@backblaze-labs/b2-sdk 0.1.0

package/dist/sync/index.d.ts

@@ -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.ts.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"}

package/dist/sync/index.js

@@ -0,0 +1,23 @@
+import { LocalFolder } from "./scanners/local.js";
+import { B2Folder } from "./scanners/b2.js";
+import { zipFolders } from "./pairing.js";
+import { generateActions } from "./policies/index.js";
+import { filesAreDifferent } from "./policies/compare.js";
+import { synchronize } from "./synchronizer.js";
+import { CopyAction, DeleteLocalAction, DeleteRemoteAction, DownloadAction, HideAction, SkipAction, UploadAction } from "./actions/index.js";
+export {
+  B2Folder,
+  CopyAction,
+  DeleteLocalAction,
+  DeleteRemoteAction,
+  DownloadAction,
+  HideAction,
+  LocalFolder,
+  SkipAction,
+  UploadAction,
+  filesAreDifferent,
+  generateActions,
+  synchronize,
+  zipFolders
+};
+//# sourceMappingURL=index.js.map

package/dist/sync/index.js.map

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

package/dist/sync/pairing.cjs

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+async function* zipFolders(source, dest) {
+  const sourceIter = source.scan()[Symbol.asyncIterator]();
+  const destIter = dest.scan()[Symbol.asyncIterator]();
+  let sourceResult = await sourceIter.next();
+  let destResult = await destIter.next();
+  while (!sourceResult.done || !destResult.done) {
+    const s = sourceResult.done ? null : sourceResult.value;
+    const d = destResult.done ? null : destResult.value;
+    if (s === null) {
+      yield [null, d];
+      destResult = await destIter.next();
+    } else if (d === null) {
+      yield [s, null];
+      sourceResult = await sourceIter.next();
+    } else if (s.relativePath < d.relativePath) {
+      yield [s, null];
+      sourceResult = await sourceIter.next();
+    } else if (d.relativePath < s.relativePath) {
+      yield [null, d];
+      destResult = await destIter.next();
+    } else {
+      yield [s, d];
+      sourceResult = await sourceIter.next();
+      destResult = await destIter.next();
+    }
+  }
+}
+exports.zipFolders = zipFolders;
+//# sourceMappingURL=pairing.cjs.map

package/dist/sync/pairing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.cjs","sources":["../../src/sync/pairing.ts"],"sourcesContent":["import type { SyncFolder, SyncPath } from './types.ts'\n\n/** A paired tuple of source and destination files. Either side may be null if the file is absent. */\nexport type SyncPair = readonly [SyncPath | null, SyncPath | null]\n\n/**\n * Merge-joins two sorted folder scans by relative path, yielding paired tuples.\n * Files present only in source yield `[source, null]`, only in dest yield `[null, dest]`,\n * and files in both yield `[source, dest]`.\n *\n * @param source - The source folder to scan.\n * @param dest - The destination folder to scan.\n */\nexport async function* zipFolders(source: SyncFolder, dest: SyncFolder): AsyncGenerator<SyncPair> {\n  const sourceIter = source.scan()[Symbol.asyncIterator]()\n  const destIter = dest.scan()[Symbol.asyncIterator]()\n\n  let sourceResult = await sourceIter.next()\n  let destResult = await destIter.next()\n\n  while (!sourceResult.done || !destResult.done) {\n    const s = sourceResult.done ? null : sourceResult.value\n    const d = destResult.done ? null : destResult.value\n\n    if (s === null) {\n      yield [null, d]\n      destResult = await destIter.next()\n    } else if (d === null) {\n      yield [s, null]\n      sourceResult = await sourceIter.next()\n    } else if (s.relativePath < d.relativePath) {\n      yield [s, null]\n      sourceResult = await sourceIter.next()\n    } else if (d.relativePath < s.relativePath) {\n      yield [null, d]\n      destResult = await destIter.next()\n    } else {\n      yield [s, d]\n      sourceResult = await sourceIter.next()\n      destResult = await destIter.next()\n    }\n  }\n}\n"],"names":[],"mappings":";;AAaA,gBAAuB,WAAW,QAAoB,MAA4C;AAChG,QAAM,aAAa,OAAO,KAAA,EAAO,OAAO,aAAa,EAAA;AACrD,QAAM,WAAW,KAAK,KAAA,EAAO,OAAO,aAAa,EAAA;AAEjD,MAAI,eAAe,MAAM,WAAW,KAAA;AACpC,MAAI,aAAa,MAAM,SAAS,KAAA;AAEhC,SAAO,CAAC,aAAa,QAAQ,CAAC,WAAW,MAAM;AAC7C,UAAM,IAAI,aAAa,OAAO,OAAO,aAAa;AAClD,UAAM,IAAI,WAAW,OAAO,OAAO,WAAW;AAE9C,QAAI,MAAM,MAAM;AACd,YAAM,CAAC,MAAM,CAAC;AACd,mBAAa,MAAM,SAAS,KAAA;AAAA,IAC9B,WAAW,MAAM,MAAM;AACrB,YAAM,CAAC,GAAG,IAAI;AACd,qBAAe,MAAM,WAAW,KAAA;AAAA,IAClC,WAAW,EAAE,eAAe,EAAE,cAAc;AAC1C,YAAM,CAAC,GAAG,IAAI;AACd,qBAAe,MAAM,WAAW,KAAA;AAAA,IAClC,WAAW,EAAE,eAAe,EAAE,cAAc;AAC1C,YAAM,CAAC,MAAM,CAAC;AACd,mBAAa,MAAM,SAAS,KAAA;AAAA,IAC9B,OAAO;AACL,YAAM,CAAC,GAAG,CAAC;AACX,qBAAe,MAAM,WAAW,KAAA;AAChC,mBAAa,MAAM,SAAS,KAAA;AAAA,IAC9B;AAAA,EACF;AACF;;"}

package/dist/sync/pairing.d.cts

@@ -0,0 +1,13 @@
+import { SyncFolder, SyncPath } from './types.js';
+/** A paired tuple of source and destination files. Either side may be null if the file is absent. */
+export type SyncPair = readonly [SyncPath | null, SyncPath | null];
+/**
+ * Merge-joins two sorted folder scans by relative path, yielding paired tuples.
+ * Files present only in source yield `[source, null]`, only in dest yield `[null, dest]`,
+ * and files in both yield `[source, dest]`.
+ *
+ * @param source - The source folder to scan.
+ * @param dest - The destination folder to scan.
+ */
+export declare function zipFolders(source: SyncFolder, dest: SyncFolder): AsyncGenerator<SyncPair>;
+//# sourceMappingURL=pairing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.d.ts","sourceRoot":"","sources":["../../src/sync/pairing.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAEtD,qGAAqG;AACrG,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAA;AAElE;;;;;;;GAOG;AACH,wBAAuB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,cAAc,CAAC,QAAQ,CAAC,CA6BhG"}

package/dist/sync/pairing.d.ts

