@hamak/ui-store 0.6.0 → 0.7.1

package/dist/impl/persistence/web-storage-persistence-provider.js

@@ -0,0 +1,155 @@
+/**
+ * Web Storage Persistence Provider
+ *
+ * Concrete `IPersistenceProvider` backed by a Web Storage area
+ * (`localStorage` / `sessionStorage`). When the backing storage is
+ * unavailable — SSR, private-mode quota errors, disabled storage — it
+ * degrades gracefully to an in-memory map so callers never throw. This mirrors
+ * the `createLocalStorageActiveProjectStorage` fallback pattern used
+ * downstream. See amah/app-framework#30.
+ */
+/** Default namespace every persisted key is prefixed with. */
+export const DEFAULT_PERSISTENCE_NAMESPACE = '@hamak/ui-store';
+const PROBE_KEY = '@hamak/ui-store:__persist_probe__';
+export class WebStoragePersistenceProvider {
+    /**
+     * @param storage   Backing web storage, or `null` to run in-memory only.
+     * @param namespace Key prefix; `clear()` only removes keys under this prefix
+     *                  so it never wipes unrelated app state.
+     */
+    constructor(storage, namespace = DEFAULT_PERSISTENCE_NAMESPACE) {
+        Object.defineProperty(this, "storage", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: storage
+        });
+        Object.defineProperty(this, "namespace", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: namespace
+        });
+        Object.defineProperty(this, "memory", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "available", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.available = WebStoragePersistenceProvider.probe(storage);
+    }
+    isAvailable() {
+        return this.available;
+    }
+    async save(key, state) {
+        const serialized = JSON.stringify(state);
+        const fullKey = this.fullKey(key);
+        if (this.available && this.storage) {
+            try {
+                this.storage.setItem(fullKey, serialized);
+                return;
+            }
+            catch (e) {
+                console.warn('[persistence] save failed, falling back to memory:', e);
+            }
+        }
+        this.memory.set(fullKey, serialized);
+    }
+    async load(key) {
+        const fullKey = this.fullKey(key);
+        let raw = null;
+        if (this.available && this.storage) {
+            try {
+                raw = this.storage.getItem(fullKey);
+            }
+            catch (e) {
+                console.warn('[persistence] load failed:', e);
+            }
+        }
+        if (raw == null) {
+            raw = this.memory.get(fullKey) ?? null;
+        }
+        if (raw == null)
+            return null;
+        try {
+            return JSON.parse(raw);
+        }
+        catch (e) {
+            console.warn('[persistence] could not parse persisted state:', e);
+            return null;
+        }
+    }
+    async remove(key) {
+        const fullKey = this.fullKey(key);
+        this.memory.delete(fullKey);
+        if (this.available && this.storage) {
+            try {
+                this.storage.removeItem(fullKey);
+            }
+            catch (e) {
+                console.warn('[persistence] remove failed:', e);
+            }
+        }
+    }
+    async clear() {
+        // Only remove keys under our namespace — never the whole storage area.
+        for (const memKey of [...this.memory.keys()]) {
+            if (memKey.startsWith(this.namespace))
+                this.memory.delete(memKey);
+        }
+        if (this.available && this.storage) {
+            try {
+                const toRemove = [];
+                for (let i = 0; i < this.storage.length; i++) {
+                    const k = this.storage.key(i);
+                    if (k && k.startsWith(this.namespace))
+                        toRemove.push(k);
+                }
+                toRemove.forEach((k) => this.storage.removeItem(k));
+            }
+            catch (e) {
+                console.warn('[persistence] clear failed:', e);
+            }
+        }
+    }
+    fullKey(key) {
+        return `${this.namespace}:${key}`;
+    }
+    /** Verify the storage area is usable with a write/remove round-trip. */
+    static probe(storage) {
+        if (!storage)
+            return false;
+        try {
+            storage.setItem(PROBE_KEY, '1');
+            storage.removeItem(PROBE_KEY);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+function getWindowStorage(kind) {
+    try {
+        const g = globalThis;
+        return g[kind] ?? null;
+    }
+    catch {
+        // Accessing storage can throw in some sandboxed environments.
+        return null;
+    }
+}
+/** Provider backed by `window.localStorage` (in-memory fallback when absent). */
+export function createLocalStoragePersistenceProvider(namespace) {
+    return new WebStoragePersistenceProvider(getWindowStorage('localStorage'), namespace);
+}
+/** Provider backed by `window.sessionStorage` (in-memory fallback when absent). */
+export function createSessionStoragePersistenceProvider(namespace) {
+    return new WebStoragePersistenceProvider(getWindowStorage('sessionStorage'), namespace);
+}

package/dist/impl/plugin/index.d.ts

@@ -1,5 +1,5 @@
 /**
  * Plugin Export
  */
-export * from './store-plugin-factory';
+export * from './store-plugin-factory.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/impl/plugin/index.js

@@ -1,4 +1,4 @@
 /**
  * Plugin Export
  */
-export * from './store-plugin-factory';
+export * from './store-plugin-factory.js';

package/dist/impl/plugin/store-plugin-factory.d.ts

@@ -3,13 +3,25 @@
  * Creates a microkernel plugin for Redux store management
  */
 import type { PluginModule } from '@hamak/microkernel-spi';
-import { type StorePluginExtensions } from '../../api';
+import { type StorePluginExtensions, type StorePersistenceConfig } from '../../api/index.js';
+import type { IPersistenceProvider } from '../../spi/index.js';
 export declare const FILESYSTEM_ADAPTER_TOKEN = "FILESYSTEM_ADAPTER";
 export interface StorePluginConfig extends StorePluginExtensions {
     /** Enable Redux DevTools integration */
     devTools?: boolean;
     /** Enable logger middleware in development */
     logger?: boolean;
+    /**
+     * State persistence configuration. When `enabled`, the whitelisted slice is
+     * rehydrated on boot and saved (debounced) on change. See #30.
+     */
+    persistence?: StorePersistenceConfig;
+    /**
+     * Custom persistence provider to mount instead of the default web-storage
+     * one. Takes precedence over any DI-registered provider and over the
+     * `persistence.storage` default. See #30.
+     */
+    persistenceProvider?: IPersistenceProvider;
 }
 export declare function createStorePlugin(config?: StorePluginConfig): PluginModule;
 //# sourceMappingURL=store-plugin-factory.d.ts.map

package/dist/impl/plugin/store-plugin-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-plugin-factory.d.ts","sourceRoot":"","sources":["../../../src/impl/plugin/store-plugin-factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAML,KAAK,qBAAqB,EAC3B,MAAM,WAAW,CAAC;AAanB,eAAO,MAAM,wBAAwB,uBAAuB,CAAC;AAE7D,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC9D,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,GAAE,iBAAsB,GAC7B,YAAY,CAqId"}
+{"version":3,"file":"store-plugin-factory.d.ts","sourceRoot":"","sources":["../../../src/impl/plugin/store-plugin-factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAQL,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC5B,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AActD,eAAO,MAAM,wBAAwB,uBAAuB,CAAC;AAE7D,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC9D,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,WAAW,CAAC,EAAE,sBAAsB,CAAC;IAErC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,oBAAoB,CAAC;CAC5C;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,GAAE,iBAAsB,GAC7B,YAAY,CAmMd"}

package/dist/impl/plugin/store-plugin-factory.js

@@ -2,11 +2,12 @@
  * Store Plugin Factory
  * Creates a microkernel plugin for Redux store management
  */
-import { STORE_MANAGER_TOKEN, MIDDLEWARE_REGISTRY_TOKEN, REDUCER_REGISTRY_TOKEN, STORE_EXTENSIONS_TOKEN, } from '../../api';
-import { StoreManager } from '../core/store-manager';
-import { createEventBridgeMiddleware, createLoggerMiddleware, } from '../middleware';
-import { applyStoreExtensions, createStoreExtensionsCollector, } from '../extensions/store-extensions';
-import { createFileSystemAdapter } from '../fs/core/fs-adapter';
+import { STORE_MANAGER_TOKEN, MIDDLEWARE_REGISTRY_TOKEN, REDUCER_REGISTRY_TOKEN, STORE_EXTENSIONS_TOKEN, PERSISTENCE_PROVIDER_TOKEN, PERSISTENCE_PROVIDER_GLOBAL_TOKEN, } from '../../api/index.js';
+import { StoreManager } from '../core/store-manager.js';
+import { createEventBridgeMiddleware, createLoggerMiddleware, } from '../middleware/index.js';
+import { applyStoreExtensions, createStoreExtensionsCollector, } from '../extensions/store-extensions.js';
+import { createFileSystemAdapter } from '../fs/core/fs-adapter.js';
+import { resolvePersistenceProvider, loadPersistedState } from '../persistence/index.js';
 // DI token for filesystem adapter
 export const FILESYSTEM_ADAPTER_TOKEN = 'FILESYSTEM_ADAPTER';
 export function createStorePlugin(config = {}) {
@@ -14,6 +15,8 @@ export function createStorePlugin(config = {}) {
     const middlewareRegistry = storeManager.getMiddlewareRegistry();
     const reducerRegistry = storeManager.getReducerRegistry();
     const extensionsCollector = createStoreExtensionsCollector();
+    // Resolved once in initialize(), reused in activate() for rehydrate + save.
+    let persistenceProvider;
     // Create filesystem adapter with 'fs' slice name
     const fileSystemAdapter = createFileSystemAdapter('fs');
     const registerDefaultMiddleware = (hooks) => {
@@ -95,15 +98,67 @@ export function createStorePlugin(config = {}) {
                 provide: FILESYSTEM_ADAPTER_TOKEN,
                 useValue: fileSystemAdapter,
             });
+            // Back-compat aliases (global symbol registry). The unique-symbol tokens
+            // above only resolve for consumers that import them from
+            // `@hamak/ui-store-api`. Several sibling plugins (ui-navigation, auth,
+            // notification, event-channel) deliberately stay decoupled and look the
+            // store services up via `Symbol.for(...)` keys instead. Register the same
+            // instances under those global keys so those lookups succeed instead of
+            // silently no-opping. See amah/app-framework#28 and #5.
+            ctx.provide({
+                provide: Symbol.for('StoreManager'),
+                useValue: storeManager,
+            });
+            ctx.provide({
+                provide: Symbol.for('@hamak/ui-store:StoreExtensionsRegistry'),
+                useValue: extensionsCollector,
+            });
+            // Resolve the persistence provider (Option B, #30). Precedence:
+            //   1. explicit mount-time provider (config.persistenceProvider)
+            //   2. a provider another plugin already registered under the token
+            //   3. a default built from `persistence.storage`
+            // The resolved instance is re-provided under both the unique and global
+            // tokens so sibling plugins can look it up the same way they do the store.
+            persistenceProvider = config.persistenceProvider;
+            if (!persistenceProvider) {
+                try {
+                    persistenceProvider = ctx.resolve(PERSISTENCE_PROVIDER_TOKEN);
+                }
+                catch {
+                    // No provider registered yet — fall through to the default.
+                }
+            }
+            if (!persistenceProvider && config.persistence?.enabled) {
+                persistenceProvider = resolvePersistenceProvider(config.persistence);
+            }
+            if (persistenceProvider) {
+                ctx.provide({
+                    provide: PERSISTENCE_PROVIDER_TOKEN,
+                    useValue: persistenceProvider,
+                });
+                ctx.provide({
+                    provide: PERSISTENCE_PROVIDER_GLOBAL_TOKEN,
+                    useValue: persistenceProvider,
+                });
+            }
             registerDefaultMiddleware(ctx.hooks);
             registerConfigExtensions();
             console.log('[ui-store] Plugin initialized with filesystem support');
         },
         async activate(ctx) {
             applyStoreExtensions(extensionsCollector, middlewareRegistry, reducerRegistry);
+            // Rehydrate the persisted slice before store creation (load() is async,
+            // but preloadedState must be supplied synchronously). See #30.
+            let preloadedState;
+            if (persistenceProvider && config.persistence?.enabled) {
+                preloadedState = await loadPersistedState(persistenceProvider, config.persistence);
+            }
             // Initialize the store after all plugins have registered middleware/reducers
             const store = storeManager.initialize({
                 devTools: config.devTools,
+                preloadedState,
+                persistence: config.persistence,
+                persistenceProvider,
             });
             // Bridge Redux state changes to microkernel events
             store.subscribe(() => {

package/dist/index.d.ts

@@ -12,5 +12,5 @@
  * // SPI (extension points)
  * import { IMiddlewareProvider, IAutosaveProvider } from '@hamak/ui-store/spi';
  */
-export * from './impl';
+export * from './impl/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -12,4 +12,4 @@
  * // SPI (extension points)
  * import { IMiddlewareProvider, IAutosaveProvider } from '@hamak/ui-store/spi';
  */
-export * from './impl';
+export * from './impl/index.js';

package/dist/spi/autosave/i-autosave-registry.d.ts

@@ -6,7 +6,7 @@
  * the appropriate provider for each file.
  */
 import type { FileSystemNode } from '@hamak/shared-utils';
-import type { IAutosaveProvider } from './i-autosave-provider';
+import type { IAutosaveProvider } from './i-autosave-provider.js';
 /**
  * Registry for autosave providers
  */

package/dist/spi/autosave/index.d.ts

@@ -3,6 +3,6 @@
  *
  * Service Provider Interfaces for autosave functionality.
  */
-export * from './i-autosave-provider';
-export * from './i-autosave-registry';
+export * from './i-autosave-provider.js';
+export * from './i-autosave-registry.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/spi/autosave/index.js

@@ -3,5 +3,5 @@
  *
  * Service Provider Interfaces for autosave functionality.
  */
-export * from './i-autosave-provider';
-export * from './i-autosave-registry';
+export * from './i-autosave-provider.js';
+export * from './i-autosave-registry.js';

package/dist/spi/index.d.ts

@@ -2,8 +2,8 @@
  * UI Store SPI
  * Service Provider Interfaces for Redux store extensions
  */
-export * from '../api';
-export * from './middleware';
-export * from './persistence';
-export * from './autosave';
+export * from '../api/index.js';
+export * from './middleware/index.js';
+export * from './persistence/index.js';
+export * from './autosave/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/spi/index.js

@@ -3,7 +3,7 @@
  * Service Provider Interfaces for Redux store extensions
  */
 // Re-export API for convenience
-export * from '../api';
-export * from './middleware';
-export * from './persistence';
-export * from './autosave';
+export * from '../api/index.js';
+export * from './middleware/index.js';
+export * from './persistence/index.js';
+export * from './autosave/index.js';

package/dist/spi/middleware/index.d.ts

@@ -1,2 +1,2 @@
-export * from './middleware-provider';
+export * from './middleware-provider.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/spi/middleware/index.js

@@ -1 +1 @@
-export * from './middleware-provider';
+export * from './middleware-provider.js';

package/dist/spi/middleware/middleware-provider.d.ts

@@ -1,5 +1,5 @@
 import type { Middleware } from 'redux';
-import type { MiddlewareRegistration } from '../../api';
+import type { MiddlewareRegistration } from '../../api/index.js';
 export interface IMiddlewareProvider {
     readonly id: string;
     create(config?: any): Middleware;

package/dist/spi/persistence/index.d.ts

@@ -1,2 +1,2 @@
-export * from './persistence-provider';
+export * from './persistence-provider.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/spi/persistence/index.js

@@ -1 +1 @@
-export * from './persistence-provider';
+export * from './persistence-provider.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hamak/ui-store",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "private": false,
   "type": "module",
   "description": "Redux store management for microkernel-based applications",
@@ -19,7 +19,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.lib.json",
+    "build": "tsc -p tsconfig.lib.json && node ../../scripts/fix-esm-extensions.mjs ./dist",
     "clean": "rm -rf dist",
     "test": "vitest run",
     "test:watch": "vitest"
@@ -43,8 +43,12 @@
   },
   "typesVersions": {
     "*": {
-      "api": ["./dist/api/index.d.ts"],
-      "spi": ["./dist/spi/index.d.ts"]
+      "api": [
+        "./dist/api/index.d.ts"
+      ],
+      "spi": [
+        "./dist/spi/index.d.ts"
+      ]
     }
   },
   "dependencies": {