@aidc-toolkit/core 1.0.34-beta → 1.0.36-beta

package/dist/base-url.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Alpha base URL. Reads from local application storage, path "config", key "resources.local", if present, otherwise
+ * defaults to the Vite server URL.
+ */
+export declare const ALPHA_BASE_URL: Promise<string>;
+/**
+ * AIDC Toolkit base URL.
+ */
+export declare const AIDC_TOOLKIT_BASE_URL = "https://aidc-toolkit.com";
+/**
+ * Determine the base URL for the phase based on the package version.
+ *
+ * @param version
+ * Package version.
+ *
+ * @param alphaBaseURL
+ * Alpha base URL.
+ *
+ * @param nonAlphaRelativeURL
+ * Non-alpha URL, relative to non-alpha base URL and optionally the pre-release identifier and version.
+ *
+ * @returns
+ * Fully-formed base URL for the phase.
+ */
+export declare function baseURL(version: string, alphaBaseURL: string, nonAlphaRelativeURL?: string): string;
+//# sourceMappingURL=base-url.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-url.d.ts","sourceRoot":"","sources":["../src/base-url.ts"],"names":[],"mappings":"AAyBA;;;GAGG;AACH,eAAO,MAAM,cAAc,iBAK1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,6BAA6B,CAAC;AAEhE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,CAsBnG"}

package/dist/base-url.js

@@ -0,0 +1,62 @@
+import { LocalAppDataStorage } from "./local-app-data-storage.js";
+import { parseVersion } from "./parse-version.js";
+/**
+ * Default alpha URL (Vite development URL) if no local resources file is found.
+ */
+const DEFAULT_ALPHA_BASE_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 base URL. Reads from local application storage, path "config", key "resources.local", if present, otherwise
+ * defaults to the Vite server URL.
+ */
+export const ALPHA_BASE_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?.alphaBaseURL ?? DEFAULT_ALPHA_BASE_URL);
+/**
+ * AIDC Toolkit base URL.
+ */
+export const AIDC_TOOLKIT_BASE_URL = "https://aidc-toolkit.com";
+/**
+ * Determine the base URL for the phase based on the package version.
+ *
+ * @param version
+ * Package version.
+ *
+ * @param alphaBaseURL
+ * Alpha base URL.
+ *
+ * @param nonAlphaRelativeURL
+ * Non-alpha URL, relative to non-alpha base URL and optionally the pre-release identifier and version.
+ *
+ * @returns
+ * Fully-formed base URL for the phase.
+ */
+export function baseURL(version, alphaBaseURL, nonAlphaRelativeURL) {
+    const parsedVersion = parseVersion(version);
+    const preReleaseIdentifier = parsedVersion.preReleaseIdentifier;
+    let url;
+    if (preReleaseIdentifier === "alpha") {
+        // Alpha base URL is absolute.
+        url = alphaBaseURL;
+    }
+    else {
+        const relativeURL = nonAlphaRelativeURL !== undefined && nonAlphaRelativeURL !== "" ? `/${nonAlphaRelativeURL}` : "";
+        if (preReleaseIdentifier !== undefined) {
+            // Non-alpha base URL is relative to AIDC Toolkit base URL plus pre-release identifier and version.
+            url = `${AIDC_TOOLKIT_BASE_URL}/${preReleaseIdentifier}/v${parsedVersion.majorVersion}.${parsedVersion.minorVersion}${relativeURL}`;
+        }
+        else {
+            // Production base URL is relative to AIDC Toolkit base URL.
+            url = `${AIDC_TOOLKIT_BASE_URL}${relativeURL}`;
+        }
+    }
+    return url;
+}
+//# sourceMappingURL=base-url.js.map

package/dist/base-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-url.js","sourceRoot":"","sources":["../src/base-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;GAEG;AACH,MAAM,sBAAsB,GAAG,uBAAuB,CAAC;AAEvD;;GAEG;AACH,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAEpC;;GAEG;AACH,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAS9C;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAC,mBAAmB,EAAC,EAAE,CAC/E,IAAI,mBAAmB,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CACxE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE;AACf,6GAA6G;AAC5G,SAA0C,EAAE,YAAY,IAAI,sBAAsB,CACtF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAEhE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,YAAoB,EAAE,mBAA4B;IACvF,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,YAAY,CAAC;IACvB,CAAC;SAAM,CAAC;QACJ,MAAM,WAAW,GAAG,mBAAmB,KAAK,SAAS,IAAI,mBAAmB,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAErH,IAAI,oBAAoB,KAAK,SAAS,EAAE,CAAC;YACrC,mGAAmG;YACnG,GAAG,GAAG,GAAG,qBAAqB,IAAI,oBAAoB,KAAK,aAAa,CAAC,YAAY,IAAI,aAAa,CAAC,YAAY,GAAG,WAAW,EAAE,CAAC;QACxI,CAAC;aAAM,CAAC;YACJ,4DAA4D;YAC5D,GAAG,GAAG,GAAG,qBAAqB,GAAG,WAAW,EAAE,CAAC;QACnD,CAAC;IACL,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -18,7 +18,7 @@ export type * from "./type.js";
 export * from "./type-helper.js";
 export * from "./logger.js";
 export * from "./parse-version.js";
