@tinycloud/web-sdk 0.0.0-beta-20260401001229

package/dist/modules/Storage/index.d.ts

@@ -0,0 +1,2 @@
+export * from './tinycloud';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/Storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/Storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/modules/Storage/tinycloud/KVServiceAdapter.d.ts

@@ -0,0 +1,24 @@
+import { IKVService } from "@tinycloud/sdk-core";
+import { Session } from "./types";
+/**
+ * Create a KVService instance from web-sdk Session.
+ *
+ * This adapter bridges the web-sdk Session type to the sdk-core KVService,
+ * allowing platform-agnostic code to use the shared KV service implementation.
+ *
+ * @param host - The TinyCloud host URL
+ * @param session - The web-sdk Session
+ * @returns An IKVService instance
+ *
+ * @example
+ * ```typescript
+ * const session = await tinycloud.space();
+ * const kvService = createKVService("https://tinycloud.example.com", session);
+ *
+ * // Use the KV service
+ * await kvService.put("key", { data: "value" });
+ * const result = await kvService.get("key");
+ * ```
+ */
+export declare function createKVService(host: string, session: Session): IKVService;
+//# sourceMappingURL=KVServiceAdapter.d.ts.map

package/dist/modules/Storage/tinycloud/KVServiceAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KVServiceAdapter.d.ts","sourceRoot":"","sources":["../../../../src/modules/Storage/tinycloud/KVServiceAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,UAAU,EAAkB,MAAM,qBAAqB,CAAC;AAE5E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,CAc1E"}

package/dist/modules/Storage/tinycloud/index.d.ts

@@ -0,0 +1,3 @@
+export { SessionConfig, Session, HostConfig } from './types';
+export { createKVService } from './KVServiceAdapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/Storage/tinycloud/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/Storage/tinycloud/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/modules/Storage/tinycloud/module.d.ts

@@ -0,0 +1,11 @@
+import { tinycloud } from '@tinycloud/web-sdk-wasm';
+import type { InvokeFunction } from '@tinycloud/sdk-services';
+type TinyCloudModule = typeof tinycloud;
+export declare const makeSpaceId: TinyCloudModule['makeSpaceId'];
+export declare const prepareSession: TinyCloudModule['prepareSession'];
+export declare const completeSessionSetup: TinyCloudModule['completeSessionSetup'];
+export declare const invoke: InvokeFunction;
+export declare const generateHostSIWEMessage: TinyCloudModule['generateHostSIWEMessage'];
+export declare const siweToDelegationHeaders: TinyCloudModule['siweToDelegationHeaders'];
+export {};
+//# sourceMappingURL=module.d.ts.map

package/dist/modules/Storage/tinycloud/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../../src/modules/Storage/tinycloud/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,KAAK,eAAe,GAAG,OAAO,SAAS,CAAC;AAYxC,eAAO,MAAM,WAAW,EAAE,eAAe,CAAC,aAAa,CAMtD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,eAAe,CAAC,gBAAgB,CAM5D,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eAAe,CAAC,sBAAsB,CAQxE,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,cAMpB,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,eAAe,CAAC,yBAAyB,CAO5E,CAAC;AAEJ,eAAO,MAAM,uBAAuB,EAAE,eAAe,CAAC,yBAAyB,CAO5E,CAAC"}

