@aidc-toolkit/app-extension 1.0.24-beta → 1.0.26-beta

package/src/gs1/identifier-proxy.ts

@@ -1,41 +1,38 @@
 import { isNullish, type Nullishable } from "@aidc-toolkit/core";
 import {
-    CPID_VALIDATOR,
-    GCN_VALIDATOR,
-    GDTI_VALIDATOR,
-    GIAI_VALIDATOR,
-    GINC_VALIDATOR,
-    GLN_VALIDATOR,
-    GMN_VALIDATOR,
-    GRAI_VALIDATOR,
-    GSIN_VALIDATOR,
-    GSRN_VALIDATOR,
-    GTIN12_VALIDATOR,
-    GTIN13_VALIDATOR,
-    GTIN8_VALIDATOR,
     GTINCreator,
+    type GTINDescriptor,
     type GTINLevel,
+    GTINTypes,
     GTINValidator,
     type IdentifierCreator,
+    type IdentifierDescriptor,
+    type IdentifierType,
+    type IdentifierTypes,
+    type IdentifierTypeValidator,
     type IdentifierValidation,
-    type IdentifierValidator,
+    IdentifierValidators,
     type NonGTINNumericIdentifierCreator,
-    type NonGTINNumericIdentifierValidator,
+    type NonGTINNumericIdentifierDescriptor,
+    type NonGTINNumericIdentifierType,
     type NonNumericIdentifierCreator,
+    type NonNumericIdentifierDescriptor,
+    type NonNumericIdentifierType,
     type NonNumericIdentifierValidation,
-    type NonNumericIdentifierValidator,
     type NumericIdentifierCreator,
-    type NumericIdentifierValidator,
+    type NumericIdentifierDescriptor,
+    type NumericIdentifierType,
+    type NumericIdentifierValidation,
     PrefixManager,
     type PrefixType,
     PrefixTypes,
     PrefixValidator,
     type SerializableNumericIdentifierCreator,
-    type SerializableNumericIdentifierValidator,
-    SSCC_VALIDATOR
+    type SerializableNumericIdentifierDescriptor,
+    type SerializableNumericIdentifierType
 } from "@aidc-toolkit/gs1";
 import { Sequence } from "@aidc-toolkit/utility";
