@indigoai-us/hq-cloud 5.35.0 → 5.37.0

package/dist/s3.js

@@ -150,6 +150,60 @@ export const SYMLINK_BODY_PREFIX = "hq-symlink:";
  * leaves the umask default in place, matching pre-fix behavior.
  */
 export const FILE_MODE_META_KEY = "hq-mode";
+/**
+ * S3 user-metadata key carrying the source-side file modification time
+ * (mtimeMs) as an integer-millisecond epoch string ("1700000000000"). On
+ * download, downloadFile parses this with a strict-numeric regex BEFORE
+ * parseInt, then applies it via `fs.utimesSync(localPath, mtimeDate,
+ * mtimeDate)` after the byte write.
+ *
+ * 5.37.0 symmetric to the 5.34.0 Bug #5 mode preservation: a file's
+ * modification time should follow it across machines instead of resetting
+ * to "the time of sync." Without this metadata, every receiver's mtime is
+ * wall-clock-now at write-time — making "newer than" comparisons,
+ * mtime-keyed caches, and reproducible builds break across sync.
+ *
+ * Symlinks: skipped at upload time (symlink mtime is OS-controlled and
+ * `lstat` on a symlink already returns the symlink's own times — but we
+ * don't stamp them because the symlink record wire body is `hq-symlink:`
+ * + target string, not real file content, so its mtime isn't user-
+ * meaningful) and skipped on download (`fs.utimesSync` follows symlinks
+ * and would mutate the target's mtime instead; `lutimesSync` is not in
+ * stable Node).
+ *
+ * Composition with 5.36.0 lstat fast-path: the journal stamp is captured
+ * AFTER utimesSync runs (the share/sync call sites lstat AFTER
+ * downloadFile returns), so the journal's mtimeMs matches the post-utimes
+ * lstat. The next sync's fast-path correctly skips re-hashing.
+ *
+ * Clock skew: a peer with a wrong clock pushes file with mtimeMs=<wrong>;
+ * receivers apply <wrong>. This is the same trade git's "file from the
+ * future" warning makes — silent in our case, deliberately. Clock skew
+ * is the user's problem, not the sync engine's.
+ *
+ * Back-compat: legacy uploads (pre-5.37.0) have no `hq-mtime` header —
+ * the receiver leaves the on-disk mtime at write-time, matching pre-
+ * 5.37.0 behavior. Forward-compat: pre-5.37.0 pullers ignore `hq-mtime`
+ * and keep their current "mtime = write-time" behavior. Both work; only
+ * the receiver upgrade unlocks the feature.
+ */
+export const FILE_MTIME_META_KEY = "hq-mtime";
+/**
+ * S3 user-metadata key carrying the source-side file birthtime (birthtimeMs)
+ * as an integer-millisecond epoch string. Stamped on upload ONLY when
+ * `birthtimeMs > 0 && birthtimeMs !== mtimeMs` — many filesystems (Linux
+ * ext4 historically, tmpfs, some FUSE mounts) return 0 (unsupported) or
+ * the same value as mtime (no separate creation time tracking). The
+ * filter keeps the metadata header free of noise on those platforms.
+ *
+ * Pull: NO-OP for now. Node has no API to set birthtime on POSIX as of
+ * v24 (no `lbirthtime`, no `birthtimeSync`). The push side stamps it
+ * anyway so a future receiver upgrade — once Node lands the API — can
+ * apply it without a server-side data migration.
+ *
+ * Symlinks: skipped on both sides for the same reasons as `hq-mtime`.
+ */
+export const FILE_BTIME_META_KEY = "hq-btime";
 /**
  * Encode/decode the symlink wire body. Kept as exported helpers so the
  * format is centrally defined and tests can probe both sides without
@@ -165,15 +219,60 @@ export async function uploadFile(ctx, localPath, key, author) {
     // FILE_MODE_META_KEY doc. Best-effort: lstat failure (raced rm, EPERM)
     // falls through to "no mode header" and the receiver keeps its umask
     // default — same as the legacy back-compat path.
+    //
+    // 5.37.0: same lstat call also yields mtimeMs + birthtimeMs for the
+    // hq-mtime / hq-btime metadata headers. Single lstat keeps the syscall
+    // budget identical to 5.36.0; the additional metadata fields are pure
+    // in-memory work on the lstat result. Symlinks skip ALL THREE stamps
+    // — symlink mode is OS-controlled, symlink mtime isn't user-meaningful
+    // because the wire body is `hq-symlink:` + target (not real file
+    // content), and fs.utimesSync follows links so applying it on receive
+    // would mutate the target's mtime instead of the link's.
     let modeOctal;
+    let mtimeMsStamp;
+    let btimeMsStamp;
     try {
         const lstat = fs.lstatSync(localPath);
         if (!lstat.isSymbolicLink()) {
             modeOctal = (lstat.mode & 0o777).toString(8);
+            // Math.floor truncates the sub-millisecond fractional component
+            // some filesystems report (APFS returns full ms+fraction; ext4
+            // is integer-ms). String(int) on the read side matches the
+            // strict-numeric regex `^-?[0-9]{1,16}$` — optional leading `-`,
+            // no leading zeros, no decimals, no exponents.
+            //
+            // Codex PR #27 P2: accept the full finite range, including 0
+            // (Unix epoch) and negatives (pre-epoch / reproducible-build
+            // clamping). Earlier `> 0` filter silently dropped legitimate
+            // timestamps and broke the round-trip guarantee for that subset.
+            const mtimeFloor = Math.floor(lstat.mtimeMs);
+            if (Number.isFinite(lstat.mtimeMs)) {
+                mtimeMsStamp = String(mtimeFloor);
+            }
+            // birthtimeMs filter: only stamp when the filesystem actually
+            // tracks a separate creation time. ext4 historically returns 0
+            // (unsupported) or equals mtimeMs (no distinct tracking); tmpfs
+            // and some FUSE mounts behave similarly. Filtering at the source
+            // keeps the metadata header free of noise — the receiver can
+            // assume hq-btime, if present, carries real signal.
+            //
+            // Compare the floored values (not raw lstat.birthtimeMs vs
+            // lstat.mtimeMs) because APFS exposes sub-millisecond fractions —
+            // two timestamps representing the "same moment" for sync purposes
+            // can differ by < 1 ms and pass a strict `!==` check while serializing
+            // to the same integer-ms string. Comparing floor-to-floor matches
+            // what we actually emit on the wire.
+            const btimeFloor = Math.floor(lstat.birthtimeMs);
+            if (Number.isFinite(lstat.birthtimeMs) &&
+                btimeFloor > 0 &&
+                btimeFloor !== mtimeFloor) {
+                btimeMsStamp = String(btimeFloor);
+            }
         }
     }
     catch {
-        // Leave modeOctal undefined; receiver applies its umask default.
+        // Leave stamps undefined; receiver applies its umask default and
+        // leaves mtime at write-time (the legacy back-compat path).
     }
     // Preserve the original `created-at` across re-uploads when the object
     // already exists with author metadata — same convention the hq-console
@@ -196,6 +295,8 @@ export async function uploadFile(ctx, localPath, key, author) {
     const Metadata = {
         ...(author ? buildAuthorMetadata(author, createdAt) : {}),
         ...(modeOctal ? { [FILE_MODE_META_KEY]: modeOctal } : {}),
+        ...(mtimeMsStamp ? { [FILE_MTIME_META_KEY]: mtimeMsStamp } : {}),
+        ...(btimeMsStamp ? { [FILE_BTIME_META_KEY]: btimeMsStamp } : {}),
     };
     const response = await client.send(new PutObjectCommand({
         Bucket: ctx.bucketName,
@@ -394,6 +495,54 @@ export async function downloadFile(ctx, key, localPath) {
             }
         }
     }
+    // 5.37.0 — apply source-side mtime after the byte write (and after the
+    // chmod above; ordering between chmod and utimes doesn't matter, but
+    // both must run AFTER writeFileSync because writeFileSync resets mtime
+    // to wall-clock-now). See FILE_MTIME_META_KEY for the metadata contract.
+    //
+    // Strict-numeric regex BEFORE parseInt — same Codex P2 lesson as hq-mode.
+    // `^-?[0-9]{1,16}$` rejects partial-prefix garbage ("175junk" → 175),
+    // empty, double-signed, decimals, whitespace, and oversized strings. A
+    // single optional leading `-` is allowed so pre-epoch / reproducible-build
+    // timestamps round-trip (Codex PR #27 P2 — `mtimeMs === 0` and negative
+    // epoch values are legitimate). 16 digits comfortably covers any plausible
+    // epoch-ms value (year ~5138 is 16 digits; we'll cross that bridge later).
+    //
+    // fs.utimesSync FOLLOWS symlinks — that's fine here because we're on
+    // the regular-file branch (the symlink branch above already returned
+    // before we reach this code).
+    //
+    // Composition with the 5.36.0 lstat fast-path: the journal stamp at the
+    // share/sync call sites runs AFTER downloadFile returns, so the lstat
+    // it captures sees the post-utimes mtime. Verified in cli/sync.ts
+    // (downloadFile → lstatSync → updateEntry) and cli/share.ts (pull path
+    // similarly lstats after downloadFile). If a future caller stamps the
+    // journal BEFORE downloadFile completes, the fast-path will stale and
+    // re-hash every sync forever — keep the call-site invariant intact.
+    const mtimeRaw = response.Metadata?.[FILE_MTIME_META_KEY];
+    if (typeof mtimeRaw === "string" && /^-?[0-9]{1,16}$/.test(mtimeRaw)) {
+        const mtimeMs = parseInt(mtimeRaw, 10);
+        if (Number.isFinite(mtimeMs)) {
+            try {
+                // utimesSync accepts seconds OR Date; use Date(ms) for precision.
+                // atime = mtime is fine — many filesystems are mounted noatime
+                // and distinguishing "access" vs "modification" time doesn't
+                // matter for sync semantics. Setting both keeps the on-disk
+                // state deterministic across receivers.
+                const mtimeDate = new Date(mtimeMs);
+                fs.utimesSync(localPath, mtimeDate, mtimeDate);
+            }
+            catch {
+                // EPERM / read-only FS / file just unlinked → non-fatal. The
+                // file is materialized at write-time mtime; the source-of-truth
+                // can re-sync next pass.
+            }
+        }
+    }
+    // TODO: stamp hq-btime once Node lands lbirthtime (or birthtimeSync).
+    // The push side already emits hq-btime when the source FS tracks a
+    // distinct creation time, so a future receiver upgrade picks it up
+    // automatically without a server-side data migration.
     return { metadata: response.Metadata };
 }
 export async function listRemoteFiles(ctx, prefix) {

package/dist/s3.js.map

@@ -1 +1 @@
-{"version":3,"file":"s3.js","sourceRoot":"","sources":["../src/s3.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B;;;;GAIG;AACH,SAAS,WAAW,CAAC,GAAkB;IACrC,OAAO,IAAI,QAAQ,CAAC;QAClB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,WAAW,EAAE;YACX,WAAW,EAAE,GAAG,CAAC,WAAW,CAAC,WAAW;YACxC,eAAe,EAAE,GAAG,CAAC,WAAW,CAAC,eAAe;YAChD,YAAY,EAAE,GAAG,CAAC,WAAW,CAAC,YAAY;SAC3C;KACF,CAAC,CAAC;AACL,CAAC;AAcD;;;;;;;GAOG;AACH,SAAS,mBAAmB,CAC1B,MAAoB,EACpB,SAAiB;IAEjB,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,gBAAgB,CAAC,GAAG,GAAG,CAAC;IAC/B,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,KAAK,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC;IAC7B,CAAC;IACD,IAAI,SAAS,IAAI,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAE3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAc;IACvD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAa;IACtD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/D,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;YAC/D,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAE5C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,MAAM,CAAC,IAAI,CAAC,mBAAmB,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAkB,EAClB,SAAiB,EACjB,GAAW,EACX,MAAqB;IAErB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAExC,wEAAwE;IACxE,uEAAuE;IACvE,qEAAqE;IACrE,iDAAiD;IACjD,IAAI,SAA6B,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;YAC5B,SAAS,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;IACnE,CAAC;IAED,uEAAuE;IACvE,uEAAuE;IACvE,0EAA0E;IAC1E,yEAAyE;IACzE,iDAAiD;IACjD,IAAI,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzC,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAC5B,IAAI,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAC5D,CAAC;YACF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,YAAY,CAAC,CAAC;YAC/C,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxD,SAAS,GAAG,QAAQ,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;QAC3D,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAA2B;QACvC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1D,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,IAAI,gBAAgB,CAAC;QACnB,MAAM,EAAE,GAAG,CAAC,UAAU;QACtB,GAAG,EAAE,GAAG;QACR,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC;QAC7B,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1D,CAAC,CACH,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAkB,EAClB,MAAc,EACd,GAAW,EACX,MAAqB;IAErB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAEhC,qEAAqE;IACrE,qEAAqE;IACrE,0BAA0B;IAC1B,IAAI,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzC,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAC5B,IAAI,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAC5D,CAAC;YACF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,YAAY,CAAC,CAAC;YAC/C,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxD,SAAS,GAAG,QAAQ,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;QAC3D,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAA2B;QACvC,+DAA+D;QAC/D,0DAA0D;QAC1D,+DAA+D;QAC/D,8BAA8B;QAC9B,CAAC,uBAAuB,CAAC,EAAE,yBAAyB;QACpD,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1D,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,IAAI,gBAAgB,CAAC;QACnB,MAAM,EAAE,GAAG,CAAC,UAAU;QACtB,GAAG,EAAE,GAAG;QACR,kEAAkE;QAClE,+DAA+D;QAC/D,8DAA8D;QAC9D,iEAAiE;QACjE,yDAAyD;QACzD,kDAAkD;QAClD,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC;QAC/B,WAAW,EAAE,0BAA0B;QACvC,QAAQ;KACT,CAAC,CACH,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AACvC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAkB,EAClB,GAAW,EACX,SAAiB;IAEjB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAEhC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,IAAI,gBAAgB,CAAC;QACnB,MAAM,EAAE,GAAG,CAAC,UAAU;QACtB,GAAG,EAAE,GAAG;KACT,CAAC,CACH,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,mEAAmE;IACnE,kEAAkE;IAClE,+DAA+D;IAC/D,2DAA2D;IAC3D,EAAE;IACF,6DAA6D;IAC7D,2DAA2D;IAC3D,mEAAmE;IACnE,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,uBAAuB,CAAC,CAAC;IACnE,MAAM,eAAe,GACnB,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;IAChE,IAAI,eAAe,EAAE,CAAC;QACpB,gEAAgE;QAChE,yDAAyD;QACzD,6DAA6D;QAC7D,8DAA8D;QAC9D,8DAA8D;QAC9D,4DAA4D;QAC5D,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAiC,CAAC;QAC1D,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE3D,IAAI,aAAqB,CAAC;QAC1B,IAAI,UAAU,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAC/C,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACN,4DAA4D;YAC5D,2DAA2D;YAC3D,2DAA2D;YAC3D,2DAA2D;YAC3D,sDAAsD;YACtD,aAAa,GAAG,0BAA0B,CAAC,aAAa,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,sBAAsB,GAAG,yBAAyB,UAAU,CAAC,MAAM,mBAAmB,aAAa,GAAG,CACvG,CAAC;QACJ,CAAC;QAED,oEAAoE;QACpE,mEAAmE;QACnE,oEAAoE;QACpE,oEAAoE;QACpE,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IACE,CAAC,GAAG;gBACJ,OAAO,GAAG,KAAK,QAAQ;gBACvB,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC;gBACf,GAAyB,CAAC,IAAI,KAAK,QAAQ,EAC5C,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACD,EAAE,CAAC,WAAW,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QACzC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;IACzC,CAAC;IAED,qEAAqE;IACrE,qEAAqE;IACrE,sEAAsE;IACtE,+DAA+D;IAC/D,iEAAiE;IACjE,iEAAiE;IACjE,iEAAiE;IACjE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC;YAC9B,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,mEAAmE;QACnE,IACE,GAAG;YACH,OAAO,GAAG,KAAK,QAAQ;YACvB,MAAM,IAAI,GAAG;YACZ,GAAyB,CAAC,IAAI,KAAK,QAAQ,EAC5C,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAiC,CAAC;IAC1D,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAEnD,4DAA4D;IAC5D,oEAAoE;IACpE,qEAAqE;IACrE,8DAA8D;IAC9D,oEAAoE;IACpE,2DAA2D;IAC3D,EAAE;IACF,sEAAsE;IACtE,oEAAoE;IACpE,qEAAqE;IACrE,+DAA+D;IAC/D,qEAAqE;IACrE,iEAAiE;IACjE,sDAAsD;IACtD,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,kBAAkB,CAAC,CAAC;IAC1D,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACpE,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;YAC9D,IAAI,CAAC;gBACH,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAClC,CAAC;YAAC,MAAM,CAAC;gBACP,8DAA8D;gBAC9D,4DAA4D;gBAC5D,4DAA4D;gBAC5D,8CAA8C;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;AACzC,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAkB,EAClB,MAAe;IAEf,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,iBAAqC,CAAC;IAE1C,GAAG,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,IAAI,oBAAoB,CAAC;YACvB,MAAM,EAAE,GAAG,CAAC,UAAU;YACtB,MAAM,EAAE,MAAM;YACd,iBAAiB,EAAE,iBAAiB;SACrC,CAAC,CACH,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YAC1C,uEAAuE;YACvE,oEAAoE;YACpE,oEAAoE;YACpE,+DAA+D;YAC/D,0BAA0B;YAC1B,IAAI,CAAC,GAAG,CAAC,GAAG;gBAAE,SAAS;YACvB,mEAAmE;YACnE,mEAAmE;YACnE,kEAAkE;YAClE,kEAAkE;YAClE,mEAAmE;YACnE,iEAAiE;YACjE,+DAA+D;YAC/D,8CAA8C;YAC9C,EAAE;YACF,iEAAiE;YACjE,mEAAmE;YACnE,+DAA+D;YAC/D,iEAAiE;YACjE,8DAA8D;YAC9D,iEAAiE;YACjE,iEAAiE;YACjE,uDAAuD;YACvD,EAAE;YACF,gEAAgE;YAChE,8DAA8D;YAC9D,iBAAiB;YACjB,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC;gBAAE,SAAS;YAE7D,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC;gBACnB,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI,IAAI,EAAE;gBAC5C,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;aACrB,CAAC,CAAC;QACL,CAAC;QAED,iBAAiB,GAAG,QAAQ,CAAC,qBAAqB,CAAC;IACrD,CAAC,QAAQ,iBAAiB,EAAE;IAE5B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAkB,EAClB,GAAW;IAEX,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAEhC,MAAM,MAAM,CAAC,IAAI,CACf,IAAI,mBAAmB,CAAC;QACtB,MAAM,EAAE,GAAG,CAAC,UAAU;QACtB,GAAG,EAAE,GAAG;KACT,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAkB,EAClB,GAAW;IAEX,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,IAAI,iBAAiB,CAAC;YACpB,MAAM,EAAE,GAAG,CAAC,UAAU;YACtB,GAAG,EAAE,GAAG;SACT,CAAC,CACH,CAAC;QACF,OAAO;YACL,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,IAAI,IAAI,EAAE;YACjD,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE;YACzB,IAAI,EAAE,QAAQ,CAAC,aAAa,IAAI,CAAC;YACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/E,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,MAAM,SAAS,GAA2B;QACxC,KAAK,EAAE,eAAe;QACtB,OAAO,EAAE,kBAAkB;QAC3B,OAAO,EAAE,WAAW;QACpB,MAAM,EAAE,WAAW;QACnB,KAAK,EAAE,iBAAiB;QACxB,KAAK,EAAE,iBAAiB;QACxB,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,WAAW;QACpB,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,WAAW;QACnB,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,YAAY;QACrB,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,iBAAiB;KAC1B,CAAC;IACF,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC;AACtD,CAAC"}
+{"version":3,"file":"s3.js","sourceRoot":"","sources":["../src/s3.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B;;;;GAIG;AACH,SAAS,WAAW,CAAC,GAAkB;IACrC,OAAO,IAAI,QAAQ,CAAC;QAClB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,WAAW,EAAE;YACX,WAAW,EAAE,GAAG,CAAC,WAAW,CAAC,WAAW;YACxC,eAAe,EAAE,GAAG,CAAC,WAAW,CAAC,eAAe;YAChD,YAAY,EAAE,GAAG,CAAC,WAAW,CAAC,YAAY;SAC3C;KACF,CAAC,CAAC;AACL,CAAC;AAcD;;;;;;;GAOG;AACH,SAAS,mBAAmB,CAC1B,MAAoB,EACpB,SAAiB;IAEjB,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,gBAAgB,CAAC,GAAG,GAAG,CAAC;IAC/B,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,KAAK,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC;IAC7B,CAAC;IACD,IAAI,SAAS,IAAI,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAE3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAc;IACvD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAa;IACtD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/D,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;YAC/D,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAE9C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,MAAM,CAAC,IAAI,CAAC,mBAAmB,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAkB,EAClB,SAAiB,EACjB,GAAW,EACX,MAAqB;IAErB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAExC,wEAAwE;IACxE,uEAAuE;IACvE,qEAAqE;IACrE,iDAAiD;IACjD,EAAE;IACF,oEAAoE;IACpE,uEAAuE;IACvE,sEAAsE;IACtE,qEAAqE;IACrE,uEAAuE;IACvE,iEAAiE;IACjE,sEAAsE;IACtE,yDAAyD;IACzD,IAAI,SAA6B,CAAC;IAClC,IAAI,YAAgC,CAAC;IACrC,IAAI,YAAgC,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;YAC5B,SAAS,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC7C,gEAAgE;YAChE,+DAA+D;YAC/D,2DAA2D;YAC3D,iEAAiE;YACjE,+CAA+C;YAC/C,EAAE;YACF,6DAA6D;YAC7D,6DAA6D;YAC7D,8DAA8D;YAC9D,iEAAiE;YACjE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7C,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnC,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;YACpC,CAAC;YACD,8DAA8D;YAC9D,+DAA+D;YAC/D,gEAAgE;YAChE,iEAAiE;YACjE,6DAA6D;YAC7D,oDAAoD;YACpD,EAAE;YACF,2DAA2D;YAC3D,kEAAkE;YAClE,kEAAkE;YAClE,uEAAuE;YACvE,kEAAkE;YAClE,qCAAqC;YACrC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACjD,IACE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC;gBAClC,UAAU,GAAG,CAAC;gBACd,UAAU,KAAK,UAAU,EACzB,CAAC;gBACD,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;QACjE,4DAA4D;IAC9D,CAAC;IAED,uEAAuE;IACvE,uEAAuE;IACvE,0EAA0E;IAC1E,yEAAyE;IACzE,iDAAiD;IACjD,IAAI,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzC,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAC5B,IAAI,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAC5D,CAAC;YACF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,YAAY,CAAC,CAAC;YAC/C,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxD,SAAS,GAAG,QAAQ,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;QAC3D,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAA2B;QACvC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,IAAI,gBAAgB,CAAC;QACnB,MAAM,EAAE,GAAG,CAAC,UAAU;QACtB,GAAG,EAAE,GAAG;QACR,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC;QAC7B,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1D,CAAC,CACH,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAkB,EAClB,MAAc,EACd,GAAW,EACX,MAAqB;IAErB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAEhC,qEAAqE;IACrE,qEAAqE;IACrE,0BAA0B;IAC1B,IAAI,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzC,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAC5B,IAAI,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAC5D,CAAC;YACF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,YAAY,CAAC,CAAC;YAC/C,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxD,SAAS,GAAG,QAAQ,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;QAC3D,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAA2B;QACvC,+DAA+D;QAC/D,0DAA0D;QAC1D,+DAA+D;QAC/D,8BAA8B;QAC9B,CAAC,uBAAuB,CAAC,EAAE,yBAAyB;QACpD,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1D,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,IAAI,gBAAgB,CAAC;QACnB,MAAM,EAAE,GAAG,CAAC,UAAU;QACtB,GAAG,EAAE,GAAG;QACR,kEAAkE;QAClE,+DAA+D;QAC/D,8DAA8D;QAC9D,iEAAiE;QACjE,yDAAyD;QACzD,kDAAkD;QAClD,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC;QAC/B,WAAW,EAAE,0BAA0B;QACvC,QAAQ;KACT,CAAC,CACH,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AACvC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAkB,EAClB,GAAW,EACX,SAAiB;IAEjB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAEhC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,IAAI,gBAAgB,CAAC;QACnB,MAAM,EAAE,GAAG,CAAC,UAAU;QACtB,GAAG,EAAE,GAAG;KACT,CAAC,CACH,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,mEAAmE;IACnE,kEAAkE;IAClE,+DAA+D;IAC/D,2DAA2D;IAC3D,EAAE;IACF,6DAA6D;IAC7D,2DAA2D;IAC3D,mEAAmE;IACnE,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,uBAAuB,CAAC,CAAC;IACnE,MAAM,eAAe,GACnB,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;IAChE,IAAI,eAAe,EAAE,CAAC;QACpB,gEAAgE;QAChE,yDAAyD;QACzD,6DAA6D;QAC7D,8DAA8D;QAC9D,8DAA8D;QAC9D,4DAA4D;QAC5D,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAiC,CAAC;QAC1D,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE3D,IAAI,aAAqB,CAAC;QAC1B,IAAI,UAAU,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAC/C,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACN,4DAA4D;YAC5D,2DAA2D;YAC3D,2DAA2D;YAC3D,2DAA2D;YAC3D,sDAAsD;YACtD,aAAa,GAAG,0BAA0B,CAAC,aAAa,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,sBAAsB,GAAG,yBAAyB,UAAU,CAAC,MAAM,mBAAmB,aAAa,GAAG,CACvG,CAAC;QACJ,CAAC;QAED,oEAAoE;QACpE,mEAAmE;QACnE,oEAAoE;QACpE,oEAAoE;QACpE,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IACE,CAAC,GAAG;gBACJ,OAAO,GAAG,KAAK,QAAQ;gBACvB,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC;gBACf,GAAyB,CAAC,IAAI,KAAK,QAAQ,EAC5C,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACD,EAAE,CAAC,WAAW,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QACzC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;IACzC,CAAC;IAED,qEAAqE;IACrE,qEAAqE;IACrE,sEAAsE;IACtE,+DAA+D;IAC/D,iEAAiE;IACjE,iEAAiE;IACjE,iEAAiE;IACjE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC;YAC9B,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,mEAAmE;QACnE,IACE,GAAG;YACH,OAAO,GAAG,KAAK,QAAQ;YACvB,MAAM,IAAI,GAAG;YACZ,GAAyB,CAAC,IAAI,KAAK,QAAQ,EAC5C,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAiC,CAAC;IAC1D,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAEnD,4DAA4D;IAC5D,oEAAoE;IACpE,qEAAqE;IACrE,8DAA8D;IAC9D,oEAAoE;IACpE,2DAA2D;IAC3D,EAAE;IACF,sEAAsE;IACtE,oEAAoE;IACpE,qEAAqE;IACrE,+DAA+D;IAC/D,qEAAqE;IACrE,iEAAiE;IACjE,sDAAsD;IACtD,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,kBAAkB,CAAC,CAAC;IAC1D,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACpE,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;YAC9D,IAAI,CAAC;gBACH,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAClC,CAAC;YAAC,MAAM,CAAC;gBACP,8DAA8D;gBAC9D,4DAA4D;gBAC5D,4DAA4D;gBAC5D,8CAA8C;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,qEAAqE;IACrE,uEAAuE;IACvE,yEAAyE;IACzE,EAAE;IACF,0EAA0E;IAC1E,sEAAsE;IACtE,uEAAuE;IACvE,2EAA2E;IAC3E,wEAAwE;IACxE,2EAA2E;IAC3E,2EAA2E;IAC3E,EAAE;IACF,qEAAqE;IACrE,qEAAqE;IACrE,8BAA8B;IAC9B,EAAE;IACF,wEAAwE;IACxE,sEAAsE;IACtE,kEAAkE;IAClE,uEAAuE;IACvE,sEAAsE;IACtE,sEAAsE;IACtE,oEAAoE;IACpE,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,mBAAmB,CAAC,CAAC;IAC1D,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACvC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,kEAAkE;gBAClE,+DAA+D;gBAC/D,6DAA6D;gBAC7D,4DAA4D;gBAC5D,wCAAwC;gBACxC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;gBACpC,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YACjD,CAAC;YAAC,MAAM,CAAC;gBACP,6DAA6D;gBAC7D,gEAAgE;gBAChE,yBAAyB;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,mEAAmE;IACnE,mEAAmE;IACnE,sDAAsD;IAEtD,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;AACzC,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAkB,EAClB,MAAe;IAEf,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,iBAAqC,CAAC;IAE1C,GAAG,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,IAAI,oBAAoB,CAAC;YACvB,MAAM,EAAE,GAAG,CAAC,UAAU;YACtB,MAAM,EAAE,MAAM;YACd,iBAAiB,EAAE,iBAAiB;SACrC,CAAC,CACH,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YAC1C,uEAAuE;YACvE,oEAAoE;YACpE,oEAAoE;YACpE,+DAA+D;YAC/D,0BAA0B;YAC1B,IAAI,CAAC,GAAG,CAAC,GAAG;gBAAE,SAAS;YACvB,mEAAmE;YACnE,mEAAmE;YACnE,kEAAkE;YAClE,kEAAkE;YAClE,mEAAmE;YACnE,iEAAiE;YACjE,+DAA+D;YAC/D,8CAA8C;YAC9C,EAAE;YACF,iEAAiE;YACjE,mEAAmE;YACnE,+DAA+D;YAC/D,iEAAiE;YACjE,8DAA8D;YAC9D,iEAAiE;YACjE,iEAAiE;YACjE,uDAAuD;YACvD,EAAE;YACF,gEAAgE;YAChE,8DAA8D;YAC9D,iBAAiB;YACjB,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC;gBAAE,SAAS;YAE7D,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC;gBACnB,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI,IAAI,EAAE;gBAC5C,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;aACrB,CAAC,CAAC;QACL,CAAC;QAED,iBAAiB,GAAG,QAAQ,CAAC,qBAAqB,CAAC;IACrD,CAAC,QAAQ,iBAAiB,EAAE;IAE5B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAkB,EAClB,GAAW;IAEX,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAEhC,MAAM,MAAM,CAAC,IAAI,CACf,IAAI,mBAAmB,CAAC;QACtB,MAAM,EAAE,GAAG,CAAC,UAAU;QACtB,GAAG,EAAE,GAAG;KACT,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAkB,EAClB,GAAW;IAEX,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,IAAI,iBAAiB,CAAC;YACpB,MAAM,EAAE,GAAG,CAAC,UAAU;YACtB,GAAG,EAAE,GAAG;SACT,CAAC,CACH,CAAC;QACF,OAAO;YACL,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,IAAI,IAAI,EAAE;YACjD,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE;YACzB,IAAI,EAAE,QAAQ,CAAC,aAAa,IAAI,CAAC;YACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/E,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,MAAM,SAAS,GAA2B;QACxC,KAAK,EAAE,eAAe;QACtB,OAAO,EAAE,kBAAkB;QAC3B,OAAO,EAAE,WAAW;QACpB,MAAM,EAAE,WAAW;QACnB,KAAK,EAAE,iBAAiB;QACxB,KAAK,EAAE,iBAAiB;QACxB,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,WAAW;QACpB,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,WAAW;QACnB,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,YAAY;QACrB,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,iBAAiB;KAC1B,CAAC;IACF,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC;AACtD,CAAC"}

package/dist/s3.test.js

@@ -88,7 +88,7 @@ vi.mock("@aws-sdk/client-s3", () => {
         DeleteObjectCommand,
     };
 });
-import { uploadFile, uploadSymlink, downloadFile, listRemoteFiles, SYMLINK_BODY_PREFIX, SYMLINK_MARKER_META_VALUE, encodeSymlinkMetadataValue, decodeSymlinkMetadataValue, } from "./s3.js";
+import { uploadFile, uploadSymlink, downloadFile, listRemoteFiles, SYMLINK_BODY_PREFIX, SYMLINK_MARKER_META_VALUE, encodeSymlinkMetadataValue, decodeSymlinkMetadataValue, FILE_MTIME_META_KEY, FILE_BTIME_META_KEY, } from "./s3.js";
 function makeCtx() {
     return {
         uid: "cmp_TEST",
@@ -202,6 +202,57 @@ describe("uploadFile", () => {
             expect(meta?.["hq-mode"]).toBe(mode.toString(8));
         }
     });
+    it("stamps source file mtimeMs as hq-mtime metadata (5.37.0 — preserve mtime)", async () => {
+        // Symmetric to Bug #5's mode preservation. A file's modification time
+        // should follow it across machines instead of resetting to "the time of
+        // sync." Push stamps `hq-mtime` = integer-ms epoch string; pull applies
+        // it via utimesSync. See FILE_MTIME_META_KEY doc.
+        const knownMs = 1_700_000_000_000; // 2023-11-14T22:13:20Z, comfortably finite
+        const knownDate = new Date(knownMs);
+        fs.utimesSync(tmpFile, knownDate, knownDate);
+        await uploadFile(makeCtx(), tmpFile, "stamped.md");
+        const put = sentCommands.find((c) => c.name === "PutObjectCommand");
+        expect(put).toBeDefined();
+        const meta = put.input.Metadata;
+        expect(meta?.[FILE_MTIME_META_KEY]).toBe(String(knownMs));
+    });
+    it("stamps hq-btime only when birthtime is supported AND distinct from mtime", async () => {
+        // Many filesystems (Linux/ext4 historically, tmpfs, some FUSE mounts)
+        // return birthtimeMs === 0 or birthtimeMs === mtimeMs. Stamping in
+        // those cases would be pure noise; the upload side filters it out.
+        // We don't control the test filesystem's birthtime semantics, so the
+        // assertion is shape-only: IF hq-btime is present, it's a numeric
+        // string AND it's distinct from hq-mtime.
+        await uploadFile(makeCtx(), tmpFile, "btime.md");
+        const put = sentCommands.find((c) => c.name === "PutObjectCommand");
+        const meta = put.input.Metadata;
+        const btime = meta?.[FILE_BTIME_META_KEY];
+        const mtime = meta?.[FILE_MTIME_META_KEY];
+        if (typeof btime === "string") {
+            expect(btime).toMatch(/^[0-9]{1,16}$/);
+            expect(btime).not.toBe(mtime);
+        }
+    });
+    it("does NOT stamp hq-mtime / hq-btime for symlinks (uploadFile branch)", async () => {
+        // uploadFile is the regular-file path; uploadSymlink is the symlink
+        // path. uploadFile's lstat.isSymbolicLink() guard skips ALL three of
+        // mode + mtime + btime stamping for symlinks, mirroring the existing
+        // hq-mode policy: symlink times are OS-controlled and fs.utimesSync
+        // would follow the link and mutate the target. The link is set up
+        // pointing at a real target so fs.readFileSync (which follows links)
+        // doesn't ENOENT before the metadata stamping branch even runs.
+        const targetPath = path.join(os.tmpdir(), `s3-link-target-${Date.now()}-${Math.random()}.txt`);
+        fs.writeFileSync(targetPath, "real-bytes");
+        const linkPath = path.join(os.tmpdir(), `s3-link-test-${Date.now()}-${Math.random()}.lnk`);
+        fs.symlinkSync(targetPath, linkPath);
+        await uploadFile(makeCtx(), linkPath, "link.md");
+        const put = sentCommands.find((c) => c.name === "PutObjectCommand");
+        const meta = put.input.Metadata;
+        expect(meta?.[FILE_MTIME_META_KEY]).toBeUndefined();
+        expect(meta?.[FILE_BTIME_META_KEY]).toBeUndefined();
+        fs.unlinkSync(linkPath);
+        fs.unlinkSync(targetPath);
+    });
     it("elides non-ASCII or empty author fields rather than throwing", async () => {
         // S3 user-defined metadata must be ASCII-only and total ≤ 2KB. Partial
         // attribution beats hard failure — values that fail the printable check
@@ -677,6 +728,215 @@ describe("downloadFile", () => {
         // No assertion on mode — receiver default is whatever umask set.
         expect(fs.readFileSync(localPath, "utf-8")).toBe("legacy");
     });
+    it("applies hq-mtime via utimesSync after byte write (5.37.0 — preserve mtime)", async () => {
+        // Round-trip pair to the s3.upload mtime stamp test. The receiver must
+        // set the local file's mtime to the metadata-stamped value AFTER the
+        // byte write, mirroring the chmod-after-write shape from Bug #5.
+        const knownMs = 1_700_000_000_000;
+        nextGetObjectResponse = {
+            Body: (async function* () {
+                yield new Uint8Array([116, 105, 109, 101]); // "time"
+            })(),
+            Metadata: { [FILE_MTIME_META_KEY]: String(knownMs) },
+        };
+        const localPath = path.join(tmpRoot, "mtime-applied.bin");
+        await downloadFile(makeCtx(), "mtime-applied.bin", localPath);
+        const stat = fs.statSync(localPath);
+        // ±50ms tolerance accommodates ms-precision filesystems and the
+        // utimesSync→stat round-trip rounding. macOS APFS reports full ms;
+        // some Linux filesystems round to seconds — guard with tolerance.
+        expect(Math.abs(stat.mtimeMs - knownMs)).toBeLessThanOrEqual(50);
+    });
+    it("rejects malformed hq-mtime metadata via strict-numeric regex", async () => {
+        // Symmetric to the hq-mode Codex P2 lesson: parseInt accepts partial-
+        // prefix garbage ("175junk" → 175). A strict `^[0-9]{1,16}$` regex
+        // BEFORE parseInt rejects empty / signed / decimals / whitespace /
+        // oversized / non-numeric and falls through to "no utimes call,"
+        // leaving the file at write-time mtime — the legacy back-compat path.
+        // NOTE: `-100` is intentionally NOT in this list — Codex PR #27 P2 pointed
+        // out that legitimate epoch values include 0 (Unix epoch) and negatives
+        // (e.g. reproducible-build clamping pre-1970). Negative-but-well-formed
+        // strings are now accepted; see the dedicated round-trip tests below.
+        const malformed = [
+            "175junk", // trailing garbage — parseInt parses 175 pre-fix
+            "abc", // non-numeric
+            "", // empty
+            "  100  ", // whitespace
+            "--100", // double-sign — only ONE optional leading "-" allowed
+            "+100", // explicit plus rejected (regex only allows optional "-")
+            "3.14", // decimal
+            "99999999999999999", // >16 digits
+        ];
+        for (const bad of malformed) {
+            // Establish a known pre-write mtime by writing the file first.
+            const localPath = path.join(tmpRoot, `bad-mtime-${malformed.indexOf(bad)}.bin`);
+            nextGetObjectResponse = {
+                Body: (async function* () {
+                    yield new Uint8Array([98]); // "b"
+                })(),
+                Metadata: { [FILE_MTIME_META_KEY]: bad },
+            };
+            const before = Date.now();
+            await downloadFile(makeCtx(), `bad-mtime-${malformed.indexOf(bad)}.bin`, localPath);
+            const stat = fs.statSync(localPath);
+            // The file's mtime MUST be wall-clock-now (write-time), NOT the
+            // partial-parse value. For "175junk", that means mtime is in the
+            // current millis range, not ms=175 (1970-01-01T00:00:00.175Z).
+            // Generic check: mtime is near `before` (within 5s).
+            expect(Math.abs(stat.mtimeMs - before)).toBeLessThan(5000);
+            // Specific check: never the partial-parse epoch (~175ms after epoch).
+            expect(stat.mtimeMs).toBeGreaterThan(1_000_000_000_000);
+        }
+    });
+    it("round-trips mtimeMs === 0 (Unix epoch — Codex PR #27 P2)", async () => {
+        // Codex flagged that filtering `mtimeMs > 0` drops legitimate epoch-0
+        // timestamps (and reproducible-build clamping uses exactly 0). The
+        // receiver must accept "0", parse it, and stamp `new Date(0)` on disk.
+        const sourcePath = path.join(tmpRoot, "epoch-zero-src.bin");
+        fs.writeFileSync(sourcePath, "epoch-bytes");
+        fs.utimesSync(sourcePath, new Date(0), new Date(0));
+        sentCommands.length = 0;
+        await uploadFile(makeCtx(), sourcePath, "epoch-zero.bin");
+        const put = sentCommands.find((c) => c.name === "PutObjectCommand");
+        const stampedMeta = put.input.Metadata;
+        const stampedBody = put.input.Body;
+        expect(stampedMeta[FILE_MTIME_META_KEY]).toBe("0");
+        fs.unlinkSync(sourcePath);
+        nextGetObjectResponse = {
+            Body: (async function* () {
+                yield new Uint8Array(stampedBody);
+            })(),
+            Metadata: stampedMeta,
+        };
+        await downloadFile(makeCtx(), "epoch-zero.bin", sourcePath);
+        const stat = fs.statSync(sourcePath);
+        // 0 is integer-clean — exact match expected, but allow 50ms tolerance
+        // for any underlying FS rounding shenanigans.
+        expect(Math.abs(stat.mtimeMs - 0)).toBeLessThanOrEqual(50);
+        expect(fs.readFileSync(sourcePath, "utf-8")).toBe("epoch-bytes");
+    });
+    it("round-trips a negative mtime (pre-epoch — Codex PR #27 P2)", async () => {
+        // Some filesystems / reproducible-build pipelines clamp mtime to values
+        // before the Unix epoch (negative ms). `new Date(-86400000)` is a legal
+        // Date; `fs.utimesSync` accepts it. The receiver MUST NOT drop these.
+        const sourceMs = -86_400_000; // 1969-12-31T00:00:00Z, one day before epoch
+        const sourcePath = path.join(tmpRoot, "pre-epoch-src.bin");
+        fs.writeFileSync(sourcePath, "pre-epoch-bytes");
+        fs.utimesSync(sourcePath, new Date(sourceMs), new Date(sourceMs));
+        sentCommands.length = 0;
+        await uploadFile(makeCtx(), sourcePath, "pre-epoch.bin");
+        const put = sentCommands.find((c) => c.name === "PutObjectCommand");
+        const stampedMeta = put.input.Metadata;
+        const stampedBody = put.input.Body;
+        expect(stampedMeta[FILE_MTIME_META_KEY]).toBe(String(sourceMs));
+        fs.unlinkSync(sourcePath);
+        nextGetObjectResponse = {
+            Body: (async function* () {
+                yield new Uint8Array(stampedBody);
+            })(),
+            Metadata: stampedMeta,
+        };
+        await downloadFile(makeCtx(), "pre-epoch.bin", sourcePath);
+        const stat = fs.statSync(sourcePath);
+        expect(Math.abs(stat.mtimeMs - sourceMs)).toBeLessThanOrEqual(50);
+        expect(fs.readFileSync(sourcePath, "utf-8")).toBe("pre-epoch-bytes");
+    });
+    it("accepts well-formed negative hq-mtime (e.g. '-100') on download", async () => {
+        // Migration of the old rejection-list case for `-100`. Codex PR #27 P2:
+        // negative epoch-ms values are legitimate; the regex now allows a single
+        // optional leading `-`, and utimesSync handles it.
+        const localPath = path.join(tmpRoot, "negative-mtime.bin");
+        nextGetObjectResponse = {
+            Body: (async function* () {
+                yield new Uint8Array([110]); // "n"
+            })(),
+            Metadata: { [FILE_MTIME_META_KEY]: "-100" },
+        };
+        await downloadFile(makeCtx(), "negative-mtime.bin", localPath);
+        const stat = fs.statSync(localPath);
+        // mtime should be ~ -100 ms, NOT wall-clock-now. The old code would have
+        // left this at write-time; the new code applies the negative stamp.
+        expect(Math.abs(stat.mtimeMs - -100)).toBeLessThanOrEqual(50);
+    });
+    it("downloads with default mtime when hq-mtime metadata is absent (back-compat)", async () => {
+        // Legacy uploads (pre-5.37.0) carry no hq-mtime header. The receiver
+        // must NOT crash and must NOT alter the on-disk mtime away from the
+        // default `fs.writeFileSync` wall-clock-now behavior. Mirrors the
+        // hq-mode back-compat test.
+        nextGetObjectResponse = {
+            Body: (async function* () {
+                yield new Uint8Array([108, 101, 103]); // "leg"
+            })(),
+            Metadata: {},
+        };
+        const before = Date.now();
+        const localPath = path.join(tmpRoot, "legacy-mtime.bin");
+        await downloadFile(makeCtx(), "legacy-mtime.bin", localPath);
+        const stat = fs.statSync(localPath);
+        expect(Math.abs(stat.mtimeMs - before)).toBeLessThan(5000);
+        expect(fs.readFileSync(localPath, "utf-8")).toBe("leg");
+    });
+    it("does NOT call utimesSync on the symlink branch (5.37.0)", async () => {
+        // fs.utimesSync follows symlinks (mutates the target's mtime, not the
+        // link's). On the symlink branch we must skip the utimes block entirely
+        // so we don't accidentally mutate an unrelated target file. The
+        // symlink record's hq-mtime, if any, is ignored — symlink mtime is
+        // OS-controlled and Node has no stable lutimes API. Easiest verifier:
+        // the link is materialized AND the test doesn't crash.
+        const targetPath = path.join(tmpRoot, "untouched-target.txt");
+        fs.writeFileSync(targetPath, "do-not-touch");
+        const knownTargetMs = 1_500_000_000_000;
+        fs.utimesSync(targetPath, new Date(knownTargetMs), new Date(knownTargetMs));
+        const linkPath = path.join(tmpRoot, "the-link");
+        nextGetObjectResponse = {
+            Body: (async function* () {
+                yield Buffer.from(SYMLINK_BODY_PREFIX + "untouched-target.txt");
+            })(),
+            Metadata: {
+                "hq-symlink-target": SYMLINK_MARKER_META_VALUE,
+                // Even if a misbehaving uploader stamped hq-mtime on a symlink
+                // record, the downloader's symlink branch returns BEFORE the
+                // utimes block, so the target's mtime stays at knownTargetMs.
+                [FILE_MTIME_META_KEY]: "1_900_000_000_000",
+            },
+        };
+        await downloadFile(makeCtx(), "the-link", linkPath);
+        expect(fs.lstatSync(linkPath).isSymbolicLink()).toBe(true);
+        expect(fs.readlinkSync(linkPath)).toBe("untouched-target.txt");
+        // Target's mtime is unchanged — utimes block was skipped.
+        const targetStat = fs.statSync(targetPath);
+        expect(Math.abs(targetStat.mtimeMs - knownTargetMs)).toBeLessThanOrEqual(50);
+    });
+    it("round-trips mtime across upload + download (5.37.0 user-visible promise)", async () => {
+        // The whole point of the feature: a file's mtime should follow it
+        // across the wire. Push captures source mtime → metadata; pull applies
+        // metadata → local mtime. This test wires upload's PutObject capture
+        // into download's GetObject response so the contract round-trips end-
+        // to-end through s3.ts without bringing in journal/CLI state.
+        const sourceMs = 1_650_000_000_000; // 2022-04-15T03:33:20Z
+        const sourcePath = path.join(tmpRoot, "round-trip-src.bin");
+        fs.writeFileSync(sourcePath, "round-trip-bytes");
+        fs.utimesSync(sourcePath, new Date(sourceMs), new Date(sourceMs));
+        sentCommands.length = 0;
+        await uploadFile(makeCtx(), sourcePath, "round-trip.bin");
+        const put = sentCommands.find((c) => c.name === "PutObjectCommand");
+        const stampedMeta = put.input.Metadata;
+        const stampedBody = put.input.Body;
+        // Wipe the local copy and pull via download — simulating a different
+        // machine receiving the file.
+        fs.unlinkSync(sourcePath);
+        nextGetObjectResponse = {
+            Body: (async function* () {
+                yield new Uint8Array(stampedBody);
+            })(),
+            Metadata: stampedMeta,
+        };
+        await downloadFile(makeCtx(), "round-trip.bin", sourcePath);
+        const stat = fs.statSync(sourcePath);
+        // Within 100ms — covers FS rounding on both ends of the round-trip.
+        expect(Math.abs(stat.mtimeMs - sourceMs)).toBeLessThanOrEqual(100);
+        expect(fs.readFileSync(sourcePath, "utf-8")).toBe("round-trip-bytes");
+    });
     it("returns the object's user-metadata (including created-by) for a regular file", async () => {
         nextGetObjectResponse = {
             Body: (async function* () {