@tinycloud/node-sdk 2.4.1-beta.0 → 2.5.0

package/dist/index.cjs

@@ -17722,7 +17722,7 @@ var NodeUserAuthorization = class {
    * Create the space on the TinyCloud server (host delegation).
    * This registers the user as the owner of the space.
    */
-  async hostSpace(targetSpaceId) {
+  async hostSpace(targetSpaceId, purpose) {
     if (!this._tinyCloudSession || !this._address || !this._chainId) {
       throw new Error("Must be signed in to host space");
     }
@@ -17738,7 +17738,7 @@ var NodeUserAuthorization = class {
       spaceId,
       peerId
     });
-    const signature2 = await this.signMessage(siwe);
+    const signature2 = await this.signMessage(siwe, purpose);
     const headers = this.wasm.siweToDelegationHeaders({ siwe, signature: signature2 });
     const result = await (0, import_sdk_core2.submitHostDelegation)(host, headers);
     return result.success;
@@ -17754,8 +17754,8 @@ var NodeUserAuthorization = class {
    * Create a specific owned space on the server via host delegation.
    * Used by manifest registry setup for the account space.
    */
-  async hostOwnedSpace(spaceId) {
-    return this.hostSpace(spaceId);
+  async hostOwnedSpace(spaceId, purpose) {
+    return this.hostSpace(spaceId, purpose);
   }
   /**
    * Ensure the user's space exists on the TinyCloud server.
@@ -17905,7 +17905,8 @@ var NodeUserAuthorization = class {
       address,
       chainId,
       message: prepared.siwe,
-      type: "siwe"
+      type: "siwe",
+      purpose: "bootstrap-session"
     });
     const session = this.wasm.completeSessionSetup({
       ...prepared,
@@ -17969,7 +17970,8 @@ var NodeUserAuthorization = class {
       address,
       chainId,
       message: prepared.siwe,
-      type: "siwe"
+      type: "siwe",
+      purpose: "sign-in"
     });
     const session = this.wasm.completeSessionSetup({
       ...prepared,
@@ -18057,7 +18059,7 @@ var NodeUserAuthorization = class {
   /**
    * Sign a message with the connected signer.
    */
-  async signMessage(message) {
+  async signMessage(message, purpose) {
     if (!this._address) {
       this._address = (0, import_sdk_core2.canonicalizeAddress)(await this.signer.getAddress());
     }
@@ -18068,7 +18070,8 @@ var NodeUserAuthorization = class {
       address: this._address,
       chainId: this._chainId,
       message,
-      type: "message"
+      type: "message",
+      ...purpose ? { purpose } : {}
     });
   }
   /**
@@ -18696,6 +18699,15 @@ var DEFAULT_SESSION_EXPIRATION_MS = import_sdk_core7.EXPIRY.SESSION_MS;
 function isOpenKeyAutoSignStrategy(strategy) {
   return strategy?.openKeyAutoSign === true;
 }
+function isInteractiveSigner(config) {
+  if (config.privateKey) {
+    return false;
+  }
+  if (isOpenKeyAutoSignStrategy(config.signStrategy)) {
+    return false;
+  }
+  return config.signer !== void 0;
+}
 function didPrincipalMatches2(actual, expected) {
   try {
     return (0, import_sdk_core7.principalDidEquals)(actual, expected);
@@ -18832,6 +18844,21 @@ var _TinyCloudNode = class _TinyCloudNode {
     this._baseSecrets = /* @__PURE__ */ new Map();
     this._secrets = /* @__PURE__ */ new Map();
     this.runtimePermissionGrants = [];
+    /**
+     * True when the last signIn() detected an interactive signer and skipped
+     * client-side bootstrap. Apps can read this to know whether bootstrap was
+     * deferred to the server (OpenKey) or requires a separate user action.
+     */
+    this._bootstrapSkipped = false;
+    /**
+     * Outcome of the last signIn()'s account-bootstrap attempt. `skipped` is
+     * true when bootstrap did not complete (interactive signer, auto-sign
+     * denied, or a bootstrap step failed); `reason` carries the cause so apps
+     * can surface a "finish account setup" call-to-action.
+     */
+    this._bootstrapStatus = {
+      skipped: false
+    };
     this.invokeWithRuntimePermissions = (session, service, path, action, facts) => {
       return this.wasmBindings.invoke(
         this.selectInvocationSession(session, service, path, action),
@@ -18924,6 +18951,15 @@ var _TinyCloudNode = class _TinyCloudNode {
   static registerNodeDefaults(defaults) {
     _TinyCloudNode.nodeDefaults = defaults;
   }
+  /** Whether the last signIn() skipped client-side bootstrap because the
+   * signer is interactive (browser wallet / EIP-1193 provider). */
+  get bootstrapSkipped() {
+    return this._bootstrapSkipped;
+  }
+  /** Outcome of the last signIn()'s account-bootstrap attempt. */
+  get bootstrapStatus() {
+    return this._bootstrapStatus;
+  }
   get nodeFeatures() {
     return this.auth?.nodeFeatures ?? [];
   }
@@ -19147,17 +19183,38 @@ var _TinyCloudNode = class _TinyCloudNode {
     return this.wasmBindings.makeSpaceId(this._address, this._chainId, name);
   }
   async bootstrapAccountIfNeeded() {
+    this._bootstrapSkipped = false;
+    this._bootstrapStatus = { skipped: false };
     if (this.config.autoBootstrapAccount === false) {
       return false;
     }
     if (!this.auth || !this._address) {
       return false;
     }
+    if (isInteractiveSigner(this.config)) {
+      console.debug(
+        "[TinyCloudNode] bootstrap skipped: interactive signer detected. Server-side bootstrap (OpenKey) is expected to have provisioned the account."
+      );
+      this._bootstrapSkipped = true;
+      this._bootstrapStatus = { skipped: true, reason: "interactive-signer" };
+      return false;
+    }
     const steps = (0, import_sdk_core7.bootstrapSteps)(this._address, this._chainId);
     if (!await this.isFreshBootstrapAccount(steps)) {
       return false;
     }
-    await this.runAccountBootstrap(steps);
+    try {
+      await this.runAccountBootstrap(steps);
+    } catch (err) {
+      const reason = err instanceof Error ? err.message : String(err);
+      this._bootstrapSkipped = true;
+      this._bootstrapStatus = { skipped: true, reason };
+      this.notificationHandler.warning(
+        `Account bootstrap did not complete: ${reason}`
+      );
+      console.warn(`[TinyCloudNode] account bootstrap failed: ${reason}`);
+      return false;
+    }
     return true;
   }
   async isFreshBootstrapAccount(steps) {
@@ -19209,16 +19266,23 @@ var _TinyCloudNode = class _TinyCloudNode {
       if (rawAbilities) {
         rawAbilitiesBySpace.set(step.space, rawAbilities);
       }
-      const session = await auth.createBootstrapSession({
-        spaceId: step.spaceId,
-        capabilityRequest: step.request ?? import_sdk_core7.BOOTSTRAP_SESSION_REQUESTS[step.space],
-        rawAbilities
-      });
+      let session;
+      try {
+        session = await auth.createBootstrapSession({
+          spaceId: step.spaceId,
+          capabilityRequest: step.request ?? import_sdk_core7.BOOTSTRAP_SESSION_REQUESTS[step.space],
+          rawAbilities
+        });
+      } catch (err) {
+        throw new Error(
+          `Account bootstrap aborted: signature rejected for space "${step.space}". Cause: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
       sessions.set(step.space, session);
     }
     for (const step of steps) {
       if (step.kind !== "host") continue;
-      const hosted = await auth.hostOwnedSpace(step.spaceId);
+      const hosted = await auth.hostOwnedSpace(step.spaceId, "bootstrap-host");
       if (!hosted) {
         throw new Error(`Failed to host bootstrap space: ${step.spaceId}`);
       }