@aidc-toolkit/core 1.0.41 → 1.0.43-beta

package/dist/type-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-helper.js","sourceRoot":"","sources":["../src/type-helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAS,UAAU,CAAgE,QAAkB,EAAE,CAAI,EAAE,GAAG,IAAS;IACrH,yGAAyG;IACzG,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAQ,CAAC,KAAK,QAAQ,CAAC,CAAkD,CAAC;AAC1J,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,IAAI,CAAsC,CAAI,EAAE,GAAG,IAAS;IACxE,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,IAAI,CAAsC,CAAI,EAAE,GAAG,IAAS;IACxE,OAAO,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,OAAO,CAAyE,IAAW,EAAE,MAAe;IACxH,0FAA0F;IAC1F,OAAO,IAAI,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAQ,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,OAAO,CAAyE,IAAW,EAAE,MAAe;IACxH,0FAA0F;IAC1F,OAAO,IAAI,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAQ,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,UAAU,CAA4D,CAAI,EAAE,GAAM;IAC9F,2GAA2G;IAC3G,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACd;YACI,sFAAsF;YACtF,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAY;SAC3B,CAAC,CAAC;QACH,EAAE,CAC2C,CAAC;AACtD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,QAAiB;IACvC,OAAO,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,CAAC;AACvD,CAAC"}

package/dist/type.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Typed function, applicable to any function, stricter than {@linkcode Function}.
+ *
+ * @template TFunction
+ * Function type.
+ */
+export type TypedFunction<TFunction extends (...args: Parameters<TFunction>) => ReturnType<TFunction>> = (...args: Parameters<TFunction>) => ReturnType<TFunction>;
+/**
+ * Typed synchronous function, applicable to any function that doesn't return a {@linkcode Promise}.
+ *
+ * @template TFunction
+ * Function type.
+ */
+export type TypedSyncFunction<TFunction extends TypedFunction<TFunction>> = [ReturnType<TFunction>] extends [PromiseLike<unknown>] ? never : TypedFunction<TFunction>;
+/**
+ * Arbitrary constructor. An arbitrary constructor doesn't have to be an exact match to a constructor; the only
+ * requirements are that `TConstructorParameters` have compatible types (exact or wider types of the actual constructor
+ * parameters) and that `TConstructorInstance` be a compatible type (exact or narrower type of the actual constructor
+ * instance).
+ *
+ * @template TConstructorParameters
+ * Constructor parameters types.
+ *
+ * @template TConstructorInstance
+ * Constructor instance type.
+ */
+export type Constructor<TConstructorParameters extends unknown[], TConstructorInstance> = new (...args: TConstructorParameters) => TConstructorInstance;
+/**
+ * Arbitrary abstract constructor. Abstract version of {@linkcode Constructor}.
+ *
+ * @template TConstructorParameters
+ * Constructor parameters types.
+ *
+ * @template TConstructorInstance
+ * Constructor instance type.
+ */
+export type AbstractConstructor<TConstructorParameters extends unknown[], TConstructorInstance> = abstract new (...args: TConstructorParameters) => TConstructorInstance;
+/**
+ * Typed constructor, applicable to any constructor.
+ *
+ * @template TConstructor
+ * Constructor type.
+ */
+export type TypedConstructor<TConstructor extends abstract new (...args: ConstructorParameters<TConstructor>) => InstanceType<TConstructor>> = Constructor<ConstructorParameters<TConstructor>, InstanceType<TConstructor>>;
+/**
+ * Typed abstract constructor, applicable to any constructor.
+ *
+ * @template TConstructor
+ * 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}.
+ *
+ * @template T
+ * Promised type.
+ */
+export type PromisedType<T> = [T] extends [PromiseLike<infer TPromised>] ? TPromised : never;
+/**
+ * Typed asynchronous function, applicable to any function that returns a {@linkcode Promise}.
+ *
+ * @template TFunction
+ * Function type.
+ */
+export type TypedAsyncFunction<TMethod extends (...args: Parameters<TMethod>) => PromiseLike<PromisedType<ReturnType<TMethod>>>> = (...args: Parameters<TMethod>) => Promise<PromisedType<ReturnType<TMethod>>>;
+/**
+ * Nullishable type. Extends a type by allowing `null` and `undefined`.
+ *
+ * @template T
+ * Type.
+ */
+export type Nullishable<T> = T | null | undefined;
+/**
+ * Non-nullishable type. If T is an object type, it is spread and attributes within it are made non-nullishable.
+ * Equivalent to a deep `Required<T>` for an object and `NonNullable<T>` for any other type.
+ *
+ * @template T
+ * Type.
+ */
+export type NonNullishable<T> = T extends object ? {
+    [P in keyof T]-?: NonNullishable<T[P]>;
+} : NonNullable<T>;
+/**
+ * Make some keys within a type optional.
+ *
+ * @template T
+ * Object type.
+ *
+ * @template K
+ * Object key type.
+ */
+export type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/**
+ * Type to restrict property keys to those that are strings and that support a specified type.
+ *
+ * @template T
+ * Object type.
+ *
+ * @template P
+ * Object property type.
+ */
+export type PropertyKeys<T, P> = {
+    [K in keyof T]: K extends string ? T[K] extends P ? K : never : never;
+}[keyof T];
+//# sourceMappingURL=type.d.ts.map

