webcodecs-node 0.3.0 → 0.5.0

package/dist/utils/errors.js

@@ -0,0 +1,84 @@
+/**
+ * Standardized error utilities for WebCodecs compliance
+ *
+ * The WebCodecs spec uses specific DOMException error names:
+ * - InvalidStateError: operation on wrong state
+ * - NotSupportedError: unsupported codec/config
+ * - DataError: malformed/corrupt data
+ * - EncodingError: codec processing failure
+ * - AbortError: operation was aborted
+ * - TypeError: invalid parameters (thrown, not via callback)
+ * - QuotaExceededError: queue full
+ * - TimeoutError: operation timed out
+ */
+import { DOMException } from '../types/index.js';
+/**
+ * Create a WebCodecs-compliant error
+ */
+export function createWebCodecsError(message, name) {
+    return new DOMException(message, name);
+}
+/**
+ * Create an InvalidStateError (e.g., encoder not configured)
+ */
+export function invalidStateError(message) {
+    return new DOMException(message, 'InvalidStateError');
+}
+/**
+ * Create a NotSupportedError (e.g., unsupported codec)
+ */
+export function notSupportedError(message) {
+    return new DOMException(message, 'NotSupportedError');
+}
+/**
+ * Create a DataError (e.g., corrupt input data)
+ */
+export function dataError(message) {
+    return new DOMException(message, 'DataError');
+}
+/**
+ * Create an EncodingError (e.g., codec processing failed)
+ */
+export function encodingError(message) {
+    return new DOMException(message, 'EncodingError');
+}
+/**
+ * Create an AbortError (e.g., operation was reset/closed)
+ */
+export function abortError(message) {
+    return new DOMException(message, 'AbortError');
+}
+/**
+ * Create a QuotaExceededError (e.g., queue full)
+ */
+export function quotaExceededError(message) {
+    return new DOMException(message, 'QuotaExceededError');
+}
+/**
+ * Create a TimeoutError (e.g., operation timed out)
+ */
+export function timeoutError(message) {
+    return new DOMException(message, 'TimeoutError');
+}
+/**
+ * Wrap an error as a DOMException if it isn't already
+ *
+ * @param error - The error to wrap
+ * @param defaultName - The error name to use if error is not a DOMException
+ */
+export function wrapAsWebCodecsError(error, defaultName = 'EncodingError') {
+    if (error instanceof DOMException) {
+        return error;
+    }
+    if (error instanceof Error) {
+        return new DOMException(error.message, defaultName);
+    }
+    return new DOMException(String(error), defaultName);
+}
+/**
+ * Check if an error is a specific WebCodecs error type
+ */
+export function isWebCodecsError(error, name) {
+    return error instanceof DOMException && error.name === name;
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAcjD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,IAAwB;IAExB,OAAO,IAAI,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,IAAI,YAAY,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,IAAI,YAAY,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,IAAI,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,IAAI,YAAY,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO,IAAI,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO,IAAI,YAAY,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,IAAI,YAAY,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAc,EACd,cAAkC,eAAe;IAEjD,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,IAAwB;IACvE,OAAO,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AAC9D,CAAC"}

package/dist/utils/hardware-pool.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Hardware Context Pool - Reuses GPU hardware contexts across encoders/decoders
+ *
+ * Creating hardware contexts (VAAPI, CUDA, QSV, etc.) has overhead.
+ * This pool maintains a set of reusable contexts to improve performance
+ * when encoding/decoding multiple streams or files sequentially.
+ */
+import { HardwareContext } from 'node-av/api';
+/**
+ * Configuration for the hardware context pool
+ */
+export interface HardwarePoolConfig {
+    /** Maximum number of contexts to keep in the pool per device type */
+    maxContextsPerType?: number;
+    /** Time in ms after which unused contexts are disposed (default: 60000ms = 1 minute) */
+    idleTimeoutMs?: number;
+    /** Whether to automatically initialize contexts on first acquire (default: true) */
+    lazyInit?: boolean;
+}
+/**
+ * Pool for reusing hardware contexts
+ */
+declare class HardwareContextPool {
+    private pools;
+    private config;
+    private cleanupTimer;
+    private disposed;
+    constructor(config?: HardwarePoolConfig);
+    /**
+     * Acquire a hardware context from the pool
+     * Creates a new one if none available
+     *
+     * @param preferredType - Preferred device type (vaapi, cuda, qsv, videotoolbox)
+     * @returns Hardware context or null if none available
+     */
+    acquire(preferredType?: string): HardwareContext | null;
+    /**
+     * Release a hardware context back to the pool
+     * The context will be reused by future acquire() calls
+     *
+     * @param context - The hardware context to release
+     */
+    release(context: HardwareContext | null): void;
+    /**
+     * Get pool statistics
+     */
+    stats(): {
+        deviceType: string;
+        total: number;
+        inUse: number;
+        idle: number;
+    }[];
+    /**
+     * Dispose all contexts and stop the pool
+     */
+    dispose(): void;
+    private acquireFromPool;
+    private acquireAnyAvailable;
+    private trackContext;
+    private disposeContext;
+    private startCleanupTimer;
+    private cleanupIdleContexts;
+}
+/**
+ * Get the global hardware context pool
+ * Creates one on first access with default configuration
+ */
+export declare function getHardwarePool(): HardwareContextPool;
+/**
+ * Initialize the global pool with custom configuration
+ * Should be called before first use if custom config is needed
+ */
+export declare function initHardwarePool(config: HardwarePoolConfig): HardwareContextPool;
+/**
+ * Dispose the global pool and release all contexts
+ * Call this when shutting down the application
+ */
+export declare function disposeHardwarePool(): void;
+/**
+ * Convenience function to acquire a hardware context from the global pool
+ */
+export declare function acquireHardwareContext(preferredType?: string): HardwareContext | null;
+/**
+ * Convenience function to release a hardware context back to the global pool
+ */
+export declare function releaseHardwareContext(context: HardwareContext | null): void;
+export { HardwareContextPool };
+//# sourceMappingURL=hardware-pool.d.ts.map

package/dist/utils/hardware-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardware-pool.d.ts","sourceRoot":"","sources":["../../src/utils/hardware-pool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAe9C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wFAAwF;IACxF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAQD;;GAEG;AACH,cAAM,mBAAmB;IACvB,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,GAAE,kBAAuB;IAK3C;;;;;;OAMG;IACH,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAoCvD;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI;IAmC9C;;OAEG;IACH,KAAK,IAAI;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;IAgB7E;;OAEG;IACH,OAAO,IAAI,IAAI;IAwBf,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,mBAAmB;CAsB5B;AAKD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,mBAAmB,CAKrD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,mBAAmB,CAMhF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAErF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAE5E;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/utils/hardware-pool.js

@@ -0,0 +1,266 @@
+/**
+ * Hardware Context Pool - Reuses GPU hardware contexts across encoders/decoders
+ *
+ * Creating hardware contexts (VAAPI, CUDA, QSV, etc.) has overhead.
+ * This pool maintains a set of reusable contexts to improve performance
+ * when encoding/decoding multiple streams or files sequentially.
+ */
+import { HardwareContext } from 'node-av/api';
+import { createLogger } from './logger.js';
+const logger = createLogger('HardwarePool');
+const DEFAULT_CONFIG = {
+    maxContextsPerType: 2,
+    idleTimeoutMs: 60_000,
+    lazyInit: true,
+};
+/**
+ * Pool for reusing hardware contexts
+ */
+class HardwareContextPool {
+    pools = new Map();
+    config;
+    cleanupTimer = null;
+    disposed = false;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.startCleanupTimer();
+    }
+    /**
+     * Acquire a hardware context from the pool
+     * Creates a new one if none available
+     *
+     * @param preferredType - Preferred device type (vaapi, cuda, qsv, videotoolbox)
+     * @returns Hardware context or null if none available
+     */
+    acquire(preferredType) {
+        if (this.disposed) {
+            return null;
+        }
+        // Try to get from pool first
+        if (preferredType) {
+            const pooled = this.acquireFromPool(preferredType);
+            if (pooled) {
+                logger.debug(`Reusing ${preferredType} context from pool`);
+                return pooled;
+            }
+        }
+        // Try auto-detection
+        const pooled = this.acquireAnyAvailable();
+        if (pooled) {
+            return pooled;
+        }
+        // Create new context
+        try {
+            const context = HardwareContext.auto();
+            if (context) {
+                const deviceType = context.deviceTypeName || 'unknown';
+                logger.info(`Created new hardware context: ${deviceType}`);
+                this.trackContext(context, deviceType);
+                return context;
+            }
+        }
+        catch (err) {
+            logger.debug(`Failed to create hardware context: ${err.message}`);
+        }
+        return null;
+    }
+    /**
+     * Release a hardware context back to the pool
+     * The context will be reused by future acquire() calls
+     *
+     * @param context - The hardware context to release
+     */
+    release(context) {
+        if (!context || this.disposed) {
+            return;
+        }
+        const deviceType = context.deviceTypeName || 'unknown';
+        const pool = this.pools.get(deviceType);
+        if (!pool) {
+            // Context wasn't tracked, dispose it
+            this.disposeContext(context);
+            return;
+        }
+        const entry = pool.find(e => e.context === context);
+        if (entry) {
+            entry.inUse = false;
+            entry.lastUsed = Date.now();
+            logger.debug(`Released ${deviceType} context back to pool (uses: ${entry.useCount})`);
+        }
+        else {
+            // Context not in pool but matches type - add if pool not full
+            if (pool.length < this.config.maxContextsPerType) {
+                pool.push({
+                    context,
+                    inUse: false,
+                    lastUsed: Date.now(),
+                    useCount: 1,
+                });
+                logger.debug(`Added ${deviceType} context to pool`);
+            }
+            else {
+                this.disposeContext(context);
+            }
+        }
+    }
+    /**
+     * Get pool statistics
+     */
+    stats() {
+        const result = [];
+        for (const [deviceType, pool] of this.pools) {
+            const inUse = pool.filter(e => e.inUse).length;
+            result.push({
+                deviceType,
+                total: pool.length,
+                inUse,
+                idle: pool.length - inUse,
+            });
+        }
+        return result;
+    }
+    /**
+     * Dispose all contexts and stop the pool
+     */
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        for (const [deviceType, pool] of this.pools) {
+            for (const entry of pool) {
+                this.disposeContext(entry.context);
+            }
+            logger.debug(`Disposed ${pool.length} ${deviceType} contexts`);
+        }
+        this.pools.clear();
+        logger.info('Hardware context pool disposed');
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Private methods
+    // ─────────────────────────────────────────────────────────────────────────────
+    acquireFromPool(deviceType) {
+        const pool = this.pools.get(deviceType);
+        if (!pool)
+            return null;
+        const available = pool.find(e => !e.inUse);
+        if (available) {
+            available.inUse = true;
+            available.useCount++;
+            return available.context;
+        }
+        return null;
+    }
+    acquireAnyAvailable() {
+        for (const [deviceType, pool] of this.pools) {
+            const available = pool.find(e => !e.inUse);
+            if (available) {
+                available.inUse = true;
+                available.useCount++;
+                logger.debug(`Reusing ${deviceType} context from pool`);
+                return available.context;
+            }
+        }
+        return null;
+    }
+    trackContext(context, deviceType) {
+        let pool = this.pools.get(deviceType);
+        if (!pool) {
+            pool = [];
+            this.pools.set(deviceType, pool);
+        }
+        pool.push({
+            context,
+            inUse: true,
+            lastUsed: Date.now(),
+            useCount: 1,
+        });
+    }
+    disposeContext(context) {
+        try {
+            context.dispose();
+        }
+        catch (err) {
+            logger.debug(`Error disposing context: ${err.message}`);
+        }
+    }
+    startCleanupTimer() {
+        // Run cleanup every 10 seconds
+        this.cleanupTimer = setInterval(() => {
+            this.cleanupIdleContexts();
+        }, 10_000);
+        // Don't prevent process from exiting
+        if (this.cleanupTimer.unref) {
+            this.cleanupTimer.unref();
+        }
+    }
+    cleanupIdleContexts() {
+        const now = Date.now();
+        for (const [deviceType, pool] of this.pools) {
+            // Keep at least one context per type, remove extras that are idle
+            const keepCount = 1;
+            let removed = 0;
+            for (let i = pool.length - 1; i >= keepCount; i--) {
+                const entry = pool[i];
+                if (!entry.inUse && (now - entry.lastUsed) > this.config.idleTimeoutMs) {
+                    pool.splice(i, 1);
+                    this.disposeContext(entry.context);
+                    removed++;
+                }
+            }
+            if (removed > 0) {
+                logger.debug(`Cleaned up ${removed} idle ${deviceType} contexts`);
+            }
+        }
+    }
+}
+// Singleton instance
+let globalPool = null;
+/**
+ * Get the global hardware context pool
+ * Creates one on first access with default configuration
+ */
+export function getHardwarePool() {
+    if (!globalPool) {
+        globalPool = new HardwareContextPool();
+    }
+    return globalPool;
+}
+/**
+ * Initialize the global pool with custom configuration
+ * Should be called before first use if custom config is needed
+ */
+export function initHardwarePool(config) {
+    if (globalPool) {
+        globalPool.dispose();
+    }
+    globalPool = new HardwareContextPool(config);
+    return globalPool;
+}
+/**
+ * Dispose the global pool and release all contexts
+ * Call this when shutting down the application
+ */
+export function disposeHardwarePool() {
+    if (globalPool) {
+        globalPool.dispose();
+        globalPool = null;
+    }
+}
+/**
+ * Convenience function to acquire a hardware context from the global pool
+ */
+export function acquireHardwareContext(preferredType) {
+    return getHardwarePool().acquire(preferredType);
+}
+/**
+ * Convenience function to release a hardware context back to the global pool
+ */
+export function releaseHardwareContext(context) {
+    getHardwarePool().release(context);
+}
+export { HardwareContextPool };
+//# sourceMappingURL=hardware-pool.js.map

