node-av 0.0.1

package/dist/lib/utilities.js

@@ -0,0 +1,424 @@
+/**
+ * FFmpeg utility functions collection.
+ *
+ * Provides direct mappings to various FFmpeg utility functions from libavutil.
+ * These functions handle common operations like timestamp conversion, image buffer
+ * allocation, sample format queries, and more.
+ *
+ * @example
+ * ```typescript
+ * import { avImageAlloc, avTs2TimeStr, avRescaleQ, FFmpegError } from 'node-av';
+ * import { AV_PIX_FMT_YUV420P, IRational } from 'node-av';
+ *
+ * // Allocate image buffer
+ * const image = avImageAlloc(1920, 1080, AV_PIX_FMT_YUV420P, 32);
+ * console.log(`Allocated ${image.size} bytes`);
+ *
+ * // Convert timestamp to readable time
+ * const timebase: IRational = { num: 1, den: 90000 };
+ * const pts = 450000n;
+ * console.log(avTs2TimeStr(pts, timebase)); // "5.000000"
+ * ```
+ */
+import { bindings } from './binding.js';
+import { FFmpegError } from './error.js';
+/**
+ * Get bytes per sample for a sample format.
+ *
+ * Returns the number of bytes required to store one sample in the given format.
+ *
+ * Direct mapping to av_get_bytes_per_sample()
+ *
+ * @param sampleFmt - Audio sample format
+ *
+ * @returns Number of bytes per sample, or 0 for invalid format
+ *
+ * @example
+ * ```typescript
+ * import { avGetBytesPerSample, AV_SAMPLE_FMT_S16, AV_SAMPLE_FMT_FLT } from 'node-av';
+ *
+ * console.log(avGetBytesPerSample(AV_SAMPLE_FMT_S16)); // 2
+ * console.log(avGetBytesPerSample(AV_SAMPLE_FMT_FLT)); // 4
+ * ```
+ */
+export function avGetBytesPerSample(sampleFmt) {
+    return bindings.avGetBytesPerSample(sampleFmt);
+}
+/**
+ * Get the name of a sample format.
+ *
+ * Returns a string describing the sample format.
+ *
+ * Direct mapping to av_get_sample_fmt_name()
+ *
+ * @param sampleFmt - Audio sample format
+ *
+ * @returns Format name string, or null for invalid format
+ *
+ * @example
+ * ```typescript
+ * import { avGetSampleFmtName, AV_SAMPLE_FMT_S16, AV_SAMPLE_FMT_FLTP } from 'node-av';
+ *
+ * console.log(avGetSampleFmtName(AV_SAMPLE_FMT_S16)); // "s16"
+ * console.log(avGetSampleFmtName(AV_SAMPLE_FMT_FLTP)); // "fltp"
+ * ```
+ */
+export function avGetSampleFmtName(sampleFmt) {
+    return bindings.avGetSampleFmtName(sampleFmt);
+}
+/**
+ * Get packed sample format
+ * Direct mapping to av_get_packed_sample_fmt()
+ */
+export function avGetPackedSampleFmt(sampleFmt) {
+    return bindings.avGetPackedSampleFmt(sampleFmt);
+}
+/**
+ * Get planar sample format
+ * Direct mapping to av_get_planar_sample_fmt()
+ */
+export function avGetPlanarSampleFmt(sampleFmt) {
+    return bindings.avGetPlanarSampleFmt(sampleFmt);
+}
+/**
+ * Check if sample format is planar
+ * Direct mapping to av_sample_fmt_is_planar()
+ */
+export function avSampleFmtIsPlanar(sampleFmt) {
+    return bindings.avSampleFmtIsPlanar(sampleFmt);
+}
+/**
+ * Get pixel format name
+ * Direct mapping to av_get_pix_fmt_name()
+ */
+export function avGetPixFmtName(pixFmt) {
+    return bindings.avGetPixFmtName(pixFmt);
+}
+/**
+ * Get pixel format from name
+ * Direct mapping to av_get_pix_fmt()
+ */
+export function avGetPixFmtFromName(name) {
+    return bindings.avGetPixFmtFromName(name);
+}
+/**
+ * Check if a pixel format is hardware-accelerated
+ * Direct mapping using av_pix_fmt_desc_get() and AV_PIX_FMT_FLAG_HWACCEL
+ */
+export function avIsHardwarePixelFormat(pixFmt) {
+    return bindings.avIsHardwarePixelFormat(pixFmt);
+}
+/**
+ * Get media type string
+ * Direct mapping to av_get_media_type_string()
+ */
+export function avGetMediaTypeString(mediaType) {
+    return bindings.avGetMediaTypeString(mediaType);
+}
+/**
+ * Allocate an image with size, pixel format and alignment.
+ *
+ * Allocates a buffer large enough to hold an image with the given parameters.
+ * The allocated buffer is properly aligned for optimal performance.
+ *
+ * Direct mapping to av_image_alloc()
+ *
+ * @param width - Image width in pixels
+ * @param height - Image height in pixels
+ * @param pixFmt - Pixel format
+ * @param align - Buffer alignment (1 for no alignment, 32 for SIMD)
+ *
+ * @returns Object containing:
+ *   - buffer: Allocated image buffer
+ *   - size: Total size in bytes
+ *   - linesizes: Array of line sizes for each plane
+ *
+ * @throws {Error} If allocation fails
+ *
+ * @example
+ * ```typescript
+ * import { avImageAlloc, AV_PIX_FMT_YUV420P, FFmpegError } from 'node-av';
+ *
+ * try {
+ *   const result = avImageAlloc(1920, 1080, AV_PIX_FMT_YUV420P, 32);
+ *   console.log(`Allocated ${result.size} bytes`);
+ *   console.log(`Y linesize: ${result.linesizes[0]}`);
+ *   // Use result.buffer for image data
+ * } catch (error) {
+ *   console.error('Failed to allocate image buffer');
+ * }
+ * ```
+ *
+ * @see {@link avImageGetBufferSize} To calculate required size without allocating
+ */
+export function avImageAlloc(width, height, pixFmt, align) {
+    const result = bindings.avImageAlloc(width, height, pixFmt, align);
+    if (typeof result === 'number') {
+        // Error code returned instead of object
+        throw new FFmpegError(result);
+    }
+    return result;
+}
+/**
+ * Copy image data from src to dst
+ * Direct mapping to av_image_copy2()
+ *
+ * @param dstData - Destination data buffers (one per plane)
+ * @param dstLinesizes - Destination line sizes
+ * @param srcData - Source data buffers (one per plane)
+ * @param srcLinesizes - Source line sizes
+ * @param pixFmt - Pixel format
+ * @param width - Image width
+ * @param height - Image height
+ */
+export function avImageCopy2(dstData, dstLinesizes, srcData, srcLinesizes, pixFmt, width, height) {
+    bindings.avImageCopy2(dstData, dstLinesizes, srcData, srcLinesizes, pixFmt, width, height);
+}
+/**
+ * Get the required buffer size for an image
+ * Direct mapping to av_image_get_buffer_size()
+ *
+ * @returns The required buffer size in bytes, or negative on error
+ */
+export function avImageGetBufferSize(pixFmt, width, height, align) {
+    return bindings.avImageGetBufferSize(pixFmt, width, height, align);
+}
+/**
+ * Copy image data to a single buffer.
+ *
+ * Copies image data from separate planes into a single continuous buffer.
+ * Useful for serialization or when a single buffer is required.
+ *
+ * Direct mapping to av_image_copy_to_buffer()
+ *
+ * @param dst - Destination buffer
+ * @param dstSize - Size of destination buffer in bytes
+ * @param srcData - Array of source data planes
+ * @param srcLinesize - Array of source linesizes
+ * @param pixFmt - Pixel format
+ * @param width - Image width in pixels
+ * @param height - Image height in pixels
+ * @param align - Buffer alignment
+ *
+ * @returns Number of bytes written to dst, or negative AVERROR on error:
+ *   - >0: Number of bytes written
+ *   - AVERROR(EINVAL): Invalid parameters
+ *   - AVERROR(ENOMEM): Destination buffer too small
+ *
+ * @example
+ * ```typescript
+ * import { avImageCopyToBuffer, avImageGetBufferSize, FFmpegError } from 'node-av';
+ * import { AV_PIX_FMT_RGB24 } from 'node-av';
+ *
+ * const width = 640, height = 480;
+ * const pixFmt = AV_PIX_FMT_RGB24;
+ *
+ * // Calculate required buffer size
+ * const dstSize = avImageGetBufferSize(pixFmt, width, height, 1);
+ * const dst = Buffer.alloc(dstSize);
+ *
+ * const ret = avImageCopyToBuffer(
+ *   dst, dstSize,
+ *   srcData, srcLinesize,
+ *   pixFmt, width, height, 1
+ * );
+ *
+ * FFmpegError.throwIfError(ret, 'avImageCopyToBuffer');
+ * console.log(`Copied ${ret} bytes to buffer`);
+ * ```
+ */
+export function avImageCopyToBuffer(dst, dstSize, srcData, srcLinesize, pixFmt, width, height, align) {
+    return bindings.avImageCopyToBuffer(dst, dstSize, srcData, srcLinesize, pixFmt, width, height, align);
+}
+/**
+ * Convert timestamp to string
+ * Direct mapping to av_ts2str()
+ */
+export function avTs2Str(ts) {
+    return bindings.avTs2Str(ts);
+}
+/**
+ * Convert timestamp to time string
+ * Direct mapping to av_ts2timestr()
+ */
+export function avTs2TimeStr(ts, timeBase) {
+    if (!timeBase) {
+        return avTs2Str(ts);
+    }
+    return bindings.avTs2TimeStr(ts, timeBase);
+}
+/**
+ * Helper to separate image allocation result into separate arrays
+ * This is useful when you need separate data and linesize arrays
+ */
+export function avImageAllocArrays(width, height, pixFmt, align) {
+    const result = avImageAlloc(width, height, pixFmt, align);
+    // Split the buffer into planes based on pixel format
+    const data = [];
+    const linesizes = result.linesizes;
+    // For now, we'll treat it as a single buffer
+    // In a real implementation, we'd need to know the plane layout for each pixel format
+    data[0] = result.buffer;
+    return {
+        data,
+        linesizes,
+        size: result.size,
+    };
+}
+/**
+ * Compare two timestamps
+ * Direct mapping to av_compare_ts()
+ *
+ * @returns -1 if tsA < tsB, 0 if tsA == tsB, 1 if tsA > tsB
+ */
+export function avCompareTs(tsA, tbA, tsB, tbB) {
+    return bindings.avCompareTs(tsA, tbA, tsB, tbB);
+}
+/**
+ * Rescale a timestamp from one timebase to another
+ * Direct mapping to av_rescale_q()
+ */
+export function avRescaleQ(a, bq, cq) {
+    return bindings.avRescaleQ(a, bq, cq);
+}
+/**
+ * Sleep for a specified number of microseconds.
+ *
+ * Provides a cross-platform microsecond sleep function.
+ * Useful for timing operations or frame pacing.
+ *
+ * Direct mapping to av_usleep()
+ *
+ * @param usec - Number of microseconds to sleep
+ *
+ * @example
+ * ```typescript
+ * import { avUsleep } from 'node-av';
+ *
+ * // Sleep for 100ms (100,000 microseconds)
+ * avUsleep(100000);
+ *
+ * // Sleep for 1 second
+ * avUsleep(1000000);
+ *
+ * // Frame pacing for 30fps (33.33ms per frame)
+ * const frameTime = 1000000 / 30;
+ * avUsleep(frameTime);
+ * ```
+ */
+export function avUsleep(usec) {
+    bindings.avUsleep(usec);
+}
+/**
+ * Rescale a timestamp with rounding
+ * Direct mapping to av_rescale_rnd()
+ *
+ * @param a - Value to rescale
+ * @param b - Numerator of scale factor
+ * @param c - Denominator of scale factor
+ * @param rnd - Rounding mode (AVRounding enum)
+ * @returns Rescaled value
+ */
+export function avRescaleRnd(a, b, c, rnd) {
+    return bindings.avRescaleRnd(a, b, c, rnd);
+}
+/**
+ * Allocate audio sample buffers
+ * Direct mapping to av_samples_alloc()
+ *
+ * @param nbChannels - Number of channels
+ * @param nbSamples - Number of samples per channel
+ * @param sampleFmt - Sample format
+ * @param align - Buffer alignment (0 for default)
+ * @returns Object with allocated data buffers, linesize and total size, or error code
+ */
+export function avSamplesAlloc(nbChannels, nbSamples, sampleFmt, align) {
+    const result = bindings.avSamplesAlloc(nbChannels, nbSamples, sampleFmt, align);
+    if (typeof result === 'number') {
+        throw new FFmpegError(result);
+    }
+    return result;
+}
+/**
+ * Get the required buffer size for audio samples
+ * Direct mapping to av_samples_get_buffer_size()
+ *
+ * @param nbChannels - Number of channels
+ * @param nbSamples - Number of samples per channel
+ * @param sampleFmt - Sample format
+ * @param align - Buffer alignment (0 for default)
+ * @returns Object with size and linesize, or error code
+ */
+export function avSamplesGetBufferSize(nbChannels, nbSamples, sampleFmt, align) {
+    const result = bindings.avSamplesGetBufferSize(nbChannels, nbSamples, sampleFmt, align);
+    if (typeof result === 'number') {
+        throw new FFmpegError(result);
+    }
+    return result;
+}
+/**
+ * Get a string description of a channel layout.
+ * Direct mapping to av_channel_layout_describe()
+ *
+ * @param channelLayout - The channel layout object with order, nbChannels, and mask
+ * @returns String description of the channel layout, or null if invalid
+ */
+export function avChannelLayoutDescribe(channelLayout) {
+    return bindings.avChannelLayoutDescribe(channelLayout);
+}
+/**
+ * Create an SDP (Session Description Protocol) string for RTP/RTSP streaming.
+ *
+ * Generates an SDP description from one or more FormatContext objects.
+ * Useful for RTP/RTSP streaming scenarios where you need to describe
+ * the media streams to clients.
+ *
+ * Direct mapping to av_sdp_create()
+ *
+ * @param contexts - Array of FormatContext objects to describe
+ * @returns SDP string on success, or null on failure
+ *
+ * @throws {FFmpegError} On invalid parameters or SDP creation failure
+ *
+ * @example
+ * ```typescript
+ * import { avSdpCreate, FormatContext, FFmpegError } from 'node-av';
+ *
+ * // Create format contexts for RTP output
+ * const contexts: FormatContext[] = [];
+ *
+ * const ctx = new FormatContext();
+ * // ... configure context for RTP output ...
+ * contexts.push(ctx);
+ *
+ * // Generate SDP
+ * const sdp = avSdpCreate(contexts);
+ * if (sdp) {
+ *   console.log('SDP:', result);
+ * }
+ *
+ * // Use the SDP string for RTSP server or save to .sdp file
+ * ```
+ */
+export function avSdpCreate(contexts) {
+    if (!Array.isArray(contexts) || contexts.length === 0) {
+        return null;
+    }
+    // Pass the native objects to the binding
+    const nativeContexts = contexts
+        .map((ctx) => {
+        if (ctx && typeof ctx.getNative === 'function') {
+            const nativeCtx = ctx.getNative();
+            if (nativeCtx) {
+                return nativeCtx;
+            }
+        }
+    })
+        .filter((ctx) => ctx !== undefined);
+    // If no valid contexts after filtering, return null
+    if (nativeContexts.length === 0) {
+        return null;
+    }
+    return bindings.avSdpCreate(nativeContexts);
+}
+//# sourceMappingURL=utilities.js.map

