@tinycloudlabs/web-sdk-wasm 0.2.0 → 1.0.0

package/dist/tinycloud_web_sdk_rs.d.ts

@@ -1,26 +1,5 @@
 /* tslint:disable */
 /* eslint-disable */
-/**
- * Initialise console-error-panic-hook to improve debug output for panics.
- *
- * Run once on initialisation.
- */
-export function initPanicHook(): void;
-export function makeOrbitId(address: string, chainId: number, name?: string | null): string;
-export function prepareSession(config: string): Promise<any>;
-export function completeSessionSetup(config: string): string;
-export function invoke(session: string, service: string, path: string, action: string): Promise<any>;
-export function generateHostSIWEMessage(config: string): string;
-export function siweToDelegationHeaders(signedSIWEMessage: string): string;
-
-export type ExtraFields = {
-    /** Any extra fields that are needed for the capability.
-     * This object must be serializable with JSON.stringify().
-     */
-    [key: string]: any
-}
-
-
 
 export type SiweConfig = {
     /**Ethereum address performing the signing conformant to capitalization
@@ -56,6 +35,15 @@ export type SiweConfig = {
 
 
 
+export type ExtraFields = {
+    /** Any extra fields that are needed for the capability.
+     * This object must be serializable with JSON.stringify().
+     */
+    [key: string]: any
+}
+
+
+
 /**
  * Configuration object for starting a TinyCloud session.
  */
