@arcanewizards/artnet 0.1.0

package/dist/chunk-J2HDMITA.js

@@ -0,0 +1,20 @@
+// src/constants.ts
+var ARTNET_PORT = 6454;
+var TIMECODE_MODES = {
+  FILM: 0,
+  EBU: 1,
+  DF: 2,
+  SMPTE: 3
+};
+var TIMECODE_FPS = {
+  FILM: 24,
+  EBU: 25,
+  DF: 29.97,
+  SMPTE: 30
+};
+
+export {
+  ARTNET_PORT,
+  TIMECODE_MODES,
+  TIMECODE_FPS
+};

package/dist/chunk-XUTZK65B.cjs

@@ -0,0 +1,20 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/constants.ts
+var ARTNET_PORT = 6454;
+var TIMECODE_MODES = {
+  FILM: 0,
+  EBU: 1,
+  DF: 2,
+  SMPTE: 3
+};
+var TIMECODE_FPS = {
+  FILM: 24,
+  EBU: 25,
+  DF: 29.97,
+  SMPTE: 30
+};
+
+
+
+
+
+exports.ARTNET_PORT = ARTNET_PORT; exports.TIMECODE_MODES = TIMECODE_MODES; exports.TIMECODE_FPS = TIMECODE_FPS;

package/dist/constants.cjs

@@ -0,0 +1,10 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+var _chunkXUTZK65Bcjs = require('./chunk-XUTZK65B.cjs');
+
+
+
+
+exports.ARTNET_PORT = _chunkXUTZK65Bcjs.ARTNET_PORT; exports.TIMECODE_FPS = _chunkXUTZK65Bcjs.TIMECODE_FPS; exports.TIMECODE_MODES = _chunkXUTZK65Bcjs.TIMECODE_MODES;

package/dist/constants.d.cts

@@ -0,0 +1,11 @@
+declare const ARTNET_PORT = 6454;
+declare const TIMECODE_MODES: {
+    FILM: number;
+    EBU: number;
+    DF: number;
+    SMPTE: number;
+};
+type TimecodeMode = keyof typeof TIMECODE_MODES;
+declare const TIMECODE_FPS: Record<TimecodeMode, number>;
+
+export { ARTNET_PORT, TIMECODE_FPS, TIMECODE_MODES, type TimecodeMode };

package/dist/constants.d.ts

@@ -0,0 +1,11 @@
+declare const ARTNET_PORT = 6454;
+declare const TIMECODE_MODES: {
+    FILM: number;
+    EBU: number;
+    DF: number;
+    SMPTE: number;
+};
+type TimecodeMode = keyof typeof TIMECODE_MODES;
+declare const TIMECODE_FPS: Record<TimecodeMode, number>;
+
+export { ARTNET_PORT, TIMECODE_FPS, TIMECODE_MODES, type TimecodeMode };

package/dist/constants.js

@@ -0,0 +1,10 @@
+import {
+  ARTNET_PORT,
+  TIMECODE_FPS,
+  TIMECODE_MODES
+} from "./chunk-J2HDMITA.js";
+export {
+  ARTNET_PORT,
+  TIMECODE_FPS,
+  TIMECODE_MODES
+};

package/dist/index.cjs

