@budiauktioner/buildi-primitives 0.1.1 → 0.2.0

package/dist/cjs/product/gtin.js

@@ -0,0 +1,99 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var gtin_exports = {};
+__export(gtin_exports, {
+  Gtin: () => Gtin
+});
+module.exports = __toCommonJS(gtin_exports);
+var import_gtin_check_digit = require("../internal/gtin-check-digit.js");
+var import_input_sanitization = require("../internal/input-sanitization.js");
+class Gtin {
+  static typeInfo = Object.freeze({
+    englishName: "GTIN",
+    localizedName: "GTIN",
+    emoji: "\u{1F4E6}",
+    sources: Object.freeze([
+      "https://www.gs1.org/standards/id-keys/gtin",
+      "https://www.gs1.org/services/check-digit-calculator",
+      "https://en.wikipedia.org/wiki/Global_Trade_Item_Number"
+    ])
+  });
+  /** The digits, e.g. `5901234123457`. */
+  digits;
+  /** Number of digits: 8, 12, 13 or 14. */
+  length;
+  /** The GS1 modulo-10 check digit (last digit). */
+  checkDigit;
+  constructor(digits) {
+    this.digits = digits;
+    this.length = digits.length;
+    this.checkDigit = digits.charCodeAt(digits.length - 1) - 48;
+  }
+  /** Returns the GTIN zero-padded to 14 digits, the form used for cross-length comparison. */
+  toGtin14Digits() {
+    return this.digits.padStart(14, "0");
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const digits = (0, import_gtin_check_digit.extractGtinDigits)((0, import_input_sanitization.sanitizeInput)(input));
+    if (digits === null || !import_gtin_check_digit.GTIN_VALID_LENGTHS.includes(digits.length)) return null;
+    if (!(0, import_gtin_check_digit.validateGtinCheckDigit)(digits)) return null;
+    return new Gtin(digits);
+  }
+  static parse(input) {
+    const result = Gtin.tryParse(input);
+    if (result === null) throw new Error("Invalid GTIN.");
+    return result;
+  }
+  static isValid(input) {
+    return Gtin.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = Gtin.tryParse(input);
+    if (r !== null) return r.digits;
+    return fallback(input, options);
+  }
+  static normalize(input, options) {
+    const r = Gtin.tryParse(input);
+    if (r !== null) return r.digits;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && Gtin.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.digits;
+  }
+  toString() {
+    return this.digits;
+  }
+  equals(other) {
+    return other != null && this.digits === other.digits;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.digits < other.digits ? -1 : this.digits > other.digits ? 1 : 0;
+  }
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=gtin.js.map

package/dist/cjs/product/gtin.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/gtin.ts"],
+  "sourcesContent": ["import {\n  GTIN_VALID_LENGTHS,\n  extractGtinDigits,\n  validateGtinCheckDigit,\n} from \"../internal/gtin-check-digit.js\";\nimport { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface GtinFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\n/**\n * A Global Trade Item Number of any GS1 length: 8, 12, 13 or 14 digits. Use this when the\n * length is not known up front; the fixed-length types expose the parts specific to each\n * format. Validated with the GS1 modulo-10 check digit.\n */\nexport class Gtin {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"GTIN\",\n    localizedName: \"GTIN\",\n    emoji: \"\uD83D\uDCE6\",\n    sources: Object.freeze([\n      \"https://www.gs1.org/standards/id-keys/gtin\",\n      \"https://www.gs1.org/services/check-digit-calculator\",\n      \"https://en.wikipedia.org/wiki/Global_Trade_Item_Number\",\n    ]),\n  });\n\n  /** The digits, e.g. `5901234123457`. */\n  readonly digits: string;\n\n  /** Number of digits: 8, 12, 13 or 14. */\n  readonly length: number;\n\n  /** The GS1 modulo-10 check digit (last digit). */\n  readonly checkDigit: number;\n\n  private constructor(digits: string) {\n    this.digits = digits;\n    this.length = digits.length;\n    this.checkDigit = digits.charCodeAt(digits.length - 1) - 48;\n  }\n\n  /** Returns the GTIN zero-padded to 14 digits, the form used for cross-length comparison. */\n  toGtin14Digits(): string {\n    return this.digits.padStart(14, \"0\");\n  }\n\n  static tryParse(input: string | null | undefined): Gtin | null {\n    if (input == null || input.trim().length === 0) return null;\n    const digits = extractGtinDigits(sanitizeInput(input));\n    if (digits === null || !GTIN_VALID_LENGTHS.includes(digits.length)) return null;\n    if (!validateGtinCheckDigit(digits)) return null;\n    return new Gtin(digits);\n  }\n\n  static parse(input: string): Gtin {\n    const result = Gtin.tryParse(input);\n    if (result === null) throw new Error(\"Invalid GTIN.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return Gtin.tryParse(input) !== null;\n  }\n\n  static format(input: string | null | undefined, options?: GtinFormatOptions): string | null {\n    const r = Gtin.tryParse(input);\n    if (r !== null) return r.digits;\n    return fallback(input, options);\n  }\n\n  static normalize(input: string | null | undefined, options?: GtinFormatOptions): string | null {\n    const r = Gtin.tryParse(input);\n    if (r !== null) return r.digits;\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && Gtin.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.digits;\n  }\n\n  toString(): string {\n    return this.digits;\n  }\n\n  equals(other: Gtin | null | undefined): boolean {\n    return other != null && this.digits === other.digits;\n  }\n\n  compareTo(other: Gtin | null | undefined): number {\n    if (other == null) return 1;\n    return this.digits < other.digits ? -1 : this.digits > other.digits ? 1 : 0;\n  }\n}\n\nfunction fallback(input: string | null | undefined, options?: GtinFormatOptions): string | null {\n  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;\n  const trimmed = input.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,8BAIO;AACP,gCAA8B;AAcvB,MAAM,KAAK;AAAA,EAChB,OAAgB,WAA8B,OAAO,OAAO;AAAA,IAC1D,aAAa;AAAA,IACb,eAAe;AAAA,IACf,OAAO;AAAA,IACP,SAAS,OAAO,OAAO;AAAA,MACrB;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAAA;AAAA,EAGQ;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA,EAED,YAAY,QAAgB;AAClC,SAAK,SAAS;AACd,SAAK,SAAS,OAAO;AACrB,SAAK,aAAa,OAAO,WAAW,OAAO,SAAS,CAAC,IAAI;AAAA,EAC3D;AAAA;AAAA,EAGA,iBAAyB;AACvB,WAAO,KAAK,OAAO,SAAS,IAAI,GAAG;AAAA,EACrC;AAAA,EAEA,OAAO,SAAS,OAA+C;AAC7D,QAAI,SAAS,QAAQ,MAAM,KAAK,EAAE,WAAW,EAAG,QAAO;AACvD,UAAM,aAAS,+CAAkB,yCAAc,KAAK,CAAC;AACrD,QAAI,WAAW,QAAQ,CAAC,2CAAmB,SAAS,OAAO,MAAM,EAAG,QAAO;AAC3E,QAAI,KAAC,gDAAuB,MAAM,EAAG,QAAO;AAC5C,WAAO,IAAI,KAAK,MAAM;AAAA,EACxB;AAAA,EAEA,OAAO,MAAM,OAAqB;AAChC,UAAM,SAAS,KAAK,SAAS,KAAK;AAClC,QAAI,WAAW,KAAM,OAAM,IAAI,MAAM,eAAe;AACpD,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,KAAK,SAAS,KAAK,MAAM;AAAA,EAClC;AAAA,EAEA,OAAO,OAAO,OAAkC,SAA4C;AAC1F,UAAM,IAAI,KAAK,SAAS,KAAK;AAC7B,QAAI,MAAM,KAAM,QAAO,EAAE;AACzB,WAAO,SAAS,OAAO,OAAO;AAAA,EAChC;AAAA,EAEA,OAAO,UAAU,OAAkC,SAA4C;AAC7F,UAAM,IAAI,KAAK,SAAS,KAAK;AAC7B,QAAI,MAAM,KAAM,QAAO,EAAE;AACzB,WAAO,SAAS,OAAO,OAAO;AAAA,EAChC;AAAA,EAEA,OAAO,aAAa,OAA2C;AAC7D,WAAO,SAAS,QAAQ,KAAK,UAAU,KAAK,MAAM;AAAA,EACpD;AAAA,EAEA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,WAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO,OAAyC;AAC9C,WAAO,SAAS,QAAQ,KAAK,WAAW,MAAM;AAAA,EAChD;AAAA,EAEA,UAAU,OAAwC;AAChD,QAAI,SAAS,KAAM,QAAO;AAC1B,WAAO,KAAK,SAAS,MAAM,SAAS,KAAK,KAAK,SAAS,MAAM,SAAS,IAAI;AAAA,EAC5E;AACF;AAEA,SAAS,SAAS,OAAkC,SAA4C;AAC9F,MAAI,SAAS,sCAAsC,QAAQ,SAAS,KAAM,QAAO;AACjF,QAAM,UAAU,MAAM,KAAK;AAC3B,SAAO,QAAQ,SAAS,IAAI,UAAU;AACxC;",
+  "names": []
+}

package/dist/cjs/product/gtin12.js

@@ -0,0 +1,130 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var gtin12_exports = {};
+__export(gtin12_exports, {
+  Gtin12: () => Gtin12
+});
+module.exports = __toCommonJS(gtin12_exports);
+var import_gtin_check_digit = require("../internal/gtin-check-digit.js");
+var import_input_sanitization = require("../internal/input-sanitization.js");
+var import_text_candidate_category = require("../text-scanning/text-candidate-category.js");
+var import_text_candidate = require("../text-scanning/text-candidate.js");
+var import_text_match_confidence = require("../text-scanning/text-match-confidence.js");
+var import_product_masking = require("./product-masking.js");
+const SCAN_PATTERN = /(?<!\d)\d{12}(?!\d)/gu;
+class Gtin12 {
+  static typeInfo = Object.freeze({
+    englishName: "GTIN-12",
+    localizedName: "GTIN-12",
+    emoji: "\u{1F4E6}",
+    sources: Object.freeze([
+      "https://www.gs1.org/standards/id-keys/gtin",
+      "https://www.gs1.org/services/check-digit-calculator",
+      "https://en.wikipedia.org/wiki/Universal_Product_Code"
+    ])
+  });
+  /** The 12 digits, e.g. `614141000036`. */
+  digits;
+  /** The GS1 modulo-10 check digit (last digit). */
+  checkDigit;
+  constructor(digits) {
+    this.digits = digits;
+    this.checkDigit = digits.charCodeAt(digits.length - 1) - 48;
+  }
+  /** Returns the GTIN zero-padded to 14 digits, the form used for cross-length comparison. */
+  toGtin14Digits() {
+    return this.digits.padStart(14, "0");
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const digits = (0, import_gtin_check_digit.extractGtinDigits)((0, import_input_sanitization.sanitizeInput)(input));
+    if (digits === null || digits.length !== 12) return null;
+    if (!(0, import_gtin_check_digit.validateGtinCheckDigit)(digits)) return null;
+    return new Gtin12(digits);
+  }
+  static parse(input) {
+    const result = Gtin12.tryParse(input);
+    if (result === null) throw new Error("Invalid GTIN-12.");
+    return result;
+  }
+  static isValid(input) {
+    return Gtin12.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = Gtin12.tryParse(input);
+    if (r !== null) return r.digits;
+    return fallback(input, options);
+  }
+  static normalize(input, options) {
+    const r = Gtin12.tryParse(input);
+    if (r !== null) return r.digits;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && Gtin12.normalize(input) === input;
+  }
+  /**
+   * Scans unstructured text for potential UPC-A barcodes. Results are heuristic candidates
+   * and may include false positives; nothing guarantees a candidate is a real product code.
+   */
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    SCAN_PATTERN.lastIndex = 0;
+    let match;
+    while ((match = SCAN_PATTERN.exec(text)) !== null) {
+      const value = Gtin12.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new import_text_candidate.TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "Gtin12",
+          category: import_text_candidate_category.TextCandidateCategory.Product,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: (0, import_product_masking.maskGtin12)(value),
+          confidence: import_text_match_confidence.TextMatchConfidence.Medium,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  toNormalizedString() {
+    return this.digits;
+  }
+  toString() {
+    return this.digits;
+  }
+  equals(other) {
+    return other != null && this.digits === other.digits;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.digits < other.digits ? -1 : this.digits > other.digits ? 1 : 0;
+  }
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=gtin12.js.map

package/dist/cjs/product/gtin12.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/gtin12.ts"],
+  "sourcesContent": ["import { extractGtinDigits, validateGtinCheckDigit } from \"../internal/gtin-check-digit.js\";\nimport { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { TextCandidateCategory } from \"../text-scanning/text-candidate-category.js\";\nimport { TextCandidate } from \"../text-scanning/text-candidate.js\";\nimport { TextMatchConfidence } from \"../text-scanning/text-match-confidence.js\";\nimport { maskGtin12 } from \"./product-masking.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface Gtin12FormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst SCAN_PATTERN = /(?<!\\d)\\d{12}(?!\\d)/gu;\n\n/**\n * A 12-digit Global Trade Item Number (GTIN-12), better known as a UPC-A barcode and used\n * mainly in North America. Validated with the GS1 modulo-10 check digit.\n */\nexport class Gtin12 {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"GTIN-12\",\n    localizedName: \"GTIN-12\",\n    emoji: \"\uD83D\uDCE6\",\n    sources: Object.freeze([\n      \"https://www.gs1.org/standards/id-keys/gtin\",\n      \"https://www.gs1.org/services/check-digit-calculator\",\n      \"https://en.wikipedia.org/wiki/Universal_Product_Code\",\n    ]),\n  });\n\n  /** The 12 digits, e.g. `614141000036`. */\n  readonly digits: string;\n\n  /** The GS1 modulo-10 check digit (last digit). */\n  readonly checkDigit: number;\n\n  private constructor(digits: string) {\n    this.digits = digits;\n    this.checkDigit = digits.charCodeAt(digits.length - 1) - 48;\n  }\n\n  /** Returns the GTIN zero-padded to 14 digits, the form used for cross-length comparison. */\n  toGtin14Digits(): string {\n    return this.digits.padStart(14, \"0\");\n  }\n\n  static tryParse(input: string | null | undefined): Gtin12 | null {\n    if (input == null || input.trim().length === 0) return null;\n    const digits = extractGtinDigits(sanitizeInput(input));\n    if (digits === null || digits.length !== 12) return null;\n    if (!validateGtinCheckDigit(digits)) return null;\n    return new Gtin12(digits);\n  }\n\n  static parse(input: string): Gtin12 {\n    const result = Gtin12.tryParse(input);\n    if (result === null) throw new Error(\"Invalid GTIN-12.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return Gtin12.tryParse(input) !== null;\n  }\n\n  static format(input: string | null | undefined, options?: Gtin12FormatOptions): string | null {\n    const r = Gtin12.tryParse(input);\n    if (r !== null) return r.digits;\n    return fallback(input, options);\n  }\n\n  static normalize(input: string | null | undefined, options?: Gtin12FormatOptions): string | null {\n    const r = Gtin12.tryParse(input);\n    if (r !== null) return r.digits;\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && Gtin12.normalize(input) === input;\n  }\n\n  /**\n   * Scans unstructured text for potential UPC-A barcodes. Results are heuristic candidates\n   * and may include false positives; nothing guarantees a candidate is a real product code.\n   */\n  static findCandidatesInText(text: string): readonly TextCandidate<Gtin12>[] {\n    if (!text) return [];\n    const out: TextCandidate<Gtin12>[] = [];\n    SCAN_PATTERN.lastIndex = 0;\n    let match: RegExpExecArray | null;\n    while ((match = SCAN_PATTERN.exec(text)) !== null) {\n      const value = Gtin12.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<Gtin12>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"Gtin12\",\n          category: TextCandidateCategory.Product,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskGtin12(value),\n          confidence: TextMatchConfidence.Medium,\n          value,\n        }),\n      );\n    }\n    return out;\n  }\n\n  toNormalizedString(): string {\n    return this.digits;\n  }\n\n  toString(): string {\n    return this.digits;\n  }\n\n  equals(other: Gtin12 | null | undefined): boolean {\n    return other != null && this.digits === other.digits;\n  }\n\n  compareTo(other: Gtin12 | null | undefined): number {\n    if (other == null) return 1;\n    return this.digits < other.digits ? -1 : this.digits > other.digits ? 1 : 0;\n  }\n}\n\nfunction fallback(input: string | null | undefined, options?: Gtin12FormatOptions): string | null {\n  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;\n  const trimmed = input.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/product/gtin13.js

@@ -0,0 +1,147 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var gtin13_exports = {};
+__export(gtin13_exports, {
+  Gtin13: () => Gtin13
+});
+module.exports = __toCommonJS(gtin13_exports);
+var import_gs1_prefix = require("../internal/gs1-prefix.js");
+var import_gtin_check_digit = require("../internal/gtin-check-digit.js");
+var import_input_sanitization = require("../internal/input-sanitization.js");
+var import_text_candidate_category = require("../text-scanning/text-candidate-category.js");
+var import_text_candidate = require("../text-scanning/text-candidate.js");
+var import_text_match_confidence = require("../text-scanning/text-match-confidence.js");
+var import_product_masking = require("./product-masking.js");
+const SCAN_PATTERN = /(?<!\d)\d{13}(?!\d)/gu;
+class Gtin13 {
+  static typeInfo = Object.freeze({
+    englishName: "GTIN-13",
+    localizedName: "GTIN-13",
+    emoji: "\u{1F4E6}",
+    sources: Object.freeze([
+      "https://www.gs1.org/standards/id-keys/gtin",
+      "https://www.gs1.org/services/check-digit-calculator",
+      "https://en.wikipedia.org/wiki/International_Article_Number"
+    ])
+  });
+  /** The 13 digits, e.g. `5901234123457`. */
+  digits;
+  /** The GS1 modulo-10 check digit (last digit). */
+  checkDigit;
+  /** The 3-digit GS1 prefix identifying the issuing member organization, e.g. `590` for Poland. */
+  gs1Prefix;
+  /**
+   * Organization or country behind the prefix, e.g. `Sweden` for 730–739 or `Books (ISBN)` for
+   * 978–979. `null` when the prefix falls outside every published range.
+   */
+  gs1PrefixName;
+  /**
+   * ISO 3166-1 alpha-2 code for the prefix, e.g. `SE`. `null` when the prefix maps to a
+   * non-country assignment such as ISBN or coupons, or is unknown.
+   */
+  gs1PrefixCountryCode;
+  constructor(digits) {
+    this.digits = digits;
+    this.checkDigit = digits.charCodeAt(digits.length - 1) - 48;
+    this.gs1Prefix = digits.slice(0, 3);
+    const resolved = (0, import_gs1_prefix.resolveGs1Prefix)(this.gs1Prefix);
+    this.gs1PrefixName = resolved?.name ?? null;
+    this.gs1PrefixCountryCode = resolved?.countryCode ?? null;
+  }
+  /** Returns the GTIN zero-padded to 14 digits, the form used for cross-length comparison. */
+  toGtin14Digits() {
+    return this.digits.padStart(14, "0");
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const digits = (0, import_gtin_check_digit.extractGtinDigits)((0, import_input_sanitization.sanitizeInput)(input));
+    if (digits === null || digits.length !== 13) return null;
+    if (!(0, import_gtin_check_digit.validateGtinCheckDigit)(digits)) return null;
+    return new Gtin13(digits);
+  }
+  static parse(input) {
+    const result = Gtin13.tryParse(input);
+    if (result === null) throw new Error("Invalid GTIN-13.");
+    return result;
+  }
+  static isValid(input) {
+    return Gtin13.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = Gtin13.tryParse(input);
+    if (r !== null) return r.digits;
+    return fallback(input, options);
+  }
+  static normalize(input, options) {
+    const r = Gtin13.tryParse(input);
+    if (r !== null) return r.digits;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && Gtin13.normalize(input) === input;
+  }
+  /**
+   * Scans unstructured text for potential EAN-13 barcodes. Results are heuristic candidates
+   * and may include false positives; nothing guarantees a candidate is a real product code.
+   */
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    SCAN_PATTERN.lastIndex = 0;
+    let match;
+    while ((match = SCAN_PATTERN.exec(text)) !== null) {
+      const value = Gtin13.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new import_text_candidate.TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "Gtin13",
+          category: import_text_candidate_category.TextCandidateCategory.Product,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: (0, import_product_masking.maskGtin13)(value),
+          confidence: import_text_match_confidence.TextMatchConfidence.High,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  toNormalizedString() {
+    return this.digits;
+  }
+  toString() {
+    return this.digits;
+  }
+  equals(other) {
+    return other != null && this.digits === other.digits;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.digits < other.digits ? -1 : this.digits > other.digits ? 1 : 0;
+  }
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=gtin13.js.map

package/dist/cjs/product/gtin13.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/gtin13.ts"],
+  "sourcesContent": ["import { resolveGs1Prefix } from \"../internal/gs1-prefix.js\";\nimport { extractGtinDigits, validateGtinCheckDigit } from \"../internal/gtin-check-digit.js\";\nimport { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { TextCandidateCategory } from \"../text-scanning/text-candidate-category.js\";\nimport { TextCandidate } from \"../text-scanning/text-candidate.js\";\nimport { TextMatchConfidence } from \"../text-scanning/text-match-confidence.js\";\nimport { maskGtin13 } from \"./product-masking.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface Gtin13FormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst SCAN_PATTERN = /(?<!\\d)\\d{13}(?!\\d)/gu;\n\n/**\n * A 13-digit Global Trade Item Number (GTIN-13), also known as EAN-13, the most widely used\n * consumer barcode. The first three digits form the GS1 prefix identifying the issuing member\n * organization. Validated with the GS1 modulo-10 check digit.\n */\nexport class Gtin13 {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"GTIN-13\",\n    localizedName: \"GTIN-13\",\n    emoji: \"\uD83D\uDCE6\",\n    sources: Object.freeze([\n      \"https://www.gs1.org/standards/id-keys/gtin\",\n      \"https://www.gs1.org/services/check-digit-calculator\",\n      \"https://en.wikipedia.org/wiki/International_Article_Number\",\n    ]),\n  });\n\n  /** The 13 digits, e.g. `5901234123457`. */\n  readonly digits: string;\n\n  /** The GS1 modulo-10 check digit (last digit). */\n  readonly checkDigit: number;\n\n  /** The 3-digit GS1 prefix identifying the issuing member organization, e.g. `590` for Poland. */\n  readonly gs1Prefix: string;\n\n  /**\n   * Organization or country behind the prefix, e.g. `Sweden` for 730\u2013739 or `Books (ISBN)` for\n   * 978\u2013979. `null` when the prefix falls outside every published range.\n   */\n  readonly gs1PrefixName: string | null;\n\n  /**\n   * ISO 3166-1 alpha-2 code for the prefix, e.g. `SE`. `null` when the prefix maps to a\n   * non-country assignment such as ISBN or coupons, or is unknown.\n   */\n  readonly gs1PrefixCountryCode: string | null;\n\n  private constructor(digits: string) {\n    this.digits = digits;\n    this.checkDigit = digits.charCodeAt(digits.length - 1) - 48;\n    this.gs1Prefix = digits.slice(0, 3);\n    const resolved = resolveGs1Prefix(this.gs1Prefix);\n    this.gs1PrefixName = resolved?.name ?? null;\n    this.gs1PrefixCountryCode = resolved?.countryCode ?? null;\n  }\n\n  /** Returns the GTIN zero-padded to 14 digits, the form used for cross-length comparison. */\n  toGtin14Digits(): string {\n    return this.digits.padStart(14, \"0\");\n  }\n\n  static tryParse(input: string | null | undefined): Gtin13 | null {\n    if (input == null || input.trim().length === 0) return null;\n    const digits = extractGtinDigits(sanitizeInput(input));\n    if (digits === null || digits.length !== 13) return null;\n    if (!validateGtinCheckDigit(digits)) return null;\n    return new Gtin13(digits);\n  }\n\n  static parse(input: string): Gtin13 {\n    const result = Gtin13.tryParse(input);\n    if (result === null) throw new Error(\"Invalid GTIN-13.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return Gtin13.tryParse(input) !== null;\n  }\n\n  static format(input: string | null | undefined, options?: Gtin13FormatOptions): string | null {\n    const r = Gtin13.tryParse(input);\n    if (r !== null) return r.digits;\n    return fallback(input, options);\n  }\n\n  static normalize(input: string | null | undefined, options?: Gtin13FormatOptions): string | null {\n    const r = Gtin13.tryParse(input);\n    if (r !== null) return r.digits;\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && Gtin13.normalize(input) === input;\n  }\n\n  /**\n   * Scans unstructured text for potential EAN-13 barcodes. Results are heuristic candidates\n   * and may include false positives; nothing guarantees a candidate is a real product code.\n   */\n  static findCandidatesInText(text: string): readonly TextCandidate<Gtin13>[] {\n    if (!text) return [];\n    const out: TextCandidate<Gtin13>[] = [];\n    SCAN_PATTERN.lastIndex = 0;\n    let match: RegExpExecArray | null;\n    while ((match = SCAN_PATTERN.exec(text)) !== null) {\n      const value = Gtin13.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<Gtin13>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"Gtin13\",\n          category: TextCandidateCategory.Product,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskGtin13(value),\n          confidence: TextMatchConfidence.High,\n          value,\n        }),\n      );\n    }\n    return out;\n  }\n\n  toNormalizedString(): string {\n    return this.digits;\n  }\n\n  toString(): string {\n    return this.digits;\n  }\n\n  equals(other: Gtin13 | null | undefined): boolean {\n    return other != null && this.digits === other.digits;\n  }\n\n  compareTo(other: Gtin13 | null | undefined): number {\n    if (other == null) return 1;\n    return this.digits < other.digits ? -1 : this.digits > other.digits ? 1 : 0;\n  }\n}\n\nfunction fallback(input: string | null | undefined, options?: Gtin13FormatOptions): string | null {\n  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;\n  const trimmed = input.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/product/gtin14.js

@@ -0,0 +1,135 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var gtin14_exports = {};
+__export(gtin14_exports, {
+  Gtin14: () => Gtin14
+});
+module.exports = __toCommonJS(gtin14_exports);
+var import_gtin_check_digit = require("../internal/gtin-check-digit.js");
+var import_input_sanitization = require("../internal/input-sanitization.js");
+var import_text_candidate_category = require("../text-scanning/text-candidate-category.js");
+var import_text_candidate = require("../text-scanning/text-candidate.js");
+var import_text_match_confidence = require("../text-scanning/text-match-confidence.js");
+var import_product_masking = require("./product-masking.js");
+const SCAN_PATTERN = /(?<!\d)\d{14}(?!\d)/gu;
+class Gtin14 {
+  static typeInfo = Object.freeze({
+    englishName: "GTIN-14",
+    localizedName: "GTIN-14",
+    emoji: "\u{1F4E6}",
+    sources: Object.freeze([
+      "https://www.gs1.org/standards/id-keys/gtin",
+      "https://www.gs1.org/services/check-digit-calculator",
+      "https://en.wikipedia.org/wiki/ITF-14"
+    ])
+  });
+  /** The 14 digits, e.g. `10614141000415`. */
+  digits;
+  /** The GS1 modulo-10 check digit (last digit). */
+  checkDigit;
+  /**
+   * The packaging indicator (first digit). 1–8 are defined packaging levels, 9 marks a
+   * variable-measure trade item, and 0 means no specific level.
+   */
+  indicatorDigit;
+  /** The inner 13 digits, which represent the contained GTIN-13. */
+  innerGtin13Digits;
+  constructor(digits) {
+    this.digits = digits;
+    this.checkDigit = digits.charCodeAt(digits.length - 1) - 48;
+    this.indicatorDigit = digits.charCodeAt(0) - 48;
+    this.innerGtin13Digits = digits.slice(1);
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const digits = (0, import_gtin_check_digit.extractGtinDigits)((0, import_input_sanitization.sanitizeInput)(input));
+    if (digits === null || digits.length !== 14) return null;
+    if (!(0, import_gtin_check_digit.validateGtinCheckDigit)(digits)) return null;
+    return new Gtin14(digits);
+  }
+  static parse(input) {
+    const result = Gtin14.tryParse(input);
+    if (result === null) throw new Error("Invalid GTIN-14.");
+    return result;
+  }
+  static isValid(input) {
+    return Gtin14.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = Gtin14.tryParse(input);
+    if (r !== null) return r.digits;
+    return fallback(input, options);
+  }
+  static normalize(input, options) {
+    const r = Gtin14.tryParse(input);
+    if (r !== null) return r.digits;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && Gtin14.normalize(input) === input;
+  }
+  /**
+   * Scans unstructured text for potential ITF-14 barcodes. Results are heuristic candidates
+   * and may include false positives; nothing guarantees a candidate is a real product code.
+   */
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    SCAN_PATTERN.lastIndex = 0;
+    let match;
+    while ((match = SCAN_PATTERN.exec(text)) !== null) {
+      const value = Gtin14.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new import_text_candidate.TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "Gtin14",
+          category: import_text_candidate_category.TextCandidateCategory.Product,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: (0, import_product_masking.maskGtin14)(value),
+          confidence: import_text_match_confidence.TextMatchConfidence.Medium,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  toNormalizedString() {
+    return this.digits;
+  }
+  toString() {
+    return this.digits;
+  }
+  equals(other) {
+    return other != null && this.digits === other.digits;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.digits < other.digits ? -1 : this.digits > other.digits ? 1 : 0;
+  }
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=gtin14.js.map

package/dist/cjs/product/gtin14.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/gtin14.ts"],
+  "sourcesContent": ["import { extractGtinDigits, validateGtinCheckDigit } from \"../internal/gtin-check-digit.js\";\nimport { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { TextCandidateCategory } from \"../text-scanning/text-candidate-category.js\";\nimport { TextCandidate } from \"../text-scanning/text-candidate.js\";\nimport { TextMatchConfidence } from \"../text-scanning/text-match-confidence.js\";\nimport { maskGtin14 } from \"./product-masking.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface Gtin14FormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst SCAN_PATTERN = /(?<!\\d)\\d{14}(?!\\d)/gu;\n\n/**\n * A 14-digit Global Trade Item Number (GTIN-14), used on cases and pallets and printed as an\n * ITF-14 barcode. The leading digit indicates the packaging level. Validated with the GS1\n * modulo-10 check digit.\n */\nexport class Gtin14 {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"GTIN-14\",\n    localizedName: \"GTIN-14\",\n    emoji: \"\uD83D\uDCE6\",\n    sources: Object.freeze([\n      \"https://www.gs1.org/standards/id-keys/gtin\",\n      \"https://www.gs1.org/services/check-digit-calculator\",\n      \"https://en.wikipedia.org/wiki/ITF-14\",\n    ]),\n  });\n\n  /** The 14 digits, e.g. `10614141000415`. */\n  readonly digits: string;\n\n  /** The GS1 modulo-10 check digit (last digit). */\n  readonly checkDigit: number;\n\n  /**\n   * The packaging indicator (first digit). 1\u20138 are defined packaging levels, 9 marks a\n   * variable-measure trade item, and 0 means no specific level.\n   */\n  readonly indicatorDigit: number;\n\n  /** The inner 13 digits, which represent the contained GTIN-13. */\n  readonly innerGtin13Digits: string;\n\n  private constructor(digits: string) {\n    this.digits = digits;\n    this.checkDigit = digits.charCodeAt(digits.length - 1) - 48;\n    this.indicatorDigit = digits.charCodeAt(0) - 48;\n    this.innerGtin13Digits = digits.slice(1);\n  }\n\n  static tryParse(input: string | null | undefined): Gtin14 | null {\n    if (input == null || input.trim().length === 0) return null;\n    const digits = extractGtinDigits(sanitizeInput(input));\n    if (digits === null || digits.length !== 14) return null;\n    if (!validateGtinCheckDigit(digits)) return null;\n    return new Gtin14(digits);\n  }\n\n  static parse(input: string): Gtin14 {\n    const result = Gtin14.tryParse(input);\n    if (result === null) throw new Error(\"Invalid GTIN-14.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return Gtin14.tryParse(input) !== null;\n  }\n\n  static format(input: string | null | undefined, options?: Gtin14FormatOptions): string | null {\n    const r = Gtin14.tryParse(input);\n    if (r !== null) return r.digits;\n    return fallback(input, options);\n  }\n\n  static normalize(input: string | null | undefined, options?: Gtin14FormatOptions): string | null {\n    const r = Gtin14.tryParse(input);\n    if (r !== null) return r.digits;\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && Gtin14.normalize(input) === input;\n  }\n\n  /**\n   * Scans unstructured text for potential ITF-14 barcodes. Results are heuristic candidates\n   * and may include false positives; nothing guarantees a candidate is a real product code.\n   */\n  static findCandidatesInText(text: string): readonly TextCandidate<Gtin14>[] {\n    if (!text) return [];\n    const out: TextCandidate<Gtin14>[] = [];\n    SCAN_PATTERN.lastIndex = 0;\n    let match: RegExpExecArray | null;\n    while ((match = SCAN_PATTERN.exec(text)) !== null) {\n      const value = Gtin14.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<Gtin14>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"Gtin14\",\n          category: TextCandidateCategory.Product,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskGtin14(value),\n          confidence: TextMatchConfidence.Medium,\n          value,\n        }),\n      );\n    }\n    return out;\n  }\n\n  toNormalizedString(): string {\n    return this.digits;\n  }\n\n  toString(): string {\n    return this.digits;\n  }\n\n  equals(other: Gtin14 | null | undefined): boolean {\n    return other != null && this.digits === other.digits;\n  }\n\n  compareTo(other: Gtin14 | null | undefined): number {\n    if (other == null) return 1;\n    return this.digits < other.digits ? -1 : this.digits > other.digits ? 1 : 0;\n  }\n}\n\nfunction fallback(input: string | null | undefined, options?: Gtin14FormatOptions): string | null {\n  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;\n  const trimmed = input.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n"],
+  "mappings": "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",
+  "names": []
+}