@adonis-agora/media 0.8.1 → 0.9.0

package/dist/src/direct_upload.js

@@ -0,0 +1,299 @@
+import { randomUUID } from 'node:crypto';
+import { publishMedia } from './diagnostics.js';
+import { MimeNotAllowedError, UploadNotSupportedError, UploadPartOutOfRangeError, UploadPartSizeError, UploadPartsIncompleteError, UploadSessionExpiredError, UploadSessionNotFoundError, } from './errors.js';
+import { isMultipartCapable } from './multipart.js';
+/**
+ * Default part size: 20 MiB. Between S3's 5 MiB minimum and a reasonable payload per browser `PUT`;
+ * with S3's 10,000-part cap it covers files up to ~195 GiB. Larger than the proxy default (8 MiB)
+ * on purpose — direct parts don't occupy app memory, so the only cost of a bigger part is a bigger
+ * retry unit.
+ */
+export const DEFAULT_DIRECT_PART_SIZE = 20 * 1024 * 1024;
+/** S3's minimum part size (every part but the last). Enforced at `initiate` — see {@link UploadPartSizeError}. */
+export const MIN_DIRECT_PART_SIZE = 5 * 1024 * 1024;
+/** S3's cap on parts per multipart upload. */
+export const MAX_DIRECT_PARTS = 10_000;
+/**
+ * Default presigned part-URL lifetime (1 hour). Deliberately not sized to "the whole upload on a
+ * slow connection": {@link DirectUploadManager.status} re-issues fresh URLs for whatever is still
+ * pending, so an expired URL costs one status round-trip, not the upload.
+ */
+const DEFAULT_PRESIGN_TTL_SECONDS = 3600;
+/** Session-metadata key marking a session as a direct upload and carrying its agreed part size. */
+const PART_SIZE_METADATA_KEY = 'direct:partSize';
+/**
+ * Session-backed direct-to-S3 multipart uploads: the browser `PUT`s every byte straight to storage
+ * through presigned part URLs, and the app only coordinates — open, presign, collect ETags, close.
+ * The app's bandwidth cost is a handful of JSON round-trips regardless of file size, which is the
+ * entire point for video-sized files: the TUS path streams every chunk THROUGH the app (2× the
+ * bytes: client→app, app→S3), where this path streams none.
+ *
+ * What this adds over the raw primitives on {@link UploadManager} (`initiateDirect` & friends) is
+ * the **persisted session**: `uploadId`, the agreed `partSize` and every confirmed part ETag live
+ * in an {@link UploadSessionStore} — the same SPI the TUS engine persists its offsets in — instead
+ * of in the client's memory. A page reload no longer orphans the upload: the client asks
+ * {@link status} and gets back the confirmed ETags plus fresh URLs for what is missing.
+ *
+ * Framework-free, like {@link ResumableUploadManager}: the `DirectUploadHandler` maps it onto HTTP
+ * and the AdonisJS provider mounts that. `MediaManager.completeDirectUploadToLibrary` bridges a
+ * finished session into the media library through `attachExisting` — where the collection's
+ * whitelist checks the REAL bytes, exactly like every other upload path.
+ */
+export class DirectUploadManager {
+    storage;
+    sessions;
+    collections;
+    partSize;
+    presignTtlSeconds;
+    ttlSeconds;
+    newId;
+    now;
+    emitDiagnostics;
+    constructor(options) {
+        this.storage = options.storage;
+        this.sessions = options.sessions;
+        this.collections = options.collections;
+        this.partSize = options.partSize ?? DEFAULT_DIRECT_PART_SIZE;
+        this.presignTtlSeconds = options.presignTtlSeconds ?? DEFAULT_PRESIGN_TTL_SECONDS;
+        this.ttlSeconds = options.sessionTtlSeconds;
+        this.newId = options.idGenerator ?? (() => randomUUID());
+        this.now = options.clock ?? (() => new Date());
+        this.emitDiagnostics = options.emitDiagnostics ?? true;
+    }
+    /**
+     * Open a direct upload: validate everything that can be validated without bytes, start the native
+     * multipart upload, persist the session, and presign every part URL in one batch (presigning is
+     * local computation — see `sigv4.ts` — so a 10,000-part batch costs no S3 round-trips).
+     */
+    async initiate(input) {
+        const diskName = input.disk ?? this.storage.defaultDisk;
+        const disk = this.storage.disk(diskName);
+        if (!isMultipartCapable(disk))
+            throw new UploadNotSupportedError(diskName);
+        if (typeof this.sessions.addPart !== 'function' ||
+            typeof this.sessions.listParts !== 'function') {
+            throw new UploadNotSupportedError(diskName, 'direct upload part recording');
+        }
+        if (!Number.isInteger(input.size) || input.size <= 0) {
+            throw new RangeError(`Direct upload size must be a positive integer, got ${input.size}`);
+        }
+        const partSize = input.partSize ?? this.partSize;
+        if (!Number.isInteger(partSize) || partSize < MIN_DIRECT_PART_SIZE) {
+            throw new UploadPartSizeError(`${partSize} bytes is below S3's ${MIN_DIRECT_PART_SIZE}-byte minimum`);
+        }
+        const totalParts = Math.max(1, Math.ceil(input.size / partSize));
+        if (totalParts > MAX_DIRECT_PARTS) {
+            throw new UploadPartSizeError(`${input.size} bytes at ${partSize} bytes/part needs ${totalParts} parts, over S3's cap of ${MAX_DIRECT_PARTS} — increase partSize`);
+        }
+        // The cheapest possible rejection, before the multipart upload even opens. Only the DECLARED
+        // type can be checked here (there are no bytes yet); the collection config stays the single
+        // source of truth, and attach-time validation of the real content remains the final barrier.
+        if (input.collection !== undefined && this.collections !== undefined) {
+            const accepts = this.collections.get(input.collection).acceptsMimeTypes;
+            if (accepts && input.contentType !== undefined && !accepts.includes(input.contentType)) {
+                throw new MimeNotAllowedError(input.collection, input.contentType);
+            }
+        }
+        const putOptions = input.contentType !== undefined || input.visibility !== undefined
+            ? {
+                ...(input.contentType !== undefined ? { contentType: input.contentType } : {}),
+                ...(input.visibility !== undefined ? { visibility: input.visibility } : {}),
+            }
+            : undefined;
+        const { uploadId } = await disk.createMultipartUpload(input.key, putOptions);
+        const createdAt = this.now();
+        const session = await this.sessions.create({
+            id: this.newId(),
+            disk: diskName,
+            key: input.key,
+            contentType: input.contentType,
+            size: input.size,
+            offset: 0,
+            parts: 0,
+            multipartUploadId: uploadId,
+            createdAt,
+            ...(this.ttlSeconds !== undefined
+                ? { expiresAt: new Date(createdAt.getTime() + this.ttlSeconds * 1000) }
+                : {}),
+            metadata: { ...input.metadata, [PART_SIZE_METADATA_KEY]: String(partSize) },
+        });
+        const parts = await this.#presignParts(disk, session, Array.from({ length: totalParts }, (_, index) => index + 1));
+        this.emit('upload.start', {
+            id: session.id,
+            disk: diskName,
+            key: input.key,
+            mode: 'direct',
+            size: input.size,
+            contentType: input.contentType,
+        });
+        return {
+            id: session.id,
+            key: session.key,
+            disk: diskName,
+            partSize,
+            size: input.size,
+            totalParts,
+            parts,
+            expiresAt: session.expiresAt,
+        };
+    }
+    /**
+     * Record one part the client finished `PUT`ing (its S3 `ETag` response header). This is what makes
+     * the session resumable: an ETag the server holds survives any client-side loss of state. Safe to
+     * retry — confirming the same part again overwrites its ETag.
+     */
+    async confirmPart(id, part) {
+        const session = await this.#require(id);
+        const { partSize, totalParts } = this.#geometry(session);
+        if (!Number.isInteger(part.partNumber) || part.partNumber < 1 || part.partNumber > totalParts) {
+            throw new UploadPartOutOfRangeError(part.partNumber, totalParts);
+        }
+        await this.sessions.addPart?.(id, { partNumber: part.partNumber, etag: part.etag });
+        // Recompute progress from what is actually recorded (parts confirm in any order and in
+        // parallel), so offset means "bytes safely on S3" rather than a linear cursor.
+        const confirmed = (await this.sessions.listParts?.(id)) ?? [];
+        session.parts = confirmed.length;
+        session.offset = confirmed.reduce((sum, recorded) => sum + this.#partBytes(session, partSize, totalParts, recorded.partNumber), 0);
+        await this.sessions.update(session);
+        this.emit('upload.progress', {
+            id: session.id,
+            offset: session.offset,
+            parts: session.parts,
+            size: session.size,
+        });
+        return { offset: session.offset, completedParts: confirmed.length };
+    }
+    /**
+     * Where the upload stands, framed for resumption: the ETags already confirmed and a FRESH
+     * presigned URL for every part still missing. After a page reload the client calls this, slices
+     * the file with the returned `partSize`, uploads only `pendingParts`, and completes.
+     */
+    async status(id) {
+        const session = await this.#require(id);
+        const disk = this.storage.disk(session.disk);
+        if (!isMultipartCapable(disk))
+            throw new UploadNotSupportedError(session.disk);
+        const { partSize, totalParts } = this.#geometry(session);
+        const completedParts = [...((await this.sessions.listParts?.(id)) ?? [])].sort((a, b) => a.partNumber - b.partNumber);
+        const confirmedNumbers = new Set(completedParts.map((part) => part.partNumber));
+        const pendingNumbers = Array.from({ length: totalParts }, (_, index) => index + 1).filter((partNumber) => !confirmedNumbers.has(partNumber));
+        return {
+            id: session.id,
+            key: session.key,
+            disk: session.disk,
+            partSize,
+            size: session.size,
+            totalParts,
+            contentType: session.contentType,
+            completedParts,
+            pendingParts: await this.#presignParts(disk, session, pendingNumbers),
+            expiresAt: session.expiresAt,
+        };
+    }
+    /**
+     * Assemble the parts into the final object and close the session. `parts` supplements what the
+     * session already holds (a client may hand over ETags it never got to confirm — e.g. it raced
+     * completion against its last confirms); on overlap the caller's ETag wins. Every part number in
+     * `1..totalParts` must be accounted for, or this throws {@link UploadPartsIncompleteError} naming
+     * the gaps — BEFORE the S3 round-trip that would report an opaque `InvalidPart`.
+     *
+     * This is the raw primitive (the object exists, no media record). To land in the library, use
+     * `MediaManager.completeDirectUploadToLibrary`, which chains `attachExisting` — collection
+     * whitelist against the real bytes included.
+     */
+    async complete(id, parts = []) {
+        const session = await this.#require(id);
+        const disk = this.storage.disk(session.disk);
+        if (!isMultipartCapable(disk))
+            throw new UploadNotSupportedError(session.disk);
+        const { totalParts } = this.#geometry(session);
+        const byNumber = new Map();
+        for (const recorded of (await this.sessions.listParts?.(id)) ?? []) {
+            byNumber.set(recorded.partNumber, recorded);
+        }
+        for (const given of parts)
+            byNumber.set(given.partNumber, given);
+        const missing = Array.from({ length: totalParts }, (_, index) => index + 1).filter((partNumber) => !byNumber.has(partNumber));
+        if (missing.length > 0)
+            throw new UploadPartsIncompleteError(id, missing);
+        const assembled = [...byNumber.values()].sort((a, b) => a.partNumber - b.partNumber);
+        await disk.completeMultipartUpload(session.key, session.multipartUploadId, assembled);
+        await this.sessions.delete(id);
+        this.emit('upload.complete', { id: session.id, disk: session.disk, key: session.key });
+        return { key: session.key, disk: session.disk, size: session.size };
+    }
+    /**
+     * Discard an in-flight upload: abort the native multipart upload (S3 frees the stored parts and
+     * stops charging for them) and drop the session. The S3 abort is best-effort — a bucket lifecycle
+     * rule may have already reaped the upload (`NoSuchUpload`), and a session that can no longer be
+     * aborted remotely must still be deletable locally.
+     */
+    async abort(id) {
+        const session = await this.sessions.get(id);
+        if (!session)
+            return;
+        const disk = this.storage.disk(session.disk);
+        if (session.multipartUploadId && isMultipartCapable(disk)) {
+            await disk.abortMultipartUpload(session.key, session.multipartUploadId).catch(() => { });
+        }
+        await this.sessions.delete(id);
+        this.emit('upload.abort', { id: session.id, disk: session.disk, key: session.key });
+    }
+    /** In-progress direct sessions, optionally filtered. Empty when the store cannot enumerate. */
+    async list(filter) {
+        const sessions = (await this.sessions.list?.(filter)) ?? [];
+        return sessions.filter((session) => session.metadata?.[PART_SIZE_METADATA_KEY] !== undefined);
+    }
+    /** Presign a `PUT` URL for each given part number, in one local batch. */
+    async #presignParts(disk, session, partNumbers) {
+        const urls = [];
+        for (const partNumber of partNumbers) {
+            urls.push({
+                partNumber,
+                url: await disk.presignUploadPart(session.key, session.multipartUploadId, partNumber, this.presignTtlSeconds),
+            });
+        }
+        return urls;
+    }
+    /** The agreed slicing for a session, recovered from its persisted metadata. */
+    #geometry(session) {
+        const partSize = Number(session.metadata?.[PART_SIZE_METADATA_KEY]);
+        const size = session.size;
+        return { partSize, totalParts: Math.max(1, Math.ceil(size / partSize)) };
+    }
+    /** Byte length of one part: `partSize`, except the last part which takes the remainder. */
+    #partBytes(session, partSize, totalParts, partNumber) {
+        const size = session.size;
+        return partNumber === totalParts ? size - (totalParts - 1) * partSize : partSize;
+    }
+    /**
+     * Load a session, requiring it to be a DIRECT one: the store may be shared with the TUS engine
+     * (the Lucid driver even shares tables), so a session lacking the direct part-size marker — or a
+     * declared size, or a native upload id — is "not found" here, never misinterpreted. An expired
+     * session is treated as gone: native upload aborted, record deleted,
+     * {@link UploadSessionExpiredError} thrown.
+     */
+    async #require(id) {
+        const session = await this.sessions.get(id);
+        if (!session ||
+            session.multipartUploadId === undefined ||
+            session.size === undefined ||
+            !Number.isFinite(Number(session.metadata?.[PART_SIZE_METADATA_KEY]))) {
+            throw new UploadSessionNotFoundError(id);
+        }
+        if (session.expiresAt && session.expiresAt.getTime() <= this.now().getTime()) {
+            const disk = this.storage.disk(session.disk);
+            if (isMultipartCapable(disk)) {
+                await disk.abortMultipartUpload(session.key, session.multipartUploadId).catch(() => { });
+            }
+            await this.sessions.delete(id);
+            throw new UploadSessionExpiredError(id);
+        }
+        return session;
+    }
+    emit(event, payload) {
+        if (this.emitDiagnostics)
+            publishMedia(event, payload);
+    }
+}
+//# sourceMappingURL=direct_upload.js.map

