@tinycloud/node-sdk 2.2.0-beta.3 → 2.2.0-beta.5

package/dist/{core-NsTndW58.d.cts → core-DdMPUB5s.d.cts}

@@ -189,8 +189,12 @@ interface NodeUserAuthorizationConfig {
     autoCreateSpace?: boolean;
     /** Custom space creation handler. If provided, takes precedence over autoCreateSpace. */
     spaceCreationHandler?: ISpaceCreationHandler;
-    /** TinyCloud server endpoints (default: ["https://node.tinycloud.xyz"]) */
+    /** Explicit TinyCloud server endpoints. When omitted, signIn resolves the user's host. */
     tinycloudHosts?: string[];
+    /** TinyCloud location registry URL. Default: https://registry.tinycloud.xyz. */
+    tinycloudRegistryUrl?: string | null;
+    /** Fallback TinyCloud hosts. Default: hosted TinyCloud node. */
+    tinycloudFallbackHosts?: string[] | null;
     /** Whether to include public space capabilities in the session (default: true) */
     enablePublicSpace?: boolean;
     /** WASM bindings for cryptographic operations. Required. */
@@ -270,7 +274,9 @@ declare class NodeUserAuthorization implements IUserAuthorization {
     private readonly sessionExpirationMs;
     private readonly autoCreateSpace;
     private readonly spaceCreationHandler?;
-    private readonly tinycloudHosts;
+    private tinycloudHosts?;
+    private readonly tinycloudRegistryUrl?;
+    private readonly tinycloudFallbackHosts?;
     private readonly enablePublicSpace;
     private readonly nonce?;
     private readonly siweConfig?;
@@ -299,6 +305,7 @@ declare class NodeUserAuthorization implements IUserAuthorization {
      */
     get manifest(): Manifest | Manifest[] | undefined;
     get capabilityRequest(): ComposedManifestRequest | undefined;
+    get hosts(): string[];
     /**
      * Install or replace the stored manifest. Takes effect on the next
      * `signIn()` call — the current session (if any) is not touched.
@@ -314,6 +321,9 @@ declare class NodeUserAuthorization implements IUserAuthorization {
      * Includes spaceId, delegationHeader, and delegationCid.
      */
     get tinyCloudSession(): TinyCloudSession | undefined;
+    private resolveTinyCloudHostsForSignIn;
+    private requireTinyCloudHosts;
+    private get primaryTinyCloudHost();
     get nodeFeatures(): string[];
     /**
      * Compute the `abilities` map the WASM `prepareSession` call should
@@ -644,8 +654,12 @@ interface TinyCloudNodeConfig {
     privateKey?: string;
     /** Custom signer implementation. If provided, takes precedence over privateKey. */
     signer?: ISigner;
-    /** TinyCloud server URL (default: "https://node.tinycloud.xyz") */
+    /** Explicit TinyCloud server URL. When omitted, signIn resolves the user's host. */
     host?: string;
+    /** TinyCloud location registry URL. Default: https://registry.tinycloud.xyz. */
+    tinycloudRegistryUrl?: string | null;
+    /** Fallback TinyCloud hosts. Default: hosted TinyCloud node. */
+    tinycloudFallbackHosts?: string[] | null;
     /** Space prefix for this user's space. Optional - only needed for signIn() */
     prefix?: string;
     /** Domain for SIWE messages (default: derived from host) */
@@ -742,6 +756,7 @@ declare class TinyCloudNode {
     /** @internal Register Node.js-specific defaults (NodeWasmBindings, PrivateKeySigner) */
     static registerNodeDefaults(defaults: NodeDefaults): void;
     private config;
+    private readonly explicitHost?;
     private signer;
     private auth;
     private tc;
@@ -800,6 +815,7 @@ declare class TinyCloudNode {
      * @internal
      */
     private setupAuth;
+    private syncResolvedHostFromAuth;
     /**
      * Install or replace the manifest that drives the SIWE recap at
      * sign-in. Takes effect on the next `signIn()` call — the current
@@ -815,6 +831,7 @@ declare class TinyCloudNode {
      */
     get manifest(): Manifest | Manifest[] | undefined;
     get capabilityRequest(): ComposedManifestRequest | undefined;
+    get hosts(): string[];
     /**
      * Get the primary identity DID for this user.
      * - If wallet connected and signed in: returns PKH DID (did:pkh:eip155:{chainId}:{address})
@@ -860,6 +877,7 @@ declare class TinyCloudNode {
     signIn(options?: SignInOptions): Promise<void>;
     private ownedSpaceId;
     private writeManifestRegistryRecords;
+    private ensureOwnedSpaceHosted;
     /**
      * Restore a previously established session from stored delegation data.
      *

package/dist/{core-NsTndW58.d.ts → core-DdMPUB5s.d.ts}

@@ -189,8 +189,12 @@ interface NodeUserAuthorizationConfig {
     autoCreateSpace?: boolean;
     /** Custom space creation handler. If provided, takes precedence over autoCreateSpace. */
     spaceCreationHandler?: ISpaceCreationHandler;
-    /** TinyCloud server endpoints (default: ["https://node.tinycloud.xyz"]) */
+    /** Explicit TinyCloud server endpoints. When omitted, signIn resolves the user's host. */
     tinycloudHosts?: string[];
+    /** TinyCloud location registry URL. Default: https://registry.tinycloud.xyz. */
+    tinycloudRegistryUrl?: string | null;
+    /** Fallback TinyCloud hosts. Default: hosted TinyCloud node. */
+    tinycloudFallbackHosts?: string[] | null;
     /** Whether to include public space capabilities in the session (default: true) */
     enablePublicSpace?: boolean;
     /** WASM bindings for cryptographic operations. Required. */
@@ -270,7 +274,9 @@ declare class NodeUserAuthorization implements IUserAuthorization {
     private readonly sessionExpirationMs;
     private readonly autoCreateSpace;
     private readonly spaceCreationHandler?;
-    private readonly tinycloudHosts;
+    private tinycloudHosts?;
+    private readonly tinycloudRegistryUrl?;
+    private readonly tinycloudFallbackHosts?;
     private readonly enablePublicSpace;
     private readonly nonce?;
     private readonly siweConfig?;
@@ -299,6 +305,7 @@ declare class NodeUserAuthorization implements IUserAuthorization {
      */
     get manifest(): Manifest | Manifest[] | undefined;
     get capabilityRequest(): ComposedManifestRequest | undefined;
+    get hosts(): string[];
     /**
      * Install or replace the stored manifest. Takes effect on the next
      * `signIn()` call — the current session (if any) is not touched.
@@ -314,6 +321,9 @@ declare class NodeUserAuthorization implements IUserAuthorization {
      * Includes spaceId, delegationHeader, and delegationCid.
      */
     get tinyCloudSession(): TinyCloudSession | undefined;
+    private resolveTinyCloudHostsForSignIn;
+    private requireTinyCloudHosts;
+    private get primaryTinyCloudHost();
     get nodeFeatures(): string[];
     /**
      * Compute the `abilities` map the WASM `prepareSession` call should
@@ -644,8 +654,12 @@ interface TinyCloudNodeConfig {
     privateKey?: string;
     /** Custom signer implementation. If provided, takes precedence over privateKey. */
     signer?: ISigner;
-    /** TinyCloud server URL (default: "https://node.tinycloud.xyz") */
+    /** Explicit TinyCloud server URL. When omitted, signIn resolves the user's host. */
     host?: string;
+    /** TinyCloud location registry URL. Default: https://registry.tinycloud.xyz. */
+    tinycloudRegistryUrl?: string | null;
+    /** Fallback TinyCloud hosts. Default: hosted TinyCloud node. */
+    tinycloudFallbackHosts?: string[] | null;
     /** Space prefix for this user's space. Optional - only needed for signIn() */
     prefix?: string;
     /** Domain for SIWE messages (default: derived from host) */
@@ -742,6 +756,7 @@ declare class TinyCloudNode {
     /** @internal Register Node.js-specific defaults (NodeWasmBindings, PrivateKeySigner) */
     static registerNodeDefaults(defaults: NodeDefaults): void;
     private config;
+    private readonly explicitHost?;
     private signer;
     private auth;
     private tc;
@@ -800,6 +815,7 @@ declare class TinyCloudNode {
      * @internal
      */
     private setupAuth;
+    private syncResolvedHostFromAuth;
     /**
      * Install or replace the manifest that drives the SIWE recap at
      * sign-in. Takes effect on the next `signIn()` call — the current
@@ -815,6 +831,7 @@ declare class TinyCloudNode {
      */
     get manifest(): Manifest | Manifest[] | undefined;
     get capabilityRequest(): ComposedManifestRequest | undefined;
+    get hosts(): string[];
     /**
      * Get the primary identity DID for this user.
      * - If wallet connected and signed in: returns PKH DID (did:pkh:eip155:{chainId}:{address})
@@ -860,6 +877,7 @@ declare class TinyCloudNode {
     signIn(options?: SignInOptions): Promise<void>;
     private ownedSpaceId;
     private writeManifestRegistryRecords;
+    private ensureOwnedSpaceHosted;
     /**
      * Restore a previously established session from stored delegation data.
      *

package/dist/core.cjs

@@ -339,9 +339,9 @@ var NodeUserAuthorization = class {
     this.sessionExpirationMs = config.sessionExpirationMs ?? 60 * 60 * 1e3;
     this.autoCreateSpace = config.autoCreateSpace ?? false;
     this.spaceCreationHandler = config.spaceCreationHandler;
-    this.tinycloudHosts = config.tinycloudHosts ?? [
-      "https://node.tinycloud.xyz"
-    ];
+    this.tinycloudHosts = config.tinycloudHosts;
+    this.tinycloudRegistryUrl = config.tinycloudRegistryUrl;
+    this.tinycloudFallbackHosts = config.tinycloudFallbackHosts;
     this.enablePublicSpace = config.enablePublicSpace ?? true;
     this.nonce = config.nonce;
     this.siweConfig = config.siweConfig;
@@ -362,6 +362,9 @@ var NodeUserAuthorization = class {
   get capabilityRequest() {
     return this.getCapabilityRequest();
   }
+  get hosts() {
+    return this.tinycloudHosts ? [...this.tinycloudHosts] : [];
+  }
   /**
    * Install or replace the stored manifest. Takes effect on the next
    * `signIn()` call — the current session (if any) is not touched.
@@ -386,6 +389,26 @@ var NodeUserAuthorization = class {
   get tinyCloudSession() {
     return this._tinyCloudSession;
   }
+  async resolveTinyCloudHostsForSignIn(address, chainId) {
+    if (this.tinycloudHosts && this.tinycloudHosts.length > 0) {
+      return;
+    }
+    const subject = `did:pkh:eip155:${chainId}:${address}`;
+    const resolved = await (0, import_sdk_core2.resolveTinyCloudHosts)(subject, {
+      registryUrl: this.tinycloudRegistryUrl,
+      fallbackHosts: this.tinycloudFallbackHosts
+    });
+    this.tinycloudHosts = resolved.hosts;
+  }
+  requireTinyCloudHosts() {
+    if (!this.tinycloudHosts || this.tinycloudHosts.length === 0) {
+      throw new Error("TinyCloud hosts have not been resolved. Call signIn() first.");
+    }
+    return this.tinycloudHosts;
+  }
+  get primaryTinyCloudHost() {
+    return this.requireTinyCloudHosts()[0];
+  }
   get nodeFeatures() {
     return this._nodeFeatures;
   }
@@ -517,7 +540,7 @@ var NodeUserAuthorization = class {
     if (!this._tinyCloudSession || !this._address || !this._chainId) {
       throw new Error("Must be signed in to host space");
     }
-    const host = this.tinycloudHosts[0];
+    const host = this.primaryTinyCloudHost;
     const spaceId = targetSpaceId ?? this._tinyCloudSession.spaceId;
     const peerId = await (0, import_sdk_core2.fetchPeerId)(host, spaceId);
     const siwe = this.wasm.generateHostSIWEMessage({
@@ -559,7 +582,7 @@ var NodeUserAuthorization = class {
     if (!this._tinyCloudSession) {
       throw new Error("Must be signed in to ensure space exists");
     }
-    const host = this.tinycloudHosts[0];
+    const host = this.primaryTinyCloudHost;
     const primarySpaceId = this._tinyCloudSession.spaceId;
     const result = await (0, import_sdk_core2.activateSessionWithHost)(
       host,
@@ -668,6 +691,7 @@ var NodeUserAuthorization = class {
     this._chainId = await this.signer.getChainId();
     const address = this.wasm.ensureEip55(this._address);
     const chainId = this._chainId;
+    await this.resolveTinyCloudHostsForSignIn(address, chainId);
     const keyId = `session-${Date.now()}`;
     this.sessionManager.renameSessionKeyId("default", keyId);
     const jwkString = this.sessionManager.jwk(keyId);
@@ -746,7 +770,7 @@ var NodeUserAuthorization = class {
     this._address = address;
     this._chainId = chainId;
     const nodeInfo = await (0, import_sdk_core2.checkNodeInfo)(
-      this.tinycloudHosts[0],
+      this.primaryTinyCloudHost,
       this.wasm.protocolVersion()
     );
     this._nodeFeatures = nodeInfo.features;
@@ -862,6 +886,7 @@ var NodeUserAuthorization = class {
     });
     const address = this.wasm.ensureEip55(await this.signer.getAddress());
     const chainId = await this.signer.getChainId();
+    await this.resolveTinyCloudHostsForSignIn(address, chainId);
     const clientSession = {
       address,
       walletAddress: address,
@@ -911,7 +936,7 @@ var NodeUserAuthorization = class {
     this._address = address;
     this._chainId = chainId;
     const nodeInfo = await (0, import_sdk_core2.checkNodeInfo)(
-      this.tinycloudHosts[0],
+      this.primaryTinyCloudHost,
       this.wasm.protocolVersion()
     );
     this._nodeFeatures = nodeInfo.features;
@@ -1258,6 +1283,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     this.auth = null;
     this.tc = null;
     this._chainId = 1;
+    this.explicitHost = config.host;
     this.config = {
       ...config,
       host: config.host ?? DEFAULT_HOST
@@ -1339,7 +1365,6 @@ var _TinyCloudNode = class _TinyCloudNode {
    * @internal
    */
   setupAuth(config) {
-    const host = this.config.host;
     this.auth = new NodeUserAuthorization({
       signer: this.signer,
       signStrategy: { type: "auto-sign" },
@@ -1348,7 +1373,9 @@ var _TinyCloudNode = class _TinyCloudNode {
       domain: this.siweDomain,
       spacePrefix: config.prefix,
       sessionExpirationMs: config.sessionExpirationMs ?? 60 * 60 * 1e3,
-      tinycloudHosts: [host],
+      tinycloudHosts: this.explicitHost ? [this.explicitHost] : void 0,
+      tinycloudRegistryUrl: config.tinycloudRegistryUrl,
+      tinycloudFallbackHosts: config.tinycloudFallbackHosts,
       autoCreateSpace: config.autoCreateSpace,
       enablePublicSpace: config.enablePublicSpace ?? true,
       spaceCreationHandler: config.spaceCreationHandler,
@@ -1362,6 +1389,12 @@ var _TinyCloudNode = class _TinyCloudNode {
       invokeAny: this.wasmBindings.invokeAny
     });
   }
+  syncResolvedHostFromAuth() {
+    const host = this.auth?.hosts[0];
+    if (host) {
+      this.config.host = host;
+    }
+  }
   /**
    * Install or replace the manifest that drives the SIWE recap at
    * sign-in. Takes effect on the next `signIn()` call — the current
@@ -1399,6 +1432,10 @@ var _TinyCloudNode = class _TinyCloudNode {
   get capabilityRequest() {
     return this.auth?.capabilityRequest;
   }
+  get hosts() {
+    const authHosts = this.auth?.hosts ?? [];
+    return authHosts.length > 0 ? authHosts : [this.config.host];
+  }
   /**
    * Get the primary identity DID for this user.
    * - If wallet connected and signed in: returns PKH DID (did:pkh:eip155:{chainId}:{address})
@@ -1471,6 +1508,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     this._hooks = void 0;
     this._serviceContext = void 0;
     await this.tc.signIn(options);
+    this.syncResolvedHostFromAuth();
     this.initializeServices();
     await this.writeManifestRegistryRecords();
     this.notificationHandler.success("Successfully signed in");
@@ -1490,7 +1528,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       throw new Error("Manifest registry write requires wallet mode");
     }
     const accountSpaceId = this.ownedSpaceId(import_sdk_core5.ACCOUNT_REGISTRY_SPACE);
-    await this.auth.hostOwnedSpace(accountSpaceId);
+    await this.ensureOwnedSpaceHosted(accountSpaceId);
     const accountKV = this.spaces.get(accountSpaceId).kv;
     for (const record of request.registryRecords) {
       const result = await accountKV.put(record.key, {
@@ -1505,6 +1543,39 @@ var _TinyCloudNode = class _TinyCloudNode {
       }
     }
   }
+  async ensureOwnedSpaceHosted(spaceId) {
+    if (!this.auth) {
+      throw new Error("Owned space hosting requires wallet mode");
+    }
+    const session = this.auth.tinyCloudSession;
+    if (!session) {
+      throw new Error("Owned space hosting requires an active session");
+    }
+    const host = this.hosts[0] ?? this.config.host;
+    if (!host) {
+      throw new Error("Owned space hosting requires a TinyCloud host");
+    }
+    const activation = await (0, import_sdk_core5.activateSessionWithHost)(host, session.delegationHeader);
+    if (activation.success && !activation.skipped?.includes(spaceId)) {
+      return;
+    }
+    if (!activation.success && activation.status !== 404) {
+      throw new Error(
+        `Failed to check owned space ${spaceId}: ${activation.error ?? activation.status}`
+      );
+    }
+    const created = await this.auth.hostOwnedSpace(spaceId);
+    if (!created) {
+      throw new Error(`Failed to create owned space: ${spaceId}`);
+    }
+    await new Promise((resolve) => setTimeout(resolve, 100));
+    const retry = await (0, import_sdk_core5.activateSessionWithHost)(host, session.delegationHeader);
+    if (!retry.success || retry.skipped?.includes(spaceId)) {
+      throw new Error(
+        `Failed to activate session after creating owned space ${spaceId}: ${retry.error ?? "space was skipped"}`
+      );
+    }
+  }
   /**
    * Restore a previously established session from stored delegation data.
    *
@@ -1622,7 +1693,6 @@ var _TinyCloudNode = class _TinyCloudNode {
       throw new Error("Wallet already connected. Cannot connect another wallet.");
     }
     const prefix = options?.prefix ?? "default";
-    const host = this.config.host;
     if (!_TinyCloudNode.nodeDefaults) {
       throw new Error(
         "connectWallet() requires PrivateKeySigner. Use connectSigner() instead, or import from '@tinycloud/node-sdk' (not '/core') for automatic Node.js defaults."
@@ -1637,7 +1707,9 @@ var _TinyCloudNode = class _TinyCloudNode {
       domain: this.siweDomain,
       spacePrefix: prefix,
       sessionExpirationMs: this.config.sessionExpirationMs ?? 60 * 60 * 1e3,
-      tinycloudHosts: [host],
+      tinycloudHosts: this.explicitHost ? [this.explicitHost] : void 0,
+      tinycloudRegistryUrl: this.config.tinycloudRegistryUrl,
+      tinycloudFallbackHosts: this.config.tinycloudFallbackHosts,
       autoCreateSpace: this.config.autoCreateSpace,
       enablePublicSpace: this.config.enablePublicSpace ?? true,
       spaceCreationHandler: this.config.spaceCreationHandler,
@@ -1670,7 +1742,6 @@ var _TinyCloudNode = class _TinyCloudNode {
       throw new Error("Signer already connected. Cannot connect another signer.");
     }
     const prefix = options?.prefix ?? "default";
-    const host = this.config.host;
     this.signer = signer;
     this.auth = new NodeUserAuthorization({
       signer: this.signer,
@@ -1680,7 +1751,9 @@ var _TinyCloudNode = class _TinyCloudNode {
       domain: this.siweDomain,
       spacePrefix: prefix,
       sessionExpirationMs: this.config.sessionExpirationMs ?? 60 * 60 * 1e3,
-      tinycloudHosts: [host],
+      tinycloudHosts: this.explicitHost ? [this.explicitHost] : void 0,
+      tinycloudRegistryUrl: this.config.tinycloudRegistryUrl,
+      tinycloudFallbackHosts: this.config.tinycloudFallbackHosts,
       autoCreateSpace: this.config.autoCreateSpace,
       enablePublicSpace: this.config.enablePublicSpace ?? true,
       spaceCreationHandler: this.config.spaceCreationHandler,