-import type { AppExtension } from "../app-extension";
+import type { AppExtension } from "../app-extension.js";
 import {
     expandParameterDescriptor,
     type ParameterDescriptor,
@@ -43,17 +40,17 @@ import {
     ProxyMethod,
     ProxyParameter,
     Types
-} from "../descriptor";
-import { LibProxy } from "../lib-proxy";
-import { i18nextAppExtension } from "../locale/i18n";
-import type { ErrorExtends, Matrix, MatrixResultError } from "../type";
-import { exclusionAllNumericParameterDescriptor } from "../utility/character-set-descriptor";
-import { StringProxy } from "../utility/string-proxy";
+} from "../descriptor.js";
+import { LibProxy } from "../lib-proxy.js";
+import { i18nextAppExtension } from "../locale/i18n.js";
+import type { ErrorExtends, Matrix, MatrixResultError } from "../type.js";
+import { exclusionAllNumericParameterDescriptor } from "../utility/character-set-descriptor.js";
+import { StringProxy } from "../utility/string-proxy.js";
 import {
     countParameterDescriptor,
     startValueParameterDescriptor,
     valueParameterDescriptor
-} from "../utility/transformer-descriptor";
+} from "../utility/transformer-descriptor.js";
 
 const identifierParameterDescriptor: ParameterDescriptor = {
     name: "identifier",
@@ -68,21 +65,21 @@ const validateIdentifierParameterDescriptor: ParameterDescriptor = {
     name: "validateIdentifier"
 };
 
-abstract class IdentifierValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt, TIdentifierValidation extends IdentifierValidation, TIdentifierValidator extends IdentifierValidator<TIdentifierValidation>> extends StringProxy<ThrowError, TError, TInvocationContext, TBigInt> {
-    private readonly _validator: TIdentifierValidator;
+abstract class IdentifierValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt, TIdentifierType extends IdentifierType> extends StringProxy<ThrowError, TError, TInvocationContext, TBigInt> {
+    private readonly _validator: IdentifierTypeValidator<TIdentifierType>;
 
-    protected constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>, validator: TIdentifierValidator) {
+    protected constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>, validator: IdentifierTypeValidator<TIdentifierType>) {
         super(appExtension);
 
         this._validator = validator;
     }
 
-    protected get validator(): TIdentifierValidator {
+    protected get validator(): IdentifierTypeValidator<TIdentifierType> {
         return this._validator;
     }
 }
 
-abstract class NumericIdentifierValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt, TNumericIdentifierValidator extends NumericIdentifierValidator> extends IdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt, IdentifierValidation, TNumericIdentifierValidator> {
+abstract class NumericIdentifierValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt, TNumericIdentifierType extends NumericIdentifierType> extends IdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt, TNumericIdentifierType> {
     @ProxyMethod({
         type: Types.String,
         isMatrix: true
@@ -94,16 +91,16 @@ abstract class NumericIdentifierValidatorProxy<ThrowError extends boolean, TErro
     }
 }
 
-abstract class GTINValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt, GTINValidator> {
+abstract class GTINValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt, typeof IdentifierTypes.GTIN> {
 }
 
-abstract class NonGTINNumericIdentifierValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt, TNonGTINNumericIdentifierValidator extends NonGTINNumericIdentifierValidator> extends NumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt, TNonGTINNumericIdentifierValidator> {
+abstract class NonGTINNumericIdentifierValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt, TNonGTINNumericIdentifierType extends NonGTINNumericIdentifierType = NonGTINNumericIdentifierType> extends NumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt, TNonGTINNumericIdentifierType> {
 }
 
-abstract class SerializableNumericIdentifierValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt, SerializableNumericIdentifierValidator> {
+abstract class SerializableNumericIdentifierValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt, SerializableNumericIdentifierType> {
 }
 
-abstract class NonNumericIdentifierValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends IdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt, NonNumericIdentifierValidation, NonNumericIdentifierValidator> {
+abstract class NonNumericIdentifierValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends IdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt, NonNumericIdentifierType> {
     @ProxyMethod({
         type: Types.String,
         isMatrix: true
@@ -124,7 +121,7 @@ abstract class NonNumericIdentifierValidatorProxy<ThrowError extends boolean, TE
 })
 export class GTIN13ValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends GTINValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
-        super(appExtension, GTIN13_VALIDATOR);
+        super(appExtension, IdentifierValidators.GTIN[GTINTypes.GTIN13]);
     }
 }
 
@@ -134,7 +131,7 @@ export class GTIN13ValidatorProxy<ThrowError extends boolean, TError extends Err
 })
 export class GTIN12ValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends GTINValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
-        super(appExtension, GTIN12_VALIDATOR);
+        super(appExtension, IdentifierValidators.GTIN[GTINTypes.GTIN12]);
     }
 }
 
@@ -144,7 +141,7 @@ export class GTIN12ValidatorProxy<ThrowError extends boolean, TError extends Err
 })
 export class GTIN8ValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends GTINValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
-        super(appExtension, GTIN8_VALIDATOR);
+        super(appExtension, IdentifierValidators.GTIN[GTINTypes.GTIN8]);
     }
 }
 
@@ -312,9 +309,9 @@ export class GTINValidatorStaticProxy<ThrowError extends boolean, TError extends
     namespace: "GS1",
     methodInfix: "GLN"
 })
-export class GLNValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt, NonGTINNumericIdentifierValidator> {
+export class GLNValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
-        super(appExtension, GLN_VALIDATOR);
+        super(appExtension, IdentifierValidators.GLN);
     }
 }
 
@@ -322,9 +319,9 @@ export class GLNValidatorProxy<ThrowError extends boolean, TError extends ErrorE
     namespace: "GS1",
     methodInfix: "SSCC"
 })
-export class SSCCValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt, NonGTINNumericIdentifierValidator> {
+export class SSCCValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
-        super(appExtension, SSCC_VALIDATOR);
+        super(appExtension, IdentifierValidators.SSCC);
     }
 }
 
@@ -334,7 +331,7 @@ export class SSCCValidatorProxy<ThrowError extends boolean, TError extends Error
 })
 export class GRAIValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends SerializableNumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
