sia-reactor 0.0.21 → 0.0.23

package/dist/modules.d.cts

@@ -0,0 +1,52 @@
+import { P as Paths, I as Inert, F as FanoutTuple, B as BaseReactorModule, R as Reactor, a as REvent } from './index-m0aAWxhX.cjs';
+export { b as ReactorModuleConstructor, c as ReactorModuleId } from './index-m0aAWxhX.cjs';
+import { S as StorageAdapter, A as AsyncStorageAdapter, a as StorageAdapterConstructor, b as AsyncStorageAdapterConstructor } from './timeTravel-DctvcHVt.cjs';
+export { B as BaseStorageAdapter, C as COOKIE_ADAPTER_BUILD, c as CookieAdapter, d as CookieAdapterConfig, e as CookieOptions, H as HistoryEntry, I as INDEXED_DB_ADAPTER_BUILD, f as IndexedDBAdapter, g as IndexedDBAdapterConfig, J as JSONReplacer, h as JSONReviver, L as LocalStorageAdapter, M as MemoryAdapter, i as MemoryAdapterConfig, j as SessionStorageAdapter, k as StorageAdapterConfig, T as TIME_TRAVEL_MODULE_BUILD, l as TimeTravelConfig, m as TimeTravelModule, n as TimeTravelState } from './timeTravel-DctvcHVt.cjs';
+
+interface PersistConfig<T extends object> {
+    /** Whether the persistence is disabled and cleared */
+    disabled: boolean;
+    /** The key under which to store the persisted data */
+    key: string;
+    /** Specific paths only, no "*"; instead don't pass anything */
+    paths: Paths<T>[];
+    /** Storage adapter class or instance to use, can satisfy `instanceof` or just definition, cast to `any` if the latter */
+    adapter: Inert<StorageAdapter> | Inert<AsyncStorageAdapter> | Inert<StorageAdapterConstructor> | Inert<AsyncStorageAdapterConstructor>;
+    /** Throttle time for saving changes */
+    throttle: number;
+    /** Fan out restored hydration writes so listeners/effects catch up, defaults to `true` if async for predictability */
+    fanout: boolean | FanoutTuple;
+    /** - `false`: persist live proxied roots (fastest, adapter must handle proxies).
+     * - `true`,`"auto"`: persist via `Reactor.snapshot()` but `true` force-enables `Reactor.config.referenceTracking`+`Reactor.config.smartCloning` for better performance. */
+    useSnapshot: boolean | "auto";
+}
+interface PersistState {
+    /** Whether the persisted data has been loaded. */
+    hydrated: boolean;
+}
+/**
+ * - The Storage Manager.
+ * - Configurable storage adapters for maximum flexibility (localStorage, sessionStorage, IndexedDB, cookies, custom server persisters, etc.)
+ * Path-based persistence for fine-grained control over what gets persisted across single or multiple reactors, merges into a single serialized state tree.
+ * When using async adapters, listen to `state.hydrated` (preferably `once`) before the setup of modules that should ignore hydration waves.
+ */
+declare class PersistModule<T extends object = any> extends BaseReactorModule<T, PersistConfig<T>, PersistState> {
+    static readonly moduleName: string;
+    adapter: StorageAdapter | AsyncStorageAdapter;
+    protected hydrateSeq: number;
+    protected saveTimeoutId: number;
+    get payload(): Record<string, any> | undefined;
+    constructor(config?: Partial<PersistConfig<T>>, rtr?: Reactor<T>);
+    wire(): void;
+    protected onAttach(rtr: Reactor<any>): void;
+    protected handleAdapter({ value }: REvent<PersistConfig<T>, "adapter">): Promise<void>;
+    protected handleDisabled({ value }: REvent<PersistConfig<T>, "disabled">): void;
+    protected handlePaths({ value: paths, oldValue: prevs }: REvent<PersistConfig<T>, "paths">): void;
+    protected handleSave(e: REvent<any, any>): void;
+    /** Clears persisted payload for this module instance and drops any pending save. */
+    clear(): void;
+    protected onDestroy(): void;
+}
+declare const PERSIST_MODULE_BUILD: Partial<PersistConfig<any>>;
+
+export { AsyncStorageAdapter, AsyncStorageAdapterConstructor, BaseReactorModule, PERSIST_MODULE_BUILD, type PersistConfig, PersistModule, StorageAdapter, StorageAdapterConstructor };