package/dist/src/direct_upload.js.map

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

package/dist/src/direct_upload_handler.d.ts

@@ -0,0 +1,83 @@
+import type { DirectUploadManager } from './direct_upload.js';
+import type { MultipartPart } from './types.js';
+/**
+ * A web-framework-neutral direct-upload request, one variant per lifecycle step (the provider maps
+ * an AdonisJS `HttpContext` to this; any other framework maps its own request the same way).
+ */
+export type DirectUploadRequest = {
+    action: 'initiate';
+    /** Name of the file being uploaded — feeds `keyFor`, never used as a key verbatim. */
+    fileName: string;
+    /** Total size in bytes. */
+    size: number;
+    contentType?: string | undefined;
+    /** Extra metadata persisted on the session. */
+    metadata?: Record<string, string> | undefined;
+} | {
+    action: 'status';
+    uploadId: string;
+} | {
+    action: 'confirm-part';
+    uploadId: string;
+    partNumber: number;
+    etag: string;
+} | {
+    action: 'complete';
+    uploadId: string;
+    parts?: MultipartPart[] | undefined;
+} | {
+    action: 'abort';
+    uploadId: string;
+};
+/** A web-framework-neutral response: a status code and a JSON-serializable body. */
+export interface DirectUploadResponse {
+    status: number;
+    body?: unknown;
+}
+export interface DirectUploadHandlerOptions {
+    manager: DirectUploadManager;
+    /** Disk uploads land on. Defaults to the manager's default disk. */
+    disk?: string | undefined;
+    /**
+     * Collection this endpoint uploads into. Forwarded to the manager's `initiate`, whose MIME gate
+     * (against the registry the manager holds) rejects a wrong declared type with `415` before the
+     * multipart upload opens. The collection config stays the single source of truth.
+     */
+    collection?: string | undefined;
+    /** Reject initiations whose `size` exceeds this many bytes (`413`). */
+    maxSize?: number | undefined;
+    /** Compute the final object key. Default: `uploads/<token>/<fileName>`. */
+    keyFor?: ((fileName: string, token: string, metadata: Record<string, string>) => string) | undefined;
+    idGenerator?: (() => string) | undefined;
+}
+/**
+ * HTTP half of the session-backed direct upload flow, mirroring {@link TusUploadHandler}: the core
+ * ({@link DirectUploadManager}) never sees HTTP, this class never sees a framework, and a thin
+ * AdonisJS route adapter maps `HttpContext` to {@link DirectUploadRequest}/{@link DirectUploadResponse}.
+ *
+ * The endpoint surface it expects to be mounted on (see the provider's `uploads.direct.routes`):
+ *
+ * - `POST   /`                       → `initiate` — `201` + session id, part size, presigned URLs
+ * - `GET    /:id`                    → `status` — confirmed ETags + fresh URLs for pending parts
+ * - `POST   /:id/parts/:partNumber`  → `confirm-part` — record one uploaded part's ETag
+ * - `POST   /:id/complete`           → `complete` — assemble; `409` names any missing parts
+ * - `DELETE /:id`                    → `abort`
+ *
+ * **This handler performs NO authorization** — the same split as `TusUploadHandler` and
+ * `MediaDeliveryHandler`. Who may upload, and into whose namespace the key resolves, are questions
+ * only the app can answer: guard the route, and resolve the key server-side via {@link keyFor}
+ * (the client sends a `fileName`, never a key).
+ */
+export declare class DirectUploadHandler {
+    private readonly manager;
+    private readonly disk;
+    private readonly collection;
+    private readonly maxSize;
+    private readonly keyFor;
+    private readonly newId;
+    constructor(options: DirectUploadHandlerOptions);
+    handle(req: DirectUploadRequest): Promise<DirectUploadResponse>;
+    /** Map manager errors onto HTTP statuses; anything unexpected keeps propagating. */
+    private mapError;
+}
+//# sourceMappingURL=direct_upload_handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"direct_upload_handler.d.ts","sourceRoot":"","sources":["../../src/direct_upload_handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAU9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,sFAAsF;IACtF,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC/C,GACD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9E;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,aAAa,EAAE,GAAG,SAAS,CAAA;CAAE,GAC7E;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,oFAAoF;AACpF,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,2EAA2E;IAC3E,MAAM,CAAC,EACH,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,GAC/E,SAAS,CAAC;IACd,WAAW,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8D;IACrF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,OAAO,EAAE,0BAA0B;IASzC,MAAM,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA2HrE,oFAAoF;IACpF,OAAO,CAAC,QAAQ;CA4BjB"}