-        super(appExtension, GRAI_VALIDATOR);
+        super(appExtension, IdentifierValidators.GRAI);
     }
 }
 
@@ -344,7 +341,7 @@ export class GRAIValidatorProxy<ThrowError extends boolean, TError extends Error
 })
 export class GIAIValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonNumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
-        super(appExtension, GIAI_VALIDATOR);
+        super(appExtension, IdentifierValidators.GIAI);
     }
 }
 
@@ -352,9 +349,9 @@ export class GIAIValidatorProxy<ThrowError extends boolean, TError extends Error
     namespace: "GS1",
     methodInfix: "GSRN"
 })
-export class GSRNValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt, NonGTINNumericIdentifierValidator> {
+export class GSRNValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
-        super(appExtension, GSRN_VALIDATOR);
+        super(appExtension, IdentifierValidators.GSRN);
     }
 }
 
@@ -364,7 +361,7 @@ export class GSRNValidatorProxy<ThrowError extends boolean, TError extends Error
 })
 export class GDTIValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends SerializableNumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
-        super(appExtension, GDTI_VALIDATOR);
+        super(appExtension, IdentifierValidators.GDTI);
     }
 }
 
@@ -374,7 +371,7 @@ export class GDTIValidatorProxy<ThrowError extends boolean, TError extends Error
 })
 export class GINCValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonNumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
-        super(appExtension, GINC_VALIDATOR);
+        super(appExtension, IdentifierValidators.GINC);
     }
 }
 
@@ -382,9 +379,9 @@ export class GINCValidatorProxy<ThrowError extends boolean, TError extends Error
     namespace: "GS1",
     methodInfix: "GSIN"
 })
-export class GSINValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt, NonGTINNumericIdentifierValidator> {
+export class GSINValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
-        super(appExtension, GSIN_VALIDATOR);
+        super(appExtension, IdentifierValidators.GSIN);
     }
 }
 
@@ -394,7 +391,7 @@ export class GSINValidatorProxy<ThrowError extends boolean, TError extends Error
 })
 export class GCNValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends SerializableNumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
-        super(appExtension, GCN_VALIDATOR);
+        super(appExtension, IdentifierValidators.GCN);
     }
 }
 
@@ -404,7 +401,7 @@ export class GCNValidatorProxy<ThrowError extends boolean, TError extends ErrorE
 })
 export class CPIDValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonNumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
-        super(appExtension, CPID_VALIDATOR);
+        super(appExtension, IdentifierValidators.CPID);
     }
 }
 
@@ -414,7 +411,7 @@ export class CPIDValidatorProxy<ThrowError extends boolean, TError extends Error
 })
 export class GMNValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonNumericIdentifierValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
-        super(appExtension, GMN_VALIDATOR);
+        super(appExtension, IdentifierValidators.GMN);
     }
 }
 
@@ -474,8 +471,8 @@ export class PrefixManagerProxy<ThrowError extends boolean, TError extends Error
     }
 }
 
-abstract class IdentifierCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt, TIdentifierCreator extends IdentifierCreator> extends LibProxy<ThrowError, TError, TInvocationContext, TBigInt> {
-    private static readonly PREFIX_TYPES: PrefixType[] = [PrefixTypes.GS1CompanyPrefix, PrefixTypes.UPCCompanyPrefix, PrefixTypes.GS18Prefix];
+abstract class IdentifierCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt, TIdentifierDescriptor extends IdentifierDescriptor, TIdentifierValidation extends IdentifierValidation, TIdentifierCreator extends IdentifierCreator<TIdentifierDescriptor, TIdentifierValidation>> extends LibProxy<ThrowError, TError, TInvocationContext, TBigInt> {
+    private static readonly PREFIX_TYPES: Array<PrefixType | undefined> = [PrefixTypes.GS1CompanyPrefix, PrefixTypes.UPCCompanyPrefix, PrefixTypes.GS18Prefix];
 
     private readonly _getCreator: (prefixManager: PrefixManager) => TIdentifierCreator;
 
@@ -515,7 +512,14 @@ abstract class IdentifierCreatorProxy<ThrowError extends boolean, TError extends
             }));
         }
 