package/dist/type.d.ts.map

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

package/dist/type.js

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

package/dist/type.js.map

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

package/dist/website-url.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Alpha URL. Reads from local application storage, path "config", key "resources.local", if present, otherwise defaults
+ * to Vite development server URL.
+ */
+export declare const ALPHA_URL: Promise<string>;
+/**
+ * AIDC Toolkit website base URL.
+ */
+export declare const WEBSITE_BASE_URL = "https://aidc-toolkit.com";
+/**
+ * Determine the website URL based on the package version.
+ *
+ * @param version
+ * Package version.
+ *
+ * @param includeVersionInProduction
+ * If true, the version is included in the URL in production.
+ *
+ * @param alphaURL
+ * URL if pre-release identifier is "alpha".
+ *
+ * @param nonAlphaRelativeURL
+ * Non-alpha URL, relative to website base URL plus pre-release identifier (optional) and version.
+ *
+ * @returns
+ * Fully-formed website URL based on the package version.
+ */
+export declare function websiteURL(version: string, includeVersionInProduction: boolean, alphaURL: string, nonAlphaRelativeURL?: string): string;
+//# sourceMappingURL=website-url.d.ts.map

package/dist/website-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-url.d.ts","sourceRoot":"","sources":["../src/website-url.ts"],"names":[],"mappings":"AAyBA;;;GAGG;AACH,eAAO,MAAM,SAAS,iBAKrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,6BAA6B,CAAC;AAE3D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,0BAA0B,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,CAkBvI"}

package/dist/website-url.js

@@ -0,0 +1,60 @@
+import { LocalAppDataStorage } from "./local-app-data-storage.js";
+import { parseVersion } from "./parse-version.js";
+/**
+ * Default alpha URL (Vite development server URL) if no local resources found.
+ */
+const DEFAULT_ALPHA_URL = "http://localhost:5173";
+/**
+ * Configuration path, expected to be present in development but not necessarily in production.
+ */
+const CONFIGURATION_PATH = "config";
+/**
+ * Key to local resources, expected to be present in development but not necessarily in production.
+ */
+const LOCAL_RESOURCES_KEY = "resources.local";
+/**
+ * Alpha URL. Reads from local application storage, path "config", key "resources.local", if present, otherwise defaults
+ * to Vite development server URL.
+ */
+export const ALPHA_URL = LocalAppDataStorage.then(async (LocalAppDataStorage) => new LocalAppDataStorage(CONFIGURATION_PATH).read(LOCAL_RESOURCES_KEY)).then(resources => 
+// eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Fallback works regardless of type.
+resources?.alphaURL ?? DEFAULT_ALPHA_URL);
+/**
+ * AIDC Toolkit website base URL.
+ */
+export const WEBSITE_BASE_URL = "https://aidc-toolkit.com";
+/**
+ * Determine the website URL based on the package version.
+ *
+ * @param version
+ * Package version.
+ *
+ * @param includeVersionInProduction
+ * If true, the version is included in the URL in production.
+ *
+ * @param alphaURL
+ * URL if pre-release identifier is "alpha".
+ *
+ * @param nonAlphaRelativeURL
+ * Non-alpha URL, relative to website base URL plus pre-release identifier (optional) and version.
+ *
+ * @returns
+ * Fully-formed website URL based on the package version.
+ */
+export function websiteURL(version, includeVersionInProduction, alphaURL, nonAlphaRelativeURL) {
+    const parsedVersion = parseVersion(version);
+    const preReleaseIdentifier = parsedVersion.preReleaseIdentifier;
+    let url;
+    if (preReleaseIdentifier === "alpha") {
+        // Alpha base URL is absolute.
+        url = alphaURL;
+    }
+    else {
+        const preReleaseIdentifierPath = preReleaseIdentifier !== undefined ? `/${preReleaseIdentifier}` : "";
+        const versionPath = preReleaseIdentifier !== undefined || includeVersionInProduction ? `/v${parsedVersion.majorVersion}.${parsedVersion.minorVersion}` : "";
+        const relativeURL = nonAlphaRelativeURL !== undefined && nonAlphaRelativeURL !== "" ? `/${nonAlphaRelativeURL}` : "";
+        url = `${WEBSITE_BASE_URL}${preReleaseIdentifierPath}${versionPath}${relativeURL}`;
+    }
+    return url;
+}
+//# sourceMappingURL=website-url.js.map

