@aelionsdk/export 0.1.0-beta.1

package/dist/index.js

@@ -0,0 +1,11 @@
+export * from './audio-export.js';
+export * from './checkpoint.js';
+export * from './image-export.js';
+export * from './memory-sink.js';
+export * from './opfs-sink.js';
+export * from './profiles.js';
+export * from './remote-export.js';
+export * from './resumable-muxed-export.js';
+export * from './session.js';
+export * from './webm-export.js';
+export * from './worker-export.js';

package/dist/memory-sink.d.ts

@@ -0,0 +1,17 @@
+import type { StreamTargetChunk } from 'mediabunny';
+export interface MemorySinkSnapshot {
+    readonly writes: number;
+    readonly bytesWritten: number;
+    readonly finalSize: number;
+    readonly maxInFlightWrites: number;
+    readonly closed: boolean;
+    readonly aborted: boolean;
+}
+export declare class SeekableMemorySink {
+    #private;
+    readonly writable: WritableStream<StreamTargetChunk>;
+    finalize(): Uint8Array;
+    cleanup(): void;
+    snapshot(): MemorySinkSnapshot;
+}
+//# sourceMappingURL=memory-sink.d.ts.map

package/dist/memory-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-sink.d.ts","sourceRoot":"","sources":["../src/memory-sink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,qBAAa,kBAAkB;;IAS7B,SAAgB,QAAQ,oCAuBrB;IAEI,QAAQ,IAAI,UAAU;IAWtB,OAAO,IAAI,IAAI;IAMf,QAAQ,IAAI,kBAAkB;CActC"}

package/dist/memory-sink.js

