@budiauktioner/buildi-primitives 0.1.0 → 0.2.0

package/dist/esm/product/gtin12.js

@@ -0,0 +1,110 @@
+import { extractGtinDigits, validateGtinCheckDigit } from "../internal/gtin-check-digit.js";
+import { sanitizeInput } from "../internal/input-sanitization.js";
+import { TextCandidateCategory } from "../text-scanning/text-candidate-category.js";
+import { TextCandidate } from "../text-scanning/text-candidate.js";
+import { TextMatchConfidence } from "../text-scanning/text-match-confidence.js";
+import { maskGtin12 } from "./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 = extractGtinDigits(sanitizeInput(input));
+    if (digits === null || digits.length !== 12) return null;
+    if (!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 TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "Gtin12",
+          category: TextCandidateCategory.Product,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskGtin12(value),
+          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;
+}
+export {
+  Gtin12
+};
+//# sourceMappingURL=gtin12.js.map

package/dist/esm/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/esm/product/gtin13.js

@@ -0,0 +1,127 @@
+import { resolveGs1Prefix } from "../internal/gs1-prefix.js";
+import { extractGtinDigits, validateGtinCheckDigit } from "../internal/gtin-check-digit.js";
+import { sanitizeInput } from "../internal/input-sanitization.js";
+import { TextCandidateCategory } from "../text-scanning/text-candidate-category.js";
+import { TextCandidate } from "../text-scanning/text-candidate.js";
+import { TextMatchConfidence } from "../text-scanning/text-match-confidence.js";
+import { maskGtin13 } from "./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 = 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 = extractGtinDigits(sanitizeInput(input));
+    if (digits === null || digits.length !== 13) return null;
+    if (!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 TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "Gtin13",
+          category: TextCandidateCategory.Product,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskGtin13(value),
+          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;
+}
+export {
+  Gtin13
+};
+//# sourceMappingURL=gtin13.js.map

package/dist/esm/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/esm/product/gtin14.js

@@ -0,0 +1,115 @@
+import { extractGtinDigits, validateGtinCheckDigit } from "../internal/gtin-check-digit.js";
+import { sanitizeInput } from "../internal/input-sanitization.js";
+import { TextCandidateCategory } from "../text-scanning/text-candidate-category.js";
+import { TextCandidate } from "../text-scanning/text-candidate.js";
+import { TextMatchConfidence } from "../text-scanning/text-match-confidence.js";
+import { maskGtin14 } from "./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 = extractGtinDigits(sanitizeInput(input));
+    if (digits === null || digits.length !== 14) return null;
+    if (!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 TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "Gtin14",
+          category: TextCandidateCategory.Product,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskGtin14(value),
+          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;
+}
+export {
+  Gtin14
+};
+//# sourceMappingURL=gtin14.js.map

package/dist/esm/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": []
+}

package/dist/esm/product/gtin8.js

