@parity/product-sdk 0.0.0-dev.312.0

package/dist/react/index.js

@@ -0,0 +1,198 @@
+import { createApp } from '../chunk-DHRCWMY5.js';
+import '../chunk-BRZNHTLQ.js';
+import { createContext, useContext, useState, useEffect, useCallback, useMemo } from 'react';
+import { jsx, Fragment } from 'react/jsx-runtime';
+
+var ProductSDKContext = createContext(null);
+function useProductSDK() {
+  const app = useContext(ProductSDKContext);
+  if (!app) {
+    throw new Error(
+      'useProductSDK must be used within a ProductSDKProvider. Wrap your app with <ProductSDKProvider name="your-app">.'
+    );
+  }
+  return app;
+}
+function ProductSDKProvider({
+  name,
+  logLevel = "info",
+  children,
+  fallback = null
+}) {
+  const [app, setApp] = useState(null);
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    let mounted = true;
+    createApp({ name, logLevel }).then((createdApp) => {
+      if (mounted) {
+        setApp(createdApp);
+      }
+    }).catch((e) => {
+      if (mounted) {
+        setError(e instanceof Error ? e : new Error(String(e)));
+      }
+    });
+    return () => {
+      mounted = false;
+    };
+  }, [name, logLevel]);
+  if (error) {
+    throw error;
+  }
+  if (!app) {
+    return /* @__PURE__ */ jsx(Fragment, { children: fallback });
+  }
+  return /* @__PURE__ */ jsx(ProductSDKContext.Provider, { value: app, children });
+}
+function useWallet() {
+  const app = useProductSDK();
+  const [state, setState] = useState({
+    isConnected: false,
+    isConnecting: false,
+    accounts: [],
+    selectedAccount: null,
+    error: null
+  });
+  const connect = useCallback(async () => {
+    setState((s) => ({ ...s, isConnecting: true, error: null }));
+    try {
+      const result = await app.wallet.connect();
+      setState((s) => ({
+        ...s,
+        isConnected: true,
+        isConnecting: false,
+        accounts: result.accounts,
+        selectedAccount: result.accounts[0] || null
+      }));
+    } catch (e) {
+      setState((s) => ({
+        ...s,
+        isConnecting: false,
+        error: e instanceof Error ? e : new Error(String(e))
+      }));
+    }
+  }, [app]);
+  const disconnect = useCallback(async () => {
+    await app.wallet.disconnect();
+    setState({
+      isConnected: false,
+      isConnecting: false,
+      accounts: [],
+      selectedAccount: null,
+      error: null
+    });
+  }, [app]);
+  const selectAccount = useCallback(
+    (address) => {
+      app.wallet.selectAccount(address);
+      const account = state.accounts.find((a) => a.address === address) || null;
+      setState((s) => ({ ...s, selectedAccount: account }));
+    },
+    [app, state.accounts]
+  );
+  const signMessage = useCallback(
+    async (message) => {
+      return app.wallet.signMessage(message);
+    },
+    [app]
+  );
+  const signMessageWithDotNsIdentity = useCallback(
+    async (args) => {
+      return app.wallet.signMessageWithDotNsIdentity(args);
+    },
+    [app]
+  );
+  useEffect(() => {
+    const unsubscribe = app.wallet.onAccountChange((account) => {
+      setState((s) => ({ ...s, selectedAccount: account }));
+    });
+    return unsubscribe;
+  }, [app]);
+  return {
+    ...state,
+    connect,
+    disconnect,
+    selectAccount,
+    signMessage,
+    signMessageWithDotNsIdentity
+  };
+}
+function useLocalStorage(key, defaultValue) {
+  const app = useProductSDK();
+  const [value, setValue] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    let mounted = true;
+    const loadValue = async () => {
+      try {
+        setLoading(true);
+        const stored = await app.localStorage.getJSON(key);
+        if (mounted) {
+          setValue(stored ?? defaultValue ?? null);
+          setLoading(false);
+        }
+      } catch (e) {
+        if (mounted) {
+          setError(e instanceof Error ? e : new Error(String(e)));
+          setLoading(false);
+        }
+      }
+    };
+    loadValue();
+    return () => {
+      mounted = false;
+    };
+  }, [app, key, defaultValue]);
+  const setStoredValue = useCallback(
+    async (newValue) => {
+      try {
+        setError(null);
+        await app.localStorage.setJSON(key, newValue);
+        setValue(newValue);
+      } catch (e) {
+        setError(e instanceof Error ? e : new Error(String(e)));
+        throw e;
+      }
+    },
+    [app, key]
+  );
+  return [value, setStoredValue, { loading, error }];
+}
+function useLocalStorageString(key, defaultValue) {
+  const app = useProductSDK();
+  const [value, setValue] = useState(null);
+  const [loading, setLoading] = useState(true);
+  useEffect(() => {
+    let mounted = true;
+    const loadValue = async () => {
+      const stored = await app.localStorage.get(key);
+      if (mounted) {
+        setValue(stored ?? defaultValue ?? null);
+        setLoading(false);
+      }
+    };
+    loadValue();
+    return () => {
+      mounted = false;
+    };
+  }, [app, key, defaultValue]);
+  const setStoredValue = useCallback(
+    async (newValue) => {
+      await app.localStorage.set(key, newValue);
+      setValue(newValue);
+    },
+    [app, key]
+  );
+  return [value, setStoredValue, { loading }];
+}
+function useChain(chain) {
+  const app = useProductSDK();
+  return useMemo(() => {
+    return app.chain.getClient(chain);
+  }, [app, chain]);
+}
+
+export { ProductSDKContext, ProductSDKProvider, useChain, useLocalStorage, useLocalStorageString, useProductSDK, useWallet };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/context.ts","../../src/react/provider.tsx","../../src/react/useWallet.ts","../../src/react/useLocalStorage.ts","../../src/react/useChain.ts"],"names":["useState","useEffect","useCallback"],"mappings":"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","file":"index.js","sourcesContent":["// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * React context for Product SDK\n */\n\nimport { createContext, useContext } from \"react\";\nimport type { App } from \"../core/types.js\";\n\n/** Context for the Product SDK app instance */\nexport const ProductSDKContext = createContext<App | null>(null);\n\n/**\n * Hook to access the Product SDK app instance\n *\n * @throws If used outside of ProductSDKProvider\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const app = useProductSDK();\n *   // Use app.wallet, app.localStorage, etc.\n * }\n * ```\n */\nexport function useProductSDK(): App {\n    const app = useContext(ProductSDKContext);\n    if (!app) {\n        throw new Error(\n            \"useProductSDK must be used within a ProductSDKProvider. \" +\n                'Wrap your app with <ProductSDKProvider name=\"your-app\">.',\n        );\n    }\n    return app;\n}\n","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * ProductSDKProvider component\n */\n\nimport React, { useEffect, useState, type ReactNode } from \"react\";\nimport { ProductSDKContext } from \"./context.js\";\nimport { createApp } from \"../core/createApp.js\";\nimport type { App, LogLevel } from \"../core/types.js\";\n\n/** Props for ProductSDKProvider */\nexport interface ProductSDKProviderProps {\n    /** Application name - used for storage namespacing and product account derivation */\n    name: string;\n    /** Log level (default: 'info') */\n    logLevel?: LogLevel;\n    /** Child components */\n    children: ReactNode;\n    /** Fallback to show while loading */\n    fallback?: ReactNode;\n}\n\n/**\n * Provider component that initializes the Product SDK\n *\n * @example\n * ```tsx\n * import { ProductSDKProvider } from '@parity/product-sdk/react';\n *\n * function App() {\n *   return (\n *     <ProductSDKProvider name=\"my-app\" fallback={<Loading />}>\n *       <MyApp />\n *     </ProductSDKProvider>\n *   );\n * }\n * ```\n */\nexport function ProductSDKProvider({\n    name,\n    logLevel = \"info\",\n    children,\n    fallback = null,\n}: ProductSDKProviderProps) {\n    const [app, setApp] = useState<App | null>(null);\n    const [error, setError] = useState<Error | null>(null);\n\n    useEffect(() => {\n        let mounted = true;\n\n        createApp({ name, logLevel })\n            .then((createdApp) => {\n                if (mounted) {\n                    setApp(createdApp);\n                }\n            })\n            .catch((e) => {\n                if (mounted) {\n                    setError(e instanceof Error ? e : new Error(String(e)));\n                }\n            });\n\n        return () => {\n            mounted = false;\n        };\n    }, [name, logLevel]);\n\n    if (error) {\n        throw error;\n    }\n\n    if (!app) {\n        return <>{fallback}</>;\n    }\n\n    return <ProductSDKContext.Provider value={app}>{children}</ProductSDKContext.Provider>;\n}\n","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * useWallet hook\n */\n\nimport { useState, useEffect, useCallback } from \"react\";\nimport { useProductSDK } from \"./context.js\";\nimport type {\n    Account,\n    DotNsIdentitySignature,\n    SignMessageWithDotNsIdentityArgs,\n} from \"../core/types.js\";\n\n/** Wallet hook state */\nexport interface UseWalletState {\n    /** Whether wallet is connected */\n    isConnected: boolean;\n    /** Whether connection is in progress */\n    isConnecting: boolean;\n    /** Available accounts */\n    accounts: Account[];\n    /** Currently selected account */\n    selectedAccount: Account | null;\n    /** Last error */\n    error: Error | null;\n}\n\n/** Wallet hook actions */\nexport interface UseWalletActions {\n    /** Connect to wallet */\n    connect: () => Promise<void>;\n    /** Disconnect from wallet */\n    disconnect: () => Promise<void>;\n    /** Select an account */\n    selectAccount: (address: string) => void;\n    /** Sign a message */\n    signMessage: (message: string | Uint8Array) => Promise<Uint8Array>;\n    /** Sign a message with the account that owns a DotNS / People username identity. */\n    signMessageWithDotNsIdentity: (\n        args: SignMessageWithDotNsIdentityArgs,\n    ) => Promise<DotNsIdentitySignature>;\n}\n\n/** Return type of useWallet */\nexport type UseWalletReturn = UseWalletState & UseWalletActions;\n\n/**\n * Hook for wallet connection and signing\n *\n * @example\n * ```tsx\n * function WalletButton() {\n *   const { isConnected, accounts, connect, disconnect, selectAccount } = useWallet();\n *\n *   if (!isConnected) {\n *     return <button onClick={connect}>Connect Wallet</button>;\n *   }\n *\n *   return (\n *     <div>\n *       <select onChange={(e) => selectAccount(e.target.value)}>\n *         {accounts.map((a) => (\n *           <option key={a.address} value={a.address}>\n *             {a.name || a.address}\n *           </option>\n *         ))}\n *       </select>\n *       <button onClick={disconnect}>Disconnect</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useWallet(): UseWalletReturn {\n    const app = useProductSDK();\n\n    const [state, setState] = useState<UseWalletState>({\n        isConnected: false,\n        isConnecting: false,\n        accounts: [],\n        selectedAccount: null,\n        error: null,\n    });\n\n    const connect = useCallback(async () => {\n        setState((s) => ({ ...s, isConnecting: true, error: null }));\n        try {\n            const result = await app.wallet.connect();\n            setState((s) => ({\n                ...s,\n                isConnected: true,\n                isConnecting: false,\n                accounts: result.accounts,\n                selectedAccount: result.accounts[0] || null,\n            }));\n        } catch (e) {\n            setState((s) => ({\n                ...s,\n                isConnecting: false,\n                error: e instanceof Error ? e : new Error(String(e)),\n            }));\n        }\n    }, [app]);\n\n    const disconnect = useCallback(async () => {\n        await app.wallet.disconnect();\n        setState({\n            isConnected: false,\n            isConnecting: false,\n            accounts: [],\n            selectedAccount: null,\n            error: null,\n        });\n    }, [app]);\n\n    const selectAccount = useCallback(\n        (address: string) => {\n            app.wallet.selectAccount(address);\n            const account = state.accounts.find((a) => a.address === address) || null;\n            setState((s) => ({ ...s, selectedAccount: account }));\n        },\n        [app, state.accounts],\n    );\n\n    const signMessage = useCallback(\n        async (message: string | Uint8Array) => {\n            return app.wallet.signMessage(message);\n        },\n        [app],\n    );\n\n    const signMessageWithDotNsIdentity = useCallback(\n        async (args: SignMessageWithDotNsIdentityArgs) => {\n            return app.wallet.signMessageWithDotNsIdentity(args);\n        },\n        [app],\n    );\n\n    // Subscribe to account changes\n    useEffect(() => {\n        const unsubscribe = app.wallet.onAccountChange((account) => {\n            setState((s) => ({ ...s, selectedAccount: account }));\n        });\n        return unsubscribe;\n    }, [app]);\n\n    return {\n        ...state,\n        connect,\n        disconnect,\n        selectAccount,\n        signMessage,\n        signMessageWithDotNsIdentity,\n    };\n}\n","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * useLocalStorage hook\n */\n\nimport { useState, useEffect, useCallback } from \"react\";\nimport { useProductSDK } from \"./context.js\";\n\n/**\n * Hook for key-value storage operations\n *\n * @param key - Storage key\n * @param defaultValue - Default value if key doesn't exist\n *\n * @example\n * ```tsx\n * function ThemeToggle() {\n *   const [theme, setTheme, { loading }] = useLocalStorage('theme', 'light');\n *\n *   if (loading) return <div>Loading...</div>;\n *\n *   return (\n *     <button onClick={() => setTheme(theme === 'light' ? 'dark' : 'light')}>\n *       Current: {theme}\n *     </button>\n *   );\n * }\n * ```\n */\nexport function useLocalStorage<T = string>(\n    key: string,\n    defaultValue?: T,\n): [T | null, (value: T) => Promise<void>, { loading: boolean; error: Error | null }] {\n    const app = useProductSDK();\n\n    const [value, setValue] = useState<T | null>(null);\n    const [loading, setLoading] = useState(true);\n    const [error, setError] = useState<Error | null>(null);\n\n    // Load initial value\n    useEffect(() => {\n        let mounted = true;\n\n        const loadValue = async () => {\n            try {\n                setLoading(true);\n                const stored = await app.localStorage.getJSON<T>(key);\n                if (mounted) {\n                    setValue(stored ?? defaultValue ?? null);\n                    setLoading(false);\n                }\n            } catch (e) {\n                if (mounted) {\n                    setError(e instanceof Error ? e : new Error(String(e)));\n                    setLoading(false);\n                }\n            }\n        };\n\n        loadValue();\n\n        return () => {\n            mounted = false;\n        };\n    }, [app, key, defaultValue]);\n\n    const setStoredValue = useCallback(\n        async (newValue: T) => {\n            try {\n                setError(null);\n                await app.localStorage.setJSON(key, newValue);\n                setValue(newValue);\n            } catch (e) {\n                setError(e instanceof Error ? e : new Error(String(e)));\n                throw e;\n            }\n        },\n        [app, key],\n    );\n\n    return [value, setStoredValue, { loading, error }];\n}\n\n/**\n * Hook for string storage (simpler API)\n *\n * @param key - Storage key\n * @param defaultValue - Default value\n */\nexport function useLocalStorageString(\n    key: string,\n    defaultValue?: string,\n): [string | null, (value: string) => Promise<void>, { loading: boolean }] {\n    const app = useProductSDK();\n\n    const [value, setValue] = useState<string | null>(null);\n    const [loading, setLoading] = useState(true);\n\n    useEffect(() => {\n        let mounted = true;\n\n        const loadValue = async () => {\n            const stored = await app.localStorage.get(key);\n            if (mounted) {\n                setValue(stored ?? defaultValue ?? null);\n                setLoading(false);\n            }\n        };\n\n        loadValue();\n\n        return () => {\n            mounted = false;\n        };\n    }, [app, key, defaultValue]);\n\n    const setStoredValue = useCallback(\n        async (newValue: string) => {\n            await app.localStorage.set(key, newValue);\n            setValue(newValue);\n        },\n        [app, key],\n    );\n\n    return [value, setStoredValue, { loading }];\n}\n","// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * useChain hook\n */\n\nimport { useMemo } from \"react\";\nimport { useProductSDK } from \"./context.js\";\nimport type { ChainDefinition, TypedApi } from \"../core/types.js\";\n\n/**\n * Hook to get a typed chain client\n *\n * @param chain - Chain descriptor (PAPI ChainDefinition)\n *\n * @example\n * ```tsx\n * import { paseo_asset_hub } from '@parity/product-sdk-descriptors/paseo-asset-hub';\n * import { useChain } from '@parity/product-sdk/react';\n *\n * function AssetHubBalance() {\n *   const assetHub = useChain(paseo_asset_hub);\n *\n *   // assetHub is typed for Asset Hub queries\n *   const balance = await assetHub.query.System.Account.getValue(address);\n * }\n * ```\n */\nexport function useChain<T extends ChainDefinition>(chain: T): TypedApi<T> {\n    const app = useProductSDK();\n\n    return useMemo(() => {\n        return app.chain.getClient(chain);\n    }, [app, chain]);\n}\n"]}

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-B5Zx4RNq.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-bswWAmR2.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":";;;;;;;;;AAyBA,IAAM,WAAA,GAAc,IAAI,WAAA,EAAY;AAwCpC,SAAS,eAAe,OAAA,EAAwC;AAC5D,EAAA,MAAM,QAAA,GAAW,OAAA,EAAS,QAAA,IAAY,EAAC;AACvC,EAAA,IAAI,QAAA,GAAW,SAAS,QAAA,KAAa,MAAA,GAAY,QAAQ,QAAA,GAAY,QAAA,CAAS,CAAC,CAAA,IAAK,IAAA;AACpF,EAAA,MAAM,SAAA,GAAY,OAAA,EAAS,SAAA,IAAa,IAAI,WAAW,EAAE,CAAA;AACzD,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAuC;AAC7D,EAAA,MAAM,SAAS,MAAM;AACjB,IAAA,KAAA,MAAW,CAAA,IAAK,SAAA,EAAW,CAAA,CAAE,QAAQ,CAAA;AAAA,EACzC,CAAA;AAEA,EAAA,OAAO;AAAA,IACH,MAAM,OAAA,GAAU;AACZ,MAAA,OAAO,EAAE,QAAA,EAAS;AAAA,IACtB,CAAA;AAAA,IACA,MAAM,UAAA,GAAa;AACf,MAAA,QAAA,GAAW,IAAA;AACX,MAAA,MAAA,EAAO;AAAA,IACX,CAAA;AAAA,IACA,WAAA,GAAc;AACV,MAAA,OAAO,QAAA;AAAA,IACX,CAAA;AAAA,IACA,kBAAA,GAAqB;AACjB,MAAA,OAAO,QAAA;AAAA,IACX,CAAA;AAAA,IACA,cAAc,OAAA,EAAS;AACnB,MAAA,QAAA,GAAW,SAAS,IAAA,CAAK,CAAC,MAAM,CAAA,CAAE,OAAA,KAAY,OAAO,CAAA,IAAK,IAAA;AAC1D,MAAA,MAAA,EAAO;AAAA,IACX,CAAA;AAAA,IACA,MAAM,WAAA,GAAc;AAChB,MAAA,OAAO,SAAA;AAAA,IACX,CAAA;AAAA,IACA,MAAM,6BAA6B,IAAA,EAAM;AACrC,MAAA,OAAO;AAAA,QACH,QAAA,EAAU,KAAK,QAAA,IAAY,OAAA;AAAA,QAC3B,SAAA,EAAW,CAAA,EAAA,EAAK,IAAA,CAAK,MAAA,CAAO,EAAE,CAAC,CAAA,CAAA;AAAA,QAC/B;AAAA,OACJ;AAAA,IACJ,CAAA;AAAA,IACA,gBAAgB,QAAA,EAAU;AACtB,MAAA,SAAA,CAAU,IAAI,QAAQ,CAAA;AACtB,MAAA,OAAO,MAAM;AACT,QAAA,SAAA,CAAU,OAAO,QAAQ,CAAA;AAAA,MAC7B,CAAA;AAAA,IACJ,CAAA;AAAA,IACA,iBAAA,GAAoB;AAChB,MAAA,OAAO,OAAA,EAAS,cAAA,KAAmB,MAAA,GAAY,OAAA,CAAQ,cAAA,GAAiB,QAAA;AAAA,IAC5E,CAAA;AAAA,IACA,iBAAA,GAAoB;AAChB,MAAA,OAAO,SAAS,cAAA,IAAkB,IAAA;AAAA,IACtC,CAAA;AAAA,IACA,MAAM,WAAA,GAAc;AAChB,MAAA,OAAO,SAAA;AAAA,IACX;AAAA,GACJ;AACJ;AAEA,SAAS,oBAAA,GAAwC;AAG7C,EAAA,MAAM,OAAO,0BAAA,EAA2B;AACxC,EAAA,OAAO;AAAA,IACH,MAAM,IAAI,GAAA,EAAK;AACX,MAAA,OAAQ,MAAM,IAAA,CAAK,UAAA,CAAW,GAAG,CAAA,IAAM,IAAA;AAAA,IAC3C,CAAA;AAAA,IACA,MAAM,GAAA,CAAI,GAAA,EAAK,KAAA,EAAO;AAClB,MAAA,MAAM,IAAA,CAAK,WAAA,CAAY,GAAA,EAAK,KAAK,CAAA;AAAA,IACrC,CAAA;AAAA,IACA,MAAM,QAAW,GAAA,EAAa;AAC1B,MAAA,OAAS,MAAM,IAAA,CAAK,QAAA,CAAS,GAAG,CAAA,IAAM,IAAA;AAAA,IAC1C,CAAA;AAAA,IACA,MAAM,OAAA,CAAW,GAAA,EAAa,KAAA,EAAU;AACpC,MAAA,MAAM,IAAA,CAAK,SAAA,CAAU,GAAA,EAAK,KAAK,CAAA;AAAA,IACnC,CAAA;AAAA,IACA,MAAM,OAAO,GAAA,EAAK;AACd,MAAA,MAAM,IAAA,CAAK,MAAM,GAAG,CAAA;AAAA,IACxB,CAAA;AAAA,IACA,MAAM,KAAA,GAAQ;AAGV,MAAA,IAAA,CAAK,KAAA,EAAM;AAAA,IACf;AAAA,GACJ;AACJ;AAEA,SAAS,oBAAA,GAAwC;AAC7C,EAAA,MAAM,KAAA,uBAAY,GAAA,EAAwB;AAC1C,EAAA,MAAM,OAAA,GAAU,CAAC,IAAA,KACb,OAAO,SAAS,QAAA,GAAW,WAAA,CAAY,MAAA,CAAO,IAAI,CAAA,GAAI,IAAA;AAE1D,EAAA,MAAM,KAAA,GAAQ,CAAC,KAAA,KAAsB;AACjC,IAAA,IAAI,CAAA,GAAI,UAAA;AACR,IAAA,KAAA,MAAW,KAAK,KAAA,EAAO;AACnB,MAAA,CAAA,IAAK,CAAA;AACL,MAAA,CAAA,GAAI,IAAA,CAAK,IAAA,CAAK,CAAA,EAAG,QAAU,CAAA;AAAA,IAC/B;AACA,IAAA,OAAO,CAAA,QAAA,EAAA,CAAY,MAAM,CAAA,EAAG,QAAA,CAAS,EAAE,CAAA,CAAE,QAAA,CAAS,CAAA,EAAG,GAAG,CAAC,CAAA,CAAA;AAAA,EAC7D,CAAA;AACA,EAAA,OAAO;AAAA,IACH,MAAM,OAAO,IAAA,EAAM;AACf,MAAA,MAAM,KAAA,GAAQ,QAAQ,IAAI,CAAA;AAC1B,MAAA,MAAM,GAAA,GAAM,MAAM,KAAK,CAAA;AACvB,MAAA,KAAA,CAAM,GAAA,CAAI,KAAK,KAAK,CAAA;AACpB,MAAA,OAAO,GAAG,GAAG,CAAA;AAAA,IACjB,CAAA;AAAA,IACA,MAAM,MAAM,GAAA,EAAK;AACb,MAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,GAAA,CAAI,GAAG,CAAA;AAC3B,MAAA,IAAI,CAAC,KAAA,EAAO;AACR,QAAA,OAAO,GAAA;AAAA,UACH,IAAI,wBAAA;AAAA,YACA,gDAAgD,GAAG,CAAA;AAAA;AACvD,SACJ;AAAA,MACJ;AACA,MAAA,OAAO,GAAG,KAAK,CAAA;AAAA,IACnB,CAAA;AAAA,IACA,MAAM,WAAW,IAAA,EAAM;AACnB,MAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAC,CAAA;AAAA,IAC9B;AAAA,GACJ;AACJ;AAEA,SAAS,qBAAA,GAAkC;AACvC,EAAA,MAAM,OAAO,MAAa;AACtB,IAAA,MAAM,IAAI,KAAA;AAAA,MACN;AAAA,KAGJ;AAAA,EACJ,CAAA;AAEA,EAAA,OAAO;AAAA,IACH,SAAA,EAAW,IAAA;AAAA,IACX,YAAA,EAAc,IAAA;AAAA,IACd,OAAA,EAAS,IAAA;AAAA,IACT,aAAa,MAAM,KAAA;AAAA,IACnB,YAAY,MAAM;AAAA,IAAC;AAAA,GACvB;AACJ;AAsBO,SAAS,cAAc,OAAA,EAAqC;AAC/D,EAAA,MAAM,IAAA,GAAO,SAAS,IAAA,IAAQ,UAAA;AAC9B,EAAA,OAAO;AAAA,IACH,MAAA,EAAQ,cAAA,CAAe,OAAA,EAAS,MAAM,CAAA;AAAA,IACtC,YAAA,EAAc,OAAA,EAAS,YAAA,IAAgB,oBAAA,EAAqB;AAAA,IAC5D,KAAA,EAAO,OAAA,EAAS,KAAA,IAAS,qBAAA,EAAsB;AAAA,IAC/C,cACI,OAAA,EAAS,YAAA,KAAiB,MAAA,GAAY,OAAA,CAAQ,eAAe,oBAAA,EAAqB;AAAA,IACtF,UAAA,EAAY,OAAO,EAAE,IAAA,EAAK;AAAA,GAC9B;AACJ","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"]}