@aidc-toolkit/gs1 1.0.32-beta → 1.0.34-beta

package/src/gcp-length-cache.ts

@@ -1,74 +1,222 @@
-import { Cache } from "@aidc-toolkit/core";
-import { type GCPLengthData, type GCPLengthHeader, parseGCPLengthHeader } from "./gcp-length-data.js";
+import { type AppData, type AppDataStorage, Cache, omit, RemoteAppDataStorage } from "@aidc-toolkit/core";
+import {
+    type GCPLengthAppData,
+    type GCPLengthData,
+    type GCPLengthHeader,
+    type GCPLengthSourceJSON,
+    isGCPLengthAppData,
+    isGCPLengthHeader
+} from "./gcp-length-data.js";
 import { i18nextGS1 } from "./locale/i18n.js";
 
 /**
  * GS1 Company Prefix length cache.
  */
-export abstract class GCPLengthCache extends Cache<GCPLengthData, GCPLengthData | string> {
-}
+export abstract class GCPLengthCache extends Cache<GCPLengthData, GCPLengthData | GCPLengthSourceJSON> {
+    /**
+     * Storage key for full application data object.
+     */
+    static APP_DATA_STORAGE_KEY = "gcp-length";
 
-/**
- * GS1 Company Prefix length cache with remote source.
- */
-export abstract class RemoteGCPLengthCache extends GCPLengthCache {
     /**
-     * Default base URL pointing to AIDC Toolkit website data directory.
+     * Storage key for next check date/time.
      */
-    static DEFAULT_BASE_URL = "https://aidc-toolkit.com/data/";
+    static NEXT_CHECK_DATE_TIME_STORAGE_KEY = "gcp-length-next-check-date-time";
 
     /**
-     * File containing header information (date/time and disclaimer).
+     * Storage key for header information (date/time and disclaimer).
      */
-    static SOURCE_HEADER_FILE_NAME = "gcp-length-header.json";
+    static HEADER_STORAGE_KEY = "gcp-length-header";
 
     /**
-     * File containing tree data in binary form.
+     * Storage key for data only.
      */
-    static SOURCE_DATA_FILE_NAME = "gcp-length-data.bin";
+    static DATA_STORAGE_KEY = "gcp-length-data";
 
     /**
-     * Base URL.
+     * Application data storage.
      */
-    readonly #baseURL: string;
+    readonly #appDataStorage: AppDataStorage<boolean>;
 
     /**
-     * GS1 Company Prefix header data.
+     * GS1 Company Prefix application data.
      */
-    #gcpLengthHeader?: GCPLengthHeader | undefined;
+    #cacheGCPLengthAppData?: GCPLengthAppData | undefined;
 
     /**
      * Constructor.
      *
-     * @param baseURL
-     * Base URL. The URL must end with a slash, and must host the {@linkcode SOURCE_HEADER_FILE_NAME} and {@linkcode
-     * SOURCE_DATA_FILE_NAME} files.
+     * @param appDataStorage
+     * Application data storage.
      */
-    constructor(baseURL: string = RemoteGCPLengthCache.DEFAULT_BASE_URL) {
+    constructor(appDataStorage: AppDataStorage<boolean>) {
         super();
 
-        this.#baseURL = baseURL;
+        this.#appDataStorage = appDataStorage;
     }
 
     /**
-     * Get a remote file. If an exception is thrown, retrying is delayed for ten minutes to prevent repeated network
-     * calls.
+     * Get the application data storage.
+     */
+    get appDataStorage(): AppDataStorage<boolean> {
+        return this.#appDataStorage;
+    }
+
+    /**
+     * Load cached GS1 Company Prefix length application data from application data storage.
      *
-     * @param fileName
-     * File name relative to base URL.
+     * @returns
+     * GS1 Company Prefix length application data.
+     */
+    async #loadCache(): Promise<GCPLengthAppData> {
+        if (this.#cacheGCPLengthAppData === undefined) {
+            if (!this.appDataStorage.supportsBinary) {
+                // Everything is stored in a single object.
+                const appData = await this.appDataStorage.read(GCPLengthCache.APP_DATA_STORAGE_KEY);
+
+                if (isGCPLengthAppData(appData)) {
+                    this.#cacheGCPLengthAppData = appData;
+                }
+            } else {
+                const nextCheckDateTime = await this.appDataStorage.read(GCPLengthCache.NEXT_CHECK_DATE_TIME_STORAGE_KEY);
+                const header = await this.appDataStorage.read(GCPLengthCache.HEADER_STORAGE_KEY);
+                const data = await this.appDataStorage.read(GCPLengthCache.DATA_STORAGE_KEY, true);
+
+                this.#cacheGCPLengthAppData = {
+                    nextCheckDateTime: nextCheckDateTime instanceof Date ? nextCheckDateTime : undefined,
+                    gcpLengthData: isGCPLengthHeader(header) && data instanceof Uint8Array ?
+                        {
+                            ...header,
+                            data
+                        } :
+                        undefined
+                };
+            }
+        }
+
+        // If there's nothing in the cache yet, create an object with the next check date/time set to now.
+        if (this.#cacheGCPLengthAppData === undefined) {
+            this.#cacheGCPLengthAppData = {
+                nextCheckDateTime: new Date(),
+                gcpLengthData: undefined
+            };
+        }
+
+        return this.#cacheGCPLengthAppData;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    override get nextCheckDateTime(): Promise<Date | undefined> {
+        return this.#loadCache().then(gcpLengthAppData => gcpLengthAppData.nextCheckDateTime);
+    }
+
+    /**
+     * @inheritDoc
+     */
+    override get cacheDateTime(): Promise<Date | undefined> {
+        return this.#loadCache().then(gcpLengthAppData => gcpLengthAppData.gcpLengthData?.dateTime);
+    }
+
+    /**
+     * @inheritDoc
+     */
+    override get cacheData(): Promise<GCPLengthData> {
+        return this.#loadCache().then((gcpLengthAppData) => {
+            if (gcpLengthAppData.gcpLengthData === undefined) {
+                // Application error; no localization necessary.
+                throw new Error("GS1 Company Prefix length application data not loaded");
+            }
+
+            return gcpLengthAppData.gcpLengthData;
+        });
+    }
+
+    /**
+     * @inheritDoc
+     */
+    override async update(nextCheckDateTime: Date, _cacheDateTime?: Date, cacheData?: GCPLengthData): Promise<void> {
+        this.#cacheGCPLengthAppData = {
+            nextCheckDateTime,
+            // Retain existing data if cache data is not provided.
+            gcpLengthData: cacheData ?? this.#cacheGCPLengthAppData?.gcpLengthData
+        };
+
+        if (!this.appDataStorage.supportsBinary) {
+            // Everything is stored in a single object.
+            await this.appDataStorage.write(GCPLengthCache.APP_DATA_STORAGE_KEY, this.#cacheGCPLengthAppData);
+        } else {
+            await this.appDataStorage.write(GCPLengthCache.NEXT_CHECK_DATE_TIME_STORAGE_KEY, nextCheckDateTime);
+
+            if (cacheData !== undefined) {
+                await this.appDataStorage.write(GCPLengthCache.HEADER_STORAGE_KEY, omit(cacheData, "data"));
+                await this.appDataStorage.write(GCPLengthCache.DATA_STORAGE_KEY, cacheData.data);
+            }
+        }
+    }
+}
+
+/**
+ * GS1 Company Prefix length cache with remote source.
+ */
+export class RemoteGCPLengthCache extends GCPLengthCache {
+    /**
+     * Default base URL pointing to AIDC Toolkit website data directory.
+     */
+    static DEFAULT_BASE_URL = "https://aidc-toolkit.com/data";
+
+    /**
+     * Remote application data storage.
+     */
+    readonly #remoteAppDataStorage: RemoteAppDataStorage;
+
+    /**
+     * Remote GS1 Company Prefix header data.
+     */
+    #remoteGCPLengthHeader?: GCPLengthHeader | undefined;
+
+    /**
+     * Constructor.
+     *
+     * @param appDataStorage
+     * Application data storage.
+     *
+     * @param baseURL
+     * Base URL. The URL must not end with a slash and must host the `gcp-length-header.json` and `gcp-length-data.bin`
+     * files.
+     */
+    constructor(appDataStorage: AppDataStorage<boolean>, baseURL: string = RemoteGCPLengthCache.DEFAULT_BASE_URL) {
+        super(appDataStorage);
+
+        this.#remoteAppDataStorage = new RemoteAppDataStorage(baseURL);
+    }
+
+    /**
+     * Get remote application data. If an exception is thrown while retrieving or processing the data, retrying is
+     * delayed for ten minutes to prevent repeated network calls.
+     *
+     * @param pathKey
+     * Key relative to base URL.
+     *
+     * @param asBinary
+     * True if binary data is requested, false if string data is requested.
+     *
+     * @param callback
+     * Callback function to process the application data.
      *
      * @returns
-     * Response.
+     * Application data.
      */
-    async #getRemoteFile(fileName: string): Promise<Response> {
-        return fetch(`${this.#baseURL}${fileName}`).then((response) => {
-            if (!response.ok) {
-                throw new RangeError(i18nextGS1.t("Prefix.gs1CompanyPrefixLengthDataHTTPError", {
-                    status: response.status
+    async #getRemoteAppData<T>(pathKey: string, asBinary: boolean, callback: (appData: AppData) => T): Promise<T> {
+        return this.#remoteAppDataStorage.read(pathKey, asBinary).then((appData) => {
+            if (appData === undefined) {
+                throw new RangeError(i18nextGS1.t("Prefix.gs1CompanyPrefixLengthDataFileNotFound", {
+                    key: pathKey
                 }));
             }
 
-            return response;
+            return callback(appData);
         }).catch(async (e: unknown) => {
             // Try again in ten minutes.
             const nowPlus10Minutes = new Date();
@@ -83,35 +231,41 @@ export abstract class RemoteGCPLengthCache extends GCPLengthCache {
     /**
      * @inheritDoc
      */
-    get sourceDateTime(): Promise<Date> {
-        return this.#getRemoteFile(RemoteGCPLengthCache.SOURCE_HEADER_FILE_NAME).then(async response =>
-            response.text()
-        ).then((s) => {
-            this.#gcpLengthHeader = parseGCPLengthHeader(s);
+    override get sourceDateTime(): Promise<Date> {
+        // Header is fetched on each call.
+        return this.#getRemoteAppData(RemoteGCPLengthCache.HEADER_STORAGE_KEY, false, (appData) => {
+            if (!isGCPLengthHeader(appData)) {
+                // Application error; no localization necessary.
+                throw new Error("Invalid GS1 Company Prefix length header");
+            }
 
-            return this.#gcpLengthHeader.dateTime;
+            this.#remoteGCPLengthHeader = appData;
+
+            return this.#remoteGCPLengthHeader.dateTime;
         });
     }
 
     /**
      * @inheritDoc
      */
-    get sourceData(): Promise<GCPLengthData> {
-        if (this.#gcpLengthHeader === undefined) {
-            // Application error; no localization necessary.
-            throw new Error("GS1 Company Prefix length header not loaded");
-        }
+    override get sourceData(): Promise<GCPLengthData> {
+        return this.#getRemoteAppData(RemoteGCPLengthCache.DATA_STORAGE_KEY, true, (appData) => {
+            const gcpLengthHeader = this.#remoteGCPLengthHeader;
 
-        const gcpLengthHeader = this.#gcpLengthHeader;
+            if (gcpLengthHeader === undefined) {
+                // Application error; no localization necessary.
+                throw new Error("GS1 Company Prefix length header not loaded");
+            }
 
-        // Clear header to allow for retry in case of failure.
-        this.#gcpLengthHeader = undefined;
+            if (!(appData instanceof Uint8Array)) {
+                // Application error; no localization necessary.
+                throw new Error("Invalid GS1 Company Prefix length data");
+            }
 
-        return this.#getRemoteFile(RemoteGCPLengthCache.SOURCE_DATA_FILE_NAME).then(async response =>
-            response.arrayBuffer()
-        ).then(a => ({
-            ...gcpLengthHeader,
-            data: new Uint8Array(a)
-        }));
+            return {
+                ...gcpLengthHeader,
+                data: appData
+            };
+        });
     }
 }

package/src/gcp-length-data.ts

@@ -1,3 +1,5 @@
+import type { AppData } from "@aidc-toolkit/core";
+
 /**
  * GS1 Company Prefix length header.
  */
@@ -14,55 +16,121 @@ export interface GCPLengthHeader {
 }
 
 /**
- * Parse a JSON string representing a GS1 Company Prefix length header.
+ * Determine if application data object is GS1 Company Prefix length header.
  *
- * @param s
- * JSON string.
+ * @param appData
+ * Application data object.
  *
  * @returns
- * GS1 Company Prefix length header.
+ * True if application data object is GS1 Company Prefix length header.
  */
-export function parseGCPLengthHeader(s: string): GCPLengthHeader {
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- File format is known.
-    return JSON.parse(s, (key, value: unknown) =>
-        key === "dateTime" && typeof value === "string" ? new Date(value) : value
-    ) as GCPLengthHeader;
+export function isGCPLengthHeader(appData: AppData | undefined): appData is GCPLengthHeader {
+    // Property type check is necessary to guard against data corruption or changes in format.
+    return typeof appData === "object" && "dateTime" in appData && appData.dateTime instanceof Date && "disclaimer" in appData && typeof appData.disclaimer === "string";
 }
 
 /**
- * Generate a JSON string representing a GS1 Company Prefix length header.
- *
- * @param gcpLengthHeader
- * GS1 Company Prefix length header.
+ * GS1 Company Prefix length data.
+ */
+export interface GCPLengthData extends GCPLengthHeader {
+    /**
+     * Tree data in binary form.
+     */
+    readonly data: Uint8Array;
+}
+
+/**
+ * Determine if application data object is GS1 Company Prefix length data.
  *
- * @param space
- * JSON string indentation.
+ * @param appData
+ * Application data object.
  *
  * @returns
- * JSON string.
+ * True if application data object is GS1 Company Prefix length data.
  */
-export function stringifyGCPLengthHeader(gcpLengthHeader: GCPLengthHeader, space?: string | number): string {
-    return JSON.stringify(gcpLengthHeader, (key, value: unknown) =>
-        key === "dateTime" && value instanceof Date ? value.toISOString() : value,
-    space);
+export function isGCPLengthData(appData: AppData | undefined): appData is GCPLengthData {
+    // Property type check is necessary to guard against data corruption or changes in format.
+    return isGCPLengthHeader(appData) && "data" in appData && appData.data instanceof Uint8Array;
 }
 
 /**
- * GS1 Company Prefix length data.
+ * GS1 Company Prefix length application data.
  */
-export interface GCPLengthData extends GCPLengthHeader {
+export interface GCPLengthAppData {
     /**
-     * Date/time the data was last updated.
+     * Next check date/time.
      */
-    readonly dateTime: Date;
+    nextCheckDateTime: Date | undefined;
 
+    /**
+     * GS1 Company Prefix length data.
+     */
+    gcpLengthData: GCPLengthData | undefined;
+}
+
+/**
+ * Determine if application data object is GS1 Company Prefix length application data.
+ *
+ * @param appData
+ * Application data object.
+ *
+ * @returns
+ * True if application data object is GS1 Company Prefix length application data.
+ */
+export function isGCPLengthAppData(appData: AppData | undefined): appData is GCPLengthAppData {
+    // Property type check is necessary to guard against data corruption or changes in format.
+    return typeof appData === "object" && "nextCheckDateTime" in appData && appData.nextCheckDateTime instanceof Date && (
+        !("gcpLengthData" in appData) || appData.gcpLengthData === undefined || (
+            typeof appData.gcpLengthData === "object" && appData.gcpLengthData !== null && isGCPLengthData(appData.gcpLengthData)
+        )
+    );
+}
+
+/**
+ * GS1 Company Prefix length JSON source file format.
+ */
+export interface GCPLengthSourceJSON {
     /**
      * Disclaimer.
      */
-    readonly disclaimer: string;
+    _disclaimer: string[];
 
     /**
-     * Tree data in binary form.
+     * Format list.
      */
-    readonly data: Uint8Array;
+    GCPPrefixFormatList: {
+        /**
+         * ISO data/time the table was last updated.
+         */
+        date: string;
+
+        /**
+         * Entries.
+         */
+        entry: Array<{
+            /**
+             * Identification key prefix start.
+             */
+            prefix: string;
+
+            /**
+             * Length of GS1 Company Prefix.
+             */
+            gcpLength: number;
+        }>;
+    };
+}
+
+/**
+ * Determine if application data object is GS1 Company Prefix length source JSON.
+ *
+ * @param appData
+ * Application data object.
+ *
+ * @returns
+ * True if application data object is GS1 Company Prefix length source JSON.
+ */
+export function isGCPLengthSourceJSON(appData: AppData | undefined): appData is GCPLengthSourceJSON {
+    // Checking is minimal as this is generally used in a controlled environment (e.g., updating remote storage).
+    return typeof appData === "object" && "_disclaimer" in appData && "GCPPrefixFormatList" in appData;
 }

package/src/gcp-length.ts

@@ -1,47 +1,12 @@
 import { omit } from "@aidc-toolkit/core";
 import type { GCPLengthCache } from "./gcp-length-cache.js";
-import type { GCPLengthData, GCPLengthHeader } from "./gcp-length-data.js";
+import { type GCPLengthData, type GCPLengthHeader, isGCPLengthData } from "./gcp-length-data.js";
 import { GTINLengths } from "./gtin-length.js";
 import { GTINValidator } from "./gtin-validator.js";
 import { type IdentifierType, IdentifierTypes } from "./identifier-type.js";
 import { IdentifierValidators, isNumericIdentifierValidator } from "./identifier-validators.js";
 import { LeaderTypes } from "./leader-type.js";
 
-/**
- * GS1 Company Prefix length JSON source file format.
- */
-interface GCPLengthJSON {
-    /**
-     * Disclaimer.
-     */
-    _disclaimer: string[];
-
-    /**
-     * Format list.
-     */
-    GCPPrefixFormatList: {
-        /**
-         * ISO data/time the table was last updated.
-         */
-        date: string;
-
-        /**
-         * Entries.
-         */
-        entry: Array<{
-            /**
-             * Identification key prefix start.
-             */
-            prefix: string;
-
-            /**
-             * Length of GS1 Company Prefix.
-             */
-            gcpLength: number;
-        }>;
-    };
-}
-
 /**
  * Leaf of GS1 Company Prefix length tree.
  */
@@ -299,7 +264,7 @@ export async function loadData(gcpLengthCache: GCPLengthCache): Promise<Root | u
 
             let cacheData: GCPLengthData;
 
-            if (typeof sourceData !== "string") {
+            if (isGCPLengthData(sourceData)) {
                 root = {
                     dateTime: sourceData.dateTime,
                     disclaimer: sourceData.disclaimer,
@@ -310,13 +275,10 @@ export async function loadData(gcpLengthCache: GCPLengthCache): Promise<Root | u
 
                 cacheData = sourceData;
             } else {
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- File format is known.
-                const gcpLength = JSON.parse(sourceData) as GCPLengthJSON;
-
                 root = {
-                    dateTime: new Date(gcpLength.GCPPrefixFormatList.date),
+                    dateTime: new Date(sourceData.GCPPrefixFormatList.date),
                     // Join disclaimer as a single string.
-                    disclaimer: `${gcpLength._disclaimer.reduce<string[]>((lines, line) => {
+                    disclaimer: `${sourceData._disclaimer.reduce<string[]>((lines, line) => {
                         if (lines.length === 0 || lines[lines.length - 1] === "" || line === "") {
                             lines.push(line);
                         } else {
@@ -331,7 +293,7 @@ export async function loadData(gcpLengthCache: GCPLengthCache): Promise<Root | u
 
                 let branchesAdded = 1;
 
-                for (const entry of gcpLength.GCPPrefixFormatList.entry) {
+                for (const entry of sourceData.GCPPrefixFormatList.entry) {
                     branchesAdded += addEntry(root, entry.prefix, entry.gcpLength);
                 }
 

package/src/index.ts

@@ -1,5 +1,5 @@
 /*!
- * Copyright © 2024-2025 Dolphin Data Development Ltd. and AIDC Toolkit
+ * Copyright © 2024-2026 Dolphin Data Development Ltd. and AIDC Toolkit
  * contributors
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
@@ -14,6 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+
 export * from "./locale/i18n.js";
 
 export * from "./character-set.js";

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

@@ -1,4 +1,7 @@
 export default {
+    AI64CharacterSetValidator: {
+        lengthMustBeMultipleOf4: "Length {{length, number}} must be a multiple of 4"
+    },
     Check: {
         lengthOfStringForPriceOrWeightMustBeExactly: "Length {{length, number}} of string for price or weight must be 4 or 5",
         priceOrWeightComponent: "price or weight",
@@ -35,7 +38,7 @@ export default {
         upcCompanyPrefixCantStartWith0000: "U.P.C. Company Prefix can't start with \"0000\"",
         gs18PrefixCantStartWith0: "GS1-8 Prefix can't start with \"0\"",
         identifierTypeNotSupportedByGS18Prefix: "{{identifierType}} not supported by GS1-8 Prefix",
-        gs1CompanyPrefixLengthDataHTTPError: "HTTP error {{status, number}} loading GS1 Company Prefix length data",
+        gs1CompanyPrefixLengthDataFileNotFound: "GS1 Company Prefix length data \"{{key}}\" not found",
         gs1CompanyPrefixLengthDataNotLoaded: "GS1 Company Prefix length data not loaded"
     }
-} as const;
+};

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

@@ -1,4 +1,7 @@
 export default {
+    AI64CharacterSetValidator: {
+        lengthMustBeMultipleOf4: "La longueur {{length, number}} doit être un multiple de 4"
+    },
     Check: {
         lengthOfStringForPriceOrWeightMustBeExactly: "La longueur {{length, number}} de la chaîne pour le prix ou le poids doit être 4 ou 5",
         priceOrWeightComponent: "prix ou poids",
@@ -35,7 +38,7 @@ export default {
         upcCompanyPrefixCantStartWith0000: "Le préfixe de l'entreprise U.P.C. ne peut pas commencer par \"0000\"",
         gs18PrefixCantStartWith0: "Le préfixe GS1-8 ne peut pas commencer par \"0\"",
         identifierTypeNotSupportedByGS18Prefix: "{{identifierType}} non pris en charge par le préfixe GS1-8",
-        gs1CompanyPrefixLengthDataHTTPError: "Erreur HTTP {{status, number}} lors du chargement des données de longueur du préfixe d'entreprise GS1",
+        gs1CompanyPrefixLengthDataFileNotFound: "Données de longueur du préfixe d'entreprise GS1 «{{key}}» introuvables",
         gs1CompanyPrefixLengthDataNotLoaded: "Les données relatives à la longueur du préfixe d'entreprise GS1 n'ont pas été chargées"
     }
-} as const;
+};

package/src/locale/i18n.ts

@@ -1,5 +1,5 @@
-import { type I18nEnvironment, i18nFinalizeInit } from "@aidc-toolkit/core";
-import { i18nUtilityInit, utilityResources } from "@aidc-toolkit/utility";
+import { i18nCoreInit, type I18nEnvironment, i18nInit } from "@aidc-toolkit/core";
+import { i18nUtilityInit } from "@aidc-toolkit/utility";
 import i18next, { type i18n, type Resource } from "i18next";
 import enLocaleResources from "./en/locale-resources.js";
 import frLocaleResources from "./fr/locale-resources.js";
@@ -12,9 +12,9 @@ export const gs1NS = "aidct_gs1";
 export type GS1LocaleResources = typeof enLocaleResources;
 
 /**
- * GS1 resources.
+ * GS1 resource bundle.
  */
-export const gs1Resources: Resource = {
+export const gs1ResourceBundle: Resource = {
     en: {
         aidct_gs1: enLocaleResources
     },
@@ -34,8 +34,10 @@ export const i18nextGS1: i18n = i18next.createInstance();
  *
  * @param debug
  * Debug setting.
+ *
+ * @returns
+ * GS1 resource bundle.
  */
-export async function i18nGS1Init(environment: I18nEnvironment, debug = false): Promise<void> {
-    await i18nUtilityInit(environment, debug);
-    await i18nFinalizeInit(i18nextGS1, environment, debug, gs1NS, utilityResources, gs1Resources);
+export async function i18nGS1Init(environment: I18nEnvironment, debug = false): Promise<Resource> {
+    return i18nInit(i18nextGS1, environment, debug, gs1NS, gs1ResourceBundle, i18nCoreInit, i18nUtilityInit);
 }

package/src/locale/i18next.d.ts

@@ -1,3 +1,4 @@
+import type { CoreLocaleResources } from "@aidc-toolkit/core";
 import type { UtilityLocaleResources } from "@aidc-toolkit/utility";
 import type { GS1LocaleResources } from "./i18n.js";
 
@@ -11,6 +12,7 @@ declare module "i18next" {
     interface CustomTypeOptions {
         defaultNS: "aidct_gs1";
         resources: {
+            aidct_core: CoreLocaleResources;
             aidct_utility: UtilityLocaleResources;
             aidct_gs1: GS1LocaleResources;
         };

package/src/numeric-identifier-validator.ts

@@ -56,7 +56,7 @@ export abstract class NumericIdentifierValidator<TNumericIdentifierType extends
     /**
      * @inheritDoc
      */
-    validate(identifier: string, validation?: NumericIdentifierValidation): void {
+    override validate(identifier: string, validation?: NumericIdentifierValidation): void {
         // Validate the prefix, with care taken for its position within the identifier.
         if (this.#prefixPosition === 0) {
             super.validatePrefix(identifier);