package/dist/modules/Storage/tinycloud/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Configuration object for starting a TinyCloud session.
+ */
+export type SessionConfig = {
+    /** Actions that the session key will be permitted to perform, organized by service and path */
+    actions: {
+        [service: string]: {
+            [key: string]: string[];
+        };
+    };
+    /** Ethereum address. */
+    address: string;
+    /** Chain ID. */
+    chainId: number;
+    /** Domain of the webpage. */
+    domain: string;
+    /** Current time for SIWE message. */
+    issuedAt: 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. */
+    expirationTime: string;
+    /** Optional parent delegations to inherit and attenuate */
+    parents?: string[];
+    /** Optional jwk to delegate to */
+    jwk?: object;
+};
+/**
+ * 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;
+};
+/**
+ * Configuration object for generating a Space Host Delegation SIWE message.
+ */
+export type HostConfig = {
+    /** Ethereum address. */
+    address: string;
+    /** Chain ID. */
+    chainId: number;
+    /** Domain of the webpage. */
+    domain: string;
+    /** Current time for SIWE message. */
+    issuedAt: 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;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/modules/Storage/tinycloud/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/modules/Storage/tinycloud/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,+FAA+F;IAC/F,OAAO,EAAE;QAAE,CAAC,OAAO,EAAE,MAAM,GAAG;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;SAAE,CAAA;KAAE,CAAC;IAC5D,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,uDAAuD;IACvD,gBAAgB,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/dist/modules/Storage/tinycloud/types.schema.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Zod schemas for TinyCloud storage session and configuration types.
+ *
+ * These schemas provide runtime validation for session configuration,
+ * active sessions, and host configuration. Types are derived from
+ * schemas using z.infer<>.
+ *
+ * @packageDocumentation
+ */
+import { z } from "zod";
+/**
+ * Configuration object for starting a TinyCloud session.
+ */
+export declare const SessionConfigSchema: z.ZodObject<{
+    /** Actions that the session key will be permitted to perform, organized by service and path */
+    actions: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+    /** Ethereum address. */
+    address: z.ZodString;
+    /** Chain ID. */
+    chainId: z.ZodNumber;
+    /** Domain of the webpage. */
+    domain: z.ZodString;
+    /** Current time for SIWE message (ISO 8601 format). */
+    issuedAt: z.ZodString;
+    /** The space that is the target resource of the delegation. */
+    spaceId: z.ZodString;
+    /** The earliest time that the session will be valid from. */
+    notBefore: z.ZodOptional<z.ZodString>;
+    /** The latest time that the session will be valid until. */
+    expirationTime: z.ZodString;
+    /** Optional parent delegations to inherit and attenuate */
+    parents: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Optional jwk to delegate to */
+    jwk: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    spaceId?: string;
+    actions?: Record<string, Record<string, string[]>>;
+    address?: string;
+    chainId?: number;
+    domain?: string;
+    issuedAt?: string;
+    notBefore?: string;
+    expirationTime?: string;
+    parents?: string[];
+    jwk?: Record<string, unknown>;
+}, {
+    spaceId?: string;
+    actions?: Record<string, Record<string, string[]>>;
+    address?: string;
+    chainId?: number;
+    domain?: string;
+    issuedAt?: string;
+    notBefore?: string;
+    expirationTime?: string;
+    parents?: string[];
+    jwk?: Record<string, unknown>;
+}>;
+export type SessionConfig = z.infer<typeof SessionConfigSchema>;
+/**
+ * A TinyCloud session.
+ */
+export declare const SessionSchema: z.ZodObject<{
+    /** The delegation from the user to the session key. */
+    delegationHeader: z.ZodObject<{
+        Authorization: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        Authorization?: string;
+    }, {
+        Authorization?: string;
+    }>;
+    /** The delegation reference from the user to the session key. */
+    delegationCid: z.ZodString;
+    /** The session key (JWK format). */
+    jwk: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /** The space that the session key is permitted to perform actions against. */
+    spaceId: z.ZodString;
+    /** The verification method of the session key. */
+    verificationMethod: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceId?: string;
+    jwk?: Record<string, unknown>;
+    delegationHeader?: {
+        Authorization?: string;
+    };
+    delegationCid?: string;
+    verificationMethod?: string;
+}, {
+    spaceId?: string;
+    jwk?: Record<string, unknown>;
+    delegationHeader?: {
+        Authorization?: string;
+    };
+    delegationCid?: string;
+    verificationMethod?: string;
+}>;
+export type Session = z.infer<typeof SessionSchema>;
+/**
+ * Configuration object for generating a Space Host Delegation SIWE message.
+ */
+export declare const HostConfigSchema: z.ZodObject<{
+    /** Ethereum address. */
+    address: z.ZodString;
+    /** Chain ID. */
+    chainId: z.ZodNumber;
+    /** Domain of the webpage. */
+    domain: z.ZodString;
+    /** Current time for SIWE message (ISO 8601 format). */
+    issuedAt: z.ZodString;
+    /** The space that is the target resource of the delegation. */
+    spaceId: z.ZodString;
+    /** The peer that is the target/invoker in the delegation. */
+    peerId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    spaceId?: string;
+    address?: string;
+    chainId?: number;
+    domain?: string;
+    issuedAt?: string;
+    peerId?: string;
+}, {
+    spaceId?: string;
+    address?: string;
+    chainId?: number;
+    domain?: string;
+    issuedAt?: string;
+    peerId?: string;
+}>;
+export type HostConfig = z.infer<typeof HostConfigSchema>;
+/**
+ * Validation error type.
+ */
+export interface ValidationError {
+    code: string;
+    message: string;
+    issues?: unknown[];
+}
+/**
+ * Result type for validation operations.
+ */
+export type ValidationResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: ValidationError;
+};
+/**
+ * Validates SessionConfig.
+ */
+export declare function validateSessionConfig(data: unknown): ValidationResult<SessionConfig>;
+/**
+ * Validates Session.
+ */
+export declare function validateSession(data: unknown): ValidationResult<Session>;
+/**
+ * Validates HostConfig.
+ */
+export declare function validateHostConfig(data: unknown): ValidationResult<HostConfig>;
+//# sourceMappingURL=types.schema.d.ts.map