@@ -0,0 +1,110 @@
+import { extractGtinDigits, validateGtinCheckDigit } from "../internal/gtin-check-digit.js";
+import { sanitizeInput } from "../internal/input-sanitization.js";
+import { TextCandidateCategory } from "../text-scanning/text-candidate-category.js";
+import { TextCandidate } from "../text-scanning/text-candidate.js";
+import { TextMatchConfidence } from "../text-scanning/text-match-confidence.js";
+import { maskGtin8 } from "./product-masking.js";
+const SCAN_PATTERN = /(?<!\d)\d{8}(?!\d)/gu;
+class Gtin8 {
+  static typeInfo = Object.freeze({
+    englishName: "GTIN-8",
+    localizedName: "GTIN-8",
+    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/EAN-8"
+    ])
+  });
+  /** The 8 digits, e.g. `96385074`. */
+  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 = extractGtinDigits(sanitizeInput(input));
+    if (digits === null || digits.length !== 8) return null;
+    if (!validateGtinCheckDigit(digits)) return null;
+    return new Gtin8(digits);
+  }
+  static parse(input) {
+    const result = Gtin8.tryParse(input);
+    if (result === null) throw new Error("Invalid GTIN-8.");
+    return result;
+  }
+  static isValid(input) {
+    return Gtin8.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = Gtin8.tryParse(input);
+    if (r !== null) return r.digits;
+    return fallback(input, options);
+  }
+  static normalize(input, options) {
+    const r = Gtin8.tryParse(input);
+    if (r !== null) return r.digits;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && Gtin8.normalize(input) === input;
+  }
+  /**
+   * Scans unstructured text for potential GTIN-8 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 = Gtin8.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "Gtin8",
+          category: TextCandidateCategory.Product,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskGtin8(value),
+          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;
+}
+export {
+  Gtin8
+};
+//# sourceMappingURL=gtin8.js.map

package/dist/esm/product/gtin8.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/gtin8.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 { maskGtin8 } from \"./product-masking.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface Gtin8FormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst SCAN_PATTERN = /(?<!\\d)\\d{8}(?!\\d)/gu;\n\n/**\n * An 8-digit Global Trade Item Number (GTIN-8), also known as EAN-8. Used on small packages\n * where a GTIN-13 barcode would not fit. Validated with the GS1 modulo-10 check digit.\n */\nexport class Gtin8 {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"GTIN-8\",\n    localizedName: \"GTIN-8\",\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/EAN-8\",\n    ]),\n  });\n\n  /** The 8 digits, e.g. `96385074`. */\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): Gtin8 | null {\n    if (input == null || input.trim().length === 0) return null;\n    const digits = extractGtinDigits(sanitizeInput(input));\n    if (digits === null || digits.length !== 8) return null;\n    if (!validateGtinCheckDigit(digits)) return null;\n    return new Gtin8(digits);\n  }\n\n  static parse(input: string): Gtin8 {\n    const result = Gtin8.tryParse(input);\n    if (result === null) throw new Error(\"Invalid GTIN-8.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return Gtin8.tryParse(input) !== null;\n  }\n\n  static format(input: string | null | undefined, options?: Gtin8FormatOptions): string | null {\n    const r = Gtin8.tryParse(input);\n    if (r !== null) return r.digits;\n    return fallback(input, options);\n  }\n\n  static normalize(input: string | null | undefined, options?: Gtin8FormatOptions): string | null {\n    const r = Gtin8.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 && Gtin8.normalize(input) === input;\n  }\n\n  /**\n   * Scans unstructured text for potential GTIN-8 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<Gtin8>[] {\n    if (!text) return [];\n    const out: TextCandidate<Gtin8>[] = [];\n    SCAN_PATTERN.lastIndex = 0;\n    let match: RegExpExecArray | null;\n    while ((match = SCAN_PATTERN.exec(text)) !== null) {\n      const value = Gtin8.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<Gtin8>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"Gtin8\",\n          category: TextCandidateCategory.Product,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskGtin8(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: Gtin8 | null | undefined): boolean {\n    return other != null && this.digits === other.digits;\n  }\n\n  compareTo(other: Gtin8 | 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?: Gtin8FormatOptions): 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/esm/product/hs-code-level.js

@@ -0,0 +1,12 @@
+const HsCodeLevel = {
+  Unknown: 0,
+  Chapter: 1,
+  Heading: 2,
+  Subheading: 3,
+  CnSubheading: 4,
+  TaricCode: 5
+};
+export {
+  HsCodeLevel
+};
+//# sourceMappingURL=hs-code-level.js.map

package/dist/esm/product/hs-code-level.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/hs-code-level.ts"],
+  "sourcesContent": ["/** The hierarchy level of an HS code, from a two-digit chapter to a ten-digit TARIC code. */\nexport const HsCodeLevel = {\n  Unknown: 0,\n  Chapter: 1,\n  Heading: 2,\n  Subheading: 3,\n  CnSubheading: 4,\n  TaricCode: 5,\n} as const;\n\nexport type HsCodeLevel = (typeof HsCodeLevel)[keyof typeof HsCodeLevel];\n"],
+  "mappings": "AACO,MAAM,cAAc;AAAA,EACzB,SAAS;AAAA,EACT,SAAS;AAAA,EACT,SAAS;AAAA,EACT,YAAY;AAAA,EACZ,cAAc;AAAA,EACd,WAAW;AACb;",
+  "names": []
+}