-export * from "./phase-url.js";
+export * from "./base-url.js";
 export * from "./app-data.js";
 export * from "./app-data-storage.js";
 export * from "./local-app-data-storage.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,mBAAmB,WAAW,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,aAAa,CAAC;AAE5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,YAAY,CAAC;AAE3B,mBAAmB,gBAAgB,CAAC;AAEpC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,mBAAmB,WAAW,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,aAAa,CAAC;AAE5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAE9B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,YAAY,CAAC;AAE3B,mBAAmB,gBAAgB,CAAC;AAEpC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -17,7 +17,7 @@
 export * from "./type-helper.js";
 export * from "./logger.js";
 export * from "./parse-version.js";
-export * from "./phase-url.js";
+export * from "./base-url.js";
 export * from "./app-data.js";
 export * from "./app-data-storage.js";
 export * from "./local-app-data-storage.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,cAAc,kBAAkB,CAAC;AAEjC,cAAc,aAAa,CAAC;AAE5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,YAAY,CAAC;AAI3B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,cAAc,kBAAkB,CAAC;AAEjC,cAAc,aAAa,CAAC;AAE5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAE9B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,YAAY,CAAC;AAI3B,cAAc,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aidc-toolkit/core",
-  "version": "1.0.34-beta",
+  "version": "1.0.36-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.34-beta"
+    "@aidc-toolkit/dev": "1.0.35-beta"
   },
   "dependencies": {
     "base64-js": "^1.5.1",

package/src/base-url.ts

@@ -0,0 +1,79 @@
+import { LocalAppDataStorage } from "./local-app-data-storage.js";
+import { parseVersion } from "./parse-version.js";
+
+/**
+ * Default alpha URL (Vite development URL) if no local resources file is found.
+ */
+const DEFAULT_ALPHA_BASE_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";
+
+/**
+ * Local resources.
+ */
+interface LocalResources {
+    alphaBaseURL: string;
+}
+
+/**
+ * Alpha base URL. Reads from local application storage, path "config", key "resources.local", if present, otherwise
+ * defaults to the Vite server URL.
+ */
+export const ALPHA_BASE_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 as (LocalResources | undefined))?.alphaBaseURL ?? DEFAULT_ALPHA_BASE_URL
+);
+
+/**
+ * AIDC Toolkit base URL.
+ */
+export const AIDC_TOOLKIT_BASE_URL = "https://aidc-toolkit.com";
+
+/**
+ * Determine the base URL for the phase based on the package version.
+ *
+ * @param version
+ * Package version.
+ *
+ * @param alphaBaseURL
+ * Alpha base URL.
+ *
+ * @param nonAlphaRelativeURL
+ * Non-alpha URL, relative to non-alpha base URL and optionally the pre-release identifier and version.
+ *
+ * @returns
+ * Fully-formed base URL for the phase.
+ */
+export function baseURL(version: string, alphaBaseURL: string, nonAlphaRelativeURL?: string): string {
+    const parsedVersion = parseVersion(version);
+    const preReleaseIdentifier = parsedVersion.preReleaseIdentifier;
+
+    let url: string;
+
+    if (preReleaseIdentifier === "alpha") {
+        // Alpha base URL is absolute.
+        url = alphaBaseURL;
+    } else {
+        const relativeURL = nonAlphaRelativeURL !== undefined && nonAlphaRelativeURL !== "" ? `/${nonAlphaRelativeURL}` : "";
+
+        if (preReleaseIdentifier !== undefined) {
+            // Non-alpha base URL is relative to AIDC Toolkit base URL plus pre-release identifier and version.
+            url = `${AIDC_TOOLKIT_BASE_URL}/${preReleaseIdentifier}/v${parsedVersion.majorVersion}.${parsedVersion.minorVersion}${relativeURL}`;
+        } else {
+            // Production base URL is relative to AIDC Toolkit base URL.
+            url = `${AIDC_TOOLKIT_BASE_URL}${relativeURL}`;
+        }
+    }
+
+    return url;
+}

package/src/index.ts

@@ -21,7 +21,7 @@ export * from "./type-helper.js";
 export * from "./logger.js";
 
 export * from "./parse-version.js";
-export * from "./phase-url.js";
+export * from "./base-url.js";
 
 export * from "./app-data.js";
 export * from "./app-data-storage.js";

package/dist/phase-url.d.ts