package/dist/modules/Storage/tinycloud/types.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.schema.d.ts","sourceRoot":"","sources":["../../../../src/modules/Storage/tinycloud/types.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC9B,+FAA+F;;IAE/F,wBAAwB;;IAExB,gBAAgB;;IAEhB,6BAA6B;;IAE7B,uDAAuD;;IAEvD,+DAA+D;;IAE/D,6DAA6D;;IAE7D,4DAA4D;;IAE5D,2DAA2D;;IAE3D,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;EAElC,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,uDAAuD;;;;;;;;IAIvD,iEAAiE;;IAEjE,oCAAoC;;IAEpC,8EAA8E;;IAE9E,kDAAkD;;;;;;;;;;;;;;;;;;EAElD,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAMpD;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,wBAAwB;;IAExB,gBAAgB;;IAEhB,6BAA6B;;IAE7B,uDAAuD;;IAEvD,+DAA+D;;IAE/D,6DAA6D;;;;;;;;;;;;;;;;EAE7D,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAM1D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACrB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAC;AAE1C;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAapF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAaxE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAa9E"}

package/dist/modules/WasmInitializer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Centralized WASM initialization for the TinyCloud SDK.
+ * Ensures WASM modules are loaded before any extension operations.
+ */
+export declare class WasmInitializer {
+    private static isInitialized;
+    private static tinycloudModule;
+    private static sessionManager;
+    /**
+     * Ensures WASM modules are initialized. Safe to call multiple times.
+     * @returns Promise resolving to initialized WASM modules
+     */
+    static ensureInitialized(): Promise<{
+        tinycloudModule: any;
+        sessionManager: any;
+    }>;
+    /**
+     * Gets the initialized WASM modules if available.
+     * @returns The WASM modules or null if not initialized
+     */
+    static getModules(): {
+        tinycloudModule: any;
+        sessionManager: any;
+    } | null;
+}
+//# sourceMappingURL=WasmInitializer.d.ts.map

package/dist/modules/WasmInitializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WasmInitializer.d.ts","sourceRoot":"","sources":["../../src/modules/WasmInitializer.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,aAAa,CAAS;IACrC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAM;IACpC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAM;IAEnC;;;OAGG;WACU,iBAAiB,IAAI,OAAO,CAAC;QACxC,eAAe,EAAE,GAAG,CAAC;QACrB,cAAc,EAAE,GAAG,CAAC;KACrB,CAAC;IAeF;;;OAGG;IACH,MAAM,CAAC,UAAU,IAAI;QAAE,eAAe,EAAE,GAAG,CAAC;QAAC,cAAc,EAAE,GAAG,CAAA;KAAE,GAAG,IAAI;CAS1E"}

package/dist/modules/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./Storage";
+export * from "./tcw";
+export { TinyCloudWeb } from "./tcw";
+export { ModalSpaceCreationHandler, defaultWebSpaceCreationHandler, } from "../authorization";
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAGrC,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC"}

package/dist/modules/keys/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Key management utilities for web-sdk.
+ *
+ * @packageDocumentation
+ */
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/keys/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/keys/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/modules/registry/Registry.d.ts

