dexbot 1.1.10

package/dist/modules/storage/browser_adapter.js

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * BrowserStorageAdapter — in-memory Map backed by IndexedDB.
+ *
+ * Architecture:
+ *   - On construction, schedules an async IndexedDB load into an in-memory Map.
+ *     Until the load completes, synchronous reads return undefined/defaults.
+ *   - All sync operations (readJSON, writeJSON, exists, etc.) hit the Map.
+ *   - Call `await adapter.flush()` periodically or after writes to persist
+ *     to IndexedDB.  This matches the browser's single-tab / single-process
+ *     concurrency model — no cross-process atomicity needed.
+ *
+ * IndexedDB schema:
+ *   DB name: "DEXBotStorage"
+ *   Store name: "files"
+ *   Key: file path (string)
+ *   Value: { content: string, type: 'json' | 'text', mtime: number }
+ *
+ * If IndexedDB is unavailable (private browsing, SSR), falls back to a
+ * MemoryMap adapter that logs a warning.
+ */
+function createBrowserStorageAdapter() {
+    const store = new Map();
+    /** Try to open IndexedDB and load all records into memory. */
+    async function initFromIndexedDB() {
+        let db;
+        try {
+            db = await openDB();
+            const tx = db.transaction('files', 'readonly');
+            const cursor = tx.objectStore('files').openCursor();
+            await new Promise((resolve, reject) => {
+                cursor.onsuccess = (event) => {
+                    const cur = event.target.result;
+                    if (cur) {
+                        store.set(cur.key, cur.value);
+                        cur.continue();
+                    }
+                    else {
+                        resolve();
+                    }
+                };
+                cursor.onerror = () => reject(cursor.error);
+            });
+        }
+        catch {
+            // IndexedDB unavailable — MemoryMap mode
+        }
+        finally {
+            if (db)
+                db.close();
+        }
+    }
+    /** Flush in-memory store back to IndexedDB. */
+    async function flush() {
+        let db;
+        try {
+            db = await openDB();
+            const tx = db.transaction('files', 'readwrite');
+            const os = tx.objectStore('files');
+            for (const [key, value] of store) {
+                os.put(value, key);
+            }
+            await new Promise((resolve, reject) => {
+                tx.oncomplete = () => resolve();
+                tx.onerror = () => reject(tx.error);
+            });
+        }
+        catch {
+            // MemoryMap mode — nothing to flush
+        }
+        finally {
+            if (db)
+                db.close();
+        }
+    }
+    function openDB() {
+        const idb = globalThis.indexedDB;
+        return new Promise((resolve, reject) => {
+            const request = idb.open('DEXBotStorage', 1);
+            request.onupgradeneeded = (event) => {
+                const db = event.target.result;
+                if (!db.objectStoreNames.contains('files')) {
+                    db.createObjectStore('files');
+                }
+            };
+            request.onsuccess = (event) => resolve(event.target.result);
+            request.onerror = () => reject(request.error);
+        });
+    }
+    // Kick off async IndexedDB load (non-blocking)
+    initFromIndexedDB().catch(() => { });
+    const adapter = {
+        readJSON(path) {
+            const entry = store.get(path);
+            if (!entry)
+                throw Object.assign(new Error(`ENOENT: ${path}`), { code: 'ENOENT' });
+            return JSON.parse(entry.content);
+        },
+        writeJSON(path, data, options) {
+            if (options?.flag === 'wx' && store.has(path)) {
+                const err = new Error(`EEXIST: ${path}`);
+                err.code = 'EEXIST';
+                throw err;
+            }
+            const content = JSON.stringify(data, null, 2) + '\n';
+            store.set(path, {
+                content,
+                type: 'json',
+                mtime: Date.now(),
+                mode: options?.mode,
+            });
+        },
+        exists(path) {
+            return store.has(path);
+        },
+        ensureDir(_path, _options) {
+            // In-memory: directories are implicit
+        },
+        unlink(path) {
+            store.delete(path);
+        },
+        readFile(path, encoding = 'utf8') {
+            const entry = store.get(path);
+            if (!entry)
+                throw Object.assign(new Error(`ENOENT: ${path}`), { code: 'ENOENT' });
+            if (encoding === 'utf8' || encoding === 'utf-8')
+                return entry.content;
+            return entry.content;
+        },
+        writeFile(path, data, options) {
+            store.set(path, {
+                content: data,
+                type: 'text',
+                mtime: Date.now(),
+                mode: typeof options === 'object' ? options.mode : undefined,
+            });
+        },
+        rename(oldPath, newPath) {
+            const entry = store.get(oldPath);
+            if (entry) {
+                store.set(newPath, entry);
+                store.delete(oldPath);
+            }
+        },
+        stat(path) {
+            const entry = store.get(path);
+            if (!entry)
+                throw Object.assign(new Error(`ENOENT: ${path}`), { code: 'ENOENT' });
+            return {
+                mtimeMs: entry.mtime || 0,
+                isFile: () => true,
+                isDirectory: () => false,
+            };
+        },
+        readdir(dirPath) {
+            const normalized = dirPath.endsWith('/') ? dirPath : dirPath + '/';
+            const entries = new Set();
+            for (const key of store.keys()) {
+                if (key.startsWith(normalized)) {
+                    const rest = key.slice(normalized.length);
+                    const idx = rest.indexOf('/');
+                    entries.add(idx === -1 ? rest : rest.slice(0, idx));
+                }
+            }
+            return Array.from(entries);
+        },
+        open(_path, _flags, _mode) {
+            throw new Error('open() not supported in browser adapter');
+        },
+        close() {
+            throw new Error('close() not supported in browser adapter');
+        },
+        write() {
+            throw new Error('write() not supported in browser adapter');
+        },
+        fsync() {
+            throw new Error('fsync() not supported in browser adapter');
+        },
+        chmod() {
+            // no-op in browser
+        },
+        realpath(path) {
+            return path;
+        },
+        access() {
+            // no-op — all file operations are permitted in-memory
+        },
+        utimes(_path, _atime, _mtime) {
+            // no-op in browser
+        },
+        lstat(path) {
+            return this.stat(path);
+        },
+        rmdir(_path) {
+            // no-op in browser
+        },
+        rm(_path, _options) {
+            // no-op in browser
+        },
+        mkdtemp(prefix) {
+            return `${prefix}${Date.now()}.${Math.random().toString(36).slice(2, 8)}`;
+        },
+        readlink(path) {
+            return path;
+        },
+        appendFile(path, data, options) {
+            const existing = store.get(path);
+            const newContent = existing ? existing.content + data : data;
+            store.set(path, {
+                content: newContent,
+                type: 'text',
+                mtime: Date.now(),
+                mode: typeof options === 'object' ? options.mode : undefined,
+            });
+        },
+        appendFileAsync(path, data, options) {
+            this.appendFile(path, data, options);
+            return Promise.resolve();
+        },
+        createReadStream() {
+            throw new Error('createReadStream() not supported in browser adapter');
+        },
+        createWriteStream() {
+            throw new Error('createWriteStream() not supported in browser adapter');
+        },
+        flush,
+    };
+    return adapter;
+}
+module.exports = createBrowserStorageAdapter;
+//# sourceMappingURL=browser_adapter.js.map

