@backblaze-labs/b2-sdk 0.1.0 → 0.2.0

package/dist/upload/large.js.map

@@ -1 +1 @@
-{"version":3,"file":"large.js","sources":["../../src/upload/large.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport type { RawClient } from '../raw/index.ts'\nimport { IncrementalSha1 } from '../streams/hash.ts'\nimport type { ProgressListener } from '../streams/progress.ts'\nimport { ProgressTracker } from '../streams/progress.ts'\nimport type { ContentSource } from '../streams/source.ts'\nimport type { EncryptionSetting } from '../types/encryption.ts'\nimport type { FileVersion } from '../types/file.ts'\nimport type { BucketId, LargeFileId } from '../types/ids.ts'\nimport type { FileRetentionValue, LegalHoldValue } from '../types/lock.ts'\nimport { DEFAULT_CONTENT_TYPE, DEFAULT_TRANSFER_CONCURRENCY } from '../util/defaults.ts'\nimport { type RangePlan, planRanges } from '../util/plan-ranges.ts'\nimport { cancelLargeFileBestEffort } from './cancel.ts'\nimport { Semaphore } from './concurrency.ts'\nimport { collectPartSha1s, findResumeCandidate } from './resume.ts'\n\n/** Options for uploading a large file via the multipart protocol. */\nexport interface UploadLargeFileOptions {\n  /** Target bucket for the upload. */\n  readonly bucketId: BucketId\n  /** Full B2 file name including any path prefix. */\n  readonly fileName: string\n  /**\n   * Content to upload. Sliceable sources ({@link BufferSource},\n   * {@link BlobSource}) use the parallel-parts path. Non-sliceable\n   * sources ({@link StreamSource}) fall back to a sequential read path\n   * — one part at a time, concurrency forced to 1 — so callers can\n   * stream a multi-GB file without buffering the whole payload in\n   * memory. The `resume` / `resumeFileId` options require a sliceable\n   * source; they throw on a `StreamSource`.\n   */\n  readonly source: ContentSource\n  /** MIME type. Defaults to `b2/x-auto` for server-side detection. */\n  readonly contentType?: string\n  /** Custom file info key/value pairs stored with the file. */\n  readonly fileInfo?: Record<string, string>\n  /** Server-side encryption settings applied to each part. */\n  readonly serverSideEncryption?: EncryptionSetting\n  /** File retention policy applied at upload time. */\n  readonly fileRetention?: FileRetentionValue\n  /** Legal hold status applied at upload time. */\n  readonly legalHold?: LegalHoldValue\n  /** Size of each part in bytes. Defaults to the account's recommended part size. */\n  readonly partSize?: number\n  /** Maximum number of parts uploaded in parallel. Defaults to 4. */\n  readonly concurrency?: number\n  /** Callback invoked with upload progress updates. */\n  readonly onProgress?: ProgressListener\n  /** Signal to abort the upload. Triggers cancellation of the large file. */\n  readonly signal?: AbortSignal\n  /**\n   * If true, look for an unfinished large file with the same bucket and file name\n   * and skip parts whose locally-recomputed SHA-1 matches the server's.\n   */\n  readonly resume?: boolean\n  /**\n   * Explicit large file ID to resume into. Overrides {@link resume} discovery\n   * but the local `partSize` must still match the server's plan.\n   */\n  readonly resumeFileId?: LargeFileId\n}\n\n/**\n * Uploads a file using the B2 multipart (large file) protocol.\n *\n * The source is sliced into parts and uploaded concurrently via\n * `b2_upload_part`. This is appropriate for files larger than the recommended\n * part size. For smaller files, use {@link uploadSmallFile} which sends the\n * entire payload in a single request.\n *\n * On failure, the in-progress large file is cancelled on a best-effort basis.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state (tokens, URLs, upload URL pool).\n * @param options - Upload parameters including part size and concurrency.\n *\n * @returns The resulting {@link FileVersion} metadata.\n */\nexport async function uploadLargeFile(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: UploadLargeFileOptions,\n): Promise<FileVersion> {\n  const recommendedPartSize = accountInfo.getRecommendedPartSize()\n  const minPartSize = accountInfo.getAbsoluteMinimumPartSize()\n  const partSize = Math.max(options.partSize ?? recommendedPartSize, minPartSize)\n  const concurrency = options.concurrency ?? DEFAULT_TRANSFER_CONCURRENCY\n  const totalSize = options.source.size\n\n  const parts = planRanges(totalSize, partSize)\n  const fileInfo: Record<string, string> = { ...options.fileInfo }\n\n  // Construct the `b2_start_large_file` request body once so the two\n  // non-resume branches below (no `resume`, resume-but-no-candidate)\n  // can dispatch without re-spelling the conditional spreads.\n  const startLargeFileRequest = {\n    bucketId: options.bucketId,\n    fileName: options.fileName,\n    contentType: options.contentType ?? DEFAULT_CONTENT_TYPE,\n    fileInfo,\n    ...(options.serverSideEncryption !== undefined\n      ? { serverSideEncryption: options.serverSideEncryption }\n      : {}),\n    ...(options.fileRetention !== undefined ? { fileRetention: options.fileRetention } : {}),\n    ...(options.legalHold !== undefined ? { legalHold: options.legalHold } : {}),\n  }\n\n  // --- Resume discovery (M11.1) ---\n  let largeFileId: LargeFileId\n  let preUploaded: ReadonlyMap<number, string>\n\n  if (options.resumeFileId !== undefined) {\n    largeFileId = options.resumeFileId\n    preUploaded = await collectPartSha1s(raw, accountInfo, largeFileId)\n  } else if (options.resume === true) {\n    const candidate = await findResumeCandidate(\n      raw,\n      accountInfo,\n      options.bucketId,\n      options.fileName,\n    )\n    if (candidate) {\n      largeFileId = candidate.fileId\n      preUploaded = candidate.uploadedPartSha1s\n    } else {\n      const startResp = await raw.startLargeFile(\n        accountInfo.getApiUrl(),\n        accountInfo.getAuthToken(),\n        startLargeFileRequest,\n      )\n      largeFileId = startResp.fileId\n      preUploaded = new Map<number, string>()\n    }\n  } else {\n    const startResp = await raw.startLargeFile(\n      accountInfo.getApiUrl(),\n      accountInfo.getAuthToken(),\n      startLargeFileRequest,\n    )\n    largeFileId = startResp.fileId\n    preUploaded = new Map<number, string>()\n  }\n\n  const partSha1s: string[] = new Array(parts.length)\n  const tracker = new ProgressTracker(options.onProgress, totalSize, parts.length)\n  const sem = new Semaphore(concurrency)\n\n  // Non-sliceable sources (e.g. `StreamSource` wrapping a Node\n  // `Readable.toWeb`) can't be read in parallel — there's only one\n  // forward-only cursor. Resume is also impossible (no seek). Bail to a\n  // sequential read loop instead. Each part is buffered, hashed,\n  // shipped, then dropped before the next read starts, so the peak\n  // memory footprint is ~partSize bytes regardless of total file size.\n  if (!options.source.canSlice) {\n    if (options.resume === true || options.resumeFileId !== undefined) {\n      // Cancel the unfinished large file before throwing so the caller\n      // doesn't have to clean it up themselves.\n      await cancelLargeFileBestEffort(raw, accountInfo, largeFileId)\n      throw new Error(\n        'uploadLargeFile: resume is not supported on non-sliceable sources (e.g. StreamSource).',\n      )\n    }\n    try {\n      await uploadPartsSequentially(\n        raw,\n        accountInfo,\n        options,\n        largeFileId,\n        parts,\n        partSha1s,\n        tracker,\n      )\n      return await raw.finishLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {\n        fileId: largeFileId,\n        partSha1Array: partSha1s,\n      })\n    } catch (err) {\n      await cancelLargeFileBestEffort(raw, accountInfo, largeFileId)\n      throw err\n    }\n  }\n\n  try {\n    const tasks = parts.map(async (part) => {\n      await sem.acquire()\n      try {\n        options.signal?.throwIfAborted()\n\n        const partSource = options.source.slice(part.offset, part.offset + part.length)\n        const data = new Uint8Array(await partSource.toArrayBuffer())\n\n        const partSha1 = new IncrementalSha1()\n        await partSha1.update(data)\n        const sha1Hex = await partSha1.digest()\n\n        // Resume short-circuit: server already has this part with matching SHA-1\n        const serverSha1 = preUploaded.get(part.partNumber)\n        if (serverSha1 !== undefined && serverSha1 === sha1Hex) {\n          partSha1s[part.partNumber - 1] = serverSha1\n          tracker.addBytes(data.byteLength)\n          tracker.completePart()\n          return\n        }\n\n        let uploadEntry = accountInfo.checkoutPartUploadUrl(largeFileId)\n        if (!uploadEntry) {\n          const resp = await raw.getUploadPartUrl(\n            accountInfo.getApiUrl(),\n            accountInfo.getAuthToken(),\n            { fileId: largeFileId },\n          )\n          uploadEntry = { uploadUrl: resp.uploadUrl, authorizationToken: resp.authorizationToken }\n        }\n\n        try {\n          const result = await raw.uploadPart(\n            uploadEntry.uploadUrl,\n            {\n              authorization: uploadEntry.authorizationToken,\n              partNumber: part.partNumber,\n              contentLength: data.byteLength,\n              contentSha1: sha1Hex,\n              ...(options.serverSideEncryption !== undefined\n                ? { serverSideEncryption: options.serverSideEncryption }\n                : {}),\n            },\n            data,\n            options.signal,\n          )\n\n          accountInfo.returnPartUploadUrl(largeFileId, uploadEntry)\n          partSha1s[part.partNumber - 1] = result.contentSha1\n          tracker.addBytes(data.byteLength)\n          tracker.completePart()\n        } catch (err) {\n          accountInfo.evictPartUploadUrl(largeFileId, uploadEntry)\n          throw err\n        }\n      } finally {\n        sem.release()\n      }\n    })\n\n    await Promise.all(tasks)\n\n    const result = await raw.finishLargeFile(accountInfo.getApiUrl(), accountInfo.getAuthToken(), {\n      fileId: largeFileId,\n      partSha1Array: partSha1s,\n    })\n\n    return result\n  } catch (err) {\n    await cancelLargeFileBestEffort(raw, accountInfo, largeFileId)\n    throw err\n  }\n}\n\n/**\n * Sequential upload path for non-sliceable sources (`StreamSource`).\n *\n * Reads the source's `stream()` once and accumulates exactly `partSize`\n * bytes into an in-memory buffer per iteration. Each filled buffer is\n * hashed, dispatched to `b2_upload_part`, then released before the next\n * part starts — so peak memory is ~partSize regardless of file size.\n *\n * Concurrency is forced to 1 here because the stream is a single\n * forward-only cursor; the engine can't read part N+1 until part N is\n * fully consumed.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - The original `uploadLargeFile` options.\n * @param largeFileId - ID of the in-progress large file (already started).\n * @param parts - Pre-planned part layout (used for part numbers + count).\n * @param partSha1s - Output array, written in-place at index `partNumber - 1`.\n * @param tracker - Progress tracker; bytes added per chunk, part completed\n *   each time a part finishes.\n */\nasync function uploadPartsSequentially(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: UploadLargeFileOptions,\n  largeFileId: LargeFileId,\n  parts: readonly RangePlan[],\n  partSha1s: string[],\n  tracker: ProgressTracker,\n): Promise<void> {\n  const reader = options.source.stream().getReader()\n  let partNumber = 1\n  // Carry-over bytes from a previous read when the read returned more\n  // than we needed to fill one part. Kept as an array to avoid an\n  // allocation per loop iteration on a typical multi-part upload.\n  let carry: Uint8Array | null = null\n\n  try {\n    for (const planned of parts) {\n      options.signal?.throwIfAborted()\n\n      const buf = new Uint8Array(planned.length)\n      let filled = 0\n\n      if (carry !== null) {\n        const take = Math.min(carry.byteLength, buf.byteLength - filled)\n        buf.set(carry.subarray(0, take), filled)\n        filled += take\n        carry = take < carry.byteLength ? carry.subarray(take) : null\n      }\n\n      while (filled < buf.byteLength) {\n        const { done, value } = await reader.read()\n        if (done) break\n        const take = Math.min(value.byteLength, buf.byteLength - filled)\n        buf.set(value.subarray(0, take), filled)\n        filled += take\n        if (take < value.byteLength) {\n          carry = value.subarray(take)\n        }\n      }\n\n      // For the LAST part the stream may run dry mid-buffer, leaving a\n      // shorter chunk. B2 accepts a final part smaller than `partSize`.\n      const data = filled === buf.byteLength ? buf : buf.subarray(0, filled)\n      /* v8 ignore start -- defensive: only fires when the source's advertised\n         size over-reports the actual emitted byte count, which a well-behaved\n         ContentSource implementation cannot do. Kept so callers feeding the\n         engine a buggy custom stream get an actionable error rather than a\n         B2 wire-level failure. */\n      if (data.byteLength === 0) {\n        throw new Error(\n          `uploadLargeFile: source stream ended before part ${partNumber}; advertised size does not match emitted bytes.`,\n        )\n      }\n      /* v8 ignore stop */\n\n      const partSha1 = new IncrementalSha1()\n      await partSha1.update(data)\n      const sha1Hex = await partSha1.digest()\n\n      let uploadEntry = accountInfo.checkoutPartUploadUrl(largeFileId)\n      if (!uploadEntry) {\n        const resp = await raw.getUploadPartUrl(\n          accountInfo.getApiUrl(),\n          accountInfo.getAuthToken(),\n          { fileId: largeFileId },\n        )\n        uploadEntry = { uploadUrl: resp.uploadUrl, authorizationToken: resp.authorizationToken }\n      }\n\n      try {\n        const result = await raw.uploadPart(\n          uploadEntry.uploadUrl,\n          {\n            authorization: uploadEntry.authorizationToken,\n            partNumber: planned.partNumber,\n            contentLength: data.byteLength,\n            contentSha1: sha1Hex,\n            ...(options.serverSideEncryption !== undefined\n              ? { serverSideEncryption: options.serverSideEncryption }\n              : {}),\n          },\n          data,\n          options.signal,\n        )\n\n        accountInfo.returnPartUploadUrl(largeFileId, uploadEntry)\n        partSha1s[planned.partNumber - 1] = result.contentSha1\n        tracker.addBytes(data.byteLength)\n        tracker.completePart()\n      } catch (err) {\n        accountInfo.evictPartUploadUrl(largeFileId, uploadEntry)\n        throw err\n      }\n\n      partNumber++\n    }\n  } finally {\n    // Releasing the lock lets the underlying stream propagate close /\n    // error events to any upstream producer (e.g. a Node `Readable`).\n    reader.releaseLock()\n  }\n}\n"],"names":["result"],"mappings":"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"}
+{"version":3,"file":"large.js","names":[],"sources":["../../src/upload/large.ts"],"sourcesContent":["import type { AccountInfo } from '../auth/account-info.ts'\nimport type { RawClient } from '../raw/index.ts'\nimport { IncrementalSha1 } from '../streams/hash.ts'\nimport type { ProgressListener } from '../streams/progress.ts'\nimport { ProgressTracker } from '../streams/progress.ts'\nimport { type ContentSource, readNextNonEmptyStreamChunk } from '../streams/source.ts'\nimport type { BucketRetentionPolicy } from '../types/bucket.ts'\nimport type { EncryptionSetting } from '../types/encryption.ts'\nimport type { FileVersion } from '../types/file.ts'\nimport type { BucketId, LargeFileId } from '../types/ids.ts'\nimport type { FileRetentionValue, LegalHoldValue } from '../types/lock.ts'\nimport { DEFAULT_CONTENT_TYPE, DEFAULT_TRANSFER_CONCURRENCY } from '../util/defaults.ts'\nimport { planRanges, type RangePlan } from '../util/plan-ranges.ts'\nimport { createAbortScope, raceWithAbort, throwRejectedOrAbortReason } from './abort-scope.ts'\nimport {\n  type CleanupFailureOptions,\n  cancelLargeFileBestEffort,\n  cleanupAfterLargeFileError,\n} from './cancel.ts'\nimport { Semaphore } from './concurrency.ts'\nimport { finishLargeFileWithAbortReconciliation } from './finish.ts'\nimport {\n  findResumeCandidate,\n  type ResumeCandidateCriteria,\n  type ResumeCandidateRejectedListener,\n  ResumeFileIdMismatchError,\n} from './resume.ts'\nimport {\n  resolveRetryResponseBodyFailures,\n  type UploadRetryOptions,\n  uploadPartWithFreshUrl,\n} from './retry.ts'\n\n/** Event emitted when explicit resume skips a local part because B2 already has matching SHA-1 bytes. */\nexport interface ResumePartReusedEvent {\n  /** File name being resumed. */\n  readonly fileName: string\n  /** Unfinished large-file ID that supplied the existing part. */\n  readonly fileId: LargeFileId\n  /** One-based part number reused from the unfinished large file. */\n  readonly partNumber: number\n  /** Number of bytes in the reused part. */\n  readonly contentLength: number\n  /** SHA-1 hex digest that matched the local part bytes. */\n  readonly contentSha1: string\n}\n\n/** Callback invoked when explicit resume accepts a pre-existing server part. */\nexport type ResumePartReusedListener = (event: ResumePartReusedEvent) => void\n\nconst MAX_CONSECUTIVE_EMPTY_STREAM_CHUNKS = 1024\n\n/** Options for uploading a large file via the multipart protocol. */\nexport interface UploadLargeFileOptions extends UploadRetryOptions, CleanupFailureOptions {\n  /** Target bucket for the upload. */\n  readonly bucketId: BucketId\n  /** Full B2 file name including any path prefix. */\n  readonly fileName: string\n  /**\n   * Content to upload. Sliceable sources ({@link BufferSource},\n   * {@link BlobSource}, {@link FileSource}) use the parallel-parts path.\n   * Non-sliceable streams and async iterables fall back to a sequential read\n   * path — one part at a time, concurrency forced to 1 — so callers can stream\n   * a multi-GB file without buffering the whole payload in memory. The\n   * `resumeFileId` requires a sliceable source; deprecated `resume: true`\n   * without an explicit file ID is ignored on forward-only sources.\n   */\n  readonly source: ContentSource\n  /** MIME type. Defaults to `b2/x-auto` for server-side detection. */\n  readonly contentType?: string\n  /** Custom file info key/value pairs stored with the file. */\n  readonly fileInfo?: Record<string, string>\n  /** Server-side encryption settings applied to each part. */\n  readonly serverSideEncryption?: EncryptionSetting\n  /** Effective bucket default encryption used when serverSideEncryption is omitted. */\n  readonly bucketDefaultServerSideEncryption?: EncryptionSetting\n  /** File retention policy applied at upload time. */\n  readonly fileRetention?: FileRetentionValue\n  /** Effective readable bucket default retention used when fileRetention is omitted. */\n  readonly bucketDefaultRetention?: BucketRetentionPolicy\n  /** Bucket default retention exists but cannot be read, so resume must fail closed. */\n  readonly bucketDefaultRetentionUnreadable?: boolean\n  /** Legal hold status applied at upload time. */\n  readonly legalHold?: LegalHoldValue\n  /** Size of each part in bytes. Defaults to the account's recommended part size. */\n  readonly partSize?: number\n  /** Maximum number of parts uploaded in parallel. Defaults to 4. */\n  readonly concurrency?: number\n  /** Callback invoked with upload progress updates. */\n  readonly onProgress?: ProgressListener\n  /** Signal to abort the upload. Triggers cancellation of the large file. */\n  readonly signal?: AbortSignal\n  /**\n   * If true, look for an unfinished large file with the same bucket and file name\n   * and continue uploading into it. Automatic discovery only reuses unfinished\n   * files whose upload options and already-uploaded part lengths match;\n   * otherwise a new large file is started. Existing server parts are overwritten\n   * with locally read bytes instead of being trusted by SHA-1 alone.\n   *\n   * Discovery runs before the first upload byte and can make up to the\n   * list-page budget plus the candidate budget times the part-page budget in\n   * sequential B2 list calls. Pass `resumeDiscoveryTimeoutMs` or an\n   * `AbortSignal` to enforce a hard discovery deadline. SSE-C uploads are\n   * never auto-resumed because B2 does not expose the customer key identity\n   * needed to verify a compatible unfinished file. Candidates with unreadable\n   * Object Lock fields are rejected unless the caller provides explicit\n   * settings that can be verified.\n   */\n  readonly resume?: boolean\n  /** Optional aggregate SDK-enforced timeout for resume discovery. */\n  readonly resumeDiscoveryTimeoutMs?: number\n  /**\n   * Maximum `b2_list_unfinished_large_files` pages inspected before upload starts. Defaults to 10.\n   * If the scan truncates, resume falls back to a fresh upload and\n   * `onResumeCandidateRejected` is the only SDK signal.\n   */\n  readonly resumeMaxListPages?: number\n  /**\n   * Maximum metadata-compatible candidates whose parts may be listed before upload starts. Defaults to 25.\n   * Hitting the limit can leave older unfinished uploads orphaned while a fresh\n   * large file is started; tune for high-churn buckets.\n   */\n  readonly resumeMaxPartCandidates?: number\n  /**\n   * Maximum `b2_list_parts` pages inspected per metadata-compatible candidate before upload starts. Defaults to 10.\n   * A candidate whose parts exceed this bound is skipped and reported through\n   * `onResumeCandidateRejected`.\n   */\n  readonly resumeMaxPartPages?: number\n  /**\n   * Explicit large file ID to resume into. Overrides {@link resume} discovery\n   * after verifying that the ID belongs to the requested bucket/file name and\n   * matches the current upload options and already-uploaded part lengths. This\n   * verification also rejects SSE-C uploads because B2 does not expose\n   * customer key identity for unfinished files. A mismatch, or a file ID that\n   * cannot be verified through B2's unfinished-large-file listing, throws\n   * {@link ResumeFileIdMismatchError}. Unreadable Object Lock fields reject\n   * the candidate.\n   */\n  readonly resumeFileId?: LargeFileId\n  /** Diagnostic callback invoked when resume discovery rejects a candidate. */\n  readonly onResumeCandidateRejected?: ResumeCandidateRejectedListener\n  /** Diagnostic callback invoked when resume reuses an already-uploaded part. */\n  readonly onResumePartReused?: ResumePartReusedListener\n}\n\ninterface StartLargeFileResumeRequest {\n  readonly contentType: string\n  readonly fileInfo: Record<string, string>\n  readonly serverSideEncryption?: EncryptionSetting\n  readonly fileRetention?: FileRetentionValue\n  readonly legalHold?: LegalHoldValue\n}\n\nfunction createResumeCandidateCriteria(\n  options: UploadLargeFileOptions,\n  request: StartLargeFileResumeRequest,\n  totalSize: number,\n  partSize: number,\n  parts: readonly RangePlan[],\n): ResumeCandidateCriteria {\n  return {\n    contentType: request.contentType,\n    fileInfo: request.fileInfo,\n    sourceSize: totalSize,\n    partSize,\n    parts,\n    ...(options.signal !== undefined ? { signal: options.signal } : {}),\n    ...(request.serverSideEncryption !== undefined\n      ? { serverSideEncryption: request.serverSideEncryption }\n      : options.bucketDefaultServerSideEncryption !== undefined\n        ? { serverSideEncryption: options.bucketDefaultServerSideEncryption }\n        : {}),\n    ...(request.fileRetention !== undefined\n      ? { fileRetention: request.fileRetention }\n      : options.bucketDefaultRetention !== undefined\n        ? { defaultFileRetention: options.bucketDefaultRetention }\n        : options.bucketDefaultRetentionUnreadable === true\n          ? { defaultFileRetentionUnreadable: true }\n          : {}),\n    ...(request.legalHold !== undefined ? { legalHold: request.legalHold } : {}),\n    ...(options.resumeDiscoveryTimeoutMs !== undefined\n      ? { discoveryTimeoutMs: options.resumeDiscoveryTimeoutMs }\n      : {}),\n    ...(options.onResumeCandidateRejected !== undefined\n      ? { onCandidateRejected: options.onResumeCandidateRejected }\n      : {}),\n    ...(options.resumeMaxListPages !== undefined\n      ? { maxListPages: options.resumeMaxListPages }\n      : {}),\n    ...(options.resumeMaxPartCandidates !== undefined\n      ? { maxPartCandidates: options.resumeMaxPartCandidates }\n      : {}),\n    ...(options.resumeMaxPartPages !== undefined\n      ? { maxPartPages: options.resumeMaxPartPages }\n      : {}),\n  }\n}\n\n/**\n * Uploads a file using the B2 multipart (large file) protocol.\n *\n * The source is sliced into parts and uploaded concurrently via\n * `b2_upload_part`. This is appropriate for files larger than the recommended\n * part size. For smaller files, use {@link uploadSmallFile} which sends the\n * entire payload in a single request.\n *\n * On failure, the in-progress large file is cancelled on a best-effort basis.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state (tokens, URLs, upload URL pool).\n * @param options - Upload parameters including part size and concurrency.\n *\n * @returns The resulting {@link FileVersion} metadata.\n */\nexport async function uploadLargeFile(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: UploadLargeFileOptions,\n): Promise<FileVersion> {\n  const recommendedPartSize = accountInfo.getRecommendedPartSize()\n  const minPartSize = accountInfo.getAbsoluteMinimumPartSize()\n  const partSize = Math.max(options.partSize ?? recommendedPartSize, minPartSize)\n  const concurrency = options.concurrency ?? DEFAULT_TRANSFER_CONCURRENCY\n  const totalSize = options.source.size\n\n  const parts = planRanges(totalSize, partSize)\n  // Keep caller fileInfo on a null-prototype record so resume identity\n  // comparison only sees caller-owned enumerable keys.\n  const fileInfo: Record<string, string> = Object.create(null)\n  if (options.fileInfo !== undefined) {\n    for (const [key, value] of Object.entries(options.fileInfo)) {\n      fileInfo[key] = value\n    }\n  }\n\n  // Construct the `b2_start_large_file` request body once so the two\n  // non-resume branches below (no `resume`, resume-but-no-candidate)\n  // can dispatch without re-spelling the conditional spreads.\n  const startLargeFileRequest = {\n    bucketId: options.bucketId,\n    fileName: options.fileName,\n    contentType: options.contentType ?? DEFAULT_CONTENT_TYPE,\n    fileInfo,\n    ...(options.serverSideEncryption !== undefined\n      ? { serverSideEncryption: options.serverSideEncryption }\n      : {}),\n    ...(options.fileRetention !== undefined ? { fileRetention: options.fileRetention } : {}),\n    ...(options.legalHold !== undefined ? { legalHold: options.legalHold } : {}),\n  }\n  const resumeCandidateCriteria = createResumeCandidateCriteria(\n    options,\n    startLargeFileRequest,\n    totalSize,\n    partSize,\n    parts,\n  )\n\n  if (!options.source.canSlice && options.resumeFileId !== undefined) {\n    throw new Error('uploadLargeFile: resume is not supported on non-sliceable sources.')\n  }\n\n  // --- Explicit resume file reuse (M11.1) ---\n  let largeFileId: LargeFileId | undefined\n  let preUploaded: ReadonlyMap<number, string> = new Map()\n  let createdLargeFile = false\n  const abortScope = createAbortScope(options.signal)\n  const startFreshLargeFile = async (): Promise<void> => {\n    if (abortScope.signal.aborted && !options.source.canSlice) {\n      await cancelForwardOnlySource(options.source, abortScope.signal.reason)\n    }\n    abortScope.signal.throwIfAborted()\n    const startPromise = raw.startLargeFile(\n      accountInfo.getApiUrl(),\n      accountInfo.getAuthToken(),\n      startLargeFileRequest,\n      {\n        signal: abortScope.signal,\n        ...(options.retry !== undefined ? { retry: options.retry } : {}),\n      },\n    )\n    try {\n      const startResp = await raceWithAbort(startPromise, abortScope.signal)\n      largeFileId = startResp.fileId\n    } catch (err) {\n      if (abortScope.signal.aborted) {\n        if (!options.source.canSlice) {\n          await cancelForwardOnlySource(options.source, abortScope.signal.reason).catch(() => {})\n        }\n        cancelLargeFileAfterStart(startPromise, raw, accountInfo, options.onCleanupFailure)\n      }\n      throw err\n    }\n    preUploaded = new Map<number, string>()\n    createdLargeFile = true\n  }\n\n  try {\n    if (abortScope.signal.aborted && !options.source.canSlice) {\n      await cancelForwardOnlySource(options.source, abortScope.signal.reason)\n    }\n    abortScope.signal.throwIfAborted()\n    if (options.resumeFileId !== undefined) {\n      const candidate = await findResumeCandidate(\n        raw,\n        accountInfo,\n        options.bucketId,\n        options.fileName,\n        {\n          ...resumeCandidateCriteria,\n          resumeFileId: options.resumeFileId,\n        },\n      )\n      if (candidate === null) {\n        throw new ResumeFileIdMismatchError(options.resumeFileId, options.fileName)\n      }\n      largeFileId = candidate.fileId\n      preUploaded = candidate.uploadedPartSha1s\n    } else if (options.resume === true && options.source.canSlice) {\n      const candidate = await findResumeCandidate(\n        raw,\n        accountInfo,\n        options.bucketId,\n        options.fileName,\n        resumeCandidateCriteria,\n      )\n      if (candidate) {\n        largeFileId = candidate.fileId\n        preUploaded = new Map<number, string>()\n      } else {\n        await startFreshLargeFile()\n      }\n    } else {\n      await startFreshLargeFile()\n    }\n    const activeLargeFileId = largeFileId\n    if (activeLargeFileId === undefined) {\n      throw new Error('uploadLargeFile: start did not return a large file ID.')\n    }\n\n    const partSha1s: string[] = new Array(parts.length)\n    const tracker = new ProgressTracker(options.onProgress, totalSize, parts.length)\n    const sem = new Semaphore(concurrency)\n\n    // Non-sliceable sources can't be read in parallel — there's only one\n    // forward-only cursor. Resume is also impossible (no seek). Bail to a\n    // sequential read loop instead. Each part is buffered, hashed, shipped,\n    // then dropped before the next read starts, so the peak memory footprint is\n    // ~partSize bytes regardless of total file size.\n    if (!options.source.canSlice) {\n      await uploadPartsSequentially(\n        raw,\n        accountInfo,\n        options,\n        activeLargeFileId,\n        parts,\n        partSha1s,\n        tracker,\n        abortScope.signal,\n      )\n      return await finishLargeFileWithAbortReconciliation(raw, accountInfo, {\n        fileId: activeLargeFileId,\n        bucketId: options.bucketId,\n        fileName: options.fileName,\n        partSha1s,\n        signal: abortScope.signal,\n        ...(options.retry !== undefined ? { retry: options.retry } : {}),\n      })\n    }\n\n    const tasks = parts.map(async (part) => {\n      await sem.acquire()\n      try {\n        abortScope.signal.throwIfAborted()\n\n        const partSource = options.source.slice(part.offset, part.offset + part.length)\n        const data = new Uint8Array(await partSource.toArrayBuffer({ signal: abortScope.signal }))\n        abortScope.signal.throwIfAborted()\n\n        const partSha1 = new IncrementalSha1()\n        await partSha1.update(data)\n        const sha1Hex = await partSha1.digest()\n        abortScope.signal.throwIfAborted()\n\n        // Explicit resume is the only mode that trusts an already-uploaded\n        // server part enough to skip sending the local bytes again.\n        const serverSha1 = preUploaded.get(part.partNumber)\n        if (serverSha1 !== undefined && serverSha1 === sha1Hex) {\n          notifyResumePartReused(options.onResumePartReused, {\n            fileName: options.fileName,\n            fileId: activeLargeFileId,\n            partNumber: part.partNumber,\n            contentLength: data.byteLength,\n            contentSha1: serverSha1,\n          })\n          partSha1s[part.partNumber - 1] = serverSha1\n          tracker.addBytes(data.byteLength)\n          tracker.completePart()\n          return\n        }\n\n        const result = await uploadPartWithFreshUrl(raw, accountInfo, activeLargeFileId, {\n          fileName: options.fileName,\n          partNumber: part.partNumber,\n          data,\n          contentLength: data.byteLength,\n          contentSha1: sha1Hex,\n          retry: options.retry,\n          signal: abortScope.signal,\n          onUploadRetry: options.onUploadRetry,\n          retryResponseBodyFailures: resolveRetryResponseBodyFailures(\n            options.retryResponseBodyFailures,\n          ),\n          ...(options.serverSideEncryption !== undefined\n            ? { serverSideEncryption: options.serverSideEncryption }\n            : {}),\n        })\n\n        partSha1s[part.partNumber - 1] = result.contentSha1\n        tracker.addBytes(data.byteLength)\n        tracker.completePart()\n      } catch (err) {\n        abortScope.abort(err)\n        throw err\n      } finally {\n        sem.release()\n      }\n    })\n\n    throwRejectedOrAbortReason(await Promise.allSettled(tasks), abortScope)\n\n    const result = await finishLargeFileWithAbortReconciliation(raw, accountInfo, {\n      fileId: activeLargeFileId,\n      bucketId: options.bucketId,\n      fileName: options.fileName,\n      partSha1s,\n      signal: abortScope.signal,\n      ...(options.retry !== undefined ? { retry: options.retry } : {}),\n    })\n\n    return result\n  } catch (err) {\n    abortScope.abort(err)\n    if (largeFileId === undefined) throw err\n    return await cleanupAfterUploadLargeFileError(\n      err,\n      raw,\n      accountInfo,\n      options,\n      largeFileId,\n      createdLargeFile,\n    )\n  } finally {\n    abortScope.dispose()\n  }\n}\n\nfunction cancelLargeFileAfterStart(\n  started: Promise<{ readonly fileId: LargeFileId }>,\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  onCleanupFailure: CleanupFailureOptions['onCleanupFailure'],\n): void {\n  void started\n    .then((resp) =>\n      cancelLargeFileBestEffort(\n        raw,\n        accountInfo,\n        resp.fileId,\n        onCleanupFailure === undefined ? undefined : { onCleanupFailure },\n      ),\n    )\n    .catch(() => {\n      // If start failed, no file ID is available to cancel.\n    })\n}\n\nasync function cleanupAfterUploadLargeFileError(\n  err: unknown,\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: UploadLargeFileOptions,\n  largeFileId: LargeFileId,\n  createdLargeFile: boolean,\n): Promise<never> {\n  return await cleanupAfterLargeFileError(\n    err,\n    raw,\n    accountInfo,\n    {\n      fileId: largeFileId,\n      bucketId: options.bucketId,\n      fileName: options.fileName,\n      signal: options.signal,\n      onCleanupFailure: options.onCleanupFailure,\n    },\n    { cancelOnError: createdLargeFile },\n  )\n}\n\n/**\n * Sequential upload path for non-sliceable sources.\n *\n * Reads the source's `stream()` once and accumulates exactly `partSize`\n * bytes into an in-memory buffer per iteration. Each filled buffer is\n * hashed, dispatched to `b2_upload_part`, then released before the next\n * part starts — so peak memory is ~partSize regardless of file size.\n *\n * Concurrency is forced to 1 here because the stream is a single\n * forward-only cursor; the engine can't read part N+1 until part N is\n * fully consumed.\n *\n * @param raw - Low-level B2 API client.\n * @param accountInfo - Authorized account state.\n * @param options - The original `uploadLargeFile` options.\n * @param largeFileId - ID of the in-progress large file (already started).\n * @param parts - Pre-planned part layout (used for part numbers + count).\n * @param partSha1s - Output array, written in-place at index `partNumber - 1`.\n * @param tracker - Progress tracker; bytes added per chunk, part completed\n *   each time a part finishes.\n * @param signal - Linked abort signal for source reads and part uploads.\n */\nasync function uploadPartsSequentially(\n  raw: RawClient,\n  accountInfo: AccountInfo,\n  options: UploadLargeFileOptions,\n  largeFileId: LargeFileId,\n  parts: readonly RangePlan[],\n  partSha1s: string[],\n  tracker: ProgressTracker,\n  signal: AbortSignal,\n): Promise<void> {\n  const reader = options.source.stream().getReader()\n  let bytesRead = 0\n  // Carry-over bytes from a previous read when the read returned more\n  // than we needed to fill one part. Kept as an array to avoid an\n  // allocation per loop iteration on a typical multi-part upload.\n  let carry: Uint8Array | null = null\n\n  try {\n    for (const planned of parts) {\n      signal.throwIfAborted()\n\n      const buf = new Uint8Array(planned.length)\n      let filled = 0\n\n      if (carry !== null) {\n        const take = Math.min(carry.byteLength, buf.byteLength - filled)\n        buf.set(carry.subarray(0, take), filled)\n        filled += take\n        carry = take < carry.byteLength ? carry.subarray(take) : null\n      }\n\n      while (filled < buf.byteLength) {\n        const { done, value } = await readNextNonEmptyStreamChunk(reader, emptyChunkError(), signal)\n        if (done) {\n          throw new Error(\n            `uploadLargeFile: source stream ended after ${bytesRead} bytes, expected ${options.source.size}.`,\n          )\n        }\n        bytesRead += value.byteLength\n        const take = Math.min(value.byteLength, buf.byteLength - filled)\n        buf.set(value.subarray(0, take), filled)\n        filled += take\n        if (take < value.byteLength) {\n          carry = value.subarray(take)\n        }\n      }\n\n      signal.throwIfAborted()\n      const data = buf\n\n      const partSha1 = new IncrementalSha1()\n      await partSha1.update(data)\n      const sha1Hex = await partSha1.digest()\n      signal.throwIfAborted()\n\n      const result = await uploadPartWithFreshUrl(raw, accountInfo, largeFileId, {\n        fileName: options.fileName,\n        partNumber: planned.partNumber,\n        data,\n        contentLength: data.byteLength,\n        contentSha1: sha1Hex,\n        retry: options.retry,\n        signal,\n        onUploadRetry: options.onUploadRetry,\n        retryResponseBodyFailures: resolveRetryResponseBodyFailures(\n          options.retryResponseBodyFailures,\n        ),\n        ...(options.serverSideEncryption !== undefined\n          ? { serverSideEncryption: options.serverSideEncryption }\n          : {}),\n      })\n\n      partSha1s[planned.partNumber - 1] = result.contentSha1\n      tracker.addBytes(data.byteLength)\n      tracker.completePart()\n    }\n    if (carry !== null && carry.byteLength > 0) {\n      throw new Error(tooManyBytesError(options.source.size))\n    }\n    const extra = await readNextNonEmptyStreamChunk(reader, emptyChunkError(), signal)\n    if (!extra.done) {\n      bytesRead += extra.value.byteLength\n      throw new Error(tooManyBytesError(options.source.size))\n    }\n  } catch (err) {\n    await reader.cancel(err).catch(() => {})\n    throw err\n  } finally {\n    // Releasing the lock lets the underlying stream propagate close / error\n    // events to any upstream producer (e.g. a Node `Readable`).\n    reader.releaseLock()\n  }\n}\n\nfunction emptyChunkError(): string {\n  return `uploadLargeFile: source stream emitted more than ${MAX_CONSECUTIVE_EMPTY_STREAM_CHUNKS} consecutive empty chunks. too many empty chunks.`\n}\n\nfunction tooManyBytesError(advertisedSize: number): string {\n  return `uploadLargeFile: source stream emitted more than advertised ${advertisedSize} bytes. source stream emitted more bytes than advertised size.`\n}\n\nasync function cancelForwardOnlySource(source: ContentSource, reason: unknown): Promise<void> {\n  const reader = source.stream().getReader()\n  try {\n    await reader.cancel(reason)\n  } finally {\n    reader.releaseLock()\n  }\n}\n\nfunction notifyResumePartReused(\n  listener: ResumePartReusedListener | undefined,\n  event: ResumePartReusedEvent,\n): void {\n  try {\n    listener?.(event)\n  } catch {\n    // Diagnostic observers must not change upload success or failure.\n  }\n}\n"],"mappings":"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"}

