@pproenca/node-webcodecs 0.1.1-alpha.0 → 0.1.1-alpha.5

package/dist/binding.js

@@ -2,140 +2,58 @@
 // Copyright 2024 The node-webcodecs Authors
 // SPDX-License-Identifier: MIT
 //
-// Native binding loader with fallback chain and enhanced error messages.
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
+// Native binding loader using esbuild-style platform resolution.
+// Tries platform-specific package first, falls back to node-gyp-build for local dev.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.platformInfo = exports.binding = void 0;
-const fs = __importStar(require("node:fs"));
-const path = __importStar(require("node:path"));
-const platform_1 = require("./platform");
-const rootDir = path.resolve(__dirname, '..');
-const candidates = [
-    // Development build (node-gyp output)
-    path.join(rootDir, 'build', 'Release', 'node_webcodecs.node'),
-    path.join(rootDir, 'build', 'Debug', 'node_webcodecs.node'),
-    // node-gyp-build compatible
-    () => {
-        try {
-            return require('node-gyp-build')(rootDir);
-        }
-        catch {
-            throw new Error('node-gyp-build not available');
-        }
-    },
-    // Prebuilt from platform package (sharp pattern: @scope/pkg-platform/binding.node)
-    () => {
-        const pkg = (0, platform_1.getPrebuiltPackageName)();
-        const bindingPath = `${pkg}/node-webcodecs.node`;
-        return require(bindingPath);
-    },
-];
-function getPlatformBuildInstructions() {
-    const platform = process.platform;
-    if (platform === 'darwin') {
-        return `  brew install ffmpeg pkg-config
-  npm run build:native`;
-    }
-    if (platform === 'linux') {
-        return `  sudo apt-get install libavcodec-dev libavutil-dev libswscale-dev libswresample-dev libavfilter-dev pkg-config
-  npm run build:native`;
-    }
-    if (platform === 'win32') {
-        return `  Download FFmpeg from https://github.com/BtbN/FFmpeg-Builds/releases
-  Set FFMPEG_PATH environment variable
-  npm run build:native`;
-    }
-    return `  Install FFmpeg development libraries
-  npm run build:native`;
-}
-function buildHelpMessage(errors) {
-    const platform = (0, platform_1.runtimePlatformArch)();
-    const hasPrebuilt = (0, platform_1.isPrebuiltAvailable)();
-    let msg = `Could not load native binding for ${platform}.\n\n`;
-    msg += `Node.js: ${process.version}\n\n`;
-    msg += 'Attempted paths:\n';
-    for (const { path: p, error } of errors) {
-        msg += `  - ${p}: ${error.message}\n`;
-    }
-    msg += '\nPossible solutions:\n';
-    if (hasPrebuilt) {
-        msg += '  1. Install with optional dependencies:\n';
-        msg += '     npm install --include=optional\n\n';
-        msg += '  2. Build from source:\n';
-    }
-    else {
-        msg += '  1. Build from source:\n';
-    }
-    msg += getPlatformBuildInstructions();
-    return msg;
-}
+const node_path_1 = require("node:path");
+const PLATFORMS = {
+    'darwin-arm64': '@pproenca/node-webcodecs-darwin-arm64',
+    'darwin-x64': '@pproenca/node-webcodecs-darwin-x64',
+    'linux-x64': '@pproenca/node-webcodecs-linux-x64',
+};
+/**
+ * Load the native binding.
+ *
+ * Resolution order:
+ * 1. Platform-specific npm package (production path via optionalDependencies)
+ * 2. node-gyp-build (local development fallback)
+ */
 function loadBinding() {
-    const errors = [];
-    for (const candidate of candidates) {
-        try {
-            if (typeof candidate === 'function') {
-                const binding = candidate();
-                if (binding && typeof binding.VideoEncoder === 'function') {
-                    return binding;
-                }
-                throw new Error('Invalid binding: missing VideoEncoder');
-            }
-            if (!fs.existsSync(candidate)) {
-                continue;
-            }
-            const binding = require(candidate);
-            if (typeof binding.VideoEncoder !== 'function') {
-                throw new Error('Invalid binding: missing VideoEncoder');
-            }
-            return binding;
-        }
-        catch (err) {
-            errors.push({
-                path: typeof candidate === 'string' ? candidate : 'dynamic loader',
-                error: err instanceof Error ? err : new Error(String(err)),
-            });
-        }
+    const platform = `${process.platform}-${process.arch}`;
+    const pkg = PLATFORMS[platform];
+    if (!pkg) {
+        throw new Error(`Unsupported platform: ${platform}. ` +
+            `Supported platforms: ${Object.keys(PLATFORMS).join(', ')}`);
+    }
+    // Try platform-specific package first (production path)
+    try {
+        const pkgPath = require.resolve(`${pkg}/package.json`);
+        const binPath = (0, node_path_1.join)((0, node_path_1.dirname)(pkgPath), 'bin', 'node.napi.node');
+        return require(binPath);
+    }
+    catch {
+        // Platform package not installed - fallback to local build
+    }
+    // Fallback to node-gyp-build for local development
+    try {
+        const nodeGypBuild = require('node-gyp-build');
+        const rootDir = (0, node_path_1.resolve)(__dirname, '..');
+        return nodeGypBuild(rootDir);
+    }
+    catch (err) {
+        throw new Error(`Could not load the node-webcodecs native binding for ${platform}.\n` +
+            `Error: ${err instanceof Error ? err.message : String(err)}\n\n` +
+            `Solutions:\n` +
+            `  1. Install the main package: npm install @pproenca/node-webcodecs\n` +
+            `  2. Build from source: npm rebuild --build-from-source\n` +
+            `  3. Ensure FFmpeg dev libs: pkg-config --exists libavcodec\n`);
     }
-    throw new Error(buildHelpMessage(errors));
 }
 exports.binding = loadBinding();
 exports.platformInfo = {
     platform: process.platform,
     arch: process.arch,
-    runtimePlatform: (0, platform_1.runtimePlatformArch)(),
     nodeVersion: process.version,
     napiVersion: process.versions.napi ?? 'unknown',
-    prebuiltAvailable: (0, platform_1.isPrebuiltAvailable)(),
 };

package/dist/control-message-queue.js

@@ -71,7 +71,6 @@ class ControlMessageQueue {
             }
         }
         this.processing = false;