package/dist/modules/storage/browser_adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser_adapter.js","sourceRoot":"","sources":["../../../modules/storage/browser_adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,SAAS,2BAA2B;IAClC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IAExB,8DAA8D;IAC9D,KAAK,UAAU,iBAAiB;QAC9B,IAAI,EAAE,CAAC;QACP,IAAI,CAAC;YACH,EAAE,GAAG,MAAM,MAAM,EAAE,CAAC;YACpB,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC;YACpD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC1C,MAAM,CAAC,SAAS,GAAG,CAAC,KAAU,EAAE,EAAE;oBAChC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;oBAChC,IAAI,GAAG,EAAE,CAAC;wBACR,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;wBAC9B,GAAG,CAAC,QAAQ,EAAE,CAAC;oBACjB,CAAC;yBAAM,CAAC;wBACN,OAAO,EAAE,CAAC;oBACZ,CAAC;gBACH,CAAC,CAAC;gBACF,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9C,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;QAC3C,CAAC;gBAAS,CAAC;YACT,IAAI,EAAE;gBAAE,EAAE,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,KAAK,UAAU,KAAK;QAClB,IAAI,EAAE,CAAC;QACP,IAAI,CAAC;YACH,EAAE,GAAG,MAAM,MAAM,EAAE,CAAC;YACpB,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAChD,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACnC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;gBACjC,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACrB,CAAC;YACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC1C,EAAE,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;gBAChC,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;gBAAS,CAAC;YACT,IAAI,EAAE;gBAAE,EAAE,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAED,SAAS,MAAM;QACb,MAAM,GAAG,GAAS,UAAkB,CAAC,SAAS,CAAC;QAC/C,OAAO,IAAI,OAAO,CAAM,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;YAC7C,OAAO,CAAC,eAAe,GAAG,CAAC,KAAU,EAAE,EAAE;gBACvC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;gBAC/B,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC3C,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC,CAAC;YACF,OAAO,CAAC,SAAS,GAAG,CAAC,KAAU,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACjE,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,+CAA+C;IAC/C,iBAAiB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAG;QACd,QAAQ,CAAC,IAAI;YACX,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,CAAC,KAAK;gBAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YAClF,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAED,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO;YAC3B,IAAI,OAAO,EAAE,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9C,MAAM,GAAG,GAAQ,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;gBAC9C,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC;gBACpB,MAAM,GAAG,CAAC;YACZ,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;YACrD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;gBACd,OAAO;gBACP,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE;gBACjB,IAAI,EAAE,OAAO,EAAE,IAAI;aACpB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,CAAC,IAAI;YACT,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAED,SAAS,CAAC,KAAK,EAAE,QAAQ;YACvB,sCAAsC;QACxC,CAAC;QAED,MAAM,CAAC,IAAI;YACT,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QAED,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM;YAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,CAAC,KAAK;gBAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YAClF,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,OAAO;gBAAE,OAAO,KAAK,CAAC,OAAO,CAAC;YACtE,OAAO,KAAK,CAAC,OAAO,CAAC;QACvB,CAAC;QAED,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO;YAC3B,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;gBACd,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE;gBACjB,IAAI,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;aAC7D,CAAC,CAAC;QACL,CAAC;QAED,MAAM,CAAC,OAAO,EAAE,OAAO;YACrB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACjC,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC1B,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI;YACP,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,CAAC,KAAK;gBAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YAClF,OAAO;gBACL,OAAO,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;gBACzB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI;gBAClB,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK;aACzB,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,OAAO;YACb,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC;YACnE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;YAClC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC/B,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;oBAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;oBAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAED,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK;YACvB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QACD,KAAK;YACH,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,KAAK;YACH,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,KAAK;YACH,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,KAAK;YACH,mBAAmB;QACrB,CAAC;QACD,QAAQ,CAAC,IAAI;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM;YACJ,sDAAsD;QACxD,CAAC;QACD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM;YAC1B,mBAAmB;QACrB,CAAC;QACD,KAAK,CAAC,IAAI;YACR,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAED,KAAK,CAAC,KAAK;YACT,mBAAmB;QACrB,CAAC;QAED,EAAE,CAAC,KAAK,EAAE,QAAQ;YAChB,mBAAmB;QACrB,CAAC;QAED,OAAO,CAAC,MAAM;YACZ,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC5E,CAAC;QAED,QAAQ,CAAC,IAAI;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO;YAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YAC7D,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;gBACd,OAAO,EAAE,UAAU;gBACnB,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE;gBACjB,IAAI,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;aAC7D,CAAC,CAAC;QACL,CAAC;QAED,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO;YACjC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YACrC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QAED,gBAAgB;YACd,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QAED,iBAAiB;YACf,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,KAAK;KACN,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iBAAS,2BAA2B,CAAC"}

