@harperfast/harper 5.2.13 → 5.3.0-beta.1

package/dist/config/readConfigFileSync.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readConfigFileSync = readConfigFileSync;
+const node_fs_1 = require("node:fs");
+// Why root config reads must not be async, and why this budget is shared rather than per call:
+// see "Root config watchers must read synchronously" in DESIGN.md (harper#2191).
+const READ_RETRY_BUDGET_MS = 500;
+const READ_RETRY_INITIAL_DELAY_MS = 10;
+const READ_RETRY_MAX_DELAY_MS = 100;
+const readRetrySleepBuffer = new Int32Array(new SharedArrayBuffer(4));
+const retryDeadlines = new Map();
+// A caller that already owns a retry ladder passes `waitForLock` false, so one lock costs one
+// blocking window in total rather than one per rung.
+function readConfigFileSync(filePath, waitForLock = true) {
+    let delayMs = READ_RETRY_INITIAL_DELAY_MS;
+    while (true) {
+        try {
+            const contents = (0, node_fs_1.readFileSync)(filePath, 'utf-8');
+            retryDeadlines.delete(filePath);
+            return contents;
+        }
+        catch (error) {
+            const remainingBudgetMs = waitForLock && isSharingViolation(error) ? remainingRetryBudgetMs(filePath) : 0;
+            if (remainingBudgetMs <= 0)
+                throw error;
+            Atomics.wait(readRetrySleepBuffer, 0, 0, Math.min(delayMs, remainingBudgetMs));
+            delayMs = Math.min(delayMs * 2, READ_RETRY_MAX_DELAY_MS);
+        }
+    }
+}
+function isSharingViolation(error) {
+    if (process.platform !== 'win32')
+        return false;
+    const code = error?.code;
+    return code === 'EPERM' || code === 'EACCES' || code === 'EBUSY';
+}
+function remainingRetryBudgetMs(filePath) {
+    const now = performance.now();
+    let deadline = retryDeadlines.get(filePath);
+    // A deadline more than one budget past its expiry belongs to an earlier burst, not this one.
+    if (deadline === undefined || now - deadline > READ_RETRY_BUDGET_MS) {
+        deadline = now + READ_RETRY_BUDGET_MS;
+        retryDeadlines.set(filePath, deadline);
+    }
+    return deadline - now;
+}
+//# sourceMappingURL=readConfigFileSync.js.map

package/dist/config/readConfigFileSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readConfigFileSync.js","sourceRoot":"","sources":["../../config/readConfigFileSync.ts"],"names":[],"mappings":";;AAYA,gDAcC;AA1BD,qCAAuC;AAEvC,+FAA+F;AAC/F,iFAAiF;AACjF,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACjC,MAAM,2BAA2B,GAAG,EAAE,CAAC;AACvC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AACpC,MAAM,oBAAoB,GAAG,IAAI,UAAU,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;AACtE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEjD,8FAA8F;AAC9F,qDAAqD;AACrD,SAAgB,kBAAkB,CAAC,QAAgB,EAAE,cAAuB,IAAI;IAC/E,IAAI,OAAO,GAAG,2BAA2B,CAAC;IAC1C,OAAO,IAAI,EAAE,CAAC;QACb,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,IAAA,sBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjD,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChC,OAAO,QAAQ,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,iBAAiB,GAAG,WAAW,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1G,IAAI,iBAAiB,IAAI,CAAC;gBAAE,MAAM,KAAK,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;YAC/E,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,EAAE,uBAAuB,CAAC,CAAC;QAC1D,CAAC;IACF,CAAC;AACF,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACzC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAC/C,MAAM,IAAI,GAAI,KAAkC,EAAE,IAAI,CAAC;IACvD,OAAO,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO,CAAC;AAClE,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAgB;IAC/C,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAC9B,IAAI,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5C,6FAA6F;IAC7F,IAAI,QAAQ,KAAK,SAAS,IAAI,GAAG,GAAG,QAAQ,GAAG,oBAAoB,EAAE,CAAC;QACrE,QAAQ,GAAG,GAAG,GAAG,oBAAoB,CAAC;QACtC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,QAAQ,GAAG,GAAG,CAAC;AACvB,CAAC"}

package/dist/config/watcherArming.d.ts

@@ -0,0 +1,15 @@
+export declare function armGraceMs(platform?: string): number;
+/**
+ * The gate a config watcher opens when its chokidar watcher is really watching: the initial scan
+ * has finished *and* the platform's kernel-side warm-up has had its grace. Shared by
+ * `RootConfigWatcher` and `OptionsWatcher` because both read the config synchronously, which is
+ * what exposes the unarmed window in the first place.
+ */
+export declare class ArmGate {
+    #private;
+    constructor(graceMs?: number);
+    get armed(): boolean;
+    arm(onArmed: () => void): void;
+    cancel(): void;
+    reset(): void;
+}