@@ -1,17 +0,0 @@
-/**
- * Get the URL for the phase as determined by the package version.
- *
- * @param version
- * Package version.
- *
- * @param alphaURL
- * Alpha URL.
- *
- * @param nonAlphaRelativeURL
- * Non-alpha URL, relative to non-alpha base URL plus optionally the pre-release identifier and version.
- *
- * @returns
- * Fully-formed URL for the phase.
- */
-export declare function phaseURL(version: string, alphaURL: string, nonAlphaRelativeURL?: string): string;
-//# sourceMappingURL=phase-url.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"phase-url.d.ts","sourceRoot":"","sources":["../src/phase-url.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,CAsBhG"}

package/dist/phase-url.js

@@ -1,39 +0,0 @@
-import { parseVersion } from "./parse-version.js";
-const NON_ALPHA_BASE_URL = "https://aidc-toolkit.com";
-/**
- * Get the URL for the phase as determined by the package version.
- *
- * @param version
- * Package version.
- *
- * @param alphaURL
- * Alpha URL.
- *
- * @param nonAlphaRelativeURL
- * Non-alpha URL, relative to non-alpha base URL plus optionally the pre-release identifier and version.
- *
- * @returns
- * Fully-formed URL for the phase.
- */
-export function phaseURL(version, alphaURL, nonAlphaRelativeURL) {
-    const parsedVersion = parseVersion(version);
-    const preReleaseIdentifier = parsedVersion.preReleaseIdentifier;
-    let url;
-    if (preReleaseIdentifier === "alpha") {
-        // Alpha URL is absolute.
-        url = alphaURL;
-    }
-    else {
-        const relativeURL = nonAlphaRelativeURL !== undefined && nonAlphaRelativeURL !== "" ? `/${nonAlphaRelativeURL}` : "";
-        if (preReleaseIdentifier !== undefined) {
-            // Non-alpha URL is relative to non-alpha base URL plus pre-release identifier and version.
-            url = `${NON_ALPHA_BASE_URL}/${preReleaseIdentifier}/v${parsedVersion.majorVersion}.${parsedVersion.minorVersion}${relativeURL}`;
-        }
-        else {
-            // Production URL is relative to non-alpha base URL.
-            url = `${NON_ALPHA_BASE_URL}${relativeURL}`;
-        }
-    }
-    return url;
-}
-//# sourceMappingURL=phase-url.js.map

package/dist/phase-url.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"phase-url.js","sourceRoot":"","sources":["../src/phase-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAEtD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,QAAgB,EAAE,mBAA4B;IACpF,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,yBAAyB;QACzB,GAAG,GAAG,QAAQ,CAAC;IACnB,CAAC;SAAM,CAAC;QACJ,MAAM,WAAW,GAAG,mBAAmB,KAAK,SAAS,IAAI,mBAAmB,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAErH,IAAI,oBAAoB,KAAK,SAAS,EAAE,CAAC;YACrC,2FAA2F;YAC3F,GAAG,GAAG,GAAG,kBAAkB,IAAI,oBAAoB,KAAK,aAAa,CAAC,YAAY,IAAI,aAAa,CAAC,YAAY,GAAG,WAAW,EAAE,CAAC;QACrI,CAAC;aAAM,CAAC;YACJ,oDAAoD;YACpD,GAAG,GAAG,GAAG,kBAAkB,GAAG,WAAW,EAAE,CAAC;QAChD,CAAC;IACL,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC"}

package/src/phase-url.ts

@@ -1,42 +0,0 @@
-import { parseVersion } from "./parse-version.js";
-
-const NON_ALPHA_BASE_URL = "https://aidc-toolkit.com";
-
-/**
- * Get the URL for the phase as determined by the package version.
- *
- * @param version
- * Package version.
- *
- * @param alphaURL
- * Alpha URL.
- *
- * @param nonAlphaRelativeURL
- * Non-alpha URL, relative to non-alpha base URL plus optionally the pre-release identifier and version.
- *
- * @returns
- * Fully-formed URL for the phase.
- */
-export function phaseURL(version: string, alphaURL: string, nonAlphaRelativeURL?: string): string {
-    const parsedVersion = parseVersion(version);
-    const preReleaseIdentifier = parsedVersion.preReleaseIdentifier;
-
-    let url: string;
-
-    if (preReleaseIdentifier === "alpha") {
-        // Alpha URL is absolute.
-        url = alphaURL;
-    } else {
-        const relativeURL = nonAlphaRelativeURL !== undefined && nonAlphaRelativeURL !== "" ? `/${nonAlphaRelativeURL}` : "";
-
-        if (preReleaseIdentifier !== undefined) {
-            // Non-alpha URL is relative to non-alpha base URL plus pre-release identifier and version.
-            url = `${NON_ALPHA_BASE_URL}/${preReleaseIdentifier}/v${parsedVersion.majorVersion}.${parsedVersion.minorVersion}${relativeURL}`;
-        } else {
-            // Production URL is relative to non-alpha base URL.
-            url = `${NON_ALPHA_BASE_URL}${relativeURL}`;
-        }
-    }
-
-    return url;
-}