package/dist/modules/storage/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Storage abstraction layer.
+ *
+ * Provides a unified IStorageAdapter interface for all filesystem operations.
+ *
+ * Usage:
+ *   const storage = require('./modules/storage').getStorage();
+ *   const data = storage.readJSON('/path/to/file.json');
+ *   storage.writeJSON('/path/to/file.json', { hello: 'world' });
+ *   if (storage.exists('/path/to/file.json')) { ... }
+ *
+ * Node:    wraps fs.*Sync directly; writeJSON uses unified atomic tmp+rename.
+ * Browser: in-memory Map backed by IndexedDB (call flush() to persist).
+ *
+ * Adapter selection:
+ *   - If `globalThis.window !== undefined` → BrowserStorageAdapter
+ *   - Otherwise → NodeStorageAdapter
+ *   - Explicit override via `setAdapter(adapter)` for DI/testing.
+ */
+declare const IStorageAdapter: any;
+declare function getStorage(): any;
+/**
+ * Override the storage adapter (for DI, testing, or explicit choice).
+ * Pass `null` to reset to auto-detection on next `getStorage()` call.
+ */
+declare function setAdapter(adapter: any): void;
+export { getStorage, setAdapter, IStorageAdapter };
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../modules/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,QAAA,MAAQ,eAAe,KAAuB,CAAC;AAK/C,iBAAS,UAAU,QAgBlB;AAED;;;GAGG;AACH,iBAAS,UAAU,CAAC,OAAO,KAAA,QAE1B;AAED,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC"}

