@aidc-toolkit/core 1.0.28-beta → 1.0.32-beta

package/README.md

@@ -35,7 +35,7 @@ All AIDC Toolkit packages require internationalization. The localization functio
 Packages install their resources as follows in `i18n.ts` or similar:
 
 ```typescript
-import { i18nCoreInit, type I18nEnvironment } from "@aidc-toolkit/core";
+import { type I18nEnvironment, i18nFinalizeInit } from "@aidc-toolkit/core";
 import { dependency1Resources, i18nDependency1Init } from "@aidc-toolkit/dependency1";
 import { dependency2Resources, i18nDependency2Init } from "@aidc-toolkit/dependency2";
 import i18next, { type i18n, type Resource } from "i18next";
@@ -79,7 +79,7 @@ export const i18nextPackage: i18n = i18next.createInstance();
 export async function i18nPackageInit(environment: I18nEnvironment, debug = false): Promise<void> {
     await i18nDependency1Init(environment, debug);
     await i18nDependency2Init(environment, debug);
-    await i18nCoreInit(i18nextPackage, environment, debug, packageNS, dependency1Resources, dependency2Resources, packageResources);
+    await i18nFinalizeInit(i18nextPackage, environment, debug, packageNS, dependency1Resources, dependency2Resources, packageResources);
 }
 ```
 

package/dist/cache.d.ts

@@ -0,0 +1,58 @@
+import type { Promisable } from "./type.js";
+/**
+ * Generic cache. Typically used to manage a local copy of remote data that is not refreshed regularly.
+ *
+ * @template TCache
+ * Type of cached data.
+ *
+ * @template TSource
+ * Type of source data. The type may be different from the cached data type if a transformation is required.
+ */
+export declare abstract class Cache<TCache, TSource = TCache> {
+    /**
+     * Get the date/time at or after which the source should be checked for updates. If the value is undefined, this is
+     * the first usage.
+     */
+    abstract get nextCheckDateTime(): Promisable<Date | undefined>;
+    /**
+     * Get the date/time at which the cache was last updated. This may more accurately reflect the date/time at which
+     * the last source retrieved was updated. If the value is undefined, there is no data in the cache.
+     */
+    abstract get cacheDateTime(): Promisable<Date | undefined>;
+    /**
+     * Get the cache data. This should only ever be called if the cache date/time is defined.
+     */
+    abstract get cacheData(): Promisable<TCache>;
+    /**
+     * Get the date/time at which the source was last updated. This should not be called unless the next check date/time
+     * has passed, as it may trigger an expensive remote retrieval.
+     */
+    abstract get sourceDateTime(): Promisable<Date>;
+    /**
+     * Get the source data. This should not be called unless the next check date/time has passed, as it may trigger an
+     * expensive remote retrieval.
+     */
+    abstract get sourceData(): Promisable<TSource>;
+    /**
+     * Update the cache with only the next check date/time. The cache date/time and cache data must not be modified.
+     * This is typically called when the cache is up to date with the source or source retrieval has failed.
+     *
+     * @param nextCheckDateTime
+     * Next check date/time.
+     */
+    abstract update(nextCheckDateTime: Date): Promisable<void>;
+    /**
+     * Update all cache parameters. This is typically called when the cache is updated from the source.
+     *
+     * @param nextCheckDateTime
+     * Next check date/time.
+     *
+     * @param cacheDateTime
+     * Cache date/time.
+     *
+     * @param cacheData
+     * Cache data.
+     */
+    abstract update(nextCheckDateTime: Date, cacheDateTime: Date, cacheData: TCache): Promisable<void>;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;;;;;;;GAQG;AACH,8BAAsB,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM;IAChD;;;OAGG;IACH,QAAQ,KAAK,iBAAiB,IAAI,UAAU,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IAE/D;;;OAGG;IACH,QAAQ,KAAK,aAAa,IAAI,UAAU,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IAE3D;;OAEG;IACH,QAAQ,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IAE7C;;;OAGG;IACH,QAAQ,KAAK,cAAc,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAEhD;;;OAGG;IACH,QAAQ,KAAK,UAAU,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;IAE/C;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;IAE1D;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC;CACrG"}

package/dist/cache.js

@@ -0,0 +1,12 @@
+/**
+ * Generic cache. Typically used to manage a local copy of remote data that is not refreshed regularly.
+ *
+ * @template TCache
+ * Type of cached data.
+ *
+ * @template TSource
+ * Type of source data. The type may be different from the cached data type if a transformation is required.
+ */
+export class Cache {
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,OAAgB,KAAK;CAoD1B"}

package/dist/hyperlink.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Hyperlink.
+ */
+export interface Hyperlink {
+    /**
+     * Reference, relative or absolute depending on the application.
+     */
+    readonly reference: string;
+    /**
+     * Human-readable text.
+     */
+    readonly text?: string | undefined;
+    /**
+     * Additional details.
+     */
+    readonly details?: string | undefined;
+}
+//# sourceMappingURL=hyperlink.d.ts.map

package/dist/hyperlink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperlink.d.ts","sourceRoot":"","sources":["../src/hyperlink.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC"}

package/dist/hyperlink.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hyperlink.js.map

package/dist/hyperlink.js.map

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

package/dist/index.d.ts

@@ -17,5 +17,7 @@
 export type * from "./type.js";
 export * from "./type-helper.js";
 export * from "./logger.js";
+export * from "./cache.js";
+export type * from "./hyperlink.js";
 export * from "./locale/i18n.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,mBAAmB,WAAW,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,mBAAmB,WAAW,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,aAAa,CAAC;AAE5B,cAAc,YAAY,CAAC;AAC3B,mBAAmB,gBAAgB,CAAC;AAEpC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from "./type-helper.js";
 export * from "./logger.js";
+export * from "./cache.js";
 export * from "./locale/i18n.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,cAAc,kBAAkB,CAAC;AAEjC,cAAc,aAAa,CAAC;AAE5B,cAAc,YAAY,CAAC;AAG3B,cAAc,kBAAkB,CAAC"}

package/dist/locale/en/locale-resources.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+    Logger: {
+        unknownLogLevel: string;
+    };
+};
+export default _default;
+//# sourceMappingURL=locale-resources.d.ts.map

