@aelionsdk/export 0.1.0-beta.1

package/dist/profiles.js

@@ -0,0 +1,284 @@
+export const EXPORT_PROFILES = Object.freeze({
+    'webm-vp9-opus': {
+        id: 'webm-vp9-opus',
+        kind: 'muxed-av',
+        mimeType: 'video/webm',
+        extension: '.webm',
+        videoCodec: 'vp09.00.10.08',
+        audioCodec: 'opus',
+        resumability: 'checkpointed-units',
+    },
+    'mp4-h264-aac': {
+        id: 'mp4-h264-aac',
+        kind: 'muxed-av',
+        mimeType: 'video/mp4',
+        extension: '.mp4',
+        videoCodec: 'avc1.640028',
+        audioCodec: 'mp4a.40.2',
+        resumability: 'checkpointed-units',
+    },
+    'mp4-av1-aac': {
+        id: 'mp4-av1-aac',
+        kind: 'muxed-av',
+        mimeType: 'video/mp4',
+        extension: '.mp4',
+        videoCodec: 'av01.0.08M.08',
+        audioCodec: 'mp4a.40.2',
+        resumability: 'checkpointed-units',
+    },
+    'mp4-hevc-aac': {
+        id: 'mp4-hevc-aac',
+        kind: 'muxed-av',
+        mimeType: 'video/mp4',
+        extension: '.mp4',
+        videoCodec: 'hvc1.1.6.L120.B0',
+        audioCodec: 'mp4a.40.2',
+        resumability: 'checkpointed-units',
+    },
+    'still-png': {
+        id: 'still-png',
+        kind: 'still',
+        mimeType: 'image/png',
+        extension: '.png',
+        resumability: 'checkpointed-units',
+    },
+    'still-jpeg': {
+        id: 'still-jpeg',
+        kind: 'still',
+        mimeType: 'image/jpeg',
+        extension: '.jpg',
+        resumability: 'checkpointed-units',
+    },
+    'still-webp': {
+        id: 'still-webp',
+        kind: 'still',
+        mimeType: 'image/webp',
+        extension: '.webp',
+        resumability: 'checkpointed-units',
+    },
+    'animated-gif': {
+        id: 'animated-gif',
+        kind: 'animated-image',
+        mimeType: 'image/gif',
+        extension: '.gif',
+        resumability: 'checkpointed-units',
+    },
+    'audio-wav': {
+        id: 'audio-wav',
+        kind: 'audio-only',
+        mimeType: 'audio/wav',
+        extension: '.wav',
+        resumability: 'checkpointed-units',
+    },
+});
+const AVC_LEVELS = Object.freeze([
+    { levelHex: '1e', maxMacroblocksPerFrame: 1_620, maxMacroblocksPerSecond: 40_500 },
+    { levelHex: '1f', maxMacroblocksPerFrame: 3_600, maxMacroblocksPerSecond: 108_000 },
+    { levelHex: '20', maxMacroblocksPerFrame: 5_120, maxMacroblocksPerSecond: 216_000 },
+    { levelHex: '28', maxMacroblocksPerFrame: 8_192, maxMacroblocksPerSecond: 245_760 },
+    { levelHex: '29', maxMacroblocksPerFrame: 8_192, maxMacroblocksPerSecond: 245_760 },
+    { levelHex: '2a', maxMacroblocksPerFrame: 8_704, maxMacroblocksPerSecond: 522_240 },
+    { levelHex: '32', maxMacroblocksPerFrame: 22_080, maxMacroblocksPerSecond: 589_824 },
+    { levelHex: '33', maxMacroblocksPerFrame: 36_864, maxMacroblocksPerSecond: 983_040 },
+    { levelHex: '34', maxMacroblocksPerFrame: 36_864, maxMacroblocksPerSecond: 2_073_600 },
+]);
+function assertPositiveFinite(value, name) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new RangeError(`${name} must be a positive finite 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 function avcCodecCandidates(width, height, framerate) {
+    assertPositiveFinite(width, 'width');
+    assertPositiveFinite(height, 'height');
+    assertPositiveFinite(framerate, 'framerate');
+    const macroblocksPerFrame = Math.ceil(width / 16) * Math.ceil(height / 16);
+    const macroblocksPerSecond = Math.ceil(macroblocksPerFrame * framerate);
+    const firstLevel = AVC_LEVELS.findIndex(level => macroblocksPerFrame <= level.maxMacroblocksPerFrame &&
+        macroblocksPerSecond <= level.maxMacroblocksPerSecond);
+    if (firstLevel < 0) {
+        throw new RangeError(`No bounded AVC level supports ${width.toString()}x${height.toString()} at ${framerate.toString()} fps`);
+    }
+    return AVC_LEVELS.slice(firstLevel).flatMap(level => [
+        `avc1.6400${level.levelHex}`,
+        `avc1.4d00${level.levelHex}`,
+        `avc1.4200${level.levelHex}`,
+    ]);
+}
+export function preferredAvcCodecString(width, height, framerate) {
+    const codec = avcCodecCandidates(width, height, framerate)[0];
+    if (codec === undefined)
+        throw new Error('AVC candidate generation returned no codecs');
+    return codec;
+}
+export function avcEncoderConfig(codec, width, height, framerate, bitrate) {
+    return {
+        codec,
+        width,
+        height,
+        bitrate,
+        bitrateMode: 'variable',
+        framerate,
+        latencyMode: 'quality',
+        alpha: 'discard',
+        avc: { format: 'avc' },
+    };
+}
+/** Main-profile AV1 level chosen conservatively for HD or UHD output. */
+export function av1CodecString(width, height, framerate) {
+    assertPositiveFinite(width, 'width');
+    assertPositiveFinite(height, 'height');
+    assertPositiveFinite(framerate, 'framerate');
+    const samplesPerSecond = width * height * framerate;
+    return samplesPerSecond > 1920 * 1080 * 30 ? 'av01.0.12M.08' : 'av01.0.08M.08';
+}
+/** Main-tier HEVC level chosen conservatively for HD or UHD output. */
+export function hevcCodecString(width, height, framerate) {
+    assertPositiveFinite(width, 'width');
+    assertPositiveFinite(height, 'height');
+    assertPositiveFinite(framerate, 'framerate');
+    const samplesPerSecond = width * height * framerate;
+    return samplesPerSecond > 1920 * 1080 * 30 ? 'hvc1.1.6.L153.B0' : 'hvc1.1.6.L120.B0';
+}
+export function negotiatedVideoCodecString(profile, width, height, framerate) {
+    if (profile.id === 'mp4-h264-aac') {
+        return preferredAvcCodecString(width, height, framerate);
+    }
+    if (profile.id === 'mp4-av1-aac')
+        return av1CodecString(width, height, framerate);
+    if (profile.id === 'mp4-hevc-aac')
+        return hevcCodecString(width, height, framerate);
+    if (profile.videoCodec === undefined)
+        throw new RangeError(`${profile.id} has no video codec`);
+    return profile.videoCodec;
+}
+const avcNegotiationCache = new Map();
+export function negotiateAvcCodecString(options) {
+    const key = JSON.stringify(options);
+    let negotiation = avcNegotiationCache.get(key);
+    if (negotiation === undefined) {
+        negotiation = (async () => {
+            const attempts = [];
+            if (typeof VideoEncoder !== 'function')
+                return { attempts };
+            for (const codec of avcCodecCandidates(options.width, options.height, options.framerate)) {
+                try {
+                    const support = await VideoEncoder.isConfigSupported(avcEncoderConfig(codec, options.width, options.height, options.framerate, options.bitrate));
+                    attempts.push({ codec, supported: support.supported === true });
+                    if (support.supported)
+                        return { selected: codec, attempts };
+                }
+                catch (error) {
+                    attempts.push({
+                        codec,
+                        supported: false,
+                        error: error instanceof Error ? error.message : 'VideoEncoder probe failed',
+                    });
+                }
+            }
+            return { attempts };
+        })();
+        avcNegotiationCache.set(key, negotiation);
+        void negotiation.catch(() => avcNegotiationCache.delete(key));
+    }
+    return negotiation;
+}
+async function encoderSupport(profile, options = {}) {
+    const reasons = [];
+    if (profile.videoCodec !== undefined) {
+        if (typeof VideoEncoder !== 'function')
+            reasons.push('EXPORT_VIDEO_ENCODER_UNAVAILABLE');
+        else {
+            try {
+                const width = options.width ?? 1_280;
+                const height = options.height ?? 720;
+                const framerate = options.framerate ?? 30;
+                const codecs = profile.id === 'mp4-h264-aac'
+                    ? avcCodecCandidates(width, height, framerate)
+                    : [negotiatedVideoCodecString(profile, width, height, framerate)];
+                let supported = false;
+                for (const codec of codecs) {
+                    const result = await VideoEncoder.isConfigSupported(profile.id === 'mp4-h264-aac'
+                        ? avcEncoderConfig(codec, width, height, framerate, options.videoBitrate ?? 4_000_000)
+                        : {
+                            codec,
+                            width,
+                            height,
+                            bitrate: options.videoBitrate ?? 4_000_000,
+                            bitrateMode: 'variable',
+                            framerate,
+                            latencyMode: 'quality',
+                            alpha: 'discard',
+                            ...(profile.id === 'mp4-hevc-aac' ? { hevc: { format: 'hevc' } } : {}),
+                        });
+                    if (result.supported) {
+                        supported = true;
+                        break;
+                    }
+                }
+                if (!supported)
+                    reasons.push('EXPORT_VIDEO_CONFIG_UNSUPPORTED');
+            }
+            catch {
+                reasons.push('EXPORT_VIDEO_CONFIG_PROBE_FAILED');
+            }
+        }
+    }
+    if (profile.audioCodec !== undefined) {
+        if (typeof AudioEncoder !== 'function')
+            reasons.push('EXPORT_AUDIO_ENCODER_UNAVAILABLE');
+        else {
+            try {
+                const supported = await AudioEncoder.isConfigSupported({
+                    codec: profile.audioCodec,
+                    sampleRate: options.sampleRate ?? 48_000,
+                    numberOfChannels: options.numberOfChannels ?? 2,
+                    bitrate: options.audioBitrate ?? 128_000,
+                    bitrateMode: 'variable',
+                    ...(profile.audioCodec === 'mp4a.40.2'
+                        ? { aac: { format: 'aac' } }
+                        : profile.audioCodec === 'opus'
+                            ? { opus: { format: 'opus' } }
+                            : {}),
+                });
+                if (!supported.supported)
+                    reasons.push('EXPORT_AUDIO_CONFIG_UNSUPPORTED');
+            }
+            catch {
+                reasons.push('EXPORT_AUDIO_CONFIG_PROBE_FAILED');
+            }
+        }
+    }
+    if (profile.kind === 'still' && typeof OffscreenCanvas !== 'function') {
+        reasons.push('EXPORT_IMAGE_CANVAS_UNAVAILABLE');
+    }
+    if (profile.kind === 'animated-image' && typeof OffscreenCanvas !== 'function') {
+        reasons.push('EXPORT_IMAGE_CANVAS_UNAVAILABLE');
+    }
+    return { profile, supported: reasons.length === 0, reasons };
+}
+export async function probeExportProfiles(options = {}) {
+    return Promise.all(Object.values(EXPORT_PROFILES).map(profile => encoderSupport(profile, options)));
+}
+export async function selectExportProfile(options) {
+    const ids = [options.preferred, ...(options.fallbacks ?? [])].filter((id, index, values) => values.indexOf(id) === index);
+    const attempts = [];
+    for (const id of ids) {
+        const profile = EXPORT_PROFILES[id];
+        if (profile === undefined) {
+            throw new RangeError(`Unknown export profile ${String(id)}`);
+        }
+        const support = await encoderSupport(profile, options);
+        attempts.push(support);
+        if (support.supported)
+            return { selected: support.profile, execution: 'local', attempts };
+    }
+    return options.remoteAvailable === true
+        ? { selected: EXPORT_PROFILES[options.preferred], execution: 'remote', attempts }
+        : { execution: 'unsupported', attempts };
+}

package/dist/remote-export.d.ts

@@ -0,0 +1,56 @@
+import { type JsonObject } from '@aelionsdk/core';
+import type { ExportProfileId } from './profiles.js';
+export interface RemoteExportAuthorization {
+    readonly scheme: string;
+    readonly token: string;
+    readonly expiresAtMs?: number;
+}
+export interface RemoteExportAuthorizer {
+    authorize(signal?: AbortSignal): Promise<RemoteExportAuthorization>;
+}
+export interface RemoteExportRequest {
+    readonly contentId: string;
+    readonly idempotencyKey: string;
+    readonly profileId: ExportProfileId;
+    readonly projectId: string;
+    readonly sequenceId: string;
+    readonly revision: string;
+    readonly manifest: JsonObject;
+}
+export type RemoteExportEvent = {
+    readonly type: 'progress';
+    readonly progress: number;
+    readonly stage?: string;
+} | {
+    readonly type: 'completed';
+    readonly result: RemoteExportResult;
+};
+export interface RemoteExportResult {
+    readonly providerJobId: string;
+    readonly contentId: string;
+    readonly profileId: ExportProfileId;
+    readonly mimeType: string;
+    readonly byteLength: number;
+    readonly outputUrl?: string;
+    readonly outputToken?: string;
+}
+export interface RemoteExportSession {
+    readonly providerJobId: string;
+    readonly events: AsyncIterable<RemoteExportEvent>;
+    cancel(reason?: unknown): Promise<void>;
+    cleanup(reason?: unknown): Promise<void>;
+}
+export interface RemoteExportProvider {
+    readonly id: string;
+    start(request: RemoteExportRequest, authorization: RemoteExportAuthorization, signal?: AbortSignal): Promise<RemoteExportSession>;
+}
+export interface RunRemoteExportOptions {
+    readonly provider: RemoteExportProvider;
+    readonly authorizer: RemoteExportAuthorizer;
+    readonly request: RemoteExportRequest;
+    readonly signal?: AbortSignal;
+    readonly onProgress?: (progress: number, stage?: string) => void;
+}
+export declare function runRemoteExport(options: RunRemoteExportOptions): Promise<RemoteExportResult>;
+export declare function createRemoteExportContentId(canonicalManifestBytes: Uint8Array, profileId: ExportProfileId, revision: string): Promise<string>;
+//# sourceMappingURL=remote-export.d.ts.map

package/dist/remote-export.d.ts.map

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

package/dist/remote-export.js

@@ -0,0 +1,83 @@
+import { AelionError, throwIfAborted } from '@aelionsdk/core';
+function boundedProgress(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.max(0, Math.min(1, value));
+}
+export async function runRemoteExport(options) {
+    throwIfAborted(options.signal, 'Remote export');
+    const authorization = await options.authorizer.authorize(options.signal);
+    throwIfAborted(options.signal, 'Remote export');
+    if (authorization.scheme.length === 0 || authorization.token.length === 0) {
+        throw new AelionError([
+            {
+                code: 'REMOTE_EXPORT_AUTH_INVALID',
+                severity: 'error',
+                message: 'Remote export authorization is empty',
+                recoverable: true,
+            },
+        ]);
+    }
+    if (authorization.expiresAtMs !== undefined && authorization.expiresAtMs <= Date.now()) {
+        throw new AelionError([
+            {
+                code: 'REMOTE_EXPORT_AUTH_EXPIRED',
+                severity: 'error',
+                message: 'Remote export authorization has expired',
+                recoverable: true,
+            },
+        ]);
+    }
+    let session;
+    let lastProgress = 0;
+    try {
+        session = await options.provider.start(options.request, authorization, options.signal);
+        for await (const event of session.events) {
+            throwIfAborted(options.signal, 'Remote export');
+            if (event.type === 'progress') {
+                const progress = boundedProgress(event.progress);
+                if (progress < lastProgress) {
+                    throw new Error('Remote export progress must be monotonic');
+                }
+                lastProgress = progress;
+                options.onProgress?.(progress, event.stage);
+                continue;
+            }
+            if (event.result.providerJobId !== session.providerJobId ||
+                event.result.contentId !== options.request.contentId ||
+                event.result.profileId !== options.request.profileId) {
+                throw new Error('Remote export result identity does not match the request');
+            }
+            options.onProgress?.(1, 'completed');
+            return event.result;
+        }
+        throw new Error('Remote export event stream ended without a result');
+    }
+    catch (cause) {
+        await Promise.resolve(session?.cancel(cause)).catch(() => undefined);
+        await Promise.resolve(session?.cleanup(cause)).catch(() => undefined);
+        if (cause instanceof AelionError)
+            throw cause;
+        throw new AelionError([
+            {
+                code: options.signal?.aborted === true ? 'OPERATION_ABORTED' : 'REMOTE_EXPORT_FAILED',
+                severity: 'error',
+                message: options.signal?.aborted === true
+                    ? 'Remote export was aborted'
+                    : cause instanceof Error
+                        ? cause.message
+                        : 'Remote export failed',
+                recoverable: true,
+                cause,
+            },
+        ]);
+    }
+}
+export async function createRemoteExportContentId(canonicalManifestBytes, profileId, revision) {
+    const prefix = new TextEncoder().encode(`${profileId}\n${revision}\n`);
+    const bytes = new Uint8Array(prefix.byteLength + canonicalManifestBytes.byteLength);
+    bytes.set(prefix);
+    bytes.set(canonicalManifestBytes, prefix.byteLength);
+    const digest = new Uint8Array(await crypto.subtle.digest('SHA-256', bytes));
+    return [...digest].map(value => value.toString(16).padStart(2, '0')).join('');
+}

package/dist/resumable-muxed-export.d.ts

@@ -0,0 +1,84 @@
+import { type MuxedEncoderConfiguration, type WebMExportOptions, type WebMExportResult } from './webm-export.js';
+export type ResumableMuxedProfile = MuxedEncoderConfiguration['profile'];
+export interface ResumableMuxedUnitMetadata {
+    readonly index: number;
+    readonly videoStartFrame: number;
+    readonly videoEndFrameExclusive: number;
+    readonly audioStartFrame: number;
+    readonly audioEndFrameExclusive: number;
+    readonly byteLength: number;
+    readonly sha256: string;
+}
+export interface ResumableMuxedExportManifest {
+    readonly version: 1;
+    readonly contentId: string;
+    readonly configurationId: string;
+    readonly profile: ResumableMuxedProfile;
+    readonly durationUs: number;
+    readonly totalUnits: number;
+    readonly completedUnits: number;
+    readonly units: readonly ResumableMuxedUnitMetadata[];
+    readonly mimeType?: string;
+    readonly encoderConfiguration?: MuxedEncoderConfiguration;
+    readonly updatedAtMs: number;
+}
+export interface ResumableMuxedExportUnit {
+    readonly index: number;
+    readonly init?: Uint8Array;
+    readonly media: Uint8Array;
+}
+export interface ResumableMuxedExportStore {
+    loadManifest(key: string, signal?: AbortSignal): Promise<ResumableMuxedExportManifest | undefined>;
+    loadUnit(key: string, index: number, signal?: AbortSignal): Promise<ResumableMuxedExportUnit | undefined>;
+    /** Commits unit bytes and the advanced manifest in one durable transaction. */
+    commitUnit(key: string, unit: ResumableMuxedExportUnit, manifest: ResumableMuxedExportManifest, signal?: AbortSignal): Promise<void>;
+    delete(key: string, signal?: AbortSignal): Promise<void>;
+}
+export declare class MemoryResumableMuxedExportStore implements ResumableMuxedExportStore {
+    #private;
+    loadManifest(key: string, signal?: AbortSignal): Promise<ResumableMuxedExportManifest | undefined>;
+    loadUnit(key: string, index: number, signal?: AbortSignal): Promise<ResumableMuxedExportUnit | undefined>;
+    commitUnit(key: string, unit: ResumableMuxedExportUnit, manifest: ResumableMuxedExportManifest, signal?: AbortSignal): Promise<void>;
+    delete(key: string, signal?: AbortSignal): Promise<void>;
+}
+/**
+ * IndexedDB-backed binary checkpoint store. Unit bytes and their prefix
+ * manifest advance in the same read/write transaction, so a reload observes
+ * either the previous committed prefix or the complete next unit.
+ */
+export declare class IndexedDbResumableMuxedExportStore implements ResumableMuxedExportStore {
+    #private;
+    constructor(options?: {
+        readonly databaseName?: string;
+        readonly namespace?: string;
+    });
+    loadManifest(key: string, signal?: AbortSignal): Promise<ResumableMuxedExportManifest | undefined>;
+    loadUnit(key: string, index: number, signal?: AbortSignal): Promise<ResumableMuxedExportUnit | undefined>;
+    commitUnit(key: string, unit: ResumableMuxedExportUnit, manifest: ResumableMuxedExportManifest, signal?: AbortSignal): Promise<void>;
+    delete(key: string, signal?: AbortSignal): Promise<void>;
+}
+export interface ResumableMuxedExportOptions extends Omit<WebMExportOptions, 'onProgress'> {
+    readonly key: string;
+    readonly contentId: string;
+    readonly profile: ResumableMuxedProfile;
+    readonly store: ResumableMuxedExportStore;
+    /** Target unit duration. Actual boundaries are aligned to complete video frames. */
+    readonly segmentDurationUs?: number;
+    readonly onProgress?: (progress: number) => void;
+    readonly onUnitCommitted?: (completedUnits: number, totalUnits: number) => void;
+    readonly deleteCheckpointOnSuccess?: boolean;
+    readonly now?: () => number;
+}
+export interface ResumableMuxedExportResult extends WebMExportResult {
+    readonly checkpointKey: string;
+    readonly totalUnits: number;
+    readonly reusedUnits: number;
+    readonly encodedUnits: number;
+}
+/**
+ * Encodes frame-aligned WebM clusters or fMP4 fragments and checkpoints every
+ * complete unit. Resume reuses the committed prefix, verifies every unit hash,
+ * and re-encodes only the first missing unit onward.
+ */
+export declare function exportResumableMuxed(options: ResumableMuxedExportOptions): Promise<ResumableMuxedExportResult>;
+//# sourceMappingURL=resumable-muxed-export.d.ts.map

package/dist/resumable-muxed-export.d.ts.map

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