@aidc-toolkit/gs1 1.0.25-beta → 1.0.27-beta

package/dist/prefix-validator.js

@@ -0,0 +1,208 @@
+import { NUMERIC_CREATOR } from "@aidc-toolkit/utility";
+import { i18nextGS1 } from "./locale/i18n.js";
+import { PrefixTypes } from "./prefix-type.js";
+/**
+ * GS1 Company Prefix minimum length.
+ */
+const GS1_COMPANY_PREFIX_MINIMUM_LENGTH = 4;
+/**
+ * GS1 Company Prefix maximum length.
+ */
+const GS1_COMPANY_PREFIX_MAXIMUM_LENGTH = 12;
+/**
+ * U.P.C. Company Prefix minimum length.
+ */
+const UPC_COMPANY_PREFIX_MINIMUM_LENGTH = 6;
+/**
+ * U.P.C. Company Prefix maximum length.
+ */
+const UPC_COMPANY_PREFIX_MAXIMUM_LENGTH = 11;
+/**
+ * GS1-8 Prefix minimum length.
+ */
+const GS1_8_PREFIX_MINIMUM_LENGTH = 2;
+/**
+ * GS1-8 Prefix maximum length.
+ */
+const GS1_8_PREFIX_MAXIMUM_LENGTH = 7;
+/**
+ * Validation parameters for GS1 Company Prefix.
+ */
+const GS1_COMPANY_PREFIX_VALIDATION = {
+    minimumLength: GS1_COMPANY_PREFIX_MINIMUM_LENGTH,
+    maximumLength: GS1_COMPANY_PREFIX_MAXIMUM_LENGTH,
+    component: () => i18nextGS1.t("Prefix.gs1CompanyPrefix")
+};
+/**
+ * Validation parameters for U.P.C. Company Prefix expressed as GS1 Company Prefix.
+ */
+const UPC_COMPANY_PREFIX_AS_GS1_COMPANY_PREFIX_VALIDATION = {
+    minimumLength: UPC_COMPANY_PREFIX_MINIMUM_LENGTH + 1,
+    maximumLength: UPC_COMPANY_PREFIX_MAXIMUM_LENGTH + 1,
+    component: () => i18nextGS1.t("Prefix.gs1CompanyPrefix")
+};
+/**
+ * Validation parameters for GS1-8 Prefix expressed as GS1 Company Prefix.
+ */
+const GS1_8_PREFIX_AS_GS1_COMPANY_PREFIX_VALIDATION = {
+    minimumLength: GS1_8_PREFIX_MINIMUM_LENGTH + 5,
+    maximumLength: GS1_8_PREFIX_MAXIMUM_LENGTH + 5,
+    component: () => i18nextGS1.t("Prefix.gs1CompanyPrefix")
+};
+/**
+ * Validation parameters for U.P.C. Company Prefix.
+ */
+const UPC_COMPANY_PREFIX_VALIDATION = {
+    minimumLength: UPC_COMPANY_PREFIX_MINIMUM_LENGTH,
+    maximumLength: UPC_COMPANY_PREFIX_MAXIMUM_LENGTH,
+    component: () => i18nextGS1.t("Prefix.upcCompanyPrefix")
+};
+/**
+ * Validation parameters for GS1-8 Prefix.
+ */
+const GS1_8_PREFIX_VALIDATION = {
+    minimumLength: GS1_8_PREFIX_MINIMUM_LENGTH,
+    maximumLength: GS1_8_PREFIX_MAXIMUM_LENGTH,
+    component: () => i18nextGS1.t("Prefix.gs18Prefix")
+};
+/**
+ * Prefix validator.
+ */
+export const PrefixValidator = {
+    GS1_COMPANY_PREFIX_MINIMUM_LENGTH,
+    GS1_COMPANY_PREFIX_MAXIMUM_LENGTH,
+    UPC_COMPANY_PREFIX_MINIMUM_LENGTH,
+    UPC_COMPANY_PREFIX_MAXIMUM_LENGTH,
+    GS1_8_PREFIX_MINIMUM_LENGTH,
+    GS1_8_PREFIX_MAXIMUM_LENGTH,
+    /**
+     * Validate a prefix.
+     *
+     * @param prefixType
+     * Prefix type.
+     *
+     * @param allowUPCCompanyPrefix
+     * If true, a U.P.C. Company Prefix expressed as a GS1 Company Prefix is permitted.
+     *
+     * @param allowGS18Prefix
+     * If true, a GS1-8 Prefix expressed as a GS1 Company Prefix is permitted.
+     *
+     * @param prefix
+     * Prefix.
+     *
+     * @param isFromIdentifier
+     * If true, the prefix is from an identifier and should be trimmed before its character set is validated.
+     *
+     * @param isNumericIdentifier
+     * If true, the prefix is from a numeric identifier and its character set will be validated by the caller.
+     *
+     * @param positionOffset
+     * Position offset within a larger string.
+     */
+    validate(prefixType, allowUPCCompanyPrefix, allowGS18Prefix, prefix, isFromIdentifier = false, isNumericIdentifier = false, positionOffset) {
+        let baseValidation;
+        // Validate the prefix type and determine the prefix validation parameters.
+        switch (prefixType) {
+            case PrefixTypes.GS1CompanyPrefix:
+                if (!prefix.startsWith("0")) {
+                    baseValidation = GS1_COMPANY_PREFIX_VALIDATION;
+                }
+                else if (!prefix.startsWith("00000")) {
+                    if (!allowUPCCompanyPrefix) {
+                        throw new RangeError(i18nextGS1.t("Prefix.gs1CompanyPrefixCantStartWith0"));
+                    }
+                    baseValidation = UPC_COMPANY_PREFIX_AS_GS1_COMPANY_PREFIX_VALIDATION;
+                }
+                else if (!prefix.startsWith("000000")) {
+                    if (!allowGS18Prefix) {
+                        throw new RangeError(i18nextGS1.t("Prefix.gs1CompanyPrefixCantStartWith00000"));
+                    }
+                    baseValidation = GS1_8_PREFIX_AS_GS1_COMPANY_PREFIX_VALIDATION;
+                }
+                else {
+                    throw new RangeError(i18nextGS1.t("Prefix.gs1CompanyPrefixCantStartWith000000"));
+                }
+                break;
+            case PrefixTypes.UPCCompanyPrefix:
+                if (prefix.startsWith("0000")) {
+                    throw new RangeError(i18nextGS1.t("Prefix.upcCompanyPrefixCantStartWith0000"));
+                }
+                baseValidation = UPC_COMPANY_PREFIX_VALIDATION;
+                break;
+            case PrefixTypes.GS18Prefix:
+                if (prefix.startsWith("0")) {
+                    throw new RangeError(i18nextGS1.t("Prefix.gs18PrefixCantStartWith0"));
+                }
+                baseValidation = GS1_8_PREFIX_VALIDATION;
+                break;
+        }
+        const mergedValidation = {
+            ...baseValidation,
+            positionOffset
+        };
+        // If from key and numeric, key validation will take care of character set validation.
+        if (!isFromIdentifier) {
+            NUMERIC_CREATOR.validate(prefix, mergedValidation);
+        }
+        else if (!isNumericIdentifier) {
+            // Validate only the minimum length, allowing at least one character for the (possibly non-numeric) reference.
+            NUMERIC_CREATOR.validate(prefix.substring(0, Math.min(mergedValidation.minimumLength, prefix.length - 1)), mergedValidation);
+        }
+    },
+    /**
+     * Normalize a prefix.
+     *
+     * @param prefixType
+     * Prefix type.
+     *
+     * @param prefix
+     * Prefix.
+     *
+     * @returns
+     * Prefix provider with normalized prefix type and prefix.
+     */
+    normalize(prefixType, prefix) {
+        // Validate first.
+        this.validate(prefixType, true, true, prefix);
+        let gs1CompanyPrefix;
+        // First step is to map the prefix to a GS1 Company Prefix.
+        switch (prefixType) {
+            case PrefixTypes.GS1CompanyPrefix:
+                gs1CompanyPrefix = prefix;
+                break;
+            case PrefixTypes.UPCCompanyPrefix:
+                gs1CompanyPrefix = "0" + prefix;
+                break;
+            case PrefixTypes.GS18Prefix:
+                gs1CompanyPrefix = "00000" + prefix;
+                break;
+        }
+        let normalizedPrefixType;
+        let normalizedPrefix;
+        let upcCompanyPrefix = undefined;
+        let gs18Prefix = undefined;
+        // Determine the prefix type and populate the remaining fields.
+        if (!gs1CompanyPrefix.startsWith("0")) {
+            normalizedPrefixType = PrefixTypes.GS1CompanyPrefix;
+            normalizedPrefix = gs1CompanyPrefix;
+        }
+        else if (!gs1CompanyPrefix.startsWith("00000")) {
+            normalizedPrefixType = PrefixTypes.UPCCompanyPrefix;
+            upcCompanyPrefix = gs1CompanyPrefix.substring(1);
+            normalizedPrefix = upcCompanyPrefix;
+        }
+        else {
+            normalizedPrefixType = PrefixTypes.GS18Prefix;
+            gs18Prefix = gs1CompanyPrefix.substring(5);
+            normalizedPrefix = gs18Prefix;
+        }
+        return {
+            prefixType: normalizedPrefixType,
+            prefix: normalizedPrefix,
+            gs1CompanyPrefix,
+            upcCompanyPrefix,
+            gs18Prefix
+        };
+    }
+};
+//# sourceMappingURL=prefix-validator.js.map

