grandi 1.1.0 → 1.2.1

package/dist/index.d.mts

@@ -0,0 +1,644 @@
+//#region src/types.d.ts
+declare enum FrameType {
+  Interlaced = 0,
+  Progressive = 1,
+  Field0 = 2,
+  Field1 = 3,
+}
+declare enum ColorFormat {
+  BGRX_BGRA = 0,
+  UYVY_BGRA = 1,
+  RGBX_RGBA = 2,
+  UYVY_RGBA = 3,
+  Fastest = 100,
+  Best = 101,
+  BGRX_BGRA_FLIPPED = 1000,
+}
+declare enum AudioFormat {
+  Float32Separate = 0,
+  Float32Interleaved = 1,
+  Int16Interleaved = 2,
+}
+declare enum Bandwidth {
+  MetadataOnly = -10,
+  AudioOnly = 10,
+  Lowest = 0,
+  Highest = 100,
+}
+declare enum FourCC {
+  UYVY = 1498831189,
+  UYVA = 1096178005,
+  P216 = 909193808,
+  PA16 = 909197648,
+  YV12 = 842094169,
+  I420 = 808596553,
+  NV12 = 842094158,
+  BGRA = 1095911234,
+  BGRX = 1481787202,
+  RGBA = 1094862674,
+  RGBX = 1480738642,
+  FLTp = 1884572742,
+}
+type PtpTimestamp = [number, number];
+type Timecode = bigint | number | PtpTimestamp;
+interface Source {
+  name: string;
+  urlAddress?: string;
+}
+interface VideoFrame {
+  type?: "video";
+  xres: number;
+  yres: number;
+  frameRateN: number;
+  frameRateD: number;
+  pictureAspectRatio: number;
+  fourCC: FourCC;
+  frameFormatType: FrameType;
+  lineStrideBytes: number;
+  data: Buffer;
+  timecode?: Timecode;
+  /**
+   * Receive-only timestamp filled by the NDI SDK (UTC time, 100ns units under the hood).
+   * NDI ignores this field when sending.
+   */
+  timestamp?: PtpTimestamp;
+  metadata?: string;
+}
+interface ReceivedVideoFrame extends VideoFrame {
+  type: "video";
+  timecode: PtpTimestamp;
+  timestamp: PtpTimestamp;
+  metadata?: string;
+}
+interface AudioFrame {
+  type?: "audio";
+  sampleRate: number;
+  noChannels: number;
+  noSamples: number;
+  channelStrideBytes: number;
+  data: Buffer;
+  fourCC: FourCC;
+  timecode?: Timecode;
+  /**
+   * Receive-only timestamp filled by the NDI SDK (UTC time, 100ns units under the hood).
+   * NDI ignores this field when sending.
+   */
+  timestamp?: PtpTimestamp;
+  metadata?: string;
+}
+interface ReceivedAudioFrame {
+  type: "audio";
+  audioFormat: AudioFormat;
+  referenceLevel?: number;
+  sampleRate: number;
+  channels: number;
+  samples: number;
+  channelStrideInBytes: number;
+  data: Buffer;
+  timecode: PtpTimestamp;
+  timestamp: PtpTimestamp;
+  metadata?: string;
+}
+interface ReceivedMetadataFrame {
+  type: "metadata";
+  length: number;
+  timecode: PtpTimestamp;
+  timestamp: PtpTimestamp;
+  data: string;
+}
+interface SourceChangeEvent {
+  type: "sourceChange";
+}
+interface StatusChangeEvent {
+  type: "statusChange";
+}
+interface TimeoutEvent {
+  type: "timeout";
+}
+type ReceiverDataFrame = ReceivedVideoFrame | ReceivedAudioFrame | ReceivedMetadataFrame | SourceChangeEvent | StatusChangeEvent | TimeoutEvent;
+interface AudioReceiveOptions {
+  audioFormat?: AudioFormat;
+  referenceLevel?: number;
+}
+interface Receiver {
+  embedded: unknown;
+  source: Source;
+  colorFormat: ColorFormat;
+  bandwidth: Bandwidth;
+  allowVideoFields: boolean;
+  name?: string;
+  video(timeoutMs?: number): Promise<ReceivedVideoFrame>;
+  audio(timeoutMs?: number): Promise<ReceivedAudioFrame>;
+  audio(options: AudioReceiveOptions, timeoutMs?: number): Promise<ReceivedAudioFrame>;
+  metadata(timeoutMs?: number): Promise<ReceivedMetadataFrame>;
+  data(timeoutMs?: number): Promise<ReceiverDataFrame>;
+  data(options: AudioReceiveOptions, timeoutMs?: number): Promise<ReceiverDataFrame>;
+  tally(state: ReceiverTallyState): boolean;
+  destroy(): boolean;
+}
+interface ReceiverTallyState {
+  onProgram?: boolean;
+  onPreview?: boolean;
+}
+interface SenderTally {
+  changed: boolean;
+  on_program: boolean;
+  on_preview: boolean;
+}
+interface Sender {
+  embedded: unknown;
+  name: string;
+  groups?: string;
+  clockVideo: boolean;
+  clockAudio: boolean;
+  video(frame: VideoFrame): Promise<void>;
+  audio(frame: AudioFrame): Promise<void>;
+  connections(): number;
+  metadata(data: string): boolean;
+  tally(): SenderTally;
+  sourcename(): string;
+  destroy(): boolean;
+}
+interface Routing {
+  embedded: unknown;
+  name?: string;
+  groups?: string;
+  destroy(): boolean;
+  change(source: Source): boolean;
+  clear(): boolean;
+  connections(): number;
+  sourcename(): string;
+}
+interface FrameSyncAudioOptions {
+  sampleRate?: number;
+  noChannels?: number;
+  noSamples?: number;
+}
+interface FrameSync {
+  embedded: unknown;
+  /**
+   * Captures a video frame using NDI frame-synchronization (time base correction).
+   * Always returns immediately.
+   *
+   * If no video has ever been received, resolves with `{ type: "timeout" }`.
+   */
+  video(fieldType?: FrameType): Promise<ReceivedVideoFrame | TimeoutEvent>;
+  /**
+   * Captures audio using NDI frame-synchronization (resampled to match your calls).
+   * Always returns immediately and may insert silence if no audio is present.
+   */
+  audio(options?: FrameSyncAudioOptions): Promise<ReceivedAudioFrame>;
+  /**
+   * Returns an approximate depth of the internal audio queue in samples.
+   */
+  audioQueueDepth(): number;
+  destroy(): boolean;
+}
+interface Finder {
+  sources(): Source[];
+  wait(timeoutMs?: number): boolean;
+  destroy(): boolean;
+}
+interface FindOptions {
+  showLocalSources?: boolean;
+  groups?: string;
+  extraIPs?: string;
+}
+interface ReceiveOptions {
+  source: Source;
+  colorFormat?: ColorFormat;
+  bandwidth?: Bandwidth;
+  /**
+   * If `colorFormat` is `ColorFormat.Fastest` or `ColorFormat.Best`, the NDI SDK
+   * implicitly enables video fields and this option is forced to `true`.
+   */
+  allowVideoFields?: boolean;
+  name?: string;
+}
+interface SendOptions {
+  name: string;
+  groups?: string;
+  clockVideo?: boolean;
+  clockAudio?: boolean;
+}
+interface Grandi {
+  /**
+   * Gets the NDI SDK version string (e.g. `"NDI SDK 6.0.0.0"`).
+   * @returns The NDI SDK version string.
+   *
+   * @example
+   * ```js
+   * import grandi from "grandi";
+   * console.log(grandi.version());
+   * ```
+   */
+  version(): string;
+  /**
+   * Checks if the current CPU architecture is supported by NDI.
+   * @returns `true` when NDI is supported on this CPU/platform.
+   *
+   * @example
+   * ```js
+   * import grandi from "grandi";
+   * if (!grandi.isSupportedCPU()) throw new Error("NDI unsupported here");
+   * ```
+   */
+  isSupportedCPU(): boolean;
+  /**
+   * Initializes the NDI library. Must be called before using any other NDI functions.
+   * Call this once per process, before creating senders/receivers/finders.
+   * @returns `true` if initialization was successful.
+   *
+   * @example
+   * ```js
+   * import grandi from "grandi";
+   * if (!grandi.initialize()) throw new Error("NDI init failed");
+   * ```
+   */
+  initialize(): boolean;
+  /**
+   * Destroys the NDI library instance and cleans up resources.
+   * Should be called when done using NDI to free resources.
+   * @returns `true` if destruction was successful.
+   *
+   * @example
+   * ```js
+   * import grandi from "grandi";
+   * grandi.destroy();
+   * ```
+   */
+  destroy(): boolean;
+  /**
+   * Creates an NDI sender for transmitting video and audio over the network.
+   * @param params Sender options.
+   * @returns A promise that resolves to a Sender instance.
+   * @throws {Error} Promise rejects on unsupported platform/CPU or if sender creation fails.
+   *
+   * @example
+   * ```js
+   * import grandi from "grandi";
+   * grandi.initialize();
+   * const sender = await grandi.send({ name: "My Source" });
+   * ```
+   */
+  send(params: SendOptions): Promise<Sender>;
+  /**
+   * Creates an NDI receiver for receiving video and audio from an NDI source.
+   * @param params Receiver options.
+   * @returns A promise that resolves to a Receiver instance.
+   * @throws {Error} Promise rejects on unsupported platform/CPU or if receiver creation fails.
+   *
+   * @example
+   * ```js
+   * import grandi from "grandi";
+   * grandi.initialize();
+   * const finder = await grandi.find({ showLocalSources: true });
+   * finder.wait(1000);
+   * const source = finder.sources()[0];
+   * finder.destroy();
+   * const receiver = await grandi.receive({ source });
+   * const frame = await receiver.video(1000);
+   * receiver.destroy();
+   * ```
+   */
+  receive(params: ReceiveOptions): Promise<Receiver>;
+  /**
+   * Creates an NDI frame-synchronizer (time base corrector) backed by an existing receiver.
+   * Use this when you want smooth playback clocked to your own render/audio loop.
+   *
+   * Note: destroy the frame-sync before destroying the receiver.
+   */
+  framesync(receiver: Receiver): Promise<FrameSync>;
+  /**
+   * Creates an NDI router for switching between different NDI sources.
+   * @param params Router options.
+   * @returns A promise that resolves to a Routing instance.
+   * @throws {Error} Promise rejects on unsupported platform/CPU or if routing creation fails.
+   *
+   * @example
+   * ```js
+   * import grandi from "grandi";
+   * grandi.initialize();
+   * const router = await grandi.routing({ name: "My Router" });
+   * // router.change(source) to route a discovered source
+   * router.destroy();
+   * ```
+   */
+  routing(params: {
+    name?: string;
+    groups?: string;
+  }): Promise<Routing>;
+  /**
+   * Creates a finder to discover NDI sources on the network.
+   * @param params Discovery options.
+   * @returns A promise that resolves to a Finder instance.
+   * @throws {Error} Promise rejects on unsupported platform/CPU or if the finder cannot be created.
+   *
+   * @example
+   * ```js
+   * import grandi from "grandi";
+   * grandi.initialize();
+   * const finder = await grandi.find({ showLocalSources: true });
+   * finder.wait(1000);
+   * console.log(finder.sources());
+   * finder.destroy();
+   * ```
+   */
+  find(params?: FindOptions): Promise<Finder>;
+  /**
+   * Enum: receiver video color formats.
+   */
+  ColorFormat: typeof ColorFormat;
+  /**
+   * Enum: supported raw audio formats for helpers/receive conversions.
+   */
+  AudioFormat: typeof AudioFormat;
+  /**
+   * Enum: receiver bandwidth modes.
+   */
+  Bandwidth: typeof Bandwidth;
+  /**
+   * Enum: video frame format types (progressive/interlaced/fields).
+   */
+  FrameType: typeof FrameType;
+  /**
+   * Enum: FourCC pixel/audio formats used in frames.
+   */
+  FourCC: typeof FourCC;
+  /**
+   * Alias of `ColorFormat.BGRX_BGRA`.
+   */
+  COLOR_FORMAT_BGRX_BGRA: ColorFormat;
+  /**
+   * Alias of `ColorFormat.UYVY_BGRA`.
+   */
+  COLOR_FORMAT_UYVY_BGRA: ColorFormat;
+  /**
+   * Alias of `ColorFormat.RGBX_RGBA`.
+   */
+  COLOR_FORMAT_RGBX_RGBA: ColorFormat;
+  /**
+   * Alias of `ColorFormat.UYVY_RGBA`.
+   */
+  COLOR_FORMAT_UYVY_RGBA: ColorFormat;
+  /**
+   * Alias of `ColorFormat.Fastest`.
+   */
+  COLOR_FORMAT_FASTEST: ColorFormat;
+  /**
+   * Alias of `ColorFormat.BGRX_BGRA_FLIPPED` (Windows-only).
+   */
+  COLOR_FORMAT_BGRX_BGRA_FLIPPED: ColorFormat;
+  /**
+   * Alias of `Bandwidth.MetadataOnly`.
+   */
+  BANDWIDTH_METADATA_ONLY: Bandwidth;
+  /**
+   * Alias of `Bandwidth.AudioOnly`.
+   */
+  BANDWIDTH_AUDIO_ONLY: Bandwidth;
+  /**
+   * Alias of `Bandwidth.Lowest`.
+   */
+  BANDWIDTH_LOWEST: Bandwidth;
+  /**
+   * Alias of `Bandwidth.Highest`.
+   */
+  BANDWIDTH_HIGHEST: Bandwidth;
+  /**
+   * Alias of `FrameType.Progressive`.
+   */
+  FORMAT_TYPE_PROGRESSIVE: FrameType;
+  /**
+   * Alias of `FrameType.Interlaced`.
+   */
+  FORMAT_TYPE_INTERLACED: FrameType;
+  /**
+   * Alias of `FrameType.Field0`.
+   */
+  FORMAT_TYPE_FIELD_0: FrameType;
+  /**
+   * Alias of `FrameType.Field1`.
+   */
+  FORMAT_TYPE_FIELD_1: FrameType;
+  /**
+   * Alias of `AudioFormat.Float32Separate`.
+   */
+  AUDIO_FORMAT_FLOAT_32_SEPARATE: AudioFormat;
+  /**
+   * Alias of `AudioFormat.Float32Interleaved`.
+   */
+  AUDIO_FORMAT_FLOAT_32_INTERLEAVED: AudioFormat;
+  /**
+   * Alias of `AudioFormat.Int16Interleaved`.
+   */
+  AUDIO_FORMAT_INT_16_INTERLEAVED: AudioFormat;
+  /**
+   * Alias of `FourCC.UYVY`.
+   */
+  FOURCC_UYVY: FourCC;
+  /**
+   * Alias of `FourCC.UYVA`.
+   */
+  FOURCC_UYVA: FourCC;
+  /**
+   * Alias of `FourCC.P216`.
+   */
+  FOURCC_P216: FourCC;
+  /**
+   * Alias of `FourCC.PA16`.
+   */
+  FOURCC_PA16: FourCC;
+  /**
+   * Alias of `FourCC.YV12`.
+   */
+  FOURCC_YV12: FourCC;
+  /**
+   * Alias of `FourCC.I420`.
+   */
+  FOURCC_I420: FourCC;
+  /**
+   * Alias of `FourCC.NV12`.
+   */
+  FOURCC_NV12: FourCC;
+  /**
+   * Alias of `FourCC.BGRA`.
+   */
+  FOURCC_BGRA: FourCC;
+  /**
+   * Alias of `FourCC.BGRX`.
+   */
+  FOURCC_BGRX: FourCC;
+  /**
+   * Alias of `FourCC.RGBA`.
+   */
+  FOURCC_RGBA: FourCC;
+  /**
+   * Alias of `FourCC.RGBX`.
+   */
+  FOURCC_RGBX: FourCC;
+  /**
+   * Alias of `FourCC.FLTp`.
+   */
+  FOURCC_FLTp: FourCC;
+}
+//#endregion
+//#region src/index.d.ts
+interface GrandiAddon {
+  version(): string;
+  isSupportedCPU(): boolean;
+  initialize(): boolean;
+  destroy(): boolean;
+  find(params?: FindOptions): Promise<Finder>;
+  receive(params: ReceiveOptions): Promise<Receiver>;
+  framesync(receiver: Receiver): Promise<FrameSync>;
+  send(params: SendOptions): Promise<Sender>;
+  routing(params: {
+    name?: string;
+    groups?: string;
+  }): Promise<Routing>;
+}
+/**
+ * Creates a finder to discover NDI sources on the network.
+ * @param {FindOptions} [params={}] - Options for finding sources.
+ * @param {boolean} [params.showLocalSources] - Whether to show local sources.
+ * @param {string} [params.groups] - Multicast groups to search in.
+ * @param {string} [params.extraIPs] - Additional IP addresses to search.
+ * @returns {Promise<Finder>} A promise that resolves to a Finder instance for discovering sources.
+ * @throws {Error} Promise rejects on unsupported platform/CPU or if the finder cannot be created.
+ *
+ * @example
+ * ```js
+ * import { find, initialize } from "grandi";
+ * initialize();
+ * const finder = await find({ showLocalSources: true });
+ * finder.wait(1000);
+ * console.log(finder.sources());
+ * finder.destroy();
+ * ```
+ */
+declare function find(params?: FindOptions): Promise<Finder>;
+/**
+ * Gets the version of the NDI SDK.
+ * @returns {string} The NDI SDK version string.
+ */
+declare const version: () => string;
+/**
+ * Checks if the current CPU architecture is supported by NDI.
+ * @returns {boolean} True if the CPU is supported, false otherwise.
+ */
+declare const isSupportedCPU: () => boolean;
+/**
+ * Initializes the NDI library. Must be called before using any other NDI functions.
+ * @returns {boolean} True if initialization was successful, false otherwise.
+ *
+ * @example
+ * ```js
+ * import { initialize } from "grandi";
+ * if (!initialize()) throw new Error("NDI init failed");
+ * ```
+ */
+declare const initialize: () => boolean;
+/**
+ * Destroys the NDI library instance and cleans up resources.
+ * Should be called when done using NDI to free resources.
+ * @returns {boolean} True if destruction was successful, false otherwise.
+ *
+ * @example
+ * ```js
+ * import { destroy } from "grandi";
+ * destroy();
+ * ```
+ */
+declare const destroy: () => boolean;
+/**
+ * Creates an NDI sender for transmitting video and audio over the network.
+ * @param {SendOptions} params - Options for creating the sender.
+ * @param {string} params.name - The name of the NDI source.
+ * @param {string} [params.groups] - Multicast groups to send to.
+ * @param {boolean} [params.clockVideo] - Whether to clock video frames.
+ * @param {boolean} [params.clockAudio] - Whether to clock audio frames.
+ * @returns {Promise<Sender>} A promise that resolves to a Sender instance for transmitting data.
+ * @throws {Error} Promise rejects on unsupported platform/CPU or if sender creation fails.
+ *
+ * @example
+ * ```js
+ * import { initialize, send } from "grandi";
+ * initialize();
+ * const sender = await send({ name: "My Source" });
+ * // sender.video(...) / sender.audio(...)
+ * sender.destroy();
+ * ```
+ */
+declare const send: (params: SendOptions) => Promise<Sender>;
+/**
+ * Creates an NDI receiver for receiving video and audio from an NDI source.
+ * @param {ReceiveOptions} params - Options for creating the receiver.
+ * @param {ReceiveOptions["source"]} params.source - The NDI source to connect to.
+ * @param {ReceiveOptions["colorFormat"]} [params.colorFormat] - The color format for received video.
+ * @param {ReceiveOptions["bandwidth"]} [params.bandwidth] - The bandwidth limitation for the connection.
+ * @param {boolean} [params.allowVideoFields] - Whether to allow video fields.
+ * @param {string} [params.name] - The name for the receiver.
+ * @returns {Promise<Receiver>} A promise that resolves to a Receiver instance for receiving data.
+ * @throws {Error} Promise rejects on unsupported platform/CPU or if receiver creation fails.
+ *
+ * @example
+ * ```js
+ * import { find, initialize, receive } from "grandi";
+ * initialize();
+ * const finder = await find({ showLocalSources: true });
+ * finder.wait(1000);
+ * const source = finder.sources()[0];
+ * finder.destroy();
+ * const receiver = await receive({ source });
+ * const frame = await receiver.video(1000);
+ * receiver.destroy();
+ * ```
+ */
+declare const receive: (params: ReceiveOptions) => Promise<Receiver>;
+/**
+ * Creates an NDI frame-synchronizer (time base corrector) backed by an existing receiver.
+ * Use this when you want smooth playback clocked to your own render/audio loop.
+ *
+ * Note: destroy the frame-sync before destroying the receiver.
+ * @param {Receiver} receiver - The receiver instance to frame-sync.
+ * @returns {Promise<FrameSync>} A promise that resolves to a FrameSync instance.
+ * @throws {Error} Promise rejects on unsupported platform/CPU or if framesync creation fails.
+ *
+ * @example
+ * ```js
+ * import grandi from "grandi";
+ * grandi.initialize();
+ * const receiver = await grandi.receive({ source });
+ * const fs = await grandi.framesync(receiver);
+ * const frame = await fs.video(grandi.FrameType.Progressive);
+ * fs.destroy();
+ * receiver.destroy();
+ * ```
+ */
+declare const framesync: (receiver: Receiver) => Promise<FrameSync>;
+/**
+ * Creates an NDI router for switching between different NDI sources.
+ * @param {Object} params - Options for creating the router.
+ * @param {string} [params.name] - The name for the router.
+ * @param {string} [params.groups] - Multicast groups for the router.
+ * @returns {Promise<Routing>} A promise that resolves to a Routing instance for source switching.
+ * @throws {Error} Promise rejects on unsupported platform/CPU or if routing creation fails.
+ *
+ * @example
+ * ```js
+ * import { initialize, routing } from "grandi";
+ * initialize();
+ * const router = await routing({ name: "My Router" });
+ * // router.change(source)
+ * router.destroy();
+ * ```
+ */
+declare const routing: (params: {
+  name?: string;
+  groups?: string;
+}) => Promise<Routing>;
+declare const grandi: Grandi;
+//#endregion
+export { AudioFormat, type AudioFrame, type AudioReceiveOptions, Bandwidth, ColorFormat, type FindOptions, type Finder, FourCC, type FrameSync, type FrameSyncAudioOptions, FrameType, type Grandi, GrandiAddon, type PtpTimestamp, type ReceiveOptions, type ReceivedAudioFrame, type ReceivedMetadataFrame, type ReceivedVideoFrame, type ReceiverDataFrame, type ReceiverTallyState, type Routing, type Sender, type SenderTally, type Source, type SourceChangeEvent, type StatusChangeEvent, type Timecode, type TimeoutEvent, type VideoFrame, grandi as default, destroy, find, framesync, initialize, isSupportedCPU, receive, routing, send, version };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,332 @@
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import nodeGypBuild from "node-gyp-build";
+
+//#region rolldown:runtime
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+//#region node_modules/tsdown/esm-shims.js
+const getFilename = () => fileURLToPath(import.meta.url);
+const getDirname = () => path.dirname(getFilename());
+const __dirname = /* @__PURE__ */ getDirname();
+
+//#endregion
+//#region src/types.ts
+let FrameType = /* @__PURE__ */ function(FrameType$1) {
+	FrameType$1[FrameType$1["Interlaced"] = 0] = "Interlaced";
+	FrameType$1[FrameType$1["Progressive"] = 1] = "Progressive";
+	FrameType$1[FrameType$1["Field0"] = 2] = "Field0";
+	FrameType$1[FrameType$1["Field1"] = 3] = "Field1";
+	return FrameType$1;
+}({});
+let ColorFormat = /* @__PURE__ */ function(ColorFormat$1) {
+	ColorFormat$1[ColorFormat$1["BGRX_BGRA"] = 0] = "BGRX_BGRA";
+	ColorFormat$1[ColorFormat$1["UYVY_BGRA"] = 1] = "UYVY_BGRA";
+	ColorFormat$1[ColorFormat$1["RGBX_RGBA"] = 2] = "RGBX_RGBA";
+	ColorFormat$1[ColorFormat$1["UYVY_RGBA"] = 3] = "UYVY_RGBA";
+	ColorFormat$1[ColorFormat$1["Fastest"] = 100] = "Fastest";
+	ColorFormat$1[ColorFormat$1["Best"] = 101] = "Best";
+	ColorFormat$1[ColorFormat$1["BGRX_BGRA_FLIPPED"] = 1e3] = "BGRX_BGRA_FLIPPED";
+	return ColorFormat$1;
+}({});
+let AudioFormat = /* @__PURE__ */ function(AudioFormat$1) {
+	AudioFormat$1[AudioFormat$1["Float32Separate"] = 0] = "Float32Separate";
+	AudioFormat$1[AudioFormat$1["Float32Interleaved"] = 1] = "Float32Interleaved";
+	AudioFormat$1[AudioFormat$1["Int16Interleaved"] = 2] = "Int16Interleaved";
+	return AudioFormat$1;
+}({});
+let Bandwidth = /* @__PURE__ */ function(Bandwidth$1) {
+	Bandwidth$1[Bandwidth$1["MetadataOnly"] = -10] = "MetadataOnly";
+	Bandwidth$1[Bandwidth$1["AudioOnly"] = 10] = "AudioOnly";
+	Bandwidth$1[Bandwidth$1["Lowest"] = 0] = "Lowest";
+	Bandwidth$1[Bandwidth$1["Highest"] = 100] = "Highest";
+	return Bandwidth$1;
+}({});
+let FourCC = /* @__PURE__ */ function(FourCC$1) {
+	FourCC$1[FourCC$1["UYVY"] = 1498831189] = "UYVY";
+	FourCC$1[FourCC$1["UYVA"] = 1096178005] = "UYVA";
+	FourCC$1[FourCC$1["P216"] = 909193808] = "P216";
+	FourCC$1[FourCC$1["PA16"] = 909197648] = "PA16";
+	FourCC$1[FourCC$1["YV12"] = 842094169] = "YV12";
+	FourCC$1[FourCC$1["I420"] = 808596553] = "I420";
+	FourCC$1[FourCC$1["NV12"] = 842094158] = "NV12";
+	FourCC$1[FourCC$1["BGRA"] = 1095911234] = "BGRA";
+	FourCC$1[FourCC$1["BGRX"] = 1481787202] = "BGRX";
+	FourCC$1[FourCC$1["RGBA"] = 1094862674] = "RGBA";
+	FourCC$1[FourCC$1["RGBX"] = 1480738642] = "RGBX";
+	FourCC$1[FourCC$1["FLTp"] = 1884572742] = "FLTp";
+	return FourCC$1;
+}({});
+
+//#endregion
+//#region src/index.ts
+/**
+* Checks if the current platform and architecture are supported by NDI.
+* @returns {boolean} True if the platform is supported (darwin, linux, or win32 with ia32/x64), false otherwise.
+*/
+function isSupportedPlatform() {
+	return process.platform === "darwin" || process.platform === "linux" || process.platform === "win32" && ["ia32", "x64"].includes(process.arch);
+}
+function tryRequireArchPackage() {
+	const archKey = `${process.platform}-${process.arch}`;
+	const pkg = {
+		"linux-x64": "@grandi/linux-x64",
+		"linux-arm64": "@grandi/linux-arm64",
+		"linux-arm": "@grandi/linux-armv7l",
+		"win32-x64": "@grandi/win32-x64",
+		"win32-ia32": "@grandi/win32-ia32",
+		"darwin-x64": "@grandi/darwin-universal",
+		"darwin-arm64": "@grandi/darwin-universal"
+	}[archKey];
+	if (!pkg) throw new Error(`Unsupported platform or architecture: ${archKey}`);
+	try {
+		return __require(pkg);
+	} catch {
+		throw new Error(`Failed to find prebuilt package for ${archKey}. Please ensure that the package "${pkg}" is installed`);
+	}
+}
+function loadAddon() {
+	const loadErrors = [];
+	if (!isSupportedPlatform()) {
+		console.error(`Unsupported platform or architecture: ${process.platform}-${process.arch}`);
+		return noopAddon;
+	}
+	try {
+		const localBinding = nodeGypBuild(path.join(__dirname, ".."));
+		if (localBinding) return localBinding;
+	} catch (err) {
+		loadErrors.push(err);
+	}
+	try {
+		const archAddon = tryRequireArchPackage();
+		if (archAddon) return archAddon;
+	} catch (err) {
+		loadErrors.push(err);
+	}
+	if (loadErrors.length > 0) {
+		const aggregateError = /* @__PURE__ */ new Error("Failed to load native addon:\n" + loadErrors.map((e, i) => `  [${i + 1}] ${e.message}`).join("\n"));
+		console.error(aggregateError);
+	}
+	return noopAddon;
+}
+const noopAddon = {
+	version() {
+		return "";
+	},
+	isSupportedCPU() {
+		return false;
+	},
+	initialize() {
+		return false;
+	},
+	destroy() {
+		return false;
+	},
+	send(_params) {
+		return Promise.reject(/* @__PURE__ */ new Error("Unsupported platform or CPU"));
+	},
+	receive(_params) {
+		return Promise.reject(/* @__PURE__ */ new Error("Unsupported platform or CPU"));
+	},
+	framesync(_receiver) {
+		return Promise.reject(/* @__PURE__ */ new Error("Unsupported platform or CPU"));
+	},
+	routing() {
+		return Promise.reject(/* @__PURE__ */ new Error("Unsupported platform or CPU"));
+	},
+	find(_params) {
+		return Promise.reject(/* @__PURE__ */ new Error("Unsupported platform or CPU"));
+	}
+};
+const addon = loadAddon();
+/**
+* Creates a finder to discover NDI sources on the network.
+* @param {FindOptions} [params={}] - Options for finding sources.
+* @param {boolean} [params.showLocalSources] - Whether to show local sources.
+* @param {string} [params.groups] - Multicast groups to search in.
+* @param {string} [params.extraIPs] - Additional IP addresses to search.
+* @returns {Promise<Finder>} A promise that resolves to a Finder instance for discovering sources.
+* @throws {Error} Promise rejects on unsupported platform/CPU or if the finder cannot be created.
+*
+* @example
+* ```js
+* import { find, initialize } from "grandi";
+* initialize();
+* const finder = await find({ showLocalSources: true });
+* finder.wait(1000);
+* console.log(finder.sources());
+* finder.destroy();
+* ```
+*/
+function find(params = {}) {
+	return addon.find(params);
+}
+/**
+* Gets the version of the NDI SDK.
+* @returns {string} The NDI SDK version string.
+*/
+const version = addon.version;
+/**
+* Checks if the current CPU architecture is supported by NDI.
+* @returns {boolean} True if the CPU is supported, false otherwise.
+*/
+const isSupportedCPU = addon.isSupportedCPU;
+/**
+* Initializes the NDI library. Must be called before using any other NDI functions.
+* @returns {boolean} True if initialization was successful, false otherwise.
+*
+* @example
+* ```js
+* import { initialize } from "grandi";
+* if (!initialize()) throw new Error("NDI init failed");
+* ```
+*/
+const initialize = addon.initialize;
+/**
+* Destroys the NDI library instance and cleans up resources.
+* Should be called when done using NDI to free resources.
+* @returns {boolean} True if destruction was successful, false otherwise.
+*
+* @example
+* ```js
+* import { destroy } from "grandi";
+* destroy();
+* ```
+*/
+const destroy = addon.destroy;
+/**
+* Creates an NDI sender for transmitting video and audio over the network.
+* @param {SendOptions} params - Options for creating the sender.
+* @param {string} params.name - The name of the NDI source.
+* @param {string} [params.groups] - Multicast groups to send to.
+* @param {boolean} [params.clockVideo] - Whether to clock video frames.
+* @param {boolean} [params.clockAudio] - Whether to clock audio frames.
+* @returns {Promise<Sender>} A promise that resolves to a Sender instance for transmitting data.
+* @throws {Error} Promise rejects on unsupported platform/CPU or if sender creation fails.
+*
+* @example
+* ```js
+* import { initialize, send } from "grandi";
+* initialize();
+* const sender = await send({ name: "My Source" });
+* // sender.video(...) / sender.audio(...)
+* sender.destroy();
+* ```
+*/
+const send = addon.send;
+/**
+* Creates an NDI receiver for receiving video and audio from an NDI source.
+* @param {ReceiveOptions} params - Options for creating the receiver.
+* @param {ReceiveOptions["source"]} params.source - The NDI source to connect to.
+* @param {ReceiveOptions["colorFormat"]} [params.colorFormat] - The color format for received video.
+* @param {ReceiveOptions["bandwidth"]} [params.bandwidth] - The bandwidth limitation for the connection.
+* @param {boolean} [params.allowVideoFields] - Whether to allow video fields.
+* @param {string} [params.name] - The name for the receiver.
+* @returns {Promise<Receiver>} A promise that resolves to a Receiver instance for receiving data.
+* @throws {Error} Promise rejects on unsupported platform/CPU or if receiver creation fails.
+*
+* @example
+* ```js
+* import { find, initialize, receive } from "grandi";
+* initialize();
+* const finder = await find({ showLocalSources: true });
+* finder.wait(1000);
+* const source = finder.sources()[0];
+* finder.destroy();
+* const receiver = await receive({ source });
+* const frame = await receiver.video(1000);
+* receiver.destroy();
+* ```
+*/
+const receive = addon.receive;
+/**
+* Creates an NDI frame-synchronizer (time base corrector) backed by an existing receiver.
+* Use this when you want smooth playback clocked to your own render/audio loop.
+*
+* Note: destroy the frame-sync before destroying the receiver.
+* @param {Receiver} receiver - The receiver instance to frame-sync.
+* @returns {Promise<FrameSync>} A promise that resolves to a FrameSync instance.
+* @throws {Error} Promise rejects on unsupported platform/CPU or if framesync creation fails.
+*
+* @example
+* ```js
+* import grandi from "grandi";
+* grandi.initialize();
+* const receiver = await grandi.receive({ source });
+* const fs = await grandi.framesync(receiver);
+* const frame = await fs.video(grandi.FrameType.Progressive);
+* fs.destroy();
+* receiver.destroy();
+* ```
+*/
+const framesync = addon.framesync;
+/**
+* Creates an NDI router for switching between different NDI sources.
+* @param {Object} params - Options for creating the router.
+* @param {string} [params.name] - The name for the router.
+* @param {string} [params.groups] - Multicast groups for the router.
+* @returns {Promise<Routing>} A promise that resolves to a Routing instance for source switching.
+* @throws {Error} Promise rejects on unsupported platform/CPU or if routing creation fails.
+*
+* @example
+* ```js
+* import { initialize, routing } from "grandi";
+* initialize();
+* const router = await routing({ name: "My Router" });
+* // router.change(source)
+* router.destroy();
+* ```
+*/
+const routing = addon.routing;
+const grandi = {
+	version,
+	isSupportedCPU,
+	initialize,
+	destroy,
+	send,
+	receive,
+	framesync,
+	routing,
+	find,
+	ColorFormat,
+	AudioFormat,
+	Bandwidth,
+	FrameType,
+	FourCC,
+	COLOR_FORMAT_BGRX_BGRA: ColorFormat.BGRX_BGRA,
+	COLOR_FORMAT_UYVY_BGRA: ColorFormat.UYVY_BGRA,
+	COLOR_FORMAT_RGBX_RGBA: ColorFormat.RGBX_RGBA,
+	COLOR_FORMAT_UYVY_RGBA: ColorFormat.UYVY_RGBA,
+	COLOR_FORMAT_FASTEST: ColorFormat.Fastest,
+	COLOR_FORMAT_BGRX_BGRA_FLIPPED: ColorFormat.BGRX_BGRA_FLIPPED,
+	BANDWIDTH_METADATA_ONLY: Bandwidth.MetadataOnly,
+	BANDWIDTH_AUDIO_ONLY: Bandwidth.AudioOnly,
+	BANDWIDTH_LOWEST: Bandwidth.Lowest,
+	BANDWIDTH_HIGHEST: Bandwidth.Highest,
+	FORMAT_TYPE_PROGRESSIVE: FrameType.Progressive,
+	FORMAT_TYPE_INTERLACED: FrameType.Interlaced,
+	FORMAT_TYPE_FIELD_0: FrameType.Field0,
+	FORMAT_TYPE_FIELD_1: FrameType.Field1,
+	AUDIO_FORMAT_FLOAT_32_SEPARATE: AudioFormat.Float32Separate,
+	AUDIO_FORMAT_FLOAT_32_INTERLEAVED: AudioFormat.Float32Interleaved,
+	AUDIO_FORMAT_INT_16_INTERLEAVED: AudioFormat.Int16Interleaved,
+	FOURCC_UYVY: FourCC.UYVY,
+	FOURCC_UYVA: FourCC.UYVA,
+	FOURCC_P216: FourCC.P216,
+	FOURCC_PA16: FourCC.PA16,
+	FOURCC_YV12: FourCC.YV12,
+	FOURCC_I420: FourCC.I420,
+	FOURCC_NV12: FourCC.NV12,
+	FOURCC_BGRA: FourCC.BGRA,
+	FOURCC_BGRX: FourCC.BGRX,
+	FOURCC_RGBA: FourCC.RGBA,
+	FOURCC_RGBX: FourCC.RGBX,
+	FOURCC_FLTp: FourCC.FLTp
+};
+var src_default = grandi;
+
+//#endregion
+export { AudioFormat, Bandwidth, ColorFormat, FourCC, FrameType, src_default as default, destroy, find, framesync, initialize, isSupportedCPU, receive, routing, send, version };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["loadErrors: Error[]","noopAddon: GrandiAddon","addon: GrandiAddon","grandi: Grandi"],"sources":["../node_modules/tsdown/esm-shims.js","../src/types.ts","../src/index.ts"],"sourcesContent":["// Shim globals in esm bundle\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nconst getFilename = () => fileURLToPath(import.meta.url)\nconst getDirname = () => path.dirname(getFilename())\n\nexport const __dirname = /* @__PURE__ */ getDirname()\nexport const __filename = /* @__PURE__ */ getFilename()\n","export enum FrameType {\n\tInterlaced = 0,\n\tProgressive = 1,\n\tField0 = 2,\n\tField1 = 3,\n}\n\nexport enum ColorFormat {\n\tBGRX_BGRA = 0,\n\tUYVY_BGRA = 1,\n\tRGBX_RGBA = 2,\n\tUYVY_RGBA = 3,\n\tFastest = 100,\n\tBest = 101,\n\t// Windows-only NDI SDK extension: 1000 + BGRX_BGRA.\n\tBGRX_BGRA_FLIPPED = 1000,\n}\n\nexport enum AudioFormat {\n\tFloat32Separate = 0,\n\tFloat32Interleaved = 1,\n\tInt16Interleaved = 2,\n}\n\nexport enum Bandwidth {\n\tMetadataOnly = -10,\n\tAudioOnly = 10,\n\tLowest = 0,\n\tHighest = 100,\n}\n\nexport enum FourCC {\n\tUYVY = 1498831189,\n\tUYVA = 1096178005,\n\tP216 = 909193808,\n\tPA16 = 909197648,\n\tYV12 = 842094169,\n\tI420 = 808596553,\n\tNV12 = 842094158,\n\tBGRA = 1095911234,\n\tBGRX = 1481787202,\n\tRGBA = 1094862674,\n\tRGBX = 1480738642,\n\tFLTp = 1884572742,\n}\n\nexport type PtpTimestamp = [number, number]; // [seconds, nanoseconds]\nexport type Timecode = bigint | number | PtpTimestamp;\n\nexport interface Source {\n\tname: string;\n\turlAddress?: string;\n}\n\nexport interface VideoFrame {\n\ttype?: \"video\";\n\txres: number;\n\tyres: number;\n\tframeRateN: number;\n\tframeRateD: number;\n\tpictureAspectRatio: number;\n\tfourCC: FourCC;\n\tframeFormatType: FrameType;\n\tlineStrideBytes: number;\n\tdata: Buffer;\n\ttimecode?: Timecode;\n\t/**\n\t * Receive-only timestamp filled by the NDI SDK (UTC time, 100ns units under the hood).\n\t * NDI ignores this field when sending.\n\t */\n\ttimestamp?: PtpTimestamp;\n\tmetadata?: string;\n}\n\nexport interface ReceivedVideoFrame extends VideoFrame {\n\ttype: \"video\";\n\ttimecode: PtpTimestamp;\n\ttimestamp: PtpTimestamp;\n\tmetadata?: string;\n}\n\nexport interface AudioFrame {\n\ttype?: \"audio\";\n\tsampleRate: number;\n\tnoChannels: number;\n\tnoSamples: number;\n\tchannelStrideBytes: number;\n\tdata: Buffer;\n\tfourCC: FourCC;\n\ttimecode?: Timecode;\n\t/**\n\t * Receive-only timestamp filled by the NDI SDK (UTC time, 100ns units under the hood).\n\t * NDI ignores this field when sending.\n\t */\n\ttimestamp?: PtpTimestamp;\n\tmetadata?: string;\n}\n\nexport interface ReceivedAudioFrame {\n\ttype: \"audio\";\n\taudioFormat: AudioFormat;\n\treferenceLevel?: number;\n\tsampleRate: number;\n\tchannels: number;\n\tsamples: number;\n\tchannelStrideInBytes: number;\n\tdata: Buffer;\n\ttimecode: PtpTimestamp;\n\ttimestamp: PtpTimestamp;\n\tmetadata?: string;\n}\n\nexport interface ReceivedMetadataFrame {\n\ttype: \"metadata\";\n\tlength: number;\n\ttimecode: PtpTimestamp;\n\ttimestamp: PtpTimestamp;\n\tdata: string;\n}\n\nexport interface SourceChangeEvent {\n\ttype: \"sourceChange\";\n}\n\nexport interface StatusChangeEvent {\n\ttype: \"statusChange\";\n}\n\nexport interface TimeoutEvent {\n\ttype: \"timeout\";\n}\n\nexport type ReceiverDataFrame =\n\t| ReceivedVideoFrame\n\t| ReceivedAudioFrame\n\t| ReceivedMetadataFrame\n\t| SourceChangeEvent\n\t| StatusChangeEvent\n\t| TimeoutEvent;\n\nexport interface AudioReceiveOptions {\n\taudioFormat?: AudioFormat;\n\treferenceLevel?: number;\n}\n\nexport interface Receiver {\n\tembedded: unknown;\n\tsource: Source;\n\tcolorFormat: ColorFormat;\n\tbandwidth: Bandwidth;\n\tallowVideoFields: boolean;\n\tname?: string;\n\tvideo(timeoutMs?: number): Promise<ReceivedVideoFrame>;\n\taudio(timeoutMs?: number): Promise<ReceivedAudioFrame>;\n\taudio(\n\t\toptions: AudioReceiveOptions,\n\t\ttimeoutMs?: number,\n\t): Promise<ReceivedAudioFrame>;\n\tmetadata(timeoutMs?: number): Promise<ReceivedMetadataFrame>;\n\tdata(timeoutMs?: number): Promise<ReceiverDataFrame>;\n\tdata(\n\t\toptions: AudioReceiveOptions,\n\t\ttimeoutMs?: number,\n\t): Promise<ReceiverDataFrame>;\n\ttally(state: ReceiverTallyState): boolean;\n\tdestroy(): boolean;\n}\n\nexport interface ReceiverTallyState {\n\tonProgram?: boolean;\n\tonPreview?: boolean;\n}\n\nexport interface SenderTally {\n\tchanged: boolean;\n\ton_program: boolean;\n\ton_preview: boolean;\n}\n\nexport interface Sender {\n\tembedded: unknown;\n\tname: string;\n\tgroups?: string;\n\tclockVideo: boolean;\n\tclockAudio: boolean;\n\tvideo(frame: VideoFrame): Promise<void>;\n\taudio(frame: AudioFrame): Promise<void>;\n\tconnections(): number;\n\tmetadata(data: string): boolean;\n\ttally(): SenderTally;\n\tsourcename(): string;\n\tdestroy(): boolean;\n}\n\nexport interface Routing {\n\tembedded: unknown;\n\tname?: string;\n\tgroups?: string;\n\tdestroy(): boolean;\n\tchange(source: Source): boolean;\n\tclear(): boolean;\n\tconnections(): number;\n\tsourcename(): string;\n}\n\nexport interface FrameSyncAudioOptions {\n\tsampleRate?: number;\n\tnoChannels?: number;\n\tnoSamples?: number;\n}\n\nexport interface FrameSync {\n\tembedded: unknown;\n\t/**\n\t * Captures a video frame using NDI frame-synchronization (time base correction).\n\t * Always returns immediately.\n\t *\n\t * If no video has ever been received, resolves with `{ type: \"timeout\" }`.\n\t */\n\tvideo(fieldType?: FrameType): Promise<ReceivedVideoFrame | TimeoutEvent>;\n\t/**\n\t * Captures audio using NDI frame-synchronization (resampled to match your calls).\n\t * Always returns immediately and may insert silence if no audio is present.\n\t */\n\taudio(options?: FrameSyncAudioOptions): Promise<ReceivedAudioFrame>;\n\t/**\n\t * Returns an approximate depth of the internal audio queue in samples.\n\t */\n\taudioQueueDepth(): number;\n\tdestroy(): boolean;\n}\n\nexport interface Finder {\n\tsources(): Source[];\n\twait(timeoutMs?: number): boolean;\n\tdestroy(): boolean;\n}\n\nexport interface FindOptions {\n\tshowLocalSources?: boolean;\n\tgroups?: string;\n\textraIPs?: string;\n}\n\nexport interface ReceiveOptions {\n\tsource: Source;\n\tcolorFormat?: ColorFormat;\n\tbandwidth?: Bandwidth;\n\t/**\n\t * If `colorFormat` is `ColorFormat.Fastest` or `ColorFormat.Best`, the NDI SDK\n\t * implicitly enables video fields and this option is forced to `true`.\n\t */\n\tallowVideoFields?: boolean;\n\tname?: string;\n}\n\nexport interface SendOptions {\n\tname: string;\n\tgroups?: string;\n\tclockVideo?: boolean;\n\tclockAudio?: boolean;\n}\n\nexport interface Grandi {\n\t/**\n\t * Gets the NDI SDK version string (e.g. `\"NDI SDK 6.0.0.0\"`).\n\t * @returns The NDI SDK version string.\n\t *\n\t * @example\n\t * ```js\n\t * import grandi from \"grandi\";\n\t * console.log(grandi.version());\n\t * ```\n\t */\n\tversion(): string;\n\t/**\n\t * Checks if the current CPU architecture is supported by NDI.\n\t * @returns `true` when NDI is supported on this CPU/platform.\n\t *\n\t * @example\n\t * ```js\n\t * import grandi from \"grandi\";\n\t * if (!grandi.isSupportedCPU()) throw new Error(\"NDI unsupported here\");\n\t * ```\n\t */\n\tisSupportedCPU(): boolean;\n\t/**\n\t * Initializes the NDI library. Must be called before using any other NDI functions.\n\t * Call this once per process, before creating senders/receivers/finders.\n\t * @returns `true` if initialization was successful.\n\t *\n\t * @example\n\t * ```js\n\t * import grandi from \"grandi\";\n\t * if (!grandi.initialize()) throw new Error(\"NDI init failed\");\n\t * ```\n\t */\n\tinitialize(): boolean;\n\t/**\n\t * Destroys the NDI library instance and cleans up resources.\n\t * Should be called when done using NDI to free resources.\n\t * @returns `true` if destruction was successful.\n\t *\n\t * @example\n\t * ```js\n\t * import grandi from \"grandi\";\n\t * grandi.destroy();\n\t * ```\n\t */\n\tdestroy(): boolean;\n\t/**\n\t * Creates an NDI sender for transmitting video and audio over the network.\n\t * @param params Sender options.\n\t * @returns A promise that resolves to a Sender instance.\n\t * @throws {Error} Promise rejects on unsupported platform/CPU or if sender creation fails.\n\t *\n\t * @example\n\t * ```js\n\t * import grandi from \"grandi\";\n\t * grandi.initialize();\n\t * const sender = await grandi.send({ name: \"My Source\" });\n\t * ```\n\t */\n\tsend(params: SendOptions): Promise<Sender>;\n\t/**\n\t * Creates an NDI receiver for receiving video and audio from an NDI source.\n\t * @param params Receiver options.\n\t * @returns A promise that resolves to a Receiver instance.\n\t * @throws {Error} Promise rejects on unsupported platform/CPU or if receiver creation fails.\n\t *\n\t * @example\n\t * ```js\n\t * import grandi from \"grandi\";\n\t * grandi.initialize();\n\t * const finder = await grandi.find({ showLocalSources: true });\n\t * finder.wait(1000);\n\t * const source = finder.sources()[0];\n\t * finder.destroy();\n\t * const receiver = await grandi.receive({ source });\n\t * const frame = await receiver.video(1000);\n\t * receiver.destroy();\n\t * ```\n\t */\n\treceive(params: ReceiveOptions): Promise<Receiver>;\n\t/**\n\t * Creates an NDI frame-synchronizer (time base corrector) backed by an existing receiver.\n\t * Use this when you want smooth playback clocked to your own render/audio loop.\n\t *\n\t * Note: destroy the frame-sync before destroying the receiver.\n\t */\n\tframesync(receiver: Receiver): Promise<FrameSync>;\n\t/**\n\t * Creates an NDI router for switching between different NDI sources.\n\t * @param params Router options.\n\t * @returns A promise that resolves to a Routing instance.\n\t * @throws {Error} Promise rejects on unsupported platform/CPU or if routing creation fails.\n\t *\n\t * @example\n\t * ```js\n\t * import grandi from \"grandi\";\n\t * grandi.initialize();\n\t * const router = await grandi.routing({ name: \"My Router\" });\n\t * // router.change(source) to route a discovered source\n\t * router.destroy();\n\t * ```\n\t */\n\trouting(params: { name?: string; groups?: string }): Promise<Routing>;\n\t/**\n\t * Creates a finder to discover NDI sources on the network.\n\t * @param params Discovery options.\n\t * @returns A promise that resolves to a Finder instance.\n\t * @throws {Error} Promise rejects on unsupported platform/CPU or if the finder cannot be created.\n\t *\n\t * @example\n\t * ```js\n\t * import grandi from \"grandi\";\n\t * grandi.initialize();\n\t * const finder = await grandi.find({ showLocalSources: true });\n\t * finder.wait(1000);\n\t * console.log(finder.sources());\n\t * finder.destroy();\n\t * ```\n\t */\n\tfind(params?: FindOptions): Promise<Finder>;\n\n\t/**\n\t * Enum: receiver video color formats.\n\t */\n\tColorFormat: typeof ColorFormat;\n\t/**\n\t * Enum: supported raw audio formats for helpers/receive conversions.\n\t */\n\tAudioFormat: typeof AudioFormat;\n\t/**\n\t * Enum: receiver bandwidth modes.\n\t */\n\tBandwidth: typeof Bandwidth;\n\t/**\n\t * Enum: video frame format types (progressive/interlaced/fields).\n\t */\n\tFrameType: typeof FrameType;\n\t/**\n\t * Enum: FourCC pixel/audio formats used in frames.\n\t */\n\tFourCC: typeof FourCC;\n\n\t// Constant aliases for backwards compatibility / convenience.\n\t/**\n\t * Alias of `ColorFormat.BGRX_BGRA`.\n\t */\n\tCOLOR_FORMAT_BGRX_BGRA: ColorFormat;\n\t/**\n\t * Alias of `ColorFormat.UYVY_BGRA`.\n\t */\n\tCOLOR_FORMAT_UYVY_BGRA: ColorFormat;\n\t/**\n\t * Alias of `ColorFormat.RGBX_RGBA`.\n\t */\n\tCOLOR_FORMAT_RGBX_RGBA: ColorFormat;\n\t/**\n\t * Alias of `ColorFormat.UYVY_RGBA`.\n\t */\n\tCOLOR_FORMAT_UYVY_RGBA: ColorFormat;\n\t/**\n\t * Alias of `ColorFormat.Fastest`.\n\t */\n\tCOLOR_FORMAT_FASTEST: ColorFormat;\n\t/**\n\t * Alias of `ColorFormat.BGRX_BGRA_FLIPPED` (Windows-only).\n\t */\n\tCOLOR_FORMAT_BGRX_BGRA_FLIPPED: ColorFormat;\n\n\t/**\n\t * Alias of `Bandwidth.MetadataOnly`.\n\t */\n\tBANDWIDTH_METADATA_ONLY: Bandwidth;\n\t/**\n\t * Alias of `Bandwidth.AudioOnly`.\n\t */\n\tBANDWIDTH_AUDIO_ONLY: Bandwidth;\n\t/**\n\t * Alias of `Bandwidth.Lowest`.\n\t */\n\tBANDWIDTH_LOWEST: Bandwidth;\n\t/**\n\t * Alias of `Bandwidth.Highest`.\n\t */\n\tBANDWIDTH_HIGHEST: Bandwidth;\n\n\t/**\n\t * Alias of `FrameType.Progressive`.\n\t */\n\tFORMAT_TYPE_PROGRESSIVE: FrameType;\n\t/**\n\t * Alias of `FrameType.Interlaced`.\n\t */\n\tFORMAT_TYPE_INTERLACED: FrameType;\n\t/**\n\t * Alias of `FrameType.Field0`.\n\t */\n\tFORMAT_TYPE_FIELD_0: FrameType;\n\t/**\n\t * Alias of `FrameType.Field1`.\n\t */\n\tFORMAT_TYPE_FIELD_1: FrameType;\n\n\t/**\n\t * Alias of `AudioFormat.Float32Separate`.\n\t */\n\tAUDIO_FORMAT_FLOAT_32_SEPARATE: AudioFormat;\n\t/**\n\t * Alias of `AudioFormat.Float32Interleaved`.\n\t */\n\tAUDIO_FORMAT_FLOAT_32_INTERLEAVED: AudioFormat;\n\t/**\n\t * Alias of `AudioFormat.Int16Interleaved`.\n\t */\n\tAUDIO_FORMAT_INT_16_INTERLEAVED: AudioFormat;\n\n\t/**\n\t * Alias of `FourCC.UYVY`.\n\t */\n\tFOURCC_UYVY: FourCC;\n\t/**\n\t * Alias of `FourCC.UYVA`.\n\t */\n\tFOURCC_UYVA: FourCC;\n\t/**\n\t * Alias of `FourCC.P216`.\n\t */\n\tFOURCC_P216: FourCC;\n\t/**\n\t * Alias of `FourCC.PA16`.\n\t */\n\tFOURCC_PA16: FourCC;\n\t/**\n\t * Alias of `FourCC.YV12`.\n\t */\n\tFOURCC_YV12: FourCC;\n\t/**\n\t * Alias of `FourCC.I420`.\n\t */\n\tFOURCC_I420: FourCC;\n\t/**\n\t * Alias of `FourCC.NV12`.\n\t */\n\tFOURCC_NV12: FourCC;\n\t/**\n\t * Alias of `FourCC.BGRA`.\n\t */\n\tFOURCC_BGRA: FourCC;\n\t/**\n\t * Alias of `FourCC.BGRX`.\n\t */\n\tFOURCC_BGRX: FourCC;\n\t/**\n\t * Alias of `FourCC.RGBA`.\n\t */\n\tFOURCC_RGBA: FourCC;\n\t/**\n\t * Alias of `FourCC.RGBX`.\n\t */\n\tFOURCC_RGBX: FourCC;\n\t/**\n\t * Alias of `FourCC.FLTp`.\n\t */\n\tFOURCC_FLTp: FourCC;\n}\n","import path from \"node:path\";\nimport nodeGypBuild from \"node-gyp-build\";\n\nimport type {\n\tFinder,\n\tFindOptions,\n\tFrameSync,\n\tGrandi,\n\tReceiveOptions,\n\tReceiver,\n\tRouting,\n\tSender,\n\tSendOptions,\n} from \"./types\";\nimport {\n\tAudioFormat,\n\tBandwidth,\n\tColorFormat,\n\tFourCC,\n\tFrameType,\n} from \"./types\";\n\n/**\n * Checks if the current platform and architecture are supported by NDI.\n * @returns {boolean} True if the platform is supported (darwin, linux, or win32 with ia32/x64), false otherwise.\n */\nfunction isSupportedPlatform(): boolean {\n\treturn (\n\t\tprocess.platform === \"darwin\" ||\n\t\tprocess.platform === \"linux\" ||\n\t\t(process.platform === \"win32\" && [\"ia32\", \"x64\"].includes(process.arch))\n\t);\n}\n\nfunction tryRequireArchPackage(): GrandiAddon | null {\n\tconst archKey = `${process.platform}-${process.arch}`;\n\tconst map: Record<string, string> = {\n\t\t\"linux-x64\": \"@grandi/linux-x64\",\n\t\t\"linux-arm64\": \"@grandi/linux-arm64\",\n\t\t\"linux-arm\": \"@grandi/linux-armv7l\",\n\t\t\"win32-x64\": \"@grandi/win32-x64\",\n\t\t\"win32-ia32\": \"@grandi/win32-ia32\",\n\t\t\"darwin-x64\": \"@grandi/darwin-universal\",\n\t\t\"darwin-arm64\": \"@grandi/darwin-universal\",\n\t};\n\tconst pkg = map[archKey];\n\tif (!pkg) throw new Error(`Unsupported platform or architecture: ${archKey}`);\n\ttry {\n\t\t// eslint-disable-next-line @typescript-eslint/no-var-requires\n\t\treturn require(pkg) as GrandiAddon;\n\t} catch {\n\t\tthrow new Error(\n\t\t\t`Failed to find prebuilt package for ${archKey}. Please ensure that the package \"${pkg}\" is installed`,\n\t\t);\n\t}\n}\n\nfunction loadAddon(): GrandiAddon {\n\tconst loadErrors: Error[] = [];\n\tif (!isSupportedPlatform()) {\n\t\tconsole.error(\n\t\t\t`Unsupported platform or architecture: ${process.platform}-${process.arch}`,\n\t\t);\n\t\treturn noopAddon;\n\t}\n\ttry {\n\t\tconst localBinding = nodeGypBuild(\n\t\t\tpath.join(__dirname, \"..\"),\n\t\t) as GrandiAddon;\n\t\tif (localBinding) return localBinding;\n\t} catch (err) {\n\t\tloadErrors.push(err as Error);\n\t}\n\ttry {\n\t\tconst archAddon = tryRequireArchPackage();\n\t\tif (archAddon) return archAddon;\n\t} catch (err) {\n\t\tloadErrors.push(err as Error);\n\t}\n\n\tif (loadErrors.length > 0) {\n\t\tconst aggregateError = new Error(\n\t\t\t\"Failed to load native addon:\\n\" +\n\t\t\t\tloadErrors.map((e, i) => `  [${i + 1}] ${e.message}`).join(\"\\n\"),\n\t\t);\n\t\tconsole.error(aggregateError);\n\t}\n\treturn noopAddon;\n}\n\nexport interface GrandiAddon {\n\tversion(): string;\n\tisSupportedCPU(): boolean;\n\tinitialize(): boolean;\n\tdestroy(): boolean;\n\tfind(params?: FindOptions): Promise<Finder>;\n\treceive(params: ReceiveOptions): Promise<Receiver>;\n\tframesync(receiver: Receiver): Promise<FrameSync>;\n\tsend(params: SendOptions): Promise<Sender>;\n\trouting(params: { name?: string; groups?: string }): Promise<Routing>;\n}\n\nconst noopAddon: GrandiAddon = {\n\tversion() {\n\t\treturn \"\";\n\t},\n\tisSupportedCPU() {\n\t\treturn false;\n\t},\n\tinitialize() {\n\t\treturn false;\n\t},\n\tdestroy() {\n\t\treturn false;\n\t},\n\tsend(_params) {\n\t\treturn Promise.reject(new Error(\"Unsupported platform or CPU\"));\n\t},\n\treceive(_params) {\n\t\treturn Promise.reject(new Error(\"Unsupported platform or CPU\"));\n\t},\n\tframesync(_receiver) {\n\t\treturn Promise.reject(new Error(\"Unsupported platform or CPU\"));\n\t},\n\trouting() {\n\t\treturn Promise.reject(new Error(\"Unsupported platform or CPU\"));\n\t},\n\tfind(_params) {\n\t\treturn Promise.reject(new Error(\"Unsupported platform or CPU\"));\n\t},\n};\n\nconst addon: GrandiAddon = loadAddon();\n/**\n * Creates a finder to discover NDI sources on the network.\n * @param {FindOptions} [params={}] - Options for finding sources.\n * @param {boolean} [params.showLocalSources] - Whether to show local sources.\n * @param {string} [params.groups] - Multicast groups to search in.\n * @param {string} [params.extraIPs] - Additional IP addresses to search.\n * @returns {Promise<Finder>} A promise that resolves to a Finder instance for discovering sources.\n * @throws {Error} Promise rejects on unsupported platform/CPU or if the finder cannot be created.\n *\n * @example\n * ```js\n * import { find, initialize } from \"grandi\";\n * initialize();\n * const finder = await find({ showLocalSources: true });\n * finder.wait(1000);\n * console.log(finder.sources());\n * finder.destroy();\n * ```\n */\nexport function find(params: FindOptions = {}): Promise<Finder> {\n\treturn addon.find(params);\n}\n// Named runtime exports\n/**\n * Gets the version of the NDI SDK.\n * @returns {string} The NDI SDK version string.\n */\nexport const version = addon.version;\n/**\n * Checks if the current CPU architecture is supported by NDI.\n * @returns {boolean} True if the CPU is supported, false otherwise.\n */\nexport const isSupportedCPU = addon.isSupportedCPU;\n/**\n * Initializes the NDI library. Must be called before using any other NDI functions.\n * @returns {boolean} True if initialization was successful, false otherwise.\n *\n * @example\n * ```js\n * import { initialize } from \"grandi\";\n * if (!initialize()) throw new Error(\"NDI init failed\");\n * ```\n */\nexport const initialize = addon.initialize;\n/**\n * Destroys the NDI library instance and cleans up resources.\n * Should be called when done using NDI to free resources.\n * @returns {boolean} True if destruction was successful, false otherwise.\n *\n * @example\n * ```js\n * import { destroy } from \"grandi\";\n * destroy();\n * ```\n */\nexport const destroy = addon.destroy;\n/**\n * Creates an NDI sender for transmitting video and audio over the network.\n * @param {SendOptions} params - Options for creating the sender.\n * @param {string} params.name - The name of the NDI source.\n * @param {string} [params.groups] - Multicast groups to send to.\n * @param {boolean} [params.clockVideo] - Whether to clock video frames.\n * @param {boolean} [params.clockAudio] - Whether to clock audio frames.\n * @returns {Promise<Sender>} A promise that resolves to a Sender instance for transmitting data.\n * @throws {Error} Promise rejects on unsupported platform/CPU or if sender creation fails.\n *\n * @example\n * ```js\n * import { initialize, send } from \"grandi\";\n * initialize();\n * const sender = await send({ name: \"My Source\" });\n * // sender.video(...) / sender.audio(...)\n * sender.destroy();\n * ```\n */\nexport const send = addon.send;\n/**\n * Creates an NDI receiver for receiving video and audio from an NDI source.\n * @param {ReceiveOptions} params - Options for creating the receiver.\n * @param {ReceiveOptions[\"source\"]} params.source - The NDI source to connect to.\n * @param {ReceiveOptions[\"colorFormat\"]} [params.colorFormat] - The color format for received video.\n * @param {ReceiveOptions[\"bandwidth\"]} [params.bandwidth] - The bandwidth limitation for the connection.\n * @param {boolean} [params.allowVideoFields] - Whether to allow video fields.\n * @param {string} [params.name] - The name for the receiver.\n * @returns {Promise<Receiver>} A promise that resolves to a Receiver instance for receiving data.\n * @throws {Error} Promise rejects on unsupported platform/CPU or if receiver creation fails.\n *\n * @example\n * ```js\n * import { find, initialize, receive } from \"grandi\";\n * initialize();\n * const finder = await find({ showLocalSources: true });\n * finder.wait(1000);\n * const source = finder.sources()[0];\n * finder.destroy();\n * const receiver = await receive({ source });\n * const frame = await receiver.video(1000);\n * receiver.destroy();\n * ```\n */\nexport const receive = addon.receive;\n/**\n * Creates an NDI frame-synchronizer (time base corrector) backed by an existing receiver.\n * Use this when you want smooth playback clocked to your own render/audio loop.\n *\n * Note: destroy the frame-sync before destroying the receiver.\n * @param {Receiver} receiver - The receiver instance to frame-sync.\n * @returns {Promise<FrameSync>} A promise that resolves to a FrameSync instance.\n * @throws {Error} Promise rejects on unsupported platform/CPU or if framesync creation fails.\n *\n * @example\n * ```js\n * import grandi from \"grandi\";\n * grandi.initialize();\n * const receiver = await grandi.receive({ source });\n * const fs = await grandi.framesync(receiver);\n * const frame = await fs.video(grandi.FrameType.Progressive);\n * fs.destroy();\n * receiver.destroy();\n * ```\n */\nexport const framesync = addon.framesync;\n/**\n * Creates an NDI router for switching between different NDI sources.\n * @param {Object} params - Options for creating the router.\n * @param {string} [params.name] - The name for the router.\n * @param {string} [params.groups] - Multicast groups for the router.\n * @returns {Promise<Routing>} A promise that resolves to a Routing instance for source switching.\n * @throws {Error} Promise rejects on unsupported platform/CPU or if routing creation fails.\n *\n * @example\n * ```js\n * import { initialize, routing } from \"grandi\";\n * initialize();\n * const router = await routing({ name: \"My Router\" });\n * // router.change(source)\n * router.destroy();\n * ```\n */\nexport const routing = addon.routing;\n\n// Re-export enums and types for convenient named imports\nexport { ColorFormat, AudioFormat, Bandwidth, FrameType, FourCC };\nexport type {\n\tAudioFrame,\n\tAudioReceiveOptions,\n\tFinder,\n\tFindOptions,\n\tFrameSync,\n\tFrameSyncAudioOptions,\n\tGrandi,\n\tPtpTimestamp,\n\tReceivedAudioFrame,\n\tReceivedMetadataFrame,\n\tReceivedVideoFrame,\n\tReceiveOptions,\n\tReceiverDataFrame,\n\tReceiverTallyState,\n\tRouting,\n\tSender,\n\tSenderTally,\n\tSource,\n\tSourceChangeEvent,\n\tStatusChangeEvent,\n\tTimecode,\n\tTimeoutEvent,\n\tVideoFrame,\n} from \"./types\";\n\nconst grandi: Grandi = {\n\tversion,\n\tisSupportedCPU,\n\tinitialize,\n\tdestroy,\n\tsend,\n\treceive,\n\tframesync,\n\trouting,\n\tfind,\n\tColorFormat,\n\tAudioFormat,\n\tBandwidth,\n\tFrameType,\n\tFourCC,\n\n\t// Constants mapped to enum values\n\tCOLOR_FORMAT_BGRX_BGRA: ColorFormat.BGRX_BGRA,\n\tCOLOR_FORMAT_UYVY_BGRA: ColorFormat.UYVY_BGRA,\n\tCOLOR_FORMAT_RGBX_RGBA: ColorFormat.RGBX_RGBA,\n\tCOLOR_FORMAT_UYVY_RGBA: ColorFormat.UYVY_RGBA,\n\tCOLOR_FORMAT_FASTEST: ColorFormat.Fastest,\n\tCOLOR_FORMAT_BGRX_BGRA_FLIPPED: ColorFormat.BGRX_BGRA_FLIPPED,\n\n\tBANDWIDTH_METADATA_ONLY: Bandwidth.MetadataOnly,\n\tBANDWIDTH_AUDIO_ONLY: Bandwidth.AudioOnly,\n\tBANDWIDTH_LOWEST: Bandwidth.Lowest,\n\tBANDWIDTH_HIGHEST: Bandwidth.Highest,\n\n\tFORMAT_TYPE_PROGRESSIVE: FrameType.Progressive,\n\tFORMAT_TYPE_INTERLACED: FrameType.Interlaced,\n\tFORMAT_TYPE_FIELD_0: FrameType.Field0,\n\tFORMAT_TYPE_FIELD_1: FrameType.Field1,\n\n\tAUDIO_FORMAT_FLOAT_32_SEPARATE: AudioFormat.Float32Separate,\n\tAUDIO_FORMAT_FLOAT_32_INTERLEAVED: AudioFormat.Float32Interleaved,\n\tAUDIO_FORMAT_INT_16_INTERLEAVED: AudioFormat.Int16Interleaved,\n\n\t// FourCC helpers/constants\n\tFOURCC_UYVY: FourCC.UYVY,\n\tFOURCC_UYVA: FourCC.UYVA,\n\tFOURCC_P216: FourCC.P216,\n\tFOURCC_PA16: FourCC.PA16,\n\tFOURCC_YV12: FourCC.YV12,\n\tFOURCC_I420: FourCC.I420,\n\tFOURCC_NV12: FourCC.NV12,\n\tFOURCC_BGRA: FourCC.BGRA,\n\tFOURCC_BGRX: FourCC.BGRX,\n\tFOURCC_RGBA: FourCC.RGBA,\n\tFOURCC_RGBX: FourCC.RGBX,\n\tFOURCC_FLTp: FourCC.FLTp,\n};\n\nexport default grandi;\n"],"x_google_ignoreList":[0],"mappings":"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"}

