@backblaze-labs/b2-sdk 0.1.0

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

@@ -0,0 +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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"}

package/dist/sync/actions/index.d.cts

@@ -0,0 +1,167 @@
+import { SyncEvent } from '../types.js';
+/** Discriminated union of all sync action types. */
+export type SyncActionType = 'upload' | 'download' | 'copy' | 'hide' | 'delete-remote' | 'delete-local' | 'skip';
+/** A single executable sync action produced by the policy engine. */
+export interface SyncAction {
+    /** The kind of action. */
+    readonly type: SyncActionType;
+    /** Relative path of the file this action targets. */
+    readonly relativePath: string;
+    /** Size in bytes of the file, or 0 for metadata-only actions. */
+    readonly size: number;
+    /**
+     * Executes the action (or no-ops if dryRun is true) and returns a corresponding event.
+     * @param dryRun - When true, skip the actual I/O but still return the event.
+     */
+    execute(dryRun: boolean): Promise<SyncEvent>;
+}
+/** Uploads a local file to B2. */
+export declare class UploadAction implements SyncAction {
+    readonly relativePath: string;
+    readonly absolutePath: string;
+    readonly size: number;
+    private readonly doUpload;
+    readonly 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: string, absolutePath: string, size: number, doUpload: (absolutePath: string, relativePath: string) => Promise<void>);
+    /**
+     * 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.
+     */
+    execute(dryRun: boolean): Promise<SyncEvent>;
+}
+/** Downloads a B2 file to the local filesystem. */
+export declare class DownloadAction implements SyncAction {
+    readonly relativePath: string;
+    readonly size: number;
+    private readonly doDownload;
+    readonly 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: string, size: number, doDownload: (relativePath: string) => Promise<void>);
+    /**
+     * 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.
+     */
+    execute(dryRun: boolean): Promise<SyncEvent>;
+}
+/** Server-side copies a B2 file to a new key within the same or different bucket. */
+export declare class CopyAction implements SyncAction {
+    readonly relativePath: string;
+    readonly size: number;
+    private readonly doCopy;
+    readonly 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: string, size: number, doCopy: (relativePath: string) => Promise<void>);
+    /**
+     * 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.
+     */
+    execute(dryRun: boolean): Promise<SyncEvent>;
+}
+/** Hides a file in B2 by creating a hide marker (soft delete). */
+export declare class HideAction implements SyncAction {
+    readonly relativePath: string;
+    private readonly doHide;
+    readonly type: "hide";
+    readonly 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: string, doHide: (relativePath: string) => Promise<void>);
+    /**
+     * 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.
+     */
+    execute(dryRun: boolean): Promise<SyncEvent>;
+}
+/** Permanently deletes a specific file version from B2. */
+export declare class DeleteRemoteAction implements SyncAction {
+    readonly relativePath: string;
+    readonly fileId: string;
+    private readonly doDelete;
+    readonly type: "delete-remote";
+    readonly 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: string, fileId: string, doDelete: (fileId: string, fileName: string) => Promise<void>);
+    /**
+     * 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.
+     */
+    execute(dryRun: boolean): Promise<SyncEvent>;
+}
+/** Deletes a file from the local filesystem. */
+export declare class DeleteLocalAction implements SyncAction {
+    readonly relativePath: string;
+    readonly absolutePath: string;
+    private readonly doDelete;
+    readonly type: "delete-local";
+    readonly 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: string, absolutePath: string, doDelete: (absolutePath: string) => Promise<void>);
+    /**
+     * 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.
+     */
+    execute(dryRun: boolean): Promise<SyncEvent>;
+}
+/** Represents a no-op action for files that do not need syncing. */
+export declare class SkipAction implements SyncAction {
+    readonly relativePath: string;
+    readonly reason: string;
+    readonly type: "skip";
+    readonly 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: string, reason: string);
+    /**
+     * 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.
+     */
+    execute(_dryRun: boolean): Promise<SyncEvent>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/sync/actions/index.d.cts.map

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

package/dist/sync/actions/index.d.ts

