@tinycloud/node-sdk 3.0.1-beta.0 → 3.1.0-beta.1

package/dist/{core-DufYfxi-.d.cts → core-Bm76PnOz.d.cts}

@@ -1,5 +1,5 @@
 import * as _tinycloud_sdk_core from '@tinycloud/sdk-core';
-import { ISessionStorage, PersistedSessionData, AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, IUserAuthorization, ISigner, ISpaceCreationHandler, LocalNodeIdentityStore, IWasmBindings, ISessionManager, SiweConfig, Manifest, ComposedManifestRequest, ClientSession, TinyCloudSession, Extension, SignRequest, SignInOptions, CapabilityPresentationEnvelopeV1, Delegation, DelegatedResource, PermissionEntry, TelemetryConfig, IKVService, ISQLService, IDuckDbService, IHooksService, CreateOwnerDelegationParams as CreateOwnerDelegationParams$1, OwnerDelegationReceipt as OwnerDelegationReceipt$1, INotificationHandler, IENSResolver, AccountService, InvokeAnyFunction as InvokeAnyFunction$1, UnifiedPolicyCapability, RegisterPolicyV3Input, RegisterPolicyV3Receipt, CanonicalJson, ShareDeliveryAuthorizationV3Receipt, IDataVaultService, IEncryptionService, NetworkDescriptor, ISecretsService, ICapabilityKeyRegistry, DelegationManager, ISpaceService, ISpace, ISharingService, CreateDelegationParams, DelegationResult, DelegationRevocationReceipt, DelegationStatus, ResolvedDelegate, KeyProvider, JWK } from '@tinycloud/sdk-core';
+import { ISessionStorage, PersistedSessionData, AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, IUserAuthorization, ISigner, ISpaceCreationHandler, LocalNodeIdentityStore, IWasmBindings, ISessionManager, SiweConfig, Manifest, ComposedManifestRequest, ClientSession, TinyCloudSession, Extension, SignRequest, SpaceHostResult, SignInOptions, CapabilityPresentationEnvelopeV1, Delegation, DelegatedResource, PermissionEntry, TelemetryConfig, IKVService, ISQLService, IDuckDbService, IHooksService, CreateOwnerDelegationParams as CreateOwnerDelegationParams$1, OwnerDelegationReceipt as OwnerDelegationReceipt$1, INotificationHandler, IENSResolver, AccountService, InvokeAnyFunction as InvokeAnyFunction$1, UnifiedPolicyCapability, RegisterPolicyV3Input, RegisterPolicyV3Receipt, CanonicalJson, ShareDeliveryAuthorizationV3Receipt, IDataVaultService, IEncryptionService, NetworkDescriptor, ISecretsService, ICapabilityKeyRegistry, DelegationManager, ISpaceService, ISpace, ISharingService, CreateDelegationParams, DelegationResult, DelegationRevocationReceipt, DelegationStatus, ResolvedDelegate, KeyProvider, JWK } from '@tinycloud/sdk-core';
 import { EventEmitter } from 'events';
 import { InvokeFunction, InvokeAnyFunction } from '@tinycloud/sdk-services';
 
