node-av-lgpl 0.0.0 → 7.1.0-beta.2

package/dist/constants/options.js

@@ -0,0 +1,7 @@
+/**
+ * Auto-generated codec private-option types.
+ * Generated from FFmpeg codec AVOption sources (see scripts/generate-options-source.js).
+ * DO NOT EDIT MANUALLY.
+ */
+export {};
+//# sourceMappingURL=options.js.map

package/dist/constants/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/constants/options.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/ffmpeg/index.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Get the absolute path to the FFmpeg binary.
+ *
+ * The binary ships in the optional `@seydx/node-av-ffmpeg` package
+ * (`npm install @seydx/node-av-ffmpeg`), which installs the build for the
+ * current platform. It is built from the same FFmpeg as the native bindings,
+ * so node-av-lgpl and node-av-light use `@seydx/node-av-ffmpeg-lgpl` and
+ * `@seydx/node-av-ffmpeg-light` instead.
+ * In Electron apps the path points into `app.asar.unpacked`.
+ *
+ * @returns Absolute path to the FFmpeg binary
+ *
+ * @throws {Error} If the FFmpeg CLI package is not installed or has no build for this platform
+ *
+ * @example
+ * ```typescript
+ * import { ffmpegPath } from 'node-av/ffmpeg';
+ *
+ * const path = ffmpegPath();
+ * console.log('FFmpeg binary at:', path);
+ * // e.g. /path/to/node_modules/@seydx/node-av-ffmpeg-linux-x64/ffmpeg
+ * ```
+ *
+ * @example Convert video using FFmpeg binary
+ * ```typescript
+ * import { ffmpegPath } from 'node-av/ffmpeg';
+ * import { execFile } from 'node:child_process';
+ * import { promisify } from 'node:util';
+ *
+ * const execFileAsync = promisify(execFile);
+ *
+ * async function convertVideo(input: string, output: string) {
+ *   const args = [
+ *     '-i', input,
+ *     '-c:v', 'libx264',
+ *     '-crf', '23',
+ *     '-c:a', 'aac',
+ *     output
+ *   ];
+ *
+ *   await execFileAsync(ffmpegPath(), args);
+ * }
+ * ```
+ */
+export declare function ffmpegPath(): string;
+/**
+ * Check if the FFmpeg binary is available.
+ *
+ * Returns whether the FFmpeg CLI package (`@seydx/node-av-ffmpeg`, or the
+ * one of the node-av-lgpl and node-av-light variants) is installed with a
+ * build for this platform, i.e. whether {@link ffmpegPath} will succeed.
+ *
+ * @returns `true` if the FFmpeg binary exists, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * import { isFfmpegAvailable, ffmpegPath } from 'node-av/ffmpeg';
+ *
+ * if (isFfmpegAvailable()) {
+ *   console.log('FFmpeg is ready to use');
+ *   // Safe to use ffmpegPath() and execute FFmpeg commands
+ * } else {
+ *   console.log('FFmpeg binary not found, run: npm install @seydx/node-av-ffmpeg');
+ * }
+ * ```
+ *
+ * @example Conditional FFmpeg usage
+ * ```typescript
+ * import { isFfmpegAvailable, ffmpegPath } from 'node-av/ffmpeg';
+ * import { execFile } from 'node:child_process';
+ *
+ * async function getFFmpegVersion(): Promise<string | null> {
+ *   if (!isFfmpegAvailable()) {
+ *     return null;
+ *   }
+ *
+ *   try {
+ *     const { stdout } = await execFile(ffmpegPath(), ['-version']);
+ *     return stdout;
+ *   } catch (error) {
+ *     console.error('Failed to execute FFmpeg:', error);
+ *     return null;
+ *   }
+ * }
+ * ```
+ */
+export declare function isFfmpegAvailable(): boolean;
+/**
+ * Get the FFmpeg version used by the binary.
+ *
+ * @returns FFmpeg version string (e.g. "8.0")
+ *
+ * @example
+ * ```typescript
+ * import { ffmpegVersion } from 'node-av/ffmpeg';
+ *
+ * console.log('FFmpeg version:', ffmpegVersion());
+ * // Output: FFmpeg version: 8.0
+ * ```
+ */
+export declare function ffmpegVersion(): string;

package/dist/ffmpeg/index.js

