@verisav/gs1-dpp-utils

Validate GTIN, GLN & GS1 Digital Link URIs for EU Digital Product Passports.
Zero dependencies. Compliant with GS1 GSMP (GSCN 23-103). Aligned with EU ESPR and DPP use cases.

Used in production at Verisav for the DPP Compliance Checker, GLN Validator, and DPP QR Generator.

Install

npm install @verisav/gs1-dpp-utils

Usage

import {
  validateGTIN,
  validateGLN,
  generateGS1DigitalLinkURI,
  validateGS1DigitalLinkURI,
  extractGTINFromJSONLD,
  extractGLNFromJSONLD,
  generateGLN,
} from '@verisav/gs1-dpp-utils'

// Validate GTIN (GTIN-8, -12, -13, -14)
validateGTIN('1234567890128')   // { valid: true, type: 'GTIN-13' }
validateGTIN('123')             // { valid: false, error: '...' }

// Validate GLN (13 digits)
validateGLN('9501101530003')    // { valid: true }

// Generate GS1 Digital Link URI
generateGS1DigitalLinkURI('1234567890128')
// 'https://id.gs1.org/01/1234567890128'

generateGS1DigitalLinkURI('1234567890128', { serial: 'SN-ABC', lot: 'LOT1' })
// 'https://id.gs1.org/01/1234567890128/21/SN-ABC/10/LOT1'

// Validate a Digital Link URL
validateGS1DigitalLinkURI('https://id.gs1.org/01/1234567890128/21/SN123')
// { valid: true, isGS1: true, gtin: '1234567890128', details: { ai01: '...', ai21: '...' } }

// Extract from JSON-LD (DPP, Schema.org Product, etc.)
extractGTINFromJSONLD({ gtin: '1234567890128', name: 'Product' })  // '1234567890128'
extractGLNFromJSONLD(dppJsonLd)  // GLN from manufacturer address if present

// Generate test GLN (testing only; production GLNs are assigned by GS1)
generateGLN('950')  // e.g. '9501234567890'

API

| Function | Description | |----------|-------------| | validateGTIN(gtin) | Returns { valid, type?, error? }. Supports GTIN-8, 12, 13, 14. | | validateGLN(gln) | Returns { valid, error? }. GLN is always 13 digits. | | generateGS1DigitalLinkURI(gtin, params?) | Builds https://id.gs1.org/01/{GTIN}[/AI/value...]. Returns null if GTIN invalid. | | validateGS1DigitalLinkURI(uri) | Parses and validates a GS1 Digital Link URL. Returns { valid, isGS1, gtin?, details?, error? }. | | extractGTINFromJSONLD(obj) | Extracts GTIN from identifier (PropertyValue) or gtin. | | extractGLNFromJSONLD(obj) | Extracts GLN from identifier or manufacturer.address. | | generateGLN(prefix?) | Generates a valid 13-digit GLN (test prefix 950 by default). |

References

• GS1 Digital Link
• GS1 GTIN
• GS1 GLN
• EU ESPR / Digital Product Passport

License

MIT