@adonis-agora/media 0.8.2 → 0.9.0

package/dist/src/hls/delivery.d.ts

@@ -0,0 +1,112 @@
+import type { DeliveryResult } from '../delivery.js';
+import type { MediaLibrary } from '../media_library.js';
+/** Identifies one file of a media's HLS package, handed to the URL callbacks. */
+export interface HlsFileRef {
+    mediaId: string;
+    /** Package-relative artifact path (`'index.m3u8'`, `'playlist-1.m3u8'`, `'segment-0-3.ts'`). */
+    file: string;
+}
+/** Builds the URL a rewritten playlist reference should point at. */
+export type HlsUrlBuilder = (ref: HlsFileRef) => string | Promise<string>;
+/** What {@link HlsDeliveryHandler.handle} is asked to serve. */
+export interface HlsDeliveryRequest {
+    mediaId: string;
+    /**
+     * Which file of the package, relative to the conversion prefix. Omit for the entry (master)
+     * playlist. Validated against the conversion's persisted artifact list, so a request can never
+     * reach outside the package.
+     */
+    file?: string | undefined;
+}
+/**
+ * What serving one HLS package file yields: playlists come back as rewritten text (they are
+ * *always* rewritten, never proxied raw — raw ones reference the storage layout, not URLs), and
+ * media files come back as the usual {@link DeliveryResult} (`redirect` to a signed URL, or a
+ * `stream` to pipe).
+ */
+export type HlsDeliveryResult = {
+    kind: 'playlist';
+    content: string;
+    contentType: string;
+    fileName: string;
+} | DeliveryResult;
+export interface HlsDeliveryHandlerOptions {
+    /** The {@link MediaLibrary} records are resolved from — or a `MediaManager`, whose `.library` is used. */
+    library: MediaLibrary | {
+        library: MediaLibrary;
+    };
+    /** Name of the HLS conversion on the record. Default `'hls'` (the {@link HlsTransformer} default). */
+    conversion?: string | undefined;
+    /**
+     * URL for a **sub-playlist** reference (master → media playlists, audio renditions). Required,
+     * and it should point back at a route of yours that calls this handler again — playlists must be
+     * rewritten on every hop, and your route is where your authorization runs. There is no safe
+     * library default: presigning a playlist would serve it raw from storage, whose relative
+     * references then resolve against the storage host and break (or leak).
+     */
+    urlForPlaylist: HlsUrlBuilder;
+    /**
+     * URL for a **media** reference (segments, init sections). Default: a presigned URL straight to
+     * the object on the disk (`segmentTtlSeconds` lifetime) — the common case, letting players pull
+     * segments from storage/CDN without the bytes transiting your app. Point it at your own proxy
+     * route instead when storage isn't reachable from clients (then serve those requests with
+     * {@link HlsDeliveryHandler.handle}, which streams media files per `segmentDelivery`).
+     */
+    urlForSegment?: HlsUrlBuilder | undefined;
+    /** Lifetime of default presigned segment URLs, seconds. Default 300. */
+    segmentTtlSeconds?: number | undefined;
+    /**
+     * How {@link HlsDeliveryHandler.handle} answers a request for a media file (it always answers
+     * playlists with rewritten text): `'redirect'` (default) to a presigned URL, or `'stream'` to
+     * proxy the bytes through the app.
+     */
+    segmentDelivery?: 'redirect' | 'stream' | undefined;
+}
+/**
+ * Framework-agnostic HLS read path — the {@link MediaDeliveryHandler} of a transformer-generated
+ * HLS package. One route of yours receives `(:mediaId, :file?)` and delegates here; the handler
+ * resolves the record's HLS conversion, validates the requested file against the package's
+ * persisted artifact list, and:
+ *
+ * - for a **playlist**: returns its content with every relative reference rewritten — sub-playlist
+ *   references through your `urlForPlaylist` (auth stays yours), media references through
+ *   `urlForSegment` or a presigned URL;
+ * - for a **media file**: returns a `redirect` (presigned) or a `stream`, per `segmentDelivery`.
+ *
+ * ```ts
+ * const hls = new HlsDeliveryHandler({
+ *   library: media,
+ *   urlForPlaylist: ({ mediaId, file }) => router.makeUrl('videos.hls', { id: mediaId, file }),
+ * })
+ *
+ * router.get('/videos/:id/hls/:file?', async ({ params, response, auth }) => {
+ *   await authorize(auth.user, params.id)             // ← the app's job, as everywhere
+ *   const result = await hls.handle({ mediaId: params.id, file: params.file })
+ *   if (result.kind === 'redirect') return response.redirect(result.url)
+ *   if (result.kind === 'stream') {
+ *     response.header('content-type', result.mimeType)
+ *     return response.stream(result.stream)
+ *   }
+ *   response.header('content-type', result.contentType)
+ *   return response.send(result.content)
+ * }).use(middleware.auth())
+ * ```
+ *
+ * **This handler performs NO authorization** — the same split as {@link MediaDeliveryHandler} and
+ * `TusUploadHandler`: guard the route before calling `handle`. Note that a presigned segment URL
+ * (the default) is itself a capability: whoever holds it can fetch that segment until the TTL
+ * expires. That is the standard HLS trade-off — keep `segmentTtlSeconds` short, or use
+ * `segmentDelivery: 'stream'` with a segment `urlForSegment` pointing back at your route to keep
+ * every byte behind your auth.
+ */
+export declare class HlsDeliveryHandler {
+    private readonly library;
+    private readonly conversion;
+    private readonly urlForPlaylist;
+    private readonly urlForSegment;
+    private readonly segmentTtlSeconds;
+    private readonly segmentDelivery;
+    constructor(options: HlsDeliveryHandlerOptions);
+    handle(request: HlsDeliveryRequest): Promise<HlsDeliveryResult>;
+}
+//# sourceMappingURL=delivery.d.ts.map

