node-av 0.0.1 → 1.0.1

package/install/check.js

@@ -1,113 +1,123 @@
 #!/usr/bin/env node
 
-import { getFFmpegLibraryVersions, globalFFmpegVersion, log, spawnRebuild, useGlobalFFmpeg } from './ffmpeg.js';
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
 
-const buildFromSource = async (msg) => {
-  log(msg);
-  log('Building from source requires:');
-  log('  - FFmpeg 7.1+ with development headers');
-  log('  - Python 3.12+');
-  log('  - node-gyp and node-addon-api');
+import { log, spawnRebuild, useGlobalFFmpeg } from './ffmpeg.js';
 
-  // Check for node-addon-api and node-gyp
-  let hasNodeAddonApi = false;
-  let hasNodeGyp = false;
+const require = createRequire(import.meta.url);
+
+const tryLoadPrebuilt = () => {
+  // Try to load from platform-specific package (optionalDependencies)
+  const platform = process.platform;
+  const arch = process.arch;
+  const packageName = `@seydx/node-av-${platform}-${arch}`;
 
   try {
-    // @ts-expect-error
-    await import('node-addon-api');
-    hasNodeAddonApi = true;
+    const packagePath = require.resolve(`${packageName}/node-av.node`);
+    if (existsSync(packagePath)) {
+      log(`Using prebuilt binary from ${packageName}`);
+      return true;
+    }
   } catch {
-    // Not installed
+    // Package not installed or file not found
+  }
+
+  // Try local binary folder (for development)
+  const localBinary = join(process.cwd(), 'binary', 'node-av.node');
+  if (existsSync(localBinary)) {
+    log('Using local binary from binary/node-av.node');
+    return true;
   }
 
+  return false;
+};
+
+const buildFromSource = () => {
+  log('Building from source...');
+
+  // Check for required build dependencies
+  const missingDeps = [];
+
   try {
-    // @ts-expect-error
-    await import('node-gyp');
-    hasNodeGyp = true;
+    require('node-addon-api');
   } catch {
-    // Not installed
+    missingDeps.push('node-addon-api');
   }
 
-  if (!hasNodeAddonApi || !hasNodeGyp) {
+  try {
+    require('node-gyp');
+  } catch {
+    missingDeps.push('node-gyp');
+  }
+
+  if (missingDeps.length > 0) {
     log('');
-    log('Missing build dependencies. Please install:');
-    log('  npm install --save-dev node-addon-api node-gyp');
+    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);
   }
 
-  log('Found required build dependencies');
   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/av for detailed requirements');
     process.exit(status);
   }
+
+  log('Build completed successfully!');
 };
 
 (async () => {
   try {
-    // Check if we should build from source
-    const shouldBuildFromSource = process.env.npm_config_build_from_source;
-
-    // Try to load the prebuilt binary first (unless explicitly building from source)
-    if (!shouldBuildFromSource) {
-      try {
-        // Check if platform-specific package exists (optionalDependencies)
-        const platform = process.platform;
-        const arch = process.arch;
-        const packageName = `@seydx/node-av-${platform}-${arch}`;
-
-        // Try to resolve the package
-        await import(`${packageName}/package.json`);
-        log(`Using prebuilt binary from ${packageName}`);
+    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;
-      } catch {
-        // No prebuilt binary available, will build from source
       }
     }
 
-    // No prebuilt binary or --build-from-source flag, check for system FFmpeg
-    if (useGlobalFFmpeg(log)) {
-      const versions = getFFmpegLibraryVersions();
-      if (versions && versions.length > 0) {
-        log('Detected globally-installed FFmpeg libraries:');
-        for (const lib of versions) {
-          log(`  ✓ ${lib.name.padEnd(20)} v${lib.version} (${lib.description})`);
-        }
-        await buildFromSource('Building with system FFmpeg');
-      } else {
-        await buildFromSource(`Detected globally-installed FFmpeg v${globalFFmpegVersion()}`);
-      }
-    } else {
-      // No system FFmpeg found
+    // Build from source (either requested or as fallback)
+    if (useGlobalFFmpeg()) {
+      // Determine why we're building
       if (shouldBuildFromSource) {
-        log('--build-from-source specified but no FFmpeg libraries found');
-        log('Please install FFmpeg 7.1+ with development headers');
-        process.exit(1);
+        log('Building from source as requested');
       } else {
         log('No prebuilt binary available for your platform');
-        log('No system FFmpeg libraries found (requires v7.1+)');
-        log('');
-        log('Please install FFmpeg 7.1+ and build dependencies:');
-        log('  - FFmpeg development libraries');
-        log('  - Python 3.12+');
-        log('  - npm install --save-dev node-addon-api node-gyp');
-        log('');
-        log('Then run npm install again.');
-        process.exit(1);
+        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('Please install FFmpeg 7.1+ with development headers');
+      log('See https://github.com/seydx/av for installation instructions');
+      process.exit(1);
     }
   } catch (err) {
-    const summary = err.message.split(/\n/).slice(0, 1);
-    console.log(`node-av: installation error: ${summary}`);
+    console.error(`node-av: Installation error: ${err.message}`);
     process.exit(1);
   }
 })();

package/install/ffmpeg.js

@@ -1,29 +1,13 @@
-// https://github.com/lovell/sharp/blob/main/lib/libvips.js
+// Adapted from https://github.com/lovell/sharp/blob/main/lib/libvips.js
 
 import detectLibc from 'detect-libc';
 import { spawnSync } from 'node:child_process';
-import { readFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import semverCoerce from 'semver/functions/coerce.js';
-import semverGreaterThanOrEqualTo from 'semver/functions/gte.js';
-import semverSatisfies from 'semver/functions/satisfies.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf8'));
-const { engines } = packageJson;
 
 const spawnSyncOptions = {
   encoding: 'utf8',
   shell: true,
 };
 
-// Minimum FFmpeg version required
-export const minimumFFmpegVersion = '7.1.0';
-
-// Minimum Python version required for node-gyp
-export const minimumPythonVersion = '3.12.0';
-
 export const log = (item) => {
   if (item instanceof Error) {
     console.error(`node-av: Installation error: ${item.message}`);
@@ -42,122 +26,52 @@ export const buildPlatformArch = () => {
   return `${npm_config_platform ?? process.platform}${libc}-${npm_config_arch ?? process.arch}`;
 };
 
-export const isUnsupportedNodeRuntime = () => {
-  if (process.release?.name === 'node' && process.versions) {
-    if (!semverSatisfies(process.versions.node, engines.node)) {
-      return { found: process.versions.node, expected: engines.node };
-    }
-  }
-};
-
 export const spawnRebuild = () =>
   spawnSync('node-gyp rebuild', {
     ...spawnSyncOptions,
     stdio: 'inherit',
   }).status;
 
-export const globalFFmpegVersion = () => {
-  if (process.platform !== 'win32') {
-    const ffmpegVersion =
-      spawnSync('pkg-config --modversion libavcodec', {
-        ...spawnSyncOptions,
-        env: {
-          ...process.env,
-          PKG_CONFIG_PATH: pkgConfigPath(),
-        },
-      }).stdout || '';
-    return ffmpegVersion.trim();
-  } else {
+export const pkgConfigPath = () => {
+  if (process.platform === 'win32') {
     return '';
   }
-};
 
-export const getFFmpegLibraryVersions = () => {
-  if (process.platform === 'win32') {
-    return null;
-  }
+  const paths = [];
 
-  const libraries = [
-    { name: 'libavcodec', description: 'codec library' },
-    { name: 'libavformat', description: 'format library' },
-    { name: 'libavutil', description: 'utility library' },
-    { name: 'libswscale', description: 'video scaling library' },
-    { name: 'libswresample', description: 'audio resampling library' },
-    { name: 'libavfilter', description: 'filter library' },
-    { name: 'libavdevice', description: 'device library' },
-    { name: 'libpostproc', description: 'post-processing library' },
-  ];
-
-  const versions = [];
-
-  for (const lib of libraries) {
-    const version = spawnSync(`pkg-config --modversion ${lib.name}`, {
-      ...spawnSyncOptions,
-      env: {
-        ...process.env,
-        PKG_CONFIG_PATH: pkgConfigPath(),
-      },
-    }).stdout;
-
-    if (version && version.trim()) {
-      versions.push({
-        name: lib.name,
-        description: lib.description,
-        version: version.trim(),
-      });
+  // Try homebrew path on macOS
+  if (process.platform === 'darwin') {
+    const brewPath = spawnSync('brew --prefix 2>/dev/null', spawnSyncOptions).stdout;
+    if (brewPath) {
+      paths.push(`${brewPath.trim()}/lib/pkgconfig`);
     }
   }
 
-  return versions.length > 0 ? versions : null;
-};
+  // Add standard paths
+  paths.push(process.env.PKG_CONFIG_PATH, '/usr/local/lib/pkgconfig', '/usr/lib/pkgconfig', '/usr/local/libdata/pkgconfig', '/usr/libdata/pkgconfig');
 
-export const pkgConfigPath = () => {
-  if (process.platform !== 'win32') {
-    const brewPkgConfigPath = spawnSync('which brew >/dev/null 2>&1 && brew environment --plain | grep PKG_CONFIG_LIBDIR | cut -d" " -f2', spawnSyncOptions).stdout || '';
-    return [
-      brewPkgConfigPath.trim(),
-      process.env.PKG_CONFIG_PATH,
-      '/usr/local/lib/pkgconfig',
-      '/usr/lib/pkgconfig',
-      '/usr/local/libdata/pkgconfig',
-      '/usr/libdata/pkgconfig',
-    ]
-      .filter(Boolean)
-      .join(':');
-  } else {
-    return '';
-  }
+  return paths.filter(Boolean).join(':');
 };
 
-export const useGlobalFFmpeg = (logger) => {
-  const globalVersion = globalFFmpegVersion();
-  if (!globalVersion) {
+export const useGlobalFFmpeg = () => {
+  if (process.platform === 'win32') {
     return false;
   }
 
-  // Check if all required libraries are present
-  const requiredLibs = ['libavcodec', 'libavformat', 'libavutil', 'libswscale', 'libswresample'];
-  for (const lib of requiredLibs) {
-    const version =
-      spawnSync(`pkg-config --modversion ${lib}`, {
-        ...spawnSyncOptions,
-        env: {
-          ...process.env,
-          PKG_CONFIG_PATH: pkgConfigPath(),
-        },
-      }).stdout || '';
-    if (!version?.trim()) {
-      if (logger) {
-        logger(`Missing required FFmpeg library: ${lib}`);
-      }
-      return false;
-    }
-  }
+  let ffmpegVersion =
+    spawnSync('pkg-config --modversion libavcodec', {
+      ...spawnSyncOptions,
+      env: {
+        ...process.env,
+        PKG_CONFIG_PATH: pkgConfigPath(),
+      },
+    }).stdout || '';
+
+  ffmpegVersion = ffmpegVersion.trim();
 
-  const coercedVersion = semverCoerce(globalVersion);
-  if (!coercedVersion) {
+  if (!ffmpegVersion) {
     return false;
   }
 
-  return semverGreaterThanOrEqualTo(coercedVersion.version, minimumFFmpegVersion);
+  return true;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-av",
-  "version": "0.0.1",
+  "version": "1.0.1",
   "description": "FFmpeg bindings for Node.js",
   "author": "seydx (https://github.com/seydx/av)",
   "type": "module",
@@ -32,17 +32,16 @@
     }
   },
   "scripts": {
-    "build": "npm run build:native && npm run build:tsc",
-    "build:all": "npm run build:native && npm run build:tests && npm run build:examples && npm run build:tsc",
+    "build": "npm run generate && npm run build:tests && npm run build:examples && npm run build:tsc && npm run build:native",
     "build:examples": "tsc -p tsconfig.examples.json",
     "build:native": "node-gyp rebuild && cpy --flat build/Release/node-av.node binary/",
     "build:tests": "tsc -p tsconfig.tests.json",
-    "build:tsc": "rimraf dist && npm run generate:constants && npm run generate:layouts && tsc -p tsconfig.build.json",
-    "clean": "node-gyp clean && rimraf dist",
-    "clean:tsc": "npm run format && npm run lint:fix && npm run generate:constants && npm run build:tests && npm run build:examples && npm run build:tsc",
-    "format": "prettier --write 'src/' --write 'test/' --write 'scripts/' --write 'examples/' --ignore-unknown --no-error-on-unmatched-pattern",
-    "generate:constants": "node scripts/generate-constants.js && prettier --write 'src/lib/constants.ts'",
-    "generate:layouts": "node scripts/generate-channel-layouts.js && prettier --write 'src/lib/channel-layouts.ts'",
+    "build:tsc": "rimraf dist && tsc -p tsconfig.build.json",
+    "clean": "rimraf dist && node-gyp clean && npm run generate && npm run format && npm run lint:fix && npm run build:tests && npm run build:examples && npm run build:tsc",
+    "format": "prettier --write src/ --write test/ --write scripts/ --write examples/ --ignore-unknown --no-error-on-unmatched-pattern",
+    "generate": "npm run generate:constants && npm run generate:layouts",
+    "generate:constants": "node scripts/generate-constants.js && prettier --write src/lib/constants.ts",
+    "generate:layouts": "node scripts/generate-channel-layouts.js && prettier --write src/lib/channel-layouts.ts",
     "install": "node install/check.js",
     "install-updates": "npm i --save",
     "lint": "eslint .",
@@ -50,20 +49,19 @@
     "release:patch": "node scripts/prepare-release.js patch",
     "release:minor": "node scripts/prepare-release.js minor",
     "release:major": "node scripts/prepare-release.js major",
-    "test:all": "npm run build:tests && npm run build:tsc && tsx --test test/**/*.test.ts",
+    "test:all": "npm run generate && npm run build:tests && npm run build:tsc && tsx --test test/*.test.ts",
     "update": "updates --update ./"
   },
   "dependencies": {
-    "detect-libc": "^2.0.4",
-    "semver": "^7.7.2"
+    "detect-libc": "^2.0.4"
   },
   "optionalDependencies": {
-    "@seydx/node-av-darwin-arm64": "^0.0.1",
-    "@seydx/node-av-darwin-x64": "^0.0.1",
-    "@seydx/node-av-linux-arm64": "^0.0.1",
-    "@seydx/node-av-linux-x64": "^0.0.1",
-    "@seydx/node-av-win32-arm64": "^0.0.1",
-    "@seydx/node-av-win32-x64": "^0.0.1"
+    "@seydx/node-av-darwin-arm64": "^1.0.1",
+    "@seydx/node-av-darwin-x64": "^1.0.1",
+    "@seydx/node-av-linux-arm64": "^1.0.1",
+    "@seydx/node-av-linux-x64": "^1.0.1",
+    "@seydx/node-av-win32-arm64": "^1.0.1",
+    "@seydx/node-av-win32-x64": "^1.0.1"
   },
   "devDependencies": {
     "@stylistic/eslint-plugin": "^5.2.3",

package/release_notes.md

@@ -0,0 +1,11 @@
+## node-av Release v1.0.1
+
+### 📦 Updated Packages
+
+The following platform packages have been updated to v1.0.1:
+- `@seydx/node-av-darwin-arm64@v1.0.1`
+- `@seydx/node-av-darwin-x64@v1.0.1`
+- `@seydx/node-av-linux-arm64@v1.0.1`
+- `@seydx/node-av-linux-x64@v1.0.1`
+- `@seydx/node-av-win32-arm64@v1.0.1`
+- `@seydx/node-av-win32-x64@v1.0.1`