@proteinjs/db-file 1.8.3 → 1.9.0

package/dist/src/FileStorage.js.map

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

package/dist/src/FileStorageDriver.d.ts

@@ -6,6 +6,17 @@ import { File } from './tables/FileTable';
  * file's true bytes — for text and binary files alike. Drivers own their at-rest representation,
  * with one hard requirement: a driver that serves blobs directly to clients (`getSignedUrl`)
  * MUST store the true bytes at rest, because clients read its objects without any decode step.
+ *
+ * Error contract: a failed byte operation throws a {@link FileStorageError} — a code, a plain
+ * message and the store's HTTP status where it has one — and NEVER the store client's own error
+ * object or anything hanging off one (a request config, a request, a response, headers, a signed
+ * URL): a client's error holds the request it made, and that request holds the driver's
+ * credentials, so an application logging what it caught would write a live credential. Bytes that
+ * are not there are reported as the `not-found` code on every read and overwrite, so callers
+ * branch on one thing whichever driver is behind them (`deleteFile` alone treats missing bytes as
+ * success — see its contract). A driver whose store IS the application's database
+ * (`DbFileStorageDriver`) lets the database layer's own errors through unchanged: they are
+ * already that layer's owned errors, and a transaction runner must see them to retry.
  */
 export interface FileStorageDriver {
     createFile(file: File, fileData: string): Promise<void>;

package/dist/src/FileStorageDriver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileStorageDriver.d.ts","sourceRoot":"","sources":["../../src/FileStorageDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;;;;OAMG;IACH,YAAY,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7E;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C"}
+{"version":3,"file":"FileStorageDriver.d.ts","sourceRoot":"","sources":["../../src/FileStorageDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAG1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;;;;OAMG;IACH,YAAY,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7E;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C"}

package/dist/src/FileStorageError.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Why a byte operation failed — the closed set a caller branches on.
+ *
+ * - `not-found`: the stored bytes for that file id are not there.
+ * - `precondition-failed`: the store refused a conditional write (the object changed underneath it).
+ * - `forbidden`: the store refused the driver's credentials or permissions.
+ * - `unavailable`: the store could not be reached or asked to be retried later.
+ * - `unknown`: anything else.
+ */
+export type FileStorageErrorCode = 'not-found' | 'precondition-failed' | 'forbidden' | 'unavailable' | 'unknown';
+/**
+ * THE error a {@link FileStorageDriver} throws — the only thing that leaves a driver when a byte
+ * operation fails.
+ *
+ * It carries three plain facts and nothing else: a {@link FileStorageErrorCode}, a one-line
+ * message, and the HTTP status where the store speaks HTTP. It NEVER carries the store client's own
+ * error object, nor anything hanging off one — a request config, a request, a response, headers, a
+ * signed URL. A store client's error routinely holds the request it made, and that request holds
+ * the driver's credentials (an `Authorization` header); an application that logs the error it
+ * caught would write a live credential into its logs. The driver is the only party that talks to
+ * the store, so the driver owns what its errors carry, and no caller has to know to strip one.
+ *
+ * Callers branch on `code` — through {@link FileStorageError.is} / {@link FileStorageError.isNotFound},
+ * which read the error's shape rather than its prototype, so they hold across duplicate copies of
+ * this package in one process.
+ */
+export declare class FileStorageError extends Error {
+    private static readonly NAME;
+    private static readonly CODES;
+    /** Free text that reaches a message is one line and bounded. */
+    private static readonly MAX_DETAIL_CHARS;
+    readonly code: FileStorageErrorCode;
+    /** The store's HTTP status, where it has one. */
+    readonly status?: number;
+    /**
+     * @param code what went wrong, for callers to branch on
+     * @param summary the driver's own words for the failed operation (e.g. `getFileData failed for file <id>`)
+     * @param options.status the store's HTTP status, where it has one
+     * @param options.detail the store's own message text — made plain (see {@link plain}) before it is kept
+     */
+    constructor(code: FileStorageErrorCode, summary: string, options?: {
+        status?: number;
+        detail?: unknown;
+    });
+    /** Is this a driver's error? Read by shape, so it holds across duplicate copies of this package. */
+    static is(error: unknown): error is FileStorageError;
+    /** The stored bytes for that file id are not there. */
+    static isNotFound(error: unknown): boolean;
+    /**
+     * The code an HTTP status means. Drivers whose store speaks HTTP share this table so one status
+     * never reads two ways.
+     */
+    static codeForStatus(status: number | undefined): FileStorageErrorCode;
+    private static describe;
+    /**
+     * A store's message text made safe to keep: text only (an object is never read into it), one
+     * line, bounded, with every URL's query string dropped (a signed URL's signature lives there)
+     * and any bearer credential masked.
+     */
+    private static plain;
+}
+//# sourceMappingURL=FileStorageError.d.ts.map

package/dist/src/FileStorageError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileStorageError.d.ts","sourceRoot":"","sources":["../../src/FileStorageError.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,qBAAqB,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;AAEjH;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAsB;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAM3B;IACF,gEAAgE;IAChE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAO;IAE/C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,iDAAiD;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;gBACS,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE;IAUxG,oGAAoG;IACpG,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB;IAQpD,uDAAuD;IACvD,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAI1C;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,oBAAoB;IAgBtE,OAAO,CAAC,MAAM,CAAC,QAAQ;IAUvB;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,KAAK;CAcrB"}

package/dist/src/FileStorageError.js

@@ -0,0 +1,118 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileStorageError = void 0;
+/**
+ * THE error a {@link FileStorageDriver} throws — the only thing that leaves a driver when a byte
+ * operation fails.
+ *
+ * It carries three plain facts and nothing else: a {@link FileStorageErrorCode}, a one-line
+ * message, and the HTTP status where the store speaks HTTP. It NEVER carries the store client's own
+ * error object, nor anything hanging off one — a request config, a request, a response, headers, a
+ * signed URL. A store client's error routinely holds the request it made, and that request holds
+ * the driver's credentials (an `Authorization` header); an application that logs the error it
+ * caught would write a live credential into its logs. The driver is the only party that talks to
+ * the store, so the driver owns what its errors carry, and no caller has to know to strip one.
+ *
+ * Callers branch on `code` — through {@link FileStorageError.is} / {@link FileStorageError.isNotFound},
+ * which read the error's shape rather than its prototype, so they hold across duplicate copies of
+ * this package in one process.
+ */
+var FileStorageError = /** @class */ (function (_super) {
+    __extends(FileStorageError, _super);
+    /**
+     * @param code what went wrong, for callers to branch on
+     * @param summary the driver's own words for the failed operation (e.g. `getFileData failed for file <id>`)
+     * @param options.status the store's HTTP status, where it has one
+     * @param options.detail the store's own message text — made plain (see {@link plain}) before it is kept
+     */
+    function FileStorageError(code, summary, options) {
+        var _this = _super.call(this, FileStorageError.describe(code, summary, options)) || this;
+        _this.name = FileStorageError.NAME;
+        Object.setPrototypeOf(_this, FileStorageError.prototype);
+        _this.code = code;
+        if ((options === null || options === void 0 ? void 0 : options.status) !== undefined) {
+            _this.status = options.status;
+        }
+        return _this;
+    }
+    /** Is this a driver's error? Read by shape, so it holds across duplicate copies of this package. */
+    FileStorageError.is = function (error) {
+        var candidate = error;
+        return ((candidate === null || candidate === void 0 ? void 0 : candidate.name) === FileStorageError.NAME &&
+            FileStorageError.CODES.includes(candidate.code));
+    };
+    /** The stored bytes for that file id are not there. */
+    FileStorageError.isNotFound = function (error) {
+        return FileStorageError.is(error) && error.code === 'not-found';
+    };
+    /**
+     * The code an HTTP status means. Drivers whose store speaks HTTP share this table so one status
+     * never reads two ways.
+     */
+    FileStorageError.codeForStatus = function (status) {
+        if (status === 404) {
+            return 'not-found';
+        }
+        if (status === 412) {
+            return 'precondition-failed';
+        }
+        if (status === 401 || status === 403) {
+            return 'forbidden';
+        }
+        if (status === 408 || status === 429 || (status !== undefined && status >= 500 && status <= 599)) {
+            return 'unavailable';
+        }
+        return 'unknown';
+    };
+    FileStorageError.describe = function (code, summary, options) {
+        var status = (options === null || options === void 0 ? void 0 : options.status) !== undefined ? " (HTTP ".concat(options.status, ")") : '';
+        var detail = FileStorageError.plain(options === null || options === void 0 ? void 0 : options.detail);
+        return "".concat(summary, ": ").concat(code).concat(status).concat(detail ? " \u2014 ".concat(detail) : '');
+    };
+    /**
+     * A store's message text made safe to keep: text only (an object is never read into it), one
+     * line, bounded, with every URL's query string dropped (a signed URL's signature lives there)
+     * and any bearer credential masked.
+     */
+    FileStorageError.plain = function (detail) {
+        if (typeof detail !== 'string') {
+            return '';
+        }
+        var oneLine = detail
+            .replace(/\s+/g, ' ')
+            .replace(/(https?:\/\/[^\s?#]+)[?#]\S*/gi, '$1')
+            .replace(/\b(bearer|basic)\s+\S+/gi, '$1 [masked]')
+            .trim();
+        return oneLine.length > FileStorageError.MAX_DETAIL_CHARS
+            ? "".concat(oneLine.slice(0, FileStorageError.MAX_DETAIL_CHARS), "\u2026")
+            : oneLine;
+    };
+    FileStorageError.NAME = 'FileStorageError';
+    FileStorageError.CODES = [
+        'not-found',
+        'precondition-failed',
+        'forbidden',
+        'unavailable',
+        'unknown',
+    ];
+    /** Free text that reaches a message is one line and bounded. */
+    FileStorageError.MAX_DETAIL_CHARS = 300;
+    return FileStorageError;
+}(Error));
+exports.FileStorageError = FileStorageError;
+//# sourceMappingURL=FileStorageError.js.map

package/dist/src/FileStorageError.js.map

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

package/dist/src/FileVariantMaker.d.ts

@@ -0,0 +1,61 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { Loadable } from '@proteinjs/reflection';
+import { File } from './tables/FileTable';
+/**
+ * The kinds of derived File a file can carry — each a seat on the row (`File.preview`,
+ * `File.stage`) with one lifecycle: made once, named on the row, dropped when the original's
+ * bytes change, deleted with the original, readable by whoever can read the original.
+ */
+export type FileVariantKind = 'preview' | 'stage';
+export declare const FILE_VARIANT_KINDS: readonly FileVariantKind[];
+/** What the maker hands back for a variant: the bytes, their type, and the facts a consumer renders from without loading them. */
+export interface FileVariant {
+    bytes: Buffer;
+    type: string;
+    width?: number;
+    height?: number;
+}
+/**
+ * How a derived File of a File is made — ONE owner for "a variant of this file's bytes".
+ *
+ * The library owns the seat on the row, the lifecycle and the access rule for every variant
+ * (`FileStorage.deriveVariants` at ingest, `FileStorage.getVariant` on the read path); the one
+ * package that knows the file's format registers how the variant's bytes are made — a picture's
+ * 512 px thumbnail (`preview`) and its 1600 px rendition for the stage (`stage`) are two answers
+ * of the same maker, never two mechanisms. Dependency direction is the
+ * {@link FileReachabilityResolver} / {@link FileCopyForOthers} pattern: the interface here, the
+ * implementation above, discovered through the SourceRepository. With no maker registered no
+ * variant is ever made and every consumer draws the original.
+ */
+export interface FileVariantMaker extends Loadable {
+    /**
+     * Whether a variant of this kind is made of this file at all — decided from the row alone,
+     * never from its bytes (a document, a clip, a picture already small enough cost no read). True
+     * means {@link make} is called once with the original's bytes and its answer is stored.
+     */
+    appliesTo(file: File, kind: FileVariantKind): boolean;
+    /** The variant, made from the original's bytes. Throws when it cannot be made — nothing is stored, the consumer draws the original. */
+    make(file: File, bytes: Buffer, kind: FileVariantKind): Promise<FileVariant>;
+}
+export declare const getFileVariantMaker: () => FileVariantMaker | undefined;
+/**
+ * What a derivation becomes when the registered maker could not make the variant of these
+ * bytes: nothing is stored. Thrown by `FileStorage` in place of whatever the maker threw (the
+ * maker's own one-line reason kept as `reason`), so the ingest door can report it to the caller
+ * holding the bytes and the read path can tell it from a failure of the store or the database
+ * (and serve the file itself). Read by shape ({@link FileVariantNotMade.is}), like
+ * `FileCopyRefused`, so it holds across duplicate copies of this package.
+ */
+export declare class FileVariantNotMade extends Error {
+    private static readonly NAME;
+    /** Free text that reaches a message is one line and bounded. */
+    private static readonly MAX_REASON_CHARS;
+    readonly fileId: string;
+    readonly kind: FileVariantKind;
+    readonly reason: string;
+    constructor(fileId: string, kind: FileVariantKind, cause: unknown);
+    static is(error: unknown): error is FileVariantNotMade;
+    private static plain;
+}
+//# sourceMappingURL=FileVariantMaker.d.ts.map

package/dist/src/FileVariantMaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileVariantMaker.d.ts","sourceRoot":"","sources":["../../src/FileVariantMaker.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,QAAQ,EAAoB,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,CAAC;AAElD,eAAO,MAAM,kBAAkB,EAAE,SAAS,eAAe,EAAyB,CAAC;AAEnF,kIAAkI;AAClI,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC;IACtD,uIAAuI;IACvI,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC9E;AAED,eAAO,MAAM,mBAAmB,QAAO,gBAAgB,GAAG,SAC8B,CAAC;AAEzF;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAwB;IACpD,gEAAgE;IAChE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAO;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO;IAUjE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB;IAItD,OAAO,CAAC,MAAM,CAAC,KAAK;CAOrB"}

package/dist/src/FileVariantMaker.js

@@ -0,0 +1,62 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileVariantNotMade = exports.getFileVariantMaker = exports.FILE_VARIANT_KINDS = void 0;
+var reflection_1 = require("@proteinjs/reflection");
+exports.FILE_VARIANT_KINDS = ['preview', 'stage'];
+var getFileVariantMaker = function () {
+    return reflection_1.SourceRepository.get().object('@proteinjs/db-file/FileVariantMaker');
+};
+exports.getFileVariantMaker = getFileVariantMaker;
+/**
+ * What a derivation becomes when the registered maker could not make the variant of these
+ * bytes: nothing is stored. Thrown by `FileStorage` in place of whatever the maker threw (the
+ * maker's own one-line reason kept as `reason`), so the ingest door can report it to the caller
+ * holding the bytes and the read path can tell it from a failure of the store or the database
+ * (and serve the file itself). Read by shape ({@link FileVariantNotMade.is}), like
+ * `FileCopyRefused`, so it holds across duplicate copies of this package.
+ */
+var FileVariantNotMade = /** @class */ (function (_super) {
+    __extends(FileVariantNotMade, _super);
+    function FileVariantNotMade(fileId, kind, cause) {
+        var _this = this;
+        var reason = FileVariantNotMade.plain(cause);
+        _this = _super.call(this, "No ".concat(kind, " variant could be made of file ").concat(fileId).concat(reason ? ": ".concat(reason) : '')) || this;
+        _this.name = FileVariantNotMade.NAME;
+        Object.setPrototypeOf(_this, FileVariantNotMade.prototype);
+        _this.fileId = fileId;
+        _this.kind = kind;
+        _this.reason = reason;
+        return _this;
+    }
+    FileVariantNotMade.is = function (error) {
+        return (error === null || error === void 0 ? void 0 : error.name) === FileVariantNotMade.NAME;
+    };
+    FileVariantNotMade.plain = function (cause) {
+        var message = cause instanceof Error ? cause.message : typeof cause === 'string' ? cause : '';
+        var line = message.replace(/\s+/g, ' ').trim();
+        return line.length > FileVariantNotMade.MAX_REASON_CHARS
+            ? "".concat(line.slice(0, FileVariantNotMade.MAX_REASON_CHARS), "\u2026")
+            : line;
+    };
+    FileVariantNotMade.NAME = 'FileVariantNotMade';
+    /** Free text that reaches a message is one line and bounded. */
+    FileVariantNotMade.MAX_REASON_CHARS = 300;
+    return FileVariantNotMade;
+}(Error));
+exports.FileVariantNotMade = FileVariantNotMade;
+//# sourceMappingURL=FileVariantMaker.js.map

package/dist/src/FileVariantMaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileVariantMaker.js","sourceRoot":"","sources":["../../src/FileVariantMaker.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,oDAAmE;AAUtD,QAAA,kBAAkB,GAA+B,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAiC5E,IAAM,mBAAmB,GAAG;IACjC,OAAA,6BAAgB,CAAC,GAAG,EAAE,CAAC,MAAM,CAAmB,qCAAqC,CAAC;AAAtF,CAAsF,CAAC;AAD5E,QAAA,mBAAmB,uBACyD;AAEzF;;;;;;;GAOG;AACH;IAAwC,sCAAK;IAQ3C,4BAAY,MAAc,EAAE,IAAqB,EAAE,KAAc;QAAjE,iBAQC;QAPC,IAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC/C,kBAAM,aAAM,IAAI,4CAAkC,MAAM,SAAG,MAAM,CAAC,CAAC,CAAC,YAAK,MAAM,CAAE,CAAC,CAAC,CAAC,EAAE,CAAE,CAAC;QACzF,KAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC;QACpC,MAAM,CAAC,cAAc,CAAC,KAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAC1D,KAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,KAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,KAAI,CAAC,MAAM,GAAG,MAAM,CAAC;;IACvB,CAAC;IAEM,qBAAE,GAAT,UAAU,KAAc;QACtB,OAAO,CAAC,KAA+C,aAA/C,KAAK,uBAAL,KAAK,CAA4C,IAAI,MAAK,kBAAkB,CAAC,IAAI,CAAC;IAC5F,CAAC;IAEc,wBAAK,GAApB,UAAqB,KAAc;QACjC,IAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAChG,IAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,MAAM,GAAG,kBAAkB,CAAC,gBAAgB;YACtD,CAAC,CAAC,UAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,WAAG;YAC1D,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IA3BuB,uBAAI,GAAG,oBAAoB,CAAC;IACpD,gEAAgE;IACxC,mCAAgB,GAAG,GAAG,CAAC;IA0BjD,yBAAC;CAAA,AA7BD,CAAwC,KAAK,GA6B5C;AA7BY,gDAAkB"}

package/dist/src/routes/FileResponder.d.ts

@@ -0,0 +1,41 @@
+import { File } from '../tables/FileTable';
+/** The express members the file routes touch — typed narrowly so the routes and their tests agree. */
+export type FileRequest = {
+    params: Record<string, string>;
+    headers?: {
+        range?: string;
+    };
+};
+export type FileResponse = {
+    status(code: number): {
+        send(body: unknown): unknown;
+    };
+    send(body: unknown): unknown;
+    setHeader(name: string, value: string): void;
+    redirect(status: number, url: string): void;
+};
+/**
+ * THE ONE SERVING PATH for a file's bytes — `GET /file/:id` and `GET /file/:id/variant/:kind`
+ * answer through it, so a variant is served exactly as any File is. Two shapes:
+ *
+ * - **302 redirect** to a short-lived signed URL when the driver's store has an external URL
+ *   space (GCS). The app URL stays the one stable reference every `<img>`/`<video>`/chip uses;
+ *   the client follows the redirect and reads the store directly — native Range/206 for video
+ *   seeking, real caching, bytes never transit the app server. The redirect itself is cached
+ *   briefly (client-private, well under the signed TTL) so repeated loads reuse one URL.
+ * - **Proxy** for drivers with no external URL space (`DbFileStorageDriver`): the interface's
+ *   base64 is decoded so every mime — binary or text — serves its true bytes, and HTTP Range
+ *   is honored (206/416 via {@link resolveByteRange}) so a `<video>` can SEEK against a
+ *   proxy-served blob — streaming parity with the signed-URL path instead of download-then-watch.
+ *
+ * WHICH bytes is `FileStorage`'s decision (`getSignedUrl` / `getFileData` substitute the copy
+ * for others for anyone but the owner); the headers are the row's (its name and type). The
+ * route decided existence and access before calling here (`FileStorage.getFile`).
+ */
+export declare class FileResponder {
+    /** Serve `file` (a row the caller may read) to `response`; every failure shape mapped to its status. */
+    static serve(file: File, request: FileRequest, response: FileResponse): Promise<void>;
+    /** The failure shapes a file read has: bytes missing behind a row (404), a refusal (its status, 404), anything else (500, logged). */
+    static fail(fileId: string, error: unknown, response: FileResponse): void;
+}
+//# sourceMappingURL=FileResponder.d.ts.map

package/dist/src/routes/FileResponder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileResponder.d.ts","sourceRoot":"","sources":["../../../src/routes/FileResponder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAM3C,sGAAsG;AACtG,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAC3F,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;KAAE,CAAC;IACvD,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,aAAa;IACxB,wGAAwG;WAC3F,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC3F,sIAAsI;IACtI,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;CAgB1E"}

package/dist/src/routes/FileResponder.js

@@ -0,0 +1,135 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileResponder = void 0;
+var FileStorage_1 = require("../FileStorage");
+var FileStorageError_1 = require("../FileStorageError");
+var service_1 = require("@proteinjs/service");
+var byteRange_1 = require("./byteRange");
+/**
+ * THE ONE SERVING PATH for a file's bytes — `GET /file/:id` and `GET /file/:id/variant/:kind`
+ * answer through it, so a variant is served exactly as any File is. Two shapes:
+ *
+ * - **302 redirect** to a short-lived signed URL when the driver's store has an external URL
+ *   space (GCS). The app URL stays the one stable reference every `<img>`/`<video>`/chip uses;
+ *   the client follows the redirect and reads the store directly — native Range/206 for video
+ *   seeking, real caching, bytes never transit the app server. The redirect itself is cached
+ *   briefly (client-private, well under the signed TTL) so repeated loads reuse one URL.
+ * - **Proxy** for drivers with no external URL space (`DbFileStorageDriver`): the interface's
+ *   base64 is decoded so every mime — binary or text — serves its true bytes, and HTTP Range
+ *   is honored (206/416 via {@link resolveByteRange}) so a `<video>` can SEEK against a
+ *   proxy-served blob — streaming parity with the signed-URL path instead of download-then-watch.
+ *
+ * WHICH bytes is `FileStorage`'s decision (`getSignedUrl` / `getFileData` substitute the copy
+ * for others for anyone but the owner); the headers are the row's (its name and type). The
+ * route decided existence and access before calling here (`FileStorage.getFile`).
+ */
+var FileResponder = /** @class */ (function () {
+    function FileResponder() {
+    }
+    /** Serve `file` (a row the caller may read) to `response`; every failure shape mapped to its status. */
+    FileResponder.serve = function (file, request, response) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function () {
+            var fileStorage, signedUrl, bytes, _b, _c, safeFilename, range, error_1;
+            return __generator(this, function (_d) {
+                switch (_d.label) {
+                    case 0:
+                        fileStorage = new FileStorage_1.FileStorage();
+                        _d.label = 1;
+                    case 1:
+                        _d.trys.push([1, 4, , 5]);
+                        return [4 /*yield*/, fileStorage.getSignedUrl(file.id)];
+                    case 2:
+                        signedUrl = _d.sent();
+                        if (signedUrl) {
+                            response.setHeader('Cache-Control', 'private, max-age=300');
+                            response.redirect(302, signedUrl);
+                            return [2 /*return*/];
+                        }
+                        _c = (_b = Buffer).from;
+                        return [4 /*yield*/, fileStorage.getFileData(file.id)];
+                    case 3:
+                        bytes = _c.apply(_b, [_d.sent(), 'base64']);
+                        safeFilename = encodeURIComponent(file.name);
+                        response.setHeader('Content-Disposition', "inline; filename=\"".concat(safeFilename, "\""));
+                        response.setHeader('Content-Type', file.type);
+                        response.setHeader('Accept-Ranges', 'bytes');
+                        range = (0, byteRange_1.resolveByteRange)((_a = request.headers) === null || _a === void 0 ? void 0 : _a.range, bytes.length);
+                        if (range === 'unsatisfiable') {
+                            response.setHeader('Content-Range', "bytes */".concat(bytes.length));
+                            response.status(416).send('Range Not Satisfiable');
+                            return [2 /*return*/];
+                        }
+                        if (range) {
+                            response.setHeader('Content-Range', "bytes ".concat(range.start, "-").concat(range.end, "/").concat(bytes.length));
+                            response.status(206).send(bytes.subarray(range.start, range.end + 1));
+                            return [2 /*return*/];
+                        }
+                        response.send(bytes);
+                        return [3 /*break*/, 5];
+                    case 4:
+                        error_1 = _d.sent();
+                        FileResponder.fail(file.id, error_1, response);
+                        return [3 /*break*/, 5];
+                    case 5: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /** The failure shapes a file read has: bytes missing behind a row (404), a refusal (its status, 404), anything else (500, logged). */
+    FileResponder.fail = function (fileId, error, response) {
+        if (FileStorageError_1.FileStorageError.isNotFound(error)) {
+            // The row is there and its bytes are not: the same answer as a row that is not there.
+            response.status(404).send('File not found');
+            return;
+        }
+        if (service_1.ServiceRefusal.is(error)) {
+            // A deliberate refusal, not a failure — a file no copy can be made of is not there for anyone
+            // but its owner (`FileStorage` answers every door the same 404 and keeps the maker's reason in
+            // its own WARN). The same words as a row the caller cannot read; quiet, and never a 500.
+            response.status(error.status).send('File not found');
+            return;
+        }
+        console.error("Error fetching file (".concat(fileId, "):"), error);
+        response.status(500).send('Internal Server Error');
+    };
+    return FileResponder;
+}());
+exports.FileResponder = FileResponder;
+//# sourceMappingURL=FileResponder.js.map

package/dist/src/routes/FileResponder.js.map

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

package/dist/src/routes/getFile.d.ts

@@ -1,19 +1,11 @@
 import { Route } from '@proteinjs/server-api';
 /**
  * Serves a file's bytes. Auth first: logged-in, then the `FileStorage.getFile` row read as the
- * access decision — the caller's SCOPED read, else the shared-content reachability leg
- * (`FileReachabilityResolver`: the caller may read a file when they may read a row that
- * references it, e.g. a shared thought's media node). Then one of two serving paths:
- *
- * - **302 redirect** to a short-lived signed URL when the driver's store has an external URL
- *   space (GCS). The app URL stays the one stable reference every `<img>`/`<video>`/chip uses;
- *   the client follows the redirect and reads the store directly — native Range/206 for video
- *   seeking, real caching, bytes never transit the app server. The redirect itself is cached
- *   briefly (client-private, well under the signed TTL) so repeated loads reuse one URL.
- * - **Proxy** for drivers with no external URL space (`DbFileStorageDriver`): the interface's
- *   base64 is decoded so every mime — binary or text — serves its true bytes, and HTTP Range
- *   is honored (206/416 via {@link resolveByteRange}) so a `<video>` can SEEK against a
- *   proxy-served blob — streaming parity with the signed-URL path instead of download-then-watch.
+ * access decision — the caller's SCOPED read, else a variant's original, else the shared-content
+ * reachability leg (`FileReachabilityResolver`: the caller may read a file when they may read a
+ * row that references it, e.g. a shared thought's media node). Then {@link FileResponder} — the
+ * one serving path (a 302 to a signed URL, or the proxy with Range) every file route answers
+ * through.
  */
 export declare const getFile: Route;
 //# sourceMappingURL=getFile.d.ts.map

package/dist/src/routes/getFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getFile.d.ts","sourceRoot":"","sources":["../../../src/routes/getFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAK9C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,OAAO,EAAE,KAiDrB,CAAC"}
+{"version":3,"file":"getFile.d.ts","sourceRoot":"","sources":["../../../src/routes/getFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAK9C;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,EAAE,KAsBrB,CAAC"}