package/dist/src/direct_upload_handler.js

@@ -0,0 +1,180 @@
+import { randomUUID } from 'node:crypto';
+import { MimeNotAllowedError, UploadNotSupportedError, UploadPartOutOfRangeError, UploadPartSizeError, UploadPartsIncompleteError, UploadSessionExpiredError, UploadSessionNotFoundError, } from './errors.js';
+/**
+ * HTTP half of the session-backed direct upload flow, mirroring {@link TusUploadHandler}: the core
+ * ({@link DirectUploadManager}) never sees HTTP, this class never sees a framework, and a thin
+ * AdonisJS route adapter maps `HttpContext` to {@link DirectUploadRequest}/{@link DirectUploadResponse}.
+ *
+ * The endpoint surface it expects to be mounted on (see the provider's `uploads.direct.routes`):
+ *
+ * - `POST   /`                       → `initiate` — `201` + session id, part size, presigned URLs
+ * - `GET    /:id`                    → `status` — confirmed ETags + fresh URLs for pending parts
+ * - `POST   /:id/parts/:partNumber`  → `confirm-part` — record one uploaded part's ETag
+ * - `POST   /:id/complete`           → `complete` — assemble; `409` names any missing parts
+ * - `DELETE /:id`                    → `abort`
+ *
+ * **This handler performs NO authorization** — the same split as `TusUploadHandler` and
+ * `MediaDeliveryHandler`. Who may upload, and into whose namespace the key resolves, are questions
+ * only the app can answer: guard the route, and resolve the key server-side via {@link keyFor}
+ * (the client sends a `fileName`, never a key).
+ */
+export class DirectUploadHandler {
+    manager;
+    disk;
+    collection;
+    maxSize;
+    keyFor;
+    newId;
+    constructor(options) {
+        this.manager = options.manager;
+        this.disk = options.disk;
+        this.collection = options.collection;
+        this.maxSize = options.maxSize;
+        this.keyFor = options.keyFor ?? ((fileName, token) => `uploads/${token}/${fileName}`);
+        this.newId = options.idGenerator ?? (() => randomUUID());
+    }
+    async handle(req) {
+        switch (req.action) {
+            case 'initiate': {
+                if (typeof req.fileName !== 'string' || req.fileName.length === 0) {
+                    return { status: 400, body: { error: 'fileName is required' } };
+                }
+                if (!Number.isInteger(req.size) || req.size <= 0) {
+                    return { status: 400, body: { error: 'size must be a positive integer' } };
+                }
+                if (this.maxSize !== undefined && req.size > this.maxSize) {
+                    return {
+                        status: 413,
+                        body: { error: `Upload exceeds the maximum size of ${this.maxSize} bytes` },
+                    };
+                }
+                const metadata = req.metadata ?? {};
+                try {
+                    const created = await this.manager.initiate({
+                        key: this.keyFor(req.fileName, this.newId(), metadata),
+                        size: req.size,
+                        contentType: req.contentType,
+                        metadata,
+                        ...(this.disk !== undefined ? { disk: this.disk } : {}),
+                        ...(this.collection !== undefined ? { collection: this.collection } : {}),
+                    });
+                    return {
+                        status: 201,
+                        body: {
+                            id: created.id,
+                            key: created.key,
+                            disk: created.disk,
+                            partSize: created.partSize,
+                            size: created.size,
+                            totalParts: created.totalParts,
+                            parts: created.parts,
+                            ...(created.expiresAt !== undefined
+                                ? { expiresAt: created.expiresAt.toISOString() }
+                                : {}),
+                        },
+                    };
+                }
+                catch (err) {
+                    return this.mapError(err);
+                }
+            }
+            case 'status': {
+                try {
+                    const status = await this.manager.status(req.uploadId);
+                    return {
+                        status: 200,
+                        body: {
+                            id: status.id,
+                            key: status.key,
+                            disk: status.disk,
+                            partSize: status.partSize,
+                            size: status.size,
+                            totalParts: status.totalParts,
+                            ...(status.contentType !== undefined ? { contentType: status.contentType } : {}),
+                            completedParts: status.completedParts,
+                            pendingParts: status.pendingParts,
+                            ...(status.expiresAt !== undefined
+                                ? { expiresAt: status.expiresAt.toISOString() }
+                                : {}),
+                        },
+                    };
+                }
+                catch (err) {
+                    return this.mapError(err);
+                }
+            }
+            case 'confirm-part': {
+                if (!Number.isInteger(req.partNumber) || req.partNumber < 1) {
+                    return { status: 400, body: { error: 'partNumber must be a positive integer' } };
+                }
+                if (typeof req.etag !== 'string' || req.etag.length === 0) {
+                    return { status: 400, body: { error: 'etag is required' } };
+                }
+                try {
+                    const progress = await this.manager.confirmPart(req.uploadId, {
+                        partNumber: req.partNumber,
+                        etag: req.etag,
+                    });
+                    return { status: 200, body: progress };
+                }
+                catch (err) {
+                    return this.mapError(err);
+                }
+            }
+            case 'complete': {
+                const parts = req.parts ?? [];
+                if (!Array.isArray(parts) ||
+                    parts.some((part) => !Number.isInteger(part?.partNumber) ||
+                        part.partNumber < 1 ||
+                        typeof part?.etag !== 'string' ||
+                        part.etag.length === 0)) {
+                    return {
+                        status: 400,
+                        body: { error: 'parts must be an array of { partNumber, etag }' },
+                    };
+                }
+                try {
+                    const done = await this.manager.complete(req.uploadId, parts);
+                    return { status: 200, body: done };
+                }
+                catch (err) {
+                    return this.mapError(err);
+                }
+            }
+            case 'abort': {
+                await this.manager.abort(req.uploadId);
+                return { status: 204 };
+            }
+            default:
+                return { status: 400, body: { error: 'Unknown action' } };
+        }
+    }
+    /** Map manager errors onto HTTP statuses; anything unexpected keeps propagating. */
+    mapError(err) {
+        if (err instanceof UploadSessionNotFoundError) {
+            return { status: 404, body: { error: err.message, code: err.code } };
+        }
+        if (err instanceof UploadSessionExpiredError) {
+            return { status: 410, body: { error: err.message, code: err.code } };
+        }
+        if (err instanceof MimeNotAllowedError) {
+            return { status: 415, body: { error: err.message, code: err.code } };
+        }
+        // Not-yet-uploaded parts are client state out of sync with the session, not a bad request.
+        if (err instanceof UploadPartsIncompleteError) {
+            return {
+                status: 409,
+                body: { error: err.message, code: err.code, missingParts: [...err.missingParts] },
+            };
+        }
+        if (err instanceof UploadPartOutOfRangeError ||
+            err instanceof UploadPartSizeError ||
+            err instanceof UploadNotSupportedError ||
+            err instanceof RangeError) {
+            const code = err.code;
+            return { status: 400, body: { error: err.message, ...(code ? { code } : {}) } };
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=direct_upload_handler.js.map

package/dist/src/direct_upload_handler.js.map

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

package/dist/src/disks/factory.d.ts

@@ -24,6 +24,13 @@ export interface S3DiskConfig {
     credentials?: S3Credentials;
     /** Custom endpoint for S3-compatible services (MinIO, R2, DigitalOcean Spaces, …). */
     endpoint?: string;
+    /**
+     * Endpoint presigned URLs are signed against, when it differs from `endpoint`. Presigned URLs are
+     * consumed by the BROWSER (direct-upload part `PUT`s, signed `GET`s) and SigV4 bakes the host into
+     * the signature — so when `endpoint` is an internal FQDN the internet cannot resolve (MinIO on a
+     * private network), set the public one here. Server-side operations keep using `endpoint`.
+     */
+    publicEndpoint?: string;
     /** Use path-style addressing (`endpoint/bucket/key`) — required by most S3-compatible services. */
     forcePathStyle?: boolean;
     /** Prefix prepended to every key (e.g. `uploads`). */
@@ -51,11 +58,12 @@ export interface S3DiskConfig {
  * ```
  *
  * Each factory returns a {@link DiskFactory} — a lazy thunk. Calling it in the config file costs
- * nothing; `@aws-sdk/client-s3` (and `@aws-sdk/s3-request-presigner`) are only imported when the
- * provider builds the selected disk at boot, keeping the AWS SDK an optional peer.
+ * nothing; `@aws-sdk/client-s3` is only imported when the provider builds the selected disk at
+ * boot, keeping the AWS SDK an optional peer. (Presigning needs no SDK at all — it is hand-rolled
+ * SigV4, see `sigv4.ts`.)
  */
 export declare const disks: {
-    /** S3 (or S3-compatible) disk — needs the optional `@aws-sdk/client-s3` + `@aws-sdk/s3-request-presigner` peers. */
+    /** S3 (or S3-compatible) disk — needs the optional `@aws-sdk/client-s3` peer. */
     s3(config: S3DiskConfig): DiskFactory;
 };
 /**

package/dist/src/disks/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/disks/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9C,yGAAyG;AACzG,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,sGAAsG;AACtG,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,KAAK;IAChB,oHAAoH;eACzG,YAAY,GAAG,WAAW;CAsBtC,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAQ/B"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/disks/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9C,yGAAyG;AACzG,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,sGAAsG;AACtG,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mGAAmG;IACnG,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,KAAK;IAChB,iFAAiF;eACtE,YAAY,GAAG,WAAW;CAuBtC,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAQ/B"}