-        const prefixManager = PrefixManager.get(IdentifierCreatorProxy.PREFIX_TYPES[prefixTypeIndex], prefix);
+        const prefixType = IdentifierCreatorProxy.PREFIX_TYPES[prefixTypeIndex];
+        
+        // Undefined is included in type in case of invalid input.
+        if (prefixType === undefined) {
+            throw new RangeError(i18nextAppExtension.t("IdentifierCreatorProxy.invalidPrefixType"));
+        }
+        
+        const prefixManager = PrefixManager.get(prefixType, prefix);
 
         const tweakFactor = reducedPrefixDefinition[2];
         
@@ -540,7 +544,7 @@ const sparseParameterDescriptor: ParameterDescriptor = {
     isRequired: false
 };
 
-abstract class NumericIdentifierCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt, TNumericIdentifierCreator extends NumericIdentifierCreator> extends IdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, TNumericIdentifierCreator> {
+abstract class NumericIdentifierCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt, TNumericIdentifierDescriptor extends NumericIdentifierDescriptor, TNumericIdentifierCreator extends NumericIdentifierCreator<TNumericIdentifierDescriptor>> extends IdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, TNumericIdentifierDescriptor, NumericIdentifierValidation, TNumericIdentifierCreator> {
     @ProxyMethod({
         type: Types.String,
         isMatrix: true
@@ -588,7 +592,7 @@ abstract class NumericIdentifierCreatorProxy<ThrowError extends boolean, TError
     }
 }
 
-abstract class NonGTINNumericIdentifierCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt, TNonGTINNumericIdentifierCreator extends NonGTINNumericIdentifierCreator> extends NumericIdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, TNonGTINNumericIdentifierCreator> {
+abstract class NonGTINNumericIdentifierCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt, TNonGTINNumericIdentifierDescriptor extends NonGTINNumericIdentifierDescriptor, TNonGTINNumericIdentifierCreator extends NonGTINNumericIdentifierCreator> extends NumericIdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, TNonGTINNumericIdentifierDescriptor, TNonGTINNumericIdentifierCreator> {
 }
 
 const singleValueParameterDescriptor: ParameterDescriptor = {
@@ -609,7 +613,7 @@ const serialComponentParameterDescriptor: ParameterDescriptor = {
     isRequired: true
 };
 
-abstract class SerializableNumericIdentifierCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, SerializableNumericIdentifierCreator> {
+abstract class SerializableNumericIdentifierCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, SerializableNumericIdentifierDescriptor, SerializableNumericIdentifierCreator> {
     @ProxyMethod({
         type: Types.String,
         isMatrix: true
@@ -648,7 +652,7 @@ const referenceParameterDescriptor: ParameterDescriptor = {
     isRequired: true
 };
 
-abstract class NonNumericIdentifierCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends IdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, NonNumericIdentifierCreator> {
+abstract class NonNumericIdentifierCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends IdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, NonNumericIdentifierDescriptor, NonNumericIdentifierValidation, NonNumericIdentifierCreator> {
     @ProxyMethod({
         type: Types.String,
         isMatrix: true
@@ -673,7 +677,7 @@ abstract class NonNumericIdentifierCreatorProxy<ThrowError extends boolean, TErr
         }
     ]
 })
-export class GTINCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NumericIdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, GTINCreator> {
+export class GTINCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NumericIdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, GTINDescriptor, GTINCreator> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
         super(appExtension, prefixManager => prefixManager.gtinCreator);
     }
@@ -714,7 +718,7 @@ export class GTINCreatorProxy<ThrowError extends boolean, TError extends ErrorEx
     namespace: "GS1",
     methodInfix: "GLN"
 })
-export class GLNCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, NonGTINNumericIdentifierCreator> {
+export class GLNCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, NonGTINNumericIdentifierDescriptor, NonGTINNumericIdentifierCreator> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
         super(appExtension, prefixManager => prefixManager.glnCreator);
     }
@@ -724,7 +728,7 @@ export class GLNCreatorProxy<ThrowError extends boolean, TError extends ErrorExt
     namespace: "GS1",
     methodInfix: "SSCC"
 })
-export class SSCCCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, NonGTINNumericIdentifierCreator> {
+export class SSCCCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, NonGTINNumericIdentifierDescriptor, NonGTINNumericIdentifierCreator> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
         super(appExtension, prefixManager => prefixManager.ssccCreator);
     }
@@ -754,7 +758,7 @@ export class GIAICreatorProxy<ThrowError extends boolean, TError extends ErrorEx
     namespace: "GS1",
     methodInfix: "GSRN"
 })
-export class GSRNCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, NonGTINNumericIdentifierCreator> {
+export class GSRNCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, NonGTINNumericIdentifierDescriptor, NonGTINNumericIdentifierCreator> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
         super(appExtension, prefixManager => prefixManager.gsrnCreator);
     }
@@ -784,7 +788,7 @@ export class GINCCreatorProxy<ThrowError extends boolean, TError extends ErrorEx
     namespace: "GS1",
     methodInfix: "GSIN"
 })