package/dist/upload/options.cjs

@@ -0,0 +1,28 @@
+//#region src/upload/options.ts
+/**
+* Explicit resume targets are multipart-only and must fail closed on small uploads.
+*
+* @param options - High-level upload options.
+* @param caller - Public method name used in the thrown error.
+*
+* @throws Error when an explicit resume target is supplied for a small upload.
+*/
+function rejectSmallResumeFileId(options, caller) {
+	if (options.resumeFileId !== void 0) throw new Error(`${caller}: resumeFileId is only supported for multipart uploads.`);
+}
+/**
+* Removes resume-only options before forwarding to the small-file upload path.
+*
+* @param options - High-level upload options.
+*
+* @returns Options accepted by the single-request upload implementation.
+*/
+function stripResumeOnlyOptions(options) {
+	const { resume: _resume, resumeFileId: _resumeFileId, onResumeCandidateRejected: _onResumeCandidateRejected, onResumePartReused: _onResumePartReused, resumeDiscoveryTimeoutMs: _resumeDiscoveryTimeoutMs, resumeMaxListPages: _resumeMaxListPages, resumeMaxPartCandidates: _resumeMaxPartCandidates, resumeMaxPartPages: _resumeMaxPartPages, ...smallOptions } = options;
+	return smallOptions;
+}
+//#endregion
+exports.rejectSmallResumeFileId = rejectSmallResumeFileId;
+exports.stripResumeOnlyOptions = stripResumeOnlyOptions;
+
+//# sourceMappingURL=options.cjs.map