@@ -0,0 +1,60 @@
+export class SeekableMemorySink {
+    #chunks = [];
+    #writes = 0;
+    #bytesWritten = 0;
+    #inFlightWrites = 0;
+    #maxInFlightWrites = 0;
+    #closed = false;
+    #aborted = false;
+    writable = new WritableStream({
+        write: chunk => {
+            if (this.#closed)
+                throw new Error('SeekableMemorySink is closed');
+            this.#inFlightWrites += 1;
+            this.#maxInFlightWrites = Math.max(this.#maxInFlightWrites, this.#inFlightWrites);
+            try {
+                this.#chunks.push({
+                    type: 'write',
+                    data: chunk.data.slice(),
+                    position: chunk.position,
+                });
+                this.#writes += 1;
+                this.#bytesWritten += chunk.data.byteLength;
+            }
+            finally {
+                this.#inFlightWrites -= 1;
+            }
+        },
+        close: () => {
+            this.#closed = true;
+        },
+        abort: () => {
+            this.cleanup();
+        },
+    });
+    finalize() {
+        if (!this.#closed)
+            throw new Error('SeekableMemorySink is not finalized');
+        const finalSize = this.#chunks.reduce((size, chunk) => Math.max(size, chunk.position + chunk.data.byteLength), 0);
+        const result = new Uint8Array(finalSize);
+        for (const chunk of this.#chunks)
+            result.set(chunk.data, chunk.position);
+        return result;
+    }
+    cleanup() {
+        this.#closed = true;
+        this.#aborted = true;
+        this.#chunks.length = 0;
+    }
+    snapshot() {
+        const finalSize = this.#chunks.reduce((size, chunk) => Math.max(size, chunk.position + chunk.data.byteLength), 0);
+        return {
+            writes: this.#writes,
+            bytesWritten: this.#bytesWritten,
+            finalSize,
+            maxInFlightWrites: this.#maxInFlightWrites,
+            closed: this.#closed,
+            aborted: this.#aborted,
+        };
+    }
+}

package/dist/mux-export-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mux-export-worker.d.ts.map

package/dist/mux-export-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mux-export-worker.d.ts","sourceRoot":"","sources":["../src/mux-export-worker.ts"],"names":[],"mappings":""}

package/dist/mux-export-worker.js

@@ -0,0 +1,120 @@
+/// <reference lib="webworker" />
+import { exportAv1Mp4, exportHevcMp4, exportMp4, exportWebM } from './webm-export.js';
+const scope = self;
+let controller;
+let nextRequestId = 1;
+const frames = new Map();
+const audio = new Map();
+function post(response, transfer = []) {
+    scope.postMessage(response, transfer);
+}
+function errorIdentity(error) {
+    const aborted = error instanceof DOMException && error.name === 'AbortError';
+    if (error !== null && typeof error === 'object') {
+        const diagnostics = Reflect.get(error, 'diagnostics');
+        if (Array.isArray(diagnostics)) {
+            const first = diagnostics[0];
+            if (first !== null && typeof first === 'object') {
+                const code = Reflect.get(first, 'code');
+                const message = Reflect.get(first, 'message');
+                if (typeof code === 'string' && typeof message === 'string')
+                    return { code, message, aborted };
+            }
+        }
+    }
+    return {
+        code: aborted ? 'OPERATION_ABORTED' : 'EXPORT_WORKER_FAILED',
+        message: error instanceof Error ? error.message : 'Export Worker failed',
+        aborted,
+    };
+}
+function requestFrame(request) {
+    const id = nextRequestId++;
+    return new Promise((resolve, reject) => {
+        frames.set(id, { resolve, reject });
+        post({ type: 'render-frame', id, request });
+    });
+}
+function requestAudio(request) {
+    const id = nextRequestId++;
+    return new Promise((resolve, reject) => {
+        audio.set(id, { resolve, reject });
+        post({ type: 'render-audio', id, request });
+    });
+}
+function frameResponse(response) {
+    const pending = frames.get(response.id);
+    if (pending === undefined) {
+        response.frame?.close();
+        return;
+    }
+    frames.delete(response.id);
+    if (response.frame !== undefined)
+        pending.resolve(response.frame);
+    else
+        pending.reject(new Error(response.error ?? 'Frame rendering failed'));
+}
+function audioResponse(response) {
+    const pending = audio.get(response.id);
+    if (pending === undefined)
+        return;
+    audio.delete(response.id);
+    if (response.pcm !== undefined)
+        pending.resolve(response.pcm);
+    else
+        pending.reject(new Error(response.error ?? 'Audio rendering failed'));
+}
+async function start(request) {
+    if (controller !== undefined) {
+        post({
+            type: 'failed',
+            code: 'EXPORT_WORKER_BUSY',
+            message: 'Export Worker is busy',
+            aborted: false,
+        });
+        return;
+    }
+    controller = new AbortController();
+    try {
+        const run = request.profile === 'mp4'
+            ? exportMp4
+            : request.profile === 'mp4-av1'
+                ? exportAv1Mp4
+                : request.profile === 'mp4-hevc'
+                    ? exportHevcMp4
+                    : exportWebM;
+        const result = await run({
+            ...request.config,
+            sink: request.sink,
+            signal: controller.signal,
+            renderFrame: requestFrame,
+            renderAudio: requestAudio,
+            onProgress: value => post({ type: 'progress', value }),
+        });
+        post({ type: 'completed', result });
+    }
+    catch (error) {
+        post({ type: 'failed', ...errorIdentity(error) });
+    }
+    finally {
+        controller = undefined;
+    }
+}
+scope.addEventListener('message', (event) => {
+    const request = event.data;
+    if (request.type === 'start')
+        void start(request);
+    else if (request.type === 'cancel') {
+        controller?.abort(new DOMException(request.reason, 'AbortError'));
+        for (const pending of frames.values())
+            pending.reject(new DOMException(request.reason, 'AbortError'));
+        for (const pending of audio.values())
+            pending.reject(new DOMException(request.reason, 'AbortError'));
+        frames.clear();
+        audio.clear();
+    }
+    else if (request.type === 'frame-response')
+        frameResponse(request);
+    else
+        audioResponse(request);
+});

package/dist/opfs-sink.d.ts

@@ -0,0 +1,20 @@
+import type { StreamTargetChunk } from 'mediabunny';
+export interface OpfsSinkSnapshot {
+    readonly fileName: string;
+    readonly writes: number;
+    readonly bytesWritten: number;
+    readonly maxInFlightWrites: number;
+    readonly closed: boolean;
+    readonly aborted: boolean;
+}
+export declare class OpfsSeekableSink {
+    #private;
+    constructor(fileName: string);
+    readonly writable: WritableStream<StreamTargetChunk>;
+    getFile(): Promise<File>;
+    /** Resolves only after the transferred WritableStream has closed on this host. */
+    waitUntilFinalized(): Promise<void>;
+    cleanup(): Promise<void>;
+    snapshot(): OpfsSinkSnapshot;
+}
+//# sourceMappingURL=opfs-sink.d.ts.map

package/dist/opfs-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opfs-sink.d.ts","sourceRoot":"","sources":["../src/opfs-sink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,qBAAa,gBAAgB;;gBAcR,QAAQ,EAAE,MAAM;IAenC,SAAgB,QAAQ,oCAiCrB;IAEU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrC,kFAAkF;IACrE,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAUnC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAa9B,QAAQ,IAAI,gBAAgB;CAepC"}

package/dist/opfs-sink.js

@@ -0,0 +1,113 @@
+export class OpfsSeekableSink {
+    #fileName;
+    #handlePromise;
+    #streamPromise;
+    #writes = 0;
+    #bytesWritten = 0;
+    #inFlightWrites = 0;
+    #maxInFlightWrites = 0;
+    #closed = false;
+    #aborted = false;
+    #finalizationError;
+    #finalized;
+    #resolveFinalized;
+    constructor(fileName) {
+        if (fileName.length === 0 || fileName.includes('/')) {
+            throw new TypeError('OPFS fileName must be a non-empty leaf name');
+        }
+        this.#fileName = fileName;
+        let resolveFinalized = () => undefined;
+        this.#finalized = new Promise(resolve => {
+            resolveFinalized = resolve;
+        });
+        this.#resolveFinalized = resolveFinalized;
+        this.#handlePromise = navigator.storage
+            .getDirectory()
+            .then(directory => directory.getFileHandle(fileName, { create: true }));
+    }
+    writable = new WritableStream({
+        write: async (chunk) => {
+            if (this.#closed || this.#aborted)
+                throw new Error('OPFS sink is not writable');
+            this.#inFlightWrites += 1;
+            this.#maxInFlightWrites = Math.max(this.#maxInFlightWrites, this.#inFlightWrites);
+            try {
+                const stream = await this.#stream();
+                await stream.write({
+                    type: 'write',
+                    position: chunk.position,
+                    data: chunk.data,
+                });
+                this.#writes += 1;
+                this.#bytesWritten += chunk.data.byteLength;
+            }
+            finally {
+                this.#inFlightWrites -= 1;
+            }
+        },
+        close: async () => {
+            if (this.#closed || this.#aborted)
+                return;
+            try {
+                await (await this.#stream()).close();
+                this.#closed = true;
+            }
+            catch (error) {
+                this.#finalizationError = error;
+                throw error;
+            }
+            finally {
+                this.#resolveFinalized();
+            }
+        },
+        abort: async () => {
+            await this.cleanup();
+        },
+    });
+    async getFile() {
+        await this.waitUntilFinalized();
+        return (await this.#handlePromise).getFile();
+    }
+    /** Resolves only after the transferred WritableStream has closed on this host. */
+    async waitUntilFinalized() {
+        await this.#finalized;
+        if (this.#finalizationError !== undefined) {
+            if (this.#finalizationError instanceof Error)
+                throw this.#finalizationError;
+            throw new Error('OPFS sink finalization failed', { cause: this.#finalizationError });
+        }
+        if (this.#aborted)
+            throw new DOMException('OPFS sink was aborted', 'AbortError');
+        if (!this.#closed)
+            throw new Error('OPFS sink did not finalize');
+    }
+    async cleanup() {
+        if (this.#aborted)
+            return;
+        this.#aborted = true;
+        try {
+            const stream = await this.#streamPromise;
+            if (stream !== undefined)
+                await stream.abort().catch(() => undefined);
+            const root = await navigator.storage.getDirectory();
+            await root.removeEntry(this.#fileName).catch(() => undefined);
+        }
+        finally {
+            this.#resolveFinalized();
+        }
+    }
+    snapshot() {
+        return {
+            fileName: this.#fileName,
+            writes: this.#writes,
+            bytesWritten: this.#bytesWritten,
+            maxInFlightWrites: this.#maxInFlightWrites,
+            closed: this.#closed,
+            aborted: this.#aborted,
+        };
+    }
+    #stream() {
+        this.#streamPromise ??= this.#handlePromise.then(handle => handle.createWritable());
+        return this.#streamPromise;
+    }
+}

package/dist/profiles.d.ts

@@ -0,0 +1,66 @@
+export type ExportProfileId = 'webm-vp9-opus' | 'mp4-h264-aac' | 'mp4-av1-aac' | 'mp4-hevc-aac' | 'still-png' | 'still-jpeg' | 'still-webp' | 'animated-gif' | 'audio-wav';
+export interface ExportProfile {
+    readonly id: ExportProfileId;
+    readonly kind: 'muxed-av' | 'still' | 'animated-image' | 'audio-only';
+    readonly mimeType: string;
+    readonly extension: string;
+    readonly videoCodec?: string;
+    readonly audioCodec?: string;
+    readonly resumability: 'restart-local' | 'checkpointed-units' | 'provider';
+}
+export declare const EXPORT_PROFILES: Readonly<Record<ExportProfileId, ExportProfile>>;
+export interface ExportProfileSupport {
+    readonly profile: ExportProfile;
+    readonly supported: boolean;
+    readonly reasons: readonly string[];
+}
+export interface ExportCapabilityProbeOptions {
+    readonly width?: number;
+    readonly height?: number;
+    readonly framerate?: number;
+    readonly sampleRate?: number;
+    readonly numberOfChannels?: number;
+    readonly videoBitrate?: number;
+    readonly audioBitrate?: number;
+}
+/**
+ * Returns AVC codec strings from the smallest level that can represent the
+ * requested macroblock rate through progressively more permissive levels.
+ * Each level tries High, Main and Baseline profiles because platform encoders
+ * commonly expose only a subset even when they support the same dimensions.
+ */
+export declare function avcCodecCandidates(width: number, height: number, framerate: number): readonly string[];
+export declare function preferredAvcCodecString(width: number, height: number, framerate: number): string;
+export declare function avcEncoderConfig(codec: string, width: number, height: number, framerate: number, bitrate: number): VideoEncoderConfig;
+/** Main-profile AV1 level chosen conservatively for HD or UHD output. */
+export declare function av1CodecString(width: number, height: number, framerate: number): string;
+/** Main-tier HEVC level chosen conservatively for HD or UHD output. */
+export declare function hevcCodecString(width: number, height: number, framerate: number): string;
+export declare function negotiatedVideoCodecString(profile: Pick<ExportProfile, 'id' | 'videoCodec'>, width: number, height: number, framerate: number): string;
+export interface AvcNegotiationResult {
+    readonly selected?: string;
+    readonly attempts: readonly {
+        readonly codec: string;
+        readonly supported: boolean;
+        readonly error?: string;
+    }[];
+}
+export declare function negotiateAvcCodecString(options: {
+    readonly width: number;
+    readonly height: number;
+    readonly framerate: number;
+    readonly bitrate: number;
+}): Promise<AvcNegotiationResult>;
+export declare function probeExportProfiles(options?: ExportCapabilityProbeOptions): Promise<readonly ExportProfileSupport[]>;
+export interface SelectExportProfileOptions extends ExportCapabilityProbeOptions {
+    readonly preferred: ExportProfileId;
+    readonly fallbacks?: readonly ExportProfileId[];
+    readonly remoteAvailable?: boolean;
+}
+export interface ExportProfileSelection {
+    readonly selected?: ExportProfile;
+    readonly execution: 'local' | 'remote' | 'unsupported';
+    readonly attempts: readonly ExportProfileSupport[];
+}
+export declare function selectExportProfile(options: SelectExportProfileOptions): Promise<ExportProfileSelection>;
+//# sourceMappingURL=profiles.d.ts.map

package/dist/profiles.d.ts.map

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