@@ -0,0 +1,13 @@
+import { SyncFolder, SyncPath } from './types.js';
+/** A paired tuple of source and destination files. Either side may be null if the file is absent. */
+export type SyncPair = readonly [SyncPath | null, SyncPath | null];
+/**
+ * Merge-joins two sorted folder scans by relative path, yielding paired tuples.
+ * Files present only in source yield `[source, null]`, only in dest yield `[null, dest]`,
+ * and files in both yield `[source, dest]`.
+ *
+ * @param source - The source folder to scan.
+ * @param dest - The destination folder to scan.
+ */
+export declare function zipFolders(source: SyncFolder, dest: SyncFolder): AsyncGenerator<SyncPair>;
+//# sourceMappingURL=pairing.d.ts.map

package/dist/sync/pairing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.d.ts","sourceRoot":"","sources":["../../src/sync/pairing.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAEtD,qGAAqG;AACrG,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAA;AAElE;;;;;;;GAOG;AACH,wBAAuB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,cAAc,CAAC,QAAQ,CAAC,CA6BhG"}

package/dist/sync/pairing.js

@@ -0,0 +1,31 @@
+async function* zipFolders(source, dest) {
+  const sourceIter = source.scan()[Symbol.asyncIterator]();
+  const destIter = dest.scan()[Symbol.asyncIterator]();
+  let sourceResult = await sourceIter.next();
+  let destResult = await destIter.next();
+  while (!sourceResult.done || !destResult.done) {
+    const s = sourceResult.done ? null : sourceResult.value;
+    const d = destResult.done ? null : destResult.value;
+    if (s === null) {
+      yield [null, d];
+      destResult = await destIter.next();
+    } else if (d === null) {
+      yield [s, null];
+      sourceResult = await sourceIter.next();
+    } else if (s.relativePath < d.relativePath) {
+      yield [s, null];
+      sourceResult = await sourceIter.next();
+    } else if (d.relativePath < s.relativePath) {
+      yield [null, d];
+      destResult = await destIter.next();
+    } else {
+      yield [s, d];
+      sourceResult = await sourceIter.next();
+      destResult = await destIter.next();
+    }
+  }
+}
+export {
+  zipFolders
+};
+//# sourceMappingURL=pairing.js.map

package/dist/sync/pairing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.js","sources":["../../src/sync/pairing.ts"],"sourcesContent":["import type { SyncFolder, SyncPath } from './types.ts'\n\n/** A paired tuple of source and destination files. Either side may be null if the file is absent. */\nexport type SyncPair = readonly [SyncPath | null, SyncPath | null]\n\n/**\n * Merge-joins two sorted folder scans by relative path, yielding paired tuples.\n * Files present only in source yield `[source, null]`, only in dest yield `[null, dest]`,\n * and files in both yield `[source, dest]`.\n *\n * @param source - The source folder to scan.\n * @param dest - The destination folder to scan.\n */\nexport async function* zipFolders(source: SyncFolder, dest: SyncFolder): AsyncGenerator<SyncPair> {\n  const sourceIter = source.scan()[Symbol.asyncIterator]()\n  const destIter = dest.scan()[Symbol.asyncIterator]()\n\n  let sourceResult = await sourceIter.next()\n  let destResult = await destIter.next()\n\n  while (!sourceResult.done || !destResult.done) {\n    const s = sourceResult.done ? null : sourceResult.value\n    const d = destResult.done ? null : destResult.value\n\n    if (s === null) {\n      yield [null, d]\n      destResult = await destIter.next()\n    } else if (d === null) {\n      yield [s, null]\n      sourceResult = await sourceIter.next()\n    } else if (s.relativePath < d.relativePath) {\n      yield [s, null]\n      sourceResult = await sourceIter.next()\n    } else if (d.relativePath < s.relativePath) {\n      yield [null, d]\n      destResult = await destIter.next()\n    } else {\n      yield [s, d]\n      sourceResult = await sourceIter.next()\n      destResult = await destIter.next()\n    }\n  }\n}\n"],"names":[],"mappings":"AAaA,gBAAuB,WAAW,QAAoB,MAA4C;AAChG,QAAM,aAAa,OAAO,KAAA,EAAO,OAAO,aAAa,EAAA;AACrD,QAAM,WAAW,KAAK,KAAA,EAAO,OAAO,aAAa,EAAA;AAEjD,MAAI,eAAe,MAAM,WAAW,KAAA;AACpC,MAAI,aAAa,MAAM,SAAS,KAAA;AAEhC,SAAO,CAAC,aAAa,QAAQ,CAAC,WAAW,MAAM;AAC7C,UAAM,IAAI,aAAa,OAAO,OAAO,aAAa;AAClD,UAAM,IAAI,WAAW,OAAO,OAAO,WAAW;AAE9C,QAAI,MAAM,MAAM;AACd,YAAM,CAAC,MAAM,CAAC;AACd,mBAAa,MAAM,SAAS,KAAA;AAAA,IAC9B,WAAW,MAAM,MAAM;AACrB,YAAM,CAAC,GAAG,IAAI;AACd,qBAAe,MAAM,WAAW,KAAA;AAAA,IAClC,WAAW,EAAE,eAAe,EAAE,cAAc;AAC1C,YAAM,CAAC,GAAG,IAAI;AACd,qBAAe,MAAM,WAAW,KAAA;AAAA,IAClC,WAAW,EAAE,eAAe,EAAE,cAAc;AAC1C,YAAM,CAAC,MAAM,CAAC;AACd,mBAAa,MAAM,SAAS,KAAA;AAAA,IAC9B,OAAO;AACL,YAAM,CAAC,GAAG,CAAC;AACX,qBAAe,MAAM,WAAW,KAAA;AAChC,mBAAa,MAAM,SAAS,KAAA;AAAA,IAC9B;AAAA,EACF;AACF;"}

package/dist/sync/policies/compare.cjs

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function filesAreDifferent(source, dest, compareMode, threshold = 0) {
+  switch (compareMode) {
+    case "none":
+      return false;
+    case "size":
+      return Math.abs(source.size - dest.size) > threshold;
+    case "modtime":
+      return Math.abs(source.modTimeMillis - dest.modTimeMillis) > threshold;
+  }
+}
+exports.filesAreDifferent = filesAreDifferent;
+//# sourceMappingURL=compare.cjs.map

package/dist/sync/policies/compare.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.cjs","sources":["../../../src/sync/policies/compare.ts"],"sourcesContent":["import type { CompareMode, SyncPath } from '../types.ts'\n\n/**\n * Determines whether two files should be considered different based on the compare mode.\n *\n * @param source - The source file metadata.\n * @param dest - The destination file metadata.\n * @param compareMode - The comparison strategy: 'modtime', 'size', or 'none'.\n * @param threshold - Tolerance for the comparison (bytes for size, milliseconds for modtime).\n *\n * @returns `true` if the files are considered different.\n */\nexport function filesAreDifferent(\n  source: SyncPath,\n  dest: SyncPath,\n  compareMode: CompareMode,\n  threshold = 0,\n): boolean {\n  switch (compareMode) {\n    case 'none':\n      return false\n    case 'size':\n      return Math.abs(source.size - dest.size) > threshold\n    case 'modtime':\n      return Math.abs(source.modTimeMillis - dest.modTimeMillis) > threshold\n  }\n}\n"],"names":[],"mappings":";;AAYO,SAAS,kBACd,QACA,MACA,aACA,YAAY,GACH;AACT,UAAQ,aAAA;AAAA,IACN,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,KAAK,IAAI,OAAO,OAAO,KAAK,IAAI,IAAI;AAAA,IAC7C,KAAK;AACH,aAAO,KAAK,IAAI,OAAO,gBAAgB,KAAK,aAAa,IAAI;AAAA,EAAA;AAEnE;;"}

