@supernal/interface 1.0.0

package/dist/esm/src/storage/StateManager.js

@@ -0,0 +1,295 @@
+/**
+ * State Manager
+ *
+ * Hierarchical state management with named instances and pluggable storage adapters.
+ *
+ * Key Features:
+ * - Named instances for multi-context support
+ * - Plugin storage adapters (MV3-safe)
+ * - Path-based state access
+ * - Subscription system
+ * - No default adapter (must be injected)
+ *
+ * @example
+ * ```typescript
+ * // Browser
+ * const state = StateManager.getInstance(
+ *   StateManagers.SupernalCoreV1,
+ *   new LocalStorageAdapter()
+ * );
+ *
+ * // Chrome Extension MV3
+ * const state = StateManager.getInstance(
+ *   StateManagers.SupernalCoreV1,
+ *   new ChromeStorageAdapter()
+ * );
+ *
+ * // Testing
+ * const state = StateManager.getInstance(
+ *   StateManagers.Testing,
+ *   new MemoryStorageAdapter()
+ * );
+ * ```
+ */
+/**
+ * Named State Manager with plugin storage
+ */
+export class StateManager {
+    /**
+     * Private constructor (use getInstance)
+     */
+    constructor(name, adapter, options = {}) {
+        /**
+         * In-memory state cache
+         */
+        this.state = new Map();
+        /**
+         * Subscribers for state changes
+         */
+        this.subscribers = new Map();
+        /**
+         * Save timeout for debouncing
+         */
+        this.saveTimeout = null;
+        this.name = name;
+        this.adapter = adapter;
+        this.options = {
+            autoSave: options.autoSave ?? true,
+            saveDebounce: options.saveDebounce ?? 100,
+            debug: options.debug ?? false,
+        };
+    }
+    /**
+     * Get or create a named StateManager instance
+     *
+     * CRITICAL: Storage adapter MUST be provided. No default adapter.
+     *
+     * @param name The StateManager name
+     * @param adapter The storage adapter to use
+     * @param options Optional configuration
+     */
+    static getInstance(name, adapter, options) {
+        if (!StateManager.instances.has(name)) {
+            StateManager.instances.set(name, new StateManager(name, adapter, options));
+        }
+        return StateManager.instances.get(name);
+    }
+    /**
+     * Clear all instances (useful for testing)
+     */
+    static clearAllInstances() {
+        StateManager.instances.clear();
+    }
+    /**
+     * Get instance name
+     */
+    getName() {
+        return this.name;
+    }
+    /**
+     * Initialize from storage
+     * Loads persisted state into memory
+     */
+    async initialize() {
+        try {
+            const keys = await this.adapter.keys();
+            const stateKeys = keys.filter(k => k.startsWith(`${this.name}:state:`));
+            for (const key of stateKeys) {
+                const componentId = key.replace(`${this.name}:state:`, '');
+                const state = await this.adapter.get(key);
+                if (state) {
+                    this.state.set(componentId, state);
+                }
+            }
+            if (this.options.debug) {
+                console.log(`[StateManager:${this.name}] Initialized with ${this.state.size} states`);
+            }
+        }
+        catch (err) {
+            console.error(`[StateManager:${this.name}] Failed to initialize:`, err);
+            throw err;
+        }
+    }
+    /**
+     * Get component state by ID
+     */
+    async get(componentId) {
+        // Check memory cache first
+        if (this.state.has(componentId)) {
+            return this.state.get(componentId);
+        }
+        // Check storage
+        const key = `${this.name}:state:${componentId}`;
+        const state = await this.adapter.get(key);
+        if (state) {
+            this.state.set(componentId, state);
+            return state;
+        }
+        return null;
+    }
+    /**
+     * Set component state
+     */
+    async set(componentId, state) {
+        const prevState = this.state.get(componentId) ?? null;
+        // Update memory cache
+        this.state.set(componentId, state);
+        // Notify subscribers
+        this.notifySubscribers(componentId, state, prevState);
+        // Auto-save if enabled
+        if (this.options.autoSave) {
+            this.scheduleSave(componentId, state);
+        }
+        if (this.options.debug) {
+            console.log(`[StateManager:${this.name}] Set state for ${componentId}`, state);
+        }
+    }
+    /**
+     * Merge partial state (shallow merge)
+     */
+    async merge(componentId, partialState) {
+        const currentState = await this.get(componentId);
+        if (!currentState) {
+            throw new Error(`Cannot merge: no state found for component ${componentId}`);
+        }
+        const newState = { ...currentState, ...partialState };
+        await this.set(componentId, newState);
+    }
+    /**
+     * Delete component state
+     */
+    async delete(componentId) {
+        const prevState = this.state.get(componentId) ?? null;
+        // Remove from memory
+        this.state.delete(componentId);
+        // Remove from storage
+        const key = `${this.name}:state:${componentId}`;
+        await this.adapter.delete(key);
+        // Notify subscribers
+        this.notifySubscribers(componentId, null, prevState);
+        if (this.options.debug) {
+            console.log(`[StateManager:${this.name}] Deleted state for ${componentId}`);
+        }
+    }
+    /**
+     * Restore state from storage (force refresh)
+     */
+    async restore(componentId) {
+        const key = `${this.name}:state:${componentId}`;
+        const state = await this.adapter.get(key);
+        if (state) {
+            this.state.set(componentId, state);
+            this.notifySubscribers(componentId, state, null);
+        }
+        return state;
+    }
+    /**
+     * Subscribe to state changes for a component
+     */
+    subscribe(componentId, callback) {
+        if (!this.subscribers.has(componentId)) {
+            this.subscribers.set(componentId, new Set());
+        }
+        this.subscribers.get(componentId).add(callback);
+        if (this.options.debug) {
+            console.log(`[StateManager:${this.name}] Subscribed to ${componentId}`);
+        }
+        return {
+            unsubscribe: () => {
+                const subs = this.subscribers.get(componentId);
+                if (subs) {
+                    subs.delete(callback);
+                    if (subs.size === 0) {
+                        this.subscribers.delete(componentId);
+                    }
+                }
+            },
+        };
+    }
+    /**
+     * Get all component IDs
+     */
+    async keys() {
+        return Array.from(this.state.keys());
+    }
+    /**
+     * Get all states
+     */
+    async getAll() {
+        return new Map(this.state);
+    }
+    /**
+     * Clear all state (memory + storage)
+     */
+    async clear() {
+        const keys = await this.adapter.keys();
+        const stateKeys = keys.filter(k => k.startsWith(`${this.name}:state:`));
+        for (const key of stateKeys) {
+            await this.adapter.delete(key);
+        }
+        this.state.clear();
+        this.subscribers.clear();
+        if (this.options.debug) {
+            console.log(`[StateManager:${this.name}] Cleared all state`);
+        }
+    }
+    /**
+     * Notify subscribers of state changes
+     */
+    notifySubscribers(componentId, state, prevState) {
+        const subs = this.subscribers.get(componentId);
+        if (subs) {
+            subs.forEach(callback => {
+                try {
+                    callback(state, prevState);
+                }
+                catch (err) {
+                    console.error(`[StateManager:${this.name}] Subscriber error:`, err);
+                }
+            });
+        }
+    }
+    /**
+     * Schedule a save with debouncing
+     */
+    scheduleSave(componentId, state) {
+        if (this.saveTimeout) {
+            clearTimeout(this.saveTimeout);
+        }
+        this.saveTimeout = setTimeout(async () => {
+            const key = `${this.name}:state:${componentId}`;
+            try {
+                await this.adapter.set(key, state);
+                if (this.options.debug) {
+                    console.log(`[StateManager:${this.name}] Saved state for ${componentId}`);
+                }
+            }
+            catch (err) {
+                console.error(`[StateManager:${this.name}] Failed to save state:`, err);
+            }
+        }, this.options.saveDebounce);
+    }
+    /**
+     * Flush pending saves immediately
+     */
+    async flush() {
+        if (this.saveTimeout) {
+            clearTimeout(this.saveTimeout);
+            this.saveTimeout = null;
+        }
+        // Save all current states
+        const saves = Array.from(this.state.entries()).map(async ([componentId, state]) => {
+            const key = `${this.name}:state:${componentId}`;
+            await this.adapter.set(key, state);
+        });
+        await Promise.all(saves);
+        if (this.options.debug) {
+            console.log(`[StateManager:${this.name}] Flushed ${saves.length} states`);
+        }
+    }
+}
+/**
+ * Registry of named StateManager instances
+ */
+StateManager.instances = new Map();
+//# sourceMappingURL=StateManager.js.map