@@ -0,0 +1,167 @@
+import { SyncEvent } from '../types.js';
+/** Discriminated union of all sync action types. */
+export type SyncActionType = 'upload' | 'download' | 'copy' | 'hide' | 'delete-remote' | 'delete-local' | 'skip';
+/** A single executable sync action produced by the policy engine. */
+export interface SyncAction {
+    /** The kind of action. */
+    readonly type: SyncActionType;
+    /** Relative path of the file this action targets. */
+    readonly relativePath: string;
+    /** Size in bytes of the file, or 0 for metadata-only actions. */
+    readonly size: number;
+    /**
+     * Executes the action (or no-ops if dryRun is true) and returns a corresponding event.
+     * @param dryRun - When true, skip the actual I/O but still return the event.
+     */
+    execute(dryRun: boolean): Promise<SyncEvent>;
+}
+/** Uploads a local file to B2. */
+export declare class UploadAction implements SyncAction {
+    readonly relativePath: string;
+    readonly absolutePath: string;
+    readonly size: number;
+    private readonly doUpload;
+    readonly 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: string, absolutePath: string, size: number, doUpload: (absolutePath: string, relativePath: string) => Promise<void>);
+    /**
+     * 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.
+     */
+    execute(dryRun: boolean): Promise<SyncEvent>;
+}
+/** Downloads a B2 file to the local filesystem. */
+export declare class DownloadAction implements SyncAction {
+    readonly relativePath: string;
+    readonly size: number;
+    private readonly doDownload;
+    readonly 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: string, size: number, doDownload: (relativePath: string) => Promise<void>);
+    /**
+     * 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.
+     */
+    execute(dryRun: boolean): Promise<SyncEvent>;
+}
+/** Server-side copies a B2 file to a new key within the same or different bucket. */
+export declare class CopyAction implements SyncAction {
+    readonly relativePath: string;
+    readonly size: number;
+    private readonly doCopy;
+    readonly 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: string, size: number, doCopy: (relativePath: string) => Promise<void>);
+    /**
+     * 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.
+     */
+    execute(dryRun: boolean): Promise<SyncEvent>;
+}
+/** Hides a file in B2 by creating a hide marker (soft delete). */
+export declare class HideAction implements SyncAction {
+    readonly relativePath: string;
+    private readonly doHide;
+    readonly type: "hide";
+    readonly 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: string, doHide: (relativePath: string) => Promise<void>);
+    /**
+     * 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.
+     */
+    execute(dryRun: boolean): Promise<SyncEvent>;
+}
+/** Permanently deletes a specific file version from B2. */
+export declare class DeleteRemoteAction implements SyncAction {
+    readonly relativePath: string;
+    readonly fileId: string;
+    private readonly doDelete;
+    readonly type: "delete-remote";
+    readonly 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: string, fileId: string, doDelete: (fileId: string, fileName: string) => Promise<void>);
+    /**
+     * 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.
+     */
+    execute(dryRun: boolean): Promise<SyncEvent>;
+}
+/** Deletes a file from the local filesystem. */
+export declare class DeleteLocalAction implements SyncAction {
+    readonly relativePath: string;
+    readonly absolutePath: string;
+    private readonly doDelete;
+    readonly type: "delete-local";
+    readonly 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: string, absolutePath: string, doDelete: (absolutePath: string) => Promise<void>);
+    /**
+     * 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.
+     */
+    execute(dryRun: boolean): Promise<SyncEvent>;
+}
+/** Represents a no-op action for files that do not need syncing. */
+export declare class SkipAction implements SyncAction {
+    readonly relativePath: string;
+    readonly reason: string;
+    readonly type: "skip";
+    readonly 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: string, reason: string);
+    /**
+     * 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.
+     */
+    execute(_dryRun: boolean): Promise<SyncEvent>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/sync/actions/index.d.ts.map

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

package/dist/sync/actions/index.js

@@ -0,0 +1,191 @@
+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
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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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"}

package/dist/sync/index.cjs

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const local = require("./scanners/local.cjs");
+const b2 = require("./scanners/b2.cjs");
+const pairing = require("./pairing.cjs");
+const index$1 = require("./policies/index.cjs");
+const compare = require("./policies/compare.cjs");
+const synchronizer = require("./synchronizer.cjs");
+const index = require("./actions/index.cjs");
+exports.LocalFolder = local.LocalFolder;
+exports.B2Folder = b2.B2Folder;
+exports.zipFolders = pairing.zipFolders;
+exports.generateActions = index$1.generateActions;
+exports.filesAreDifferent = compare.filesAreDifferent;
+exports.synchronize = synchronizer.synchronize;
+exports.CopyAction = index.CopyAction;
+exports.DeleteLocalAction = index.DeleteLocalAction;
+exports.DeleteRemoteAction = index.DeleteRemoteAction;
+exports.DownloadAction = index.DownloadAction;
+exports.HideAction = index.HideAction;
+exports.SkipAction = index.SkipAction;
+exports.UploadAction = index.UploadAction;
+//# sourceMappingURL=index.cjs.map

package/dist/sync/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;"}

package/dist/sync/index.d.cts

@@ -0,0 +1,21 @@
+/**
+ * Sync engine for mirroring files between local folders and B2 buckets.
+ *
+ * The pipeline is: scan folders, pair files by relative path, generate actions
+ * based on comparison and keep policies, then execute with bounded concurrency.
+ *
+ * @packageDocumentation
+ */
+export { LocalFolder } from './scanners/local.js';
+export { B2Folder } from './scanners/b2.js';
+export { zipFolders } from './pairing.js';
+export { generateActions } from './policies/index.js';
+export { filesAreDifferent } from './policies/compare.js';
+export { synchronize } from './synchronizer.js';
+export type { SyncAction, SyncActionType, } from './actions/index.js';
+export { UploadAction, DownloadAction, CopyAction, HideAction, DeleteRemoteAction, DeleteLocalAction, SkipAction, } from './actions/index.js';
+export type { CompareMode, KeepMode, SyncDirection, SyncPath, LocalSyncPath, B2SyncPath, SyncEvent, SyncEventType, SyncActionEvent, SyncActionEventType, SyncSkipEvent, SyncErrorEvent, SyncOptions, SyncEncryptionProvider, SyncFolder, } from './types.js';
+export type { ActionFactory } from './policies/index.js';
+export type { SyncPair } from './pairing.js';
+export type { SynchronizerConfig, SynchronizerUpConfig, SynchronizerDownConfig, LocalSyncFolder, B2SyncFolder, } from './synchronizer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/sync/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,YAAY,EACV,UAAU,EACV,cAAc,GACf,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,GACX,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,WAAW,EACX,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,aAAa,EACb,UAAU,EACV,SAAS,EACT,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,WAAW,EACX,sBAAsB,EACtB,UAAU,GACX,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5C,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,YAAY,GACb,MAAM,mBAAmB,CAAA"}