@supernal/interface 1.0.0

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

@@ -0,0 +1,299 @@
+"use strict";
+/**
+ * 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()
+ * );
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StateManager = void 0;
+/**
+ * Named State Manager with plugin storage
+ */
+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`);
+        }
+    }
+}
+exports.StateManager = StateManager;
+/**
+ * Registry of named StateManager instances
+ */
+StateManager.instances = new Map();
+//# sourceMappingURL=StateManager.js.map

package/dist/cjs/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/cjs/src/storage/StorageAdapter.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * Storage Adapter Interface
+ *
+ * Defines the contract for environment-specific persistence.
+ * Implementations include:
+ * - LocalStorageAdapter (browser)
+ * - ChromeStorageAdapter (Chrome MV3)
+ * - FileStorageAdapter (Node.js)
+ * - MemoryStorageAdapter (testing)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryStorageAdapter = exports.ChromeStorageAdapter = exports.LocalStorageAdapter = void 0;
+/**
+ * LocalStorage adapter for browser environments
+ */
+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));
+    }
+}
+exports.LocalStorageAdapter = LocalStorageAdapter;
+/**
+ * Chrome Storage adapter for Chrome Extension MV3
+ * CRITICAL: Must be imported only in extension context
+ */
+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);
+    }
+}
+exports.ChromeStorageAdapter = ChromeStorageAdapter;
+/**
+ * Memory Storage adapter for testing
+ * In-memory implementation that doesn't persist
+ * Deep clones values to prevent mutations
+ */
+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);
+        }
+    }
+}
+exports.MemoryStorageAdapter = MemoryStorageAdapter;
+//# sourceMappingURL=StorageAdapter.js.map

package/dist/cjs/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/cjs/src/storage/index.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * 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';
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryStorageAdapter = exports.ChromeStorageAdapter = exports.LocalStorageAdapter = void 0;
+// Export browser-safe adapters
+var StorageAdapter_1 = require("./StorageAdapter");
+Object.defineProperty(exports, "LocalStorageAdapter", { enumerable: true, get: function () { return StorageAdapter_1.LocalStorageAdapter; } });
+Object.defineProperty(exports, "ChromeStorageAdapter", { enumerable: true, get: function () { return StorageAdapter_1.ChromeStorageAdapter; } });
+Object.defineProperty(exports, "MemoryStorageAdapter", { enumerable: true, get: function () { return StorageAdapter_1.MemoryStorageAdapter; } });
+// Export StateManager
+__exportStar(require("./StateManager"), exports);
+// 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/cjs/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,mDAK0B;AAHxB,qHAAA,mBAAmB,OAAA;AACnB,sHAAA,oBAAoB,OAAA;AACpB,sHAAA,oBAAoB,OAAA;AAGtB,sBAAsB;AACtB,iDAA+B;AAE/B,kEAAkE;AAClE,sCAAsC;AACtC,yGAAyG"}

package/dist/cjs/src/testing/BrowserStateInjection.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * Browser State Injection - Test Utilities
+ *
+ * Provides mechanism for E2E tests to set and read component state
+ * in the browser context. Only active in test environments.
+ *
+ * @module BrowserStateInjection
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeTestStateManager = initializeTestStateManager;
+exports.getTestStateManager = getTestStateManager;
+/**
+ * Test state manager implementation
+ * Available as window.__testState__ in test environments
+ */
+class BrowserTestStateManager {
+    constructor() {
+        this.eventPrefix = 'test:';
+    }
+    setState(component, state) {
+        if (typeof window === 'undefined') {
+            throw new Error('setState can only be called in browser context');
+        }
+        const event = new CustomEvent(`${this.eventPrefix}setState`, {
+            detail: { component, state },
+            bubbles: false,
+            cancelable: false,
+        });
+        window.dispatchEvent(event);
+        // Also log for debugging
+        if (process.env.NODE_ENV === 'test') {
+            console.log(`[TEST] setState: ${component}`, state);
+        }
+    }
+    getState(component) {
+        if (typeof window === 'undefined') {
+            throw new Error('getState can only be called in browser context');
+        }
+        // Find element by component name
+        const element = document.querySelector(`[data-component="${component}"]`);
+        if (!element) {
+            return undefined;
+        }
+        // Read state from data-state attribute
+        const stateAttr = element.getAttribute('data-state');
+        if (!stateAttr) {
+            return undefined;
+        }
+        try {
+            return JSON.parse(stateAttr);
+        }
+        catch (error) {
+            console.error(`[TEST] Failed to parse state for ${component}:`, error);
+            return undefined;
+        }
+    }
+    async waitForComponent(component, timeoutMs = 5000) {
+        if (typeof window === 'undefined') {
+            throw new Error('waitForComponent can only be called in browser context');
+        }
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeoutMs) {
+            const element = document.querySelector(`[data-component="${component}"]`);
+            if (element) {
+                // Component element exists, wait a bit for React to initialize
+                await new Promise(resolve => setTimeout(resolve, 100));
+                return;
+            }
+            await new Promise(resolve => setTimeout(resolve, 100));
+        }
+        throw new Error(`Component '${component}' not found after ${timeoutMs}ms`);
+    }
+    resetState(component) {
+        if (typeof window === 'undefined') {
+            throw new Error('resetState can only be called in browser context');
+        }
+        const event = new CustomEvent(`${this.eventPrefix}resetState`, {
+            detail: { component },
+            bubbles: false,
+            cancelable: false,
+        });
+        window.dispatchEvent(event);
+        if (process.env.NODE_ENV === 'test') {
+            console.log(`[TEST] resetState: ${component}`);
+        }
+    }
+    hasComponent(component) {
+        if (typeof window === 'undefined') {
+            return false;
+        }
+        const element = document.querySelector(`[data-component="${component}"]`);
+        return !!element;
+    }
+}
+/**
+ * Initialize test state manager on window
+ * Only runs in test environment
+ */
+function initializeTestStateManager() {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    // Only initialize in test environment
+    if (process.env.NODE_ENV !== 'test') {
+        return;
+    }
+    // Check if already initialized
+    if (window.__testState__) {
+        return;
+    }
+    // Create and expose test state manager
+    window.__testState__ = new BrowserTestStateManager();
+    console.log('[TEST] Browser state injection initialized');
+}
+/**
+ * Get test state manager from window
+ * Returns undefined if not in browser or not test environment
+ */
+function getTestStateManager() {
+    if (typeof window === 'undefined') {
+        return undefined;
+    }
+    return window.__testState__;
+}
+// Auto-initialize in test environment
+if (typeof window !== 'undefined' && process.env.NODE_ENV === 'test') {
+    initializeTestStateManager();
+}
+//# sourceMappingURL=BrowserStateInjection.js.map

package/dist/cjs/src/testing/BrowserStateInjection.js.map

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