aimeat 3.1.0 → 3.3.0

package/dist/src/utils/app-content-type.js

@@ -33,11 +33,27 @@
  *     added for text types that do not already carry a charset. Non-text types pass through.
  *   - sniffedContentType(mimeType, bytes) — for USER-UPLOADED bytes: the same, but only after the
  *     bytes pass a UTF-8 decode test.
+ *   - needsUtf8Verdict(mimeType) / isValidUtf8(bytes) — the two halves of that test, so a WRITE path
+ *     can settle the question once instead of every read repeating it.
+ *   - verifiedContentType(mimeType, utf8Verified) — the same answer from a stored verdict, for a
+ *     response that does not have the whole file in hand.
+ *
+ *   WHY THE VERDICT IS STORED. Serving a byte range is the case that breaks the "read the bytes"
+ *   design: the whole point of a range is not to load the file, and the whole file is exactly what
+ *   the decode test wants. Loading 25 MB to answer an 8-byte request measured 181 ms against 3 ms for
+ *   a database-side slice. So the decode test moved to the write, where the bytes are already in
+ *   hand and the answer is a property of the file rather than of the request. A row from before this
+ *   existed carries no verdict, and a range read of one still loads the file: the same answer as
+ *   today at the same cost as today, and it settles itself the next time the file is written.
  * @usage
- *   import { appContentType, sniffedContentType } from '../utils/app-content-type.js';
- *   res.setHeader('Content-Type', appContentType(app.mimeType));            // node-generated
- *   res.setHeader('Content-Type', sniffedContentType(file.mimeType, file.data));  // uploaded
+ *   import { appContentType, sniffedContentType, verifiedContentType } from '../utils/app-content-type.js';
+ *   res.setHeader('Content-Type', appContentType(app.mimeType));                    // node-generated
+ *   res.setHeader('Content-Type', sniffedContentType(file.mimeType, file.data));    // uploaded, bytes in hand
+ *   res.setHeader('Content-Type', verifiedContentType(file.mimeType, file.utf8Verified)); // uploaded, metadata only
  * @version-history
+ *   v1.2.0 — 2026-08-15 — TARGET-063: the decode test split out so a write can settle it once
+ *     (needsUtf8Verdict / isValidUtf8) and a metadata-only response can read the answer back
+ *     (verifiedContentType). sniffedContentType now delegates, so there is still ONE rule.
  *   v1.1.0 — 2026-08-01 — TARGET-058 Phase 5 step 0b: sniffedContentType() for the stored-file
  *     routes, with the node-generated / user-uploaded distinction the Phase 4 audit drew.
  *   v1.0.0 — 2026-08-01 — TARGET-058 Phase 4 step 0a, after the corpus scan above.
