@parity/product-sdk-terminal 0.8.2 → 0.9.0

package/README.md

@@ -63,7 +63,7 @@ Creates a terminal adapter backed by the host-papp SDK.
 
 **Options:**
 - `appId` -- unique app identifier (used as storage namespace)
-- `endpoints?` -- statement store WebSocket endpoints (defaults to Paseo)
+- `endpoints?` -- statement store WebSocket endpoints (defaults to `StatementStoreNetworks.paseo`)
 - `hostMetadata?` -- optional host environment info
 - `storageDir?` -- override the on-disk session directory (defaults to `~/.polkadot-apps/`). Useful in tests and containerised environments.
 
@@ -73,6 +73,26 @@ Creates a terminal adapter backed by the host-papp SDK.
 - `sessions` -- session manager (signing, disconnect)
 - `destroy()` -- disconnect the WebSocket and release resources. Idempotent. Drops `@novasamatech/statement-store`'s benign `Statement subscription error: Client destroyed` line, which it emits synchronously while disconnecting a live subscription — only that line; every other `console.error` passes through.
 
+### `StatementStoreNetworks`
+
+The statement store endpoints terminal can pair against, keyed by network.
+
+| Key | Network | Endpoint |
+| --- | --- | --- |
+| `paseo` | Paseo Next v2 | `wss://paseo-people-next-system-rpc.polkadot.io` |
+| `previewnet` | zombienet, a step ahead of paseo | whatever host-papp's `SS_PREVIEW_STAGE_ENDPOINTS` resolves to, today `wss://previewnet.substrate.dev/people` |
+
+Keyed the same way as `BULLETIN_RPCS` in `@parity/product-sdk-host`. There is deliberately no
+`devnet` key: that people chain has a statement store, but no endpoint for it is published here, and
+no phone build pairs against it. Pass `endpoints` explicitly to reach one.
+
+Pairing only works when the terminal and the phone are on the **same** people chain, and the phone
+picks its chain per build flavour. The Polkadot app's nightly build uses `paseo`, which is why that
+is the default; a preview-flavour phone needs `endpoints: StatementStoreNetworks.previewnet`.
+
+`SS_STABLE_STAGE_ENDPOINTS` is also exported. It is internal to the Parity network and does not
+answer from outside it.
+
 ### `isBenignTeardownError(error): boolean`
 
 Whether `error` is the benign teardown noise above (`Client destroyed`, matched on the message so it never swallows another package's `DestroyedError`). `destroy()` already drops it during its own teardown; export it so a consumer with its own `console.error` guard can drop the same line without reinventing the match.
@@ -102,7 +122,7 @@ const subSigner = createSessionSignerForAccount(session, {
 });
 ```
 
-> **Wire format note:** `@novasamatech/host-papp` 0.7 expects `productAccountId: [productId, derivationIndex]` in `SigningRawRequest`. Both functions above hide that tuple — pass an adapter for the default case or a named-fields object for the escape hatch.
+> **Wire format note:** `@novasamatech/host-papp` expects `productAccountId: [productId, { tag: "Index", value: derivationIndex }]` in `SigningRawRequest`. Both functions above hide that tuple — pass an adapter for the default case or a named-fields object for the escape hatch.
 
 ### `renderQrCode(data, options?): Promise<string>`
 
@@ -251,9 +271,9 @@ For consumers moving from `@polkadot-apps/terminal` v0.2.0 / v0.3.0. Existing se
 
 ### Why the signer API changed
 
-`@novasamatech/host-papp` 0.7 replaced `SigningRawRequest.address` with `productAccountId: [productId, derivationIndex]`. The wire format requires both fields, so a session-only argument is no longer enough — the signer needs to know *which sub-account of which product is asking*. We split that into two functions to keep the common case ergonomic:
+`@novasamatech/host-papp` 0.7 replaced `SigningRawRequest.address` with `productAccountId: [productId, derivationIndex]`, and 0.10 made the index a tagged `Index | Raw` selector. The wire format requires both fields, so a session-only argument is no longer enough — the signer needs to know *which sub-account of which product is asking*. We split that into two functions to keep the common case ergonomic:
 
-- `createSessionSigner(session, adapter)` for the default account (uses `[adapter.appId, 0]`)
+- `createSessionSigner(session, adapter)` for the default account (uses `[adapter.appId, { tag: "Index", value: 0 }]`)
 - `createSessionSignerForAccount(session, { productId, derivationIndex })` for everything else
 
 The single-argument `createSessionSigner(session)` from `@polkadot-apps/terminal` no longer works against host-papp 0.7 regardless of which package you use.

package/dist/chunk-GHOFKVUG.js

@@ -1,9 +1,10 @@
+import { createLogger } from '@parity/product-sdk-logger';
+import { fromPromise } from 'neverthrow';
+import { join } from 'path';
+import { unlink, writeFile, readFile, mkdir } from 'fs/promises';
+import { homedir } from 'os';
+
 // src/node-storage.ts
-import { createLogger } from "@parity/product-sdk-logger";
-import { fromPromise } from "neverthrow";
-import { join } from "path";
-import { readFile, writeFile, mkdir, unlink } from "fs/promises";
-import { homedir } from "os";
 var log = createLogger("terminal");
 var DEFAULT_STORAGE_DIR = join(homedir(), ".polkadot-apps");
 function sanitizeKey(appId, key) {
@@ -78,133 +79,7 @@ function createNodeStorageAdapter(appId, storageDir) {
     }
   };
 }
-if (void 0) {
-  const { describe, test, expect, beforeEach, afterAll } = void 0;
-  const { mkdtemp, rm } = await null;
-  const { tmpdir } = await null;
-  const { configure } = await null;
-  let testDir;
-  beforeEach(async () => {
-    configure({ handler: () => {
-    } });
-    testDir = await mkdtemp(join(tmpdir(), "terminal-storage-test-"));
-  });
-  afterAll(async () => {
-    try {
-      await rm(testDir, { recursive: true });
-    } catch {
-    }
-  });
-  describe("createNodeStorageAdapter", () => {
-    test("read returns null for missing key", async () => {
-      const store = createNodeStorageAdapter("test", testDir);
-      const result = await store.read("nonexistent");
-      expect(result.isOk()).toBe(true);
-      expect(result._unsafeUnwrap()).toBeNull();
-    });
-    test("write and read round-trip", async () => {
-      const store = createNodeStorageAdapter("test", testDir);
-      await store.write("key1", "hello");
-      const result = await store.read("key1");
-      expect(result._unsafeUnwrap()).toBe("hello");
-    });
-    test("write overwrites existing value", async () => {
-      const store = createNodeStorageAdapter("test", testDir);
-      await store.write("key1", "first");
-      await store.write("key1", "second");
-      const result = await store.read("key1");
-      expect(result._unsafeUnwrap()).toBe("second");
-    });
-    test("clear removes key", async () => {
-      const store = createNodeStorageAdapter("test", testDir);
-      await store.write("key1", "value");
-      await store.clear("key1");
-      const result = await store.read("key1");
-      expect(result._unsafeUnwrap()).toBeNull();
-    });
-    test("clear is safe for missing key", async () => {
-      const store = createNodeStorageAdapter("test", testDir);
-      const result = await store.clear("nonexistent");
-      expect(result.isOk()).toBe(true);
-    });
-    test("different appIds are isolated", async () => {
-      const storeA = createNodeStorageAdapter("app-a", testDir);
-      const storeB = createNodeStorageAdapter("app-b", testDir);
-      await storeA.write("key", "from-a");
-      await storeB.write("key", "from-b");
-      expect((await storeA.read("key"))._unsafeUnwrap()).toBe("from-a");
-      expect((await storeB.read("key"))._unsafeUnwrap()).toBe("from-b");
-    });
-    test("subscribe notifies on write", async () => {
-      const store = createNodeStorageAdapter("test", testDir);
-      const values = [];
-      store.subscribe("key1", (v) => values.push(v));
-      await store.write("key1", "hello");
-      expect(values).toEqual(["hello"]);
-    });
-    test("subscribe notifies on clear", async () => {
-      const store = createNodeStorageAdapter("test", testDir);
-      const values = [];
-      await store.write("key1", "hello");
-      store.subscribe("key1", (v) => values.push(v));
-      await store.clear("key1");
-      expect(values).toEqual([null]);
-    });
-    test("unsubscribe stops notifications", async () => {
-      const store = createNodeStorageAdapter("test", testDir);
-      const values = [];
-      const unsub = store.subscribe("key1", (v) => values.push(v));
-      await store.write("key1", "first");
-      unsub();
-      await store.write("key1", "second");
-      expect(values).toEqual(["first"]);
-    });
-    test("subscriber errors do not break other subscribers", async () => {
-      const store = createNodeStorageAdapter("test", testDir);
-      const values = [];
-      store.subscribe("key1", () => {
-        throw new Error("boom");
-      });
-      store.subscribe("key1", (v) => {
-        if (v) values.push(v);
-      });
-      await store.write("key1", "hello");
-      expect(values).toEqual(["hello"]);
-    });
-    test("sanitizes special characters in keys", async () => {
-      const store = createNodeStorageAdapter("test", testDir);
-      await store.write("key/with:special chars!", "value");
-      const result = await store.read("key/with:special chars!");
-      expect(result._unsafeUnwrap()).toBe("value");
-    });
-    test("handles JSON values", async () => {
-      const store = createNodeStorageAdapter("test", testDir);
-      const obj = { name: "test", count: 42, nested: { ok: true } };
-      await store.write("json", JSON.stringify(obj));
-      const raw = (await store.read("json"))._unsafeUnwrap();
-      expect(JSON.parse(raw)).toEqual(obj);
-    });
-  });
-  describe("toError", () => {
-    test("returns Error instances unchanged", () => {
-      const original = new TypeError("boom");
-      expect(toError(original)).toBe(original);
-    });
-    test("wraps non-Error string values", () => {
-      const result = toError("primitive failure");
-      expect(result).toBeInstanceOf(Error);
-      expect(result.message).toBe("primitive failure");
-    });
-    test("wraps non-Error nullish values", () => {
-      const result = toError(null);
-      expect(result).toBeInstanceOf(Error);
-      expect(result.message).toBe("null");
-    });
-  });
-}
 
-export {
-  sanitizeKey,
-  createNodeStorageAdapter
-};
+export { createNodeStorageAdapter, sanitizeKey };
+//# sourceMappingURL=chunk-GHOFKVUG.js.map
 //# sourceMappingURL=chunk-GHOFKVUG.js.map

package/dist/chunk-GHOFKVUG.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/node-storage.ts"],"sourcesContent":["// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * File-based StorageAdapter for Node.js environments.\n *\n * Implements the @novasamatech/storage-adapter interface using JSON files\n * in ~/.polkadot-apps/. Node.js doesn't have localStorage, so this\n * provides persistent storage for the SDK's session and secret data.\n */\nimport type { StorageAdapter } from \"@novasamatech/storage-adapter\";\nimport { createLogger } from \"@parity/product-sdk-logger\";\nimport { fromPromise } from \"neverthrow\";\nimport { join } from \"node:path\";\nimport { readFile, writeFile, mkdir, unlink } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\n\nconst log = createLogger(\"terminal\");\nconst DEFAULT_STORAGE_DIR = join(homedir(), \".polkadot-apps\");\n\n/**\n * Compute the storage filename for a given appId+key pair.\n *\n * Exposed (rather than kept private) so the test-session helper in\n * `./testing.ts` can target the same file the live adapter reads from\n * without having to duplicate the sanitization rule.\n */\nexport function sanitizeKey(appId: string, key: string): string {\n    return `${appId}_${key}`.replace(/[^a-zA-Z0-9_.-]/g, \"_\");\n}\n\nfunction toError(e: unknown): Error {\n    return e instanceof Error ? e : new Error(String(e));\n}\n\n/**\n * Create a file-based StorageAdapter for use with the host-papp SDK in Node.js.\n *\n * Data is stored as individual JSON files in the given directory\n * (defaults to `~/.polkadot-apps/`).\n */\nexport function createNodeStorageAdapter(appId: string, storageDir?: string): StorageAdapter {\n    const dir = storageDir ?? DEFAULT_STORAGE_DIR;\n    let dirCreated = false;\n    const subscribers = new Map<string, Set<(value: string | null) => unknown>>();\n\n    function fp(key: string): string {\n        return join(dir, `${sanitizeKey(appId, key)}.json`);\n    }\n\n    async function ensureDir(): Promise<void> {\n        if (dirCreated) return;\n        await mkdir(dir, { recursive: true });\n        dirCreated = true;\n    }\n\n    function notifySubscribers(key: string, value: string | null) {\n        const subs = subscribers.get(key);\n        if (subs) {\n            for (const cb of subs) {\n                try {\n                    cb(value);\n                } catch (e) {\n                    log.warn(\"storage subscriber callback threw\", { key, error: e });\n                }\n            }\n        }\n    }\n\n    return {\n        read(key: string) {\n            return fromPromise(\n                readFile(fp(key), \"utf-8\").catch((e) => {\n                    // Missing files are expected (a missing key reads as null);\n                    // log at debug so consumers can opt in to seeing reads when\n                    // diagnosing \"why isn't my session loading\".\n                    if ((e as NodeJS.ErrnoException).code !== \"ENOENT\") {\n                        log.warn(\"storage read failed\", { key, error: e });\n                    } else {\n                        log.debug(\"storage read miss\", { key });\n                    }\n                    return null;\n                }),\n                toError,\n            );\n        },\n\n        write(key: string, value: string) {\n            return fromPromise(\n                ensureDir()\n                    .then(() => writeFile(fp(key), value, \"utf-8\"))\n                    .then(() => {\n                        notifySubscribers(key, value);\n                    }),\n                toError,\n            ).map(() => undefined as undefined);\n        },\n\n        clear(key: string) {\n            return fromPromise(\n                unlink(fp(key))\n                    .catch(() => {})\n                    .then(() => {\n                        notifySubscribers(key, null);\n                    }),\n                toError,\n            ).map(() => undefined as undefined);\n        },\n\n        subscribe(key: string, callback: (value: string | null) => unknown) {\n            if (!subscribers.has(key)) {\n                subscribers.set(key, new Set());\n            }\n            subscribers.get(key)!.add(callback);\n            return () => {\n                subscribers.get(key)?.delete(callback);\n            };\n        },\n    };\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect, beforeEach, afterAll } = import.meta.vitest;\n    const { mkdtemp, rm } = await import(\"node:fs/promises\");\n    const { tmpdir } = await import(\"node:os\");\n    const { configure } = await import(\"@parity/product-sdk-logger\");\n\n    let testDir: string;\n\n    beforeEach(async () => {\n        // Silence the logger so tests that exercise the warn paths don't\n        // pollute stderr with expected log output.\n        configure({ handler: () => {} });\n        testDir = await mkdtemp(join(tmpdir(), \"terminal-storage-test-\"));\n    });\n\n    afterAll(async () => {\n        // Clean up any remaining test dirs\n        try {\n            await rm(testDir, { recursive: true });\n        } catch {\n            /* ignore */\n        }\n    });\n\n    describe(\"createNodeStorageAdapter\", () => {\n        test(\"read returns null for missing key\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            const result = await store.read(\"nonexistent\");\n            expect(result.isOk()).toBe(true);\n            expect(result._unsafeUnwrap()).toBeNull();\n        });\n\n        test(\"write and read round-trip\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            await store.write(\"key1\", \"hello\");\n            const result = await store.read(\"key1\");\n            expect(result._unsafeUnwrap()).toBe(\"hello\");\n        });\n\n        test(\"write overwrites existing value\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            await store.write(\"key1\", \"first\");\n            await store.write(\"key1\", \"second\");\n            const result = await store.read(\"key1\");\n            expect(result._unsafeUnwrap()).toBe(\"second\");\n        });\n\n        test(\"clear removes key\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            await store.write(\"key1\", \"value\");\n            await store.clear(\"key1\");\n            const result = await store.read(\"key1\");\n            expect(result._unsafeUnwrap()).toBeNull();\n        });\n\n        test(\"clear is safe for missing key\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            const result = await store.clear(\"nonexistent\");\n            expect(result.isOk()).toBe(true);\n        });\n\n        test(\"different appIds are isolated\", async () => {\n            const storeA = createNodeStorageAdapter(\"app-a\", testDir);\n            const storeB = createNodeStorageAdapter(\"app-b\", testDir);\n            await storeA.write(\"key\", \"from-a\");\n            await storeB.write(\"key\", \"from-b\");\n            expect((await storeA.read(\"key\"))._unsafeUnwrap()).toBe(\"from-a\");\n            expect((await storeB.read(\"key\"))._unsafeUnwrap()).toBe(\"from-b\");\n        });\n\n        test(\"subscribe notifies on write\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            const values: (string | null)[] = [];\n            store.subscribe(\"key1\", (v) => values.push(v));\n\n            await store.write(\"key1\", \"hello\");\n            expect(values).toEqual([\"hello\"]);\n        });\n\n        test(\"subscribe notifies on clear\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            const values: (string | null)[] = [];\n            await store.write(\"key1\", \"hello\");\n            store.subscribe(\"key1\", (v) => values.push(v));\n\n            await store.clear(\"key1\");\n            expect(values).toEqual([null]);\n        });\n\n        test(\"unsubscribe stops notifications\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            const values: (string | null)[] = [];\n            const unsub = store.subscribe(\"key1\", (v) => values.push(v));\n\n            await store.write(\"key1\", \"first\");\n            unsub();\n            await store.write(\"key1\", \"second\");\n\n            expect(values).toEqual([\"first\"]);\n        });\n\n        test(\"subscriber errors do not break other subscribers\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            const values: string[] = [];\n            store.subscribe(\"key1\", () => {\n                throw new Error(\"boom\");\n            });\n            store.subscribe(\"key1\", (v) => {\n                if (v) values.push(v);\n            });\n\n            await store.write(\"key1\", \"hello\");\n            expect(values).toEqual([\"hello\"]);\n        });\n\n        test(\"sanitizes special characters in keys\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            await store.write(\"key/with:special chars!\", \"value\");\n            const result = await store.read(\"key/with:special chars!\");\n            expect(result._unsafeUnwrap()).toBe(\"value\");\n        });\n\n        test(\"handles JSON values\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            const obj = { name: \"test\", count: 42, nested: { ok: true } };\n            await store.write(\"json\", JSON.stringify(obj));\n            const raw = (await store.read(\"json\"))._unsafeUnwrap();\n            expect(JSON.parse(raw!)).toEqual(obj);\n        });\n    });\n\n    describe(\"toError\", () => {\n        test(\"returns Error instances unchanged\", () => {\n            const original = new TypeError(\"boom\");\n            expect(toError(original)).toBe(original);\n        });\n\n        test(\"wraps non-Error string values\", () => {\n            const result = toError(\"primitive failure\");\n            expect(result).toBeInstanceOf(Error);\n            expect(result.message).toBe(\"primitive failure\");\n        });\n\n        test(\"wraps non-Error nullish values\", () => {\n            const result = toError(null);\n            expect(result).toBeInstanceOf(Error);\n            expect(result.message).toBe(\"null\");\n        });\n    });\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/node-storage.ts"],"names":[],"mappings":"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","file":"chunk-GHOFKVUG.js","sourcesContent":["// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * File-based StorageAdapter for Node.js environments.\n *\n * Implements the @novasamatech/storage-adapter interface using JSON files\n * in ~/.polkadot-apps/. Node.js doesn't have localStorage, so this\n * provides persistent storage for the SDK's session and secret data.\n */\nimport type { StorageAdapter } from \"@novasamatech/storage-adapter\";\nimport { createLogger } from \"@parity/product-sdk-logger\";\nimport { fromPromise } from \"neverthrow\";\nimport { join } from \"node:path\";\nimport { readFile, writeFile, mkdir, unlink } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\n\nconst log = createLogger(\"terminal\");\nconst DEFAULT_STORAGE_DIR = join(homedir(), \".polkadot-apps\");\n\n/**\n * Compute the storage filename for a given appId+key pair.\n *\n * Exposed (rather than kept private) so the test-session helper in\n * `./testing.ts` can target the same file the live adapter reads from\n * without having to duplicate the sanitization rule.\n */\nexport function sanitizeKey(appId: string, key: string): string {\n    return `${appId}_${key}`.replace(/[^a-zA-Z0-9_.-]/g, \"_\");\n}\n\nfunction toError(e: unknown): Error {\n    return e instanceof Error ? e : new Error(String(e));\n}\n\n/**\n * Create a file-based StorageAdapter for use with the host-papp SDK in Node.js.\n *\n * Data is stored as individual JSON files in the given directory\n * (defaults to `~/.polkadot-apps/`).\n */\nexport function createNodeStorageAdapter(appId: string, storageDir?: string): StorageAdapter {\n    const dir = storageDir ?? DEFAULT_STORAGE_DIR;\n    let dirCreated = false;\n    const subscribers = new Map<string, Set<(value: string | null) => unknown>>();\n\n    function fp(key: string): string {\n        return join(dir, `${sanitizeKey(appId, key)}.json`);\n    }\n\n    async function ensureDir(): Promise<void> {\n        if (dirCreated) return;\n        await mkdir(dir, { recursive: true });\n        dirCreated = true;\n    }\n\n    function notifySubscribers(key: string, value: string | null) {\n        const subs = subscribers.get(key);\n        if (subs) {\n            for (const cb of subs) {\n                try {\n                    cb(value);\n                } catch (e) {\n                    log.warn(\"storage subscriber callback threw\", { key, error: e });\n                }\n            }\n        }\n    }\n\n    return {\n        read(key: string) {\n            return fromPromise(\n                readFile(fp(key), \"utf-8\").catch((e) => {\n                    // Missing files are expected (a missing key reads as null);\n                    // log at debug so consumers can opt in to seeing reads when\n                    // diagnosing \"why isn't my session loading\".\n                    if ((e as NodeJS.ErrnoException).code !== \"ENOENT\") {\n                        log.warn(\"storage read failed\", { key, error: e });\n                    } else {\n                        log.debug(\"storage read miss\", { key });\n                    }\n                    return null;\n                }),\n                toError,\n            );\n        },\n\n        write(key: string, value: string) {\n            return fromPromise(\n                ensureDir()\n                    .then(() => writeFile(fp(key), value, \"utf-8\"))\n                    .then(() => {\n                        notifySubscribers(key, value);\n                    }),\n                toError,\n            ).map(() => undefined as undefined);\n        },\n\n        clear(key: string) {\n            return fromPromise(\n                unlink(fp(key))\n                    .catch(() => {})\n                    .then(() => {\n                        notifySubscribers(key, null);\n                    }),\n                toError,\n            ).map(() => undefined as undefined);\n        },\n\n        subscribe(key: string, callback: (value: string | null) => unknown) {\n            if (!subscribers.has(key)) {\n                subscribers.set(key, new Set());\n            }\n            subscribers.get(key)!.add(callback);\n            return () => {\n                subscribers.get(key)?.delete(callback);\n            };\n        },\n    };\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect, beforeEach, afterAll } = import.meta.vitest;\n    const { mkdtemp, rm } = await import(\"node:fs/promises\");\n    const { tmpdir } = await import(\"node:os\");\n    const { configure } = await import(\"@parity/product-sdk-logger\");\n\n    let testDir: string;\n\n    beforeEach(async () => {\n        // Silence the logger so tests that exercise the warn paths don't\n        // pollute stderr with expected log output.\n        configure({ handler: () => {} });\n        testDir = await mkdtemp(join(tmpdir(), \"terminal-storage-test-\"));\n    });\n\n    afterAll(async () => {\n        // Clean up any remaining test dirs\n        try {\n            await rm(testDir, { recursive: true });\n        } catch {\n            /* ignore */\n        }\n    });\n\n    describe(\"createNodeStorageAdapter\", () => {\n        test(\"read returns null for missing key\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            const result = await store.read(\"nonexistent\");\n            expect(result.isOk()).toBe(true);\n            expect(result._unsafeUnwrap()).toBeNull();\n        });\n\n        test(\"write and read round-trip\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            await store.write(\"key1\", \"hello\");\n            const result = await store.read(\"key1\");\n            expect(result._unsafeUnwrap()).toBe(\"hello\");\n        });\n\n        test(\"write overwrites existing value\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            await store.write(\"key1\", \"first\");\n            await store.write(\"key1\", \"second\");\n            const result = await store.read(\"key1\");\n            expect(result._unsafeUnwrap()).toBe(\"second\");\n        });\n\n        test(\"clear removes key\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            await store.write(\"key1\", \"value\");\n            await store.clear(\"key1\");\n            const result = await store.read(\"key1\");\n            expect(result._unsafeUnwrap()).toBeNull();\n        });\n\n        test(\"clear is safe for missing key\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            const result = await store.clear(\"nonexistent\");\n            expect(result.isOk()).toBe(true);\n        });\n\n        test(\"different appIds are isolated\", async () => {\n            const storeA = createNodeStorageAdapter(\"app-a\", testDir);\n            const storeB = createNodeStorageAdapter(\"app-b\", testDir);\n            await storeA.write(\"key\", \"from-a\");\n            await storeB.write(\"key\", \"from-b\");\n            expect((await storeA.read(\"key\"))._unsafeUnwrap()).toBe(\"from-a\");\n            expect((await storeB.read(\"key\"))._unsafeUnwrap()).toBe(\"from-b\");\n        });\n\n        test(\"subscribe notifies on write\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            const values: (string | null)[] = [];\n            store.subscribe(\"key1\", (v) => values.push(v));\n\n            await store.write(\"key1\", \"hello\");\n            expect(values).toEqual([\"hello\"]);\n        });\n\n        test(\"subscribe notifies on clear\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            const values: (string | null)[] = [];\n            await store.write(\"key1\", \"hello\");\n            store.subscribe(\"key1\", (v) => values.push(v));\n\n            await store.clear(\"key1\");\n            expect(values).toEqual([null]);\n        });\n\n        test(\"unsubscribe stops notifications\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            const values: (string | null)[] = [];\n            const unsub = store.subscribe(\"key1\", (v) => values.push(v));\n\n            await store.write(\"key1\", \"first\");\n            unsub();\n            await store.write(\"key1\", \"second\");\n\n            expect(values).toEqual([\"first\"]);\n        });\n\n        test(\"subscriber errors do not break other subscribers\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            const values: string[] = [];\n            store.subscribe(\"key1\", () => {\n                throw new Error(\"boom\");\n            });\n            store.subscribe(\"key1\", (v) => {\n                if (v) values.push(v);\n            });\n\n            await store.write(\"key1\", \"hello\");\n            expect(values).toEqual([\"hello\"]);\n        });\n\n        test(\"sanitizes special characters in keys\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            await store.write(\"key/with:special chars!\", \"value\");\n            const result = await store.read(\"key/with:special chars!\");\n            expect(result._unsafeUnwrap()).toBe(\"value\");\n        });\n\n        test(\"handles JSON values\", async () => {\n            const store = createNodeStorageAdapter(\"test\", testDir);\n            const obj = { name: \"test\", count: 42, nested: { ok: true } };\n            await store.write(\"json\", JSON.stringify(obj));\n            const raw = (await store.read(\"json\"))._unsafeUnwrap();\n            expect(JSON.parse(raw!)).toEqual(obj);\n        });\n    });\n\n    describe(\"toError\", () => {\n        test(\"returns Error instances unchanged\", () => {\n            const original = new TypeError(\"boom\");\n            expect(toError(original)).toBe(original);\n        });\n\n        test(\"wraps non-Error string values\", () => {\n            const result = toError(\"primitive failure\");\n            expect(result).toBeInstanceOf(Error);\n            expect(result.message).toBe(\"primitive failure\");\n        });\n\n        test(\"wraps non-Error nullish values\", () => {\n            const result = toError(null);\n            expect(result).toBeInstanceOf(Error);\n            expect(result.message).toBe(\"null\");\n        });\n    });\n}\n"]}

package/dist/chunk-OKJQEB6P.js

@@ -0,0 +1,251 @@
+import { createLogger } from '@parity/product-sdk-logger';
+import { fromHex, toHex } from '@polkadot-api/utils';
+import { readFile, mkdir, writeFile, rename } from 'fs/promises';
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+import { numberToBytesLE, bytesToNumberLE } from '@noble/curves/utils.js';
+import { createDerive, sr25519Derive, sr25519 } from '@polkadot-labs/hdkd-helpers';
+import { getPolkadotSigner } from 'polkadot-api/signer';
+
+// src/host.ts
+var log = createLogger("terminal");
+var DEFAULT_STORAGE_DIR = join(homedir(), ".polkadot-apps");
+var CACHE_FILE_MODE = 384;
+function sanitizeAppId(appId) {
+  return appId.replace(/[^a-zA-Z0-9_.-]/g, "_");
+}
+function cachePath(appId, storageDir) {
+  return join(storageDir ?? DEFAULT_STORAGE_DIR, `${sanitizeAppId(appId)}_AllowanceKeys.json`);
+}
+function emptyCache() {
+  return { version: 2, entries: {} };
+}
+async function loadCache(appId, storageDir) {
+  const path = cachePath(appId, storageDir);
+  let raw;
+  try {
+    raw = await readFile(path, "utf-8");
+  } catch (e) {
+    if (e?.code === "ENOENT") return emptyCache();
+    throw e;
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (parsed?.version !== 2 || typeof parsed.entries !== "object" || parsed.entries === null) {
+      log.warn("allowance cache schema mismatch; starting fresh", { appId, path });
+      return emptyCache();
+    }
+    return parsed;
+  } catch (e) {
+    log.warn("allowance cache parse failed; starting fresh", { appId, path, error: String(e) });
+    return emptyCache();
+  }
+}
+async function saveCache(appId, cache, storageDir) {
+  const path = cachePath(appId, storageDir);
+  await mkdir(dirname(path), { recursive: true });
+  const tmp = `${path}.tmp`;
+  await writeFile(tmp, JSON.stringify(cache, null, 2), { mode: CACHE_FILE_MODE });
+  await rename(tmp, path);
+}
+function smartContractDest(dest) {
+  return dest.tag === "Index" ? `Index::${dest.value}` : `Raw::${toHex(dest.value)}`;
+}
+function cacheKey(resource) {
+  if (resource.tag === "SmartContractAllowance") {
+    return `${resource.tag}::${smartContractDest(resource.value)}`;
+  }
+  return resource.tag;
+}
+function pickOnExistingPolicy(cache, resources) {
+  if (resources.length === 0) return "Ignore";
+  const allSlotTableAndCached = resources.every((r) => {
+    if (r.tag !== "BulletInAllowance" && r.tag !== "StatementStoreAllowance") return false;
+    return Object.hasOwn(cache.entries, cacheKey(r));
+  });
+  return allSlotTableAndCached ? "Increase" : "Ignore";
+}
+function mergeOutcomes(cache, requested, outcomes) {
+  if (requested.length !== outcomes.length) {
+    throw new Error(
+      `mergeOutcomes: length mismatch \u2014 requested ${requested.length}, got ${outcomes.length}`
+    );
+  }
+  const entries = { ...cache.entries };
+  let mutated = false;
+  for (let i = 0; i < outcomes.length; i++) {
+    const req = requested[i];
+    const out = outcomes[i];
+    if (out.tag !== "Allocated") continue;
+    const inner = out.value;
+    if (inner.tag !== req.tag) {
+      throw new Error(
+        `mergeOutcomes: variant mismatch at index ${i} \u2014 requested ${req.tag}, got Allocated<${inner.tag}>`
+      );
+    }
+    const key = cacheKey(req);
+    switch (inner.tag) {
+      case "BulletInAllowance":
+      case "StatementStoreAllowance":
+        entries[key] = {
+          tag: inner.tag,
+          slotAccountKey: toHex(inner.value.slotAccountKey)
+        };
+        mutated = true;
+        break;
+      case "SmartContractAllowance":
+        if (req.tag === "SmartContractAllowance") {
+          entries[key] = {
+            tag: "SmartContractAllowance",
+            dest: smartContractDest(req.value)
+          };
+          mutated = true;
+        }
+        break;
+      case "AutoSigning":
+        entries[key] = {
+          tag: "AutoSigning",
+          ringVrfDomainEntropy: toHex(inner.value.ringVrfDomainEntropy),
+          productRootPrivateKey: toHex(inner.value.productRootPrivateKey)
+        };
+        mutated = true;
+        break;
+    }
+  }
+  return mutated ? { version: 2, entries } : cache;
+}
+function readCacheEntry(cache, resource) {
+  return cache.entries[cacheKey(resource)] ?? null;
+}
+var cacheLocks = /* @__PURE__ */ new Map();
+function withCacheLock(appId, storageDir, fn) {
+  const key = cachePath(appId, storageDir);
+  const prev = cacheLocks.get(key) ?? Promise.resolve();
+  const next = prev.catch(() => {
+  }).then(fn);
+  cacheLocks.set(
+    key,
+    next.catch(() => {
+    })
+  );
+  return next;
+}
+function canonicalSr25519SecretToEd25519Bytes(secret) {
+  const ed25519Scalar = numberToBytesLE(bytesToNumberLE(secret.subarray(0, 32)) << 3n, 32);
+  const out = new Uint8Array(64);
+  out.set(ed25519Scalar, 0);
+  out.set(secret.subarray(32, 64), 32);
+  return out;
+}
+function buildKeypair(secret) {
+  if (secret.length === 32) {
+    const derive = createDerive({ seed: secret, curve: sr25519, derive: sr25519Derive });
+    const keypair = derive("");
+    return { publicKey: keypair.publicKey, sign: (data) => keypair.sign(data) };
+  }
+  if (secret.length === 64) {
+    const ed25519Secret = canonicalSr25519SecretToEd25519Bytes(secret);
+    return {
+      publicKey: sr25519.getPublicKey(ed25519Secret),
+      sign: (data) => sr25519.sign(data, ed25519Secret)
+    };
+  }
+  throw new Error(
+    `createSlotAccountSigner: unexpected slotAccountKey length ${secret.length}. Expected 32 (mini-secret) or 64 (expanded secret).`
+  );
+}
+function buildSignerFromEntry(entry) {
+  if (entry.tag !== "BulletInAllowance" && entry.tag !== "StatementStoreAllowance") {
+    throw new Error(
+      `createSlotAccountSigner: ${entry.tag} does not carry a slot account key. Slot-table signing is defined for BulletInAllowance and StatementStoreAllowance only.`
+    );
+  }
+  const secret = fromHex(entry.slotAccountKey);
+  const { publicKey, sign } = buildKeypair(secret);
+  return getPolkadotSigner(publicKey, "Sr25519", async (data) => sign(data));
+}
+async function createSlotAccountSigner(adapter, resource, productId) {
+  const cache = await loadCache(productId ?? adapter.appId, adapter.storageDir);
+  const entry = readCacheEntry(cache, resource);
+  if (!entry) return null;
+  return buildSignerFromEntry(entry);
+}
+
+// src/host.ts
+var log2 = createLogger("terminal");
+async function requestResourceAllocation(session, adapter, resources, options = {}) {
+  const productId = options.productId ?? adapter.appId;
+  return withCacheLock(productId, adapter.storageDir, async () => {
+    const cache = await loadCache(productId, adapter.storageDir);
+    const onExisting = options.onExisting ?? pickOnExistingPolicy(cache, resources);
+    log2.debug("requestResourceAllocation", {
+      productId,
+      resources: resources.map((r) => r.tag),
+      onExisting,
+      autoPolicy: options.onExisting === void 0
+    });
+    const outcomes = await sendResourceAllocation(session, productId, resources, onExisting);
+    const next = mergeOutcomes(cache, resources, outcomes);
+    if (next !== cache) {
+      await saveCache(productId, next, adapter.storageDir);
+    }
+    return outcomes;
+  });
+}
+async function sendResourceAllocation(session, productId, resources, onExisting) {
+  const result = await session.requestResourceAllocation({
+    callingProductId: productId,
+    resources,
+    onExisting
+  });
+  if (result.isErr()) {
+    throw new Error(`requestResourceAllocation failed: ${result.error.message}`);
+  }
+  return result.value;
+}
+async function getCachedAllocation(adapter, resource, productId) {
+  const cache = await loadCache(productId ?? adapter.appId, adapter.storageDir);
+  return readCacheEntry(cache, resource);
+}
+async function ensureSlotAccountSigner(session, adapter, resource, productId) {
+  const resolvedProductId = productId ?? adapter.appId;
+  return withCacheLock(resolvedProductId, adapter.storageDir, async () => {
+    const cache = await loadCache(resolvedProductId, adapter.storageDir);
+    const hit = readCacheEntry(cache, resource);
+    if (hit) return buildSignerFromEntry(hit);
+    log2.debug("ensureSlotAccountSigner: cache miss, allocating", { resource: resource.tag });
+    const onExisting = pickOnExistingPolicy(cache, [resource]);
+    const outcomes = await sendResourceAllocation(
+      session,
+      resolvedProductId,
+      [resource],
+      onExisting
+    );
+    const next = mergeOutcomes(cache, [resource], outcomes);
+    if (next !== cache) {
+      await saveCache(resolvedProductId, next, adapter.storageDir);
+    }
+    const outcome = outcomes[0];
+    if (!outcome) {
+      throw new Error(
+        `ensureSlotAccountSigner: protocol violation \u2014 empty outcomes for ${resource.tag}`
+      );
+    }
+    if (outcome.tag !== "Allocated") {
+      throw new Error(
+        `ensureSlotAccountSigner: allocation ${outcome.tag} for ${resource.tag}`
+      );
+    }
+    const freshEntry = readCacheEntry(next, resource);
+    if (!freshEntry) {
+      throw new Error(
+        `ensureSlotAccountSigner: allocation succeeded but cache lookup returned null for ${resource.tag}`
+      );
+    }
+    return buildSignerFromEntry(freshEntry);
+  });
+}
+
+export { createSlotAccountSigner, ensureSlotAccountSigner, getCachedAllocation, requestResourceAllocation, sendResourceAllocation };
+//# sourceMappingURL=chunk-OKJQEB6P.js.map
+//# sourceMappingURL=chunk-OKJQEB6P.js.map