package/dist/modules/storage/index.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Storage abstraction layer.
+ *
+ * Provides a unified IStorageAdapter interface for all filesystem operations.
+ *
+ * Usage:
+ *   const storage = require('./modules/storage').getStorage();
+ *   const data = storage.readJSON('/path/to/file.json');
+ *   storage.writeJSON('/path/to/file.json', { hello: 'world' });
+ *   if (storage.exists('/path/to/file.json')) { ... }
+ *
+ * Node:    wraps fs.*Sync directly; writeJSON uses unified atomic tmp+rename.
+ * Browser: in-memory Map backed by IndexedDB (call flush() to persist).
+ *
+ * Adapter selection:
+ *   - If `globalThis.window !== undefined` → BrowserStorageAdapter
+ *   - Otherwise → NodeStorageAdapter
+ *   - Explicit override via `setAdapter(adapter)` for DI/testing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IStorageAdapter = void 0;
+exports.getStorage = getStorage;
+exports.setAdapter = setAdapter;
+const { IStorageAdapter } = require('./types');
+exports.IStorageAdapter = IStorageAdapter;
+const { isBrowser } = require('../env');
+let _adapter = null;
+function getStorage() {
+    if (_adapter)
+        return _adapter;
+    if (isBrowser()) {
+        const createBrowserStorageAdapter = require('./browser_adapter');
+        _adapter = createBrowserStorageAdapter();
+    }
+    else {
+        const NodeStorageAdapter = require('./node_adapter');
+        _adapter = new NodeStorageAdapter();
+    }
+    if (!_adapter) {
+        throw new Error('No storage adapter available for this environment');
+    }
+    return _adapter;
+}
+/**
+ * Override the storage adapter (for DI, testing, or explicit choice).
+ * Pass `null` to reset to auto-detection on next `getStorage()` call.
+ */
+function setAdapter(adapter) {
+    _adapter = adapter;
+}
+//# sourceMappingURL=index.js.map