package/dist/modules.d.ts

@@ -0,0 +1,52 @@
+import { P as Paths, I as Inert, F as FanoutTuple, B as BaseReactorModule, R as Reactor, a as REvent } from './index-m0aAWxhX.js';
+export { b as ReactorModuleConstructor, c as ReactorModuleId } from './index-m0aAWxhX.js';
+import { S as StorageAdapter, A as AsyncStorageAdapter, a as StorageAdapterConstructor, b as AsyncStorageAdapterConstructor } from './timeTravel-DExvNb04.js';
+export { B as BaseStorageAdapter, C as COOKIE_ADAPTER_BUILD, c as CookieAdapter, d as CookieAdapterConfig, e as CookieOptions, H as HistoryEntry, I as INDEXED_DB_ADAPTER_BUILD, f as IndexedDBAdapter, g as IndexedDBAdapterConfig, J as JSONReplacer, h as JSONReviver, L as LocalStorageAdapter, M as MemoryAdapter, i as MemoryAdapterConfig, j as SessionStorageAdapter, k as StorageAdapterConfig, T as TIME_TRAVEL_MODULE_BUILD, l as TimeTravelConfig, m as TimeTravelModule, n as TimeTravelState } from './timeTravel-DExvNb04.js';
+
+interface PersistConfig<T extends object> {
+    /** Whether the persistence is disabled and cleared */
+    disabled: boolean;
+    /** The key under which to store the persisted data */
+    key: string;
+    /** Specific paths only, no "*"; instead don't pass anything */
+    paths: Paths<T>[];
+    /** Storage adapter class or instance to use, can satisfy `instanceof` or just definition, cast to `any` if the latter */
+    adapter: Inert<StorageAdapter> | Inert<AsyncStorageAdapter> | Inert<StorageAdapterConstructor> | Inert<AsyncStorageAdapterConstructor>;
+    /** Throttle time for saving changes */
+    throttle: number;
+    /** Fan out restored hydration writes so listeners/effects catch up, defaults to `true` if async for predictability */
+    fanout: boolean | FanoutTuple;
+    /** - `false`: persist live proxied roots (fastest, adapter must handle proxies).
+     * - `true`,`"auto"`: persist via `Reactor.snapshot()` but `true` force-enables `Reactor.config.referenceTracking`+`Reactor.config.smartCloning` for better performance. */
+    useSnapshot: boolean | "auto";
+}
+interface PersistState {
+    /** Whether the persisted data has been loaded. */
+    hydrated: boolean;
+}
+/**
+ * - The Storage Manager.
+ * - Configurable storage adapters for maximum flexibility (localStorage, sessionStorage, IndexedDB, cookies, custom server persisters, etc.)
+ * Path-based persistence for fine-grained control over what gets persisted across single or multiple reactors, merges into a single serialized state tree.
+ * When using async adapters, listen to `state.hydrated` (preferably `once`) before the setup of modules that should ignore hydration waves.
+ */
+declare class PersistModule<T extends object = any> extends BaseReactorModule<T, PersistConfig<T>, PersistState> {
+    static readonly moduleName: string;
+    adapter: StorageAdapter | AsyncStorageAdapter;
+    protected hydrateSeq: number;
+    protected saveTimeoutId: number;
+    get payload(): Record<string, any> | undefined;
+    constructor(config?: Partial<PersistConfig<T>>, rtr?: Reactor<T>);
+    wire(): void;
+    protected onAttach(rtr: Reactor<any>): void;
+    protected handleAdapter({ value }: REvent<PersistConfig<T>, "adapter">): Promise<void>;
+    protected handleDisabled({ value }: REvent<PersistConfig<T>, "disabled">): void;
+    protected handlePaths({ value: paths, oldValue: prevs }: REvent<PersistConfig<T>, "paths">): void;
+    protected handleSave(e: REvent<any, any>): void;
+    /** Clears persisted payload for this module instance and drops any pending save. */
+    clear(): void;
+    protected onDestroy(): void;
+}
+declare const PERSIST_MODULE_BUILD: Partial<PersistConfig<any>>;
+
+export { AsyncStorageAdapter, AsyncStorageAdapterConstructor, BaseReactorModule, PERSIST_MODULE_BUILD, type PersistConfig, PersistModule, StorageAdapter, StorageAdapterConstructor };