package/dist/esm/src/storage/StateManager.js.map

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

package/dist/esm/src/storage/StorageAdapter.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Storage Adapter Interface
+ *
+ * Defines the contract for environment-specific persistence.
+ * Implementations include:
+ * - LocalStorageAdapter (browser)
+ * - ChromeStorageAdapter (Chrome MV3)
+ * - FileStorageAdapter (Node.js)
+ * - MemoryStorageAdapter (testing)
+ */
+/**
+ * Storage adapter interface for environment-agnostic persistence
+ */
+export interface StorageAdapter {
+    /**
+     * Get a value by key
+     * @param key The storage key
+     * @returns The stored value or null if not found
+     */
+    get(key: string): Promise<any>;
+    /**
+     * Set a value for a key
+     * @param key The storage key
+     * @param value The value to store
+     */
+    set(key: string, value: any): Promise<void>;
+    /**
+     * Delete a key
+     * @param key The storage key
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Get all keys
+     * @returns Array of all storage keys
+     */
+    keys(): Promise<string[]>;
+    /**
+     * Clear all storage
+     */
+    clear?(): Promise<void>;
+    /**
+     * Get multiple keys at once (optional optimization)
+     */
+    getMultiple?(keys: string[]): Promise<Record<string, any>>;
+    /**
+     * Set multiple keys at once (optional optimization)
+     */
+    setMultiple?(entries: Record<string, any>): Promise<void>;
+}
+/**
+ * LocalStorage adapter for browser environments
+ */
+export declare class LocalStorageAdapter implements StorageAdapter {
+    private prefix;
+    constructor(prefix?: string);
+    get(key: string): Promise<any>;
+    set(key: string, value: any): Promise<void>;
+    delete(key: string): Promise<void>;
+    keys(): Promise<string[]>;
+    clear(): Promise<void>;
+}
+/**
+ * Chrome Storage adapter for Chrome Extension MV3
+ * CRITICAL: Must be imported only in extension context
+ */
+export declare class ChromeStorageAdapter implements StorageAdapter {
+    private prefix;
+    constructor(prefix?: string);
+    get(key: string): Promise<any>;
+    set(key: string, value: any): Promise<void>;
+    delete(key: string): Promise<void>;
+    keys(): Promise<string[]>;
+    clear(): Promise<void>;
+    getMultiple(keys: string[]): Promise<Record<string, any>>;
+    setMultiple(entries: Record<string, any>): Promise<void>;
+}
+/**
+ * Memory Storage adapter for testing
+ * In-memory implementation that doesn't persist
+ * Deep clones values to prevent mutations
+ */
+export declare class MemoryStorageAdapter implements StorageAdapter {
+    private storage;
+    private prefix;
+    constructor(prefix?: string);
+    get(key: string): Promise<any>;
+    set(key: string, value: any): Promise<void>;
+    delete(key: string): Promise<void>;
+    keys(): Promise<string[]>;
+    clear(): Promise<void>;
+    getMultiple(keys: string[]): Promise<Record<string, any>>;
+    setMultiple(entries: Record<string, any>): Promise<void>;
+}
+//# sourceMappingURL=StorageAdapter.d.ts.map