package/dist/src/hls/delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../../src/hls/delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAOrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAQxD,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,gGAAgG;IAChG,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE1E,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC5E,cAAc,CAAC;AAEnB,MAAM,WAAW,yBAAyB;IACxC,0GAA0G;IAC1G,OAAO,EAAE,YAAY,GAAG;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE,CAAC;IAClD,sGAAsG;IACtG,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC;;;;;;OAMG;IACH,cAAc,EAAE,aAAa,CAAC;IAC9B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC1C,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC;;;;OAIG;IACH,eAAe,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;CACrD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4B;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;gBAE5C,OAAO,EAAE,yBAAyB;IAUxC,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA+DtE"}

package/dist/src/hls/delivery.js

@@ -0,0 +1,118 @@
+import { DEFAULT_DELIVERY_SIGNED_TTL_SECONDS } from '../delivery.js';
+import { ConversionArtifactMissingError, MediaNotFoundError, TransformNotReadyError, } from '../errors.js';
+import { HLS_PLAYLIST_CONTENT_TYPE, hlsArtifactContentType, resolvePackagePath, rewriteHlsPlaylist, } from './playlist.js';
+/**
+ * Framework-agnostic HLS read path — the {@link MediaDeliveryHandler} of a transformer-generated
+ * HLS package. One route of yours receives `(:mediaId, :file?)` and delegates here; the handler
+ * resolves the record's HLS conversion, validates the requested file against the package's
+ * persisted artifact list, and:
+ *
+ * - for a **playlist**: returns its content with every relative reference rewritten — sub-playlist
+ *   references through your `urlForPlaylist` (auth stays yours), media references through
+ *   `urlForSegment` or a presigned URL;
+ * - for a **media file**: returns a `redirect` (presigned) or a `stream`, per `segmentDelivery`.
+ *
+ * ```ts
+ * const hls = new HlsDeliveryHandler({
+ *   library: media,
+ *   urlForPlaylist: ({ mediaId, file }) => router.makeUrl('videos.hls', { id: mediaId, file }),
+ * })
+ *
+ * router.get('/videos/:id/hls/:file?', async ({ params, response, auth }) => {
+ *   await authorize(auth.user, params.id)             // ← the app's job, as everywhere
+ *   const result = await hls.handle({ mediaId: params.id, file: params.file })
+ *   if (result.kind === 'redirect') return response.redirect(result.url)
+ *   if (result.kind === 'stream') {
+ *     response.header('content-type', result.mimeType)
+ *     return response.stream(result.stream)
+ *   }
+ *   response.header('content-type', result.contentType)
+ *   return response.send(result.content)
+ * }).use(middleware.auth())
+ * ```
+ *
+ * **This handler performs NO authorization** — the same split as {@link MediaDeliveryHandler} and
+ * `TusUploadHandler`: guard the route before calling `handle`. Note that a presigned segment URL
+ * (the default) is itself a capability: whoever holds it can fetch that segment until the TTL
+ * expires. That is the standard HLS trade-off — keep `segmentTtlSeconds` short, or use
+ * `segmentDelivery: 'stream'` with a segment `urlForSegment` pointing back at your route to keep
+ * every byte behind your auth.
+ */
+export class HlsDeliveryHandler {
+    library;
+    conversion;
+    urlForPlaylist;
+    urlForSegment;
+    segmentTtlSeconds;
+    segmentDelivery;
+    constructor(options) {
+        const source = options.library;
+        this.library = 'library' in source ? source.library : source;
+        this.conversion = options.conversion ?? 'hls';
+        this.urlForPlaylist = options.urlForPlaylist;
+        this.urlForSegment = options.urlForSegment;
+        this.segmentTtlSeconds = options.segmentTtlSeconds ?? DEFAULT_DELIVERY_SIGNED_TTL_SECONDS;
+        this.segmentDelivery = options.segmentDelivery ?? 'redirect';
+    }
+    async handle(request) {
+        const { mediaId } = request;
+        const record = await this.library.find(mediaId);
+        if (!record)
+            throw new MediaNotFoundError(mediaId);
+        const variant = record.conversions[this.conversion];
+        if (!variant)
+            throw new TransformNotReadyError(mediaId, this.conversion);
+        if (variant.path === undefined || variant.disk === undefined) {
+            throw new ConversionArtifactMissingError(mediaId, this.conversion);
+        }
+        // The package's shape comes from what the transformer persisted; a hand-registered
+        // single-file conversion degrades to a one-file package.
+        const prefix = variant.prefix ?? variant.path.slice(0, variant.path.lastIndexOf('/') + 1);
+        const files = variant.files ?? [variant.path.slice(prefix.length)];
+        const entry = variant.path.slice(prefix.length);
+        const requested = request.file === undefined || request.file === '' ? entry : request.file;
+        // Membership in the persisted artifact list is the whole access check: no path arithmetic on
+        // caller input ever reaches the disk, so traversal is structurally impossible.
+        if (!files.includes(requested)) {
+            throw new MediaNotFoundError(`${mediaId}#${this.conversion}:${requested}`);
+        }
+        const disk = this.library.storage.disk(variant.disk);
+        const key = `${prefix}${requested}`;
+        if (requested.toLowerCase().endsWith('.m3u8')) {
+            const content = Buffer.from(await disk.getBytes(key)).toString('utf8');
+            const rewritten = await rewriteHlsPlaylist(content, async (ref) => {
+                const target = resolvePackagePath(requested, ref.uri);
+                // A relative reference that escapes the package or names a file the transformer never
+                // wrote is not ours to rewrite — leave it exactly as it was.
+                if (target === null || !files.includes(target))
+                    return ref.uri;
+                if (ref.kind === 'playlist')
+                    return this.urlForPlaylist({ mediaId, file: target });
+                if (this.urlForSegment)
+                    return this.urlForSegment({ mediaId, file: target });
+                return disk.getSignedUrl(`${prefix}${target}`, { expiresIn: this.segmentTtlSeconds });
+            });
+            return {
+                kind: 'playlist',
+                content: rewritten,
+                contentType: HLS_PLAYLIST_CONTENT_TYPE,
+                fileName: requested,
+            };
+        }
+        if (this.segmentDelivery === 'redirect') {
+            return {
+                kind: 'redirect',
+                url: await disk.getSignedUrl(key, { expiresIn: this.segmentTtlSeconds }),
+            };
+        }
+        const metadata = await disk.getMetaData(key);
+        return {
+            kind: 'stream',
+            stream: await disk.getStream(key),
+            mimeType: metadata.contentType ?? hlsArtifactContentType(requested) ?? 'application/octet-stream',
+            size: metadata.contentLength,
+            fileName: requested.slice(requested.lastIndexOf('/') + 1),
+        };
+    }
+}
+//# sourceMappingURL=delivery.js.map