package/dist/prefix-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefix-validator.js","sourceRoot":"","sources":["../src/prefix-validator.ts"],"names":[],"mappings":"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"}

package/dist/serializable-numeric-identifier-creator.d.ts

@@ -0,0 +1,48 @@
+import { type TransformerInput, type TransformerOutput } from "@aidc-toolkit/utility";
+import type { SerializableNumericIdentifierType } from "./serializable-numeric-identifier-type.js";
+import { SerializableNumericIdentifierValidator } from "./serializable-numeric-identifier-validator.js";
+declare const SerializableNumericIdentifierCreator_base: abstract new (prefixProvider: import("./prefix-provider.js").PrefixProvider, identifierType: SerializableNumericIdentifierType) => SerializableNumericIdentifierValidator & import("./non-gtin-numeric-identifier-creator.js").NonGTINNumericIdentifierCreator<SerializableNumericIdentifierType>;
+/**
+ * Serializable numeric identifier creator.
+ */
+export declare class SerializableNumericIdentifierCreator extends SerializableNumericIdentifierCreator_base {
+    #private;
+    /**
+     * Create serialized identifier(s) with a reference based on a numeric value concatenated with serial component(s).
+     * The value is converted to a reference of the appropriate length using {@linkcode NUMERIC_CREATOR}.
+     *
+     * @template TTransformerInput
+     * Transformer input type.
+     *
+     * @param value
+     * Numeric value of the reference.
+     *
+     * @param serialComponentOrComponents
+     * Serial component(s).
+     *
+     * @param sparse
+     * If true, the value is mapped to a sparse sequence resistant to discovery. Default is false.
+     *
+     * @returns
+     * Serialized identifiers.
+     */
+    createSerialized<TTransformerInput extends TransformerInput<string>>(value: number, serialComponentOrComponents: TTransformerInput, sparse?: boolean): TransformerOutput<TTransformerInput, string>;
+    /**
+     * Concatenate a base identifier with serial component(s).
+     *
+     * @template TTransformerInput
+     * Transformer input type.
+     *
+     * @param baseIdentifier
+     * Base identifier.
+     *
+     * @param serialComponentOrComponents
+     * Serial component(s).
+     *
+     * @returns
+     * Serialized identifier(s).
+     */
+    concatenate<TTransformerInput extends TransformerInput<string>>(baseIdentifier: string, serialComponentOrComponents: TTransformerInput): TransformerOutput<TTransformerInput, string>;
+}
+export {};
+//# sourceMappingURL=serializable-numeric-identifier-creator.d.ts.map

