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

package/dist/core.d.cts

@@ -1,15 +1,16 @@
 import { ReplicationOptions, Manifest, PermissionEntry } from '@tinycloud/sdk-core';
 export { ACCOUNT_REGISTRY_PATH, ACCOUNT_REGISTRY_SPACE, AccountApplication, AccountApplicationListOptions, AccountApplicationRegisterOptions, AccountDelegation, AccountDelegationListOptions, AccountDelegationRevokeOptions, AccountIndexEnsureResult, AccountIndexRebuildResult, AccountIndexStatus, AccountIndexedReadOptions, AccountService, AccountServiceConfig, AccountSpace, AccountSpaceListOptions, AccountStatus, AuthorityRefusal, AutoApproveSpaceCreationHandler, AutoRejectStrategy, AutoSignStrategy, BatchOptions, BatchResponse, CallbackStrategy, CanonicalAddress, CanonicalParsedNetworkId, CapabilityEntry, CapabilityKeyRegistry, CapabilityKeyRegistryErrorCode, CapabilityKeyRegistryErrorCodes, CaveatedDelegationUnsupportedError, ClientSession, ColumnInfo, ComposeManifestOptions, ComposedManifestRequest, CreateDelegationParams, DEFAULT_MANIFEST_SPACE, DEFAULT_MANIFEST_VERSION, DEFAULT_SIGNED_READ_URL_EXPIRY_MS, DataVaultConfig, DataVaultService, DatabaseHandle, DelegateReceivedShareParams, DelegatedShareAccess, Delegation, DelegationChain, DelegationChainV2, DelegationDirection, DelegationError, DelegationErrorCode, DelegationErrorCodes, DelegationFilters, DelegationManager, DelegationManagerConfig, DelegationRecord, DelegationResult, DidCacheKeyOptions, DidEqualsOptions, DuckDbAction, DuckDbActionType, DuckDbBatchOptions, DuckDbBatchResponse, DuckDbDatabaseHandle, DuckDbExecuteOptions, DuckDbExecuteResponse, DuckDbOptions, DuckDbQueryOptions, DuckDbQueryResponse, DuckDbService, DuckDbServiceConfig, DuckDbStatement, DuckDbValue, EncodedShareData, ExecuteOptions, ExecuteResponse, Extension, FetchFunction, GenerateShareParams, ICapabilityKeyRegistry, IDataVaultService, IDatabaseHandle, IDuckDbDatabaseHandle, IDuckDbService, IENSResolver, IKVService, INotificationHandler, IPrefixedKVService, ISQLService, ISecretsService, ISessionManager, ISessionStorage, ISharingService, ISigner, ISpace, ISpaceCreationHandler, ISpaceScopedDelegations, ISpaceScopedSharing, ISpaceService, IUserAuthorization, IWasmBindings, IdentityParseError, IngestOptions, InvokeFunction, JWK, KVBatchReadResponse, KVCreateSignedReadUrlOptions, KVListPage, KVReadThrough, KVReplicaHandle, KVReplicaSpec, KVReplicaStorage, KVReplicationController, KVReplicationDeps, KVResponse, KVService, KVServiceConfig, KVSignedReadUrlResponse, KeyInfo, KeyProvider, KeyType, LocalGetResult, LocalListResult, LocalReadMeta, LocalReplicaStatus, LocalSyncResult, Manifest, ManifestDefaults, ManifestRegistryRecord, ManifestSecretActions, ManifestValidationError, OpenKeyCallbackStrategy, OpenKeySigningRequestBody, OpenKeySigningResponseBody, OpenKeySigningStrategyOptions, ParsedSecretCatalogKey, PendingWriteRecord, PendingWriteState, PendingWriteStore, PermissionEntry, PermissionNotInManifestError, PersistedSessionData, PinnedKey, PkhDidParts, PrefixedKVService, ProtocolMismatchError, PurgeTarget, QueryOptions, QueryResponse, ReceiveOptions, RegisterBatchSuccess, RegisterPolicyV3Input, RegisterPolicyV3Receipt, ReplicaAuthorityState, ReplicaCoverage, ReplicaDevice, ReplicaGatedHandle, ReplicaGrantInfo, ReplicaInspectedStatus, ReplicaState, ReplicaStatusEntry, ReplicationAuthority, ReplicationControl, ReplicationEvent, ReplicationIdentity, ReplicationOptions, ReplicationPurgeReport, ReplicationReason, ReplicationScheduler, ResolvedCapabilities, ResolvedDelegate, ResolvedReplicationOptions, ResolvedSecretPath, ResourceCapability, SECRET_NAME_RE, SQLAction, SQLActionType, SQLService, SQLServiceConfig, SchemaInfo, SecretCatalogEntry, SecretPayload, SecretScopeOptions, SecretsError, SecretsService, ServiceContext, ServiceContextConfig, ServiceSession, SessionExpiredError, ShareAccess, ShareLink, ShareLinkData, ShareSchema, SharingService, SharingServiceConfig, SignCallback, SignInOptions, SignRequest, SignResponse, SilentNotificationHandler, Space, SpaceAbilitiesMap, SpaceConfig, SpaceCreationContext, SpaceErrorCode, SpaceErrorCodes, SpaceInfo, SpaceOwnership, SpaceService, SpaceServiceConfig, SqlStatement, SqlValue, StoredDelegationChain, TableInfo, TelemetryConfig, TelemetryEventHandler, TinyCloud, TinyCloudConfig, TinyCloudDebugEnableOptions, TinyCloudDebugEvent, TinyCloudDebugLevel, TinyCloudDebugLogger, TinyCloudDebugTimer, TinyCloudSession, UnsupportedFeatureError, VAULT_PERMISSION_SERVICE, VaultCrypto, VaultEntry, VaultError, VaultGetOptions, VaultGrantOptions, VaultHeaders, VaultListOptions, VaultNetworkReadResult, VaultPublicSpaceKVActions, VaultPutOptions, VersionCheckError, ViewInfo, WasmVaultFunctions, addressStorageKey, buildSpaceUri, canonicalizeAddress, canonicalizeDid, canonicalizeDidUrl, canonicalizeNetworkId, canonicalizeSecretScope, checkNodeInfo, clearTinyCloudDebugLogs, composeManifestRequest, createCapabilityKeyRegistry, createOpenKeyCallbackSigningStrategy, createSharingService, createSpaceService, createVaultCrypto, defaultSpaceCreationHandler, didCacheKey, didEquals, disableTinyCloudDebug, enableTinyCloudDebug, expandActionShortNames, expandPermissionEntries, expandPermissionEntry, getTinyCloudDebugLogs, installTinyCloudDebugGlobals, isCapabilitySubset, isEvmAddress, loadManifest, makePkhSpaceId, makePublicSpaceId, parseCanonicalNetworkId, parseExpiry, parsePkhDid, parseSecretCatalogKey, parseSpaceUri, pkhDid, principalDid, principalDidEquals, resolveManifest, resolveSecretListPrefix, resolveSecretPath, resourceCapabilitiesToSpaceAbilitiesMap, tinyCloudDebugLogger, validateManifest } from '@tinycloud/sdk-core';
 import { _ as __gated_network } from './gated-network-BEF2XSTC.cjs';