package/package.json

@@ -1,83 +1,86 @@
 {
-  "name": "grandi",
-  "version": "1.1.0",
-  "description": "Node.JS native bindings to the Newtek NDI SDK.",
-  "homepage": "https://github.com/tux-tn/grandi#readme",
-  "keywords": [
-    "Newtek",
-    "NDI",
-    "network",
-    "device",
-    "interface"
-  ],
-  "author": "Sarhan Aissi <npm@tux.tn>",
-  "license": "Apache-2.0",
-  "files": [
-    "dist",
-    "LICENSE",
-    "NOTICE",
-    "README.md"
-  ],
-  "main": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
-  "exports": {
-    ".": "./dist/index.mjs",
-    "./package.json": "./package.json"
-  },
-  "gypfile": true,
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/tux-tn/grandi.git"
-  },
-  "bugs": {
-    "url": "https://github.com/tux-tn/grandi/issues"
-  },
-  "optionalDependencies": {
-    "@grandi/linux-x64": "^1.0.0",
-    "@grandi/linux-arm64": "^1.0.0",
-    "@grandi/linux-armv7l": "^1.0.0",
-    "@grandi/win32-x64": "^1.0.0",
-    "@grandi/win32-ia32": "^1.0.0",
-    "@grandi/darwin-universal": "1.0.0"
-  },
-  "dependencies": {
-    "cross-spawn": "7.0.6",
-    "cross-zip": "4.0.1",
-    "execa": "9.6.1",
-    "got": "14.6.5",
-    "node-gyp-build": "^4.8.4",
-    "shelljs": "0.10.0",
-    "tmp": "0.2.5"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "2.3.9",
-    "@types/bindings": "^1.5.5",
-    "@types/cross-zip": "^4.0.2",
-    "@types/node": "^25.0.2",
-    "@types/shelljs": "^0.10.0",
-    "@types/tmp": "^0.2.6",
-    "@vitest/coverage-v8": "^4.0.15",
-    "cross-env": "^10.1.0",
-    "shx": "0.4.0",
-    "standard-version": "^9.5.0",
-    "tsdown": "^0.18.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.15"
-  },
-  "scripts": {
-    "build": "tsdown",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:unit": "vitest run test/unit",
-    "test:integration": "vitest run test/integration",
-    "bench": "node --expose-gc scripts/benchmark.mjs",
-    "test:coverage": "vitest run --coverage",
-    "format": "biome format",
-    "format:cpp": "clang-format -i lib/*.cc lib/*.h",
-    "lint": "biome lint",
-    "clean": "shx rm -rf ndi build"
-  },
-  "engines": {
-    "node": ">=20.19.5"
-  }
+	"name": "grandi",
+	"version": "1.2.1",
+	"description": "Node.JS native bindings to the Newtek NDI SDK.",
+	"homepage": "https://github.com/tux-tn/grandi#readme",
+	"keywords": [
+		"Newtek",
+		"NDI",
+		"network",
+		"device",
+		"interface"
+	],
+	"author": "Sarhan Aissi <npm@tux.tn>",
+	"license": "Apache-2.0",
+	"files": [
+		"dist",
+		"LICENSE",
+		"NOTICE",
+		"README.md"
+	],
+	"main": "./dist/index.mjs",
+	"types": "./dist/index.d.mts",
+	"exports": {
+		".": "./dist/index.mjs",
+		"./package.json": "./package.json"
+	},
+	"gypfile": true,
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/tux-tn/grandi.git"
+	},
+	"bugs": {
+		"url": "https://github.com/tux-tn/grandi/issues"
+	},
+	"optionalDependencies": {
+		"@grandi/darwin-universal": "1.2.1",
+		"@grandi/linux-arm64": "1.2.1",
+		"@grandi/linux-armv7l": "1.2.1",
+		"@grandi/linux-x64": "1.2.1",
+		"@grandi/win32-ia32": "1.2.1",
+		"@grandi/win32-x64": "1.2.1"
+	},
+	"dependencies": {
+		"node-gyp-build": "^4.8.4"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.3.9",
+		"@types/bindings": "^1.5.5",
+		"@types/cross-zip": "^4.0.2",
+		"@types/node": "^25.0.2",
+		"@types/shelljs": "^0.10.0",
+		"@types/tmp": "^0.2.6",
+		"@vitest/coverage-v8": "^4.0.15",
+		"cross-env": "^10.1.0",
+		"cross-spawn": "7.0.6",
+		"cross-zip": "4.0.1",
+		"execa": "9.6.1",
+		"got": "14.6.5",
+		"node-gyp": "^12.1.0",
+		"shelljs": "0.10.0",
+		"shx": "0.4.0",
+		"standard-version": "^9.5.0",
+		"tmp": "0.2.5",
+		"tsdown": "^0.18.0",
+		"typescript": "^5.9.3",
+		"vitest": "^4.0.15"
+	},
+	"scripts": {
+		"bench": "node --expose-gc scripts/benchmark.mjs",
+		"build": "tsdown",
+		"build:addon": "node scripts/build-addon.mjs",
+		"clean": "shx rm -rf ndi build",
+		"format": "biome format",
+		"format:cpp": "clang-format -i lib/*.cc lib/*.h",
+		"install": "exit 0",
+		"lint": "biome lint",
+		"test": "vitest run",
+		"test:coverage": "vitest run --coverage",
+		"test:integration": "vitest run test/integration",
+		"test:unit": "vitest run test/unit",
+		"test:watch": "vitest"
+	},
+	"engines": {
+		"node": ">=20.19.5"
+	}
 }