package/dist/utils/hardware-pool.js.map

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

package/dist/utils/index.d.ts

@@ -9,4 +9,9 @@ export { parseAvcDecoderConfig, convertAvccToAnnexB, splitAnnexBNals, extractAvc
 export { parseHvccDecoderConfig, convertHvccToAnnexB, splitHevcAnnexBNals, extractHevcParameterSetsFromAnnexB, buildHvccDecoderConfig, convertAnnexBToHvcc, type HvccConfig, } from './hevc.js';
 export { parseAudioSpecificConfig, wrapAacFrameWithAdts, buildAudioSpecificConfig, stripAdtsHeader, type AacConfig, } from './aac.js';
 export { WebCodecsEventTarget, type EventListener, type EventListenerOptions, } from './event-target.js';
+export { getCodecBase, parseCodec, getVideoCodecName, getAudioCodecName, isVideoCodec, isAudioCodec, clearCodecCache, type ParsedCodec, type VideoCodecName, type AudioCodecName, } from './codec-cache.js';
+export { withTimeout, createTimeoutWrapper, createTimeoutAbortController, DEFAULT_TIMEOUTS, } from './timeout.js';
+export { createWebCodecsError, invalidStateError, notSupportedError, dataError, encodingError, abortError, quotaExceededError, timeoutError, wrapAsWebCodecsError, isWebCodecsError, type WebCodecsErrorName, } from './errors.js';
+export { HardwareContextPool, getHardwarePool, initHardwarePool, disposeHardwarePool, acquireHardwareContext, releaseHardwareContext, type HardwarePoolConfig, } from './hardware-pool.js';
+export { BufferPool, getBufferPool, initBufferPool, disposeBufferPool, acquireBuffer, releaseBuffer, type BufferPoolConfig, type BufferPoolStats, } from './buffer-pool.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,KAAK,QAAQ,EACb,KAAK,QAAQ,GACd,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,iCAAiC,EACjC,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,SAAS,GACf,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,kCAAkC,EAClC,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EACf,KAAK,SAAS,GACf,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,KAAK,QAAQ,EACb,KAAK,QAAQ,GACd,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,iCAAiC,EACjC,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,SAAS,GACf,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,kCAAkC,EAClC,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EACf,KAAK,SAAS,GACf,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,UAAU,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/utils/index.js

@@ -15,4 +15,14 @@ export { parseHvccDecoderConfig, convertHvccToAnnexB, splitHevcAnnexBNals, extra
 export { parseAudioSpecificConfig, wrapAacFrameWithAdts, buildAudioSpecificConfig, stripAdtsHeader, } from './aac.js';
 // EventTarget support
 export { WebCodecsEventTarget, } from './event-target.js';
+// Codec caching utilities
+export { getCodecBase, parseCodec, getVideoCodecName, getAudioCodecName, isVideoCodec, isAudioCodec, clearCodecCache, } from './codec-cache.js';
+// Timeout utilities
+export { withTimeout, createTimeoutWrapper, createTimeoutAbortController, DEFAULT_TIMEOUTS, } from './timeout.js';
+// Error utilities
+export { createWebCodecsError, invalidStateError, notSupportedError, dataError, encodingError, abortError, quotaExceededError, timeoutError, wrapAsWebCodecsError, isWebCodecsError, } from './errors.js';
+// Hardware context pooling
+export { HardwareContextPool, getHardwarePool, initHardwarePool, disposeHardwarePool, acquireHardwareContext, releaseHardwareContext, } from './hardware-pool.js';
+// Buffer pooling for efficient memory reuse
+export { BufferPool, getBufferPool, initBufferPool, disposeBufferPool, acquireBuffer, releaseBuffer, } from './buffer-pool.js';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mBAAmB;AACnB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,uBAAuB;AACvB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,SAAS;AACT,OAAO,EACL,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,WAAW,GAGZ,MAAM,aAAa,CAAC;AAErB,cAAc;AACd,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,GAIpB,MAAM,kBAAkB,CAAC;AAE1B,gBAAgB;AAChB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,iCAAiC,EACjC,qBAAqB,EACrB,mBAAmB,GAEpB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,kCAAkC,EAClC,sBAAsB,EACtB,mBAAmB,GAEpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,GAEhB,MAAM,UAAU,CAAC;AAElB,sBAAsB;AACtB,OAAO,EACL,oBAAoB,GAGrB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mBAAmB;AACnB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,uBAAuB;AACvB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,SAAS;AACT,OAAO,EACL,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,WAAW,GAGZ,MAAM,aAAa,CAAC;AAErB,cAAc;AACd,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,GAIpB,MAAM,kBAAkB,CAAC;AAE1B,gBAAgB;AAChB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,iCAAiC,EACjC,qBAAqB,EACrB,mBAAmB,GAEpB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,kCAAkC,EAClC,sBAAsB,EACtB,mBAAmB,GAEpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,GAEhB,MAAM,UAAU,CAAC;AAElB,sBAAsB;AACtB,OAAO,EACL,oBAAoB,GAGrB,MAAM,mBAAmB,CAAC;AAE3B,0BAA0B;AAC1B,OAAO,EACL,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,eAAe,GAIhB,MAAM,kBAAkB,CAAC;AAE1B,oBAAoB;AACpB,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,kBAAkB;AAClB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,GAEjB,MAAM,aAAa,CAAC;AAErB,2BAA2B;AAC3B,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,GAEvB,MAAM,oBAAoB,CAAC;AAE5B,4CAA4C;AAC5C,OAAO,EACL,UAAU,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,GAGd,MAAM,kBAAkB,CAAC"}

package/dist/utils/timeout.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Timeout utilities for async operations
+ */
+/**
+ * Default timeout values in milliseconds
+ */
+export declare const DEFAULT_TIMEOUTS: {
+    /** Timeout for encoder/decoder configuration */
+    readonly configure: 10000;
+    /** Timeout for flush operations */
+    readonly flush: 30000;
+    /** Timeout for muxer/demuxer open operations */
+    readonly open: 15000;
+    /** Timeout for close operations */
+    readonly close: 10000;
+};
+/**
+ * Wrap a promise with a timeout
+ *
+ * @param promise - The promise to wrap
+ * @param timeoutMs - Timeout in milliseconds
+ * @param operationName - Name of the operation for error messages
+ * @returns The result of the promise
+ * @throws DOMException with TimeoutError if timeout is exceeded
+ */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, operationName?: string): Promise<T>;
+/**
+ * Create a timeout-wrapped version of an async function
+ *
+ * @param fn - The async function to wrap
+ * @param timeoutMs - Timeout in milliseconds
+ * @param operationName - Name of the operation for error messages
+ * @returns A wrapped function that will timeout
+ */
+export declare function createTimeoutWrapper<T extends (...args: any[]) => Promise<any>>(fn: T, timeoutMs: number, operationName: string): T;
+/**
+ * Abort controller with timeout
+ * Useful for operations that support AbortSignal
+ */
+export declare function createTimeoutAbortController(timeoutMs: number): {
+    controller: AbortController;
+    cleanup: () => void;
+};
+//# sourceMappingURL=timeout.d.ts.map

package/dist/utils/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../src/utils/timeout.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,gDAAgD;;IAEhD,mCAAmC;;IAEnC,gDAAgD;;IAEhD,mCAAmC;;CAE3B,CAAC;AAEX;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,MAAoB,GAClC,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EAC7E,EAAE,EAAE,CAAC,EACL,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,CAAC,CAIH;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG;IAC/D,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAUA"}

package/dist/utils/timeout.js

@@ -0,0 +1,73 @@
+/**
+ * Timeout utilities for async operations
+ */
+import { DOMException } from '../types/index.js';
+/**
+ * Default timeout values in milliseconds
+ */
+export const DEFAULT_TIMEOUTS = {
+    /** Timeout for encoder/decoder configuration */
+    configure: 10_000,
+    /** Timeout for flush operations */
+    flush: 30_000,
+    /** Timeout for muxer/demuxer open operations */
+    open: 15_000,
+    /** Timeout for close operations */
+    close: 10_000,
+};
+/**
+ * Wrap a promise with a timeout
+ *
+ * @param promise - The promise to wrap
+ * @param timeoutMs - Timeout in milliseconds
+ * @param operationName - Name of the operation for error messages
+ * @returns The result of the promise
+ * @throws DOMException with TimeoutError if timeout is exceeded
+ */
+export async function withTimeout(promise, timeoutMs, operationName = 'Operation') {
+    let timeoutId = null;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            reject(new DOMException(`${operationName} timed out after ${timeoutMs}ms`, 'TimeoutError'));
+        }, timeoutMs);
+    });
+    try {
+        const result = await Promise.race([promise, timeoutPromise]);
+        if (timeoutId)
+            clearTimeout(timeoutId);
+        return result;
+    }
+    catch (error) {
+        if (timeoutId)
+            clearTimeout(timeoutId);
+        throw error;
+    }
+}
+/**
+ * Create a timeout-wrapped version of an async function
+ *
+ * @param fn - The async function to wrap
+ * @param timeoutMs - Timeout in milliseconds
+ * @param operationName - Name of the operation for error messages
+ * @returns A wrapped function that will timeout
+ */
+export function createTimeoutWrapper(fn, timeoutMs, operationName) {
+    return (async (...args) => {
+        return withTimeout(fn(...args), timeoutMs, operationName);
+    });
+}
+/**
+ * Abort controller with timeout
+ * Useful for operations that support AbortSignal
+ */
+export function createTimeoutAbortController(timeoutMs) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => {
+        controller.abort(new DOMException('Operation timed out', 'TimeoutError'));
+    }, timeoutMs);
+    return {
+        controller,
+        cleanup: () => clearTimeout(timeoutId),
+    };
+}
+//# sourceMappingURL=timeout.js.map