@@ -0,0 +1,161 @@
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join, resolve } from 'node:path';
+import { getDirname, getUnpackedPath } from '../utils/electron.js';
+import { isMusl } from '../utils/libc.js';
+import { ffmpegPackageName } from '../utils/variant.js';
+import { FFMPEG_VERSION } from './version.js';
+const __dirname = getDirname(import.meta.url);
+const require = createRequire(import.meta.url);
+// @seydx/node-av-ffmpeg, or the -lgpl / -light package of the other variants
+const FFMPEG_PACKAGE = ffmpegPackageName();
+const ffmpegFile = 'ffmpeg' + (process.platform === 'win32' ? '.exe' : '');
+// Local build (development, CI tests): binary/ next to dist/
+const localFfmpegPath = resolve(__dirname, '../../binary', ffmpegFile);
+let resolvedFfmpegPath = null;
+/**
+ * Find the FFmpeg binary.
+ *
+ * Checks the local `binary/` folder first, then the platform package installed by the variant's FFmpeg CLI package.
+ *
+ * @returns Absolute path to the binary, or `null` if neither is installed
+ *
+ * @internal
+ */
+function findFfmpeg() {
+    if (resolvedFfmpegPath) {
+        return resolvedFfmpegPath;
+    }
+    if (existsSync(localFfmpegPath)) {
+        resolvedFfmpegPath = localFfmpegPath;
+        return resolvedFfmpegPath;
+    }
+    try {
+        // The platform package is a dependency of the meta package, not of node-av, so it is
+        // resolved from there (strict layouts like pnpm don't expose it to node-av directly).
+        const metaPackageJson = require.resolve(`${FFMPEG_PACKAGE}/package.json`);
+        const platformPackage = `${FFMPEG_PACKAGE}-${process.platform}-${process.arch}${isMusl() ? '-musl' : ''}`;
+        const platformPackageJson = createRequire(metaPackageJson).resolve(`${platformPackage}/package.json`);
+        const path = getUnpackedPath(join(dirname(platformPackageJson), ffmpegFile));
+        if (existsSync(path)) {
+            resolvedFfmpegPath = path;
+            return resolvedFfmpegPath;
+        }
+    }
+    catch {
+        // Not installed, or no build for this platform
+    }
+    return null;
+}
+/**
+ * Get the absolute path to the FFmpeg binary.
+ *
+ * The binary ships in the optional `@seydx/node-av-ffmpeg` package
+ * (`npm install @seydx/node-av-ffmpeg`), which installs the build for the
+ * current platform. It is built from the same FFmpeg as the native bindings,
+ * so node-av-lgpl and node-av-light use `@seydx/node-av-ffmpeg-lgpl` and
+ * `@seydx/node-av-ffmpeg-light` instead.
+ * In Electron apps the path points into `app.asar.unpacked`.
+ *
+ * @returns Absolute path to the FFmpeg binary
+ *
+ * @throws {Error} If the FFmpeg CLI package is not installed or has no build for this platform
+ *
+ * @example
+ * ```typescript
+ * import { ffmpegPath } from 'node-av/ffmpeg';
+ *
+ * const path = ffmpegPath();
+ * console.log('FFmpeg binary at:', path);
+ * // e.g. /path/to/node_modules/@seydx/node-av-ffmpeg-linux-x64/ffmpeg
+ * ```
+ *
+ * @example Convert video using FFmpeg binary
+ * ```typescript
+ * import { ffmpegPath } from 'node-av/ffmpeg';
+ * import { execFile } from 'node:child_process';
+ * import { promisify } from 'node:util';
+ *
+ * const execFileAsync = promisify(execFile);
+ *
+ * async function convertVideo(input: string, output: string) {
+ *   const args = [
+ *     '-i', input,
+ *     '-c:v', 'libx264',
+ *     '-crf', '23',
+ *     '-c:a', 'aac',
+ *     output
+ *   ];
+ *
+ *   await execFileAsync(ffmpegPath(), args);
+ * }
+ * ```
+ */
+export function ffmpegPath() {
+    const path = findFfmpeg();
+    if (!path) {
+        throw new Error(`FFmpeg binary not found for ${process.platform}-${process.arch}. Install it with: npm install ${FFMPEG_PACKAGE}`);
+    }
+    return path;
+}
+/**
+ * Check if the FFmpeg binary is available.
+ *
+ * Returns whether the FFmpeg CLI package (`@seydx/node-av-ffmpeg`, or the
+ * one of the node-av-lgpl and node-av-light variants) is installed with a
+ * build for this platform, i.e. whether {@link ffmpegPath} will succeed.
+ *
+ * @returns `true` if the FFmpeg binary exists, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * import { isFfmpegAvailable, ffmpegPath } from 'node-av/ffmpeg';
+ *
+ * if (isFfmpegAvailable()) {
+ *   console.log('FFmpeg is ready to use');
+ *   // Safe to use ffmpegPath() and execute FFmpeg commands
+ * } else {
+ *   console.log('FFmpeg binary not found, run: npm install @seydx/node-av-ffmpeg');
+ * }
+ * ```
+ *
+ * @example Conditional FFmpeg usage
+ * ```typescript
+ * import { isFfmpegAvailable, ffmpegPath } from 'node-av/ffmpeg';
+ * import { execFile } from 'node:child_process';
+ *
+ * async function getFFmpegVersion(): Promise<string | null> {
+ *   if (!isFfmpegAvailable()) {
+ *     return null;
+ *   }
+ *
+ *   try {
+ *     const { stdout } = await execFile(ffmpegPath(), ['-version']);
+ *     return stdout;
+ *   } catch (error) {
+ *     console.error('Failed to execute FFmpeg:', error);
+ *     return null;
+ *   }
+ * }
+ * ```
+ */
+export function isFfmpegAvailable() {
+    return findFfmpeg() !== null;
+}
+/**
+ * Get the FFmpeg version used by the binary.
+ *
+ * @returns FFmpeg version string (e.g. "8.0")
+ *
+ * @example
+ * ```typescript
+ * import { ffmpegVersion } from 'node-av/ffmpeg';
+ *
+ * console.log('FFmpeg version:', ffmpegVersion());
+ * // Output: FFmpeg version: 8.0
+ * ```
+ */
+export function ffmpegVersion() {
+    return FFMPEG_VERSION;
+}
+//# sourceMappingURL=index.js.map