package/dist/serializable-numeric-identifier-creator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializable-numeric-identifier-creator.d.ts","sourceRoot":"","sources":["../src/serializable-numeric-identifier-creator.ts"],"names":[],"mappings":"AACA,OAAO,EAAgC,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAEpH,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,2CAA2C,CAAC;AACnG,OAAO,EAAE,sCAAsC,EAAE,MAAM,gDAAgD,CAAC;;AAExG;;GAEG;AACH,qBAAa,oCAAqC,SAAQ,yCAGjB;;IAgDrC;;;;;;;;;;;;;;;;;;OAkBG;IACH,gBAAgB,CAAC,iBAAiB,SAAS,gBAAgB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAInM;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,iBAAiB,SAAS,gBAAgB,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,2BAA2B,EAAE,iBAAiB,GAAG,iBAAiB,CAAC,iBAAiB,EAAE,MAAM,CAAC;CAKxL"}

package/dist/serializable-numeric-identifier-creator.js

@@ -0,0 +1,93 @@
+// eslint-disable-next-line @typescript-eslint/no-unused-vars -- Used in JSDoc.
+import { mapIterable } from "@aidc-toolkit/utility";
+import { MixinAbstractNonGTINNumericIdentifierCreator } from "./abstract-non-gtin-numeric-identifier-creator.js";
+import { SerializableNumericIdentifierValidator } from "./serializable-numeric-identifier-validator.js";
+/**
+ * Serializable numeric identifier creator.
+ */
+export class SerializableNumericIdentifierCreator extends MixinAbstractNonGTINNumericIdentifierCreator(SerializableNumericIdentifierValidator) {
+    /**
+     * Concatenate a validated base identifier with serial component(s).
+     *
+     * @template TTransformerInput
+     * Transformer input type.
+     *
+     * @param baseIdentifier
+     * Base identifier.
+     *
+     * @param serialComponentOrComponents
+     * Serial component(s).
+     *
+     * @returns
+     * Serialized identifier(s).
+     */
+    #concatenateValidated(baseIdentifier, serialComponentOrComponents) {
+        // TODO Refactor type when https://github.com/microsoft/TypeScript/pull/56941 released.
+        let result;
+        const serialComponentCreator = this.serialComponentCreator;
+        const serialComponentValidation = this.serialComponentValidation;
+        /**
+         * Validate a serial component and concatenate it to the base identifier.
+         *
+         * @param serialComponent
+         * Serial component.
+         *
+         * @returns
+         * Serialized identifier.
+         */
+        function validateAndConcatenate(serialComponent) {
+            serialComponentCreator.validate(serialComponent, serialComponentValidation);
+            return baseIdentifier + serialComponent;
+        }
+        if (typeof serialComponentOrComponents !== "object") {
+            result = validateAndConcatenate(serialComponentOrComponents);
+        }
+        else {
+            result = mapIterable(serialComponentOrComponents, validateAndConcatenate);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Type determination is handled above.
+        return result;
+    }
+    /**
+     * Create serialized identifier(s) with a reference based on a numeric value concatenated with serial component(s).
+     * The value is converted to a reference of the appropriate length using {@linkcode NUMERIC_CREATOR}.
+     *
+     * @template TTransformerInput
+     * Transformer input type.
+     *
+     * @param value
+     * Numeric value of the reference.
+     *
+     * @param serialComponentOrComponents
+     * Serial component(s).
+     *
+     * @param sparse
+     * If true, the value is mapped to a sparse sequence resistant to discovery. Default is false.
+     *
+     * @returns
+     * Serialized identifiers.
+     */
+    createSerialized(value, serialComponentOrComponents, sparse) {
+        return this.#concatenateValidated(this.create(value, sparse), serialComponentOrComponents);
+    }
+    /**
+     * Concatenate a base identifier with serial component(s).
+     *
+     * @template TTransformerInput
+     * Transformer input type.
+     *
+     * @param baseIdentifier
+     * Base identifier.
+     *
+     * @param serialComponentOrComponents
+     * Serial component(s).
+     *
+     * @returns
+     * Serialized identifier(s).
+     */
+    concatenate(baseIdentifier, serialComponentOrComponents) {
+        this.validate(baseIdentifier);
+        return this.#concatenateValidated(baseIdentifier, serialComponentOrComponents);
+    }
+}
+//# sourceMappingURL=serializable-numeric-identifier-creator.js.map