@@ -0,0 +1,301 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+
+var _chunkXUTZK65Bcjs = require('./chunk-XUTZK65B.cjs');
+
+// src/index.ts
+var _dgram = require('dgram');
+var _events = require('events'); var _events2 = _interopRequireDefault(_events);
+
+
+var _netutils = require('@arcanewizards/net-utils');
+var ARTNET_HEADER = "Art-Net\0";
+var ARTNET_VERSION = 14;
+var OP_TIME_CODE = 38656;
+var DROP_FRAME_NUMERATOR = 3e4;
+var DROP_FRAME_DENOMINATOR = 1001;
+var DROP_FRAME_COUNT = 2;
+var DROP_FRAME_FRAMES_PER_SECOND = 30;
+var DROP_FRAME_FRAMES_PER_MINUTE = DROP_FRAME_FRAMES_PER_SECOND * 60 - DROP_FRAME_COUNT;
+var DROP_FRAME_FRAMES_PER_10_MINUTES = DROP_FRAME_FRAMES_PER_MINUTE * 9 + DROP_FRAME_FRAMES_PER_SECOND * 60;
+var DROP_FRAME_FRAMES_PER_HOUR = DROP_FRAME_FRAMES_PER_10_MINUTES * 6;
+var DROP_FRAME_FRAMES_PER_24_HOURS = DROP_FRAME_FRAMES_PER_HOUR * 24;
+var TIMECODE_MODE_IDS = Object.fromEntries(
+  Object.entries(_chunkXUTZK65Bcjs.TIMECODE_MODES).map(([mode, id]) => [id, mode])
+);
+var bindSocket = (socket, port, address) => {
+  return new Promise((resolve, reject) => {
+    const onError = (error) => {
+      socket.removeListener("error", onError);
+      reject(error);
+    };
+    socket.once("error", onError);
+    const onBound = () => {
+      socket.removeListener("error", onError);
+      resolve();
+    };
+    if (address) {
+      socket.bind(port, address, onBound);
+    } else {
+      socket.bind(port, onBound);
+    }
+  });
+};
+var getDropFrameTimecode = (timeMillis) => {
+  const totalFrames = Math.floor(
+    timeMillis * DROP_FRAME_NUMERATOR / (1e3 * DROP_FRAME_DENOMINATOR)
+  );
+  const wrappedFrames = (totalFrames % DROP_FRAME_FRAMES_PER_24_HOURS + DROP_FRAME_FRAMES_PER_24_HOURS) % DROP_FRAME_FRAMES_PER_24_HOURS;
+  const tenMinuteChunks = Math.floor(
+    wrappedFrames / DROP_FRAME_FRAMES_PER_10_MINUTES
+  );
+  const remainingFrames = wrappedFrames % DROP_FRAME_FRAMES_PER_10_MINUTES;
+  const skippedFrames = DROP_FRAME_COUNT * 9 * tenMinuteChunks + (remainingFrames > DROP_FRAME_COUNT ? DROP_FRAME_COUNT * Math.floor(
+    (remainingFrames - DROP_FRAME_COUNT) / DROP_FRAME_FRAMES_PER_MINUTE
+  ) : 0);
+  const displayFrameNumber = wrappedFrames + skippedFrames;
+  return {
+    hours: Math.floor(
+      displayFrameNumber / (DROP_FRAME_FRAMES_PER_SECOND * 60 * 60)
+    ),
+    minutes: Math.floor(displayFrameNumber / (DROP_FRAME_FRAMES_PER_SECOND * 60)) % 60,
+    seconds: Math.floor(displayFrameNumber / DROP_FRAME_FRAMES_PER_SECOND) % 60,
+    frame: displayFrameNumber % DROP_FRAME_FRAMES_PER_SECOND,
+    mode: "DF",
+    timeMillis
+  };
+};
+var getTimecodeFromMillis = (mode, timeMillis) => {
+  if (mode === "DF") {
+    return getDropFrameTimecode(timeMillis);
+  }
+  return {
+    hours: Math.floor(timeMillis / 36e5),
+    minutes: Math.floor(timeMillis % 36e5 / 6e4),
+    seconds: Math.floor(timeMillis % 6e4 / 1e3),
+    frame: Math.floor(timeMillis % 1e3 / 1e3 * _chunkXUTZK65Bcjs.TIMECODE_FPS[mode]),
+    mode,
+    timeMillis
+  };
+};
+var getTimeMillisFromTimecode = (timecode) => {
+  const { hours, minutes, seconds, frame, mode } = timecode;
+  if (mode === "DF") {
+    const totalMinutes = hours * 60 + minutes;
+    const droppedFrames = DROP_FRAME_COUNT * (totalMinutes - Math.floor(totalMinutes / 10));
+    const displayFrameNumber = (hours * 60 * 60 + minutes * 60 + seconds) * DROP_FRAME_FRAMES_PER_SECOND + frame;
+    const totalFrames = displayFrameNumber - droppedFrames;
+    return totalFrames * 1e3 * DROP_FRAME_DENOMINATOR / DROP_FRAME_NUMERATOR;
+  }
+  return (hours * 60 * 60 + minutes * 60 + seconds) * 1e3 + frame * 1e3 / _chunkXUTZK65Bcjs.TIMECODE_FPS[mode];
+};
+var parseTimecodePacket = (packet, source) => {
+  if (packet.length < 19) {
+    return null;
+  }
+  if (packet.subarray(0, 8).toString("ascii") !== ARTNET_HEADER) {
+    return null;
+  }
+  if (packet.readUInt16LE(8) !== OP_TIME_CODE) {
+    return null;
+  }
+  const mode = TIMECODE_MODE_IDS[packet.readUInt8(18)];
+  if (!mode) {
+    return null;
+  }
+  const hours = packet.readUInt8(17);
+  const minutes = packet.readUInt8(16);
+  const seconds = packet.readUInt8(15);
+  const frame = packet.readUInt8(14);
+  return {
+    hours,
+    minutes,
+    seconds,
+    frame,
+    mode,
+    timeMillis: getTimeMillisFromTimecode({
+      hours,
+      minutes,
+      seconds,
+      frame,
+      mode
+    }),
+    host: source.address,
+    port: source.port
+  };
+};
+var createArtnet = (config) => {
+  const events = new (0, _events2.default)();
+  let sendSocket = null;
+  let receiveSocket = null;
+  let destroyed = false;
+  let connectPromise = null;
+  let interfacePromise = null;
+  const on = events.on.bind(events);
+  const addListener = events.addListener.bind(events);
+  const removeListener = events.removeListener.bind(
+    events
+  );
+  const getInterface = async () => {
+    if (config.type === "host") {
+      throw new Error(
+        "Network interface must be specified when listening for ArtNet packets"
+      );
+    }
+    if (!interfacePromise) {
+      interfacePromise = _netutils.getNetworkInterfaces.call(void 0, ).then((interfaces) => {
+        const iface = interfaces[config.interface];
+        if (!iface) {
+          throw new Error(`Network interface ${config.interface} not found`);
+        }
+        return iface;
+      });
+    }
+    return interfacePromise;
+  };
+  const cleanupSockets = () => {
+    _optionalChain([sendSocket, 'optionalAccess', _ => _.socket, 'access', _2 => _2.close, 'call', _3 => _3()]);
+    _optionalChain([receiveSocket, 'optionalAccess', _4 => _4.close, 'call', _5 => _5()]);
+    sendSocket = null;
+    receiveSocket = null;
+    connectPromise = null;
+  };
+  const initializeSendSocket = async () => {
+    if (sendSocket) {
+      return;
+    }
+    const socket = _dgram.createSocket.call(void 0, { type: "udp4", reuseAddr: true });
+    let sendHost;
+    if (config.type === "interface") {
+      const iface = await getInterface();
+      sendHost = iface.broadcastAddress;
+      await bindSocket(socket, 0);
+      socket.setBroadcast(true);
+    } else {
+      sendHost = config.host;
+    }
+    sendSocket = { socket, sendHost };
+  };
+  const initializeReceiveSocket = async () => {
+    if (receiveSocket) {
+      return;
+    }
+    const iface = await getInterface();
+    const bindAddress = iface.internal ? iface.address : iface.broadcastAddress;
+    const socket = _dgram.createSocket.call(void 0, { type: "udp4", reuseAddr: true });
+    receiveSocket = socket;
+    socket.on("message", (packet, source) => {
+      const timecode = parseTimecodePacket(packet, source);
+      if (!timecode) {
+        return;
+      }
+      events.emit("timecode", timecode);
+    });
+    try {
+      await bindSocket(socket, _nullishCoalesce(config.port, () => ( _chunkXUTZK65Bcjs.ARTNET_PORT)), bindAddress);
+    } catch (error) {
+      if (receiveSocket === socket) {
+        receiveSocket = null;
+      }
+      socket.close();
+      throw error;
+    }
+    socket.on("error", (error) => {
+      events.emit("error", error);
+    });
+  };
+  const connect = async () => {
+    if (destroyed) {
+      throw new Error("Cannot connect destroyed ArtNet instance");
+    }
+    if (connectPromise) {
+      return connectPromise;
+    }
+    connectPromise = (async () => {
+      try {
+        if (config.mode !== "receive") {
+          await initializeSendSocket();
+        }
+        if (config.mode !== "send") {
+          if (config.type === "interface") {
+            await initializeReceiveSocket();
+          } else if (events.listenerCount("timecode") > 0) {
+            throw new Error(
+              "Network interface must be specified when listening for ArtNet packets"
+            );
+          }
+        }
+      } catch (error) {
+        cleanupSockets();
+        throw error instanceof Error ? error : new Error(String(error));
+      }
+    })();
+    return connectPromise;
+  };
+  const sendTimecode = (mode, timeMillis) => {
+    if (timeMillis < 0) {
+      return Promise.resolve();
+    }
+    if (!sendSocket) {
+      return Promise.reject(new Error("ArtNet connection has not been opened"));
+    }
+    if (destroyed) {
+      return Promise.reject(
+        new Error("Cannot send timecode with destroyed ArtNet instance")
+      );
+    }
+    const { socket, sendHost } = sendSocket;
+    const { hours, minutes, seconds, frame } = getTimecodeFromMillis(
+      mode,
+      timeMillis
+    );
+    const packet = Buffer.alloc(19);
+    packet.write(ARTNET_HEADER, 0, "ascii");
+    packet.writeUInt16LE(OP_TIME_CODE, 8);
+    packet.writeUint16BE(ARTNET_VERSION, 10);
+    packet.writeUInt8(0, 12);
+    packet.writeUInt8(0, 13);
+    packet.writeUInt8(frame, 14);
+    packet.writeUInt8(seconds, 15);
+    packet.writeUInt8(minutes, 16);
+    packet.writeUInt8(hours, 17);
+    packet.writeUInt8(_chunkXUTZK65Bcjs.TIMECODE_MODES[mode], 18);
+    return new Promise(
+      (resolve, reject) => socket.send(
+        packet,
+        0,
+        packet.length,
+        _nullishCoalesce(config.port, () => ( _chunkXUTZK65Bcjs.ARTNET_PORT)),
+        sendHost,
+        (err) => {
+          if (err) {
+            const error = new Error("Failed to send ArtNet timecode packet", {
+              cause: err instanceof Error ? err : new Error(String(err))
+            });
+            events.emit("error", error);
+            reject(error);
+          } else {
+            resolve();
+          }
+        }
+      )
+    );
+  };
+  const destroy = () => {
+    destroyed = true;
+    events.emit("destroy");
+    cleanupSockets();
+  };
+  return {
+    connect,
+    sendTimecode,
+    on,
+    addListener,
+    removeListener,
+    destroy
+  };
+};
+
+
+exports.createArtnet = createArtnet;

