@parity/product-sdk 0.17.0 → 0.18.0

package/dist/{chunk-6MNKFIU6.js → chunk-6BI66XUJ.js}

@@ -2,7 +2,8 @@ import { resolvePeopleUsernameOwner, accountIdHexToBytes } from './chunk-BIKT6X5
 import { createLogger, configure } from '@parity/product-sdk-logger';
 import { createLocalKvStore } from '@parity/product-sdk-local-storage';
 import { SignerManager } from '@parity/product-sdk-signer';
-import { CloudStorageClient, createLazySigner, calculateCid } from '@parity/product-sdk-cloud-storage';
+import { CloudStorageClient, createLazySigner, calculateCid, ProductCloudStorageError } from '@parity/product-sdk-cloud-storage';
+import { err, ok } from '@parity/result';
 import { isConnected, getClient, createChainClient, destroyAll } from '@parity/product-sdk-chain-client';
 import { getAccountsProvider } from '@parity/product-sdk-host';
 
@@ -65,13 +66,20 @@ async function createApp(config) {
   const cloudStorageApi = cloudStorageClient ? {
     upload: async (data) => {
       const bytes = typeof data === "string" ? new TextEncoder().encode(data) : data;
-      const result = await cloudStorageClient.store(bytes).withManifest(true).send();
-      if (!result.cid) {
-        throw new Error(
-          "Cloud storage upload returned no CID despite .withManifest(true). Upstream contract may have shifted \u2014 file an issue."
-        );
+      try {
+        const uploaded = await cloudStorageClient.store(bytes).withManifest(true).send();
+        if (!uploaded.cid) {
+          return err(
+            new ProductCloudStorageError(
+              "Cloud storage upload returned no CID despite .withManifest(true). Upstream contract may have shifted \u2014 file an issue."
+            )
+          );
+        }
+        return ok(uploaded.cid.toString());
+      } catch (cause) {
+        const message = cause instanceof Error ? cause.message : String(cause);
+        return err(new ProductCloudStorageError(message, { cause }));
       }
-      return result.cid.toString();
     },
     fetch: (cid) => cloudStorageClient.fetchBytes(cid),
     computeCid: async (data) => {
@@ -217,8 +225,8 @@ async function getHostAccountsProvider() {
 async function getPrimaryUsername(accountsProvider) {
   const result = await accountsProvider.getUserId().match(
     (value) => value,
-    (err) => {
-      throw err;
+    (err2) => {
+      throw err2;
     }
   );
   const username = result.primaryUsername.trim();
@@ -229,5 +237,5 @@ async function getPrimaryUsername(accountsProvider) {
 }
 
 export { createApp };
-//# sourceMappingURL=chunk-6MNKFIU6.js.map
-//# sourceMappingURL=chunk-6MNKFIU6.js.map
+//# sourceMappingURL=chunk-6BI66XUJ.js.map
+//# sourceMappingURL=chunk-6BI66XUJ.js.map

package/dist/chunk-6BI66XUJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/createApp.ts"],"names":["err"],"mappings":"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","file":"chunk-6BI66XUJ.js","sourcesContent":["// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * createApp - Main entry point for the Product SDK\n *\n * Creates an App instance with wallet, storage, chain, and cloud storage APIs.\n */\n\nimport type { ChainDefinition } from \"polkadot-api\";\nimport type {\n    App,\n    AppConfig,\n    WalletApi,\n    ChainApi,\n    Account,\n    CloudStorageApi,\n    LocalStorageApi,\n} from \"./types.js\";\nimport { configure, createLogger } from \"@parity/product-sdk-logger\";\nimport { createLocalKvStore } from \"@parity/product-sdk-local-storage\";\nimport { SignerManager } from \"@parity/product-sdk-signer\";\nimport {\n    CloudStorageClient,\n    ProductCloudStorageError,\n    calculateCid,\n    createLazySigner,\n} from \"@parity/product-sdk-cloud-storage\";\nimport { err, ok } from \"@parity/result\";\nimport {\n    createChainClient,\n    getClient,\n    isConnected,\n    destroyAll,\n} from \"@parity/product-sdk-chain-client\";\nimport { getAccountsProvider } from \"@parity/product-sdk-host\";\nimport {\n    accountIdHexToBytes,\n    type PeopleUsernameQueryApi,\n    resolvePeopleUsernameOwner,\n} from \"../identity/dotns.js\";\n\nconst log = createLogger(\"app\");\n\n/**\n * Create a new Product SDK app instance\n *\n * @param config - Application configuration\n * @returns App instance with all APIs\n *\n * @example\n * ```ts\n * import { createApp } from '@parity/product-sdk';\n *\n * // Default: cloud storage enabled with paseo environment\n * const app = await createApp({\n *   name: 'my-app',\n *   logLevel: 'info',\n * });\n *\n * // Custom cloud storage environment\n * const prodApp = await createApp({\n *   name: 'my-app',\n *   cloudStorage: { environment: 'polkadot' },\n * });\n *\n * // Disable cloud storage entirely\n * const noCloudStorageApp = await createApp({\n *   name: 'my-app',\n *   cloudStorage: false,\n * });\n *\n * // Connect wallet\n * const { accounts } = await app.wallet.connect();\n *\n * // Use storage\n * await app.localStorage.set('key', 'value');\n *\n * // Use cloud storage (check for null if it might be disabled)\n * if (app.cloudStorage) {\n *   const cid = await app.cloudStorage.upload('hello world');\n * }\n * ```\n */\nexport async function createApp(config: AppConfig): Promise<App> {\n    // Set log level if specified\n    if (config.logLevel) {\n        configure({ level: config.logLevel });\n    }\n\n    log.info(\"Creating Product SDK app\", { name: config.name });\n\n    // Initialize storage (container-only - will throw if not in container)\n    const localKvStore = await createLocalKvStore({ prefix: config.name });\n\n    // Initialize signer manager\n    const signerManager = new SignerManager({\n        dappName: config.name,\n    });\n\n    // Initialize cloud storage client (configurable, defaults to paseo).\n    //\n    // The signer is wrapped lazily so the cloud storage client can be built before\n    // an account is selected. Uploads will throw a clear error if no signer\n    // is available at submission time. Reads (fetch / fetchJson) don't need\n    // a signer, so they work regardless of whether an account is selected --\n    // but they are container-only and throw CloudStorageHostUnavailableError\n    // outside a host container (no IPFS-gateway fallback).\n    const cloudStorageEnabled = config.cloudStorage !== false;\n    const cloudStorageEnvironment =\n        typeof config.cloudStorage === \"object\" ? config.cloudStorage.environment : \"paseo\";\n    const cloudStorageClient = cloudStorageEnabled\n        ? await CloudStorageClient.create({\n              environment: cloudStorageEnvironment,\n              signer: createLazySigner(() => signerManager.getSigner()),\n          })\n        : null;\n\n    if (cloudStorageEnabled) {\n        log.debug(\"Cloud Storage client (Bulletin) initialized\", {\n            environment: cloudStorageEnvironment,\n        });\n    } else {\n        log.debug(\"Cloud Storage client disabled\");\n    }\n\n    // Create storage API adapter\n    const localStorageApi: LocalStorageApi = {\n        get: (key) => localKvStore.get(key),\n        set: (key, value) => localKvStore.set(key, value),\n        getJSON: <T>(key: string) => localKvStore.getJSON<T>(key),\n        setJSON: <T>(key: string, value: T) => localKvStore.setJSON(key, value),\n        remove: (key) => localKvStore.remove(key),\n        clear: async () => {\n            // LocalKvStore doesn't have clear - this is a no-op\n            log.debug(\"clear() is not supported in container storage mode\");\n        },\n    };\n\n    // Create wallet API adapter\n    const walletApi = createWalletApi(signerManager);\n\n    // Create chain API\n    const chainApi: ChainApi = {\n        getClient(descriptor) {\n            log.debug(\"getClient called\", { genesis: descriptor.genesis });\n            const client = getClient(descriptor);\n            return client.getTypedApi(descriptor);\n        },\n\n        getRawClient(descriptor) {\n            log.debug(\"getRawClient called\", { genesis: descriptor.genesis });\n            return getClient(descriptor);\n        },\n\n        async connect<T extends Record<string, ChainDefinition>>(chains: T) {\n            log.debug(\"connect called\", { chains: Object.keys(chains) });\n            return createChainClient({ chains });\n        },\n\n        isConnected(descriptor) {\n            return isConnected(descriptor);\n        },\n\n        destroyAll() {\n            log.debug(\"destroyAll called\");\n            destroyAll();\n        },\n    };\n\n    // Create Cloud Storage API adapter (null if disabled)\n    const cloudStorageApi: CloudStorageApi | null = cloudStorageClient\n        ? {\n              upload: async (data) => {\n                  const bytes = typeof data === \"string\" ? new TextEncoder().encode(data) : data;\n                  try {\n                      // Explicitly request a DAG-PB manifest so chunked uploads always\n                      // resolve to a single root CID. Without this, AsyncBulletinClient\n                      // can return `result.cid: undefined` for chunked-without-manifest\n                      // uploads — but app consumers expect a CID they can hand to\n                      // `fetch(cid)`, so treat a missing CID as an error.\n                      const uploaded = await cloudStorageClient\n                          .store(bytes)\n                          .withManifest(true)\n                          .send();\n                      if (!uploaded.cid) {\n                          return err(\n                              new ProductCloudStorageError(\n                                  \"Cloud storage upload returned no CID despite .withManifest(true). Upstream contract may have shifted — file an issue.\",\n                              ),\n                          );\n                      }\n                      return ok(uploaded.cid.toString());\n                  } catch (cause) {\n                      const message = cause instanceof Error ? cause.message : String(cause);\n                      return err(new ProductCloudStorageError(message, { cause }));\n                  }\n              },\n              fetch: (cid) => cloudStorageClient.fetchBytes(cid),\n              computeCid: async (data) => {\n                  const bytes = typeof data === \"string\" ? new TextEncoder().encode(data) : data;\n                  const cid = await calculateCid(bytes);\n                  return cid.toString();\n              },\n          }\n        : null;\n\n    log.info(\"Product SDK app created\", {\n        name: config.name,\n        cloudStorage: cloudStorageEnabled ? cloudStorageEnvironment : \"disabled\",\n    });\n\n    return {\n        wallet: walletApi,\n        localStorage: localStorageApi,\n        chain: chainApi,\n        cloudStorage: cloudStorageApi,\n        getAppInfo: () => ({ ...config }),\n    };\n}\n\n/**\n * Create wallet API adapter using SignerManager from leaf package\n */\nfunction createWalletApi(signerManager: SignerManager): WalletApi {\n    // Track account change subscribers\n    const accountChangeSubscribers = new Set<(account: Account | null) => void>();\n\n    // Subscribe to signer manager state changes\n    signerManager.subscribe((state) => {\n        const account = state.selectedAccount\n            ? {\n                  address: state.selectedAccount.address,\n                  name: state.selectedAccount.name ?? undefined,\n                  source: state.selectedAccount.source,\n              }\n            : null;\n        for (const callback of accountChangeSubscribers) {\n            try {\n                callback(account);\n            } catch (e) {\n                log.warn(\"Account change callback threw\", { error: e });\n            }\n        }\n    });\n\n    return {\n        async connect(): Promise<{ accounts: Account[] }> {\n            const result = await signerManager.connect();\n            if (!result.ok) {\n                throw new Error(result.error.message);\n            }\n            return {\n                accounts: result.value.map((a) => ({\n                    address: a.address,\n                    name: a.name ?? undefined,\n                    source: a.source,\n                })),\n            };\n        },\n\n        async disconnect(): Promise<void> {\n            signerManager.disconnect();\n        },\n\n        getAccounts(): Account[] {\n            return signerManager.getState().accounts.map((a) => ({\n                address: a.address,\n                name: a.name ?? undefined,\n                source: a.source,\n            }));\n        },\n\n        getSelectedAccount(): Account | null {\n            const selected = signerManager.getState().selectedAccount;\n            if (!selected) return null;\n            return {\n                address: selected.address,\n                name: selected.name ?? undefined,\n                source: selected.source,\n            };\n        },\n\n        selectAccount(address: string): void {\n            signerManager.selectAccount(address);\n        },\n\n        async signMessage(message: string | Uint8Array): Promise<Uint8Array> {\n            const bytes = typeof message === \"string\" ? new TextEncoder().encode(message) : message;\n            const result = await signerManager.signRaw(bytes);\n            if (!result.ok) {\n                throw new Error(result.error.message);\n            }\n            return result.value;\n        },\n\n        async signMessageWithDotNsIdentity(args) {\n            const message =\n                typeof args.message === \"string\"\n                    ? new TextEncoder().encode(args.message)\n                    : args.message;\n            const accountsProvider = await getHostAccountsProvider();\n            const username = args.username ?? (await getPrimaryUsername(accountsProvider));\n\n            // Reuse an already-connected People chain when the caller has\n            // wired one up via `app.chain.connect({ ..., <name>: peopleChain })`.\n            // Fall back to opening a transient connection so first-time users\n            // don't have to think about chain lifecycles. The chain-client\n            // module caches by genesis fingerprint, so subsequent\n            // signMessageWithDotNsIdentity calls share whichever connection\n            // got established first.\n            const peopleClient = isConnected(args.peopleChain)\n                ? getClient(args.peopleChain)\n                : await createChainClient({ chains: { people: args.peopleChain } }).then(\n                      (c) => c.raw.people,\n                  );\n            // PAPI's `TypedApi.query.X.Y.getValue` is variadic\n            // (`...args: [...WithCallOptions<Args>]`) so it's not assignable\n            // to our deliberately-narrow `(key) => Promise<...>` shape. The\n            // resolver only ever passes the storage key; the cast adapts the\n            // wider PAPI surface to the minimum we depend on.\n            const peopleApi = peopleClient.getTypedApi(\n                args.peopleChain,\n            ) as unknown as PeopleUsernameQueryApi;\n            const accountId = await resolvePeopleUsernameOwner(username, peopleApi);\n            if (!accountId) {\n                throw new Error(`No account owns DotNS username \"${username}\"`);\n            }\n\n            const owner = accountIdHexToBytes(accountId);\n            const signer = accountsProvider.getLegacyAccountSigner({\n                publicKey: owner,\n                name: username,\n            });\n\n            try {\n                return {\n                    username,\n                    accountId,\n                    signature: await signer.signBytes(message),\n                };\n            } catch (cause) {\n                throw new Error(\n                    `Failed to sign with DotNS username \"${username}\": ${\n                        cause instanceof Error ? cause.message : String(cause)\n                    }`,\n                    { cause },\n                );\n            }\n        },\n\n        onAccountChange(callback: (account: Account | null) => void): () => void {\n            accountChangeSubscribers.add(callback);\n            return () => accountChangeSubscribers.delete(callback);\n        },\n\n        getProductAccount(): Account | null {\n            // Product accounts require async call - this sync API can't support it properly\n            // Users should use SignerManager.getProductAccount() directly\n            log.warn(\n                \"getProductAccount() is deprecated - use SignerManager.getProductAccount() directly\",\n            );\n            return null;\n        },\n\n        getAnonymousAlias(): string | null {\n            // Anonymous aliases require async call - this sync API can't support it properly\n            // Users should use SignerManager.getProductAccountAlias() directly\n            log.warn(\n                \"getAnonymousAlias() is deprecated - use SignerManager.getProductAccountAlias() directly\",\n            );\n            return null;\n        },\n\n        async createProof(_message: Uint8Array): Promise<Uint8Array> {\n            // Ring VRF proofs require SignerManager.createRingVRFProof() directly\n            throw new Error(\n                \"createProof() is not implemented in the App API. \" +\n                    \"Use SignerManager.createRingVRFProof() directly.\",\n            );\n        },\n    };\n}\n\ntype HostAccountsProvider = NonNullable<Awaited<ReturnType<typeof getAccountsProvider>>>;\n\nasync function getHostAccountsProvider(): Promise<HostAccountsProvider> {\n    const provider = await getAccountsProvider();\n    if (!provider) {\n        throw new Error(\"Host accounts provider is not available\");\n    }\n    return provider;\n}\n\nasync function getPrimaryUsername(accountsProvider: HostAccountsProvider): Promise<string> {\n    const result = await accountsProvider.getUserId().match(\n        (value) => value,\n        (err) => {\n            throw err;\n        },\n    );\n    const username = result.primaryUsername.trim();\n    if (!username) {\n        throw new Error(\"Host identity did not provide a primary DotNS username\");\n    }\n    return username;\n}\n"]}

package/dist/core/index.d.ts

@@ -1,8 +1,10 @@
 export { createApp } from '../index.js';
 export { LogEntry, LogHandler, LogLevel, Logger, LoggerConfig, configure, createLogger } from '@parity/product-sdk-logger';
-export { a as Account, A as App, b as AppConfig, C as ChainApi, c as CloudStorageApi, d as CloudStorageConfig, D as DotNsIdentitySignature, L as LocalStorageApi, S as SignMessageWithDotNsIdentityArgs, W as WalletApi } from '../types-DsMUguUr.js';
+export { A as Account, b as App, c as AppConfig, C as ChainApi, a as CloudStorageApi, d as CloudStorageConfig, D as DotNsIdentitySignature, L as LocalStorageApi, S as SignMessageWithDotNsIdentityArgs, W as WalletApi } from '../types-CztPAgZT.js';
 export { ChainClient } from '@parity/product-sdk-chain-client';
 export { ChainDefinition, PolkadotClient, TypedApi } from 'polkadot-api';
+import '@parity/result';
+import '@parity/product-sdk-errors';
 import '@parity/product-sdk-host';
 import '@parity/product-sdk-signer';
 import '@parity/product-sdk-local-storage';

package/dist/core/index.js

@@ -1,5 +1,5 @@
 export { configure, createLogger } from '../chunk-JVJ552RU.js';
-export { createApp } from '../chunk-6MNKFIU6.js';
+export { createApp } from '../chunk-6BI66XUJ.js';
 import '../chunk-BIKT6X54.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export { LogEntry, LogHandler, LogLevel, Logger, LoggerConfig, configure, createLogger } from '@parity/product-sdk-logger';
-import { b as AppConfig, A as App } from './types-DsMUguUr.js';
-export { a as Account, C as ChainApi, c as CloudStorageApi, D as DotNsIdentitySignature, L as LocalStorageApi, S as SignMessageWithDotNsIdentityArgs, W as WalletApi } from './types-DsMUguUr.js';
+import { c as AppConfig, b as App } from './types-CztPAgZT.js';
+export { A as Account, C as ChainApi, a as CloudStorageApi, D as DotNsIdentitySignature, L as LocalStorageApi, S as SignMessageWithDotNsIdentityArgs, W as WalletApi } from './types-CztPAgZT.js';
+export { Result, err, isErrorOf, ok } from '@parity/result';
+export { SdkError, isSdkError } from '@parity/product-sdk-errors';
 export { isInsideContainer, isInsideContainerSync } from '@parity/product-sdk-host';
 export { ChainClient, createChainClient } from '@parity/product-sdk-chain-client';
 export { SignerManager } from '@parity/product-sdk-signer';

package/dist/index.js

@@ -1,6 +1,8 @@
 export { configure, createLogger } from './chunk-JVJ552RU.js';
-export { createApp } from './chunk-6MNKFIU6.js';
+export { createApp } from './chunk-6BI66XUJ.js';
 import './chunk-BIKT6X54.js';
+export { err, isErrorOf, ok } from '@parity/result';
+export { isSdkError } from '@parity/product-sdk-errors';
 export { isInsideContainer, isInsideContainerSync } from '@parity/product-sdk-host';
 export { createChainClient } from '@parity/product-sdk-chain-client';
 export { SignerManager } from '@parity/product-sdk-signer';

package/dist/react/index.d.ts

@@ -2,9 +2,10 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { LogLevel } from '@parity/product-sdk-logger';
-import { A as App, S as SignMessageWithDotNsIdentityArgs, D as DotNsIdentitySignature, a as Account } from '../types-DsMUguUr.js';
+import { b as App, S as SignMessageWithDotNsIdentityArgs, D as DotNsIdentitySignature, A as Account } from '../types-CztPAgZT.js';
 import { ChainDefinition, TypedApi } from 'polkadot-api';
 import '@parity/product-sdk-cloud-storage';
+import '@parity/result';
 import '@parity/product-sdk-chain-client';
 import '../dotns-hLSvmo6u.js';
 

package/dist/react/index.js

@@ -1,4 +1,4 @@
-import { createApp } from '../chunk-6MNKFIU6.js';
+import { createApp } from '../chunk-6BI66XUJ.js';
 import '../chunk-BIKT6X54.js';
 import { createContext, useContext, useState, useEffect, useCallback, useMemo } from 'react';
 import { jsx, Fragment } from 'react/jsx-runtime';

package/dist/testing/index.d.ts

@@ -0,0 +1,61 @@
+import { A as Account, L as LocalStorageApi, C as ChainApi, a as CloudStorageApi, b as App } from '../types-CztPAgZT.js';
+export * from '@parity/product-sdk-local-storage/testing';
+export * from '@parity/product-sdk-signer/testing';
+export * from '@parity/product-sdk-contracts/testing';
+export * from '@parity/product-sdk-host/testing';
+import '@parity/product-sdk-logger';
+import '@parity/product-sdk-cloud-storage';
+import '@parity/result';
+import '@parity/product-sdk-chain-client';
+import '../dotns-hLSvmo6u.js';
+import 'polkadot-api';
+
+/** Configurable behavior for the fake {@link WalletApi}. */
+interface FakeWalletOptions {
+    /** Accounts `connect()` / `getAccounts()` expose. Default: none. */
+    accounts?: Account[];
+    /** Initially selected account. Default: the first account, or `null`. */
+    selected?: Account | null;
+    /** Bytes returned by `signMessage` / `createProof`. Default: 64 zero bytes. */
+    signature?: Uint8Array;
+    /** Value returned by `getProductAccount()`. Default: the selected account. */
+    productAccount?: Account | null;
+    /** Value returned by `getAnonymousAlias()`. Default: `null`. */
+    anonymousAlias?: string | null;
+}
+/** Options for {@link createFakeApp}. */
+interface CreateFakeAppOptions {
+    /** App name reported by `getAppInfo()`. Default: `"fake-app"`. */
+    name?: string;
+    /** Configure the fake wallet. */
+    wallet?: FakeWalletOptions;
+    /** Override the local-storage API. Default: in-memory (backed by `createFakeHostLocalStorage`). */
+    localStorage?: LocalStorageApi;
+    /** Override the chain API. Default: unconfigured (throws until you provide one). */
+    chain?: ChainApi;
+    /** Override cloud storage, or pass `null` to disable it. Default: an in-memory fake. */
+    cloudStorage?: CloudStorageApi | null;
+}
+/**
+ * Create a fake {@link App}. Wallet, local-storage, and cloud-storage are working
+ * in-memory fakes; `chain` is unconfigured until you override it. Every sub-API
+ * is overridable.
+ *
+ * @example
+ * ```ts
+ * import { createFakeApp } from "@parity/product-sdk/testing";
+ *
+ * const app = createFakeApp({ wallet: { accounts: [alice, bob], selected: alice } });
+ * await app.wallet.connect();
+ * expect(app.wallet.getAccounts()).toHaveLength(2);
+ * ```
+ *
+ * For React, feed the fake to the exported context:
+ * ```tsx
+ * import { ProductSDKContext } from "@parity/product-sdk/react";
+ * render(<ProductSDKContext.Provider value={app}><AccountPicker /></ProductSDKContext.Provider>);
+ * ```
+ */
+declare function createFakeApp(options?: CreateFakeAppOptions): App;
+
+export { type CreateFakeAppOptions, type FakeWalletOptions, createFakeApp };

package/dist/testing/index.js

@@ -0,0 +1,149 @@
+import { ProductCloudStorageError } from '@parity/product-sdk-cloud-storage';
+import { createFakeHostLocalStorage } from '@parity/product-sdk-local-storage/testing';
+export * from '@parity/product-sdk-local-storage/testing';
+import { err, ok } from '@parity/result';
+export * from '@parity/product-sdk-signer/testing';
+export * from '@parity/product-sdk-contracts/testing';
+export * from '@parity/product-sdk-host/testing';
+
+// src/testing.ts
+var textEncoder = new TextEncoder();
+function makeFakeWallet(options) {
+  const accounts = options?.accounts ?? [];
+  let selected = options?.selected !== void 0 ? options.selected : accounts[0] ?? null;
+  const signature = options?.signature ?? new Uint8Array(64);
+  const listeners = /* @__PURE__ */ new Set();
+  const notify = () => {
+    for (const l of listeners) l(selected);
+  };
+  return {
+    async connect() {
+      return { accounts };
+    },
+    async disconnect() {
+      selected = null;
+      notify();
+    },
+    getAccounts() {
+      return accounts;
+    },
+    getSelectedAccount() {
+      return selected;
+    },
+    selectAccount(address) {
+      selected = accounts.find((a) => a.address === address) ?? null;
+      notify();
+    },
+    async signMessage() {
+      return signature;
+    },
+    async signMessageWithDotNsIdentity(args) {
+      return {
+        username: args.username ?? "alice",
+        accountId: `0x${"00".repeat(32)}`,
+        signature
+      };
+    },
+    onAccountChange(callback) {
+      listeners.add(callback);
+      return () => {
+        listeners.delete(callback);
+      };
+    },
+    getProductAccount() {
+      return options?.productAccount !== void 0 ? options.productAccount : selected;
+    },
+    getAnonymousAlias() {
+      return options?.anonymousAlias ?? null;
+    },
+    async createProof() {
+      return signature;
+    }
+  };
+}
+function makeFakeLocalStorage() {
+  const host = createFakeHostLocalStorage();
+  return {
+    async get(key) {
+      return await host.readString(key) || null;
+    },
+    async set(key, value) {
+      await host.writeString(key, value);
+    },
+    async getJSON(key) {
+      return await host.readJSON(key) ?? null;
+    },
+    async setJSON(key, value) {
+      await host.writeJSON(key, value);
+    },
+    async remove(key) {
+      await host.clear(key);
+    },
+    async clear() {
+      host.reset();
+    }
+  };
+}
+function makeFakeCloudStorage() {
+  const store = /* @__PURE__ */ new Map();
+  const toBytes = (data) => typeof data === "string" ? textEncoder.encode(data) : data;
+  const cidOf = (bytes) => {
+    let h = 2166136261;
+    for (const b of bytes) {
+      h ^= b;
+      h = Math.imul(h, 16777619);
+    }
+    return `bafyfake${(h >>> 0).toString(16).padStart(8, "0")}`;
+  };
+  return {
+    async upload(data) {
+      const bytes = toBytes(data);
+      const cid = cidOf(bytes);
+      store.set(cid, bytes);
+      return ok(cid);
+    },
+    async fetch(cid) {
+      const bytes = store.get(cid);
+      if (!bytes) {
+        return err(
+          new ProductCloudStorageError(
+            `fake cloud storage: no object stored for CID ${cid}`
+          )
+        );
+      }
+      return ok(bytes);
+    },
+    async computeCid(data) {
+      return cidOf(toBytes(data));
+    }
+  };
+}
+function makeUnconfiguredChain() {
+  const fail = () => {
+    throw new Error(
+      "createFakeApp: `chain` is not configured. Pass a `chain` override in options. There is no chain-read fake \u2014 the host owns RPC selection; test chain-reading logic behind your own interface and cover the real wiring in e2e."
+    );
+  };
+  return {
+    getClient: fail,
+    getRawClient: fail,
+    connect: fail,
+    isConnected: () => false,
+    destroyAll: () => {
+    }
+  };
+}
+function createFakeApp(options) {
+  const name = options?.name ?? "fake-app";
+  return {
+    wallet: makeFakeWallet(options?.wallet),
+    localStorage: options?.localStorage ?? makeFakeLocalStorage(),
+    chain: options?.chain ?? makeUnconfiguredChain(),
+    cloudStorage: options?.cloudStorage !== void 0 ? options.cloudStorage : makeFakeCloudStorage(),
+    getAppInfo: () => ({ name })
+  };
+}
+
+export { createFakeApp };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * Test fakes for `@parity/product-sdk` (umbrella).\n *\n * `createFakeApp` returns a fake {@link App} — use it directly in logic tests or\n * hand it to `ProductSDKContext.Provider` for React component tests, so code that\n * calls `useProductSDK()` / `useWallet()` runs with no host. This entry also\n * re-exports every package's fakes, for a single meta-package import.\n *\n * @packageDocumentation\n */\nimport { ProductCloudStorageError } from \"@parity/product-sdk-cloud-storage\";\nimport { createFakeHostLocalStorage } from \"@parity/product-sdk-local-storage/testing\";\nimport { err, ok, unwrapErr, unwrapOk } from \"@parity/result\";\n\nimport type {\n    Account,\n    App,\n    ChainApi,\n    CloudStorageApi,\n    LocalStorageApi,\n    WalletApi,\n} from \"./core/types.js\";\n\nconst textEncoder = new TextEncoder();\n\n// Re-export the per-package fakes so `@parity/product-sdk/testing` is a one-stop import.\n// statement-store is deliberately absent: the umbrella doesn't wrap that package, so apps\n// using it depend on it directly — import `@parity/product-sdk-statement-store/testing`\n// there instead. Re-exporting its fake here would add a dependency the umbrella otherwise\n// doesn't have and could skew against the version the app actually installs.\nexport * from \"@parity/product-sdk-local-storage/testing\";\nexport * from \"@parity/product-sdk-signer/testing\";\nexport * from \"@parity/product-sdk-contracts/testing\";\nexport * from \"@parity/product-sdk-host/testing\";\n\n/** Configurable behavior for the fake {@link WalletApi}. */\nexport interface FakeWalletOptions {\n    /** Accounts `connect()` / `getAccounts()` expose. Default: none. */\n    accounts?: Account[];\n    /** Initially selected account. Default: the first account, or `null`. */\n    selected?: Account | null;\n    /** Bytes returned by `signMessage` / `createProof`. Default: 64 zero bytes. */\n    signature?: Uint8Array;\n    /** Value returned by `getProductAccount()`. Default: the selected account. */\n    productAccount?: Account | null;\n    /** Value returned by `getAnonymousAlias()`. Default: `null`. */\n    anonymousAlias?: string | null;\n}\n\n/** Options for {@link createFakeApp}. */\nexport interface CreateFakeAppOptions {\n    /** App name reported by `getAppInfo()`. Default: `\"fake-app\"`. */\n    name?: string;\n    /** Configure the fake wallet. */\n    wallet?: FakeWalletOptions;\n    /** Override the local-storage API. Default: in-memory (backed by `createFakeHostLocalStorage`). */\n    localStorage?: LocalStorageApi;\n    /** Override the chain API. Default: unconfigured (throws until you provide one). */\n    chain?: ChainApi;\n    /** Override cloud storage, or pass `null` to disable it. Default: an in-memory fake. */\n    cloudStorage?: CloudStorageApi | null;\n}\n\nfunction makeFakeWallet(options?: FakeWalletOptions): WalletApi {\n    const accounts = options?.accounts ?? [];\n    let selected = options?.selected !== undefined ? options.selected : (accounts[0] ?? null);\n    const signature = options?.signature ?? new Uint8Array(64);\n    const listeners = new Set<(account: Account | null) => void>();\n    const notify = () => {\n        for (const l of listeners) l(selected);\n    };\n\n    return {\n        async connect() {\n            return { accounts };\n        },\n        async disconnect() {\n            selected = null;\n            notify();\n        },\n        getAccounts() {\n            return accounts;\n        },\n        getSelectedAccount() {\n            return selected;\n        },\n        selectAccount(address) {\n            selected = accounts.find((a) => a.address === address) ?? null;\n            notify();\n        },\n        async signMessage() {\n            return signature;\n        },\n        async signMessageWithDotNsIdentity(args) {\n            return {\n                username: args.username ?? \"alice\",\n                accountId: `0x${\"00\".repeat(32)}`,\n                signature,\n            };\n        },\n        onAccountChange(callback) {\n            listeners.add(callback);\n            return () => {\n                listeners.delete(callback);\n            };\n        },\n        getProductAccount() {\n            return options?.productAccount !== undefined ? options.productAccount : selected;\n        },\n        getAnonymousAlias() {\n            return options?.anonymousAlias ?? null;\n        },\n        async createProof() {\n            return signature;\n        },\n    };\n}\n\nfunction makeFakeLocalStorage(): LocalStorageApi {\n    // Compose the local-storage fake; mirror createApp's adapter semantics\n    // (get normalizes \"\" -> null, getJSON normalizes undefined -> null).\n    const host = createFakeHostLocalStorage();\n    return {\n        async get(key) {\n            return (await host.readString(key)) || null;\n        },\n        async set(key, value) {\n            await host.writeString(key, value);\n        },\n        async getJSON<T>(key: string) {\n            return ((await host.readJSON(key)) ?? null) as T | null;\n        },\n        async setJSON<T>(key: string, value: T) {\n            await host.writeJSON(key, value);\n        },\n        async remove(key) {\n            await host.clear(key);\n        },\n        async clear() {\n            // Unlike the production adapter (a no-op in container mode), the fake\n            // actually empties, so tests get real isolation.\n            host.reset();\n        },\n    };\n}\n\nfunction makeFakeCloudStorage(): CloudStorageApi {\n    const store = new Map<string, Uint8Array>();\n    const toBytes = (data: string | Uint8Array) =>\n        typeof data === \"string\" ? textEncoder.encode(data) : data;\n    // Deterministic content-addressed id so upload / computeCid / fetch line up.\n    const cidOf = (bytes: Uint8Array) => {\n        let h = 0x811c9dc5;\n        for (const b of bytes) {\n            h ^= b;\n            h = Math.imul(h, 0x01000193);\n        }\n        return `bafyfake${(h >>> 0).toString(16).padStart(8, \"0\")}`;\n    };\n    return {\n        async upload(data) {\n            const bytes = toBytes(data);\n            const cid = cidOf(bytes);\n            store.set(cid, bytes);\n            return ok(cid);\n        },\n        async fetch(cid) {\n            const bytes = store.get(cid);\n            if (!bytes) {\n                return err(\n                    new ProductCloudStorageError(\n                        `fake cloud storage: no object stored for CID ${cid}`,\n                    ),\n                );\n            }\n            return ok(bytes);\n        },\n        async computeCid(data) {\n            return cidOf(toBytes(data));\n        },\n    };\n}\n\nfunction makeUnconfiguredChain(): ChainApi {\n    const fail = (): never => {\n        throw new Error(\n            \"createFakeApp: `chain` is not configured. Pass a `chain` override in options. \" +\n                \"There is no chain-read fake — the host owns RPC selection; test chain-reading \" +\n                \"logic behind your own interface and cover the real wiring in e2e.\",\n        );\n    };\n    // Reads throw (fail fast, no silent undefined); state queries stay quiet.\n    return {\n        getClient: fail,\n        getRawClient: fail,\n        connect: fail,\n        isConnected: () => false,\n        destroyAll: () => {},\n    };\n}\n\n/**\n * Create a fake {@link App}. Wallet, local-storage, and cloud-storage are working\n * in-memory fakes; `chain` is unconfigured until you override it. Every sub-API\n * is overridable.\n *\n * @example\n * ```ts\n * import { createFakeApp } from \"@parity/product-sdk/testing\";\n *\n * const app = createFakeApp({ wallet: { accounts: [alice, bob], selected: alice } });\n * await app.wallet.connect();\n * expect(app.wallet.getAccounts()).toHaveLength(2);\n * ```\n *\n * For React, feed the fake to the exported context:\n * ```tsx\n * import { ProductSDKContext } from \"@parity/product-sdk/react\";\n * render(<ProductSDKContext.Provider value={app}><AccountPicker /></ProductSDKContext.Provider>);\n * ```\n */\nexport function createFakeApp(options?: CreateFakeAppOptions): App {\n    const name = options?.name ?? \"fake-app\";\n    return {\n        wallet: makeFakeWallet(options?.wallet),\n        localStorage: options?.localStorage ?? makeFakeLocalStorage(),\n        chain: options?.chain ?? makeUnconfiguredChain(),\n        cloudStorage:\n            options?.cloudStorage !== undefined ? options.cloudStorage : makeFakeCloudStorage(),\n        getAppInfo: () => ({ name }),\n    };\n}\n\nif (import.meta.vitest) {\n    const { describe, test, expect } = import.meta.vitest;\n\n    const alice: Account = { address: \"5Alice\", name: \"Alice\", source: \"dev\" };\n    const bob: Account = { address: \"5Bob\", name: \"Bob\", source: \"dev\" };\n\n    describe(\"createFakeApp\", () => {\n        test(\"wallet lists, selects, and notifies on account change\", async () => {\n            const app = createFakeApp({ wallet: { accounts: [alice, bob], selected: alice } });\n            expect(app.wallet.getAccounts()).toHaveLength(2);\n            expect(app.wallet.getSelectedAccount()).toEqual(alice);\n\n            let changed: Account | null = null;\n            app.wallet.onAccountChange((a) => {\n                changed = a;\n            });\n            app.wallet.selectAccount(\"5Bob\");\n            expect(app.wallet.getSelectedAccount()).toEqual(bob);\n            expect(changed).toEqual(bob);\n\n            const { accounts } = await app.wallet.connect();\n            expect(accounts).toHaveLength(2);\n        });\n\n        test(\"localStorage round-trips and clear empties it\", async () => {\n            const app = createFakeApp();\n            await app.localStorage.set(\"k\", \"v\");\n            await app.localStorage.setJSON(\"o\", { n: 1 });\n            expect(await app.localStorage.get(\"k\")).toBe(\"v\");\n            expect(await app.localStorage.getJSON(\"o\")).toEqual({ n: 1 });\n            expect(await app.localStorage.get(\"missing\")).toBeNull();\n\n            await app.localStorage.clear();\n            expect(await app.localStorage.get(\"k\")).toBeNull();\n        });\n\n        test(\"cloudStorage round-trips upload -> fetch; computeCid matches upload\", async () => {\n            const cs = createFakeApp().cloudStorage;\n            if (!cs) throw new Error(\"expected default cloud storage\");\n            const cid = unwrapOk(await cs.upload(\"hello\"));\n            expect(await cs.computeCid(\"hello\")).toBe(cid);\n            expect(new TextDecoder().decode(unwrapOk(await cs.fetch(cid)))).toBe(\"hello\");\n            expect(unwrapErr(await cs.fetch(\"bafyfakemissing\"))).toBeInstanceOf(\n                ProductCloudStorageError,\n            );\n        });\n\n        test(\"cloudStorage can be disabled with null\", () => {\n            expect(createFakeApp({ cloudStorage: null }).cloudStorage).toBeNull();\n        });\n\n        test(\"chain is unconfigured by default\", () => {\n            const app = createFakeApp();\n            expect(app.chain.isConnected({} as never)).toBe(false);\n            expect(() => app.chain.getClient({} as never)).toThrow(/not configured/);\n        });\n\n        test(\"getAppInfo reports the name\", () => {\n            expect(createFakeApp({ name: \"my-app\" }).getAppInfo().name).toBe(\"my-app\");\n        });\n    });\n}\n"]}

package/dist/{types-DsMUguUr.d.ts → types-CztPAgZT.d.ts}

@@ -1,5 +1,6 @@
 import { LogLevel } from '@parity/product-sdk-logger';
-import { CloudStorageEnvironment } from '@parity/product-sdk-cloud-storage';
+import { ProductCloudStorageError, CloudStorageEnvironment } from '@parity/product-sdk-cloud-storage';
+import { Result } from '@parity/result';
 import { ChainClient } from '@parity/product-sdk-chain-client';
 import { P as PeopleUsernameChain } from './dotns-hLSvmo6u.js';
 import { ChainDefinition, TypedApi, PolkadotClient } from 'polkadot-api';
@@ -122,16 +123,23 @@ interface CloudStorageApi {
     /**
      * Upload data to the Cloud.
      *
-     * Requires a wallet to be connected and an account selected. Throws
-     * "No signer available …" otherwise.
+     * Requires a wallet to be connected and an account selected.
+     *
+     * @returns A {@link Result}: `ok(cid)` on success, or `err(ProductCloudStorageError)`
+     *   if the upload fails (no signer, network rejection, or no CID returned).
+     */
+    upload(data: string | Uint8Array): Promise<Result<string, ProductCloudStorageError>>;
+    /**
+     * Fetch data by CID.
+     *
+     * @returns A {@link Result}: `ok(bytes)` on success, or `err(ProductCloudStorageError)`.
      */
-    upload(data: string | Uint8Array): Promise<string>;
-    /** Fetch data by CID. */
-    fetch(cid: string): Promise<Uint8Array>;
+    fetch(cid: string): Promise<Result<Uint8Array, ProductCloudStorageError>>;
     /**
      * Compute the CID for data without uploading.
      *
-     * Async because the underlying hash is computed via Web Crypto.
+     * Async because the underlying hash is computed via Web Crypto. Does not
+     * perform I/O, so it throws on invalid input rather than returning a Result.
      */
     computeCid(data: string | Uint8Array): Promise<string>;
 }
@@ -200,4 +208,4 @@ interface DotNsIdentitySignature {
     signature: Uint8Array;
 }
 
-export type { App as A, ChainApi as C, DotNsIdentitySignature as D, LocalStorageApi as L, SignMessageWithDotNsIdentityArgs as S, WalletApi as W, Account as a, AppConfig as b, CloudStorageApi as c, CloudStorageConfig as d };
+export type { Account as A, ChainApi as C, DotNsIdentitySignature as D, LocalStorageApi as L, SignMessageWithDotNsIdentityArgs as S, WalletApi as W, CloudStorageApi as a, App as b, AppConfig as c, CloudStorageConfig as d };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parity/product-sdk",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Unified SDK for building products in the Polkadot ecosystem - umbrella package",
   "type": "module",
   "sideEffects": false,
@@ -55,6 +55,10 @@
     "./wallet": {
       "import": "./dist/wallet/index.js",
       "types": "./dist/wallet/index.d.ts"
+    },
+    "./testing": {
+      "import": "./dist/testing/index.js",
+      "types": "./dist/testing/index.d.ts"
     }
   },
   "files": [
@@ -64,16 +68,18 @@
   "dependencies": {
     "polkadot-api": "^2.1.6",
     "@parity/product-sdk-address": "0.1.1",
-    "@parity/product-sdk-host": "0.12.0",
+    "@parity/product-sdk-cloud-storage": "0.7.0",
+    "@parity/product-sdk-contracts": "0.9.0",
+    "@parity/product-sdk-chain-client": "0.8.0",
+    "@parity/product-sdk-host": "0.13.0",
     "@parity/product-sdk-crypto": "0.1.1",
-    "@parity/product-sdk-cloud-storage": "0.6.7",
-    "@parity/product-sdk-contracts": "0.8.3",
-    "@parity/product-sdk-chain-client": "0.7.7",
-    "@parity/product-sdk-keys": "0.3.13",
-    "@parity/product-sdk-local-storage": "0.2.12",
+    "@parity/product-sdk-keys": "0.3.14",
     "@parity/product-sdk-logger": "0.1.1",
-    "@parity/product-sdk-signer": "0.9.0",
-    "@parity/product-sdk-tx": "0.2.17"
+    "@parity/product-sdk-errors": "0.2.0",
+    "@parity/product-sdk-signer": "0.10.0",
+    "@parity/product-sdk-local-storage": "0.3.0",
+    "@parity/result": "0.2.0",
+    "@parity/product-sdk-tx": "0.3.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"
@@ -100,6 +106,7 @@
   "license": "Apache-2.0",
   "scripts": {
     "build": "NODE_OPTIONS=--max-old-space-size=8192 tsup",
+    "test": "vitest run",
     "clean": "rm -rf dist"
   }
 }

package/src/core/createApp.ts

@@ -21,9 +21,11 @@ import { createLocalKvStore } from "@parity/product-sdk-local-storage";
 import { SignerManager } from "@parity/product-sdk-signer";
 import {
     CloudStorageClient,
+    ProductCloudStorageError,
     calculateCid,
     createLazySigner,
 } from "@parity/product-sdk-cloud-storage";
+import { err, ok } from "@parity/result";
 import {
     createChainClient,
     getClient,
@@ -170,20 +172,28 @@ export async function createApp(config: AppConfig): Promise<App> {
         ? {
               upload: async (data) => {
                   const bytes = typeof data === "string" ? new TextEncoder().encode(data) : data;
-                  // Explicitly request a DAG-PB manifest so chunked uploads always
-                  // resolve to a single root CID. Without this, AsyncBulletinClient
-                  // can return `result.cid: undefined` for chunked-without-manifest
-                  // uploads — but CloudStorageApi.upload promises a string return, and
-                  // app consumers expect a CID they can hand to `fetch(cid)`. Keep
-                  // the defensive null-check below as belt-and-braces in case the
-                  // upstream contract shifts.
-                  const result = await cloudStorageClient.store(bytes).withManifest(true).send();
-                  if (!result.cid) {
-                      throw new Error(
-                          "Cloud storage upload returned no CID despite .withManifest(true). Upstream contract may have shifted — file an issue.",
-                      );
+                  try {
+                      // Explicitly request a DAG-PB manifest so chunked uploads always
+                      // resolve to a single root CID. Without this, AsyncBulletinClient
+                      // can return `result.cid: undefined` for chunked-without-manifest
+                      // uploads — but app consumers expect a CID they can hand to
+                      // `fetch(cid)`, so treat a missing CID as an error.
+                      const uploaded = await cloudStorageClient
+                          .store(bytes)
+                          .withManifest(true)
+                          .send();
+                      if (!uploaded.cid) {
+                          return err(
+                              new ProductCloudStorageError(
+                                  "Cloud storage upload returned no CID despite .withManifest(true). Upstream contract may have shifted — file an issue.",
+                              ),
+                          );
+                      }
+                      return ok(uploaded.cid.toString());
+                  } catch (cause) {
+                      const message = cause instanceof Error ? cause.message : String(cause);
+                      return err(new ProductCloudStorageError(message, { cause }));
                   }
-                  return result.cid.toString();
               },
               fetch: (cid) => cloudStorageClient.fetchBytes(cid),
               computeCid: async (data) => {

package/src/core/types.ts

@@ -5,7 +5,11 @@
  */
 
 import type { LogLevel } from "@parity/product-sdk-logger";
-import type { CloudStorageEnvironment } from "@parity/product-sdk-cloud-storage";
+import type {
+    CloudStorageEnvironment,
+    ProductCloudStorageError,
+} from "@parity/product-sdk-cloud-storage";
+import type { Result } from "@parity/result";
 import type { ChainClient } from "@parity/product-sdk-chain-client";
 import type { PeopleUsernameChain } from "../identity/dotns.js";
 import type { ChainDefinition, TypedApi, PolkadotClient } from "polkadot-api";
@@ -136,16 +140,23 @@ export interface CloudStorageApi {
     /**
      * Upload data to the Cloud.
      *
-     * Requires a wallet to be connected and an account selected. Throws
-     * "No signer available …" otherwise.
+     * Requires a wallet to be connected and an account selected.
+     *
+     * @returns A {@link Result}: `ok(cid)` on success, or `err(ProductCloudStorageError)`
+     *   if the upload fails (no signer, network rejection, or no CID returned).
+     */
+    upload(data: string | Uint8Array): Promise<Result<string, ProductCloudStorageError>>;
+    /**
+     * Fetch data by CID.
+     *
+     * @returns A {@link Result}: `ok(bytes)` on success, or `err(ProductCloudStorageError)`.
      */
-    upload(data: string | Uint8Array): Promise<string>;
-    /** Fetch data by CID. */
-    fetch(cid: string): Promise<Uint8Array>;
+    fetch(cid: string): Promise<Result<Uint8Array, ProductCloudStorageError>>;
     /**
      * Compute the CID for data without uploading.
      *
-     * Async because the underlying hash is computed via Web Crypto.
+     * Async because the underlying hash is computed via Web Crypto. Does not
+     * perform I/O, so it throws on invalid input rather than returning a Result.
      */
     computeCid(data: string | Uint8Array): Promise<string>;
 }

package/src/index.ts

@@ -45,6 +45,14 @@ export type {
 } from "./core/types.js";
 export type { LogEntry, LogHandler, LoggerConfig, Logger } from "./core/logger.js";
 
+// The throw→Result model. Every fallible SDK operation returns `Result<T, E>`.
+// `Result`/`ok`/`err`/`isErrorOf` come from the generic `@parity/result`; the
+// cross-package `SdkError` marker (`isSdkError` recognizes any error raised by
+// an `@parity/product-sdk-*` package) lives in `@parity/product-sdk-errors`.
+export { ok, err, isErrorOf } from "@parity/result";
+export type { Result } from "@parity/result";
+export { type SdkError, isSdkError } from "@parity/product-sdk-errors";
+
 // Re-export common utilities from leaf packages
 export { isInsideContainer, isInsideContainerSync } from "@parity/product-sdk-host";
 export { createChainClient } from "@parity/product-sdk-chain-client";

package/src/testing.ts

@@ -0,0 +1,297 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Test fakes for `@parity/product-sdk` (umbrella).
+ *
+ * `createFakeApp` returns a fake {@link App} — use it directly in logic tests or
+ * hand it to `ProductSDKContext.Provider` for React component tests, so code that
+ * calls `useProductSDK()` / `useWallet()` runs with no host. This entry also
+ * re-exports every package's fakes, for a single meta-package import.
+ *
+ * @packageDocumentation
+ */
+import { ProductCloudStorageError } from "@parity/product-sdk-cloud-storage";
+import { createFakeHostLocalStorage } from "@parity/product-sdk-local-storage/testing";
+import { err, ok, unwrapErr, unwrapOk } from "@parity/result";
+
+import type {
+    Account,
+    App,
+    ChainApi,
+    CloudStorageApi,
+    LocalStorageApi,
+    WalletApi,
+} from "./core/types.js";
+
+const textEncoder = new TextEncoder();
+
+// Re-export the per-package fakes so `@parity/product-sdk/testing` is a one-stop import.
+// statement-store is deliberately absent: the umbrella doesn't wrap that package, so apps
+// using it depend on it directly — import `@parity/product-sdk-statement-store/testing`
+// there instead. Re-exporting its fake here would add a dependency the umbrella otherwise
+// doesn't have and could skew against the version the app actually installs.
+export * from "@parity/product-sdk-local-storage/testing";
+export * from "@parity/product-sdk-signer/testing";
+export * from "@parity/product-sdk-contracts/testing";
+export * from "@parity/product-sdk-host/testing";
+
+/** Configurable behavior for the fake {@link WalletApi}. */
+export interface FakeWalletOptions {
+    /** Accounts `connect()` / `getAccounts()` expose. Default: none. */
+    accounts?: Account[];
+    /** Initially selected account. Default: the first account, or `null`. */
+    selected?: Account | null;
+    /** Bytes returned by `signMessage` / `createProof`. Default: 64 zero bytes. */
+    signature?: Uint8Array;
+    /** Value returned by `getProductAccount()`. Default: the selected account. */
+    productAccount?: Account | null;
+    /** Value returned by `getAnonymousAlias()`. Default: `null`. */
+    anonymousAlias?: string | null;
+}
+
+/** Options for {@link createFakeApp}. */
+export interface CreateFakeAppOptions {
+    /** App name reported by `getAppInfo()`. Default: `"fake-app"`. */
+    name?: string;
+    /** Configure the fake wallet. */
+    wallet?: FakeWalletOptions;
+    /** Override the local-storage API. Default: in-memory (backed by `createFakeHostLocalStorage`). */
+    localStorage?: LocalStorageApi;
+    /** Override the chain API. Default: unconfigured (throws until you provide one). */
+    chain?: ChainApi;
+    /** Override cloud storage, or pass `null` to disable it. Default: an in-memory fake. */
+    cloudStorage?: CloudStorageApi | null;
+}
+
+function makeFakeWallet(options?: FakeWalletOptions): WalletApi {
+    const accounts = options?.accounts ?? [];
+    let selected = options?.selected !== undefined ? options.selected : (accounts[0] ?? null);
+    const signature = options?.signature ?? new Uint8Array(64);
+    const listeners = new Set<(account: Account | null) => void>();
+    const notify = () => {
+        for (const l of listeners) l(selected);
+    };
+
+    return {
+        async connect() {
+            return { accounts };
+        },
+        async disconnect() {
+            selected = null;
+            notify();
+        },
+        getAccounts() {
+            return accounts;
+        },
+        getSelectedAccount() {
+            return selected;
+        },
+        selectAccount(address) {
+            selected = accounts.find((a) => a.address === address) ?? null;
+            notify();
+        },
+        async signMessage() {
+            return signature;
+        },
+        async signMessageWithDotNsIdentity(args) {
+            return {
+                username: args.username ?? "alice",
+                accountId: `0x${"00".repeat(32)}`,
+                signature,
+            };
+        },
+        onAccountChange(callback) {
+            listeners.add(callback);
+            return () => {
+                listeners.delete(callback);
+            };
+        },
+        getProductAccount() {
+            return options?.productAccount !== undefined ? options.productAccount : selected;
+        },
+        getAnonymousAlias() {
+            return options?.anonymousAlias ?? null;
+        },
+        async createProof() {
+            return signature;
+        },
+    };
+}
+
+function makeFakeLocalStorage(): LocalStorageApi {
+    // Compose the local-storage fake; mirror createApp's adapter semantics
+    // (get normalizes "" -> null, getJSON normalizes undefined -> null).
+    const host = createFakeHostLocalStorage();
+    return {
+        async get(key) {
+            return (await host.readString(key)) || null;
+        },
+        async set(key, value) {
+            await host.writeString(key, value);
+        },
+        async getJSON<T>(key: string) {
+            return ((await host.readJSON(key)) ?? null) as T | null;
+        },
+        async setJSON<T>(key: string, value: T) {
+            await host.writeJSON(key, value);
+        },
+        async remove(key) {
+            await host.clear(key);
+        },
+        async clear() {
+            // Unlike the production adapter (a no-op in container mode), the fake
+            // actually empties, so tests get real isolation.
+            host.reset();
+        },
+    };
+}
+
+function makeFakeCloudStorage(): CloudStorageApi {
+    const store = new Map<string, Uint8Array>();
+    const toBytes = (data: string | Uint8Array) =>
+        typeof data === "string" ? textEncoder.encode(data) : data;
+    // Deterministic content-addressed id so upload / computeCid / fetch line up.
+    const cidOf = (bytes: Uint8Array) => {
+        let h = 0x811c9dc5;
+        for (const b of bytes) {
+            h ^= b;
+            h = Math.imul(h, 0x01000193);
+        }
+        return `bafyfake${(h >>> 0).toString(16).padStart(8, "0")}`;
+    };
+    return {
+        async upload(data) {
+            const bytes = toBytes(data);
+            const cid = cidOf(bytes);
+            store.set(cid, bytes);
+            return ok(cid);
+        },
+        async fetch(cid) {
+            const bytes = store.get(cid);
+            if (!bytes) {
+                return err(
+                    new ProductCloudStorageError(
+                        `fake cloud storage: no object stored for CID ${cid}`,
+                    ),
+                );
+            }
+            return ok(bytes);
+        },
+        async computeCid(data) {
+            return cidOf(toBytes(data));
+        },
+    };
+}
+
+function makeUnconfiguredChain(): ChainApi {
+    const fail = (): never => {
+        throw new Error(
+            "createFakeApp: `chain` is not configured. Pass a `chain` override in options. " +
+                "There is no chain-read fake — the host owns RPC selection; test chain-reading " +
+                "logic behind your own interface and cover the real wiring in e2e.",
+        );
+    };
+    // Reads throw (fail fast, no silent undefined); state queries stay quiet.
+    return {
+        getClient: fail,
+        getRawClient: fail,
+        connect: fail,
+        isConnected: () => false,
+        destroyAll: () => {},
+    };
+}
+
+/**
+ * Create a fake {@link App}. Wallet, local-storage, and cloud-storage are working
+ * in-memory fakes; `chain` is unconfigured until you override it. Every sub-API
+ * is overridable.
+ *
+ * @example
+ * ```ts
+ * import { createFakeApp } from "@parity/product-sdk/testing";
+ *
+ * const app = createFakeApp({ wallet: { accounts: [alice, bob], selected: alice } });
+ * await app.wallet.connect();
+ * expect(app.wallet.getAccounts()).toHaveLength(2);
+ * ```
+ *
+ * For React, feed the fake to the exported context:
+ * ```tsx
+ * import { ProductSDKContext } from "@parity/product-sdk/react";
+ * render(<ProductSDKContext.Provider value={app}><AccountPicker /></ProductSDKContext.Provider>);
+ * ```
+ */
+export function createFakeApp(options?: CreateFakeAppOptions): App {
+    const name = options?.name ?? "fake-app";
+    return {
+        wallet: makeFakeWallet(options?.wallet),
+        localStorage: options?.localStorage ?? makeFakeLocalStorage(),
+        chain: options?.chain ?? makeUnconfiguredChain(),
+        cloudStorage:
+            options?.cloudStorage !== undefined ? options.cloudStorage : makeFakeCloudStorage(),
+        getAppInfo: () => ({ name }),
+    };
+}
+
+if (import.meta.vitest) {
+    const { describe, test, expect } = import.meta.vitest;
+
+    const alice: Account = { address: "5Alice", name: "Alice", source: "dev" };
+    const bob: Account = { address: "5Bob", name: "Bob", source: "dev" };
+
+    describe("createFakeApp", () => {
+        test("wallet lists, selects, and notifies on account change", async () => {
+            const app = createFakeApp({ wallet: { accounts: [alice, bob], selected: alice } });
+            expect(app.wallet.getAccounts()).toHaveLength(2);
+            expect(app.wallet.getSelectedAccount()).toEqual(alice);
+
+            let changed: Account | null = null;
+            app.wallet.onAccountChange((a) => {
+                changed = a;
+            });
+            app.wallet.selectAccount("5Bob");
+            expect(app.wallet.getSelectedAccount()).toEqual(bob);
+            expect(changed).toEqual(bob);
+
+            const { accounts } = await app.wallet.connect();
+            expect(accounts).toHaveLength(2);
+        });
+
+        test("localStorage round-trips and clear empties it", async () => {
+            const app = createFakeApp();
+            await app.localStorage.set("k", "v");
+            await app.localStorage.setJSON("o", { n: 1 });
+            expect(await app.localStorage.get("k")).toBe("v");
+            expect(await app.localStorage.getJSON("o")).toEqual({ n: 1 });
+            expect(await app.localStorage.get("missing")).toBeNull();
+
+            await app.localStorage.clear();
+            expect(await app.localStorage.get("k")).toBeNull();
+        });
+
+        test("cloudStorage round-trips upload -> fetch; computeCid matches upload", async () => {
+            const cs = createFakeApp().cloudStorage;
+            if (!cs) throw new Error("expected default cloud storage");
+            const cid = unwrapOk(await cs.upload("hello"));
+            expect(await cs.computeCid("hello")).toBe(cid);
+            expect(new TextDecoder().decode(unwrapOk(await cs.fetch(cid)))).toBe("hello");
+            expect(unwrapErr(await cs.fetch("bafyfakemissing"))).toBeInstanceOf(
+                ProductCloudStorageError,
+            );
+        });
+
+        test("cloudStorage can be disabled with null", () => {
+            expect(createFakeApp({ cloudStorage: null }).cloudStorage).toBeNull();
+        });
+
+        test("chain is unconfigured by default", () => {
+            const app = createFakeApp();
+            expect(app.chain.isConnected({} as never)).toBe(false);
+            expect(() => app.chain.getClient({} as never)).toThrow(/not configured/);
+        });
+
+        test("getAppInfo reports the name", () => {
+            expect(createFakeApp({ name: "my-app" }).getAppInfo().name).toBe("my-app");
+        });
+    });
+}

package/dist/chunk-6MNKFIU6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/createApp.ts"],"names":[],"mappings":"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","file":"chunk-6MNKFIU6.js","sourcesContent":["// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * createApp - Main entry point for the Product SDK\n *\n * Creates an App instance with wallet, storage, chain, and cloud storage APIs.\n */\n\nimport type { ChainDefinition } from \"polkadot-api\";\nimport type {\n    App,\n    AppConfig,\n    WalletApi,\n    ChainApi,\n    Account,\n    CloudStorageApi,\n    LocalStorageApi,\n} from \"./types.js\";\nimport { configure, createLogger } from \"@parity/product-sdk-logger\";\nimport { createLocalKvStore } from \"@parity/product-sdk-local-storage\";\nimport { SignerManager } from \"@parity/product-sdk-signer\";\nimport {\n    CloudStorageClient,\n    calculateCid,\n    createLazySigner,\n} from \"@parity/product-sdk-cloud-storage\";\nimport {\n    createChainClient,\n    getClient,\n    isConnected,\n    destroyAll,\n} from \"@parity/product-sdk-chain-client\";\nimport { getAccountsProvider } from \"@parity/product-sdk-host\";\nimport {\n    accountIdHexToBytes,\n    type PeopleUsernameQueryApi,\n    resolvePeopleUsernameOwner,\n} from \"../identity/dotns.js\";\n\nconst log = createLogger(\"app\");\n\n/**\n * Create a new Product SDK app instance\n *\n * @param config - Application configuration\n * @returns App instance with all APIs\n *\n * @example\n * ```ts\n * import { createApp } from '@parity/product-sdk';\n *\n * // Default: cloud storage enabled with paseo environment\n * const app = await createApp({\n *   name: 'my-app',\n *   logLevel: 'info',\n * });\n *\n * // Custom cloud storage environment\n * const prodApp = await createApp({\n *   name: 'my-app',\n *   cloudStorage: { environment: 'polkadot' },\n * });\n *\n * // Disable cloud storage entirely\n * const noCloudStorageApp = await createApp({\n *   name: 'my-app',\n *   cloudStorage: false,\n * });\n *\n * // Connect wallet\n * const { accounts } = await app.wallet.connect();\n *\n * // Use storage\n * await app.localStorage.set('key', 'value');\n *\n * // Use cloud storage (check for null if it might be disabled)\n * if (app.cloudStorage) {\n *   const cid = await app.cloudStorage.upload('hello world');\n * }\n * ```\n */\nexport async function createApp(config: AppConfig): Promise<App> {\n    // Set log level if specified\n    if (config.logLevel) {\n        configure({ level: config.logLevel });\n    }\n\n    log.info(\"Creating Product SDK app\", { name: config.name });\n\n    // Initialize storage (container-only - will throw if not in container)\n    const localKvStore = await createLocalKvStore({ prefix: config.name });\n\n    // Initialize signer manager\n    const signerManager = new SignerManager({\n        dappName: config.name,\n    });\n\n    // Initialize cloud storage client (configurable, defaults to paseo).\n    //\n    // The signer is wrapped lazily so the cloud storage client can be built before\n    // an account is selected. Uploads will throw a clear error if no signer\n    // is available at submission time. Reads (fetch / fetchJson) don't need\n    // a signer, so they work regardless of whether an account is selected --\n    // but they are container-only and throw CloudStorageHostUnavailableError\n    // outside a host container (no IPFS-gateway fallback).\n    const cloudStorageEnabled = config.cloudStorage !== false;\n    const cloudStorageEnvironment =\n        typeof config.cloudStorage === \"object\" ? config.cloudStorage.environment : \"paseo\";\n    const cloudStorageClient = cloudStorageEnabled\n        ? await CloudStorageClient.create({\n              environment: cloudStorageEnvironment,\n              signer: createLazySigner(() => signerManager.getSigner()),\n          })\n        : null;\n\n    if (cloudStorageEnabled) {\n        log.debug(\"Cloud Storage client (Bulletin) initialized\", {\n            environment: cloudStorageEnvironment,\n        });\n    } else {\n        log.debug(\"Cloud Storage client disabled\");\n    }\n\n    // Create storage API adapter\n    const localStorageApi: LocalStorageApi = {\n        get: (key) => localKvStore.get(key),\n        set: (key, value) => localKvStore.set(key, value),\n        getJSON: <T>(key: string) => localKvStore.getJSON<T>(key),\n        setJSON: <T>(key: string, value: T) => localKvStore.setJSON(key, value),\n        remove: (key) => localKvStore.remove(key),\n        clear: async () => {\n            // LocalKvStore doesn't have clear - this is a no-op\n            log.debug(\"clear() is not supported in container storage mode\");\n        },\n    };\n\n    // Create wallet API adapter\n    const walletApi = createWalletApi(signerManager);\n\n    // Create chain API\n    const chainApi: ChainApi = {\n        getClient(descriptor) {\n            log.debug(\"getClient called\", { genesis: descriptor.genesis });\n            const client = getClient(descriptor);\n            return client.getTypedApi(descriptor);\n        },\n\n        getRawClient(descriptor) {\n            log.debug(\"getRawClient called\", { genesis: descriptor.genesis });\n            return getClient(descriptor);\n        },\n\n        async connect<T extends Record<string, ChainDefinition>>(chains: T) {\n            log.debug(\"connect called\", { chains: Object.keys(chains) });\n            return createChainClient({ chains });\n        },\n\n        isConnected(descriptor) {\n            return isConnected(descriptor);\n        },\n\n        destroyAll() {\n            log.debug(\"destroyAll called\");\n            destroyAll();\n        },\n    };\n\n    // Create Cloud Storage API adapter (null if disabled)\n    const cloudStorageApi: CloudStorageApi | null = cloudStorageClient\n        ? {\n              upload: async (data) => {\n                  const bytes = typeof data === \"string\" ? new TextEncoder().encode(data) : data;\n                  // Explicitly request a DAG-PB manifest so chunked uploads always\n                  // resolve to a single root CID. Without this, AsyncBulletinClient\n                  // can return `result.cid: undefined` for chunked-without-manifest\n                  // uploads — but CloudStorageApi.upload promises a string return, and\n                  // app consumers expect a CID they can hand to `fetch(cid)`. Keep\n                  // the defensive null-check below as belt-and-braces in case the\n                  // upstream contract shifts.\n                  const result = await cloudStorageClient.store(bytes).withManifest(true).send();\n                  if (!result.cid) {\n                      throw new Error(\n                          \"Cloud storage upload returned no CID despite .withManifest(true). Upstream contract may have shifted — file an issue.\",\n                      );\n                  }\n                  return result.cid.toString();\n              },\n              fetch: (cid) => cloudStorageClient.fetchBytes(cid),\n              computeCid: async (data) => {\n                  const bytes = typeof data === \"string\" ? new TextEncoder().encode(data) : data;\n                  const cid = await calculateCid(bytes);\n                  return cid.toString();\n              },\n          }\n        : null;\n\n    log.info(\"Product SDK app created\", {\n        name: config.name,\n        cloudStorage: cloudStorageEnabled ? cloudStorageEnvironment : \"disabled\",\n    });\n\n    return {\n        wallet: walletApi,\n        localStorage: localStorageApi,\n        chain: chainApi,\n        cloudStorage: cloudStorageApi,\n        getAppInfo: () => ({ ...config }),\n    };\n}\n\n/**\n * Create wallet API adapter using SignerManager from leaf package\n */\nfunction createWalletApi(signerManager: SignerManager): WalletApi {\n    // Track account change subscribers\n    const accountChangeSubscribers = new Set<(account: Account | null) => void>();\n\n    // Subscribe to signer manager state changes\n    signerManager.subscribe((state) => {\n        const account = state.selectedAccount\n            ? {\n                  address: state.selectedAccount.address,\n                  name: state.selectedAccount.name ?? undefined,\n                  source: state.selectedAccount.source,\n              }\n            : null;\n        for (const callback of accountChangeSubscribers) {\n            try {\n                callback(account);\n            } catch (e) {\n                log.warn(\"Account change callback threw\", { error: e });\n            }\n        }\n    });\n\n    return {\n        async connect(): Promise<{ accounts: Account[] }> {\n            const result = await signerManager.connect();\n            if (!result.ok) {\n                throw new Error(result.error.message);\n            }\n            return {\n                accounts: result.value.map((a) => ({\n                    address: a.address,\n                    name: a.name ?? undefined,\n                    source: a.source,\n                })),\n            };\n        },\n\n        async disconnect(): Promise<void> {\n            signerManager.disconnect();\n        },\n\n        getAccounts(): Account[] {\n            return signerManager.getState().accounts.map((a) => ({\n                address: a.address,\n                name: a.name ?? undefined,\n                source: a.source,\n            }));\n        },\n\n        getSelectedAccount(): Account | null {\n            const selected = signerManager.getState().selectedAccount;\n            if (!selected) return null;\n            return {\n                address: selected.address,\n                name: selected.name ?? undefined,\n                source: selected.source,\n            };\n        },\n\n        selectAccount(address: string): void {\n            signerManager.selectAccount(address);\n        },\n\n        async signMessage(message: string | Uint8Array): Promise<Uint8Array> {\n            const bytes = typeof message === \"string\" ? new TextEncoder().encode(message) : message;\n            const result = await signerManager.signRaw(bytes);\n            if (!result.ok) {\n                throw new Error(result.error.message);\n            }\n            return result.value;\n        },\n\n        async signMessageWithDotNsIdentity(args) {\n            const message =\n                typeof args.message === \"string\"\n                    ? new TextEncoder().encode(args.message)\n                    : args.message;\n            const accountsProvider = await getHostAccountsProvider();\n            const username = args.username ?? (await getPrimaryUsername(accountsProvider));\n\n            // Reuse an already-connected People chain when the caller has\n            // wired one up via `app.chain.connect({ ..., <name>: peopleChain })`.\n            // Fall back to opening a transient connection so first-time users\n            // don't have to think about chain lifecycles. The chain-client\n            // module caches by genesis fingerprint, so subsequent\n            // signMessageWithDotNsIdentity calls share whichever connection\n            // got established first.\n            const peopleClient = isConnected(args.peopleChain)\n                ? getClient(args.peopleChain)\n                : await createChainClient({ chains: { people: args.peopleChain } }).then(\n                      (c) => c.raw.people,\n                  );\n            // PAPI's `TypedApi.query.X.Y.getValue` is variadic\n            // (`...args: [...WithCallOptions<Args>]`) so it's not assignable\n            // to our deliberately-narrow `(key) => Promise<...>` shape. The\n            // resolver only ever passes the storage key; the cast adapts the\n            // wider PAPI surface to the minimum we depend on.\n            const peopleApi = peopleClient.getTypedApi(\n                args.peopleChain,\n            ) as unknown as PeopleUsernameQueryApi;\n            const accountId = await resolvePeopleUsernameOwner(username, peopleApi);\n            if (!accountId) {\n                throw new Error(`No account owns DotNS username \"${username}\"`);\n            }\n\n            const owner = accountIdHexToBytes(accountId);\n            const signer = accountsProvider.getLegacyAccountSigner({\n                publicKey: owner,\n                name: username,\n            });\n\n            try {\n                return {\n                    username,\n                    accountId,\n                    signature: await signer.signBytes(message),\n                };\n            } catch (cause) {\n                throw new Error(\n                    `Failed to sign with DotNS username \"${username}\": ${\n                        cause instanceof Error ? cause.message : String(cause)\n                    }`,\n                    { cause },\n                );\n            }\n        },\n\n        onAccountChange(callback: (account: Account | null) => void): () => void {\n            accountChangeSubscribers.add(callback);\n            return () => accountChangeSubscribers.delete(callback);\n        },\n\n        getProductAccount(): Account | null {\n            // Product accounts require async call - this sync API can't support it properly\n            // Users should use SignerManager.getProductAccount() directly\n            log.warn(\n                \"getProductAccount() is deprecated - use SignerManager.getProductAccount() directly\",\n            );\n            return null;\n        },\n\n        getAnonymousAlias(): string | null {\n            // Anonymous aliases require async call - this sync API can't support it properly\n            // Users should use SignerManager.getProductAccountAlias() directly\n            log.warn(\n                \"getAnonymousAlias() is deprecated - use SignerManager.getProductAccountAlias() directly\",\n            );\n            return null;\n        },\n\n        async createProof(_message: Uint8Array): Promise<Uint8Array> {\n            // Ring VRF proofs require SignerManager.createRingVRFProof() directly\n            throw new Error(\n                \"createProof() is not implemented in the App API. \" +\n                    \"Use SignerManager.createRingVRFProof() directly.\",\n            );\n        },\n    };\n}\n\ntype HostAccountsProvider = NonNullable<Awaited<ReturnType<typeof getAccountsProvider>>>;\n\nasync function getHostAccountsProvider(): Promise<HostAccountsProvider> {\n    const provider = await getAccountsProvider();\n    if (!provider) {\n        throw new Error(\"Host accounts provider is not available\");\n    }\n    return provider;\n}\n\nasync function getPrimaryUsername(accountsProvider: HostAccountsProvider): Promise<string> {\n    const result = await accountsProvider.getUserId().match(\n        (value) => value,\n        (err) => {\n            throw err;\n        },\n    );\n    const username = result.primaryUsername.trim();\n    if (!username) {\n        throw new Error(\"Host identity did not provide a primary DotNS username\");\n    }\n    return username;\n}\n"]}