package/dist/serializable-numeric-identifier-creator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializable-numeric-identifier-creator.js","sourceRoot":"","sources":["../src/serializable-numeric-identifier-creator.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAkE,MAAM,uBAAuB,CAAC;AACpH,OAAO,EAAE,4CAA4C,EAAE,MAAM,mDAAmD,CAAC;AAEjH,OAAO,EAAE,sCAAsC,EAAE,MAAM,gDAAgD,CAAC;AAExG;;GAEG;AACH,MAAM,OAAO,oCAAqC,SAAQ,4CAA4C,CAGpG,sCAAsC,CAAC;IACrC;;;;;;;;;;;;;;OAcG;IACH,qBAAqB,CAAqD,cAAsB,EAAE,2BAA8C;QAC5I,uFAAuF;QACvF,IAAI,MAAiC,CAAC;QAEtC,MAAM,sBAAsB,GAAG,IAAI,CAAC,sBAAsB,CAAC;QAC3D,MAAM,yBAAyB,GAAG,IAAI,CAAC,yBAAyB,CAAC;QAEjE;;;;;;;;WAQG;QACH,SAAS,sBAAsB,CAAC,eAAuB;YACnD,sBAAsB,CAAC,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC,CAAC;YAE5E,OAAO,cAAc,GAAG,eAAe,CAAC;QAC5C,CAAC;QAED,IAAI,OAAO,2BAA2B,KAAK,QAAQ,EAAE,CAAC;YAClD,MAAM,GAAG,sBAAsB,CAAC,2BAA2B,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACJ,MAAM,GAAG,WAAW,CAAC,2BAA2B,EAAE,sBAAsB,CAAC,CAAC;QAC9E,CAAC;QAED,+GAA+G;QAC/G,OAAO,MAAsD,CAAC;IAClE,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,gBAAgB,CAAqD,KAAa,EAAE,2BAA8C,EAAE,MAAgB;QAChJ,OAAO,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,2BAA2B,CAAC,CAAC;IAC/F,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAqD,cAAsB,EAAE,2BAA8C;QAClI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAE9B,OAAO,IAAI,CAAC,qBAAqB,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;IACnF,CAAC;CACJ"}