package/dist/upload/options.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.cjs","names":[],"sources":["../../src/upload/options.ts"],"sourcesContent":["import type { ProgressListener } from '../streams/progress.ts'\nimport type { ContentSource } from '../streams/source.ts'\nimport type { EncryptionSetting } from '../types/encryption.ts'\nimport type { LargeFileId } from '../types/ids.ts'\nimport type { FileRetentionValue, LegalHoldValue } from '../types/lock.ts'\nimport type { CleanupFailureOptions } from './cancel.ts'\nimport type { ResumePartReusedListener } from './large.ts'\nimport type { ResumeCandidateRejectedListener } from './resume.ts'\nimport type { UploadRetryOptions } from './retry.ts'\n\n/** Shared options for high-level file uploads. */\nexport interface HighLevelUploadOptions extends UploadRetryOptions, CleanupFailureOptions {\n  /**\n   * Data source to upload. Use {@link BufferSource}, {@link BlobSource}, {@link FileSource},\n   * {@link StreamSource}, or {@link toContentSource} for async iterables and Node Readables.\n   */\n  readonly source: ContentSource\n  /** MIME type. Defaults to `\"b2/x-auto\"` (auto-detected by B2). */\n  readonly contentType?: string\n  /** Custom key-value metadata stored with the file. */\n  readonly fileInfo?: Record<string, string>\n  /** Server-side encryption settings. */\n  readonly serverSideEncryption?: EncryptionSetting\n  /** File retention policy (requires file lock on the bucket). */\n  readonly fileRetention?: FileRetentionValue\n  /** Legal hold status for the file. */\n  readonly legalHold?: LegalHoldValue\n  /** Last-modified timestamp in milliseconds since epoch. */\n  readonly lastModifiedMillis?: number\n  /** Part size override for multipart uploads, in bytes. */\n  readonly partSize?: number\n  /** Number of concurrent part uploads for large files. */\n  readonly concurrency?: number\n  /** Callback invoked with upload progress events. */\n  readonly onProgress?: ProgressListener\n  /** Abort signal for cancelling the upload. */\n  readonly signal?: AbortSignal\n  /** Enable bounded same-name multipart resume discovery. Ignored on the small-file path. */\n  readonly resume?: boolean\n  /** Optional aggregate SDK-enforced timeout for resume discovery. */\n  readonly resumeDiscoveryTimeoutMs?: number\n  /** Maximum `b2_list_unfinished_large_files` pages inspected before upload starts. */\n  readonly resumeMaxListPages?: number\n  /** Maximum metadata-compatible candidates whose parts may be listed before upload starts. */\n  readonly resumeMaxPartCandidates?: number\n  /** Maximum `b2_list_parts` pages inspected per metadata-compatible candidate. */\n  readonly resumeMaxPartPages?: number\n  /**\n   * Explicit unfinished large-file ID to verify and resume. Only supported on\n   * the large-file path; small-file uploads throw.\n   */\n  readonly resumeFileId?: LargeFileId\n  /** Diagnostic callback invoked when resume discovery rejects a candidate. */\n  readonly onResumeCandidateRejected?: ResumeCandidateRejectedListener\n  /** Diagnostic callback invoked when resume reuses an already-uploaded part. */\n  readonly onResumePartReused?: ResumePartReusedListener\n}\n\n/** Backwards-compatible name for high-level upload options. */\nexport type UploadOptions = HighLevelUploadOptions\n\n/** Options accepted by {@link Bucket.upload}. */\nexport interface BucketUploadOptions extends HighLevelUploadOptions {\n  /** Destination file name (path) in the bucket. */\n  readonly fileName: string\n}\n\n/** Options accepted by {@link B2Object.upload}. */\nexport type B2ObjectUploadOptions = HighLevelUploadOptions\n\n/** Options accepted by {@link B2Object.createWriteStream}. */\nexport interface B2ObjectWriteStreamOptions extends UploadRetryOptions, CleanupFailureOptions {\n  /** MIME type. Defaults to `\"b2/x-auto\"`. */\n  readonly contentType?: string\n  /** Custom key-value metadata stored with the file. */\n  readonly fileInfo?: Record<string, string>\n  /** Server-side encryption applied to each part. */\n  readonly serverSideEncryption?: EncryptionSetting\n  /** Target part size in bytes. Defaults to the account's recommended part size. */\n  readonly partSize?: number\n  /** Maximum number of parts uploaded in parallel. Defaults to 4. */\n  readonly concurrency?: number\n  /** Callback invoked with upload progress events. */\n  readonly onProgress?: ProgressListener\n  /** Abort signal that cancels the upload and the unfinished large file. */\n  readonly signal?: AbortSignal\n}\n\ntype ResumeOnlyUploadOptions = Pick<\n  HighLevelUploadOptions,\n  | 'resume'\n  | 'resumeFileId'\n  | 'onResumeCandidateRejected'\n  | 'onResumePartReused'\n  | 'resumeDiscoveryTimeoutMs'\n  | 'resumeMaxListPages'\n  | 'resumeMaxPartCandidates'\n  | 'resumeMaxPartPages'\n>\n\n/** High-level upload options after resume-only settings have been removed. */\nexport type SmallUploadOptions<T extends HighLevelUploadOptions> = Omit<\n  T,\n  keyof ResumeOnlyUploadOptions\n>\n\n/**\n * Explicit resume targets are multipart-only and must fail closed on small uploads.\n *\n * @param options - High-level upload options.\n * @param caller - Public method name used in the thrown error.\n *\n * @throws Error when an explicit resume target is supplied for a small upload.\n */\nexport function rejectSmallResumeFileId(options: HighLevelUploadOptions, caller: string): void {\n  if (options.resumeFileId !== undefined) {\n    throw new Error(`${caller}: resumeFileId is only supported for multipart uploads.`)\n  }\n}\n\n/**\n * Removes resume-only options before forwarding to the small-file upload path.\n *\n * @param options - High-level upload options.\n *\n * @returns Options accepted by the single-request upload implementation.\n */\nexport function stripResumeOnlyOptions<T extends HighLevelUploadOptions>(\n  options: T,\n): SmallUploadOptions<T> {\n  const {\n    resume: _resume,\n    resumeFileId: _resumeFileId,\n    onResumeCandidateRejected: _onResumeCandidateRejected,\n    onResumePartReused: _onResumePartReused,\n    resumeDiscoveryTimeoutMs: _resumeDiscoveryTimeoutMs,\n    resumeMaxListPages: _resumeMaxListPages,\n    resumeMaxPartCandidates: _resumeMaxPartCandidates,\n    resumeMaxPartPages: _resumeMaxPartPages,\n    ...smallOptions\n  } = options\n  return smallOptions\n}\n"],"mappings":";;;;;;;;;AAkHA,SAAgB,wBAAwB,SAAiC,QAAsB;CAC7F,IAAI,QAAQ,iBAAiB,KAAA,GAC3B,MAAM,IAAI,MAAM,GAAG,OAAO,wDAAwD;AAEtF;;;;;;;;AASA,SAAgB,uBACd,SACuB;CACvB,MAAM,EACJ,QAAQ,SACR,cAAc,eACd,2BAA2B,4BAC3B,oBAAoB,qBACpB,0BAA0B,2BAC1B,oBAAoB,qBACpB,yBAAyB,0BACzB,oBAAoB,qBACpB,GAAG,iBACD;CACJ,OAAO;AACT"}