package/dist/esm/src/storage/StorageAdapter.d.ts.map

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

package/dist/esm/src/storage/StorageAdapter.js

@@ -0,0 +1,158 @@
+/**
+ * Storage Adapter Interface
+ *
+ * Defines the contract for environment-specific persistence.
+ * Implementations include:
+ * - LocalStorageAdapter (browser)
+ * - ChromeStorageAdapter (Chrome MV3)
+ * - FileStorageAdapter (Node.js)
+ * - MemoryStorageAdapter (testing)
+ */
+/**
+ * LocalStorage adapter for browser environments
+ */
+export class LocalStorageAdapter {
+    constructor(prefix = 'supernal:') {
+        this.prefix = prefix;
+    }
+    async get(key) {
+        const item = localStorage.getItem(this.prefix + key);
+        if (item === null)
+            return null;
+        try {
+            return JSON.parse(item);
+        }
+        catch {
+            return item;
+        }
+    }
+    async set(key, value) {
+        localStorage.setItem(this.prefix + key, JSON.stringify(value));
+    }
+    async delete(key) {
+        localStorage.removeItem(this.prefix + key);
+    }
+    async keys() {
+        const allKeys = [];
+        for (let i = 0; i < localStorage.length; i++) {
+            const key = localStorage.key(i);
+            if (key && key.startsWith(this.prefix)) {
+                allKeys.push(key.substring(this.prefix.length));
+            }
+        }
+        return allKeys;
+    }
+    async clear() {
+        const keysToRemove = await this.keys();
+        keysToRemove.forEach(key => localStorage.removeItem(this.prefix + key));
+    }
+}
+/**
+ * Chrome Storage adapter for Chrome Extension MV3
+ * CRITICAL: Must be imported only in extension context
+ */
+export class ChromeStorageAdapter {
+    constructor(prefix = 'supernal:') {
+        this.prefix = prefix;
+    }
+    async get(key) {
+        // Type assertion for chrome global
+        const chromeAPI = globalThis.chrome;
+        const result = await chromeAPI.storage.local.get(this.prefix + key);
+        return result[this.prefix + key] ?? null;
+    }
+    async set(key, value) {
+        const chromeAPI = globalThis.chrome;
+        await chromeAPI.storage.local.set({ [this.prefix + key]: value });
+    }
+    async delete(key) {
+        const chromeAPI = globalThis.chrome;
+        await chromeAPI.storage.local.remove(this.prefix + key);
+    }
+    async keys() {
+        const chromeAPI = globalThis.chrome;
+        const result = await chromeAPI.storage.local.get(null);
+        return Object.keys(result)
+            .filter(k => k.startsWith(this.prefix))
+            .map(k => k.substring(this.prefix.length));
+    }
+    async clear() {
+        const keysToRemove = (await this.keys()).map(k => this.prefix + k);
+        const chromeAPI = globalThis.chrome;
+        await chromeAPI.storage.local.remove(keysToRemove);
+    }
+    async getMultiple(keys) {
+        const prefixedKeys = keys.map(k => this.prefix + k);
+        const chromeAPI = globalThis.chrome;
+        const result = await chromeAPI.storage.local.get(prefixedKeys);
+        // Remove prefix from keys in result
+        const unprefixed = {};
+        for (const [key, value] of Object.entries(result)) {
+            const unprefixedKey = key.substring(this.prefix.length);
+            unprefixed[unprefixedKey] = value;
+        }
+        return unprefixed;
+    }
+    async setMultiple(entries) {
+        const prefixed = {};
+        for (const [key, value] of Object.entries(entries)) {
+            prefixed[this.prefix + key] = value;
+        }
+        const chromeAPI = globalThis.chrome;
+        await chromeAPI.storage.local.set(prefixed);
+    }
+}
+/**
+ * Memory Storage adapter for testing
+ * In-memory implementation that doesn't persist
+ * Deep clones values to prevent mutations
+ */
+export class MemoryStorageAdapter {
+    constructor(prefix = 'supernal:') {
+        this.storage = new Map();
+        this.prefix = prefix;
+    }
+    async get(key) {
+        const value = this.storage.get(this.prefix + key);
+        if (value === undefined)
+            return null;
+        // Deep clone to prevent mutations
+        return JSON.parse(JSON.stringify(value));
+    }
+    async set(key, value) {
+        // Deep clone to prevent mutations
+        this.storage.set(this.prefix + key, JSON.parse(JSON.stringify(value)));
+    }
+    async delete(key) {
+        this.storage.delete(this.prefix + key);
+    }
+    async keys() {
+        const allKeys = [];
+        for (const key of this.storage.keys()) {
+            if (key.startsWith(this.prefix)) {
+                allKeys.push(key.substring(this.prefix.length));
+            }
+        }
+        return allKeys;
+    }
+    async clear() {
+        const keysToRemove = await this.keys();
+        keysToRemove.forEach(key => this.storage.delete(this.prefix + key));
+    }
+    async getMultiple(keys) {
+        const result = {};
+        for (const key of keys) {
+            const value = await this.get(key);
+            if (value !== null) {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    async setMultiple(entries) {
+        for (const [key, value] of Object.entries(entries)) {
+            await this.set(key, value);
+        }
+    }
+}
+//# sourceMappingURL=StorageAdapter.js.map

package/dist/esm/src/storage/StorageAdapter.js.map

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

package/dist/esm/src/storage/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Storage System - Index File
+ *
+ * Exports storage adapters and StateManager
+ *
+ * NOTE: FileStorageAdapter is NOT exported here to avoid Node.js dependencies (fs/promises)
+ * in browser bundles. Import it directly if needed in Node.js environments:
+ * import { FileStorageAdapter } from '@supernal/interface-core/dist/esm/src/storage/FileStorageAdapter';
+ */
+export { StorageAdapter, LocalStorageAdapter, ChromeStorageAdapter, MemoryStorageAdapter } from './StorageAdapter';
+export * from './StateManager';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/src/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,kBAAkB,CAAC;AAG1B,cAAc,gBAAgB,CAAC"}

package/dist/esm/src/storage/index.js

@@ -0,0 +1,17 @@
+/**
+ * Storage System - Index File
+ *
+ * Exports storage adapters and StateManager
+ *
+ * NOTE: FileStorageAdapter is NOT exported here to avoid Node.js dependencies (fs/promises)
+ * in browser bundles. Import it directly if needed in Node.js environments:
+ * import { FileStorageAdapter } from '@supernal/interface-core/dist/esm/src/storage/FileStorageAdapter';
+ */
+// Export browser-safe adapters
+export { LocalStorageAdapter, ChromeStorageAdapter, MemoryStorageAdapter } from './StorageAdapter.js';
+// Export StateManager
+export * from './StateManager.js';
+// DO NOT export FileStorageAdapter here - it contains fs/promises
+// For Node.js usage, import directly:
+// import { FileStorageAdapter } from '@supernal/interface-core/dist/esm/src/storage/FileStorageAdapter';
+//# sourceMappingURL=index.js.map

package/dist/esm/src/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,+BAA+B;AAC/B,OAAO,EAEL,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,kBAAkB,CAAC;AAE1B,sBAAsB;AACtB,cAAc,gBAAgB,CAAC;AAE/B,kEAAkE;AAClE,sCAAsC;AACtC,yGAAyG"}