package/dist/sync/policies/compare.d.cts

@@ -0,0 +1,13 @@
+import { CompareMode, SyncPath } from '../types.js';
+/**
+ * Determines whether two files should be considered different based on the compare mode.
+ *
+ * @param source - The source file metadata.
+ * @param dest - The destination file metadata.
+ * @param compareMode - The comparison strategy: 'modtime', 'size', or 'none'.
+ * @param threshold - Tolerance for the comparison (bytes for size, milliseconds for modtime).
+ *
+ * @returns `true` if the files are considered different.
+ */
+export declare function filesAreDifferent(source: SyncPath, dest: SyncPath, compareMode: CompareMode, threshold?: number): boolean;
+//# sourceMappingURL=compare.d.ts.map

package/dist/sync/policies/compare.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../../src/sync/policies/compare.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAExD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,QAAQ,EACd,WAAW,EAAE,WAAW,EACxB,SAAS,SAAI,GACZ,OAAO,CAST"}

package/dist/sync/policies/compare.d.ts

@@ -0,0 +1,13 @@
+import { CompareMode, SyncPath } from '../types.js';
+/**
+ * Determines whether two files should be considered different based on the compare mode.
+ *
+ * @param source - The source file metadata.
+ * @param dest - The destination file metadata.
+ * @param compareMode - The comparison strategy: 'modtime', 'size', or 'none'.
+ * @param threshold - Tolerance for the comparison (bytes for size, milliseconds for modtime).
+ *
+ * @returns `true` if the files are considered different.
+ */
+export declare function filesAreDifferent(source: SyncPath, dest: SyncPath, compareMode: CompareMode, threshold?: number): boolean;
+//# sourceMappingURL=compare.d.ts.map

package/dist/sync/policies/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../../src/sync/policies/compare.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAExD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,QAAQ,EACd,WAAW,EAAE,WAAW,EACxB,SAAS,SAAI,GACZ,OAAO,CAST"}

package/dist/sync/policies/compare.js

@@ -0,0 +1,14 @@
+function filesAreDifferent(source, dest, compareMode, threshold = 0) {
+  switch (compareMode) {
+    case "none":
+      return false;
+    case "size":
+      return Math.abs(source.size - dest.size) > threshold;
+    case "modtime":
+      return Math.abs(source.modTimeMillis - dest.modTimeMillis) > threshold;
+  }
+}
+export {
+  filesAreDifferent
+};
+//# sourceMappingURL=compare.js.map

package/dist/sync/policies/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sources":["../../../src/sync/policies/compare.ts"],"sourcesContent":["import type { CompareMode, SyncPath } from '../types.ts'\n\n/**\n * Determines whether two files should be considered different based on the compare mode.\n *\n * @param source - The source file metadata.\n * @param dest - The destination file metadata.\n * @param compareMode - The comparison strategy: 'modtime', 'size', or 'none'.\n * @param threshold - Tolerance for the comparison (bytes for size, milliseconds for modtime).\n *\n * @returns `true` if the files are considered different.\n */\nexport function filesAreDifferent(\n  source: SyncPath,\n  dest: SyncPath,\n  compareMode: CompareMode,\n  threshold = 0,\n): boolean {\n  switch (compareMode) {\n    case 'none':\n      return false\n    case 'size':\n      return Math.abs(source.size - dest.size) > threshold\n    case 'modtime':\n      return Math.abs(source.modTimeMillis - dest.modTimeMillis) > threshold\n  }\n}\n"],"names":[],"mappings":"AAYO,SAAS,kBACd,QACA,MACA,aACA,YAAY,GACH;AACT,UAAQ,aAAA;AAAA,IACN,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,KAAK,IAAI,OAAO,OAAO,KAAK,IAAI,IAAI;AAAA,IAC7C,KAAK;AACH,aAAO,KAAK,IAAI,OAAO,gBAAgB,KAAK,aAAa,IAAI;AAAA,EAAA;AAEnE;"}

