@tinycloud/node-sdk 3.6.2-beta.0 → 3.7.0-beta.1

package/dist/{TinyCloudNode--OyL6lZh.d.ts → TinyCloudNode-BHiKCQ4W.d.ts}

@@ -2040,14 +2040,14 @@ declare class TinyCloudNode {
     signOwnerRevocation(cid: string): Promise<string>;
     /** Register a signed policy and sibling roots with this Node's Policy/v3 runtime. */
     registerPolicy(params: Omit<RegisterPolicyV3Input, "nodeOrigin" | "fetch">): Promise<RegisterPolicyV3Receipt>;
-    /** Authorize one short-lived v3 delivery against the signed v3 envelope and registered roots. */
+    /**
+     * Authorize one short-lived v3 delivery. `shareUrl` is the short `/s/<id>#v=4&k=…&c=…` link: the node fetches the
+     * sealed body by id and opens it with the link's key, so the body of the request carries the link and nothing else
+     * of the share. `envelope` is the signed v3 envelope the sender holds; it checks the node's admission here and is
+     * not sent.
+     */
     authorizeShareDeliveryV3(input: {
         readonly envelope: Record<string, CanonicalJson | undefined>;
-        /** Canonical sealed recipient envelope: version || nonce || ciphertext+tag. */
-        readonly sealedEnvelope: string;
-        /** Base64url 32-byte envelope key; it must also be the URL fragment key. */
-        readonly envelopeKey: string;
-        readonly shareCid: string;
         readonly resourcePath: string;
         readonly recipientEmail: string;
         readonly shareUrl: string;
@@ -2056,6 +2056,8 @@ declare class TinyCloudNode {
         readonly deliveryAudience: string;
         /** Stable caller retry identity. It is hashed into the protocol's 16-byte JTI. */
         readonly idempotencyKey: string;
+        /** The origins `shareUrl` may be on: the node's `return_origin`. Default: `https://share.tinycloud.xyz`. */
+        readonly trustedOrigins?: readonly string[];
     }): Promise<ShareDeliveryAuthorizationV3Receipt>;
     private createRootDelegationForSharing;
     /**

package/dist/{TinyCloudNode-BMi72EIk.d.cts → TinyCloudNode-DrLNh4bs.d.cts}

@@ -2040,14 +2040,14 @@ declare class TinyCloudNode {
     signOwnerRevocation(cid: string): Promise<string>;
     /** Register a signed policy and sibling roots with this Node's Policy/v3 runtime. */
     registerPolicy(params: Omit<RegisterPolicyV3Input, "nodeOrigin" | "fetch">): Promise<RegisterPolicyV3Receipt>;
-    /** Authorize one short-lived v3 delivery against the signed v3 envelope and registered roots. */
+    /**
+     * Authorize one short-lived v3 delivery. `shareUrl` is the short `/s/<id>#v=4&k=…&c=…` link: the node fetches the
+     * sealed body by id and opens it with the link's key, so the body of the request carries the link and nothing else
+     * of the share. `envelope` is the signed v3 envelope the sender holds; it checks the node's admission here and is
+     * not sent.
+     */
     authorizeShareDeliveryV3(input: {
         readonly envelope: Record<string, CanonicalJson | undefined>;
-        /** Canonical sealed recipient envelope: version || nonce || ciphertext+tag. */
-        readonly sealedEnvelope: string;
-        /** Base64url 32-byte envelope key; it must also be the URL fragment key. */
-        readonly envelopeKey: string;
-        readonly shareCid: string;
         readonly resourcePath: string;
         readonly recipientEmail: string;
         readonly shareUrl: string;
@@ -2056,6 +2056,8 @@ declare class TinyCloudNode {
         readonly deliveryAudience: string;
         /** Stable caller retry identity. It is hashed into the protocol's 16-byte JTI. */
         readonly idempotencyKey: string;
+        /** The origins `shareUrl` may be on: the node's `return_origin`. Default: `https://share.tinycloud.xyz`. */
+        readonly trustedOrigins?: readonly string[];
     }): Promise<ShareDeliveryAuthorizationV3Receipt>;
     private createRootDelegationForSharing;
     /**

package/dist/{authority-DSG538B7.d.ts → authority-BHVqCPyl.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--OyL6lZh.js';
+import { T as TinyCloudNode } from './TinyCloudNode-BHiKCQ4W.js';
 
 /** Constructor-time validation; the space-dependent secrets check runs at sign-in and open. */
 declare function assertValidReplicationConfig(replication: (ReplicationOptions & {

package/dist/{authority-U0m7P2TE.d.cts → authority-BVmX2vCi.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-BMi72EIk.cjs';
+import { T as TinyCloudNode } from './TinyCloudNode-DrLNh4bs.cjs';
 
 /** Constructor-time validation; the space-dependent secrets check runs at sign-in and open. */
 declare function assertValidReplicationConfig(replication: (ReplicationOptions & {

package/dist/core.cjs

@@ -7422,8 +7422,14 @@ var _TinyCloudNode = class _TinyCloudNode {
       fetch: globalThis.fetch.bind(globalThis)
     });
   }
-  /** Authorize one short-lived v3 delivery against the signed v3 envelope and registered roots. */
+  /**
+   * Authorize one short-lived v3 delivery. `shareUrl` is the short `/s/<id>#v=4&k=…&c=…` link: the node fetches the
+   * sealed body by id and opens it with the link's key, so the body of the request carries the link and nothing else
+   * of the share. `envelope` is the signed v3 envelope the sender holds; it checks the node's admission here and is
+   * not sent.
+   */
   async authorizeShareDeliveryV3(input) {
+    const envelopeRef = await (0, import_sdk_core11.shortDeliveryLinkBodyCid)(input.shareUrl, input.trustedOrigins);
     const session = this.currentTinyCloudSession();
     const serviceSession = this._serviceContext?.session;
     if (!session || !serviceSession) throw new Error("Share delivery requires an authenticated session");
@@ -7433,15 +7439,12 @@ var _TinyCloudNode = class _TinyCloudNode {
     }
     const jtiDigest = new Uint8Array(await crypto.subtle.digest("SHA-256", idempotencyBytes));
     const body = {
-      envelope: input.envelope,
-      sealedEnvelope: input.sealedEnvelope,
-      envelopeKey: input.envelopeKey,
-      shareCid: input.shareCid,
       recipientEmail: input.recipientEmail,
       shareUrl: input.shareUrl,
       documentName: input.documentName,
       jti: base64UrlEncode(jtiDigest.slice(0, 16)),
-      expiresAt: new Date(input.expiresAt).toISOString().replace(/\.\d{3}Z$/, "Z")
+      // Re-normalised through Date, so the sent value is always `YYYY-MM-DDTHH:mm:ss.SSSZ` (UTC, three digits).
+      expiresAt: new Date(input.expiresAt).toISOString()
     };
     const requestBodyDigest = base64UrlEncode(new Uint8Array(await crypto.subtle.digest("SHA-256", new TextEncoder().encode((0, import_sdk_core11.canonicalizeEncryptionJson)(body)))));
     const request = { ...body, requestBodyDigest };
@@ -7451,9 +7454,16 @@ var _TinyCloudNode = class _TinyCloudNode {
       headers: { accept: "application/json", "content-type": "application/json", authorization },
       body: (0, import_sdk_core11.canonicalizeEncryptionJson)(request)
     });
-    if (!response.ok) throw await (0, import_sdk_core11.httpResponseError)(response, "V3 share delivery authorization failed");
-    const verified = (0, import_sdk_core11.validateShareDeliveryAuthorizationV3Bytes)(new Uint8Array(await response.arrayBuffer()), {
+    if (response.status === 400 || response.status === 422) throw new import_sdk_core11.ShareDeliveryRefusedError();
+    if (!response.ok) {
+      const reply = await response.text().catch(() => response.statusText);
+      const body2 = (await (0, import_sdk_core11.withoutShareLink)(reply, input.shareUrl)).trim().slice(0, 512);
+      throw Object.assign(new Error(`V3 share delivery authorization failed: HTTP ${response.status}${body2 ? ` - ${body2}` : ""}`), { status: response.status });
+    }
+    const verified = await (0, import_sdk_core11.verifyShareDeliveryAuthorizationV3Bytes)(new Uint8Array(await response.arrayBuffer()), {
       request,
+      envelope: input.envelope,
+      envelopeRef,
       senderKeyDid: this.credentialHolderDid,
       deliveryAudience: input.deliveryAudience
     });