@parity/product-sdk 0.6.0 → 0.7.0

package/dist/address/index.d.ts

@@ -1,8 +1,8 @@
 export * from '@parity/product-sdk-address';
-import '@parity/product-sdk-bulletin';
+import '@parity/product-sdk-cloud-storage';
 import '@parity/product-sdk-chain-client';
 import '@parity/product-sdk-contracts';
 import '@parity/product-sdk-crypto';
 import '@parity/product-sdk-host';
-import '@parity/product-sdk-storage';
+import '@parity/product-sdk-local-storage';
 import '@parity/product-sdk-signer';

package/dist/{chunk-6W3TCR3W.js → chunk-4U2FP26I.js}

@@ -1,7 +1,7 @@
 import { createLogger, configure } from '@parity/product-sdk-logger';
-import { createKvStore } from '@parity/product-sdk-storage';
+import { createLocalKvStore } from '@parity/product-sdk-local-storage';
 import { SignerManager } from '@parity/product-sdk-signer';
-import { BulletinClient, createLazySigner, calculateCid } from '@parity/product-sdk-bulletin';
+import { CloudStorageClient, createLazySigner, calculateCid } from '@parity/product-sdk-cloud-storage';
 import { destroyAll, isConnected, createChainClient, getClient } from '@parity/product-sdk-chain-client';
 
 // src/core/createApp.ts
@@ -11,27 +11,29 @@ async function createApp(config) {
     configure({ level: config.logLevel });
   }
   log.info("Creating Product SDK app", { name: config.name });
-  const kvStore = await createKvStore({ prefix: config.name });
+  const localKvStore = await createLocalKvStore({ prefix: config.name });
   const signerManager = new SignerManager({
     dappName: config.name
   });
