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

package/dist/lib/codec.js.map

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

package/dist/lib/device.d.ts

@@ -0,0 +1,294 @@
+import type { AVCodecID, AVPixelFormat, AVSampleFormat } from '../constants/constants.js';
+/**
+ * Screen bounds rectangle
+ */
+export interface ScreenBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Base device information
+ */
+export interface BaseDeviceInfo {
+    name: string;
+    description: string;
+    isDefault: boolean;
+}
+/**
+ * Device information for video capture devices
+ */
+export interface VideoDeviceInfo extends BaseDeviceInfo {
+    type: 'video';
+}
+/**
+ * Device information for audio capture devices
+ */
+export interface AudioDeviceInfo extends BaseDeviceInfo {
+    type: 'audio';
+}
+/**
+ * Device information for screen capture devices
+ */
+export interface ScreenDeviceInfo extends BaseDeviceInfo {
+    type: 'screen';
+    bounds: ScreenBounds;
+}
+/**
+ * Device information for capture devices
+ */
+export type DeviceInfo = VideoDeviceInfo | AudioDeviceInfo | ScreenDeviceInfo;
+/**
+ * Device capture mode
+ */
+export interface DeviceMode {
+    width: number;
+    height: number;
+    minFrameRate: number;
+    maxFrameRate: number;
+    /** Pixel format of raw capture modes, `AV_PIX_FMT_NONE` for compressed ones */
+    pixelFormat: AVPixelFormat;
+    /** `AV_CODEC_ID_RAWVIDEO` for raw capture modes, the codec of compressed ones (e.g. `AV_CODEC_ID_MJPEG`), `AV_CODEC_ID_NONE` if unknown */
+    codecId: AVCodecID;
+}
+/**
+ * Audio device capture mode
+ */
+export interface AudioDeviceMode {
+    sampleRate: number;
+    channels: number;
+    sampleFormat: AVSampleFormat;
+}
+/**
+ * Low-level device enumeration and format detection.
+ *
+ * Provides direct access to system capture devices (cameras, microphones)
+ * and platform-specific input format names for FFmpeg.
+ *
+ * Direct mapping to platform-specific APIs:
+ * - macOS: AVFoundation
+ * - Linux: V4L2/ALSA
+ * - Windows: DirectShow
+ *
+ * @example
+ * ```typescript
+ * import { Device } from 'node-av/lib';
+ *
+ * // List all capture devices
+ * const devices = await Device.list();
+ * for (const device of devices) {
+ *   console.log(`[${device.type}] ${device.name}: ${device.description}`);
+ * }
+ *
+ * // Get platform-specific format names
+ * console.log(`Video format: ${Device.getVideoFormat()}`);
+ * console.log(`Audio format: ${Device.getAudioFormat()}`);
+ * console.log(`Screen format: ${Device.getScreenFormat()}`);
+ * ```
+ *
+ * @see {@link DeviceInfo} For device structure
+ */
+export declare class Device {
+    /**
+     * List all available capture devices.
+     *
+     * Enumerates video and audio capture devices on the system.
+     * Uses platform-specific APIs for device discovery.
+     *
+     * @returns Array of device information
+     *
+     * @example
+     * ```typescript
+     * const devices = await Device.list();
+     * const cameras = devices.filter(d => d.type === 'video');
+     * const microphones = devices.filter(d => d.type === 'audio');
+     * ```
+     */
+    static list(): Promise<DeviceInfo[]>;
+    /**
+     * List all available capture devices synchronously.
+     *
+     * @returns Array of device information
+     *
+     * @example
+     * ```typescript
+     * const devices = Device.listSync();
+     * ```
+     *
+     * @see {@link list} For async version
+     */
+    static listSync(): DeviceInfo[];
+    /**
+     * Query supported capture modes for a video device.
+     *
+     * Returns supported resolutions and frame rate ranges for the specified device.
+     * Modes are sorted descending by resolution (area), then by max frame rate.
+     *
+     * @param deviceName - Device name as returned by `list()` (e.g. uniqueID on macOS, /dev/video0 on Linux)
+     *
+     * @returns Array of supported device modes
+     *
+     * @example
+     * ```typescript
+     * const devices = await Device.list();
+     * const camera = devices.find(d => d.type === 'video');
+     * if (camera) {
+     *   const modes = await Device.modes(camera.name);
+     *   console.log('Supported modes:', modes);
+     * }
+     * ```
+     */
+    static modes(deviceName: string): Promise<DeviceMode[]>;
+    /**
+     * Query supported capture modes for a video device synchronously.
+     *
+     * @param deviceName - Device name as returned by `listSync()`
+     *
+     * @returns Array of supported device modes
+     *
+     * @example
+     * ```typescript
+     * const devices = Device.listSync();
+     * const camera = devices.find(d => d.type === 'video');
+     * if (camera) {
+     *   const modes = Device.modesSync(camera.name);
+     *   console.log('Supported modes:', modes);
+     * }
+     * ```
+     *
+     * @see {@link modes} For async version
+     */
+    static modesSync(deviceName: string): DeviceMode[];
+    /**
+     * Query supported audio capture modes for an audio device.
+     *
+     * Returns supported sample rates, channel counts and sample formats for the specified device.
+     * Modes are sorted descending by sample rate, then by channel count.
+     *
+     * @param deviceName - Device name as returned by `list()` (e.g. uniqueID on macOS, hw:0 on Linux)
+     *
+     * @returns Array of supported audio device modes
+     *
+     * @example
+     * ```typescript
+     * const devices = await Device.list();
+     * const mic = devices.find(d => d.type === 'audio');
+     * if (mic) {
+     *   const modes = await Device.audioModes(mic.name);
+     *   console.log('Supported audio modes:', modes);
+     * }
+     * ```
+     */
+    static audioModes(deviceName: string): Promise<AudioDeviceMode[]>;
+    /**
+     * Query supported audio capture modes for an audio device synchronously.
+     *
+     * @param deviceName - Device name as returned by `listSync()`
+     *
+     * @returns Array of supported audio device modes
+     *
+     * @example
+     * ```typescript
+     * const devices = Device.listSync();
+     * const mic = devices.find(d => d.type === 'audio');
+     * if (mic) {
+     *   const modes = Device.audioModesSync(mic.name);
+     *   console.log('Supported audio modes:', modes);
+     * }
+     * ```
+     *
+     * @see {@link audioModes} For async version
+     */
+    static audioModesSync(deviceName: string): AudioDeviceMode[];
+    /**
+     * Get platform-specific video input format name.
+     *
+     * @returns Format name for FFmpeg input
+     *
+     * | Platform | Format |
+     * |----------|--------|
+     * | macOS    | avfoundation |
+     * | Linux    | v4l2 |
+     * | Windows  | dshow |
+     *
+     * @example
+     * ```typescript
+     * const format = Device.getVideoFormat();
+     * // Use with Demuxer.open(deviceName, { format })
+     * ```
+     */
+    static getVideoFormat(): string;
+    /**
+     * Get platform-specific audio input format name.
+     *
+     * @returns Format name for FFmpeg input
+     *
+     * | Platform | Format |
+     * |----------|--------|
+     * | macOS    | avfoundation |
+     * | Linux    | alsa |
+     * | Windows  | dshow |
+     *
+     * @example
+     * ```typescript
+     * const format = Device.getAudioFormat(); // 'avfoundation' on macOS
+     * ```
+     */
+    static getAudioFormat(): string;
+    /**
+     * Get platform-specific screen capture format name.
+     *
+     * @returns Format name for FFmpeg input
+     *
+     * | Platform | Format |
+     * |----------|--------|
+     * | macOS    | avfoundation |
+     * | Linux    | x11grab |
+     * | Windows  | gdigrab |
+     *
+     * @example
+     * ```typescript
+     * const format = Device.getScreenFormat(); // 'avfoundation' on macOS
+     * ```
+     */
+    static getScreenFormat(): string;
+    /**
+     * Check if the application has screen capture permission (macOS only).
+     *
+     * Uses `CGPreflightScreenCaptureAccess()` on macOS 11+.
+     * Always returns `true` on Linux, Windows, and macOS < 11.
+     *
+     * @returns `true` if screen capture is permitted
+     *
+     * @example
+     * ```typescript
+     * if (Device.hasScreenCapturePermission()) {
+     *   console.log('Screen capture is permitted');
+     * } else {
+     *   console.log('Screen capture permission not granted');
+     * }
+     * ```
+     */
+    static hasScreenCapturePermission(): boolean;
+    /**
+     * Request screen capture permission from the user (macOS only).
+     *
+     * Uses `CGRequestScreenCaptureAccess()` on macOS 11+.
+     * This will trigger the system permission dialog if not already granted.
+     * Always returns `true` on Linux, Windows, and macOS < 11.
+     *
+     * @returns `true` if permission was already granted (does not wait for dialog)
+     *
+     * @example
+     * ```typescript
+     * const granted = Device.requestScreenCaptureAccess();
+     * if (granted) {
+     *   console.log('Screen capture permission already granted');
+     * } else {
+     *   console.log('Screen capture permission dialog shown to user');
+     * }
+     * ```
+     */
+    static requestScreenCaptureAccess(): boolean;
+}