package/dist/website-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-url.js","sourceRoot":"","sources":["../src/website-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;GAEG;AACH,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AAElD;;GAEG;AACH,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAEpC;;GAEG;AACH,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAS9C;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAC,mBAAmB,EAAC,EAAE,CAC1E,IAAI,mBAAmB,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CACxE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE;AACf,6GAA6G;AAC5G,SAA0C,EAAE,QAAQ,IAAI,iBAAiB,CAC7E,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAE3D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,0BAAmC,EAAE,QAAgB,EAAE,mBAA4B;IAC3H,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,oBAAoB,GAAG,aAAa,CAAC,oBAAoB,CAAC;IAEhE,IAAI,GAAW,CAAC;IAEhB,IAAI,oBAAoB,KAAK,OAAO,EAAE,CAAC;QACnC,8BAA8B;QAC9B,GAAG,GAAG,QAAQ,CAAC;IACnB,CAAC;SAAM,CAAC;QACJ,MAAM,wBAAwB,GAAG,oBAAoB,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtG,MAAM,WAAW,GAAG,oBAAoB,KAAK,SAAS,IAAI,0BAA0B,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,YAAY,IAAI,aAAa,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5J,MAAM,WAAW,GAAG,mBAAmB,KAAK,SAAS,IAAI,mBAAmB,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAErH,GAAG,GAAG,GAAG,gBAAgB,GAAG,wBAAwB,GAAG,WAAW,GAAG,WAAW,EAAE,CAAC;IACvF,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aidc-toolkit/core",
-  "version": "1.0.41",
+  "version": "1.0.43-beta",
   "description": "Core functionality for AIDC Toolkit",
   "type": "module",
   "main": "dist/index.js",