@@ -465,6 +465,12 @@ declare class NodeUserAuthorization implements IUserAuthorization {
      * Used by manifest registry setup for the account space.
      */
     hostOwnedSpace(spaceId: string, purpose?: SignRequest["purpose"]): Promise<boolean>;
+    /**
+     * {@link hostOwnedSpace} with the full host-delegation result, so a failure
+     * keeps its HTTP status (e.g. a typed 401/403) instead of collapsing to
+     * `false`.
+     */
+    hostOwnedSpaceResult(spaceId: string, purpose?: SignRequest["purpose"]): Promise<SpaceHostResult>;
     /**
      * Ensure the user's space exists on the TinyCloud server.
      * Creates the space if it doesn't exist and autoCreateSpace is enabled.

package/dist/{core-DufYfxi-.d.ts → core-Bm76PnOz.d.ts}

@@ -1,5 +1,5 @@
 import * as _tinycloud_sdk_core from '@tinycloud/sdk-core';
-import { ISessionStorage, PersistedSessionData, AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, IUserAuthorization, ISigner, ISpaceCreationHandler, LocalNodeIdentityStore, IWasmBindings, ISessionManager, SiweConfig, Manifest, ComposedManifestRequest, ClientSession, TinyCloudSession, Extension, SignRequest, SignInOptions, CapabilityPresentationEnvelopeV1, Delegation, DelegatedResource, PermissionEntry, TelemetryConfig, IKVService, ISQLService, IDuckDbService, IHooksService, CreateOwnerDelegationParams as CreateOwnerDelegationParams$1, OwnerDelegationReceipt as OwnerDelegationReceipt$1, INotificationHandler, IENSResolver, AccountService, InvokeAnyFunction as InvokeAnyFunction$1, UnifiedPolicyCapability, RegisterPolicyV3Input, RegisterPolicyV3Receipt, CanonicalJson, ShareDeliveryAuthorizationV3Receipt, IDataVaultService, IEncryptionService, NetworkDescriptor, ISecretsService, ICapabilityKeyRegistry, DelegationManager, ISpaceService, ISpace, ISharingService, CreateDelegationParams, DelegationResult, DelegationRevocationReceipt, DelegationStatus, ResolvedDelegate, KeyProvider, JWK } from '@tinycloud/sdk-core';
+import { ISessionStorage, PersistedSessionData, AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, IUserAuthorization, ISigner, ISpaceCreationHandler, LocalNodeIdentityStore, IWasmBindings, ISessionManager, SiweConfig, Manifest, ComposedManifestRequest, ClientSession, TinyCloudSession, Extension, SignRequest, SpaceHostResult, SignInOptions, CapabilityPresentationEnvelopeV1, Delegation, DelegatedResource, PermissionEntry, TelemetryConfig, IKVService, ISQLService, IDuckDbService, IHooksService, CreateOwnerDelegationParams as CreateOwnerDelegationParams$1, OwnerDelegationReceipt as OwnerDelegationReceipt$1, INotificationHandler, IENSResolver, AccountService, InvokeAnyFunction as InvokeAnyFunction$1, UnifiedPolicyCapability, RegisterPolicyV3Input, RegisterPolicyV3Receipt, CanonicalJson, ShareDeliveryAuthorizationV3Receipt, IDataVaultService, IEncryptionService, NetworkDescriptor, ISecretsService, ICapabilityKeyRegistry, DelegationManager, ISpaceService, ISpace, ISharingService, CreateDelegationParams, DelegationResult, DelegationRevocationReceipt, DelegationStatus, ResolvedDelegate, KeyProvider, JWK } from '@tinycloud/sdk-core';
 import { EventEmitter } from 'events';
 import { InvokeFunction, InvokeAnyFunction } from '@tinycloud/sdk-services';
 
@@ -465,6 +465,12 @@ declare class NodeUserAuthorization implements IUserAuthorization {
      * Used by manifest registry setup for the account space.
      */
     hostOwnedSpace(spaceId: string, purpose?: SignRequest["purpose"]): Promise<boolean>;
+    /**
+     * {@link hostOwnedSpace} with the full host-delegation result, so a failure
+     * keeps its HTTP status (e.g. a typed 401/403) instead of collapsing to
+     * `false`.
+     */
+    hostOwnedSpaceResult(spaceId: string, purpose?: SignRequest["purpose"]): Promise<SpaceHostResult>;
     /**
      * Ensure the user's space exists on the TinyCloud server.
      * Creates the space if it doesn't exist and autoCreateSpace is enabled.

package/dist/core.cjs

@@ -800,21 +800,28 @@ var NodeUserAuthorization = class {
     });
     const signature = await this.signMessage(siwe, purpose);
     const headers = this.wasm.siweToDelegationHeaders({ siwe, signature });
-    const result = await (0, import_sdk_core3.submitHostDelegation)(host, headers);
-    return result.success;
+    return (0, import_sdk_core3.submitHostDelegation)(host, headers);
   }
   /**
    * Create a specific space on the server via host delegation.
    * Used for lazy creation of additional spaces (e.g., public).
    */
   async hostPublicSpace(spaceId) {
-    return this.hostSpace(spaceId);
+    return (await this.hostSpace(spaceId)).success;
   }
   /**
    * Create a specific owned space on the server via host delegation.
    * Used by manifest registry setup for the account space.
    */
   async hostOwnedSpace(spaceId, purpose) {
+    return (await this.hostOwnedSpaceResult(spaceId, purpose)).success;
+  }
+  /**
+   * {@link hostOwnedSpace} with the full host-delegation result, so a failure
+   * keeps its HTTP status (e.g. a typed 401/403) instead of collapsing to
+   * `false`.
+   */
+  async hostOwnedSpaceResult(spaceId, purpose) {
     return this.hostSpace(spaceId, purpose);
   }
   /**
@@ -857,7 +864,7 @@ var NodeUserAuthorization = class {
         return;
       }
       try {
-        const created = await this.hostSpace();
+        const created = (await this.hostSpace()).success;
         if (!created) {
           const err = new Error(`Failed to create space: ${primarySpaceId}`);
           handler.onSpaceCreationFailed?.(creationContext, err);
@@ -894,7 +901,7 @@ var NodeUserAuthorization = class {
         return;
       }
       try {
-        const created = await this.hostSpace();
+        const created = (await this.hostSpace()).success;
         if (!created) {
           const err = new Error(`Failed to create space: ${primarySpaceId}`);
           handler.onSpaceCreationFailed?.(creationContext, err);
@@ -2397,6 +2404,10 @@ function persistedExpiry(value) {
 function sameInstant(left, right) {
   return left.getTime() === right.getTime();
 }
+function describeHostFailure(result) {
+  const text = result.error?.trim();
+  return text ? `${result.status} - ${text}` : `${result.status}`;
+}
 function ownerDelegationPermissions(params) {
   const hasPermissions = Object.prototype.hasOwnProperty.call(params, "permissions");
   const hasLegacy = Object.prototype.hasOwnProperty.call(params, "path") || Object.prototype.hasOwnProperty.call(params, "actions");
@@ -3510,8 +3521,9 @@ var _TinyCloudNode = class _TinyCloudNode {
     await this.ensureOwnedSpaceHostedById(accountSpaceId);
     const result = await this.account.applications.register(request.manifests);
     if (!result.ok) {
-      throw new Error(
-        `Failed to write manifest registry records: ${result.error.message}`
+      throw Object.assign(
+        new Error(`Failed to write manifest registry records: ${result.error.message}`),
+        { cause: result.error }
       );
     }
   }
@@ -3536,7 +3548,10 @@ var _TinyCloudNode = class _TinyCloudNode {
         if (this.currentSessionCanListSpaces()) {
           const spaces = await this.account.spaces.syncAccessible();
           if (!spaces.ok) {
-            throw new Error(`Failed to sync account spaces: ${spaces.error.message}`);
+            throw Object.assign(
+              new Error(`Failed to sync account spaces: ${spaces.error.message}`),
+              { cause: spaces.error }
+            );
           }
         }
       });
@@ -3591,8 +3606,10 @@ var _TinyCloudNode = class _TinyCloudNode {
         await task();
         return;
       } catch (error) {
+        const verdict = (0, import_sdk_core8.authorizationVerdictOf)(error);
         const message = error instanceof Error ? error.message : String(error);
-        if (/Unauthorized Action|\b(?:401|403)\b/.test(message)) {
+        const isAuthorizationVerdict = verdict === void 0 ? /Unauthorized Action|\b(?:401|403)\b/.test(message) : verdict !== "other";
+        if (isAuthorizationVerdict) {
           console.warn(
             "TinyCloud account registry sync stopped: authorization verdict is not retryable",
             error
@@ -3672,19 +3689,26 @@ var _TinyCloudNode = class _TinyCloudNode {
       return;
     }
     if (!activation.success && activation.status !== 404) {
-      throw new Error(
-        `Failed to check owned space ${spaceId}: ${activation.error ?? activation.status}`
+      throw Object.assign(
+        new Error(`Failed to check owned space ${spaceId}: ${describeHostFailure(activation)}`),
+        { cause: activation }
       );
     }
-    const created = await this.auth.hostOwnedSpace(spaceId);
-    if (!created) {
-      throw new Error(`Failed to create owned space: ${spaceId}`);
+    const created = await this.auth.hostOwnedSpaceResult(spaceId);
+    if (!created.success) {
+      throw Object.assign(
+        new Error(`Failed to create owned space ${spaceId}: ${describeHostFailure(created)}`),
+        { cause: created }
+      );
     }
     await new Promise((resolve) => setTimeout(resolve, 100));
     const retry = await (0, import_sdk_core8.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"}`
+      throw Object.assign(
+        new Error(
+          `Failed to activate session after creating owned space ${spaceId}: ${retry.success ? "space was skipped" : describeHostFailure(retry)}`
+        ),
+        { cause: retry }
       );
     }
     this.confirmedHostedSpaceIds.add(spaceId);
@@ -5232,7 +5256,10 @@ var _TinyCloudNode = class _TinyCloudNode {
     const activation = await (0, import_sdk_core8.activateSessionWithHost)(host, delegationSession.delegationHeader);
     assertOwnerGraphActive();
     if (!activation.success) {
-      throw new Error(`Owner delegation import failed: ${activation.status} ${activation.error ?? ""}`.trim());
+      throw Object.assign(
+        new Error(`Owner delegation import failed: ${activation.status} ${activation.error ?? ""}`.trim()),
+        { cause: activation }
+      );
     }
     const delegation = {
       cid: delegationSession.delegationCid,