package/dist/index.d.cts

@@ -0,0 +1,34 @@
+import { TimecodeMode } from './constants.cjs';
+import { ConnectionConfig } from '@arcanewizards/net-utils';
+
+type ArtNetTimecode = {
+    hours: number;
+    minutes: number;
+    seconds: number;
+    frame: number;
+    mode: TimecodeMode;
+    timeMillis: number;
+};
+type ArtNetTimecodeEvent = ArtNetTimecode & {
+    host: string;
+    port: number;
+};
+type ArtNetEventMap = {
+    destroy: [];
+    timecode: [ArtNetTimecodeEvent];
+    error: [Error];
+};
+type ArtNet = {
+    connect: () => Promise<void>;
+    sendTimecode: (mode: TimecodeMode, timeMillis: number) => Promise<void>;
+    on<K extends keyof ArtNetEventMap>(event: K, callback: (...args: ArtNetEventMap[K]) => void): void;
+    addListener<K extends keyof ArtNetEventMap>(event: K, callback: (...args: ArtNetEventMap[K]) => void): void;
+    removeListener<K extends keyof ArtNetEventMap>(event: K, callback: (...args: ArtNetEventMap[K]) => void): void;
+    destroy: () => void;
+};
+type ArtNetConnectionConfig = ConnectionConfig & {
+    mode: 'send' | 'receive' | 'both';
+};
+declare const createArtnet: (config: ArtNetConnectionConfig) => ArtNet;
+
+export { type ArtNet, type ArtNetConnectionConfig, type ArtNetEventMap, type ArtNetTimecode, type ArtNetTimecodeEvent, createArtnet };

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import { TimecodeMode } from './constants.js';
+import { ConnectionConfig } from '@arcanewizards/net-utils';
+
+type ArtNetTimecode = {
+    hours: number;
+    minutes: number;
+    seconds: number;
+    frame: number;
+    mode: TimecodeMode;
+    timeMillis: number;
+};
+type ArtNetTimecodeEvent = ArtNetTimecode & {
+    host: string;
+    port: number;
+};
+type ArtNetEventMap = {
+    destroy: [];
+    timecode: [ArtNetTimecodeEvent];
+    error: [Error];
+};
+type ArtNet = {
+    connect: () => Promise<void>;
+    sendTimecode: (mode: TimecodeMode, timeMillis: number) => Promise<void>;
+    on<K extends keyof ArtNetEventMap>(event: K, callback: (...args: ArtNetEventMap[K]) => void): void;
+    addListener<K extends keyof ArtNetEventMap>(event: K, callback: (...args: ArtNetEventMap[K]) => void): void;
+    removeListener<K extends keyof ArtNetEventMap>(event: K, callback: (...args: ArtNetEventMap[K]) => void): void;
+    destroy: () => void;
+};
+type ArtNetConnectionConfig = ConnectionConfig & {
+    mode: 'send' | 'receive' | 'both';
+};
+declare const createArtnet: (config: ArtNetConnectionConfig) => ArtNet;
+
+export { type ArtNet, type ArtNetConnectionConfig, type ArtNetEventMap, type ArtNetTimecode, type ArtNetTimecodeEvent, createArtnet };

