@aelionsdk/export 0.1.0-beta.1 → 1.0.0-rc.1

package/README.md

@@ -4,4 +4,4 @@ Streaming WebCodecs and WebM export pipeline for AelionSDK
 
 Install with `npm install @aelionsdk/export@next`.
 
-Version 0.1.0-beta.1 is a prerelease and its API may change before the first stable release. This package is part of [AelionSDK](https://github.com/FoyonaCZY/AelionSDK); see the repository README for supported browsers, examples and deployment requirements.
+Version 1.0.0-rc.1 is a prerelease and its API may change before the first stable release. This package is part of [AelionSDK](https://github.com/FoyonaCZY/AelionSDK); see the repository README for supported browsers, examples and deployment requirements.

package/dist/remote-export.d.ts

@@ -1,5 +1,6 @@
 import { type JsonObject } from '@aelionsdk/core';
 import type { ExportProfileId } from './profiles.js';
+export declare const REMOTE_EXPORT_PROTOCOL_VERSION: "1.0.0";
 export interface RemoteExportAuthorization {
     readonly scheme: string;
     readonly token: string;
@@ -8,7 +9,22 @@ export interface RemoteExportAuthorization {
 export interface RemoteExportAuthorizer {
     authorize(signal?: AbortSignal): Promise<RemoteExportAuthorization>;
 }
+export interface RemoteExportAsset {
+    readonly assetId: string;
+    readonly contentId: string;
+    readonly byteLength: number;
+    readonly sha256: string;
+    readonly mediaType?: string;
+    readonly locator?: JsonObject;
+}
+export interface RemoteExportAssetAuthorization extends RemoteExportAuthorization {
+    readonly assetId: string;
+}
+export interface RemoteExportAssetAuthorizer {
+    authorizeAsset(asset: RemoteExportAsset, signal?: AbortSignal): Promise<RemoteExportAssetAuthorization>;
+}
 export interface RemoteExportRequest {
+    readonly protocolVersion: typeof REMOTE_EXPORT_PROTOCOL_VERSION;
     readonly contentId: string;
     readonly idempotencyKey: string;
     readonly profileId: ExportProfileId;
@@ -16,6 +32,20 @@ export interface RemoteExportRequest {
     readonly sequenceId: string;
     readonly revision: string;
     readonly manifest: JsonObject;
+    readonly assets: readonly RemoteExportAsset[];
+    /** Ephemeral credentials; providers must not persist them in manifests or logs. */
+    readonly assetAuthorizations: readonly RemoteExportAssetAuthorization[];
+}
+export interface RemoteExportNegotiationRequest {
+    readonly supportedProtocolVersions: readonly [typeof REMOTE_EXPORT_PROTOCOL_VERSION];
+    readonly profileId: ExportProfileId;
+    readonly assets: readonly RemoteExportAsset[];
+}
+export interface RemoteExportNegotiation {
+    /** Untrusted provider response; callers validate it against the supported version. */
+    readonly protocolVersion: string;
+    readonly acceptedProfileIds: readonly ExportProfileId[];
+    readonly maxAssetBytes: number;
 }
 export type RemoteExportEvent = {
     readonly type: 'progress';
@@ -31,6 +61,7 @@ export interface RemoteExportResult {
     readonly profileId: ExportProfileId;
     readonly mimeType: string;
     readonly byteLength: number;
+    readonly sha256: string;
     readonly outputUrl?: string;
     readonly outputToken?: string;
 }
@@ -42,12 +73,14 @@ export interface RemoteExportSession {
 }
 export interface RemoteExportProvider {
     readonly id: string;
+    negotiate(request: RemoteExportNegotiationRequest, authorization: RemoteExportAuthorization, signal?: AbortSignal): Promise<RemoteExportNegotiation>;
     start(request: RemoteExportRequest, authorization: RemoteExportAuthorization, signal?: AbortSignal): Promise<RemoteExportSession>;
 }
 export interface RunRemoteExportOptions {
     readonly provider: RemoteExportProvider;
     readonly authorizer: RemoteExportAuthorizer;
     readonly request: RemoteExportRequest;
+    readonly assetAuthorizer?: RemoteExportAssetAuthorizer;
     readonly signal?: AbortSignal;
     readonly onProgress?: (progress: number, stage?: string) => void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"remote-export.d.ts","sourceRoot":"","sources":["../src/remote-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;CAC/B;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACjF;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC,CAAC;AAEN,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAClD,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,KAAK,CACH,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,yBAAyB,EACxC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAClE;AAOD,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAqE7B;AAED,wBAAsB,2BAA2B,CAC/C,sBAAsB,EAAE,UAAU,EAClC,SAAS,EAAE,eAAe,EAC1B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAOjB"}
+{"version":3,"file":"remote-export.d.ts","sourceRoot":"","sources":["../src/remote-export.ts"],"names":[],"mappings":"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"}

package/dist/remote-export.js

@@ -1,37 +1,92 @@
 import { AelionError, throwIfAborted } from '@aelionsdk/core';
+export const REMOTE_EXPORT_PROTOCOL_VERSION = '1.0.0';
 function boundedProgress(value) {
     if (!Number.isFinite(value))
         return 0;
     return Math.max(0, Math.min(1, value));
 }
+function validAuthorization(value) {
+    return (value.scheme.length > 0 &&
+        value.token.length > 0 &&
+        (value.expiresAtMs === undefined || value.expiresAtMs > Date.now()));
+}
+function validateAsset(asset) {
+    if (asset.assetId.length === 0 ||
+        asset.contentId.length === 0 ||
+        !Number.isSafeInteger(asset.byteLength) ||
+        asset.byteLength < 0 ||
+        !/^[0-9a-f]{64}$/u.test(asset.sha256)) {
+        throw new TypeError(`Invalid remote export asset ${asset.assetId || '<empty>'}`);
+    }
+}
 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) {
+    if (!validAuthorization(authorization)) {
         throw new AelionError([
             {
-                code: 'REMOTE_EXPORT_AUTH_INVALID',
+                code: authorization.expiresAtMs !== undefined && authorization.expiresAtMs <= Date.now()
+                    ? 'REMOTE_EXPORT_AUTH_EXPIRED'
+                    : 'REMOTE_EXPORT_AUTH_INVALID',
                 severity: 'error',
-                message: 'Remote export authorization is empty',
+                message: 'Remote export authorization is empty or expired',
                 recoverable: true,
             },
         ]);
     }
-    if (authorization.expiresAtMs !== undefined && authorization.expiresAtMs <= Date.now()) {
+    for (const asset of options.request.assets)
+        validateAsset(asset);
+    const negotiation = await options.provider.negotiate({
+        supportedProtocolVersions: [REMOTE_EXPORT_PROTOCOL_VERSION],
+        profileId: options.request.profileId,
+        assets: options.request.assets,
+    }, authorization, options.signal);
+    if (negotiation.protocolVersion !== REMOTE_EXPORT_PROTOCOL_VERSION ||
+        !negotiation.acceptedProfileIds.includes(options.request.profileId) ||
+        !Number.isSafeInteger(negotiation.maxAssetBytes) ||
+        negotiation.maxAssetBytes < 0 ||
+        options.request.assets.some(asset => asset.byteLength > negotiation.maxAssetBytes)) {
         throw new AelionError([
             {
-                code: 'REMOTE_EXPORT_AUTH_EXPIRED',
+                code: 'REMOTE_EXPORT_INCOMPATIBLE',
                 severity: 'error',
-                message: 'Remote export authorization has expired',
+                message: 'Remote export protocol, profile, or asset budget is incompatible',
+                recoverable: false,
+            },
+        ]);
+    }
+    if (options.request.assets.length > 0 && options.assetAuthorizer === undefined) {
+        throw new AelionError([
+            {
+                code: 'REMOTE_EXPORT_ASSET_AUTH_REQUIRED',
+                severity: 'error',
+                message: 'Remote export assets require an explicit authorizer',
                 recoverable: true,
             },
         ]);
     }
+    const assetAuthorizations = [];
+    for (const asset of options.request.assets) {
+        const assetAuthorization = await options.assetAuthorizer?.authorizeAsset(asset, options.signal);
+        if (assetAuthorization === undefined ||
+            assetAuthorization.assetId !== asset.assetId ||
+            !validAuthorization(assetAuthorization)) {
+            throw new AelionError([
+                {
+                    code: 'REMOTE_EXPORT_ASSET_AUTH_INVALID',
+                    severity: 'error',
+                    message: `Remote export asset authorization is invalid for ${asset.assetId}`,
+                    recoverable: true,
+                },
+            ]);
+        }
+        assetAuthorizations.push(assetAuthorization);
+    }
     let session;
     let lastProgress = 0;
     try {
-        session = await options.provider.start(options.request, authorization, options.signal);
+        session = await options.provider.start({ ...options.request, assetAuthorizations }, authorization, options.signal);
         for await (const event of session.events) {
             throwIfAborted(options.signal, 'Remote export');
             if (event.type === 'progress') {
@@ -45,7 +100,10 @@ export async function runRemoteExport(options) {
             }
             if (event.result.providerJobId !== session.providerJobId ||
                 event.result.contentId !== options.request.contentId ||
-                event.result.profileId !== options.request.profileId) {
+                event.result.profileId !== options.request.profileId ||
+                !Number.isSafeInteger(event.result.byteLength) ||
+                event.result.byteLength < 0 ||
+                !/^[0-9a-f]{64}$/u.test(event.result.sha256)) {
                 throw new Error('Remote export result identity does not match the request');
             }
             options.onProgress?.(1, 'completed');

package/dist/session.d.ts

@@ -34,6 +34,32 @@ export interface FrozenProfilePreflightOptions {
     readonly audioBitrate?: number;
     readonly materialBackendAvailable?: FrozenWebMExportOptions['materialBackendAvailable'];
 }
+export type AudioExportCodec = 'opus' | 'aac';
+export interface AudioExportCapabilityEntry {
+    readonly codec: AudioExportCodec;
+    readonly codecString: 'opus' | 'mp4a.40.2';
+    readonly sampleRate: number;
+    readonly channelCount: number;
+    readonly bitrate: number;
+    readonly declaredSupported: boolean;
+    readonly runtimeSupported: boolean;
+    readonly supported: boolean;
+    readonly reason?: 'EXPORT_AUDIO_ENCODER_UNAVAILABLE' | 'EXPORT_AUDIO_CONFIG_UNSUPPORTED' | 'EXPORT_AUDIO_RUNTIME_CANARY_FAILED' | 'EXPORT_AUDIO_CONFIG_PROBE_FAILED';
+}
+export interface ProbeAudioExportMatrixOptions {
+    readonly codecs?: readonly AudioExportCodec[];
+    readonly sampleRates?: readonly number[];
+    readonly channelCounts?: readonly number[];
+    readonly bitratePerChannel?: number;
+}
+/**
+ * Probes the exact multichannel/sample-rate matrix advertised to a host.
+ *
+ * `isConfigSupported()` is not accepted as sufficient evidence: every declared
+ * configuration also encodes and flushes four real AudioData blocks. This
+ * catches runtimes that advertise AAC/Opus but fail when the encoder is used.
+ */
+export declare function probeAudioExportMatrix(options?: ProbeAudioExportMatrixOptions): Promise<readonly AudioExportCapabilityEntry[]>;
 export declare function preflightWebMExport(options: FrozenWebMExportOptions): Promise<ExportPreflightReport>;
 export declare function preflightMp4Export(options: FrozenMp4ExportOptions): Promise<ExportPreflightReport>;
 export declare function preflightAv1Mp4Export(options: FrozenMp4ExportOptions): Promise<ExportPreflightReport>;

package/dist/session.d.ts.map

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

package/dist/session.js

@@ -60,6 +60,96 @@ function verifyAudioEncoderRuntime(config) {
     audioRuntimeSupport.set(key, probe);
     return probe;
 }
+/**
+ * Probes the exact multichannel/sample-rate matrix advertised to a host.
+ *
+ * `isConfigSupported()` is not accepted as sufficient evidence: every declared
+ * configuration also encodes and flushes four real AudioData blocks. This
+ * catches runtimes that advertise AAC/Opus but fail when the encoder is used.
+ */
+export async function probeAudioExportMatrix(options = {}) {
+    const codecs = options.codecs ?? ['opus', 'aac'];
+    const sampleRates = options.sampleRates ?? [44_100, 48_000, 96_000];
+    const channelCounts = options.channelCounts ?? [1, 2, 6];
+    const bitratePerChannel = options.bitratePerChannel ?? 64_000;
+    for (const [values, name] of [
+        [sampleRates, 'sampleRates'],
+        [channelCounts, 'channelCounts'],
+    ]) {
+        if (values.length === 0 || values.some(value => !Number.isSafeInteger(value) || value <= 0)) {
+            throw new RangeError(`${name} must contain positive safe integers`);
+        }
+    }
+    if (!Number.isSafeInteger(bitratePerChannel) || bitratePerChannel <= 0) {
+        throw new RangeError('bitratePerChannel must be a positive safe integer');
+    }
+    const entries = [];
+    for (const codec of codecs) {
+        const codecString = codec === 'aac' ? 'mp4a.40.2' : 'opus';
+        for (const sampleRate of sampleRates) {
+            for (const channelCount of channelCounts) {
+                const bitrate = bitratePerChannel * channelCount;
+                if (typeof AudioEncoder !== 'function') {
+                    entries.push({
+                        codec,
+                        codecString,
+                        sampleRate,
+                        channelCount,
+                        bitrate,
+                        declaredSupported: false,
+                        runtimeSupported: false,
+                        supported: false,
+                        reason: 'EXPORT_AUDIO_ENCODER_UNAVAILABLE',
+                    });
+                    continue;
+                }
+                const config = {
+                    codec: codecString,
+                    sampleRate,
+                    numberOfChannels: channelCount,
+                    bitrate,
+                    bitrateMode: 'variable',
+                    ...(codec === 'aac'
+                        ? { aac: { format: 'aac' } }
+                        : { opus: { format: 'opus' } }),
+                };
+                try {
+                    const declaredSupported = (await AudioEncoder.isConfigSupported(config)).supported === true;
+                    const runtimeSupported = declaredSupported && (await verifyAudioEncoderRuntime(config));
+                    entries.push({
+                        codec,
+                        codecString,
+                        sampleRate,
+                        channelCount,
+                        bitrate,
+                        declaredSupported,
+                        runtimeSupported,
+                        supported: runtimeSupported,
+                        ...(!declaredSupported
+                            ? { reason: 'EXPORT_AUDIO_CONFIG_UNSUPPORTED' }
+                            : !runtimeSupported
+                                ? { reason: 'EXPORT_AUDIO_RUNTIME_CANARY_FAILED' }
+                                : {}),
+                    });
+                }
+                catch {
+                    entries.push({
+                        codec,
+                        codecString,
+                        sampleRate,
+                        channelCount,
+                        bitrate,
+                        declaredSupported: false,
+                        runtimeSupported: false,
+                        supported: false,
+                        reason: 'EXPORT_AUDIO_CONFIG_PROBE_FAILED',
+                    });
+                }
+            }
+        }
+    }
+    return entries;
+}
 function channelCount(layout) {
     if (layout === 'mono')
         return 1;
@@ -69,6 +159,20 @@ function channelCount(layout) {
         return 6;
     return undefined;
 }
+function sourceColorSpace(ir) {
+    if (ir.colorPrimaries !== 'bt709' ||
+        ir.transferFunction !== 'srgb' ||
+        ir.matrixCoefficients !== 'rgb' ||
+        ir.colorRange !== 'full') {
+        throw new TypeError('COLOR_EXPORT_RGBA_CONVERSION_UNSUPPORTED');
+    }
+    return {
+        primaries: 'bt709',
+        transfer: 'iec61966-2-1',
+        matrix: 'rgb',
+        fullRange: true,
+    };
+}
 async function preflightMuxedExport(options, profile) {
     const issues = [];
     try {
@@ -383,6 +487,7 @@ export async function exportFrozenRenderIrWebM(options) {
         channelCount: channelCount(options.ir.channelLayout) ?? 0,
         videoBitrate: options.videoBitrate,
         audioBitrate: options.audioBitrate,
+        sourceColorSpace: sourceColorSpace(options.ir),
         ...(report.encoderConfiguration?.videoCodecString === undefined
             ? {}
             : { videoCodecString: report.encoderConfiguration.videoCodecString }),
@@ -417,6 +522,7 @@ export async function exportFrozenRenderIrMp4(options) {
         channelCount: channelCount(options.ir.channelLayout) ?? 0,
         videoBitrate: options.videoBitrate,
         audioBitrate: options.audioBitrate,
+        sourceColorSpace: sourceColorSpace(options.ir),
         ...(report.encoderConfiguration?.videoCodecString === undefined
             ? {}
             : { videoCodecString: report.encoderConfiguration.videoCodecString }),
@@ -453,6 +559,7 @@ async function exportFrozenRenderIrAlternativeMp4(options, profile) {
         channelCount: channelCount(options.ir.channelLayout) ?? 0,
         videoBitrate: options.videoBitrate,
         audioBitrate: options.audioBitrate,
+        sourceColorSpace: sourceColorSpace(options.ir),
         ...(report.encoderConfiguration?.videoCodecString === undefined
             ? {}
             : { videoCodecString: report.encoderConfiguration.videoCodecString }),

package/dist/webm-export.d.ts

@@ -26,6 +26,8 @@ export interface WebMExportOptions {
     readonly videoCodecString?: string;
     /** Exact audio codec string selected by preflight. */
     readonly audioCodecString?: string;
+    /** Color interpretation of the RGBA frames passed to the encoder. */
+    readonly sourceColorSpace?: VideoColorSpaceInit;
     readonly sink: WritableStream<{
         readonly type: 'write';
         readonly data: Uint8Array<ArrayBuffer>;
@@ -59,6 +61,12 @@ export interface MuxedEncoderConfiguration {
         readonly frameRate: number;
         readonly bitrateMode: 'variable';
         readonly targetBitrate: number;
+        readonly sourceColorSpace: {
+            readonly primaries: VideoColorPrimaries | null;
+            readonly transfer: VideoTransferCharacteristics | null;
+            readonly matrix: VideoMatrixCoefficients | null;
+            readonly fullRange: boolean | null;
+        };
     };
     readonly audio: {
         readonly codec: string;

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

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

package/dist/webm-export.js

@@ -4,6 +4,12 @@ import { av1CodecString, hevcCodecString, negotiateAvcCodecString, preferredAvcC
 import { createSinkCompletionBarrier } from './sink-completion.js';
 const MAIN_THREAD_YIELD_INTERVAL_MS = 16;
 const audioEncoderRuntimeSupport = new Map();
+const DEFAULT_SOURCE_COLOR_SPACE = Object.freeze({
+    primaries: 'bt709',
+    transfer: 'iec61966-2-1',
+    matrix: 'rgb',
+    fullRange: true,
+});
 function nextMainThreadTask() {
     return new Promise(resolve => globalThis.setTimeout(resolve, 0));
 }
@@ -130,6 +136,12 @@ export async function exportMuxed(options, profile, range) {
         throw new RangeError('Muxed export range must be a non-empty subset of the timeline');
     }
     throwIfAborted(options.signal, profile.operationName);
+    const sourceColorSpace = {
+        primaries: options.sourceColorSpace?.primaries ?? DEFAULT_SOURCE_COLOR_SPACE.primaries,
+        transfer: options.sourceColorSpace?.transfer ?? DEFAULT_SOURCE_COLOR_SPACE.transfer,
+        matrix: options.sourceColorSpace?.matrix ?? DEFAULT_SOURCE_COLOR_SPACE.matrix,
+        fullRange: options.sourceColorSpace?.fullRange ?? DEFAULT_SOURCE_COLOR_SPACE.fullRange,
+    };
     if (profile.audioCodec === 'aac') {
         const runtimeConfig = {
             codec: options.audioCodecString ?? 'mp4a.40.2',
@@ -230,6 +242,7 @@ export async function exportMuxed(options, profile, range) {
                 const sample = new VideoSample(frame, {
                     timestamp: (timestampUs - rangeTimestampBaseUs) / 1_000_000,
                     duration: durationUs / 1_000_000,
+                    colorSpace: sourceColorSpace,
                 });
                 try {
                     await videoSource.add(sample);
@@ -299,6 +312,7 @@ export async function exportMuxed(options, profile, range) {
                     frameRate: options.frameRate.numerator / options.frameRate.denominator,
                     bitrateMode: 'variable',
                     targetBitrate: options.videoBitrate,
+                    sourceColorSpace,
                 },
                 audio: {
                     codec: profile.audioCodec,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aelionsdk/export",
-  "version": "0.1.0-beta.1",
+  "version": "1.0.0-rc.1",
   "description": "Streaming WebCodecs and WebM export pipeline for AelionSDK",
   "license": "MIT",
   "repository": {
@@ -34,9 +34,9 @@
     "provenance": true
   },
   "dependencies": {
-    "@aelionsdk/core": "0.1.0-beta.1",
-    "@aelionsdk/media": "0.1.0-beta.1",
-    "@aelionsdk/render-ir": "0.1.0-beta.1",
+    "@aelionsdk/core": "1.0.0-rc.1",
+    "@aelionsdk/media": "1.0.0-rc.1",
+    "@aelionsdk/render-ir": "1.0.0-rc.1",
     "mediabunny": "1.50.8"
   },
   "scripts": {