package/dist/modules/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../modules/storage/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAiCM,gCAAU;AAAE,gCAAU;AA/B/B,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AA+Bd,0CAAe;AA9BhD,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAExC,IAAI,QAAQ,GAAG,IAAI,CAAC;AAEpB,SAAS,UAAU;IACjB,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,IAAI,SAAS,EAAE,EAAE,CAAC;QAChB,MAAM,2BAA2B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACjE,QAAQ,GAAG,2BAA2B,EAAE,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,MAAM,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACrD,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAS,UAAU,CAAC,OAAO;IACzB,QAAQ,GAAG,OAAO,CAAC;AACrB,CAAC"}

package/dist/modules/storage/node_adapter.d.ts

@@ -0,0 +1,49 @@
+/**
+ * NodeStorageAdapter — wraps fs.*Sync calls directly.
+ * Single unified atomic-write implementation replaces all prior variants.
+ *
+ * Atomic write strategy:
+ *   writeJSON → tmp file (with crypto.randomBytes for collision resistance)
+ *             → optional fd-level write with mode + fsync
+ *             → rename over target
+ *             → cleanup tmp on failure
+ *
+ * This subsumes the 5 prior implementations:
+ *   1. fs_utils.writeJSON             (tmp+rename, no mode/fsync)
+ *   2. bots_file_lock.writeJsonFileAtomic (tmp+rename + crypto.randomBytes + ensureDir)
+ *   3. atomic_write.writeJsonAtomic   (tmp+rename + Math.random + ensureDir)
+ *   4. chain_keys inline              (openSync 0o600 + writeSync + fsyncSync + renameSync)
+ *   5. credential_policy inline       (openSync 0o600 + writeSync + fsyncSync + renameSync)
+ *   6. account_orders._persist        (writeFileSync + read-fsync + renameSync)
+ */
+declare class NodeStorageAdapter {
+    readJSON(filePath: any): any;
+    writeJSON(filePath: string, data: any, options?: any): void;
+    exists(path: any): any;
+    ensureDir(path: string, options?: any): void;
+    unlink(path: any): void;
+    readFile(path: any, encoding?: string): any;
+    writeFile(path: any, data: any, options: any): void;
+    rename(oldPath: any, newPath: any): void;
+    stat(path: any): any;
+    readdir(path: any): any;
+    open(path: any, flags: any, mode: any): any;
+    close(fd: any): void;
+    write(fd: any, buffer: any, position: any, encoding: any): void;
+    fsync(fd: any): void;
+    chmod(path: any, mode: any): void;
+    realpath(path: any): any;
+    access(path: any, mode: any): any;
+    utimes(path: any, atime: any, mtime: any): void;
+    lstat(path: any): any;
+    rmdir(path: any): void;
+    rm(path: any, options?: {}): void;
+    mkdtemp(prefix: any): any;
+    readlink(path: any): any;
+    appendFile(path: any, data: any, options: any): void;
+    appendFileAsync(path: any, data: any, options: any): Promise<void>;
+    createReadStream(path: any): any;
+    createWriteStream(path: any): any;
+}
+export = NodeStorageAdapter;
+//# sourceMappingURL=node_adapter.d.ts.map

