@backblaze-labs/b2-sdk 0.1.0 → 0.2.0

package/dist/streams/source.js.map

@@ -1 +1 @@
-{"version":3,"file":"source.js","sources":["../../src/streams/source.ts"],"sourcesContent":["import { collectStream } from './collect.ts'\n\n/**\n * Uniform adapter for upload content. Wraps File, Blob, Buffer, or ReadableStream\n * behind a common interface so upload logic does not depend on the input type.\n */\nexport interface ContentSource {\n  /** Total size of the content in bytes. */\n  readonly size: number\n  /** Pre-computed SHA-1 hex digest, if available. */\n  readonly sha1?: string\n  /**\n   * Whether {@link slice} is safe to call on this source.\n   *\n   * `true` for in-memory / random-access sources (`BufferSource`,\n   * `BlobSource`) — the multipart upload engine can dispatch part reads\n   * in parallel by slicing the source into disjoint ranges. `false`\n   * for forward-only sources (`StreamSource`) — the engine must read\n   * sequentially, one `partSize` chunk at a time. Callers that branch\n   * on this flag are expected to fall back to the sequential path\n   * rather than call `slice()` and catch the throw.\n   */\n  readonly canSlice: boolean\n  /** Return a sub-range of this source as a new ContentSource. */\n  slice(start: number, end: number): ContentSource\n  /** Open the content as a ReadableStream. */\n  stream(): ReadableStream<Uint8Array>\n  /** Read the entire content into an ArrayBuffer. */\n  toArrayBuffer(): Promise<ArrayBuffer>\n}\n\n/** ContentSource backed by a Blob or File. */\nexport class BlobSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /** Random-access: `Blob.slice()` is cheap and returns a new Blob view. */\n  readonly canSlice = true\n\n  /**\n   * Create a BlobSource wrapping the given Blob.\n   * @param blob - The Blob or File to use as the underlying content.\n   */\n  constructor(private readonly blob: Blob) {\n    this.size = blob.size\n  }\n\n  /**\n   * Return a new BlobSource covering the specified byte range.\n   * @param start - The zero-based byte offset to begin the slice.\n   * @param end - The exclusive byte offset where the slice ends.\n   *\n   * @returns A new ContentSource representing the requested sub-range.\n   */\n  slice(start: number, end: number): ContentSource {\n    return new BlobSource(this.blob.slice(start, end))\n  }\n\n  /**\n   * Open the Blob content as a ReadableStream.\n   * @returns A ReadableStream of the Blob bytes.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    return this.blob.stream() as ReadableStream<Uint8Array>\n  }\n\n  /**\n   * Read the entire Blob content into an ArrayBuffer.\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  toArrayBuffer(): Promise<ArrayBuffer> {\n    return this.blob.arrayBuffer()\n  }\n}\n\n/** ContentSource backed by a Uint8Array buffer. */\nexport class BufferSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /** Random-access: the entire payload lives in memory. */\n  readonly canSlice = true\n\n  /**\n   * Create a BufferSource wrapping the given Uint8Array.\n   * @param buffer - The byte buffer to use as the underlying content.\n   */\n  constructor(private readonly buffer: Uint8Array) {\n    this.size = buffer.byteLength\n  }\n\n  /**\n   * Return a new BufferSource covering the specified byte range.\n   * @param start - The zero-based byte offset to begin the slice.\n   * @param end - The exclusive byte offset where the slice ends.\n   *\n   * @returns A new ContentSource representing the requested sub-range.\n   */\n  slice(start: number, end: number): ContentSource {\n    return new BufferSource(this.buffer.slice(start, end))\n  }\n\n  /**\n   * Open the buffer content as a ReadableStream.\n   * @returns A ReadableStream that emits the buffer bytes in a single chunk.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    const buffer = this.buffer\n    return new ReadableStream({\n      start(controller) {\n        controller.enqueue(buffer)\n        controller.close()\n      },\n    })\n  }\n\n  /**\n   * Read the entire buffer content into an ArrayBuffer.\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  toArrayBuffer(): Promise<ArrayBuffer> {\n    return Promise.resolve(\n      this.buffer.buffer.slice(\n        this.buffer.byteOffset,\n        this.buffer.byteOffset + this.buffer.byteLength,\n      ) as ArrayBuffer,\n    )\n  }\n}\n\n/** ContentSource backed by a ReadableStream. Can only be consumed once and does not support slicing. */\nexport class StreamSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /**\n   * Forward-only: ReadableStreams cannot be repositioned, so multipart\n   * uploads must take the sequential path. See the interface comment on\n   * `canSlice` for what the engine does with this flag.\n   */\n  readonly canSlice = false\n  /** Whether the stream has already been read. */\n  private consumed = false\n\n  /**\n   * Create a StreamSource wrapping the given ReadableStream with a known byte size.\n   * @param readable - The ReadableStream to wrap as a content source.\n   * @param size - The total number of bytes the stream will produce.\n   */\n  constructor(\n    private readonly readable: ReadableStream<Uint8Array>,\n    size: number,\n  ) {\n    this.size = size\n  }\n\n  /**\n   * Always throws because streams cannot be sliced. Buffer the stream first.\n   *\n   * @throws If slicing is attempted on a stream-backed source.\n   */\n  slice(): ContentSource {\n    throw new Error('StreamSource does not support slicing. Buffer the stream first.')\n  }\n\n  /**\n   * Open the underlying ReadableStream. Can only be called once.\n   * @returns The underlying ReadableStream of bytes.\n   *\n   * @throws If the stream has already been consumed.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    if (this.consumed) throw new Error('StreamSource can only be consumed once.')\n    this.consumed = true\n    return this.readable\n  }\n\n  /**\n   * Read the entire stream into an ArrayBuffer.\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  async toArrayBuffer(): Promise<ArrayBuffer> {\n    const bytes = await collectStream(this.stream())\n    return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength) as ArrayBuffer\n  }\n}\n\n/**\n * Convert a Uint8Array, Blob, or ReadableStream into a {@link ContentSource}.\n * When passing a ReadableStream, the `size` parameter is required.\n * @param input - The content to wrap, as a Uint8Array, Blob, or ReadableStream.\n * @param size - The total byte length, required when input is a ReadableStream.\n *\n * @returns A ContentSource adapter for the given input.\n *\n * @throws If input is a ReadableStream and size is not provided.\n */\nexport function toContentSource(\n  input: Uint8Array | Blob | ReadableStream<Uint8Array>,\n  size?: number,\n): ContentSource {\n  if (input instanceof Uint8Array) {\n    return new BufferSource(input)\n  }\n  if (input instanceof Blob) {\n    return new BlobSource(input)\n  }\n  if (size === undefined) {\n    throw new Error('size is required when using a ReadableStream as input.')\n  }\n  return new StreamSource(input, size)\n}\n"],"names":[],"mappings":";AAgCO,MAAM,WAAoC;AAAA;AAAA;AAAA;AAAA;AAAA,EAU/C,YAA6B,MAAY;AAAZ,SAAA,OAAA;AAC3B,SAAK,OAAO,KAAK;AAAA,EACnB;AAAA;AAAA,EAVS;AAAA;AAAA,EAEA,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBpB,MAAM,OAAe,KAA4B;AAC/C,WAAO,IAAI,WAAW,KAAK,KAAK,MAAM,OAAO,GAAG,CAAC;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,SAAqC;AACnC,WAAO,KAAK,KAAK,OAAA;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,gBAAsC;AACpC,WAAO,KAAK,KAAK,YAAA;AAAA,EACnB;AACF;AAGO,MAAM,aAAsC;AAAA;AAAA;AAAA;AAAA;AAAA,EAUjD,YAA6B,QAAoB;AAApB,SAAA,SAAA;AAC3B,SAAK,OAAO,OAAO;AAAA,EACrB;AAAA;AAAA,EAVS;AAAA;AAAA,EAEA,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBpB,MAAM,OAAe,KAA4B;AAC/C,WAAO,IAAI,aAAa,KAAK,OAAO,MAAM,OAAO,GAAG,CAAC;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,SAAqC;AACnC,UAAM,SAAS,KAAK;AACpB,WAAO,IAAI,eAAe;AAAA,MACxB,MAAM,YAAY;AAChB,mBAAW,QAAQ,MAAM;AACzB,mBAAW,MAAA;AAAA,MACb;AAAA,IAAA,CACD;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,gBAAsC;AACpC,WAAO,QAAQ;AAAA,MACb,KAAK,OAAO,OAAO;AAAA,QACjB,KAAK,OAAO;AAAA,QACZ,KAAK,OAAO,aAAa,KAAK,OAAO;AAAA,MAAA;AAAA,IACvC;AAAA,EAEJ;AACF;AAGO,MAAM,aAAsC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBjD,YACmB,UACjB,MACA;AAFiB,SAAA,WAAA;AAGjB,SAAK,OAAO;AAAA,EACd;AAAA;AAAA,EApBS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,WAAW;AAAA;AAAA,EAEZ,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBnB,QAAuB;AACrB,UAAM,IAAI,MAAM,iEAAiE;AAAA,EACnF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,SAAqC;AACnC,QAAI,KAAK,SAAU,OAAM,IAAI,MAAM,yCAAyC;AAC5E,SAAK,WAAW;AAChB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,gBAAsC;AAC1C,UAAM,QAAQ,MAAM,cAAc,KAAK,QAAQ;AAC/C,WAAO,MAAM,OAAO,MAAM,MAAM,YAAY,MAAM,aAAa,MAAM,UAAU;AAAA,EACjF;AACF;AAYO,SAAS,gBACd,OACA,MACe;AACf,MAAI,iBAAiB,YAAY;AAC/B,WAAO,IAAI,aAAa,KAAK;AAAA,EAC/B;AACA,MAAI,iBAAiB,MAAM;AACzB,WAAO,IAAI,WAAW,KAAK;AAAA,EAC7B;AACA,MAAI,SAAS,QAAW;AACtB,UAAM,IAAI,MAAM,wDAAwD;AAAA,EAC1E;AACA,SAAO,IAAI,aAAa,OAAO,IAAI;AACrC;"}
+{"version":3,"file":"source.js","names":[],"sources":["../../src/streams/source.ts"],"sourcesContent":["import { arrayBufferFor } from '../util/bytes.ts'\nimport { collectStream } from './collect.ts'\n\nexport { FileSource, type FileSourcePath } from './file-source.ts'\n\nconst READABLE_STREAM_SIZE_REQUIRED_ERROR = 'size is required when using a ReadableStream as input.'\nconst FORWARD_ONLY_SIZE_REQUIRED_ERROR =\n  'size is required when using a forward-only content source as input.'\nconst STREAM_SOURCE_ENDED_EARLY_ERROR = 'StreamSource ended before the advertised byte count.'\nconst STREAM_SOURCE_TOO_MANY_BYTES_ERROR =\n  'StreamSource emitted more bytes than the advertised byte count.'\nconst STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR =\n  'StreamSource emitted too many empty chunks without data.'\n/** Maximum consecutive empty chunks tolerated from a forward-only stream. */\nexport const MAX_EMPTY_STREAM_CHUNKS = 1024\n\nfunction asyncIterableToReadableStream(\n  iterable: AsyncIterable<Uint8Array>,\n): ReadableStream<Uint8Array> {\n  const iterator = iterable[Symbol.asyncIterator]()\n  return new ReadableStream<Uint8Array>({\n    async pull(controller) {\n      try {\n        const { done, value } = await iterator.next()\n        if (done === true) {\n          controller.close()\n          return\n        }\n        if (!(value instanceof Uint8Array)) {\n          throw new TypeError('Async iterable content sources must yield Uint8Array chunks.')\n        }\n        controller.enqueue(value)\n      } catch (err) {\n        /* v8 ignore next -- Iterator-return failure must not mask the pull error. */\n        await returnAsyncIteratorBestEffort(iterator)\n        throw err\n      }\n    },\n    async cancel(reason) {\n      await returnAsyncIteratorBestEffort(iterator, reason)\n    },\n  })\n}\n\nasync function returnAsyncIteratorBestEffort(\n  iterator: AsyncIterator<Uint8Array>,\n  reason?: unknown,\n): Promise<void> {\n  try {\n    await iterator.return?.(reason)\n  } catch {\n    // Iterator cleanup is secondary and must not mask the pull error.\n  }\n}\n\nfunction isAsyncIterable(input: unknown): input is AsyncIterable<Uint8Array> {\n  return (\n    typeof input === 'object' &&\n    input !== null &&\n    Symbol.asyncIterator in input &&\n    typeof input[Symbol.asyncIterator] === 'function'\n  )\n}\n\nfunction isReadableStream(input: unknown): input is ReadableStream<Uint8Array> {\n  return (\n    typeof input === 'object' &&\n    input !== null &&\n    typeof (input as { getReader?: unknown }).getReader === 'function'\n  )\n}\n\n/**\n * Uniform adapter for upload content. Wraps File, Blob, Buffer, local files,\n * async iterables, or ReadableStream behind a common interface so upload logic\n * does not depend on the input type.\n */\nexport interface ContentSource {\n  /** Total size of the content in bytes. */\n  readonly size: number\n  /** Pre-computed SHA-1 hex digest, if available. */\n  readonly sha1?: string\n  /**\n   * Whether {@link slice} is safe to call on this source.\n   *\n   * `true` for in-memory / random-access sources (`BufferSource`,\n   * `BlobSource`, `FileSource`) — the multipart upload engine can dispatch\n   * part reads in parallel by slicing the source into disjoint ranges.\n   * `false` for forward-only streams and async iterables — the engine must\n   * read sequentially, one `partSize` chunk at a time. Callers that branch on\n   * this flag are expected to fall back to the sequential path rather than call\n   * `slice()` and catch the throw.\n   */\n  readonly canSlice: boolean\n  /** Return a sub-range of this source as a new ContentSource. */\n  slice(start: number, end: number): ContentSource\n  /** Open the content as a ReadableStream. */\n  stream(): ReadableStream<Uint8Array>\n  /** Read the entire content into an ArrayBuffer. */\n  toArrayBuffer(options?: { readonly signal?: AbortSignal }): Promise<ArrayBuffer>\n}\n\n/** ContentSource backed by a Blob or File. */\nexport class BlobSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /** Random-access: `Blob.slice()` is cheap and returns a new Blob view. */\n  readonly canSlice = true\n\n  /**\n   * Create a BlobSource wrapping the given Blob.\n   * @param blob - The Blob or File to use as the underlying content.\n   */\n  constructor(private readonly blob: Blob) {\n    this.size = blob.size\n  }\n\n  /**\n   * Return a new BlobSource covering the specified byte range.\n   * @param start - The zero-based byte offset to begin the slice.\n   * @param end - The exclusive byte offset where the slice ends.\n   *\n   * @returns A new ContentSource representing the requested sub-range.\n   */\n  slice(start: number, end: number): ContentSource {\n    return new BlobSource(this.blob.slice(start, end))\n  }\n\n  /**\n   * Open the Blob content as a ReadableStream.\n   * @returns A ReadableStream of the Blob bytes.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    return this.blob.stream() as ReadableStream<Uint8Array>\n  }\n\n  /**\n   * Read the entire Blob content into an ArrayBuffer.\n   * @param options - Optional abort signal used while reading.\n   *\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  async toArrayBuffer(options: { readonly signal?: AbortSignal } = {}): Promise<ArrayBuffer> {\n    options.signal?.throwIfAborted()\n    if (options.signal === undefined) return this.blob.arrayBuffer()\n    const bytes = await collectStream(this.stream(), options)\n    return arrayBufferFor(bytes)\n  }\n}\n\n/** ContentSource backed by a Uint8Array buffer. */\nexport class BufferSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /** Random-access: the entire payload lives in memory. */\n  readonly canSlice = true\n\n  /**\n   * Create a BufferSource wrapping the given Uint8Array.\n   * @param buffer - The byte buffer to use as the underlying content.\n   */\n  constructor(private readonly buffer: Uint8Array) {\n    this.size = buffer.byteLength\n  }\n\n  /**\n   * Return a new BufferSource covering the specified byte range.\n   * @param start - The zero-based byte offset to begin the slice.\n   * @param end - The exclusive byte offset where the slice ends.\n   *\n   * @returns A new ContentSource representing the requested sub-range.\n   */\n  slice(start: number, end: number): ContentSource {\n    return new BufferSource(this.buffer.slice(start, end))\n  }\n\n  /**\n   * Open the buffer content as a ReadableStream.\n   * @returns A ReadableStream that emits the buffer bytes in a single chunk.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    const buffer = this.buffer\n    return new ReadableStream({\n      start(controller) {\n        controller.enqueue(buffer)\n        controller.close()\n      },\n    })\n  }\n\n  /**\n   * Read the entire buffer content into an ArrayBuffer.\n   * @param options - Optional abort signal checked before returning bytes.\n   *\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  async toArrayBuffer(options: { readonly signal?: AbortSignal } = {}): Promise<ArrayBuffer> {\n    options.signal?.throwIfAborted()\n    return arrayBufferFor(this.buffer)\n  }\n}\n\n/** ContentSource backed by a ReadableStream. Can only be consumed once and does not support slicing. */\nexport class StreamSource implements ContentSource {\n  /** {@inheritDoc} */\n  readonly size: number\n  /**\n   * Forward-only: ReadableStreams cannot be repositioned, so multipart\n   * uploads must take the sequential path. See the interface comment on\n   * `canSlice` for what the engine does with this flag.\n   */\n  readonly canSlice = false\n  /** Whether the stream has already been read. */\n  private consumed = false\n\n  /**\n   * Create a StreamSource wrapping the given ReadableStream with a known byte size.\n   * @param readable - The ReadableStream to wrap as a content source.\n   * @param size - The total number of bytes the stream will produce.\n   */\n  constructor(\n    private readonly readable: ReadableStream<Uint8Array>,\n    size: number,\n  ) {\n    validateStreamSourceSize(size)\n    this.size = size\n  }\n\n  /**\n   * Always throws because streams cannot be sliced. Buffer the stream first.\n   *\n   * @throws If slicing is attempted on a stream-backed source.\n   */\n  slice(): ContentSource {\n    throw new Error('StreamSource does not support slicing. Buffer the stream first.')\n  }\n\n  /**\n   * Open the underlying ReadableStream. Can only be called once.\n   * @returns The underlying ReadableStream of bytes.\n   *\n   * @throws If the stream has already been consumed.\n   */\n  stream(): ReadableStream<Uint8Array> {\n    if (this.consumed) throw new Error('StreamSource can only be consumed once.')\n    this.consumed = true\n    return this.readable\n  }\n\n  /**\n   * Read the entire stream into an ArrayBuffer.\n   * @param options - Optional abort signal used while reading.\n   *\n   * @returns A promise that resolves with the full content as an ArrayBuffer.\n   */\n  async toArrayBuffer(options: { readonly signal?: AbortSignal } = {}): Promise<ArrayBuffer> {\n    const bytes = await collectStreamExactly(this.stream(), this.size, options.signal)\n    return bytes.buffer as ArrayBuffer\n  }\n}\n\nfunction validateStreamSourceSize(size: number): void {\n  if (!Number.isFinite(size) || !Number.isInteger(size) || size < 0) {\n    throw new RangeError('StreamSource size must be a non-negative finite integer.')\n  }\n}\n\n/**\n * Reads exactly the advertised number of bytes from a stream.\n * @param stream - Stream to consume.\n * @param expectedSize - Exact number of bytes expected from the stream.\n * @param signal - Optional abort signal for cancelling the read.\n *\n * @returns A byte array of length `expectedSize`.\n *\n * @throws If the stream emits too few bytes, too many bytes, too many empty chunks, or aborts.\n */\nexport async function collectStreamExactly(\n  stream: ReadableStream<Uint8Array>,\n  expectedSize: number,\n  signal?: AbortSignal,\n): Promise<Uint8Array<ArrayBuffer>> {\n  const reader = stream.getReader()\n  const chunks: Uint8Array[] = []\n  let total = 0\n  let completed = false\n\n  try {\n    while (total < expectedSize) {\n      const { done, value } = await readNextNonEmptyStreamChunk(\n        reader,\n        STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR,\n        signal,\n      )\n      if (done) throw new Error(STREAM_SOURCE_ENDED_EARLY_ERROR)\n      if (total + value.byteLength > expectedSize) {\n        throw new Error(STREAM_SOURCE_TOO_MANY_BYTES_ERROR)\n      }\n      chunks.push(value)\n      total += value.byteLength\n    }\n\n    const extra = await readNextNonEmptyStreamChunk(\n      reader,\n      STREAM_SOURCE_TOO_MANY_EMPTY_CHUNKS_ERROR,\n      signal,\n    )\n    if (!extra.done) throw new Error(STREAM_SOURCE_TOO_MANY_BYTES_ERROR)\n\n    const result = new Uint8Array(expectedSize)\n    let offset = 0\n    for (const chunk of chunks) {\n      result.set(chunk, offset)\n      offset += chunk.byteLength\n    }\n    completed = true\n    return result\n  } finally {\n    if (!completed) {\n      cancelReaderBestEffort(reader)\n    }\n    try {\n      reader.releaseLock()\n    } catch {\n      // Aborted reads can leave a pending read while best-effort cancel is\n      // still unsettled. Preserve the original abort/error instead.\n    }\n  }\n}\n\n/**\n * Reads from a stream until it receives data, EOF, or too many consecutive empty chunks.\n * @param reader - Locked reader for a Uint8Array stream.\n * @param emptyChunkErrorMessage - Error message to throw when the empty-chunk limit is exceeded.\n * @param signal - Optional abort signal that cancels the reader and rejects the read.\n *\n * @returns The next non-empty chunk or EOF result.\n */\nexport async function readNextNonEmptyStreamChunk(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  emptyChunkErrorMessage: string,\n  signal?: AbortSignal,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  let emptyChunks = 0\n  while (true) {\n    const result = await readStreamChunk(reader, signal)\n    if (result.done || result.value.byteLength > 0) return result\n    emptyChunks += 1\n    if (emptyChunks > MAX_EMPTY_STREAM_CHUNKS) {\n      throw new Error(emptyChunkErrorMessage)\n    }\n  }\n}\n\nasync function readStreamChunk(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  signal: AbortSignal | undefined,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  if (signal === undefined) return reader.read()\n  if (signal.aborted) {\n    const reason = signal.reason ?? new DOMException('Aborted', 'AbortError')\n    cancelReaderBestEffort(reader, reason)\n    throw reason\n  }\n\n  let removeAbortListener: (() => void) | undefined\n  const abort = new Promise<never>((_, reject) => {\n    const onAbort = (): void => {\n      const reason = signal.reason ?? new DOMException('Aborted', 'AbortError')\n      cancelReaderBestEffort(reader, reason)\n      reject(reason)\n    }\n    signal.addEventListener('abort', onAbort, { once: true })\n    removeAbortListener = () => signal.removeEventListener('abort', onAbort)\n  })\n\n  try {\n    const result = await Promise.race([reader.read(), abort])\n    if (signal.aborted) {\n      const reason = signal.reason ?? new DOMException('Aborted', 'AbortError')\n      cancelReaderBestEffort(reader, reason)\n      throw reason\n    }\n    return result\n  } finally {\n    removeAbortListener?.()\n  }\n}\n\nfunction cancelReaderBestEffort(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  reason?: unknown,\n): void {\n  /* v8 ignore next -- Reader cancellation failure is deliberately best-effort. */\n  void reader.cancel(reason).catch(() => {})\n}\n\n/** ContentSource backed by a forward-only async iterable of Uint8Array chunks. */\nclass AsyncIterableSource extends StreamSource {\n  /**\n   * Create an AsyncIterableSource from a known-size async iterable.\n   * @param iterable - Async iterable that yields Uint8Array chunks.\n   * @param size - Total byte length the iterable will produce.\n   */\n  constructor(iterable: AsyncIterable<Uint8Array>, size: number) {\n    super(asyncIterableToReadableStream(iterable), size)\n  }\n}\n\n/**\n * Convert a Uint8Array, Blob, ReadableStream, or async iterable into a {@link ContentSource}.\n * When passing a ReadableStream or async iterable, the `size` parameter is required.\n * @param input - The content to wrap.\n * @param size - The total byte length, required for forward-only inputs.\n *\n * @returns A ContentSource adapter for the given input.\n *\n * @throws If input is forward-only and size is not provided.\n */\nexport function toContentSource(\n  input: Uint8Array | Blob | ReadableStream<Uint8Array> | AsyncIterable<Uint8Array>,\n  size?: number,\n): ContentSource {\n  if (input instanceof Uint8Array) {\n    return new BufferSource(input)\n  }\n  if (input instanceof Blob) {\n    return new BlobSource(input)\n  }\n  if (isReadableStream(input)) {\n    if (size === undefined) {\n      throw new Error(READABLE_STREAM_SIZE_REQUIRED_ERROR)\n    }\n    return new StreamSource(input, size)\n  }\n  if (isAsyncIterable(input)) {\n    if (size === undefined) {\n      throw new Error(FORWARD_ONLY_SIZE_REQUIRED_ERROR)\n    }\n    return new AsyncIterableSource(input, size)\n  }\n  throw new TypeError('Unsupported content source input.')\n}\n"],"mappings":";;;;AAKA,IAAM,sCAAsC;AAC5C,IAAM,mCACJ;AACF,IAAM,kCAAkC;AACxC,IAAM,qCACJ;AACF,IAAM,4CACJ;;AAEF,IAAa,0BAA0B;AAEvC,SAAS,8BACP,UAC4B;CAC5B,MAAM,WAAW,SAAS,OAAO,cAAc,CAAC;CAChD,OAAO,IAAI,eAA2B;EACpC,MAAM,KAAK,YAAY;GACrB,IAAI;IACF,MAAM,EAAE,MAAM,UAAU,MAAM,SAAS,KAAK;IAC5C,IAAI,SAAS,MAAM;KACjB,WAAW,MAAM;KACjB;IACF;IACA,IAAI,EAAE,iBAAiB,aACrB,MAAM,IAAI,UAAU,8DAA8D;IAEpF,WAAW,QAAQ,KAAK;GAC1B,SAAS,KAAK;;IAEZ,MAAM,8BAA8B,QAAQ;IAC5C,MAAM;GACR;EACF;EACA,MAAM,OAAO,QAAQ;GACnB,MAAM,8BAA8B,UAAU,MAAM;EACtD;CACF,CAAC;AACH;AAEA,eAAe,8BACb,UACA,QACe;CACf,IAAI;EACF,MAAM,SAAS,SAAS,MAAM;CAChC,QAAQ,CAER;AACF;AAEA,SAAS,gBAAgB,OAAoD;CAC3E,OACE,OAAO,UAAU,YACjB,UAAU,QACV,OAAO,iBAAiB,SACxB,OAAO,MAAM,OAAO,mBAAmB;AAE3C;AAEA,SAAS,iBAAiB,OAAqD;CAC7E,OACE,OAAO,UAAU,YACjB,UAAU,QACV,OAAQ,MAAkC,cAAc;AAE5D;;AAiCA,IAAa,aAAb,MAAa,WAAoC;CAUlB;;CAR7B;;CAEA,WAAoB;;;;;CAMpB,YAAY,MAA6B;EAAZ,KAAA,OAAA;EAC3B,KAAK,OAAO,KAAK;CACnB;;;;;;;;CASA,MAAM,OAAe,KAA4B;EAC/C,OAAO,IAAI,WAAW,KAAK,KAAK,MAAM,OAAO,GAAG,CAAC;CACnD;;;;;CAMA,SAAqC;EACnC,OAAO,KAAK,KAAK,OAAO;CAC1B;;;;;;;CAQA,MAAM,cAAc,UAA6C,CAAC,GAAyB;EACzF,QAAQ,QAAQ,eAAe;EAC/B,IAAI,QAAQ,WAAW,KAAA,GAAW,OAAO,KAAK,KAAK,YAAY;EAE/D,OAAO,eAAe,MADF,cAAc,KAAK,OAAO,GAAG,OAAO,CAC7B;CAC7B;AACF;;AAGA,IAAa,eAAb,MAAa,aAAsC;CAUpB;;CAR7B;;CAEA,WAAoB;;;;;CAMpB,YAAY,QAAqC;EAApB,KAAA,SAAA;EAC3B,KAAK,OAAO,OAAO;CACrB;;;;;;;;CASA,MAAM,OAAe,KAA4B;EAC/C,OAAO,IAAI,aAAa,KAAK,OAAO,MAAM,OAAO,GAAG,CAAC;CACvD;;;;;CAMA,SAAqC;EACnC,MAAM,SAAS,KAAK;EACpB,OAAO,IAAI,eAAe,EACxB,MAAM,YAAY;GAChB,WAAW,QAAQ,MAAM;GACzB,WAAW,MAAM;EACnB,EACF,CAAC;CACH;;;;;;;CAQA,MAAM,cAAc,UAA6C,CAAC,GAAyB;EACzF,QAAQ,QAAQ,eAAe;EAC/B,OAAO,eAAe,KAAK,MAAM;CACnC;AACF;;AAGA,IAAa,eAAb,MAAmD;CAkB9B;;CAhBnB;;;;;;CAMA,WAAoB;;CAEpB,WAAmB;;;;;;CAOnB,YACE,UACA,MACA;EAFiB,KAAA,WAAA;EAGjB,yBAAyB,IAAI;EAC7B,KAAK,OAAO;CACd;;;;;;CAOA,QAAuB;EACrB,MAAM,IAAI,MAAM,iEAAiE;CACnF;;;;;;;CAQA,SAAqC;EACnC,IAAI,KAAK,UAAU,MAAM,IAAI,MAAM,yCAAyC;EAC5E,KAAK,WAAW;EAChB,OAAO,KAAK;CACd;;;;;;;CAQA,MAAM,cAAc,UAA6C,CAAC,GAAyB;EAEzF,QAAO,MADa,qBAAqB,KAAK,OAAO,GAAG,KAAK,MAAM,QAAQ,MAAM,EAAA,CACpE;CACf;AACF;AAEA,SAAS,yBAAyB,MAAoB;CACpD,IAAI,CAAC,OAAO,SAAS,IAAI,KAAK,CAAC,OAAO,UAAU,IAAI,KAAK,OAAO,GAC9D,MAAM,IAAI,WAAW,0DAA0D;AAEnF;;;;;;;;;;;AAYA,eAAsB,qBACpB,QACA,cACA,QACkC;CAClC,MAAM,SAAS,OAAO,UAAU;CAChC,MAAM,SAAuB,CAAC;CAC9B,IAAI,QAAQ;CACZ,IAAI,YAAY;CAEhB,IAAI;EACF,OAAO,QAAQ,cAAc;GAC3B,MAAM,EAAE,MAAM,UAAU,MAAM,4BAC5B,QACA,2CACA,MACF;GACA,IAAI,MAAM,MAAM,IAAI,MAAM,+BAA+B;GACzD,IAAI,QAAQ,MAAM,aAAa,cAC7B,MAAM,IAAI,MAAM,kCAAkC;GAEpD,OAAO,KAAK,KAAK;GACjB,SAAS,MAAM;EACjB;EAOA,IAAI,EAAC,MALe,4BAClB,QACA,2CACA,MACF,EAAA,CACW,MAAM,MAAM,IAAI,MAAM,kCAAkC;EAEnE,MAAM,SAAS,IAAI,WAAW,YAAY;EAC1C,IAAI,SAAS;EACb,KAAK,MAAM,SAAS,QAAQ;GAC1B,OAAO,IAAI,OAAO,MAAM;GACxB,UAAU,MAAM;EAClB;EACA,YAAY;EACZ,OAAO;CACT,UAAU;EACR,IAAI,CAAC,WACH,uBAAuB,MAAM;EAE/B,IAAI;GACF,OAAO,YAAY;EACrB,QAAQ,CAGR;CACF;AACF;;;;;;;;;AAUA,eAAsB,4BACpB,QACA,wBACA,QAC+C;CAC/C,IAAI,cAAc;CAClB,OAAO,MAAM;EACX,MAAM,SAAS,MAAM,gBAAgB,QAAQ,MAAM;EACnD,IAAI,OAAO,QAAQ,OAAO,MAAM,aAAa,GAAG,OAAO;EACvD,eAAe;EACf,IAAI,cAAA,MACF,MAAM,IAAI,MAAM,sBAAsB;CAE1C;AACF;AAEA,eAAe,gBACb,QACA,QAC+C;CAC/C,IAAI,WAAW,KAAA,GAAW,OAAO,OAAO,KAAK;CAC7C,IAAI,OAAO,SAAS;EAClB,MAAM,SAAS,OAAO,UAAU,IAAI,aAAa,WAAW,YAAY;EACxE,uBAAuB,QAAQ,MAAM;EACrC,MAAM;CACR;CAEA,IAAI;CACJ,MAAM,QAAQ,IAAI,SAAgB,GAAG,WAAW;EAC9C,MAAM,gBAAsB;GAC1B,MAAM,SAAS,OAAO,UAAU,IAAI,aAAa,WAAW,YAAY;GACxE,uBAAuB,QAAQ,MAAM;GACrC,OAAO,MAAM;EACf;EACA,OAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;EACxD,4BAA4B,OAAO,oBAAoB,SAAS,OAAO;CACzE,CAAC;CAED,IAAI;EACF,MAAM,SAAS,MAAM,QAAQ,KAAK,CAAC,OAAO,KAAK,GAAG,KAAK,CAAC;EACxD,IAAI,OAAO,SAAS;GAClB,MAAM,SAAS,OAAO,UAAU,IAAI,aAAa,WAAW,YAAY;GACxE,uBAAuB,QAAQ,MAAM;GACrC,MAAM;EACR;EACA,OAAO;CACT,UAAU;EACR,sBAAsB;CACxB;AACF;AAEA,SAAS,uBACP,QACA,QACM;;CAEN,OAAY,OAAO,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;AAC3C;;AAGA,IAAM,sBAAN,cAAkC,aAAa;;;;;;CAM7C,YAAY,UAAqC,MAAc;EAC7D,MAAM,8BAA8B,QAAQ,GAAG,IAAI;CACrD;AACF;;;;;;;;;;;AAYA,SAAgB,gBACd,OACA,MACe;CACf,IAAI,iBAAiB,YACnB,OAAO,IAAI,aAAa,KAAK;CAE/B,IAAI,iBAAiB,MACnB,OAAO,IAAI,WAAW,KAAK;CAE7B,IAAI,iBAAiB,KAAK,GAAG;EAC3B,IAAI,SAAS,KAAA,GACX,MAAM,IAAI,MAAM,mCAAmC;EAErD,OAAO,IAAI,aAAa,OAAO,IAAI;CACrC;CACA,IAAI,gBAAgB,KAAK,GAAG;EAC1B,IAAI,SAAS,KAAA,GACX,MAAM,IAAI,MAAM,gCAAgC;EAElD,OAAO,IAAI,oBAAoB,OAAO,IAAI;CAC5C;CACA,MAAM,IAAI,UAAU,mCAAmC;AACzD"}