-  const bulletinEnabled = config.bulletin !== false;
-  const bulletinEnvironment = typeof config.bulletin === "object" ? config.bulletin.environment : "paseo";
-  const bulletinClient = bulletinEnabled ? await BulletinClient.create({
-    environment: bulletinEnvironment,
+  const cloudStorageEnabled = config.cloudStorage !== false;
+  const cloudStorageEnvironment = typeof config.cloudStorage === "object" ? config.cloudStorage.environment : "paseo";
+  const cloudStorageClient = cloudStorageEnabled ? await CloudStorageClient.create({
+    environment: cloudStorageEnvironment,
     signer: createLazySigner(() => signerManager.getSigner())
   }) : null;
-  if (bulletinEnabled) {
-    log.debug("Bulletin client initialized", { environment: bulletinEnvironment });
+  if (cloudStorageEnabled) {
+    log.debug("Cloud Storage client (Bulletin) initialized", {
+      environment: cloudStorageEnvironment
+    });
   } else {
-    log.debug("Bulletin client disabled");
+    log.debug("Cloud Storage client disabled");
   }
-  const storageApi = {
-    get: (key) => kvStore.get(key),
-    set: (key, value) => kvStore.set(key, value),
-    getJSON: (key) => kvStore.getJSON(key),
-    setJSON: (key, value) => kvStore.setJSON(key, value),
-    remove: (key) => kvStore.remove(key),
+  const localStorageApi = {
+    get: (key) => localKvStore.get(key),
+    set: (key, value) => localKvStore.set(key, value),
+    getJSON: (key) => localKvStore.getJSON(key),
+    setJSON: (key, value) => localKvStore.setJSON(key, value),
+    remove: (key) => localKvStore.remove(key),
     clear: async () => {
       log.debug("clear() is not supported in container storage mode");
     }
@@ -62,18 +64,18 @@ async function createApp(config) {
       destroyAll();
     }
   };
-  const bulletinApi = bulletinClient ? {
+  const cloudStorageApi = cloudStorageClient ? {
     upload: async (data) => {
       const bytes = typeof data === "string" ? new TextEncoder().encode(data) : data;
-      const result = await bulletinClient.store(bytes).withManifest(true).send();
+      const result = await cloudStorageClient.store(bytes).withManifest(true).send();
       if (!result.cid) {
         throw new Error(
-          "Bulletin upload returned no CID despite .withManifest(true). Upstream contract may have shifted \u2014 file an issue."
+          "Cloud storage upload returned no CID despite .withManifest(true). Upstream contract may have shifted \u2014 file an issue."
         );
       }
       return result.cid.toString();
     },
-    fetch: (cid) => bulletinClient.fetchBytes(cid),
+    fetch: (cid) => cloudStorageClient.fetchBytes(cid),
     computeCid: async (data) => {
       const bytes = typeof data === "string" ? new TextEncoder().encode(data) : data;
       const cid = await calculateCid(bytes);
@@ -82,13 +84,13 @@ async function createApp(config) {
   } : null;
   log.info("Product SDK app created", {
     name: config.name,
-    bulletin: bulletinEnabled ? bulletinEnvironment : "disabled"
+    cloudStorage: cloudStorageEnabled ? cloudStorageEnvironment : "disabled"
   });
   return {
     wallet: walletApi,
-    storage: storageApi,
+    localStorage: localStorageApi,
     chain: chainApi,
-    bulletin: bulletinApi,
+    cloudStorage: cloudStorageApi,
     getAppInfo: () => ({ ...config })
   };
 }
@@ -177,5 +179,5 @@ function createWalletApi(signerManager) {
 }
 
 export { createApp };
-//# sourceMappingURL=chunk-6W3TCR3W.js.map
-//# sourceMappingURL=chunk-6W3TCR3W.js.map
+//# sourceMappingURL=chunk-4U2FP26I.js.map
+//# sourceMappingURL=chunk-4U2FP26I.js.map

package/dist/chunk-4U2FP26I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/createApp.ts"],"names":[],"mappings":"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","file":"chunk-4U2FP26I.js","sourcesContent":["/**\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\";\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 and work regardless.\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            // Build empty rpcs object (required by API but unused - host routes connections)\n            const rpcs = Object.fromEntries(\n                Object.keys(chains).map((k) => [k, [] as readonly string[]]),\n            ) as { [K in keyof T]: readonly string[] };\n            return createChainClient({ chains, rpcs });\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        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"]}

package/dist/cloud-storage/index.d.ts

@@ -0,0 +1 @@
+export * from '@parity/product-sdk-cloud-storage';

package/dist/cloud-storage/index.js

@@ -0,0 +1,3 @@
+export * from '@parity/product-sdk-cloud-storage';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/core/index.d.ts

@@ -1,9 +1,9 @@
 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, B as BulletinApi, c as BulletinConfig, C as ChainApi, S as StorageApi, W as WalletApi } from '../types-DVpAr2JN.js';
+export { a as Account, A as App, b as AppConfig, C as ChainApi, c as CloudStorageApi, d as CloudStorageConfig, L as LocalStorageApi, W as WalletApi } from '../types-AjDV1BTd.js';
 export { ChainClient } from '@parity/product-sdk-chain-client';
 export { ChainDefinition, PolkadotClient, TypedApi } from 'polkadot-api';
 import '@parity/product-sdk-host';
 import '@parity/product-sdk-signer';
-import '@parity/product-sdk-storage';
-import '@parity/product-sdk-bulletin';
+import '@parity/product-sdk-local-storage';
+import '@parity/product-sdk-cloud-storage';

package/dist/core/index.js

@@ -1,4 +1,4 @@
 export { configure, createLogger } from '../chunk-XSKBA5SR.js';
-export { createApp } from '../chunk-6W3TCR3W.js';
+export { createApp } from '../chunk-4U2FP26I.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -1,17 +1,17 @@
 export { LogEntry, LogHandler, LogLevel, Logger, LoggerConfig, configure, createLogger } from '@parity/product-sdk-logger';
-import { b as AppConfig, A as App } from './types-DVpAr2JN.js';
-export { a as Account, B as BulletinApi, C as ChainApi, S as StorageApi, W as WalletApi } from './types-DVpAr2JN.js';
+import { b as AppConfig, A as App } from './types-AjDV1BTd.js';
+export { a as Account, C as ChainApi, c as CloudStorageApi, L as LocalStorageApi, W as WalletApi } from './types-AjDV1BTd.js';
 export { isInsideContainer, isInsideContainerSync } from '@parity/product-sdk-host';
 export { ChainClient, createChainClient } from '@parity/product-sdk-chain-client';
 export { SignerManager } from '@parity/product-sdk-signer';
-export { createKvStore } from '@parity/product-sdk-storage';
-export { BulletinClient, calculateCid } from '@parity/product-sdk-bulletin';
+export { createLocalKvStore } from '@parity/product-sdk-local-storage';
+export { CloudStorageClient, calculateCid } from '@parity/product-sdk-cloud-storage';
 export { ChainDefinition, PolkadotClient, TypedApi } from 'polkadot-api';
 
 /**
  * createApp - Main entry point for the Product SDK
  *
- * Creates an App instance with wallet, storage, chain, and bulletin APIs.
+ * Creates an App instance with wallet, storage, chain, and cloud storage APIs.
  */
 
 /**
@@ -24,33 +24,33 @@ export { ChainDefinition, PolkadotClient, TypedApi } from 'polkadot-api';
  * ```ts
  * import { createApp } from '@parity/product-sdk';
  *
- * // Default: bulletin enabled with paseo environment
+ * // Default: cloud storage enabled with paseo environment
  * const app = await createApp({
  *   name: 'my-app',
  *   logLevel: 'info',
  * });
  *
- * // Custom bulletin environment
+ * // Custom cloud storage environment
  * const prodApp = await createApp({
  *   name: 'my-app',
- *   bulletin: { environment: 'polkadot' },
+ *   cloudStorage: { environment: 'polkadot' },
  * });
  *
- * // Disable bulletin entirely
- * const noBulletinApp = await createApp({
+ * // Disable cloud storage entirely
+ * const noCloudStorageApp = await createApp({
  *   name: 'my-app',
- *   bulletin: false,
+ *   cloudStorage: false,
  * });
  *
  * // Connect wallet
  * const { accounts } = await app.wallet.connect();
  *
  * // Use storage
- * await app.storage.set('key', 'value');
+ * await app.localStorage.set('key', 'value');
  *
- * // Use bulletin (check for null if it might be disabled)
- * if (app.bulletin) {
- *   const cid = await app.bulletin.upload('hello world');
+ * // Use cloud storage (check for null if it might be disabled)
+ * if (app.cloudStorage) {
+ *   const cid = await app.cloudStorage.upload('hello world');
  * }
  * ```
  */

package/dist/index.js

@@ -1,9 +1,9 @@
 export { configure, createLogger } from './chunk-XSKBA5SR.js';
-export { createApp } from './chunk-6W3TCR3W.js';
+export { createApp } from './chunk-4U2FP26I.js';
 export { isInsideContainer, isInsideContainerSync } from '@parity/product-sdk-host';
 export { createChainClient } from '@parity/product-sdk-chain-client';
 export { SignerManager } from '@parity/product-sdk-signer';
-export { createKvStore } from '@parity/product-sdk-storage';
-export { BulletinClient, calculateCid } from '@parity/product-sdk-bulletin';
+export { createLocalKvStore } from '@parity/product-sdk-local-storage';
+export { CloudStorageClient, calculateCid } from '@parity/product-sdk-cloud-storage';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/local-storage/index.d.ts

@@ -0,0 +1 @@
+export * from '@parity/product-sdk-local-storage';

package/dist/local-storage/index.js

@@ -0,0 +1,3 @@
+export * from '@parity/product-sdk-local-storage';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/react/index.d.ts

@@ -2,9 +2,9 @@ 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, a as Account } from '../types-DVpAr2JN.js';
+import { A as App, a as Account } from '../types-AjDV1BTd.js';
 import { ChainDefinition, TypedApi } from 'polkadot-api';
-import '@parity/product-sdk-bulletin';
+import '@parity/product-sdk-cloud-storage';
 import '@parity/product-sdk-chain-client';
 
 /** Props for ProductSDKProvider */
@@ -47,7 +47,7 @@ declare const ProductSDKContext: react.Context<App | null>;
  * ```tsx
  * function MyComponent() {
  *   const app = useProductSDK();
- *   // Use app.wallet, app.storage, etc.
+ *   // Use app.wallet, app.localStorage, etc.
  * }
  * ```
  */
@@ -113,7 +113,7 @@ type UseWalletReturn = UseWalletState & UseWalletActions;
 declare function useWallet(): UseWalletReturn;
 
 /**
- * useStorage hook
+ * useLocalStorage hook
  */
 /**
  * Hook for key-value storage operations
@@ -124,7 +124,7 @@ declare function useWallet(): UseWalletReturn;
  * @example
  * ```tsx
  * function ThemeToggle() {
- *   const [theme, setTheme, { loading }] = useStorage('theme', 'light');
+ *   const [theme, setTheme, { loading }] = useLocalStorage('theme', 'light');
  *
  *   if (loading) return <div>Loading...</div>;
  *
@@ -136,7 +136,7 @@ declare function useWallet(): UseWalletReturn;
  * }
  * ```
  */
-declare function useStorage<T = string>(key: string, defaultValue?: T): [T | null, (value: T) => Promise<void>, {
+declare function useLocalStorage<T = string>(key: string, defaultValue?: T): [T | null, (value: T) => Promise<void>, {
     loading: boolean;
     error: Error | null;
 }];
@@ -146,7 +146,7 @@ declare function useStorage<T = string>(key: string, defaultValue?: T): [T | nul
  * @param key - Storage key
  * @param defaultValue - Default value
  */
-declare function useStorageString(key: string, defaultValue?: string): [string | null, (value: string) => Promise<void>, {
+declare function useLocalStorageString(key: string, defaultValue?: string): [string | null, (value: string) => Promise<void>, {
     loading: boolean;
 }];
 
@@ -174,4 +174,4 @@ declare function useStorageString(key: string, defaultValue?: string): [string |
  */
 declare function useChain<T extends ChainDefinition>(chain: T): TypedApi<T>;
 
-export { ProductSDKContext, ProductSDKProvider, type ProductSDKProviderProps, type UseWalletActions, type UseWalletReturn, type UseWalletState, useChain, useProductSDK, useStorage, useStorageString, useWallet };
+export { ProductSDKContext, ProductSDKProvider, type ProductSDKProviderProps, type UseWalletActions, type UseWalletReturn, type UseWalletState, useChain, useLocalStorage, useLocalStorageString, useProductSDK, useWallet };

package/dist/react/index.js

@@ -1,4 +1,4 @@
-import { createApp } from '../chunk-6W3TCR3W.js';
+import { createApp } from '../chunk-4U2FP26I.js';
 import { createContext, useContext, useState, useEffect, useCallback, useMemo } from 'react';
 import { jsx, Fragment } from 'react/jsx-runtime';
 
@@ -109,7 +109,7 @@ function useWallet() {
     signMessage
   };
 }
-function useStorage(key, defaultValue) {
+function useLocalStorage(key, defaultValue) {
   const app = useProductSDK();
   const [value, setValue] = useState(null);
   const [loading, setLoading] = useState(true);
@@ -119,7 +119,7 @@ function useStorage(key, defaultValue) {
     const loadValue = async () => {
       try {
         setLoading(true);
-        const stored = await app.storage.getJSON(key);
+        const stored = await app.localStorage.getJSON(key);
         if (mounted) {
           setValue(stored ?? defaultValue ?? null);
           setLoading(false);
@@ -140,7 +140,7 @@ function useStorage(key, defaultValue) {
     async (newValue) => {
       try {
         setError(null);
-        await app.storage.setJSON(key, newValue);
+        await app.localStorage.setJSON(key, newValue);
         setValue(newValue);
       } catch (e) {
         setError(e instanceof Error ? e : new Error(String(e)));
@@ -151,14 +151,14 @@ function useStorage(key, defaultValue) {
   );
   return [value, setStoredValue, { loading, error }];
 }
-function useStorageString(key, defaultValue) {
+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.storage.get(key);
+      const stored = await app.localStorage.get(key);
       if (mounted) {
         setValue(stored ?? defaultValue ?? null);
         setLoading(false);
@@ -171,7 +171,7 @@ function useStorageString(key, defaultValue) {
   }, [app, key, defaultValue]);
   const setStoredValue = useCallback(
     async (newValue) => {
-      await app.storage.set(key, newValue);
+      await app.localStorage.set(key, newValue);
       setValue(newValue);
     },
     [app, key]
@@ -185,6 +185,6 @@ function useChain(chain) {
   }, [app, chain]);
 }
 
-export { ProductSDKContext, ProductSDKProvider, useChain, useProductSDK, useStorage, useStorageString, useWallet };
+export { ProductSDKContext, ProductSDKProvider, useChain, useLocalStorage, useLocalStorageString, useProductSDK, useWallet };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/react/context.ts","../../src/react/provider.tsx","../../src/react/useWallet.ts","../../src/react/useStorage.ts","../../src/react/useChain.ts"],"names":["useState","useEffect","useCallback"],"mappings":";;;;AAQO,IAAM,iBAAA,GAAoB,cAA0B,IAAI;AAexD,SAAS,aAAA,GAAqB;AACjC,EAAA,MAAM,GAAA,GAAM,WAAW,iBAAiB,CAAA;AACxC,EAAA,IAAI,CAAC,GAAA,EAAK;AACN,IAAA,MAAM,IAAI,KAAA;AAAA,MACN;AAAA,KAEJ;AAAA,EACJ;AACA,EAAA,OAAO,GAAA;AACX;ACKO,SAAS,kBAAA,CAAmB;AAAA,EAC/B,IAAA;AAAA,EACA,QAAA,GAAW,MAAA;AAAA,EACX,QAAA;AAAA,EACA,QAAA,GAAW;AACf,CAAA,EAA4B;AACxB,EAAA,MAAM,CAAC,GAAA,EAAK,MAAM,CAAA,GAAI,SAAqB,IAAI,CAAA;AAC/C,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,SAAuB,IAAI,CAAA;AAErD,EAAA,SAAA,CAAU,MAAM;AACZ,IAAA,IAAI,OAAA,GAAU,IAAA;AAEd,IAAA,SAAA,CAAU,EAAE,IAAA,EAAM,QAAA,EAAU,CAAA,CACvB,IAAA,CAAK,CAAC,UAAA,KAAe;AAClB,MAAA,IAAI,OAAA,EAAS;AACT,QAAA,MAAA,CAAO,UAAU,CAAA;AAAA,MACrB;AAAA,IACJ,CAAC,CAAA,CACA,KAAA,CAAM,CAAC,CAAA,KAAM;AACV,MAAA,IAAI,OAAA,EAAS;AACT,QAAA,QAAA,CAAS,CAAA,YAAa,QAAQ,CAAA,GAAI,IAAI,MAAM,MAAA,CAAO,CAAC,CAAC,CAAC,CAAA;AAAA,MAC1D;AAAA,IACJ,CAAC,CAAA;AAEL,IAAA,OAAO,MAAM;AACT,MAAA,OAAA,GAAU,KAAA;AAAA,IACd,CAAA;AAAA,EACJ,CAAA,EAAG,CAAC,IAAA,EAAM,QAAQ,CAAC,CAAA;AAEnB,EAAA,IAAI,KAAA,EAAO;AACP,IAAA,MAAM,KAAA;AAAA,EACV;AAEA,EAAA,IAAI,CAAC,GAAA,EAAK;AACN,IAAA,uCAAU,QAAA,EAAA,QAAA,EAAS,CAAA;AAAA,EACvB;AAEA,EAAA,2BAAQ,iBAAA,CAAkB,QAAA,EAAlB,EAA2B,KAAA,EAAO,KAAM,QAAA,EAAS,CAAA;AAC7D;ACXO,SAAS,SAAA,GAA6B;AACzC,EAAA,MAAM,MAAM,aAAA,EAAc;AAE1B,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,QAAAA,CAAyB;AAAA,IAC/C,WAAA,EAAa,KAAA;AAAA,IACb,YAAA,EAAc,KAAA;AAAA,IACd,UAAU,EAAC;AAAA,IACX,eAAA,EAAiB,IAAA;AAAA,IACjB,KAAA,EAAO;AAAA,GACV,CAAA;AAED,EAAA,MAAM,OAAA,GAAU,YAAY,YAAY;AACpC,IAAA,QAAA,CAAS,CAAC,OAAO,EAAE,GAAG,GAAG,YAAA,EAAc,IAAA,EAAM,KAAA,EAAO,IAAA,EAAK,CAAE,CAAA;AAC3D,IAAA,IAAI;AACA,MAAA,MAAM,MAAA,GAAS,MAAM,GAAA,CAAI,MAAA,CAAO,OAAA,EAAQ;AACxC,MAAA,QAAA,CAAS,CAAC,CAAA,MAAO;AAAA,QACb,GAAG,CAAA;AAAA,QACH,WAAA,EAAa,IAAA;AAAA,QACb,YAAA,EAAc,KAAA;AAAA,QACd,UAAU,MAAA,CAAO,QAAA;AAAA,QACjB,eAAA,EAAiB,MAAA,CAAO,QAAA,CAAS,CAAC,CAAA,IAAK;AAAA,OAC3C,CAAE,CAAA;AAAA,IACN,SAAS,CAAA,EAAG;AACR,MAAA,QAAA,CAAS,CAAC,CAAA,MAAO;AAAA,QACb,GAAG,CAAA;AAAA,QACH,YAAA,EAAc,KAAA;AAAA,QACd,KAAA,EAAO,aAAa,KAAA,GAAQ,CAAA,GAAI,IAAI,KAAA,CAAM,MAAA,CAAO,CAAC,CAAC;AAAA,OACvD,CAAE,CAAA;AAAA,IACN;AAAA,EACJ,CAAA,EAAG,CAAC,GAAG,CAAC,CAAA;AAER,EAAA,MAAM,UAAA,GAAa,YAAY,YAAY;AACvC,IAAA,MAAM,GAAA,CAAI,OAAO,UAAA,EAAW;AAC5B,IAAA,QAAA,CAAS;AAAA,MACL,WAAA,EAAa,KAAA;AAAA,MACb,YAAA,EAAc,KAAA;AAAA,MACd,UAAU,EAAC;AAAA,MACX,eAAA,EAAiB,IAAA;AAAA,MACjB,KAAA,EAAO;AAAA,KACV,CAAA;AAAA,EACL,CAAA,EAAG,CAAC,GAAG,CAAC,CAAA;AAER,EAAA,MAAM,aAAA,GAAgB,WAAA;AAAA,IAClB,CAAC,OAAA,KAAoB;AACjB,MAAA,GAAA,CAAI,MAAA,CAAO,cAAc,OAAO,CAAA;AAChC,MAAA,MAAM,OAAA,GAAU,MAAM,QAAA,CAAS,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,OAAA,KAAY,OAAO,CAAA,IAAK,IAAA;AACrE,MAAA,QAAA,CAAS,CAAC,CAAA,MAAO,EAAE,GAAG,CAAA,EAAG,eAAA,EAAiB,SAAQ,CAAE,CAAA;AAAA,IACxD,CAAA;AAAA,IACA,CAAC,GAAA,EAAK,KAAA,CAAM,QAAQ;AAAA,GACxB;AAEA,EAAA,MAAM,WAAA,GAAc,WAAA;AAAA,IAChB,OAAO,OAAA,KAAiC;AACpC,MAAA,OAAO,GAAA,CAAI,MAAA,CAAO,WAAA,CAAY,OAAO,CAAA;AAAA,IACzC,CAAA;AAAA,IACA,CAAC,GAAG;AAAA,GACR;AAGA,EAAAC,UAAU,MAAM;AACZ,IAAA,MAAM,WAAA,GAAc,GAAA,CAAI,MAAA,CAAO,eAAA,CAAgB,CAAC,OAAA,KAAY;AACxD,MAAA,QAAA,CAAS,CAAC,CAAA,MAAO,EAAE,GAAG,CAAA,EAAG,eAAA,EAAiB,SAAQ,CAAE,CAAA;AAAA,IACxD,CAAC,CAAA;AACD,IAAA,OAAO,WAAA;AAAA,EACX,CAAA,EAAG,CAAC,GAAG,CAAC,CAAA;AAER,EAAA,OAAO;AAAA,IACH,GAAG,KAAA;AAAA,IACH,OAAA;AAAA,IACA,UAAA;AAAA,IACA,aAAA;AAAA,IACA;AAAA,GACJ;AACJ;AC7GO,SAAS,UAAA,CACZ,KACA,YAAA,EACkF;AAClF,EAAA,MAAM,MAAM,aAAA,EAAc;AAE1B,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAID,SAAmB,IAAI,CAAA;AACjD,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAIA,SAAS,IAAI,CAAA;AAC3C,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,SAAuB,IAAI,CAAA;AAGrD,EAAAC,UAAU,MAAM;AACZ,IAAA,IAAI,OAAA,GAAU,IAAA;AAEd,IAAA,MAAM,YAAY,YAAY;AAC1B,MAAA,IAAI;AACA,QAAA,UAAA,CAAW,IAAI,CAAA;AACf,QAAA,MAAM,MAAA,GAAS,MAAM,GAAA,CAAI,OAAA,CAAQ,QAAW,GAAG,CAAA;AAC/C,QAAA,IAAI,OAAA,EAAS;AACT,UAAA,QAAA,CAAS,MAAA,IAAU,gBAAgB,IAAI,CAAA;AACvC,UAAA,UAAA,CAAW,KAAK,CAAA;AAAA,QACpB;AAAA,MACJ,SAAS,CAAA,EAAG;AACR,QAAA,IAAI,OAAA,EAAS;AACT,UAAA,QAAA,CAAS,CAAA,YAAa,QAAQ,CAAA,GAAI,IAAI,MAAM,MAAA,CAAO,CAAC,CAAC,CAAC,CAAA;AACtD,UAAA,UAAA,CAAW,KAAK,CAAA;AAAA,QACpB;AAAA,MACJ;AAAA,IACJ,CAAA;AAEA,IAAA,SAAA,EAAU;AAEV,IAAA,OAAO,MAAM;AACT,MAAA,OAAA,GAAU,KAAA;AAAA,IACd,CAAA;AAAA,EACJ,CAAA,EAAG,CAAC,GAAA,EAAK,GAAA,EAAK,YAAY,CAAC,CAAA;AAE3B,EAAA,MAAM,cAAA,GAAiBC,WAAAA;AAAA,IACnB,OAAO,QAAA,KAAgB;AACnB,MAAA,IAAI;AACA,QAAA,QAAA,CAAS,IAAI,CAAA;AACb,QAAA,MAAM,GAAA,CAAI,OAAA,CAAQ,OAAA,CAAQ,GAAA,EAAK,QAAQ,CAAA;AACvC,QAAA,QAAA,CAAS,QAAQ,CAAA;AAAA,MACrB,SAAS,CAAA,EAAG;AACR,QAAA,QAAA,CAAS,CAAA,YAAa,QAAQ,CAAA,GAAI,IAAI,MAAM,MAAA,CAAO,CAAC,CAAC,CAAC,CAAA;AACtD,QAAA,MAAM,CAAA;AAAA,MACV;AAAA,IACJ,CAAA;AAAA,IACA,CAAC,KAAK,GAAG;AAAA,GACb;AAEA,EAAA,OAAO,CAAC,KAAA,EAAO,cAAA,EAAgB,EAAE,OAAA,EAAS,OAAO,CAAA;AACrD;AAQO,SAAS,gBAAA,CACZ,KACA,YAAA,EACuE;AACvE,EAAA,MAAM,MAAM,aAAA,EAAc;AAE1B,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIF,SAAwB,IAAI,CAAA;AACtD,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAIA,SAAS,IAAI,CAAA;AAE3C,EAAAC,UAAU,MAAM;AACZ,IAAA,IAAI,OAAA,GAAU,IAAA;AAEd,IAAA,MAAM,YAAY,YAAY;AAC1B,MAAA,MAAM,MAAA,GAAS,MAAM,GAAA,CAAI,OAAA,CAAQ,IAAI,GAAG,CAAA;AACxC,MAAA,IAAI,OAAA,EAAS;AACT,QAAA,QAAA,CAAS,MAAA,IAAU,gBAAgB,IAAI,CAAA;AACvC,QAAA,UAAA,CAAW,KAAK,CAAA;AAAA,MACpB;AAAA,IACJ,CAAA;AAEA,IAAA,SAAA,EAAU;AAEV,IAAA,OAAO,MAAM;AACT,MAAA,OAAA,GAAU,KAAA;AAAA,IACd,CAAA;AAAA,EACJ,CAAA,EAAG,CAAC,GAAA,EAAK,GAAA,EAAK,YAAY,CAAC,CAAA;AAE3B,EAAA,MAAM,cAAA,GAAiBC,WAAAA;AAAA,IACnB,OAAO,QAAA,KAAqB;AACxB,MAAA,MAAM,GAAA,CAAI,OAAA,CAAQ,GAAA,CAAI,GAAA,EAAK,QAAQ,CAAA;AACnC,MAAA,QAAA,CAAS,QAAQ,CAAA;AAAA,IACrB,CAAA;AAAA,IACA,CAAC,KAAK,GAAG;AAAA,GACb;AAEA,EAAA,OAAO,CAAC,KAAA,EAAO,cAAA,EAAgB,EAAE,SAAS,CAAA;AAC9C;AClGO,SAAS,SAAoC,KAAA,EAAuB;AACvE,EAAA,MAAM,MAAM,aAAA,EAAc;AAE1B,EAAA,OAAO,QAAQ,MAAM;AACjB,IAAA,OAAO,GAAA,CAAI,KAAA,CAAM,SAAA,CAAU,KAAK,CAAA;AAAA,EACpC,CAAA,EAAG,CAAC,GAAA,EAAK,KAAK,CAAC,CAAA;AACnB","file":"index.js","sourcesContent":["/**\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.storage, 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","/**\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","/**\n * useWallet hook\n */\n\nimport { useState, useEffect, useCallback } from \"react\";\nimport { useProductSDK } from \"./context.js\";\nimport type { Account } 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}\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    // 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    };\n}\n","/**\n * useStorage 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 }] = useStorage('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 useStorage<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.storage.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.storage.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 useStorageString(\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.storage.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.storage.set(key, newValue);\n            setValue(newValue);\n        },\n        [app, key],\n    );\n\n    return [value, setStoredValue, { loading }];\n}\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"]}
+{"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":["/**\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","/**\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","/**\n * useWallet hook\n */\n\nimport { useState, useEffect, useCallback } from \"react\";\nimport { useProductSDK } from \"./context.js\";\nimport type { Account } 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}\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    // 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    };\n}\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","/**\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/{types-DVpAr2JN.d.ts → types-AjDV1BTd.d.ts}

@@ -1,5 +1,5 @@
 import { LogLevel } from '@parity/product-sdk-logger';
-import { BulletinEnvironment } from '@parity/product-sdk-bulletin';
+import { CloudStorageEnvironment } from '@parity/product-sdk-cloud-storage';
 import { ChainClient } from '@parity/product-sdk-chain-client';
 import { ChainDefinition, TypedApi, PolkadotClient } from 'polkadot-api';
 
@@ -7,10 +7,10 @@ import { ChainDefinition, TypedApi, PolkadotClient } from 'polkadot-api';
  * Core types for @parity/product-sdk
  */
 
-/** Bulletin configuration options */
-interface BulletinConfig {
-    /** Bulletin environment to connect to */
-    environment: BulletinEnvironment;
+/** Cloud Storage configuration options */
+interface CloudStorageConfig {
+    /** Cloud Storage environment to connect to */
+    environment: CloudStorageEnvironment;
 }
 /** Configuration for createApp */
 interface AppConfig {
@@ -19,11 +19,11 @@ interface AppConfig {
     /** Log level for SDK operations (default: 'info') */
     logLevel?: LogLevel;
     /**
-     * Bulletin Chain configuration.
+     * Cloud Storage configuration.
      * - Omit or pass config object to enable (default: { environment: "paseo" })
-     * - Pass `false` to disable bulletin initialization
+     * - Pass `false` to disable cloud storage initialization
      */
-    bulletin?: BulletinConfig | false;
+    cloudStorage?: CloudStorageConfig | false;
 }
 /** Wallet API exposed by the SDK */
 interface WalletApi {
@@ -51,7 +51,7 @@ interface WalletApi {
     createProof(message: Uint8Array): Promise<Uint8Array>;
 }
 /** Storage API exposed by the SDK */
-interface StorageApi {
+interface LocalStorageApi {
     /** Get a value by key */
     get(key: string): Promise<string | null>;
     /** Set a value by key */
@@ -107,10 +107,10 @@ interface ChainApi {
      */
     destroyAll(): void;
 }
-/** Bulletin Chain API exposed by the SDK */
-interface BulletinApi {
+/** Cloud Storage API exposed by the SDK */
+interface CloudStorageApi {
     /**
-     * Upload data to Bulletin Chain.
+     * Upload data to the Cloud.
      *
      * Requires a wallet to be connected and an account selected. Throws
      * "No signer available …" otherwise.
@@ -129,12 +129,12 @@ interface BulletinApi {
 interface App {
     /** Wallet/signing operations */
     wallet: WalletApi;
-    /** Key-value storage operations */
-    storage: StorageApi;
+    /** Local Key-value storage operations */
+    localStorage: LocalStorageApi;
     /** Chain interaction operations */
     chain: ChainApi;
-    /** Bulletin Chain operations (null if disabled via config) */
-    bulletin: BulletinApi | null;
+    /** Cloud Storage operations (null if disabled via config) */
+    cloudStorage: CloudStorageApi | null;
     /** Get app configuration */
     getAppInfo(): AppConfig;
 }
@@ -148,4 +148,4 @@ interface Account {
     source: string;
 }
 
-export type { App as A, BulletinApi as B, ChainApi as C, StorageApi as S, WalletApi as W, Account as a, AppConfig as b, BulletinConfig as c };
+export type { App as A, ChainApi as C, LocalStorageApi as L, WalletApi as W, Account as a, AppConfig as b, CloudStorageApi as c, CloudStorageConfig as d };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parity/product-sdk",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Unified SDK for building products in the Polkadot ecosystem - umbrella package",
   "type": "module",
   "sideEffects": false,
@@ -16,9 +16,9 @@
       "import": "./dist/address/index.js",
       "types": "./dist/address/index.d.ts"
     },
-    "./bulletin": {
-      "import": "./dist/bulletin/index.js",
-      "types": "./dist/bulletin/index.d.ts"
+    "./cloud-storage": {
+      "import": "./dist/cloud-storage/index.js",
+      "types": "./dist/cloud-storage/index.d.ts"
     },
     "./chain": {
       "import": "./dist/chain/index.js",
@@ -48,9 +48,9 @@
       "import": "./dist/react/index.js",
       "types": "./dist/react/index.d.ts"
     },
-    "./storage": {
-      "import": "./dist/storage/index.js",
-      "types": "./dist/storage/index.d.ts"
+    "./local-storage": {
+      "import": "./dist/local-storage/index.js",
+      "types": "./dist/local-storage/index.d.ts"
     },
     "./wallet": {
       "import": "./dist/wallet/index.js",
@@ -64,16 +64,16 @@
   "dependencies": {
     "polkadot-api": "^2.1.2",
     "@parity/product-sdk-address": "0.1.1",
-    "@parity/product-sdk-chain-client": "0.4.2",
-    "@parity/product-sdk-bulletin": "0.4.2",
+    "@parity/product-sdk-cloud-storage": "0.5.0",
+    "@parity/product-sdk-chain-client": "0.5.0",
+    "@parity/product-sdk-contracts": "0.6.0",
     "@parity/product-sdk-crypto": "0.1.1",
-    "@parity/product-sdk-host": "0.4.0",
-    "@parity/product-sdk-contracts": "0.5.1",
-    "@parity/product-sdk-keys": "0.3.0",
+    "@parity/product-sdk-host": "0.5.0",
+    "@parity/product-sdk-keys": "0.3.1",
     "@parity/product-sdk-logger": "0.1.1",
-    "@parity/product-sdk-signer": "0.3.0",
-    "@parity/product-sdk-storage": "0.1.5",
-    "@parity/product-sdk-tx": "0.2.4"
+    "@parity/product-sdk-signer": "0.4.0",
+    "@parity/product-sdk-tx": "0.2.5",
+    "@parity/product-sdk-local-storage": "0.2.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"
@@ -99,7 +99,7 @@
   ],
   "license": "Apache-2.0",
   "scripts": {
-    "build": "tsup",
+    "build": "NODE_OPTIONS=--max-old-space-size=8192 tsup",
     "clean": "rm -rf dist"
   }
 }

package/src/cloud-storage/index.ts

@@ -0,0 +1,6 @@
+/**
+ * @parity/product-sdk/bulletin
+ *
+ * Re-exports from @parity/product-sdk-cloud-storage.
+ */
+export * from "@parity/product-sdk-cloud-storage";

package/src/core/createApp.ts

@@ -1,7 +1,7 @@
 /**
  * createApp - Main entry point for the Product SDK
  *
- * Creates an App instance with wallet, storage, chain, and bulletin APIs.
+ * Creates an App instance with wallet, storage, chain, and cloud storage APIs.
  */
 
 import type { ChainDefinition } from "polkadot-api";
@@ -9,15 +9,19 @@ import type {
     App,
     AppConfig,
     WalletApi,
-    StorageApi,
     ChainApi,
-    BulletinApi,
     Account,
+    CloudStorageApi,
+    LocalStorageApi,
 } from "./types.js";
 import { configure, createLogger } from "@parity/product-sdk-logger";
-import { createKvStore } from "@parity/product-sdk-storage";
+import { createLocalKvStore } from "@parity/product-sdk-local-storage";
 import { SignerManager } from "@parity/product-sdk-signer";
-import { BulletinClient, calculateCid, createLazySigner } from "@parity/product-sdk-bulletin";
+import {
+    CloudStorageClient,
+    calculateCid,
+    createLazySigner,
+} from "@parity/product-sdk-cloud-storage";
 import {
     createChainClient,
     getClient,
@@ -37,33 +41,33 @@ const log = createLogger("app");
  * ```ts
  * import { createApp } from '@parity/product-sdk';
  *
- * // Default: bulletin enabled with paseo environment
+ * // Default: cloud storage enabled with paseo environment
  * const app = await createApp({
  *   name: 'my-app',
  *   logLevel: 'info',
  * });
  *
- * // Custom bulletin environment
+ * // Custom cloud storage environment
  * const prodApp = await createApp({
  *   name: 'my-app',
- *   bulletin: { environment: 'polkadot' },
+ *   cloudStorage: { environment: 'polkadot' },
  * });
  *
- * // Disable bulletin entirely
- * const noBulletinApp = await createApp({
+ * // Disable cloud storage entirely
+ * const noCloudStorageApp = await createApp({
  *   name: 'my-app',
- *   bulletin: false,
+ *   cloudStorage: false,
  * });
  *
  * // Connect wallet
  * const { accounts } = await app.wallet.connect();
  *
  * // Use storage
- * await app.storage.set('key', 'value');
+ * await app.localStorage.set('key', 'value');
  *
- * // Use bulletin (check for null if it might be disabled)
- * if (app.bulletin) {
- *   const cid = await app.bulletin.upload('hello world');
+ * // Use cloud storage (check for null if it might be disabled)
+ * if (app.cloudStorage) {
+ *   const cid = await app.cloudStorage.upload('hello world');
  * }
  * ```
  */
@@ -76,44 +80,46 @@ export async function createApp(config: AppConfig): Promise<App> {
     log.info("Creating Product SDK app", { name: config.name });
 
     // Initialize storage (container-only - will throw if not in container)
-    const kvStore = await createKvStore({ prefix: config.name });
+    const localKvStore = await createLocalKvStore({ prefix: config.name });
 
     // Initialize signer manager
     const signerManager = new SignerManager({
         dappName: config.name,
     });
 
-    // Initialize bulletin client (configurable, defaults to paseo).
+    // Initialize cloud storage client (configurable, defaults to paseo).
     //
-    // The signer is wrapped lazily so the bulletin client can be built before
+    // The signer is wrapped lazily so the cloud storage client can be built before
     // an account is selected. Uploads will throw a clear error if no signer
     // is available at submission time. Reads (fetch / fetchJson) don't need
     // a signer and work regardless.
-    const bulletinEnabled = config.bulletin !== false;
-    const bulletinEnvironment =
-        typeof config.bulletin === "object" ? config.bulletin.environment : "paseo";
-    const bulletinClient = bulletinEnabled
-        ? await BulletinClient.create({
-              environment: bulletinEnvironment,
+    const cloudStorageEnabled = config.cloudStorage !== false;
+    const cloudStorageEnvironment =
+        typeof config.cloudStorage === "object" ? config.cloudStorage.environment : "paseo";
+    const cloudStorageClient = cloudStorageEnabled
+        ? await CloudStorageClient.create({
+              environment: cloudStorageEnvironment,
               signer: createLazySigner(() => signerManager.getSigner()),
           })
         : null;
 
-    if (bulletinEnabled) {
-        log.debug("Bulletin client initialized", { environment: bulletinEnvironment });
+    if (cloudStorageEnabled) {
+        log.debug("Cloud Storage client (Bulletin) initialized", {
+            environment: cloudStorageEnvironment,
+        });
     } else {
-        log.debug("Bulletin client disabled");
+        log.debug("Cloud Storage client disabled");
     }
 
     // Create storage API adapter
-    const storageApi: StorageApi = {
-        get: (key) => kvStore.get(key),
-        set: (key, value) => kvStore.set(key, value),
-        getJSON: <T>(key: string) => kvStore.getJSON<T>(key),
-        setJSON: <T>(key: string, value: T) => kvStore.setJSON(key, value),
-        remove: (key) => kvStore.remove(key),
+    const localStorageApi: LocalStorageApi = {
+        get: (key) => localKvStore.get(key),
+        set: (key, value) => localKvStore.set(key, value),
+        getJSON: <T>(key: string) => localKvStore.getJSON<T>(key),
+        setJSON: <T>(key: string, value: T) => localKvStore.setJSON(key, value),
+        remove: (key) => localKvStore.remove(key),
         clear: async () => {
-            // KvStore doesn't have clear - this is a no-op
+            // LocalKvStore doesn't have clear - this is a no-op
             log.debug("clear() is not supported in container storage mode");
         },
     };
@@ -153,27 +159,27 @@ export async function createApp(config: AppConfig): Promise<App> {
         },
     };
 
-    // Create bulletin API adapter (null if disabled)
-    const bulletinApi: BulletinApi | null = bulletinClient
+    // Create Cloud Storage API adapter (null if disabled)
+    const cloudStorageApi: CloudStorageApi | null = cloudStorageClient
         ? {
               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 BulletinApi.upload promises a string return, and
+                  // 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 bulletinClient.store(bytes).withManifest(true).send();
+                  const result = await cloudStorageClient.store(bytes).withManifest(true).send();
                   if (!result.cid) {
                       throw new Error(
-                          "Bulletin upload returned no CID despite .withManifest(true). Upstream contract may have shifted — file an issue.",
+                          "Cloud storage upload returned no CID despite .withManifest(true). Upstream contract may have shifted — file an issue.",
                       );
                   }
                   return result.cid.toString();
               },
-              fetch: (cid) => bulletinClient.fetchBytes(cid),
+              fetch: (cid) => cloudStorageClient.fetchBytes(cid),
               computeCid: async (data) => {
                   const bytes = typeof data === "string" ? new TextEncoder().encode(data) : data;
                   const cid = await calculateCid(bytes);
@@ -184,14 +190,14 @@ export async function createApp(config: AppConfig): Promise<App> {
 
     log.info("Product SDK app created", {
         name: config.name,
-        bulletin: bulletinEnabled ? bulletinEnvironment : "disabled",
+        cloudStorage: cloudStorageEnabled ? cloudStorageEnvironment : "disabled",
     });
 
     return {
         wallet: walletApi,
-        storage: storageApi,
+        localStorage: localStorageApi,
         chain: chainApi,
-        bulletin: bulletinApi,
+        cloudStorage: cloudStorageApi,
         getAppInfo: () => ({ ...config }),
     };
 }

package/src/core/types.ts

@@ -3,17 +3,17 @@
  */
 
 import type { LogLevel } from "@parity/product-sdk-logger";
-import type { BulletinEnvironment } from "@parity/product-sdk-bulletin";
+import type { CloudStorageEnvironment } from "@parity/product-sdk-cloud-storage";
 import type { ChainClient } from "@parity/product-sdk-chain-client";
 import type { ChainDefinition, TypedApi, PolkadotClient } from "polkadot-api";
 
 export type { LogLevel };
 export type { ChainClient };
 
-/** Bulletin configuration options */
-export interface BulletinConfig {
-    /** Bulletin environment to connect to */
-    environment: BulletinEnvironment;
+/** Cloud Storage configuration options */
+export interface CloudStorageConfig {
+    /** Cloud Storage environment to connect to */
+    environment: CloudStorageEnvironment;
 }
 
 /** Configuration for createApp */
@@ -23,11 +23,11 @@ export interface AppConfig {
     /** Log level for SDK operations (default: 'info') */
     logLevel?: LogLevel;
     /**
-     * Bulletin Chain configuration.
+     * Cloud Storage configuration.
      * - Omit or pass config object to enable (default: { environment: "paseo" })
-     * - Pass `false` to disable bulletin initialization
+     * - Pass `false` to disable cloud storage initialization
      */
-    bulletin?: BulletinConfig | false;
+    cloudStorage?: CloudStorageConfig | false;
 }
 
 /** Wallet API exposed by the SDK */
@@ -55,7 +55,7 @@ export interface WalletApi {
 }
 
 /** Storage API exposed by the SDK */
-export interface StorageApi {
+export interface LocalStorageApi {
     /** Get a value by key */
     get(key: string): Promise<string | null>;
     /** Set a value by key */
@@ -117,10 +117,10 @@ export interface ChainApi {
     destroyAll(): void;
 }
 
-/** Bulletin Chain API exposed by the SDK */
-export interface BulletinApi {
+/** Cloud Storage API exposed by the SDK */
+export interface CloudStorageApi {
     /**
-     * Upload data to Bulletin Chain.
+     * Upload data to the Cloud.
      *
      * Requires a wallet to be connected and an account selected. Throws
      * "No signer available …" otherwise.
@@ -140,12 +140,12 @@ export interface BulletinApi {
 export interface App {
     /** Wallet/signing operations */
     wallet: WalletApi;
-    /** Key-value storage operations */
-    storage: StorageApi;
+    /** Local Key-value storage operations */
+    localStorage: LocalStorageApi;
     /** Chain interaction operations */
     chain: ChainApi;
-    /** Bulletin Chain operations (null if disabled via config) */
-    bulletin: BulletinApi | null;
+    /** Cloud Storage operations (null if disabled via config) */
+    cloudStorage: CloudStorageApi | null;
     /** Get app configuration */
     getAppInfo(): AppConfig;
 }

package/src/index.ts

@@ -16,7 +16,7 @@
  * const { accounts } = await app.wallet.connect();
  *
  * // Use storage
- * await app.storage.set('key', 'value');
+ * await app.localStorage.set('key', 'value');
  * ```
  *
  * @packageDocumentation
@@ -30,9 +30,9 @@ export type {
     AppConfig,
     LogLevel,
     WalletApi,
-    StorageApi,
+    LocalStorageApi,
     ChainApi,
-    BulletinApi,
+    CloudStorageApi,
     Account,
     ChainClient,
     ChainDefinition,
@@ -45,5 +45,5 @@ export type { LogEntry, LogHandler, LoggerConfig, Logger } from "./core/logger.j
 export { isInsideContainer, isInsideContainerSync } from "@parity/product-sdk-host";
 export { createChainClient } from "@parity/product-sdk-chain-client";
 export { SignerManager } from "@parity/product-sdk-signer";
-export { createKvStore } from "@parity/product-sdk-storage";
-export { BulletinClient, calculateCid } from "@parity/product-sdk-bulletin";
+export { createLocalKvStore } from "@parity/product-sdk-local-storage";
+export { CloudStorageClient, calculateCid } from "@parity/product-sdk-cloud-storage";

package/src/local-storage/index.ts

@@ -0,0 +1,6 @@
+/**
+ * @parity/product-sdk/local-storage
+ *
+ * Re-exports from @parity/product-sdk-local-storage.
+ */
+export * from "@parity/product-sdk-local-storage";

package/src/react/context.ts

@@ -17,7 +17,7 @@ export const ProductSDKContext = createContext<App | null>(null);
  * ```tsx
  * function MyComponent() {
  *   const app = useProductSDK();
- *   // Use app.wallet, app.storage, etc.
+ *   // Use app.wallet, app.localStorage, etc.
  * }
  * ```
  */

package/src/react/index.ts

@@ -6,7 +6,7 @@
  *
  * @example
  * ```tsx
- * import { ProductSDKProvider, useWallet, useStorage } from '@parity/product-sdk/react';
+ * import { ProductSDKProvider, useWallet, useLocalStorage } from '@parity/product-sdk/react';
  *
  * function App() {
  *   return (
@@ -18,7 +18,7 @@
  *
  * function MyApp() {
  *   const { isConnected, connect, accounts } = useWallet();
- *   const [theme, setTheme] = useStorage('theme', 'light');
+ *   const [theme, setTheme] = useLocalStorage('theme', 'light');
  *
  *   // ...
  * }
@@ -36,6 +36,6 @@ export { ProductSDKContext, useProductSDK } from "./context.js";
 export { useWallet } from "./useWallet.js";
 export type { UseWalletState, UseWalletActions, UseWalletReturn } from "./useWallet.js";
 
-export { useStorage, useStorageString } from "./useStorage.js";
+export { useLocalStorage, useLocalStorageString } from "./useLocalStorage.js";
 
 export { useChain } from "./useChain.js";

package/src/react/{useStorage.ts → useLocalStorage.ts}

@@ -1,5 +1,5 @@
 /**
- * useStorage hook
+ * useLocalStorage hook
  */
 
 import { useState, useEffect, useCallback } from "react";
@@ -14,7 +14,7 @@ import { useProductSDK } from "./context.js";
  * @example
  * ```tsx
  * function ThemeToggle() {
- *   const [theme, setTheme, { loading }] = useStorage('theme', 'light');
+ *   const [theme, setTheme, { loading }] = useLocalStorage('theme', 'light');
  *
  *   if (loading) return <div>Loading...</div>;
  *
@@ -26,7 +26,7 @@ import { useProductSDK } from "./context.js";
  * }
  * ```
  */
-export function useStorage<T = string>(
+export function useLocalStorage<T = string>(
     key: string,
     defaultValue?: T,
 ): [T | null, (value: T) => Promise<void>, { loading: boolean; error: Error | null }] {
@@ -43,7 +43,7 @@ export function useStorage<T = string>(
         const loadValue = async () => {
             try {
                 setLoading(true);
-                const stored = await app.storage.getJSON<T>(key);
+                const stored = await app.localStorage.getJSON<T>(key);
                 if (mounted) {
                     setValue(stored ?? defaultValue ?? null);
                     setLoading(false);
@@ -67,7 +67,7 @@ export function useStorage<T = string>(
         async (newValue: T) => {
             try {
                 setError(null);
-                await app.storage.setJSON(key, newValue);
+                await app.localStorage.setJSON(key, newValue);
                 setValue(newValue);
             } catch (e) {
                 setError(e instanceof Error ? e : new Error(String(e)));
@@ -86,7 +86,7 @@ export function useStorage<T = string>(
  * @param key - Storage key
  * @param defaultValue - Default value
  */
-export function useStorageString(
+export function useLocalStorageString(
     key: string,
     defaultValue?: string,
 ): [string | null, (value: string) => Promise<void>, { loading: boolean }] {
@@ -99,7 +99,7 @@ export function useStorageString(
         let mounted = true;
 
         const loadValue = async () => {
-            const stored = await app.storage.get(key);
+            const stored = await app.localStorage.get(key);
             if (mounted) {
                 setValue(stored ?? defaultValue ?? null);
                 setLoading(false);
@@ -115,7 +115,7 @@ export function useStorageString(
 
     const setStoredValue = useCallback(
         async (newValue: string) => {
-            await app.storage.set(key, newValue);
+            await app.localStorage.set(key, newValue);
             setValue(newValue);
         },
         [app, key],

package/dist/bulletin/index.d.ts

@@ -1 +0,0 @@
-export * from '@parity/product-sdk-bulletin';

package/dist/bulletin/index.js

@@ -1,3 +0,0 @@
-export * from '@parity/product-sdk-bulletin';
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/createApp.ts"],"names":[],"mappings":"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","file":"chunk-6W3TCR3W.js","sourcesContent":["/**\n * createApp - Main entry point for the Product SDK\n *\n * Creates an App instance with wallet, storage, chain, and bulletin APIs.\n */\n\nimport type { ChainDefinition } from \"polkadot-api\";\nimport type {\n    App,\n    AppConfig,\n    WalletApi,\n    StorageApi,\n    ChainApi,\n    BulletinApi,\n    Account,\n} from \"./types.js\";\nimport { configure, createLogger } from \"@parity/product-sdk-logger\";\nimport { createKvStore } from \"@parity/product-sdk-storage\";\nimport { SignerManager } from \"@parity/product-sdk-signer\";\nimport { BulletinClient, calculateCid, createLazySigner } from \"@parity/product-sdk-bulletin\";\nimport {\n    createChainClient,\n    getClient,\n    isConnected,\n    destroyAll,\n} from \"@parity/product-sdk-chain-client\";\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: bulletin enabled with paseo environment\n * const app = await createApp({\n *   name: 'my-app',\n *   logLevel: 'info',\n * });\n *\n * // Custom bulletin environment\n * const prodApp = await createApp({\n *   name: 'my-app',\n *   bulletin: { environment: 'polkadot' },\n * });\n *\n * // Disable bulletin entirely\n * const noBulletinApp = await createApp({\n *   name: 'my-app',\n *   bulletin: false,\n * });\n *\n * // Connect wallet\n * const { accounts } = await app.wallet.connect();\n *\n * // Use storage\n * await app.storage.set('key', 'value');\n *\n * // Use bulletin (check for null if it might be disabled)\n * if (app.bulletin) {\n *   const cid = await app.bulletin.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 kvStore = await createKvStore({ prefix: config.name });\n\n    // Initialize signer manager\n    const signerManager = new SignerManager({\n        dappName: config.name,\n    });\n\n    // Initialize bulletin client (configurable, defaults to paseo).\n    //\n    // The signer is wrapped lazily so the bulletin 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 and work regardless.\n    const bulletinEnabled = config.bulletin !== false;\n    const bulletinEnvironment =\n        typeof config.bulletin === \"object\" ? config.bulletin.environment : \"paseo\";\n    const bulletinClient = bulletinEnabled\n        ? await BulletinClient.create({\n              environment: bulletinEnvironment,\n              signer: createLazySigner(() => signerManager.getSigner()),\n          })\n        : null;\n\n    if (bulletinEnabled) {\n        log.debug(\"Bulletin client initialized\", { environment: bulletinEnvironment });\n    } else {\n        log.debug(\"Bulletin client disabled\");\n    }\n\n    // Create storage API adapter\n    const storageApi: StorageApi = {\n        get: (key) => kvStore.get(key),\n        set: (key, value) => kvStore.set(key, value),\n        getJSON: <T>(key: string) => kvStore.getJSON<T>(key),\n        setJSON: <T>(key: string, value: T) => kvStore.setJSON(key, value),\n        remove: (key) => kvStore.remove(key),\n        clear: async () => {\n            // KvStore 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            // Build empty rpcs object (required by API but unused - host routes connections)\n            const rpcs = Object.fromEntries(\n                Object.keys(chains).map((k) => [k, [] as readonly string[]]),\n            ) as { [K in keyof T]: readonly string[] };\n            return createChainClient({ chains, rpcs });\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 bulletin API adapter (null if disabled)\n    const bulletinApi: BulletinApi | null = bulletinClient\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 BulletinApi.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 bulletinClient.store(bytes).withManifest(true).send();\n                  if (!result.cid) {\n                      throw new Error(\n                          \"Bulletin 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) => bulletinClient.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        bulletin: bulletinEnabled ? bulletinEnvironment : \"disabled\",\n    });\n\n    return {\n        wallet: walletApi,\n        storage: storageApi,\n        chain: chainApi,\n        bulletin: bulletinApi,\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        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"]}

package/dist/storage/index.d.ts

@@ -1 +0,0 @@
-export * from '@parity/product-sdk-storage';

package/dist/storage/index.js

@@ -1,3 +0,0 @@
-export * from '@parity/product-sdk-storage';
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/src/bulletin/index.ts

@@ -1,6 +0,0 @@
-/**
- * @parity/product-sdk/bulletin
- *
- * Re-exports from @parity/product-sdk-bulletin.
- */
-export * from "@parity/product-sdk-bulletin";

package/src/storage/index.ts

@@ -1,6 +0,0 @@
-/**
- * @parity/product-sdk/storage
- *
- * Re-exports from @parity/product-sdk-storage.
- */
-export * from "@parity/product-sdk-storage";