@backblaze-labs/b2-sdk 0.1.0 → 0.2.0

package/dist/sync/actions/index.js

@@ -1,191 +1,237 @@
-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 };
-  }
-}
-export {
-  CopyAction,
-  DeleteLocalAction,
-  DeleteRemoteAction,
-  DownloadAction,
-  HideAction,
-  SkipAction,
-  UploadAction
+//#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
+		};
+	}
 };
-//# sourceMappingURL=index.js.map
+/** 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
+export { CopyAction, DeleteLocalAction, DeleteRemoteAction, DownloadAction, HideAction, SkipAction, UploadAction };
+
+//# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","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.js","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"}

package/dist/sync/b2-sha1-reader.cjs

@@ -0,0 +1,148 @@
+const require_hash = require("../streams/hash.cjs");
+const require_sha1_options = require("./sha1-options.cjs");
+//#region src/sync/b2-sha1-reader.ts
+var MAX_CONSECUTIVE_EMPTY_READ_CHUNKS = 1024;
+/**
+* Reads one non-empty stream chunk with an idle timeout and optional abort signal.
+* Empty chunks are not progress; too many consecutive empty chunks fail with the
+* same stalled-read diagnostic used for pending reads.
+*
+* @param reader - Locked reader to read from.
+* @param timeoutMillis - Idle timeout in milliseconds for this read.
+* @param stalledMessage - Error message used when the read makes no progress.
+* @param signal - Optional abort signal to observe while reading.
+*
+* @returns The next stream read result.
+*
+* @internal
+*/
+async function readStreamChunkWithTimeout(reader, timeoutMillis, stalledMessage, signal) {
+	let emptyChunks = 0;
+	while (true) {
+		const result = await readRawStreamChunkWithTimeout(reader, timeoutMillis, stalledMessage, signal);
+		if (result.done || result.value.byteLength > 0) return result;
+		emptyChunks += 1;
+		if (emptyChunks > MAX_CONSECUTIVE_EMPTY_READ_CHUNKS) throw new Error(stalledMessage);
+	}
+}
+async function readRawStreamChunkWithTimeout(reader, timeoutMillis, stalledMessage, signal) {
+	signal?.throwIfAborted();
+	let timeout;
+	let removeAbortListener;
+	const readPromise = reader.read();
+	const timeoutPromise = timeoutMillis === Number.POSITIVE_INFINITY ? void 0 : new Promise((_, reject) => {
+		timeout = setTimeout(() => {
+			reject(new Error(stalledMessage));
+		}, timeoutMillis);
+	});
+	const abortPromise = signal === void 0 ? void 0 : new Promise((_, reject) => {
+		const onAbort = () => reject(signal.reason ?? /* @__PURE__ */ new Error("aborted"));
+		signal.addEventListener("abort", onAbort, { once: true });
+		removeAbortListener = () => signal.removeEventListener("abort", onAbort);
+	});
+	try {
+		if (timeoutPromise === void 0 && abortPromise === void 0) return await readPromise;
+		const candidates = [readPromise];
+		if (timeoutPromise !== void 0) candidates.push(timeoutPromise);
+		if (abortPromise !== void 0) candidates.push(abortPromise);
+		return await Promise.race(candidates);
+	} finally {
+		if (timeout !== void 0) clearTimeout(timeout);
+		removeAbortListener?.();
+		readPromise.catch(() => {});
+	}
+}
+/**
+* Hashes a B2 response body as SHA-1 with idle timeout, abort, and size checks.
+*
+* @param body - Response body stream to hash.
+* @param signal - Optional abort signal to observe while reading.
+* @param options - Optional timeout and byte-count limits.
+*
+* @returns The computed SHA-1 and number of bytes read.
+*
+* @internal
+*/
+async function hashReadableStreamSha1(body, signal, options) {
+	const hash = new require_hash.IncrementalSha1();
+	const reader = body.getReader();
+	const idleTimeoutMillis = options?.idleTimeoutMillis ?? require_sha1_options.normalizeSha1TimeoutMillis(void 0);
+	const maxBytes = options?.maxBytes ?? Number.POSITIVE_INFINITY;
+	const expectedBytes = options?.expectedBytes;
+	let bytesRead = 0;
+	try {
+		while (true) {
+			const { done, value } = await readStreamChunkWithTimeout(reader, idleTimeoutMillis, `sha1 B2 read stalled for ${idleTimeoutMillis} ms`, signal);
+			if (done) break;
+			bytesRead += value.byteLength;
+			if (bytesRead > maxBytes) throw new Error(`sha1 B2 read exceeded ${maxBytes} byte verification budget`);
+			await hash.update(value);
+		}
+		if (expectedBytes !== void 0 && bytesRead !== expectedBytes) throw new Error(`sha1 B2 read ended after ${bytesRead} bytes, expected ${expectedBytes}`);
+		return {
+			contentSha1: await hash.digest(),
+			bytesRead
+		};
+	} catch (err) {
+		reader.cancel(err).catch(() => {});
+		throw err;
+	} finally {
+		reader.releaseLock();
+	}
+}
+/**
+* Applies an absolute verification deadline while forwarding parent aborts.
+*
+* @param signal - Optional parent abort signal.
+* @param timeoutMillis - Absolute deadline in milliseconds.
+* @param run - Operation to run with the derived deadline signal.
+*
+* @returns The operation result.
+*
+* @internal
+*/
+async function withSha1VerificationDeadline(signal, timeoutMillis, run) {
+	const controller = new AbortController();
+	const abortFromParent = () => controller.abort(signal?.reason);
+	if (signal?.aborted) abortFromParent();
+	signal?.addEventListener("abort", abortFromParent, { once: true });
+	let timeout;
+	const timeoutPromise = new Promise((_, reject) => {
+		timeout = setTimeout(() => {
+			const error = /* @__PURE__ */ new Error(`sha1 B2 verification exceeded ${timeoutMillis} ms`);
+			controller.abort(error);
+			reject(error);
+		}, timeoutMillis);
+	});
+	const runPromise = run(controller.signal);
+	try {
+		return await Promise.race([runPromise, timeoutPromise]);
+	} finally {
+		if (timeout !== void 0) clearTimeout(timeout);
+		signal?.removeEventListener("abort", abortFromParent);
+		runPromise.catch(() => {});
+	}
+}
+/**
+* Bounds B2 SHA-1 verification downloads to the selected object's size and optional ceiling.
+*
+* @param contentLength - Selected B2 object byte length.
+* @param ceiling - Optional lower verification budget.
+*
+* @returns The byte budget to enforce.
+*
+* @internal
+*/
+function normalizeSha1VerificationMaxBytes(contentLength, ceiling) {
+	const contentBudget = Math.max(0, Math.floor(contentLength));
+	if (ceiling === void 0) return contentBudget;
+	if (!Number.isFinite(ceiling) || ceiling < 0) return contentBudget;
+	return Math.min(contentBudget, Math.floor(ceiling));
+}
+//#endregion
+exports.hashReadableStreamSha1 = hashReadableStreamSha1;
+exports.normalizeSha1VerificationMaxBytes = normalizeSha1VerificationMaxBytes;
+exports.readStreamChunkWithTimeout = readStreamChunkWithTimeout;
+exports.withSha1VerificationDeadline = withSha1VerificationDeadline;
+
+//# sourceMappingURL=b2-sha1-reader.cjs.map

