@adriangalilea/utils 0.0.10

package/dist/platform/dir.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Directory operations that exit on error (offensive programming style)
+ */
+declare class DirOps {
+    /**
+     * Create a directory (including parents) and exit on error
+     */
+    create(path: string): void;
+    /**
+     * Check if directory exists
+     */
+    exists(path: string): boolean;
+    /**
+     * Remove a directory and all its contents, exit on error
+     */
+    remove(path: string): void;
+    /**
+     * List all entries in a directory, exit on error
+     */
+    list(path: string): string[];
+    /**
+     * List full paths of all entries in a directory
+     */
+    listFull(dirPath: string): string[];
+    /**
+     * List only subdirectories
+     */
+    listDirs(path: string): string[];
+    /**
+     * List only files (not directories)
+     */
+    listFiles(path: string): string[];
+    /**
+     * Check if directory is empty
+     */
+    isEmpty(path: string): boolean;
+}
+export declare const dir: DirOps;
+export {};
+//# sourceMappingURL=dir.d.ts.map

package/dist/platform/dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dir.d.ts","sourceRoot":"","sources":["../../src/platform/dir.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,cAAM,MAAM;IACV;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ1B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAU7B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ1B;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAS5B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAKnC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAYhC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAYjC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAS/B;AAED,eAAO,MAAM,GAAG,QAAe,CAAA"}

package/dist/platform/dir.js