-import { _ as __authority } from './authority-BYSEyjDI.cjs';
+import { _ as __authority } from './authority-DDdheOL6.cjs';
 import { _ as __runtime } from './runtime-mRhSu-vJ.cjs';
 import { ReplicaDenyInput } from '@tinycloud/sdk-services/kv/replication';
 export { F as FileSessionStorage, M as MemorySessionStorage, W as WasmKeyProvider, a as WasmKeyProviderConfig, c as createWasmKeyProvider, i as isAppKeyHostBound } from './WasmKeyProvider-OA0LqmTg.cjs';
-export { B as BootstrapWarning, C as CreateOwnerDelegationParams, D as DelegateToOptions, a as DelegateToResult, b as DelegatedAccess, E as EnsureEncryptionNetworkOptions, I as InvalidRestoredSessionError, N as NodeEventEmitterStrategy, c as NodeUserAuthorization, d as NodeUserAuthorizationConfig, O as OpenKeyAuthorizeTinyCloud, e as OwnerDelegationReceipt, P as PreparedOpenKeyAuthorization, R as RuntimePermissionGrantOptions, S as SecretPermissionHint, f as SecretReadInput, g as SecretReadResult, h as SignStrategy, T as TinyCloudNode, i as TinyCloudNodeConfig, U as UnifiedOwnerRootInput, j as UnifiedOwnerRootReceipt, k as UnsupportedSessionRestoreError, l as defaultSignStrategy, w as wireOpenKeyAuthorize } from './TinyCloudNode-BmpjkpWR.cjs';
-export { C as CompactRuntimeDelegationInput, P as PortableDelegation, R as RuntimeDelegationRejectedError, a as RuntimeDelegationRejection, V as ValidatedRuntimeDelegation, b as activateCompactRuntimeDelegation, c as activateValidatedRuntimeDelegation, d as deserializeDelegation, s as serializeDelegation } from './delegation-Ckc3UETl.cjs';
+export { N as NodeEventEmitterStrategy, a as NodeUserAuthorization, b as NodeUserAuthorizationConfig, O as OpenKeyAuthorizeTinyCloud, P as PreparedOpenKeyAuthorization, c as SignStrategy, S as SpaceHosting, d as defaultSignStrategy, w as wireOpenKeyAuthorize } from './NodeUserAuthorization-BtoDI9in.cjs';
+export { B as BootstrapWarning, C as CreateOwnerDelegationParams, D as DelegateToOptions, a as DelegateToResult, b as DelegatedAccess, E as EnsureEncryptionNetworkOptions, I as InvalidRestoredSessionError, O as OwnerDelegationReceipt, R as RuntimePermissionGrantOptions, S as SecretPermissionHint, c as SecretReadInput, d as SecretReadResult, T as TinyCloudNode, e as TinyCloudNodeConfig, U as UnifiedOwnerRootInput, f as UnifiedOwnerRootReceipt, g as UnsupportedSessionRestoreError } from './TinyCloudNode-C24728N_.cjs';
+export { C as CompactRuntimeDelegationInput, P as PortableDelegation, R as RuntimeDelegationRejectedError, a as RuntimeDelegationRejection, V as ValidatedRuntimeDelegation, b as activateCompactRuntimeDelegation, c as activateValidatedRuntimeDelegation, d as deserializeDelegation, s as serializeDelegation } from './delegation-BQbAuKad.cjs';
 import '@tinycloud/sdk-services';
