@backblaze-labs/b2-sdk 0.1.0 → 0.3.0

package/dist/sync/index.cjs

@@ -1,23 +1,40 @@
-"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
+const require_index = require("./actions/index.cjs");
+const require_filters = require("./filters.cjs");
+const require_path_order = require("./path-order.cjs");
+const require_pairing = require("./pairing.cjs");
+const require_sha1_metadata = require("./sha1-metadata.cjs");
+const require_compare = require("./policies/compare.cjs");
+const require_index$1 = require("./policies/index.cjs");
+const require_prefix = require("./prefix.cjs");
+const require_b2 = require("./scanners/b2.cjs");
+const require_local = require("./scanners/local.cjs");
+const require_synchronizer = require("./synchronizer.cjs");
+exports.B2Folder = require_b2.B2Folder;
+exports.CopyAction = require_index.CopyAction;
+exports.DeleteLocalAction = require_index.DeleteLocalAction;
+exports.DeleteRemoteAction = require_index.DeleteRemoteAction;
+exports.DownloadAction = require_index.DownloadAction;
+exports.HideAction = require_index.HideAction;
+exports.LocalFolder = require_local.LocalFolder;
+exports.SkipAction = require_index.SkipAction;
+exports.UploadAction = require_index.UploadAction;
+exports.asRawB2KeyPrefix = require_prefix.asRawB2KeyPrefix;
+exports.b2KeyToRelativePathUnderPrefix = require_prefix.b2KeyToRelativePathUnderPrefix;
+exports.compareSyncRelativePaths = require_path_order.compareSyncRelativePaths;
+exports.directoryMayContainSyncPaths = require_filters.directoryMayContainSyncPaths;
+exports.filesAreDifferent = require_compare.filesAreDifferent;
+exports.filterSyncPaths = require_filters.filterSyncPaths;
+exports.generateActions = require_index$1.generateActions;
+exports.isUntrustedSha1 = require_sha1_metadata.isUntrustedSha1;
+exports.literalPrefixForSyncFilters = require_filters.literalPrefixForSyncFilters;
+exports.normalizeB2RelativePath = require_prefix.normalizeB2RelativePath;
+exports.parseSyncContentSha1 = require_sha1_metadata.parseSyncContentSha1;
+exports.pathPassesSyncFilters = require_filters.pathPassesSyncFilters;
+exports.pathSkippedByRegExpInputLimit = require_filters.pathSkippedByRegExpInputLimit;
+exports.selectB2ComparableSha1 = require_sha1_metadata.selectB2ComparableSha1;
+exports.syncSha1StateOf = require_sha1_metadata.syncSha1StateOf;
+exports.synchronize = require_synchronizer.synchronize;
+exports.untrustedSha1 = require_sha1_metadata.untrustedSha1;
+exports.untrustedSha1Prefix = require_sha1_metadata.untrustedSha1Prefix;
+exports.zipFolders = require_pairing.zipFolders;

package/dist/sync/index.d.cts

@@ -6,16 +6,21 @@
  *
  * @packageDocumentation
  */
-export { LocalFolder } from './scanners/local.js';
-export { B2Folder } from './scanners/b2.js';
+export type { SyncAction, SyncActionType, } from './actions/index.js';
+export { CopyAction, DeleteLocalAction, DeleteRemoteAction, DownloadAction, HideAction, SkipAction, UploadAction, } from './actions/index.js';
+export { directoryMayContainSyncPaths, filterSyncPaths, literalPrefixForSyncFilters, pathPassesSyncFilters, pathSkippedByRegExpInputLimit, } from './filters.js';
+export type { SyncPair } from './pairing.js';
 export { zipFolders } from './pairing.js';