package/dist/utils/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/utils/timeout.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,gDAAgD;IAChD,SAAS,EAAE,MAAM;IACjB,mCAAmC;IACnC,KAAK,EAAE,MAAM;IACb,gDAAgD;IAChD,IAAI,EAAE,MAAM;IACZ,mCAAmC;IACnC,KAAK,EAAE,MAAM;CACL,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAmB,EACnB,SAAiB,EACjB,gBAAwB,WAAW;IAEnC,IAAI,SAAS,GAA0B,IAAI,CAAC;IAE5C,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QACtD,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,MAAM,CAAC,IAAI,YAAY,CACrB,GAAG,aAAa,oBAAoB,SAAS,IAAI,EACjD,cAAc,CACf,CAAC,CAAC;QACL,CAAC,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;QAC7D,IAAI,SAAS;YAAE,YAAY,CAAC,SAAS,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,SAAS;YAAE,YAAY,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,EAAK,EACL,SAAiB,EACjB,aAAqB;IAErB,OAAO,CAAC,KAAK,EAAE,GAAG,IAAmB,EAA0B,EAAE;QAC/D,OAAO,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAC5D,CAAC,CAAM,CAAC;AACV,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,SAAiB;IAI5D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;QAChC,UAAU,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,qBAAqB,EAAE,cAAc,CAAC,CAAC,CAAC;IAC5E,CAAC,EAAE,SAAS,CAAC,CAAC;IAEd,OAAO;QACL,UAAU;QACV,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/dist/utils/type-guards.d.ts

@@ -24,9 +24,19 @@ export interface CanvasLike {
 export interface VideoFrameLike {
     codedWidth: number;
     codedHeight: number;
-    format: string;
+    format: string | null;
     timestamp: number;
     duration?: number | null;
+    displayWidth: number;
+    displayHeight: number;
+    visibleRect?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+    allocationSize?: (options?: unknown) => number;
+    copyTo?: (dest: Uint8Array, options?: unknown) => void;
     _buffer?: Uint8Array;
     _rawData?: Uint8Array;
     _data?: Uint8Array;

package/dist/utils/type-guards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../src/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;IACzD,aAAa,CAAC,EAAE,MAAM,iBAAiB,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CAQlE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAQ5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CASpE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAQzD"}
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../src/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;IACzD,aAAa,CAAC,EAAE,MAAM,iBAAiB,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7E,cAAc,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC;IAC/C,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACvD,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CAQlE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAQ5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CASpE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAQzD"}