-import '@tinycloud/sdk-services/encryption/named-keys';
 import 'events';
+import '@tinycloud/sdk-services/encryption/named-keys';
 
 /**
  * The `@tinycloud/replica/profile-gate` members the node adapter uses, typed structurally: node-sdk

package/dist/core.d.ts

@@ -1,15 +1,16 @@
 import { ReplicationOptions, Manifest, PermissionEntry } from '@tinycloud/sdk-core';
 export { ACCOUNT_REGISTRY_PATH, ACCOUNT_REGISTRY_SPACE, AccountApplication, AccountApplicationListOptions, AccountApplicationRegisterOptions, AccountDelegation, AccountDelegationListOptions, AccountDelegationRevokeOptions, AccountIndexEnsureResult, AccountIndexRebuildResult, AccountIndexStatus, AccountIndexedReadOptions, AccountService, AccountServiceConfig, AccountSpace, AccountSpaceListOptions, AccountStatus, AuthorityRefusal, AutoApproveSpaceCreationHandler, AutoRejectStrategy, AutoSignStrategy, BatchOptions, BatchResponse, CallbackStrategy, CanonicalAddress, CanonicalParsedNetworkId, CapabilityEntry, CapabilityKeyRegistry, CapabilityKeyRegistryErrorCode, CapabilityKeyRegistryErrorCodes, CaveatedDelegationUnsupportedError, ClientSession, ColumnInfo, ComposeManifestOptions, ComposedManifestRequest, CreateDelegationParams, DEFAULT_MANIFEST_SPACE, DEFAULT_MANIFEST_VERSION, DEFAULT_SIGNED_READ_URL_EXPIRY_MS, DataVaultConfig, DataVaultService, DatabaseHandle, DelegateReceivedShareParams, DelegatedShareAccess, Delegation, DelegationChain, DelegationChainV2, DelegationDirection, DelegationError, DelegationErrorCode, DelegationErrorCodes, DelegationFilters, DelegationManager, DelegationManagerConfig, DelegationRecord, DelegationResult, DidCacheKeyOptions, DidEqualsOptions, DuckDbAction, DuckDbActionType, DuckDbBatchOptions, DuckDbBatchResponse, DuckDbDatabaseHandle, DuckDbExecuteOptions, DuckDbExecuteResponse, DuckDbOptions, DuckDbQueryOptions, DuckDbQueryResponse, DuckDbService, DuckDbServiceConfig, DuckDbStatement, DuckDbValue, EncodedShareData, ExecuteOptions, ExecuteResponse, Extension, FetchFunction, GenerateShareParams, ICapabilityKeyRegistry, IDataVaultService, IDatabaseHandle, IDuckDbDatabaseHandle, IDuckDbService, IENSResolver, IKVService, INotificationHandler, IPrefixedKVService, ISQLService, ISecretsService, ISessionManager, ISessionStorage, ISharingService, ISigner, ISpace, ISpaceCreationHandler, ISpaceScopedDelegations, ISpaceScopedSharing, ISpaceService, IUserAuthorization, IWasmBindings, IdentityParseError, IngestOptions, InvokeFunction, JWK, KVBatchReadResponse, KVCreateSignedReadUrlOptions, KVListPage, KVReadThrough, KVReplicaHandle, KVReplicaSpec, KVReplicaStorage, KVReplicationController, KVReplicationDeps, KVResponse, KVService, KVServiceConfig, KVSignedReadUrlResponse, KeyInfo, KeyProvider, KeyType, LocalGetResult, LocalListResult, LocalReadMeta, LocalReplicaStatus, LocalSyncResult, Manifest, ManifestDefaults, ManifestRegistryRecord, ManifestSecretActions, ManifestValidationError, OpenKeyCallbackStrategy, OpenKeySigningRequestBody, OpenKeySigningResponseBody, OpenKeySigningStrategyOptions, ParsedSecretCatalogKey, PendingWriteRecord, PendingWriteState, PendingWriteStore, PermissionEntry, PermissionNotInManifestError, PersistedSessionData, PinnedKey, PkhDidParts, PrefixedKVService, ProtocolMismatchError, PurgeTarget, QueryOptions, QueryResponse, ReceiveOptions, RegisterBatchSuccess, RegisterPolicyV3Input, RegisterPolicyV3Receipt, ReplicaAuthorityState, ReplicaCoverage, ReplicaDevice, ReplicaGatedHandle, ReplicaGrantInfo, ReplicaInspectedStatus, ReplicaState, ReplicaStatusEntry, ReplicationAuthority, ReplicationControl, ReplicationEvent, ReplicationIdentity, ReplicationOptions, ReplicationPurgeReport, ReplicationReason, ReplicationScheduler, ResolvedCapabilities, ResolvedDelegate, ResolvedReplicationOptions, ResolvedSecretPath, ResourceCapability, SECRET_NAME_RE, SQLAction, SQLActionType, SQLService, SQLServiceConfig, SchemaInfo, SecretCatalogEntry, SecretPayload, SecretScopeOptions, SecretsError, SecretsService, ServiceContext, ServiceContextConfig, ServiceSession, SessionExpiredError, ShareAccess, ShareLink, ShareLinkData, ShareSchema, SharingService, SharingServiceConfig, SignCallback, SignInOptions, SignRequest, SignResponse, SilentNotificationHandler, Space, SpaceAbilitiesMap, SpaceConfig, SpaceCreationContext, SpaceErrorCode, SpaceErrorCodes, SpaceInfo, SpaceOwnership, SpaceService, SpaceServiceConfig, SqlStatement, SqlValue, StoredDelegationChain, TableInfo, TelemetryConfig, TelemetryEventHandler, TinyCloud, TinyCloudConfig, TinyCloudDebugEnableOptions, TinyCloudDebugEvent, TinyCloudDebugLevel, TinyCloudDebugLogger, TinyCloudDebugTimer, TinyCloudSession, UnsupportedFeatureError, VAULT_PERMISSION_SERVICE, VaultCrypto, VaultEntry, VaultError, VaultGetOptions, VaultGrantOptions, VaultHeaders, VaultListOptions, VaultNetworkReadResult, VaultPublicSpaceKVActions, VaultPutOptions, VersionCheckError, ViewInfo, WasmVaultFunctions, addressStorageKey, buildSpaceUri, canonicalizeAddress, canonicalizeDid, canonicalizeDidUrl, canonicalizeNetworkId, canonicalizeSecretScope, checkNodeInfo, clearTinyCloudDebugLogs, composeManifestRequest, createCapabilityKeyRegistry, createOpenKeyCallbackSigningStrategy, createSharingService, createSpaceService, createVaultCrypto, defaultSpaceCreationHandler, didCacheKey, didEquals, disableTinyCloudDebug, enableTinyCloudDebug, expandActionShortNames, expandPermissionEntries, expandPermissionEntry, getTinyCloudDebugLogs, installTinyCloudDebugGlobals, isCapabilitySubset, isEvmAddress, loadManifest, makePkhSpaceId, makePublicSpaceId, parseCanonicalNetworkId, parseExpiry, parsePkhDid, parseSecretCatalogKey, parseSpaceUri, pkhDid, principalDid, principalDidEquals, resolveManifest, resolveSecretListPrefix, resolveSecretPath, resourceCapabilitiesToSpaceAbilitiesMap, tinyCloudDebugLogger, validateManifest } from '@tinycloud/sdk-core';
 import { _ as __gated_network } from './gated-network-BEF2XSTC.js';
-import { _ as __authority } from './authority-dRnJD4iL.js';
+import { _ as __authority } from './authority-BQN2Z3st.js';
 import { _ as __runtime } from './runtime-CO4VXnPq.js';
 import { ReplicaDenyInput } from '@tinycloud/sdk-services/kv/replication';
 export { F as FileSessionStorage, M as MemorySessionStorage, W as WasmKeyProvider, a as WasmKeyProviderConfig, c as createWasmKeyProvider, i as isAppKeyHostBound } from './WasmKeyProvider-OA0LqmTg.js';
-export { B as BootstrapWarning, C as CreateOwnerDelegationParams, D as DelegateToOptions, a as DelegateToResult, b as DelegatedAccess, E as EnsureEncryptionNetworkOptions, I as InvalidRestoredSessionError, N as NodeEventEmitterStrategy, c as NodeUserAuthorization, d as NodeUserAuthorizationConfig, O as OpenKeyAuthorizeTinyCloud, e as OwnerDelegationReceipt, P as PreparedOpenKeyAuthorization, R as RuntimePermissionGrantOptions, S as SecretPermissionHint, f as SecretReadInput, g as SecretReadResult, h as SignStrategy, T as TinyCloudNode, i as TinyCloudNodeConfig, U as UnifiedOwnerRootInput, j as UnifiedOwnerRootReceipt, k as UnsupportedSessionRestoreError, l as defaultSignStrategy, w as wireOpenKeyAuthorize } from './TinyCloudNode-AUotFGzy.js';
-export { C as CompactRuntimeDelegationInput, P as PortableDelegation, R as RuntimeDelegationRejectedError, a as RuntimeDelegationRejection, V as ValidatedRuntimeDelegation, b as activateCompactRuntimeDelegation, c as activateValidatedRuntimeDelegation, d as deserializeDelegation, s as serializeDelegation } from './delegation-Ckc3UETl.js';
+export { N as NodeEventEmitterStrategy, a as NodeUserAuthorization, b as NodeUserAuthorizationConfig, O as OpenKeyAuthorizeTinyCloud, P as PreparedOpenKeyAuthorization, c as SignStrategy, S as SpaceHosting, d as defaultSignStrategy, w as wireOpenKeyAuthorize } from './NodeUserAuthorization-BtoDI9in.js';
+export { B as BootstrapWarning, C as CreateOwnerDelegationParams, D as DelegateToOptions, a as DelegateToResult, b as DelegatedAccess, E as EnsureEncryptionNetworkOptions, I as InvalidRestoredSessionError, O as OwnerDelegationReceipt, R as RuntimePermissionGrantOptions, S as SecretPermissionHint, c as SecretReadInput, d as SecretReadResult, T as TinyCloudNode, e as TinyCloudNodeConfig, U as UnifiedOwnerRootInput, f as UnifiedOwnerRootReceipt, g as UnsupportedSessionRestoreError } from './TinyCloudNode-DLrINr98.js';
+export { C as CompactRuntimeDelegationInput, P as PortableDelegation, R as RuntimeDelegationRejectedError, a as RuntimeDelegationRejection, V as ValidatedRuntimeDelegation, b as activateCompactRuntimeDelegation, c as activateValidatedRuntimeDelegation, d as deserializeDelegation, s as serializeDelegation } from './delegation-BQbAuKad.js';
 import '@tinycloud/sdk-services';
-import '@tinycloud/sdk-services/encryption/named-keys';
 import 'events';
+import '@tinycloud/sdk-services/encryption/named-keys';
 
 /**
  * The `@tinycloud/replica/profile-gate` members the node adapter uses, typed structurally: node-sdk

package/dist/core.js

@@ -500,6 +500,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;
@@ -659,6 +661,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;
@@ -799,6 +802,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.
@@ -1259,103 +1274,55 @@ var NodeUserAuthorization = class {
       this._tinyCloudSession.delegationHeader
     );
     this.recordActivationSkippedSpaces(result, primarySpaceId);
+    if (!result.success && result.status !== 404) {
+      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) {
+    if (hosting !== "not-hosted") {
+      return;
+    }
+    const session = this._tinyCloudSession;
+    if (!session) {
+      throw new Error("Must be signed in to host the primary space");
+    }
     const handler = this.spaceCreationHandler ?? (this.autoCreateSpace ? new AutoApproveSpaceCreationHandler() : void 0);
+    if (!handler) {
+      return;
+    }
+    await this.ensureTinyCloudHosts();
+    const host = this.primaryTinyCloudHost;
+    const primarySpaceId = session.spaceId;
     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 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 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;
-    }
-    throw Object.assign(
-      new Error(`Failed to activate session: ${describeHostFailure(result)}`),
-      { cause: result }
-    );
+    const { createPrimarySpace } = await import("./space-hosting.js");
+    await createPrimarySpace({
+      handler,
+      context: creationContext,
+      guard: () => this.guardSpaceCreation(handler, creationContext),
+      host: () => this.hostSpace(primarySpaceId),
+      onHosted: () => {
+        this._spaceHosting = "hosted";
+      },
+      activate: () => activateSessionWithHost(host, session.delegationHeader)
+    });
   }
   /** {@link assertMayCreateSpace}, reporting a refusal to the creation handler before rethrowing it. */
   async guardSpaceCreation(handler, context) {
@@ -1371,10 +1338,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);
@@ -4116,6 +4085,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
@@ -4454,6 +4425,84 @@ 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";
+    }
+  }
+  /**
+   * 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.js");
+    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 activateSessionWithHost2(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 ?? [];
   }
@@ -4945,6 +4994,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();
@@ -5138,6 +5188,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");
@@ -6517,6 +6571,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();