package/dist/sync/actions/index.cjs

@@ -1,186 +1,237 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-class UploadAction {
-  /**
-   * Creates a new UploadAction for the given relative path.
-   * @param relativePath - Path relative to the sync root.
-   * @param absolutePath - Absolute local filesystem path.
-   * @param size - File size in bytes.
-   * @param doUpload - Callback that performs the actual upload.
-   */
-  constructor(relativePath, absolutePath, size, doUpload) {
-    this.relativePath = relativePath;
-    this.absolutePath = absolutePath;
-    this.size = size;
-    this.doUpload = doUpload;
-  }
-  type = "upload";
-  /**
-   * Uploads the file (unless dryRun) and returns an 'upload-done' event.
-   * @param dryRun - Whether to simulate the action without making changes.
-   *
-   * @returns An async generator yielding sync progress events.
-   */
-  async execute(dryRun) {
-    if (!dryRun) {
-      await this.doUpload(this.absolutePath, this.relativePath);
-    }
-    return { type: "upload-done", path: this.relativePath, size: this.size };
-  }
-}
-class DownloadAction {
-  /**
-   * Creates a new DownloadAction for the given relative path.
-   * @param relativePath - Path relative to the sync root.
-   * @param size - File size in bytes.
-   * @param doDownload - Callback that performs the actual download.
-   */
-  constructor(relativePath, size, doDownload) {
-    this.relativePath = relativePath;
-    this.size = size;
-    this.doDownload = doDownload;
-  }
-  type = "download";
-  /**
-   * Downloads the file (unless dryRun) and returns a 'download-done' event.
-   * @param dryRun - Whether to simulate the action without making changes.
-   *
-   * @returns An async generator yielding sync progress events.
-   */
-  async execute(dryRun) {
-    if (!dryRun) {
-      await this.doDownload(this.relativePath);
-    }
-    return { type: "download-done", path: this.relativePath, size: this.size };
-  }
-}
-class CopyAction {
-  /**
-   * Creates a new CopyAction for the given relative path.
-   * @param relativePath - Path relative to the sync root.
-   * @param size - File size in bytes.
-   * @param doCopy - Callback that performs the server-side copy.
-   */
-  constructor(relativePath, size, doCopy) {
-    this.relativePath = relativePath;
-    this.size = size;
-    this.doCopy = doCopy;
-  }
-  type = "copy";
-  /**
-   * Copies the file (unless dryRun) and returns a 'copy-done' event.
-   * @param dryRun - Whether to simulate the action without making changes.
-   *
-   * @returns An async generator yielding sync progress events.
-   */
-  async execute(dryRun) {
-    if (!dryRun) {
-      await this.doCopy(this.relativePath);
-    }
-    return { type: "copy-done", path: this.relativePath, size: this.size };
-  }
-}
-class HideAction {
-  /**
-   * Creates a new HideAction for the given relative path.
-   * @param relativePath - Path relative to the sync root.
-   * @param doHide - Callback that creates the hide marker.
-   */
-  constructor(relativePath, doHide) {
-    this.relativePath = relativePath;
-    this.doHide = doHide;
-  }
-  type = "hide";
-  size = 0;
-  /**
-   * Hides the file (unless dryRun) and returns a 'hide' event.
-   * @param dryRun - Whether to simulate the action without making changes.
-   *
-   * @returns An async generator yielding sync progress events.
-   */
-  async execute(dryRun) {
-    if (!dryRun) {
-      await this.doHide(this.relativePath);
-    }
-    return { type: "hide", path: this.relativePath, size: 0 };
-  }
-}
-class DeleteRemoteAction {
-  /**
-   * Creates a new DeleteRemoteAction for the given relative path.
-   * @param relativePath - Path relative to the sync root.
-   * @param fileId - The B2 file version ID to delete.
-   * @param doDelete - Callback that performs the deletion.
-   */
-  constructor(relativePath, fileId, doDelete) {
-    this.relativePath = relativePath;
-    this.fileId = fileId;
-    this.doDelete = doDelete;
-  }
-  type = "delete-remote";
-  size = 0;
-  /**
-   * Deletes the remote file version (unless dryRun) and returns a 'delete-remote' event.
-   * @param dryRun - Whether to simulate the action without making changes.
-   *
-   * @returns An async generator yielding sync progress events.
-   */
-  async execute(dryRun) {
-    if (!dryRun) {
-      await this.doDelete(this.fileId, this.relativePath);
-    }
-    return { type: "delete-remote", path: this.relativePath, size: 0 };
-  }
-}
-class DeleteLocalAction {
-  /**
-   * Creates a new DeleteLocalAction for the given relative path.
-   * @param relativePath - Path relative to the sync root.
-   * @param absolutePath - Absolute local filesystem path.
-   * @param doDelete - Callback that performs the deletion.
-   */
-  constructor(relativePath, absolutePath, doDelete) {
-    this.relativePath = relativePath;
-    this.absolutePath = absolutePath;
-    this.doDelete = doDelete;
-  }
-  type = "delete-local";
-  size = 0;
-  /**
-   * Deletes the local file (unless dryRun) and returns a 'delete-local' event.
-   * @param dryRun - Whether to simulate the action without making changes.
-   *
-   * @returns An async generator yielding sync progress events.
-   */
-  async execute(dryRun) {
-    if (!dryRun) {
-      await this.doDelete(this.absolutePath);
-    }
-    return { type: "delete-local", path: this.relativePath, size: 0 };
-  }
-}
-class SkipAction {
-  /**
-   * Creates a new SkipAction for the given relative path.
-   * @param relativePath - Path relative to the sync root.
-   * @param reason - Human-readable explanation for why the file was skipped.
-   */
-  constructor(relativePath, reason) {
-    this.relativePath = relativePath;
-    this.reason = reason;
-  }
-  type = "skip";
-  size = 0;
-  /**
-   * Returns a 'skip' event with the reason message. No I/O is performed.
-   * @param _dryRun - Whether to simulate the action (unused for no-op).
-   *
-   * @returns An async generator yielding sync progress events.
-   */
-  async execute(_dryRun) {
-    return { type: "skip", path: this.relativePath, size: 0, message: this.reason };
-  }
-}
+//#region src/sync/actions/index.ts
+/** Uploads a local file to B2. */
+var UploadAction = class {
+	relativePath;
+	absolutePath;
+	size;
+	doUpload;
+	type = "upload";
+	/**
+	* Creates a new UploadAction for the given relative path.
+	* @param relativePath - Path relative to the sync root.
+	* @param absolutePath - Absolute local filesystem path.
+	* @param size - File size in bytes.
+	* @param doUpload - Callback that performs the actual upload.
+	*/
+	constructor(relativePath, absolutePath, size, doUpload) {
+		this.relativePath = relativePath;
+		this.absolutePath = absolutePath;
+		this.size = size;
+		this.doUpload = doUpload;
+	}
+	/**
+	* Uploads the file (unless dryRun) and returns an 'upload-done' event.
+	* @param dryRun - Whether to simulate the action without making changes.
+	* @param signal - Optional abort signal for canceling the upload.
+	*
+	* @returns A promise resolving to the sync event produced by the action.
+	*/
+	async execute(dryRun, signal) {
+		if (!dryRun) await this.doUpload(this.absolutePath, this.relativePath, signal);
+		return {
+			type: "upload-done",
+			path: this.relativePath,
+			size: this.size
+		};
+	}
+};
+/** Downloads a B2 file to the local filesystem. */
+var DownloadAction = class {
+	relativePath;
+	size;
+	doDownload;
+	type = "download";
+	/**
+	* Creates a new DownloadAction for the given relative path.
+	* @param relativePath - Path relative to the sync root.
+	* @param size - File size in bytes.
+	* @param doDownload - Callback that performs the actual download.
+	*/
+	constructor(relativePath, size, doDownload) {
+		this.relativePath = relativePath;
+		this.size = size;
+		this.doDownload = doDownload;
+	}
+	/**
+	* Downloads the file (unless dryRun) and returns a 'download-done' event.
+	* @param dryRun - Whether to simulate the action without making changes.
+	* @param signal - Optional abort signal for canceling the download.
+	*
+	* @returns A promise resolving to the sync event produced by the action.
+	*/
+	async execute(dryRun, signal) {
+		if (!dryRun) await this.doDownload(this.relativePath, signal);
+		return {
+			type: "download-done",
+			path: this.relativePath,
+			size: this.size
+		};
+	}
+};
+/** Server-side copies a B2 file to a new key within the same or different bucket. */
+var CopyAction = class {
+	relativePath;
+	size;
+	doCopy;
+	type = "copy";
+	/**
+	* Creates a new CopyAction for the given relative path.
+	* @param relativePath - Path relative to the sync root.
+	* @param size - File size in bytes.
+	* @param doCopy - Callback that performs the server-side copy.
+	*/
+	constructor(relativePath, size, doCopy) {
+		this.relativePath = relativePath;
+		this.size = size;
+		this.doCopy = doCopy;
+	}
+	/**
+	* Copies the file (unless dryRun) and returns a 'copy-done' event.
+	* @param dryRun - Whether to simulate the action without making changes.
+	* @param signal - Optional abort signal for canceling the copy.
+	*
+	* @returns A promise resolving to the sync event produced by the action.
+	*/
+	async execute(dryRun, signal) {
+		if (!dryRun) await this.doCopy(this.relativePath, signal);
+		return {
+			type: "copy-done",
+			path: this.relativePath,
+			size: this.size
+		};
+	}
+};
+/** Hides a file in B2 by creating a hide marker (soft delete). */
+var HideAction = class {
+	relativePath;
+	doHide;
+	type = "hide";
+	size = 0;
+	/**
+	* Creates a new HideAction for the given relative path.
+	* @param relativePath - Path relative to the sync root.
+	* @param doHide - Callback that creates the hide marker.
+	*/
+	constructor(relativePath, doHide) {
+		this.relativePath = relativePath;
+		this.doHide = doHide;
+	}
+	/**
+	* Hides the file (unless dryRun) and returns a 'hide' event.
+	* @param dryRun - Whether to simulate the action without making changes.
+	* @param signal - Optional abort signal for canceling the hide request.
+	*
+	* @returns A promise resolving to the sync event produced by the action.
+	*/
+	async execute(dryRun, signal) {
+		if (!dryRun) await this.doHide(this.relativePath, signal);
+		return {
+			type: "hide",
+			path: this.relativePath,
+			size: 0
+		};
+	}
+};
+/** Permanently deletes a specific file version from B2. */
+var DeleteRemoteAction = class {
+	relativePath;
+	fileId;
+	doDelete;
+	type = "delete-remote";
+	size = 0;
+	/**
+	* Creates a new DeleteRemoteAction for the given relative path.
+	* @param relativePath - Path relative to the sync root.
+	* @param fileId - The B2 file version ID to delete.
+	* @param doDelete - Callback that performs the deletion.
+	*/
+	constructor(relativePath, fileId, doDelete) {
+		this.relativePath = relativePath;
+		this.fileId = fileId;
+		this.doDelete = doDelete;
+	}
+	/**
+	* Deletes the remote file version (unless dryRun) and returns a 'delete-remote' event.
+	* @param dryRun - Whether to simulate the action without making changes.
+	* @param signal - Optional abort signal for canceling the delete request.
+	*
+	* @returns A promise resolving to the sync event produced by the action.
+	*/
+	async execute(dryRun, signal) {
+		if (!dryRun) await this.doDelete(this.fileId, this.relativePath, signal);
+		return {
+			type: "delete-remote",
+			path: this.relativePath,
+			size: 0
+		};
+	}
+};
+/** Deletes a file from the local filesystem. */
+var DeleteLocalAction = class {
+	relativePath;
+	absolutePath;
+	doDelete;
+	type = "delete-local";
+	size = 0;
+	/**
+	* Creates a new DeleteLocalAction for the given relative path.
+	* @param relativePath - Path relative to the sync root.
+	* @param absolutePath - Absolute local filesystem path.
+	* @param doDelete - Callback that performs the deletion.
+	*/
+	constructor(relativePath, absolutePath, doDelete) {
+		this.relativePath = relativePath;
+		this.absolutePath = absolutePath;
+		this.doDelete = doDelete;
+	}
+	/**
+	* Deletes the local file (unless dryRun) and returns a 'delete-local' event.
+	* @param dryRun - Whether to simulate the action without making changes.
+	* @param signal - Optional abort signal checked before deleting.
+	*
+	* @returns A promise resolving to the sync event produced by the action.
+	*/
+	async execute(dryRun, signal) {
+		if (!dryRun) await this.doDelete(this.absolutePath, signal);
+		return {
+			type: "delete-local",
+			path: this.relativePath,
+			size: 0
+		};
+	}
+};
+/** Represents a no-op action for files that do not need syncing. */
+var SkipAction = class {
+	relativePath;
+	reason;
+	type = "skip";
+	size = 0;
+	/**
+	* Creates a new SkipAction for the given relative path.
+	* @param relativePath - Path relative to the sync root.
+	* @param reason - Human-readable explanation for why the file was skipped.
+	*/
+	constructor(relativePath, reason) {
+		this.relativePath = relativePath;
+		this.reason = reason;
+	}
+	/**
+	* Returns a 'skip' event with the reason message. No I/O is performed.
+	* @param _dryRun - Whether to simulate the action (unused for no-op).
+	* @param _signal - Unused abort signal accepted for the shared action interface.
+	*
+	* @returns A promise resolving to the sync event produced by the action.
+	*/
+	async execute(_dryRun, _signal) {
+		return {
+			type: "skip",
+			path: this.relativePath,
+			size: 0,
+			message: this.reason
+		};
+	}
+};
+//#endregion
 exports.CopyAction = CopyAction;
 exports.DeleteLocalAction = DeleteLocalAction;
 exports.DeleteRemoteAction = DeleteRemoteAction;