package/dist/upload/options.d.cts

@@ -0,0 +1,104 @@
+import { ProgressListener } from '../streams/progress.js';
+import { ContentSource } from '../streams/source.js';
+import { EncryptionSetting } from '../types/encryption.js';
+import { LargeFileId } from '../types/ids.js';
+import { FileRetentionValue, LegalHoldValue } from '../types/lock.js';
+import { CleanupFailureOptions } from './cancel.js';
+import { ResumePartReusedListener } from './large.js';
+import { ResumeCandidateRejectedListener } from './resume.js';
+import { UploadRetryOptions } from './retry.js';
+/** Shared options for high-level file uploads. */
+export interface HighLevelUploadOptions extends UploadRetryOptions, CleanupFailureOptions {
+    /**
+     * Data source to upload. Use {@link BufferSource}, {@link BlobSource}, {@link FileSource},
+     * {@link StreamSource}, or {@link toContentSource} for async iterables and Node Readables.
+     */
+    readonly source: ContentSource;
+    /** MIME type. Defaults to `"b2/x-auto"` (auto-detected by B2). */
+    readonly contentType?: string;
+    /** Custom key-value metadata stored with the file. */
+    readonly fileInfo?: Record<string, string>;
+    /** Server-side encryption settings. */
+    readonly serverSideEncryption?: EncryptionSetting;
+    /** File retention policy (requires file lock on the bucket). */
+    readonly fileRetention?: FileRetentionValue;
+    /** Legal hold status for the file. */
+    readonly legalHold?: LegalHoldValue;
+    /** Last-modified timestamp in milliseconds since epoch. */
+    readonly lastModifiedMillis?: number;
+    /** Part size override for multipart uploads, in bytes. */
+    readonly partSize?: number;
+    /** Number of concurrent part uploads for large files. */
+    readonly concurrency?: number;
+    /** Callback invoked with upload progress events. */
+    readonly onProgress?: ProgressListener;
+    /** Abort signal for cancelling the upload. */
+    readonly signal?: AbortSignal;
+    /** Enable bounded same-name multipart resume discovery. Ignored on the small-file path. */
+    readonly resume?: boolean;
+    /** Optional aggregate SDK-enforced timeout for resume discovery. */
+    readonly resumeDiscoveryTimeoutMs?: number;
+    /** Maximum `b2_list_unfinished_large_files` pages inspected before upload starts. */
+    readonly resumeMaxListPages?: number;
+    /** Maximum metadata-compatible candidates whose parts may be listed before upload starts. */
+    readonly resumeMaxPartCandidates?: number;
+    /** Maximum `b2_list_parts` pages inspected per metadata-compatible candidate. */
+    readonly resumeMaxPartPages?: number;
+    /**
+     * Explicit unfinished large-file ID to verify and resume. Only supported on
+     * the large-file path; small-file uploads throw.
+     */
+    readonly resumeFileId?: LargeFileId;
+    /** Diagnostic callback invoked when resume discovery rejects a candidate. */
+    readonly onResumeCandidateRejected?: ResumeCandidateRejectedListener;
+    /** Diagnostic callback invoked when resume reuses an already-uploaded part. */
+    readonly onResumePartReused?: ResumePartReusedListener;
+}
+/** Backwards-compatible name for high-level upload options. */
+export type UploadOptions = HighLevelUploadOptions;
+/** Options accepted by {@link Bucket.upload}. */
+export interface BucketUploadOptions extends HighLevelUploadOptions {
+    /** Destination file name (path) in the bucket. */
+    readonly fileName: string;
+}
+/** Options accepted by {@link B2Object.upload}. */
+export type B2ObjectUploadOptions = HighLevelUploadOptions;
+/** Options accepted by {@link B2Object.createWriteStream}. */
+export interface B2ObjectWriteStreamOptions extends UploadRetryOptions, CleanupFailureOptions {
+    /** MIME type. Defaults to `"b2/x-auto"`. */
+    readonly contentType?: string;
+    /** Custom key-value metadata stored with the file. */
+    readonly fileInfo?: Record<string, string>;
+    /** Server-side encryption applied to each part. */
+    readonly serverSideEncryption?: EncryptionSetting;
+    /** Target part size in bytes. Defaults to the account's recommended part size. */
+    readonly partSize?: number;
+    /** Maximum number of parts uploaded in parallel. Defaults to 4. */
+    readonly concurrency?: number;
+    /** Callback invoked with upload progress events. */
+    readonly onProgress?: ProgressListener;
+    /** Abort signal that cancels the upload and the unfinished large file. */
+    readonly signal?: AbortSignal;
+}
+type ResumeOnlyUploadOptions = Pick<HighLevelUploadOptions, 'resume' | 'resumeFileId' | 'onResumeCandidateRejected' | 'onResumePartReused' | 'resumeDiscoveryTimeoutMs' | 'resumeMaxListPages' | 'resumeMaxPartCandidates' | 'resumeMaxPartPages'>;
+/** High-level upload options after resume-only settings have been removed. */
+export type SmallUploadOptions<T extends HighLevelUploadOptions> = Omit<T, keyof ResumeOnlyUploadOptions>;
+/**
+ * Explicit resume targets are multipart-only and must fail closed on small uploads.
+ *
+ * @param options - High-level upload options.
+ * @param caller - Public method name used in the thrown error.
+ *
+ * @throws Error when an explicit resume target is supplied for a small upload.
+ */
+export declare function rejectSmallResumeFileId(options: HighLevelUploadOptions, caller: string): void;
+/**
+ * Removes resume-only options before forwarding to the small-file upload path.
+ *
+ * @param options - High-level upload options.
+ *
+ * @returns Options accepted by the single-request upload implementation.
+ */
+export declare function stripResumeOnlyOptions<T extends HighLevelUploadOptions>(options: T): SmallUploadOptions<T>;
+export {};
+//# sourceMappingURL=options.d.ts.map

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

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

