@putkoff/abstract-utilities 0.1.113 → 0.1.115

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,17 @@
+/**
+ * Reads a file at `relativeOrAbsolutePath` and returns its contents as a string.
+ */
+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>;
+/**
+ * Read a file and optionally parse it as JSON (and even pluck a field).
+ *
+ * @param filePath   Path to your file (relative to cwd or absolute)
+ * @param asJson     If true, JSON.parse the file.
+ *                   If a string, JSON.parse then return parsed[string].
+ * @returns          The raw string, whole parsed object, or a specific field.
+ */
+export declare function reader(filePath: string, asJson?: boolean | string): Promise<any>;

package/dist/cjs/index.js

@@ -2,6 +2,8 @@
 
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
+var fs = require('fs');
+var path = require('path');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 /**
@@ -1023,14 +1025,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 +1282,86 @@ 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;
+    });
+}
+
+/**
+ * Reads a file at `relativeOrAbsolutePath` and returns its contents as a string.
+ */
+function readFileContents(relativeOrAbsolutePath) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // Resolve to an absolute path (so you’re always sure where it’s looking)
+        const filePath = path.isAbsolute(relativeOrAbsolutePath)
+            ? relativeOrAbsolutePath
+            : path.resolve(__dirname, relativeOrAbsolutePath);
+        // Read and return as UTF-8 text
+        return fs.promises.readFile(filePath, 'utf8');
+    });
+}
+/**
+ * Reads a JSON file and returns the parsed object.
+ */
+function readJsonFile(relativeOrAbsolutePath) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const filePath = path.isAbsolute(relativeOrAbsolutePath)
+            ? relativeOrAbsolutePath
+            : path.resolve(__dirname, relativeOrAbsolutePath);
+        const text = yield fs.promises.readFile(filePath, 'utf8');
+        return JSON.parse(text);
+    });
+}
+/**
+ * Read a file and optionally parse it as JSON (and even pluck a field).
+ *
+ * @param filePath   Path to your file (relative to cwd or absolute)
+ * @param asJson     If true, JSON.parse the file.
+ *                   If a string, JSON.parse then return parsed[string].
+ * @returns          The raw string, whole parsed object, or a specific field.
+ */
+function reader(filePath_1) {
+    return __awaiter(this, arguments, void 0, function* (filePath, asJson = false) {
+        // resolve to absolute so you know exactly where you’re reading from
+        const abs = path.isAbsolute(filePath)
+            ? filePath
+            : path.resolve(process.cwd(), filePath);
+        // 1) read file as text
+        const text = yield fs.promises.readFile(abs, 'utf8');
+        // 2) if they want JSON, parse it
+        if (asJson) {
+            const obj = JSON.parse(text);
+            // 3) if they passed a string, return that property
+            if (typeof asJson === 'string') {
+                return obj[asJson];
+            }
+            return obj;
+        }
+        // 4) otherwise, just return the raw text
+        return text;
+    });
+}
+
 Object.defineProperty(exports, "useCallback", {
     enumerable: true,
     get: function () { return react.useCallback; }
@@ -1333,6 +1415,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 +1445,9 @@ 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.reader = reader;
 exports.requestPatch = requestPatch;
 exports.requireToken = requireToken;
 exports.sanitizeFilename = sanitizeFilename;