@@ -0,0 +1,59 @@
+import { type Address } from "viem";
+import { providers } from "ethers";
+export declare const REGISTRY_CONTRACT_ADDRESS: {
+    1: string;
+    11155111: string;
+};
+export interface RegistryConfig {
+    provider: providers.Web3Provider;
+}
+/**
+ * Registry provides access to the TinyCloud Registry contract for resolving
+ * account addresses to their associated node identifiers.
+ */
+export declare class Registry {
+    provider: providers.Web3Provider;
+    /**
+     * Creates a new instance of the Registry class.
+     *
+     * @param config - Configuration options for the Registry
+     * @param config.rpcUrl - The RPC URL to connect to the blockchain
+     * @param config.contractAddress - The address of the Registry contract
+     */
+    constructor(config: RegistryConfig);
+    /**
+     * Gets the node identifier associated with an account address.
+     *
+     * @param account - The account address to look up
+     * @returns A Promise containing the node identifier string
+     *
+     * @example
+     * ```ts
+     * const registry = new Registry({
+     *   rpcUrl: 'https://mainnet.base.org',
+     *   contractAddress: '0x...'
+     * });
+     * const node = await registry.getNode('0x1234...');
+     * console.log(node); // 'my-node-id'
+     * ```
+     */
+    getNode(account: Address): Promise<string>;
+    addressNode(): Promise<string>;
+    /**
+     * Checks if an account has a registered node.
+     *
+     * @param account - The account address to check
+     * @returns A Promise containing a boolean indicating if the account has a node
+     *
+     * @example
+     * ```ts
+     * const hasNode = await registry.hasNode('0x1234...');
+     * if (hasNode) {
+     *   const node = await registry.getNode('0x1234...');
+     * }
+     * ```
+     */
+    hasNode(account: Address): Promise<boolean>;
+}
+export default Registry;
+//# sourceMappingURL=Registry.d.ts.map

package/dist/modules/registry/Registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Registry.d.ts","sourceRoot":"","sources":["../../../src/modules/registry/Registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAsD,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAExF,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAkBnC,eAAO,MAAM,yBAAyB;;;CAGrC,CAAA;AACD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,SAAS,CAAC,YAAY,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,QAAQ;IAEnB,QAAQ,EAAE,SAAS,CAAC,YAAY,CAAC;IACjC;;;;;;OAMG;gBACS,MAAM,EAAE,cAAc;IAIlC;;;;;;;;;;;;;;;OAeG;IACG,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAyB1C,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAWpC;;;;;;;;;;;;;OAaG;IACG,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CAclD;AAED,eAAe,QAAQ,CAAC"}

package/dist/modules/tcw.d.ts