package/dist/ffmpeg/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ffmpeg/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,6EAA6E;AAC7E,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;AAC3C,MAAM,UAAU,GAAG,QAAQ,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAE3E,6DAA6D;AAC7D,MAAM,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC;AAEvE,IAAI,kBAAkB,GAAkB,IAAI,CAAC;AAE7C;;;;;;;;GAQG;AACH,SAAS,UAAU;IACjB,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAChC,kBAAkB,GAAG,eAAe,CAAC;QACrC,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC;QACH,qFAAqF;QACrF,sFAAsF;QACtF,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,cAAc,eAAe,CAAC,CAAC;QAC1E,MAAM,eAAe,GAAG,GAAG,cAAc,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1G,MAAM,mBAAmB,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,GAAG,eAAe,eAAe,CAAC,CAAC;QACtG,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;QAC7E,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,kBAAkB,GAAG,IAAI,CAAC;YAC1B,OAAO,kBAAkB,CAAC;QAC5B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;IACjD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,kCAAkC,cAAc,EAAE,CAAC,CAAC;IACrI,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,EAAE,KAAK,IAAI,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/ffmpeg/version.d.ts

@@ -0,0 +1,6 @@
+/**
+ * FFmpeg Version
+ * Auto-generated from externals/jellyfin-ffmpeg/FFMPEG_VERSION
+ * DO NOT EDIT MANUALLY
+ */
+export declare const FFMPEG_VERSION = "8.1.3";

package/dist/ffmpeg/version.js

@@ -0,0 +1,7 @@
+/**
+ * FFmpeg Version
+ * Auto-generated from externals/jellyfin-ffmpeg/FFMPEG_VERSION
+ * DO NOT EDIT MANUALLY
+ */
+export const FFMPEG_VERSION = '8.1.3';
+//# sourceMappingURL=version.js.map

package/dist/ffmpeg/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/ffmpeg/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './lib/index.js';
+export * from './api/index.js';
+export * from './constants/index.js';
+export * from './ffmpeg/index.js';

package/dist/index.js

@@ -0,0 +1,9 @@
+// Export low-level API
+export * from './lib/index.js';
+// Export high-level API
+export * from './api/index.js';
+// Export all generated constants
+export * from './constants/index.js';
+// Export ffmpeg utilities
+export * from './ffmpeg/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,cAAc,gBAAgB,CAAC;AAE/B,wBAAwB;AACxB,cAAc,gBAAgB,CAAC;AAE/B,iCAAiC;AACjC,cAAc,sBAAsB,CAAC;AAErC,0BAA0B;AAC1B,cAAc,mBAAmB,CAAC"}