@parity/product-sdk 0.6.0 → 0.7.1

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.1",
   "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.1",
+    "@parity/product-sdk-chain-client": "0.5.1",
+    "@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/address/index.ts

@@ -1,3 +1,5 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * @parity/product-sdk/address
  *

package/src/chain/index.ts

@@ -1,3 +1,5 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * @parity/product-sdk/chain
  *

package/src/cloud-storage/index.ts

@@ -0,0 +1,8 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @parity/product-sdk/bulletin
+ *
+ * Re-exports from @parity/product-sdk-cloud-storage.
+ */
+export * from "@parity/product-sdk-cloud-storage";

package/src/contracts/index.ts

@@ -1,3 +1,5 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * @parity/product-sdk/contracts
  *

package/src/core/createApp.ts

@@ -1,7 +1,9 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * 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 +11,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 +43,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 +82,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 +161,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 +192,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/index.ts

@@ -1,3 +1,5 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * @parity/product-sdk core module
  *

package/src/core/logger.ts

@@ -1,3 +1,5 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * Logger module for @parity/product-sdk
  *

package/src/core/types.ts

@@ -1,19 +1,21 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * Core types for @parity/product-sdk
  */
 
 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 +25,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 +57,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 +119,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 +142,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/crypto/index.ts

@@ -1,3 +1,5 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * @parity/product-sdk/crypto
  *

package/src/host/index.ts

@@ -1,3 +1,5 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * @parity/product-sdk/host
  *

package/src/identity/dotns.ts

@@ -1,3 +1,5 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * DotNS (Polkadot Name Service) utilities
  *

package/src/identity/index.ts

@@ -1,3 +1,5 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * @parity/product-sdk/identity
  *

package/src/identity/product-account.ts

@@ -1,3 +1,5 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * Context alias derivation
  *

package/src/identity/types.ts

@@ -1,3 +1,5 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * Identity module types
  *

package/src/index.ts

@@ -1,3 +1,5 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * @parity/product-sdk
  *
@@ -16,7 +18,7 @@
  * const { accounts } = await app.wallet.connect();
  *
  * // Use storage
- * await app.storage.set('key', 'value');
+ * await app.localStorage.set('key', 'value');
  * ```
  *
  * @packageDocumentation
@@ -30,9 +32,9 @@ export type {
     AppConfig,
     LogLevel,
     WalletApi,
-    StorageApi,
+    LocalStorageApi,
     ChainApi,
-    BulletinApi,
+    CloudStorageApi,
     Account,
     ChainClient,
     ChainDefinition,
@@ -45,5 +47,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,8 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @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

@@ -1,3 +1,5 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * React context for Product SDK
  */
@@ -17,7 +19,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

@@ -1,3 +1,5 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * @parity/product-sdk/react
  *
@@ -6,7 +8,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 +20,7 @@
  *
  * function MyApp() {
  *   const { isConnected, connect, accounts } = useWallet();
- *   const [theme, setTheme] = useStorage('theme', 'light');
+ *   const [theme, setTheme] = useLocalStorage('theme', 'light');
  *
  *   // ...
  * }
@@ -36,6 +38,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/provider.tsx

@@ -1,3 +1,5 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * ProductSDKProvider component
  */

package/src/react/useChain.ts

@@ -1,3 +1,5 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * useChain hook
  */