@aidc-toolkit/core 1.0.41 → 1.0.43-beta

package/dist/logger.js

@@ -0,0 +1,256 @@
+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

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

package/dist/parse-version.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,23 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,23 @@
+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

@@ -0,0 +1 @@
+{"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"}

package/dist/remote-app-data-storage.js

@@ -0,0 +1,42 @@
+import { ReadOnlyAppDataStorage } from "./app-data-storage.js";
+import { defaultHTTPFetch, HTTP_NOT_FOUND } from "./http-fetch.js";
+import { i18nextCore } from "./locale/i18n.js";
+/**
+ * Remote application data storage using HTTP.
+ */
+export class RemoteAppDataStorage extends ReadOnlyAppDataStorage {
+    #httpFetch;
+    /**
+     * Constructor.
+     *
+     * @param baseURL
+     * Base URL. The URL must not end with a slash.
+     *
+     * @param httpFetch
+     * HTTP fetch function.
+     */
+    constructor(baseURL, httpFetch = defaultHTTPFetch) {
+        super(true, baseURL);
+        this.#httpFetch = httpFetch;
+    }
+    /**
+     * @inheritDoc
+     */
+    async doRead(key, asBinary) {
+        const response = await this.#httpFetch(key);
+        let result;
+        if (response.ok) {
+            result = asBinary === true ? new Uint8Array(await response.arrayBuffer()) : await response.text();
+        }
+        else if (response.status === HTTP_NOT_FOUND) {
+            result = undefined;
+        }
+        else {
+            throw new RangeError(i18nextCore.t("RemoteAppDataStorage.httpError", {
+                status: response.status
+            }));
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=remote-app-data-storage.js.map

package/dist/remote-app-data-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-app-data-storage.js","sourceRoot":"","sources":["../src/remote-app-data-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAkB,MAAM,iBAAiB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,sBAA4B;IACzD,UAAU,CAAY;IAE/B;;;;;;;;OAQG;IACH,YAAY,OAAe,EAAE,YAAuB,gBAAgB;QAChE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAErB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAChC,CAAC;IAED;;OAEG;IACgB,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,QAA6B;QACtE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAE5C,IAAI,MAAuC,CAAC;QAE5C,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YACd,MAAM,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtG,CAAC;aAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;YAC5C,MAAM,GAAG,SAAS,CAAC;QACvB,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,gCAAgC,EAAE;gBACjE,MAAM,EAAE,QAAQ,CAAC,MAAM;aAC1B,CAAC,CAAC,CAAC;QACR,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ"}

package/dist/type-helper.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Create an object with omitted entries.
+ *
+ * @template T
+ * Object type.
+ *
+ * @template K
+ * Object key type.
+ *
+ * @param o
+ * Object.
+ *
+ * @param keys
+ * Keys to omit.
+ *
+ * @returns
+ * Edited object.
+ */
+export declare function omit<T extends object, K extends keyof T>(o: T, ...keys: K[]): Omit<T, K>;
+/**
+ * Create an object with picked entries.
+ *
+ * @template T
+ * Object type.
+ *
+ * @template K
+ * Object key type.
+ *
+ * @param o
+ * Object.
+ *
+ * @param keys
+ * Keys to pick.
+ *
+ * @returns
+ * Edited object.
+ */
+export declare function pick<T extends object, K extends keyof T>(o: T, ...keys: K[]): Pick<T, K>;
+/**
+ * Create an object from a wide object without entries matching those from a narrow object.
+ *
+ * @template TWide
+ * Wide object type.
+ *
+ * @template TNarrow
+ * Narrow object type.
+ *
+ * @template K
+ * Narrow object key type, subset of wide object key type.
+ *
+ * @param wide
+ * Wide object.
+ *
+ * @param narrow
+ * Narrow object.
+ *
+ * @returns
+ * Edited object.
+ */
+export declare function exclude<TWide extends TNarrow, TNarrow extends object, K extends keyof TNarrow>(wide: TWide, narrow: TNarrow): Omit<TWide, K>;
+/**
+ * Create an object from a wide object with entries matching those from a narrow object.
+ *
+ * @template TWide
+ * Wide object type.
+ *
+ * @template TNarrow
+ * Narrow object type.
+ *
+ * @template K
+ * Narrow object key type, subset of wide object key type.
+ *
+ * @param wide
+ * Wide object.
+ *
+ * @param narrow
+ * Narrow object.
+ *
+ * @returns
+ * Edited object.
+ */
+export declare function include<TWide extends TNarrow, TNarrow extends object, K extends keyof TNarrow>(wide: TWide, narrow: TNarrow): Pick<TWide, K>;
+/**
+ * Cast a property as a more narrow type.
+ *
+ * @template T
+ * Object type.
+ *
+ * @template K
+ * Object key type.
+ *
+ * @template TAsType
+ * Desired type.
+ *
+ * @param o
+ * Object.
+ *
+ * @param key
+ * Key of property to cast.
+ *
+ * @returns
+ * Single-key object with property cast as desired type.
+ */
+export declare function propertyAs<T extends object, K extends keyof T, TAsType extends T[K]>(o: T, key: K): Readonly<Omit<T, K> extends T ? Partial<Record<K, TAsType>> : Record<K, TAsType>>;
+/**
+ * Determine if argument is nullish. Application extension may pass `null` or `undefined` to missing parameters.
+ *
+ * @param argument
+ * Argument.
+ *
+ * @returns
+ * True if argument is undefined or null.
+ */
+export declare function isNullish(argument: unknown): argument is null | undefined;
+//# sourceMappingURL=type-helper.d.ts.map

package/dist/type-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-helper.d.ts","sourceRoot":"","sources":["../src/type-helper.ts"],"names":[],"mappings":"AA6BA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAExF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAExF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,OAAO,CAAC,KAAK,SAAS,OAAO,EAAE,OAAO,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAG5I;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,OAAO,CAAC,KAAK,SAAS,OAAO,EAAE,OAAO,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAG5I;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CASrL;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,IAAI,GAAG,SAAS,CAEzE"}

package/dist/type-helper.js

@@ -0,0 +1,163 @@
+/**
+ * Create an object with omitted or picked entries.
+ *
+ * @template Omitting
+ * Type representation of `omitting` parameter for return type determination.
+ *
+ * @template T
+ * Object type.
+ *
+ * @template K
+ * Object key type.
+ *
+ * @param omitting
+ * True if omitting.
+ *
+ * @param o
+ * Object.
+ *
+ * @param keys
+ * Keys to omit or pick.
+ *
+ * @returns
+ * Edited object.
+ */
+function omitOrPick(omitting, o, ...keys) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Key and value types are known.
+    return Object.fromEntries(Object.entries(o).filter(([key]) => keys.includes(key) !== omitting));
+}
+/**
+ * Create an object with omitted entries.
+ *
+ * @template T
+ * Object type.
+ *
+ * @template K
+ * Object key type.
+ *
+ * @param o
+ * Object.
+ *
+ * @param keys
+ * Keys to omit.
+ *
+ * @returns
+ * Edited object.
+ */
+export function omit(o, ...keys) {
+    return omitOrPick(true, o, ...keys);
+}
+/**
+ * Create an object with picked entries.
+ *
+ * @template T
+ * Object type.
+ *
+ * @template K
+ * Object key type.
+ *
+ * @param o
+ * Object.
+ *
+ * @param keys
+ * Keys to pick.
+ *
+ * @returns
+ * Edited object.
+ */
+export function pick(o, ...keys) {
+    return omitOrPick(false, o, ...keys);
+}
+/**
+ * Create an object from a wide object without entries matching those from a narrow object.
+ *
+ * @template TWide
+ * Wide object type.
+ *
+ * @template TNarrow
+ * Narrow object type.
+ *
+ * @template K
+ * Narrow object key type, subset of wide object key type.
+ *
+ * @param wide
+ * Wide object.
+ *
+ * @param narrow
+ * Narrow object.
+ *
+ * @returns
+ * Edited object.
+ */
+export function exclude(wide, narrow) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Keys are valid.
+    return omit(wide, ...Object.keys(narrow));
+}
+/**
+ * Create an object from a wide object with entries matching those from a narrow object.
+ *
+ * @template TWide
+ * Wide object type.
+ *
+ * @template TNarrow
+ * Narrow object type.
+ *
+ * @template K
+ * Narrow object key type, subset of wide object key type.
+ *
+ * @param wide
+ * Wide object.
+ *
+ * @param narrow
+ * Narrow object.
+ *
+ * @returns
+ * Edited object.
+ */
+export function include(wide, narrow) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Keys are valid.
+    return pick(wide, ...Object.keys(narrow));
+}
+/**
+ * Cast a property as a more narrow type.
+ *
+ * @template T
+ * Object type.
+ *
+ * @template K
+ * Object key type.
+ *
+ * @template TAsType
+ * Desired type.
+ *
+ * @param o
+ * Object.
+ *
+ * @param key
+ * Key of property to cast.
+ *
+ * @returns
+ * Single-key object with property cast as desired type.
+ */
+export function propertyAs(o, key) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Type is determined by condition.
+    return (key in o ?
+        {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Force cast.
+            [key]: o[key]
+        } :
+        {});
+}
+/**
+ * Determine if argument is nullish. Application extension may pass `null` or `undefined` to missing parameters.
+ *
+ * @param argument
+ * Argument.
+ *
+ * @returns
+ * True if argument is undefined or null.
+ */
+export function isNullish(argument) {
+    return argument === null || argument === undefined;
+}
+//# sourceMappingURL=type-helper.js.map