@aidc-toolkit/gs1 1.0.25-beta → 1.0.26-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,76 @@
+import { type TransformerInput, type TransformerOutput } from "@aidc-toolkit/utility";
+import { AbstractNumericIdentifierCreator } from "./abstract-numeric-identifier-creator.js";
+import type { PrefixProvider } from "./prefix-provider.js";
+import type { SerializableNumericIdentifierType } from "./serializable-numeric-identifier-type.js";
+import { SerializableNumericIdentifierValidator } from "./serializable-numeric-identifier-validator.js";
+declare const SerializableNumericIdentifierCreator_base: import("ts-mixer/dist/types/types.js").Class<any[], SerializableNumericIdentifierValidator & AbstractNumericIdentifierCreator<import("./numeric-identifier-descriptor.js").NumericIdentifierDescriptor>, typeof SerializableNumericIdentifierValidator & (abstract new () => AbstractNumericIdentifierCreator<import("./numeric-identifier-descriptor.js").NumericIdentifierDescriptor>)>;
+/**
+ * Serializable numeric identifier creator.
+ */
+export declare class SerializableNumericIdentifierCreator extends SerializableNumericIdentifierCreator_base {
+    /**
+     * Constructor. Typically called internally by a prefix manager but may be called by other code with another prefix
+     * provider type.
+     *
+     * @param prefixProvider
+     * Prefix provider.
+     *
+     * @param identifierType
+     * Identifier type.
+     */
+    constructor(prefixProvider: PrefixProvider, identifierType: SerializableNumericIdentifierType);
+    /**
+     * 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).
+     */
+    private concatenateValidated;
+    /**
+     * 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 a 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":"AAAA,OAAO,EAAe,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAEnG,OAAO,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,2CAA2C,CAAC;AACnG,OAAO,EAAE,sCAAsC,EAAE,MAAM,gDAAgD,CAAC;;AAExG;;GAEG;AACH,qBAAa,oCAAqC,SAAQ,yCAA+E;IACrI;;;;;;;;;OASG;gBACS,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,iCAAiC;IAM7F;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,oBAAoB;IAgC5B;;;;;;;;;;;;;;;;;;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,107 @@
+import { mapIterable } from "@aidc-toolkit/utility";
+import { Mixin } from "ts-mixer";
+import { AbstractNumericIdentifierCreator } from "./abstract-numeric-identifier-creator.js";
+import { SerializableNumericIdentifierValidator } from "./serializable-numeric-identifier-validator.js";
+/**
+ * Serializable numeric identifier creator.
+ */
+export class SerializableNumericIdentifierCreator extends Mixin(SerializableNumericIdentifierValidator, AbstractNumericIdentifierCreator) {
+    /**
+     * Constructor. Typically called internally by a prefix manager but may be called by other code with another prefix
+     * provider type.
+     *
+     * @param prefixProvider
+     * Prefix provider.
+     *
+     * @param identifierType
+     * Identifier type.
+     */
+    constructor(prefixProvider, identifierType) {
+        super(identifierType);
+        this.init(prefixProvider, prefixProvider.gs1CompanyPrefix);
+    }
+    /**
+     * 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 a 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,OAAO,EAAE,WAAW,EAAiD,MAAM,uBAAuB,CAAC;AACnG,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AAG5F,OAAO,EAAE,sCAAsC,EAAE,MAAM,gDAAgD,CAAC;AAExG;;GAEG;AACH,MAAM,OAAO,oCAAqC,SAAQ,KAAK,CAAC,sCAAsC,EAAE,gCAAgC,CAAC;IACrI;;;;;;;;;OASG;IACH,YAAY,cAA8B,EAAE,cAAiD;QACzF,KAAK,CAAC,cAAc,CAAC,CAAC;QAEtB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACK,oBAAoB,CAAqD,cAAsB,EAAE,2BAA8C;QACnJ,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,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,2BAA2B,CAAC,CAAC;IAC9F,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAqD,cAAsB,EAAE,2BAA8C;QAClI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAE9B,OAAO,IAAI,CAAC,oBAAoB,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;IAClF,CAAC;CACJ"}

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

@@ -0,0 +1,26 @@
+import type { ContentCharacterSet } from "./content-character-set.js";
+import type { NonGTINNumericIdentifierDescriptor } from "./non-gtin-numeric-identifier-descriptor.js";
+import type { LeaderTypes } from "./numeric-identifier-type.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,kCAAkC,EAAE,MAAM,6CAA6C,CAAC;AACtG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,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,6 @@
+import type { IdentifierTypes } from "./identifier-type.js";
+/**
+ * Serializable numeric identifier type.
+ */
+export type SerializableNumericIdentifierType = typeof IdentifierTypes.GRAI | typeof IdentifierTypes.GDTI | typeof IdentifierTypes.GCN;
+//# 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":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,iCAAiC,GACzC,OAAO,eAAe,CAAC,IAAI,GAC3B,OAAO,eAAe,CAAC,IAAI,GAC3B,OAAO,eAAe,CAAC,GAAG,CAAC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# 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":""}

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

@@ -0,0 +1,56 @@
+import type { CharacterSetCreator, CharacterSetValidation } from "@aidc-toolkit/utility";
+import { AbstractNumericIdentifierValidator } from "./abstract-numeric-identifier-validator.js";
+import type { ContentCharacterSet } from "./content-character-set.js";
+import type { IdentifierValidation } from "./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 AbstractNumericIdentifierValidator<SerializableNumericIdentifierDescriptor> {
+    /**
+     * Serial component length.
+     */
+    private readonly _serialComponentLength;
+    /**
+     * Serial component character set.
+     */
+    private readonly _serialComponentCharacterSet;
+    /**
+     * Serial component validation parameters.
+     */
+    private readonly _serialComponentValidation;
+    /**
+     * Serial component creator.
+     */
+    private readonly _serialComponentCreator;
+    /**
+     * 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;AACzF,OAAO,EAAE,kCAAkC,EAAE,MAAM,4CAA4C,CAAC;AAChG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,iDAAiD,CAAC;AAC/G,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,2CAA2C,CAAC;AAEnG;;;GAGG;AACH,qBAAa,sCAAuC,SAAQ,kCAAkC,CAAC,uCAAuC,CAAC;IACnI;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAEhD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAAsB;IAEnE;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAyB;IAEpE;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAsB;IAE9D;;;;;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,77 @@
+import { AbstractNumericIdentifierValidator } from "./abstract-numeric-identifier-validator.js";
+import { IdentifierDescriptors } from "./descriptors.js";
+import { i18nextGS1 } from "./locale/i18n.js";
+/**
+ * Serializable numeric identifier validator. Validates both serialized and non-serialized forms of numeric identifiers
+ * that support serialization.
+ */
+export class SerializableNumericIdentifierValidator extends AbstractNumericIdentifierValidator {
+    /**
+     * 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 = SerializableNumericIdentifierValidator.creatorFor(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,kCAAkC,EAAE,MAAM,4CAA4C,CAAC;AAEhG,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI9C;;;GAGG;AACH,MAAM,OAAO,sCAAuC,SAAQ,kCAA2E;IACnI;;OAEG;IACc,sBAAsB,CAAS;IAEhD;;OAEG;IACc,4BAA4B,CAAsB;IAEnE;;OAEG;IACc,0BAA0B,CAAyB;IAEpE;;OAEG;IACc,uBAAuB,CAAsB;IAE9D;;;;;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,sCAAsC,CAAC,UAAU,CAAC,oBAAoB,CAAC,2BAA2B,CAAC,CAAC;IACvI,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"}