@tinycloud/node-sdk 2.3.1-beta.0 → 2.4.0-beta.2

package/dist/index.cjs

@@ -17126,6 +17126,7 @@ __export(index_exports, {
   expandPermissionEntries: () => import_sdk_core9.expandPermissionEntries,
   expandPermissionEntry: () => import_sdk_core9.expandPermissionEntry,
   generateRandomReceiverKey: () => import_sdk_core14.generateRandomReceiverKey,
+  grantAuthRequest: () => grantAuthRequest,
   hexDecode: () => import_sdk_core14.hexDecode,
   hexEncode: () => import_sdk_core14.hexEncode,
   isCapabilitySubset: () => import_sdk_core9.isCapabilitySubset,
@@ -18987,6 +18988,52 @@ var _TinyCloudNode = class _TinyCloudNode {
       );
     }
   }
+  /**
+   * Host one of this user's owned spaces by name (e.g. `"applications"`).
+   *
+   * Resolves the name to the owned space URI
+   * (`tinycloud:pkh:eip155:<chain>:<addr>:<name>`) and registers it on the
+   * server via the host-SIWE delegation flow, so subsequent KV/SQL writes to
+   * that space succeed instead of returning `404 - Space not found`. The
+   * caller is the root authority of their own owned spaces, so no additional
+   * delegation is required.
+   *
+   * Unlike {@link ensureOwnedSpaceHosted}, this always submits the host
+   * delegation rather than inferring hosting from session activation: a space
+   * the current session has never referenced is reported neither as
+   * `activated` nor `skipped`, so activation-based detection would wrongly
+   * skip the host. The host SIWE is idempotent server-side, so re-hosting an
+   * existing space is a safe no-op. Must be called after {@link signIn}.
+   *
+   * @param name - The owned space name (e.g. `"applications"`).
+   * @returns The hosted space URI.
+   */
+  async hostOwnedSpace(name) {
+    if (!this.auth || !this.auth.tinyCloudSession) {
+      throw new Error("Not signed in. Call signIn() first.");
+    }
+    const spaceId = this.ownedSpaceId(name);
+    const host = this.hosts[0] ?? this.config.host;
+    if (!host) {
+      throw new Error("Owned space hosting requires a TinyCloud host");
+    }
+    const hosted = await this.auth.hostOwnedSpace(
+      spaceId
+    );
+    if (!hosted) {
+      throw new Error(`Failed to host owned space: ${spaceId}`);
+    }
+    const activation = await (0, import_sdk_core5.activateSessionWithHost)(
+      host,
+      this.auth.tinyCloudSession.delegationHeader
+    );
+    if (!activation.success || activation.skipped?.includes(spaceId)) {
+      throw new Error(
+        `Failed to activate session for owned space ${spaceId}: ${activation.error ?? "space was skipped"}`
+      );
+    }
+    return spaceId;
+  }
   /**
    * Restore a previously established session from stored delegation data.
    *
@@ -21662,6 +21709,32 @@ var FileSessionStorage = class {
 var import_sdk_core9 = require("@tinycloud/sdk-core");
 
 // src/delegation.ts
+async function grantAuthRequest(authority, request, options) {
+  if (request.kind !== "tinycloud.auth.request") {
+    throw new Error(
+      `grantAuthRequest expects a tinycloud.auth.request artifact, got "${request.kind}".`
+    );
+  }
+  if (!Array.isArray(request.requested) || request.requested.length === 0) {
+    throw new Error("grantAuthRequest request has no requested capabilities.");
+  }
+  const expiry = options?.expiry ?? request.requestedExpiry;
+  const result = await authority.delegateTo(
+    request.sessionDid,
+    request.requested,
+    expiry !== void 0 ? { expiry } : void 0
+  );
+  return {
+    kind: "tinycloud.auth.delegation",
+    version: 1,
+    requestId: request.requestId,
+    delegationCid: result.delegation.cid,
+    delegation: result.delegation,
+    permissions: request.requested,
+    expiry: result.delegation.expiry.toISOString(),
+    prompted: result.prompted
+  };
+}
 function serializeDelegation(delegation) {
   return JSON.stringify({
     ...delegation,
@@ -21792,6 +21865,7 @@ var import_sdk_core20 = require("@tinycloud/sdk-core");
   expandPermissionEntries,
   expandPermissionEntry,
   generateRandomReceiverKey,
+  grantAuthRequest,
   hexDecode,
   hexEncode,
   isCapabilitySubset,