@adonis-agora/media 0.8.2 → 0.10.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,117 @@
+import type { DirectUploadManager } from './direct_upload.js';
+import type { AttachExistingInput } from './media_library.js';
+import type { MediaRecord } from './media_record.js';
+import type { DirectUploadPolicy, 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;
+    /**
+     * App-injected strategy that owns the variant decisions (key resolution, what the upload becomes
+     * on completion, error→HTTP mapping). When present, `initiate`/`complete`/`abort` route through
+     * it; when absent, the handler keeps its built-in key/complete behavior. See {@link DirectUploadPolicy}.
+     */
+    policy?: DirectUploadPolicy<unknown, unknown> | undefined;
+    /**
+     * Adopt an assembled object into the media library — wired to `MediaManager.completeDirectUploadToLibrary`
+     * by the provider. The policy's `complete` path calls it with the resolution's `sessionId`/`target`
+     * (plus the caller-supplied parts) and returns the resulting record. Unused without a {@link policy}.
+     */
+    adopt?: ((sessionId: string, target: Omit<AttachExistingInput, 'key' | 'disk' | 'size'>, parts?: MultipartPart[] | undefined) => Promise<MediaRecord>) | 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;
+    private readonly policy;
+    private readonly adopt;
+    constructor(options: DirectUploadHandlerOptions);
+    handle(req: DirectUploadRequest, ctx?: unknown): Promise<DirectUploadResponse>;
+    /** The `201` body for a created session — shared by the built-in and policy initiate paths. */
+    private initiateBody;
+    /**
+     * Policy-driven `initiate`: the policy decides the key/collection/metadata (and may attach a
+     * `response` merged onto the `201`), the manager opens the upload. If anything throws after the
+     * decision, the decision's `rollback` runs and the policy's `mapError` gets first refusal on the
+     * HTTP mapping (with the decision in the info); an unmapped error falls through to {@link mapError}.
+     */
+    private initiatePolicy;
+    /**
+     * Policy-driven `complete`: `resolveComplete` maps the session onto a library `target`, `adopt`
+     * assembles + adopts the object, and the `200` body is whatever `onComplete` returns. Parts-shape
+     * validation is deliberately skipped — the policy owns what a completion means. `mapError` (with
+     * the resolution in the info) gets first refusal on failures; else {@link mapError}.
+     */
+    private completePolicy;
+    /** Policy-driven `abort`: the policy cleans up app-side state, then the session is dropped. */
+    private abortPolicy;
+    /** 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":"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"}