package/dist/upload/options.d.ts

@@ -0,0 +1,104 @@
+import { ProgressListener } from '../streams/progress.js';
+import { ContentSource } from '../streams/source.js';
+import { EncryptionSetting } from '../types/encryption.js';
+import { LargeFileId } from '../types/ids.js';
+import { FileRetentionValue, LegalHoldValue } from '../types/lock.js';
+import { CleanupFailureOptions } from './cancel.js';
+import { ResumePartReusedListener } from './large.js';
+import { ResumeCandidateRejectedListener } from './resume.js';
+import { UploadRetryOptions } from './retry.js';
+/** Shared options for high-level file uploads. */
+export interface HighLevelUploadOptions extends UploadRetryOptions, CleanupFailureOptions {
+    /**
+     * Data source to upload. Use {@link BufferSource}, {@link BlobSource}, {@link FileSource},
+     * {@link StreamSource}, or {@link toContentSource} for async iterables and Node Readables.
+     */
+    readonly source: ContentSource;
+    /** MIME type. Defaults to `"b2/x-auto"` (auto-detected by B2). */
+    readonly contentType?: string;
+    /** Custom key-value metadata stored with the file. */
+    readonly fileInfo?: Record<string, string>;
+    /** Server-side encryption settings. */
+    readonly serverSideEncryption?: EncryptionSetting;
+    /** File retention policy (requires file lock on the bucket). */
+    readonly fileRetention?: FileRetentionValue;
+    /** Legal hold status for the file. */
+    readonly legalHold?: LegalHoldValue;
+    /** Last-modified timestamp in milliseconds since epoch. */
+    readonly lastModifiedMillis?: number;
+    /** Part size override for multipart uploads, in bytes. */
+    readonly partSize?: number;
+    /** Number of concurrent part uploads for large files. */
+    readonly concurrency?: number;
+    /** Callback invoked with upload progress events. */
+    readonly onProgress?: ProgressListener;
+    /** Abort signal for cancelling the upload. */
+    readonly signal?: AbortSignal;
+    /** Enable bounded same-name multipart resume discovery. Ignored on the small-file path. */
+    readonly resume?: boolean;
+    /** Optional aggregate SDK-enforced timeout for resume discovery. */
+    readonly resumeDiscoveryTimeoutMs?: number;
+    /** Maximum `b2_list_unfinished_large_files` pages inspected before upload starts. */
+    readonly resumeMaxListPages?: number;
+    /** Maximum metadata-compatible candidates whose parts may be listed before upload starts. */
+    readonly resumeMaxPartCandidates?: number;
+    /** Maximum `b2_list_parts` pages inspected per metadata-compatible candidate. */
+    readonly resumeMaxPartPages?: number;
+    /**
+     * Explicit unfinished large-file ID to verify and resume. Only supported on
+     * the large-file path; small-file uploads throw.
+     */
+    readonly resumeFileId?: LargeFileId;
+    /** Diagnostic callback invoked when resume discovery rejects a candidate. */
+    readonly onResumeCandidateRejected?: ResumeCandidateRejectedListener;
+    /** Diagnostic callback invoked when resume reuses an already-uploaded part. */
+    readonly onResumePartReused?: ResumePartReusedListener;
+}
+/** Backwards-compatible name for high-level upload options. */
+export type UploadOptions = HighLevelUploadOptions;
+/** Options accepted by {@link Bucket.upload}. */
+export interface BucketUploadOptions extends HighLevelUploadOptions {
+    /** Destination file name (path) in the bucket. */
+    readonly fileName: string;
+}
+/** Options accepted by {@link B2Object.upload}. */
+export type B2ObjectUploadOptions = HighLevelUploadOptions;
+/** Options accepted by {@link B2Object.createWriteStream}. */
+export interface B2ObjectWriteStreamOptions extends UploadRetryOptions, CleanupFailureOptions {
+    /** MIME type. Defaults to `"b2/x-auto"`. */
+    readonly contentType?: string;
+    /** Custom key-value metadata stored with the file. */
+    readonly fileInfo?: Record<string, string>;
+    /** Server-side encryption applied to each part. */
+    readonly serverSideEncryption?: EncryptionSetting;
+    /** Target part size in bytes. Defaults to the account's recommended part size. */
+    readonly partSize?: number;
+    /** Maximum number of parts uploaded in parallel. Defaults to 4. */
+    readonly concurrency?: number;
+    /** Callback invoked with upload progress events. */
+    readonly onProgress?: ProgressListener;
+    /** Abort signal that cancels the upload and the unfinished large file. */
+    readonly signal?: AbortSignal;
+}
+type ResumeOnlyUploadOptions = Pick<HighLevelUploadOptions, 'resume' | 'resumeFileId' | 'onResumeCandidateRejected' | 'onResumePartReused' | 'resumeDiscoveryTimeoutMs' | 'resumeMaxListPages' | 'resumeMaxPartCandidates' | 'resumeMaxPartPages'>;
+/** High-level upload options after resume-only settings have been removed. */
+export type SmallUploadOptions<T extends HighLevelUploadOptions> = Omit<T, keyof ResumeOnlyUploadOptions>;
+/**
+ * Explicit resume targets are multipart-only and must fail closed on small uploads.
+ *
+ * @param options - High-level upload options.
+ * @param caller - Public method name used in the thrown error.
+ *
+ * @throws Error when an explicit resume target is supplied for a small upload.
+ */
+export declare function rejectSmallResumeFileId(options: HighLevelUploadOptions, caller: string): void;
+/**
+ * Removes resume-only options before forwarding to the small-file upload path.
+ *
+ * @param options - High-level upload options.
+ *
+ * @returns Options accepted by the single-request upload implementation.
+ */
+export declare function stripResumeOnlyOptions<T extends HighLevelUploadOptions>(options: T): SmallUploadOptions<T>;
+export {};
+//# sourceMappingURL=options.d.ts.map

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

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