-export class GSINCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, NonGTINNumericIdentifierCreator> {
+export class GSINCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends NonGTINNumericIdentifierCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt, NonGTINNumericIdentifierDescriptor, NonGTINNumericIdentifierCreator> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
         super(appExtension, prefixManager => prefixManager.gsinCreator);
     }

package/src/gs1/index.ts

@@ -1,3 +1,3 @@
-export * from "./character-set-proxy";
-export * from "./check-proxy";
-export * from "./identifier-proxy";
+export * from "./character-set-proxy.js";
+export * from "./check-proxy.js";
+export * from "./identifier-proxy.js";

package/src/index.ts

@@ -14,12 +14,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export * from "./locale/i18n";
-export type * from "./type";
-export * from "./app-extension";
-export * from "./lib-proxy";
-export * from "./descriptor";
-export * from "./app-utility-proxy";
-export * from "./utility/index";
-export * as GS1 from "./gs1/index";
-export * from "./generator/index";
+export * from "./locale/i18n.js";
+export type * from "./type.js";
+export * from "./app-extension.js";
+export * from "./lib-proxy.js";
+export * from "./descriptor.js";
+export * from "./app-utility-proxy.js";
+export * from "./utility/index.js";
+export * as GS1 from "./gs1/index.js";
+export * from "./generator/index.js";

package/src/lib-proxy.ts

@@ -1,7 +1,7 @@
 import { mapIterable } from "@aidc-toolkit/utility";
