node-av 6.2.0-beta.3 → 6.2.0-beta.31

package/dist/lib/stream.d.ts

@@ -1,10 +1,10 @@
 import { CodecParameters } from './codec-parameters.js';
 import { CodecParser } from './codec-parser.js';
 import { Dictionary } from './dictionary.js';
+import { Packet } from './packet.js';
 import { Rational } from './rational.js';
 import type { AVDiscard, AVDisposition, AVStreamEventFlag } from '../constants/constants.js';
 import type { NativeStream, NativeWrapper } from './native-types.js';
-import type { Packet } from './packet.js';
 /**
  * Media stream within a format context.
  *
@@ -13,6 +13,10 @@ import type { Packet } from './packet.js';
  * metadata, and disposition flags. Each stream in a file has a unique index and may
  * contain packets of compressed data.
  *
+ * A stream belongs to its format context. Once that context is closed or freed, the
+ * stream and its codecpar read their defaults (e.g. index -1) and ignore writes;
+ * copy what must outlive the context first.
+ *
  * Direct mapping to FFmpeg's AVStream.
  *
  * @example
@@ -48,9 +52,7 @@ import type { Packet } from './packet.js';
  */
 export declare class Stream implements NativeWrapper<NativeStream> {
     private native;
-    private _metadata?;
     private _codecpar?;
-    private _parser?;
     /**
      * @param native - The native stream instance
      *
@@ -81,6 +83,7 @@ export declare class Stream implements NativeWrapper<NativeStream> {
      *
      * Contains essential codec configuration for this stream.
      * Used to initialize decoders and describe stream properties.
+     * Reads defaults once the format context is closed or freed.
      *
      * Direct mapping to AVStream->codecpar.
      */
@@ -192,7 +195,8 @@ export declare class Stream implements NativeWrapper<NativeStream> {
      * Dictionary containing stream-specific metadata
      * (e.g., language, title, encoder settings).
      *
-     * Direct mapping to AVStream->metadata.
+     * Returns a copy of AVStream->metadata - mutating the returned Dictionary
+     * does not affect the stream. Assign it back to apply changes.
      */
     get metadata(): Dictionary | null;
     set metadata(value: Dictionary | null);

package/dist/lib/stream.js

@@ -1,6 +1,7 @@
 import { CodecParameters } from './codec-parameters.js';
 import { CodecParser } from './codec-parser.js';
 import { Dictionary } from './dictionary.js';
+import { Packet } from './packet.js';
 import { Rational } from './rational.js';
 /**
  * Media stream within a format context.
@@ -10,6 +11,10 @@ import { Rational } from './rational.js';
  * metadata, and disposition flags. Each stream in a file has a unique index and may
  * contain packets of compressed data.
  *
+ * A stream belongs to its format context. Once that context is closed or freed, the
+ * stream and its codecpar read their defaults (e.g. index -1) and ignore writes;
+ * copy what must outlive the context first.
+ *
  * Direct mapping to FFmpeg's AVStream.
  *
  * @example
@@ -45,9 +50,7 @@ import { Rational } from './rational.js';
  */
 export class Stream {
     native;
-    _metadata; // Cache for metadata wrapper
     _codecpar; // Cache the wrapped codecpar
-    _parser; // Cache the wrapped parser
     /**
      * @param native - The native stream instance
      *
@@ -86,6 +89,7 @@ export class Stream {
      *
      * Contains essential codec configuration for this stream.
      * Used to initialize decoders and describe stream properties.
+     * Reads defaults once the format context is closed or freed.
      *
      * Direct mapping to AVStream->codecpar.
      */
@@ -265,28 +269,20 @@ export class Stream {
      * Dictionary containing stream-specific metadata
      * (e.g., language, title, encoder settings).
      *
-     * Direct mapping to AVStream->metadata.
+     * Returns a copy of AVStream->metadata - mutating the returned Dictionary
+     * does not affect the stream. Assign it back to apply changes.
      */
     get metadata() {
         const native = this.native.metadata;
         if (!native) {
-            // Clear cache if native is null
-            this._metadata = undefined;
             return null;
         }
-        // Return cached wrapper if available and still valid
-        if (this._metadata && this._metadata.native === native) {
-            return this._metadata;
-        }
-        // Create and cache new wrapper
-        const device = Object.create(Dictionary.prototype);
-        device.native = native;
-        this._metadata = device;
-        return device;
+        const dict = Object.create(Dictionary.prototype);
+        dict.native = native;
+        return dict;
     }
     set metadata(value) {
         this.native.metadata = value?.getNative() ?? null;
-        this._metadata = undefined;
     }
     /**
      * Attached picture.
@@ -297,7 +293,15 @@ export class Stream {
      * Direct mapping to AVStream->attached_pic.
      */
     get attachedPic() {
-        return this.native.attachedPic;
+        const native = this.native.attachedPic;
+        if (!native) {
+            return null;
+        }
+        // The native getter refs the picture data into a new packet - the returned
+        // wrapper owns that ref (freed on GC, or free() to release earlier)
+        const packet = Object.create(Packet.prototype);
+        packet.native = native;
+        return packet;
     }
     /**
      * Event flags.
@@ -336,20 +340,14 @@ export class Stream {
      * @see {@link CodecParser} For parser details
      */
     get parser() {
+        // Not cached: the native getter returns a fresh object per access, so an
+        // identity-based cache can never hit
         const native = this.native.parser;
         if (!native) {
-            // Clear cache if native is null
-            this._parser = undefined;
             return null;
         }
-        // Return cached wrapper if available and still valid
-        if (this._parser && this._parser.native === native) {
-            return this._parser;
-        }
-        // Create and cache new wrapper
         const parser = Object.create(CodecParser.prototype);
         parser.native = native;
-        this._parser = parser;
         return parser;
     }
     /**

package/dist/lib/stream.js.map

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

package/install/check.js

@@ -4,8 +4,7 @@ import { existsSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { join } from 'node:path';
 
-import { type } from 'node:os';
-import { log, spawnRebuild, useGlobalFFmpeg } from './ffmpeg.js';
+import { log } from './ffmpeg.js';
 
 const require = createRequire(import.meta.url);
 
@@ -15,22 +14,21 @@ const tryLoadPrebuilt = () => {
   const arch = process.arch;
 
   if (platform === 'win32') {
-    const useMingW = type() !== 'Windows_NT';
-    if (useMingW) {
-      try {
-        const packageName = `@seydx/node-av-${platform}-${arch}-mingw`;
-        // Check if the package is installed (don't check for .node file yet - it may be extracted by postinstall)
-        const packageJsonPath = require.resolve(`${packageName}/package.json`);
-        if (existsSync(packageJsonPath)) {
-          log(`Using prebuilt binary from ${packageName}`);
-          return true;
-        }
-      } catch {
-        // Package not installed
-      }
-    }
+    // MinGW builds are discontinued, Windows ships MSVC only
+    // const useMingW = type() !== 'Windows_NT';
+    // if (useMingW) {
+    //   try {
+    //     const packageName = `@seydx/node-av-${platform}-${arch}-mingw`;
+    //     const packageJsonPath = require.resolve(`${packageName}/package.json`);
+    //     if (existsSync(packageJsonPath)) {
+    //       log(`Using prebuilt binary from ${packageName}`);
+    //       return true;
+    //     }
+    //   } catch {
+    //     // Package not installed
+    //   }
+    // }
 
-    // Fallback to MSVC
     try {
       const packageName = `@seydx/node-av-${platform}-${arch}-msvc`;
       // Check if the package is installed (don't check for .node file yet - it may be extracted by postinstall)
@@ -67,87 +65,50 @@ const tryLoadPrebuilt = () => {
   return false;
 };
 
-const buildFromSource = () => {
-  log('Building from source...');
-
-  // Check for required build dependencies
-  const missingDeps = [];
-
-  try {
-    require('node-addon-api');
-  } catch {
-    missingDeps.push('node-addon-api');
+const isMuslLibc = () => {
+  if (process.platform !== 'linux') {
+    return false;
   }
 
   try {
-    require('node-gyp');
+    const report = process.report?.getReport?.();
+    return !report?.header?.glibcVersionRuntime;
   } catch {
-    missingDeps.push('node-gyp');
+    return false;
   }
+};
 
-  if (missingDeps.length > 0) {
-    log('');
-    log(`Missing build dependencies: ${missingDeps.join(', ')}`);
-    log('Please install:');
-    log(`  npm install --save-dev ${missingDeps.join(' ')}`);
-    log('');
-    log('Then run npm install again.');
-    process.exit(1);
-  }
+const noPrebuiltError = () => {
+  log('');
+  log(`No prebuilt binary available for ${process.platform}-${process.arch}.`);
 
-  log('Building native bindings...');
-
-  const status = spawnRebuild();
-  if (status !== 0) {
-    log('');
-    log('Build failed. Please ensure you have:');
-    log('  - FFmpeg 7.1+ libraries and headers installed');
-    log('  - Python 3.12+ installed');
-    log('  - A C++ compiler with C++17 support');
-    log('');
-    log('See https://github.com/seydx/node-av for detailed requirements');
-    process.exit(status);
+  if (isMuslLibc()) {
+    log('Note: You appear to be on a musl-based system (e.g. Alpine Linux).');
+    log('Prebuilt binaries are only provided for glibc-based Linux distributions.');
   }
 
-  log('Build completed successfully!');
+  log('The published npm package does not contain the native sources,');
+  log('so it cannot be built from source inside node_modules.');
+  log('To build from source, clone the repository and follow the build instructions:');
+  log('  https://github.com/seydx/node-av');
+  process.exit(1);
 };
 
 (async () => {
   try {
     const shouldBuildFromSource = process.env.npm_config_build_from_source === 'true';
 
-    // Priority 1: User explicitly wants to build from source
     if (shouldBuildFromSource) {
-      if (!useGlobalFFmpeg()) {
-        log('--build-from-source specified but no FFmpeg libraries found');
-        log('Please install FFmpeg 7.1+ with development headers');
-        process.exit(1);
-      }
-      // Fall through to build logic below
-    } else {
-      // Priority 2: Try to use prebuilt binary if not forcing source build
-      if (tryLoadPrebuilt()) {
-        return;
-      }
+      log('--build-from-source was specified, but the published npm package cannot be built from source.');
+      noPrebuiltError();
     }
 
-    // Build from source (either requested or as fallback)
-    if (useGlobalFFmpeg()) {
-      // Determine why we're building
-      if (shouldBuildFromSource) {
-        log('Building from source as requested');
-      } else {
-        log('No prebuilt binary available for your platform');
-        log('System FFmpeg detected, building from source automatically');
-      }
-
-      buildFromSource();
-    } else {
-      // No FFmpeg found and no prebuilt available
-      log('⚠️  No prebuilt binary and no system FFmpeg found');
-      log('See https://github.com/seydx/node-av for installation instructions');
-      process.exit(1);
+    // Try to use prebuilt binary
+    if (tryLoadPrebuilt()) {
+      return;
     }
+
+    noPrebuiltError();
   } catch (err) {
     console.error(`node-av: Installation error: ${err.message}`);
     process.exit(1);

package/package.json

@@ -1,9 +1,18 @@
 {
   "name": "node-av",
-  "version": "6.2.0-beta.3",
+  "version": "6.2.0-beta.31",
   "description": "FFmpeg bindings for Node.js",
   "author": "seydx (https://github.com/seydx/node-av)",
   "type": "module",
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "files": [
+    "dist",
+    "install",
+    "README.md",
+    "LICENSE.md"
+  ],
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -67,6 +76,7 @@
     "install-updates": "npm i --save",
     "lint": "eslint .",
     "lint:fix": "eslint --fix .",
+    "lint:gyp": "node scripts/check-gyp-sync.js",
     "patch:ffmpeg": "node scripts/patch-ffmpeg.js",
     "postinstall": "node dist/ffmpeg/install.js",
     "predocs": "typedoc && cpy README.md docs/ --rename=index.md",
@@ -84,57 +94,58 @@
     "unzipper": "^0.12.5"
   },
   "optionalDependencies": {
-    "werift": "^0.23.0",
-    "@seydx/node-av-darwin-arm64": "^6.2.0-beta.3",
-    "@seydx/node-av-darwin-x64": "^6.2.0-beta.3",
-    "@seydx/node-av-linux-arm64": "^6.2.0-beta.3",
-    "@seydx/node-av-linux-x64": "^6.2.0-beta.3",
-    "@seydx/node-av-win32-arm64-mingw": "^6.2.0-beta.3",
-    "@seydx/node-av-win32-arm64-msvc": "^6.2.0-beta.3",
-    "@seydx/node-av-win32-x64-mingw": "^6.2.0-beta.3",
-    "@seydx/node-av-win32-x64-msvc": "^6.2.0-beta.3"
+    "@seydx/node-av-darwin-arm64": "6.2.0-beta.31",
+    "@seydx/node-av-darwin-x64": "6.2.0-beta.31",
+    "@seydx/node-av-linux-arm64": "6.2.0-beta.31",
+    "@seydx/node-av-linux-x64": "6.2.0-beta.31",
+    "@seydx/node-av-win32-arm64-msvc": "6.2.0-beta.31",
+    "@seydx/node-av-win32-x64-msvc": "6.2.0-beta.31"
+  },
+  "peerDependencies": {
+    "werift": "^0.24.3 || ^0.25.0"
+  },
+  "peerDependenciesMeta": {
+    "werift": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@stylistic/eslint-plugin": "^5.10.0",
-    "@types/node": "^26.1.0",
+    "@types/node": "^26.6.5",
     "@types/node-abi": "^3.0.3",
-    "@types/semver": "^7.7.1",
+    "@types/semver": "^7.8.0",
     "@types/unzipper": "^0.10.11",
-    "@types/ws": "^8.18.1",
-    "@typescript-eslint/parser": "^8.62.1",
-    "concurrently": "^10.0.3",
+    "@types/ws": "^8.18.2",
+    "@typescript-eslint/parser": "^8.71.2",
+    "concurrently": "^10.0.6",
     "cpy-cli": "^7.0.0",
     "cross-env": "^10.1.0",
     "eslint": "9.39.2",
-    "eslint-plugin-jsdoc": "^63.0.12",
-    "globals": "^17.7.0",
-    "node-addon-api": "^8.9.0",
-    "node-gyp": "^13.0.1",
-    "prettier": "^3.9.4",
+    "eslint-plugin-jsdoc": "^65.3.11",
+    "globals": "^17.13.0",
+    "node-addon-api": "^8.9.2",
+    "node-gyp": "^13.1.0",
+    "prettier": "^3.9.10",
     "rimraf": "^6.1.3",
-    "sharp": "^0.35.3",
-    "tsx": "^4.23.0",
+    "sharp": "^0.35.5",
+    "tsx": "^4.23.15",
     "typedoc": "^0.28.20",
-    "typedoc-plugin-markdown": "^4.12.0",
-    "typedoc-vitepress-theme": "^1.1.3",
+    "typedoc-plugin-markdown": "^4.14.0",
+    "typedoc-vitepress-theme": "^1.1.4",
     "typescript": "5.9.3",
-    "typescript-eslint": "^8.62.1",
-    "updates": "^17.18.2",
-    "vitepress": "^2.0.0-alpha.17",
-    "werift": "^0.23.0",
-    "ws": "^8.21.0"
+    "typescript-eslint": "^8.71.2",
+    "updates": "^19.2.1",
+    "vitepress": "^2.0.0-alpha.20",
+    "werift": "^0.25.1",
+    "ws": "^8.22.0"
   },
   "overrides": {
     "werift": {
-      "@shinyoshiaki/binary-data": "npm:@seydx/binary-data@0.6.2",
-      "ip": "npm:neoip@2.1.0"
+      "@shinyoshiaki/binary-data": "npm:@seydx/binary-data@0.6.2"
     },
     "werift-dtls": {
       "@shinyoshiaki/binary-data": "npm:@seydx/binary-data@0.6.2"
     },
-    "werift-ice": {
-      "ip": "npm:neoip@2.1.0"
-    },
     "werift-sctp": {
       "@shinyoshiaki/binary-data": "npm:@seydx/binary-data@0.6.2"
     }

package/build_mac_local.sh

@@ -1,69 +0,0 @@
-#!/bin/bash
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-BUILDER_DIR="$SCRIPT_DIR/externals/jellyfin-ffmpeg/builder"
-BUILD_DIR="$BUILDER_DIR/build"
-
-echo ""
-echo "=== FFmpeg Local Build ==="
-echo ""
-echo "  1) Full build (clean + dependencies + FFmpeg)"
-echo "  2) FFmpeg only (skip dependency builds)"
-echo ""
-read -rp "Choose [1/2]: " choice
-
-case "$choice" in
-    1)
-        echo ""
-        echo "=> Full build selected. Cleaning build + prefix directories..."
-        rm -rf "$BUILD_DIR"
-        sudo rm -rf /opt/ffbuild/prefix
-        SKIP_BUILD=""
-        ;;
-    2)
-        echo ""
-        echo "=> FFmpeg-only build selected. Skipping dependencies..."
-        SKIP_BUILD="--skip-build"
-        ;;
-    *)
-        echo "Invalid choice."
-        exit 1
-        ;;
-esac
-
-# Ensure submodules are initialized
-if [ ! -f "$SCRIPT_DIR/externals/jellyfin-ffmpeg/configure" ]; then
-    echo "=> Initializing git submodules..."
-    git -C "$SCRIPT_DIR" submodule update --init --recursive
-fi
-
-# Log everything to terminal and file
-LOG_FILE="$SCRIPT_DIR/ffmpeg_build.log"
-exec > >(tee "$LOG_FILE") 2>&1
-
-# Ensure /opt/ffbuild exists with correct permissions
-sudo mkdir -p /opt/ffbuild/prefix
-sudo chown -R "$(whoami):staff" /opt/ffbuild
-sudo chmod -R 755 /opt/ffbuild
-
-cd "$SCRIPT_DIR"
-
-# Apply FFmpeg patches (skips if already applied)
-node scripts/patch-ffmpeg.js
-
-cd "$BUILDER_DIR"
-
-# Run Jellyfin build script
-./buildmac.sh arm64 $SKIP_BUILD
-
-# The build script uses /ffbuild/prefix but we need /opt/ffbuild/prefix
-cd ..
-make install DESTDIR="" prefix="/opt/ffbuild/prefix"
-
-# Fix permissions after install
-sudo chown -R "$(whoami):staff" /opt/ffbuild
-
-cd "$SCRIPT_DIR"
-
-# npm run build:native