@novasamatech/product-sdk 0.5.4 → 0.5.5

package/README.md

@@ -12,6 +12,8 @@ Core features:
 - Accounts provider for product accounts and signing
 - Redirect [PAPI](https://papi.how/) requests to host application
 - Receive additional information from host application - supported chains, theme, etc.
+- Local storage for persisting data in the host application
+- Preimage manager for looking up and submitting preimages
 
 ## Installation
 
@@ -149,9 +151,6 @@ const statementStore = createStatementStore();
 // Define topics (32-byte identifiers) to categorize statements
 const topic: Topic = new Uint8Array(32);
 
-// Query existing statements by topics
-const statements: SignedStatement[] = await statementStore.query([topic]);
-
 // Subscribe to statement updates for specific topics
 const subscription = statementStore.subscribe([topic], (statements) => {
   console.log('Received statement updates:', statements);
@@ -232,3 +231,61 @@ const productAccountSignedTx = await tx.signAndSubmit(signer);
 const nonProductAccountSignedTx = await tx.signAndSubmit(nonProductSigner);
 ```
 
+### Local Storage
+
+The Local Storage module provides a way to persist data in the host application's storage.
+
+```ts
+import { hostLocalStorage, createLocalStorage } from '@novasamatech/product-sdk';
+
+// Use the default instance
+const storage = hostLocalStorage;
+
+// Or create a custom instance with a different transport
+// const storage = createLocalStorage(customTransport);
+
+// Write and read raw bytes
+await storage.writeBytes('key', new Uint8Array([1, 2, 3]));
+const bytes = await storage.readBytes('key');
+
+// Write and read strings
+await storage.writeString('greeting', 'Hello, World!');
+const greeting = await storage.readString('greeting');
+
+// Write and read JSON
+await storage.writeJSON('config', { theme: 'dark', fontSize: 14 });
+const config = await storage.readJSON('config');
+
+// Clear a key
+await storage.clear('key');
+```
+
+### Preimage Manager
+
+The Preimage Manager allows you to lookup and submit preimages to the host application.
+
+```ts
+import { preimageManager, createPreimageManager } from '@novasamatech/product-sdk';
+
+// Use the default instance
+const manager = preimageManager;
+
+// Or create a custom instance with a different transport
+// const manager = createPreimageManager(customTransport);
+
+// Lookup a preimage by its hash key
+const subscription = manager.lookup('0x1234...', (preimage) => {
+  if (preimage) {
+    console.log('Preimage found:', preimage);
+  } else {
+    console.log('Preimage not found');
+  }
+});
+
+// Unsubscribe when done
+subscription.unsubscribe();
+
+// Submit a preimage
+const preimageKey = await manager.submit(new Uint8Array([1, 2, 3, 4]));
+```
+

package/dist/helpers.d.ts

@@ -1,7 +1,9 @@
-type PromiseWithResolvers<T> = {
-    promise: Promise<T>;
-    resolve: (value: T) => void;
-    reject: (reason: unknown) => void;
-};
-export declare const promiseWithResolvers: <const T>() => PromiseWithResolvers<T>;
-export {};
+import type { ResultAsync } from 'neverthrow';
+export declare function unwrapVersionedResult<OK, KO, V extends string>(version: V, result: ResultAsync<{
+    tag: V;
+    value: OK;
+}, {
+    tag: V;
+    value: KO;
+}>): ResultAsync<OK, Error | KO>;
+export declare function resultToPromise<T>(result: ResultAsync<T, unknown>): Promise<T>;

package/dist/helpers.js

@@ -1,10 +1,19 @@
-export const promiseWithResolvers = () => {
-    let resolve;
-    let reject;
-    const promise = new Promise((res, rej) => {
-        resolve = res;
-        reject = rej;
+import { err, ok } from 'neverthrow';
+export function unwrapVersionedResult(version, result) {
+    return result
+        .orElse(payload => {
+        if (payload.tag !== version) {
+            return err(new Error(`Unsupported result version ${payload.tag}`));
+        }
+        return err(payload.value);
+    })
+        .andThen(payload => {
+        if (payload.tag !== version) {
+            return err(new Error(`Unsupported result version ${payload.tag}`));
+        }
+        return ok(payload.value);
     });
-    // @ts-expect-error before assign
-    return { promise, resolve, reject };
-};
+}
+export function resultToPromise(result) {
+    return new Promise((resolve, reject) => result.match(resolve, reject));
+}

package/dist/index.d.ts

@@ -10,3 +10,5 @@ export type { ProductAccountId, SignedStatement, Statement, Topic } from './stat
 export { createStatementStore } from './statementStore.js';
 export type { ProductAccount } from './accounts.js';
 export { createAccountsProvider } from './accounts.js';
+export { createLocalStorage, hostLocalStorage } from './localStorage.js';
+export { createPreimageManager, preimageManager } from './preimage.js';

package/dist/index.js

@@ -7,3 +7,5 @@ export { createPapiProvider } from './papiProvider.js';
 export { createProductChatManager } from './chat.js';
 export { createStatementStore } from './statementStore.js';
 export { createAccountsProvider } from './accounts.js';
+export { createLocalStorage, hostLocalStorage } from './localStorage.js';
+export { createPreimageManager, preimageManager } from './preimage.js';

package/dist/localStorage.d.ts

@@ -0,0 +1,18 @@
+export declare const createLocalStorage: (transport?: import("@novasamatech/host-api").Transport) => {
+    clear(key: string): Promise<undefined>;
+    readBytes(key: string): Promise<Uint8Array<ArrayBufferLike> | undefined>;
+    writeBytes(key: string, value: Uint8Array): Promise<undefined>;
+    readString(key: string): Promise<string>;
+    writeString(key: string, value: string): Promise<undefined>;
+    readJSON(key: string): Promise<any>;
+    writeJSON(key: string, value: unknown): Promise<undefined>;
+};
+export declare const hostLocalStorage: {
+    clear(key: string): Promise<undefined>;
+    readBytes(key: string): Promise<Uint8Array<ArrayBufferLike> | undefined>;
+    writeBytes(key: string, value: Uint8Array): Promise<undefined>;
+    readString(key: string): Promise<string>;
+    writeString(key: string, value: string): Promise<undefined>;
+    readJSON(key: string): Promise<any>;
+    writeJSON(key: string, value: unknown): Promise<undefined>;
+};

package/dist/localStorage.js

@@ -0,0 +1,44 @@
+import { createHostApi, enumValue } from '@novasamatech/host-api';
+import { resultToPromise, unwrapVersionedResult } from './helpers.js';
+import { sandboxTransport } from './sandboxTransport.js';
+export const createLocalStorage = (transport = sandboxTransport) => {
+    const supportedVersion = 'v1';
+    const hostApi = createHostApi(transport);
+    const textEncoder = new TextEncoder();
+    const textDecoder = new TextDecoder();
+    function readBytes(key) {
+        return resultToPromise(unwrapVersionedResult(supportedVersion, hostApi.localStorageRead(enumValue(supportedVersion, key))));
+    }
+    function writeBytes(key, value) {
+        return resultToPromise(unwrapVersionedResult(supportedVersion, hostApi.localStorageWrite(enumValue(supportedVersion, [key, value]))));
+    }
+    function clearKey(key) {
+        return resultToPromise(unwrapVersionedResult(supportedVersion, hostApi.localStorageClear(enumValue(supportedVersion, key))));
+    }
+    return {
+        async clear(key) {
+            return clearKey(key);
+        },
+        async readBytes(key) {
+            return readBytes(key);
+        },
+        async writeBytes(key, value) {
+            return writeBytes(key, value);
+        },
+        async readString(key) {
+            return readBytes(key).then(bytes => textDecoder.decode(bytes));
+        },
+        async writeString(key, value) {
+            return writeBytes(key, textEncoder.encode(value));
+        },
+        async readJSON(key) {
+            return readBytes(key)
+                .then(bytes => textDecoder.decode(bytes))
+                .then(JSON.parse);
+        },
+        async writeJSON(key, value) {
+            return writeBytes(key, textEncoder.encode(JSON.stringify(value)));
+        },
+    };
+};
+export const hostLocalStorage = createLocalStorage();

package/dist/papiProvider.js

@@ -34,7 +34,7 @@ __fallback, internal) {
             if (!ready)
                 return false;
             return transport
-                .request('feature', enumValue('v1', enumValue('Chain', genesisHash)))
+                .request('host_feature_supported', enumValue('v1', enumValue('Chain', genesisHash)))
                 .then(payload => {
                 switch (payload.tag) {
                     case 'v1': {

package/dist/preimage.d.ts

@@ -0,0 +1,9 @@
+import type { HexString } from '@novasamatech/host-api';
+export declare const createPreimageManager: (transport?: import("@novasamatech/host-api").Transport) => {
+    lookup(key: HexString, callback: (preimage: Uint8Array | null) => void): import("@novasamatech/host-api").Subscription;
+    submit(value: Uint8Array): Promise<`0x${string}`>;
+};
+export declare const preimageManager: {
+    lookup(key: HexString, callback: (preimage: Uint8Array | null) => void): import("@novasamatech/host-api").Subscription;
+    submit(value: Uint8Array): Promise<`0x${string}`>;
+};

package/dist/preimage.js

@@ -0,0 +1,20 @@
+import { createHostApi, enumValue } from '@novasamatech/host-api';
+import { resultToPromise, unwrapVersionedResult } from './helpers.js';
+import { sandboxTransport } from './sandboxTransport.js';
+export const createPreimageManager = (transport = sandboxTransport) => {
+    const supportedVersion = 'v1';
+    const hostApi = createHostApi(transport);
+    return {
+        lookup(key, callback) {
+            return hostApi.preimageLookupSubscribe(enumValue(supportedVersion, key), payload => {
+                if (payload.tag === supportedVersion) {
+                    callback(payload.value);
+                }
+            });
+        },
+        submit(value) {
+            return resultToPromise(unwrapVersionedResult(supportedVersion, hostApi.preimageSubmit(enumValue(supportedVersion, value))));
+        },
+    };
+};
+export const preimageManager = createPreimageManager();

package/dist/statementStore.d.ts

@@ -4,7 +4,6 @@ export type SignedStatement = CodecType<typeof SignedStatementCodec>;
 export type Topic = CodecType<typeof TopicCodec>;
 export type ProductAccountId = CodecType<typeof ProductAccountIdCodec>;
 export declare const createStatementStore: (transport?: Transport) => {
-    query(topics: Topic[]): Promise<SignedStatement[]>;
     subscribe(topics: Topic[], callback: (statements: SignedStatement[]) => void): import("@novasamatech/host-api").Subscription;
     createProof(accountId: ProductAccountId, statement: Statement): Promise<{
         tag: "Sr25519";

package/dist/statementStore.js

@@ -3,17 +3,6 @@ import { sandboxTransport } from './sandboxTransport.js';
 export const createStatementStore = (transport = sandboxTransport) => {
     const hostApi = createHostApi(transport);
     return {
-        async query(topics) {
-            const result = await hostApi.statementStoreQuery(enumValue('v1', topics));
-            return result.match(payload => {
-                if (payload.tag === 'v1') {
-                    return payload.value;
-                }
-                throw new Error(`Unknown response version ${payload.tag}`);
-            }, err => {
-                throw err.value;
-            });
-        },
         subscribe(topics, callback) {
             return hostApi.statementStoreSubscribe(enumValue('v1', topics), payload => {
                 if (payload.tag === 'v1') {

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@novasamatech/product-sdk",
   "type": "module",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "Polkadot product SDK: integrate and run your product inside Polkadot browser.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/novasamatech/spektr-sdk.git"
+    "url": "git+https://github.com/Polkadot-Community-Foundation/triangle-js-sdks.git"
   },
   "keywords": [
     "polkadot",
@@ -30,7 +30,7 @@
     "@polkadot-api/substrate-bindings": "^0.17.0",
     "@polkadot-api/json-rpc-provider": "^0.0.4",
     "@polkadot-api/json-rpc-provider-proxy": "^0.2.7",
-    "@novasamatech/host-api": "0.5.4"
+    "@novasamatech/host-api": "0.5.5"
   },
   "publishConfig": {
     "access": "public"