package/dist/sync/b2-sha1-reader.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"b2-sha1-reader.cjs","names":[],"sources":["../../src/sync/b2-sha1-reader.ts"],"sourcesContent":["import { IncrementalSha1 } from '../streams/hash.ts'\nimport { normalizeSha1TimeoutMillis } from './sha1-options.ts'\n\nconst MAX_CONSECUTIVE_EMPTY_READ_CHUNKS = 1024\n\n/**\n * Reads one non-empty stream chunk with an idle timeout and optional abort signal.\n * Empty chunks are not progress; too many consecutive empty chunks fail with the\n * same stalled-read diagnostic used for pending reads.\n *\n * @param reader - Locked reader to read from.\n * @param timeoutMillis - Idle timeout in milliseconds for this read.\n * @param stalledMessage - Error message used when the read makes no progress.\n * @param signal - Optional abort signal to observe while reading.\n *\n * @returns The next stream read result.\n *\n * @internal\n */\nexport async function readStreamChunkWithTimeout(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  timeoutMillis: number,\n  stalledMessage: string,\n  signal?: AbortSignal,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  let emptyChunks = 0\n  while (true) {\n    const result = await readRawStreamChunkWithTimeout(\n      reader,\n      timeoutMillis,\n      stalledMessage,\n      signal,\n    )\n    if (result.done || result.value.byteLength > 0) return result\n    emptyChunks += 1\n    if (emptyChunks > MAX_CONSECUTIVE_EMPTY_READ_CHUNKS) {\n      throw new Error(stalledMessage)\n    }\n  }\n}\n\nasync function readRawStreamChunkWithTimeout(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  timeoutMillis: number,\n  stalledMessage: string,\n  signal?: AbortSignal,\n): Promise<ReadableStreamReadResult<Uint8Array>> {\n  signal?.throwIfAborted()\n\n  let timeout: ReturnType<typeof setTimeout> | undefined\n  let removeAbortListener: (() => void) | undefined\n  const readPromise = reader.read()\n  const timeoutPromise =\n    timeoutMillis === Number.POSITIVE_INFINITY\n      ? undefined\n      : new Promise<never>((_, reject) => {\n          timeout = setTimeout(() => {\n            reject(new Error(stalledMessage))\n          }, timeoutMillis)\n        })\n  const abortPromise =\n    signal === undefined\n      ? undefined\n      : new Promise<never>((_, reject) => {\n          const onAbort = () => reject(signal.reason ?? new Error('aborted'))\n          signal.addEventListener('abort', onAbort, { once: true })\n          removeAbortListener = () => signal.removeEventListener('abort', onAbort)\n        })\n\n  try {\n    if (timeoutPromise === undefined && abortPromise === undefined) return await readPromise\n    const candidates = [readPromise]\n    if (timeoutPromise !== undefined) candidates.push(timeoutPromise)\n    if (abortPromise !== undefined) candidates.push(abortPromise)\n    return await Promise.race(candidates)\n  } finally {\n    if (timeout !== undefined) clearTimeout(timeout)\n    removeAbortListener?.()\n    void readPromise.catch(() => {})\n  }\n}\n\n/**\n * Hashes a B2 response body as SHA-1 with idle timeout, abort, and size checks.\n *\n * @param body - Response body stream to hash.\n * @param signal - Optional abort signal to observe while reading.\n * @param options - Optional timeout and byte-count limits.\n *\n * @returns The computed SHA-1 and number of bytes read.\n *\n * @internal\n */\nexport async function hashReadableStreamSha1(\n  body: ReadableStream<Uint8Array>,\n  signal?: AbortSignal,\n  options?: {\n    readonly idleTimeoutMillis: number\n    readonly maxBytes: number\n    readonly expectedBytes: number\n  },\n): Promise<{ readonly contentSha1: string; readonly bytesRead: number }> {\n  const hash = new IncrementalSha1()\n  const reader = body.getReader()\n  const idleTimeoutMillis = options?.idleTimeoutMillis ?? normalizeSha1TimeoutMillis(undefined)\n  const maxBytes = options?.maxBytes ?? Number.POSITIVE_INFINITY\n  const expectedBytes = options?.expectedBytes\n  let bytesRead = 0\n  try {\n    while (true) {\n      const { done, value } = await readStreamChunkWithTimeout(\n        reader,\n        idleTimeoutMillis,\n        `sha1 B2 read stalled for ${idleTimeoutMillis} ms`,\n        signal,\n      )\n      if (done) break\n      bytesRead += value.byteLength\n      if (bytesRead > maxBytes) {\n        throw new Error(`sha1 B2 read exceeded ${maxBytes} byte verification budget`)\n      }\n      await hash.update(value)\n    }\n    if (expectedBytes !== undefined && bytesRead !== expectedBytes) {\n      throw new Error(`sha1 B2 read ended after ${bytesRead} bytes, expected ${expectedBytes}`)\n    }\n    return { contentSha1: await hash.digest(), bytesRead }\n  } catch (err) {\n    void reader.cancel(err).catch(() => {})\n    throw err\n  } finally {\n    reader.releaseLock()\n  }\n}\n\n/**\n * Applies an absolute verification deadline while forwarding parent aborts.\n *\n * @param signal - Optional parent abort signal.\n * @param timeoutMillis - Absolute deadline in milliseconds.\n * @param run - Operation to run with the derived deadline signal.\n *\n * @returns The operation result.\n *\n * @internal\n */\nexport async function withSha1VerificationDeadline<T>(\n  signal: AbortSignal | undefined,\n  timeoutMillis: number,\n  run: (signal: AbortSignal) => Promise<T>,\n): Promise<T> {\n  const controller = new AbortController()\n  const abortFromParent = () => controller.abort(signal?.reason)\n  if (signal?.aborted) abortFromParent()\n  signal?.addEventListener('abort', abortFromParent, { once: true })\n\n  let timeout: ReturnType<typeof setTimeout> | undefined\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    timeout = setTimeout(() => {\n      const error = new Error(`sha1 B2 verification exceeded ${timeoutMillis} ms`)\n      controller.abort(error)\n      reject(error)\n    }, timeoutMillis)\n  })\n  const runPromise = run(controller.signal)\n  try {\n    return await Promise.race([runPromise, timeoutPromise])\n  } finally {\n    if (timeout !== undefined) clearTimeout(timeout)\n    signal?.removeEventListener('abort', abortFromParent)\n    void runPromise.catch(() => {})\n  }\n}\n\n/**\n * Bounds B2 SHA-1 verification downloads to the selected object's size and optional ceiling.\n *\n * @param contentLength - Selected B2 object byte length.\n * @param ceiling - Optional lower verification budget.\n *\n * @returns The byte budget to enforce.\n *\n * @internal\n */\nexport function normalizeSha1VerificationMaxBytes(\n  contentLength: number,\n  ceiling: number | undefined,\n): number {\n  const contentBudget = Math.max(0, Math.floor(contentLength))\n  if (ceiling === undefined) return contentBudget\n  if (!Number.isFinite(ceiling) || ceiling < 0) return contentBudget\n  return Math.min(contentBudget, Math.floor(ceiling))\n}\n"],"mappings":"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"}