@edenapp/sdk 0.1.0

package/dist/settings/SettingsHandler.js

@@ -0,0 +1,199 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettingsHandler = exports.EDEN_SETTINGS_APP_ID = void 0;
+const ipc_1 = require("../ipc");
+/**
+ * Reserved app ID for Eden system settings.
+ * No external app can use this ID.
+ */
+exports.EDEN_SETTINGS_APP_ID = "com.eden";
+/**
+ * SettingsHandler - IPC layer for settings operations
+ *
+ * Provides multiple sets of endpoints:
+ * 1. Regular endpoints - require "settings/rw" permission, scoped to caller's appId
+ * 2. Superuser endpoints - require "settings/superuser" permission for cross-namespace access
+ *
+ * Eden system settings use appId "com.eden" via superuser endpoints.
+ */
+let SettingsHandler = class SettingsHandler {
+    settingsManager;
+    constructor(settingsManager) {
+        this.settingsManager = settingsManager;
+    }
+    // ===================================================================
+    // Regular Endpoints - Scoped to caller's app
+    // ===================================================================
+    /**
+     * Get a setting value (scoped to caller's app)
+     */
+    async handleGet(args) {
+        const { key } = args;
+        const value = await this.settingsManager.get(args._callerAppId, key);
+        return { value };
+    }
+    /**
+     * Set a setting value (scoped to caller's app)
+     */
+    async handleSet(args) {
+        const { key, value } = args;
+        await this.settingsManager.set(args._callerAppId, key, value);
+        return { success: true };
+    }
+    /**
+     * List all settings keys (scoped to caller's app)
+     */
+    async handleList(args) {
+        const keys = await this.settingsManager.list(args._callerAppId);
+        return { keys };
+    }
+    /**
+     * Get all settings with values (scoped to caller's app)
+     */
+    async handleGetAll(args) {
+        const settings = await this.settingsManager.getAll(args._callerAppId);
+        return { settings };
+    }
+    /**
+     * Reset a setting to default (scoped to caller's app)
+     */
+    async handleReset(args) {
+        const { key, schema } = args;
+        await this.settingsManager.reset(args._callerAppId, key, schema);
+        return { success: true };
+    }
+    // ===================================================================
+    // Superuser Endpoints - Cross-namespace access
+    // ===================================================================
+    /**
+     * Get a setting from any app's namespace (superuser only)
+     */
+    async handleGetSuperuser(args) {
+        const { appId, key } = args;
+        const value = await this.settingsManager.get(appId, key);
+        return { value };
+    }
+    /**
+     * Set a setting in any app's namespace (superuser only)
+     */
+    async handleSetSuperuser(args) {
+        const { appId, key, value } = args;
+        await this.settingsManager.set(appId, key, value);
+        return { success: true };
+    }
+    /**
+     * List all settings in any app's namespace (superuser only)
+     */
+    async handleListSuperuser(args) {
+        const { appId } = args;
+        const keys = await this.settingsManager.list(appId);
+        return { keys };
+    }
+    /**
+     * Get all settings with values for any app (superuser only)
+     */
+    async handleGetAllSuperuser(args) {
+        const { appId } = args;
+        const settings = await this.settingsManager.getAll(appId);
+        return { settings };
+    }
+    /**
+     * Reset a setting for any app (superuser only)
+     */
+    async handleResetSuperuser(args) {
+        const { appId, key, schema } = args;
+        await this.settingsManager.reset(appId, key, schema);
+        return { success: true };
+    }
+    // ===================================================================
+    // Eden Schema Endpoint
+    // ===================================================================
+    /**
+     * Get the Eden settings schema
+     */
+    async handleSchema() {
+        const schema = this.settingsManager.getEdenSchema();
+        return { schema };
+    }
+};
+exports.SettingsHandler = SettingsHandler;
+__decorate([
+    (0, ipc_1.EdenHandler)("get", { permission: "rw" }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SettingsHandler.prototype, "handleGet", null);
+__decorate([
+    (0, ipc_1.EdenHandler)("set", { permission: "rw" }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SettingsHandler.prototype, "handleSet", null);
+__decorate([
+    (0, ipc_1.EdenHandler)("list", { permission: "rw" }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SettingsHandler.prototype, "handleList", null);
+__decorate([
+    (0, ipc_1.EdenHandler)("get-all", { permission: "rw" }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SettingsHandler.prototype, "handleGetAll", null);
+__decorate([
+    (0, ipc_1.EdenHandler)("reset", { permission: "rw" }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SettingsHandler.prototype, "handleReset", null);
+__decorate([
+    (0, ipc_1.EdenHandler)("get/su", { permission: "superuser" }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SettingsHandler.prototype, "handleGetSuperuser", null);
+__decorate([
+    (0, ipc_1.EdenHandler)("set/su", { permission: "superuser" }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SettingsHandler.prototype, "handleSetSuperuser", null);
+__decorate([
+    (0, ipc_1.EdenHandler)("list/su", { permission: "superuser" }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SettingsHandler.prototype, "handleListSuperuser", null);
+__decorate([
+    (0, ipc_1.EdenHandler)("get-all/su", { permission: "superuser" }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SettingsHandler.prototype, "handleGetAllSuperuser", null);
+__decorate([
+    (0, ipc_1.EdenHandler)("reset/su", { permission: "superuser" }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SettingsHandler.prototype, "handleResetSuperuser", null);
+__decorate([
+    (0, ipc_1.EdenHandler)("schema"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], SettingsHandler.prototype, "handleSchema", null);
+exports.SettingsHandler = SettingsHandler = __decorate([
+    (0, ipc_1.EdenNamespace)("settings"),
+    __metadata("design:paramtypes", [Function])
+], SettingsHandler);
+//# sourceMappingURL=SettingsHandler.js.map

package/dist/settings/SettingsHandler.js.map

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

package/dist/settings/SettingsManager.d.ts

@@ -0,0 +1,64 @@
+import { SettingsCategory } from "@edenapp/types";
+import { CommandRegistry, IPCBridge, EdenEmitter } from "../ipc";
+/**
+ * Events emitted by the SettingsManager
+ */
+interface SettingsNamespaceEvents {
+    changed: {
+        appId: string;
+        key: string;
+        value: string;
+    };
+}
+/**
+ * SettingsManager - Manages persistent settings storage for Eden and apps
+ *
+ * Provides namespace-isolated settings storage using SQLite backend via Keyv.
+ * Settings are stored separately from app data in settings.db.
+ * Key format: {appId}:{key}
+ *
+ * Eden system settings use appId "com.eden" which is reserved.
+ */
+export declare class SettingsManager extends EdenEmitter<SettingsNamespaceEvents> {
+    private keyv;
+    private handler;
+    constructor(ipcBridge: IPCBridge, commandRegistry: CommandRegistry, appsDirectory: string);
+    /**
+     * Get the namespaced key for an app setting
+     */
+    private getAppKey;
+    /**
+     * Get a setting value for an app
+     */
+    get(appId: string, key: string): Promise<string | undefined>;
+    /**
+     * Set a setting value for an app
+     */
+    set(appId: string, key: string, value: string): Promise<void>;
+    /**
+     * List all setting keys for an app
+     */
+    list(appId: string): Promise<string[]>;
+    /**
+     * Get all settings with values for an app
+     */
+    getAll(appId: string): Promise<Record<string, string>>;
+    /**
+     * Reset a setting to its default value
+     */
+    reset(appId: string, key: string, schema?: SettingsCategory[]): Promise<void>;
+    /**
+     * Get Eden settings schema
+     */
+    getEdenSchema(): SettingsCategory[];
+    /**
+     * Get the default value for an Eden setting key
+     */
+    private getEdenDefault;
+    /**
+     * Get all Eden settings with values (including defaults)
+     */
+    private getAllEdenSettings;
+}
+export {};
+//# sourceMappingURL=SettingsManager.d.ts.map

package/dist/settings/SettingsManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsManager.d.ts","sourceRoot":"","sources":["../../src/settings/SettingsManager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAiB,WAAW,EAAE,MAAM,QAAQ,CAAC;AAIhF;;GAEG;AACH,UAAU,uBAAuB;IAC/B,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD;AAED;;;;;;;;GAQG;AACH,qBAEa,eAAgB,SAAQ,WAAW,CAAC,uBAAuB,CAAC;IACvE,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,OAAO,CAAkB;gBAGZ,SAAS,EAAE,SAAS,EACd,eAAe,EAAE,eAAe,EAChC,aAAa,EAAE,MAAM;IAwBhD;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAkBlE;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAanE;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAuB5C;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAmB5D;;OAEG;IACG,KAAK,CACT,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,gBAAgB,EAAE,GAC1B,OAAO,CAAC,IAAI,CAAC;IA+BhB;;OAEG;IACH,aAAa,IAAI,gBAAgB,EAAE;IAInC;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;YACW,kBAAkB;CAcjC"}

package/dist/settings/SettingsManager.js

@@ -0,0 +1,221 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettingsManager = void 0;
+const keyv_1 = __importDefault(require("keyv"));
+const sqlite_1 = __importDefault(require("@keyv/sqlite"));
+const path = __importStar(require("path"));
+const tsyringe_1 = require("tsyringe");
+const ipc_1 = require("../ipc");
+const SettingsHandler_1 = require("./SettingsHandler");
+const EdenSettings_1 = require("./EdenSettings");
+/**
+ * SettingsManager - Manages persistent settings storage for Eden and apps
+ *
+ * Provides namespace-isolated settings storage using SQLite backend via Keyv.
+ * Settings are stored separately from app data in settings.db.
+ * Key format: {appId}:{key}
+ *
+ * Eden system settings use appId "com.eden" which is reserved.
+ */
+let SettingsManager = class SettingsManager extends ipc_1.EdenEmitter {
+    keyv;
+    handler;
+    constructor(ipcBridge, commandRegistry, appsDirectory) {
+        super(ipcBridge);
+        // Initialize Keyv with SQLite backend - separate from app storage
+        const dbPath = path.join(appsDirectory, "settings.db");
+        const sqlite = new sqlite_1.default(`sqlite://${dbPath}`);
+        this.keyv = new keyv_1.default({ store: sqlite });
+        // Handle errors
+        this.keyv.on("error", (err) => {
+            console.error("[SettingsManager] Database error:", err);
+        });
+        console.log(`[SettingsManager] Initialized settings storage at ${dbPath}`);
+        // Create and register handler
+        this.handler = new SettingsHandler_1.SettingsHandler(this);
+        commandRegistry.registerManager(this.handler);
+    }
+    // ===================================================================
+    // App Settings Methods
+    // ===================================================================
+    /**
+     * Get the namespaced key for an app setting
+     */
+    getAppKey(appId, key) {
+        return `${appId}:${key}`;
+    }
+    /**
+     * Get a setting value for an app
+     */
+    async get(appId, key) {
+        const namespacedKey = this.getAppKey(appId, key);
+        const value = await this.keyv.get(namespacedKey);
+        // If no value found and this is com.eden, check for default
+        if (value === undefined && appId === SettingsHandler_1.EDEN_SETTINGS_APP_ID) {
+            return this.getEdenDefault(key);
+        }
+        if (value !== undefined && typeof value !== "string") {
+            console.warn(`[SettingsManager] Non-string value found for key ${key}, converting to string`);
+            return String(value);
+        }
+        return value;
+    }
+    /**
+     * Set a setting value for an app
+     */
+    async set(appId, key, value) {
+        if (typeof value !== "string") {
+            throw new Error(`[SettingsManager] Value must be a string, got ${typeof value}`);
+        }
+        const namespacedKey = this.getAppKey(appId, key);
+        await this.keyv.set(namespacedKey, value);
+        // Notify subscribers of the change
+        this.notify("changed", { appId, key, value });
+    }
+    /**
+     * List all setting keys for an app
+     */
+    async list(appId) {
+        const prefix = `${appId}:`;
+        const allKeys = [];
+        try {
+            if (this.keyv.iterator) {
+                const iterator = this.keyv.iterator(undefined);
+                for await (const [key] of iterator) {
+                    if (typeof key === "string" && key.startsWith(prefix)) {
+                        allKeys.push(key.substring(prefix.length));
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.warn("[SettingsManager] Iterator not supported or failed:", error);
+        }
+        return allKeys;
+    }
+    /**
+     * Get all settings with values for an app
+     */
+    async getAll(appId) {
+        // For com.eden, return all settings with defaults
+        if (appId === SettingsHandler_1.EDEN_SETTINGS_APP_ID) {
+            return this.getAllEdenSettings();
+        }
+        const keys = await this.list(appId);
+        const result = {};
+        for (const key of keys) {
+            const value = await this.get(appId, key);
+            if (value !== undefined) {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    /**
+     * Reset a setting to its default value
+     */
+    async reset(appId, key, schema) {
+        // Find default value from schema
+        let defaultValue;
+        // For com.eden, use built-in schema
+        const schemaToUse = appId === SettingsHandler_1.EDEN_SETTINGS_APP_ID ? EdenSettings_1.EDEN_SETTINGS_SCHEMA : schema;
+        if (schemaToUse) {
+            for (const category of schemaToUse) {
+                const setting = category.settings.find((s) => s.key === key);
+                if (setting) {
+                    defaultValue = setting.defaultValue;
+                    break;
+                }
+            }
+        }
+        if (defaultValue === undefined) {
+            throw new Error(`[SettingsManager] Cannot reset key "${key}": no default value found in schema`);
+        }
+        await this.set(appId, key, defaultValue);
+    }
+    // ===================================================================
+    // Eden System Settings Helpers
+    // ===================================================================
+    /**
+     * Get Eden settings schema
+     */
+    getEdenSchema() {
+        return EdenSettings_1.EDEN_SETTINGS_SCHEMA;
+    }
+    /**
+     * Get the default value for an Eden setting key
+     */
+    getEdenDefault(key) {
+        for (const category of EdenSettings_1.EDEN_SETTINGS_SCHEMA) {
+            const setting = category.settings.find((s) => s.key === key);
+            if (setting) {
+                return setting.defaultValue;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Get all Eden settings with values (including defaults)
+     */
+    async getAllEdenSettings() {
+        const result = {};
+        for (const category of EdenSettings_1.EDEN_SETTINGS_SCHEMA) {
+            for (const setting of category.settings) {
+                const value = await this.get(SettingsHandler_1.EDEN_SETTINGS_APP_ID, setting.key);
+                if (value !== undefined) {
+                    result[setting.key] = value;
+                }
+            }
+        }
+        return result;
+    }
+};
+exports.SettingsManager = SettingsManager;
+exports.SettingsManager = SettingsManager = __decorate([
+    (0, tsyringe_1.singleton)(),
+    (0, ipc_1.EdenNamespace)("settings"),
+    __param(0, (0, tsyringe_1.inject)(ipc_1.IPCBridge)),
+    __param(1, (0, tsyringe_1.inject)(ipc_1.CommandRegistry)),
+    __param(2, (0, tsyringe_1.inject)("appsDirectory")),
+    __metadata("design:paramtypes", [ipc_1.IPCBridge,
+        ipc_1.CommandRegistry, String])
+], SettingsManager);
+//# sourceMappingURL=SettingsManager.js.map

package/dist/settings/SettingsManager.js.map

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

package/dist/settings/index.d.ts

@@ -0,0 +1,4 @@
+export { SettingsManager } from "./SettingsManager";
+export { SettingsHandler, EDEN_SETTINGS_APP_ID } from "./SettingsHandler";
+export { EDEN_SETTINGS_SCHEMA } from "./EdenSettings";
+//# sourceMappingURL=index.d.ts.map

package/dist/settings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/settings/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/settings/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EDEN_SETTINGS_SCHEMA = exports.EDEN_SETTINGS_APP_ID = exports.SettingsHandler = exports.SettingsManager = void 0;
+var SettingsManager_1 = require("./SettingsManager");
+Object.defineProperty(exports, "SettingsManager", { enumerable: true, get: function () { return SettingsManager_1.SettingsManager; } });
+var SettingsHandler_1 = require("./SettingsHandler");
+Object.defineProperty(exports, "SettingsHandler", { enumerable: true, get: function () { return SettingsHandler_1.SettingsHandler; } });
+Object.defineProperty(exports, "EDEN_SETTINGS_APP_ID", { enumerable: true, get: function () { return SettingsHandler_1.EDEN_SETTINGS_APP_ID; } });
+var EdenSettings_1 = require("./EdenSettings");
+Object.defineProperty(exports, "EDEN_SETTINGS_SCHEMA", { enumerable: true, get: function () { return EdenSettings_1.EDEN_SETTINGS_SCHEMA; } });
+//# sourceMappingURL=index.js.map

package/dist/settings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/settings/index.ts"],"names":[],"mappings":";;;AAAA,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,qDAA0E;AAAjE,kHAAA,eAAe,OAAA;AAAE,uHAAA,oBAAoB,OAAA;AAC9C,+CAAsD;AAA7C,oHAAA,oBAAoB,OAAA"}

package/dist/utils/cachedFileReader.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Cached file reader for non-changing files.
+ * Reads from filesystem on first access, then serves from cache.
+ */
+declare class CachedFileReader {
+    private cache;
+    /**
+     * Reads a file from cache if available, otherwise reads from filesystem and caches the result.
+     * @param filePath - Absolute path to the file to read
+     * @param encoding - File encoding (default: 'utf-8')
+     * @returns The file contents as a string
+     */
+    read(filePath: string, encoding?: BufferEncoding): string;
+    /**
+     * Asynchronously reads a file from cache if available, otherwise reads from filesystem and caches the result.
+     * @param filePath - Absolute path to the file to read
+     * @param encoding - File encoding (default: 'utf-8')
+     * @returns Promise resolving to the file contents as a string
+     */
+    readAsync(filePath: string, encoding?: BufferEncoding): Promise<string>;
+    /**
+     * Flushes the entire cache.
+     */
+    flushCache(): void;
+    /**
+     * Flushes a specific file from the cache.
+     * @param filePath - Absolute path to the file to flush
+     * @param encoding - File encoding (default: 'utf-8')
+     */
+    flushFile(filePath: string, encoding?: BufferEncoding): void;
+    /**
+     * Checks if a file is cached.
+     * @param filePath - Absolute path to the file
+     * @param encoding - File encoding (default: 'utf-8')
+     * @returns true if the file is cached, false otherwise
+     */
+    isCached(filePath: string, encoding?: BufferEncoding): boolean;
+    /**
+     * Gets the number of cached files.
+     * @returns The number of files currently in cache
+     */
+    getCacheSize(): number;
+}
+export declare const cachedFileReader: CachedFileReader;
+export { CachedFileReader };
+//# sourceMappingURL=cachedFileReader.d.ts.map

package/dist/utils/cachedFileReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cachedFileReader.d.ts","sourceRoot":"","sources":["../../src/utils/cachedFileReader.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,cAAM,gBAAgB;IACpB,OAAO,CAAC,KAAK,CAAkC;IAE/C;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAwB,GAAG,MAAM;IAalE;;;;;OAKG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAwB,GAAG,OAAO,CAAC,MAAM,CAAC;IAatF;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAwB,GAAG,IAAI;IAKrE;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAwB,GAAG,OAAO;IAKvE;;;OAGG;IACH,YAAY,IAAI,MAAM;CAGvB;AAGD,eAAO,MAAM,gBAAgB,kBAAyB,CAAC;AAGvD,OAAO,EAAE,gBAAgB,EAAE,CAAC"}