@beam-network/sdk 0.5.17-dev.3 → 0.5.17-dev.4

package/README.md

@@ -161,7 +161,7 @@ Create and resume accept an ownership `signal`. Aborting it stops initial routes
 
 The stream ID derives from the transfer, selected flow, and immutable plan identity, and each ordered batch ID includes its route-coordinate checksum. Manual multi-destination attachment requires `delivery_index` on every route. Lifecycle mutations retry transient failures up to three times with the same request identity. A non-recoverable provider setup or route failure raises `BeamProviderTransferError`, whose `errors`, `transferCancelled`, and `multipartCleanupComplete` fields retain the original provider, cancellation, and cleanup outcomes. `waitForTransfer` subscribes to the API-key-owned, at-most-once terminal signal before its first status read and reconciles every signal through authoritative status; subscription failure degrades to the same jittered 15-to-30-second status fallback. Call `close()` when the client is no longer needed; it also closes outstanding terminal waiters.
 
-During the pre-completion `integrity_check` phase, Runtime may include an `integrity_audit_challenge` in status. The TypeScript client signs exact read-only source and final-destination GET ranges and submits `transfer.integrity_audit_grants`. S3-compatible source and destination grants use the prepared source ETag and Runtime-verified final-object ETag as `If-Match` conditions. Submission failures retry on the next status poll; the transfer completes with a warning if the check cannot finish by its deadline.
+During the pre-completion `integrity_check` phase, Runtime may include an `integrity_audit_challenge` in status. The TypeScript client signs exact read-only source and final-destination GET ranges and submits `transfer.integrity_audit_grants`. S3-compatible source and destination grants use the prepared source ETag and Runtime-verified final-object ETag as `If-Match` conditions. Submission failures retry on the next status poll and appear as a URL-safe `integrity_audit_submission_error` on that status response; the transfer completes with a warning if the check cannot finish by its deadline.
 
 Hippius uses canonical non-multipart `signed_url` routes, so its manifest is empty and group-level final HEAD verification is not available from that provider flow.
 

package/dist/client.js

@@ -121,7 +121,12 @@ export class BeamClient {
         validateId(transferId, "transferId");
         const status = await this.control.request("transfer.status", { transfer_id: transferId }, { transferId });
         if (status.integrity_audit_challenge) {
-            await this.submitIntegrityAuditGrantsIfPresent(status).catch(() => undefined);
+            try {
+                await this.submitIntegrityAuditGrantsIfPresent(status);
+            }
+            catch (error) {
+                status.integrity_audit_submission_error = integrityAuditErrorSummary(error);
+            }
         }
         if (["completed", "failed", "cancelled"].includes(status.status)) {
             this.control.releaseRecoveryLease(transferId);
@@ -929,7 +934,7 @@ export class BeamClient {
             return;
         const signer = this.integrityAuditSigners.get(challenge.transfer_id);
         if (!signer)
-            return;
+            throw new Error("integrity audit signer unavailable");
         const existing = this.integrityAuditSubmissions.get(challenge.audit_id);
         if (existing) {
             await existing;
@@ -1357,6 +1362,15 @@ async function mapOrderedWithConcurrency(values, concurrency, map) {
     await Promise.all(workers);
     return results;
 }
+function integrityAuditErrorSummary(error) {
+    if (!(error instanceof Error))
+        return "unknown_error";
+    const message = error.message.trim();
+    if (!message || /https?:\/\/|x-amz|password|secret|token|authorization|credential/i.test(message)) {
+        return error.name || "unknown_error";
+    }
+    return message.slice(0, 200);
+}
 function positiveInteger(value, label) {
     if (!Number.isInteger(value) || value < 1)
         throw new Error(`${label} must be a positive integer.`);

package/dist/models.d.ts

@@ -171,6 +171,7 @@ export interface TransferStatusInfo {
         completedDestinationIds: string[];
     };
     integrity_audit_challenge?: IntegrityAuditChallenge;
+    integrity_audit_submission_error?: string;
 }
 export interface ProviderTransferResumeInput extends Omit<ProviderTransferCreateInput, "idempotencyKey" | "routeGenerationId"> {
     transferId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@beam-network/sdk",
-    "version": "0.5.17-dev.3",
+    "version": "0.5.17-dev.4",
     "description": "TypeScript SDK for BEAM transfer creation and management.",
     "type": "module",
     "license": "MIT",