@optimizely/ocp-local-env 1.0.0-beta.10

package/dist/src/local_engine/storage/LocalKVStore.js

@@ -0,0 +1,1061 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalKVStore = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const NumberSet_1 = require("./NumberSet");
+const StringSet_1 = require("./StringSet");
+const LogManager_1 = require("../../logging/LogManager");
+/**
+ * Local implementation of KVStore that persists data to disk
+ * Follows the pattern of LocalSettingsStore with singleton per app directory
+ */
+class LocalKVStore {
+    constructor(appRootDir, storeFileName = "kvstore.json") {
+        this.logManager = LogManager_1.LogManager.getInstance();
+        this.appRootDir = appRootDir;
+        this.storeFileName = storeFileName;
+        this.configDirPath = path_1.default.join(appRootDir, ".ocp-local");
+        this.kvStorePath = path_1.default.join(this.configDirPath, storeFileName);
+        // Initialize store file if it doesn't exist
+        this.ensureStoreFileExists();
+    }
+    /**
+     * Get or create a singleton instance for the given app directory
+     */
+    static getInstance(appRootDir, storeFileName) {
+        const normalizedPath = path_1.default.resolve(appRootDir);
+        const instanceKey = `${normalizedPath}:${storeFileName || "kvstore.json"}`;
+        if (!this.instances.has(instanceKey)) {
+            this.instances.set(instanceKey, new LocalKVStore(normalizedPath, storeFileName));
+        }
+        return this.instances.get(instanceKey);
+    }
+    /**
+     * Clear singleton instance for testing
+     */
+    static clearInstance(appRootDir, storeFileName) {
+        const normalizedPath = path_1.default.resolve(appRootDir);
+        const instanceKey = `${normalizedPath}:${storeFileName || "kvstore.json"}`;
+        this.instances.delete(instanceKey);
+    }
+    /**
+     * Clear all singleton instances for testing
+     */
+    static clearAllInstances() {
+        this.instances.clear();
+    }
+    /**
+     * Ensure store file exists with empty structure
+     */
+    ensureStoreFileExists() {
+        try {
+            // Ensure the .ocp-local directory exists
+            if (!fs_1.default.existsSync(this.configDirPath)) {
+                fs_1.default.mkdirSync(this.configDirPath, { recursive: true });
+            }
+            // Create empty store file if it doesn't exist
+            if (!fs_1.default.existsSync(this.kvStorePath)) {
+                this.saveDataToDisk({});
+            }
+        }
+        catch (error) {
+            this.logManager.warn(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'Failed to ensure KV store file exists', {
+                id: 'unknown',
+                store: 'LocalKVStore',
+                operation: 'set',
+                error
+            });
+        }
+    }
+    /**
+     * Load data from disk and clean up expired entries
+     */
+    loadDataFromDisk() {
+        try {
+            if (!fs_1.default.existsSync(this.kvStorePath)) {
+                return {};
+            }
+            const storeData = fs_1.default.readFileSync(this.kvStorePath, "utf-8");
+            const data = JSON.parse(storeData);
+            // Clean up expired entries
+            const now = Date.now();
+            const cleanedData = {};
+            for (const [key, item] of Object.entries(data)) {
+                if (!item.expiresAt || item.expiresAt > now) {
+                    cleanedData[key] = item;
+                }
+            }
+            // Save cleaned data if any entries were removed
+            if (Object.keys(cleanedData).length !== Object.keys(data).length) {
+                this.saveDataToDisk(cleanedData);
+            }
+            return cleanedData;
+        }
+        catch (error) {
+            this.logManager.warn(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'Failed to load KV store from disk', {
+                id: 'unknown',
+                store: 'LocalKVStore',
+                operation: 'get',
+                error
+            });
+            return {};
+        }
+    }
+    /**
+     * Save data to disk atomically
+     */
+    saveDataToDisk(data) {
+        try {
+            // Ensure the .ocp-local directory exists
+            if (!fs_1.default.existsSync(this.configDirPath)) {
+                fs_1.default.mkdirSync(this.configDirPath, { recursive: true });
+            }
+            // Serialize data with custom handling for NumberSet and StringSet
+            const serializedData = JSON.stringify(data, (key, value) => {
+                if (value instanceof NumberSet_1.NumberSet) {
+                    return { _type: "NumberSet", values: Array.from(value) };
+                }
+                if (value instanceof StringSet_1.StringSet) {
+                    return { _type: "StringSet", values: Array.from(value) };
+                }
+                return value;
+            }, 2);
+            // Write to temp file first, then rename for atomicity
+            const tempPath = `${this.kvStorePath}.tmp`;
+            fs_1.default.writeFileSync(tempPath, serializedData, "utf-8");
+            fs_1.default.renameSync(tempPath, this.kvStorePath);
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'Failed to save KV store to disk', {
+                id: 'unknown',
+                store: 'LocalKVStore',
+                operation: 'set',
+                error
+            });
+            throw error;
+        }
+    }
+    /**
+     * Deserialize data with custom handling for NumberSet and StringSet
+     */
+    deserializeValue(value) {
+        if (value && typeof value === "object" && value._type) {
+            switch (value._type) {
+                case "NumberSet":
+                    return new NumberSet_1.NumberSet(value.values);
+                case "StringSet":
+                    return new StringSet_1.StringSet(value.values);
+            }
+        }
+        if (Array.isArray(value)) {
+            return value.map((item) => this.deserializeValue(item));
+        }
+        if (value && typeof value === "object") {
+            const result = {};
+            for (const [k, v] of Object.entries(value)) {
+                result[k] = this.deserializeValue(v);
+            }
+            return result;
+        }
+        return value;
+    }
+    /**
+     * Get stored item with deserialization
+     */
+    getStoredItem(key) {
+        const data = this.loadDataFromDisk();
+        const item = data[key];
+        if (!item) {
+            return null;
+        }
+        // Deserialize the data
+        const deserializedData = this.deserializeValue(item.data);
+        return {
+            ...item,
+            data: deserializedData,
+        };
+    }
+    /**
+     * Store item with optional TTL
+     */
+    storeItem(key, data, options) {
+        const storeData = this.loadDataFromDisk();
+        const item = { data };
+        if (options?.ttl !== undefined) {
+            item.ttl = options.ttl;
+            item.expiresAt = Date.now() + options.ttl * 1000;
+        }
+        storeData[key] = item;
+        this.saveDataToDisk(storeData);
+    }
+    // ===================================================================================================================
+    // Basic Operations
+    // ===================================================================================================================
+    async get(key, fields) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'GET request', {
+            id: key || 'unknown',
+            store: 'LocalKVStore',
+            operation: 'get',
+            key
+        });
+        try {
+            const item = this.getStoredItem(key);
+            if (!item) {
+                this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'GET result: empty', {
+                    id: key || 'unknown',
+                    store: 'LocalKVStore',
+                    operation: 'get',
+                    key
+                });
+                return {};
+            }
+            if (fields && fields.length > 0) {
+                // Return only requested fields
+                const filteredData = {};
+                fields.forEach((field) => {
+                    if (item.data[field] !== undefined) {
+                        filteredData[field] = item.data[field];
+                    }
+                });
+                this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'GET result: filtered', {
+                    id: key || 'unknown',
+                    store: 'LocalKVStore',
+                    operation: 'get',
+                    key
+                });
+                return filteredData;
+            }
+            else {
+                // Return all data
+                this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'GET result: full', {
+                    id: key || 'unknown',
+                    store: 'LocalKVStore',
+                    operation: 'get',
+                    key
+                });
+                return item.data;
+            }
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'GET failed', {
+                id: key || 'unknown',
+                store: 'LocalKVStore',
+                operation: 'get',
+                key,
+                error
+            });
+            return {};
+        }
+    }
+    async put(key, value, options) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'PUT request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        try {
+            // Get previous value
+            const previousItem = this.getStoredItem(key);
+            const previousValue = previousItem ? previousItem.data : {};
+            // Store new value
+            this.storeItem(key, value, options);
+            this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'PUT completed', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+            return previousValue;
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'PUT failed', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key, error });
+            throw error;
+        }
+    }
+    async patch(key, valueOrUpdater, options) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'PATCH request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        try {
+            // Get current value
+            const currentItem = this.getStoredItem(key);
+            const currentValue = currentItem ? currentItem.data : {};
+            let newValue;
+            if (typeof valueOrUpdater === "function") {
+                // Updater function
+                const updater = valueOrUpdater;
+                try {
+                    // Try with options first (KVPatchUpdaterWithOptions)
+                    const currentOptions = { ttl: currentItem?.ttl };
+                    newValue = updater(currentValue, currentOptions);
+                }
+                catch (error) {
+                    // Fall back to regular PatchUpdater
+                    newValue = updater(currentValue);
+                }
+            }
+            else {
+                // Value object - merge with current
+                newValue = { ...currentValue, ...valueOrUpdater };
+            }
+            // Store updated value
+            this.storeItem(key, newValue, options);
+            this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'PATCH completed', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+            return currentValue;
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'PATCH failed', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key, error });
+            throw error;
+        }
+    }
+    async delete(key, fields) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'DELETE request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'delete', key });
+        try {
+            const storeData = this.loadDataFromDisk();
+            const item = storeData[key];
+            if (!item) {
+                this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'DELETE result: not found', { id: key || 'unknown', store: 'LocalKVStore', operation: 'delete', key });
+                return {};
+            }
+            const deserializedData = this.deserializeValue(item.data);
+            if (!fields || fields.length === 0) {
+                // Delete entire object
+                delete storeData[key];
+                this.saveDataToDisk(storeData);
+                this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'DELETE completed: deleted entire key', { id: key || 'unknown', store: 'LocalKVStore', operation: 'delete', key });
+                return deserializedData;
+            }
+            else {
+                // Delete specific fields
+                const deletedFields = {};
+                fields.forEach((field) => {
+                    if (item.data[field] !== undefined) {
+                        deletedFields[field] = item.data[field];
+                        delete item.data[field];
+                    }
+                });
+                this.saveDataToDisk(storeData);
+                this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'DELETE completed: deleted fields', { id: key || 'unknown', store: 'LocalKVStore', operation: 'delete', key });
+                return this.deserializeValue(deletedFields);
+            }
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'DELETE failed', { id: key || 'unknown', store: 'LocalKVStore', operation: 'delete', key, error });
+            throw error;
+        }
+    }
+    async exists(key) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'EXISTS request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'exists', key });
+        try {
+            const item = this.getStoredItem(key);
+            const exists = item !== null;
+            this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'EXISTS result', { id: key || 'unknown', store: 'LocalKVStore', operation: 'exists', key });
+            return exists;
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'EXISTS failed', { id: key || 'unknown', store: 'LocalKVStore', operation: 'exists', key, error });
+            return false;
+        }
+    }
+    // ===================================================================================================================
+    // Numeric Operations
+    // ===================================================================================================================
+    async increment(key, field, amount = 1, options) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'INCREMENT request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        return this.patch(key, (previous) => {
+            const currentValue = previous[field];
+            if (currentValue !== undefined && typeof currentValue !== "number") {
+                throw new Error(`Field "${field}" is not a number`);
+            }
+            const newValue = (currentValue || 0) + amount;
+            return {
+                ...previous,
+                [field]: newValue,
+            };
+        }, options).then(() => {
+            // Return the new value
+            return this.get(key, [field]).then((result) => result[field]);
+        });
+    }
+    async incrementMulti(key, fieldAmounts, options) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'INCREMENT_MULTI request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        return this.patch(key, (previous) => {
+            const updated = { ...previous };
+            for (const [field, amount] of Object.entries(fieldAmounts)) {
+                const currentValue = updated[field];
+                if (currentValue !== undefined && typeof currentValue !== "number") {
+                    throw new Error(`Field "${field}" is not a number`);
+                }
+                updated[field] = (currentValue || 0) + amount;
+            }
+            return updated;
+        }, options).then(() => {
+            // Return the new values
+            return this.get(key, Object.keys(fieldAmounts)).then((result) => {
+                const newValues = {};
+                for (const field of Object.keys(fieldAmounts)) {
+                    newValues[field] = result[field];
+                }
+                return newValues;
+            });
+        });
+    }
+    // ===================================================================================================================
+    // List Operations
+    // ===================================================================================================================
+    async shift(key, field) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'SHIFT request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        let shiftedElement = undefined;
+        await this.patch(key, (previous) => {
+            const currentValue = previous[field];
+            if (currentValue === undefined) {
+                return previous;
+            }
+            if (!Array.isArray(currentValue)) {
+                throw new Error(`Field "${field}" is not a list`);
+            }
+            if (currentValue.length === 0) {
+                return previous;
+            }
+            // Capture the first element before removing it
+            shiftedElement = currentValue[0];
+            // Remove first element
+            const updatedList = [...currentValue.slice(1)];
+            return {
+                ...previous,
+                [field]: updatedList,
+            };
+        });
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'SHIFT result', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        return shiftedElement;
+    }
+    async shiftMulti(key, fieldCounts) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'SHIFT_MULTI request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        const shiftedItems = {};
+        return this.patch(key, (previous) => {
+            const updated = { ...previous };
+            for (const [field, count] of Object.entries(fieldCounts)) {
+                const currentValue = updated[field];
+                if (currentValue === undefined) {
+                    shiftedItems[field] = [];
+                    continue;
+                }
+                if (!Array.isArray(currentValue)) {
+                    throw new Error(`Field "${field}" is not a list`);
+                }
+                const actualCount = Math.min(count, currentValue.length);
+                shiftedItems[field] = currentValue.slice(0, actualCount);
+                updated[field] = currentValue.slice(actualCount);
+            }
+            return updated;
+        }).then(() => shiftedItems);
+    }
+    async unshift(key, field, value) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'UNSHIFT request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        await this.patch(key, (previous) => {
+            const currentValue = previous[field];
+            if (currentValue === undefined) {
+                // Create new list with the value
+                return {
+                    ...previous,
+                    [field]: [value],
+                };
+            }
+            if (!Array.isArray(currentValue)) {
+                throw new Error(`Field "${field}" is not a list`);
+            }
+            // Prepend to existing list
+            return {
+                ...previous,
+                [field]: [value, ...currentValue],
+            };
+        });
+    }
+    async unshiftMulti(key, fieldValues) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'UNSHIFT_MULTI request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        await this.patch(key, (previous) => {
+            const updated = { ...previous };
+            for (const [field, values] of Object.entries(fieldValues)) {
+                const currentValue = updated[field];
+                if (currentValue === undefined) {
+                    // Create new list with the values
+                    updated[field] = [...values];
+                }
+                else {
+                    if (!Array.isArray(currentValue)) {
+                        throw new Error(`Field "${field}" is not a list`);
+                    }
+                    // Prepend to existing list
+                    updated[field] = [...values, ...currentValue];
+                }
+            }
+            return updated;
+        });
+    }
+    async peek(key, field) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'PEEK request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+        try {
+            const item = this.getStoredItem(key);
+            if (!item) {
+                this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'PEEK result: key not found', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+                return undefined;
+            }
+            const fieldValue = item.data[field];
+            if (fieldValue === undefined) {
+                this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'PEEK result: field not found', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+                return undefined;
+            }
+            if (!Array.isArray(fieldValue)) {
+                this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'PEEK result: not a list', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+                return undefined;
+            }
+            if (fieldValue.length === 0) {
+                this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'PEEK result: empty list', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+                return undefined;
+            }
+            const firstElement = fieldValue[0];
+            this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'PEEK result', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+            return firstElement;
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'PEEK failed', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key, error });
+            return undefined;
+        }
+    }
+    async peekMulti(key, fieldCounts) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'PEEK_MULTI request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+        const result = {};
+        try {
+            const item = this.getStoredItem(key);
+            if (!item) {
+                // Return empty arrays for all fields
+                for (const field of Object.keys(fieldCounts)) {
+                    result[field] = [];
+                }
+                return result;
+            }
+            for (const [field, count] of Object.entries(fieldCounts)) {
+                const fieldValue = item.data[field];
+                if (fieldValue === undefined || !Array.isArray(fieldValue)) {
+                    result[field] = [];
+                    continue;
+                }
+                const actualCount = Math.min(count, fieldValue.length);
+                result[field] = fieldValue.slice(0, actualCount);
+            }
+            this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'PEEK_MULTI result', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+            return result;
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'PEEK_MULTI failed', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key, error });
+            // Return empty arrays for all fields on error
+            for (const field of Object.keys(fieldCounts)) {
+                result[field] = [];
+            }
+            return result;
+        }
+    }
+    async append(key, field, value) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'APPEND request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        await this.patch(key, (previous) => {
+            const currentValue = previous[field];
+            if (currentValue === undefined) {
+                // Create new list with the value
+                return {
+                    ...previous,
+                    [field]: [value],
+                };
+            }
+            if (!Array.isArray(currentValue)) {
+                throw new Error(`Field "${field}" is not a list`);
+            }
+            // Append to existing list
+            return {
+                ...previous,
+                [field]: [...currentValue, value],
+            };
+        });
+    }
+    async appendMulti(key, fieldValues) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'APPEND_MULTI request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        await this.patch(key, (previous) => {
+            const updated = { ...previous };
+            for (const [field, values] of Object.entries(fieldValues)) {
+                const currentValue = updated[field];
+                if (currentValue === undefined) {
+                    // Create new list with the values
+                    updated[field] = [...values];
+                }
+                else {
+                    if (!Array.isArray(currentValue)) {
+                        throw new Error(`Field "${field}" is not a list`);
+                    }
+                    // Append to existing list
+                    updated[field] = [...currentValue, ...values];
+                }
+            }
+            return updated;
+        });
+    }
+    // ===================================================================================================================
+    // NumberSet Operations
+    // ===================================================================================================================
+    async addNumber(key, field, value) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'ADD_NUMBER request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        let wasAdded = false;
+        await this.patch(key, (previous) => {
+            const currentValue = previous[field];
+            if (currentValue === undefined) {
+                // Create new NumberSet with the value
+                const newSet = new NumberSet_1.NumberSet([value]);
+                wasAdded = true;
+                return {
+                    ...previous,
+                    [field]: newSet,
+                };
+            }
+            if (!(currentValue instanceof NumberSet_1.NumberSet)) {
+                throw new Error(`Field "${field}" is not a NumberSet`);
+            }
+            // Check if value already exists
+            wasAdded = !currentValue.has(value);
+            if (wasAdded) {
+                // Create new NumberSet with added value
+                const newSet = new NumberSet_1.NumberSet(currentValue);
+                newSet.add(value);
+                return {
+                    ...previous,
+                    [field]: newSet,
+                };
+            }
+            return previous;
+        });
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'ADD_NUMBER result', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        return wasAdded;
+    }
+    async addNumberMulti(key, fieldValues) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'ADD_NUMBER_MULTI request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        const addedValues = {};
+        await this.patch(key, (previous) => {
+            const updated = { ...previous };
+            for (const [field, values] of Object.entries(fieldValues)) {
+                const currentValue = updated[field];
+                const newlyAdded = new NumberSet_1.NumberSet();
+                if (currentValue === undefined) {
+                    // Create new NumberSet with all values
+                    const newSet = new NumberSet_1.NumberSet(values);
+                    updated[field] = newSet;
+                    addedValues[field] = new NumberSet_1.NumberSet(values);
+                }
+                else {
+                    if (!(currentValue instanceof NumberSet_1.NumberSet)) {
+                        throw new Error(`Field "${field}" is not a NumberSet`);
+                    }
+                    // Create new NumberSet and track newly added values
+                    const newSet = new NumberSet_1.NumberSet(currentValue);
+                    for (const value of values) {
+                        if (!newSet.has(value)) {
+                            newSet.add(value);
+                            newlyAdded.add(value);
+                        }
+                    }
+                    updated[field] = newSet;
+                    addedValues[field] = newlyAdded;
+                }
+            }
+            return updated;
+        });
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'ADD_NUMBER_MULTI result', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        return addedValues;
+    }
+    async removeNumber(key, field, value) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'REMOVE_NUMBER request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        let wasRemoved = false;
+        await this.patch(key, (previous) => {
+            const currentValue = previous[field];
+            if (currentValue === undefined) {
+                return previous;
+            }
+            if (!(currentValue instanceof NumberSet_1.NumberSet)) {
+                throw new Error(`Field "${field}" is not a NumberSet`);
+            }
+            // Check if value exists
+            wasRemoved = currentValue.has(value);
+            if (wasRemoved) {
+                // Create new NumberSet with removed value
+                const newSet = new NumberSet_1.NumberSet(currentValue);
+                newSet.delete(value);
+                return {
+                    ...previous,
+                    [field]: newSet,
+                };
+            }
+            return previous;
+        });
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'REMOVE_NUMBER result', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        return wasRemoved;
+    }
+    async removeNumberMulti(key, fieldValues) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'REMOVE_NUMBER_MULTI request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        const removedValues = {};
+        await this.patch(key, (previous) => {
+            const updated = { ...previous };
+            for (const [field, values] of Object.entries(fieldValues)) {
+                const currentValue = updated[field];
+                const actuallyRemoved = new NumberSet_1.NumberSet();
+                if (currentValue === undefined) {
+                    removedValues[field] = actuallyRemoved;
+                    continue;
+                }
+                if (!(currentValue instanceof NumberSet_1.NumberSet)) {
+                    throw new Error(`Field "${field}" is not a NumberSet`);
+                }
+                // Create new NumberSet and track removed values
+                const newSet = new NumberSet_1.NumberSet(currentValue);
+                for (const value of values) {
+                    if (newSet.has(value)) {
+                        newSet.delete(value);
+                        actuallyRemoved.add(value);
+                    }
+                }
+                updated[field] = newSet;
+                removedValues[field] = actuallyRemoved;
+            }
+            return updated;
+        });
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'REMOVE_NUMBER_MULTI result', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        return removedValues;
+    }
+    async hasNumber(key, field, value) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'HAS_NUMBER request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+        try {
+            const item = this.getStoredItem(key);
+            if (!item) {
+                this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'HAS_NUMBER result: key not found', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+                return false;
+            }
+            const fieldValue = item.data[field];
+            if (fieldValue === undefined) {
+                this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'HAS_NUMBER result: field not found', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+                return false;
+            }
+            if (!(fieldValue instanceof NumberSet_1.NumberSet)) {
+                throw new Error(`Field "${field}" is not a NumberSet`);
+            }
+            const hasValue = fieldValue.has(value);
+            this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'HAS_NUMBER result', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+            return hasValue;
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'HAS_NUMBER failed', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key, error });
+            throw error;
+        }
+    }
+    async hasNumberMulti(key, fieldValues) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'HAS_NUMBER_MULTI request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+        const result = {};
+        try {
+            const item = this.getStoredItem(key);
+            if (!item) {
+                // Return empty NumberSets for all fields
+                for (const field of Object.keys(fieldValues)) {
+                    result[field] = new NumberSet_1.NumberSet();
+                }
+                return result;
+            }
+            for (const [field, values] of Object.entries(fieldValues)) {
+                const fieldValue = item.data[field];
+                const existingValues = new NumberSet_1.NumberSet();
+                if (fieldValue === undefined) {
+                    result[field] = existingValues;
+                    continue;
+                }
+                if (!(fieldValue instanceof NumberSet_1.NumberSet)) {
+                    throw new Error(`Field "${field}" is not a NumberSet`);
+                }
+                // Check which values exist
+                for (const value of values) {
+                    if (fieldValue.has(value)) {
+                        existingValues.add(value);
+                    }
+                }
+                result[field] = existingValues;
+            }
+            this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'HAS_NUMBER_MULTI result', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+            return result;
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'HAS_NUMBER_MULTI failed', {
+                id: key || 'unknown',
+                store: 'LocalKVStore',
+                operation: 'get',
+                key,
+                error
+            });
+            throw error;
+        }
+    }
+    // ===================================================================================================================
+    // StringSet Operations
+    // ===================================================================================================================
+    async addString(key, field, value) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'ADD_STRING request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        let wasAdded = false;
+        await this.patch(key, (previous) => {
+            const currentValue = previous[field];
+            if (currentValue === undefined) {
+                // Create new StringSet with the value
+                const newSet = new StringSet_1.StringSet([value]);
+                wasAdded = true;
+                return {
+                    ...previous,
+                    [field]: newSet,
+                };
+            }
+            if (!(currentValue instanceof StringSet_1.StringSet)) {
+                throw new Error(`Field "${field}" is not a StringSet`);
+            }
+            // Check if value already exists
+            wasAdded = !currentValue.has(value);
+            if (wasAdded) {
+                // Create new StringSet with added value
+                const newSet = new StringSet_1.StringSet(currentValue);
+                newSet.add(value);
+                return {
+                    ...previous,
+                    [field]: newSet,
+                };
+            }
+            return previous;
+        });
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'ADD_STRING result', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        return wasAdded;
+    }
+    async addStringMulti(key, fieldValues) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'ADD_STRING_MULTI request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        const addedValues = {};
+        await this.patch(key, (previous) => {
+            const updated = { ...previous };
+            for (const [field, values] of Object.entries(fieldValues)) {
+                const currentValue = updated[field];
+                const newlyAdded = new StringSet_1.StringSet();
+                if (currentValue === undefined) {
+                    // Create new StringSet with all values
+                    const newSet = new StringSet_1.StringSet(values);
+                    updated[field] = newSet;
+                    addedValues[field] = new StringSet_1.StringSet(values);
+                }
+                else {
+                    if (!(currentValue instanceof StringSet_1.StringSet)) {
+                        throw new Error(`Field "${field}" is not a StringSet`);
+                    }
+                    // Create new StringSet and track newly added values
+                    const newSet = new StringSet_1.StringSet(currentValue);
+                    for (const value of values) {
+                        if (!newSet.has(value)) {
+                            newSet.add(value);
+                            newlyAdded.add(value);
+                        }
+                    }
+                    updated[field] = newSet;
+                    addedValues[field] = newlyAdded;
+                }
+            }
+            return updated;
+        });
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'ADD_STRING_MULTI result', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        return addedValues;
+    }
+    async removeString(key, field, value) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'REMOVE_STRING request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        let wasRemoved = false;
+        await this.patch(key, (previous) => {
+            const currentValue = previous[field];
+            if (currentValue === undefined) {
+                return previous;
+            }
+            if (!(currentValue instanceof StringSet_1.StringSet)) {
+                throw new Error(`Field "${field}" is not a StringSet`);
+            }
+            // Check if value exists
+            wasRemoved = currentValue.has(value);
+            if (wasRemoved) {
+                // Create new StringSet with removed value
+                const newSet = new StringSet_1.StringSet(currentValue);
+                newSet.delete(value);
+                return {
+                    ...previous,
+                    [field]: newSet,
+                };
+            }
+            return previous;
+        });
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'REMOVE_STRING result', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        return wasRemoved;
+    }
+    async removeStringMulti(key, fieldValues) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'REMOVE_STRING_MULTI request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        const removedValues = {};
+        await this.patch(key, (previous) => {
+            const updated = { ...previous };
+            for (const [field, values] of Object.entries(fieldValues)) {
+                const currentValue = updated[field];
+                const actuallyRemoved = new StringSet_1.StringSet();
+                if (currentValue === undefined) {
+                    removedValues[field] = actuallyRemoved;
+                    continue;
+                }
+                if (!(currentValue instanceof StringSet_1.StringSet)) {
+                    throw new Error(`Field "${field}" is not a StringSet`);
+                }
+                // Create new StringSet and track removed values
+                const newSet = new StringSet_1.StringSet(currentValue);
+                for (const value of values) {
+                    if (newSet.has(value)) {
+                        newSet.delete(value);
+                        actuallyRemoved.add(value);
+                    }
+                }
+                updated[field] = newSet;
+                removedValues[field] = actuallyRemoved;
+            }
+            return updated;
+        });
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'REMOVE_STRING_MULTI result', { id: key || 'unknown', store: 'LocalKVStore', operation: 'set', key });
+        return removedValues;
+    }
+    async hasString(key, field, value) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'HAS_STRING request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+        try {
+            const item = this.getStoredItem(key);
+            if (!item) {
+                this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'HAS_STRING result: key not found', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+                return false;
+            }
+            const fieldValue = item.data[field];
+            if (fieldValue === undefined) {
+                this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'HAS_STRING result: field not found', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+                return false;
+            }
+            if (!(fieldValue instanceof StringSet_1.StringSet)) {
+                throw new Error(`Field "${field}" is not a StringSet`);
+            }
+            const hasValue = fieldValue.has(value);
+            this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'HAS_STRING result', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+            return hasValue;
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'HAS_STRING failed', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key, error });
+            throw error;
+        }
+    }
+    async hasStringMulti(key, fieldValues) {
+        this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'HAS_STRING_MULTI request', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+        const result = {};
+        try {
+            const item = this.getStoredItem(key);
+            if (!item) {
+                // Return empty StringSets for all fields
+                for (const field of Object.keys(fieldValues)) {
+                    result[field] = new StringSet_1.StringSet();
+                }
+                return result;
+            }
+            for (const [field, values] of Object.entries(fieldValues)) {
+                const fieldValue = item.data[field];
+                const existingValues = new StringSet_1.StringSet();
+                if (fieldValue === undefined) {
+                    result[field] = existingValues;
+                    continue;
+                }
+                if (!(fieldValue instanceof StringSet_1.StringSet)) {
+                    throw new Error(`Field "${field}" is not a StringSet`);
+                }
+                // Check which values exist
+                for (const value of values) {
+                    if (fieldValue.has(value)) {
+                        existingValues.add(value);
+                    }
+                }
+                result[field] = existingValues;
+            }
+            this.logManager.debug(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'HAS_STRING_MULTI result', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key });
+            return result;
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, 'HAS_STRING_MULTI failed', { id: key || 'unknown', store: 'LocalKVStore', operation: 'get', key, error });
+            throw error;
+        }
+    }
+    // ===================================================================================================================
+    // Helper Methods for API
+    // ===================================================================================================================
+    /**
+     * Get all stored data as a simple key-value object for the UI
+     */
+    getAllData() {
+        try {
+            const storeData = this.loadDataFromDisk();
+            const result = {};
+            for (const [key, item] of Object.entries(storeData)) {
+                result[key] = this.deserializeValue(item.data);
+            }
+            return result;
+        }
+        catch (error) {
+            this.logManager.warn(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, "Failed to get all KV data:", {
+                id: 'all',
+                store: 'LocalKVStore',
+                operation: 'get',
+                error
+            });
+            return {};
+        }
+    }
+    /**
+     * Set a simple key-value pair (for UI convenience)
+     */
+    async set(key, value) {
+        await this.put(key, value);
+    }
+    /**
+     * Get a simple value by key (for UI convenience)
+     */
+    async getValue(key) {
+        const result = await this.get(key);
+        return result.value;
+    }
+    /**
+     * Delete a key entirely (for UI convenience)
+     */
+    async deleteKey(key) {
+        const storeData = this.loadDataFromDisk();
+        if (key in storeData) {
+            delete storeData[key];
+            this.saveDataToDisk(storeData);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get all keys
+     */
+    getAllKeys() {
+        try {
+            const storeData = this.loadDataFromDisk();
+            return Object.keys(storeData);
+        }
+        catch (error) {
+            this.logManager.warn(LogManager_1.LogSource.System, LogManager_1.LogCategory.KVStore, "Failed to get all KV keys:", {
+                id: 'all',
+                store: 'LocalKVStore',
+                operation: 'list',
+                error
+            });
+            return [];
+        }
+    }
+    /**
+     * Get a shared instance for shared KV store (global across installations of the same app)
+     */
+    static getSharedInstance(appRootDir) {
+        // Use the same app directory but with a different filename for shared storage
+        return LocalKVStore.getInstance(appRootDir, "shared-kvstore.json");
+    }
+}
+exports.LocalKVStore = LocalKVStore;
+LocalKVStore.instances = new Map();
+//# sourceMappingURL=LocalKVStore.js.map