@tinycloud/node-sdk 3.1.0-beta.14 → 3.1.0-beta.15

package/dist/{core-CMDgVfBj.d.cts → core-AEx5vAa8.d.cts}

@@ -1201,12 +1201,25 @@ interface TinyCloudNodeConfig {
  * delegation through the legacy wallet-signed SIWE path, which always
  * triggers a wallet prompt. Used for testing, for explicit wallet
  * confirmation flows, and by the legacy `createDelegation` fallback.
+ *
+ * `onPrepared` runs after the delegation is fully built and signed (CID
+ * included) and before it is activated with the host. It receives the same
+ * `PortableDelegation` object that `delegateTo` returns as
+ * `result.delegation`, so callers can durably record the grant before it
+ * goes live. If the hook rejects, the delegation is not activated and
+ * `delegateTo` rejects with the same error. It cannot be combined with
+ * `forceWalletSign`, whose wallet path activates as part of signing.
  */
 interface DelegateToOptions {
     /** Override expiry. ms-format string ("7d", "1h") or raw milliseconds. */
     expiry?: string | number;
     /** Force the wallet-signed SIWE path even if the caps are derivable. Default false. */
     forceWalletSign?: boolean;
+    /**
+     * Called with the prepared delegation before host activation. A rejection
+     * aborts activation and propagates from `delegateTo`.
+     */
+    onPrepared?: (prepared: PortableDelegation) => Promise<void>;
 }
 /**
  * Result of {@link TinyCloudNode.delegateTo}.
@@ -2253,6 +2266,10 @@ declare class TinyCloudNode {
      * @throws {@link PermissionNotInManifestError} when any requested
      *   entry is not a subset of the granted session capabilities and
      *   `forceWalletSign` is not set.
+     * @throws when `onPrepared` is combined with `forceWalletSign: true`,
+     *   before anything is signed.
+     * @throws the `onPrepared` rejection, unchanged, without activating the
+     *   delegation.
      */
     delegateTo(did: string, permissions: PermissionEntry[], options?: DelegateToOptions): Promise<DelegateToResult>;
     /**

package/dist/{core-CMDgVfBj.d.ts → core-AEx5vAa8.d.ts}

@@ -1201,12 +1201,25 @@ interface TinyCloudNodeConfig {
  * delegation through the legacy wallet-signed SIWE path, which always
  * triggers a wallet prompt. Used for testing, for explicit wallet
  * confirmation flows, and by the legacy `createDelegation` fallback.
+ *
+ * `onPrepared` runs after the delegation is fully built and signed (CID
+ * included) and before it is activated with the host. It receives the same
+ * `PortableDelegation` object that `delegateTo` returns as
+ * `result.delegation`, so callers can durably record the grant before it
+ * goes live. If the hook rejects, the delegation is not activated and
+ * `delegateTo` rejects with the same error. It cannot be combined with
+ * `forceWalletSign`, whose wallet path activates as part of signing.
  */
 interface DelegateToOptions {
     /** Override expiry. ms-format string ("7d", "1h") or raw milliseconds. */
     expiry?: string | number;
     /** Force the wallet-signed SIWE path even if the caps are derivable. Default false. */
     forceWalletSign?: boolean;
+    /**
+     * Called with the prepared delegation before host activation. A rejection
+     * aborts activation and propagates from `delegateTo`.
+     */
+    onPrepared?: (prepared: PortableDelegation) => Promise<void>;
 }
 /**
  * Result of {@link TinyCloudNode.delegateTo}.
@@ -2253,6 +2266,10 @@ declare class TinyCloudNode {
      * @throws {@link PermissionNotInManifestError} when any requested
      *   entry is not a subset of the granted session capabilities and
      *   `forceWalletSign` is not set.
+     * @throws when `onPrepared` is combined with `forceWalletSign: true`,
+     *   before anything is signed.
+     * @throws the `onPrepared` rejection, unchanged, without activating the
+     *   delegation.
      */
     delegateTo(did: string, permissions: PermissionEntry[], options?: DelegateToOptions): Promise<DelegateToResult>;
     /**

package/dist/core.cjs

@@ -6425,8 +6425,18 @@ var _TinyCloudNode = class _TinyCloudNode {
    * @throws {@link PermissionNotInManifestError} when any requested
    *   entry is not a subset of the granted session capabilities and
    *   `forceWalletSign` is not set.
+   * @throws when `onPrepared` is combined with `forceWalletSign: true`,
+   *   before anything is signed.
+   * @throws the `onPrepared` rejection, unchanged, without activating the
+   *   delegation.
    */
   async delegateTo(did, permissions, options) {
+    const onPrepared = options?.onPrepared;
+    if (onPrepared && options?.forceWalletSign) {
+      throw new Error(
+        "delegateTo: onPrepared cannot be combined with forceWalletSign=true; the wallet-signed path activates the delegation before it could be handed to onPrepared."
+      );
+    }
     const session = this.currentTinyCloudSession();
     if (!session) {
       throw new import_sdk_core8.SessionExpiredError(/* @__PURE__ */ new Date(0));
@@ -6485,7 +6495,8 @@ var _TinyCloudNode = class _TinyCloudNode {
           expandedEntries,
           runtimeExpiration,
           runtimeGrant,
-          runtimeOperations
+          runtimeOperations,
+          onPrepared
         );
         return { delegation: delegation2, prompted: false };
       }
@@ -6495,7 +6506,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       did,
       expandedEntries,
       effectiveExpiration,
-      session
+      session,
+      onPrepared
     );
     return { delegation, prompted: false };
   }