package/dist/modules/storage/node_adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node_adapter.d.ts","sourceRoot":"","sources":["../../../modules/storage/node_adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAeH,cAAM,kBAAkB;IACtB,QAAQ,CAAC,QAAQ,KAAA;IAIjB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,GAAE,GAAQ;IA8CxD,MAAM,CAAC,IAAI,KAAA;IAIX,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,GAAQ;IAMzC,MAAM,CAAC,IAAI,KAAA;IAKX,QAAQ,CAAC,IAAI,KAAA,EAAE,QAAQ,SAAS;IAIhC,SAAS,CAAC,IAAI,KAAA,EAAE,IAAI,KAAA,EAAE,OAAO,KAAA;IAI7B,MAAM,CAAC,OAAO,KAAA,EAAE,OAAO,KAAA;IAIvB,IAAI,CAAC,IAAI,KAAA;IAIT,OAAO,CAAC,IAAI,KAAA;IAIZ,IAAI,CAAC,IAAI,KAAA,EAAE,KAAK,KAAA,EAAE,IAAI,KAAA;IAItB,KAAK,CAAC,EAAE,KAAA;IAIR,KAAK,CAAC,EAAE,KAAA,EAAE,MAAM,KAAA,EAAE,QAAQ,KAAA,EAAE,QAAQ,KAAA;IAIpC,KAAK,CAAC,EAAE,KAAA;IAIR,KAAK,CAAC,IAAI,KAAA,EAAE,IAAI,KAAA;IAIhB,QAAQ,CAAC,IAAI,KAAA;IAIb,MAAM,CAAC,IAAI,KAAA,EAAE,IAAI,KAAA;IAIjB,MAAM,CAAC,IAAI,KAAA,EAAE,KAAK,KAAA,EAAE,KAAK,KAAA;IAIzB,KAAK,CAAC,IAAI,KAAA;IAIV,KAAK,CAAC,IAAI,KAAA;IAIV,EAAE,CAAC,IAAI,KAAA,EAAE,OAAO,KAAK;IAIrB,OAAO,CAAC,MAAM,KAAA;IAId,QAAQ,CAAC,IAAI,KAAA;IAIb,UAAU,CAAC,IAAI,KAAA,EAAE,IAAI,KAAA,EAAE,OAAO,KAAA;IAIxB,eAAe,CAAC,IAAI,KAAA,EAAE,IAAI,KAAA,EAAE,OAAO,KAAA;IAIzC,gBAAgB,CAAC,IAAI,KAAA;IAIrB,iBAAiB,CAAC,IAAI,KAAA;CAGvB;AAED,SAAS,kBAAkB,CAAC"}

