@tinycloud/node-sdk 3.3.0-beta.7 → 3.3.0-beta.8

package/dist/{TinyCloudNode-BchWB_zv.d.cts → TinyCloudNode-CcNh20QX.d.cts}

@@ -1283,6 +1283,13 @@ interface DelegateToOptions {
      * aborts activation and propagates from `delegateTo`.
      */
     onPrepared?: (prepared: PortableDelegation) => Promise<void>;
+    /**
+     * Mark the delegation terminal: the node refuses any delegation that cites
+     * it as a parent (`terminal-parent-cannot-redelegate`). The delegate can
+     * still use it directly. Only session-key UCAN delegations can carry the
+     * marker, so this throws with `forceWalletSign`. Default false.
+     */
+    disableSubDelegation?: boolean;
 }
 /**
  * Result of {@link TinyCloudNode.delegateTo}.
@@ -2138,7 +2145,8 @@ declare class TinyCloudNode {
      * Both SharingService (single-entry) and
      * {@link TinyCloudNode.delegateTo} (multi-entry) drive this through
      * the same code path so there's exactly one place that touches the
-     * WASM boundary.
+     * WASM boundary. `terminal` adds the node's terminal marker, which the
+     * WASM builder cannot emit.
      *
      * @internal
      */
@@ -2734,7 +2742,12 @@ declare class TinyCloudNode {
         actions: string[];
         /** DID of the recipient (from their TinyCloudNode.did) */
         delegateDID: string;
-        /** Whether to prevent the recipient from creating sub-delegations (default: false) */
+        /**
+         * Prevent the recipient from creating sub-delegations (default: false).
+         * The delegation carries the node's terminal marker, so the node refuses
+         * its children. Needs capabilities the current session holds; throws
+         * rather than fall back to a wallet-signed delegation.
+         */
         disableSubDelegation?: boolean;
         /** Expiration time in milliseconds from now (default: 1 hour) */
         expiryMs?: number;
@@ -2782,7 +2795,10 @@ declare class TinyCloudNode {
         actions: string[];
         /** DID of the recipient */
         delegateDID: string;
-        /** Whether to prevent the recipient from creating further sub-delegations */
+        /**
+         * Not supported: this method issues a wallet-signed delegation, which
+         * cannot carry the node's terminal marker, so `true` throws.
+         */
         disableSubDelegation?: boolean;
         /** Expiration in milliseconds from now; defaults to the parent's own expiry, the longest allowed. */
         expiryMs?: number;

package/dist/{TinyCloudNode-BchWB_zv.d.ts → TinyCloudNode-CcNh20QX.d.ts}

@@ -1283,6 +1283,13 @@ interface DelegateToOptions {
      * aborts activation and propagates from `delegateTo`.
      */
     onPrepared?: (prepared: PortableDelegation) => Promise<void>;
+    /**
+     * Mark the delegation terminal: the node refuses any delegation that cites
+     * it as a parent (`terminal-parent-cannot-redelegate`). The delegate can
+     * still use it directly. Only session-key UCAN delegations can carry the
+     * marker, so this throws with `forceWalletSign`. Default false.
+     */
+    disableSubDelegation?: boolean;
 }
 /**
  * Result of {@link TinyCloudNode.delegateTo}.
@@ -2138,7 +2145,8 @@ declare class TinyCloudNode {
      * Both SharingService (single-entry) and
      * {@link TinyCloudNode.delegateTo} (multi-entry) drive this through
      * the same code path so there's exactly one place that touches the
-     * WASM boundary.
+     * WASM boundary. `terminal` adds the node's terminal marker, which the
+     * WASM builder cannot emit.
      *
      * @internal
      */
@@ -2734,7 +2742,12 @@ declare class TinyCloudNode {
         actions: string[];
         /** DID of the recipient (from their TinyCloudNode.did) */
         delegateDID: string;
-        /** Whether to prevent the recipient from creating sub-delegations (default: false) */
+        /**
+         * Prevent the recipient from creating sub-delegations (default: false).
+         * The delegation carries the node's terminal marker, so the node refuses
+         * its children. Needs capabilities the current session holds; throws
+         * rather than fall back to a wallet-signed delegation.
+         */
         disableSubDelegation?: boolean;
         /** Expiration time in milliseconds from now (default: 1 hour) */
         expiryMs?: number;
@@ -2782,7 +2795,10 @@ declare class TinyCloudNode {
         actions: string[];
         /** DID of the recipient */
         delegateDID: string;
-        /** Whether to prevent the recipient from creating further sub-delegations */
+        /**
+         * Not supported: this method issues a wallet-signed delegation, which
+         * cannot carry the node's terminal marker, so `true` throws.
+         */
         disableSubDelegation?: boolean;
         /** Expiration in milliseconds from now; defaults to the parent's own expiry, the longest allowed. */
         expiryMs?: number;

package/dist/{authority-lrA-698X.d.cts → authority-Cwotwza3.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 { ReplicaSessionStamp, ReplicaDenyInput } from '@tinycloud/sdk-services/kv/replication';
-import { T as TinyCloudNode } from './TinyCloudNode-BchWB_zv.cjs';
+import { T as TinyCloudNode } from './TinyCloudNode-CcNh20QX.cjs';
 
 /** Constructor-time validation; the space-dependent secrets check runs at sign-in and open. */
 declare function assertValidReplicationConfig(replication: (ReplicationOptions & {

package/dist/{authority-4HXYteKF.d.ts → authority-D_u9a7Wl.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 { ReplicaSessionStamp, ReplicaDenyInput } from '@tinycloud/sdk-services/kv/replication';
-import { T as TinyCloudNode } from './TinyCloudNode-BchWB_zv.js';
+import { T as TinyCloudNode } from './TinyCloudNode-CcNh20QX.js';
 
 /** Constructor-time validation; the space-dependent secrets check runs at sign-in and open. */
 declare function assertValidReplicationConfig(replication: (ReplicationOptions & {

package/dist/core.cjs

@@ -3347,6 +3347,7 @@ function ownerPermissionsToAbilities(permissions) {
   }
   return { abilities, rawAbilities };
 }
+var TERMINAL_DELEGATION_REQUIRES_SESSION_KEY = "disableSubDelegation requires a session-key delegation";
 function base64UrlEncode(bytes) {
   const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
   let output = "";
@@ -6932,11 +6933,12 @@ var _TinyCloudNode = class _TinyCloudNode {
    * Both SharingService (single-entry) and
    * {@link TinyCloudNode.delegateTo} (multi-entry) drive this through
    * the same code path so there's exactly one place that touches the
-   * WASM boundary.
+   * WASM boundary. `terminal` adds the node's terminal marker, which the
+   * WASM builder cannot emit.
    *
    * @internal
    */
-  createDelegationWrapper(params) {
+  createDelegationWrapper(params, terminal = false) {
     const wasmSession = {
       delegationHeader: params.session.delegationHeader,
       delegationCid: params.session.delegationCid,
@@ -6956,8 +6958,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       params.notBeforeSecs
     );
     return {
-      delegation: result.delegation,
-      cid: result.cid,
+      ...terminal ? (0, import_sdk_core10.markDelegationTerminal)(result.delegation, params.session.jwk) : { delegation: result.delegation, cid: result.cid },
       // Rust serde `rename_all = "camelCase"` emits `delegateDid`
       // (lowercase d); the TypeScript interface uses `delegateDID`
       // (historical, matches Delegation.delegateDID). Normalize here.
@@ -8206,6 +8207,9 @@ var _TinyCloudNode = class _TinyCloudNode {
       effectiveExpiration = sessionExpiry;
     }
     if (options?.forceWalletSign) {
+      if (options.disableSubDelegation) {
+        throw new Error(TERMINAL_DELEGATION_REQUIRES_SESSION_KEY);
+      }
       if (expandedEntries.length > 1) {
         throw new Error(
           "delegateTo with forceWalletSign=true supports at most one PermissionEntry. Multi-entry requests must go through the session-key UCAN path (drop forceWalletSign) or the legacy createDelegation method."
@@ -8241,7 +8245,8 @@ var _TinyCloudNode = class _TinyCloudNode {
         plan.effectiveExpiration,
         plan.grant,
         plan.operations,
-        onPrepared
+        onPrepared,
+        options?.disableSubDelegation === true
       );
       return { delegation: delegation2, prompted: false };
     }
@@ -8250,7 +8255,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       expandedEntries,
       effectiveExpiration,
       session,
-      onPrepared
+      onPrepared,
+      options?.disableSubDelegation === true
     );
     return { delegation, prompted: false };
   }
@@ -8481,7 +8487,7 @@ var _TinyCloudNode = class _TinyCloudNode {
    *
    * @internal
    */
-  async createDelegationViaWasmPath(did, entries, expirationTime, session, onPrepared) {
+  async createDelegationViaWasmPath(did, entries, expirationTime, session, onPrepared, disableSubDelegation = false) {
     if (entries.length === 0) {
       throw new Error(
         "createDelegationViaWasmPath requires a non-empty entries array"
@@ -8541,7 +8547,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       spaceId,
       abilities,
       expirationSecs
-    });
+    }, disableSubDelegation);
     const primary = result.resources[0];
     const delegationHeader = { Authorization: result.delegation };
     const delegation = {
@@ -8551,7 +8557,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       path: primary.path,
       actions: primary.actions,
       resources: result.resources,
-      disableSubDelegation: false,
+      disableSubDelegation,
       expiry: result.expiry,
       delegateDID: did,
       ownerAddress: session.address,
@@ -8573,7 +8579,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     }
     return delegation;
   }
-  async createDelegationViaRuntimeGrant(did, entries, expirationTime, grant, requestedOperations, onPrepared) {
+  async createDelegationViaRuntimeGrant(did, entries, expirationTime, grant, requestedOperations, onPrepared, disableSubDelegation = false) {
     this.assertRuntimeGrantCaveatsPreservable(entries, requestedOperations, grant);
     this.assertDelegationCaveatsPreservable(entries);
     const result = this.createDelegationWrapper({
@@ -8582,7 +8588,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       spaceId: grant.session.spaceId,
       abilities: this.permissionsToAbilities(entries),
       expirationSecs: Math.floor(expirationTime.getTime() / 1e3)
-    });
+    }, disableSubDelegation);
     const primary = result.resources[0];
     const delegationHeader = { Authorization: result.delegation };
     const targetHost = grant.delegation.host ?? this.config.host;
@@ -8593,7 +8599,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       path: primary.path,
       actions: primary.actions,
       resources: result.resources,
-      disableSubDelegation: false,
+      disableSubDelegation,
       expiry: result.expiry,
       delegateDID: did,
       ownerAddress: grant.delegation.ownerAddress,
@@ -9177,11 +9183,10 @@ var _TinyCloudNode = class _TinyCloudNode {
       params.spaceIdOverride
     );
     try {
-      const result = await this.delegateTo(
-        resolvedDelegateDID,
-        entries,
-        params.expiryMs !== void 0 ? { expiry: params.expiryMs } : void 0
-      );
+      const result = await this.delegateTo(resolvedDelegateDID, entries, {
+        ...params.expiryMs !== void 0 ? { expiry: params.expiryMs } : {},
+        disableSubDelegation: params.disableSubDelegation
+      });
       return result.delegation;
     } catch (err2) {
       if (err2 instanceof import_sdk_core10.PermissionNotInManifestError) {
@@ -9202,6 +9207,9 @@ var _TinyCloudNode = class _TinyCloudNode {
    * @internal
    */
   async createDelegationWalletPath(params) {
+    if (params.disableSubDelegation) {
+      throw new Error(TERMINAL_DELEGATION_REQUIRES_SESSION_KEY);
+    }
     if (!this.signer) {
       throw new Error("Cannot createDelegation() in session-only mode. Requires wallet mode.");
     }
@@ -9257,7 +9265,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       spaceId: params.spaceIdOverride ?? session.spaceId,
       path: params.path,
       actions: params.actions,
-      disableSubDelegation: params.disableSubDelegation ?? false,
+      disableSubDelegation: false,
       expiry: expirationTime,
       delegateDID: params.delegateDID,
       ownerAddress: session.address,
@@ -9300,7 +9308,7 @@ var _TinyCloudNode = class _TinyCloudNode {
           spaceId: publicSpaceId,
           path: "",
           actions: [import_sdk_core10.KV.GET, import_sdk_core10.KV.PUT, import_sdk_core10.KV.METADATA],
-          disableSubDelegation: params.disableSubDelegation ?? false,
+          disableSubDelegation: false,
           expiry: expirationTime,
           delegateDID: params.delegateDID,
           ownerAddress: session.address,
@@ -9467,6 +9475,9 @@ var _TinyCloudNode = class _TinyCloudNode {
     if (parentDelegation.disableSubDelegation) {
       throw new Error("Parent delegation does not allow sub-delegation");
     }
+    if (params.disableSubDelegation) {
+      throw new Error(TERMINAL_DELEGATION_REQUIRES_SESSION_KEY);
+    }
     const parentResources = parentDelegation.resources ?? [{
       service: parentDelegation.actions[0]?.split("/", 1)[0]?.replace(/^tinycloud\./, "") ?? "kv",
       space: parentDelegation.spaceId,
@@ -9539,7 +9550,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       spaceId: parentDelegation.spaceId,
       path: requestedResources[0].path,
       actions: requestedResources[0].actions,
-      disableSubDelegation: params.disableSubDelegation ?? false,
+      disableSubDelegation: false,
       expiry: actualExpiry,
       delegateDID: params.delegateDID,
       ownerAddress: parentDelegation.ownerAddress,