@@ -0,0 +1,142 @@
+/**
+ * TinyCloudWeb — thin browser wrapper around TinyCloudNode.
+ *
+ * All core logic (auth, services, delegations) is handled by TinyCloudNode.
+ * This wrapper provides:
+ * - Browser-specific adapters (wallet signer, notifications, WASM bindings)
+ * - The familiar TinyCloudWeb public API surface
+ * - Static receiveShare() using browser WASM
+ *
+ * @packageDocumentation
+ */
+import { IKVService, ISQLService, IDuckDbService, IDataVaultService, ISpaceService, ISpace, ISharingService, ICapabilityKeyRegistry, DelegationManager, Delegation, CreateDelegationParams, Result, DelegationError, ClientSession, Extension, ISpaceCreationHandler } from "@tinycloud/sdk-core";
+import type { providers } from "ethers";
+import { RPCProviders, ClientConfig } from "../providers";
+import type { NotificationConfig } from "../notifications/types";
+import type { PortableDelegation, DelegatedAccess } from "@tinycloud/node-sdk/core";
+declare global {
+    interface Window {
+        ethereum?: any;
+    }
+}
+/**
+ * Configuration for TinyCloudWeb.
+ *
+ * Extends ClientConfig with browser-specific options.
+ */
+export interface Config extends ClientConfig {
+    /** Notification configuration for error popups and toasts */
+    notifications?: NotificationConfig;
+    /** Optional prefix for KV service keys */
+    kvPrefix?: string;
+    /** Prefix for space names when creating spaces */
+    spacePrefix?: string;
+    /** TinyCloud server hosts (default: ['https://node.tinycloud.xyz']) */
+    tinycloudHosts?: string[];
+    /** Whether to auto-create space on sign-in (default: true) */
+    autoCreateSpace?: boolean;
+    /** Space creation handler (default: ModalSpaceCreationHandler) */
+    spaceCreationHandler?: ISpaceCreationHandler;
+    /** Session expiration time in milliseconds (default: 1 hour) */
+    sessionExpirationMs?: number;
+    /** Shorthand for passing a Web3 provider */
+    provider?: any;
+}
+/**
+ * Result of receiving a share link.
+ */
+export interface ShareReceiveResult<T = unknown> {
+    data: T;
+    delegation: Delegation;
+    path: string;
+    spaceId: string;
+}
+export declare class TinyCloudWeb {
+    /** The Ethereum provider */
+    provider: providers.Web3Provider;
+    /** Supported RPC Providers */
+    static RPCProviders: typeof RPCProviders;
+    /** Underlying TinyCloudNode (created after WASM init) */
+    private _node;
+    /** Browser notification handler */
+    private notificationHandler;
+    /** Browser WASM bindings */
+    private wasmBindings;
+    /** Browser wallet signer */
+    private walletSigner?;
+    /** Promise that resolves when WASM + node are ready */
+    private _initPromise;
+    /** User config */
+    private config;
+    constructor(config?: Config);
+    /**
+     * Async initialization: ensure WASM is ready, then create TinyCloudNode.
+     * @internal
+     */
+    private _init;
+    /**
+     * Get the TinyCloudNode instance, awaiting init if necessary.
+     * @internal
+     */
+    private ensureNode;
+    /**
+     * Get the TinyCloudNode instance synchronously.
+     * Throws if called before WASM initialization completes.
+     * @internal
+     */
+    private get node();
+    /**
+     * Factory method for guaranteed correct initialization.
+     * Awaits WASM loading before returning the instance.
+     */
+    static create(config?: Config): Promise<TinyCloudWeb>;
+    get kv(): IKVService;
+    get sql(): ISQLService;
+    get duckdb(): IDuckDbService;
+    get vault(): IDataVaultService;
+    get spaces(): ISpaceService;
+    get sharing(): ISharingService;
+    get delegations(): DelegationManager;
+    get capabilityRegistry(): ICapabilityKeyRegistry;
+    space(nameOrUri: string): ISpace;
+    get kvPrefix(): string;
+    signIn: () => Promise<ClientSession>;
+    signOut: () => Promise<void>;
+    session: () => ClientSession | undefined;
+    address: () => string | undefined;
+    chainId: () => number | undefined;
+    get did(): string;
+    get sessionDid(): string;
+    get isSessionOnly(): boolean;
+    get isWalletConnected(): boolean;
+    extend(_extension: Extension): void;
+    cleanup(): void;
+    connectWallet(provider: providers.ExternalProvider | providers.Web3Provider, options?: {
+        spacePrefix?: string;
+    }): void;
+    createDelegation(params: {
+        path: string;
+        actions: string[];
+        delegateDID: string;
+        disableSubDelegation?: boolean;
+        expiryMs?: number;
+    }): Promise<PortableDelegation>;
+    useDelegation(delegation: PortableDelegation): Promise<DelegatedAccess>;
+    createSubDelegation(parentDelegation: PortableDelegation, params: {
+        path: string;
+        actions: string[];
+        delegateDID: string;
+        disableSubDelegation?: boolean;
+        expiryMs?: number;
+    }): Promise<PortableDelegation>;
+    delegate(params: CreateDelegationParams): Promise<Result<Delegation, DelegationError>>;
+    revokeDelegation(cid: string): Promise<Result<void, DelegationError>>;
+    listDelegations(): Promise<Result<Delegation[], DelegationError>>;
+    checkPermission(path: string, action: string): Promise<Result<boolean, DelegationError>>;
+    /**
+     * Receive and retrieve data from a v2 share link.
+     * Static method — no auth required. Uses browser WASM.
+     */
+    static receiveShare<T = unknown>(link: string, key?: string): Promise<Result<ShareReceiveResult<T>, DelegationError>>;
+}
+//# sourceMappingURL=tcw.d.ts.map

package/dist/modules/tcw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tcw.d.ts","sourceRoot":"","sources":["../../src/modules/tcw.ts"],"names":[],"mappings":"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"}

package/dist/notifications/ErrorHandler.d.ts

@@ -0,0 +1,32 @@
+export declare class SDKErrorHandler {
+    private static instance;
+    private toastManager;
+    private config;
+    private isInitialized;
+    private boundHandlers;
+    private constructor();
+    static getInstance(config?: {
+        popups: boolean;
+        throwErrors: boolean;
+    }): SDKErrorHandler;
+    static reset(): void;
+    setupErrorHandling(): void;
+    cleanup(): void;
+    updateConfig(config: {
+        popups: boolean;
+        throwErrors: boolean;
+    }): void;
+    private handleError;
+    private handleWarning;
+    private handleSuccess;
+    private getErrorMessage;
+    private retryWalletConnection;
+    private handleUnhandledRejection;
+}
+export declare const dispatchSDKEvent: {
+    error: any;
+    warning: any;
+    success: any;
+    cleanup: any;
+};
+//# sourceMappingURL=ErrorHandler.d.ts.map