-        // Continue processing if more messages
         if (this.queue.length > 0) {
             this.scheduleProcessing();
         }

package/dist/demuxer.d.ts

@@ -4,6 +4,13 @@ export declare class Demuxer {
     constructor(init: DemuxerInit);
     open(path: string): Promise<void>;
     demux(): Promise<void>;
+    /**
+     * Read packets from the file in chunks.
+     * This is useful for yielding to the event loop during demuxing.
+     * @param maxPackets - Maximum number of packets to read. 0 = unlimited (reads all).
+     * @returns The number of packets actually read.
+     */
+    demuxPackets(maxPackets?: number): number;
     close(): void;
     getVideoTrack(): TrackInfo | null;
     getAudioTrack(): TrackInfo | null;

package/dist/demuxer.js

@@ -30,6 +30,15 @@ class Demuxer {
     async demux() {
         return this._native.demux();
     }
+    /**
+     * Read packets from the file in chunks.
+     * This is useful for yielding to the event loop during demuxing.
+     * @param maxPackets - Maximum number of packets to read. 0 = unlimited (reads all).
+     * @returns The number of packets actually read.
+     */
+    demuxPackets(maxPackets) {
+        return this._native.demuxPackets(maxPackets ?? 0);
+    }
     close() {
         this._native.close();
     }

package/dist/encoded-chunks.d.ts

@@ -9,11 +9,22 @@ export declare class EncodedVideoChunk {
     /** @internal */
     _native: NativeEncodedVideoChunk;
     constructor(init: EncodedVideoChunkInit);
+    /**
+     * @internal
+     * Wrap an existing native EncodedVideoChunk without copying data.
+     * Used by the encoder's async output path to avoid double-copying.
+     */
+    static _fromNative(nativeChunk: NativeEncodedVideoChunk): EncodedVideoChunk;
     get type(): 'key' | 'delta';
     get timestamp(): number;
     get duration(): number | null;
     get byteLength(): number;
     copyTo(destination: ArrayBuffer | ArrayBufferView): void;
+    /**
+     * Releases the internal data buffer.
+     * Per W3C WebCodecs spec, this allows early release of memory.
+     */
+    close(): void;
 }
 export declare class EncodedAudioChunk {
     private _native;
@@ -23,5 +34,10 @@ export declare class EncodedAudioChunk {
     get duration(): number | null;
     get byteLength(): number;
     copyTo(destination: ArrayBuffer | ArrayBufferView): void;
+    /**
+     * Releases the internal data buffer.
+     * Per W3C WebCodecs spec, this allows early release of memory.
+     */
+    close(): void;
     get _nativeChunk(): NativeEncodedAudioChunk;
 }

package/dist/encoded-chunks.js

@@ -7,15 +7,45 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EncodedAudioChunk = exports.EncodedVideoChunk = void 0;
 const binding_1 = require("./binding");
+const transfer_1 = require("./transfer");
 // Load native addon with type assertion
 const native = binding_1.binding;
+/**
+ * FinalizationRegistry for automatic cleanup of native EncodedVideoChunk objects.
+ * When a JS EncodedVideoChunk wrapper becomes unreachable, the registry callback
+ * fires and releases the native memory via close().
+ *
+ * This provides a safety net for users who forget to call close(), preventing
+ * memory leaks in high-throughput scenarios where GC may be delayed.
+ */
+const videoChunkRegistry = new FinalizationRegistry((native) => {
+    // The weak reference to the JS wrapper is now dead, but the native object
+    // may still be valid. Call close() to release its internal data buffer.
+    // close() is idempotent - safe to call even if already closed.
+    try {
+        native.close();
+    }
+    catch {
+        // Ignore errors - native object may already be destroyed
+    }
+});
+/**
+ * FinalizationRegistry for automatic cleanup of native EncodedAudioChunk objects.
+ */
+const audioChunkRegistry = new FinalizationRegistry((native) => {
+    try {
+        native.close();
+    }
+    catch {
+        // Ignore errors - native object may already be destroyed
+    }
+});
 class EncodedVideoChunk {
     constructor(init) {
         // W3C spec: type must be 'key' or 'delta'
         if (init.type !== 'key' && init.type !== 'delta') {
             throw new TypeError(`Invalid type: ${init.type}`);
         }
-        // Convert BufferSource to Buffer for native
         let dataBuffer;
         if (init.data instanceof ArrayBuffer) {
             dataBuffer = Buffer.from(init.data);
@@ -32,6 +62,26 @@ class EncodedVideoChunk {
             duration: init.duration,
             data: dataBuffer,
         });
+        // Register with FinalizationRegistry for automatic cleanup.
+        // When this JS wrapper is GC'd, the registry callback will call close()
+        // on the native object to release memory.
+        videoChunkRegistry.register(this, this._native, this);
+        // Handle ArrayBuffer transfer semantics per W3C spec
+        if (init.transfer && Array.isArray(init.transfer)) {
+            (0, transfer_1.detachArrayBuffers)(init.transfer.filter((b) => b instanceof ArrayBuffer));
+        }
+    }
+    /**
+     * @internal
+     * Wrap an existing native EncodedVideoChunk without copying data.
+     * Used by the encoder's async output path to avoid double-copying.
+     */
+    static _fromNative(nativeChunk) {
+        const chunk = Object.create(EncodedVideoChunk.prototype);
+        chunk._native = nativeChunk;
+        // Register with FinalizationRegistry for automatic cleanup
+        videoChunkRegistry.register(chunk, nativeChunk, chunk);
+        return chunk;
     }
     get type() {
         return this._native.type;
@@ -62,11 +112,24 @@ class EncodedVideoChunk {
             throw new TypeError('Destination must be ArrayBuffer or ArrayBufferView');
         }
     }
+    /**
+     * Releases the internal data buffer.
+     * Per W3C WebCodecs spec, this allows early release of memory.
+     */
+    close() {
+        // Unregister from FinalizationRegistry to prevent double-close.
+        // If close() is called explicitly, we don't need the registry callback.
+        videoChunkRegistry.unregister(this);
+        this._native.close();
+    }
 }
 exports.EncodedVideoChunk = EncodedVideoChunk;
 class EncodedAudioChunk {
     constructor(init) {
-        // Convert BufferSource to Buffer for native
+        // W3C spec: type must be 'key' or 'delta'
+        if (init.type !== 'key' && init.type !== 'delta') {
+            throw new TypeError(`Invalid type: ${init.type}`);
+        }
         let dataBuffer;
         if (init.data instanceof ArrayBuffer) {
             dataBuffer = Buffer.from(init.data);
@@ -83,6 +146,14 @@ class EncodedAudioChunk {
             duration: init.duration,
             data: dataBuffer,
         });
+        // Register with FinalizationRegistry for automatic cleanup.
+        // When this JS wrapper is GC'd, the registry callback will call close()
+        // on the native object to release memory.
+        audioChunkRegistry.register(this, this._native, this);
+        // Handle ArrayBuffer transfer semantics per W3C spec
+        if (init.transfer && Array.isArray(init.transfer)) {
+            (0, transfer_1.detachArrayBuffers)(init.transfer.filter((b) => b instanceof ArrayBuffer));
+        }
     }
     get type() {
         return this._native.type;
@@ -106,6 +177,15 @@ class EncodedAudioChunk {
             this._native.copyTo(uint8);
         }
     }
+    /**
+     * Releases the internal data buffer.
+     * Per W3C WebCodecs spec, this allows early release of memory.
+     */
+    close() {
+        // Unregister from FinalizationRegistry to prevent double-close.
+        audioChunkRegistry.unregister(this);
+        this._native.close();
+    }
     get _nativeChunk() {
         return this._native;
     }

package/dist/image-decoder.js

@@ -36,6 +36,7 @@ class ImageDecoder {
         this._initOptions = {
             type: init.type,
             colorSpaceConversion: init.colorSpaceConversion,
+            premultiplyAlpha: init.premultiplyAlpha,
             desiredWidth: init.desiredWidth,
             desiredHeight: init.desiredHeight,
             preferAnimation: init.preferAnimation,
@@ -74,6 +75,9 @@ class ImageDecoder {
         if ('colorSpaceConversion' in init && init.colorSpaceConversion) {
             nativeInit.colorSpaceConversion = init.colorSpaceConversion;
         }
+        if ('premultiplyAlpha' in init && init.premultiplyAlpha !== undefined) {
+            nativeInit.premultiplyAlpha = init.premultiplyAlpha;
+        }
         if ('desiredWidth' in init && init.desiredWidth !== undefined) {
             nativeInit.desiredWidth = init.desiredWidth;
         }

package/dist/index.d.ts

@@ -51,6 +51,17 @@ export declare const createEncoderConfigDescriptor: (config: object) => {
     colorMatrix: string;
     colorFullRange: boolean;
 };
+export declare const getCounters: () => {
+    videoFrames: number;
+    audioData: number;
+    videoEncoders: number;
+    videoDecoders: number;
+    audioEncoders: number;
+    audioDecoders: number;
+    queue: number;
+    process: number;
+    frames: number;
+};
 export type { ErrorCodeType } from './errors';
 export { AllocationError, ConfigurationError, DecodingError, EncodingError, ErrorCode, ffmpegErrorMessage, InvalidDataError, InvalidStateError, UnsupportedCodecError, WebCodecsError, } from './errors';
 export { ImageTrack } from './image-track';

package/dist/index.js

@@ -16,7 +16,7 @@
  * - SVC temporal layer tracking via scalabilityMode (L1T1, L1T2, L1T3)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TestVideoGenerator = exports.ResourceManager = exports.ImageTrackList = exports.ImageTrack = exports.WebCodecsError = exports.UnsupportedCodecError = exports.InvalidStateError = exports.InvalidDataError = exports.ffmpegErrorMessage = exports.ErrorCode = exports.EncodingError = exports.DecodingError = exports.ConfigurationError = exports.AllocationError = exports.createEncoderConfigDescriptor = exports.testAttrAsEnum = exports.ErrorBuilder = exports.clearFFmpegWarnings = exports.getFFmpegWarnings = exports.WarningAccumulator = exports.VideoFrame = exports.VideoColorSpace = exports.VideoFilter = exports.VideoEncoder = exports.VideoDecoder = exports.Muxer = exports.ImageDecoder = exports.EncodedVideoChunk = exports.EncodedAudioChunk = exports.Demuxer = exports.AudioEncoder = exports.AudioDecoder = exports.AudioData = exports.platformInfo = void 0;
+exports.TestVideoGenerator = exports.ResourceManager = exports.ImageTrackList = exports.ImageTrack = exports.WebCodecsError = exports.UnsupportedCodecError = exports.InvalidStateError = exports.InvalidDataError = exports.ffmpegErrorMessage = exports.ErrorCode = exports.EncodingError = exports.DecodingError = exports.ConfigurationError = exports.AllocationError = exports.getCounters = exports.createEncoderConfigDescriptor = exports.testAttrAsEnum = exports.ErrorBuilder = exports.clearFFmpegWarnings = exports.getFFmpegWarnings = exports.WarningAccumulator = exports.VideoFrame = exports.VideoColorSpace = exports.VideoFilter = exports.VideoEncoder = exports.VideoDecoder = exports.Muxer = exports.ImageDecoder = exports.EncodedVideoChunk = exports.EncodedAudioChunk = exports.Demuxer = exports.AudioEncoder = exports.AudioDecoder = exports.AudioData = exports.platformInfo = void 0;
 const binding_1 = require("./binding");
 Object.defineProperty(exports, "platformInfo", { enumerable: true, get: function () { return binding_1.platformInfo; } });
 // Load native addon with type assertion
@@ -54,6 +54,8 @@ exports.clearFFmpegWarnings = native.clearFFmpegWarnings;
 exports.ErrorBuilder = native.ErrorBuilder;
 exports.testAttrAsEnum = native.testAttrAsEnum;
 exports.createEncoderConfigDescriptor = native.createEncoderConfigDescriptor;
+// Export instance counters for monitoring and leak detection
+exports.getCounters = native.getCounters;
 // Re-export error classes and codes
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "AllocationError", { enumerable: true, get: function () { return errors_1.AllocationError; } });

package/dist/native-types.d.ts

@@ -65,6 +65,7 @@ export interface NativeVideoDecoder {
     readonly state: CodecState;
     readonly decodeQueueSize: number;
     readonly codecSaturated: boolean;
+    readonly pendingFrames: number;
     configure(config: VideoDecoderConfig): void;
     decode(chunk: NativeEncodedVideoChunk): void;
     flush(): Promise<void>;
@@ -80,6 +81,7 @@ export interface NativeEncodedVideoChunk {
     readonly duration: number | null;
     readonly byteLength: number;
     copyTo(dest: Uint8Array | ArrayBuffer): void;
+    close(): void;
 }
 /**
  * Native AudioData object from C++ addon
@@ -111,6 +113,7 @@ export interface NativeEncodedAudioChunk {
     readonly duration: number | null;
     readonly byteLength: number;
     copyTo(dest: Uint8Array | ArrayBuffer): void;
+    close(): void;
 }
 /**
  * Native AudioEncoder object from C++ addon
@@ -151,6 +154,12 @@ export interface NativeVideoFilter {
 export interface NativeDemuxer {
     open(path: string): void;
     demux(): void;
+    /**
+     * Read packets from the file in chunks.
+     * @param maxPackets - Maximum number of packets to read. 0 = unlimited.
+     * @returns The number of packets actually read.
+     */
+    demuxPackets(maxPackets: number): number;
     close(): void;
     getVideoTrack(): TrackInfo | null;
     getAudioTrack(): TrackInfo | null;
@@ -462,6 +471,17 @@ export interface NativeModule {
     getFFmpegWarnings: () => string[];
     clearFFmpegWarnings: () => void;
     testAttrAsEnum: (obj: object, attr: string) => string;
+    getCounters: () => {
+        videoFrames: number;
+        audioData: number;
+        videoEncoders: number;
+        videoDecoders: number;
+        audioEncoders: number;
+        audioDecoders: number;
+        queue: number;
+        process: number;
+        frames: number;
+    };
     createEncoderConfigDescriptor: (config: object) => {
         codec: string;
         width: number;

package/dist/platform.d.ts

@@ -1,6 +1,5 @@
 /**
  * Get the runtime platform-architecture string.
- * Handles musl vs glibc distinction on Linux.
  */
 export declare function runtimePlatformArch(): string;
 /**
@@ -15,17 +14,9 @@ export declare function buildPlatformArch(): string;
  * Platforms with prebuilt binaries available.
  * Must match what release.yml actually builds.
  */
-export declare const prebuiltPlatforms: readonly ["darwin-arm64", "darwin-x64", "linux-x64", "linuxmusl-x64", "win32-x64"];
+export declare const prebuiltPlatforms: readonly ["darwin-arm64", "darwin-x64", "linux-x64"];
 export type PrebuiltPlatform = (typeof prebuiltPlatforms)[number];
 /**
  * Check if a prebuilt binary is available for the current platform.
  */
 export declare function isPrebuiltAvailable(): boolean;
-/**
- * Get the npm package name for the prebuilt binary.
- */
-export declare function getPrebuiltPackageName(): string;
-/**
- * Get the npm package name for prebuilt FFmpeg.
- */
-export declare function getFFmpegPackageName(): string;

package/dist/platform.js

@@ -41,36 +41,12 @@ exports.prebuiltPlatforms = void 0;
 exports.runtimePlatformArch = runtimePlatformArch;
 exports.buildPlatformArch = buildPlatformArch;
 exports.isPrebuiltAvailable = isPrebuiltAvailable;
-exports.getPrebuiltPackageName = getPrebuiltPackageName;
-exports.getFFmpegPackageName = getFFmpegPackageName;
 const os = __importStar(require("node:os"));
-// Try to detect musl vs glibc on Linux
-function detectLibc() {
-    if (os.platform() !== 'linux')
-        return null;
-    try {
-        const { familySync } = require('detect-libc');
-        return familySync() === 'musl' ? 'musl' : 'glibc';
-    }
-    catch {
-        // detect-libc not available, assume glibc
-        return 'glibc';
-    }
-}
 /**
  * Get the runtime platform-architecture string.
- * Handles musl vs glibc distinction on Linux.
  */
 function runtimePlatformArch() {
-    const platform = os.platform();
-    const arch = os.arch();
-    if (platform === 'linux') {
-        const libc = detectLibc();
-        if (libc === 'musl') {
-            return `linuxmusl-${arch}`;
-        }
-    }
-    return `${platform}-${arch}`;
+    return `${os.platform()}-${os.arch()}`;
 }
 /**
  * Get the build-time platform-architecture string.
@@ -92,8 +68,6 @@ exports.prebuiltPlatforms = [
     'darwin-arm64',
     'darwin-x64',
     'linux-x64',
-    'linuxmusl-x64',
-    'win32-x64',
 ];
 /**
  * Check if a prebuilt binary is available for the current platform.
@@ -102,15 +76,3 @@ function isPrebuiltAvailable() {
     const platform = runtimePlatformArch();
     return exports.prebuiltPlatforms.includes(platform);
 }
-/**
- * Get the npm package name for the prebuilt binary.
- */
-function getPrebuiltPackageName() {
-    return `@pproenca/node-webcodecs-${runtimePlatformArch()}`;
-}
-/**
- * Get the npm package name for prebuilt FFmpeg.
- */
-function getFFmpegPackageName() {
-    return `@pproenca/ffmpeg-${runtimePlatformArch()}`;
-}

package/dist/resource-manager.d.ts

@@ -15,7 +15,6 @@ export declare class ResourceManager {
     private static instance;
     private codecs;
     private inactivityTimeout;
-    private checkInterval;
     private constructor();
     static getInstance(): ResourceManager;
     /**
@@ -51,9 +50,9 @@ export declare class ResourceManager {
      * Set inactivity timeout (for testing).
      */
     setInactivityTimeout(ms: number): void;
-    private startMonitoring;
     /**
      * Stop monitoring (for cleanup).
+     * @deprecated No longer needed - monitoring happens on-demand via getReclaimableCodecs()
      */
     stopMonitoring(): void;
 }

package/dist/resource-manager.js

@@ -11,8 +11,7 @@ class ResourceManager {
     constructor() {
         this.codecs = new Map();
         this.inactivityTimeout = 10000; // 10 seconds per spec
-        this.checkInterval = null;
-        this.startMonitoring();
+        // Monitoring happens on-demand via getReclaimableCodecs()
     }
     static getInstance() {
         if (!ResourceManager.instance) {
@@ -104,25 +103,12 @@ class ResourceManager {
     setInactivityTimeout(ms) {
         this.inactivityTimeout = ms;
     }
-    startMonitoring() {
-        // Check every 5 seconds
-        this.checkInterval = setInterval(() => {
-            // Just track, don't auto-reclaim
-            // Actual reclamation would be triggered by memory pressure
-        }, 5000);
-        // Don't keep process alive
-        if (this.checkInterval.unref) {
-            this.checkInterval.unref();
-        }
-    }
     /**
      * Stop monitoring (for cleanup).
+     * @deprecated No longer needed - monitoring happens on-demand via getReclaimableCodecs()
      */
     stopMonitoring() {
-        if (this.checkInterval) {
-            clearInterval(this.checkInterval);
-            this.checkInterval = null;
-        }
+        // No-op: monitoring now happens on-demand
     }
 }
 exports.ResourceManager = ResourceManager;