@putkoff/abstract-utilities 1.0.147 → 1.0.156

package/dist/esm/src/browser/src/read_utils/src/readJsonFile.browser.js

@@ -0,0 +1,32 @@
+//src/browser/src/read_utils
+/**
+ * Safely walk `globalThis` (or window/document) by a chain of property names.
+ * Returns `undefined` if any step is missing.
+ */
+function safeGlobalProp(...path) {
+    let obj = globalThis;
+    for (const key of path) {
+        if (obj == null || typeof obj !== "object" || !(key in obj)) {
+            return undefined;
+        }
+        obj = obj[key];
+    }
+    return obj;
+}
+async function readJsonFileBrowser(url) {
+    const fetchFn = safeGlobalProp("fetch");
+    if (typeof fetchFn !== "function")
+        return null;
+    try {
+        const res = await fetchFn(url);
+        if (!res.ok)
+            return null;
+        return (await res.json());
+    }
+    catch {
+        return null;
+    }
+}
+
+export { readJsonFileBrowser, safeGlobalProp };
+//# sourceMappingURL=readJsonFile.browser.js.map

package/dist/esm/src/browser/src/read_utils/src/readJsonFile.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readJsonFile.browser.js","sources":["../../../../../../../src/browser/src/read_utils/src/readJsonFile.browser.ts"],"sourcesContent":["//src/browser/src/read_utils\n/** \n * Safely walk `globalThis` (or window/document) by a chain of property names.\n * Returns `undefined` if any step is missing.\n */\nexport function safeGlobalProp<T = any>(...path: string[]): T | undefined {\n  let obj: any = globalThis;\n  for (const key of path) {\n    if (obj == null || typeof obj !== \"object\" || !(key in obj)) {\n      return undefined;\n    }\n    obj = obj[key];\n  }\n  return obj as T;\n}\n\nexport async function readJsonFileBrowser<T = any>(\n  url: string\n): Promise<T | null> {\n  const fetchFn = safeGlobalProp<typeof fetch>(\"fetch\");\n  if (typeof fetchFn !== \"function\") return null;\n\n  try {\n    const res = await fetchFn(url);\n    if (!res.ok) return null;\n    return (await res.json()) as T;\n  } catch {\n    return null;\n  }\n}\n"],"names":[],"mappings":"AAAA;AACA;;;AAGG;AACG,SAAU,cAAc,CAAU,GAAG,IAAc,EAAA;IACvD,IAAI,GAAG,GAAQ,UAAU;AACzB,IAAA,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE;AACtB,QAAA,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,EAAE,GAAG,IAAI,GAAG,CAAC,EAAE;AAC3D,YAAA,OAAO,SAAS;QAClB;AACA,QAAA,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IAChB;AACA,IAAA,OAAO,GAAQ;AACjB;AAEO,eAAe,mBAAmB,CACvC,GAAW,EAAA;AAEX,IAAA,MAAM,OAAO,GAAG,cAAc,CAAe,OAAO,CAAC;IACrD,IAAI,OAAO,OAAO,KAAK,UAAU;AAAE,QAAA,OAAO,IAAI;AAE9C,IAAA,IAAI;AACF,QAAA,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,EAAE;AAAE,YAAA,OAAO,IAAI;AACxB,QAAA,QAAQ,MAAM,GAAG,CAAC,IAAI,EAAE;IAC1B;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,IAAI;IACb;AACF;;;;"}

package/dist/esm/src/client/auth/src/token_client.js