package/dist/locale/en/locale-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-resources.d.ts","sourceRoot":"","sources":["../../../src/locale/en/locale-resources.ts"],"names":[],"mappings":";;;;;AAAA,wBAIE"}

package/dist/locale/en/locale-resources.js

@@ -0,0 +1,6 @@
+export default {
+    Logger: {
+        unknownLogLevel: "Unknown log level \"{{logLevel}}\""
+    }
+};
+//# sourceMappingURL=locale-resources.js.map

package/dist/locale/en/locale-resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-resources.js","sourceRoot":"","sources":["../../../src/locale/en/locale-resources.ts"],"names":[],"mappings":"AAAA,eAAe;IACX,MAAM,EAAE;QACJ,eAAe,EAAE,oCAAoC;KACxD;CACJ,CAAC"}

package/dist/locale/fr/locale-resources.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+    Logger: {
+        unknownLogLevel: string;
+    };
+};
+export default _default;
+//# sourceMappingURL=locale-resources.d.ts.map

package/dist/locale/fr/locale-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-resources.d.ts","sourceRoot":"","sources":["../../../src/locale/fr/locale-resources.ts"],"names":[],"mappings":";;;;;AAAA,wBAIE"}

package/dist/locale/fr/locale-resources.js

@@ -0,0 +1,6 @@
+export default {
+    Logger: {
+        unknownLogLevel: "Niveau de journalisation inconnu «{{logLevel}}»"
+    }
+};
+//# sourceMappingURL=locale-resources.js.map

package/dist/locale/fr/locale-resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-resources.js","sourceRoot":"","sources":["../../../src/locale/fr/locale-resources.ts"],"names":[],"mappings":"AAAA,eAAe;IACX,MAAM,EAAE;QACJ,eAAe,EAAE,iDAAiD;KACrE;CACJ,CAAC"}

package/dist/locale/i18n.d.ts

@@ -1,4 +1,5 @@
-import type { i18n, Resource } from "i18next";
+import { type i18n, type Resource } from "i18next";
+import enLocaleResources from "./en/locale-resources.js";
 /**
  * Locale strings type for generic manipulation.
  */
@@ -30,6 +31,26 @@ export type I18nEnvironmentKey = keyof typeof I18nEnvironments;
  * Internationalization operating environment.
  */
 export type I18nEnvironment = typeof I18nEnvironments[I18nEnvironmentKey];
+export declare const coreNS = "aidct_core";
+/**
+ * Locale resources type is extracted from the English locale resources object.
+ */
+export type CoreLocaleResources = typeof enLocaleResources;
+/**
+ * Core resources.
+ */
+export declare const coreResources: Resource;
+export declare const i18nextCore: i18n;
+/**
+ * Initialize internationalization.
+ *
+ * @param environment
+ * Environment in which the application is running.
+ *
+ * @param debug
+ * Debug setting.
+ */
+export declare function i18nCoreInit(environment: I18nEnvironment, debug?: boolean): Promise<void>;
 /**
  * Initialize internationalization.
  *
@@ -48,9 +69,6 @@ export type I18nEnvironment = typeof I18nEnvironments[I18nEnvironmentKey];
  *
  * @param resources
  * Resources.
- *
- * @returns
- * Void promise.
  */
-export declare function i18nCoreInit(i18next: i18n, environment: I18nEnvironment, debug: boolean, defaultNS: string, ...resources: Resource[]): Promise<void>;
+export declare function i18nFinalizeInit(i18next: i18n, environment: I18nEnvironment, debug: boolean, defaultNS: string, ...resources: Resource[]): Promise<void>;
 //# sourceMappingURL=i18n.d.ts.map

package/dist/locale/i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/locale/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAA0B,QAAQ,EAAE,MAAM,SAAS,CAAC;AAItE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,MAAM,CAAC;CAC3C;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;IACzB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;CAEG,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;AAgB1E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiD1J"}
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/locale/i18n.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,KAAK,IAAI,EAA+B,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGzF,OAAO,iBAAiB,MAAM,0BAA0B,CAAC;AAGzD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,MAAM,CAAC;CAC3C;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;IACzB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;CAEG,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;AAgB1E,eAAO,MAAM,MAAM,eAAe,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,iBAAiB,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,QAO3B,CAAC;AAGF,eAAO,MAAM,WAAW,EAAE,IAA+B,CAAC;AAE1D;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,eAAe,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7F;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiD9J"}

package/dist/locale/i18n.js

@@ -1,5 +1,8 @@
+import i18next from "i18next";
 import I18nextBrowserLanguageDetector from "i18next-browser-languagedetector";
 import I18nextCLILanguageDetector from "i18next-cli-language-detector";
+import enLocaleResources from "./en/locale-resources.js";
+import frLocaleResources from "./fr/locale-resources.js";
 /**
  * Internationalization operating environments.
  */