package/dist/notifications/ErrorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorHandler.d.ts","sourceRoot":"","sources":["../../src/notifications/ErrorHandler.ts"],"names":[],"mappings":"AAGA,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgC;IACvD,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,aAAa,CAKnB;IAEF,OAAO;WAaO,WAAW,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,GAAG,eAAe;WAShF,KAAK,IAAI,IAAI;IAOpB,kBAAkB,IAAI,IAAI;IAiB1B,OAAO,IAAI,IAAI;IAWf,YAAY,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAc5E,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,wBAAwB;CAajC;AA4CD,eAAO,MAAM,gBAAgB;;;;;CAK5B,CAAC"}

package/dist/notifications/ModalManager.d.ts

@@ -0,0 +1,15 @@
+import { type SpaceCreationModalOptions, type SpaceCreationResult } from './SpaceCreationModal';
+import { type NodeSelectionModalOptions, type NodeSelectionResult } from './NodeSelectionModal';
+export declare class ModalManager {
+    private static instance;
+    private activeModal;
+    private constructor();
+    static getInstance(): ModalManager;
+    showSpaceCreationModal(options: SpaceCreationModalOptions): Promise<SpaceCreationResult>;
+    showNodeSelectionModal(options: NodeSelectionModalOptions): Promise<NodeSelectionResult>;
+    closeActiveModal(): void;
+    hasActiveModal(): boolean;
+}
+export declare const showSpaceCreationModal: (options: SpaceCreationModalOptions) => Promise<SpaceCreationResult>;
+export declare const showNodeSelectionModal: (options: NodeSelectionModalOptions) => Promise<NodeSelectionResult>;
+//# sourceMappingURL=ModalManager.d.ts.map

package/dist/notifications/ModalManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalManager.d.ts","sourceRoot":"","sources":["../../src/notifications/ModalManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,yBAAyB,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACrH,OAAO,EAA+B,KAAK,yBAAyB,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE7H,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAe;IACtC,OAAO,CAAC,WAAW,CAAkE;IAErF,OAAO;WAEO,WAAW,IAAI,YAAY;IAOlC,sBAAsB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAuBxF,sBAAsB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAuBxF,gBAAgB,IAAI,IAAI;IAOxB,cAAc,IAAI,OAAO;CAGjC;AAGD,eAAO,MAAM,sBAAsB,YAAa,yBAAyB,KAAG,OAAO,CAAC,mBAAmB,CAEtG,CAAC;AAEF,eAAO,MAAM,sBAAsB,YAAa,yBAAyB,KAAG,OAAO,CAAC,mBAAmB,CAEtG,CAAC"}

package/dist/notifications/NodeSelectionModal.d.ts

@@ -0,0 +1,29 @@
+export interface NodeSelectionModalOptions {
+    onCreateNode: (host: string) => Promise<void>;
+    onDismiss?: () => void;
+}
+export interface NodeSelectionResult {
+    host?: string;
+    dismissed: boolean;
+}
+export declare class TinyCloudNodeSelectionModal extends HTMLElement {
+    private options;
+    private isVisible;
+    private isCreating;
+    private resolveResult;
+    private completionPromise;
+    private selectedHost;
+    constructor(options: NodeSelectionModalOptions);
+    getCompletionPromise(): Promise<NodeSelectionResult>;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private render;
+    private getModalStyles;
+    private setupEventListeners;
+    private handleKeyDown;
+    private handleCreateSpace;
+    private show;
+    private hide;
+    private dismiss;
+}
+//# sourceMappingURL=NodeSelectionModal.d.ts.map

package/dist/notifications/NodeSelectionModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeSelectionModal.d.ts","sourceRoot":"","sources":["../../src/notifications/NodeSelectionModal.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,2BAA4B,SAAQ,WAAW;IAC1D,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,aAAa,CAAwD;IAC7E,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,YAAY,CAAwC;gBAEhD,OAAO,EAAE,yBAAyB;IAWvC,oBAAoB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAI3D,iBAAiB;IAKjB,oBAAoB;IAIpB,OAAO,CAAC,MAAM;IAwDd,OAAO,CAAC,cAAc;IA4QtB,OAAO,CAAC,mBAAmB;IAgC3B,OAAO,CAAC,aAAa,CAInB;YAEY,iBAAiB;IAoB/B,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,OAAO;CAKhB"}