-import type { AppExtension } from "./app-extension";
-import { i18nextAppExtension } from "./locale/i18n";
-import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "./type";
+import type { AppExtension } from "./app-extension.js";
+import { i18nextAppExtension } from "./locale/i18n.js";
+import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "./type.js";
 
 /**
  * Library proxy.

package/src/locale/en/locale-resources.ts

@@ -12,6 +12,7 @@ export default {
         prefixDefinitionMustHaveMaximumThreeElements: "Prefix definition must have a maximum of 3 elements",
         prefixMustBeString: "Prefix must be a string",
         prefixTypeMustBeNumber: "Prefix type must be a number in the range of 0 to {{maximumPrefixType, number}}",
+        invalidPrefixType: "Invalid prefix type",
         tweakFactorMustBeNumber: "Tweak factor must be a number"
     },
     Parameters: {
@@ -354,6 +355,14 @@ export default {
                 name: "valueForAI39",
                 description: "Get the value for a GS1 AI 39 encodable character set string."
             },
+            validateAI64: {
+                name: "validateAI64",
+                description: "Validate a GS1 AI 64 encodable character set string."
+            },
+            isValidAI64: {
+                name: "isValidAI64",
+                description: "Determine if a string is GS1 AI 64 encodable character set."
+            },
             checkDigit: {
                 name: "checkDigit",
                 description: "Calculate the check digit for a numeric string."

package/src/locale/fr/locale-resources.ts

@@ -12,6 +12,7 @@ export default {
         prefixDefinitionMustHaveMaximumThreeElements: "La définition du préfixe doit comporter un maximum de 3 éléments",
         prefixMustBeString: "Le préfixe doit être une chaîne",
         prefixTypeMustBeNumber: "Le type de préfixe doit être un nombre compris entre 0 et {{maximumPrefixType, number}}",
+        invalidPrefixType: "Type de préfixe invalide",
         tweakFactorMustBeNumber: "Le facteur de réglage doit être un nombre"
     },
     Parameters: {
@@ -354,6 +355,14 @@ export default {
                 name: "valeurDeAI39",
                 description: "Obtenez la valeur d'une chaîne de caractères GS1 AI 39."
             },
+            validateAI64: {
+                name: "validerAI64",
+                description: "Valider une chaîne de caractères GS1 AI 64."
+            },
+            isValidAI64: {
+                name: "estValideAI64",
+                description: "Déterminer si une chaîne est un jeu de caractères GS1 AI 64."
+            },
             checkDigit: {
                 name: "chiffreDeControle",
                 description: "Calculer le chiffre de contrôle pour une chaîne numérique."

package/src/locale/i18n.ts

@@ -2,8 +2,8 @@ import { i18nCoreInit, type I18nEnvironment } from "@aidc-toolkit/core";
 import { gs1Resources, i18nGS1Init } from "@aidc-toolkit/gs1";
 import { i18nUtilityInit, utilityResources } from "@aidc-toolkit/utility";
 import i18next, { type i18n, type Resource } from "i18next";
-import enLocaleResources from "./en/locale-resources";
-import frLocaleResources from "./fr/locale-resources";
+import enLocaleResources from "./en/locale-resources.js";
+import frLocaleResources from "./fr/locale-resources.js";
 
 export const appExtensionNS = "aidct_app_extension";
 
@@ -24,7 +24,7 @@ export const appExtensionResources: Resource = {
     }
 };
 
-// Explicit type is necessary to work around bug in type discovery with linked packages.
+// Explicit type is necessary because type can't be inferred without additional references.
 export const i18nextAppExtension: i18n = i18next.createInstance();
 
 /**

package/src/locale/i18next.d.ts

@@ -1,6 +1,6 @@
 import type { GS1LocaleResources } from "@aidc-toolkit/gs1";
 import type { UtilityLocaleResources } from "@aidc-toolkit/utility";
-import type { AppExtensionLocaleResources } from "./i18n";
+import type { AppExtensionLocaleResources } from "./i18n.js";
 
 /**
  * Internationalization module.

package/src/type.ts

@@ -1,6 +1,6 @@
 /**
  * Type that error type is expected to extend. If the application framework reports errors through the throw/catch
- * mechanism, the error type is expected to extend {@link Error}. Otherwise, it may extend any object type.
+ * mechanism, the error type is expected to extend {@linkcode Error}. Otherwise, it may extend any object type.
  *
  * @template ThrowError
  * If true, errors are reported through the throw/catch mechanism.

package/src/utility/character-set-descriptor.ts

@@ -1,4 +1,4 @@
-import { type ParameterDescriptor, Types } from "../descriptor";
+import { type ParameterDescriptor, Types } from "../descriptor.js";
 
 const exclusionParameterDescriptor: ParameterDescriptor = {
     name: "exclusion",

package/src/utility/character-set-proxy.ts

@@ -4,12 +4,13 @@ import {
     ALPHANUMERIC_CREATOR,
     type CharacterSetCreator,
     type CharacterSetValidation,
+    type CharacterSetValidator,
     type Exclusion,
     HEXADECIMAL_CREATOR,
     NUMERIC_CREATOR,
     Sequence
 } from "@aidc-toolkit/utility";
-import type { AppExtension } from "../app-extension";
+import type { AppExtension } from "../app-extension.js";
 import {
     expandParameterDescriptor,
     type ParameterDescriptor,
@@ -17,22 +18,22 @@ import {
     ProxyMethod,
     ProxyParameter,
     Types
-} from "../descriptor";
-import { LibProxy } from "../lib-proxy";
-import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "../type";
+} from "../descriptor.js";
+import { LibProxy } from "../lib-proxy.js";
+import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "../type.js";
 import {
     exclusionAnyParameterDescriptor,
     exclusionFirstZeroParameterDescriptor,
     exclusionNoneParameterDescriptor
-} from "./character-set-descriptor";
-import { sParameterDescriptor, validateSParameterDescriptor } from "./string-descriptor";
-import { StringProxy } from "./string-proxy";
+} from "./character-set-descriptor.js";
+import { sParameterDescriptor, validateSParameterDescriptor } from "./string-descriptor.js";
+import { StringProxy } from "./string-proxy.js";
 import {
     countParameterDescriptor,
     startValueParameterDescriptor,
     tweakParameterDescriptor,
     valueParameterDescriptor
-} from "./transformer-descriptor";
+} from "./transformer-descriptor.js";
 
 const lengthParameterDescriptor: ParameterDescriptor = {
     name: "length",
@@ -46,13 +47,13 @@ const valueForSParameterDescriptor: ParameterDescriptor = {
     name: "valueForS"
 };
 
-export abstract class CharacterSetProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends StringProxy<ThrowError, TError, TInvocationContext, TBigInt> {
-    private readonly _characterSetCreator: CharacterSetCreator;
+export abstract class CharacterSetValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends StringProxy<ThrowError, TError, TInvocationContext, TBigInt> {
+    private readonly _characterSetValidator: CharacterSetValidator;
 
-    protected constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>, characterSetCreator: CharacterSetCreator) {
+    protected constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>, characterSetValidator: CharacterSetValidator) {
         super(appExtension);
 
-        this._characterSetCreator = characterSetCreator;
+        this._characterSetValidator = characterSetValidator;
     }
 
     @ProxyMethod({
@@ -63,7 +64,7 @@ export abstract class CharacterSetProxy<ThrowError extends boolean, TError exten
         @ProxyParameter(validateSParameterDescriptor) matrixSs: Matrix<string>,
         @ProxyParameter(exclusionNoneParameterDescriptor) exclusion: Nullishable<Exclusion>
     ): MatrixResultError<string, ThrowError, TError> {
-        return this.validateString(this._characterSetCreator, matrixSs, {
+        return this.validateString(this._characterSetValidator, matrixSs, {
             exclusion: exclusion ?? undefined
         } satisfies CharacterSetValidation);
     }
@@ -78,6 +79,16 @@ export abstract class CharacterSetProxy<ThrowError extends boolean, TError exten
     ): MatrixResultError<boolean, ThrowError, TError> {
         return this.isValidString(this.validate(matrixSs, exclusion));
     }
+}
+
+export abstract class CharacterSetCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends CharacterSetValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
+    private readonly _characterSetCreator: CharacterSetCreator;
+
+    protected constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>, characterSetCreator: CharacterSetCreator) {
+        super(appExtension, characterSetCreator);
+
+        this._characterSetCreator = characterSetCreator;
+    }
 
     @ProxyMethod({
         type: Types.String,
@@ -140,7 +151,7 @@ export abstract class CharacterSetProxy<ThrowError extends boolean, TError exten
         }
     ]
 })
-export class NumericProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends CharacterSetProxy<ThrowError, TError, TInvocationContext, TBigInt> {
+export class NumericProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends CharacterSetCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
         super(appExtension, NUMERIC_CREATOR);
     }
@@ -155,7 +166,7 @@ export class NumericProxy<ThrowError extends boolean, TError extends ErrorExtend
         }
     ]
 })
-export class HexadecimalProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends CharacterSetProxy<ThrowError, TError, TInvocationContext, TBigInt> {
+export class HexadecimalProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends CharacterSetCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
         super(appExtension, HEXADECIMAL_CREATOR);
     }
@@ -164,7 +175,7 @@ export class HexadecimalProxy<ThrowError extends boolean, TError extends ErrorEx
 @ProxyClass({
     methodInfix: "Alphabetic"
 })
-export class AlphabeticProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends CharacterSetProxy<ThrowError, TError, TInvocationContext, TBigInt> {
+export class AlphabeticProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends CharacterSetCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
         super(appExtension, ALPHABETIC_CREATOR);
     }
@@ -179,7 +190,7 @@ export class AlphabeticProxy<ThrowError extends boolean, TError extends ErrorExt
         }
     ]
 })
-export class AlphanumericProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends CharacterSetProxy<ThrowError, TError, TInvocationContext, TBigInt> {
+export class AlphanumericProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends CharacterSetCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
         super(appExtension, ALPHANUMERIC_CREATOR);
     }