package/dist/modules/storage/node_adapter.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * NodeStorageAdapter — wraps fs.*Sync calls directly.
+ * Single unified atomic-write implementation replaces all prior variants.
+ *
+ * Atomic write strategy:
+ *   writeJSON → tmp file (with crypto.randomBytes for collision resistance)
+ *             → optional fd-level write with mode + fsync
+ *             → rename over target
+ *             → cleanup tmp on failure
+ *
+ * This subsumes the 5 prior implementations:
+ *   1. fs_utils.writeJSON             (tmp+rename, no mode/fsync)
+ *   2. bots_file_lock.writeJsonFileAtomic (tmp+rename + crypto.randomBytes + ensureDir)
+ *   3. atomic_write.writeJsonAtomic   (tmp+rename + Math.random + ensureDir)
+ *   4. chain_keys inline              (openSync 0o600 + writeSync + fsyncSync + renameSync)
+ *   5. credential_policy inline       (openSync 0o600 + writeSync + fsyncSync + renameSync)
+ *   6. account_orders._persist        (writeFileSync + read-fsync + renameSync)
+ */
+const { getNodeRequire } = require('../env');
+const _require = getNodeRequire();
+let _fs;
+const fs = new Proxy({}, {
+    get(_, prop) {
+        if (!_fs && _require)
+            _fs = _require('fs');
+        return _fs ? _fs[prop] : undefined;
+    }
+});
+const { path } = require('../path_api');
+const { randomBytes } = require('../crypto/sync');
+const { runtime } = require('../runtime');
+class NodeStorageAdapter {
+    readJSON(filePath) {
+        return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    }
+    writeJSON(filePath, data, options = {}) {
+        const dir = path.dirname(filePath);
+        if (dir && !this.exists(dir)) {
+            this.ensureDir(dir);
+        }
+        const content = JSON.stringify(data, null, 2) + '\n';
+        if (options.flag === 'wx') {
+            const mode = options.mode ?? 0o666;
+            const fd = fs.openSync(filePath, 'wx', mode);
+            try {
+                fs.writeSync(fd, content, 0, 'utf8');
+                if (options.fsync) {
+                    fs.fsyncSync(fd);
+                }
+            }
+            finally {
+                fs.closeSync(fd);
+            }
+            return;
+        }
+        const suffix = options.tmpPrefix || `.${runtime.pid}.${Date.now()}.${randomBytes(8).toString('hex')}.tmp`;
+        const tmpPath = `${filePath}${suffix}`;
+        try {
+            if (options.mode !== undefined || options.fsync) {
+                const fd = fs.openSync(tmpPath, 'w', options.mode ?? 0o666);
+                try {
+                    fs.writeSync(fd, content, 0, 'utf8');
+                    if (options.fsync) {
+                        fs.fsyncSync(fd);
+                    }
+                }
+                finally {
+                    fs.closeSync(fd);
+                }
+            }
+            else {
+                fs.writeFileSync(tmpPath, content, 'utf8');
+            }
+            fs.renameSync(tmpPath, filePath);
+        }
+        catch (err) {
+            this.unlink(tmpPath);
+            throw err;
+        }
+    }
+    exists(path) {
+        return fs.existsSync(path);
+    }
+    ensureDir(path, options = {}) {
+        const opts = { recursive: true };
+        if (options.mode !== undefined)
+            opts.mode = options.mode;
+        fs.mkdirSync(path, opts);
+    }
+    unlink(path) {
+        if (!path)
+            return;
+        try {
+            fs.unlinkSync(path);
+        }
+        catch (_) { }
+    }
+    readFile(path, encoding = 'utf8') {
+        return fs.readFileSync(path, encoding);
+    }
+    writeFile(path, data, options) {
+        fs.writeFileSync(path, data, options ?? 'utf8');
+    }
+    rename(oldPath, newPath) {
+        fs.renameSync(oldPath, newPath);
+    }
+    stat(path) {
+        return fs.statSync(path);
+    }
+    readdir(path) {
+        return fs.readdirSync(path);
+    }
+    open(path, flags, mode) {
+        return fs.openSync(path, flags, mode);
+    }
+    close(fd) {
+        fs.closeSync(fd);
+    }
+    write(fd, buffer, position, encoding) {
+        fs.writeSync(fd, buffer, position, encoding);
+    }
+    fsync(fd) {
+        fs.fsyncSync(fd);
+    }
+    chmod(path, mode) {
+        fs.chmodSync(path, mode);
+    }
+    realpath(path) {
+        return fs.realpathSync(path);
+    }
+    access(path, mode) {
+        return fs.accessSync(path, mode);
+    }
+    utimes(path, atime, mtime) {
+        fs.utimesSync(path, atime, mtime);
+    }
+    lstat(path) {
+        return fs.lstatSync(path);
+    }
+    rmdir(path) {
+        fs.rmdirSync(path);
+    }
+    rm(path, options = {}) {
+        fs.rmSync(path, options);
+    }
+    mkdtemp(prefix) {
+        return fs.mkdtempSync(prefix);
+    }
+    readlink(path) {
+        return fs.readlinkSync(path);
+    }
+    appendFile(path, data, options) {
+        fs.appendFileSync(path, data, options ?? 'utf8');
+    }
+    async appendFileAsync(path, data, options) {
+        await fs.promises.appendFile(path, data, options ?? 'utf8');
+    }
+    createReadStream(path) {
+        return fs.createReadStream(path);
+    }
+    createWriteStream(path) {
+        return fs.createWriteStream(path);
+    }
+}
+module.exports = NodeStorageAdapter;
+//# sourceMappingURL=node_adapter.js.map

package/dist/modules/storage/node_adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node_adapter.js","sourceRoot":"","sources":["../../../modules/storage/node_adapter.ts"],"names":[],"mappings":"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"}

package/dist/modules/storage/types.d.ts

