statewire 0.23.0 → 0.24.1

package/dist/storage.d.ts

@@ -1,4 +1,5 @@
 import type { StatewireClient } from "./statewire.js";
+export declare const STORAGE_FORMAT = 5;
 /** Persist sessions through a synchronous or asynchronous string storage backend. */
 export declare const KeyValueSessionStorage: import("@assistant-ui/tap").Resource<StatewireClient.SessionStorage, [options: KeyValueSessionStorage.Options]>;
 export declare namespace KeyValueSessionStorage {
@@ -9,7 +10,15 @@ export declare namespace KeyValueSessionStorage {
         getAllKeys?: () => readonly string[] | Promise<readonly string[]>;
         /** Runs cleanup under exclusive access, skipping keys in use by another runtime. */
         withUnused?: (key: string, action: () => Promise<void>) => Promise<void>;
+        /** Notifies of keys other runtimes wrote; returns unsubscribe. */
+        subscribe?: (listener: (key: string) => void) => () => void;
     };
+    /** Transforms the stored string, e.g. encryption or compression. */
+    type Codec = {
+        encode: (plain: string) => Promise<string>;
+        decode: (stored: string) => Promise<string>;
+    };
+    type EvictEvent = StatewireClient.EvictEvent;
     type Options = {
         backend: Backend;
         key: string;
@@ -21,7 +30,40 @@ export declare namespace KeyValueSessionStorage {
             maxAgeMs?: number;
             maxEntries?: number;
         };
+        /** Off by default; a write that adds an entry past one rejects `{ fate: "aborted", cause: "quota" }`. */
+        limits?: {
+            outboxEntries?: number;
+            recordBytes?: number;
+            totalBytes?: number;
+        };
+        codec?: Codec;
         onError?: (error: unknown) => void;
+        /** Reports evicted records and dropped failure notices. */
+        onEvict?: (event: EvictEvent) => void;
+    };
+}
+/** Session storage in page memory, keyed by scope: the record and client identity survive remounts, not reloads. */
+export declare const MemorySessionStorage: import("@assistant-ui/tap").Resource<StatewireClient.SessionStorage, [MemorySessionStorage.Options]>;
+export declare namespace MemorySessionStorage {
+    type Options = {
+        scope: string;
+    };
+}
+/** Reads the outboxes of every session under `namespace`, mounted or not. */
+export declare const readOutboxes: (backend: KeyValueSessionStorage.Backend, options: ReadOutboxes.Options) => Promise<readonly ReadOutboxes.Outbox[]>;
+/** Calls `listener` with `readOutboxes` now and after every save under `namespace`; returns unsubscribe. */
+export declare const subscribeOutboxes: (backend: KeyValueSessionStorage.Backend, options: ReadOutboxes.Options, listener: (outboxes: readonly ReadOutboxes.Outbox[]) => void, onError: (error: unknown) => void) => (() => void);
+export declare namespace ReadOutboxes {
+    type Options = {
+        namespace: string;
+        codec?: KeyValueSessionStorage.Codec;
+        /** The lane that single-lane formats lift into. */
+        protocol?: string;
+    };
+    type Outbox = {
+        key: string;
+        entries: readonly StatewireClient.OutboxEntry[];
     };
 }
+export { IndexedDbSession, indexedDbBackend } from "./indexedDb.js";
 //# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAoB;AA2kBnD,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,iHAAsC,CAAC;AAE1E,yBAAiB,sBAAsB,CAAC;IACtC,KAAY,OAAO,GAAG;QACpB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QACjE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9D,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAClD,UAAU,CAAC,EAAE,MAAM,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;QAClE,oFAAoF;QACpF,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC1E,CAAC;IACF,KAAY,OAAO,GAAG;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,iHAAiH;QACjH,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,eAAe,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QACpD,SAAS,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;KACpC,CAAC;CACH"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"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"}