@@ -0,0 +1,108 @@
+import { mkdirSync, existsSync, statSync, rmSync, readdirSync } from 'fs';
+import { check } from '../offensive.js';
+import { path } from './path.js';
+/**
+ * Directory operations that exit on error (offensive programming style)
+ */
+class DirOps {
+    /**
+     * Create a directory (including parents) and exit on error
+     */
+    create(path) {
+        try {
+            mkdirSync(path, { recursive: true, mode: 0o755 });
+        }
+        catch (err) {
+            check(err);
+        }
+    }
+    /**
+     * Check if directory exists
+     */
+    exists(path) {
+        try {
+            if (!existsSync(path))
+                return false;
+            const stats = statSync(path);
+            return stats.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Remove a directory and all its contents, exit on error
+     */
+    remove(path) {
+        try {
+            rmSync(path, { recursive: true, force: true });
+        }
+        catch (err) {
+            check(err);
+        }
+    }
+    /**
+     * List all entries in a directory, exit on error
+     */
+    list(path) {
+        try {
+            return readdirSync(path);
+        }
+        catch (err) {
+            check(err);
+            throw err;
+        }
+    }
+    /**
+     * List full paths of all entries in a directory
+     */
+    listFull(dirPath) {
+        const names = this.list(dirPath);
+        return names.map(name => path.join(dirPath, name));
+    }
+    /**
+     * List only subdirectories
+     */
+    listDirs(path) {
+        try {
+            const entries = readdirSync(path, { withFileTypes: true });
+            return entries
+                .filter(entry => entry.isDirectory())
+                .map(entry => entry.name);
+        }
+        catch (err) {
+            check(err);
+            throw err;
+        }
+    }
+    /**
+     * List only files (not directories)
+     */
+    listFiles(path) {
+        try {
+            const entries = readdirSync(path, { withFileTypes: true });
+            return entries
+                .filter(entry => entry.isFile())
+                .map(entry => entry.name);
+        }
+        catch (err) {
+            check(err);
+            throw err;
+        }
+    }
+    /**
+     * Check if directory is empty
+     */
+    isEmpty(path) {
+        try {
+            const entries = readdirSync(path);
+            return entries.length === 0;
+        }
+        catch (err) {
+            check(err);
+            throw err;
+        }
+    }
+}
+export const dir = new DirOps();
+//# sourceMappingURL=dir.js.map

package/dist/platform/dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dir.js","sourceRoot":"","sources":["../../src/platform/dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,IAAI,CAAA;AACzE,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC;;GAEG;AACH,MAAM,MAAM;IACV;;OAEG;IACH,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC;YACH,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QACnD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,GAAG,CAAC,CAAA;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,OAAO,KAAK,CAAA;YACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;YAC5B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAA;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,GAAG,CAAC,CAAA;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAY;QACf,IAAI,CAAC;YACH,OAAO,WAAW,CAAC,IAAI,CAAC,CAAA;QAC1B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,GAAG,CAAC,CAAA;YACV,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,OAAe;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAChC,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA;IACpD,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAY;QACnB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;YAC1D,OAAO,OAAO;iBACX,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;iBACpC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,GAAG,CAAC,CAAA;YACV,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,IAAY;QACpB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;YAC1D,OAAO,OAAO;iBACX,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;iBAC/B,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,GAAG,CAAC,CAAA;YACV,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAY;QAClB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;YACjC,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAA;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,GAAG,CAAC,CAAA;YACV,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,MAAM,EAAE,CAAA"}

package/dist/platform/file.d.ts

@@ -0,0 +1,53 @@
+/**
+ * File operations that exit on error (offensive programming style)
+ */
+declare class FileOps {
+    /**
+     * Get the caller's file URL from the stack trace
+     * This allows us to resolve relative paths from the calling module
+     */
+    getCallerUrl(): string | undefined;
+    /**
+     * Read a file and exit on error
+     * Relative paths (./file.txt) are resolved from the calling module
+     * Absolute paths are used as-is
+     */
+    read(filePath: string): Buffer;
+    /**
+     * Read a file as string and exit on error
+     * Relative paths (./file.txt) are resolved from the calling module
+     * Absolute paths are used as-is
+     *
+     * @param filePath - Path to the file
+     * @param encodingOrUrl - Optional: encoding (e.g. 'utf-8') or import.meta.url for explicit resolution
+     * @param encoding - Optional: encoding when second param is import.meta.url
+     */
+    readText(filePath: string, encodingOrUrl?: BufferEncoding | string, encoding?: BufferEncoding): string;
+    /**
+     * Write data to a file and exit on error
+     * Relative paths (./file.txt) are resolved from the calling module
+     * Absolute paths are used as-is
+     */
+    write(filePath: string, data: string | Buffer): void;
+    /**
+     * Check if file exists (not a directory)
+     * Relative paths (./file.txt) are resolved from the calling module
+     * Absolute paths are used as-is
+     */
+    exists(filePath: string): boolean;
+    /**
+     * Remove a file and exit on error
+     */
+    remove(path: string): void;
+    /**
+     * Get file size in bytes
+     */
+    size(path: string): number;
+    /**
+     * Get file modification time
+     */
+    mtime(path: string): Date;
+}
+export declare const file: FileOps;
+export {};
+//# sourceMappingURL=file.d.ts.map

package/dist/platform/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/platform/file.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,cAAM,OAAO;IACX;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS;IA2DlC;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAkB9B;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,cAAc,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,MAAM;IAkCtG;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAiBpD;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAmBjC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ1B;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAU1B;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAS1B;AAED,eAAO,MAAM,IAAI,SAAgB,CAAA"}

package/dist/platform/file.js

@@ -0,0 +1,211 @@
+import { readFileSync, writeFileSync, existsSync, unlinkSync, statSync } from 'fs';
+import { check } from '../offensive.js';
+import { path } from './path.js';
+/**
+ * File operations that exit on error (offensive programming style)
+ */
+class FileOps {
+    /**
+     * Get the caller's file URL from the stack trace
+     * This allows us to resolve relative paths from the calling module
+     */
+    getCallerUrl() {
+        const err = new Error();
+        const stack = err.stack;
+        if (!stack)
+            return undefined;
+        // Parse stack to find file URLs
+        // Stack looks like:
+        // Error
+        //   at FileOps.getCallerUrl (file:///path/to/file.ts:line:col)
+        //   at FileOps.readText (file:///path/to/file.ts:line:col)  
+        //   at caller (file:///path/to/caller.ts:line:col) <- we want this
+        const lines = stack.split('\n');
+        // Try multiple regex patterns for different environments
+        const patterns = [
+            /\(file:\/\/([^:)]+)(?::\d+:\d+)?\)/, // Node ESM: (file:///path/file.js:1:2)
+            /at file:\/\/([^:)]+)(?::\d+:\d+)?/, // Node ESM alternate: at file:///path/file.js:1:2
+            /\(([^:)]+\.m?js)(?::\d+:\d+)?\)/, // Node CJS: (/path/file.js:1:2)
+            /at ([^:)]+\.m?js)(?::\d+:\d+)?/, // Node CJS alternate: at /path/file.js:1:2
+        ];
+        // Start at line 3 to skip: Error, getCallerUrl, and the calling method (read/readText/etc)
+        for (let i = 3; i < lines.length && i < 10; i++) { // Limit search depth
+            const line = lines[i];
+            // Skip internal file.ts/file.js lines
+            if (line.includes('/file.js') || line.includes('/file.ts') ||
+                line.includes('\\file.js') || line.includes('\\file.ts')) {
+                continue;
+            }
+            for (const pattern of patterns) {
+                const match = line.match(pattern);
+                if (match) {
+                    // Found a match - build file URL
+                    let filePath = match[1] || match[0];
+                    // Handle Windows paths
+                    if (process.platform === 'win32' && !filePath.startsWith('file://')) {
+                        filePath = filePath.replace(/\\/g, '/');
+                    }
+                    // Ensure we have a file:// URL
+                    if (!filePath.startsWith('file://')) {
+                        filePath = 'file://' + (filePath.startsWith('/') ? '' : '/') + filePath;
+                    }
+                    // Remove line and column numbers if present
+                    filePath = filePath.replace(/:\d+:\d+$/, '');
+                    return filePath;
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Read a file and exit on error
+     * Relative paths (./file.txt) are resolved from the calling module
+     * Absolute paths are used as-is
+     */
+    read(filePath) {
+        try {
+            // Auto-detect caller for relative paths
+            let resolvedPath = filePath;
+            if (filePath.startsWith('./') || filePath.startsWith('../')) {
+                const callerUrl = this.getCallerUrl();
+                resolvedPath = path.resolve(filePath, callerUrl);
+            }
+            else if (!path.isAbsolute(filePath)) {
+                resolvedPath = path.resolve(filePath);
+            }
+            return readFileSync(resolvedPath);
+        }
+        catch (err) {
+            check(err);
+            throw err; // TypeScript needs this even though check exits
+        }
+    }
+    /**
+     * Read a file as string and exit on error
+     * Relative paths (./file.txt) are resolved from the calling module
+     * Absolute paths are used as-is
+     *
+     * @param filePath - Path to the file
+     * @param encodingOrUrl - Optional: encoding (e.g. 'utf-8') or import.meta.url for explicit resolution
+     * @param encoding - Optional: encoding when second param is import.meta.url
+     */
+    readText(filePath, encodingOrUrl, encoding) {
+        try {
+            // Determine if second param is encoding or URL
+            let callerUrl;
+            let actualEncoding = 'utf-8';
+            if (encodingOrUrl) {
+                if (encodingOrUrl.startsWith('file://') || encodingOrUrl.includes('/')) {
+                    // It's a URL/path
+                    callerUrl = encodingOrUrl;
+                    actualEncoding = encoding || 'utf-8';
+                }
+                else {
+                    // It's an encoding
+                    actualEncoding = encodingOrUrl;
+                }
+            }
+            // Auto-detect caller for relative paths
+            let resolvedPath = filePath;
+            if (filePath.startsWith('./') || filePath.startsWith('../')) {
+                // Use explicit URL if provided, otherwise detect from stack
+                const url = callerUrl || this.getCallerUrl();
+                resolvedPath = path.resolve(filePath, url);
+            }
+            else if (!path.isAbsolute(filePath)) {
+                resolvedPath = path.resolve(filePath);
+            }
+            return readFileSync(resolvedPath, actualEncoding);
+        }
+        catch (err) {
+            check(err);
+            throw err;
+        }
+    }
+    /**
+     * Write data to a file and exit on error
+     * Relative paths (./file.txt) are resolved from the calling module
+     * Absolute paths are used as-is
+     */
+    write(filePath, data) {
+        try {
+            // Auto-detect caller for relative paths
+            let resolvedPath = filePath;
+            if (filePath.startsWith('./') || filePath.startsWith('../')) {
+                const callerUrl = this.getCallerUrl();
+                resolvedPath = path.resolve(filePath, callerUrl);
+            }
+            else if (!path.isAbsolute(filePath)) {
+                resolvedPath = path.resolve(filePath);
+            }
+            writeFileSync(resolvedPath, data, { mode: 0o644 });
+        }
+        catch (err) {
+            check(err);
+        }
+    }
+    /**
+     * Check if file exists (not a directory)
+     * Relative paths (./file.txt) are resolved from the calling module
+     * Absolute paths are used as-is
+     */
+    exists(filePath) {
+        try {
+            // Auto-detect caller for relative paths
+            let resolvedPath = filePath;
+            if (filePath.startsWith('./') || filePath.startsWith('../')) {
+                const callerUrl = this.getCallerUrl();
+                resolvedPath = path.resolve(filePath, callerUrl);
+            }
+            else if (!path.isAbsolute(filePath)) {
+                resolvedPath = path.resolve(filePath);
+            }
+            if (!existsSync(resolvedPath))
+                return false;
+            const stats = statSync(resolvedPath);
+            return stats.isFile();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Remove a file and exit on error
+     */
+    remove(path) {
+        try {
+            unlinkSync(path);
+        }
+        catch (err) {
+            check(err);
+        }
+    }
+    /**
+     * Get file size in bytes
+     */
+    size(path) {
+        try {
+            const stats = statSync(path);
+            return stats.size;
+        }
+        catch (err) {
+            check(err);
+            throw err;
+        }
+    }
+    /**
+     * Get file modification time
+     */
+    mtime(path) {
+        try {
+            const stats = statSync(path);
+            return stats.mtime;
+        }
+        catch (err) {
+            check(err);
+            throw err;
+        }
+    }
+}
+export const file = new FileOps();
+//# sourceMappingURL=file.js.map

package/dist/platform/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/platform/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAA;AAClF,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC;;GAEG;AACH,MAAM,OAAO;IACX;;;OAGG;IACH,YAAY;QACV,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAA;QACvB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAA;QACvB,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAA;QAE5B,gCAAgC;QAChC,oBAAoB;QACpB,QAAQ;QACR,+DAA+D;QAC/D,6DAA6D;QAC7D,mEAAmE;QAEnE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAE/B,yDAAyD;QACzD,MAAM,QAAQ,GAAG;YACf,oCAAoC,EAAE,uCAAuC;YAC7E,mCAAmC,EAAI,kDAAkD;YACzF,iCAAiC,EAAM,gCAAgC;YACvE,gCAAgC,EAAO,2CAA2C;SACnF,CAAA;QAED,2FAA2F;QAC3F,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,qBAAqB;YACtE,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YAErB,sCAAsC;YACtC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;gBACtD,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC7D,SAAQ;YACV,CAAC;YAED,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;gBACjC,IAAI,KAAK,EAAE,CAAC;oBACV,iCAAiC;oBACjC,IAAI,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAA;oBAEnC,uBAAuB;oBACvB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;wBACpE,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;oBACzC,CAAC;oBAED,+BAA+B;oBAC/B,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;wBACpC,QAAQ,GAAG,SAAS,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAA;oBACzE,CAAC;oBAED,4CAA4C;oBAC5C,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;oBAE5C,OAAO,QAAQ,CAAA;gBACjB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAA;IAClB,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,QAAgB;QACnB,IAAI,CAAC;YACH,wCAAwC;YACxC,IAAI,YAAY,GAAG,QAAQ,CAAA;YAC3B,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAA;gBACrC,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;YAClD,CAAC;iBAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtC,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;YACvC,CAAC;YAED,OAAO,YAAY,CAAC,YAAY,CAAC,CAAA;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,GAAG,CAAC,CAAA;YACV,MAAM,GAAG,CAAA,CAAC,gDAAgD;QAC5D,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAgB,EAAE,aAAuC,EAAE,QAAyB;QAC3F,IAAI,CAAC;YACH,+CAA+C;YAC/C,IAAI,SAA6B,CAAA;YACjC,IAAI,cAAc,GAAmB,OAAO,CAAA;YAE5C,IAAI,aAAa,EAAE,CAAC;gBAClB,IAAI,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACvE,kBAAkB;oBAClB,SAAS,GAAG,aAAa,CAAA;oBACzB,cAAc,GAAG,QAAQ,IAAI,OAAO,CAAA;gBACtC,CAAC;qBAAM,CAAC;oBACN,mBAAmB;oBACnB,cAAc,GAAG,aAA+B,CAAA;gBAClD,CAAC;YACH,CAAC;YAED,wCAAwC;YACxC,IAAI,YAAY,GAAG,QAAQ,CAAA;YAC3B,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5D,4DAA4D;gBAC5D,MAAM,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,YAAY,EAAE,CAAA;gBAC5C,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;YAC5C,CAAC;iBAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtC,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;YACvC,CAAC;YAED,OAAO,YAAY,CAAC,YAAY,EAAE,cAAc,CAAC,CAAA;QACnD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,GAAG,CAAC,CAAA;YACV,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAgB,EAAE,IAAqB;QAC3C,IAAI,CAAC;YACH,wCAAwC;YACxC,IAAI,YAAY,GAAG,QAAQ,CAAA;YAC3B,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAA;gBACrC,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;YAClD,CAAC;iBAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtC,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;YACvC,CAAC;YAED,aAAa,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QACpD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,GAAG,CAAC,CAAA;QACZ,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,QAAgB;QACrB,IAAI,CAAC;YACH,wCAAwC;YACxC,IAAI,YAAY,GAAG,QAAQ,CAAA;YAC3B,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAA;gBACrC,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;YAClD,CAAC;iBAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtC,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;YACvC,CAAC;YAED,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;gBAAE,OAAO,KAAK,CAAA;YAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAA;YACpC,OAAO,KAAK,CAAC,MAAM,EAAE,CAAA;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC;YACH,UAAU,CAAC,IAAI,CAAC,CAAA;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,GAAG,CAAC,CAAA;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAY;QACf,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;YAC5B,OAAO,KAAK,CAAC,IAAI,CAAA;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,GAAG,CAAC,CAAA;YACV,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;YAC5B,OAAO,KAAK,CAAC,KAAK,CAAA;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,GAAG,CAAC,CAAA;YACV,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,OAAO,EAAE,CAAA"}

package/dist/platform/kev.d.ts

@@ -0,0 +1,149 @@
+/**
+ * KEV - A Redis-style KV store for environment variables
+ *
+ * DEFAULT USAGE (no namespaces needed!):
+ *   apiKey = KEV.mustGet("API_KEY")      // Panics if not found (required config)
+ *   apiKey = KEV.get("API_KEY")          // Returns "" if not found
+ *   apiKey = KEV.get("API_KEY", "dev")   // Returns "dev" if not found
+ *   port = KEV.int("PORT", 8080)         // With type conversion
+ *   KEV.set("DEBUG", "true")             // Sets in memory (fast)
+ *
+ *   KEV.get("DATABASE_URL")              // memory → process.env → .env → cache result
+ *   KEV.get("DATABASE_URL")              // memory (cached!) ✓
+ *
+ * CUSTOMIZE THE SEARCH ORDER:
+ *   KEV.source.remove("os")              // Ignore OS env (perfect for tests!)
+ *   KEV.source.add(".env.local")         // Add more fallbacks
+ *   KEV.source.set(".env.test")          // Or replace entirely
+ *
+ * REDIS-STYLE NAMESPACING (when you need control):
+ *   KEV.get("os:PATH")                   // ONLY from OS, no fallback
+ *   KEV.get(".env:API_KEY")              // ONLY from .env file
+ *   KEV.set("os:DEBUG", "true")          // Write directly to OS
+ *   KEV.set(".env:API_KEY", "secret")    // Update .env file
+ *
+ *   // Pattern matching
+ *   KEV.keys("API_*")                    // Find all API_ keys
+ *   KEV.all("os:*")                      // Get all OS vars
+ *   KEV.clear("TEMP_*")                  // Clean up temp vars
+ *
+ * SOURCE TRACKING & OBSERVABILITY:
+ *   const [value, source] = KEV.getWithSource("API_KEY")  // Returns value + where it came from
+ *   source = KEV.sourceOf("API_KEY")                      // "/path/to/project/.env"
+ *   KEV.debug = true                                       // Shows lookup chain
+ *   KEV.export("backup.env")                              // Includes # from: comments
+ */
+interface MemEntry {
+    value: string;
+    source: string;
+}
+declare class SourceOps {
+    private kev;
+    constructor(kev: KevOps);
+    /**
+     * Replace all sources
+     */
+    set(...sources: string[]): void;
+    /**
+     * Add sources to the search list
+     */
+    add(...sources: string[]): void;
+    /**
+     * Remove specific sources
+     */
+    remove(...sources: string[]): void;
+    /**
+     * List current sources
+     */
+    list(): string[];
+    /**
+     * Clear all sources
+     */
+    clear(): void;
+}
+export declare class KevOps {
+    memory: Map<string, MemEntry>;
+    sources: string[];
+    source: SourceOps;
+    debug: boolean;
+    constructor();
+    initializeSmartDefaults(): void;
+    parseKey(key: string): [string, string];
+    /**
+     * Get environment variable with optional default.
+     */
+    get(key: string, defaultValue?: string): string;
+    /**
+     * Get environment variable or panic if not found
+     */
+    mustGet(key: string): string;
+    /**
+     * Get where a cached key came from
+     */
+    sourceOf(key: string): string;
+    /**
+     * Get both value and its source
+     */
+    getWithSource(key: string, defaultValue?: string): [string, string];
+    getFromNamespace(namespace: string, key: string): string;
+    getFromFile(filePath: string, key: string): string;
+    /**
+     * Set environment variable
+     */
+    set(key: string, value: string): void;
+    setToNamespace(namespace: string, key: string, value: string): void;
+    setToFile(path: string, key: string, value: string): void;
+    /**
+     * Check if key exists
+     */
+    has(key: string): boolean;
+    hasInNamespace(namespace: string, key: string): boolean;
+    /**
+     * Get all keys matching pattern
+     */
+    keys(pattern?: string): string[];
+    keysFromNamespace(namespace: string, pattern: string): string[];
+    getNamespaceData(namespace: string, pattern: string, keysOnly: boolean): Record<string, string>;
+    parseEnvFile(path: string, pattern: string, result: Record<string, string>, keysOnly: boolean): void;
+    matchPattern(key: string, pattern: string): boolean;
+    /**
+     * Get all variables matching patterns
+     */
+    all(pattern?: string | string[]): Record<string, Record<string, string>>;
+    getAllFromNamespace(namespace: string, pattern: string): Record<string, string>;
+    /**
+     * Clear variables from memory
+     */
+    clear(...patterns: string[]): void;
+    /**
+     * Clear from namespaces (dangerous!)
+     */
+    clearUnsafe(...patterns: string[]): void;
+    /**
+     * Remove specific keys
+     */
+    unset(...keys: string[]): void;
+    /**
+     * Get as integer with default
+     */
+    int(key: string, defaultValue: number): number;
+    /**
+     * Get as boolean with default
+     */
+    bool(key: string, defaultValue: boolean): boolean;
+    /**
+     * Get as float with default
+     */
+    float(key: string, defaultValue: number): number;
+    /**
+     * Export all memory variables to a file
+     */
+    export(path: string): void;
+    /**
+     * Print all environment variables (masks sensitive keys)
+     */
+    dump(): void;
+}
+export declare const kev: KevOps;
+export {};
+//# sourceMappingURL=kev.d.ts.map

package/dist/platform/kev.d.ts.map

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