package/dist/serializable-numeric-identifier-descriptor.d.ts

@@ -0,0 +1,26 @@
+import type { ContentCharacterSet } from "./content-character-set.js";
+import type { LeaderTypes } from "./leader-type.js";
+import type { NonGTINNumericIdentifierDescriptor } from "./non-gtin-numeric-identifier-descriptor.js";
+import type { SerializableNumericIdentifierType } from "./serializable-numeric-identifier-type.js";
+/**
+ * Serializable numeric identifier descriptor.
+ */
+export interface SerializableNumericIdentifierDescriptor extends NonGTINNumericIdentifierDescriptor {
+    /**
+     * @inheritDoc
+     */
+    readonly identifierType: SerializableNumericIdentifierType;
+    /**
+     * @inheritDoc
+     */
+    readonly leaderType: typeof LeaderTypes.None;
+    /**
+     * Serial component length.
+     */
+    readonly serialComponentLength: number;
+    /**
+     * Serial component character set.
+     */
+    readonly serialComponentCharacterSet: ContentCharacterSet;
+}
+//# sourceMappingURL=serializable-numeric-identifier-descriptor.d.ts.map

package/dist/serializable-numeric-identifier-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializable-numeric-identifier-descriptor.d.ts","sourceRoot":"","sources":["../src/serializable-numeric-identifier-descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,6CAA6C,CAAC;AACtG,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,2CAA2C,CAAC;AAEnG;;GAEG;AACH,MAAM,WAAW,uCAAwC,SAAQ,kCAAkC;IAC/F;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,iCAAiC,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,WAAW,CAAC,IAAI,CAAC;IAE7C;;OAEG;IACH,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,2BAA2B,EAAE,mBAAmB,CAAC;CAC7D"}

package/dist/serializable-numeric-identifier-descriptor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=serializable-numeric-identifier-descriptor.js.map

package/dist/serializable-numeric-identifier-descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializable-numeric-identifier-descriptor.js","sourceRoot":"","sources":["../src/serializable-numeric-identifier-descriptor.ts"],"names":[],"mappings":""}