package/dist/upload/options.js

@@ -0,0 +1,27 @@
+//#region src/upload/options.ts
+/**
+* Explicit resume targets are multipart-only and must fail closed on small uploads.
+*
+* @param options - High-level upload options.
+* @param caller - Public method name used in the thrown error.
+*
+* @throws Error when an explicit resume target is supplied for a small upload.
+*/
+function rejectSmallResumeFileId(options, caller) {
+	if (options.resumeFileId !== void 0) throw new Error(`${caller}: resumeFileId is only supported for multipart uploads.`);
+}
+/**
+* Removes resume-only options before forwarding to the small-file upload path.
+*
+* @param options - High-level upload options.
+*
+* @returns Options accepted by the single-request upload implementation.
+*/
+function stripResumeOnlyOptions(options) {
+	const { resume: _resume, resumeFileId: _resumeFileId, onResumeCandidateRejected: _onResumeCandidateRejected, onResumePartReused: _onResumePartReused, resumeDiscoveryTimeoutMs: _resumeDiscoveryTimeoutMs, resumeMaxListPages: _resumeMaxListPages, resumeMaxPartCandidates: _resumeMaxPartCandidates, resumeMaxPartPages: _resumeMaxPartPages, ...smallOptions } = options;
+	return smallOptions;
+}
+//#endregion
+export { rejectSmallResumeFileId, stripResumeOnlyOptions };
+
+//# sourceMappingURL=options.js.map