package/dist/lib/device.js

@@ -0,0 +1,326 @@
+import { bindings } from './binding.js';
+/**
+ * Low-level device enumeration and format detection.
+ *
+ * Provides direct access to system capture devices (cameras, microphones)
+ * and platform-specific input format names for FFmpeg.
+ *
+ * Direct mapping to platform-specific APIs:
+ * - macOS: AVFoundation
+ * - Linux: V4L2/ALSA
+ * - Windows: DirectShow
+ *
+ * @example
+ * ```typescript
+ * import { Device } from 'node-av/lib';
+ *
+ * // List all capture devices
+ * const devices = await Device.list();
+ * for (const device of devices) {
+ *   console.log(`[${device.type}] ${device.name}: ${device.description}`);
+ * }
+ *
+ * // Get platform-specific format names
+ * console.log(`Video format: ${Device.getVideoFormat()}`);
+ * console.log(`Audio format: ${Device.getAudioFormat()}`);
+ * console.log(`Screen format: ${Device.getScreenFormat()}`);
+ * ```
+ *
+ * @see {@link DeviceInfo} For device structure
+ */
+export class Device {
+    /**
+     * List all available capture devices.
+     *
+     * Enumerates video and audio capture devices on the system.
+     * Uses platform-specific APIs for device discovery.
+     *
+     * @returns Array of device information
+     *
+     * @example
+     * ```typescript
+     * const devices = await Device.list();
+     * const cameras = devices.filter(d => d.type === 'video');
+     * const microphones = devices.filter(d => d.type === 'audio');
+     * ```
+     */
+    static async list() {
+        const nativeDevices = await bindings.Device.listDevices();
+        return nativeDevices.map((d) => {
+            if (d.type === 'screen') {
+                return {
+                    name: d.name,
+                    description: d.description,
+                    type: 'screen',
+                    isDefault: d.isDefault,
+                    bounds: {
+                        x: d.screenX ?? 0,
+                        y: d.screenY ?? 0,
+                        width: d.screenWidth ?? 0,
+                        height: d.screenHeight ?? 0,
+                    },
+                };
+            }
+            return {
+                name: d.name,
+                description: d.description,
+                type: d.type,
+                isDefault: d.isDefault,
+            };
+        });
+    }
+    /**
+     * List all available capture devices synchronously.
+     *
+     * @returns Array of device information
+     *
+     * @example
+     * ```typescript
+     * const devices = Device.listSync();
+     * ```
+     *
+     * @see {@link list} For async version
+     */
+    static listSync() {
+        const nativeDevices = bindings.Device.listDevicesSync();
+        return nativeDevices.map((d) => {
+            if (d.type === 'screen') {
+                return {
+                    name: d.name,
+                    description: d.description,
+                    type: 'screen',
+                    isDefault: d.isDefault,
+                    bounds: {
+                        x: d.screenX ?? 0,
+                        y: d.screenY ?? 0,
+                        width: d.screenWidth ?? 0,
+                        height: d.screenHeight ?? 0,
+                    },
+                };
+            }
+            return {
+                name: d.name,
+                description: d.description,
+                type: d.type,
+                isDefault: d.isDefault,
+            };
+        });
+    }
+    /**
+     * Query supported capture modes for a video device.
+     *
+     * Returns supported resolutions and frame rate ranges for the specified device.
+     * Modes are sorted descending by resolution (area), then by max frame rate.
+     *
+     * @param deviceName - Device name as returned by `list()` (e.g. uniqueID on macOS, /dev/video0 on Linux)
+     *
+     * @returns Array of supported device modes
+     *
+     * @example
+     * ```typescript
+     * const devices = await Device.list();
+     * const camera = devices.find(d => d.type === 'video');
+     * if (camera) {
+     *   const modes = await Device.modes(camera.name);
+     *   console.log('Supported modes:', modes);
+     * }
+     * ```
+     */
+    static async modes(deviceName) {
+        const nativeModes = await bindings.Device.listDeviceModes(deviceName);
+        return nativeModes.map((m) => ({
+            width: m.width,
+            height: m.height,
+            minFrameRate: m.minFrameRate,
+            maxFrameRate: m.maxFrameRate,
+            pixelFormat: m.pixelFormat,
+            codecId: m.codecId,
+        }));
+    }
+    /**
+     * Query supported capture modes for a video device synchronously.
+     *
+     * @param deviceName - Device name as returned by `listSync()`
+     *
+     * @returns Array of supported device modes
+     *
+     * @example
+     * ```typescript
+     * const devices = Device.listSync();
+     * const camera = devices.find(d => d.type === 'video');
+     * if (camera) {
+     *   const modes = Device.modesSync(camera.name);
+     *   console.log('Supported modes:', modes);
+     * }
+     * ```
+     *
+     * @see {@link modes} For async version
+     */
+    static modesSync(deviceName) {
+        const nativeModes = bindings.Device.listDeviceModesSync(deviceName);
+        return nativeModes.map((m) => ({
+            width: m.width,
+            height: m.height,
+            minFrameRate: m.minFrameRate,
+            maxFrameRate: m.maxFrameRate,
+            pixelFormat: m.pixelFormat,
+            codecId: m.codecId,
+        }));
+    }
+    /**
+     * Query supported audio capture modes for an audio device.
+     *
+     * Returns supported sample rates, channel counts and sample formats for the specified device.
+     * Modes are sorted descending by sample rate, then by channel count.
+     *
+     * @param deviceName - Device name as returned by `list()` (e.g. uniqueID on macOS, hw:0 on Linux)
+     *
+     * @returns Array of supported audio device modes
+     *
+     * @example
+     * ```typescript
+     * const devices = await Device.list();
+     * const mic = devices.find(d => d.type === 'audio');
+     * if (mic) {
+     *   const modes = await Device.audioModes(mic.name);
+     *   console.log('Supported audio modes:', modes);
+     * }
+     * ```
+     */
+    static async audioModes(deviceName) {
+        const nativeModes = await bindings.Device.listAudioDeviceModes(deviceName);
+        return nativeModes.map((m) => ({
+            sampleRate: m.sampleRate,
+            channels: m.channels,
+            sampleFormat: m.sampleFormat,
+        }));
+    }
+    /**
+     * Query supported audio capture modes for an audio device synchronously.
+     *
+     * @param deviceName - Device name as returned by `listSync()`
+     *
+     * @returns Array of supported audio device modes
+     *
+     * @example
+     * ```typescript
+     * const devices = Device.listSync();
+     * const mic = devices.find(d => d.type === 'audio');
+     * if (mic) {
+     *   const modes = Device.audioModesSync(mic.name);
+     *   console.log('Supported audio modes:', modes);
+     * }
+     * ```
+     *
+     * @see {@link audioModes} For async version
+     */
+    static audioModesSync(deviceName) {
+        const nativeModes = bindings.Device.listAudioDeviceModesSync(deviceName);
+        return nativeModes.map((m) => ({
+            sampleRate: m.sampleRate,
+            channels: m.channels,
+            sampleFormat: m.sampleFormat,
+        }));
+    }
+    /**
+     * Get platform-specific video input format name.
+     *
+     * @returns Format name for FFmpeg input
+     *
+     * | Platform | Format |
+     * |----------|--------|
+     * | macOS    | avfoundation |
+     * | Linux    | v4l2 |
+     * | Windows  | dshow |
+     *
+     * @example
+     * ```typescript
+     * const format = Device.getVideoFormat();
+     * // Use with Demuxer.open(deviceName, { format })
+     * ```
+     */
+    static getVideoFormat() {
+        return bindings.Device.getVideoFormat();
+    }
+    /**
+     * Get platform-specific audio input format name.
+     *
+     * @returns Format name for FFmpeg input
+     *
+     * | Platform | Format |
+     * |----------|--------|
+     * | macOS    | avfoundation |
+     * | Linux    | alsa |
+     * | Windows  | dshow |
+     *
+     * @example
+     * ```typescript
+     * const format = Device.getAudioFormat(); // 'avfoundation' on macOS
+     * ```
+     */
+    static getAudioFormat() {
+        return bindings.Device.getAudioFormat();
+    }
+    /**
+     * Get platform-specific screen capture format name.
+     *
+     * @returns Format name for FFmpeg input
+     *
+     * | Platform | Format |
+     * |----------|--------|
+     * | macOS    | avfoundation |
+     * | Linux    | x11grab |
+     * | Windows  | gdigrab |
+     *
+     * @example
+     * ```typescript
+     * const format = Device.getScreenFormat(); // 'avfoundation' on macOS
+     * ```
+     */
+    static getScreenFormat() {
+        return bindings.Device.getScreenFormat();
+    }
+    /**
+     * Check if the application has screen capture permission (macOS only).
+     *
+     * Uses `CGPreflightScreenCaptureAccess()` on macOS 11+.
+     * Always returns `true` on Linux, Windows, and macOS < 11.
+     *
+     * @returns `true` if screen capture is permitted
+     *
+     * @example
+     * ```typescript
+     * if (Device.hasScreenCapturePermission()) {
+     *   console.log('Screen capture is permitted');
+     * } else {
+     *   console.log('Screen capture permission not granted');
+     * }
+     * ```
+     */
+    static hasScreenCapturePermission() {
+        return bindings.Device.hasScreenCapturePermission();
+    }
+    /**
+     * Request screen capture permission from the user (macOS only).
+     *
+     * Uses `CGRequestScreenCaptureAccess()` on macOS 11+.
+     * This will trigger the system permission dialog if not already granted.
+     * Always returns `true` on Linux, Windows, and macOS < 11.
+     *
+     * @returns `true` if permission was already granted (does not wait for dialog)
+     *
+     * @example
+     * ```typescript
+     * const granted = Device.requestScreenCaptureAccess();
+     * if (granted) {
+     *   console.log('Screen capture permission already granted');
+     * } else {
+     *   console.log('Screen capture permission dialog shown to user');
+     * }
+     * ```
+     */
+    static requestScreenCaptureAccess() {
+        return bindings.Device.requestScreenCaptureAccess();
+    }
+}
+//# sourceMappingURL=device.js.map

package/dist/lib/device.js.map

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