@@ -78,21 +94,74 @@ export function appContentType(mimeType) {
  * describes the entity, not the slice.
  */
 export function sniffedContentType(mimeType, bytes) {
-    const type = (mimeType ?? '').trim() || 'application/octet-stream';
-    if (/;\s*charset\s*=/i.test(type))
-        return type;
-    if (!TEXTUAL.test(type))
-        return type;
+    if (!needsUtf8Verdict(mimeType))
+        return normalisedType(mimeType);
     if (!bytes)
-        return type;
+        return normalisedType(mimeType);
+    return verifiedContentType(mimeType, isValidUtf8(bytes));
+}
+/**
+ * Would a UTF-8 verdict change how this type is served? False for a type that already names a
+ * charset (the author said it and we do not overrule them) and for anything non-textual (a charset
+ * on a PNG means nothing).
+ *
+ * A write path asks this FIRST, and skips the decode test entirely when the answer is no. That is
+ * what keeps the cost off image and archive uploads: they never needed the test, and now they do
+ * not pay for it.
+ */
+export function needsUtf8Verdict(mimeType) {
+    const type = normalisedType(mimeType);
+    if (/;\s*charset\s*=/i.test(type))
+        return false;
+    return TEXTUAL.test(type);
+}
+/**
+ * Do these bytes decode as UTF-8, whole and strict?
+ *
+ * The decode test rather than a glyph signature, for the reason in the file header: a signature
+ * cannot tell `ä` from a clean Finnish `[ÅÄÖåäö]`, and produced exactly that false positive
+ * against the real corpus.
+ */
+export function isValidUtf8(bytes) {
     try {
         new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+        return true;
     }
     catch {
-        // The exception IS the answer: a decode failure is precisely the signal that these bytes are
-        // not UTF-8, and it is acted on rather than swallowed.
-        return type; // leave the author's file exactly as it is served today
+        // The exception IS the answer. A fatal TextDecoder throws on exactly one condition, an invalid
+        // UTF-8 sequence, and that condition is the question being asked. There is no failure here to
+        // hide: false is a measured result rather than a fallback, and the caller stores it as one.
+        // eslint-disable-next-line aimeat/no-silent-catch -- the throw is the measurement, see above
+        return false;
     }
+}
+/**
+ * The served `Content-Type` from a verdict somebody else established.
+ *
+ * `undefined` means NOT ESTABLISHED — a file stored before the verdict was recorded — and it is
+ * treated exactly like `false`: say nothing, and serve the file the way it is served today. It is
+ * never read as "not UTF-8", because a caller that knows the answer passes the boolean.
+ */
+export function verifiedContentType(mimeType, utf8Verified) {
+    const type = normalisedType(mimeType);
+    if (!utf8Verified)
+        return type;
+    if (!needsUtf8Verdict(type))
+        return type;
     return `${type}; charset=utf-8`;
 }
+const normalisedType = (mimeType) => (mimeType ?? '').trim() || 'application/octet-stream';
+/**
+ * The verdict to STORE for a file being written. `null` when the type could not be changed by one
+ * (an image, an archive, or a type whose author already named a charset), so nothing is computed
+ * and nothing is recorded.
+ *
+ * Called by each storage provider from createStorageFile, which is the one door every write goes
+ * through — sixteen call sites create files and none of them should have to know this rule exists.
+ */
+export function utf8VerdictFor(file) {
+    if (!needsUtf8Verdict(file.mimeType))
+        return null;
+    return isValidUtf8(file.data);
+}
 //# sourceMappingURL=app-content-type.js.map

package/dist/src/utils/app-content-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-content-type.js","sourceRoot":"","sources":["../../../src/utils/app-content-type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,uGAAuG;AACvG,MAAM,OAAO,GAAG,yFAAyF,CAAC;AAE1G;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,QAAmC;IAChE,MAAM,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,0BAA0B,CAAC;IACnE,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,GAAG,IAAI,iBAAiB,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAmC,EACnC,KAA6C;IAE7C,MAAM,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,0BAA0B,CAAC;IACnE,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,CAAC;QACH,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,6FAA6F;QAC7F,uDAAuD;QACvD,OAAO,IAAI,CAAC,CAAG,wDAAwD;IACzE,CAAC;IACD,OAAO,GAAG,IAAI,iBAAiB,CAAC;AAClC,CAAC"}
+{"version":3,"file":"app-content-type.js","sourceRoot":"","sources":["../../../src/utils/app-content-type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AAEH,uGAAuG;AACvG,MAAM,OAAO,GAAG,yFAAyF,CAAC;AAE1G;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,QAAmC;IAChE,MAAM,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,0BAA0B,CAAC;IACnE,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,GAAG,IAAI,iBAAiB,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAmC,EACnC,KAA6C;IAE7C,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC;QAAE,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjE,IAAI,CAAC,KAAK;QAAE,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,mBAAmB,CAAC,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAmC;IAClE,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAChD,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAA0B;IACpD,IAAI,CAAC;QACH,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,+FAA+F;QAC/F,8FAA8F;QAC9F,4FAA4F;QAC5F,6FAA6F;QAC7F,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAmC,EAAE,YAAwC;IAC/G,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,GAAG,IAAI,iBAAiB,CAAC;AAClC,CAAC;AAED,MAAM,cAAc,GAAG,CAAC,QAAmC,EAAU,EAAE,CACrE,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,0BAA0B,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAAqD;IAClF,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC"}

package/dist/src/utils/env-config/sections-features.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sections-features.d.ts","sourceRoot":"","sources":["../../../../src/utils/env-config/sections-features.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,EAAE,CAygBrE"}
+{"version":3,"file":"sections-features.d.ts","sourceRoot":"","sources":["../../../../src/utils/env-config/sections-features.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,EAAE,CA+gBrE"}

package/dist/src/utils/env-config/sections-features.js

@@ -22,9 +22,15 @@ export function featureSections(config) {
                 },
                 {
                     envVar: 'AIMEAT_CONTENT_SIGNAL',
-                    description: 'robots.txt Content Signals Policy directive (contentsignals.org); "off" removes it',
-                    value: config.contentSignal,
-                    defaultVal: 'search=yes, ai-input=yes, ai-train=no',
+                    description: 'robots.txt Content Signals Policy directive (contentsignals.org); "off" removes it. Empty pairs it to AIMEAT_AI_TRAINING',
+                    value: config.contentSignal || '(paired to AIMEAT_AI_TRAINING)',
+                    defaultVal: '(paired)',
+                },
+                {
+                    envVar: 'AIMEAT_AI_TRAINING',
+                    description: 'Allow the AI training crawlers (GPTBot, ClaudeBot, Google-Extended, Applebot-Extended, meta-externalagent) in robots.txt. Search and retrieval bots are always allowed and are not affected',
+                    value: config.aiTraining,
+                    defaultVal: 'deny',
                 },
             ],
         },

package/dist/src/utils/env-config/sections-features.js.map

@@ -1 +1 @@
-{"version":3,"file":"sections-features.js","sourceRoot":"","sources":["../../../../src/utils/env-config/sections-features.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sections-features.js","sourceRoot":"","sources":["../../../../src/utils/env-config/sections-features.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/file-download-headers.d.ts

@@ -59,13 +59,15 @@ export declare function isInlineSafeFileType(mimeType: string | undefined | null
  * The caller still sets `Content-Length` (or `Content-Range`), caching and any CORS headers: those
  * depend on which door the file came through, and these four do not.
  *
- * Pass the WHOLE file as `data`, even when replying with a range. The content type is sniffed from
- * it, and a multi-byte character straddling a range boundary would fail a decode of the slice while
- * the file itself is good UTF-8.
+ * Pass `utf8Verified` when the record carries it — a metadata read has it and a range reply cannot
+ * sniff. Otherwise pass the WHOLE file as `data`, even when replying with a range: the content type
+ * is sniffed from it, and a multi-byte character straddling a range boundary would fail a decode of
+ * the slice while the file itself is good UTF-8.
  */
 export declare function setStoredFileHeaders(res: Response, file: {
     key: string;
     mimeType: string;
     data?: Buffer | Uint8Array | null;
+    utf8Verified?: boolean;
 }): void;
 //# sourceMappingURL=file-download-headers.d.ts.map

package/dist/src/utils/file-download-headers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-download-headers.d.ts","sourceRoot":"","sources":["../../../src/utils/file-download-headers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAejF;AAuCD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAChC,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAA;CAAE,GAC3E,IAAI,CASN"}
+{"version":3,"file":"file-download-headers.d.ts","sourceRoot":"","sources":["../../../src/utils/file-download-headers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAejF;AAuCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAChC,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACnG,IAAI,CAqBN"}

package/dist/src/utils/file-download-headers.js

@@ -1,4 +1,4 @@
-import { sniffedContentType } from './app-content-type.js';
+import { sniffedContentType, verifiedContentType } from './app-content-type.js';
 /**
  * Everything a stored file may be rendered as when someone navigates to it. Read the reasoning in
  * the file header before adding to it: a type belongs here only when a browser CANNOT run script
@@ -71,13 +71,26 @@ function dispositionValue(disposition, filename) {
  * The caller still sets `Content-Length` (or `Content-Range`), caching and any CORS headers: those
  * depend on which door the file came through, and these four do not.
  *
- * Pass the WHOLE file as `data`, even when replying with a range. The content type is sniffed from
- * it, and a multi-byte character straddling a range boundary would fail a decode of the slice while
- * the file itself is good UTF-8.
+ * Pass `utf8Verified` when the record carries it — a metadata read has it and a range reply cannot
+ * sniff. Otherwise pass the WHOLE file as `data`, even when replying with a range: the content type
+ * is sniffed from it, and a multi-byte character straddling a range boundary would fail a decode of
+ * the slice while the file itself is good UTF-8.
  */
 export function setStoredFileHeaders(res, file) {
     const inline = isInlineSafeFileType(file.mimeType);
-    res.setHeader('Content-Type', sniffedContentType(file.mimeType, file.data));
+    // A stored verdict WINS over the bytes in hand, and that ordering is the point: a range response
+    // holds a slice, and sniffing a slice can disagree with the full GET when a multi-byte character
+    // straddles the boundary. The verdict is a property of the file, so both responses name the same
+    // type. Only a file written before the verdict existed falls through to reading the bytes.
+    //
+    // An EMPTY `data` is treated as "no bytes were supplied" rather than as an empty file, and that
+    // is not pedantry: a metadata-only record carries a zero-length buffer, zero bytes decode as
+    // valid UTF-8, and the sniffer would cheerfully stamp `charset=utf-8` on a file it has never
+    // seen. A genuinely empty file loses nothing by not being told which encoding its no bytes are in.
+    const supplied = file.data && file.data.length > 0 ? file.data : null;
+    res.setHeader('Content-Type', file.utf8Verified === undefined
+        ? sniffedContentType(file.mimeType, supplied)
+        : verifiedContentType(file.mimeType, file.utf8Verified));
     res.setHeader('X-Content-Type-Options', 'nosniff');
     res.setHeader('Content-Security-Policy', inline ? CSP_INLINE : CSP_ATTACHMENT);
     // The key is an address, so its last segment is the closest thing to a filename we have; a key

package/dist/src/utils/file-download-headers.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-download-headers.js","sourceRoot":"","sources":["../../../src/utils/file-download-headers.ts"],"names":[],"mappings":"AA4CA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAmC;IACpE,MAAM,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjE,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,iGAAiG;IACjG,2EAA2E;IAC3E,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACxE,4FAA4F;IAC5F,+FAA+F;IAC/F,8BAA8B;IAC9B,IAAI,IAAI,KAAK,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAC5C,6FAA6F;IAC7F,+DAA+D;IAC/D,IAAI,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,cAAc,GAAG,0FAA0F,CAAC;AAElH;;;;;;;;;GASG;AACH,MAAM,UAAU,GAAG,mLAAmL,CAAC;AAEvM;;;;;;;;;GASG;AACH,SAAS,gBAAgB,CAAC,WAAoC,EAAE,QAAgB;IAC5E,IAAI,CAAC,QAAQ;QAAE,OAAO,WAAW,CAAC;IAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACpH,OAAO,GAAG,WAAW,eAAe,KAAK,uBAAuB,IAAI,EAAE,CAAC;AAC3E,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAChC,GAAa,EACb,IAA0E;IAE1E,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnD,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,GAAG,CAAC,SAAS,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAC;IACnD,GAAG,CAAC,SAAS,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;IAC/E,+FAA+F;IAC/F,qFAAqF;IACrF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAC/E,GAAG,CAAC,SAAS,CAAC,qBAAqB,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;AACvG,CAAC"}
+{"version":3,"file":"file-download-headers.js","sourceRoot":"","sources":["../../../src/utils/file-download-headers.ts"],"names":[],"mappings":"AA4CA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEhF;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAmC;IACpE,MAAM,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjE,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,iGAAiG;IACjG,2EAA2E;IAC3E,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACxE,4FAA4F;IAC5F,+FAA+F;IAC/F,8BAA8B;IAC9B,IAAI,IAAI,KAAK,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAC5C,6FAA6F;IAC7F,+DAA+D;IAC/D,IAAI,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,cAAc,GAAG,0FAA0F,CAAC;AAElH;;;;;;;;;GASG;AACH,MAAM,UAAU,GAAG,mLAAmL,CAAC;AAEvM;;;;;;;;;GASG;AACH,SAAS,gBAAgB,CAAC,WAAoC,EAAE,QAAgB;IAC5E,IAAI,CAAC,QAAQ;QAAE,OAAO,WAAW,CAAC;IAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACpH,OAAO,GAAG,WAAW,eAAe,KAAK,uBAAuB,IAAI,EAAE,CAAC;AAC3E,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAChC,GAAa,EACb,IAAkG;IAElG,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnD,iGAAiG;IACjG,iGAAiG;IACjG,iGAAiG;IACjG,2FAA2F;IAC3F,EAAE;IACF,gGAAgG;IAChG,6FAA6F;IAC7F,6FAA6F;IAC7F,mGAAmG;IACnG,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACtE,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,CAAC,YAAY,KAAK,SAAS;QACzD,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC7C,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IAC7D,GAAG,CAAC,SAAS,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAC;IACnD,GAAG,CAAC,SAAS,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;IAC/E,+FAA+F;IAC/F,qFAAqF;IACrF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAC/E,GAAG,CAAC,SAAS,CAAC,qBAAqB,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;AACvG,CAAC"}

package/dist/src/utils/http-range.d.ts

@@ -0,0 +1,151 @@
+/**
+ * @file src/utils/http-range.ts
+ * @description HTTP byte-range parsing for the stored-file download paths, in one place.
+ *
+ *   WHAT WAS WRONG. Three download handlers each carried the same four lines, and those four lines
+ *   were `/bytes=(\d+)-(\d*)/`. That regex does not match `bytes=-8` — the SUFFIX range, which is
+ *   exactly the request a Parquet reader makes first, because the footer is at the end of the file.
+ *   A client asking for the last eight bytes got status 200 and the whole file, with no header
+ *   anywhere saying the request had not been honoured. That is a silent fallback: the reader
+ *   believes it is streaming and is in fact downloading everything, once per range it asks for.
+ *   The fourth path, `GET /v1/pub`, never looked at `Range` at all.
+ *
+ *   And no path ever sent `Accept-Ranges`. A client cannot discover range support by guessing, so
+ *   DuckDB, pandas and every HTTP range reader concluded the node does not do ranges — correctly,
+ *   from the evidence they had.
+ *
+ *   THE RULES THIS ENCODES, and why each one is what it is:
+ *
+ *   - `bytes=N-M`, `bytes=N-` and `bytes=-N` all parse. `M` past the end clamps to the last byte,
+ *     which RFC 9110 §14.1.2 requires; `-N` larger than the file means the whole file, same clause.
+ *   - A range unit that is NOT `bytes` is IGNORED and the full representation is sent. RFC 9110
+ *     §14.2 says MUST on this, and it is not a covering fallback: `Accept-Ranges: bytes` on the
+ *     same response has already told the client which unit this server speaks.
+ *   - A `bytes=` header that does not parse, or that starts past the end of the file, is
+ *     UNSATISFIABLE. That answers 416 with a `Content-Range` of `bytes STAR/size`, never a 200. This is
+ *     the case the old regex covered up.
+ *   - A MULTI-range request (`bytes=0-9, 20-29`) is refused with 416 rather than served as one
+ *     coalesced span or silently reduced to its first range. A `multipart/byteranges` body is not
+ *     implemented here, and answering a two-range request with one range's bytes, under a status
+ *     code that claims the request was honoured, is the same class of defect this file exists to
+ *     remove. No stored-file client on this node sends one.
+ * @structure parseRangeHeader() — the verdict · sendPartialContent() / setAcceptRanges() /
+ *   rangeNotSatisfiable() — the three response shapes a door needs · serveStoredFile() — all three,
+ *   plus the read, in the one order that does not load a file to send part of it
+ * @usage
+ *   const file = await storage.getStorageFileMeta(gaii, key);      // no bytes yet
+ *   if (!file) { …404… }
+ *   res.setHeader('Cache-Control', 'public, max-age=300');          // this door's own headers first
+ *   const served = await serveStoredFile(res, file, req.headers.range, {
+ *       range: (start, length) => storage.readStorageFileRange(gaii, key, start, length),
+ *       all: () => storage.getStorageFile(gaii, key).then(f => f?.data ?? null),
+ *   });
+ *   if (!served) { …404… }                                         // it vanished mid-request
+ * @version-history
+ *   v1.1.0 -- 2026-08-15 -- TARGET-063: serveStoredFile(), so a range is read as a range. The four
+ *     doors each carried the same three-line dance and each began by loading the whole file.
+ *   v1.0.0 -- 2026-08-15 -- TARGET-063 A1: extracted from the three copies in routes/storage-files.ts,
+ *     with suffix ranges, 416 and Accept-Ranges added. GET /v1/pub gains range support for the first
+ *     time; it is the door a program reading a data package from its permanent address knocks at.
+ */
+import type { Response } from 'express';
+/** What a `Range` header means for one representation of a known size. */
+export type RangeVerdict = 
+/** No usable range: absent header, or a unit this server does not speak. Send the whole thing, 200. */
+{
+    kind: 'full';
+}
+/** Inclusive byte offsets into the representation. Send 206. */
+ | {
+    kind: 'partial';
+    start: number;
+    end: number;
+}
+/** The header named `bytes` and could not be honoured. Send 416 — never 200. */
+ | {
+    kind: 'unsatisfiable';
+    reason: string;
+};
+/**
+ * Decide what a `Range` header asks for.
+ *
+ * `size` is the complete length of the representation. A zero-length file makes every byte range
+ * unsatisfiable, which is what RFC 9110 §15.5.17 describes and what a client needs to hear rather
+ * than a 200 with no bytes and a status that says it was a partial answer.
+ */
+export declare function parseRangeHeader(header: string | undefined | null, size: number): RangeVerdict;
+/**
+ * Announce range support. Belongs on EVERY response that carries (or describes) stored bytes,
+ * including the 200 and the HEAD: a client decides whether to range-read from this header, and a
+ * server that answers ranges without advertising them is a server nothing ranges against.
+ */
+export declare function setAcceptRanges(res: Response): void;
+/**
+ * 416 with the one header that makes it actionable: a `Content-Range` of `bytes STAR/size` tells the
+ * client how long the representation actually is, so its next request can be a valid one.
+ *
+ * Deliberately NOT the envelope. This is a byte-serving path, the caller may be a database engine
+ * rather than a browser, and the status plus Content-Range is the whole message.
+ */
+export declare function rangeNotSatisfiable(res: Response, size: number, reason: string): void;
+/**
+ * 206 with the slice.
+ *
+ * `chunk` is the slice and `file` describes the WHOLE representation, which is the distinction the
+ * Content-Range header itself makes. `setStoredFileHeaders` follows the same rule: it takes the
+ * file's stored UTF-8 verdict when there is one, so this response names the same content type the
+ * full GET does. Sniffing the slice would not — a multi-byte character straddling the boundary
+ * fails a decode that the whole file passes.
+ */
+export declare function sendPartialContent(res: Response, file: {
+    key: string;
+    mimeType: string;
+    size: number;
+    data?: Buffer;
+    utf8Verified?: boolean;
+}, range: {
+    start: number;
+    end: number;
+}, chunk: Buffer): void;
+/**
+ * Does naming this file's content type still require reading it?
+ *
+ * Only for a row written before the UTF-8 verdict was recorded, and only for a type whose served
+ * form the verdict would change. Everything written since answers from metadata alone, and this
+ * shrinks to nothing as old rows are rewritten.
+ */
+export declare function needsBytesForType(file: {
+    mimeType: string;
+    utf8Verified?: boolean;
+}): boolean;
+/** How a door gets at the bytes it is about to serve. Both halves come from the storage layer, and
+ *  a range read never touches the rest of the file. */
+export interface StoredFileReader {
+    /** `length` bytes from byte offset `start`. Null only if the file has disappeared. */
+    range(start: number, length: number): Promise<Buffer | null>;
+    /** The whole representation. Null only if the file has disappeared. */
+    all(): Promise<Buffer | null>;
+}
+/**
+ * Serve one stored file, honouring `Range`, from METADATA plus a reader.
+ *
+ * WHY THE READER IS A CALLBACK AND NOT A BUFFER. Every door here used to load the entire file and
+ * then decide what part of it to send, which meant an eight-byte suffix request — the first thing a
+ * Parquet reader asks for — read 25 MB out of the database to answer it. Measured on Postgres:
+ * 181 ms that way, 3 ms as a database-side substring, and the gap widens with the file. Taking the
+ * reader rather than the bytes is what lets the decision come BEFORE the read.
+ *
+ * The caller sets its own caching and CORS headers first; they differ per door and these do not.
+ * Returns false when the file vanished between the metadata read and the bytes, and sends nothing —
+ * the caller owns the 404 because only it knows which shape of "not found" that door tells.
+ */
+export declare function serveStoredFile(res: Response, file: {
+    key: string;
+    mimeType: string;
+    size: number;
+    utf8Verified?: boolean;
+    createdAt?: string;
+}, rangeHeader: string | undefined, read: StoredFileReader, opts?: {
+    headOnly?: boolean;
+}): Promise<boolean>;
+//# sourceMappingURL=http-range.d.ts.map

package/dist/src/utils/http-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-range.d.ts","sourceRoot":"","sources":["../../../src/utils/http-range.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC,0EAA0E;AAC1E,MAAM,MAAM,YAAY;AACpB,uGAAuG;AACrG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;AAClB,gEAAgE;GAC9D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE;AACjD,gFAAgF;GAC9E;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAyC9F;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAEnD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAMrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAC9B,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,EAC5F,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACrC,KAAK,EAAE,MAAM,GACd,IAAI,CAON;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAE7F;AAED;uDACuD;AACvD,MAAM,WAAW,gBAAgB;IAC7B,sFAAsF;IACtF,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7D,uEAAuE;IACvE,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CACjC,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EACjG,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,IAAI,EAAE,gBAAgB,EACtB,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,OAAO,CAAC,OAAO,CAAC,CAoElB"}

package/dist/src/utils/http-range.js

@@ -0,0 +1,190 @@
+import { setStoredFileHeaders } from './file-download-headers.js';
+import { needsUtf8Verdict } from './app-content-type.js';
+/**
+ * Decide what a `Range` header asks for.
+ *
+ * `size` is the complete length of the representation. A zero-length file makes every byte range
+ * unsatisfiable, which is what RFC 9110 §15.5.17 describes and what a client needs to hear rather
+ * than a 200 with no bytes and a status that says it was a partial answer.
+ */
+export function parseRangeHeader(header, size) {
+    const raw = (header ?? '').trim();
+    if (!raw)
+        return { kind: 'full' };
+    // A unit we do not speak. RFC 9110 §14.2: ignore it and answer with the full representation.
+    // `Accept-Ranges: bytes` is on that same response, so the client is not left guessing.
+    if (!/^bytes\s*=/i.test(raw))
+        return { kind: 'full' };
+    const spec = raw.slice(raw.indexOf('=') + 1).trim();
+    if (spec.includes(',')) {
+        return {
+            kind: 'unsatisfiable',
+            reason: 'This server serves one byte range per request. A multipart/byteranges response is '
+                + 'not implemented, and answering part of what was asked under a success status would '
+                + 'hide that. Ask for one range at a time.',
+        };
+    }
+    // suffix-byte-range-spec: "-N" — the LAST N bytes. The shape a Parquet reader opens with.
+    const suffix = /^-(\d+)$/.exec(spec);
+    if (suffix) {
+        const wanted = parseInt(suffix[1], 10);
+        if (!Number.isFinite(wanted) || wanted <= 0 || size === 0) {
+            return { kind: 'unsatisfiable', reason: `suffix range "${spec}" against a ${size}-byte representation` };
+        }
+        // Asking for more than there is means the whole thing (RFC 9110 §14.1.2), not an error.
+        return { kind: 'partial', start: Math.max(0, size - wanted), end: size - 1 };
+    }
+    // int-byte-range-spec: "N-" or "N-M".
+    const explicit = /^(\d+)-(\d*)$/.exec(spec);
+    if (!explicit) {
+        return { kind: 'unsatisfiable', reason: `unparseable byte range "${spec}"` };
+    }
+    const start = parseInt(explicit[1], 10);
+    // An absent last-byte-pos means "to the end"; one past the end clamps to the last byte.
+    const end = explicit[2] === '' ? size - 1 : Math.min(parseInt(explicit[2], 10), size - 1);
+    if (!Number.isFinite(start) || size === 0 || start >= size || end < start) {
+        return { kind: 'unsatisfiable', reason: `byte range "${spec}" against a ${size}-byte representation` };
+    }
+    return { kind: 'partial', start, end };
+}
+/**
+ * Announce range support. Belongs on EVERY response that carries (or describes) stored bytes,
+ * including the 200 and the HEAD: a client decides whether to range-read from this header, and a
+ * server that answers ranges without advertising them is a server nothing ranges against.
+ */
+export function setAcceptRanges(res) {
+    res.setHeader('Accept-Ranges', 'bytes');
+}
+/**
+ * 416 with the one header that makes it actionable: a `Content-Range` of `bytes STAR/size` tells the
+ * client how long the representation actually is, so its next request can be a valid one.
+ *
+ * Deliberately NOT the envelope. This is a byte-serving path, the caller may be a database engine
+ * rather than a browser, and the status plus Content-Range is the whole message.
+ */
+export function rangeNotSatisfiable(res, size, reason) {
+    res.status(416);
+    setAcceptRanges(res);
+    res.setHeader('Content-Range', `bytes */${size}`);
+    res.setHeader('Content-Type', 'text/plain; charset=utf-8');
+    res.end(`416 Range Not Satisfiable: ${reason}\n`);
+}
+/**
+ * 206 with the slice.
+ *
+ * `chunk` is the slice and `file` describes the WHOLE representation, which is the distinction the
+ * Content-Range header itself makes. `setStoredFileHeaders` follows the same rule: it takes the
+ * file's stored UTF-8 verdict when there is one, so this response names the same content type the
+ * full GET does. Sniffing the slice would not — a multi-byte character straddling the boundary
+ * fails a decode that the whole file passes.
+ */
+export function sendPartialContent(res, file, range, chunk) {
+    res.status(206);
+    setStoredFileHeaders(res, file);
+    setAcceptRanges(res);
+    res.setHeader('Content-Range', `bytes ${range.start}-${range.end}/${file.size}`);
+    res.setHeader('Content-Length', chunk.length);
+    res.end(chunk);
+}
+/**
+ * Does naming this file's content type still require reading it?
+ *
+ * Only for a row written before the UTF-8 verdict was recorded, and only for a type whose served
+ * form the verdict would change. Everything written since answers from metadata alone, and this
+ * shrinks to nothing as old rows are rewritten.
+ */
+export function needsBytesForType(file) {
+    return file.utf8Verified === undefined && needsUtf8Verdict(file.mimeType);
+}
+/**
+ * Serve one stored file, honouring `Range`, from METADATA plus a reader.
+ *
+ * WHY THE READER IS A CALLBACK AND NOT A BUFFER. Every door here used to load the entire file and
+ * then decide what part of it to send, which meant an eight-byte suffix request — the first thing a
+ * Parquet reader asks for — read 25 MB out of the database to answer it. Measured on Postgres:
+ * 181 ms that way, 3 ms as a database-side substring, and the gap widens with the file. Taking the
+ * reader rather than the bytes is what lets the decision come BEFORE the read.
+ *
+ * The caller sets its own caching and CORS headers first; they differ per door and these do not.
+ * Returns false when the file vanished between the metadata read and the bytes, and sends nothing —
+ * the caller owns the 404 because only it knows which shape of "not found" that door tells.
+ */
+export async function serveStoredFile(res, file, rangeHeader, read, opts = {}) {
+    // A validator, on every representation of the file. A ranged reader keeps one of these between
+    // requests to know the bytes did not move under it, and DuckDB reads Last-Modified straight off
+    // the probe. It costs nothing: the write time is already in the metadata.
+    if (file.createdAt) {
+        const at = new Date(file.createdAt);
+        if (!Number.isNaN(at.getTime()))
+            res.setHeader('Last-Modified', at.toUTCString());
+    }
+    // ONE decision, made before anything is sent: can this file's content type be named without its
+    // bytes? With a stored verdict, yes, and nothing outside the requested range is ever read. For a
+    // file written before the verdict existed the charset still lives in the content, so the whole
+    // file is read — the same cost as before this change, paid only by rows that predate it, and
+    // gone the next time each one is written.
+    //
+    // Getting this wrong is not a slow response but a false one. An earlier draft passed the
+    // metadata record straight through, and its `data` is an EMPTY buffer: the sniffer decoded zero
+    // bytes, found them valid UTF-8, and stamped `charset=utf-8` on a range reply. On a genuinely
+    // cp1252 file that declares an encoding the file does not have, over a GET of the same file that
+    // correctly declares nothing.
+    const whole = needsBytesForType(file) ? await read.all() : null;
+    if (needsBytesForType(file) && !whole)
+        return false;
+    const described = whole ? { ...file, data: whole } : file;
+    const verdict = parseRangeHeader(rangeHeader, file.size);
+    // A HEAD answers out of the metadata and reads nothing more. Express auto-handles HEAD through
+    // the GET handler, so /v1/pub was loading the entire file and discarding the body: 114 ms
+    // measured, for a 10 MB file, to send zero bytes.
+    //
+    // IT STILL HONOURS `Range`, and that is not pedantry about RFC 9110's "same headers a GET would
+    // send". A HEAD carrying `Range: bytes=0-` is how a client ASKS whether this server does ranges,
+    // and DuckDB-Wasm's own words for the answer are `if (contentLength !== null && status == 206)`.
+    // An earlier version of this function short-circuited before reading the Range header, so that
+    // probe got 200 and the full length. DuckDB read it as "no ranges here" and downloaded an 8.45 MB
+    // Parquet file in one request to answer a two-column aggregate — and with full reads disabled it
+    // refused to open the file at all. A fast HEAD that lies about ranges is worse than a slow one.
+    if (opts.headOnly) {
+        if (verdict.kind === 'unsatisfiable') {
+            rangeNotSatisfiable(res, file.size, verdict.reason);
+            return true;
+        }
+        setStoredFileHeaders(res, described);
+        setAcceptRanges(res);
+        if (verdict.kind === 'partial') {
+            res.status(206);
+            res.setHeader('Content-Range', `bytes ${verdict.start}-${verdict.end}/${file.size}`);
+            res.setHeader('Content-Length', verdict.end - verdict.start + 1);
+        }
+        else {
+            res.setHeader('Content-Length', file.size);
+        }
+        res.end();
+        return true;
+    }
+    if (verdict.kind === 'unsatisfiable') {
+        rangeNotSatisfiable(res, file.size, verdict.reason);
+        return true;
+    }
+    if (verdict.kind === 'partial') {
+        // When the file is already in hand there is nothing to gain from asking the database for a
+        // slice of it, so the second read is skipped rather than repeated.
+        const chunk = whole
+            ? whole.subarray(verdict.start, verdict.end + 1)
+            : await read.range(verdict.start, verdict.end - verdict.start + 1);
+        if (!chunk)
+            return false;
+        sendPartialContent(res, described, verdict, chunk);
+        return true;
+    }
+    const data = whole ?? await read.all();
+    if (!data)
+        return false;
+    setStoredFileHeaders(res, { ...described, data });
+    setAcceptRanges(res);
+    res.setHeader('Content-Length', file.size);
+    res.end(data);
+    return true;
+}
+//# sourceMappingURL=http-range.js.map