package/dist/index.js

@@ -0,0 +1,301 @@
+import {
+  ARTNET_PORT,
+  TIMECODE_FPS,
+  TIMECODE_MODES
+} from "./chunk-J2HDMITA.js";
+
+// src/index.ts
+import { createSocket } from "dgram";
+import EventEmitter from "events";
+import {
+  getNetworkInterfaces
+} from "@arcanewizards/net-utils";
+var ARTNET_HEADER = "Art-Net\0";
+var ARTNET_VERSION = 14;
+var OP_TIME_CODE = 38656;
+var DROP_FRAME_NUMERATOR = 3e4;
+var DROP_FRAME_DENOMINATOR = 1001;
+var DROP_FRAME_COUNT = 2;
+var DROP_FRAME_FRAMES_PER_SECOND = 30;
+var DROP_FRAME_FRAMES_PER_MINUTE = DROP_FRAME_FRAMES_PER_SECOND * 60 - DROP_FRAME_COUNT;
+var DROP_FRAME_FRAMES_PER_10_MINUTES = DROP_FRAME_FRAMES_PER_MINUTE * 9 + DROP_FRAME_FRAMES_PER_SECOND * 60;
+var DROP_FRAME_FRAMES_PER_HOUR = DROP_FRAME_FRAMES_PER_10_MINUTES * 6;
+var DROP_FRAME_FRAMES_PER_24_HOURS = DROP_FRAME_FRAMES_PER_HOUR * 24;
+var TIMECODE_MODE_IDS = Object.fromEntries(
+  Object.entries(TIMECODE_MODES).map(([mode, id]) => [id, mode])
+);
+var bindSocket = (socket, port, address) => {
+  return new Promise((resolve, reject) => {
+    const onError = (error) => {
+      socket.removeListener("error", onError);
+      reject(error);
+    };
+    socket.once("error", onError);
+    const onBound = () => {
+      socket.removeListener("error", onError);
+      resolve();
+    };
+    if (address) {
+      socket.bind(port, address, onBound);
+    } else {
+      socket.bind(port, onBound);
+    }
+  });
+};
+var getDropFrameTimecode = (timeMillis) => {
+  const totalFrames = Math.floor(
+    timeMillis * DROP_FRAME_NUMERATOR / (1e3 * DROP_FRAME_DENOMINATOR)
+  );
+  const wrappedFrames = (totalFrames % DROP_FRAME_FRAMES_PER_24_HOURS + DROP_FRAME_FRAMES_PER_24_HOURS) % DROP_FRAME_FRAMES_PER_24_HOURS;
+  const tenMinuteChunks = Math.floor(
+    wrappedFrames / DROP_FRAME_FRAMES_PER_10_MINUTES
+  );
+  const remainingFrames = wrappedFrames % DROP_FRAME_FRAMES_PER_10_MINUTES;
+  const skippedFrames = DROP_FRAME_COUNT * 9 * tenMinuteChunks + (remainingFrames > DROP_FRAME_COUNT ? DROP_FRAME_COUNT * Math.floor(
+    (remainingFrames - DROP_FRAME_COUNT) / DROP_FRAME_FRAMES_PER_MINUTE
+  ) : 0);
+  const displayFrameNumber = wrappedFrames + skippedFrames;
+  return {
+    hours: Math.floor(
+      displayFrameNumber / (DROP_FRAME_FRAMES_PER_SECOND * 60 * 60)
+    ),
+    minutes: Math.floor(displayFrameNumber / (DROP_FRAME_FRAMES_PER_SECOND * 60)) % 60,
+    seconds: Math.floor(displayFrameNumber / DROP_FRAME_FRAMES_PER_SECOND) % 60,
+    frame: displayFrameNumber % DROP_FRAME_FRAMES_PER_SECOND,
+    mode: "DF",
+    timeMillis
+  };
+};
+var getTimecodeFromMillis = (mode, timeMillis) => {
+  if (mode === "DF") {
+    return getDropFrameTimecode(timeMillis);
+  }
+  return {
+    hours: Math.floor(timeMillis / 36e5),
+    minutes: Math.floor(timeMillis % 36e5 / 6e4),
+    seconds: Math.floor(timeMillis % 6e4 / 1e3),
+    frame: Math.floor(timeMillis % 1e3 / 1e3 * TIMECODE_FPS[mode]),
+    mode,
+    timeMillis
+  };
+};
+var getTimeMillisFromTimecode = (timecode) => {
+  const { hours, minutes, seconds, frame, mode } = timecode;
+  if (mode === "DF") {
+    const totalMinutes = hours * 60 + minutes;
+    const droppedFrames = DROP_FRAME_COUNT * (totalMinutes - Math.floor(totalMinutes / 10));
+    const displayFrameNumber = (hours * 60 * 60 + minutes * 60 + seconds) * DROP_FRAME_FRAMES_PER_SECOND + frame;
+    const totalFrames = displayFrameNumber - droppedFrames;
+    return totalFrames * 1e3 * DROP_FRAME_DENOMINATOR / DROP_FRAME_NUMERATOR;
+  }
+  return (hours * 60 * 60 + minutes * 60 + seconds) * 1e3 + frame * 1e3 / TIMECODE_FPS[mode];
+};
+var parseTimecodePacket = (packet, source) => {
+  if (packet.length < 19) {
+    return null;
+  }
+  if (packet.subarray(0, 8).toString("ascii") !== ARTNET_HEADER) {
+    return null;
+  }
+  if (packet.readUInt16LE(8) !== OP_TIME_CODE) {
+    return null;
+  }
+  const mode = TIMECODE_MODE_IDS[packet.readUInt8(18)];
+  if (!mode) {
+    return null;
+  }
+  const hours = packet.readUInt8(17);
+  const minutes = packet.readUInt8(16);
+  const seconds = packet.readUInt8(15);
+  const frame = packet.readUInt8(14);
+  return {
+    hours,
+    minutes,
+    seconds,
+    frame,
+    mode,
+    timeMillis: getTimeMillisFromTimecode({
+      hours,
+      minutes,
+      seconds,
+      frame,
+      mode
+    }),
+    host: source.address,
+    port: source.port
+  };
+};
+var createArtnet = (config) => {
+  const events = new EventEmitter();
+  let sendSocket = null;
+  let receiveSocket = null;
+  let destroyed = false;
+  let connectPromise = null;
+  let interfacePromise = null;
+  const on = events.on.bind(events);
+  const addListener = events.addListener.bind(events);
+  const removeListener = events.removeListener.bind(
+    events
+  );
+  const getInterface = async () => {
+    if (config.type === "host") {
+      throw new Error(
+        "Network interface must be specified when listening for ArtNet packets"
+      );
+    }
+    if (!interfacePromise) {
+      interfacePromise = getNetworkInterfaces().then((interfaces) => {
+        const iface = interfaces[config.interface];
+        if (!iface) {
+          throw new Error(`Network interface ${config.interface} not found`);
+        }
+        return iface;
+      });
+    }
+    return interfacePromise;
+  };
+  const cleanupSockets = () => {
+    sendSocket?.socket.close();
+    receiveSocket?.close();
+    sendSocket = null;
+    receiveSocket = null;
+    connectPromise = null;
+  };
+  const initializeSendSocket = async () => {
+    if (sendSocket) {
+      return;
+    }
+    const socket = createSocket({ type: "udp4", reuseAddr: true });
+    let sendHost;
+    if (config.type === "interface") {
+      const iface = await getInterface();
+      sendHost = iface.broadcastAddress;
+      await bindSocket(socket, 0);
+      socket.setBroadcast(true);
+    } else {
+      sendHost = config.host;
+    }
+    sendSocket = { socket, sendHost };
+  };
+  const initializeReceiveSocket = async () => {
+    if (receiveSocket) {
+      return;
+    }
+    const iface = await getInterface();
+    const bindAddress = iface.internal ? iface.address : iface.broadcastAddress;
+    const socket = createSocket({ type: "udp4", reuseAddr: true });
+    receiveSocket = socket;
+    socket.on("message", (packet, source) => {
+      const timecode = parseTimecodePacket(packet, source);
+      if (!timecode) {
+        return;
+      }
+      events.emit("timecode", timecode);
+    });
+    try {
+      await bindSocket(socket, config.port ?? ARTNET_PORT, bindAddress);
+    } catch (error) {
+      if (receiveSocket === socket) {
+        receiveSocket = null;
+      }
+      socket.close();
+      throw error;
+    }
+    socket.on("error", (error) => {
+      events.emit("error", error);
+    });
+  };
+  const connect = async () => {
+    if (destroyed) {
+      throw new Error("Cannot connect destroyed ArtNet instance");
+    }
+    if (connectPromise) {
+      return connectPromise;
+    }
+    connectPromise = (async () => {
+      try {
+        if (config.mode !== "receive") {
+          await initializeSendSocket();
+        }
+        if (config.mode !== "send") {
+          if (config.type === "interface") {
+            await initializeReceiveSocket();
+          } else if (events.listenerCount("timecode") > 0) {
+            throw new Error(
+              "Network interface must be specified when listening for ArtNet packets"
+            );
+          }
+        }
+      } catch (error) {
+        cleanupSockets();
+        throw error instanceof Error ? error : new Error(String(error));
+      }
+    })();
+    return connectPromise;
+  };
+  const sendTimecode = (mode, timeMillis) => {
+    if (timeMillis < 0) {
+      return Promise.resolve();
+    }
+    if (!sendSocket) {
+      return Promise.reject(new Error("ArtNet connection has not been opened"));
+    }
+    if (destroyed) {
+      return Promise.reject(
+        new Error("Cannot send timecode with destroyed ArtNet instance")
+      );
+    }
+    const { socket, sendHost } = sendSocket;
+    const { hours, minutes, seconds, frame } = getTimecodeFromMillis(
+      mode,
+      timeMillis
+    );
+    const packet = Buffer.alloc(19);
+    packet.write(ARTNET_HEADER, 0, "ascii");
+    packet.writeUInt16LE(OP_TIME_CODE, 8);
+    packet.writeUint16BE(ARTNET_VERSION, 10);
+    packet.writeUInt8(0, 12);
+    packet.writeUInt8(0, 13);
+    packet.writeUInt8(frame, 14);
+    packet.writeUInt8(seconds, 15);
+    packet.writeUInt8(minutes, 16);
+    packet.writeUInt8(hours, 17);
+    packet.writeUInt8(TIMECODE_MODES[mode], 18);
+    return new Promise(
+      (resolve, reject) => socket.send(
+        packet,
+        0,
+        packet.length,
+        config.port ?? ARTNET_PORT,
+        sendHost,
+        (err) => {
+          if (err) {
+            const error = new Error("Failed to send ArtNet timecode packet", {
+              cause: err instanceof Error ? err : new Error(String(err))
+            });
+            events.emit("error", error);
+            reject(error);
+          } else {
+            resolve();
+          }
+        }
+      )
+    );
+  };
+  const destroy = () => {
+    destroyed = true;
+    events.emit("destroy");
+    cleanupSockets();
+  };
+  return {
+    connect,
+    sendTimecode,
+    on,
+    addListener,
+    removeListener,
+    destroy
+  };
+};
+export {
+  createArtnet
+};

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@arcanewizards/artnet",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "@arcanewizards/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./constants": {
+      "@arcanewizards/source": "./src/constants.ts",
+      "types": "./dist/constants.d.ts",
+      "import": "./dist/constants.js",
+      "require": "./dist/constants.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsup && check-export-map",
+    "check:types": "tsc --noEmit",
+    "format:fix": "cd .. && pnpm format:fix",
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint --fix ."
+  },
+  "devDependencies": {
+    "@arcanewizards/eslint-config": "workspace:^",
+    "@arcanewizards/typescript-config": "workspace:^",
+    "@types/node": "^25.0.3",
+    "check-export-map": "^1.3.1",
+    "eslint": "^9",
+    "tsup": "^8.1.0",
+    "typescript": "^5.7.3"
+  },
+  "dependencies": {
+    "@arcanewizards/net-utils": "workspace:^"
+  }
+}