package/dist/sync/policies/index.cjs

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const index = require("../actions/index.cjs");
+const compare = require("./compare.cjs");
+function* generateActions(pair, direction, compareMode, keepMode, keepDays, nowMillis, factory, compareThreshold) {
+  const [source, dest] = pair;
+  if (source !== null && dest === null) {
+    yield* actionsForSourceOnly(source, direction, factory);
+  } else if (source === null && dest !== null) {
+    yield* actionsForDestOnly(dest, direction, keepMode, keepDays, nowMillis, factory);
+  } else if (source !== null && dest !== null) {
+    yield* actionsForBoth(source, dest, direction, compareMode, compareThreshold, factory);
+  }
+}
+function* actionsForSourceOnly(source, direction, factory) {
+  switch (direction) {
+    case "local-to-b2":
+      yield factory.upload(source);
+      break;
+    case "b2-to-local":
+      yield factory.download(source);
+      break;
+    case "b2-to-b2":
+      yield factory.copy(source, source.relativePath);
+      break;
+  }
+}
+function* actionsForDestOnly(dest, direction, keepMode, keepDays, nowMillis, factory) {
+  if (keepMode === "no-delete") {
+    yield new index.SkipAction(dest.relativePath, "not in source, keep-mode is no-delete");
+    return;
+  }
+  if (keepMode === "keep-days") {
+    const ageMillis = nowMillis - dest.modTimeMillis;
+    const ageDays = ageMillis / (24 * 60 * 60 * 1e3);
+    if (ageDays < keepDays) {
+      yield new index.SkipAction(
+        dest.relativePath,
+        `not in source, keeping for ${Math.ceil(keepDays - ageDays)} more days`
+      );
+      return;
+    }
+  }
+  switch (direction) {
+    case "local-to-b2":
+      yield factory.removeOrphan(dest);
+      break;
+    case "b2-to-local":
+      yield factory.deleteLocal(dest);
+      break;
+    case "b2-to-b2":
+      yield factory.removeOrphan(dest);
+      break;
+  }
+}
+function* actionsForBoth(source, dest, direction, compareMode, compareThreshold, factory) {
+  if (!compare.filesAreDifferent(source, dest, compareMode, compareThreshold)) {
+    yield new index.SkipAction(source.relativePath, "files are the same");
+    return;
+  }
+  switch (direction) {
+    case "local-to-b2":
+      yield factory.upload(source);
+      break;
+    case "b2-to-local":
+      yield factory.download(source);
+      break;
+    case "b2-to-b2":
+      yield factory.copy(source, dest.relativePath);
+      break;
+  }
+}
+exports.generateActions = generateActions;
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../src/sync/policies/index.ts"],"sourcesContent":["import type { SyncAction } from '../actions/index.ts'\nimport { SkipAction } from '../actions/index.ts'\nimport type { SyncPair } from '../pairing.ts'\nimport type {\n  B2SyncPath,\n  CompareMode,\n  KeepMode,\n  LocalSyncPath,\n  SyncDirection,\n  SyncPath,\n} from '../types.ts'\nimport { filesAreDifferent } from './compare.ts'\n\n/** Factory for creating concrete sync actions. Used by {@link generateActions} to decouple policy from execution. */\nexport interface ActionFactory {\n  /** Creates an action to upload a local file to B2. */\n  upload(source: LocalSyncPath): SyncAction\n  /** Creates an action to download a B2 file to the local filesystem. */\n  download(source: B2SyncPath): SyncAction\n  /** Creates an action to server-side copy a B2 file to a new destination path. */\n  copy(source: B2SyncPath, destPath: string): SyncAction\n  /** Creates an action to hide a file in B2 (soft delete). */\n  hide(path: string): SyncAction\n  /** Creates an action to permanently delete a remote B2 file version. */\n  deleteRemote(path: B2SyncPath): SyncAction\n  /** Creates an action to delete a local file. */\n  deleteLocal(path: LocalSyncPath): SyncAction\n  /**\n   * Creates the right \"remove this orphan from B2\" action for the bucket's\n   * configuration: a hide on a file-lock-enabled bucket (where direct\n   * delete may be blocked or stack hide markers), a plain\n   * delete-file-version on a vanilla bucket. Used by `actionsForDestOnly`\n   * to avoid yielding both a hide AND a delete when only one of them is\n   * the correct semantic for the destination bucket.\n   */\n  removeOrphan(dest: B2SyncPath): SyncAction\n}\n\n/**\n * Converts a paired source/dest tuple into zero or more sync actions based on the\n * sync direction, compare mode, and keep policy.\n *\n * @param pair - The source/dest file pair from {@link zipFolders}.\n * @param direction - The sync direction.\n * @param compareMode - How to compare files for differences.\n * @param keepMode - Policy for destination-only files.\n * @param keepDays - Retention period when keepMode is 'keep-days'.\n * @param nowMillis - Current time in milliseconds, used for keep-days calculation.\n * @param factory - Factory to create the concrete action objects.\n * @param compareThreshold - Tolerance for the comparison.\n */\nexport function* generateActions(\n  pair: SyncPair,\n  direction: SyncDirection,\n  compareMode: CompareMode,\n  keepMode: KeepMode,\n  keepDays: number,\n  nowMillis: number,\n  factory: ActionFactory,\n  compareThreshold: number,\n): Generator<SyncAction> {\n  const [source, dest] = pair\n\n  if (source !== null && dest === null) {\n    yield* actionsForSourceOnly(source, direction, factory)\n  } else if (source === null && dest !== null) {\n    yield* actionsForDestOnly(dest, direction, keepMode, keepDays, nowMillis, factory)\n  } else if (source !== null && dest !== null) {\n    yield* actionsForBoth(source, dest, direction, compareMode, compareThreshold, factory)\n  }\n}\n\nfunction* actionsForSourceOnly(\n  source: SyncPath,\n  direction: SyncDirection,\n  factory: ActionFactory,\n): Generator<SyncAction> {\n  switch (direction) {\n    case 'local-to-b2':\n      yield factory.upload(source as LocalSyncPath)\n      break\n    case 'b2-to-local':\n      yield factory.download(source as B2SyncPath)\n      break\n    case 'b2-to-b2':\n      yield factory.copy(source as B2SyncPath, source.relativePath)\n      break\n  }\n}\n\nfunction* actionsForDestOnly(\n  dest: SyncPath,\n  direction: SyncDirection,\n  keepMode: KeepMode,\n  keepDays: number,\n  nowMillis: number,\n  factory: ActionFactory,\n): Generator<SyncAction> {\n  if (keepMode === 'no-delete') {\n    yield new SkipAction(dest.relativePath, 'not in source, keep-mode is no-delete')\n    return\n  }\n\n  if (keepMode === 'keep-days') {\n    const ageMillis = nowMillis - dest.modTimeMillis\n    const ageDays = ageMillis / (24 * 60 * 60 * 1000)\n    if (ageDays < keepDays) {\n      yield new SkipAction(\n        dest.relativePath,\n        `not in source, keeping for ${Math.ceil(keepDays - ageDays)} more days`,\n      )\n      return\n    }\n  }\n\n  switch (direction) {\n    case 'local-to-b2':\n      // Single action — `removeOrphan` picks hide vs delete based on\n      // the destination bucket's `fileLockEnabled` state. The previous\n      // \"yield both\" behaviour stacked hide markers on vanilla buckets\n      // even though the delete that followed made them redundant.\n      yield factory.removeOrphan(dest as B2SyncPath)\n      break\n    case 'b2-to-local':\n      yield factory.deleteLocal(dest as LocalSyncPath)\n      break\n    case 'b2-to-b2':\n      yield factory.removeOrphan(dest as B2SyncPath)\n      break\n  }\n}\n\nfunction* actionsForBoth(\n  source: SyncPath,\n  dest: SyncPath,\n  direction: SyncDirection,\n  compareMode: CompareMode,\n  compareThreshold: number,\n  factory: ActionFactory,\n): Generator<SyncAction> {\n  if (!filesAreDifferent(source, dest, compareMode, compareThreshold)) {\n    yield new SkipAction(source.relativePath, 'files are the same')\n    return\n  }\n\n  switch (direction) {\n    case 'local-to-b2':\n      yield factory.upload(source as LocalSyncPath)\n      break\n    case 'b2-to-local':\n      yield factory.download(source as B2SyncPath)\n      break\n    case 'b2-to-b2':\n      yield factory.copy(source as B2SyncPath, dest.relativePath)\n      break\n  }\n}\n"],"names":["SkipAction","filesAreDifferent"],"mappings":";;;;AAmDO,UAAU,gBACf,MACA,WACA,aACA,UACA,UACA,WACA,SACA,kBACuB;AACvB,QAAM,CAAC,QAAQ,IAAI,IAAI;AAEvB,MAAI,WAAW,QAAQ,SAAS,MAAM;AACpC,WAAO,qBAAqB,QAAQ,WAAW,OAAO;AAAA,EACxD,WAAW,WAAW,QAAQ,SAAS,MAAM;AAC3C,WAAO,mBAAmB,MAAM,WAAW,UAAU,UAAU,WAAW,OAAO;AAAA,EACnF,WAAW,WAAW,QAAQ,SAAS,MAAM;AAC3C,WAAO,eAAe,QAAQ,MAAM,WAAW,aAAa,kBAAkB,OAAO;AAAA,EACvF;AACF;AAEA,UAAU,qBACR,QACA,WACA,SACuB;AACvB,UAAQ,WAAA;AAAA,IACN,KAAK;AACH,YAAM,QAAQ,OAAO,MAAuB;AAC5C;AAAA,IACF,KAAK;AACH,YAAM,QAAQ,SAAS,MAAoB;AAC3C;AAAA,IACF,KAAK;AACH,YAAM,QAAQ,KAAK,QAAsB,OAAO,YAAY;AAC5D;AAAA,EAAA;AAEN;AAEA,UAAU,mBACR,MACA,WACA,UACA,UACA,WACA,SACuB;AACvB,MAAI,aAAa,aAAa;AAC5B,UAAM,IAAIA,MAAAA,WAAW,KAAK,cAAc,uCAAuC;AAC/E;AAAA,EACF;AAEA,MAAI,aAAa,aAAa;AAC5B,UAAM,YAAY,YAAY,KAAK;AACnC,UAAM,UAAU,aAAa,KAAK,KAAK,KAAK;AAC5C,QAAI,UAAU,UAAU;AACtB,YAAM,IAAIA,MAAAA;AAAAA,QACR,KAAK;AAAA,QACL,8BAA8B,KAAK,KAAK,WAAW,OAAO,CAAC;AAAA,MAAA;AAE7D;AAAA,IACF;AAAA,EACF;AAEA,UAAQ,WAAA;AAAA,IACN,KAAK;AAKH,YAAM,QAAQ,aAAa,IAAkB;AAC7C;AAAA,IACF,KAAK;AACH,YAAM,QAAQ,YAAY,IAAqB;AAC/C;AAAA,IACF,KAAK;AACH,YAAM,QAAQ,aAAa,IAAkB;AAC7C;AAAA,EAAA;AAEN;AAEA,UAAU,eACR,QACA,MACA,WACA,aACA,kBACA,SACuB;AACvB,MAAI,CAACC,QAAAA,kBAAkB,QAAQ,MAAM,aAAa,gBAAgB,GAAG;AACnE,UAAM,IAAID,MAAAA,WAAW,OAAO,cAAc,oBAAoB;AAC9D;AAAA,EACF;AAEA,UAAQ,WAAA;AAAA,IACN,KAAK;AACH,YAAM,QAAQ,OAAO,MAAuB;AAC5C;AAAA,IACF,KAAK;AACH,YAAM,QAAQ,SAAS,MAAoB;AAC3C;AAAA,IACF,KAAK;AACH,YAAM,QAAQ,KAAK,QAAsB,KAAK,YAAY;AAC1D;AAAA,EAAA;AAEN;;"}

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

@@ -0,0 +1,42 @@
+import { SyncAction } from '../actions/index.js';
+import { SyncPair } from '../pairing.js';
+import { B2SyncPath, CompareMode, KeepMode, LocalSyncPath, SyncDirection } from '../types.js';
+/** Factory for creating concrete sync actions. Used by {@link generateActions} to decouple policy from execution. */
+export interface ActionFactory {
+    /** Creates an action to upload a local file to B2. */
+    upload(source: LocalSyncPath): SyncAction;
+    /** Creates an action to download a B2 file to the local filesystem. */
+    download(source: B2SyncPath): SyncAction;
+    /** Creates an action to server-side copy a B2 file to a new destination path. */
+    copy(source: B2SyncPath, destPath: string): SyncAction;
+    /** Creates an action to hide a file in B2 (soft delete). */
+    hide(path: string): SyncAction;
+    /** Creates an action to permanently delete a remote B2 file version. */
+    deleteRemote(path: B2SyncPath): SyncAction;
+    /** Creates an action to delete a local file. */
+    deleteLocal(path: LocalSyncPath): SyncAction;
+    /**
+     * Creates the right "remove this orphan from B2" action for the bucket's
+     * configuration: a hide on a file-lock-enabled bucket (where direct
+     * delete may be blocked or stack hide markers), a plain
+     * delete-file-version on a vanilla bucket. Used by `actionsForDestOnly`
+     * to avoid yielding both a hide AND a delete when only one of them is
+     * the correct semantic for the destination bucket.
+     */
+    removeOrphan(dest: B2SyncPath): SyncAction;
+}
+/**
+ * Converts a paired source/dest tuple into zero or more sync actions based on the
+ * sync direction, compare mode, and keep policy.
+ *
+ * @param pair - The source/dest file pair from {@link zipFolders}.
+ * @param direction - The sync direction.
+ * @param compareMode - How to compare files for differences.
+ * @param keepMode - Policy for destination-only files.
+ * @param keepDays - Retention period when keepMode is 'keep-days'.
+ * @param nowMillis - Current time in milliseconds, used for keep-days calculation.
+ * @param factory - Factory to create the concrete action objects.
+ * @param compareThreshold - Tolerance for the comparison.
+ */
+export declare function generateActions(pair: SyncPair, direction: SyncDirection, compareMode: CompareMode, keepMode: KeepMode, keepDays: number, nowMillis: number, factory: ActionFactory, compareThreshold: number): Generator<SyncAction>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sync/policies/index.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,QAAQ,EACR,aAAa,EACb,aAAa,EAEd,MAAM,aAAa,CAAA;AAGpB,qHAAqH;AACrH,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CAAA;IACzC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAAA;IACxC,iFAAiF;IACjF,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAA;IACtD,4DAA4D;IAC5D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAA;IAC9B,wEAAwE;IACxE,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAAA;IAC1C,gDAAgD;IAChD,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,UAAU,CAAA;IAC5C;;;;;;;OAOG;IACH,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAAA;CAC3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAiB,eAAe,CAC9B,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,aAAa,EACxB,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,EACtB,gBAAgB,EAAE,MAAM,GACvB,SAAS,CAAC,UAAU,CAAC,CAUvB"}

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

@@ -0,0 +1,42 @@
+import { SyncAction } from '../actions/index.js';
+import { SyncPair } from '../pairing.js';
+import { B2SyncPath, CompareMode, KeepMode, LocalSyncPath, SyncDirection } from '../types.js';
+/** Factory for creating concrete sync actions. Used by {@link generateActions} to decouple policy from execution. */
+export interface ActionFactory {
+    /** Creates an action to upload a local file to B2. */
+    upload(source: LocalSyncPath): SyncAction;
+    /** Creates an action to download a B2 file to the local filesystem. */
+    download(source: B2SyncPath): SyncAction;
+    /** Creates an action to server-side copy a B2 file to a new destination path. */
+    copy(source: B2SyncPath, destPath: string): SyncAction;
+    /** Creates an action to hide a file in B2 (soft delete). */
+    hide(path: string): SyncAction;
+    /** Creates an action to permanently delete a remote B2 file version. */
+    deleteRemote(path: B2SyncPath): SyncAction;
+    /** Creates an action to delete a local file. */
+    deleteLocal(path: LocalSyncPath): SyncAction;
+    /**
+     * Creates the right "remove this orphan from B2" action for the bucket's
+     * configuration: a hide on a file-lock-enabled bucket (where direct
+     * delete may be blocked or stack hide markers), a plain
+     * delete-file-version on a vanilla bucket. Used by `actionsForDestOnly`
+     * to avoid yielding both a hide AND a delete when only one of them is
+     * the correct semantic for the destination bucket.
+     */
+    removeOrphan(dest: B2SyncPath): SyncAction;
+}
+/**
+ * Converts a paired source/dest tuple into zero or more sync actions based on the
+ * sync direction, compare mode, and keep policy.
+ *
+ * @param pair - The source/dest file pair from {@link zipFolders}.
+ * @param direction - The sync direction.
+ * @param compareMode - How to compare files for differences.
+ * @param keepMode - Policy for destination-only files.
+ * @param keepDays - Retention period when keepMode is 'keep-days'.
+ * @param nowMillis - Current time in milliseconds, used for keep-days calculation.
+ * @param factory - Factory to create the concrete action objects.
+ * @param compareThreshold - Tolerance for the comparison.
+ */
+export declare function generateActions(pair: SyncPair, direction: SyncDirection, compareMode: CompareMode, keepMode: KeepMode, keepDays: number, nowMillis: number, factory: ActionFactory, compareThreshold: number): Generator<SyncAction>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sync/policies/index.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,QAAQ,EACR,aAAa,EACb,aAAa,EAEd,MAAM,aAAa,CAAA;AAGpB,qHAAqH;AACrH,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CAAA;IACzC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAAA;IACxC,iFAAiF;IACjF,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAA;IACtD,4DAA4D;IAC5D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAA;IAC9B,wEAAwE;IACxE,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAAA;IAC1C,gDAAgD;IAChD,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,UAAU,CAAA;IAC5C;;;;;;;OAOG;IACH,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAAA;CAC3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAiB,eAAe,CAC9B,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,aAAa,EACxB,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,EACtB,gBAAgB,EAAE,MAAM,GACvB,SAAS,CAAC,UAAU,CAAC,CAUvB"}

package/dist/sync/policies/index.js

@@ -0,0 +1,74 @@
+import { SkipAction } from "../actions/index.js";
+import { filesAreDifferent } from "./compare.js";
+function* generateActions(pair, direction, compareMode, keepMode, keepDays, nowMillis, factory, compareThreshold) {
+  const [source, dest] = pair;
+  if (source !== null && dest === null) {
+    yield* actionsForSourceOnly(source, direction, factory);
+  } else if (source === null && dest !== null) {
+    yield* actionsForDestOnly(dest, direction, keepMode, keepDays, nowMillis, factory);
+  } else if (source !== null && dest !== null) {
+    yield* actionsForBoth(source, dest, direction, compareMode, compareThreshold, factory);
+  }
+}
+function* actionsForSourceOnly(source, direction, factory) {
+  switch (direction) {
+    case "local-to-b2":
+      yield factory.upload(source);
+      break;
+    case "b2-to-local":
+      yield factory.download(source);
+      break;
+    case "b2-to-b2":
+      yield factory.copy(source, source.relativePath);
+      break;
+  }
+}
+function* actionsForDestOnly(dest, direction, keepMode, keepDays, nowMillis, factory) {
+  if (keepMode === "no-delete") {
+    yield new SkipAction(dest.relativePath, "not in source, keep-mode is no-delete");
+    return;
+  }
+  if (keepMode === "keep-days") {
+    const ageMillis = nowMillis - dest.modTimeMillis;
+    const ageDays = ageMillis / (24 * 60 * 60 * 1e3);
+    if (ageDays < keepDays) {
+      yield new SkipAction(
+        dest.relativePath,
+        `not in source, keeping for ${Math.ceil(keepDays - ageDays)} more days`
+      );
+      return;
+    }
+  }
+  switch (direction) {
+    case "local-to-b2":
+      yield factory.removeOrphan(dest);
+      break;
+    case "b2-to-local":
+      yield factory.deleteLocal(dest);
+      break;
+    case "b2-to-b2":
+      yield factory.removeOrphan(dest);
+      break;
+  }
+}
+function* actionsForBoth(source, dest, direction, compareMode, compareThreshold, factory) {
+  if (!filesAreDifferent(source, dest, compareMode, compareThreshold)) {
+    yield new SkipAction(source.relativePath, "files are the same");
+    return;
+  }
+  switch (direction) {
+    case "local-to-b2":
+      yield factory.upload(source);
+      break;
+    case "b2-to-local":
+      yield factory.download(source);
+      break;
+    case "b2-to-b2":
+      yield factory.copy(source, dest.relativePath);
+      break;
+  }
+}
+export {
+  generateActions
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/sync/policies/index.ts"],"sourcesContent":["import type { SyncAction } from '../actions/index.ts'\nimport { SkipAction } from '../actions/index.ts'\nimport type { SyncPair } from '../pairing.ts'\nimport type {\n  B2SyncPath,\n  CompareMode,\n  KeepMode,\n  LocalSyncPath,\n  SyncDirection,\n  SyncPath,\n} from '../types.ts'\nimport { filesAreDifferent } from './compare.ts'\n\n/** Factory for creating concrete sync actions. Used by {@link generateActions} to decouple policy from execution. */\nexport interface ActionFactory {\n  /** Creates an action to upload a local file to B2. */\n  upload(source: LocalSyncPath): SyncAction\n  /** Creates an action to download a B2 file to the local filesystem. */\n  download(source: B2SyncPath): SyncAction\n  /** Creates an action to server-side copy a B2 file to a new destination path. */\n  copy(source: B2SyncPath, destPath: string): SyncAction\n  /** Creates an action to hide a file in B2 (soft delete). */\n  hide(path: string): SyncAction\n  /** Creates an action to permanently delete a remote B2 file version. */\n  deleteRemote(path: B2SyncPath): SyncAction\n  /** Creates an action to delete a local file. */\n  deleteLocal(path: LocalSyncPath): SyncAction\n  /**\n   * Creates the right \"remove this orphan from B2\" action for the bucket's\n   * configuration: a hide on a file-lock-enabled bucket (where direct\n   * delete may be blocked or stack hide markers), a plain\n   * delete-file-version on a vanilla bucket. Used by `actionsForDestOnly`\n   * to avoid yielding both a hide AND a delete when only one of them is\n   * the correct semantic for the destination bucket.\n   */\n  removeOrphan(dest: B2SyncPath): SyncAction\n}\n\n/**\n * Converts a paired source/dest tuple into zero or more sync actions based on the\n * sync direction, compare mode, and keep policy.\n *\n * @param pair - The source/dest file pair from {@link zipFolders}.\n * @param direction - The sync direction.\n * @param compareMode - How to compare files for differences.\n * @param keepMode - Policy for destination-only files.\n * @param keepDays - Retention period when keepMode is 'keep-days'.\n * @param nowMillis - Current time in milliseconds, used for keep-days calculation.\n * @param factory - Factory to create the concrete action objects.\n * @param compareThreshold - Tolerance for the comparison.\n */\nexport function* generateActions(\n  pair: SyncPair,\n  direction: SyncDirection,\n  compareMode: CompareMode,\n  keepMode: KeepMode,\n  keepDays: number,\n  nowMillis: number,\n  factory: ActionFactory,\n  compareThreshold: number,\n): Generator<SyncAction> {\n  const [source, dest] = pair\n\n  if (source !== null && dest === null) {\n    yield* actionsForSourceOnly(source, direction, factory)\n  } else if (source === null && dest !== null) {\n    yield* actionsForDestOnly(dest, direction, keepMode, keepDays, nowMillis, factory)\n  } else if (source !== null && dest !== null) {\n    yield* actionsForBoth(source, dest, direction, compareMode, compareThreshold, factory)\n  }\n}\n\nfunction* actionsForSourceOnly(\n  source: SyncPath,\n  direction: SyncDirection,\n  factory: ActionFactory,\n): Generator<SyncAction> {\n  switch (direction) {\n    case 'local-to-b2':\n      yield factory.upload(source as LocalSyncPath)\n      break\n    case 'b2-to-local':\n      yield factory.download(source as B2SyncPath)\n      break\n    case 'b2-to-b2':\n      yield factory.copy(source as B2SyncPath, source.relativePath)\n      break\n  }\n}\n\nfunction* actionsForDestOnly(\n  dest: SyncPath,\n  direction: SyncDirection,\n  keepMode: KeepMode,\n  keepDays: number,\n  nowMillis: number,\n  factory: ActionFactory,\n): Generator<SyncAction> {\n  if (keepMode === 'no-delete') {\n    yield new SkipAction(dest.relativePath, 'not in source, keep-mode is no-delete')\n    return\n  }\n\n  if (keepMode === 'keep-days') {\n    const ageMillis = nowMillis - dest.modTimeMillis\n    const ageDays = ageMillis / (24 * 60 * 60 * 1000)\n    if (ageDays < keepDays) {\n      yield new SkipAction(\n        dest.relativePath,\n        `not in source, keeping for ${Math.ceil(keepDays - ageDays)} more days`,\n      )\n      return\n    }\n  }\n\n  switch (direction) {\n    case 'local-to-b2':\n      // Single action — `removeOrphan` picks hide vs delete based on\n      // the destination bucket's `fileLockEnabled` state. The previous\n      // \"yield both\" behaviour stacked hide markers on vanilla buckets\n      // even though the delete that followed made them redundant.\n      yield factory.removeOrphan(dest as B2SyncPath)\n      break\n    case 'b2-to-local':\n      yield factory.deleteLocal(dest as LocalSyncPath)\n      break\n    case 'b2-to-b2':\n      yield factory.removeOrphan(dest as B2SyncPath)\n      break\n  }\n}\n\nfunction* actionsForBoth(\n  source: SyncPath,\n  dest: SyncPath,\n  direction: SyncDirection,\n  compareMode: CompareMode,\n  compareThreshold: number,\n  factory: ActionFactory,\n): Generator<SyncAction> {\n  if (!filesAreDifferent(source, dest, compareMode, compareThreshold)) {\n    yield new SkipAction(source.relativePath, 'files are the same')\n    return\n  }\n\n  switch (direction) {\n    case 'local-to-b2':\n      yield factory.upload(source as LocalSyncPath)\n      break\n    case 'b2-to-local':\n      yield factory.download(source as B2SyncPath)\n      break\n    case 'b2-to-b2':\n      yield factory.copy(source as B2SyncPath, dest.relativePath)\n      break\n  }\n}\n"],"names":[],"mappings":";;AAmDO,UAAU,gBACf,MACA,WACA,aACA,UACA,UACA,WACA,SACA,kBACuB;AACvB,QAAM,CAAC,QAAQ,IAAI,IAAI;AAEvB,MAAI,WAAW,QAAQ,SAAS,MAAM;AACpC,WAAO,qBAAqB,QAAQ,WAAW,OAAO;AAAA,EACxD,WAAW,WAAW,QAAQ,SAAS,MAAM;AAC3C,WAAO,mBAAmB,MAAM,WAAW,UAAU,UAAU,WAAW,OAAO;AAAA,EACnF,WAAW,WAAW,QAAQ,SAAS,MAAM;AAC3C,WAAO,eAAe,QAAQ,MAAM,WAAW,aAAa,kBAAkB,OAAO;AAAA,EACvF;AACF;AAEA,UAAU,qBACR,QACA,WACA,SACuB;AACvB,UAAQ,WAAA;AAAA,IACN,KAAK;AACH,YAAM,QAAQ,OAAO,MAAuB;AAC5C;AAAA,IACF,KAAK;AACH,YAAM,QAAQ,SAAS,MAAoB;AAC3C;AAAA,IACF,KAAK;AACH,YAAM,QAAQ,KAAK,QAAsB,OAAO,YAAY;AAC5D;AAAA,EAAA;AAEN;AAEA,UAAU,mBACR,MACA,WACA,UACA,UACA,WACA,SACuB;AACvB,MAAI,aAAa,aAAa;AAC5B,UAAM,IAAI,WAAW,KAAK,cAAc,uCAAuC;AAC/E;AAAA,EACF;AAEA,MAAI,aAAa,aAAa;AAC5B,UAAM,YAAY,YAAY,KAAK;AACnC,UAAM,UAAU,aAAa,KAAK,KAAK,KAAK;AAC5C,QAAI,UAAU,UAAU;AACtB,YAAM,IAAI;AAAA,QACR,KAAK;AAAA,QACL,8BAA8B,KAAK,KAAK,WAAW,OAAO,CAAC;AAAA,MAAA;AAE7D;AAAA,IACF;AAAA,EACF;AAEA,UAAQ,WAAA;AAAA,IACN,KAAK;AAKH,YAAM,QAAQ,aAAa,IAAkB;AAC7C;AAAA,IACF,KAAK;AACH,YAAM,QAAQ,YAAY,IAAqB;AAC/C;AAAA,IACF,KAAK;AACH,YAAM,QAAQ,aAAa,IAAkB;AAC7C;AAAA,EAAA;AAEN;AAEA,UAAU,eACR,QACA,MACA,WACA,aACA,kBACA,SACuB;AACvB,MAAI,CAAC,kBAAkB,QAAQ,MAAM,aAAa,gBAAgB,GAAG;AACnE,UAAM,IAAI,WAAW,OAAO,cAAc,oBAAoB;AAC9D;AAAA,EACF;AAEA,UAAQ,WAAA;AAAA,IACN,KAAK;AACH,YAAM,QAAQ,OAAO,MAAuB;AAC5C;AAAA,IACF,KAAK;AACH,YAAM,QAAQ,SAAS,MAAoB;AAC3C;AAAA,IACF,KAAK;AACH,YAAM,QAAQ,KAAK,QAAsB,KAAK,YAAY;AAC1D;AAAA,EAAA;AAEN;"}

package/dist/sync/scanners/b2.cjs

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const file = require("../../types/file.cjs");
+class B2Folder {
+  type = "b2";
+  bucket;
+  prefix;
+  /**
+   * Creates a new B2Folder for the given bucket and optional prefix.
+   * @param bucket - The B2 bucket to scan.
+   * @param prefix - Optional key prefix to restrict the scan scope.
+   */
+  constructor(bucket, prefix = "") {
+    this.bucket = bucket;
+    this.prefix = prefix;
+  }
+  /** Lists all file versions in the bucket, groups by name, and yields the latest visible version. */
+  async *scan() {
+    const grouped = /* @__PURE__ */ new Map();
+    let startFileName;
+    let startFileId;
+    while (true) {
+      const listing = await this.bucket.listFileVersions({
+        ...this.prefix !== "" ? { prefix: this.prefix } : {},
+        ...startFileName !== void 0 ? { startFileName } : {},
+        ...startFileId !== void 0 ? { startFileId } : {}
+      });
+      for (const fv of listing.files) {
+        const existing = grouped.get(fv.fileName);
+        if (existing) {
+          existing.push(fv);
+        } else {
+          grouped.set(fv.fileName, [fv]);
+        }
+      }
+      if (!listing.nextFileName) break;
+      startFileName = listing.nextFileName;
+      startFileId = listing.nextFileId;
+    }
+    const sorted = [...grouped.entries()].sort((a, b) => a[0].localeCompare(b[0]));
+    for (const [fileName, versions] of sorted) {
+      versions.sort((a, b) => b.uploadTimestamp - a.uploadTimestamp);
+      const selected = versions[0];
+      if (!selected || selected.action === file.FileAction.Hide) continue;
+      const relativePath = this.prefix !== "" ? fileName.slice(this.prefix.length) : fileName;
+      yield {
+        relativePath,
+        modTimeMillis: selected.uploadTimestamp,
+        size: selected.contentLength,
+        selectedVersion: selected,
+        allVersions: versions
+      };
+    }
+  }
+}
+exports.B2Folder = B2Folder;
+//# sourceMappingURL=b2.cjs.map

package/dist/sync/scanners/b2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"b2.cjs","sources":["../../../src/sync/scanners/b2.ts"],"sourcesContent":["import type { Bucket } from '../../bucket.ts'\nimport { FileAction, type FileVersion } from '../../types/file.ts'\nimport type { B2SyncPath, SyncFolder } from '../types.ts'\n\n/**\n * Scans a B2 bucket (optionally filtered by prefix) and yields {@link B2SyncPath} entries\n * sorted by file name. Hidden files are excluded. All versions are fetched and grouped.\n */\nexport class B2Folder implements SyncFolder {\n  readonly type = 'b2' as const\n  private readonly bucket: Bucket\n  private readonly prefix: string\n\n  /**\n   * Creates a new B2Folder for the given bucket and optional prefix.\n   * @param bucket - The B2 bucket to scan.\n   * @param prefix - Optional key prefix to restrict the scan scope.\n   */\n  constructor(bucket: Bucket, prefix = '') {\n    this.bucket = bucket\n    this.prefix = prefix\n  }\n\n  /** Lists all file versions in the bucket, groups by name, and yields the latest visible version. */\n  async *scan(): AsyncGenerator<B2SyncPath> {\n    const grouped = new Map<string, FileVersion[]>()\n\n    let startFileName: string | undefined\n    let startFileId: string | undefined\n\n    while (true) {\n      const listing = await this.bucket.listFileVersions({\n        ...(this.prefix !== '' ? { prefix: this.prefix } : {}),\n        ...(startFileName !== undefined ? { startFileName } : {}),\n        ...(startFileId !== undefined\n          ? { startFileId: startFileId as import('../../types/ids.ts').FileId }\n          : {}),\n      })\n\n      for (const fv of listing.files) {\n        const existing = grouped.get(fv.fileName)\n        if (existing) {\n          existing.push(fv)\n        } else {\n          grouped.set(fv.fileName, [fv])\n        }\n      }\n\n      if (!listing.nextFileName) break\n      startFileName = listing.nextFileName\n      startFileId = listing.nextFileId as string | undefined\n    }\n\n    const sorted = [...grouped.entries()].sort((a, b) => a[0].localeCompare(b[0]))\n\n    for (const [fileName, versions] of sorted) {\n      versions.sort((a, b) => b.uploadTimestamp - a.uploadTimestamp)\n      const selected = versions[0]\n      if (!selected || selected.action === FileAction.Hide) continue\n\n      const relativePath = this.prefix !== '' ? fileName.slice(this.prefix.length) : fileName\n\n      yield {\n        relativePath,\n        modTimeMillis: selected.uploadTimestamp,\n        size: selected.contentLength,\n        selectedVersion: selected,\n        allVersions: versions,\n      }\n    }\n  }\n}\n"],"names":["FileAction"],"mappings":";;;AAQO,MAAM,SAA+B;AAAA,EACjC,OAAO;AAAA,EACC;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOjB,YAAY,QAAgB,SAAS,IAAI;AACvC,SAAK,SAAS;AACd,SAAK,SAAS;AAAA,EAChB;AAAA;AAAA,EAGA,OAAO,OAAmC;AACxC,UAAM,8BAAc,IAAA;AAEpB,QAAI;AACJ,QAAI;AAEJ,WAAO,MAAM;AACX,YAAM,UAAU,MAAM,KAAK,OAAO,iBAAiB;AAAA,QACjD,GAAI,KAAK,WAAW,KAAK,EAAE,QAAQ,KAAK,OAAA,IAAW,CAAA;AAAA,QACnD,GAAI,kBAAkB,SAAY,EAAE,cAAA,IAAkB,CAAA;AAAA,QACtD,GAAI,gBAAgB,SAChB,EAAE,gBACF,CAAA;AAAA,MAAC,CACN;AAED,iBAAW,MAAM,QAAQ,OAAO;AAC9B,cAAM,WAAW,QAAQ,IAAI,GAAG,QAAQ;AACxC,YAAI,UAAU;AACZ,mBAAS,KAAK,EAAE;AAAA,QAClB,OAAO;AACL,kBAAQ,IAAI,GAAG,UAAU,CAAC,EAAE,CAAC;AAAA,QAC/B;AAAA,MACF;AAEA,UAAI,CAAC,QAAQ,aAAc;AAC3B,sBAAgB,QAAQ;AACxB,oBAAc,QAAQ;AAAA,IACxB;AAEA,UAAM,SAAS,CAAC,GAAG,QAAQ,QAAA,CAAS,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;AAE7E,eAAW,CAAC,UAAU,QAAQ,KAAK,QAAQ;AACzC,eAAS,KAAK,CAAC,GAAG,MAAM,EAAE,kBAAkB,EAAE,eAAe;AAC7D,YAAM,WAAW,SAAS,CAAC;AAC3B,UAAI,CAAC,YAAY,SAAS,WAAWA,KAAAA,WAAW,KAAM;AAEtD,YAAM,eAAe,KAAK,WAAW,KAAK,SAAS,MAAM,KAAK,OAAO,MAAM,IAAI;AAE/E,YAAM;AAAA,QACJ;AAAA,QACA,eAAe,SAAS;AAAA,QACxB,MAAM,SAAS;AAAA,QACf,iBAAiB;AAAA,QACjB,aAAa;AAAA,MAAA;AAAA,IAEjB;AAAA,EACF;AACF;;"}

package/dist/sync/scanners/b2.d.cts

@@ -0,0 +1,20 @@
+import { Bucket } from '../../bucket.js';
+import { B2SyncPath, SyncFolder } from '../types.js';
+/**
+ * Scans a B2 bucket (optionally filtered by prefix) and yields {@link B2SyncPath} entries
+ * sorted by file name. Hidden files are excluded. All versions are fetched and grouped.
+ */
+export declare class B2Folder implements SyncFolder {
+    readonly type: "b2";
+    private readonly bucket;
+    private readonly prefix;
+    /**
+     * Creates a new B2Folder for the given bucket and optional prefix.
+     * @param bucket - The B2 bucket to scan.
+     * @param prefix - Optional key prefix to restrict the scan scope.
+     */
+    constructor(bucket: Bucket, prefix?: string);
+    /** Lists all file versions in the bucket, groups by name, and yields the latest visible version. */
+    scan(): AsyncGenerator<B2SyncPath>;
+}
+//# sourceMappingURL=b2.d.ts.map

package/dist/sync/scanners/b2.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"b2.d.ts","sourceRoot":"","sources":["../../../src/sync/scanners/b2.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEzD;;;GAGG;AACH,qBAAa,QAAS,YAAW,UAAU;IACzC,QAAQ,CAAC,IAAI,EAAG,IAAI,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAE/B;;;;OAIG;gBACS,MAAM,EAAE,MAAM,EAAE,MAAM,SAAK;IAKvC,oGAAoG;IAC7F,IAAI,IAAI,cAAc,CAAC,UAAU,CAAC;CA+C1C"}