@@ -0,0 +1,92 @@
+export interface IStorageAdapter {
+    /** Read and parse a JSON file */
+    readJSON<T = any>(path: string): T;
+    /**
+     * Atomically write a JSON file using tmp-file + rename.
+     * Unified implementation — replaces all 5 prior atomic-write variants.
+     *
+     * Options:
+     *   - `mode`: file permissions (e.g. 0o600). When set, uses fd-level openSync with the given mode.
+     *   - `fsync`: if true, calls fsyncSync on the fd before rename for extra durability.
+     *   - `tmpPrefix`: custom temp file prefix (default: `.tmp.${pid}.${Date.now()}.${random}`)
+     *   - `flag`: 'w' (default) overwrites via tmp+rename. 'wx' does an atomic
+     *     exclusive-create directly on the target — caller must handle EEXIST.
+     *     Use 'wx' when the file should be created only if it does not exist.
+     */
+    writeJSON(path: string, data: any, options?: {
+        mode?: number;
+        fsync?: boolean;
+        tmpPrefix?: string;
+        flag?: 'w' | 'wx';
+    }): void;
+    /** Check if a path exists */
+    exists(path: string): boolean;
+    /** Ensure a directory exists (recursive mkdir) */
+    ensureDir(path: string, options?: {
+        mode?: number;
+    }): void;
+    /** Delete a file; no-op if missing */
+    unlink(path: string): void;
+    /** Read a file as string */
+    readFile(path: string, encoding?: string): string;
+    /** Write a file (non-atomic; use writeJSON for structured/atomic writes) */
+    writeFile(path: string, data: string, options?: {
+        mode?: number;
+    } | string): void;
+    /** Rename / move a file */
+    rename(oldPath: string, newPath: string): void;
+    /** Get file stats */
+    stat(path: string): {
+        mtimeMs: number;
+        isFile(): boolean;
+        isDirectory(): boolean;
+    };
+    /** List directory contents */
+    readdir(path: string): string[];
+    /** Open a file descriptor */
+    open(path: string, flags: string | number, mode?: number): number;
+    /** Close a file descriptor */
+    close(fd: number): void;
+    /** Synchronous write to a file descriptor */
+    write(fd: number, buffer: string, position?: number | null, encoding?: string): void;
+    /** Flush a file descriptor to disk */
+    fsync(fd: number): void;
+    /** Change file permissions */
+    chmod(path: string, mode: number): void;
+    /** Resolve symlinks */
+    realpath(path: string): string;
+    /** Check file access */
+    access(path: string, mode?: number): void;
+    /** Update file timestamps */
+    utimes(path: string, atime: Date | number, mtime: Date | number): void;
+    /** Get file stats without following symlinks */
+    lstat(path: string): {
+        mtimeMs: number;
+        isFile(): boolean;
+        isDirectory(): boolean;
+    };
+    /** Remove a directory (must be empty) */
+    rmdir(path: string): void;
+    /** Remove a file or directory tree (recursive, force) */
+    rm(path: string, options?: {
+        recursive?: boolean;
+        force?: boolean;
+    }): void;
+    /** Create a unique temporary directory */
+    mkdtemp(prefix: string): string;
+    /** Read the target of a symbolic link */
+    readlink(path: string): string;
+    /** Append data to a file (creates if missing). Non-atomic. */
+    appendFile(path: string, data: string, options?: {
+        mode?: number;
+    } | string): void;
+    /** Append data to a file asynchronously (creates if missing). Non-atomic. */
+    appendFileAsync(path: string, data: string, options?: {
+        mode?: number;
+    } | string): Promise<void>;
+    /** Create a readable stream for a file (Node-only; throws in browser adapter) */
+    createReadStream(path: string): any;
+    /** Create a writable stream for a file (Node-only; throws in browser adapter) */
+    createWriteStream(path: string): any;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/modules/storage/types.d.ts.map

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

package/dist/modules/storage/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map