@aidc-toolkit/core 1.0.44-beta → 1.0.44

package/dist/locale/i18n.js

@@ -1,144 +0,0 @@
-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 language detectors.
- */
-export const I18nLanguageDetectors = {
-    /**
-     * Command-line interface (e.g., unit tests).
-     */
-    // TODO Refactor when https://github.com/neet/i18next-cli-language-detector/issues/281 resolved.
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Per above.
-    CLI: I18nextCLILanguageDetector,
-    /**
-     * Web browser.
-     */
-    Browser: I18nextBrowserLanguageDetector
-};
-/**
- * Convert a string to lower case, skipping words that are all upper case.
- *
- * @param value
- * Value.
- *
- * @returns
- * Lower case string if value is a string. If not, value is returned as a string but not converted to lower case.
- */
-function toLowerCase(value) {
-    return typeof value === "string" ?
-        // Words with no lower case letters are preserved as they are likely mnemonics.
-        value.split(" ").map(word => /[a-z]/u.test(word) ? word.toLowerCase() : word).join(" ") :
-        String(value);
-}
-export const coreNS = "aidct_core";
-/**
- * Core resource bundle.
- */
-export const coreResourceBundle = {
-    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 i18next
- * Internationalization object. As multiple objects exist, this parameter represents the one for the module for which
- * internationalization is being initialized.
- *
- * @param languageDetector
- * Language detector.
- *
- * @param debug
- * Debug setting.
- *
- * @param defaultNS
- * Default namespace.
- *
- * @param defaultResourceBundle
- * Default resource bundle.
- *
- * @param i18nDependencyInits
- * Dependency internationalization initialization functions.
- *
- * @returns
- * Default resource bundle.
- */
-export async function i18nInit(i18next, languageDetector, debug, defaultNS, defaultResourceBundle, ...i18nDependencyInits) {
-    let initAll = undefined;
-    // Initialization may be called more than once.
-    if (!i18next.isInitialized) {
-        const mergedResourceBundle = {};
-        /**
-         * Merge a package resource bundle into the merged resource bundle.
-         *
-         * @param resourceBundle
-         * Package resource bundle.
-         */
-        function mergeResourceBundle(resourceBundle) {
-            // Merge languages.
-            for (const [language, languageResourceBundle] of Object.entries(resourceBundle)) {
-                if (!(language in mergedResourceBundle)) {
-                    mergedResourceBundle[language] = {};
-                }
-                const mergedLanguageResourceBundle = mergedResourceBundle[language];
-                // Merge namespaces.
-                for (const [namespace, resourceKey] of Object.entries(languageResourceBundle)) {
-                    if (namespace in mergedLanguageResourceBundle) {
-                        // Error prior to internationalization initialization; no localization possible.
-                        throw new Error(`Duplicate namespace ${namespace} in merged resource bundle for language ${language}`);
-                    }
-                    mergedLanguageResourceBundle[namespace] = resourceKey;
-                }
-            }
-        }
-        mergeResourceBundle(defaultResourceBundle);
-        // Build chain to initialize dependencies and merge their resource bundles.
-        for (const i18nDependencyInit of i18nDependencyInits) {
-            const initDependency = i18nDependencyInit(languageDetector, debug).then(mergeResourceBundle);
-            initAll = initAll === undefined ? initDependency : initAll.then(async () => initDependency);
-        }
-        const initThis = i18next.use(languageDetector).init({
-            debug,
-            defaultNS,
-            resources: mergedResourceBundle,
-            // Allow fallback by removing variant code then country code until match is found.
-            nonExplicitSupportedLngs: true,
-            // Fallback to first language defined.
-            fallbackLng: Object.keys(mergedResourceBundle)[0],
-            detection: {
-                // Disabling cache allows read but requires explicit saving of i18nextLng attribute (e.g., via UI).
-                caches: []
-            }
-        }).then(() => {
-            // Add toLowerCase formatter.
-            i18next.services.formatter?.add("toLowerCase", toLowerCase);
-        });
-        initAll = initAll === undefined ? initThis : initAll.then(async () => initThis);
-    }
-    return initAll !== undefined ? initAll.then(() => defaultResourceBundle) : defaultResourceBundle;
-}
-/**
- * Initialize internationalization.
- *
- * @param languageDetector
- * Language detector.
- *
- * @param debug
- * Debug setting.
- *
- * @returns
- * Core resource bundle.
- */
-export async function i18nCoreInit(languageDetector, debug = false) {
-    return i18nInit(i18nextCore, languageDetector, debug, coreNS, coreResourceBundle);
-}
-//# sourceMappingURL=i18n.js.map

package/dist/locale/i18n.js.map

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

package/dist/logger.d.ts

@@ -1,136 +0,0 @@
-import { type ISettingsParam, Logger } from "tslog";
-/**
- * Log levels.
- */
-export declare const LogLevels: {
-    readonly Silly: 0;
-    readonly Trace: 1;
-    readonly Debug: 2;
-    readonly Info: 3;
-    readonly Warn: 4;
-    readonly Error: 5;
-    readonly Fatal: 6;
-};
-/**
- * Log level key.
- */
-export type LogLevelKey = keyof typeof LogLevels;
-/**
- * Log level.
- */
-export type LogLevel = typeof LogLevels[LogLevelKey];
-/**
- * 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. Mapped to `minLevel` and sets `hideLogPositionForProduction` to true in
- * settings if at {@linkcode LogLevels.Info} or higher. Default is {@linkcode LogLevels.Info}.
- *
- * @param settings
- * Detailed settings. See [`tslog`](https://tslog.js.org/#/?id=settings) documentation for details. The `minLevel` is
- * ignored in favour of `logLevel` but `hideLogPositionForProduction` will override the default logic.
- *
- * @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 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 +0,0 @@
-{"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;;;;;;;;;;;;;;;;;;;;;GAqBG;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,CAUpI;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,256 +0,0 @@
-import { Logger } from "tslog";
-import { i18nextCore } from "./locale/i18n.js";
-/**
- * Log levels.
- */
-export const LogLevels = {
-    Silly: 0,
-    Trace: 1,
-    Debug: 2,
-    Info: 3,
-    Warn: 4,
-    Error: 5,
-    Fatal: 6
-};
-/**
- * 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 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.
-            typedLogLevel = LogLevels[untypedLogLevel];
-        }
-        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)) {
-            // 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 {
-        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` and sets `hideLogPositionForProduction` to true in
- * settings if at {@linkcode LogLevels.Info} or higher. Default is {@linkcode LogLevels.Info}.
- *
- * @param settings
- * Detailed settings. See [`tslog`](https://tslog.js.org/#/?id=settings) documentation for details. The `minLevel` is
- * ignored in favour of `logLevel` but `hideLogPositionForProduction` will override the default logic.
- *
- * @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) {
-    const minLevel = logLevelOf(logLevel);
-    return new Logger({
-        // Hiding log position for production can be overridden in settings parameter.
-        hideLogPositionForProduction: minLevel >= LogLevels.Info,
-        ...settings ?? {},
-        // Minimum log level overrides settings parameter.
-        minLevel
-    }, 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 +0,0 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/dist/parse-version.d.ts

@@ -1,36 +0,0 @@
-/**
- * Parsed version.
- */
-export interface ParsedVersion {
-    /**
-     * Major version.
-     */
-    readonly majorVersion: number;
-    /**
-     * Minor version.
-     */
-    readonly minorVersion: number;
-    /**
-     * Patch version.
-     */
-    readonly patchVersion: number;
-    /**
-     * Pre-release identifier.
-     */
-    readonly preReleaseIdentifier: string | undefined;
-    /**
-     * Date/time included with pre-release identifier.
-     */
-    readonly dateTime: string | undefined;
-}
-/**
- * Parse version.
- *
- * @param version
- * Version, typically from package.json.
- *
- * @returns
- * Parsed version.
- */
-export declare function parseVersion(version: string): ParsedVersion;
-//# sourceMappingURL=parse-version.d.ts.map

package/dist/parse-version.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parse-version.d.ts","sourceRoot":"","sources":["../src/parse-version.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IAElD;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAc3D"}

package/dist/parse-version.js

@@ -1,23 +0,0 @@
-/**
- * Parse version.
- *
- * @param version
- * Version, typically from package.json.
- *
- * @returns
- * Parsed version.
- */
-export function parseVersion(version) {
-    const parsedVersionGroups = /^(?<majorVersion>\d+)\.(?<minorVersion>\d+)\.(?<patchVersion>\d+)(?:-(?<preReleaseIdentifier>alpha|beta)(?:\.(?<dateTime>\d{12}))?)?$/u.exec(version)?.groups;
-    if (parsedVersionGroups === undefined) {
-        throw new Error(`Invalid package version ${version}`);
-    }
-    return {
-        majorVersion: Number(parsedVersionGroups["majorVersion"]),
-        minorVersion: Number(parsedVersionGroups["minorVersion"]),
-        patchVersion: Number(parsedVersionGroups["patchVersion"]),
-        preReleaseIdentifier: parsedVersionGroups["preReleaseIdentifier"],
-        dateTime: parsedVersionGroups["dateTime"]
-    };
-}
-//# sourceMappingURL=parse-version.js.map

package/dist/parse-version.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"parse-version.js","sourceRoot":"","sources":["../src/parse-version.ts"],"names":[],"mappings":"AA8BA;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IACxC,MAAM,mBAAmB,GAAG,wIAAwI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE3L,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO;QACH,YAAY,EAAE,MAAM,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;QACzD,YAAY,EAAE,MAAM,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;QACzD,YAAY,EAAE,MAAM,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;QACzD,oBAAoB,EAAE,mBAAmB,CAAC,sBAAsB,CAAC;QACjE,QAAQ,EAAE,mBAAmB,CAAC,UAAU,CAAC;KAC5C,CAAC;AACN,CAAC"}

package/dist/remote-app-data-storage.d.ts

@@ -1,23 +0,0 @@
-import { ReadOnlyAppDataStorage } from "./app-data-storage.js";
-import { type HTTPFetch } from "./http-fetch.js";
-/**
- * Remote application data storage using HTTP.
- */
-export declare class RemoteAppDataStorage extends ReadOnlyAppDataStorage<true> {
-    #private;
-    /**
-     * Constructor.
-     *
-     * @param baseURL
-     * Base URL. The URL must not end with a slash.
-     *
-     * @param httpFetch
-     * HTTP fetch function.
-     */
-    constructor(baseURL: string, httpFetch?: HTTPFetch);
-    /**
-     * @inheritDoc
-     */
-    protected doRead(key: string, asBinary: boolean | undefined): Promise<string | Uint8Array | undefined>;
-}
-//# sourceMappingURL=remote-app-data-storage.d.ts.map

package/dist/remote-app-data-storage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"remote-app-data-storage.d.ts","sourceRoot":"","sources":["../src/remote-app-data-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGnF;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,sBAAsB,CAAC,IAAI,CAAC;;IAGlE;;;;;;;;OAQG;gBACS,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,SAA4B;IAMpE;;OAEG;cACsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;CAiBxH"}