@@ -70,8 +58,8 @@ export type SessionConfig = {
   domain: string,
   /** Current time for SIWE message. */
   issuedAt: string,
-  /** The orbit that is the target resource of the delegation. */
-  orbitId: string,
+  /** The space that is the target resource of the delegation. */
+  spaceId: string,
   /** The earliest time that the session will be valid from. */
   notBefore?: string,
   /** The latest time that the session will be valid until. */
@@ -85,25 +73,7 @@ export type SessionConfig = {
 
 
 /**
- * A TinyCloud session.
- */
-export type Session = {
-  /** The delegation from the user to the session key. */
-  delegationHeader: { Authorization: string },
-  /** The delegation reference from the user to the session key. */
-  delegationCid: string,
-  /** The session key. */
-  jwk: object,
-  /** The orbit that the session key is permitted to perform actions against. */
-  orbitId: string,
-  /** The verification method of the session key. */
-  verificationMethod: string,
-}
-
-
-
-/**
- * Configuration object for generating a TinyCloud Orbit Host Delegation SIWE message.
+ * Configuration object for generating a TinyCloud Space Host Delegation SIWE message.
  */
 export type HostConfig = {
   /** Ethereum address. */
@@ -114,93 +84,169 @@ export type HostConfig = {
   domain: string,
   /** Current time for SIWE message. */
   issuedAt: string,
-  /** The orbit that is the target resource of the delegation. */
-  orbitId: string,
+  /** The space that is the target resource of the delegation. */
+  spaceId: string,
   /** The peer that is the target/invoker in the delegation. */
   peerId: string,
 }
 
 
+
+/**
+ * A TinyCloud session.
+ */
+export type Session = {
+  /** The delegation from the user to the session key. */
+  delegationHeader: { Authorization: string },
+  /** The delegation reference from the user to the session key. */
+  delegationCid: string,
+  /** The session key. */
+  jwk: object,
+  /** The space that the session key is permitted to perform actions against. */
+  spaceId: string,
+  /** The verification method of the session key. */
+  verificationMethod: string,
+}
+
+
+
 export class TCWSessionManager {
   free(): void;
+  [Symbol.dispose](): void;
   /**
-   * Initialize a new TinyCloudWebSessionManager.
+   * List the available session keys.
    */
-  constructor();
+  listSessionKeys(): any;
   /**
    * Reset the SIWE message builder to its initial state.
    */
   resetCapability(): void;
   /**
-   * Build a SIWE message for signing.
-   */
-  build(config: SiweConfig, key_id?: string | null, custom_uri?: string | null): Promise<string>;
-  /**
-   * Add default actions to a capability.
+   * Create a new session key with the given key ID (Defaults to 'default').
    */
-  addDefaultActions(namespace: string, defaultActions: string[]): boolean;
+  createSessionKey(key_id?: string | null): string;
   /**
    * Add actions for a specific target to a capability.
    */
-  addTargetedActions(namespace: string, target: string, actions: string[]): boolean;
+  addTargetedActions(target: string, actions: string[]): boolean;
   /**
-   * Create a new session key with the given key ID (Defaults to 'default').
+   * Rename the key_id to retrieve session data.
    */
-  createSessionKey(key_id?: string | null): string;
+  renameSessionKeyId(old_key_id: string, new_key_id: string): void;
   /**
-   * List the available session keys.
+   * Get the full JWK associated with a the session key key_id.
    */
-  listSessionKeys(): any;
+  jwk(key_id?: string | null): string | undefined;
   /**
-   * Rename the key_id to retrieve session data.
+   * Initialize a new TinyCloudWebSessionManager.
    */
-  renameSessionKeyId(old_key_id: string, new_key_id: string): Promise<void>;
+  constructor();
   /**
-   * Get the DID associated with a the session key key_id.
+   * Build a SIWE message for signing.
    */
-  getDID(key_id?: string | null): Promise<string>;
+  build(config: SiweConfig, key_id?: string | null, custom_uri?: string | null): string;
   /**
-   * Get the full JWK associated with a the session key key_id.
+   * Get the DID associated with a the session key key_id.
    */
-  jwk(key_id?: string | null): string | undefined;
+  getDID(key_id?: string | null): string;
 }
 
+export function completeSessionSetup(config: any): any;
+
+/**
+ * Compute a CID from data bytes using Blake3_256 hash.
+ *
+ * This uses the same hashing algorithm as the TinyCloud server,
+ * ensuring CID consistency between client and server.
+ *
+ * # Arguments
+ * * `data` - The bytes to hash
+ * * `codec` - The multicodec code (e.g., 0x55 for raw)
+ *
+ * # Returns
+ * The CID as a string (base32 multibase encoded)
+ */
+export function computeCid(data: Uint8Array, codec: bigint): string;
+
+/**
+ * Create a delegation UCAN from a session to another DID.
+ * This allows session keys to delegate capabilities to other users client-side.
+ *
+ * # Arguments
+ * * `session` - The current session (with JWK and delegation info)
+ * * `delegateDID` - The recipient's DID (audience of the delegation)
+ * * `spaceId` - The space being delegated (e.g., "tinycloud:pkh:eip155:1:0x....:default")
+ * * `path` - Path scope for the delegation
+ * * `actions` - Actions to delegate (e.g., ["tinycloud.kv/get", "tinycloud.kv/put"])
+ * * `expirationSecs` - Expiration timestamp in seconds since epoch
+ * * `notBeforeSecs` - Optional not-before timestamp in seconds since epoch
+ *
+ * # Returns
+ * A `DelegationResult` containing:
+ * * `delegation` - Base64url-encoded UCAN JWT string
+ * * `cid` - CID of the delegation (for referencing in proof chains)
+ * * `delegateDID` - The delegate's DID
+ * * `path` - Path scope
+ * * `actions` - Delegated actions
+ * * `expiry` - Expiration timestamp
+ */
+export function createDelegation(session: any, delegateDID: string, spaceId: string, path: string, actions: string[], expirationSecs: number, notBeforeSecs: any): any;
+
+export function ensureEip55(address: string): string;
+
+export function generateHostSIWEMessage(config: any): string;
+
+/**
+ * Initialise console-error-panic-hook to improve debug output for panics.
+ *
+ * Run once on initialisation.
+ */
+export function initPanicHook(): void;
+
+export function invoke(session: any, service: string, path: string, action: string, facts: any): any;
+
+export function makeSpaceId(address: string, chainId: number, name: string): string;
+
+export function prepareSession(config: any): any;
+
+export function protocolVersion(): number;
+
+export function siweToDelegationHeaders(signedSIWEMessage: any): any;
+
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
 export interface InitOutput {
   readonly memory: WebAssembly.Memory;
-  readonly initPanicHook: () => void;
   readonly __wbg_tcwsessionmanager_free: (a: number, b: number) => void;
-  readonly tcwsessionmanager_new: () => [number, number, number];
+  readonly initPanicHook: () => void;
+  readonly tcwsessionmanager_addTargetedActions: (a: number, b: number, c: number, d: number, e: number) => number;
+  readonly tcwsessionmanager_build: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+  readonly tcwsessionmanager_createSessionKey: (a: number, b: number, c: number, d: number) => void;
+  readonly tcwsessionmanager_getDID: (a: number, b: number, c: number, d: number) => void;
+  readonly tcwsessionmanager_jwk: (a: number, b: number, c: number, d: number) => void;
+  readonly tcwsessionmanager_listSessionKeys: (a: number, b: number) => void;
+  readonly tcwsessionmanager_new: (a: number) => void;
+  readonly tcwsessionmanager_renameSessionKeyId: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
   readonly tcwsessionmanager_resetCapability: (a: number) => void;
-  readonly tcwsessionmanager_build: (a: number, b: any, c: number, d: number, e: number, f: number) => any;
-  readonly tcwsessionmanager_addDefaultActions: (a: number, b: number, c: number, d: number, e: number) => number;
-  readonly tcwsessionmanager_addTargetedActions: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
-  readonly tcwsessionmanager_createSessionKey: (a: number, b: number, c: number) => [number, number, number, number];
-  readonly tcwsessionmanager_listSessionKeys: (a: number) => [number, number, number];
-  readonly tcwsessionmanager_renameSessionKeyId: (a: number, b: number, c: number, d: number, e: number) => any;
-  readonly tcwsessionmanager_getDID: (a: number, b: number, c: number) => any;
-  readonly tcwsessionmanager_jwk: (a: number, b: number, c: number) => [number, number];
-  readonly makeOrbitId: (a: number, b: number, c: number, d: number, e: number) => [number, number];
-  readonly prepareSession: (a: number, b: number) => any;
-  readonly completeSessionSetup: (a: number, b: number) => [number, number, number, number];
-  readonly invoke: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => any;
-  readonly generateHostSIWEMessage: (a: number, b: number) => [number, number, number, number];
-  readonly siweToDelegationHeaders: (a: number, b: number) => [number, number, number, number];
-  readonly __wbindgen_malloc: (a: number, b: number) => number;
-  readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
-  readonly __wbindgen_exn_store: (a: number) => void;
-  readonly __externref_table_alloc: () => number;
-  readonly __wbindgen_export_4: WebAssembly.Table;
-  readonly __wbindgen_free: (a: number, b: number, c: number) => void;
-  readonly __wbindgen_export_6: WebAssembly.Table;
-  readonly __externref_table_dealloc: (a: number) => void;
-  readonly closure467_externref_shim: (a: number, b: number, c: any) => void;
-  readonly closure964_externref_shim: (a: number, b: number, c: any, d: any) => void;
-  readonly __wbindgen_start: () => void;
+  readonly completeSessionSetup: (a: number, b: number) => void;
+  readonly computeCid: (a: number, b: number, c: number, d: bigint) => void;
+  readonly createDelegation: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => void;
+  readonly ensureEip55: (a: number, b: number, c: number) => void;
+  readonly generateHostSIWEMessage: (a: number, b: number) => void;
+  readonly invoke: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
+  readonly makeSpaceId: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+  readonly prepareSession: (a: number, b: number) => void;
+  readonly protocolVersion: () => number;
+  readonly siweToDelegationHeaders: (a: number, b: number) => void;
+  readonly __wbindgen_export: (a: number, b: number) => number;
+  readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+  readonly __wbindgen_export3: (a: number) => void;
+  readonly __wbindgen_export4: (a: number, b: number, c: number) => void;
+  readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
 }
 
 export type SyncInitInput = BufferSource | WebAssembly.Module;
+
 /**
 * Instantiates the given `module`, which can either be bytes or
 * a precompiled `WebAssembly.Module`.

package/package.json

@@ -1,35 +1,30 @@
 {
   "name": "@tinycloudlabs/web-sdk-wasm",
-  "version": "0.2.0",
+  "version": "1.0.0",
+  "description": "TinyCloud WASM bindings for web browsers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "author": "TinyCloud, Inc.",
-  "license": "Apache-2.0 OR MIT",
+  "license": "EGPL",
   "scripts": {
-    "setup": "./scripts/setup-rust.sh",
-    "build": "bash -c 'source ../../scripts/setup.sh && wasm-pack build --dev --target web && rollup -c && $PWD/fixup-types.sh'",
-    "build:wasm": "wasm-pack build --dev --target web",
-    "build-dev": "wasm-pack build --dev --target web",
-    "build-release": "wasm-pack build --release --target web",
-    "bundle": "rollup -c && $PWD/fixup-types.sh",
-    "clean": "rm -rf dist pkg",
-    "dev": "bun run build:wasm && bun run bundle",
-    "release": "bun run build-release && bun run bundle",
-    "fmt": "prettier -w src package.json rollup.config.js tsconfig.json",
-    "publish-gh": "npm config set @tinycloudlabs:registry=https://npm.pkg.github.com && npm publish",
-    "publish-npm": "npm config set @tinycloudlabs:registry=https://registry.npmjs.org && npm publish --access public"
+    "build": "rollup -c && ./fixup-types.sh",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@tinycloudlabs/sdk-rs": "^1.0.0"
   },
   "devDependencies": {
-    "@changesets/cli": "^2.27.12",
     "@rollup/plugin-wasm": "^5.2.0",
-    "prettier": "^2.8.8",
     "rollup": "^2.79.2",
     "rollup-plugin-typescript2": "^0.32.1",
     "tslib": "^2.8.1",
     "typescript": "^4.9.5"
   },
   "files": [
-    "tsconfig.json",
     "dist"
-  ]
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tinycloudlabs/web-sdk"
+  }
 }

package/README.md

@@ -1,92 +0,0 @@
-# TinyCloud Web SDK (Rust/WASM)
-
-<img src="https://github.com/TinyCloudLabs/web-sdk/blob/main/documentation/static/img/tinycloudheader.png?raw=true" alt="TinyCloud" width="100%" />
-
-WebAssembly library written in Rust for the TinyCloud Web SDK.
-
-[![npm version](https://img.shields.io/npm/v/@tinycloudlabs/web-sdk-rs.svg)](https://www.npmjs.com/package/@tinycloudlabs/web-sdk-rs)
-[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/TinyCloudLabs/web-sdk/blob/main/LICENSE-MIT)
-
-## Overview
-
-This package provides high-performance WebAssembly components for TinyCloud Web SDK. It uses `rollup` to encode the `.wasm` as a base64-encoded string, meaning there is no configuration needed downstream to support WebAssembly (other than a compatible browser).
-
-## Features
-
-- **High Performance** - Critical operations implemented in Rust for maximum efficiency
-- **Small Footprint** - Minimal bundle size overhead
-- **Seamless Integration** - Works directly with the JavaScript SDK without configuration
-
-## Installation
-
-```bash
-# Using npm
-npm install @tinycloudlabs/web-sdk-rs
-
-# Using Yarn
-yarn add @tinycloudlabs/web-sdk-rs
-
-# Using Bun (recommended)
-bun add @tinycloudlabs/web-sdk-rs
-```
-
-## Usage
-
-This package is typically used internally by the main TinyCloud Web SDK, but you can also use it directly:
-
-```typescript
-import { initialize } from '@tinycloudlabs/web-sdk-rs';
-
-// Initialize the WASM module
-await initialize();
-
-// Use the WASM functions
-// ...
-```
-
-## Building from Source
-
-### Requirements
-
-* [Rust](https://www.rust-lang.org/tools/install)
-* [wasm-pack](https://rustwasm.github.io/wasm-pack/installer/)
-* [Bun](https://bun.sh) or [Yarn](https://yarnpkg.com/getting-started/install)
-
-### Building
-
-For development builds:
-
-```bash
-bun run build-dev
-```
-
-For optimized release builds:
-
-```bash
-bun run build-release
-```
-
-Then bundle the package:
-
-```bash
-bun run bundle
-```
-
-## Documentation
-
-For complete documentation, please visit:
-
-- [**TinyCloud SDK Documentation**](https://docs.tinycloud.xyz/)
-
-## Contributing
-
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-## License
-
-This project is licensed under the MIT License - see the [LICENSE-MIT](https://github.com/TinyCloudLabs/web-sdk/blob/main/LICENSE-MIT) file for details.
-
-## Related Packages
-
-- [**@tinycloudlabs/web-sdk**](https://www.npmjs.com/package/@tinycloudlabs/web-sdk) - The main TinyCloud Web SDK package
-- [**@tinycloudlabs/web-core**](https://www.npmjs.com/package/@tinycloudlabs/web-core) - Core utilities and types

package/tsconfig.json

@@ -1,5 +0,0 @@
-{
-  "compilerOptions": {
-    "declaration": true
-  }
-}