package/dist/serializable-numeric-identifier-type.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Serializable numeric identifier types.
+ */
+export declare const SerializableNumericIdentifierTypes: Omit<Omit<Pick<{
+    readonly GTIN: "GTIN";
+    readonly GLN: "GLN";
+    readonly SSCC: "SSCC";
+    readonly GRAI: "GRAI";
+    readonly GIAI: "GIAI";
+    readonly GSRN: "GSRN";
+    readonly GDTI: "GDTI";
+    readonly GINC: "GINC";
+    readonly GSIN: "GSIN";
+    readonly GCN: "GCN";
+    readonly CPID: "CPID";
+    readonly GMN: "GMN";
+}, "GTIN" | "GLN" | "SSCC" | "GRAI" | "GSRN" | "GDTI" | "GSIN" | "GCN">, "GTIN">, "GLN" | "SSCC" | "GSRN" | "GSIN">;
+/**
+ * Serializable numeric identifier type key.
+ */
+export type SerializableNumericIdentifierTypeKey = keyof typeof SerializableNumericIdentifierTypes;
+/**
+ * Serializable numeric identifier type.
+ */
+export type SerializableNumericIdentifierType = typeof SerializableNumericIdentifierTypes[SerializableNumericIdentifierTypeKey];
+//# sourceMappingURL=serializable-numeric-identifier-type.d.ts.map

package/dist/serializable-numeric-identifier-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializable-numeric-identifier-type.d.ts","sourceRoot":"","sources":["../src/serializable-numeric-identifier-type.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;mHAAgF,CAAC;AAEhI;;GAEG;AACH,MAAM,MAAM,oCAAoC,GAAG,MAAM,OAAO,kCAAkC,CAAC;AAEnG;;GAEG;AACH,MAAM,MAAM,iCAAiC,GAAG,OAAO,kCAAkC,CAAC,oCAAoC,CAAC,CAAC"}

package/dist/serializable-numeric-identifier-type.js

@@ -0,0 +1,8 @@
+import { exclude } from "@aidc-toolkit/core";
+import { NonGTINNumericIdentifierTypes } from "./non-gtin-numeric-identifier-type.js";
+import { NonSerializableNumericIdentifierTypes } from "./non-serializable-numeric-identifier-type.js";
+/**
+ * Serializable numeric identifier types.
+ */
+export const SerializableNumericIdentifierTypes = exclude(NonGTINNumericIdentifierTypes, NonSerializableNumericIdentifierTypes);
+//# sourceMappingURL=serializable-numeric-identifier-type.js.map

package/dist/serializable-numeric-identifier-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializable-numeric-identifier-type.js","sourceRoot":"","sources":["../src/serializable-numeric-identifier-type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AACtF,OAAO,EAAE,qCAAqC,EAAE,MAAM,+CAA+C,CAAC;AAEtG;;GAEG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,OAAO,CAAC,6BAA6B,EAAE,qCAAqC,CAAC,CAAC"}

package/dist/serializable-numeric-identifier-validator.d.ts

@@ -0,0 +1,41 @@
+import type { CharacterSetCreator, CharacterSetValidation } from "@aidc-toolkit/utility";
+import type { ContentCharacterSet } from "./content-character-set.js";
+import type { IdentifierValidation } from "./identifier-validator.js";
+import { NonGTINNumericIdentifierValidator } from "./non-gtin-numeric-identifier-validator.js";
+import type { SerializableNumericIdentifierDescriptor } from "./serializable-numeric-identifier-descriptor.js";
+import type { SerializableNumericIdentifierType } from "./serializable-numeric-identifier-type.js";
+/**
+ * Serializable numeric identifier validator. Validates both serialized and non-serialized forms of numeric identifiers
+ * that support serialization.
+ */
+export declare class SerializableNumericIdentifierValidator extends NonGTINNumericIdentifierValidator<SerializableNumericIdentifierType> implements SerializableNumericIdentifierDescriptor {
+    #private;
+    /**
+     * Constructor.
+     *
+     * @param identifierType
+     * Identifier type.
+     */
+    constructor(identifierType: SerializableNumericIdentifierType);
+    /**
+     * Get the serial component length.
+     */
+    get serialComponentLength(): number;
+    /**
+     * Get the serial component character set.
+     */
+    get serialComponentCharacterSet(): ContentCharacterSet;
+    /**
+     * Get the serial component validation parameters.
+     */
+    protected get serialComponentValidation(): CharacterSetValidation;
+    /**
+     * Get the serial component creator.
+     */
+    get serialComponentCreator(): CharacterSetCreator;
+    /**
+     * @inheritDoc
+     */
+    validate(identifier: string, validation?: IdentifierValidation): void;
+}
+//# sourceMappingURL=serializable-numeric-identifier-validator.d.ts.map