@@ -188,4 +239,5 @@ exports.DownloadAction = DownloadAction;
 exports.HideAction = HideAction;
 exports.SkipAction = SkipAction;
 exports.UploadAction = UploadAction;
-//# sourceMappingURL=index.cjs.map
+
+//# sourceMappingURL=index.cjs.map

package/dist/sync/actions/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../src/sync/actions/index.ts"],"sourcesContent":["import type { SyncEvent } from '../types.ts'\n\n/** Discriminated union of all sync action types. */\nexport type SyncActionType =\n  | 'upload'\n  | 'download'\n  | 'copy'\n  | 'hide'\n  | 'delete-remote'\n  | 'delete-local'\n  | 'skip'\n\n/** A single executable sync action produced by the policy engine. */\nexport interface SyncAction {\n  /** The kind of action. */\n  readonly type: SyncActionType\n  /** Relative path of the file this action targets. */\n  readonly relativePath: string\n  /** Size in bytes of the file, or 0 for metadata-only actions. */\n  readonly size: number\n  /**\n   * Executes the action (or no-ops if dryRun is true) and returns a corresponding event.\n   * @param dryRun - When true, skip the actual I/O but still return the event.\n   */\n  execute(dryRun: boolean): Promise<SyncEvent>\n}\n\n/** Uploads a local file to B2. */\nexport class UploadAction implements SyncAction {\n  readonly type = 'upload' as const\n\n  /**\n   * Creates a new UploadAction for the given relative path.\n   * @param relativePath - Path relative to the sync root.\n   * @param absolutePath - Absolute local filesystem path.\n   * @param size - File size in bytes.\n   * @param doUpload - Callback that performs the actual upload.\n   */\n  constructor(\n    readonly relativePath: string,\n    readonly absolutePath: string,\n    readonly size: number,\n    private readonly doUpload: (absolutePath: string, relativePath: string) => Promise<void>,\n  ) {}\n\n  /**\n   * Uploads the file (unless dryRun) and returns an 'upload-done' event.\n   * @param dryRun - Whether to simulate the action without making changes.\n   *\n   * @returns An async generator yielding sync progress events.\n   */\n  async execute(dryRun: boolean): Promise<SyncEvent> {\n    if (!dryRun) {\n      await this.doUpload(this.absolutePath, this.relativePath)\n    }\n    return { type: 'upload-done', path: this.relativePath, size: this.size }\n  }\n}\n\n/** Downloads a B2 file to the local filesystem. */\nexport class DownloadAction implements SyncAction {\n  readonly type = 'download' as const\n\n  /**\n   * Creates a new DownloadAction for the given relative path.\n   * @param relativePath - Path relative to the sync root.\n   * @param size - File size in bytes.\n   * @param doDownload - Callback that performs the actual download.\n   */\n  constructor(\n    readonly relativePath: string,\n    readonly size: number,\n    private readonly doDownload: (relativePath: string) => Promise<void>,\n  ) {}\n\n  /**\n   * Downloads the file (unless dryRun) and returns a 'download-done' event.\n   * @param dryRun - Whether to simulate the action without making changes.\n   *\n   * @returns An async generator yielding sync progress events.\n   */\n  async execute(dryRun: boolean): Promise<SyncEvent> {\n    if (!dryRun) {\n      await this.doDownload(this.relativePath)\n    }\n    return { type: 'download-done', path: this.relativePath, size: this.size }\n  }\n}\n\n/** Server-side copies a B2 file to a new key within the same or different bucket. */\nexport class CopyAction implements SyncAction {\n  readonly type = 'copy' as const\n\n  /**\n   * Creates a new CopyAction for the given relative path.\n   * @param relativePath - Path relative to the sync root.\n   * @param size - File size in bytes.\n   * @param doCopy - Callback that performs the server-side copy.\n   */\n  constructor(\n    readonly relativePath: string,\n    readonly size: number,\n    private readonly doCopy: (relativePath: string) => Promise<void>,\n  ) {}\n\n  /**\n   * Copies the file (unless dryRun) and returns a 'copy-done' event.\n   * @param dryRun - Whether to simulate the action without making changes.\n   *\n   * @returns An async generator yielding sync progress events.\n   */\n  async execute(dryRun: boolean): Promise<SyncEvent> {\n    if (!dryRun) {\n      await this.doCopy(this.relativePath)\n    }\n    return { type: 'copy-done', path: this.relativePath, size: this.size }\n  }\n}\n\n/** Hides a file in B2 by creating a hide marker (soft delete). */\nexport class HideAction implements SyncAction {\n  readonly type = 'hide' as const\n  readonly size = 0\n\n  /**\n   * Creates a new HideAction for the given relative path.\n   * @param relativePath - Path relative to the sync root.\n   * @param doHide - Callback that creates the hide marker.\n   */\n  constructor(\n    readonly relativePath: string,\n    private readonly doHide: (relativePath: string) => Promise<void>,\n  ) {}\n\n  /**\n   * Hides the file (unless dryRun) and returns a 'hide' event.\n   * @param dryRun - Whether to simulate the action without making changes.\n   *\n   * @returns An async generator yielding sync progress events.\n   */\n  async execute(dryRun: boolean): Promise<SyncEvent> {\n    if (!dryRun) {\n      await this.doHide(this.relativePath)\n    }\n    return { type: 'hide', path: this.relativePath, size: 0 }\n  }\n}\n\n/** Permanently deletes a specific file version from B2. */\nexport class DeleteRemoteAction implements SyncAction {\n  readonly type = 'delete-remote' as const\n  readonly size = 0\n\n  /**\n   * Creates a new DeleteRemoteAction for the given relative path.\n   * @param relativePath - Path relative to the sync root.\n   * @param fileId - The B2 file version ID to delete.\n   * @param doDelete - Callback that performs the deletion.\n   */\n  constructor(\n    readonly relativePath: string,\n    readonly fileId: string,\n    private readonly doDelete: (fileId: string, fileName: string) => Promise<void>,\n  ) {}\n\n  /**\n   * Deletes the remote file version (unless dryRun) and returns a 'delete-remote' event.\n   * @param dryRun - Whether to simulate the action without making changes.\n   *\n   * @returns An async generator yielding sync progress events.\n   */\n  async execute(dryRun: boolean): Promise<SyncEvent> {\n    if (!dryRun) {\n      await this.doDelete(this.fileId, this.relativePath)\n    }\n    return { type: 'delete-remote', path: this.relativePath, size: 0 }\n  }\n}\n\n/** Deletes a file from the local filesystem. */\nexport class DeleteLocalAction implements SyncAction {\n  readonly type = 'delete-local' as const\n  readonly size = 0\n\n  /**\n   * Creates a new DeleteLocalAction for the given relative path.\n   * @param relativePath - Path relative to the sync root.\n   * @param absolutePath - Absolute local filesystem path.\n   * @param doDelete - Callback that performs the deletion.\n   */\n  constructor(\n    readonly relativePath: string,\n    readonly absolutePath: string,\n    private readonly doDelete: (absolutePath: string) => Promise<void>,\n  ) {}\n\n  /**\n   * Deletes the local file (unless dryRun) and returns a 'delete-local' event.\n   * @param dryRun - Whether to simulate the action without making changes.\n   *\n   * @returns An async generator yielding sync progress events.\n   */\n  async execute(dryRun: boolean): Promise<SyncEvent> {\n    if (!dryRun) {\n      await this.doDelete(this.absolutePath)\n    }\n    return { type: 'delete-local', path: this.relativePath, size: 0 }\n  }\n}\n\n/** Represents a no-op action for files that do not need syncing. */\nexport class SkipAction implements SyncAction {\n  readonly type = 'skip' as const\n  readonly size = 0\n\n  /**\n   * Creates a new SkipAction for the given relative path.\n   * @param relativePath - Path relative to the sync root.\n   * @param reason - Human-readable explanation for why the file was skipped.\n   */\n  constructor(\n    readonly relativePath: string,\n    readonly reason: string,\n  ) {}\n\n  /**\n   * Returns a 'skip' event with the reason message. No I/O is performed.\n   * @param _dryRun - Whether to simulate the action (unused for no-op).\n   *\n   * @returns An async generator yielding sync progress events.\n   */\n  async execute(_dryRun: boolean): Promise<SyncEvent> {\n    return { type: 'skip', path: this.relativePath, size: 0, message: this.reason }\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/sync/actions/index.ts"],"sourcesContent":["import type { SyncEvent } from '../types.ts'\n\n/** Discriminated union of all sync action types. */\nexport type SyncActionType =\n  | 'upload'\n  | 'download'\n  | 'copy'\n  | 'hide'\n  | 'delete-remote'\n  | 'delete-local'\n  | 'skip'\n\n/** A single executable sync action produced by the policy engine. */\nexport interface SyncAction {\n  /** The kind of action. */\n  readonly type: SyncActionType\n  /** Relative path of the file this action targets. */\n  readonly relativePath: string\n  /** Size in bytes of the file, or 0 for metadata-only actions. */\n  readonly size: number\n  /**\n   * Executes the action (or no-ops if dryRun is true) and returns a corresponding event.\n   * @param dryRun - When true, skip the actual I/O but still return the event.\n   * @param signal - Optional abort signal for canceling in-flight I/O.\n   */\n  execute(dryRun: boolean, signal?: AbortSignal): Promise<SyncEvent>\n}\n\n/** Uploads a local file to B2. */\nexport class UploadAction implements SyncAction {\n  readonly type = 'upload' as const\n\n  /**\n   * Creates a new UploadAction for the given relative path.\n   * @param relativePath - Path relative to the sync root.\n   * @param absolutePath - Absolute local filesystem path.\n   * @param size - File size in bytes.\n   * @param doUpload - Callback that performs the actual upload.\n   */\n  constructor(\n    readonly relativePath: string,\n    readonly absolutePath: string,\n    readonly size: number,\n    private readonly doUpload: (\n      absolutePath: string,\n      relativePath: string,\n      signal?: AbortSignal,\n    ) => Promise<void>,\n  ) {}\n\n  /**\n   * Uploads the file (unless dryRun) and returns an 'upload-done' event.\n   * @param dryRun - Whether to simulate the action without making changes.\n   * @param signal - Optional abort signal for canceling the upload.\n   *\n   * @returns A promise resolving to the sync event produced by the action.\n   */\n  async execute(dryRun: boolean, signal?: AbortSignal): Promise<SyncEvent> {\n    if (!dryRun) {\n      await this.doUpload(this.absolutePath, this.relativePath, signal)\n    }\n    return { type: 'upload-done', path: this.relativePath, size: this.size }\n  }\n}\n\n/** Downloads a B2 file to the local filesystem. */\nexport class DownloadAction implements SyncAction {\n  readonly type = 'download' as const\n\n  /**\n   * Creates a new DownloadAction for the given relative path.\n   * @param relativePath - Path relative to the sync root.\n   * @param size - File size in bytes.\n   * @param doDownload - Callback that performs the actual download.\n   */\n  constructor(\n    readonly relativePath: string,\n    readonly size: number,\n    private readonly doDownload: (relativePath: string, signal?: AbortSignal) => Promise<void>,\n  ) {}\n\n  /**\n   * Downloads the file (unless dryRun) and returns a 'download-done' event.\n   * @param dryRun - Whether to simulate the action without making changes.\n   * @param signal - Optional abort signal for canceling the download.\n   *\n   * @returns A promise resolving to the sync event produced by the action.\n   */\n  async execute(dryRun: boolean, signal?: AbortSignal): Promise<SyncEvent> {\n    if (!dryRun) {\n      await this.doDownload(this.relativePath, signal)\n    }\n    return { type: 'download-done', path: this.relativePath, size: this.size }\n  }\n}\n\n/** Server-side copies a B2 file to a new key within the same or different bucket. */\nexport class CopyAction implements SyncAction {\n  readonly type = 'copy' as const\n\n  /**\n   * Creates a new CopyAction for the given relative path.\n   * @param relativePath - Path relative to the sync root.\n   * @param size - File size in bytes.\n   * @param doCopy - Callback that performs the server-side copy.\n   */\n  constructor(\n    readonly relativePath: string,\n    readonly size: number,\n    private readonly doCopy: (relativePath: string, signal?: AbortSignal) => Promise<void>,\n  ) {}\n\n  /**\n   * Copies the file (unless dryRun) and returns a 'copy-done' event.\n   * @param dryRun - Whether to simulate the action without making changes.\n   * @param signal - Optional abort signal for canceling the copy.\n   *\n   * @returns A promise resolving to the sync event produced by the action.\n   */\n  async execute(dryRun: boolean, signal?: AbortSignal): Promise<SyncEvent> {\n    if (!dryRun) {\n      await this.doCopy(this.relativePath, signal)\n    }\n    return { type: 'copy-done', path: this.relativePath, size: this.size }\n  }\n}\n\n/** Hides a file in B2 by creating a hide marker (soft delete). */\nexport class HideAction implements SyncAction {\n  readonly type = 'hide' as const\n  readonly size = 0\n\n  /**\n   * Creates a new HideAction for the given relative path.\n   * @param relativePath - Path relative to the sync root.\n   * @param doHide - Callback that creates the hide marker.\n   */\n  constructor(\n    readonly relativePath: string,\n    private readonly doHide: (relativePath: string, signal?: AbortSignal) => Promise<void>,\n  ) {}\n\n  /**\n   * Hides the file (unless dryRun) and returns a 'hide' event.\n   * @param dryRun - Whether to simulate the action without making changes.\n   * @param signal - Optional abort signal for canceling the hide request.\n   *\n   * @returns A promise resolving to the sync event produced by the action.\n   */\n  async execute(dryRun: boolean, signal?: AbortSignal): Promise<SyncEvent> {\n    if (!dryRun) {\n      await this.doHide(this.relativePath, signal)\n    }\n    return { type: 'hide', path: this.relativePath, size: 0 }\n  }\n}\n\n/** Permanently deletes a specific file version from B2. */\nexport class DeleteRemoteAction implements SyncAction {\n  readonly type = 'delete-remote' as const\n  readonly size = 0\n\n  /**\n   * Creates a new DeleteRemoteAction for the given relative path.\n   * @param relativePath - Path relative to the sync root.\n   * @param fileId - The B2 file version ID to delete.\n   * @param doDelete - Callback that performs the deletion.\n   */\n  constructor(\n    readonly relativePath: string,\n    readonly fileId: string,\n    private readonly doDelete: (\n      fileId: string,\n      fileName: string,\n      signal?: AbortSignal,\n    ) => Promise<void>,\n  ) {}\n\n  /**\n   * Deletes the remote file version (unless dryRun) and returns a 'delete-remote' event.\n   * @param dryRun - Whether to simulate the action without making changes.\n   * @param signal - Optional abort signal for canceling the delete request.\n   *\n   * @returns A promise resolving to the sync event produced by the action.\n   */\n  async execute(dryRun: boolean, signal?: AbortSignal): Promise<SyncEvent> {\n    if (!dryRun) {\n      await this.doDelete(this.fileId, this.relativePath, signal)\n    }\n    return { type: 'delete-remote', path: this.relativePath, size: 0 }\n  }\n}\n\n/** Deletes a file from the local filesystem. */\nexport class DeleteLocalAction implements SyncAction {\n  readonly type = 'delete-local' as const\n  readonly size = 0\n\n  /**\n   * Creates a new DeleteLocalAction for the given relative path.\n   * @param relativePath - Path relative to the sync root.\n   * @param absolutePath - Absolute local filesystem path.\n   * @param doDelete - Callback that performs the deletion.\n   */\n  constructor(\n    readonly relativePath: string,\n    readonly absolutePath: string,\n    private readonly doDelete: (absolutePath: string, signal?: AbortSignal) => Promise<void>,\n  ) {}\n\n  /**\n   * Deletes the local file (unless dryRun) and returns a 'delete-local' event.\n   * @param dryRun - Whether to simulate the action without making changes.\n   * @param signal - Optional abort signal checked before deleting.\n   *\n   * @returns A promise resolving to the sync event produced by the action.\n   */\n  async execute(dryRun: boolean, signal?: AbortSignal): Promise<SyncEvent> {\n    if (!dryRun) {\n      await this.doDelete(this.absolutePath, signal)\n    }\n    return { type: 'delete-local', path: this.relativePath, size: 0 }\n  }\n}\n\n/** Represents a no-op action for files that do not need syncing. */\nexport class SkipAction implements SyncAction {\n  readonly type = 'skip' as const\n  readonly size = 0\n\n  /**\n   * Creates a new SkipAction for the given relative path.\n   * @param relativePath - Path relative to the sync root.\n   * @param reason - Human-readable explanation for why the file was skipped.\n   */\n  constructor(\n    readonly relativePath: string,\n    readonly reason: string,\n  ) {}\n\n  /**\n   * Returns a 'skip' event with the reason message. No I/O is performed.\n   * @param _dryRun - Whether to simulate the action (unused for no-op).\n   * @param _signal - Unused abort signal accepted for the shared action interface.\n   *\n   * @returns A promise resolving to the sync event produced by the action.\n   */\n  async execute(_dryRun: boolean, _signal?: AbortSignal): Promise<SyncEvent> {\n    return { type: 'skip', path: this.relativePath, size: 0, message: this.reason }\n  }\n}\n"],"mappings":";;AA6BA,IAAa,eAAb,MAAgD;CAWnC;CACA;CACA;CACQ;CAbnB,OAAgB;;;;;;;;CAShB,YACE,cACA,cACA,MACA,UAKA;EARS,KAAA,eAAA;EACA,KAAA,eAAA;EACA,KAAA,OAAA;EACQ,KAAA,WAAA;CAKhB;;;;;;;;CASH,MAAM,QAAQ,QAAiB,QAA0C;EACvE,IAAI,CAAC,QACH,MAAM,KAAK,SAAS,KAAK,cAAc,KAAK,cAAc,MAAM;EAElE,OAAO;GAAE,MAAM;GAAe,MAAM,KAAK;GAAc,MAAM,KAAK;EAAK;CACzE;AACF;;AAGA,IAAa,iBAAb,MAAkD;CAUrC;CACA;CACQ;CAXnB,OAAgB;;;;;;;CAQhB,YACE,cACA,MACA,YACA;EAHS,KAAA,eAAA;EACA,KAAA,OAAA;EACQ,KAAA,aAAA;CAChB;;;;;;;;CASH,MAAM,QAAQ,QAAiB,QAA0C;EACvE,IAAI,CAAC,QACH,MAAM,KAAK,WAAW,KAAK,cAAc,MAAM;EAEjD,OAAO;GAAE,MAAM;GAAiB,MAAM,KAAK;GAAc,MAAM,KAAK;EAAK;CAC3E;AACF;;AAGA,IAAa,aAAb,MAA8C;CAUjC;CACA;CACQ;CAXnB,OAAgB;;;;;;;CAQhB,YACE,cACA,MACA,QACA;EAHS,KAAA,eAAA;EACA,KAAA,OAAA;EACQ,KAAA,SAAA;CAChB;;;;;;;;CASH,MAAM,QAAQ,QAAiB,QAA0C;EACvE,IAAI,CAAC,QACH,MAAM,KAAK,OAAO,KAAK,cAAc,MAAM;EAE7C,OAAO;GAAE,MAAM;GAAa,MAAM,KAAK;GAAc,MAAM,KAAK;EAAK;CACvE;AACF;;AAGA,IAAa,aAAb,MAA8C;CAUjC;CACQ;CAVnB,OAAgB;CAChB,OAAgB;;;;;;CAOhB,YACE,cACA,QACA;EAFS,KAAA,eAAA;EACQ,KAAA,SAAA;CAChB;;;;;;;;CASH,MAAM,QAAQ,QAAiB,QAA0C;EACvE,IAAI,CAAC,QACH,MAAM,KAAK,OAAO,KAAK,cAAc,MAAM;EAE7C,OAAO;GAAE,MAAM;GAAQ,MAAM,KAAK;GAAc,MAAM;EAAE;CAC1D;AACF;;AAGA,IAAa,qBAAb,MAAsD;CAWzC;CACA;CACQ;CAZnB,OAAgB;CAChB,OAAgB;;;;;;;CAQhB,YACE,cACA,QACA,UAKA;EAPS,KAAA,eAAA;EACA,KAAA,SAAA;EACQ,KAAA,WAAA;CAKhB;;;;;;;;CASH,MAAM,QAAQ,QAAiB,QAA0C;EACvE,IAAI,CAAC,QACH,MAAM,KAAK,SAAS,KAAK,QAAQ,KAAK,cAAc,MAAM;EAE5D,OAAO;GAAE,MAAM;GAAiB,MAAM,KAAK;GAAc,MAAM;EAAE;CACnE;AACF;;AAGA,IAAa,oBAAb,MAAqD;CAWxC;CACA;CACQ;CAZnB,OAAgB;CAChB,OAAgB;;;;;;;CAQhB,YACE,cACA,cACA,UACA;EAHS,KAAA,eAAA;EACA,KAAA,eAAA;EACQ,KAAA,WAAA;CAChB;;;;;;;;CASH,MAAM,QAAQ,QAAiB,QAA0C;EACvE,IAAI,CAAC,QACH,MAAM,KAAK,SAAS,KAAK,cAAc,MAAM;EAE/C,OAAO;GAAE,MAAM;GAAgB,MAAM,KAAK;GAAc,MAAM;EAAE;CAClE;AACF;;AAGA,IAAa,aAAb,MAA8C;CAUjC;CACA;CAVX,OAAgB;CAChB,OAAgB;;;;;;CAOhB,YACE,cACA,QACA;EAFS,KAAA,eAAA;EACA,KAAA,SAAA;CACR;;;;;;;;CASH,MAAM,QAAQ,SAAkB,SAA2C;EACzE,OAAO;GAAE,MAAM;GAAQ,MAAM,KAAK;GAAc,MAAM;GAAG,SAAS,KAAK;EAAO;CAChF;AACF"}