package/dist/upload/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","names":[],"sources":["../../src/upload/options.ts"],"sourcesContent":["import type { ProgressListener } from '../streams/progress.ts'\nimport type { ContentSource } from '../streams/source.ts'\nimport type { EncryptionSetting } from '../types/encryption.ts'\nimport type { LargeFileId } from '../types/ids.ts'\nimport type { FileRetentionValue, LegalHoldValue } from '../types/lock.ts'\nimport type { CleanupFailureOptions } from './cancel.ts'\nimport type { ResumePartReusedListener } from './large.ts'\nimport type { ResumeCandidateRejectedListener } from './resume.ts'\nimport type { UploadRetryOptions } from './retry.ts'\n\n/** Shared options for high-level file uploads. */\nexport interface HighLevelUploadOptions extends UploadRetryOptions, CleanupFailureOptions {\n  /**\n   * Data source to upload. Use {@link BufferSource}, {@link BlobSource}, {@link FileSource},\n   * {@link StreamSource}, or {@link toContentSource} for async iterables and Node Readables.\n   */\n  readonly source: ContentSource\n  /** MIME type. Defaults to `\"b2/x-auto\"` (auto-detected by B2). */\n  readonly contentType?: string\n  /** Custom key-value metadata stored with the file. */\n  readonly fileInfo?: Record<string, string>\n  /** Server-side encryption settings. */\n  readonly serverSideEncryption?: EncryptionSetting\n  /** File retention policy (requires file lock on the bucket). */\n  readonly fileRetention?: FileRetentionValue\n  /** Legal hold status for the file. */\n  readonly legalHold?: LegalHoldValue\n  /** Last-modified timestamp in milliseconds since epoch. */\n  readonly lastModifiedMillis?: number\n  /** Part size override for multipart uploads, in bytes. */\n  readonly partSize?: number\n  /** Number of concurrent part uploads for large files. */\n  readonly concurrency?: number\n  /** Callback invoked with upload progress events. */\n  readonly onProgress?: ProgressListener\n  /** Abort signal for cancelling the upload. */\n  readonly signal?: AbortSignal\n  /** Enable bounded same-name multipart resume discovery. Ignored on the small-file path. */\n  readonly resume?: boolean\n  /** Optional aggregate SDK-enforced timeout for resume discovery. */\n  readonly resumeDiscoveryTimeoutMs?: number\n  /** Maximum `b2_list_unfinished_large_files` pages inspected before upload starts. */\n  readonly resumeMaxListPages?: number\n  /** Maximum metadata-compatible candidates whose parts may be listed before upload starts. */\n  readonly resumeMaxPartCandidates?: number\n  /** Maximum `b2_list_parts` pages inspected per metadata-compatible candidate. */\n  readonly resumeMaxPartPages?: number\n  /**\n   * Explicit unfinished large-file ID to verify and resume. Only supported on\n   * the large-file path; small-file uploads throw.\n   */\n  readonly resumeFileId?: LargeFileId\n  /** Diagnostic callback invoked when resume discovery rejects a candidate. */\n  readonly onResumeCandidateRejected?: ResumeCandidateRejectedListener\n  /** Diagnostic callback invoked when resume reuses an already-uploaded part. */\n  readonly onResumePartReused?: ResumePartReusedListener\n}\n\n/** Backwards-compatible name for high-level upload options. */\nexport type UploadOptions = HighLevelUploadOptions\n\n/** Options accepted by {@link Bucket.upload}. */\nexport interface BucketUploadOptions extends HighLevelUploadOptions {\n  /** Destination file name (path) in the bucket. */\n  readonly fileName: string\n}\n\n/** Options accepted by {@link B2Object.upload}. */\nexport type B2ObjectUploadOptions = HighLevelUploadOptions\n\n/** Options accepted by {@link B2Object.createWriteStream}. */\nexport interface B2ObjectWriteStreamOptions extends UploadRetryOptions, CleanupFailureOptions {\n  /** MIME type. Defaults to `\"b2/x-auto\"`. */\n  readonly contentType?: string\n  /** Custom key-value metadata stored with the file. */\n  readonly fileInfo?: Record<string, string>\n  /** Server-side encryption applied to each part. */\n  readonly serverSideEncryption?: EncryptionSetting\n  /** Target part size in bytes. Defaults to the account's recommended part size. */\n  readonly partSize?: number\n  /** Maximum number of parts uploaded in parallel. Defaults to 4. */\n  readonly concurrency?: number\n  /** Callback invoked with upload progress events. */\n  readonly onProgress?: ProgressListener\n  /** Abort signal that cancels the upload and the unfinished large file. */\n  readonly signal?: AbortSignal\n}\n\ntype ResumeOnlyUploadOptions = Pick<\n  HighLevelUploadOptions,\n  | 'resume'\n  | 'resumeFileId'\n  | 'onResumeCandidateRejected'\n  | 'onResumePartReused'\n  | 'resumeDiscoveryTimeoutMs'\n  | 'resumeMaxListPages'\n  | 'resumeMaxPartCandidates'\n  | 'resumeMaxPartPages'\n>\n\n/** High-level upload options after resume-only settings have been removed. */\nexport type SmallUploadOptions<T extends HighLevelUploadOptions> = Omit<\n  T,\n  keyof ResumeOnlyUploadOptions\n>\n\n/**\n * Explicit resume targets are multipart-only and must fail closed on small uploads.\n *\n * @param options - High-level upload options.\n * @param caller - Public method name used in the thrown error.\n *\n * @throws Error when an explicit resume target is supplied for a small upload.\n */\nexport function rejectSmallResumeFileId(options: HighLevelUploadOptions, caller: string): void {\n  if (options.resumeFileId !== undefined) {\n    throw new Error(`${caller}: resumeFileId is only supported for multipart uploads.`)\n  }\n}\n\n/**\n * Removes resume-only options before forwarding to the small-file upload path.\n *\n * @param options - High-level upload options.\n *\n * @returns Options accepted by the single-request upload implementation.\n */\nexport function stripResumeOnlyOptions<T extends HighLevelUploadOptions>(\n  options: T,\n): SmallUploadOptions<T> {\n  const {\n    resume: _resume,\n    resumeFileId: _resumeFileId,\n    onResumeCandidateRejected: _onResumeCandidateRejected,\n    onResumePartReused: _onResumePartReused,\n    resumeDiscoveryTimeoutMs: _resumeDiscoveryTimeoutMs,\n    resumeMaxListPages: _resumeMaxListPages,\n    resumeMaxPartCandidates: _resumeMaxPartCandidates,\n    resumeMaxPartPages: _resumeMaxPartPages,\n    ...smallOptions\n  } = options\n  return smallOptions\n}\n"],"mappings":";;;;;;;;;AAkHA,SAAgB,wBAAwB,SAAiC,QAAsB;CAC7F,IAAI,QAAQ,iBAAiB,KAAA,GAC3B,MAAM,IAAI,MAAM,GAAG,OAAO,wDAAwD;AAEtF;;;;;;;;AASA,SAAgB,uBACd,SACuB;CACvB,MAAM,EACJ,QAAQ,SACR,cAAc,eACd,2BAA2B,4BAC3B,oBAAoB,qBACpB,0BAA0B,2BAC1B,oBAAoB,qBACpB,yBAAyB,0BACzB,oBAAoB,qBACpB,GAAG,iBACD;CACJ,OAAO;AACT"}