@tinycloudlabs/web-sdk 0.2.1 → 1.0.0

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/Storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}
+{"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 "@tinycloudlabs/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,yBAAyB,CAAC;AAEhF,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

@@ -1,6 +1,3 @@
-export { TinyCloud, TinyCloudOptions } from './tinycloud';
-export { OrbitConnection, Request, Response, hostOrbit } from './orbit';
-export { Bytes, WalletProvider } from './walletProvider';
-export { activateSession } from './authenticator';
 export { SessionConfig, Session, HostConfig } from './types';
+export { createKVService } from './KVServiceAdapter';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/Storage/tinycloud/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}
+{"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

@@ -1,6 +1,6 @@
 import { tinycloud } from '@tinycloudlabs/web-sdk-wasm';
 type TinyCloudModule = typeof tinycloud;
-export declare const makeOrbitId: TinyCloudModule['makeOrbitId'];
+export declare const makeSpaceId: TinyCloudModule['makeSpaceId'];
 export declare const prepareSession: TinyCloudModule['prepareSession'];
 export declare const completeSessionSetup: TinyCloudModule['completeSessionSetup'];
 export declare const invoke: TinyCloudModule['invoke'];

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

@@ -16,8 +16,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. */
@@ -39,15 +39,13 @@ export type Session = {
     delegationCid: string;
     /** The session key. */
     jwk: object;
-    /** The namespace the orbit is in */
-    namespace: string;
-    /** The orbit that the session key is permitted to perform actions against. */
-    orbitId: string;
+    /** 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 Orbit Host Delegation SIWE message.
+ * Configuration object for generating a Space Host Delegation SIWE message.
  */
 export type HostConfig = {
     /** Ethereum address. */
@@ -58,8 +56,8 @@ 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;
 };

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

@@ -1 +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,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,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"}
+{"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;
+    expirationTime?: string;
+    notBefore?: string;
+    jwk?: Record<string, unknown>;
+    parents?: string[];
+}, {
+    spaceId?: string;
+    actions?: Record<string, Record<string, string[]>>;
+    address?: string;
+    chainId?: number;
+    domain?: string;
+    issuedAt?: string;
+    expirationTime?: string;
+    notBefore?: string;
+    jwk?: Record<string, unknown>;
+    parents?: string[];
+}>;
+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;
+    delegationHeader?: {
+        Authorization?: string;
+    };
+    jwk?: Record<string, unknown>;
+    delegationCid?: string;
+    verificationMethod?: string;
+}, {
+    spaceId?: string;
+    delegationHeader?: {
+        Authorization?: string;
+    };
+    jwk?: Record<string, unknown>;
+    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/UserAuthorization.d.ts

@@ -1,21 +1,38 @@
-import { providers, Signer } from 'ethers';
-import { tcwSession } from '@tinycloudlabs/web-sdk-wasm';
-import { AxiosInstance } from 'axios';
-import { SiweMessage } from 'siwe';
-import { TCWEnsData } from '@tinycloudlabs/web-core';
-import { TCWClientSession, TCWClientConfig, ITCWConnected, TCWExtension } from '@tinycloudlabs/web-core/client';
+import { providers, Signer } from "ethers";
+import { tcwSession } from "@tinycloudlabs/web-sdk-wasm";
+import { AxiosInstance } from "axios";
+import { SiweMessage } from "siwe";
+import { EnsData } from "@tinycloudlabs/web-core";
+import type { ClientSession, ClientConfig, IConnected, Extension } from "@tinycloudlabs/web-core/client";
+import { IUserAuthorization as ICoreUserAuthorization, PartialSiweMessage } from "@tinycloudlabs/sdk-core";
+import { Session } from "./Storage/tinycloud";
+/**
+ * Extended Client Config with TinyCloud options
+ */
+declare module "@tinycloudlabs/web-core/client" {
+    interface ClientConfig {
+        /** Whether to automatically create space if it doesn't exist (default: true) */
+        autoCreateSpace?: boolean;
+        /** TinyCloud server endpoints (default: ["https://node.tinycloud.xyz"]) */
+        tinycloudHosts?: string[];
+        /** Space prefix for new sessions (default: "default") */
+        spacePrefix?: string;
+    }
+}
 /**
  * Interface for tracking session state during SIWE message generation
  */
 interface PendingSession {
-    /** Instance of TCWSessionManager */
-    sessionManager: tcwSession.TCWSessionManager;
+    /** Instance of SessionManager (null if consumed by build()) */
+    sessionManager: tcwSession.TCWSessionManager | null;
+    /** Session key JWK string (stored before build() consumes sessionManager) */
+    sessionKey?: string;
     /** Ethereum address for the session */
     address: string;
     /** Timestamp when session was generated */
     generatedAt: number;
     /** Extensions that were applied to the session */
-    extensions: TCWExtension[];
+    extensions: Extension[];
 }
 /** UserAuthorization Module
  *
@@ -29,19 +46,19 @@ interface PendingSession {
  */
 interface IUserAuthorization {
     provider: providers.Web3Provider;
-    session?: TCWClientSession;
-    extend: (extension: TCWExtension) => void;
+    session?: ClientSession;
+    extend: (extension: Extension) => void;
     connect(): Promise<any>;
     signIn(): Promise<any>;
     /**
-     * ENS data supported by TCW.
+     * ENS data supported by the SDK.
      * @param address - User address.
      * @param resolveEnsOpts - Options to resolve ENS.
      * @returns Object containing ENS data.
      */
     resolveEns(
     /** User address */
-    address: string): Promise<TCWEnsData>;
+    address: string): Promise<EnsData>;
     address(): string | undefined;
     chainId(): number | undefined;
     /**
@@ -54,41 +71,62 @@ interface IUserAuthorization {
     /**
      * Generates a SIWE message for authentication with session key capabilities.
      * @param address - Ethereum address performing the signing
-     * @param partialSiweMessage - Optional partial SIWE message to override defaults
+     * @param partial - Optional partial SIWE message to override defaults
      * @returns SiweMessage object ready for signing
      */
-    generateSiweMessage(address: string, partialSiweMessage?: Partial<SiweMessage>): Promise<SiweMessage>;
+    generateSiweMessage(address: string, partial?: PartialSiweMessage): Promise<SiweMessage>;
     /**
      * Sign in to the SDK using a pre-signed SIWE message.
      * @param siweMessage - The SIWE message that was generated
      * @param signature - The signature of the SIWE message
-     * @returns Promise with the TCWClientSession object
+     * @returns Promise with the ClientSession object
+     */
+    signInWithSignature(siweMessage: SiweMessage, signature: string): Promise<ClientSession>;
+    /**
+     * Get the space ID for the current session.
+     * @returns Space ID or undefined if not available
      */
-    signInWithSignature(siweMessage: SiweMessage, signature: string): Promise<TCWClientSession>;
+    getSpaceId(): string | undefined;
+    /**
+     * Get the configured TinyCloud host URLs.
+     * @returns Array of TinyCloud host URLs
+     */
+    getTinycloudHosts(): string[];
+    /**
+     * Ensure the user's space exists on the TinyCloud server.
+     * Creates the space if it doesn't exist (when autoCreateSpace is true).
+     */
+    ensureSpaceExists(): Promise<void>;
+    /**
+     * Get the active TinyCloud session.
+     * This provides access to the session for authenticated requests.
+     * @returns Session object or undefined if not signed in
+     */
+    getTinycloudSession(): Session | undefined;
 }
 declare class UserAuthorizationInit {
     private config?;
-    /** Extensions for the TCWClientSession. */
-    extensions: TCWExtension[];
+    /** Extensions for the session. */
+    extensions: Extension[];
     /** The session representation (once signed in). */
-    session?: TCWClientSession;
-    constructor(config?: TCWClientConfig);
-    /** Extend the session with an TCW compatible extension. */
-    extend(extension: TCWExtension): void;
+    session?: ClientSession;
+    constructor(config?: ClientConfig);
+    /** Extend the session with a compatible extension. */
+    extend(extension: Extension): void;
     /**
      * Connect to the signing account using the configured provider.
      * @returns UserAuthorizationConnected instance.
      */
     connect(): Promise<UserAuthorizationConnected>;
 }
-/** An intermediate TCW state: connected, but not signed-in. */
-declare class UserAuthorizationConnected implements ITCWConnected {
-    /** Instance of TCWSessionManager */
+/** An intermediate state: connected, but not signed-in. */
+declare class UserAuthorizationConnected implements IConnected {
+    /** Instance of SessionManager */
     builder: tcwSession.TCWSessionManager;
-    /** TCWConfig object. */
-    config: TCWClientConfig;
+    /** Config object. */
+    config: ClientConfig;
     /** Enabled extensions. */
-    extensions: TCWExtension[];
+    extensions: Extension[];
     /** EthersJS provider. */
     provider: providers.Web3Provider;
     /**
@@ -102,65 +140,99 @@ declare class UserAuthorizationConnected implements ITCWConnected {
     api?: AxiosInstance;
     /** Ethereum Provider */
     constructor(
-    /** Instance of TCWSessionManager */
+    /** Instance of SessionManager */
     builder: tcwSession.TCWSessionManager, 
-    /** TCWConfig object. */
-    config: TCWClientConfig, 
+    /** Config object. */
+    config: ClientConfig, 
     /** Enabled extensions. */
-    extensions: TCWExtension[], 
+    extensions: Extension[], 
     /** EthersJS provider. */
     provider: providers.Web3Provider);
+    /**
+     * Default KV actions for TinyCloud services.
+     * These are added to every session to enable basic KV operations.
+     */
+    private static readonly DEFAULT_KV_ACTIONS;
+    /**
+     * Default capabilities actions (for reading user capabilities).
+     */
+    private static readonly DEFAULT_CAPABILITIES_ACTIONS;
     /** Applies the "afterConnect" methods and the delegated capabilities of the extensions. */
     applyExtensions(): Promise<void>;
+    /**
+     * Adds default KV capabilities for the given user address and chainId.
+     * Must be called after we have address/chainId but before build().
+     * @param address - User's Ethereum address
+     * @param chainId - Chain ID
+     * @param spacePrefix - Space prefix (default: "default")
+     * @param kvPrefix - KV path prefix for scoping access (default: "" for all paths)
+     */
+    addDefaultCapabilities(address: string, chainId: number, spacePrefix?: string, kvPrefix?: string): void;
     /**
      * Applies the "afterSignIn" methods of the extensions.
-     * @param session - TCWClientSession object.
+     * @param session - ClientSession object.
      */
-    afterSignIn(session: TCWClientSession): Promise<void>;
+    afterSignIn(session: ClientSession): Promise<void>;
     /**
      * Requests the user to sign in.
      * Generates the SIWE message for this session, requests the configured
      * Signer to sign the message, calls the "afterSignIn" methods of the
      * extensions.
-     * @returns Promise with the TCWClientSession object.
+     * @returns Promise with the ClientSession object.
      */
-    signIn(): Promise<TCWClientSession>;
+    signIn(): Promise<ClientSession>;
     /**
      * Requests the user to sign out.
-     * @param session - TCWClientSession object.
+     * @param session - ClientSession object.
      */
-    signOut(session: TCWClientSession): Promise<void>;
+    signOut(session: ClientSession): Promise<void>;
 }
-declare class UserAuthorization implements IUserAuthorization {
+declare class UserAuthorization implements IUserAuthorization, ICoreUserAuthorization {
     private _config;
     /** The Ethereum provider */
     provider: providers.Web3Provider;
     /** The session representation (once signed in). */
-    session?: TCWClientSession;
-    /** TCWClientSession builder. */
+    session?: ClientSession;
+    /** Session builder. */
     private init;
-    /** Current connection of TCW */
+    /** Current connection */
     private connection?;
-    /** The TCWClientConfig object. */
+    /** The config object. */
     private config;
     /** Pending session state for signature-based initialization */
     private pendingSession?;
-    constructor(_config?: TCWClientConfig);
+    /** Whether to automatically create space if it doesn't exist */
+    private autoCreateSpace;
+    /** TinyCloud server endpoints */
+    private tinycloudHosts;
+    /** Space prefix for new sessions */
+    private spacePrefix;
+    /** KV path prefix for scoping access */
+    private kvPrefix;
+    /** The space ID for the current session */
+    private _spaceId?;
+    /** Delegation header for the current session */
+    private _delegationHeader?;
+    /** The TinyCloud session containing delegation and space info */
+    private _tinycloudSession?;
+    /** The host where the user's space was found or created */
+    private _activeHost?;
+    constructor(_config?: ClientConfig);
     /**
-     * Extends TCW with a functions that are called after connecting and signing in.
+     * Extends with functions that are called after connecting and signing in.
      */
-    extend(extension: TCWExtension): void;
+    extend(extension: Extension): void;
     connect(): Promise<void>;
-    signIn(): Promise<TCWClientSession>;
+    signIn(): Promise<ClientSession>;
     /**
-     * ENS data supported by TCW.
+     * ENS data supported by the SDK.
      * @param address - User address.
      * @param resolveEnsOpts - Options to resolve ENS.
      * @returns Object containing ENS data.
      */
     resolveEns(
     /** User address */
-    address: string): Promise<TCWEnsData>;
+    address: string): Promise<EnsData>;
     /**
      * Invalidates user's session.
      */
@@ -193,36 +265,97 @@ declare class UserAuthorization implements IUserAuthorization {
     getSigner(): Signer;
     /**
      * Generates a SIWE message for authentication with session key capabilities.
-     * This method initializes a TCWSessionManager, generates a session key,
+     * This method initializes a SessionManager, generates a session key,
      * applies extension capabilities, and builds a SIWE message for signing.
      *
      * @param address - Ethereum address performing the signing
-     * @param partialSiweMessage - Optional partial SIWE message to override defaults
+     * @param partial - Optional partial SIWE message to override defaults
      * @returns SiweMessage object ready for signing
      */
-    generateSiweMessage(address: string, partialSiweMessage?: Partial<SiweMessage>): Promise<SiweMessage>;
+    generateSiweMessage(address: string, partial?: PartialSiweMessage): Promise<SiweMessage>;
     /**
      * Sign in to the SDK using a pre-signed SIWE message.
      * This method must be called after generateSiweMessage().
      * @param siweMessage - The SIWE message that was generated
      * @param signature - The signature of the SIWE message
-     * @returns Promise with the TCWClientSession object
+     * @returns Promise with the ClientSession object
+     */
+    signInWithSignature(siweMessage: SiweMessage, signature: string): Promise<ClientSession>;
+    /**
+     * Default KV actions for TinyCloud services.
+     * These are added to every session to enable basic KV operations.
      */
-    signInWithSignature(siweMessage: SiweMessage, signature: string): Promise<TCWClientSession>;
+    private static readonly DEFAULT_KV_ACTIONS;
+    /**
+     * Default capabilities actions (for reading user capabilities).
+     */
+    private static readonly DEFAULT_CAPABILITIES_ACTIONS;
     /**
      * Applies extension capabilities (defaultActions/targetedActions) to the session manager.
-     * This method iterates through the extensions and adds their capabilities to the TCWSessionManager.
+     * This method also adds default KV and capabilities actions.
      *
      * @private
-     * @param sessionManager - TCWSessionManager instance to apply capabilities to
+     * @param sessionManager - SessionManager instance to apply capabilities to
      * @param extensions - Array of extensions to apply
+     * @param address - User's Ethereum address (for building target URIs)
+     * @param chainId - Chain ID (for building target URIs)
+     * @param spacePrefix - Space prefix (default: "default")
+     * @param kvPrefix - KV path prefix for scoping access (default: "" for all paths)
      */
     private applyExtensionCapabilities;
+    /**
+     * Get the space ID for the current session.
+     * @returns Space ID or undefined if not available
+     */
+    getSpaceId(): string | undefined;
+    /**
+     * Get the configured TinyCloud host URLs.
+     * @returns Array of TinyCloud host URLs
+     */
+    getTinycloudHosts(): string[];
+    /**
+     * Get the active TinyCloud session.
+     * This provides access to the session for authenticated requests.
+     * @returns Session object or undefined if not signed in
+     */
+    getTinycloudSession(): Session | undefined;
+    /**
+     * Create the space on the TinyCloud server (host delegation).
+     * This registers the user as the owner of the space.
+     * Uses a modal to confirm with the user before creating.
+     * @param host - The host to create the space on
+     * @returns Promise resolving to true if space was created, false if user dismissed
+     */
+    private hostSpace;
+    /**
+     * Ensure the user's space exists on the TinyCloud server.
+     * Creates the space if it doesn't exist and autoCreateSpace is enabled.
+     *
+     * Strategy:
+     * 1. Try to activate the session on the first (primary) host.
+     * 2. If activation succeeds, set it as the `_activeHost` and return.
+     * 3. If the primary host returns 404, create the space there (don't skip
+     *    because it might exist on other hosts - there is no replication).
+     * 4. If the primary host has a non-404 error, try remaining hosts.
+     *
+     * @throws Error if space creation fails or is disabled and space doesn't exist.
+     */
+    ensureSpaceExists(): Promise<void>;
+    /**
+     * Create the space on a specific host and activate the session there.
+     */
+    private createSpaceOnHost;
     /**
      * Apply extension afterSignIn hooks to the session.
-     * @param session - The TCWClientSession object
+     * @param session - The ClientSession object
      */
     private applyAfterSignInHooks;
+    /**
+     * Generate space ID and delegation header for the current session.
+     * This sets up the internal state needed for ensureSpaceExists() and SpaceConnection.
+     * @param session - The ClientSession object
+     */
+    private setupSpaceSession;
 }
 export { IUserAuthorization, UserAuthorization, UserAuthorizationInit, UserAuthorizationConnected, PendingSession, };
 //# sourceMappingURL=UserAuthorization.d.ts.map