package/dist/src/hls/delivery.js.map

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

package/dist/src/hls/playlist.d.ts

@@ -0,0 +1,67 @@
+/**
+ * HLS playlist (`.m3u8`) reference rewriting — the read-side half of the HLS transformer.
+ *
+ * Playlists are STORED with references relative to the package's storage layout (that is what the
+ * muxer emits, and it keeps the stored artifacts location-agnostic). At serve time those
+ * references must become URLs the player can actually fetch — the app's authenticated proxy
+ * routes, presigned object URLs, a CDN — and only the app knows which. This module does the part
+ * that is the same everywhere: find every reference in a playlist, classify it, and let a
+ * callback decide the URL. See {@link HlsDeliveryHandler} for the assembled read path.
+ */
+/** Content type playlists are served with (RFC 8216's `application/vnd.apple.mpegurl`). */
+export declare const HLS_PLAYLIST_CONTENT_TYPE = "application/vnd.apple.mpegurl";
+/** Content type for MPEG-TS segments. */
+export declare const HLS_SEGMENT_CONTENT_TYPE = "video/mp2t";
+/** One URI reference found in a playlist, handed to the {@link HlsUriRewriter}. */
+export interface HlsUriRef {
+    /** The reference exactly as it appears in the playlist (may carry a query string). */
+    uri: string;
+    /**
+     * `'playlist'` for `.m3u8` references (variant streams in a master playlist, audio/subtitle
+     * renditions via `#EXT-X-MEDIA`), `'media'` for everything else (segments, `#EXT-X-MAP` init
+     * sections, keys). Classified by extension, ignoring any query/fragment.
+     */
+    kind: 'playlist' | 'media';
+    /**
+     * The tag whose `URI="…"` attribute holds this reference (`'EXT-X-MEDIA'`, `'EXT-X-MAP'`,
+     * `'EXT-X-I-FRAME-STREAM-INF'`, …), or `undefined` for a plain URI line.
+     */
+    tag?: string;
+}
+/**
+ * Maps one playlist reference to the URI that should replace it. Return the input unchanged to
+ * keep a reference as-is. May be async — building the replacement routinely involves presigning.
+ */
+export type HlsUriRewriter = (ref: HlsUriRef) => string | Promise<string>;
+/**
+ * Rewrite every **relative** URI reference in an HLS playlist through `rewrite`, covering all the
+ * places RFC 8216 puts one:
+ *
+ * - plain URI lines (segments in a media playlist, variant playlists in a master playlist),
+ * - `URI="…"` attributes on tags (`#EXT-X-MEDIA` audio/subtitle renditions, `#EXT-X-MAP` init
+ *   sections, `#EXT-X-I-FRAME-STREAM-INF`, `#EXT-X-KEY`, …).
+ *
+ * Untouched, by design:
+ * - **absolute** references (`https://…`, protocol-relative `//…`, root-relative `/…`) — they no
+ *   longer describe the storage layout, so rewriting them is not this function's business;
+ * - comments and every other tag/line, byte for byte (line endings included).
+ */
+export declare function rewriteHlsPlaylist(content: string, rewrite: HlsUriRewriter): Promise<string>;
+/**
+ * Whether a playlist reference is relative to the playlist's own location — the only kind that
+ * describes the storage layout and therefore the only kind {@link rewriteHlsPlaylist} rewrites.
+ * Anything carrying a scheme (`https:`, `data:`), protocol-relative (`//cdn/…`) or root-relative
+ * (`/api/…`) is already an address, not a layout detail.
+ */
+export declare function isRelativeUri(uri: string): boolean;
+/** Classify a reference by extension (query/fragment ignored): `.m3u8` ⇒ playlist, else media. */
+export declare function classifyUri(uri: string): 'playlist' | 'media';
+/**
+ * Resolve a reference found in playlist `fromFile` (both package-relative) to the package-relative
+ * path it points at, collapsing `.`/`..` segments. Returns `null` when the reference escapes the
+ * package root — the caller treats that as "not one of ours" and leaves it alone.
+ */
+export declare function resolvePackagePath(fromFile: string, uri: string): string | null;
+/** Content type for one artifact of an HLS package, by extension. */
+export declare function hlsArtifactContentType(file: string): string | undefined;
+//# sourceMappingURL=playlist.d.ts.map

