@putkoff/abstract-utilities 0.1.114 → 0.1.116

package/dist/cjs/functions/config_utils/imports.d.ts

@@ -0,0 +1 @@
+export type { AppConfig } from './../../types';

package/dist/cjs/functions/config_utils/index.d.ts

@@ -0,0 +1 @@
+export * from './src';

package/dist/cjs/functions/config_utils/src/config_utils.d.ts

@@ -0,0 +1,7 @@
+import type { AppConfig } from './../imports';
+/**
+ * getConfig(): load the full AppConfig
+ * getConfig(key): load just that key
+ */
+export declare function getConfig(): Promise<AppConfig>;
+export declare function getConfig<K extends keyof AppConfig>(key: K): Promise<AppConfig[K]>;

package/dist/cjs/functions/config_utils/src/index.d.ts

@@ -0,0 +1 @@
+export * from './config_utils';

package/dist/cjs/functions/index.d.ts

@@ -8,3 +8,5 @@ export * from './rndm_utils';
 export * from './string_utils';
 export * from './type_utils';
 export * from './ui_utils';
+export * from './config_utils';
+export * from './read_utils';

package/dist/cjs/functions/read_utils/imports.d.ts

@@ -0,0 +1,3 @@
+export { promises as fs } from 'fs';
+import path from 'path';
+export { path };

package/dist/cjs/functions/read_utils/index.d.ts

@@ -0,0 +1 @@
+export * from './src';

package/dist/cjs/functions/read_utils/src/index.d.ts

@@ -0,0 +1 @@
+export * from './read_utils';

package/dist/cjs/functions/read_utils/src/read_utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Reads a file at `relativeOrAbsolutePath` and returns its contents as a string.
+ * In a browser this will reject immediately.
+ */
+export declare function readFileContents(relativeOrAbsolutePath: string): Promise<string>;
+/**
+ * Reads a JSON file and returns the parsed object.
+ */
+export declare function readJsonFile<T = any>(relativeOrAbsolutePath: string): Promise<T>;

package/dist/cjs/index.js

@@ -1023,14 +1023,14 @@ function getAppConfig(endpoint) {
     return base ? `${base}/${clean}` : `/api/${clean}`;
 }
 /** Accessor for the loaded config. Throws if you forgot to loadConfig(). */
-function getConfig() {
+function getConfig$1() {
     {
         throw new Error('Config not loaded! Call loadConfig() first.');
     }
 }
 /** Convenience to grab the base URL once loaded. */
 function apiBase() {
-    return getConfig().API_BASE_URL.replace(/\/+$/, '');
+    return getConfig$1().API_BASE_URL.replace(/\/+$/, '');
 }
 
 function ensureAbstractUrl(endpoint, slices = []) {
@@ -1280,6 +1280,78 @@ function Spinner() {
     return (jsxRuntime.jsx("p", { className: 'animate-pulse', children: "Loading\u2026" }));
 }
 
+let _cachedConfig = null;
+function loadConfig() {
+    return __awaiter(this, arguments, void 0, function* (filePath = null) {
+        // 1. If nobody passed a custom path, we default to "config.json" (relative)
+        const relativePath = filePath || 'config.json';
+        // 2. Resolve it against the running page’s URL (document.baseURI)
+        const configUrl = new URL(relativePath, document.baseURI).href;
+        // 3. Fetch + cache
+        if (_cachedConfig)
+            return _cachedConfig;
+        const res = yield fetch(configUrl);
+        if (!res.ok) {
+            throw new Error(`Could not fetch ${configUrl}: ${res.status}`);
+        }
+        _cachedConfig = (yield res.json());
+        return _cachedConfig;
+    });
+}
+function getConfig(key) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const cfg = yield loadConfig();
+        return key ? cfg[key] : cfg;
+    });
+}
+
+// src/read_utils.ts
+/**
+ * Attempt to load the Node-only modules.
+ * Returns { fs: null, path: null } in the browser.
+ */
+function tryNodeModules() {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const fsMod = yield import('fs');
+            const pathMod = yield import('path');
+            return {
+                fs: fsMod.promises, // keep the `promises` API
+                path: pathMod
+            };
+        }
+        catch (_a) {
+            return { fs: null, path: null };
+        }
+    });
+}
+/**
+ * Reads a file at `relativeOrAbsolutePath` and returns its contents as a string.
+ * In a browser this will reject immediately.
+ */
+function readFileContents(relativeOrAbsolutePath) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { fs, path } = yield tryNodeModules();
+        if (!fs || !path) {
+            throw new Error('readFileContents can only be used in Node.js');
+        }
+        // resolve absolute
+        const filePath = path.isAbsolute(relativeOrAbsolutePath)
+            ? relativeOrAbsolutePath
+            : path.resolve(__dirname, relativeOrAbsolutePath);
+        return fs.readFile(filePath, 'utf8');
+    });
+}
+/**
+ * Reads a JSON file and returns the parsed object.
+ */
+function readJsonFile(relativeOrAbsolutePath) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const text = yield readFileContents(relativeOrAbsolutePath);
+        return JSON.parse(text);
+    });
+}
+
 Object.defineProperty(exports, "useCallback", {
     enumerable: true,
     get: function () { return react.useCallback; }
@@ -1333,6 +1405,7 @@ exports.getAbsPath = getAbsPath;
 exports.getAuthorizationHeader = getAuthorizationHeader;
 exports.getBaseDir = getBaseDir;
 exports.getComponentsUtilsDirectory = getComponentsUtilsDirectory;
+exports.getConfig = getConfig;
 exports.getDbConfigsPath = getDbConfigsPath;
 exports.getDistDir = getDistDir;
 exports.getEnvDir = getEnvDir;
@@ -1362,6 +1435,8 @@ exports.isTokenExpired = isTokenExpired;
 exports.make_path = make_path;
 exports.make_sanitized_path = make_sanitized_path;
 exports.normalizeUrl = normalizeUrl;
+exports.readFileContents = readFileContents;
+exports.readJsonFile = readJsonFile;
 exports.requestPatch = requestPatch;
 exports.requireToken = requireToken;
 exports.sanitizeFilename = sanitizeFilename;