@@ -28,7 +31,33 @@ export const I18nEnvironments = {
  */
 function toLowerCase(s) {
     // Words with no lower case letters are preserved as they are likely mnemonics.
-    return s.split(" ").map(word => /[a-z]/.test(word) ? word.toLowerCase() : word).join(" ");
+    return s.split(" ").map(word => /[a-z]/u.test(word) ? word.toLowerCase() : word).join(" ");
+}
+export const coreNS = "aidct_core";
+/**
+ * Core resources.
+ */
+export const coreResources = {
+    en: {
+        aidct_core: enLocaleResources
+    },
+    fr: {
+        aidct_core: frLocaleResources
+    }
+};
+// Explicit type is necessary because type can't be inferred without additional references.
+export const i18nextCore = i18next.createInstance();
+/**
+ * Initialize internationalization.
+ *
+ * @param environment
+ * Environment in which the application is running.
+ *
+ * @param debug
+ * Debug setting.
+ */
+export async function i18nCoreInit(environment, debug = false) {
+    await i18nFinalizeInit(i18nextCore, environment, debug, coreNS, coreResources);
 }
 /**
  * Initialize internationalization.
@@ -48,11 +77,8 @@ function toLowerCase(s) {
  *
  * @param resources
  * Resources.
- *
- * @returns
- * Void promise.
  */
-export async function i18nCoreInit(i18next, environment, debug, defaultNS, ...resources) {
+export async function i18nFinalizeInit(i18next, environment, debug, defaultNS, ...resources) {
     // Initialization may be called more than once.
     if (!i18next.isInitialized) {
         const mergedResource = {};

package/dist/locale/i18n.js.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../src/locale/i18n.ts"],"names":[],"mappings":"AACA,OAAO,8BAA8B,MAAM,kCAAkC,CAAC;AAC9E,OAAO,0BAA0B,MAAM,+BAA+B,CAAC;AASvE;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B;;OAEG;IACH,GAAG,EAAE,CAAC;IAEN;;OAEG;IACH,MAAM,EAAE,CAAC;IAET;;OAEG;IACH,OAAO,EAAE,CAAC;CACJ,CAAC;AAYX;;;;;;;;GAQG;AACH,SAAS,WAAW,CAAC,CAAS;IAC1B,+EAA+E;IAC/E,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9F,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAa,EAAE,WAA4B,EAAE,KAAc,EAAE,SAAiB,EAAE,GAAG,SAAqB;IACvI,+CAA+C;IAC/C,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACzB,MAAM,cAAc,GAAa,EAAE,CAAC;QAEpC,mBAAmB;QACnB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YAC/B,mBAAmB;YACnB,KAAK,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClE,IAAI,CAAC,CAAC,QAAQ,IAAI,cAAc,CAAC,EAAE,CAAC;oBAChC,cAAc,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;gBAClC,CAAC;gBAED,MAAM,sBAAsB,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;gBAExD,oBAAoB;gBACpB,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBACtE,sBAAsB,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC;gBACpD,CAAC;YACL,CAAC;QACL,CAAC;QAED,IAAI,MAAyC,CAAC;QAE9C,QAAQ,WAAW,EAAE,CAAC;YAClB,KAAK,gBAAgB,CAAC,GAAG;gBACrB,gGAAgG;gBAChG,qFAAqF;gBACrF,MAAM,GAAG,0BAA+D,CAAC;gBACzE,MAAM;YAEV,KAAK,gBAAgB,CAAC,OAAO;gBACzB,MAAM,GAAG,8BAA8B,CAAC;gBACxC,MAAM;YAEV;gBACI,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;YAC3B,KAAK;YACL,SAAS,EAAE,cAAc;YACzB,WAAW,EAAE,IAAI;YACjB,SAAS;SACZ,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YACT,4BAA4B;YAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5H,CAAC,CAAC,CAAC;IACP,CAAC;AACL,CAAC"}
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../src/locale/i18n.ts"],"names":[],"mappings":"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"}

package/dist/logger.d.ts

@@ -1,4 +1,4 @@
-import { Logger } from "tslog";
+import { type ISettingsParam, Logger } from "tslog";
 /**
  * Log levels.
  */
@@ -20,13 +20,115 @@ export type LogLevelKey = keyof typeof LogLevels;
  */
 export type LogLevel = typeof LogLevels[LogLevelKey];
 /**
- * Get a simple logger with an optional log level.
+ * Get the log level enumeration value corresponding to a string or number.
+ *
+ * @param untypedLogLevel
+ * Untyped log level.
+ *
+ * @returns
+ * Typed log level or default `LogLevels.Info` if untyped log level not provided..
+ */
+export declare function logLevelOf(untypedLogLevel?: string | number): LogLevel;
+/**
+ * Get a logger with an optional log level. The underlying implementation is
+ * [`tslog`](https://tslog.js.org/).
  *
  * @param logLevel
- * Log level as enumeration value or string.
+ * Log level as enumeration value or string. Mapped to `minLevel` in settings.
+ *
+ * @param settings
+ * Detailed settings. See [`tslog`](https://tslog.js.org/#/?id=settings) documentation for details.
+ *
+ * @param logObj
+ * Default log object. See [`tslog`](https://tslog.js.org/#/?id=defining-and-accessing-logobj) documentation for
+ * details.
  *
  * @returns
  * Logger.
+ *
+ * @template T
+ * Log object type.
+ */
+export declare function getLogger<T extends object = object>(logLevel?: string | number, settings?: ISettingsParam<T>, logObj?: T): Logger<T>;
+/**
+ * Get a loggable representation of a value. Values are returned unmodified, except as follows:
+ *
+ * - Big integers are converted to whole numbers where possible, otherwise as their decimal string representations.
+ * - Arrays are limited to a maximum of ten elements. Any array longer than ten elements is replaced with the first four
+ * elements, a string of three dots, and the last four elements. This may still create large results for
+ * multidimensional arrays.
+ * - Errors are converted to objects with `name`, `message`, and `stack` properties.
+ * - Symbols are converted to their string representations.
+ * - Functions are converted to strings of the form `Function(name)`.
+ *
+ * @param value
+ * Value.
+ *
+ * @returns
+ * Loggable value.
+ */
+export declare function loggableValue(value: unknown): unknown;
+/**
+ * Logger transport that stores messages in memory.
  */
-export declare function getLogger(logLevel?: string | number): Logger<unknown>;
+export declare class MemoryTransport<T extends object> {
+    #private;
+    /**
+     * Constructor.
+     *
+     * @param logger
+     * Logger.
+     *
+     * @param maximumLength
+     * Maximum length of messages array.
+     *
+     * @param truncateLength
+     * Length to which messages array is truncated when maximum is reached. Default is 50% of `maximumLength`, maximum
+     * is 80% of `maximumLength`.
+     */
+    constructor(logger: Logger<T>, maximumLength: number, truncateLength?: number);
+    /**
+     * Get the messages.
+     */
+    get messages(): string[];
+    /**
+     * Get the maximum length of messages array.
+     */
+    get maximumLength(): number;
+    /**
+     * Get the length to which messages array is truncated when maximum is reached.
+     */
+    get truncateLength(): number;
+    /**
+     * Add a notification callback. If one already exists under the current name, do nothing.
+     *
+     * @param name
+     * Callback name.
+     *
+     * @param notificationCallback
+     * Callback.
+     *
+     * @returns
+     * True if successfully added.
+     */
+    addNotificationCallback(name: string, notificationCallback: (message: string | undefined, messages: readonly string[]) => void): boolean;
+    /**
+     * Remove a notification callback.
+     *
+     * @param name
+     * Callback name.
+     */
+    removeNotificationCallback(name: string): void;
+    /**
+     * Resize the messages array.
+     *
+     * @param maximumLength
+     * Maximum length of messages array.
+     *
+     * @param truncateLength
+     * Length to which messages array is truncated when maximum is reached. Default is 50% of `maximumLength`, maximum
+     * is 80% of `maximumLength`.
+     */
+    resize(maximumLength: number, truncateLength?: number): void;
+}
 //# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE/B;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;CAQZ,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC;AAErD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAiBrE"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAGpD;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;CAQZ,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC;AAErD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CA2BtE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAKpI;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA4CrD;AAED;;GAEG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS,MAAM;;IAqBzC;;;;;;;;;;;;OAYG;gBACS,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;IAoB7E;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,EAAE,CAEvB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED;;;;;;;;;;;OAWG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,GAAG,OAAO;IAaxI;;;;;OAKG;IACH,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9C;;;;;;;;;OASG;IACH,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;CAI/D"}

package/dist/logger.js

@@ -1,4 +1,5 @@
 import { Logger } from "tslog";
+import { i18nextCore } from "./locale/i18n.js";
 /**
  * Log levels.
  */
@@ -12,30 +13,238 @@ export const LogLevels = {
     Fatal: 6
 };
 /**
- * Get a simple logger with an optional log level.
+ * Get the log level enumeration value corresponding to a string or number.
  *
- * @param logLevel
- * Log level as enumeration value or string.
+ * @param untypedLogLevel
+ * Untyped log level.
  *
  * @returns
- * Logger.
+ * Typed log level or default `LogLevels.Info` if untyped log level not provided..
  */
-export function getLogger(logLevel) {
-    let minLevel;
-    if (typeof logLevel === "string") {
-        if (logLevel in LogLevels) {
+export function logLevelOf(untypedLogLevel) {
+    let typedLogLevel;
+    if (typeof untypedLogLevel === "string") {
+        if (untypedLogLevel in LogLevels) {
             // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- String exists as a key.
-            minLevel = LogLevels[logLevel];
+            typedLogLevel = LogLevels[untypedLogLevel];
         }
         else {
-            throw new Error(`Unknown log level ${logLevel}`);
+            throw new RangeError(i18nextCore.t("Logger.unknownLogLevel", {
+                logLevel: untypedLogLevel
+            }));
+        }
+    }
+    else if (untypedLogLevel !== undefined) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Assume that valid log level has been provided.
+        if (Object.values(LogLevels).includes(untypedLogLevel)) {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Valid log level has been provided.
+            typedLogLevel = untypedLogLevel;
+        }
+        else {
+            throw new RangeError(i18nextCore.t("Logger.unknownLogLevel", {
+                logLevel: untypedLogLevel
+            }));
         }
     }
     else {
-        minLevel = logLevel ?? LogLevels.Info;
+        typedLogLevel = LogLevels.Info;
     }
+    return typedLogLevel;
+}
+/**
+ * Get a logger with an optional log level. The underlying implementation is
+ * [`tslog`](https://tslog.js.org/).
+ *
+ * @param logLevel
+ * Log level as enumeration value or string. Mapped to `minLevel` in settings.
+ *
+ * @param settings
+ * Detailed settings. See [`tslog`](https://tslog.js.org/#/?id=settings) documentation for details.
+ *
+ * @param logObj
+ * Default log object. See [`tslog`](https://tslog.js.org/#/?id=defining-and-accessing-logobj) documentation for
+ * details.
+ *
+ * @returns
+ * Logger.
+ *
+ * @template T
+ * Log object type.
+ */
+export function getLogger(logLevel, settings, logObj) {
     return new Logger({
-        minLevel
-    });
+        ...settings ?? {},
+        minLevel: logLevelOf(logLevel)
+    }, logObj);
+}
+/**
+ * Get a loggable representation of a value. Values are returned unmodified, except as follows:
+ *
+ * - Big integers are converted to whole numbers where possible, otherwise as their decimal string representations.
+ * - Arrays are limited to a maximum of ten elements. Any array longer than ten elements is replaced with the first four
+ * elements, a string of three dots, and the last four elements. This may still create large results for
+ * multidimensional arrays.
+ * - Errors are converted to objects with `name`, `message`, and `stack` properties.
+ * - Symbols are converted to their string representations.
+ * - Functions are converted to strings of the form `Function(name)`.
+ *
+ * @param value
+ * Value.
+ *
+ * @returns
+ * Loggable value.
+ */
+export function loggableValue(value) {
+    let replacementValue;
+    switch (typeof value) {
+        case "string":
+        case "number":
+        case "boolean":
+        case "undefined":
+            replacementValue = value;
+            break;
+        case "bigint":
+            // Big integers not supported in JSON.
+            replacementValue = value >= Number.MIN_SAFE_INTEGER && value <= Number.MAX_SAFE_INTEGER ? Number(value) : value.toString(10);
+            break;
+        case "object":
+            if (value === null) {
+                replacementValue = value;
+            }
+            else if (Array.isArray(value)) {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment -- Slicing array is necessary to keep log size down.
+                replacementValue = (value.length <= 10 ? value : [...value.slice(0, 4), "...", ...value.slice(-4)]).map(entry => loggableValue(entry));
+            }
+            else if (value instanceof Error) {
+                replacementValue = loggableValue({
+                    name: value.name,
+                    message: value.message,
+                    stack: value.stack?.split("\n")
+                });
+            }
+            else {
+                // Apply recursively to all properties of the object.
+                replacementValue = Object.fromEntries(Object.entries(value).map(([k, v]) => [k, loggableValue(v)]));
+            }
+            break;
+        case "symbol":
+            replacementValue = value.toString();
+            break;
+        case "function":
+            replacementValue = `Function(${value.name})`;
+            break;
+    }
+    return replacementValue;
+}
+/**
+ * Logger transport that stores messages in memory.
+ */
+export class MemoryTransport {
+    /**
+     * Notification callbacks map.
+     */
+    #notificationCallbacksMap = new Map();
+    /**
+     * Messages.
+     */
+    #messages = [];
+    /**
+     * Maximum length of messages array.
+     */
+    #maximumLength = 0;
+    /**
+     * Length to which messages array is truncated when maximum is reached.
+     */
+    #truncateLength = 0;
+    /**
+     * Constructor.
+     *
+     * @param logger
+     * Logger.
+     *
+     * @param maximumLength
+     * Maximum length of messages array.
+     *
+     * @param truncateLength
+     * Length to which messages array is truncated when maximum is reached. Default is 50% of `maximumLength`, maximum
+     * is 80% of `maximumLength`.
+     */
+    constructor(logger, maximumLength, truncateLength) {
+        this.resize(maximumLength, truncateLength);
+        logger.attachTransport((logObject) => {
+            // Truncate logger messages if necessary.
+            if (this.#messages.length >= this.#maximumLength) {
+                this.#messages.splice(0, this.#maximumLength - this.#truncateLength);
+            }
+            const message = JSON.stringify(logObject);
+            this.#messages.push(message);
+            // Notify all registered callbacks.
+            for (const notificationCallback of this.#notificationCallbacksMap.values()) {
+                notificationCallback(message, this.#messages);
+            }
+        });
+    }
+    /**
+     * Get the messages.
+     */
+    get messages() {
+        return this.#messages;
+    }
+    /**
+     * Get the maximum length of messages array.
+     */
+    get maximumLength() {
+        return this.#maximumLength;
+    }
+    /**
+     * Get the length to which messages array is truncated when maximum is reached.
+     */
+    get truncateLength() {
+        return this.#truncateLength;
+    }
+    /**
+     * Add a notification callback. If one already exists under the current name, do nothing.
+     *
+     * @param name
+     * Callback name.
+     *
+     * @param notificationCallback
+     * Callback.
+     *
+     * @returns
+     * True if successfully added.
+     */
+    addNotificationCallback(name, notificationCallback) {
+        const added = !this.#notificationCallbacksMap.has(name);
+        if (added) {
+            this.#notificationCallbacksMap.set(name, notificationCallback);
+            // Notify with existing messages.
+            notificationCallback(undefined, this.#messages);
+        }
+        return added;
+    }
+    /**
+     * Remove a notification callback.
+     *
+     * @param name
+     * Callback name.
+     */
+    removeNotificationCallback(name) {
+        this.#notificationCallbacksMap.delete(name);
+    }
+    /**
+     * Resize the messages array.
+     *
+     * @param maximumLength
+     * Maximum length of messages array.
+     *
+     * @param truncateLength
+     * Length to which messages array is truncated when maximum is reached. Default is 50% of `maximumLength`, maximum
+     * is 80% of `maximumLength`.
+     */
+    resize(maximumLength, truncateLength) {
+        this.#maximumLength = maximumLength;
+        this.#truncateLength = truncateLength !== undefined ? Math.min(truncateLength, Math.floor(maximumLength * 0.8)) : Math.floor(maximumLength / 2);
+    }
 }
 //# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE/B;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACrB,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;CACF,CAAC;AAYX;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,QAA0B;IAChD,IAAI,QAAgB,CAAC;IAErB,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;YACxB,kGAAkG;YAClG,QAAQ,GAAG,SAAS,CAAC,QAAuB,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;QACrD,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,QAAQ,GAAG,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC;IAC1C,CAAC;IAED,OAAO,IAAI,MAAM,CAAC;QACd,QAAQ;KACX,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/dist/type.d.ts

@@ -49,6 +49,11 @@ export type TypedConstructor<TConstructor extends abstract new (...args: Constru
  * Constructor type.
  */
 export type TypedAbstractConstructor<TConstructor extends abstract new (...args: ConstructorParameters<TConstructor>) => InstanceType<TConstructor>> = AbstractConstructor<ConstructorParameters<TConstructor>, InstanceType<TConstructor>>;
+/**
+ * Promisable type. Extends a type by allowing a {@linkcode Promise} of the same type. Typically used in abstract method
+ * declarations where the implementing class may or may not implement the method as asynchronous.
+ */
+export type Promisable<T> = T | Promise<T>;
 /**
  * Determine the fundamental promised type. This is stricter than `Awaited<Type>` in that it requires a {@linkcode
  * Promise}.

package/dist/type.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aidc-toolkit/core",
-  "version": "1.0.28-beta",
+  "version": "1.0.32-beta",
   "description": "Core functionality for AIDC Toolkit",
   "type": "module",
   "main": "dist/index.js",
@@ -26,10 +26,10 @@
     "build:doc": "npm run build:dev"
   },
   "devDependencies": {
-    "@aidc-toolkit/dev": "1.0.28-beta"
+    "@aidc-toolkit/dev": "1.0.32-beta"
   },
   "dependencies": {
-    "i18next": "^25.7.2",
+    "i18next": "^25.7.4",
     "i18next-browser-languagedetector": "^8.2.0",
     "i18next-cli-language-detector": "^1.1.8",
     "tslog": "^4.10.2"

package/src/cache.ts

@@ -0,0 +1,64 @@
+import type { Promisable } from "./type.js";
+
+/**
+ * Generic cache. Typically used to manage a local copy of remote data that is not refreshed regularly.
+ *
+ * @template TCache
+ * Type of cached data.
+ *
+ * @template TSource
+ * Type of source data. The type may be different from the cached data type if a transformation is required.
+ */
+export abstract class Cache<TCache, TSource = TCache> {
+    /**
+     * Get the date/time at or after which the source should be checked for updates. If the value is undefined, this is
+     * the first usage.
+     */
+    abstract get nextCheckDateTime(): Promisable<Date | undefined>;
+
+    /**
+     * Get the date/time at which the cache was last updated. This may more accurately reflect the date/time at which
+     * the last source retrieved was updated. If the value is undefined, there is no data in the cache.
+     */
+    abstract get cacheDateTime(): Promisable<Date | undefined>;
+
+    /**
+     * Get the cache data. This should only ever be called if the cache date/time is defined.
+     */
+    abstract get cacheData(): Promisable<TCache>;
+
+    /**
+     * Get the date/time at which the source was last updated. This should not be called unless the next check date/time
+     * has passed, as it may trigger an expensive remote retrieval.
+     */
+    abstract get sourceDateTime(): Promisable<Date>;
+
+    /**
+     * Get the source data. This should not be called unless the next check date/time has passed, as it may trigger an
+     * expensive remote retrieval.
+     */
+    abstract get sourceData(): Promisable<TSource>;
+
+    /**
+     * Update the cache with only the next check date/time. The cache date/time and cache data must not be modified.
+     * This is typically called when the cache is up to date with the source or source retrieval has failed.
+     *
+     * @param nextCheckDateTime
+     * Next check date/time.
+     */
+    abstract update(nextCheckDateTime: Date): Promisable<void>;
+
+    /**
+     * Update all cache parameters. This is typically called when the cache is updated from the source.
+     *
+     * @param nextCheckDateTime
+     * Next check date/time.
+     *
+     * @param cacheDateTime
+     * Cache date/time.
+     *
+     * @param cacheData
+     * Cache data.
+     */
+    abstract update(nextCheckDateTime: Date, cacheDateTime: Date, cacheData: TCache): Promisable<void>;
+}

package/src/hyperlink.ts

@@ -0,0 +1,19 @@
+/**
+ * Hyperlink.
+ */
+export interface Hyperlink {
+    /**
+     * Reference, relative or absolute depending on the application.
+     */
+    readonly reference: string;
+
+    /**
+     * Human-readable text.
+     */
+    readonly text?: string | undefined;
+
+    /**
+     * Additional details.
+     */
+    readonly details?: string | undefined;
+}

package/src/index.ts

@@ -16,5 +16,10 @@
  */
 export type * from "./type.js";
 export * from "./type-helper.js";
+
 export * from "./logger.js";
+
+export * from "./cache.js";
+export type * from "./hyperlink.js";
+
 export * from "./locale/i18n.js";

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

@@ -0,0 +1,5 @@
+export default {
+    Logger: {
+        unknownLogLevel: "Unknown log level \"{{logLevel}}\""
+    }
+};

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

@@ -0,0 +1,5 @@
+export default {
+    Logger: {
+        unknownLogLevel: "Niveau de journalisation inconnu «{{logLevel}}»"
+    }
+};

package/src/locale/i18n.ts

@@ -1,6 +1,8 @@
-import type { i18n, LanguageDetectorModule, Resource } from "i18next";
+import i18next, { type i18n, type LanguageDetectorModule, type Resource } from "i18next";
 import I18nextBrowserLanguageDetector from "i18next-browser-languagedetector";
 import I18nextCLILanguageDetector from "i18next-cli-language-detector";
+import enLocaleResources from "./en/locale-resources.js";
+import frLocaleResources from "./fr/locale-resources.js";
 
 /**
  * Locale strings type for generic manipulation.
@@ -50,7 +52,42 @@ export type I18nEnvironment = typeof I18nEnvironments[I18nEnvironmentKey];
  */
 function toLowerCase(s: string): string {
     // Words with no lower case letters are preserved as they are likely mnemonics.
-    return s.split(" ").map(word => /[a-z]/.test(word) ? word.toLowerCase() : word).join(" ");
+    return s.split(" ").map(word => /[a-z]/u.test(word) ? word.toLowerCase() : word).join(" ");
+}
+
+export const coreNS = "aidct_core";
+
+/**
+ * Locale resources type is extracted from the English locale resources object.
+ */
+export type CoreLocaleResources = typeof enLocaleResources;
+
+/**
+ * Core resources.
+ */
+export const coreResources: Resource = {
+    en: {
+        aidct_core: enLocaleResources
+    },
+    fr: {
+        aidct_core: frLocaleResources
+    }
+};
+
+// Explicit type is necessary because type can't be inferred without additional references.
+export const i18nextCore: i18n = i18next.createInstance();
+
+/**
+ * Initialize internationalization.
+ *
+ * @param environment
+ * Environment in which the application is running.
+ *
+ * @param debug
+ * Debug setting.
+ */
+export async function i18nCoreInit(environment: I18nEnvironment, debug = false): Promise<void> {
+    await i18nFinalizeInit(i18nextCore, environment, debug, coreNS, coreResources);
 }
 
 /**
@@ -71,11 +108,8 @@ function toLowerCase(s: string): string {
  *
  * @param resources
  * Resources.
- *
- * @returns
- * Void promise.
  */
-export async function i18nCoreInit(i18next: i18n, environment: I18nEnvironment, debug: boolean, defaultNS: string, ...resources: Resource[]): Promise<void> {
+export async function i18nFinalizeInit(i18next: i18n, environment: I18nEnvironment, debug: boolean, defaultNS: string, ...resources: Resource[]): Promise<void> {
     // Initialization may be called more than once.
     if (!i18next.isInitialized) {
         const mergedResource: Resource = {};

package/src/locale/i18next.d.ts

@@ -0,0 +1,16 @@
+import type { CoreLocaleResources } from "./i18n.js";
+
+/**
+ * Internationalization module.
+ */
+declare module "i18next" {
+    /**
+     * Custom type options for this package.
+     */
+    interface CustomTypeOptions {
+        defaultNS: "aidct_core";
+        resources: {
+            aidct_core: CoreLocaleResources;
+        };
+    }
+}

package/src/logger.ts

@@ -1,4 +1,5 @@
-import { Logger } from "tslog";
+import { type ISettingsParam, Logger } from "tslog";
+import { i18nextCore } from "./locale/i18n.js";
 
 /**
  * Log levels.
@@ -24,29 +25,258 @@ export type LogLevelKey = keyof typeof LogLevels;
 export type LogLevel = typeof LogLevels[LogLevelKey];
 
 /**
- * Get a simple logger with an optional log level.
+ * Get the log level enumeration value corresponding to a string or number.
  *
- * @param logLevel
- * Log level as enumeration value or string.
+ * @param untypedLogLevel
+ * Untyped log level.
  *
  * @returns
- * Logger.
+ * Typed log level or default `LogLevels.Info` if untyped log level not provided..
  */
-export function getLogger(logLevel?: string | number): Logger<unknown> {
-    let minLevel: number;
+export function logLevelOf(untypedLogLevel?: string | number): LogLevel {
+    let typedLogLevel: LogLevel;
 
-    if (typeof logLevel === "string") {
-        if (logLevel in LogLevels) {
+    if (typeof untypedLogLevel === "string") {
+        if (untypedLogLevel in LogLevels) {
             // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- String exists as a key.
-            minLevel = LogLevels[logLevel as LogLevelKey];
+            typedLogLevel = LogLevels[untypedLogLevel as LogLevelKey];
+        } else {
+            throw new RangeError(i18nextCore.t("Logger.unknownLogLevel", {
+                logLevel: untypedLogLevel
+            }));
+        }
+    } else if (untypedLogLevel !== undefined) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Assume that valid log level has been provided.
+        if (Object.values(LogLevels).includes(untypedLogLevel as LogLevel)) {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Valid log level has been provided.
+            typedLogLevel = untypedLogLevel as LogLevel;
         } else {
-            throw new Error(`Unknown log level ${logLevel}`);
+            throw new RangeError(i18nextCore.t("Logger.unknownLogLevel", {
+                logLevel: untypedLogLevel
+            }));
         }
     } else {
-        minLevel = logLevel ?? LogLevels.Info;
+        typedLogLevel = LogLevels.Info;
     }
 
+    return typedLogLevel;
+}
+
+/**
+ * Get a logger with an optional log level. The underlying implementation is
+ * [`tslog`](https://tslog.js.org/).
+ *
+ * @param logLevel
+ * Log level as enumeration value or string. Mapped to `minLevel` in settings.
+ *
+ * @param settings
+ * Detailed settings. See [`tslog`](https://tslog.js.org/#/?id=settings) documentation for details.
+ *
+ * @param logObj
+ * Default log object. See [`tslog`](https://tslog.js.org/#/?id=defining-and-accessing-logobj) documentation for
+ * details.
+ *
+ * @returns
+ * Logger.
+ *
+ * @template T
+ * Log object type.
+ */
+export function getLogger<T extends object = object>(logLevel?: string | number, settings?: ISettingsParam<T>, logObj?: T): Logger<T> {
     return new Logger({
-        minLevel
-    });
+        ...settings ?? {},
+        minLevel: logLevelOf(logLevel)
+    }, logObj);
+}
+
+/**
+ * Get a loggable representation of a value. Values are returned unmodified, except as follows:
+ * 
+ * - Big integers are converted to whole numbers where possible, otherwise as their decimal string representations.
+ * - Arrays are limited to a maximum of ten elements. Any array longer than ten elements is replaced with the first four
+ * elements, a string of three dots, and the last four elements. This may still create large results for
+ * multidimensional arrays.
+ * - Errors are converted to objects with `name`, `message`, and `stack` properties.
+ * - Symbols are converted to their string representations.
+ * - Functions are converted to strings of the form `Function(name)`.
+ *
+ * @param value
+ * Value.
+ *
+ * @returns
+ * Loggable value.
+ */
+export function loggableValue(value: unknown): unknown {
+    let replacementValue: unknown;
+
+    switch (typeof value) {
+        case "string":
+        case "number":
+        case "boolean":
+        case "undefined":
+            replacementValue = value;
+            break;
+
+        case "bigint":
+            // Big integers not supported in JSON.
+            replacementValue = value >= Number.MIN_SAFE_INTEGER && value <= Number.MAX_SAFE_INTEGER ? Number(value) : value.toString(10);
+            break;
+
+        case "object":
+            if (value === null) {
+                replacementValue = value;
+            } else if (Array.isArray(value)) {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment -- Slicing array is necessary to keep log size down.
+                replacementValue = (value.length <= 10 ? value : [...value.slice(0, 4), "...", ...value.slice(-4)]).map(entry => loggableValue(entry));
+            } else if (value instanceof Error) {
+                replacementValue = loggableValue({
+                    name: value.name,
+                    message: value.message,
+                    stack: value.stack?.split("\n")
+                });
+            } else {
+                // Apply recursively to all properties of the object.
+                replacementValue = Object.fromEntries(Object.entries(value).map(([k, v]) => [k, loggableValue(v)]));
+            }
+            break;
+
+        case "symbol":
+            replacementValue = value.toString();
+            break;
+
+        case "function":
+            replacementValue = `Function(${value.name})`;
+            break;
+    }
+
+    return replacementValue;
+}
+
+/**
+ * Logger transport that stores messages in memory.
+ */
+export class MemoryTransport<T extends object> {
+    /**
+     * Notification callbacks map.
+     */
+    readonly #notificationCallbacksMap = new Map<string, (message: string | undefined, messages: readonly string[]) => void>();
+
+    /**
+     * Messages.
+     */
+    readonly #messages: string[] = [];
+
+    /**
+     * Maximum length of messages array.
+     */
+    #maximumLength = 0;
+
+    /**
+     * Length to which messages array is truncated when maximum is reached.
+     */
+    #truncateLength = 0;
+
+    /**
+     * Constructor.
+     *
+     * @param logger
+     * Logger.
+     *
+     * @param maximumLength
+     * Maximum length of messages array.
+     *
+     * @param truncateLength
+     * Length to which messages array is truncated when maximum is reached. Default is 50% of `maximumLength`, maximum
+     * is 80% of `maximumLength`.
+     */
+    constructor(logger: Logger<T>, maximumLength: number, truncateLength?: number) {
+        this.resize(maximumLength, truncateLength);
+
+        logger.attachTransport((logObject) => {
+            // Truncate logger messages if necessary.
+            if (this.#messages.length >= this.#maximumLength) {
+                this.#messages.splice(0, this.#maximumLength - this.#truncateLength);
+            }
+
+            const message = JSON.stringify(logObject);
+
+            this.#messages.push(message);
+
+            // Notify all registered callbacks.
+            for (const notificationCallback of this.#notificationCallbacksMap.values()) {
+                notificationCallback(message, this.#messages);
+            }
+        });
+    }
+
+    /**
+     * Get the messages.
+     */
+    get messages(): string[] {
+        return this.#messages;
+    }
+
+    /**
+     * Get the maximum length of messages array.
+     */
+    get maximumLength(): number {
+        return this.#maximumLength;
+    }
+
+    /**
+     * Get the length to which messages array is truncated when maximum is reached.
+     */
+    get truncateLength(): number {
+        return this.#truncateLength;
+    }
+
+    /**
+     * Add a notification callback. If one already exists under the current name, do nothing.
+     *
+     * @param name
+     * Callback name.
+     *
+     * @param notificationCallback
+     * Callback.
+     *
+     * @returns
+     * True if successfully added.
+     */
+    addNotificationCallback(name: string, notificationCallback: (message: string | undefined, messages: readonly string[]) => void): boolean {
+        const added = !this.#notificationCallbacksMap.has(name);
+
+        if (added) {
+            this.#notificationCallbacksMap.set(name, notificationCallback);
+
+            // Notify with existing messages.
+            notificationCallback(undefined, this.#messages);
+        }
+
+        return added;
+    }
+
+    /**
+     * Remove a notification callback.
+     *
+     * @param name
+     * Callback name.
+     */
+    removeNotificationCallback(name: string): void {
+        this.#notificationCallbacksMap.delete(name);
+    }
+
+    /**
+     * Resize the messages array.
+     *
+     * @param maximumLength
+     * Maximum length of messages array.
+     *
+     * @param truncateLength
+     * Length to which messages array is truncated when maximum is reached. Default is 50% of `maximumLength`, maximum
+     * is 80% of `maximumLength`.
+     */
+    resize(maximumLength: number, truncateLength?: number): void {
+        this.#maximumLength = maximumLength;
+        this.#truncateLength = truncateLength !== undefined ? Math.min(truncateLength, Math.floor(maximumLength * 0.8)) : Math.floor(maximumLength / 2);
+    }
 }

package/src/type.ts

@@ -63,6 +63,12 @@ export type TypedConstructor<TConstructor extends abstract new (...args: Constru
 export type TypedAbstractConstructor<TConstructor extends abstract new (...args: ConstructorParameters<TConstructor>) => InstanceType<TConstructor>> =
     AbstractConstructor<ConstructorParameters<TConstructor>, InstanceType<TConstructor>>;
 
+/**
+ * Promisable type. Extends a type by allowing a {@linkcode Promise} of the same type. Typically used in abstract method
+ * declarations where the implementing class may or may not implement the method as asynchronous.
+ */
+export type Promisable<T> = T | Promise<T>;
+
 /**
  * Determine the fundamental promised type. This is stricter than `Awaited<Type>` in that it requires a {@linkcode
  * Promise}.

package/tsconfig.json

@@ -1,4 +1,5 @@
 {
+  "extends": "@aidc-toolkit/dev/tsconfig-template.json",
   "include": [],
   "references": [
     {