@backblaze-labs/b2-sdk 0.1.0 → 0.2.0

package/dist/types/lock.js

@@ -1,17 +1,36 @@
-const RetentionMode = {
-  /** Locked: cannot be deleted or modified until `retainUntilTimestamp`, even by the account owner. */
-  Compliance: "compliance",
-  /** Locked: can be shortened by callers holding the `bypassGovernance` capability. */
-  Governance: "governance"
+//#region src/types/lock.ts
+/**
+* Named constants for the file-level Object Lock retention mode.
+*
+* @example
+* ```ts
+* await object.setRetention(fileId, {
+*   mode: RetentionMode.Compliance,
+*   retainUntilTimestamp: Date.now() + 86_400_000,
+* })
+* ```
+*/
+var RetentionMode = {
+	/** Locked: cannot be deleted or modified until `retainUntilTimestamp`, even by the account owner. */
+	Compliance: "compliance",
+	/** Locked: can be shortened by callers holding the `bypassGovernance` capability. */
+	Governance: "governance"
 };
-const LegalHoldValue = {
-  /** Apply the legal hold. */
-  On: "on",
-  /** Remove the legal hold. */
-  Off: "off"
+/**
+* Named constants for the file legal-hold status.
+*
+* @example
+* ```ts
+* await object.setLegalHold(fileId, LegalHoldValue.On)
+* ```
+*/
+var LegalHoldValue = {
+	/** Apply the legal hold. */
+	On: "on",
+	/** Remove the legal hold. */
+	Off: "off"
 };
-export {
-  LegalHoldValue,
-  RetentionMode
-};
-//# sourceMappingURL=lock.js.map
+//#endregion
+export { LegalHoldValue, RetentionMode };
+
+//# sourceMappingURL=lock.js.map

package/dist/types/lock.js.map

@@ -1 +1 @@
-{"version":3,"file":"lock.js","sources":["../../src/types/lock.ts"],"sourcesContent":["import type { FileId } from './ids.ts'\n\n/**\n * Named constants for the file-level Object Lock retention mode.\n *\n * @example\n * ```ts\n * await object.setRetention(fileId, {\n *   mode: RetentionMode.Compliance,\n *   retainUntilTimestamp: Date.now() + 86_400_000,\n * })\n * ```\n */\nexport const RetentionMode = {\n  /** Locked: cannot be deleted or modified until `retainUntilTimestamp`, even by the account owner. */\n  Compliance: 'compliance',\n  /** Locked: can be shortened by callers holding the `bypassGovernance` capability. */\n  Governance: 'governance',\n} as const\n\n/** File-level Object Lock retention mode. Derived from {@link RetentionMode}. */\nexport type RetentionMode = (typeof RetentionMode)[keyof typeof RetentionMode]\n\n/**\n * Named constants for the file legal-hold status.\n *\n * @example\n * ```ts\n * await object.setLegalHold(fileId, LegalHoldValue.On)\n * ```\n */\nexport const LegalHoldValue = {\n  /** Apply the legal hold. */\n  On: 'on',\n  /** Remove the legal hold. */\n  Off: 'off',\n} as const\n\n/** Legal hold status for a file. Derived from {@link LegalHoldValue}. */\nexport type LegalHoldValue = (typeof LegalHoldValue)[keyof typeof LegalHoldValue]\n\n/** Retention settings for a specific file version under Object Lock. */\nexport interface FileRetentionValue {\n  /** Retention mode, or null if no retention is set. */\n  readonly mode: RetentionMode | null\n  /** UTC timestamp (milliseconds) until which the file is retained, or null if not set. */\n  readonly retainUntilTimestamp: number | null\n}\n\n/**\n * Request parameters for the `b2_update_file_retention` API call.\n * Updates the Object Lock retention settings on a file version.\n */\nexport interface UpdateFileRetentionRequest {\n  /** Name of the file to update. */\n  readonly fileName: string\n  /** ID of the file version to update. */\n  readonly fileId: FileId\n  /** New retention settings for the file. */\n  readonly fileRetention: FileRetentionValue\n  /**\n   * When `true`, allows shortening a governance-mode retention period. Requires\n   * the `bypassGovernance` capability on the application key. Has no effect on\n   * compliance-mode retention.\n   */\n  readonly bypassGovernance?: boolean\n}\n\n/**\n * Request parameters for the `b2_update_file_legal_hold` API call.\n * Updates the legal hold status on a file version.\n */\nexport interface UpdateFileLegalHoldRequest {\n  /** Name of the file to update. */\n  readonly fileName: string\n  /** ID of the file version to update. */\n  readonly fileId: FileId\n  /** New legal hold status: `'on'` or `'off'`. */\n  readonly legalHold: LegalHoldValue\n}\n\n/** Response from the `b2_update_file_retention` API call. */\nexport interface UpdateFileRetentionResponse {\n  /** Name of the updated file. */\n  readonly fileName: string\n  /** ID of the updated file version. */\n  readonly fileId: FileId\n  /** Retention settings as applied. */\n  readonly fileRetention: FileRetentionValue\n}\n\n/** Response from the `b2_update_file_legal_hold` API call. */\nexport interface UpdateFileLegalHoldResponse {\n  /** Name of the updated file. */\n  readonly fileName: string\n  /** ID of the updated file version. */\n  readonly fileId: FileId\n  /** Legal hold status as applied. */\n  readonly legalHold: LegalHoldValue\n}\n"],"names":[],"mappings":"AAaO,MAAM,gBAAgB;AAAA;AAAA,EAE3B,YAAY;AAAA;AAAA,EAEZ,YAAY;AACd;AAaO,MAAM,iBAAiB;AAAA;AAAA,EAE5B,IAAI;AAAA;AAAA,EAEJ,KAAK;AACP;"}
+{"version":3,"file":"lock.js","names":[],"sources":["../../src/types/lock.ts"],"sourcesContent":["import type { FileId } from './ids.ts'\n\n/**\n * Named constants for the file-level Object Lock retention mode.\n *\n * @example\n * ```ts\n * await object.setRetention(fileId, {\n *   mode: RetentionMode.Compliance,\n *   retainUntilTimestamp: Date.now() + 86_400_000,\n * })\n * ```\n */\nexport const RetentionMode = {\n  /** Locked: cannot be deleted or modified until `retainUntilTimestamp`, even by the account owner. */\n  Compliance: 'compliance',\n  /** Locked: can be shortened by callers holding the `bypassGovernance` capability. */\n  Governance: 'governance',\n} as const\n\n/** File-level Object Lock retention mode. Derived from {@link RetentionMode}. */\nexport type RetentionMode = (typeof RetentionMode)[keyof typeof RetentionMode]\n\n/**\n * Named constants for the file legal-hold status.\n *\n * @example\n * ```ts\n * await object.setLegalHold(fileId, LegalHoldValue.On)\n * ```\n */\nexport const LegalHoldValue = {\n  /** Apply the legal hold. */\n  On: 'on',\n  /** Remove the legal hold. */\n  Off: 'off',\n} as const\n\n/** Legal hold status for a file. Derived from {@link LegalHoldValue}. */\nexport type LegalHoldValue = (typeof LegalHoldValue)[keyof typeof LegalHoldValue]\n\n/** Retention settings for a specific file version under Object Lock. */\nexport interface FileRetentionValue {\n  /** Retention mode, or null if no retention is set. */\n  readonly mode: RetentionMode | null\n  /** UTC timestamp (milliseconds) until which the file is retained, or null if not set. */\n  readonly retainUntilTimestamp: number | null\n}\n\n/**\n * Request parameters for the `b2_update_file_retention` API call.\n * Updates the Object Lock retention settings on a file version.\n */\nexport interface UpdateFileRetentionRequest {\n  /** Name of the file to update. */\n  readonly fileName: string\n  /** ID of the file version to update. */\n  readonly fileId: FileId\n  /** New retention settings for the file. */\n  readonly fileRetention: FileRetentionValue\n  /**\n   * When `true`, allows shortening a governance-mode retention period. Requires\n   * the `bypassGovernance` capability on the application key. Has no effect on\n   * compliance-mode retention.\n   */\n  readonly bypassGovernance?: boolean\n}\n\n/**\n * Request parameters for the `b2_update_file_legal_hold` API call.\n * Updates the legal hold status on a file version.\n */\nexport interface UpdateFileLegalHoldRequest {\n  /** Name of the file to update. */\n  readonly fileName: string\n  /** ID of the file version to update. */\n  readonly fileId: FileId\n  /** New legal hold status: `'on'` or `'off'`. */\n  readonly legalHold: LegalHoldValue\n}\n\n/** Response from the `b2_update_file_retention` API call. */\nexport interface UpdateFileRetentionResponse {\n  /** Name of the updated file. */\n  readonly fileName: string\n  /** ID of the updated file version. */\n  readonly fileId: FileId\n  /** Retention settings as applied. */\n  readonly fileRetention: FileRetentionValue\n}\n\n/** Response from the `b2_update_file_legal_hold` API call. */\nexport interface UpdateFileLegalHoldResponse {\n  /** Name of the updated file. */\n  readonly fileName: string\n  /** ID of the updated file version. */\n  readonly fileId: FileId\n  /** Legal hold status as applied. */\n  readonly legalHold: LegalHoldValue\n}\n"],"mappings":";;;;;;;;;;;;AAaA,IAAa,gBAAgB;;CAE3B,YAAY;;CAEZ,YAAY;AACd;;;;;;;;;AAaA,IAAa,iBAAiB;;CAE5B,IAAI;;CAEJ,KAAK;AACP"}

package/dist/types/notifications.cjs

@@ -1,24 +1,46 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const EventType = {
-  /** Wildcard: any `b2:ObjectCreated:*` sub-event. */
-  ObjectCreatedAll: "b2:ObjectCreated:*",
-  /** A small-file upload (`b2_upload_file`). */
-  ObjectCreatedUpload: "b2:ObjectCreated:Upload",
-  /** A multipart upload completed (`b2_finish_large_file`). */
-  ObjectCreatedMultipartUpload: "b2:ObjectCreated:MultipartUpload",
-  /** A server-side copy (`b2_copy_file` or `b2_copy_part`). */
-  ObjectCreatedCopy: "b2:ObjectCreated:Copy",
-  /** A replica delivered via cross-region replication. */
-  ObjectCreatedReplica: "b2:ObjectCreated:Replica",
-  /** A hide marker was created (`b2_hide_file`). */
-  ObjectCreatedHide: "b2:ObjectCreated:Hide",
-  /** Wildcard: any `b2:ObjectDeleted:*` sub-event. */
-  ObjectDeletedAll: "b2:ObjectDeleted:*",
-  /** A version was permanently deleted (`b2_delete_file_version`). */
-  ObjectDeletedDelete: "b2:ObjectDeleted:Delete",
-  /** A version was removed by a lifecycle rule. */
-  ObjectDeletedLifecycleRule: "b2:ObjectDeleted:LifecycleRule"
+//#region src/types/notifications.ts
+/**
+* Named constants for the B2 event types that can trigger notifications.
+*
+* Wildcard variants (`ObjectCreatedAll`, `ObjectDeletedAll`) subscribe to
+* every sub-event in their category.
+*
+* @example
+* ```ts
+* await bucket.setNotificationRules([
+*   {
+*     name: 'all-uploads',
+*     eventTypes: [EventType.ObjectCreatedAll],
+*     isEnabled: true,
+*     isSuspended: false,
+*     objectNamePrefix: '',
+*     suspensionReason: '',
+*     targetConfiguration: { targetType: 'url', url: 'https://example.com/webhook' },
+*   },
+* ])
+* ```
+*/
+var EventType = {
+	/** Wildcard: any `b2:ObjectCreated:*` sub-event. */
+	ObjectCreatedAll: "b2:ObjectCreated:*",
+	/** A small-file upload (`b2_upload_file`). */
+	ObjectCreatedUpload: "b2:ObjectCreated:Upload",
+	/** A multipart upload completed (`b2_finish_large_file`). */
+	ObjectCreatedMultipartUpload: "b2:ObjectCreated:MultipartUpload",
+	/** A server-side copy (`b2_copy_file` or `b2_copy_part`). */
+	ObjectCreatedCopy: "b2:ObjectCreated:Copy",
+	/** A replica delivered via cross-region replication. */
+	ObjectCreatedReplica: "b2:ObjectCreated:Replica",
+	/** A hide marker was created (`b2_hide_file`). */
+	ObjectCreatedHide: "b2:ObjectCreated:Hide",
+	/** Wildcard: any `b2:ObjectDeleted:*` sub-event. */
+	ObjectDeletedAll: "b2:ObjectDeleted:*",
+	/** A version was permanently deleted (`b2_delete_file_version`). */
+	ObjectDeletedDelete: "b2:ObjectDeleted:Delete",
+	/** A version was removed by a lifecycle rule. */
+	ObjectDeletedLifecycleRule: "b2:ObjectDeleted:LifecycleRule"
 };
+//#endregion
 exports.EventType = EventType;
-//# sourceMappingURL=notifications.cjs.map
+
+//# sourceMappingURL=notifications.cjs.map

package/dist/types/notifications.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.cjs","sources":["../../src/types/notifications.ts"],"sourcesContent":["import type { BucketId } from './ids.ts'\n\n/**\n * Named constants for the B2 event types that can trigger notifications.\n *\n * Wildcard variants (`ObjectCreatedAll`, `ObjectDeletedAll`) subscribe to\n * every sub-event in their category.\n *\n * @example\n * ```ts\n * await bucket.setNotificationRules([\n *   {\n *     name: 'all-uploads',\n *     eventTypes: [EventType.ObjectCreatedAll],\n *     isEnabled: true,\n *     isSuspended: false,\n *     objectNamePrefix: '',\n *     suspensionReason: '',\n *     targetConfiguration: { targetType: 'url', url: 'https://example.com/webhook' },\n *   },\n * ])\n * ```\n */\nexport const EventType = {\n  /** Wildcard: any `b2:ObjectCreated:*` sub-event. */\n  ObjectCreatedAll: 'b2:ObjectCreated:*',\n  /** A small-file upload (`b2_upload_file`). */\n  ObjectCreatedUpload: 'b2:ObjectCreated:Upload',\n  /** A multipart upload completed (`b2_finish_large_file`). */\n  ObjectCreatedMultipartUpload: 'b2:ObjectCreated:MultipartUpload',\n  /** A server-side copy (`b2_copy_file` or `b2_copy_part`). */\n  ObjectCreatedCopy: 'b2:ObjectCreated:Copy',\n  /** A replica delivered via cross-region replication. */\n  ObjectCreatedReplica: 'b2:ObjectCreated:Replica',\n  /** A hide marker was created (`b2_hide_file`). */\n  ObjectCreatedHide: 'b2:ObjectCreated:Hide',\n  /** Wildcard: any `b2:ObjectDeleted:*` sub-event. */\n  ObjectDeletedAll: 'b2:ObjectDeleted:*',\n  /** A version was permanently deleted (`b2_delete_file_version`). */\n  ObjectDeletedDelete: 'b2:ObjectDeleted:Delete',\n  /** A version was removed by a lifecycle rule. */\n  ObjectDeletedLifecycleRule: 'b2:ObjectDeleted:LifecycleRule',\n} as const\n\n/**\n * B2 event types that can trigger notifications. Derived from {@link EventType}.\n */\nexport type EventType = (typeof EventType)[keyof typeof EventType]\n\n/** A rule that defines which bucket events trigger webhook notifications and where they are sent. */\nexport interface EventNotificationRule {\n  /** Event types that trigger this notification rule. */\n  readonly eventTypes: readonly EventType[]\n  /** Whether this rule is actively sending notifications. */\n  readonly isEnabled: boolean\n  /** Whether B2 has suspended this rule due to delivery failures. */\n  readonly isSuspended: boolean\n  /** Unique name identifying this rule within the bucket. */\n  readonly name: string\n  /** Only events for objects with this name prefix trigger the rule. Empty string matches all objects. */\n  readonly objectNamePrefix: string\n  /** Reason for suspension, or empty string if not suspended. */\n  readonly suspensionReason: string\n  /** Webhook target configuration. */\n  readonly targetConfiguration: {\n    /** Target type (e.g., `'url'` for webhook delivery). */\n    readonly targetType: string\n    /** Webhook URL that receives the event notifications. */\n    readonly url: string\n    /** Optional HMAC-SHA256 secret used to sign notification payloads for verification. */\n    readonly hmacSha256SigningSecret?: string\n    /** Optional custom headers included in webhook requests. */\n    readonly customHeaders?: Record<string, string>\n  }\n}\n\n/** Request parameters for the `b2_get_bucket_notification_rules` API call. */\nexport interface GetBucketNotificationRulesRequest {\n  /** Bucket to get notification rules for. */\n  readonly bucketId: BucketId\n}\n\n/** Response from the `b2_get_bucket_notification_rules` API call. */\nexport interface GetBucketNotificationRulesResponse {\n  /** Bucket these rules belong to. */\n  readonly bucketId: BucketId\n  /** Array of event notification rules configured on the bucket. */\n  readonly eventNotificationRules: readonly EventNotificationRule[]\n}\n\n/**\n * Request parameters for the `b2_set_bucket_notification_rules` API call.\n * Replaces all existing notification rules on the bucket.\n */\nexport interface SetBucketNotificationRulesRequest {\n  /** Bucket to set notification rules on. */\n  readonly bucketId: BucketId\n  /** Notification rules to apply. Replaces all existing rules. */\n  readonly eventNotificationRules: readonly EventNotificationRule[]\n}\n\n/** Response from the `b2_set_bucket_notification_rules` API call. Same shape as the get response. */\nexport type SetBucketNotificationRulesResponse = GetBucketNotificationRulesResponse\n"],"names":[],"mappings":";;AAuBO,MAAM,YAAY;AAAA;AAAA,EAEvB,kBAAkB;AAAA;AAAA,EAElB,qBAAqB;AAAA;AAAA,EAErB,8BAA8B;AAAA;AAAA,EAE9B,mBAAmB;AAAA;AAAA,EAEnB,sBAAsB;AAAA;AAAA,EAEtB,mBAAmB;AAAA;AAAA,EAEnB,kBAAkB;AAAA;AAAA,EAElB,qBAAqB;AAAA;AAAA,EAErB,4BAA4B;AAC9B;;"}
+{"version":3,"file":"notifications.cjs","names":[],"sources":["../../src/types/notifications.ts"],"sourcesContent":["import type { BucketId } from './ids.ts'\n\n/**\n * Named constants for the B2 event types that can trigger notifications.\n *\n * Wildcard variants (`ObjectCreatedAll`, `ObjectDeletedAll`) subscribe to\n * every sub-event in their category.\n *\n * @example\n * ```ts\n * await bucket.setNotificationRules([\n *   {\n *     name: 'all-uploads',\n *     eventTypes: [EventType.ObjectCreatedAll],\n *     isEnabled: true,\n *     isSuspended: false,\n *     objectNamePrefix: '',\n *     suspensionReason: '',\n *     targetConfiguration: { targetType: 'url', url: 'https://example.com/webhook' },\n *   },\n * ])\n * ```\n */\nexport const EventType = {\n  /** Wildcard: any `b2:ObjectCreated:*` sub-event. */\n  ObjectCreatedAll: 'b2:ObjectCreated:*',\n  /** A small-file upload (`b2_upload_file`). */\n  ObjectCreatedUpload: 'b2:ObjectCreated:Upload',\n  /** A multipart upload completed (`b2_finish_large_file`). */\n  ObjectCreatedMultipartUpload: 'b2:ObjectCreated:MultipartUpload',\n  /** A server-side copy (`b2_copy_file` or `b2_copy_part`). */\n  ObjectCreatedCopy: 'b2:ObjectCreated:Copy',\n  /** A replica delivered via cross-region replication. */\n  ObjectCreatedReplica: 'b2:ObjectCreated:Replica',\n  /** A hide marker was created (`b2_hide_file`). */\n  ObjectCreatedHide: 'b2:ObjectCreated:Hide',\n  /** Wildcard: any `b2:ObjectDeleted:*` sub-event. */\n  ObjectDeletedAll: 'b2:ObjectDeleted:*',\n  /** A version was permanently deleted (`b2_delete_file_version`). */\n  ObjectDeletedDelete: 'b2:ObjectDeleted:Delete',\n  /** A version was removed by a lifecycle rule. */\n  ObjectDeletedLifecycleRule: 'b2:ObjectDeleted:LifecycleRule',\n} as const\n\n/**\n * B2 event types that can trigger notifications. Derived from {@link EventType}.\n */\nexport type EventType = (typeof EventType)[keyof typeof EventType]\n\n/** A rule that defines which bucket events trigger webhook notifications and where they are sent. */\nexport interface EventNotificationRule {\n  /** Event types that trigger this notification rule. */\n  readonly eventTypes: readonly EventType[]\n  /** Whether this rule is actively sending notifications. */\n  readonly isEnabled: boolean\n  /** Whether B2 has suspended this rule due to delivery failures. */\n  readonly isSuspended: boolean\n  /** Unique name identifying this rule within the bucket. */\n  readonly name: string\n  /** Only events for objects with this name prefix trigger the rule. Empty string matches all objects. */\n  readonly objectNamePrefix: string\n  /** Reason for suspension, or empty string if not suspended. */\n  readonly suspensionReason: string\n  /** Webhook target configuration. */\n  readonly targetConfiguration: {\n    /** Target type (e.g., `'url'` for webhook delivery). */\n    readonly targetType: string\n    /** Webhook URL that receives the event notifications. */\n    readonly url: string\n    /** Optional HMAC-SHA256 secret used to sign notification payloads for verification. */\n    readonly hmacSha256SigningSecret?: string\n    /** Optional custom headers included in webhook requests. */\n    readonly customHeaders?: Record<string, string>\n  }\n}\n\n/** Request parameters for the `b2_get_bucket_notification_rules` API call. */\nexport interface GetBucketNotificationRulesRequest {\n  /** Bucket to get notification rules for. */\n  readonly bucketId: BucketId\n}\n\n/** Response from the `b2_get_bucket_notification_rules` API call. */\nexport interface GetBucketNotificationRulesResponse {\n  /** Bucket these rules belong to. */\n  readonly bucketId: BucketId\n  /** Array of event notification rules configured on the bucket. */\n  readonly eventNotificationRules: readonly EventNotificationRule[]\n}\n\n/**\n * Request parameters for the `b2_set_bucket_notification_rules` API call.\n * Replaces all existing notification rules on the bucket.\n */\nexport interface SetBucketNotificationRulesRequest {\n  /** Bucket to set notification rules on. */\n  readonly bucketId: BucketId\n  /** Notification rules to apply. Replaces all existing rules. */\n  readonly eventNotificationRules: readonly EventNotificationRule[]\n}\n\n/** Response from the `b2_set_bucket_notification_rules` API call. Same shape as the get response. */\nexport type SetBucketNotificationRulesResponse = GetBucketNotificationRulesResponse\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAuBA,IAAa,YAAY;;CAEvB,kBAAkB;;CAElB,qBAAqB;;CAErB,8BAA8B;;CAE9B,mBAAmB;;CAEnB,sBAAsB;;CAEtB,mBAAmB;;CAEnB,kBAAkB;;CAElB,qBAAqB;;CAErB,4BAA4B;AAC9B"}

package/dist/types/notifications.js

@@ -1,24 +1,46 @@
-const EventType = {
-  /** Wildcard: any `b2:ObjectCreated:*` sub-event. */
-  ObjectCreatedAll: "b2:ObjectCreated:*",
-  /** A small-file upload (`b2_upload_file`). */
-  ObjectCreatedUpload: "b2:ObjectCreated:Upload",
-  /** A multipart upload completed (`b2_finish_large_file`). */
-  ObjectCreatedMultipartUpload: "b2:ObjectCreated:MultipartUpload",
-  /** A server-side copy (`b2_copy_file` or `b2_copy_part`). */
-  ObjectCreatedCopy: "b2:ObjectCreated:Copy",
-  /** A replica delivered via cross-region replication. */
-  ObjectCreatedReplica: "b2:ObjectCreated:Replica",
-  /** A hide marker was created (`b2_hide_file`). */
-  ObjectCreatedHide: "b2:ObjectCreated:Hide",
-  /** Wildcard: any `b2:ObjectDeleted:*` sub-event. */
-  ObjectDeletedAll: "b2:ObjectDeleted:*",
-  /** A version was permanently deleted (`b2_delete_file_version`). */
-  ObjectDeletedDelete: "b2:ObjectDeleted:Delete",
-  /** A version was removed by a lifecycle rule. */
-  ObjectDeletedLifecycleRule: "b2:ObjectDeleted:LifecycleRule"
+//#region src/types/notifications.ts
+/**
+* Named constants for the B2 event types that can trigger notifications.
+*
+* Wildcard variants (`ObjectCreatedAll`, `ObjectDeletedAll`) subscribe to
+* every sub-event in their category.
+*
+* @example
+* ```ts
+* await bucket.setNotificationRules([
+*   {
+*     name: 'all-uploads',
+*     eventTypes: [EventType.ObjectCreatedAll],
+*     isEnabled: true,
+*     isSuspended: false,
+*     objectNamePrefix: '',
+*     suspensionReason: '',
+*     targetConfiguration: { targetType: 'url', url: 'https://example.com/webhook' },
+*   },
+* ])
+* ```
+*/
+var EventType = {
+	/** Wildcard: any `b2:ObjectCreated:*` sub-event. */
+	ObjectCreatedAll: "b2:ObjectCreated:*",
+	/** A small-file upload (`b2_upload_file`). */
+	ObjectCreatedUpload: "b2:ObjectCreated:Upload",
+	/** A multipart upload completed (`b2_finish_large_file`). */
+	ObjectCreatedMultipartUpload: "b2:ObjectCreated:MultipartUpload",
+	/** A server-side copy (`b2_copy_file` or `b2_copy_part`). */
+	ObjectCreatedCopy: "b2:ObjectCreated:Copy",
+	/** A replica delivered via cross-region replication. */
+	ObjectCreatedReplica: "b2:ObjectCreated:Replica",
+	/** A hide marker was created (`b2_hide_file`). */
+	ObjectCreatedHide: "b2:ObjectCreated:Hide",
+	/** Wildcard: any `b2:ObjectDeleted:*` sub-event. */
+	ObjectDeletedAll: "b2:ObjectDeleted:*",
+	/** A version was permanently deleted (`b2_delete_file_version`). */
+	ObjectDeletedDelete: "b2:ObjectDeleted:Delete",
+	/** A version was removed by a lifecycle rule. */
+	ObjectDeletedLifecycleRule: "b2:ObjectDeleted:LifecycleRule"
 };
-export {
-  EventType
-};
-//# sourceMappingURL=notifications.js.map
+//#endregion
+export { EventType };
+
+//# sourceMappingURL=notifications.js.map

package/dist/types/notifications.js.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.js","sources":["../../src/types/notifications.ts"],"sourcesContent":["import type { BucketId } from './ids.ts'\n\n/**\n * Named constants for the B2 event types that can trigger notifications.\n *\n * Wildcard variants (`ObjectCreatedAll`, `ObjectDeletedAll`) subscribe to\n * every sub-event in their category.\n *\n * @example\n * ```ts\n * await bucket.setNotificationRules([\n *   {\n *     name: 'all-uploads',\n *     eventTypes: [EventType.ObjectCreatedAll],\n *     isEnabled: true,\n *     isSuspended: false,\n *     objectNamePrefix: '',\n *     suspensionReason: '',\n *     targetConfiguration: { targetType: 'url', url: 'https://example.com/webhook' },\n *   },\n * ])\n * ```\n */\nexport const EventType = {\n  /** Wildcard: any `b2:ObjectCreated:*` sub-event. */\n  ObjectCreatedAll: 'b2:ObjectCreated:*',\n  /** A small-file upload (`b2_upload_file`). */\n  ObjectCreatedUpload: 'b2:ObjectCreated:Upload',\n  /** A multipart upload completed (`b2_finish_large_file`). */\n  ObjectCreatedMultipartUpload: 'b2:ObjectCreated:MultipartUpload',\n  /** A server-side copy (`b2_copy_file` or `b2_copy_part`). */\n  ObjectCreatedCopy: 'b2:ObjectCreated:Copy',\n  /** A replica delivered via cross-region replication. */\n  ObjectCreatedReplica: 'b2:ObjectCreated:Replica',\n  /** A hide marker was created (`b2_hide_file`). */\n  ObjectCreatedHide: 'b2:ObjectCreated:Hide',\n  /** Wildcard: any `b2:ObjectDeleted:*` sub-event. */\n  ObjectDeletedAll: 'b2:ObjectDeleted:*',\n  /** A version was permanently deleted (`b2_delete_file_version`). */\n  ObjectDeletedDelete: 'b2:ObjectDeleted:Delete',\n  /** A version was removed by a lifecycle rule. */\n  ObjectDeletedLifecycleRule: 'b2:ObjectDeleted:LifecycleRule',\n} as const\n\n/**\n * B2 event types that can trigger notifications. Derived from {@link EventType}.\n */\nexport type EventType = (typeof EventType)[keyof typeof EventType]\n\n/** A rule that defines which bucket events trigger webhook notifications and where they are sent. */\nexport interface EventNotificationRule {\n  /** Event types that trigger this notification rule. */\n  readonly eventTypes: readonly EventType[]\n  /** Whether this rule is actively sending notifications. */\n  readonly isEnabled: boolean\n  /** Whether B2 has suspended this rule due to delivery failures. */\n  readonly isSuspended: boolean\n  /** Unique name identifying this rule within the bucket. */\n  readonly name: string\n  /** Only events for objects with this name prefix trigger the rule. Empty string matches all objects. */\n  readonly objectNamePrefix: string\n  /** Reason for suspension, or empty string if not suspended. */\n  readonly suspensionReason: string\n  /** Webhook target configuration. */\n  readonly targetConfiguration: {\n    /** Target type (e.g., `'url'` for webhook delivery). */\n    readonly targetType: string\n    /** Webhook URL that receives the event notifications. */\n    readonly url: string\n    /** Optional HMAC-SHA256 secret used to sign notification payloads for verification. */\n    readonly hmacSha256SigningSecret?: string\n    /** Optional custom headers included in webhook requests. */\n    readonly customHeaders?: Record<string, string>\n  }\n}\n\n/** Request parameters for the `b2_get_bucket_notification_rules` API call. */\nexport interface GetBucketNotificationRulesRequest {\n  /** Bucket to get notification rules for. */\n  readonly bucketId: BucketId\n}\n\n/** Response from the `b2_get_bucket_notification_rules` API call. */\nexport interface GetBucketNotificationRulesResponse {\n  /** Bucket these rules belong to. */\n  readonly bucketId: BucketId\n  /** Array of event notification rules configured on the bucket. */\n  readonly eventNotificationRules: readonly EventNotificationRule[]\n}\n\n/**\n * Request parameters for the `b2_set_bucket_notification_rules` API call.\n * Replaces all existing notification rules on the bucket.\n */\nexport interface SetBucketNotificationRulesRequest {\n  /** Bucket to set notification rules on. */\n  readonly bucketId: BucketId\n  /** Notification rules to apply. Replaces all existing rules. */\n  readonly eventNotificationRules: readonly EventNotificationRule[]\n}\n\n/** Response from the `b2_set_bucket_notification_rules` API call. Same shape as the get response. */\nexport type SetBucketNotificationRulesResponse = GetBucketNotificationRulesResponse\n"],"names":[],"mappings":"AAuBO,MAAM,YAAY;AAAA;AAAA,EAEvB,kBAAkB;AAAA;AAAA,EAElB,qBAAqB;AAAA;AAAA,EAErB,8BAA8B;AAAA;AAAA,EAE9B,mBAAmB;AAAA;AAAA,EAEnB,sBAAsB;AAAA;AAAA,EAEtB,mBAAmB;AAAA;AAAA,EAEnB,kBAAkB;AAAA;AAAA,EAElB,qBAAqB;AAAA;AAAA,EAErB,4BAA4B;AAC9B;"}
+{"version":3,"file":"notifications.js","names":[],"sources":["../../src/types/notifications.ts"],"sourcesContent":["import type { BucketId } from './ids.ts'\n\n/**\n * Named constants for the B2 event types that can trigger notifications.\n *\n * Wildcard variants (`ObjectCreatedAll`, `ObjectDeletedAll`) subscribe to\n * every sub-event in their category.\n *\n * @example\n * ```ts\n * await bucket.setNotificationRules([\n *   {\n *     name: 'all-uploads',\n *     eventTypes: [EventType.ObjectCreatedAll],\n *     isEnabled: true,\n *     isSuspended: false,\n *     objectNamePrefix: '',\n *     suspensionReason: '',\n *     targetConfiguration: { targetType: 'url', url: 'https://example.com/webhook' },\n *   },\n * ])\n * ```\n */\nexport const EventType = {\n  /** Wildcard: any `b2:ObjectCreated:*` sub-event. */\n  ObjectCreatedAll: 'b2:ObjectCreated:*',\n  /** A small-file upload (`b2_upload_file`). */\n  ObjectCreatedUpload: 'b2:ObjectCreated:Upload',\n  /** A multipart upload completed (`b2_finish_large_file`). */\n  ObjectCreatedMultipartUpload: 'b2:ObjectCreated:MultipartUpload',\n  /** A server-side copy (`b2_copy_file` or `b2_copy_part`). */\n  ObjectCreatedCopy: 'b2:ObjectCreated:Copy',\n  /** A replica delivered via cross-region replication. */\n  ObjectCreatedReplica: 'b2:ObjectCreated:Replica',\n  /** A hide marker was created (`b2_hide_file`). */\n  ObjectCreatedHide: 'b2:ObjectCreated:Hide',\n  /** Wildcard: any `b2:ObjectDeleted:*` sub-event. */\n  ObjectDeletedAll: 'b2:ObjectDeleted:*',\n  /** A version was permanently deleted (`b2_delete_file_version`). */\n  ObjectDeletedDelete: 'b2:ObjectDeleted:Delete',\n  /** A version was removed by a lifecycle rule. */\n  ObjectDeletedLifecycleRule: 'b2:ObjectDeleted:LifecycleRule',\n} as const\n\n/**\n * B2 event types that can trigger notifications. Derived from {@link EventType}.\n */\nexport type EventType = (typeof EventType)[keyof typeof EventType]\n\n/** A rule that defines which bucket events trigger webhook notifications and where they are sent. */\nexport interface EventNotificationRule {\n  /** Event types that trigger this notification rule. */\n  readonly eventTypes: readonly EventType[]\n  /** Whether this rule is actively sending notifications. */\n  readonly isEnabled: boolean\n  /** Whether B2 has suspended this rule due to delivery failures. */\n  readonly isSuspended: boolean\n  /** Unique name identifying this rule within the bucket. */\n  readonly name: string\n  /** Only events for objects with this name prefix trigger the rule. Empty string matches all objects. */\n  readonly objectNamePrefix: string\n  /** Reason for suspension, or empty string if not suspended. */\n  readonly suspensionReason: string\n  /** Webhook target configuration. */\n  readonly targetConfiguration: {\n    /** Target type (e.g., `'url'` for webhook delivery). */\n    readonly targetType: string\n    /** Webhook URL that receives the event notifications. */\n    readonly url: string\n    /** Optional HMAC-SHA256 secret used to sign notification payloads for verification. */\n    readonly hmacSha256SigningSecret?: string\n    /** Optional custom headers included in webhook requests. */\n    readonly customHeaders?: Record<string, string>\n  }\n}\n\n/** Request parameters for the `b2_get_bucket_notification_rules` API call. */\nexport interface GetBucketNotificationRulesRequest {\n  /** Bucket to get notification rules for. */\n  readonly bucketId: BucketId\n}\n\n/** Response from the `b2_get_bucket_notification_rules` API call. */\nexport interface GetBucketNotificationRulesResponse {\n  /** Bucket these rules belong to. */\n  readonly bucketId: BucketId\n  /** Array of event notification rules configured on the bucket. */\n  readonly eventNotificationRules: readonly EventNotificationRule[]\n}\n\n/**\n * Request parameters for the `b2_set_bucket_notification_rules` API call.\n * Replaces all existing notification rules on the bucket.\n */\nexport interface SetBucketNotificationRulesRequest {\n  /** Bucket to set notification rules on. */\n  readonly bucketId: BucketId\n  /** Notification rules to apply. Replaces all existing rules. */\n  readonly eventNotificationRules: readonly EventNotificationRule[]\n}\n\n/** Response from the `b2_set_bucket_notification_rules` API call. Same shape as the get response. */\nexport type SetBucketNotificationRulesResponse = GetBucketNotificationRulesResponse\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAuBA,IAAa,YAAY;;CAEvB,kBAAkB;;CAElB,qBAAqB;;CAErB,8BAA8B;;CAE9B,mBAAmB;;CAEnB,sBAAsB;;CAEtB,mBAAmB;;CAEnB,kBAAkB;;CAElB,qBAAqB;;CAErB,4BAA4B;AAC9B"}

package/dist/types/upload.d.cts

@@ -1,4 +1,5 @@
-import { EncryptionSetting } from './encryption.js';
+import { EncryptionSetting, PublicEncryptionSetting } from './encryption.js';
+import { FileAction } from './file.js';
 import { BucketId, LargeFileId } from './ids.js';
 import { FileRetentionValue, LegalHoldValue } from './lock.js';
 /** Request parameters for the `b2_get_upload_url` API call. */
@@ -68,8 +69,41 @@ export interface StartLargeFileRequest {
     /** Optional legal hold for the file. */
     readonly legalHold?: LegalHoldValue;
 }
+/** Object Lock retention settings as returned by B2 response objects. */
+export interface ReadableFileRetention {
+    /** Whether the caller is authorized to read retention settings. */
+    readonly isClientAuthorizedToRead: boolean;
+    /** Retention settings, or null when none are set or unreadable. */
+    readonly value: FileRetentionValue | null;
+}
+/** Legal hold status as returned by B2 response objects. */
+export interface ReadableLegalHold {
+    /** Whether the caller is authorized to read legal hold status. */
+    readonly isClientAuthorizedToRead: boolean;
+    /** Legal hold value, or null when none is set or unreadable. */
+    readonly value: LegalHoldValue | null;
+}
+/** Optional metadata fields B2 may return for unfinished large-file records. */
+export interface UnfinishedLargeFileMetadata {
+    /** Action that created this unfinished file version. */
+    readonly action?: FileAction;
+    /** When present, always 0 for unfinished large files. */
+    readonly contentLength?: number;
+    /** When present, always `'none'` for unfinished large files. */
+    readonly contentSha1?: string;
+    /** When present, always null for unfinished large files. */
+    readonly contentMd5?: string | null;
+    /** Object Lock retention settings for this unfinished file, when readable. */
+    readonly fileRetention?: ReadableFileRetention;
+    /** Legal hold status for this unfinished file, when readable. */
+    readonly legalHold?: ReadableLegalHold;
+    /** Server-side encryption applied to this unfinished file. */
+    readonly serverSideEncryption?: PublicEncryptionSetting;
+    /** UTC timestamp (milliseconds) when this unfinished upload was started. */
+    readonly uploadTimestamp?: number;
+}
 /** Response from the `b2_start_large_file` API call. */
-export interface StartLargeFileResponse {
+export interface StartLargeFileResponse extends UnfinishedLargeFileMetadata {
     /** ID assigned to this large file upload. Use this to upload parts and finish the file. */
     readonly fileId: LargeFileId;
     /** Name of the file being uploaded. */
@@ -124,7 +158,7 @@ export interface UploadPartResponse {
     /** SHA-1 checksum of the uploaded part content. */
     readonly contentSha1: string;
     /** Server-side encryption applied to this part. */
-    readonly serverSideEncryption: EncryptionSetting;
+    readonly serverSideEncryption: PublicEncryptionSetting;
     /** UTC timestamp (milliseconds) when this part was uploaded. */
     readonly uploadTimestamp: number;
 }
@@ -160,13 +194,13 @@ export interface ListUnfinishedLargeFilesRequest {
     readonly bucketId: BucketId;
     /** Only return files whose names start with this prefix. */
     readonly namePrefix?: string;
-    /** File ID to start listing from (exclusive). Used for pagination. */
+    /** File ID to start listing from (inclusive). Used for pagination. */
     readonly startFileId?: LargeFileId;
     /** Maximum number of files to return. */
     readonly maxFileCount?: number;
 }
 /** Metadata for an in-progress large file upload that has not yet been finished or cancelled. */
-export interface UnfinishedLargeFile {
+export interface UnfinishedLargeFile extends UnfinishedLargeFileMetadata {
     /** ID of the large file. */
     readonly fileId: LargeFileId;
     /** Name of the file. */

package/dist/types/upload.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/types/upload.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/types/upload.js"],"names":[],"mappings":"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"}

package/dist/types/upload.d.ts

@@ -1,4 +1,5 @@
-import { EncryptionSetting } from './encryption.js';
+import { EncryptionSetting, PublicEncryptionSetting } from './encryption.js';
+import { FileAction } from './file.js';
 import { BucketId, LargeFileId } from './ids.js';
 import { FileRetentionValue, LegalHoldValue } from './lock.js';
 /** Request parameters for the `b2_get_upload_url` API call. */
@@ -68,8 +69,41 @@ export interface StartLargeFileRequest {
     /** Optional legal hold for the file. */
     readonly legalHold?: LegalHoldValue;
 }
+/** Object Lock retention settings as returned by B2 response objects. */
+export interface ReadableFileRetention {
+    /** Whether the caller is authorized to read retention settings. */
+    readonly isClientAuthorizedToRead: boolean;
+    /** Retention settings, or null when none are set or unreadable. */
+    readonly value: FileRetentionValue | null;
+}
+/** Legal hold status as returned by B2 response objects. */
+export interface ReadableLegalHold {
+    /** Whether the caller is authorized to read legal hold status. */
+    readonly isClientAuthorizedToRead: boolean;
+    /** Legal hold value, or null when none is set or unreadable. */
+    readonly value: LegalHoldValue | null;
+}
+/** Optional metadata fields B2 may return for unfinished large-file records. */
+export interface UnfinishedLargeFileMetadata {
+    /** Action that created this unfinished file version. */
+    readonly action?: FileAction;
+    /** When present, always 0 for unfinished large files. */
+    readonly contentLength?: number;
+    /** When present, always `'none'` for unfinished large files. */
+    readonly contentSha1?: string;
+    /** When present, always null for unfinished large files. */
+    readonly contentMd5?: string | null;
+    /** Object Lock retention settings for this unfinished file, when readable. */
+    readonly fileRetention?: ReadableFileRetention;
+    /** Legal hold status for this unfinished file, when readable. */
+    readonly legalHold?: ReadableLegalHold;
+    /** Server-side encryption applied to this unfinished file. */
+    readonly serverSideEncryption?: PublicEncryptionSetting;
+    /** UTC timestamp (milliseconds) when this unfinished upload was started. */
+    readonly uploadTimestamp?: number;
+}
 /** Response from the `b2_start_large_file` API call. */
-export interface StartLargeFileResponse {
+export interface StartLargeFileResponse extends UnfinishedLargeFileMetadata {
     /** ID assigned to this large file upload. Use this to upload parts and finish the file. */
     readonly fileId: LargeFileId;
     /** Name of the file being uploaded. */
@@ -124,7 +158,7 @@ export interface UploadPartResponse {
     /** SHA-1 checksum of the uploaded part content. */
     readonly contentSha1: string;
     /** Server-side encryption applied to this part. */
-    readonly serverSideEncryption: EncryptionSetting;
+    readonly serverSideEncryption: PublicEncryptionSetting;
     /** UTC timestamp (milliseconds) when this part was uploaded. */
     readonly uploadTimestamp: number;
 }
@@ -160,13 +194,13 @@ export interface ListUnfinishedLargeFilesRequest {
     readonly bucketId: BucketId;
     /** Only return files whose names start with this prefix. */
     readonly namePrefix?: string;
-    /** File ID to start listing from (exclusive). Used for pagination. */
+    /** File ID to start listing from (inclusive). Used for pagination. */
     readonly startFileId?: LargeFileId;
     /** Maximum number of files to return. */
     readonly maxFileCount?: number;
 }
 /** Metadata for an in-progress large file upload that has not yet been finished or cancelled. */
-export interface UnfinishedLargeFile {
+export interface UnfinishedLargeFile extends UnfinishedLargeFileMetadata {
     /** ID of the large file. */
     readonly fileId: LargeFileId;
     /** Name of the file. */

package/dist/types/upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/types/upload.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/types/upload.js"],"names":[],"mappings":"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"}

package/dist/upload/abort-scope.cjs

@@ -0,0 +1,91 @@
+//#region src/upload/abort-scope.ts
+/**
+* Creates an abort scope linked to an optional upstream signal.
+* Task failures can abort the same scope so sibling tasks stop promptly.
+* @param upstream - Caller-provided abort signal, if any.
+*
+* @returns A linked abort scope.
+*/
+function createAbortScope(upstream) {
+	const controller = new AbortController();
+	let upstreamAbort;
+	const abort = (reason) => {
+		if (!controller.signal.aborted) controller.abort(reason);
+	};
+	if (upstream?.aborted === true) abort(upstream.reason);
+	else if (upstream !== void 0) {
+		upstreamAbort = () => abort(upstream.reason);
+		upstream.addEventListener("abort", upstreamAbort, { once: true });
+	}
+	return {
+		signal: controller.signal,
+		abort,
+		dispose() {
+			if (upstreamAbort !== void 0) upstream?.removeEventListener("abort", upstreamAbort);
+		}
+	};
+}
+/**
+* Throws the abort reason or first task rejection from a settled task set.
+* @param settled - Results from `Promise.allSettled`.
+* @param abortScope - Scope that coordinated the tasks.
+*
+* @throws The abort reason or first rejected task reason.
+*/
+function throwRejectedOrAbortReason(settled, abortScope) {
+	const rejected = settled.find((result) => result.status === "rejected");
+	if (rejected === void 0) return;
+	if (abortScope.signal.aborted && abortScope.signal.reason !== void 0) throw abortScope.signal.reason;
+	/* v8 ignore next -- Defensive fallback for unexpected task rejections outside the abort scope. */
+	throw rejected.reason;
+}
+/**
+* Returns the observable reason for an aborted signal.
+* @param signal - Aborted signal to inspect.
+*
+* @returns The signal's reason, or a standard AbortError when the runtime did not provide one.
+*/
+function abortReason(signal) {
+	return signal.reason ?? new DOMException("Aborted", "AbortError");
+}
+/**
+* Races a request promise against an abort signal.
+*
+* The underlying request must still receive the same signal so transports can
+* cancel their network work. This helper makes callers stop waiting promptly
+* even when a test double or custom transport ignores the signal.
+*
+* @param promise - Request promise to observe.
+* @param signal - Signal that should stop waiting for the request.
+*
+* @returns The request result if it settles before the signal aborts.
+*
+* @throws The abort reason if the signal aborts first, or the request rejection.
+*/
+async function raceWithAbort(promise, signal) {
+	if (signal.aborted) {
+		promise.catch(() => {});
+		throw abortReason(signal);
+	}
+	let removeAbortListener;
+	const abort = new Promise((_, reject) => {
+		const onAbort = () => reject(abortReason(signal));
+		signal.addEventListener("abort", onAbort, { once: true });
+		removeAbortListener = () => signal.removeEventListener("abort", onAbort);
+	});
+	try {
+		return await Promise.race([promise, abort]);
+	} catch (err) {
+		if (signal.aborted) promise.catch(() => {});
+		throw err;
+	} finally {
+		removeAbortListener?.();
+	}
+}
+//#endregion
+exports.abortReason = abortReason;
+exports.createAbortScope = createAbortScope;
+exports.raceWithAbort = raceWithAbort;
+exports.throwRejectedOrAbortReason = throwRejectedOrAbortReason;
+
+//# sourceMappingURL=abort-scope.cjs.map

package/dist/upload/abort-scope.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-scope.cjs","names":[],"sources":["../../src/upload/abort-scope.ts"],"sourcesContent":["/** Shared abort scope for multipart work that fans out into concurrent tasks. */\nexport interface AbortScope {\n  /** Signal linked to the caller signal and to task-level failures. */\n  readonly signal: AbortSignal\n  /** Abort the scope if it has not already been aborted. */\n  abort(reason: unknown): void\n  /** Detach any upstream abort listener. */\n  dispose(): void\n}\n\n/**\n * Creates an abort scope linked to an optional upstream signal.\n * Task failures can abort the same scope so sibling tasks stop promptly.\n * @param upstream - Caller-provided abort signal, if any.\n *\n * @returns A linked abort scope.\n */\nexport function createAbortScope(upstream: AbortSignal | undefined): AbortScope {\n  const controller = new AbortController()\n  let upstreamAbort: (() => void) | undefined\n  const abort = (reason: unknown): void => {\n    if (!controller.signal.aborted) controller.abort(reason)\n  }\n\n  if (upstream?.aborted === true) {\n    abort(upstream.reason)\n  } else if (upstream !== undefined) {\n    upstreamAbort = () => abort(upstream.reason)\n    upstream.addEventListener('abort', upstreamAbort, { once: true })\n  }\n\n  return {\n    signal: controller.signal,\n    abort,\n    dispose() {\n      if (upstreamAbort !== undefined) upstream?.removeEventListener('abort', upstreamAbort)\n    },\n  }\n}\n\n/**\n * Throws the abort reason or first task rejection from a settled task set.\n * @param settled - Results from `Promise.allSettled`.\n * @param abortScope - Scope that coordinated the tasks.\n *\n * @throws The abort reason or first rejected task reason.\n */\nexport function throwRejectedOrAbortReason(\n  settled: readonly PromiseSettledResult<unknown>[],\n  abortScope: AbortScope,\n): void {\n  const rejected = settled.find(\n    (result): result is PromiseRejectedResult => result.status === 'rejected',\n  )\n  if (rejected === undefined) return\n  if (abortScope.signal.aborted && abortScope.signal.reason !== undefined) {\n    throw abortScope.signal.reason\n  }\n  /* v8 ignore next -- Defensive fallback for unexpected task rejections outside the abort scope. */\n  throw rejected.reason\n}\n\n/**\n * Returns the observable reason for an aborted signal.\n * @param signal - Aborted signal to inspect.\n *\n * @returns The signal's reason, or a standard AbortError when the runtime did not provide one.\n */\nexport function abortReason(signal: AbortSignal): unknown {\n  return signal.reason ?? new DOMException('Aborted', 'AbortError')\n}\n\n/**\n * Races a request promise against an abort signal.\n *\n * The underlying request must still receive the same signal so transports can\n * cancel their network work. This helper makes callers stop waiting promptly\n * even when a test double or custom transport ignores the signal.\n *\n * @param promise - Request promise to observe.\n * @param signal - Signal that should stop waiting for the request.\n *\n * @returns The request result if it settles before the signal aborts.\n *\n * @throws The abort reason if the signal aborts first, or the request rejection.\n */\nexport async function raceWithAbort<T>(promise: Promise<T>, signal: AbortSignal): Promise<T> {\n  if (signal.aborted) {\n    promise.catch(() => {})\n    throw abortReason(signal)\n  }\n\n  let removeAbortListener: (() => void) | undefined\n  const abort = new Promise<never>((_, reject) => {\n    const onAbort = (): void => reject(abortReason(signal))\n    signal.addEventListener('abort', onAbort, { once: true })\n    removeAbortListener = () => signal.removeEventListener('abort', onAbort)\n  })\n\n  try {\n    return await Promise.race([promise, abort])\n  } catch (err) {\n    if (signal.aborted) promise.catch(() => {})\n    throw err\n  } finally {\n    removeAbortListener?.()\n  }\n}\n"],"mappings":";;;;;;;;AAiBA,SAAgB,iBAAiB,UAA+C;CAC9E,MAAM,aAAa,IAAI,gBAAgB;CACvC,IAAI;CACJ,MAAM,SAAS,WAA0B;EACvC,IAAI,CAAC,WAAW,OAAO,SAAS,WAAW,MAAM,MAAM;CACzD;CAEA,IAAI,UAAU,YAAY,MACxB,MAAM,SAAS,MAAM;MAChB,IAAI,aAAa,KAAA,GAAW;EACjC,sBAAsB,MAAM,SAAS,MAAM;EAC3C,SAAS,iBAAiB,SAAS,eAAe,EAAE,MAAM,KAAK,CAAC;CAClE;CAEA,OAAO;EACL,QAAQ,WAAW;EACnB;EACA,UAAU;GACR,IAAI,kBAAkB,KAAA,GAAW,UAAU,oBAAoB,SAAS,aAAa;EACvF;CACF;AACF;;;;;;;;AASA,SAAgB,2BACd,SACA,YACM;CACN,MAAM,WAAW,QAAQ,MACtB,WAA4C,OAAO,WAAW,UACjE;CACA,IAAI,aAAa,KAAA,GAAW;CAC5B,IAAI,WAAW,OAAO,WAAW,WAAW,OAAO,WAAW,KAAA,GAC5D,MAAM,WAAW,OAAO;;CAG1B,MAAM,SAAS;AACjB;;;;;;;AAQA,SAAgB,YAAY,QAA8B;CACxD,OAAO,OAAO,UAAU,IAAI,aAAa,WAAW,YAAY;AAClE;;;;;;;;;;;;;;;AAgBA,eAAsB,cAAiB,SAAqB,QAAiC;CAC3F,IAAI,OAAO,SAAS;EAClB,QAAQ,YAAY,CAAC,CAAC;EACtB,MAAM,YAAY,MAAM;CAC1B;CAEA,IAAI;CACJ,MAAM,QAAQ,IAAI,SAAgB,GAAG,WAAW;EAC9C,MAAM,gBAAsB,OAAO,YAAY,MAAM,CAAC;EACtD,OAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;EACxD,4BAA4B,OAAO,oBAAoB,SAAS,OAAO;CACzE,CAAC;CAED,IAAI;EACF,OAAO,MAAM,QAAQ,KAAK,CAAC,SAAS,KAAK,CAAC;CAC5C,SAAS,KAAK;EACZ,IAAI,OAAO,SAAS,QAAQ,YAAY,CAAC,CAAC;EAC1C,MAAM;CACR,UAAU;EACR,sBAAsB;CACxB;AACF"}

package/dist/upload/abort-scope.d.cts

@@ -0,0 +1,48 @@
+/** Shared abort scope for multipart work that fans out into concurrent tasks. */
+export interface AbortScope {
+    /** Signal linked to the caller signal and to task-level failures. */
+    readonly signal: AbortSignal;
+    /** Abort the scope if it has not already been aborted. */
+    abort(reason: unknown): void;
+    /** Detach any upstream abort listener. */
+    dispose(): void;
+}
+/**
+ * Creates an abort scope linked to an optional upstream signal.
+ * Task failures can abort the same scope so sibling tasks stop promptly.
+ * @param upstream - Caller-provided abort signal, if any.
+ *
+ * @returns A linked abort scope.
+ */
+export declare function createAbortScope(upstream: AbortSignal | undefined): AbortScope;
+/**
+ * Throws the abort reason or first task rejection from a settled task set.
+ * @param settled - Results from `Promise.allSettled`.
+ * @param abortScope - Scope that coordinated the tasks.
+ *
+ * @throws The abort reason or first rejected task reason.
+ */
+export declare function throwRejectedOrAbortReason(settled: readonly PromiseSettledResult<unknown>[], abortScope: AbortScope): void;
+/**
+ * Returns the observable reason for an aborted signal.
+ * @param signal - Aborted signal to inspect.
+ *
+ * @returns The signal's reason, or a standard AbortError when the runtime did not provide one.
+ */
+export declare function abortReason(signal: AbortSignal): unknown;
+/**
+ * Races a request promise against an abort signal.
+ *
+ * The underlying request must still receive the same signal so transports can
+ * cancel their network work. This helper makes callers stop waiting promptly
+ * even when a test double or custom transport ignores the signal.
+ *
+ * @param promise - Request promise to observe.
+ * @param signal - Signal that should stop waiting for the request.
+ *
+ * @returns The request result if it settles before the signal aborts.
+ *
+ * @throws The abort reason if the signal aborts first, or the request rejection.
+ */
+export declare function raceWithAbort<T>(promise: Promise<T>, signal: AbortSignal): Promise<T>;
+//# sourceMappingURL=abort-scope.d.ts.map

package/dist/upload/abort-scope.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-scope.d.ts","sourceRoot":"","sources":["../../src/upload/abort-scope.js"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,0DAA0D;IAC1D,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,0CAA0C;IAC1C,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,GAAG,UAAU,CAqB9E;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,SAAS,oBAAoB,CAAC,OAAO,CAAC,EAAE,EACjD,UAAU,EAAE,UAAU,GACrB,IAAI,CAUN;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAExD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAqB3F"}