package/dist/config/watcherArming.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArmGate = void 0;
+exports.armGraceMs = armGraceMs;
+// See DESIGN.md, "`ready` means the watcher is armed". Platform is a parameter so a test on any
+// host can pin the darwin value, rather than only observing its own.
+function armGraceMs(platform = process.platform) {
+    return platform === 'darwin' ? 20 : 0;
+}
+const ARM_GRACE_MS = armGraceMs();
+/**
+ * The gate a config watcher opens when its chokidar watcher is really watching: the initial scan
+ * has finished *and* the platform's kernel-side warm-up has had its grace. Shared by
+ * `RootConfigWatcher` and `OptionsWatcher` because both read the config synchronously, which is
+ * what exposes the unarmed window in the first place.
+ */
+class ArmGate {
+    #armed = false;
+    #timer;
+    #graceMs;
+    // Taken as an argument, not read from the module constant, so the timer branch below is
+    // reachable from a host whose own platform has no grace — unit tests are ubuntu-only.
+    constructor(graceMs = ARM_GRACE_MS) {
+        this.#graceMs = graceMs;
+    }
+    get armed() {
+        return this.#armed;
+    }
+    // Synchronous where the platform needs no grace, so a watcher with no warm-up to wait out
+    // keeps reading inside chokidar's own dispatch.
+    arm(onArmed) {
+        if (this.#armed || this.#timer)
+            return;
+        if (!this.#graceMs) {
+            this.#armed = true;
+            onArmed();
+            return;
+        }
+        this.#timer = setTimeout(() => {
+            this.#timer = undefined;
+            this.#armed = true;
+            onArmed();
+        }, this.#graceMs);
+    }
+    // Drops a grace still counting down, for a watcher that is closing.
+    cancel() {
+        clearTimeout(this.#timer);
+        this.#timer = undefined;
+    }
+    // A replacement watcher has its own scan and its own unarmed window, so the gate arms again
+    // with it: for a file that is *absent* when the replacement scans, chokidar reports `ready` and
+    // nothing else, and the arming re-read is the only thing that would notice.
+    reset() {
+        this.cancel();
+        this.#armed = false;
+    }
+}
+exports.ArmGate = ArmGate;
+//# sourceMappingURL=watcherArming.js.map

package/dist/config/watcherArming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcherArming.js","sourceRoot":"","sources":["../../config/watcherArming.ts"],"names":[],"mappings":";;;AAEA,gCAEC;AAJD,gGAAgG;AAChG,qEAAqE;AACrE,SAAgB,UAAU,CAAC,WAAmB,OAAO,CAAC,QAAQ;IAC7D,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,YAAY,GAAG,UAAU,EAAE,CAAC;AAElC;;;;;GAKG;AACH,MAAa,OAAO;IACnB,MAAM,GAAY,KAAK,CAAC;IACxB,MAAM,CAA6B;IACnC,QAAQ,CAAS;IAEjB,wFAAwF;IACxF,sFAAsF;IACtF,YAAY,UAAkB,YAAY;QACzC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,0FAA0F;IAC1F,gDAAgD;IAChD,GAAG,CAAC,OAAmB;QACtB,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACvC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,OAAO,EAAE,CAAC;YACV,OAAO;QACR,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE;YAC7B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,OAAO,EAAE,CAAC;QACX,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnB,CAAC;IAED,oEAAoE;IACpE,MAAM;QACL,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,4FAA4F;IAC5F,gGAAgG;IAChG,4EAA4E;IAC5E,KAAK;QACJ,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACrB,CAAC;CACD;AA5CD,0BA4CC"}

package/dist/dataLayer/blobBackup.d.ts

@@ -13,39 +13,68 @@
  * possible (cheap, no extra space on the same filesystem) and copied otherwise (never symlinked, so
  * a snapshot is a standalone set of files that survives independent of the live blob).
  *
- * Consistency is best-effort and point-in-time-ish, matching how the engine treats the transaction
- * log: the walk captures whatever files exist at snapshot time. A blob deleted mid-walk is skipped;
- * a blob being written mid-walk is captured as-is (a hard link shares the inode, so it reflects the
- * writer's final bytes; a cross-filesystem copy captures the bytes present at copy time). Harper
- * does not freeze blob writes for the duration of a backup.
+ * Harper does not freeze blob writes for a backup, and a blob is written in place at its final path,
+ * so the walk can meet one that is still growing. Hard-linking that inode would put bytes in the
+ * snapshot that keep changing after it was taken. Every entry returned by the walk is therefore
+ * classified (`captureBlobFile`): a complete blob is linked, and one that becomes unavailable or is
+ * not yet complete is replaced by a marker rather than dropped. This closes the classify-to-capture
+ * race and keeps that file id reserved; a file reclaimed before its parent directory is read remains
+ * outside the snapshot.
  *
- * Hard-linking is safe against later mutation because Harper blobs are content-addressed and
- * write-once: each write allocates a fresh monotonic file id (a new path), and an update or delete
- * unlinks the old path rather than rewriting it in place — so a snapshot's hard link keeps the exact
- * bytes alive even after the live blob is deleted, and no in-place overwrite can retroactively alter
- * a snapshot.
+ * Past that gate, hard-linking is safe against later mutation: each write takes a fresh monotonic
+ * file id, and an update, delete, or in-place repair replaces or unlinks the path rather than
+ * rewriting the inode.
  */
 /** Directory holding all blob snapshots for a backup repository. */
 export declare function blobsRootDir(backupDir: string): string;
 /** Directory holding a single backup id's blob snapshot. */
 export declare function blobSnapshotDir(backupDir: string, backupId: number): string;
+/** What a substituted marker says happened, so a branch clone doesn't report itself as a backup. */
+export interface CaptureMarkerReasons {
+    gone: string;
+    pending: string;
+}
 /**
- * Snapshot a database's blob roots into a backup's blob directory. Writes to a temporary sibling
- * and atomically renames into place so a create_backup that fails mid-copy never leaves a partial
- * `blobs/<backupId>/` that a later restore would trust. Overwrites any pre-existing snapshot for the
- * same id (create_backup always produces a fresh id, so this only matters on a retried offline run).
+ * Recursively copy every file under `srcRoot` into `destRoot` (hard-link-else-copy), preserving the
+ * relative directory structure. Missing `srcRoot` is a no-op (a database with no blobs yet).
+ *
+ * `classify` substitutes a marker for a file that is mid-write or already gone, so the destination
+ * fails loudly on that blob rather than carrying a truncated one. It belongs to the capture direction
+ * only; restore must replace exactly what the snapshot holds.
+ *
+ * Also used by branch materialization (harper#644), which clones a base's blob roots into the
+ * branch's own so the OS inode refcount does the reference counting. Its walk runs inside a window
+ * other threads wait on, which is what `onProgress` is for.
+ */
+export declare function copyTree(srcRoot: string, destRoot: string, classify?: boolean, reasons?: CaptureMarkerReasons, onProgress?: () => void): Promise<{
+    substituted: number;
+    captured: number;
+    copied: number;
+}>;
+/**
+ * Copy every blob root into `destDir` as `<rootIndex>/<relpath>`, hard-linking where possible.
+ * Writes to a temporary sibling and atomically renames into place so a run that fails mid-copy never
+ * leaves a partial directory a later restore would trust, and replaces any pre-existing `destDir`.
+ * Shared by managed-backup snapshots and `copy-db`'s standalone blob copy (harper#2048).
+ */
+export declare function copyBlobRootsByIndex(destDir: string, blobRoots: string[]): Promise<void>;
+/**
+ * Snapshot a database's blob roots into a backup's blob directory. Overwrites any pre-existing
+ * snapshot for the same id (create_backup always produces a fresh id, so this only matters on a
+ * retried offline run).
  */
 export declare function snapshotBlobs(backupDir: string, backupId: number, blobRoots: string[]): Promise<void>;
 /**
  * Build the `blobs/README.md` documenting the blob snapshot layout, so an operator inspecting or
- * hand-recovering a backup can decode the numeric directories. Two variants:
- * - managed (default): a create_backup repository, where snapshots are keyed by backup id
+ * hand-recovering a backup can decode the numeric directories. Three variants:
+ * - `managed` (default): a create_backup repository, where snapshots are keyed by backup id
  *   (`<backupId>/<rootIndex>/…`) and restore is automatic via `restore_backup`.
- * - archive (`archive: true`): a downloaded `get_backup` tar, which holds a single snapshot with no
- *   backup-id level (`<rootIndex>/…`) and is restored by extracting the files back into the roots.
+ * - `archive`: a downloaded `get_backup` tar, which holds a single snapshot with no backup-id level
+ *   (`<rootIndex>/…`) and is restored by extracting the files back into the roots.
+ * - `copy`: the companion directory `copy-db` writes beside a database copy, restored by hand.
  */
-export declare function blobsReadmeContent(blobRoots: string[], { archive }?: {
-    archive?: boolean;
+export declare function blobsReadmeContent(blobRoots: string[], { variant }?: {
+    variant?: 'managed' | 'archive' | 'copy';
 }): string;
 /**
  * Write the `blobs/README.md` into a managed backup's `blobs/` directory. Best-effort: a failure to

package/dist/dataLayer/blobBackup.js

@@ -5,6 +5,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.blobsRootDir = blobsRootDir;
 exports.blobSnapshotDir = blobSnapshotDir;
+exports.copyTree = copyTree;
+exports.copyBlobRootsByIndex = copyBlobRootsByIndex;
 exports.snapshotBlobs = snapshotBlobs;
 exports.blobsReadmeContent = blobsReadmeContent;
 exports.writeBlobsReadme = writeBlobsReadme;
@@ -17,6 +19,7 @@ const promises_1 = require("node:fs/promises");
 const node_path_1 = require("node:path");
 const hdbError_ts_1 = require("../utility/errors/hdbError.js");
 const harper_logger_ts_1 = __importDefault(require("../utility/logging/harper_logger.js"));
+const blob_ts_1 = require("../resources/blob.js");
 /**
  * Managed-backup snapshotting of a database's file-backed blobs.
  *
@@ -32,17 +35,17 @@ const harper_logger_ts_1 = __importDefault(require("../utility/logging/harper_lo
  * possible (cheap, no extra space on the same filesystem) and copied otherwise (never symlinked, so
  * a snapshot is a standalone set of files that survives independent of the live blob).
  *
- * Consistency is best-effort and point-in-time-ish, matching how the engine treats the transaction
- * log: the walk captures whatever files exist at snapshot time. A blob deleted mid-walk is skipped;
- * a blob being written mid-walk is captured as-is (a hard link shares the inode, so it reflects the
- * writer's final bytes; a cross-filesystem copy captures the bytes present at copy time). Harper
- * does not freeze blob writes for the duration of a backup.
+ * Harper does not freeze blob writes for a backup, and a blob is written in place at its final path,
+ * so the walk can meet one that is still growing. Hard-linking that inode would put bytes in the
+ * snapshot that keep changing after it was taken. Every entry returned by the walk is therefore
+ * classified (`captureBlobFile`): a complete blob is linked, and one that becomes unavailable or is
+ * not yet complete is replaced by a marker rather than dropped. This closes the classify-to-capture
+ * race and keeps that file id reserved; a file reclaimed before its parent directory is read remains
+ * outside the snapshot.
  *
- * Hard-linking is safe against later mutation because Harper blobs are content-addressed and
- * write-once: each write allocates a fresh monotonic file id (a new path), and an update or delete
- * unlinks the old path rather than rewriting it in place — so a snapshot's hard link keeps the exact
- * bytes alive even after the live blob is deleted, and no in-place overwrite can retroactively alter
- * a snapshot.
+ * Past that gate, hard-linking is safe against later mutation: each write takes a fresh monotonic
+ * file id, and an update, delete, or in-place repair replaces or unlinks the path rather than
+ * rewriting the inode.
  */
 /** Directory holding all blob snapshots for a backup repository. */
 function blobsRootDir(backupDir) {
@@ -54,19 +57,19 @@ function blobSnapshotDir(backupDir, backupId) {
 }
 /**
  * Hard-link `src` to `dest`, falling back to a copy when the two are on different filesystems (or
- * the filesystem does not support additional hard links). Never creates a symlink. A source that
- * vanished mid-walk (a concurrent blob delete) is skipped rather than failing the whole snapshot.
+ * the filesystem does not support additional hard links). Never creates a symlink. Returns false
+ * when the source vanishes so the caller can substitute a marker for it. `counts.copied` is what a
+ * caller on a latency budget needs: the fallback turns a constant-time clone into an O(bytes) one.
  */
-async function linkOrCopy(src, dest) {
+async function linkOrCopy(src, dest, counts) {
     await (0, promises_1.mkdir)((0, node_path_1.dirname)(dest), { recursive: true });
     try {
         await (0, promises_1.link)(src, dest);
     }
     catch (error) {
         if (error.code === 'ENOENT') {
-            // src disappeared (concurrent delete) — nothing to snapshot
             if (!(0, node_fs_1.existsSync)(src))
-                return;
+                return false; // vanished since it was classified
             throw error;
         }
         if (error.code === 'EXDEV' || // cross-device link
@@ -74,24 +77,74 @@ async function linkOrCopy(src, dest) {
             error.code === 'EPERM' || // filesystem forbids hard links
             error.code === 'ENOTSUP' ||
             error.code === 'EOPNOTSUPP') {
-            await (0, promises_1.copyFile)(src, dest);
-            return;
+            try {
+                await (0, promises_1.copyFile)(src, dest);
+            }
+            catch (copyError) {
+                if (copyError.code === 'ENOENT')
+                    return false;
+                throw copyError;
+            }
+            if (counts)
+                counts.copied++;
+            return true;
         }
         if (error.code === 'EEXIST') {
             await (0, promises_1.unlink)(dest);
-            await linkOrCopy(src, dest);
-            return;
+            return linkOrCopy(src, dest, counts);
         }
         throw error;
     }
+    return true;
+}
+const BACKUP_MARKER_REASONS = {
+    gone: 'blob was deleted while this backup was being taken',
+    pending: 'blob was not yet complete when this backup was taken',
+};
+/** Put one blob file into the destination, returning how the entry was captured. */
+async function captureBlobFile(srcPath, destPath, reasons = BACKUP_MARKER_REASONS, counts) {
+    let disposition;
+    try {
+        disposition = await (0, blob_ts_1.classifyBlobFileForCapture)(srcPath);
+    }
+    catch (error) {
+        // This rethrow is unverified: only the membership of SYSTEMIC_IO_ERRORS is tested, because
+        // reaching it needs a real host-level fault no test here can produce.
+        if ((0, blob_ts_1.isSystemicIoError)(error))
+            throw error;
+        // Fall back to what this walk did before it classified anything. `link()` needs no read permission
+        // on the source, so a blob this failed to *read* may still be perfectly capturable; substituting
+        // here would turn an unreadable-but-valid root into a backup of nothing but stubs.
+        harper_logger_ts_1.default.warn(`Could not verify blob ${srcPath} for snapshot; capturing it unverified`, error);
+        disposition = 'capture';
+    }
+    if (disposition === 'skip')
+        return disposition;
+    if (disposition === 'capture') {
+        if (await linkOrCopy(srcPath, destPath, counts))
+            return disposition;
+        disposition = 'gone';
+    }
+    await (0, promises_1.mkdir)((0, node_path_1.dirname)(destPath), { recursive: true });
+    await (0, promises_1.writeFile)(destPath, (0, blob_ts_1.createCaptureMarker)(disposition, disposition === 'gone' ? reasons.gone : reasons.pending));
+    return disposition;
 }
 /**
  * Recursively copy every file under `srcRoot` into `destRoot` (hard-link-else-copy), preserving the
  * relative directory structure. Missing `srcRoot` is a no-op (a database with no blobs yet).
+ *
+ * `classify` substitutes a marker for a file that is mid-write or already gone, so the destination
+ * fails loudly on that blob rather than carrying a truncated one. It belongs to the capture direction
+ * only; restore must replace exactly what the snapshot holds.
+ *
+ * Also used by branch materialization (harper#644), which clones a base's blob roots into the
+ * branch's own so the OS inode refcount does the reference counting. Its walk runs inside a window
+ * other threads wait on, which is what `onProgress` is for.
  */
-async function copyTree(srcRoot, destRoot) {
+async function copyTree(srcRoot, destRoot, classify = false, reasons, onProgress) {
+    const counts = { substituted: 0, captured: 0, copied: 0 };
     if (!(0, node_fs_1.existsSync)(srcRoot))
-        return;
+        return counts;
     const stack = [srcRoot];
     while (stack.length > 0) {
         const dir = stack.pop();
@@ -110,61 +163,95 @@ async function copyTree(srcRoot, destRoot) {
                 stack.push(srcPath);
             }
             else if (entry.isFile()) {
-                await linkOrCopy(srcPath, (0, node_path_1.join)(destRoot, (0, node_path_1.relative)(srcRoot, srcPath)));
+                const destPath = (0, node_path_1.join)(destRoot, (0, node_path_1.relative)(srcRoot, srcPath));
+                if (classify) {
+                    const disposition = await captureBlobFile(srcPath, destPath, reasons, counts);
+                    if (disposition === 'pending' || disposition === 'gone')
+                        counts.substituted++;
+                    else if (disposition === 'capture')
+                        counts.captured++;
+                }
+                else {
+                    await linkOrCopy(srcPath, destPath, counts);
+                }
+                onProgress?.();
             }
             // symlinks/other node types in a blob root are not expected and are intentionally skipped
         }
     }
+    return counts;
 }
 /**
- * Snapshot a database's blob roots into a backup's blob directory. Writes to a temporary sibling
- * and atomically renames into place so a create_backup that fails mid-copy never leaves a partial
- * `blobs/<backupId>/` that a later restore would trust. Overwrites any pre-existing snapshot for the
- * same id (create_backup always produces a fresh id, so this only matters on a retried offline run).
+ * Copy every blob root into `destDir` as `<rootIndex>/<relpath>`, hard-linking where possible.
+ * Writes to a temporary sibling and atomically renames into place so a run that fails mid-copy never
+ * leaves a partial directory a later restore would trust, and replaces any pre-existing `destDir`.
+ * Shared by managed-backup snapshots and `copy-db`'s standalone blob copy (harper#2048).
  */
-async function snapshotBlobs(backupDir, backupId, blobRoots) {
-    const finalDir = blobSnapshotDir(backupDir, backupId);
-    const tempDir = (0, node_path_1.join)(blobsRootDir(backupDir), `.tmp-${backupId}`);
+async function copyBlobRootsByIndex(destDir, blobRoots) {
+    const tempDir = destDir + '.tmp';
     await (0, promises_1.rm)(tempDir, { recursive: true, force: true });
     await (0, promises_1.mkdir)(tempDir, { recursive: true });
     try {
+        let substituted = 0;
+        let captured = 0;
         for (let index = 0; index < blobRoots.length; index++) {
-            await copyTree(blobRoots[index], (0, node_path_1.join)(tempDir, String(index)));
+            const counts = await copyTree(blobRoots[index], (0, node_path_1.join)(tempDir, String(index)), true);
+            substituted += counts.substituted;
+            captured += counts.captured;
+        }
+        if (substituted > 0) {
+            harper_logger_ts_1.default.warn(`Blob copy into ${destDir} substituted ${substituted} of ${substituted + captured} blob ` +
+                `file(s) with PENDING or ERROR markers because they were not capturable whole.`);
         }
-        await (0, promises_1.rm)(finalDir, { recursive: true, force: true });
-        await (0, promises_1.rename)(tempDir, finalDir);
+        await (0, promises_1.rm)(destDir, { recursive: true, force: true });
+        await (0, promises_1.rename)(tempDir, destDir);
     }
     catch (error) {
         await (0, promises_1.rm)(tempDir, { recursive: true, force: true }).catch(() => { });
         throw error;
     }
+}
+/**
+ * Snapshot a database's blob roots into a backup's blob directory. Overwrites any pre-existing
+ * snapshot for the same id (create_backup always produces a fresh id, so this only matters on a
+ * retried offline run).
+ */
+async function snapshotBlobs(backupDir, backupId, blobRoots) {
+    await copyBlobRootsByIndex(blobSnapshotDir(backupDir, backupId), blobRoots);
     await writeBlobsReadme(backupDir, blobRoots);
 }
 /**
  * Build the `blobs/README.md` documenting the blob snapshot layout, so an operator inspecting or
- * hand-recovering a backup can decode the numeric directories. Two variants:
- * - managed (default): a create_backup repository, where snapshots are keyed by backup id
+ * hand-recovering a backup can decode the numeric directories. Three variants:
+ * - `managed` (default): a create_backup repository, where snapshots are keyed by backup id
  *   (`<backupId>/<rootIndex>/…`) and restore is automatic via `restore_backup`.
- * - archive (`archive: true`): a downloaded `get_backup` tar, which holds a single snapshot with no
- *   backup-id level (`<rootIndex>/…`) and is restored by extracting the files back into the roots.
+ * - `archive`: a downloaded `get_backup` tar, which holds a single snapshot with no backup-id level
+ *   (`<rootIndex>/…`) and is restored by extracting the files back into the roots.
+ * - `copy`: the companion directory `copy-db` writes beside a database copy, restored by hand.
  */
-function blobsReadmeContent(blobRoots, { archive = false } = {}) {
+function blobsReadmeContent(blobRoots, { variant = 'managed' } = {}) {
     const rootMapping = blobRoots.length > 0 ? blobRoots.map((root, index) => `      ${index} -> ${root}`).join('\n') : '      (none)';
-    const layout = archive
-        ? '<rootIndex>/<shard1>/<shard2>/<fileId>'
-        : '<backupId>/<rootIndex>/<shard1>/<shard2>/<fileId>';
-    const intro = archive
-        ? `This directory holds this database's file-backed blobs within a downloaded \`get_backup\` archive.
+    const layout = variant === 'managed'
+        ? '<backupId>/<rootIndex>/<shard1>/<shard2>/<fileId>'
+        : '<rootIndex>/<shard1>/<shard2>/<fileId>';
+    const intro = variant === 'copy'
+        ? `This directory holds the file-backed blobs of a \`copy-db\` database copy; the database file itself
+is the sibling \`.mdb\` this directory is named after. Blobs are addressed by database NAME and the
+configured blob roots — never by the database file's path — so a copy is only restorable with these
+files: put each \`<rootIndex>/\` tree into the matching blob root of whatever database name you
+restore the copy as (mapping below).`
+        : variant === 'archive'
+            ? `This directory holds this database's file-backed blobs within a downloaded \`get_backup\` archive.
 To restore them, extract each \`<rootIndex>/\` tree back into the matching blob root (see the mapping
 below and ../README.md).`
-        : `This directory holds point-in-time snapshots of this database's file-backed blobs, captured
+            : `This directory holds point-in-time snapshots of this database's file-backed blobs, captured
 alongside each RocksDB managed backup. You do not restore these by hand — \`restore_backup\` puts
 them back automatically (see ../README.md); this file just documents the layout.`;
-    const backupIdBullet = archive
-        ? ''
-        : `- **<backupId>** matches the RocksDB backup id (\`harper list_backups\`). Each id is a full,
+    const backupIdBullet = variant === 'managed'
+        ? `- **<backupId>** matches the RocksDB backup id (\`harper list_backups\`). Each id is a full,
   independent snapshot (not incremental).
-`;
+`
+        : '';
     return `# Harper blob snapshots
 
 ${intro}
@@ -175,7 +262,7 @@ ${intro}
 
 ${backupIdBullet}- **<rootIndex>** is which of the database's blob roots the file came from — the index into
   \`storage.blobPaths[n]\`. When \`storage.blobPaths\` is not configured there is a single default root
-  (\`<rootPath>/blobs/<db>\`) at index 0. Current mapping for this backup:
+  (\`<rootPath>/blobs/<db>\`) at index 0. Current mapping:
 
 ${rootMapping}
 
@@ -184,8 +271,10 @@ ${rootMapping}
   4096 entries per directory). E.g. a blob with id \`0x12345678\` lives at \`12/345/678\`; a short id
   like \`0xc1a\` lives at \`0/0/c1a\`.
 
-Files are hard links to the live blobs when the backup is on the same filesystem, and copies
-otherwise.
+Complete blobs are hard links to the live blobs when the destination is on the same filesystem, and
+copies otherwise. A blob that was not capturable whole is stored as a marker instead: header type
+\`0xfe\` is retryable (PENDING), while \`0xff\` is terminal (ERROR). The marker preserves the file id
+but does not contain the original blob bytes.
 `;
 }
 /**

package/dist/dataLayer/blobBackup.js.map

@@ -1 +1 @@
-{"version":3,"file":"blobBackup.js","sourceRoot":"","sources":["../../dataLayer/blobBackup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"blobBackup.js","sourceRoot":"","sources":["../../dataLayer/blobBackup.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;;;AA2Cb,oCAEC;AAGD,0CAEC;AA+FD,4BAsCC;AAQD,oDAwBC;AAOD,sCAGC;AAWD,gDAsDC;AAMD,4CAMC;AAoBD,oEAaC;AAaD,kDAwBC;AAMD,gDAEC;AAOD,gDAQC;AAzYD,qCAAqC;AACrC,+CAAiG;AACjG,yCAAoD;AACpD,+DAA4D;AAC5D,2FAAyD;AACzD,kDAK8B;AAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,oEAAoE;AACpE,SAAgB,YAAY,CAAC,SAAiB;IAC7C,OAAO,IAAA,gBAAI,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,4DAA4D;AAC5D,SAAgB,eAAe,CAAC,SAAiB,EAAE,QAAgB;IAClE,OAAO,IAAA,gBAAI,EAAC,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,IAAY,EAAE,MAA2B;IAC/E,MAAM,IAAA,gBAAK,EAAC,IAAA,mBAAO,EAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC;QACJ,MAAM,IAAA,eAAI,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACrB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAA,oBAAU,EAAC,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC,CAAC,mCAAmC;YACvE,MAAM,KAAK,CAAC;QACb,CAAC;QACD,IACC,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,oBAAoB;YAC9C,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,uBAAuB;YAClD,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,gCAAgC;YAC1D,KAAK,CAAC,IAAI,KAAK,SAAS;YACxB,KAAK,CAAC,IAAI,KAAK,YAAY,EAC1B,CAAC;YACF,IAAI,CAAC;gBACJ,MAAM,IAAA,mBAAQ,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC3B,CAAC;YAAC,OAAO,SAAc,EAAE,CAAC;gBACzB,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ;oBAAE,OAAO,KAAK,CAAC;gBAC9C,MAAM,SAAS,CAAC;YACjB,CAAC;YACD,IAAI,MAAM;gBAAE,MAAM,CAAC,MAAM,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC;QACb,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAA,iBAAM,EAAC,IAAI,CAAC,CAAC;YACnB,OAAO,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,KAAK,CAAC;IACb,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAQD,MAAM,qBAAqB,GAAyB;IACnD,IAAI,EAAE,oDAAoD;IAC1D,OAAO,EAAE,sDAAsD;CAC/D,CAAC;AAEF,oFAAoF;AACpF,KAAK,UAAU,eAAe,CAC7B,OAAe,EACf,QAAgB,EAChB,UAAgC,qBAAqB,EACrD,MAA2B;IAE3B,IAAI,WAAmC,CAAC;IACxC,IAAI,CAAC;QACJ,WAAW,GAAG,MAAM,IAAA,oCAA0B,EAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,2FAA2F;QAC3F,sEAAsE;QACtE,IAAI,IAAA,2BAAiB,EAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAC;QAC1C,mGAAmG;QACnG,iGAAiG;QACjG,mFAAmF;QACnF,0BAAM,CAAC,IAAI,CAAC,yBAAyB,OAAO,wCAAwC,EAAE,KAAK,CAAC,CAAC;QAC7F,WAAW,GAAG,SAAS,CAAC;IACzB,CAAC;IACD,IAAI,WAAW,KAAK,MAAM;QAAE,OAAO,WAAW,CAAC;IAC/C,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,MAAM,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC;YAAE,OAAO,WAAW,CAAC;QACpE,WAAW,GAAG,MAAM,CAAC;IACtB,CAAC;IACD,MAAM,IAAA,gBAAK,EAAC,IAAA,mBAAO,EAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,IAAA,oBAAS,EAAC,QAAQ,EAAE,IAAA,6BAAmB,EAAC,WAAW,EAAE,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACrH,OAAO,WAAW,CAAC;AACpB,CAAC;AAED;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,QAAQ,CAC7B,OAAe,EACf,QAAgB,EAChB,QAAQ,GAAG,KAAK,EAChB,OAA8B,EAC9B,UAAuB;IAEvB,MAAM,MAAM,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAC1D,IAAI,CAAC,IAAA,oBAAU,EAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IACxC,MAAM,KAAK,GAAa,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAY,CAAC;QAClC,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACJ,OAAO,GAAG,MAAM,IAAA,kBAAO,EAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACrB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAS,CAAC,6BAA6B;YACpE,MAAM,KAAK,CAAC;QACb,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC3B,MAAM,QAAQ,GAAG,IAAA,gBAAI,EAAC,QAAQ,EAAE,IAAA,oBAAQ,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC5D,IAAI,QAAQ,EAAE,CAAC;oBACd,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;oBAC9E,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,MAAM;wBAAE,MAAM,CAAC,WAAW,EAAE,CAAC;yBACzE,IAAI,WAAW,KAAK,SAAS;wBAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACvD,CAAC;qBAAM,CAAC;oBACP,MAAM,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAC7C,CAAC;gBACD,UAAU,EAAE,EAAE,CAAC;YAChB,CAAC;YACD,0FAA0F;QAC3F,CAAC;IACF,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,oBAAoB,CAAC,OAAe,EAAE,SAAmB;IAC9E,MAAM,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IACjC,MAAM,IAAA,aAAE,EAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,IAAA,gBAAK,EAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC;QACJ,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YACvD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,IAAA,gBAAI,EAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YACpF,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC;YAClC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC;QAC7B,CAAC;QACD,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACrB,0BAAM,CAAC,IAAI,CACV,kBAAkB,OAAO,gBAAgB,WAAW,OAAO,WAAW,GAAG,QAAQ,QAAQ;gBACxF,+EAA+E,CAChF,CAAC;QACH,CAAC;QACD,MAAM,IAAA,aAAE,EAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,IAAA,iBAAM,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAA,aAAE,EAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACpE,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,aAAa,CAAC,SAAiB,EAAE,QAAgB,EAAE,SAAmB;IAC3F,MAAM,oBAAoB,CAAC,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC;IAC5E,MAAM,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,kBAAkB,CACjC,SAAmB,EACnB,EAAE,OAAO,GAAG,SAAS,KAAmD,EAAE;IAE1E,MAAM,WAAW,GAChB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,SAAS,KAAK,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;IAChH,MAAM,MAAM,GACX,OAAO,KAAK,SAAS;QACpB,CAAC,CAAC,mDAAmD;QACrD,CAAC,CAAC,wCAAwC,CAAC;IAC7C,MAAM,KAAK,GACV,OAAO,KAAK,MAAM;QACjB,CAAC,CAAC;;;;qCAIgC;QAClC,CAAC,CAAC,OAAO,KAAK,SAAS;YACtB,CAAC,CAAC;;yBAEmB;YACrB,CAAC,CAAC;;iFAE2E,CAAC;IACjF,MAAM,cAAc,GACnB,OAAO,KAAK,SAAS;QACpB,CAAC,CAAC;;CAEJ;QACE,CAAC,CAAC,EAAE,CAAC;IACP,OAAO;;EAEN,KAAK;;;;MAID,MAAM;;EAEV,cAAc;;;;EAId,WAAW;;;;;;;;;;;CAWZ,CAAC;AACF,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,gBAAgB,CAAC,SAAiB,EAAE,SAAmB;IAC5E,IAAI,CAAC;QACJ,MAAM,IAAA,oBAAS,EAAC,IAAA,gBAAI,EAAC,YAAY,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5F,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,0BAAM,CAAC,IAAI,CAAC,2CAA2C,SAAS,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IAClG,CAAC;AACF,CAAC;AAED,qGAAqG;AACrG,KAAK,UAAU,mBAAmB,CAAC,WAAmB;IACrD,IAAI,CAAC,IAAA,oBAAU,EAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,OAAO,CAAC,MAAM,IAAA,kBAAO,EAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;SAC1D,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SAClE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SAClC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,4BAA4B,CACjD,SAAiB,EACjB,QAAgB,EAChB,SAAmB;IAEnB,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChF,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,IAAI,QAAQ,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,IAAI,yBAAW,CACpB,yBAAyB,QAAQ,iBAAiB,QAAQ,GAAG,CAAC,yDAAyD,SAAS,CAAC,MAAM,IAAI;YAC1I,wHAAwH,QAAQ,GAAG,CAAC,4BAA4B,CACjK,CAAC;IACH,CAAC;AACF,CAAC;AAED;;;;;;;;;;GAUG;AACI,KAAK,UAAU,mBAAmB,CACxC,SAAiB,EACjB,QAAgB,EAChB,YAAoB,EACpB,SAAmB;IAEnB,MAAM,WAAW,GAAG,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzD,IAAI,CAAC,IAAA,oBAAU,EAAC,WAAW,CAAC,EAAE,CAAC;QAC9B,0BAAM,CAAC,IAAI,CACV,UAAU,QAAQ,iBAAiB,YAAY,kGAAkG,CACjJ,CAAC;QACF,OAAO;IACR,CAAC;IACD,gGAAgG;IAChG,kEAAkE;IAClE,MAAM,4BAA4B,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACzD,4FAA4F;IAC5F,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAA,aAAE,EAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC/B,MAAM,QAAQ,CAAC,IAAA,gBAAI,EAAC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACpE,CAAC;AACF,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,kBAAkB,CAAC,SAAiB,EAAE,QAAgB;IAC3E,MAAM,IAAA,aAAE,EAAC,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAClF,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,kBAAkB,CAAC,SAAiB,EAAE,OAAoB;IAC/E,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IACrC,IAAI,CAAC,IAAA,oBAAU,EAAC,IAAI,CAAC;QAAE,OAAO;IAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,IAAA,kBAAO,EAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QAChE,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAAE,SAAS;QAC9C,MAAM,IAAA,aAAE,EAAC,IAAA,gBAAI,EAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;AACF,CAAC"}

package/dist/dataLayer/delete.js

@@ -108,7 +108,7 @@ async function deleteAuditLogsBefore(deleteObj) {
     await pGlobalSchema(deleteObj.schema, deleteObj.table);
     harper_logger_ts_1.default.info(`Finished deleting audit logs before ${deleteObj.timestamp}`);
     // `deleteTransactionLogsBefore` returns `entries_deleted`; the legacy result exposes it as `transactions_deleted`.
-    return new DeleteAuditLogsBeforeResults_js_1.default(results.start_timestamp, results.end_timestamp, results.entries_deleted);
+    return new DeleteAuditLogsBeforeResults_js_1.default(results.start_timestamp, results.end_timestamp, results.entries_deleted, results.log_files_deleted);
 }
 /**
  * Calls the harper bridge to delete records.

package/dist/dataLayer/delete.js.map

@@ -1 +1 @@
-{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../dataLayer/delete.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../dataLayer/delete.ts"],"names":[],"mappings":"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"}

package/dist/dataLayer/harperBridge/ResourceBridge.d.ts

@@ -42,7 +42,20 @@ export declare class ResourceBridge extends BridgeMethods {
         new_attributes: any;
         skipped_hashes: any[];
     }>;
-    upsertRecords(upsertObj: any): Promise<{
+    /**
+     * Create-or-replace: the stored record becomes exactly the submitted one, so an attribute the
+     * request omits is REMOVED rather than kept. `update`/`upsert` merge (`Table.patch`), which is the
+     * v4-compatible behaviour every existing client depends on and is why this is a separate operation
+     * rather than a flag on those. Equivalent to REST `PUT /Table/id` — same `Table.put`, so the same
+     * audit type, replication shape, and retained `__createdtime__`.
+     */
+    putRecords(putObj: any): Promise<{
+        txn_time: any;
+        written_hashes: any[];
+        new_attributes: any;
+        skipped_hashes: any[];
+    }>;
+    upsertRecords(upsertObj: any, fullRecord?: boolean): Promise<{
         txn_time: any;
         written_hashes: any[];
         new_attributes: any;