@adonis-agora/media 0.8.2 → 0.9.0

package/dist/src/transformers/hls.js

@@ -0,0 +1,111 @@
+import { createReadStream } from 'node:fs';
+import { readdir, stat } from 'node:fs/promises';
+import { mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { hlsArtifactContentType } from '../hls/playlist.js';
+import { loadMediabunny } from './mediabunny_loader.js';
+import { withSourceFile } from './source_file.js';
+/**
+ * Detect how (whether) WebCodecs is available: `'native'` when the runtime already exposes
+ * `VideoEncoder`, `'injected'` when a {@link WebCodecsProvider} supplies one, `'absent'` otherwise.
+ * `'absent'` means encoding is impossible — transforms stay stream-copy only, and a transformer
+ * that cannot proceed without an encoder should throw `TransformerRuntimeMissingError`.
+ */
+export async function resolveWebCodecsSupport(provider) {
+    if (globalThis.VideoEncoder !== undefined)
+        return 'native';
+    if (provider && (await provider()).VideoEncoder !== undefined)
+        return 'injected';
+    return 'absent';
+}
+/** File name of the entry (master) playlist an {@link HlsTransformer} produces. */
+export const HLS_ENTRY_PLAYLIST = 'index.m3u8';
+/**
+ * The built-in video {@link Transformer}: converts a stored video into an HLS package — MPEG-TS
+ * segments plus media playlists behind one master playlist — written under the conversion prefix
+ * and persisted as `record.conversions['hls']` with duration/resolution/codec metadata.
+ *
+ * **Remux-only by default.** The engine (mediabunny, pure JS — no ffmpeg binary) stream-copies
+ * the source's h264/aac tracks into segments without re-encoding, because encoding needs
+ * WebCodecs, which Node does not provide. Two consequences, both deliberate:
+ *
+ * - a source whose codecs MPEG-TS cannot carry (vp9, av1…) fails with a clear, definitive
+ *   `HlsSourceUnsupportedError` — unless a {@link WebCodecsProvider} is configured, which enables
+ *   the engine's re-encode fallback;
+ * - the package has a single variant at the original resolution. Multi-quality renditions are the
+ *   documented evolution once an encoder is present (mediabunny supports fan-out video options),
+ *   not something this transformer fakes today.
+ *
+ * The engine also carries the subtle bit the naive implementation gets wrong: AAC audio with
+ * priming (an mp4 edit list) starts at a **negative** timestamp, and a conversion trimmed at t=0
+ * would kick that track off the stream-copy fast path — impossible without an encoder. The
+ * conversion is therefore trimmed at the source's real first timestamp, shifting all tracks
+ * equally (sync is unchanged) and keeping every track copyable.
+ *
+ * Serving the result is the other half: playlists are stored with storage-relative references and
+ * must be rewritten per request — see {@link HlsDeliveryHandler}.
+ */
+export class HlsTransformer {
+    name;
+    eager;
+    targetDuration;
+    webcodecs;
+    engine;
+    constructor(options = {}) {
+        this.name = options.name ?? 'hls';
+        this.eager = options.eager ?? false;
+        this.targetDuration = options.targetDuration ?? 4;
+        this.webcodecs = options.webcodecs;
+        this.engine = options.engine;
+    }
+    async transform(context) {
+        const engine = this.engine ?? (await loadMediabunny(this.name)).createHlsEngine();
+        return withSourceFile(context, async ({ sourcePath, tempDir }) => {
+            const outputDir = join(tempDir, 'hls');
+            await mkdir(outputDir, { recursive: true });
+            const summary = await engine.remux({
+                sourcePath,
+                outputDir,
+                entryName: HLS_ENTRY_PLAYLIST,
+                targetDuration: this.targetDuration,
+                webcodecs: this.webcodecs,
+            });
+            // Upload the whole package the engine wrote — playlists and segments alike — streaming each
+            // file (a segment never has to fit in memory). Sorted for deterministic order in
+            // `conversions[name].files`.
+            const files = (await readdir(outputDir, { recursive: true })).sort();
+            let segmentCount = 0;
+            let playlistCount = 0;
+            for (const file of files) {
+                const relative = file.split('\\').join('/');
+                const local = join(outputDir, file);
+                const info = await stat(local);
+                if (!info.isFile())
+                    continue;
+                if (relative.toLowerCase().endsWith('.m3u8'))
+                    playlistCount += 1;
+                else
+                    segmentCount += 1;
+                const contentType = hlsArtifactContentType(relative);
+                await context.write(relative, createReadStream(local), {
+                    contentLength: info.size,
+                    ...(contentType !== undefined ? { contentType } : {}),
+                });
+            }
+            return {
+                entry: HLS_ENTRY_PLAYLIST,
+                meta: compactMeta({
+                    ...summary,
+                    segmentCount,
+                    playlistCount,
+                    targetDuration: this.targetDuration,
+                }),
+            };
+        });
+    }
+}
+/** Drop `undefined` values so the persisted meta round-trips identically through JSON stores. */
+export function compactMeta(meta) {
+    return Object.fromEntries(Object.entries(meta).filter(([, value]) => value !== undefined));
+}
+//# sourceMappingURL=hls.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hls.js","sourceRoot":"","sources":["../../../src/transformers/hls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAqBlD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,QAA4B;IAE5B,IAAK,UAAsC,CAAC,YAAY,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACxF,IAAI,QAAQ,IAAI,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAC,YAAY,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IACjF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAoDD,mFAAmF;AACnF,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,cAAc;IAChB,IAAI,CAAO;IACX,KAAK,CAAU;IACP,cAAc,CAAS;IACvB,SAAS,CAAgC;IACzC,MAAM,CAA6B;IAEpD,YAAY,UAAuC,EAAE;QACnD,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAK,KAAc,CAAC;QAC5C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;QACpC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAA2B;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;QAElF,OAAO,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE;YAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACvC,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE5C,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;gBACjC,UAAU;gBACV,SAAS;gBACT,SAAS,EAAE,kBAAkB;gBAC7B,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAC,CAAC;YAEH,4FAA4F;YAC5F,iFAAiF;YACjF,6BAA6B;YAC7B,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACrE,IAAI,YAAY,GAAG,CAAC,CAAC;YACrB,IAAI,aAAa,GAAG,CAAC,CAAC;YACtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;gBACpC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC/B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;oBAAE,SAAS;gBAC7B,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAAE,aAAa,IAAI,CAAC,CAAC;;oBAC5D,YAAY,IAAI,CAAC,CAAC;gBACvB,MAAM,WAAW,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;gBACrD,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAAE;oBACrD,aAAa,EAAE,IAAI,CAAC,IAAI;oBACxB,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACtD,CAAC,CAAC;YACL,CAAC;YAED,OAAO;gBACL,KAAK,EAAE,kBAAkB;gBACzB,IAAI,EAAE,WAAW,CAAC;oBAChB,GAAG,OAAO;oBACV,YAAY;oBACZ,aAAa;oBACb,cAAc,EAAE,IAAI,CAAC,cAAc;iBACpC,CAAC;aACH,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,iGAAiG;AACjG,MAAM,UAAU,WAAW,CAAC,IAA6B;IACvD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC;AAC7F,CAAC"}

package/dist/src/transformers/mediabunny.d.ts

@@ -0,0 +1,5 @@
+import type { HlsRemuxEngine } from './hls.js';
+import type { MediaProbeEngine } from './probe.js';
+export declare function createHlsEngine(): HlsRemuxEngine;
+export declare function createProbeEngine(): MediaProbeEngine;
+//# sourceMappingURL=mediabunny.d.ts.map

package/dist/src/transformers/mediabunny.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediabunny.d.ts","sourceRoot":"","sources":["../../../src/transformers/mediabunny.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAuD,MAAM,UAAU,CAAC;AACpG,OAAO,KAAK,EAAE,gBAAgB,EAAqB,MAAM,YAAY,CAAC;AA+DtE,wBAAgB,eAAe,IAAI,cAAc,CA8DhD;AAED,wBAAgB,iBAAiB,IAAI,gBAAgB,CAiCpD"}

package/dist/src/transformers/mediabunny.js

@@ -0,0 +1,150 @@
+import { join } from 'node:path';
+import { ALL_FORMATS, Conversion, FilePathSource, FilePathTarget, HlsOutputFormat, Input, MpegTsOutputFormat, Output, PathedTarget, } from 'mediabunny';
+import { HlsSourceUnsupportedError } from '../errors.js';
+/**
+ * The mediabunny-backed engines — the ONLY module in the package that imports the optional
+ * `mediabunny` peer, reached lazily through `mediabunny_loader.ts` at first transform.
+ *
+ * Why mediabunny: pure TypeScript, no ffmpeg binary — a production container without system
+ * ffmpeg (the usual case) remuxes fine. The trade-off is that *encoding* rides on WebCodecs,
+ * which Node lacks, hence the remux-only default and the {@link WebCodecsProvider} injection
+ * seam documented on `HlsTransformer`.
+ */
+/** The WebCodecs API surface mediabunny reads from `globalThis`. */
+const WEBCODECS_GLOBALS = [
+    'VideoEncoder',
+    'VideoDecoder',
+    'AudioEncoder',
+    'AudioDecoder',
+    'VideoFrame',
+    'AudioData',
+    'EncodedVideoChunk',
+    'EncodedAudioChunk',
+];
+/**
+ * Install an injected WebCodecs implementation onto `globalThis` — only the classes that are
+ * missing; a native implementation is never overwritten. Global mutation is deliberate and
+ * additive: `globalThis` is where the WebCodecs spec (and therefore mediabunny) looks the API up,
+ * so "injecting an implementation" and "installing it globally" are the same thing. Installing
+ * per-conversion and uninstalling after would race concurrent transforms for zero benefit.
+ */
+async function installWebCodecs(provider) {
+    if (!provider)
+        return;
+    const implementation = await provider();
+    const globals = globalThis;
+    for (const name of WEBCODECS_GLOBALS) {
+        if (globals[name] === undefined && implementation[name] !== undefined) {
+            globals[name] = implementation[name];
+        }
+    }
+}
+/** Best-effort technical summary of an input — never fails the transform over metadata. */
+async function summarize(input) {
+    const summary = {};
+    try {
+        summary.durationSeconds = await input.computeDuration();
+        const video = await input.getPrimaryVideoTrack();
+        if (video) {
+            summary.width = await video.getDisplayWidth();
+            summary.height = await video.getDisplayHeight();
+            summary.videoCodec = await video.getCodec();
+        }
+        const audio = await input.getPrimaryAudioTrack();
+        if (audio) {
+            summary.audioCodec = await audio.getCodec();
+        }
+    }
+    catch {
+        // metadata is a bonus; the artifacts are the product
+    }
+    return summary;
+}
+export function createHlsEngine() {
+    return {
+        async remux(request) {
+            await installWebCodecs(request.webcodecs);
+            const input = new Input({
+                source: new FilePathSource(request.sourcePath),
+                formats: ALL_FORMATS,
+            });
+            try {
+                const output = new Output({
+                    format: new HlsOutputFormat({
+                        segmentFormat: new MpegTsOutputFormat(),
+                        targetDuration: request.targetDuration,
+                    }),
+                    // The HLS output is many files; each one lands in the local output directory.
+                    target: new PathedTarget(join(request.outputDir, request.entryName), (target) => new FilePathTarget(target.path)),
+                });
+                // THE gotcha: AAC audio with priming (an mp4 edit list) starts at a NEGATIVE timestamp.
+                // Mediabunny's default trims the conversion at t=0, which would throw that audio track off
+                // the packet-copy fast path — and re-encoding it needs an encoder we may not have.
+                // Trimming at the source's real first timestamp keeps every track a pure stream copy; all
+                // tracks shift equally, so A/V sync is untouched.
+                const firstTimestamp = await input.getFirstTimestamp();
+                const conversion = await Conversion.init({
+                    input,
+                    output,
+                    trim: { start: firstTimestamp },
+                });
+                // With no video/audio options, mediabunny copies compatible tracks and re-encodes the
+                // rest — but re-encoding needs an encoder, so without WebCodecs an incompatible track is
+                // DISCARDED instead. Silently shipping a video without its audio (or vice versa) is not a
+                // conversion, it is data loss: fail loudly, with the codec and the reason per track.
+                if (conversion.discardedTracks.length > 0) {
+                    const reasons = await Promise.all(conversion.discardedTracks.map(async (discarded) => {
+                        const codec = await discarded.track.getCodec().catch(() => null);
+                        return `${discarded.track.type}/${codec ?? 'unknown'}: ${discarded.reason}`;
+                    }));
+                    throw new HlsSourceUnsupportedError(reasons.join('; '));
+                }
+                if (!conversion.isValid) {
+                    throw new HlsSourceUnsupportedError('the file contains no usable track');
+                }
+                const summary = await summarize(input);
+                await conversion.execute();
+                return summary;
+            }
+            finally {
+                input.dispose();
+            }
+        },
+    };
+}
+export function createProbeEngine() {
+    return {
+        async probe(sourcePath) {
+            const input = new Input({ source: new FilePathSource(sourcePath), formats: ALL_FORMATS });
+            try {
+                const format = await input.getFormat();
+                const summary = {
+                    format: format.name,
+                    mimeType: await input.getMimeType(),
+                    durationSeconds: await input.computeDuration(),
+                    hasVideo: false,
+                    hasAudio: false,
+                };
+                const video = await input.getPrimaryVideoTrack();
+                if (video) {
+                    summary.hasVideo = true;
+                    summary.width = await video.getDisplayWidth();
+                    summary.height = await video.getDisplayHeight();
+                    summary.videoCodec = await video.getCodec();
+                }
+                const audio = await input.getPrimaryAudioTrack();
+                if (audio) {
+                    summary.hasAudio = true;
+                    summary.audioCodec = await audio.getCodec();
+                    summary.audioSampleRate = await audio.getSampleRate();
+                    summary.audioChannels = await audio.getNumberOfChannels();
+                }
+                return summary;
+            }
+            finally {
+                input.dispose();
+            }
+        },
+    };
+}
+//# sourceMappingURL=mediabunny.js.map

package/dist/src/transformers/mediabunny.js.map

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

package/dist/src/transformers/mediabunny_loader.d.ts

@@ -0,0 +1,15 @@
+import type { HlsRemuxEngine } from './hls.js';
+import type { MediaProbeEngine } from './probe.js';
+/** The engine factories `./mediabunny.js` exports (the only module that imports the peer). */
+export interface MediabunnyEngineModule {
+    createHlsEngine(): HlsRemuxEngine;
+    createProbeEngine(): MediaProbeEngine;
+}
+/**
+ * Load the mediabunny-backed engine module, translating a missing optional peer into the typed
+ * {@link TransformerRuntimeMissingError} instead of a raw `ERR_MODULE_NOT_FOUND` five imports deep.
+ * Import happens here — at first transform — never at boot: configuring a transformer must not
+ * load its engine (the same laziness `processors.sharp()` and `disks.s3()` follow).
+ */
+export declare function loadMediabunny(transformerName: string): Promise<MediabunnyEngineModule>;
+//# sourceMappingURL=mediabunny_loader.d.ts.map

package/dist/src/transformers/mediabunny_loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediabunny_loader.d.ts","sourceRoot":"","sources":["../../../src/transformers/mediabunny_loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,8FAA8F;AAC9F,MAAM,WAAW,sBAAsB;IACrC,eAAe,IAAI,cAAc,CAAC;IAClC,iBAAiB,IAAI,gBAAgB,CAAC;CACvC;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAiB7F"}

package/dist/src/transformers/mediabunny_loader.js

@@ -0,0 +1,21 @@
+import { TransformerRuntimeMissingError } from '../errors.js';
+/**
+ * Load the mediabunny-backed engine module, translating a missing optional peer into the typed
+ * {@link TransformerRuntimeMissingError} instead of a raw `ERR_MODULE_NOT_FOUND` five imports deep.
+ * Import happens here — at first transform — never at boot: configuring a transformer must not
+ * load its engine (the same laziness `processors.sharp()` and `disks.s3()` follow).
+ */
+export async function loadMediabunny(transformerName) {
+    try {
+        return await import('./mediabunny.js');
+    }
+    catch (error) {
+        if (error.code === 'ERR_MODULE_NOT_FOUND' &&
+            error instanceof Error &&
+            error.message.includes('mediabunny')) {
+            throw new TransformerRuntimeMissingError(transformerName, "the optional peer dependency 'mediabunny'", 'Install it (`pnpm add mediabunny`) or inject a custom `engine`.');
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=mediabunny_loader.js.map

package/dist/src/transformers/mediabunny_loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediabunny_loader.js","sourceRoot":"","sources":["../../../src/transformers/mediabunny_loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAU9D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,eAAuB;IAC1D,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACG,KAA2B,CAAC,IAAI,KAAK,sBAAsB;YAC5D,KAAK,YAAY,KAAK;YACtB,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EACpC,CAAC;YACD,MAAM,IAAI,8BAA8B,CACtC,eAAe,EACf,2CAA2C,EAC3C,iEAAiE,CAClE,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/src/transformers/probe.d.ts

@@ -0,0 +1,56 @@
+import type { TransformResult, Transformer, TransformerContext } from '../transformer.js';
+/** What probing a media file yields — persisted verbatim as the conversion's `meta`. */
+export interface MediaProbeSummary {
+    /** Container format name (e.g. `MP4`), when the engine can tell. */
+    format?: string;
+    /** Full MIME type including codecs parameter, when the engine can tell. */
+    mimeType?: string;
+    durationSeconds?: number;
+    width?: number;
+    height?: number;
+    videoCodec?: string | null;
+    audioCodec?: string | null;
+    audioSampleRate?: number;
+    audioChannels?: number;
+    hasVideo: boolean;
+    hasAudio: boolean;
+}
+/**
+ * The engine seam of {@link MetadataProbeTransformer}: local file in, metadata out. Default engine
+ * is mediabunny (lazy); tests inject a fake.
+ */
+export interface MediaProbeEngine {
+    probe(sourcePath: string): Promise<MediaProbeSummary>;
+}
+export interface MetadataProbeTransformerOptions<Name extends string = 'probe'> {
+    /** Conversion name on the record. Default `'probe'`. */
+    name?: Name;
+    /**
+     * Run inside attach. Default `false`: probing is CPU-cheap but reads the original, and on a
+     * remote disk that read is a download. Opt in for collections of small files.
+     */
+    eager?: boolean;
+    /** Replace the mediabunny engine (mainly for tests). */
+    engine?: MediaProbeEngine;
+}
+/**
+ * The built-in **metadata-only** {@link Transformer}: reads a media file's technical metadata —
+ * duration, resolution, codecs, channel layout — and persists it as
+ * `record.conversions['probe'].meta`, writing **no artifact at all**. The reference implementation
+ * of the "derive metadata, not files" transformer shape; the model for a blurhash/thumbhash
+ * placeholder transformer.
+ *
+ * ```ts
+ * await media.library.transform(id, 'probe')
+ * const record = await media.library.find(id)
+ * record.conversions.probe?.meta // { durationSeconds: 41.6, width: 1920, ... }
+ * ```
+ */
+export declare class MetadataProbeTransformer<Name extends string = 'probe'> implements Transformer {
+    readonly name: Name;
+    readonly eager: boolean;
+    private readonly engine;
+    constructor(options?: MetadataProbeTransformerOptions<Name>);
+    transform(context: TransformerContext): Promise<TransformResult>;
+}
+//# sourceMappingURL=probe.d.ts.map

package/dist/src/transformers/probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../../src/transformers/probe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAK1F,wFAAwF;AACxF,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,+BAA+B,CAAC,IAAI,SAAS,MAAM,GAAG,OAAO;IAC5E,wDAAwD;IACxD,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,wBAAwB,CAAC,IAAI,SAAS,MAAM,GAAG,OAAO,CAAE,YAAW,WAAW;IACzF,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;gBAE1C,OAAO,GAAE,+BAA+B,CAAC,IAAI,CAAM;IAMzD,SAAS,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC;CAKvE"}

package/dist/src/transformers/probe.js

@@ -0,0 +1,32 @@
+import { compactMeta } from './hls.js';
+import { loadMediabunny } from './mediabunny_loader.js';
+import { withSourceFile } from './source_file.js';
+/**
+ * The built-in **metadata-only** {@link Transformer}: reads a media file's technical metadata —
+ * duration, resolution, codecs, channel layout — and persists it as
+ * `record.conversions['probe'].meta`, writing **no artifact at all**. The reference implementation
+ * of the "derive metadata, not files" transformer shape; the model for a blurhash/thumbhash
+ * placeholder transformer.
+ *
+ * ```ts
+ * await media.library.transform(id, 'probe')
+ * const record = await media.library.find(id)
+ * record.conversions.probe?.meta // { durationSeconds: 41.6, width: 1920, ... }
+ * ```
+ */
+export class MetadataProbeTransformer {
+    name;
+    eager;
+    engine;
+    constructor(options = {}) {
+        this.name = options.name ?? 'probe';
+        this.eager = options.eager ?? false;
+        this.engine = options.engine;
+    }
+    async transform(context) {
+        const engine = this.engine ?? (await loadMediabunny(this.name)).createProbeEngine();
+        const summary = await withSourceFile(context, ({ sourcePath }) => engine.probe(sourcePath));
+        return { meta: compactMeta({ ...summary }) };
+    }
+}
+//# sourceMappingURL=probe.js.map

package/dist/src/transformers/probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../../../src/transformers/probe.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAuClD;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,wBAAwB;IAC1B,IAAI,CAAO;IACX,KAAK,CAAU;IACP,MAAM,CAA+B;IAEtD,YAAY,UAAiD,EAAE;QAC7D,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAK,OAAgB,CAAC;QAC9C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAA2B;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC;QACpF,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;QAC5F,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,EAAE,CAAC;IAC/C,CAAC;CACF"}

package/dist/src/transformers/source_file.d.ts

@@ -0,0 +1,20 @@
+import type { TransformerContext } from '../transformer.js';
+/** What {@link withSourceFile} hands its callback. */
+export interface MaterializedSource {
+    /** Local path of the original's bytes. */
+    sourcePath: string;
+    /** The temp directory the source lives in — free scratch space, removed when the callback ends. */
+    tempDir: string;
+}
+/**
+ * Materialize a media original into a local temp file for the duration of `fn`, then remove the
+ * whole temp directory — success or failure.
+ *
+ * File-based media engines (mediabunny, and most others) want random access to a local path, while
+ * a disk object only offers bytes/stream — so file-shaped transformers all start with this same
+ * dance. The bytes are **streamed** to disk, never buffered whole: the typical subject is a video.
+ * The file keeps the original's extension purely as a debugging nicety; engines detect the real
+ * format from content.
+ */
+export declare function withSourceFile<T>(context: TransformerContext, fn: (source: MaterializedSource) => Promise<T>): Promise<T>;
+//# sourceMappingURL=source_file.d.ts.map

package/dist/src/transformers/source_file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source_file.d.ts","sourceRoot":"","sources":["../../../src/transformers/source_file.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,mGAAmG;IACnG,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,OAAO,EAAE,kBAAkB,EAC3B,EAAE,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7C,OAAO,CAAC,CAAC,CAAC,CAYZ"}

package/dist/src/transformers/source_file.js

@@ -0,0 +1,30 @@
+import { createWriteStream } from 'node:fs';
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { extname, join } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+/**
+ * Materialize a media original into a local temp file for the duration of `fn`, then remove the
+ * whole temp directory — success or failure.
+ *
+ * File-based media engines (mediabunny, and most others) want random access to a local path, while
+ * a disk object only offers bytes/stream — so file-shaped transformers all start with this same
+ * dance. The bytes are **streamed** to disk, never buffered whole: the typical subject is a video.
+ * The file keeps the original's extension purely as a debugging nicety; engines detect the real
+ * format from content.
+ */
+export async function withSourceFile(context, fn) {
+    const tempDir = await mkdtemp(join(tmpdir(), 'agora-media-transform-'));
+    try {
+        const extension = extname(context.record.fileName);
+        const sourcePath = join(tempDir, `source${extension || '.bin'}`);
+        await pipeline(await context.getStream(), createWriteStream(sourcePath));
+        return await fn({ sourcePath, tempDir });
+    }
+    finally {
+        await rm(tempDir, { recursive: true, force: true }).catch(() => {
+            // best-effort: temp cleanup must never mask the transform's own outcome
+        });
+    }
+}
+//# sourceMappingURL=source_file.js.map

package/dist/src/transformers/source_file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source_file.js","sourceRoot":"","sources":["../../../src/transformers/source_file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAWhD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA2B,EAC3B,EAA8C;IAE9C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAC;IACxE,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,SAAS,IAAI,MAAM,EAAE,CAAC,CAAC;QACjE,MAAM,QAAQ,CAAC,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;QACzE,OAAO,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YAC7D,wEAAwE;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/stubs/config/media.stub

@@ -55,5 +55,17 @@ export default defineConfig({
   //     sessionTtlSeconds: 24 * 60 * 60,
   //     routes: { enabled: true, prefix: '/media/uploads/tus' },
   //   },
+  //
+  //   // Session-backed direct uploads — the browser PUTs multipart parts straight to S3 through
+  //   // presigned URLs (bytes never pass through the app), and the session (uploadId, part size,
+  //   // confirmed ETags) persists server-side so an interrupted upload resumes after a page
+  //   // reload. Needs a multipart-capable disk (disks.s3()); shares the session tables above.
+  //   direct: {
+  //     store: 'lucid',
+  //     stores: { lucid: uploadSessions.lucid() },
+  //     partSize: 20 * 1024 * 1024,
+  //     sessionTtlSeconds: 24 * 60 * 60,
+  //     routes: { enabled: true, prefix: '/media/uploads/direct/sessions', collection: 'videos' },
+  //   },
   // },
 })

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adonis-agora/media",
-  "version": "0.8.2",
-  "description": "Media-library for AdonisJS — owner collections (MIME whitelist, single-file replace, ordering), image conversions (eager/lazy), and column attachments, all on top of @adonisjs/drive. Pluggable MediaStore (in-memory + Lucid) and ImageProcessor (sharp). Part of the Agora ecosystem.",
+  "version": "0.9.0",
+  "description": "Media-library for AdonisJS — owner collections (MIME whitelist, single-file replace, ordering), image conversions (eager/lazy), pluggable content transformers (HLS video via mediabunny, metadata probe), and column attachments, all on top of @adonisjs/drive. Pluggable MediaStore (in-memory + Lucid) and ImageProcessor (sharp). Part of the Agora ecosystem.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -86,20 +86,20 @@
     "@adonisjs/drive": "^3.0.0",
     "@adonisjs/lucid": "^22.4.0",
     "@aws-sdk/client-s3": "^3.0.0",
-    "@aws-sdk/s3-request-presigner": "^3.0.0",
+    "mediabunny": "^1.45.4",
     "sharp": "^0.33.0"
   },
   "peerDependenciesMeta": {
     "@adonis-agora/telescope": {
       "optional": true
     },
-    "@adonisjs/lucid": {
+    "mediabunny": {
       "optional": true
     },
-    "@aws-sdk/client-s3": {
+    "@adonisjs/lucid": {
       "optional": true
     },
-    "@aws-sdk/s3-request-presigner": {
+    "@aws-sdk/client-s3": {
       "optional": true
     },
     "sharp": {
@@ -112,13 +112,13 @@
     "@adonisjs/drive": "^3.0.0",
     "@adonisjs/lucid": "^22.4.0",
     "@aws-sdk/client-s3": "^3.726.1",
-    "@aws-sdk/s3-request-presigner": "^3.726.1",
     "@smithy/util-stream": "^3.3.1",
     "@types/better-sqlite3": "^7.6.0",
     "@types/node": "^20.0.0",
     "aws-sdk-client-mock": "^4.1.0",
     "better-sqlite3": "^11.0.0",
     "luxon": "^3.4.0",
+    "mediabunny": "^1.50.9",
     "sharp": "^0.33.0",
     "tempura": "0.4.1",
     "typescript": "^5.4.0",
@@ -137,6 +137,10 @@
     "uploads",
     "image",
     "conversions",
+    "transformers",
+    "video",
+    "hls",
+    "mediabunny",
     "sharp",
     "attachment",
     "agora"

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Davi Carvalho
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.