package/dist/lib/utilities.js.map

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

package/install/check.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+
+import { getFFmpegLibraryVersions, globalFFmpegVersion, log, spawnRebuild, useGlobalFFmpeg } from './ffmpeg.js';
+
+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');
+
+  // Check for node-addon-api and node-gyp
+  let hasNodeAddonApi = false;
+  let hasNodeGyp = false;
+
+  try {
+    // @ts-expect-error
+    await import('node-addon-api');
+    hasNodeAddonApi = true;
+  } catch {
+    // Not installed
+  }
+
+  try {
+    // @ts-expect-error
+    await import('node-gyp');
+    hasNodeGyp = true;
+  } catch {
+    // Not installed
+  }
+
+  if (!hasNodeAddonApi || !hasNodeGyp) {
+    log('');
+    log('Missing build dependencies. Please install:');
+    log('  npm install --save-dev node-addon-api node-gyp');
+    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('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('See https://github.com/seydx/av for detailed requirements');
+    process.exit(status);
+  }
+};
+
+(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}`);
+        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
+      if (shouldBuildFromSource) {
+        log('--build-from-source specified but no FFmpeg libraries found');
+        log('Please install FFmpeg 7.1+ with development headers');
+        process.exit(1);
+      } 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);
+      }
+    }
+  } catch (err) {
+    const summary = err.message.split(/\n/).slice(0, 1);
+    console.log(`node-av: installation error: ${summary}`);
+    process.exit(1);
+  }
+})();