package/dist/serializable-numeric-identifier-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializable-numeric-identifier-validator.d.ts","sourceRoot":"","sources":["../src/serializable-numeric-identifier-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEzF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,OAAO,EAAE,iCAAiC,EAAE,MAAM,4CAA4C,CAAC;AAC/F,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,iDAAiD,CAAC;AAC/G,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,2CAA2C,CAAC;AAEnG;;;GAGG;AACH,qBAAa,sCAAuC,SAAQ,iCAAiC,CAAC,iCAAiC,CAAE,YAAW,uCAAuC;;IAqB/K;;;;;OAKG;gBACS,cAAc,EAAE,iCAAiC;IAiB7D;;OAEG;IACH,IAAI,qBAAqB,IAAI,MAAM,CAElC;IAED;;OAEG;IACH,IAAI,2BAA2B,IAAI,mBAAmB,CAErD;IAED;;OAEG;IACH,SAAS,KAAK,yBAAyB,IAAI,sBAAsB,CAEhE;IAED;;OAEG;IACH,IAAI,sBAAsB,IAAI,mBAAmB,CAEhD;IAED;;OAEG;IACM,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,oBAAoB,GAAG,IAAI;CAOjF"}

package/dist/serializable-numeric-identifier-validator.js

@@ -0,0 +1,78 @@
+import { CONTENT_CHARACTER_SET_CREATORS } from "./content-character-set-creators.js";
+import { IdentifierDescriptors } from "./identifier-descriptors.js";
+import { i18nextGS1 } from "./locale/i18n.js";
+import { NonGTINNumericIdentifierValidator } from "./non-gtin-numeric-identifier-validator.js";
+/**
+ * Serializable numeric identifier validator. Validates both serialized and non-serialized forms of numeric identifiers
+ * that support serialization.
+ */
+export class SerializableNumericIdentifierValidator extends NonGTINNumericIdentifierValidator {
+    /**
+     * Serial component length.
+     */
+    #serialComponentLength;
+    /**
+     * Serial component character set.
+     */
+    #serialComponentCharacterSet;
+    /**
+     * Serial component validation parameters.
+     */
+    #serialComponentValidation;
+    /**
+     * Serial component creator.
+     */
+    #serialComponentCreator;
+    /**
+     * Constructor.
+     *
+     * @param identifierType
+     * Identifier type.
+     */
+    constructor(identifierType) {
+        const identifierDescriptor = IdentifierDescriptors[identifierType];
+        super(identifierDescriptor);
+        this.#serialComponentLength = identifierDescriptor.serialComponentLength;
+        this.#serialComponentCharacterSet = identifierDescriptor.serialComponentCharacterSet;
+        this.#serialComponentValidation = {
+            minimumLength: 1,
+            maximumLength: identifierDescriptor.serialComponentLength,
+            component: () => i18nextGS1.t("Identifier.serialComponent")
+        };
+        this.#serialComponentCreator = CONTENT_CHARACTER_SET_CREATORS[identifierDescriptor.serialComponentCharacterSet];
+    }
+    /**
+     * Get the serial component length.
+     */
+    get serialComponentLength() {
+        return this.#serialComponentLength;
+    }
+    /**
+     * Get the serial component character set.
+     */
+    get serialComponentCharacterSet() {
+        return this.#serialComponentCharacterSet;
+    }
+    /**
+     * Get the serial component validation parameters.
+     */
+    get serialComponentValidation() {
+        return this.#serialComponentValidation;
+    }
+    /**
+     * Get the serial component creator.
+     */
+    get serialComponentCreator() {
+        return this.#serialComponentCreator;
+    }
+    /**
+     * @inheritDoc
+     */
+    validate(identifier, validation) {
+        super.validate(identifier.substring(0, this.length), validation);
+        if (identifier.length > this.length) {
+            this.serialComponentCreator.validate(identifier.substring(this.length), this.#serialComponentValidation);
+        }
+    }
+}
+//# sourceMappingURL=serializable-numeric-identifier-validator.js.map