-export { generateActions } from './policies/index.js';
+export { compareSyncRelativePaths } from './path-order.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';
+export { generateActions } from './policies/index.js';
+export { asRawB2KeyPrefix, b2KeyToRelativePathUnderPrefix, normalizeB2RelativePath, } from './prefix.js';
+export { B2Folder } from './scanners/b2.js';
+export { LocalFolder } from './scanners/local.js';
+export type { SyncSha1PendingState, SyncSha1State, SyncSha1UnavailableState, SyncSha1UntrustedState, SyncSha1VerifiedState, } from './sha1-metadata.js';
+export { isUntrustedSha1, parseSyncContentSha1, selectB2ComparableSha1, syncSha1StateOf, untrustedSha1, untrustedSha1Prefix, } from './sha1-metadata.js';
+export type { B2SyncFolder, LocalSyncFolder, SupportedSynchronizerConfig, SynchronizerB2Config, SynchronizerConfig, SynchronizerDownConfig, SynchronizerUpConfig, } from './synchronizer.js';
+export { synchronize } from './synchronizer.js';
+export type { B2SyncPath, CompareMode, KeepMode, LocalFileIdentity, LocalSyncPath, SyncActionEvent, SyncActionEventType, SyncCompareEvent, SyncDirection, SyncEncryptionProvider, SyncErrorEvent, SyncEvent, SyncEventType, SyncFilterOptions, SyncFilterPattern, SyncFolder, SyncOptions, SyncPath, SyncScanOptions, SyncSkipEvent, SyncSkipReason, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,UAAU,EACV,cAAc,GACf,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,4BAA4B,EAC5B,eAAe,EACf,2BAA2B,EAC3B,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EACL,gBAAgB,EAChB,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,aAAa,EACb,mBAAmB,GACpB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,YAAY,EACZ,eAAe,EACf,2BAA2B,EAC3B,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,YAAY,EACV,UAAU,EACV,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,QAAQ,EACR,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAA"}

package/dist/sync/index.d.ts

@@ -6,16 +6,21 @@
  *
  * @packageDocumentation
  */
-export { LocalFolder } from './scanners/local.js';
-export { B2Folder } from './scanners/b2.js';
+export type { SyncAction, SyncActionType, } from './actions/index.js';
+export { CopyAction, DeleteLocalAction, DeleteRemoteAction, DownloadAction, HideAction, SkipAction, UploadAction, } from './actions/index.js';
+export { directoryMayContainSyncPaths, filterSyncPaths, literalPrefixForSyncFilters, pathPassesSyncFilters, pathSkippedByRegExpInputLimit, } from './filters.js';
+export type { SyncPair } from './pairing.js';
 export { zipFolders } from './pairing.js';
-export { generateActions } from './policies/index.js';
+export { compareSyncRelativePaths } from './path-order.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';
+export { generateActions } from './policies/index.js';
+export { asRawB2KeyPrefix, b2KeyToRelativePathUnderPrefix, normalizeB2RelativePath, } from './prefix.js';
+export { B2Folder } from './scanners/b2.js';
+export { LocalFolder } from './scanners/local.js';
+export type { SyncSha1PendingState, SyncSha1State, SyncSha1UnavailableState, SyncSha1UntrustedState, SyncSha1VerifiedState, } from './sha1-metadata.js';
+export { isUntrustedSha1, parseSyncContentSha1, selectB2ComparableSha1, syncSha1StateOf, untrustedSha1, untrustedSha1Prefix, } from './sha1-metadata.js';
+export type { B2SyncFolder, LocalSyncFolder, SupportedSynchronizerConfig, SynchronizerB2Config, SynchronizerConfig, SynchronizerDownConfig, SynchronizerUpConfig, } from './synchronizer.js';
+export { synchronize } from './synchronizer.js';
+export type { B2SyncPath, CompareMode, KeepMode, LocalFileIdentity, LocalSyncPath, SyncActionEvent, SyncActionEventType, SyncCompareEvent, SyncDirection, SyncEncryptionProvider, SyncErrorEvent, SyncEvent, SyncEventType, SyncFilterOptions, SyncFilterPattern, SyncFolder, SyncOptions, SyncPath, SyncScanOptions, SyncSkipEvent, SyncSkipReason, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,UAAU,EACV,cAAc,GACf,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,4BAA4B,EAC5B,eAAe,EACf,2BAA2B,EAC3B,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EACL,gBAAgB,EAChB,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,aAAa,EACb,mBAAmB,GACpB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,YAAY,EACZ,eAAe,EACf,2BAA2B,EAC3B,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,YAAY,EACV,UAAU,EACV,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,QAAQ,EACR,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAA"}

package/dist/sync/index.js

@@ -1,23 +1,12 @@
-import { LocalFolder } from "./scanners/local.js";
-import { B2Folder } from "./scanners/b2.js";
+import { CopyAction, DeleteLocalAction, DeleteRemoteAction, DownloadAction, HideAction, SkipAction, UploadAction } from "./actions/index.js";
+import { directoryMayContainSyncPaths, filterSyncPaths, literalPrefixForSyncFilters, pathPassesSyncFilters, pathSkippedByRegExpInputLimit } from "./filters.js";
+import { compareSyncRelativePaths } from "./path-order.js";
 import { zipFolders } from "./pairing.js";
-import { generateActions } from "./policies/index.js";
+import { isUntrustedSha1, parseSyncContentSha1, selectB2ComparableSha1, syncSha1StateOf, untrustedSha1, untrustedSha1Prefix } from "./sha1-metadata.js";
 import { filesAreDifferent } from "./policies/compare.js";
+import { generateActions } from "./policies/index.js";
+import { asRawB2KeyPrefix, b2KeyToRelativePathUnderPrefix, normalizeB2RelativePath } from "./prefix.js";
+import { B2Folder } from "./scanners/b2.js";
+import { LocalFolder } from "./scanners/local.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
+export { B2Folder, CopyAction, DeleteLocalAction, DeleteRemoteAction, DownloadAction, HideAction, LocalFolder, SkipAction, UploadAction, asRawB2KeyPrefix, b2KeyToRelativePathUnderPrefix, compareSyncRelativePaths, directoryMayContainSyncPaths, filesAreDifferent, filterSyncPaths, generateActions, isUntrustedSha1, literalPrefixForSyncFilters, normalizeB2RelativePath, parseSyncContentSha1, pathPassesSyncFilters, pathSkippedByRegExpInputLimit, selectB2ComparableSha1, syncSha1StateOf, synchronize, untrustedSha1, untrustedSha1Prefix, zipFolders };

package/dist/sync/local-file-identity.cjs

@@ -0,0 +1,61 @@
+//#region src/sync/local-file-identity.ts
+/**
+* Converts Node file stats into the sync scanner's persisted identity shape.
+* @param stats - Node file stats to convert.
+*
+* @returns The scanner identity stored with a local sync path.
+*
+* @internal
+*/
+function localFileIdentityFromStats(stats) {
+	return {
+		deviceId: stats.dev,
+		inode: stats.ino,
+		size: stats.size,
+		modTimeMillis: Math.floor(stats.mtimeMs),
+		changeTimeMillis: Math.floor(stats.ctimeMs)
+	};
+}
+/**
+* Verifies that current local stats still match a previously scanned regular file.
+* @param stats - Current filesystem stats for the candidate file.
+* @param path - Previously scanned local sync path.
+* @param operation - Operation name used in mutation diagnostics.
+* @param options - Platform and ctime comparison overrides for controlled filesystem moves.
+*
+* @throws If the current file is not the scanned regular file.
+*
+* @internal
+*/
+function assertSameScannedRegularFile(stats, path, operation = "upload", options = {}) {
+	const reason = `local file changed before ${operation}`;
+	if (!stats.isFile()) {
+		if (operation === "delete") throw Object.assign(/* @__PURE__ */ new Error(`${reason}: not a regular file`), { code: "EISDIR" });
+		throw new Error(`${reason}: not a regular file`);
+	}
+	if (stats.size !== path.size) throw new Error(`${reason}: size changed`);
+	const identity = path.fileIdentity;
+	if (identity === void 0) return;
+	if (!sameLocalIdentity(stats, identity, {
+		compareChangeTime: options.compareChangeTime,
+		platform: options.platform ?? currentPlatform()
+	})) throw new Error(reason);
+}
+function sameLocalIdentity(stats, identity, options) {
+	const compareChangeTime = options.compareChangeTime ?? shouldComparePosixChangeTime(options.platform);
+	return (!shouldComparePosixFileIdentity(options.platform) || stats.dev === identity.deviceId && stats.ino === identity.inode) && stats.size === identity.size && Math.floor(stats.mtimeMs) === identity.modTimeMillis && (!compareChangeTime || identity.changeTimeMillis === void 0 || Math.floor(stats.ctimeMs) === identity.changeTimeMillis);
+}
+function shouldComparePosixFileIdentity(platform) {
+	return platform !== "win32";
+}
+function shouldComparePosixChangeTime(platform) {
+	return platform !== "win32";
+}
+function currentPlatform() {
+	return globalThis.process?.platform;
+}
+//#endregion
+exports.assertSameScannedRegularFile = assertSameScannedRegularFile;
+exports.localFileIdentityFromStats = localFileIdentityFromStats;
+
+//# sourceMappingURL=local-file-identity.cjs.map

package/dist/sync/local-file-identity.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file-identity.cjs","names":[],"sources":["../../src/sync/local-file-identity.ts"],"sourcesContent":["import type { LocalFileIdentity, LocalSyncPath } from './types.ts'\n\ninterface LocalFileStatsLike {\n  readonly dev: number\n  readonly ino: number\n  readonly mtimeMs: number\n  readonly ctimeMs: number\n  readonly size: number\n}\n\ninterface LocalRegularFileStatsLike extends LocalFileStatsLike {\n  isFile(): boolean\n}\n\n/**\n * Converts Node file stats into the sync scanner's persisted identity shape.\n * @param stats - Node file stats to convert.\n *\n * @returns The scanner identity stored with a local sync path.\n *\n * @internal\n */\nexport function localFileIdentityFromStats(stats: LocalFileStatsLike): LocalFileIdentity {\n  return {\n    deviceId: stats.dev,\n    inode: stats.ino,\n    size: stats.size,\n    modTimeMillis: Math.floor(stats.mtimeMs),\n    changeTimeMillis: Math.floor(stats.ctimeMs),\n  }\n}\n\n/**\n * Verifies that current local stats still match a previously scanned regular file.\n * @param stats - Current filesystem stats for the candidate file.\n * @param path - Previously scanned local sync path.\n * @param operation - Operation name used in mutation diagnostics.\n * @param options - Platform and ctime comparison overrides for controlled filesystem moves.\n *\n * @throws If the current file is not the scanned regular file.\n *\n * @internal\n */\nexport function assertSameScannedRegularFile(\n  stats: LocalRegularFileStatsLike,\n  path: LocalSyncPath,\n  operation: 'upload' | 'download' | 'delete' | 'sha1 comparison' = 'upload',\n  options: {\n    readonly compareChangeTime?: boolean | undefined\n    readonly platform?: string | undefined\n  } = {},\n): void {\n  const reason = `local file changed before ${operation}`\n  if (!stats.isFile()) {\n    if (operation === 'delete') {\n      throw Object.assign(new Error(`${reason}: not a regular file`), { code: 'EISDIR' })\n    }\n    throw new Error(`${reason}: not a regular file`)\n  }\n  if (stats.size !== path.size) {\n    throw new Error(`${reason}: size changed`)\n  }\n\n  const identity = path.fileIdentity\n  if (identity === undefined) return\n\n  if (\n    !sameLocalIdentity(stats, identity, {\n      compareChangeTime: options.compareChangeTime,\n      platform: options.platform ?? currentPlatform(),\n    })\n  ) {\n    throw new Error(reason)\n  }\n}\n\nfunction sameLocalIdentity(\n  stats: LocalFileStatsLike,\n  identity: LocalFileIdentity,\n  options: {\n    readonly compareChangeTime?: boolean | undefined\n    readonly platform: string | undefined\n  },\n): boolean {\n  const compareChangeTime =\n    options.compareChangeTime ?? shouldComparePosixChangeTime(options.platform)\n  return (\n    (!shouldComparePosixFileIdentity(options.platform) ||\n      (stats.dev === identity.deviceId && stats.ino === identity.inode)) &&\n    stats.size === identity.size &&\n    Math.floor(stats.mtimeMs) === identity.modTimeMillis &&\n    (!compareChangeTime ||\n      identity.changeTimeMillis === undefined ||\n      Math.floor(stats.ctimeMs) === identity.changeTimeMillis)\n  )\n}\n\nfunction shouldComparePosixFileIdentity(platform: string | undefined): boolean {\n  return platform !== 'win32'\n}\n\nfunction shouldComparePosixChangeTime(platform: string | undefined): boolean {\n  return platform !== 'win32'\n}\n\nfunction currentPlatform(): string | undefined {\n  const processLike = (globalThis as { process?: { platform?: string } }).process\n  return processLike?.platform\n}\n"],"mappings":";;;;;;;;;AAsBA,SAAgB,2BAA2B,OAA8C;CACvF,OAAO;EACL,UAAU,MAAM;EAChB,OAAO,MAAM;EACb,MAAM,MAAM;EACZ,eAAe,KAAK,MAAM,MAAM,OAAO;EACvC,kBAAkB,KAAK,MAAM,MAAM,OAAO;CAC5C;AACF;;;;;;;;;;;;AAaA,SAAgB,6BACd,OACA,MACA,YAAkE,UAClE,UAGI,CAAC,GACC;CACN,MAAM,SAAS,6BAA6B;CAC5C,IAAI,CAAC,MAAM,OAAO,GAAG;EACnB,IAAI,cAAc,UAChB,MAAM,OAAO,uBAAO,IAAI,MAAM,GAAG,OAAO,qBAAqB,GAAG,EAAE,MAAM,SAAS,CAAC;EAEpF,MAAM,IAAI,MAAM,GAAG,OAAO,qBAAqB;CACjD;CACA,IAAI,MAAM,SAAS,KAAK,MACtB,MAAM,IAAI,MAAM,GAAG,OAAO,eAAe;CAG3C,MAAM,WAAW,KAAK;CACtB,IAAI,aAAa,KAAA,GAAW;CAE5B,IACE,CAAC,kBAAkB,OAAO,UAAU;EAClC,mBAAmB,QAAQ;EAC3B,UAAU,QAAQ,YAAY,gBAAgB;CAChD,CAAC,GAED,MAAM,IAAI,MAAM,MAAM;AAE1B;AAEA,SAAS,kBACP,OACA,UACA,SAIS;CACT,MAAM,oBACJ,QAAQ,qBAAqB,6BAA6B,QAAQ,QAAQ;CAC5E,QACG,CAAC,+BAA+B,QAAQ,QAAQ,KAC9C,MAAM,QAAQ,SAAS,YAAY,MAAM,QAAQ,SAAS,UAC7D,MAAM,SAAS,SAAS,QACxB,KAAK,MAAM,MAAM,OAAO,MAAM,SAAS,kBACtC,CAAC,qBACA,SAAS,qBAAqB,KAAA,KAC9B,KAAK,MAAM,MAAM,OAAO,MAAM,SAAS;AAE7C;AAEA,SAAS,+BAA+B,UAAuC;CAC7E,OAAO,aAAa;AACtB;AAEA,SAAS,6BAA6B,UAAuC;CAC3E,OAAO,aAAa;AACtB;AAEA,SAAS,kBAAsC;CAE7C,OADqB,WAAmD,SACpD;AACtB"}

package/dist/sync/local-file-identity.d.cts

@@ -0,0 +1,37 @@
+import { LocalFileIdentity, LocalSyncPath } from './types.js';
+interface LocalFileStatsLike {
+    readonly dev: number;
+    readonly ino: number;
+    readonly mtimeMs: number;
+    readonly ctimeMs: number;
+    readonly size: number;
+}
+interface LocalRegularFileStatsLike extends LocalFileStatsLike {
+    isFile(): boolean;
+}
+/**
+ * Converts Node file stats into the sync scanner's persisted identity shape.
+ * @param stats - Node file stats to convert.
+ *
+ * @returns The scanner identity stored with a local sync path.
+ *
+ * @internal
+ */
+export declare function localFileIdentityFromStats(stats: LocalFileStatsLike): LocalFileIdentity;
+/**
+ * Verifies that current local stats still match a previously scanned regular file.
+ * @param stats - Current filesystem stats for the candidate file.
+ * @param path - Previously scanned local sync path.
+ * @param operation - Operation name used in mutation diagnostics.
+ * @param options - Platform and ctime comparison overrides for controlled filesystem moves.
+ *
+ * @throws If the current file is not the scanned regular file.
+ *
+ * @internal
+ */
+export declare function assertSameScannedRegularFile(stats: LocalRegularFileStatsLike, path: LocalSyncPath, operation?: 'upload' | 'download' | 'delete' | 'sha1 comparison', options?: {
+    readonly compareChangeTime?: boolean | undefined;
+    readonly platform?: string | undefined;
+}): void;
+export {};
+//# sourceMappingURL=local-file-identity.d.ts.map

package/dist/sync/local-file-identity.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file-identity.d.ts","sourceRoot":"","sources":["../../src/sync/local-file-identity.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAElE,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,UAAU,yBAA0B,SAAQ,kBAAkB;IAC5D,MAAM,IAAI,OAAO,CAAA;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,kBAAkB,GAAG,iBAAiB,CAQvF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,yBAAyB,EAChC,IAAI,EAAE,aAAa,EACnB,SAAS,GAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,iBAA4B,EAC1E,OAAO,GAAE;IACP,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAClC,GACL,IAAI,CAuBN"}

package/dist/sync/local-file-identity.d.ts

@@ -0,0 +1,37 @@
+import { LocalFileIdentity, LocalSyncPath } from './types.js';
+interface LocalFileStatsLike {
+    readonly dev: number;
+    readonly ino: number;
+    readonly mtimeMs: number;
+    readonly ctimeMs: number;
+    readonly size: number;
+}
+interface LocalRegularFileStatsLike extends LocalFileStatsLike {
+    isFile(): boolean;
+}
+/**
+ * Converts Node file stats into the sync scanner's persisted identity shape.
+ * @param stats - Node file stats to convert.
+ *
+ * @returns The scanner identity stored with a local sync path.
+ *
+ * @internal
+ */
+export declare function localFileIdentityFromStats(stats: LocalFileStatsLike): LocalFileIdentity;
+/**
+ * Verifies that current local stats still match a previously scanned regular file.
+ * @param stats - Current filesystem stats for the candidate file.
+ * @param path - Previously scanned local sync path.
+ * @param operation - Operation name used in mutation diagnostics.
+ * @param options - Platform and ctime comparison overrides for controlled filesystem moves.
+ *
+ * @throws If the current file is not the scanned regular file.
+ *
+ * @internal
+ */
+export declare function assertSameScannedRegularFile(stats: LocalRegularFileStatsLike, path: LocalSyncPath, operation?: 'upload' | 'download' | 'delete' | 'sha1 comparison', options?: {
+    readonly compareChangeTime?: boolean | undefined;
+    readonly platform?: string | undefined;
+}): void;
+export {};
+//# sourceMappingURL=local-file-identity.d.ts.map

package/dist/sync/local-file-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file-identity.d.ts","sourceRoot":"","sources":["../../src/sync/local-file-identity.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAElE,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,UAAU,yBAA0B,SAAQ,kBAAkB;IAC5D,MAAM,IAAI,OAAO,CAAA;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,kBAAkB,GAAG,iBAAiB,CAQvF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,yBAAyB,EAChC,IAAI,EAAE,aAAa,EACnB,SAAS,GAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,iBAA4B,EAC1E,OAAO,GAAE;IACP,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAClC,GACL,IAAI,CAuBN"}

package/dist/sync/local-file-identity.js

@@ -0,0 +1,60 @@
+//#region src/sync/local-file-identity.ts
+/**
+* Converts Node file stats into the sync scanner's persisted identity shape.
+* @param stats - Node file stats to convert.
+*
+* @returns The scanner identity stored with a local sync path.
+*
+* @internal
+*/
+function localFileIdentityFromStats(stats) {
+	return {
+		deviceId: stats.dev,
+		inode: stats.ino,
+		size: stats.size,
+		modTimeMillis: Math.floor(stats.mtimeMs),
+		changeTimeMillis: Math.floor(stats.ctimeMs)
+	};
+}
+/**
+* Verifies that current local stats still match a previously scanned regular file.
+* @param stats - Current filesystem stats for the candidate file.
+* @param path - Previously scanned local sync path.
+* @param operation - Operation name used in mutation diagnostics.
+* @param options - Platform and ctime comparison overrides for controlled filesystem moves.
+*
+* @throws If the current file is not the scanned regular file.
+*
+* @internal
+*/
+function assertSameScannedRegularFile(stats, path, operation = "upload", options = {}) {
+	const reason = `local file changed before ${operation}`;
+	if (!stats.isFile()) {
+		if (operation === "delete") throw Object.assign(/* @__PURE__ */ new Error(`${reason}: not a regular file`), { code: "EISDIR" });
+		throw new Error(`${reason}: not a regular file`);
+	}
+	if (stats.size !== path.size) throw new Error(`${reason}: size changed`);
+	const identity = path.fileIdentity;
+	if (identity === void 0) return;
+	if (!sameLocalIdentity(stats, identity, {
+		compareChangeTime: options.compareChangeTime,
+		platform: options.platform ?? currentPlatform()
+	})) throw new Error(reason);
+}
+function sameLocalIdentity(stats, identity, options) {
+	const compareChangeTime = options.compareChangeTime ?? shouldComparePosixChangeTime(options.platform);
+	return (!shouldComparePosixFileIdentity(options.platform) || stats.dev === identity.deviceId && stats.ino === identity.inode) && stats.size === identity.size && Math.floor(stats.mtimeMs) === identity.modTimeMillis && (!compareChangeTime || identity.changeTimeMillis === void 0 || Math.floor(stats.ctimeMs) === identity.changeTimeMillis);
+}
+function shouldComparePosixFileIdentity(platform) {
+	return platform !== "win32";
+}
+function shouldComparePosixChangeTime(platform) {
+	return platform !== "win32";
+}
+function currentPlatform() {
+	return globalThis.process?.platform;
+}
+//#endregion
+export { assertSameScannedRegularFile, localFileIdentityFromStats };
+
+//# sourceMappingURL=local-file-identity.js.map

package/dist/sync/local-file-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file-identity.js","names":[],"sources":["../../src/sync/local-file-identity.ts"],"sourcesContent":["import type { LocalFileIdentity, LocalSyncPath } from './types.ts'\n\ninterface LocalFileStatsLike {\n  readonly dev: number\n  readonly ino: number\n  readonly mtimeMs: number\n  readonly ctimeMs: number\n  readonly size: number\n}\n\ninterface LocalRegularFileStatsLike extends LocalFileStatsLike {\n  isFile(): boolean\n}\n\n/**\n * Converts Node file stats into the sync scanner's persisted identity shape.\n * @param stats - Node file stats to convert.\n *\n * @returns The scanner identity stored with a local sync path.\n *\n * @internal\n */\nexport function localFileIdentityFromStats(stats: LocalFileStatsLike): LocalFileIdentity {\n  return {\n    deviceId: stats.dev,\n    inode: stats.ino,\n    size: stats.size,\n    modTimeMillis: Math.floor(stats.mtimeMs),\n    changeTimeMillis: Math.floor(stats.ctimeMs),\n  }\n}\n\n/**\n * Verifies that current local stats still match a previously scanned regular file.\n * @param stats - Current filesystem stats for the candidate file.\n * @param path - Previously scanned local sync path.\n * @param operation - Operation name used in mutation diagnostics.\n * @param options - Platform and ctime comparison overrides for controlled filesystem moves.\n *\n * @throws If the current file is not the scanned regular file.\n *\n * @internal\n */\nexport function assertSameScannedRegularFile(\n  stats: LocalRegularFileStatsLike,\n  path: LocalSyncPath,\n  operation: 'upload' | 'download' | 'delete' | 'sha1 comparison' = 'upload',\n  options: {\n    readonly compareChangeTime?: boolean | undefined\n    readonly platform?: string | undefined\n  } = {},\n): void {\n  const reason = `local file changed before ${operation}`\n  if (!stats.isFile()) {\n    if (operation === 'delete') {\n      throw Object.assign(new Error(`${reason}: not a regular file`), { code: 'EISDIR' })\n    }\n    throw new Error(`${reason}: not a regular file`)\n  }\n  if (stats.size !== path.size) {\n    throw new Error(`${reason}: size changed`)\n  }\n\n  const identity = path.fileIdentity\n  if (identity === undefined) return\n\n  if (\n    !sameLocalIdentity(stats, identity, {\n      compareChangeTime: options.compareChangeTime,\n      platform: options.platform ?? currentPlatform(),\n    })\n  ) {\n    throw new Error(reason)\n  }\n}\n\nfunction sameLocalIdentity(\n  stats: LocalFileStatsLike,\n  identity: LocalFileIdentity,\n  options: {\n    readonly compareChangeTime?: boolean | undefined\n    readonly platform: string | undefined\n  },\n): boolean {\n  const compareChangeTime =\n    options.compareChangeTime ?? shouldComparePosixChangeTime(options.platform)\n  return (\n    (!shouldComparePosixFileIdentity(options.platform) ||\n      (stats.dev === identity.deviceId && stats.ino === identity.inode)) &&\n    stats.size === identity.size &&\n    Math.floor(stats.mtimeMs) === identity.modTimeMillis &&\n    (!compareChangeTime ||\n      identity.changeTimeMillis === undefined ||\n      Math.floor(stats.ctimeMs) === identity.changeTimeMillis)\n  )\n}\n\nfunction shouldComparePosixFileIdentity(platform: string | undefined): boolean {\n  return platform !== 'win32'\n}\n\nfunction shouldComparePosixChangeTime(platform: string | undefined): boolean {\n  return platform !== 'win32'\n}\n\nfunction currentPlatform(): string | undefined {\n  const processLike = (globalThis as { process?: { platform?: string } }).process\n  return processLike?.platform\n}\n"],"mappings":";;;;;;;;;AAsBA,SAAgB,2BAA2B,OAA8C;CACvF,OAAO;EACL,UAAU,MAAM;EAChB,OAAO,MAAM;EACb,MAAM,MAAM;EACZ,eAAe,KAAK,MAAM,MAAM,OAAO;EACvC,kBAAkB,KAAK,MAAM,MAAM,OAAO;CAC5C;AACF;;;;;;;;;;;;AAaA,SAAgB,6BACd,OACA,MACA,YAAkE,UAClE,UAGI,CAAC,GACC;CACN,MAAM,SAAS,6BAA6B;CAC5C,IAAI,CAAC,MAAM,OAAO,GAAG;EACnB,IAAI,cAAc,UAChB,MAAM,OAAO,uBAAO,IAAI,MAAM,GAAG,OAAO,qBAAqB,GAAG,EAAE,MAAM,SAAS,CAAC;EAEpF,MAAM,IAAI,MAAM,GAAG,OAAO,qBAAqB;CACjD;CACA,IAAI,MAAM,SAAS,KAAK,MACtB,MAAM,IAAI,MAAM,GAAG,OAAO,eAAe;CAG3C,MAAM,WAAW,KAAK;CACtB,IAAI,aAAa,KAAA,GAAW;CAE5B,IACE,CAAC,kBAAkB,OAAO,UAAU;EAClC,mBAAmB,QAAQ;EAC3B,UAAU,QAAQ,YAAY,gBAAgB;CAChD,CAAC,GAED,MAAM,IAAI,MAAM,MAAM;AAE1B;AAEA,SAAS,kBACP,OACA,UACA,SAIS;CACT,MAAM,oBACJ,QAAQ,qBAAqB,6BAA6B,QAAQ,QAAQ;CAC5E,QACG,CAAC,+BAA+B,QAAQ,QAAQ,KAC9C,MAAM,QAAQ,SAAS,YAAY,MAAM,QAAQ,SAAS,UAC7D,MAAM,SAAS,SAAS,QACxB,KAAK,MAAM,MAAM,OAAO,MAAM,SAAS,kBACtC,CAAC,qBACA,SAAS,qBAAqB,KAAA,KAC9B,KAAK,MAAM,MAAM,OAAO,MAAM,SAAS;AAE7C;AAEA,SAAS,+BAA+B,UAAuC;CAC7E,OAAO,aAAa;AACtB;AAEA,SAAS,6BAA6B,UAAuC;CAC3E,OAAO,aAAa;AACtB;AAEA,SAAS,kBAAsC;CAE7C,OADqB,WAAmD,SACpD;AACtB"}