package/dist/src/hls/playlist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playlist.d.ts","sourceRoot":"","sources":["../../../src/hls/playlist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,2FAA2F;AAC3F,eAAO,MAAM,yBAAyB,kCAAkC,CAAC;AAEzE,yCAAyC;AACzC,eAAO,MAAM,wBAAwB,eAAe,CAAC;AAErD,mFAAmF;AACnF,MAAM,WAAW,SAAS;IACxB,sFAAsF;IACtF,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAC3B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,SAAS,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE1E;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAyBD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGlD;AAED,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAG7D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAe/E;AAED,qEAAqE;AACrE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASvE"}

package/dist/src/hls/playlist.js

@@ -0,0 +1,126 @@
+/**
+ * HLS playlist (`.m3u8`) reference rewriting — the read-side half of the HLS transformer.
+ *
+ * Playlists are STORED with references relative to the package's storage layout (that is what the
+ * muxer emits, and it keeps the stored artifacts location-agnostic). At serve time those
+ * references must become URLs the player can actually fetch — the app's authenticated proxy
+ * routes, presigned object URLs, a CDN — and only the app knows which. This module does the part
+ * that is the same everywhere: find every reference in a playlist, classify it, and let a
+ * callback decide the URL. See {@link HlsDeliveryHandler} for the assembled read path.
+ */
+/** Content type playlists are served with (RFC 8216's `application/vnd.apple.mpegurl`). */
+export const HLS_PLAYLIST_CONTENT_TYPE = 'application/vnd.apple.mpegurl';
+/** Content type for MPEG-TS segments. */
+export const HLS_SEGMENT_CONTENT_TYPE = 'video/mp2t';
+/**
+ * Rewrite every **relative** URI reference in an HLS playlist through `rewrite`, covering all the
+ * places RFC 8216 puts one:
+ *
+ * - plain URI lines (segments in a media playlist, variant playlists in a master playlist),
+ * - `URI="…"` attributes on tags (`#EXT-X-MEDIA` audio/subtitle renditions, `#EXT-X-MAP` init
+ *   sections, `#EXT-X-I-FRAME-STREAM-INF`, `#EXT-X-KEY`, …).
+ *
+ * Untouched, by design:
+ * - **absolute** references (`https://…`, protocol-relative `//…`, root-relative `/…`) — they no
+ *   longer describe the storage layout, so rewriting them is not this function's business;
+ * - comments and every other tag/line, byte for byte (line endings included).
+ */
+export async function rewriteHlsPlaylist(content, rewrite) {
+    // Split keeping the separators, so CRLF/LF survive exactly as they came.
+    const parts = content.split(/(\r?\n)/);
+    for (let i = 0; i < parts.length; i += 2) {
+        const line = parts[i];
+        if (line === undefined || line === '')
+            continue;
+        if (line.startsWith('#')) {
+            if (line.startsWith('#EXT'))
+                parts[i] = await rewriteTagUris(line, rewrite);
+            continue; // plain comment: untouched
+        }
+        const uri = line.trim();
+        if (uri === '' || !isRelativeUri(uri))
+            continue;
+        const replacement = await rewrite({ uri, kind: classifyUri(uri) });
+        // Preserve any surrounding whitespace on the line, replacing only the URI itself.
+        parts[i] = line.replace(uri, replacement);
+    }
+    return parts.join('');
+}
+const TAG_URI_ATTRIBUTE = /URI="([^"]*)"/g;
+/** Rewrite every relative `URI="…"` attribute on one tag line. */
+async function rewriteTagUris(line, rewrite) {
+    const colon = line.indexOf(':');
+    const tag = (colon === -1 ? line.slice(1) : line.slice(1, colon)).trim();
+    let output = '';
+    let consumed = 0;
+    for (const match of line.matchAll(TAG_URI_ATTRIBUTE)) {
+        const uri = match[1];
+        output += line.slice(consumed, match.index);
+        if (uri !== '' && isRelativeUri(uri)) {
+            const replacement = await rewrite({ uri, kind: classifyUri(uri), tag });
+            output += `URI="${replacement}"`;
+        }
+        else {
+            output += match[0];
+        }
+        consumed = match.index + match[0].length;
+    }
+    return output + line.slice(consumed);
+}
+/**
+ * Whether a playlist reference is relative to the playlist's own location — the only kind that
+ * describes the storage layout and therefore the only kind {@link rewriteHlsPlaylist} rewrites.
+ * Anything carrying a scheme (`https:`, `data:`), protocol-relative (`//cdn/…`) or root-relative
+ * (`/api/…`) is already an address, not a layout detail.
+ */
+export function isRelativeUri(uri) {
+    if (uri.startsWith('/'))
+        return false; // covers '//' too
+    return !/^[a-z][a-z0-9+.-]*:/i.test(uri);
+}
+/** Classify a reference by extension (query/fragment ignored): `.m3u8` ⇒ playlist, else media. */
+export function classifyUri(uri) {
+    const clean = uri.split(/[?#]/, 1)[0];
+    return clean.toLowerCase().endsWith('.m3u8') ? 'playlist' : 'media';
+}
+/**
+ * Resolve a reference found in playlist `fromFile` (both package-relative) to the package-relative
+ * path it points at, collapsing `.`/`..` segments. Returns `null` when the reference escapes the
+ * package root — the caller treats that as "not one of ours" and leaves it alone.
+ */
+export function resolvePackagePath(fromFile, uri) {
+    const clean = uri.split(/[?#]/, 1)[0];
+    const slash = fromFile.lastIndexOf('/');
+    const base = slash === -1 ? '' : fromFile.slice(0, slash + 1);
+    const resolved = [];
+    for (const segment of `${base}${clean}`.split('/')) {
+        if (segment === '' || segment === '.')
+            continue;
+        if (segment === '..') {
+            if (resolved.length === 0)
+                return null;
+            resolved.pop();
+            continue;
+        }
+        resolved.push(segment);
+    }
+    return resolved.length === 0 ? null : resolved.join('/');
+}
+/** Content type for one artifact of an HLS package, by extension. */
+export function hlsArtifactContentType(file) {
+    const lower = file.toLowerCase();
+    if (lower.endsWith('.m3u8'))
+        return HLS_PLAYLIST_CONTENT_TYPE;
+    if (lower.endsWith('.ts'))
+        return HLS_SEGMENT_CONTENT_TYPE;
+    if (lower.endsWith('.m4s') || lower.endsWith('.mp4'))
+        return 'video/mp4';
+    if (lower.endsWith('.aac'))
+        return 'audio/aac';
+    if (lower.endsWith('.mp3'))
+        return 'audio/mpeg';
+    if (lower.endsWith('.vtt'))
+        return 'text/vtt';
+    return undefined;
+}
+//# sourceMappingURL=playlist.js.map

package/dist/src/hls/playlist.js.map

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

package/dist/src/index.d.ts

@@ -1,17 +1,32 @@
-export { defineConfig, stores, processors, disks, uploadSessions } from './define_config.js';
-export type { MediaConfig, MediaUploadsConfig, MediaResumableConfig, MediaDeliveryConfig, StoreContext, StoreFactory, LucidStoreConfig, ImageProcessorFactory, DiskFactory, S3DiskConfig, S3Credentials, UploadMode, UploadSessionStoreContext, UploadSessionStoreFactory, LucidUploadSessionStoreConfig, } from './define_config.js';
+export { defineConfig, stores, processors, disks, uploadSessions, transformers, } from './define_config.js';
+export type { InferConversions, InferTransformers, MediaConfig, MediaUploadsConfig, MediaResumableConfig, MediaDirectUploadConfig, MediaDeliveryConfig, StoreContext, StoreFactory, LucidStoreConfig, ImageProcessorFactory, DiskFactory, S3DiskConfig, S3Credentials, UploadMode, UploadSessionStoreContext, UploadSessionStoreFactory, LucidUploadSessionStoreConfig, } from './define_config.js';
 export { MediaManager } from './media_manager.js';
 export type { MediaManagerOptions } from './media_manager.js';
 export { UploadManager } from './upload_manager.js';
 export type { UploadManagerOptions, InitiateDirectUploadInput, DirectUploadCreated, PresignPartInput, CompleteDirectUploadInput, AbortDirectUploadInput, ProxyUploadInput, } from './upload_manager.js';
 export { resolveUploadMode } from './upload_mode.js';
 export type { ResolvedUploadMode, UploadModeLevels } from './upload_mode.js';
+export { DirectUploadManager, DEFAULT_DIRECT_PART_SIZE, MIN_DIRECT_PART_SIZE, MAX_DIRECT_PARTS, } from './direct_upload.js';
+export type { DirectUploadManagerOptions, DirectUploadInitiateInput, DirectUploadCreatedSession, DirectUploadStatus, DirectUploadPartUrl, } from './direct_upload.js';
+export { DirectUploadHandler } from './direct_upload_handler.js';
+export type { DirectUploadHandlerOptions, DirectUploadRequest, DirectUploadResponse, } from './direct_upload_handler.js';
+export { presignS3Url } from './disks/sigv4.js';
+export type { PresignS3UrlInput, SigV4Credentials } from './disks/sigv4.js';
 export { ResumableUploadManager } from './resumable_upload.js';
 export type { ResumableUploadManagerOptions, UploadSession, UploadSessionStore, UploadSessionListFilter, CreateUploadInput, } from './resumable_upload.js';
 export { TusUploadHandler, parseTusMetadata, TUS_VERSION } from './tus.js';
 export type { TusRequest, TusResponse, TusUploadHandlerOptions } from './tus.js';
 export { MediaDeliveryHandler, resolveDeliveryMode, DEFAULT_DELIVERY_SIGNED_TTL_SECONDS, } from './delivery.js';
 export type { DeliveryMode, ResolvedDeliveryMode, DeliveryResult, DeliveryRequest, MediaDeliveryHandlerOptions, } from './delivery.js';
+export type { Transformer, TransformerContext, TransformerWriteOptions, TransformResult, } from './transformer.js';
+export { HlsTransformer, HLS_ENTRY_PLAYLIST, resolveWebCodecsSupport } from './transformers/hls.js';
+export type { HlsTransformerOptions, HlsRemuxEngine, HlsRemuxRequest, HlsRemuxSummary, WebCodecsProvider, WebCodecsSupport, } from './transformers/hls.js';
+export { MetadataProbeTransformer } from './transformers/probe.js';
+export type { MetadataProbeTransformerOptions, MediaProbeEngine, MediaProbeSummary, } from './transformers/probe.js';
+export { rewriteHlsPlaylist, isRelativeUri, classifyUri, resolvePackagePath, hlsArtifactContentType, HLS_PLAYLIST_CONTENT_TYPE, HLS_SEGMENT_CONTENT_TYPE, } from './hls/playlist.js';
+export type { HlsUriRef, HlsUriRewriter } from './hls/playlist.js';
+export { HlsDeliveryHandler } from './hls/delivery.js';
+export type { HlsDeliveryHandlerOptions, HlsDeliveryRequest, HlsDeliveryResult, HlsFileRef, HlsUrlBuilder, } from './hls/delivery.js';
 export { detectMimeType, isDetectableMimeType, isClosedSignatureWhitelist, verifyContentAgainstWhitelist, SIGNATURE_HEAD_BYTES, } from './content_type.js';
 export type { ContentVerdict } from './content_type.js';
 export { createDriveBackedResolver } from './disks/drive.js';
@@ -32,6 +47,6 @@ export type { MediaCollectionConfig } from './media_collection.js';
 export type { ConversionPreset, ConversionResult, ImageProcessor } from './image_processor.js';
 export type { Disk, DiskResolver, DiskWriteOptions, DiskMetaData, SignedUrlOptions, MultipartPart, MultipartUploadDisk, ExtendedDisk, DiskCapabilities, DiskStat, CopyOptions, ListOptions, ListEntry, ListResult, } from './types.js';
 export type { MediaDiagnosticEvent, MediaDiagnosticPayloads, AttachPayload, DeletePayload, ConversionPayload, AttachmentCreatePayload, AttachmentDeletePayload, UploadStartPayload, UploadProgressPayload, UploadCompletePayload, UploadAbortPayload, } from './diagnostics.js';
-export { MimeNotAllowedError, ContentTypeMismatchError, ContentSignatureUnrecognizedError, DriveNotReadyError, MediaNotFoundError, MediaObjectMissingError, ConversionNotDefinedError, ImageProcessorMissingError, VariantNotFoundError, StoreNotConfiguredError, UploadNotSupportedError, UploadSessionNotFoundError, UploadOffsetConflictError, UploadSessionExpiredError, UploadSessionStoreNotConfiguredError, ResumableUploadsNotConfiguredError, } from './errors.js';
+export { MimeNotAllowedError, ContentTypeMismatchError, ContentSignatureUnrecognizedError, DriveNotReadyError, MediaNotFoundError, MediaObjectMissingError, ConversionNotDefinedError, ConversionArtifactMissingError, TransformerNotDefinedError, TransformNotReadyError, TransformerConflictError, TransformerRuntimeMissingError, TransformerOutputError, HlsSourceUnsupportedError, ImageProcessorMissingError, VariantNotFoundError, StoreNotConfiguredError, UploadNotSupportedError, UploadSessionNotFoundError, UploadOffsetConflictError, UploadSessionExpiredError, UploadSessionStoreNotConfiguredError, ResumableUploadsNotConfiguredError, DirectUploadsNotConfiguredError, UploadPartSizeError, UploadPartOutOfRangeError, UploadPartsIncompleteError, } from './errors.js';
 export { configure } from '../configure.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC7F,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,UAAU,EACV,yBAAyB,EACzB,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACV,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,gBAAgB,EAChB,yBAAyB,EACzB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAG7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,YAAY,EACV,6BAA6B,EAC7B,aAAa,EACb,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC3E,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAEjF,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,mCAAmC,GACpC,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,2BAA2B,GAC5B,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,0BAA0B,EAC1B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACjG,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC/F,YAAY,EACV,IAAI,EACJ,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,iCAAiC,EACjC,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,oCAAoC,EACpC,kCAAkC,GACnC,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/index.js

@@ -1,15 +1,26 @@
 // Config idiom
-export { defineConfig, stores, processors, disks, uploadSessions } from './define_config.js';
+export { defineConfig, stores, processors, disks, uploadSessions, transformers, } from './define_config.js';
 // Manager + layers
 export { MediaManager } from './media_manager.js';
 // Direct-S3 upload modes (proxy + direct multipart)
 export { UploadManager } from './upload_manager.js';
 export { resolveUploadMode } from './upload_mode.js';
+// Session-backed direct uploads (browser→S3 multipart with a persisted, resumable session)
+export { DirectUploadManager, DEFAULT_DIRECT_PART_SIZE, MIN_DIRECT_PART_SIZE, MAX_DIRECT_PARTS, } from './direct_upload.js';
+export { DirectUploadHandler } from './direct_upload_handler.js';
+// Hand-rolled SigV4 query presigner (what the S3 disk signs part/GET URLs with; exported for
+// wiring presigned URLs outside the bundled disk)
+export { presignS3Url } from './disks/sigv4.js';
 // Resumable (TUS) uploads
 export { ResumableUploadManager } from './resumable_upload.js';
 export { TusUploadHandler, parseTusMetadata, TUS_VERSION } from './tus.js';
 // Configurable delivery (the read-side counterpart to the upload modes)
 export { MediaDeliveryHandler, resolveDeliveryMode, DEFAULT_DELIVERY_SIGNED_TTL_SECONDS, } from './delivery.js';
+export { HlsTransformer, HLS_ENTRY_PLAYLIST, resolveWebCodecsSupport } from './transformers/hls.js';
+export { MetadataProbeTransformer } from './transformers/probe.js';
+// HLS delivery (playlist rewriting + the framework-agnostic package handler)
+export { rewriteHlsPlaylist, isRelativeUri, classifyUri, resolvePackagePath, hlsArtifactContentType, HLS_PLAYLIST_CONTENT_TYPE, HLS_SEGMENT_CONTENT_TYPE, } from './hls/playlist.js';
+export { HlsDeliveryHandler } from './hls/delivery.js';
 // Real-content validation (magic-byte signatures behind `acceptsMimeTypes`)
 export { detectMimeType, isDetectableMimeType, isClosedSignatureWhitelist, verifyContentAgainstWhitelist, SIGNATURE_HEAD_BYTES, } from './content_type.js';
 // Drive-backed disk resolution (the provider's resolver; exported for wiring media outside AdonisJS)
@@ -22,7 +33,7 @@ export { StorageManager } from './storage_manager.js';
 export { DEFAULT_MEDIA_LIST_LIMIT, MAX_MEDIA_LIST_LIMIT, encodeMediaCursor, decodeMediaCursor, clampMediaListLimit, } from './media_store.js';
 export { MediaCollectionRegistry } from './media_collection.js';
 // Errors
-export { MimeNotAllowedError, ContentTypeMismatchError, ContentSignatureUnrecognizedError, DriveNotReadyError, MediaNotFoundError, MediaObjectMissingError, ConversionNotDefinedError, ImageProcessorMissingError, VariantNotFoundError, StoreNotConfiguredError, UploadNotSupportedError, UploadSessionNotFoundError, UploadOffsetConflictError, UploadSessionExpiredError, UploadSessionStoreNotConfiguredError, ResumableUploadsNotConfiguredError, } from './errors.js';
+export { MimeNotAllowedError, ContentTypeMismatchError, ContentSignatureUnrecognizedError, DriveNotReadyError, MediaNotFoundError, MediaObjectMissingError, ConversionNotDefinedError, ConversionArtifactMissingError, TransformerNotDefinedError, TransformNotReadyError, TransformerConflictError, TransformerRuntimeMissingError, TransformerOutputError, HlsSourceUnsupportedError, ImageProcessorMissingError, VariantNotFoundError, StoreNotConfiguredError, UploadNotSupportedError, UploadSessionNotFoundError, UploadOffsetConflictError, UploadSessionExpiredError, UploadSessionStoreNotConfiguredError, ResumableUploadsNotConfiguredError, DirectUploadsNotConfiguredError, UploadPartSizeError, UploadPartOutOfRangeError, UploadPartsIncompleteError, } from './errors.js';
 // `node ace configure` reaches the hook through this entry point, not through the package's
 // `./configure` export path.
 export { configure } from '../configure.js';

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAmB7F,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,oDAAoD;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAUpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,0BAA0B;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAQ/D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE3E,wEAAwE;AACxE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,mCAAmC,GACpC,MAAM,eAAe,CAAC;AASvB,4EAA4E;AAC5E,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,0BAA0B,EAC1B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,qGAAqG;AACrG,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAO7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AASlD,OAAO,EACL,UAAU,EACV,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAMtD,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAmChE,SAAS;AACT,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,iCAAiC,EACjC,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,oCAAoC,EACpC,kCAAkC,GACnC,MAAM,aAAa,CAAC;AAErB,4FAA4F;AAC5F,6BAA6B;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EACL,YAAY,EACZ,MAAM,EACN,UAAU,EACV,KAAK,EACL,cAAc,EACd,YAAY,GACb,MAAM,oBAAoB,CAAC;AAsB5B,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,oDAAoD;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAUpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,2FAA2F;AAC3F,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAOjE,6FAA6F;AAC7F,kDAAkD;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,0BAA0B;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAQ/D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE3E,wEAAwE;AACxE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,mCAAmC,GACpC,MAAM,eAAe,CAAC;AAgBvB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AASpG,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAOnE,6EAA6E;AAC7E,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AASvD,4EAA4E;AAC5E,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,0BAA0B,EAC1B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,qGAAqG;AACrG,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAO7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AASlD,OAAO,EACL,UAAU,EACV,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAMtD,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAmChE,SAAS;AACT,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,iCAAiC,EACjC,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,8BAA8B,EAC9B,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,8BAA8B,EAC9B,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,oCAAoC,EACpC,kCAAkC,EAClC,+BAA+B,EAC/B,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAErB,4FAA4F;AAC5F,6BAA6B;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/media_collection.d.ts

@@ -1,4 +1,5 @@
 import type { ConversionPreset } from './image_processor.js';
+import type { Transformer } from './transformer.js';
 export interface MediaCollectionConfig {
     name: string;
     /** Single-file collection: attaching replaces any existing media. */
@@ -9,10 +10,16 @@ export interface MediaCollectionConfig {
     acceptsMimeTypes?: string[];
     /** Image conversion presets available for this collection. */
     conversions?: ConversionPreset[];
+    /**
+     * Content transformers available for this collection (e.g. `transformers.hls()`). Each produces
+     * a named entry in `record.conversions`, so transformer names and preset names share one
+     * namespace — a collision throws {@link TransformerConflictError} at construction.
+     */
+    transformers?: Transformer[];
 }
 export declare class MediaCollectionRegistry {
     private readonly map;
-    constructor(collections?: MediaCollectionConfig[]);
+    constructor(collections?: readonly MediaCollectionConfig[]);
     /** Registered config for a collection, or a permissive default. */
     get(name: string): MediaCollectionConfig;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"media_collection.d.ts","sourceRoot":"","sources":["../../src/media_collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,8DAA8D;IAC9D,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA4C;gBAEpD,WAAW,GAAE,qBAAqB,EAAO;IAIrD,mEAAmE;IACnE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB;CAGzC"}
+{"version":3,"file":"media_collection.d.ts","sourceRoot":"","sources":["../../src/media_collection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,8DAA8D;IAC9D,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACjC;;;;OAIG;IACH,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;CAC9B;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA4C;gBAEpD,WAAW,GAAE,SAAS,qBAAqB,EAAO;IAO9D,mEAAmE;IACnE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB;CAGzC"}