package/dist/serializable-numeric-identifier-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializable-numeric-identifier-validator.js","sourceRoot":"","sources":["../src/serializable-numeric-identifier-validator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAErF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,iCAAiC,EAAE,MAAM,4CAA4C,CAAC;AAI/F;;;GAGG;AACH,MAAM,OAAO,sCAAuC,SAAQ,iCAAoE;IAC5H;;OAEG;IACM,sBAAsB,CAAS;IAExC;;OAEG;IACM,4BAA4B,CAAsB;IAE3D;;OAEG;IACM,0BAA0B,CAAyB;IAE5D;;OAEG;IACM,uBAAuB,CAAsB;IAEtD;;;;;OAKG;IACH,YAAY,cAAiD;QACzD,MAAM,oBAAoB,GAAG,qBAAqB,CAAC,cAAc,CAAC,CAAC;QAEnE,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAE5B,IAAI,CAAC,sBAAsB,GAAG,oBAAoB,CAAC,qBAAqB,CAAC;QACzE,IAAI,CAAC,4BAA4B,GAAG,oBAAoB,CAAC,2BAA2B,CAAC;QAErF,IAAI,CAAC,0BAA0B,GAAG;YAC9B,aAAa,EAAE,CAAC;YAChB,aAAa,EAAE,oBAAoB,CAAC,qBAAqB;YACzD,SAAS,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,4BAA4B,CAAC;SAC9D,CAAC;QAEF,IAAI,CAAC,uBAAuB,GAAG,8BAA8B,CAAC,oBAAoB,CAAC,2BAA2B,CAAC,CAAC;IACpH,CAAC;IAED;;OAEG;IACH,IAAI,qBAAqB;QACrB,OAAO,IAAI,CAAC,sBAAsB,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,IAAI,2BAA2B;QAC3B,OAAO,IAAI,CAAC,4BAA4B,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,IAAc,yBAAyB;QACnC,OAAO,IAAI,CAAC,0BAA0B,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,IAAI,sBAAsB;QACtB,OAAO,IAAI,CAAC,uBAAuB,CAAC;IACxC,CAAC;IAED;;OAEG;IACM,QAAQ,CAAC,UAAkB,EAAE,UAAiC;QACnE,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC;QAEjE,IAAI,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAClC,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC7G,CAAC;IACL,CAAC;CACJ"}

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@aidc-toolkit/gs1",
-  "version": "1.0.25-beta",
+  "version": "1.0.27-beta",
   "description": "GS1 AIDC Toolkit",
   "type": "module",
   "main": "dist/index.js",
   "homepage": "https://aidc-toolkit.com/",
-  "repository": "aidc-toolkit/gs1",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aidc-toolkit/gs1.git"
+  },
   "bugs": {
     "url": "https://github.com/aidc-toolkit/gs1/issues"
   },
@@ -17,18 +20,18 @@
   },
   "scripts": {
     "lint": "eslint",
-    "build:dev": "tsup --define.mode=dev",
-    "build:release": "tsup",
+    "tsc:core": "tsc --project tsconfig-src.json",
+    "build:dev": "rimraf dist && npm run tsc:core -- --declarationMap --sourceMap",
+    "build:release": "npm run tsc:core -- --noEmit && tsup",
     "build:doc": "npm run build:dev",
     "test": "vitest run"
   },
   "devDependencies": {
-    "@aidc-toolkit/dev": "1.0.25-beta",
+    "@aidc-toolkit/dev": "1.0.27-beta",
     "vitest": "^4.0.15"
   },
   "dependencies": {
-    "@aidc-toolkit/core": "1.0.25-beta",
-    "@aidc-toolkit/utility": "1.0.25-beta",
-    "ts-mixer": "^6.0.4"
+    "@aidc-toolkit/core": "1.0.27-beta",
+    "@aidc-toolkit/utility": "1.0.27-beta"
   }
 }