@@ -28,7 +28,7 @@
     "build:doc": "npm run build:non-prod"
   },
   "devDependencies": {
-    "@aidc-toolkit/dev": "^1.0.40"
+    "@aidc-toolkit/dev": "1.0.42-beta"
   },
   "dependencies": {
     "base64-js": "^1.5.1",

package/src/file-app-data-storage.ts

@@ -6,6 +6,11 @@ import { AppDataStorage } from "./app-data-storage.js";
  * Application data storage using the file system.
  */
 export class FileAppDataStorage extends AppDataStorage<true> {
+    /**
+     * If true, node:fs has been polyfilled with empty object.
+     */
+    readonly #isNoOp: boolean;
+
     /**
      * Constructor.
      *
@@ -14,36 +19,45 @@ export class FileAppDataStorage extends AppDataStorage<true> {
      */
     constructor(path?: string) {
         super(true, path);
+
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Condition is true in polyfilled environment.
+        this.#isNoOp = fs?.promises?.readFile === undefined;
     }
 
     /**
      * @inheritDoc
      */
     protected override async doRead(key: string, asBinary: boolean | undefined): Promise<string | Uint8Array | undefined> {
-        return fs.promises.readFile(key).then(buffer =>
-            asBinary === true ? buffer : buffer.toString()
-        ).catch(() =>
-            undefined
-        );
+        return !this.#isNoOp ?
+            fs.promises.readFile(key).then(buffer =>
+                asBinary === true ? buffer : buffer.toString()
+            ).catch(() =>
+                undefined
+            ) :
+            undefined;
     }
 
     /**
      * @inheritDoc
      */
     protected override async doWrite(key: string, data: string | Uint8Array): Promise<void> {
-        return fs.promises.mkdir(path.dirname(key), {
-            recursive: true
-        }).then(async () =>
-            fs.promises.writeFile(key, data)
-        );
+        return !this.#isNoOp ?
+            fs.promises.mkdir(path.dirname(key), {
+                recursive: true
+            }).then(async () =>
+                fs.promises.writeFile(key, data)
+            ) :
+            undefined;
     }
 
     /**
      * @inheritDoc
      */
     protected override async doDelete(key: string): Promise<void> {
-        return fs.promises.rm(key, {
-            force: true
-        });
+        return !this.#isNoOp ?
+            fs.promises.rm(key, {
+                force: true
+            }) :
+            undefined;
     }
 }

package/src/http-fetch.ts

@@ -0,0 +1,59 @@
+import type { Promisable } from "./type.js";
+
+/**
+ * HTTP status code for OK.
+ */
+export const HTTP_OK = 200;
+
+/**
+ * HTTP status code for not found.
+ */
+export const HTTP_NOT_FOUND = 404;
+
+/**
+ * Generic HTTP response.
+ */
+export interface HTTPResponse {
+    /**
+     * True if OK.
+     */
+    readonly ok: boolean;
+
+    /**
+     * HTTP status code.
+     */
+    readonly status: number;
+
+    /**
+     * Body as array buffer.
+     */
+    readonly arrayBuffer: () => Promisable<ArrayBuffer>;
+
+    /**
+     * Body as text.
+     */
+    readonly text: () => Promisable<string>;
+}
+
+/**
+ * HTTP fetch function.
+ */
+export type HTTPFetch = (url: string) => Promisable<HTTPResponse>;
+
+/**
+ * Default HTTP fetch function using global `fetch` function.
+ *
+ * @param url
+ * URL.
+ *
+ * @returns
+ * HTTP response.
+ */
+export async function defaultHTTPFetch(url: string): Promise<HTTPResponse> {
+    return fetch(url).then(response => ({
+        ok: response.ok,
+        status: response.status,
+        arrayBuffer: async () => response.arrayBuffer(),
+        text: async () => response.text()
+    }));
+}

package/src/index.ts

@@ -26,6 +26,7 @@ export * from "./website-url.js";
 export * from "./app-data.js";
 export * from "./app-data-storage.js";
 export * from "./local-app-data-storage.js";
+export * from "./http-fetch.js";
 export * from "./remote-app-data-storage.js";
 export * from "./cache.js";
 

package/src/remote-app-data-storage.ts

@@ -1,38 +1,46 @@
 import { ReadOnlyAppDataStorage } from "./app-data-storage.js";
+import { defaultHTTPFetch, HTTP_NOT_FOUND, type HTTPFetch } from "./http-fetch.js";
 import { i18nextCore } from "./locale/i18n.js";
 
 /**
- * Remote application data storage using HTTP. The `store()` and `delete()` methods are not supported.
+ * Remote application data storage using HTTP.
  */
 export class RemoteAppDataStorage extends ReadOnlyAppDataStorage<true> {
+    readonly #httpFetch: HTTPFetch;
+
     /**
      * Constructor.
      *
      * @param baseURL
      * Base URL. The URL must not end with a slash.
+     *
+     * @param httpFetch
+     * HTTP fetch function.
      */
-    constructor(baseURL: string) {
+    constructor(baseURL: string, httpFetch: HTTPFetch = defaultHTTPFetch) {
         super(true, baseURL);
+
+        this.#httpFetch = httpFetch;
     }
 
     /**
      * @inheritDoc
      */
     protected override async doRead(key: string, asBinary: boolean | undefined): Promise<string | Uint8Array | undefined> {
-        return fetch(key).then(async (response) => {
-            let result: string | Uint8Array | undefined;
+        const response = await this.#httpFetch(key);
+
+        let result: string | Uint8Array | undefined;
 
-            if (response.ok) {
-                result = asBinary === true ? new Uint8Array(await response.arrayBuffer()) : await response.text();
-            } else if (response.status === 404) {
-                result = undefined;
-            } else {
-                throw new RangeError(i18nextCore.t("RemoteAppDataStorage.httpError", {
-                    status: response.status
-                }));
-            }
+        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;
-        });
+        return result;
     }
 }