@@ -6549,7 +6561,7 @@ var _TinyCloudNode = class _TinyCloudNode {
    *
    * @internal
    */
-  async createDelegationViaWasmPath(did, entries, expirationTime, session) {
+  async createDelegationViaWasmPath(did, entries, expirationTime, session, onPrepared) {
     if (entries.length === 0) {
       throw new Error(
         "createDelegationViaWasmPath requires a non-empty entries array"
@@ -6612,17 +6624,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     });
     const primary = result.resources[0];
     const delegationHeader = { Authorization: result.delegation };
-    const activateResult = await (0, import_sdk_core8.activateSessionWithHost)(
-      this.config.host,
-      delegationHeader
-    );
-    if (!activateResult.success) {
-      throw Object.assign(
-        new Error(`Failed to activate delegation with host: ${describeHostFailure2(activateResult)}`),
-        { cause: activateResult }
-      );
-    }
-    return {
+    const delegation = {
       cid: result.cid,
       delegationHeader,
       spaceId,
@@ -6636,8 +6638,22 @@ var _TinyCloudNode = class _TinyCloudNode {
       chainId: session.chainId,
       host: this.config.host
     };
+    if (onPrepared) {
+      await onPrepared(delegation);
+    }
+    const activateResult = await (0, import_sdk_core8.activateSessionWithHost)(
+      this.config.host,
+      delegationHeader
+    );
+    if (!activateResult.success) {
+      throw Object.assign(
+        new Error(`Failed to activate delegation with host: ${describeHostFailure2(activateResult)}`),
+        { cause: activateResult }
+      );
+    }
+    return delegation;
   }
-  async createDelegationViaRuntimeGrant(did, entries, expirationTime, grant, requestedOperations) {
+  async createDelegationViaRuntimeGrant(did, entries, expirationTime, grant, requestedOperations, onPrepared) {
     this.assertRuntimeGrantCaveatsPreservable(entries, requestedOperations, grant);
     this.assertDelegationCaveatsPreservable(entries);
     const result = this.createDelegationWrapper({
@@ -6650,17 +6666,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     const primary = result.resources[0];
     const delegationHeader = { Authorization: result.delegation };
     const targetHost = grant.delegation.host ?? this.config.host;
-    const activateResult = await (0, import_sdk_core8.activateSessionWithHost)(
-      targetHost,
-      delegationHeader
-    );
-    if (!activateResult.success) {
-      throw Object.assign(
-        new Error(`Failed to activate delegation with host: ${describeHostFailure2(activateResult)}`),
-        { cause: activateResult }
-      );
-    }
-    return {
+    const delegation = {
       cid: result.cid,
       delegationHeader,
       spaceId: grant.session.spaceId,
@@ -6674,6 +6680,20 @@ var _TinyCloudNode = class _TinyCloudNode {
       chainId: grant.delegation.chainId,
       host: targetHost
     };
+    if (onPrepared) {
+      await onPrepared(delegation);
+    }
+    const activateResult = await (0, import_sdk_core8.activateSessionWithHost)(
+      targetHost,
+      delegationHeader
+    );
+    if (!activateResult.success) {
+      throw Object.assign(
+        new Error(`Failed to activate delegation with host: ${describeHostFailure2(activateResult)}`),
+        { cause: activateResult }
+      );
+    }
+    return delegation;
   }
   resolvePermissionSpace(space, session) {
     if (space === void 0) {