@@ -0,0 +1,79 @@
+import { decodeJwt, isTokenExpired } from '../../../functions/auth_utils/src/jwt_core.js';
+import { callStorage } from '../../../functions/safe_utils/src/safe_storage.js';
+import '../../../../node_modules/path-browserify/index.js';
+import '../../../functions/type_utils/src/mime_utils.js';
+import 'util';
+
+/** Read raw JWT from LocalStorage (or null if absent) */
+function getToken() {
+    return callStorage('getItem', 'token');
+}
+function isLoggedIn() {
+    const tok = getToken();
+    return !!tok && !isTokenExpired(tok ?? "");
+}
+/**
+ * Add a Bearer Authorization header.
+ * A shallow copy of headers is returned so callers can keep chaining.
+ */
+function getAuthorizationHeader(headers = {}, token = null) {
+    token = token ?? getToken();
+    headers = headers || {};
+    if (token)
+        headers["Authorization"] = `Bearer ${token}`;
+    return { ...headers };
+}
+/** Throw + redirect if there’s no valid token; otherwise return it. */
+function requireToken() {
+    const tok = getToken();
+    if (!tok || isTokenExpired(tok)) {
+        console.warn("→ No token or expired token, redirecting to login…");
+        localStorage.removeItem("token");
+        window.location.href = '/';
+        throw new Error("Redirecting to login…");
+    }
+    return tok;
+}
+/** Convenience wrapper: return username from the JWT (or null). */
+function currentUsername() {
+    const tok = getToken();
+    if (!tok)
+        return null;
+    try {
+        const { username } = decodeJwt(tok);
+        return username ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function currentUsernames() {
+    const tok = getToken();
+    if (!tok)
+        return null;
+    try {
+        const parts = tok.split(".");
+        if (parts.length !== 3)
+            return null;
+        let b64 = parts[1].replace(/-/g, "+").replace(/_/g, "/");
+        b64 = b64.padEnd(Math.ceil(b64.length / 4) * 4, "=");
+        const jsonText = atob(b64);
+        const payload = JSON.parse(jsonText);
+        return payload.username ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Remove the JWT from LocalStorage */
+function removeToken() {
+    try {
+        callStorage('removeItem', 'token');
+    }
+    catch (err) {
+        console.warn("Failed to remove token:", err);
+    }
+}
+
+export { currentUsername, currentUsernames, getAuthorizationHeader, getToken, isLoggedIn, removeToken, requireToken };
+//# sourceMappingURL=token_client.js.map

package/dist/esm/src/client/auth/src/token_client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token_client.js","sources":["../../../../../../src/client/auth/src/token_client.ts"],"sourcesContent":["\nimport {\n  isTokenExpired,\n  decodeJwt,\n  callStorage\n} from './../../../functions/index.js'\n\n/** Read raw JWT from LocalStorage (or null if absent) */\nexport function getToken(): string | null | any {\n  return callStorage('getItem', 'token');\n}\n\n\nexport function isLoggedIn() {\n  const tok = getToken();\n  return !!tok && !isTokenExpired(tok ?? \"\");\n}\n\n\n/**\n * Add a Bearer Authorization header.\n * A shallow copy of headers is returned so callers can keep chaining.\n */\nexport function getAuthorizationHeader(\n  headers: Record<string, string> | null = {},\n  token: string | null = null\n): Record<string, string> {\n  token = token ?? getToken();\n  headers = headers || {}\n  if (token) headers[\"Authorization\"] = `Bearer ${token}`;\n  return { ...headers };\n}\n\n\n/** Throw + redirect if there’s no valid token; otherwise return it. */\nexport function requireToken(): string {\n  const tok = getToken();\n  if (!tok || isTokenExpired(tok)) {\n    console.warn(\"→ No token or expired token, redirecting to login…\");\n    localStorage.removeItem(\"token\");\n    window.location.href = '/';\n    throw new Error(\"Redirecting to login…\");\n  }\n  return tok;\n}\n\n\n\n\n/** Convenience wrapper: return username from the JWT (or null). */\nexport function currentUsername() {\n  const tok = getToken();\n  if (!tok) return null;\n  try {\n    const { username } = decodeJwt(tok);\n    return username ?? null;\n  } catch {\n    return null;\n  }\n}\nexport function currentUsernames() {\n  const tok = getToken();\n  if (!tok) return null;\n  try {\n    const parts = tok.split(\".\");\n    if (parts.length !== 3) return null;\n    let b64 = parts[1].replace(/-/g, \"+\").replace(/_/g, \"/\");\n    b64 = b64.padEnd(Math.ceil(b64.length / 4) * 4, \"=\");\n    const jsonText = atob(b64);\n    const payload = JSON.parse(jsonText);\n    return payload.username ?? null;\n  } catch {\n    return null;\n  }\n}\n\n/** Remove the JWT from LocalStorage */\nexport function removeToken(): void {\n  try {\n    callStorage('removeItem', 'token');\n  } catch (err) {\n    console.warn(\"Failed to remove token:\", err);\n  }\n}"],"names":[],"mappings":";;;;;;AAOA;SACgB,QAAQ,GAAA;AACtB,IAAA,OAAO,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC;AACxC;SAGgB,UAAU,GAAA;AACxB,IAAA,MAAM,GAAG,GAAG,QAAQ,EAAE;IACtB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,IAAI,EAAE,CAAC;AAC5C;AAGA;;;AAGG;SACa,sBAAsB,CACpC,UAAyC,EAAE,EAC3C,QAAuB,IAAI,EAAA;AAE3B,IAAA,KAAK,GAAG,KAAK,IAAI,QAAQ,EAAE;AAC3B,IAAA,OAAO,GAAG,OAAO,IAAI,EAAE;AACvB,IAAA,IAAI,KAAK;AAAE,QAAA,OAAO,CAAC,eAAe,CAAC,GAAG,CAAA,OAAA,EAAU,KAAK,EAAE;AACvD,IAAA,OAAO,EAAE,GAAG,OAAO,EAAE;AACvB;AAGA;SACgB,YAAY,GAAA;AAC1B,IAAA,MAAM,GAAG,GAAG,QAAQ,EAAE;IACtB,IAAI,CAAC,GAAG,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE;AAC/B,QAAA,OAAO,CAAC,IAAI,CAAC,oDAAoD,CAAC;AAClE,QAAA,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC;AAChC,QAAA,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,GAAG;AAC1B,QAAA,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC;IAC1C;AACA,IAAA,OAAO,GAAG;AACZ;AAKA;SACgB,eAAe,GAAA;AAC7B,IAAA,MAAM,GAAG,GAAG,QAAQ,EAAE;AACtB,IAAA,IAAI,CAAC,GAAG;AAAE,QAAA,OAAO,IAAI;AACrB,IAAA,IAAI;QACF,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC;QACnC,OAAO,QAAQ,IAAI,IAAI;IACzB;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,IAAI;IACb;AACF;SACgB,gBAAgB,GAAA;AAC9B,IAAA,MAAM,GAAG,GAAG,QAAQ,EAAE;AACtB,IAAA,IAAI,CAAC,GAAG;AAAE,QAAA,OAAO,IAAI;AACrB,IAAA,IAAI;QACF,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;AAC5B,QAAA,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;AAAE,YAAA,OAAO,IAAI;QACnC,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;QACxD,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;AACpD,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;AACpC,QAAA,OAAO,OAAO,CAAC,QAAQ,IAAI,IAAI;IACjC;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,IAAI;IACb;AACF;AAEA;SACgB,WAAW,GAAA;AACzB,IAAA,IAAI;AACF,QAAA,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC;IACpC;IAAE,OAAO,GAAG,EAAE;AACZ,QAAA,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,GAAG,CAAC;IAC9C;AACF;;;;"}

package/dist/esm/src/functions/auth_utils/src/jwt_core.js

@@ -0,0 +1,28 @@
+/** True if token is structurally bad or its exp ≤ now. */
+function isTokenExpired(token) {
+    try {
+        const payload = decodeJwt(token);
+        return Date.now() / 1000 >= payload.exp;
+    }
+    catch {
+        return true; // treat malformed token as expired
+    }
+}
+/* ------------------------------------------------------------------ */
+/*  internals                                                         */
+/* ------------------------------------------------------------------ */
+function decodeJwt(token) {
+    const [header, payload, signature] = token.split(".");
+    if (!header || !payload || !signature) {
+        throw new Error("Malformed JWT");
+    }
+    // Handle URL-safe Base64
+    let b64 = payload.replace(/-/g, "+").replace(/_/g, "/");
+    // Add padding if necessary
+    b64 = b64.padEnd(Math.ceil(b64.length / 4) * 4, "=");
+    const jsonText = atob(b64);
+    return JSON.parse(jsonText);
+}
+
+export { decodeJwt, isTokenExpired };
+//# sourceMappingURL=jwt_core.js.map

package/dist/esm/src/functions/auth_utils/src/jwt_core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt_core.js","sources":["../../../../../../src/functions/auth_utils/src/jwt_core.ts"],"sourcesContent":["/**\n * Helpers for dealing with the JWT stored in localStorage.\n */\nimport type { JwtPayload } from './../imports.js';\n\n\n\n/** True if token is structurally bad or its exp ≤ now. */\nexport function isTokenExpired(token: string): boolean {\n  try {\n    const payload = decodeJwt(token);\n    return Date.now() / 1000 >= payload.exp;\n  } catch {\n    return true; // treat malformed token as expired\n  }\n}\n\n/* ------------------------------------------------------------------ */\n/*  internals                                                         */\n/* ------------------------------------------------------------------ */\n\nexport function decodeJwt(token: string): JwtPayload {\n  const [header, payload, signature] = token.split(\".\");\n  if (!header || !payload || !signature) {\n    throw new Error(\"Malformed JWT\");\n  }\n\n  // Handle URL-safe Base64\n  let b64 = payload.replace(/-/g, \"+\").replace(/_/g, \"/\");\n  // Add padding if necessary\n  b64 = b64.padEnd(Math.ceil(b64.length / 4) * 4, \"=\");\n\n  const jsonText = atob(b64);\n  return JSON.parse(jsonText) as JwtPayload;\n}"],"names":[],"mappings":"AAOA;AACM,SAAU,cAAc,CAAC,KAAa,EAAA;AAC1C,IAAA,IAAI;AACF,QAAA,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC;QAChC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG;IACzC;AAAE,IAAA,MAAM;QACN,OAAO,IAAI,CAAC;IACd;AACF;AAEA;AACA;AACA;AAEM,SAAU,SAAS,CAAC,KAAa,EAAA;AACrC,IAAA,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;IACrD,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS,EAAE;AACrC,QAAA,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC;IAClC;;AAGA,IAAA,IAAI,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;;IAEvD,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;AAEpD,IAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC;AAC1B,IAAA,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAe;AAC3C;;;;"}

package/dist/esm/src/functions/auth_utils/src/token_utils.js

@@ -0,0 +1,87 @@
+import { callStorage } from '../../safe_utils/src/safe_storage.js';
+import { decodeJwt, isTokenExpired } from './jwt_core.js';
+
+/**
+ * Helpers for dealing with the JWT stored in localStorage.
+ */
+/**
+***Changes**:
+*- Updated import path for `InputProps` to `../../types/interfaces`.
+*
+*3. **Token Utilities** (`src/functions/auth/token_utils.ts`):
+*   Copy from `/var/www/abstractendeavors/my-login-app/src/functions/auth_utils/token_utils.ts`.
+*
+*/
+/** Read raw JWT from LocalStorage (or null if absent) */
+function getToken() {
+    return callStorage('getItem', 'token');
+}
+function isLoggedIn() {
+    const tok = getToken();
+    return !!tok && !isTokenExpired(tok ?? "");
+}
+/**
+ * Add a Bearer Authorization header.
+ * A shallow copy of headers is returned so callers can keep chaining.
+ */
+function getAuthorizationHeader(headers = {}, token = null) {
+    token = token ?? getToken();
+    headers = headers || {};
+    if (token)
+        headers["Authorization"] = `Bearer ${token}`;
+    return { ...headers };
+}
+/** Throw + redirect if there’s no valid token; otherwise return it. */
+function requireToken() {
+    const tok = getToken();
+    if (!tok || isTokenExpired(tok)) {
+        console.warn("→ No token or expired token, redirecting to login…");
+        localStorage.removeItem("token");
+        window.location.href = '/';
+        throw new Error("Redirecting to login…");
+    }
+    return tok;
+}
+/** Convenience wrapper: return username from the JWT (or null). */
+function currentUsername() {
+    const tok = getToken();
+    if (!tok)
+        return null;
+    try {
+        const { username } = decodeJwt(tok);
+        return username ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function currentUsernames() {
+    const tok = getToken();
+    if (!tok)
+        return null;
+    try {
+        const parts = tok.split(".");
+        if (parts.length !== 3)
+            return null;
+        let b64 = parts[1].replace(/-/g, "+").replace(/_/g, "/");
+        b64 = b64.padEnd(Math.ceil(b64.length / 4) * 4, "=");
+        const jsonText = atob(b64);
+        const payload = JSON.parse(jsonText);
+        return payload.username ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Remove the JWT from LocalStorage */
+function removeToken() {
+    try {
+        callStorage('removeItem', 'token');
+    }
+    catch (err) {
+        console.warn("Failed to remove token:", err);
+    }
+}
+
+export { currentUsername, currentUsernames, getAuthorizationHeader, getToken, isLoggedIn, removeToken, requireToken };
+//# sourceMappingURL=token_utils.js.map

package/dist/esm/src/functions/auth_utils/src/token_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token_utils.js","sources":["../../../../../../src/functions/auth_utils/src/token_utils.ts"],"sourcesContent":["/**\n * Helpers for dealing with the JWT stored in localStorage.\n */\n\nimport { callStorage } from './../imports.js';\nimport {isTokenExpired,decodeJwt} from './jwt_core.js';\n/**\n***Changes**:\n*- Updated import path for `InputProps` to `../../types/interfaces`.\n*\n*3. **Token Utilities** (`src/functions/auth/token_utils.ts`):\n*   Copy from `/var/www/abstractendeavors/my-login-app/src/functions/auth_utils/token_utils.ts`.\n*\n*/\n/** Read raw JWT from LocalStorage (or null if absent) */\nexport function getToken(): string | null | any {\n  return callStorage('getItem', 'token');\n}\n\n\nexport function isLoggedIn() {\n  const tok = getToken();\n  return !!tok && !isTokenExpired(tok ?? \"\");\n}\n\n\n/**\n * Add a Bearer Authorization header.\n * A shallow copy of headers is returned so callers can keep chaining.\n */\nexport function getAuthorizationHeader(\n  headers: Record<string, string> | null = {},\n  token: string | null = null\n): Record<string, string> {\n  token = token ?? getToken();\n  headers = headers || {}\n  if (token) headers[\"Authorization\"] = `Bearer ${token}`;\n  return { ...headers };\n}\n\n\n/** Throw + redirect if there’s no valid token; otherwise return it. */\nexport function requireToken(): string {\n  const tok = getToken();\n  if (!tok || isTokenExpired(tok)) {\n    console.warn(\"→ No token or expired token, redirecting to login…\");\n    localStorage.removeItem(\"token\");\n    window.location.href = '/';\n    throw new Error(\"Redirecting to login…\");\n  }\n  return tok;\n}\n\n\n\n\n/** Convenience wrapper: return username from the JWT (or null). */\nexport function currentUsername() {\n  const tok = getToken();\n  if (!tok) return null;\n  try {\n    const { username } = decodeJwt(tok);\n    return username ?? null;\n  } catch {\n    return null;\n  }\n}\nexport function currentUsernames() {\n  const tok = getToken();\n  if (!tok) return null;\n  try {\n    const parts = tok.split(\".\");\n    if (parts.length !== 3) return null;\n    let b64 = parts[1].replace(/-/g, \"+\").replace(/_/g, \"/\");\n    b64 = b64.padEnd(Math.ceil(b64.length / 4) * 4, \"=\");\n    const jsonText = atob(b64);\n    const payload = JSON.parse(jsonText);\n    return payload.username ?? null;\n  } catch {\n    return null;\n  }\n}\n\n/** Remove the JWT from LocalStorage */\nexport function removeToken(): void {\n  try {\n    callStorage('removeItem', 'token');\n  } catch (err) {\n    console.warn(\"Failed to remove token:\", err);\n  }\n}\n\n"],"names":[],"mappings":";;;AAAA;;AAEG;AAIH;;;;;;;AAOE;AACF;SACgB,QAAQ,GAAA;AACtB,IAAA,OAAO,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC;AACxC;SAGgB,UAAU,GAAA;AACxB,IAAA,MAAM,GAAG,GAAG,QAAQ,EAAE;IACtB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,IAAI,EAAE,CAAC;AAC5C;AAGA;;;AAGG;SACa,sBAAsB,CACpC,UAAyC,EAAE,EAC3C,QAAuB,IAAI,EAAA;AAE3B,IAAA,KAAK,GAAG,KAAK,IAAI,QAAQ,EAAE;AAC3B,IAAA,OAAO,GAAG,OAAO,IAAI,EAAE;AACvB,IAAA,IAAI,KAAK;AAAE,QAAA,OAAO,CAAC,eAAe,CAAC,GAAG,CAAA,OAAA,EAAU,KAAK,EAAE;AACvD,IAAA,OAAO,EAAE,GAAG,OAAO,EAAE;AACvB;AAGA;SACgB,YAAY,GAAA;AAC1B,IAAA,MAAM,GAAG,GAAG,QAAQ,EAAE;IACtB,IAAI,CAAC,GAAG,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE;AAC/B,QAAA,OAAO,CAAC,IAAI,CAAC,oDAAoD,CAAC;AAClE,QAAA,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC;AAChC,QAAA,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,GAAG;AAC1B,QAAA,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC;IAC1C;AACA,IAAA,OAAO,GAAG;AACZ;AAKA;SACgB,eAAe,GAAA;AAC7B,IAAA,MAAM,GAAG,GAAG,QAAQ,EAAE;AACtB,IAAA,IAAI,CAAC,GAAG;AAAE,QAAA,OAAO,IAAI;AACrB,IAAA,IAAI;QACF,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC;QACnC,OAAO,QAAQ,IAAI,IAAI;IACzB;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,IAAI;IACb;AACF;SACgB,gBAAgB,GAAA;AAC9B,IAAA,MAAM,GAAG,GAAG,QAAQ,EAAE;AACtB,IAAA,IAAI,CAAC,GAAG;AAAE,QAAA,OAAO,IAAI;AACrB,IAAA,IAAI;QACF,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;AAC5B,QAAA,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;AAAE,YAAA,OAAO,IAAI;QACnC,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;QACxD,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;AACpD,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;AACpC,QAAA,OAAO,OAAO,CAAC,QAAQ,IAAI,IAAI;IACjC;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,IAAI;IACb;AACF;AAEA;SACgB,WAAW,GAAA;AACzB,IAAA,IAAI;AACF,QAAA,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC;IACpC;IAAE,OAAO,GAAG,EAAE;AACZ,QAAA,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,GAAG,CAAC;IAC9C;AACF;;;;"}

package/dist/esm/src/functions/config_utils/src/config_utils.js

@@ -0,0 +1,74 @@
+import { safeGlobalProp } from '../../safe_utils/src/safe_globals.js';
+import { readJsonFile } from '../../read_utils/src/readJsonFile.js';
+
+// src/functions/config_utils/src/config_utils.ts
+let _cachedConfig = null;
+async function loadConfig(filePath = null) {
+    if (_cachedConfig) {
+        return _cachedConfig;
+    }
+    // 1) figure out where config.json lives
+    let configUrl;
+    if (filePath) {
+        configUrl = filePath;
+    }
+    else if (typeof import.meta !== 'undefined' && typeof import.meta.url === 'string') {
+        // ES module: resolve relative to this file
+        try {
+            const mod = await (new Function("return import('./config.json').catch(() => ({}))"))();
+            _cachedConfig = mod.default ?? {};
+            return _cachedConfig;
+        }
+        catch {
+            configUrl = 'config.json';
+        }
+    }
+    else {
+        // browser fallback
+        const baseURI = safeGlobalProp('document', 'baseURI');
+        try {
+            configUrl =
+                typeof baseURI === 'string'
+                    ? new URL('config.json', baseURI).href
+                    : 'config.json';
+        }
+        catch {
+            configUrl = 'config.json';
+        }
+    }
+    // 2) if we have a fetch, try HTTP(S)
+    const fetchFn = safeGlobalProp('fetch');
+    if (typeof fetchFn === 'function') {
+        try {
+            const res = await fetchFn(configUrl);
+            if (res.ok) {
+                const json = await res.json();
+                // cache & return
+                _cachedConfig = json ?? {};
+                return _cachedConfig;
+            }
+        }
+        catch {
+            /* swallow */
+        }
+    }
+    // 3) Node fallback: try reading from disk (requires your readJsonFile util)
+    try {
+        const disk = await readJsonFile(configUrl);
+        _cachedConfig = disk ?? {};
+        return _cachedConfig;
+    }
+    catch {
+        /* swallow */
+    }
+    // 4) if all else fails, return an empty config
+    _cachedConfig = {};
+    return _cachedConfig;
+}
+async function getConfig(key) {
+    const cfg = await loadConfig();
+    return key != null ? cfg[key] : cfg;
+}
+
+export { getConfig, loadConfig };
+//# sourceMappingURL=config_utils.js.map

package/dist/esm/src/functions/config_utils/src/config_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config_utils.js","sources":["../../../../../../src/functions/config_utils/src/config_utils.ts"],"sourcesContent":["// src/config_utils.ts\nimport type { AppConfig } from \"./../imports.js\";\nimport { safeGlobalProp, readJsonFile } from \"./../imports.js\";\n// src/functions/config_utils/src/config_utils.ts\n\n\n\nlet _cachedConfig: any = null;\n\nexport async function loadConfig(filePath: string | null = null): Promise<AppConfig> {\n  if (_cachedConfig) {\n    return _cachedConfig;\n  }\n\n  // 1) figure out where config.json lives\n  let configUrl: string;\n  if (filePath) {\n    configUrl = filePath;\n  } else if (typeof import.meta !== 'undefined' && typeof import.meta.url === 'string') {\n    // ES module: resolve relative to this file\n\n    try {\n      const mod: any = await (new Function(\n        \"return import('./config.json').catch(() => ({}))\"\n      ))();\n      _cachedConfig = mod.default ?? {};\n      return _cachedConfig;\n    } catch {\n      configUrl = 'config.json';\n    }\n  } else {\n    // browser fallback\n    const baseURI = safeGlobalProp<Document>('document', 'baseURI');\n    try {\n      configUrl =\n        typeof baseURI === 'string'\n          ? new URL('config.json', baseURI).href\n          : 'config.json';\n    } catch {\n      configUrl = 'config.json';\n    }\n  }\n\n  // 2) if we have a fetch, try HTTP(S)\n  const fetchFn = safeGlobalProp<typeof fetch>('fetch');\n  if (typeof fetchFn === 'function') {\n    try {\n      const res = await fetchFn(configUrl);\n      if (res.ok) {\n        const json = await res.json();\n        // cache & return\n        _cachedConfig = (json as AppConfig) ?? {};\n        return _cachedConfig;\n      }\n    } catch {\n      /* swallow */\n    }\n  }\n\n  // 3) Node fallback: try reading from disk (requires your readJsonFile util)\n  try {\n    const disk = await readJsonFile<AppConfig>(configUrl);\n    _cachedConfig = disk ?? {};\n    return _cachedConfig;\n  } catch {\n    /* swallow */\n  }\n\n  // 4) if all else fails, return an empty config\n  _cachedConfig = {} as AppConfig;\n  return _cachedConfig;\n}\n\n/** \n * getConfig(): Promise<AppConfig> \n * getConfig(key): Promise<AppConfig[K]> \n */\nexport function getConfig(): Promise<AppConfig>;\nexport function getConfig<K extends keyof AppConfig>(key: K): Promise<AppConfig[K]>;\nexport async function getConfig<K extends keyof AppConfig>(\n  key?: K\n): Promise<AppConfig | AppConfig[K]> {\n  const cfg = await loadConfig();\n  return key != null ? (cfg[key] as AppConfig[K]) : cfg;\n}\n\n"],"names":[],"mappings":";;;AAGA;AAIA,IAAI,aAAa,GAAQ,IAAI;AAEtB,eAAe,UAAU,CAAC,WAA0B,IAAI,EAAA;IAC7D,IAAI,aAAa,EAAE;AACjB,QAAA,OAAO,aAAa;IACtB;;AAGA,IAAA,IAAI,SAAiB;IACrB,IAAI,QAAQ,EAAE;QACZ,SAAS,GAAG,QAAQ;IACtB;AAAO,SAAA,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,QAAQ,EAAE;;AAGpF,QAAA,IAAI;YACF,MAAM,GAAG,GAAQ,MAAM,CAAC,IAAI,QAAQ,CAClC,kDAAkD,CACnD,GAAG;AACJ,YAAA,aAAa,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE;AACjC,YAAA,OAAO,aAAa;QACtB;AAAE,QAAA,MAAM;YACN,SAAS,GAAG,aAAa;QAC3B;IACF;SAAO;;QAEL,MAAM,OAAO,GAAG,cAAc,CAAW,UAAU,EAAE,SAAS,CAAC;AAC/D,QAAA,IAAI;YACF,SAAS;gBACP,OAAO,OAAO,KAAK;sBACf,IAAI,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;sBAChC,aAAa;QACrB;AAAE,QAAA,MAAM;YACN,SAAS,GAAG,aAAa;QAC3B;IACF;;AAGA,IAAA,MAAM,OAAO,GAAG,cAAc,CAAe,OAAO,CAAC;AACrD,IAAA,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE;AACjC,QAAA,IAAI;AACF,YAAA,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC;AACpC,YAAA,IAAI,GAAG,CAAC,EAAE,EAAE;AACV,gBAAA,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE;;AAE7B,gBAAA,aAAa,GAAI,IAAkB,IAAI,EAAE;AACzC,gBAAA,OAAO,aAAa;YACtB;QACF;AAAE,QAAA,MAAM;;QAER;IACF;;AAGA,IAAA,IAAI;AACF,QAAA,MAAM,IAAI,GAAG,MAAM,YAAY,CAAY,SAAS,CAAC;AACrD,QAAA,aAAa,GAAG,IAAI,IAAI,EAAE;AAC1B,QAAA,OAAO,aAAa;IACtB;AAAE,IAAA,MAAM;;IAER;;IAGA,aAAa,GAAG,EAAe;AAC/B,IAAA,OAAO,aAAa;AACtB;AAQO,eAAe,SAAS,CAC7B,GAAO,EAAA;AAEP,IAAA,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE;AAC9B,IAAA,OAAO,GAAG,IAAI,IAAI,GAAI,GAAG,CAAC,GAAG,CAAkB,GAAG,GAAG;AACvD;;;;"}

package/dist/esm/src/functions/constants_utils/src/constants.js

@@ -0,0 +1,10 @@
+const PROTOCOL = 'https://';
+const DOMAIN_NAME = 'abstractendeavors';
+const BASE_URL = `${PROTOCOL}${DOMAIN_NAME}.com`;
+const SUB_DIR = 'secure-files';
+const PROD_PREFIX = `/${SUB_DIR}/`;
+const API_PREFIX = `/${SUB_DIR}/api`;
+const DEV_PREFIX = `/${SUB_DIR}-dev/`;
+
+export { API_PREFIX, BASE_URL, DEV_PREFIX, DOMAIN_NAME, PROD_PREFIX, PROTOCOL, SUB_DIR };
+//# sourceMappingURL=constants.js.map

package/dist/esm/src/functions/constants_utils/src/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sources":["../../../../../../src/functions/constants_utils/src/constants.ts"],"sourcesContent":["export const PROTOCOL='https://';\nexport const DOMAIN_NAME = 'abstractendeavors';\nexport const BASE_URL = `${PROTOCOL}${DOMAIN_NAME}.com`;\nexport const SUB_DIR = 'secure-files';\nexport const PROD_PREFIX = `/${SUB_DIR}/`;\nexport const API_PREFIX = `/${SUB_DIR}/api`;\nexport const DEV_PREFIX = `/${SUB_DIR}-dev/`;\n\n\n"],"names":[],"mappings":"AAAO,MAAM,QAAQ,GAAC;AACf,MAAM,WAAW,GAAG;MACd,QAAQ,GAAG,GAAG,QAAQ,CAAA,EAAG,WAAW,CAAA,IAAA;AAC1C,MAAM,OAAO,GAAG;AAChB,MAAM,WAAW,GAAG,CAAA,CAAA,EAAI,OAAO;AAC/B,MAAM,UAAU,GAAG,CAAA,CAAA,EAAI,OAAO;AAC9B,MAAM,UAAU,GAAG,CAAA,CAAA,EAAI,OAAO;;;;"}

package/dist/esm/src/functions/env_utils/src/window_utils.js

@@ -0,0 +1,51 @@
+import { BASE_URL, DEV_PREFIX } from '../../constants_utils/src/constants.js';
+
+function get_window() {
+    try {
+        if (typeof window !== 'undefined') {
+            return window;
+        }
+    }
+    catch (err) {
+        alert(err);
+    }
+    return null;
+}
+function get_window_location() {
+    try {
+        const Window = get_window();
+        if (!Window) {
+            return BASE_URL;
+        }
+        return Window.location;
+    }
+    catch (err) {
+        alert(err);
+    }
+    return null;
+}
+function get_window_pathname() {
+    try {
+        const Window = get_window();
+        if (!Window) {
+            return DEV_PREFIX;
+        }
+        return Window.location.pathname;
+    }
+    catch (err) {
+        alert(err);
+    }
+    return null;
+}
+function get_window_parts() {
+    try {
+        return get_window_location();
+    }
+    catch (err) {
+        alert(err);
+    }
+    return null;
+}
+
+export { get_window, get_window_location, get_window_parts, get_window_pathname };
+//# sourceMappingURL=window_utils.js.map

package/dist/esm/src/functions/env_utils/src/window_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window_utils.js","sources":["../../../../../../src/functions/env_utils/src/window_utils.ts"],"sourcesContent":["import {BASE_URL,DEV_PREFIX} from './../imports.js';\nexport function get_window() {\n   try{\n      if (typeof window !== 'undefined'){\n         return window\n      }\n   }catch(err){\n      alert(err)\n   }\n   return null\n}\nexport function get_window_location() {\n   try{\n      const Window = get_window()\n      if (!Window){\n         return BASE_URL\n      }\n      return Window.location \n   }catch(err){\n      alert(err)\n   }\n   return null\n}\nexport function get_window_pathname() {\n   try{\n      const Window = get_window()\n      if (!Window){\n         return DEV_PREFIX\n      }\n      return Window.location.pathname\n   }catch(err){\n      alert(err)\n   }\n   return null\n}\nexport function get_window_parts() {\n   try{\n      return get_window_location()\n   }catch(err){\n      alert(err)\n   }\n   return null\n}\n\n"],"names":[],"mappings":";;SACgB,UAAU,GAAA;AACvB,IAAA,IAAG;AACA,QAAA,IAAI,OAAO,MAAM,KAAK,WAAW,EAAC;AAC/B,YAAA,OAAO,MAAM;QAChB;IACH;IAAC,OAAM,GAAG,EAAC;QACR,KAAK,CAAC,GAAG,CAAC;IACb;AACA,IAAA,OAAO,IAAI;AACd;SACgB,mBAAmB,GAAA;AAChC,IAAA,IAAG;AACA,QAAA,MAAM,MAAM,GAAG,UAAU,EAAE;QAC3B,IAAI,CAAC,MAAM,EAAC;AACT,YAAA,OAAO,QAAQ;QAClB;QACA,OAAO,MAAM,CAAC,QAAQ;IACzB;IAAC,OAAM,GAAG,EAAC;QACR,KAAK,CAAC,GAAG,CAAC;IACb;AACA,IAAA,OAAO,IAAI;AACd;SACgB,mBAAmB,GAAA;AAChC,IAAA,IAAG;AACA,QAAA,MAAM,MAAM,GAAG,UAAU,EAAE;QAC3B,IAAI,CAAC,MAAM,EAAC;AACT,YAAA,OAAO,UAAU;QACpB;AACA,QAAA,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ;IAClC;IAAC,OAAM,GAAG,EAAC;QACR,KAAK,CAAC,GAAG,CAAC;IACb;AACA,IAAA,OAAO,IAAI;AACd;SACgB,gBAAgB,GAAA;AAC7B,IAAA,IAAG;QACA,OAAO,mBAAmB,EAAE;IAC/B;IAAC,OAAM,GAAG,EAAC;QACR,KAAK,CAAC,GAAG,CAAC;IACb;AACA,IAAA,OAAO,IAAI;AACd;;;;"}

package/dist/esm/src/functions/fetch_utils/src/fetch_utils.js

@@ -0,0 +1,60 @@
+import { getResult } from './utils.js';
+
+async function fetchIt(endpoint, body = null, method = null, headers = null, blob = false, configUrl = false, withCredentials = true, returnJson = true, returnReult = true) {
+    method = (method || "GET").toUpperCase();
+    // 2) choose the URL
+    const url = endpoint;
+    // 3) prepare headers & body
+    headers = {
+        ...(body instanceof FormData ? {} : { "Content-Type": "application/json" }),
+        ...headers,
+    };
+    const opts = {
+        method,
+        credentials: withCredentials ? "include" : "same-origin",
+        headers,
+        body: body instanceof FormData
+            ? body
+            : body != null && method !== "GET"
+                ? JSON.stringify(body)
+                : undefined,
+    };
+    console.debug("➡️ secureFetchIt →", url, opts);
+    const res = await fetch(url, opts);
+    if (!res.ok) {
+        const err = await res.text();
+        throw new Error(`HTTP ${res.status}: ${err}`);
+    }
+    if (blob)
+        return res.blob();
+    if (returnReult)
+        return getResult(res.json());
+    if (returnJson)
+        return res.json();
+    return res;
+}
+// Constructs HTML directory path
+function getHtmlDirectory(directory, filename) {
+    return `${directory}/${filename}.html`;
+}
+// Fetches HTML content
+async function fetchIndexHtml(filename, directory = 'sf_index', base = 'html') {
+    const url = `/${base}/${directory}/${filename}.html`;
+    const response = await fetch(url);
+    return await response.text();
+}
+// Fetches and injects HTML content into container
+async function fetchIndexHtmlContainer(filename, doc = document, directory = 'html') {
+    const container = `${filename}-container`;
+    const html = await fetchIndexHtml(filename, directory);
+    const el = doc.getElementById(container);
+    if (el) {
+        el.innerHTML = html;
+    }
+    else {
+        console.warn(`⚠️ No container found for: #${container}`);
+    }
+}
+
+export { fetchIndexHtml, fetchIndexHtmlContainer, fetchIt, getHtmlDirectory };
+//# sourceMappingURL=fetch_utils.js.map

package/dist/esm/src/functions/fetch_utils/src/fetch_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch_utils.js","sources":["../../../../../../src/functions/fetch_utils/src/fetch_utils.ts"],"sourcesContent":["\nimport {getResult} from './utils.js';\n// Constructs API URL from endpoint\n\n\n\nexport function fetchIt<T>(\n  url: any,\n  body?: any,\n  method?: any,\n  headers?: Record<string,string> | null,\n  blob?:  boolean,\n  configUrl?:  boolean,\n  withCredentials?:  boolean,\n  returnJson?:  boolean,\n  returnReult?:  boolean,\n): Promise<T>;\n// 2) When blob = true, we return a Blob\nexport function fetchIt(\n  url: any,\n  body?: any,\n  method?: any,\n  headers?: Record<string,string> | null,\n  blob?:  boolean,\n  configUrl?:  boolean,\n  withCredentials?:  boolean,\n  returnJson?:  boolean,\n  returnReult?:  boolean,\n): Promise<Blob>;\nexport async function fetchIt<T = any>(\n  endpoint: any,\n  body: any = null,\n  method: any = null,\n  headers: any = null,\n  blob: boolean = false,\n  configUrl: boolean = false,\n  withCredentials: boolean = true,\n  returnJson: boolean = true,\n  returnReult: boolean = true\n): Promise<any> {\n  method = (method || \"GET\").toUpperCase();\n\n  // 1) auto-detect absolute URLs\n  const isAbsolute =\n    typeof endpoint === \"string\" && /^https?:\\/\\//i.test(endpoint);\n\n  // 2) choose the URL\n  const url: string= endpoint;\n\n\n  // 3) prepare headers & body\n  headers = {\n    ...(body instanceof FormData ? {} : { \"Content-Type\": \"application/json\" }),\n    ...headers,\n  };\n\n  const opts: RequestInit = {\n    method,\n    credentials: withCredentials ? \"include\" : \"same-origin\",\n    headers,\n    body:\n      body instanceof FormData\n        ? body\n        : body != null && method !== \"GET\"\n        ? JSON.stringify(body)\n        : undefined,\n  };\n\n  console.debug(\"➡️ secureFetchIt →\", url, opts);\n  const res = await fetch(url, opts);\n  if (!res.ok) {\n    const err = await res.text();\n    throw new Error(`HTTP ${res.status}: ${err}`);\n  }\n\n  if (blob) return res.blob();\n  if (returnReult) return getResult(res.json());\n  if (returnJson) return res.json();\n  return res;\n}\n\n// Constructs HTML directory path\nexport function getHtmlDirectory(directory: string, filename: string): string {\n  return `${directory}/${filename}.html`;\n}\n// Fetches HTML content\nexport async function fetchIndexHtml(\n  filename: string,\n  directory: string = 'sf_index',\n  base: string = 'html'\n): Promise<string> {\n  const url: string = `/${base}/${directory}/${filename}.html`;\n  const response: Response = await fetch(url);\n  return await response.text();\n}\n\n// Fetches and injects HTML content into container\nexport async function fetchIndexHtmlContainer(\n  filename: string,\n  doc: Document = document,\n  directory: string = 'html'\n): Promise<void> {\n  const container: string = `${filename}-container`;\n  const html: string = await fetchIndexHtml(filename, directory);\n  const el: HTMLElement | null = doc.getElementById(container);\n  if (el) {\n    el.innerHTML = html;\n  } else {\n    console.warn(`⚠️ No container found for: #${container}`);\n  }\n}\n\n"],"names":[],"mappings":";;AA6BO,eAAe,OAAO,CAC3B,QAAa,EACb,IAAA,GAAY,IAAI,EAChB,MAAA,GAAc,IAAI,EAClB,OAAA,GAAe,IAAI,EACnB,IAAA,GAAgB,KAAK,EACrB,SAAA,GAAqB,KAAK,EAC1B,eAAA,GAA2B,IAAI,EAC/B,UAAA,GAAsB,IAAI,EAC1B,cAAuB,IAAI,EAAA;IAE3B,MAAM,GAAG,CAAC,MAAM,IAAI,KAAK,EAAE,WAAW,EAAE;;IAOxC,MAAM,GAAG,GAAU,QAAQ;;AAI3B,IAAA,OAAO,GAAG;AACR,QAAA,IAAI,IAAI,YAAY,QAAQ,GAAG,EAAE,GAAG,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;AAC3E,QAAA,GAAG,OAAO;KACX;AAED,IAAA,MAAM,IAAI,GAAgB;QACxB,MAAM;QACN,WAAW,EAAE,eAAe,GAAG,SAAS,GAAG,aAAa;QACxD,OAAO;QACP,IAAI,EACF,IAAI,YAAY;AACd,cAAE;AACF,cAAE,IAAI,IAAI,IAAI,IAAI,MAAM,KAAK;AAC7B,kBAAE,IAAI,CAAC,SAAS,CAAC,IAAI;AACrB,kBAAE,SAAS;KAChB;IAED,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,GAAG,EAAE,IAAI,CAAC;IAC9C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC;AAClC,IAAA,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE;AACX,QAAA,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE;QAC5B,MAAM,IAAI,KAAK,CAAC,CAAA,KAAA,EAAQ,GAAG,CAAC,MAAM,CAAA,EAAA,EAAK,GAAG,CAAA,CAAE,CAAC;IAC/C;AAEA,IAAA,IAAI,IAAI;AAAE,QAAA,OAAO,GAAG,CAAC,IAAI,EAAE;AAC3B,IAAA,IAAI,WAAW;AAAE,QAAA,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;AAC7C,IAAA,IAAI,UAAU;AAAE,QAAA,OAAO,GAAG,CAAC,IAAI,EAAE;AACjC,IAAA,OAAO,GAAG;AACZ;AAEA;AACM,SAAU,gBAAgB,CAAC,SAAiB,EAAE,QAAgB,EAAA;AAClE,IAAA,OAAO,CAAA,EAAG,SAAS,CAAA,CAAA,EAAI,QAAQ,OAAO;AACxC;AACA;AACO,eAAe,cAAc,CAClC,QAAgB,EAChB,SAAA,GAAoB,UAAU,EAC9B,IAAA,GAAe,MAAM,EAAA;IAErB,MAAM,GAAG,GAAW,CAAA,CAAA,EAAI,IAAI,IAAI,SAAS,CAAA,CAAA,EAAI,QAAQ,CAAA,KAAA,CAAO;AAC5D,IAAA,MAAM,QAAQ,GAAa,MAAM,KAAK,CAAC,GAAG,CAAC;AAC3C,IAAA,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE;AAC9B;AAEA;AACO,eAAe,uBAAuB,CAC3C,QAAgB,EAChB,GAAA,GAAgB,QAAQ,EACxB,SAAA,GAAoB,MAAM,EAAA;AAE1B,IAAA,MAAM,SAAS,GAAW,CAAA,EAAG,QAAQ,YAAY;IACjD,MAAM,IAAI,GAAW,MAAM,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC9D,MAAM,EAAE,GAAuB,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC;IAC5D,IAAI,EAAE,EAAE;AACN,QAAA,EAAE,CAAC,SAAS,GAAG,IAAI;IACrB;SAAO;AACL,QAAA,OAAO,CAAC,IAAI,CAAC,+BAA+B,SAAS,CAAA,CAAE,CAAC;IAC1D;AACF;;;;"}

package/dist/esm/src/functions/fetch_utils/src/url_utils.js

@@ -0,0 +1,89 @@
+import path from '../../../../node_modules/path-browserify/index.js';
+
+function urlJoin(...parts) {
+    const s = (parts.length === 1 && Array.isArray(parts[0]) ? parts[0] : parts);
+    let r = "";
+    for (let i = 0; i < s.length; i++) {
+        let d = (s[i] ?? "").toString();
+        if (!d)
+            continue;
+        if (i === 0)
+            r = d;
+        else {
+            d = d.replace(/^\/+/, "");
+            r = r.replace(/\/+$/, "");
+            r = `${r}/${d}`;
+        }
+    }
+    return r;
+}
+/**
+ * Returns a full URL.
+ * If partial_url is already absolute (starts with http), it is returned as is.
+ * Otherwise, it is combined with the base URL.
+ */
+function get_full_url(partial_url, domain = null) {
+    if (typeof partial_url !== 'string') {
+        throw new Error('partial_url must be a string');
+    }
+    // If it already starts with http, assume it is absolute.
+    if (partial_url.startsWith('http')) {
+        return partial_url;
+    }
+    return urlJoin(domain, partial_url);
+}
+/**
+ * Returns a full file system path.
+ * If partial_path is already absolute, it is returned as is.
+ * Otherwise, it is joined with the base directory.
+ */
+function get_full_path(partial_path, parent_dir = null) {
+    if (typeof partial_path !== 'string') {
+        throw new Error('partial_path must be a string');
+    }
+    if (path.isAbsolute(partial_path)) {
+        return partial_path;
+    }
+    return urlJoin(parent_dir, partial_path);
+}
+/**
+ * Converts a local file system path into its corresponding URL.
+ * It checks against the known directories in all_paths and replaces the matching base.
+ */
+function path_to_url(filePath, all_paths) {
+    if (typeof filePath !== 'string') {
+        throw new Error('filePath must be a string');
+    }
+    for (const key in all_paths) {
+        const mapping = all_paths[key];
+        const normalizedBase = path.normalize(mapping.path);
+        if (filePath.startsWith(normalizedBase)) {
+            const relativePath = filePath.substring(normalizedBase.length);
+            return urlJoin(mapping.url, relativePath.replace(/\\/g, '/'));
+        }
+    }
+    return null;
+}
+/**
+ * Converts a URL into its corresponding local file system path.
+ * It checks against the known URL prefixes in all_paths and replaces the matching base.
+ */
+function url_to_path(urlStr, all_paths) {
+    if (typeof urlStr !== 'string') {
+        throw new Error('urlStr must be a string');
+    }
+    for (const key in all_paths) {
+        const mapping = all_paths[key];
+        if (urlStr.startsWith(mapping.url)) {
+            const relativeUrl = urlStr.substring(mapping.url.length);
+            return urlJoin(mapping.path, relativeUrl);
+        }
+    }
+    return null;
+}
+function urljoin(...parts) {
+    return urlJoin(...parts);
+}
+
+export { get_full_path, get_full_url, path_to_url, urlJoin, url_to_path, urljoin };
+//# sourceMappingURL=url_utils.js.map

package/dist/esm/src/functions/fetch_utils/src/url_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url_utils.js","sources":["../../../../../../src/functions/fetch_utils/src/url_utils.ts"],"sourcesContent":["import path from 'path-browserify';\nexport function urlJoin(...parts: (string | undefined | null)[]) {\n    const s = (parts.length === 1 && Array.isArray(parts[0]) ? parts[0] as any[] : parts) as string[];\n    let r = \"\";\n    for (let i = 0; i < s.length; i++) {\n        let d = (s[i] ?? \"\").toString();\n        if (!d) continue;\n        if (i === 0) r = d;\n        else {\n            d = d.replace(/^\\/+/, \"\");\n            r = r.replace(/\\/+$/, \"\");\n            r = `${r}/${d}`;\n        }\n    }\n    return r;\n}\n\n/**\n * Returns a full URL.\n * If partial_url is already absolute (starts with http), it is returned as is.\n * Otherwise, it is combined with the base URL.\n */\nexport function get_full_url(partial_url: any, domain: any = null) {\n    if (typeof partial_url !== 'string') {\n        throw new Error('partial_url must be a string');\n    }\n    // If it already starts with http, assume it is absolute.\n    if (partial_url.startsWith('http')) {\n        return partial_url;\n    }\n    return urlJoin(domain, partial_url);\n}\n\n/**\n * Returns a full file system path.\n * If partial_path is already absolute, it is returned as is.\n * Otherwise, it is joined with the base directory.\n */\nexport function get_full_path(partial_path: any, parent_dir: any = null) {\n    if (typeof partial_path !== 'string') {\n        throw new Error('partial_path must be a string');\n    }\n    if (path.isAbsolute(partial_path)) {\n        return partial_path;\n    }\n    return urlJoin(parent_dir, partial_path);\n}\n/**\n * Converts a local file system path into its corresponding URL.\n * It checks against the known directories in all_paths and replaces the matching base.\n */\nexport function path_to_url(filePath: string, all_paths: any): string | null {\n    if (typeof filePath !== 'string') {\n        throw new Error('filePath must be a string');\n    }\n    for (const key in all_paths) {\n        const mapping = all_paths[key as keyof typeof all_paths];\n        const normalizedBase = path.normalize(mapping.path);\n        if (filePath.startsWith(normalizedBase)) {\n            const relativePath = filePath.substring(normalizedBase.length);\n            return urlJoin(mapping.url, relativePath.replace(/\\\\/g, '/'));\n        }\n    }\n    return null;\n}\n/**\n * Converts a URL into its corresponding local file system path.\n * It checks against the known URL prefixes in all_paths and replaces the matching base.\n */\n\nexport function url_to_path(urlStr: string, all_paths: any): string | null {\n    if (typeof urlStr !== 'string') {\n        throw new Error('urlStr must be a string');\n    }\n    for (const key in all_paths) {\n        const mapping = all_paths[key as keyof typeof all_paths];\n        if (urlStr.startsWith(mapping.url)) {\n            const relativeUrl = urlStr.substring(mapping.url.length);\n            return urlJoin(mapping.path, relativeUrl);\n        }\n    }\n    return null;\n}\n\n\nexport function urljoin(\n\t...parts: (string | undefined | null)[]\n\t) {\n\t\treturn urlJoin(...parts);\n\t}\n"],"names":[],"mappings":"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"}