@tinycloud/node-sdk 3.11.1-beta.0 → 3.12.0-beta.2

package/dist/{authority-BYSEyjDI.d.cts → authority-DODDXxoP.d.cts}

@@ -1,7 +1,7 @@
 import { ReplicationOptions, PermissionEntry, TinyCloudSession, KVReplicaStorage, ServiceContext, IWasmBindings, WasmRecapEntry } from '@tinycloud/sdk-core';
 import { ReplicaConsentAnchor, AuthorityRefusal, ReplicationAuthority } from '@tinycloud/sdk-services';
 import { ReplicaLocalEraseOutcome, ReplicaPurgeLocalCopyResult, ReplicaPurgeTrigger, ReplicaPurgeFailedEvent, ReplicaSessionStamp, ReplicaDenyInput } from '@tinycloud/sdk-services/kv/replication';
-import { T as TinyCloudNode } from './TinyCloudNode-BmpjkpWR.cjs';
+import { T as TinyCloudNode } from './TinyCloudNode-6_IumWu0.cjs';
 
 /** Constructor-time validation; the space-dependent secrets check runs at sign-in and open. */
 declare function assertValidReplicationConfig(replication: (ReplicationOptions & {

package/dist/{authority-dRnJD4iL.d.ts → authority-DXpnuId1.d.ts}

@@ -1,7 +1,7 @@
 import { ReplicationOptions, PermissionEntry, TinyCloudSession, KVReplicaStorage, ServiceContext, IWasmBindings, WasmRecapEntry } from '@tinycloud/sdk-core';
 import { ReplicaConsentAnchor, AuthorityRefusal, ReplicationAuthority } from '@tinycloud/sdk-services';
 import { ReplicaLocalEraseOutcome, ReplicaPurgeLocalCopyResult, ReplicaPurgeTrigger, ReplicaPurgeFailedEvent, ReplicaSessionStamp, ReplicaDenyInput } from '@tinycloud/sdk-services/kv/replication';
-import { T as TinyCloudNode } from './TinyCloudNode-AUotFGzy.js';
+import { T as TinyCloudNode } from './TinyCloudNode-CEFGtSWn.js';
 
 /** Constructor-time validation; the space-dependent secrets check runs at sign-in and open. */
 declare function assertValidReplicationConfig(replication: (ReplicationOptions & {

package/dist/core.cjs

@@ -568,6 +568,8 @@ var NodeUserAuthorization = class {
      * delegation lists them: the node answers a repeat with empty lists.
      */
     this._lastActivationActivatedSpaceIds = [];
+    /** See {@link spaceHosting}. Written only from node answers. */
+    this._spaceHosting = "unknown";
     this.wasm = config.wasmBindings;
     this.signer = config.signer;
     this.signStrategy = config.signStrategy ?? defaultSignStrategy;
@@ -727,6 +729,7 @@ var NodeUserAuthorization = class {
     this.registryVerdict = void 0;
     this._lastActivationSkippedSpaceIds = [];
     this._lastActivationActivatedSpaceIds = [];
+    this._spaceHosting = "unknown";
     if (!session) {
       this._session = void 0;
       this._tinyCloudSession = void 0;
@@ -867,6 +870,18 @@ var NodeUserAuthorization = class {
   get lastActivationActivatedSpaceIds() {
     return [...this._lastActivationActivatedSpaceIds];
   }
+  /**
+   * The node's last answer for whether this session's primary space is hosted:
+   * recorded from the sign-in activation, or by {@link noteSpaceHosting}.
+   * `unknown` until one of them answers, and after a restore.
+   */
+  get spaceHosting() {
+    return this._spaceHosting;
+  }
+  /** @internal Record the hosting probe's answer for the primary space. */
+  noteSpaceHosting(hosting) {
+    this._spaceHosting = hosting;
+  }
   /**
    * Compute the `abilities` map the WASM `prepareSession` call should
    * see at sign-in time.
@@ -1246,23 +1261,35 @@ 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, purpose, signal) {
-    if (!this._tinyCloudSession || !this._address || !this._chainId) {
+  async hostSpace(targetSpaceId, purpose, signal, assertCurrent, siweParameters) {
+    const context = typeof targetSpaceId === "object" ? targetSpaceId : void 0;
+    const address = context?.address ?? this._address;
+    const chainId = context?.chainId ?? this._chainId;
+    if (!address || chainId === void 0 || !this._tinyCloudSession) {
       throw new Error("Must be signed in to host space");
     }
+    const checkCurrent = () => {
+      signal?.throwIfAborted();
+      assertCurrent?.();
+    };
+    checkCurrent();
     await this.ensureTinyCloudHosts();
-    const host = this.primaryTinyCloudHost;
-    const spaceId = targetSpaceId ?? this._tinyCloudSession.spaceId;
+    checkCurrent();
+    const host = context?.host ?? this.primaryTinyCloudHost;
+    const spaceId = context?.spaceId ?? (typeof targetSpaceId === "string" ? targetSpaceId : this._tinyCloudSession.spaceId);
     const peerId = await (0, import_sdk_core5.fetchPeerId)(host, spaceId, signal);
-    const siwe = this.wasm.generateHostSIWEMessage({
-      address: this._address,
-      chainId: this._chainId,
-      domain: this.domain,
-      issuedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      spaceId,
-      peerId
-    });
-    if (signal?.aborted) throw signal.reason;
+    checkCurrent();
+    const siwe = this.wasm.generateHostSIWEMessage(
+      context && siweParameters ? siweParameters(peerId) : {
+        address,
+        chainId,
+        domain: this.domain,
+        issuedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        spaceId,
+        peerId
+      }
+    );
+    checkCurrent();
     const signing = this.signMessage(siwe, purpose);
     let signature;
     if (!signal) {
@@ -1281,8 +1308,9 @@ var NodeUserAuthorization = class {
         signal.removeEventListener("abort", onAbort);
       }
     }
-    if (signal?.aborted) throw signal.reason;
+    checkCurrent();
     const headers = this.wasm.siweToDelegationHeaders({ siwe, signature });
+    checkCurrent();
     return (0, import_sdk_core5.submitHostDelegation)(host, headers, signal);
   }
   /**
@@ -1327,103 +1355,48 @@ var NodeUserAuthorization = class {
       this._tinyCloudSession.delegationHeader
     );
     this.recordActivationSkippedSpaces(result, primarySpaceId);
-    const handler = this.spaceCreationHandler ?? (this.autoCreateSpace ? new import_sdk_core5.AutoApproveSpaceCreationHandler() : void 0);
-    const creationContext = {
-      spaceId: primarySpaceId,
-      address: this._address,
-      chainId: this._chainId,
-      host
-    };
-    if (result.success) {
-      const primarySkipped = result.skipped?.includes(primarySpaceId);
-      if (!primarySkipped) {
-        return;
-      }
-      if (!handler) {
-        return;
-      }
-      await this.guardSpaceCreation(handler, creationContext);
-      const confirmed = await handler.confirmSpaceCreation(creationContext);
-      if (!confirmed) {
-        return;
-      }
-      try {
-        const created = await this.hostSpace();
-        if (!created.success) {
-          const err2 = Object.assign(
-            new Error(`Failed to create space ${primarySpaceId}: ${describeHostFailure(created)}`),
-            { cause: created }
-          );
-          throw err2;
-        }
-      } catch (error) {
-        handler.onSpaceCreationFailed?.(
-          creationContext,
-          error instanceof Error ? error : new Error(String(error))
-        );
-        throw error;
-      }
-      await new Promise((resolve) => setTimeout(resolve, 100));
-      const retryResult = await (0, import_sdk_core5.activateSessionWithHost)(
-        host,
-        this._tinyCloudSession.delegationHeader
-      );
-      if (!retryResult.success) {
-        const err2 = Object.assign(
-          new Error(`Failed to activate session after creating space: ${describeHostFailure(retryResult)}`),
-          { cause: retryResult }
-        );
-        handler.onSpaceCreationFailed?.(creationContext, err2);
-        throw err2;
-      }
-      handler.onSpaceCreated?.(creationContext);
-      return;
-    }
-    if (result.status === 404) {
-      if (!handler) {
-        return;
-      }
-      await this.guardSpaceCreation(handler, creationContext);
-      const confirmed = await handler.confirmSpaceCreation(creationContext);
-      if (!confirmed) {
-        return;
-      }
-      try {
-        const created = await this.hostSpace();
-        if (!created.success) {
-          const err2 = Object.assign(
-            new Error(`Failed to create space ${primarySpaceId}: ${describeHostFailure(created)}`),
-            { cause: created }
-          );
-          throw err2;
-        }
-      } catch (error) {
-        handler.onSpaceCreationFailed?.(
-          creationContext,
-          error instanceof Error ? error : new Error(String(error))
-        );
-        throw error;
-      }
-      await new Promise((resolve) => setTimeout(resolve, 100));
-      const retryResult = await (0, import_sdk_core5.activateSessionWithHost)(
-        host,
-        this._tinyCloudSession.delegationHeader
+    if (!result.success && result.status !== 404) {
+      throw Object.assign(
+        new Error(`Failed to activate session: ${describeHostFailure(result)}`),
+        { cause: result }
       );
-      if (!retryResult.success) {
-        const err2 = Object.assign(
-          new Error(`Failed to activate session after creating space: ${describeHostFailure(retryResult)}`),
-          { cause: retryResult }
-        );
-        handler.onSpaceCreationFailed?.(creationContext, err2);
-        throw err2;
-      }
-      handler.onSpaceCreated?.(creationContext);
-      return;
     }
-    throw Object.assign(
-      new Error(`Failed to activate session: ${describeHostFailure(result)}`),
-      { cause: result }
-    );
+    await this.ensurePrimarySpaceHosted(this._spaceHosting);
+  }
+  /**
+   * The create step of {@link ensureSpaceExists}: given the node's answer for
+   * the primary space, host it through the space creation handler when it is
+   * `not-hosted`. Any other answer, and a missing handler, change nothing. The
+   * caller supplies the answer (sign-in's activation, or the hosting probe);
+   * an empty activation list is never one.
+   *
+   * @throws Error if the creation handler fails or times out, or hosting fails
+   */
+  async ensurePrimarySpaceHosted(hosting, signal) {
+    const session = this._tinyCloudSession;
+    if (hosting !== "not-hosted") return;
+    if (!session) throw new Error("Must be signed in to host the primary space");
+    const handler = this.spaceCreationHandler ?? (this.autoCreateSpace ? new import_sdk_core5.AutoApproveSpaceCreationHandler() : void 0);
+    if (!handler) return;
+    const { createPrimarySpace } = await import("./space-hosting.cjs");
+    await createPrimarySpace({
+      handler,
+      session,
+      currentSession: () => this._tinyCloudSession,
+      signerAddress: () => this.signer.getAddress(),
+      resolveHost: async () => {
+        await this.ensureTinyCloudHosts();
+        return this.primaryTinyCloudHost;
+      },
+      domain: this.domain,
+      guard: (context) => this.guardSpaceCreation(handler, context),
+      host: (context, assertCurrent, siweParameters) => this.hostSpace(context, void 0, signal, assertCurrent, siweParameters),
+      onHosted: () => {
+        this._spaceHosting = "hosted";
+      },
+      activate: (context) => (0, import_sdk_core5.activateSessionWithHost)(context.host, session.delegationHeader),
+      signal
+    });
   }
   /** {@link assertMayCreateSpace}, reporting a refusal to the creation handler before rethrowing it. */
   async guardSpaceCreation(handler, context) {
@@ -1439,10 +1412,12 @@ var NodeUserAuthorization = class {
     if (result.success) {
       this._lastActivationSkippedSpaceIds = result.skipped ?? [];
       this._lastActivationActivatedSpaceIds = result.activated ?? [];
+      this._spaceHosting = this._lastActivationSkippedSpaceIds.includes(primarySpaceId) ? "not-hosted" : this._lastActivationActivatedSpaceIds.includes(primarySpaceId) ? "hosted" : "unknown";
       return;
     }
     this._lastActivationActivatedSpaceIds = [];
     this._lastActivationSkippedSpaceIds = result.status === 404 ? [primarySpaceId] : [];
+    this._spaceHosting = result.status === 404 ? "not-hosted" : "unknown";
   }
   async createBootstrapSession(options) {
     refuseCaveated(options.capabilityRequest.manifests);
@@ -4074,6 +4049,8 @@ var _TinyCloudNode = class _TinyCloudNode {
      * hosting is confirmed against the session that was active at the time.
      */
     this.confirmedHostedSpaceIds = /* @__PURE__ */ new Set();
+    /** The primary space's hosting answer when no authorization layer holds it (a session-only restore). */
+    this._restoredSpaceHosting = "unknown";
     /**
      * Owned space ids known to be hosted for the current session: the sign-in
      * activation listed them as `activated`, or this session hosted them. Unlike
@@ -4412,6 +4389,96 @@ var _TinyCloudNode = class _TinyCloudNode {
       ));
     }
   }
+  /**
+   * Whether the TinyCloud node hosts the primary space (the default) or a named
+   * or full-id space: `"hosted"`, `"not-hosted"`, or `"unknown"` when the node
+   * cannot say.
+   *
+   * Sends one authorized read the session already holds on that space (a kv
+   * list under a granted prefix, else kv metadata, `tinycloud.space/info`, or
+   * a kv get of a key that does not exist), signed for that space. A session
+   * with no such read sends nothing and answers `unknown`. A 401/403 registers
+   * the session delegation with the node once and asks again once. Network
+   * failures, 5xx and a 5 s timeout answer `unknown`; this never throws.
+   *
+   * `hosted` is remembered for the session and `not-hosted` never is. The
+   * answer for the primary space is also what {@link spaceHosting} reports; a
+   * `unknown` answer leaves the previous one in place.
+   */
+  async checkSpaceHosting(space) {
+    try {
+      return await this.probeSpaceHosting(space);
+    } catch {
+      return "unknown";
+    }
+  }
+  /** Run the existing primary-space creation flow for the restored session. */
+  async ensurePrimarySpaceHosted(hosting) {
+    const graph = this._serviceGraph;
+    const epoch = this.sessionEpoch;
+    graph.assertActive();
+    this.assertSessionEpoch(epoch, "Space hosting");
+    const auth = this.auth;
+    if (!auth || !this.session) return;
+    await auth.ensurePrimarySpaceHosted(hosting, graph.signal);
+    graph.assertActive();
+    this.assertSessionEpoch(epoch, "Space hosting");
+  }
+  /**
+   * The node's last answer for the primary space: recorded at sign-in from the
+   * activation, or by {@link checkSpaceHosting}. `unknown` after a restore until
+   * something asks.
+   */
+  get spaceHosting() {
+    return this.auth ? this.auth.spaceHosting : this._restoredSpaceHosting;
+  }
+  async probeSpaceHosting(space) {
+    const context = this._serviceContext;
+    const session = context?.session;
+    const host = context?.hosts[0];
+    if (!context || !session || !host) {
+      return "unknown";
+    }
+    const spaceId = space === void 0 ? session.spaceId : space.startsWith("tinycloud:") ? space : this.ownedSpaceId(space);
+    const graph = this._serviceGraph;
+    const epoch = this.sessionEpoch;
+    const assertCurrent = () => {
+      graph.assertActive();
+      if (epoch !== this.sessionEpoch || graph !== this._serviceGraph || this._serviceContext !== context) {
+        throw new Error("The session changed during the hosting check.");
+      }
+    };
+    const { askSpaceHosting } = await import("./space-hosting.cjs");
+    assertCurrent();
+    this.pruneExpiredRuntimePermissionGrants();
+    const primary = this.currentTinyCloudSession();
+    const answer = await askSpaceHosting({
+      spaceId,
+      operations: [
+        ...this.runtimePermissionGrants.flatMap((grant) => grant.operations),
+        ...primary ? this.recapOperationsFromSession(primary) : []
+      ],
+      covers: (granted, requested) => this.operationCovers(granted, requested),
+      scope: context,
+      host,
+      fetch: unrecordedFetchOf(context),
+      sign: (entries) => {
+        assertCurrent();
+        return graph.invokeAny({ ...session, spaceId }, entries);
+      },
+      // A session saved but never registered on this node is refused: it registers once.
+      activate: (signal) => {
+        assertCurrent();
+        return (0, import_sdk_core11.activateSessionWithHost)(host, session.delegationHeader, AbortSignal.any([signal, graph.signal]));
+      }
+    });
+    assertCurrent();
+    if (answer !== "unknown" && this.spaceIdsEqual(spaceId, session.spaceId)) {
+      if (this.auth) this.auth.noteSpaceHosting(answer);
+      else this._restoredSpaceHosting = answer;
+    }
+    return answer;
+  }
   get nodeFeatures() {
     return this.auth?.nodeFeatures ?? this._restoredNodeFeatures ?? [];
   }
@@ -4903,6 +4970,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     this._spaceService = void 0;
     this.runtimePermissionGrants = [];
     this._recapOperationsCache = void 0;
+    this._restoredSpaceHosting = "unknown";
     this.confirmedHostedSpaceIds.clear();
     this.hostedOwnedSpaceIds.clear();
     this.cancelOwnedSpaceHosts();
@@ -5096,6 +5164,10 @@ var _TinyCloudNode = class _TinyCloudNode {
     const primarySession = this.currentTinyCloudSession();
     if (primarySession) {
       this.registerPrimarySessionGrant(primarySession);
+      if (this.auth?.spaceHosting === "unknown") {
+        await this.checkSpaceHosting();
+        this.assertSessionEpoch(epoch, "Sign-in");
+      }
     }
     const bootstrapped = await this.bootstrapAccountIfNeeded();
     this.assertSessionEpoch(epoch, "Sign-in");
@@ -6475,6 +6547,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     this.tc = stagedGraph.core;
     this._recapOperationsCache = stagedPrimary.cache;
     this.runtimePermissionGrants = stagedPrimary.grants;
+    this._restoredSpaceHosting = "unknown";
     this.confirmedHostedSpaceIds.clear();
     this.hostedOwnedSpaceIds.clear();
     this.cancelOwnedSpaceHosts();