@bobfrankston/rmfudp 0.1.0

package/address.d.ts

@@ -0,0 +1,14 @@
+export interface NetworkInfo {
+    name: string;
+    address: string;
+    netmask: string;
+    broadcast: string;
+    mac: string;
+}
+/** Get all IPv4 network interfaces with broadcast addresses */
+export declare function getNetworkInterfaces(): NetworkInfo[];
+/** Compute broadcast address from IP and netmask */
+export declare function computeBroadcast(address: string, netmask: string): string;
+/** Get all broadcast addresses for discovery */
+export declare function getBroadcastAddresses(): string[];
+//# sourceMappingURL=address.d.ts.map

package/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["address.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACf;AAED,+DAA+D;AAC/D,wBAAgB,oBAAoB,IAAI,WAAW,EAAE,CAmBpD;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKzE;AAED,gDAAgD;AAChD,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD"}

package/address.js

@@ -0,0 +1,34 @@
+import * as os from 'node:os';
+/** Get all IPv4 network interfaces with broadcast addresses */
+export function getNetworkInterfaces() {
+    const result = [];
+    const netifs = os.networkInterfaces();
+    for (const name in netifs) {
+        for (const info of netifs[name]) {
+            if (info.family !== 'IPv4' || info.internal)
+                continue;
+            if (info.address.startsWith('169.254.'))
+                continue; /** link-local */
+            result.push({
+                name,
+                address: info.address,
+                netmask: info.netmask,
+                broadcast: computeBroadcast(info.address, info.netmask),
+                mac: info.mac
+            });
+        }
+    }
+    return result;
+}
+/** Compute broadcast address from IP and netmask */
+export function computeBroadcast(address, netmask) {
+    const addrParts = address.split('.').map(n => parseInt(n, 10));
+    const maskParts = netmask.split('.').map(n => parseInt(n, 10));
+    const broadcastParts = addrParts.map((a, i) => (~maskParts[i] & 0xff) | a);
+    return broadcastParts.join('.');
+}
+/** Get all broadcast addresses for discovery */
+export function getBroadcastAddresses() {
+    return getNetworkInterfaces().map(ni => ni.broadcast);
+}
+//# sourceMappingURL=address.js.map

package/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["address.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAU9B,+DAA+D;AAC/D,MAAM,UAAU,oBAAoB;IAChC,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QACxB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ;gBAAE,SAAS;YACtD,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC;gBAAE,SAAS,CAAE,iBAAiB;YAErE,MAAM,CAAC,IAAI,CAAC;gBACR,IAAI;gBACJ,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC;gBACvD,GAAG,EAAE,IAAI,CAAC,GAAG;aAChB,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,OAAe;IAC7D,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC/D,MAAM,cAAc,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3E,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,qBAAqB;IACjC,OAAO,oBAAoB,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;AAC1D,CAAC"}

package/address.ts

@@ -0,0 +1,44 @@
+import * as os from 'node:os';
+
+export interface NetworkInfo {
+    name: string;
+    address: string;
+    netmask: string;
+    broadcast: string;
+    mac: string;
+}
+
+/** Get all IPv4 network interfaces with broadcast addresses */
+export function getNetworkInterfaces(): NetworkInfo[] {
+    const result: NetworkInfo[] = [];
+    const netifs = os.networkInterfaces();
+
+    for (const name in netifs) {
+        for (const info of netifs[name]) {
+            if (info.family !== 'IPv4' || info.internal) continue;
+            if (info.address.startsWith('169.254.')) continue;  /** link-local */
+
+            result.push({
+                name,
+                address: info.address,
+                netmask: info.netmask,
+                broadcast: computeBroadcast(info.address, info.netmask),
+                mac: info.mac
+            });
+        }
+    }
+    return result;
+}
+
+/** Compute broadcast address from IP and netmask */
+export function computeBroadcast(address: string, netmask: string): string {
+    const addrParts = address.split('.').map(n => parseInt(n, 10));
+    const maskParts = netmask.split('.').map(n => parseInt(n, 10));
+    const broadcastParts = addrParts.map((a, i) => (~maskParts[i] & 0xff) | a);
+    return broadcastParts.join('.');
+}
+
+/** Get all broadcast addresses for discovery */
+export function getBroadcastAddresses(): string[] {
+    return getNetworkInterfaces().map(ni => ni.broadcast);
+}

package/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export { UdpSocket } from './socket.js';
+export { getNetworkInterfaces, getBroadcastAddresses, computeBroadcast, NetworkInfo } from './address.js';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/index.js

@@ -0,0 +1,4 @@
+export * from './types.js';
+export { UdpSocket } from './socket.js';
+export { getNetworkInterfaces, getBroadcastAddresses, computeBroadcast } from './address.js';
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,gBAAgB,EAAe,MAAM,cAAc,CAAC"}

package/index.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export { UdpSocket } from './socket.js';
+export { getNetworkInterfaces, getBroadcastAddresses, computeBroadcast, NetworkInfo } from './address.js';

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@bobfrankston/rmfudp",
+  "version": "0.1.0",
+  "description": "Generic UDP transport with port sharing, retry logic, and configurable timeouts",
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc -w"
+  },
+  "keywords": ["udp", "socket", "retry", "broadcast"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BobFrankston/rmfudp.git"
+  },
+  "devDependencies": {
+    "@types/node": "latest"
+  }
+}

package/socket.d.ts

@@ -0,0 +1,29 @@
+import { EventEmitter } from 'node:events';
+import { UdpSocketOptions, UdpRetryOptions, RemoteInfo } from './types.js';
+export declare class UdpSocket extends EventEmitter {
+    private socket;
+    private port;
+    private broadcastAddr;
+    private bound;
+    private retryCount;
+    private retryDelay;
+    private responseTimeout;
+    constructor(options?: UdpSocketOptions);
+    /** Bind to port and enable broadcast */
+    bind(): Promise<void>;
+    /** Close socket */
+    close(): void;
+    /** Get bound port */
+    getPort(): number;
+    /** Set retry options at runtime */
+    setRetryOptions(options: UdpRetryOptions): void;
+    /** Get current retry options */
+    getRetryOptions(): Required<UdpRetryOptions>;
+    /** Send data to specific address (fire-and-forget) */
+    send(ip: string, port: number, data: Buffer): void;
+    /** Broadcast data (fire-and-forget) */
+    broadcast(data: Buffer, port?: number): void;
+    /** Send with retry - resolves when ack received or retries exhausted */
+    sendWithRetry(ip: string, port: number, data: Buffer, isAck: (msg: Buffer, rinfo: RemoteInfo) => boolean): Promise<Buffer>;
+}
+//# sourceMappingURL=socket.d.ts.map

package/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["socket.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAQ3E,qBAAa,SAAU,SAAQ,YAAY;IACvC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,KAAK,CAAkB;IAE/B,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,eAAe,CAAoC;gBAE/C,OAAO,GAAE,gBAAqB;IAwB1C,wCAAwC;IACxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBrB,mBAAmB;IACnB,KAAK,IAAI,IAAI;IAMb,qBAAqB;IACrB,OAAO,IAAI,MAAM;IAIjB,mCAAmC;IACnC,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAM/C,gCAAgC;IAChC,eAAe,IAAI,QAAQ,CAAC,eAAe,CAAC;IAQ5C,sDAAsD;IACtD,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAUlD,uCAAuC;IACvC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5C,wEAAwE;IACxE,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAoC7H"}

package/socket.js

@@ -0,0 +1,129 @@
+import dgram from 'node:dgram';
+import { EventEmitter } from 'node:events';
+const DEFAULT_PORT = 0;
+const DEFAULT_BROADCAST = '255.255.255.255';
+const DEFAULT_RETRY_COUNT = 3;
+const DEFAULT_RETRY_DELAY = 100;
+const DEFAULT_RESPONSE_TIMEOUT = 1000;
+export class UdpSocket extends EventEmitter {
+    socket;
+    port;
+    broadcastAddr;
+    bound = false;
+    retryCount = DEFAULT_RETRY_COUNT;
+    retryDelay = DEFAULT_RETRY_DELAY;
+    responseTimeout = DEFAULT_RESPONSE_TIMEOUT;
+    constructor(options = {}) {
+        super();
+        this.port = options.port ?? DEFAULT_PORT;
+        this.broadcastAddr = options.broadcastAddr ?? DEFAULT_BROADCAST;
+        this.socket = dgram.createSocket({
+            type: 'udp4',
+            reuseAddr: options.reuseAddr ?? true
+        });
+        this.socket.on('message', (msg, rinfo) => {
+            this.emit('message', msg, rinfo);
+        });
+        this.socket.on('error', (err) => {
+            this.emit('error', err);
+        });
+        this.socket.on('close', () => {
+            this.bound = false;
+            this.emit('close');
+        });
+    }
+    /** Bind to port and enable broadcast */
+    bind() {
+        return new Promise((resolve, reject) => {
+            if (this.bound) {
+                resolve();
+                return;
+            }
+            this.socket.once('error', reject);
+            this.socket.bind(this.port, () => {
+                this.socket.removeListener('error', reject);
+                this.socket.setBroadcast(true);
+                this.bound = true;
+                this.port = this.socket.address().port;
+                this.emit('bound');
+                resolve();
+            });
+        });
+    }
+    /** Close socket */
+    close() {
+        if (this.bound) {
+            this.socket.close();
+        }
+    }
+    /** Get bound port */
+    getPort() {
+        return this.port;
+    }
+    /** Set retry options at runtime */
+    setRetryOptions(options) {
+        if (options.retryCount !== undefined)
+            this.retryCount = options.retryCount;
+        if (options.retryDelay !== undefined)
+            this.retryDelay = options.retryDelay;
+        if (options.responseTimeout !== undefined)
+            this.responseTimeout = options.responseTimeout;
+    }
+    /** Get current retry options */
+    getRetryOptions() {
+        return {
+            retryCount: this.retryCount,
+            retryDelay: this.retryDelay,
+            responseTimeout: this.responseTimeout
+        };
+    }
+    /** Send data to specific address (fire-and-forget) */
+    send(ip, port, data) {
+        if (!this.bound) {
+            this.emit('error', new Error('Socket not bound'));
+            return;
+        }
+        this.socket.send(data, 0, data.length, port, ip, (err) => {
+            if (err)
+                this.emit('error', err);
+        });
+    }
+    /** Broadcast data (fire-and-forget) */
+    broadcast(data, port) {
+        this.send(this.broadcastAddr, port ?? this.port, data);
+    }
+    /** Send with retry - resolves when ack received or retries exhausted */
+    sendWithRetry(ip, port, data, isAck) {
+        return new Promise((resolve, reject) => {
+            let attempts = 0;
+            let timeoutHandle;
+            let resolved = false;
+            const onMessage = (msg, rinfo) => {
+                if (rinfo.address === ip && isAck(msg, rinfo)) {
+                    resolved = true;
+                    clearTimeout(timeoutHandle);
+                    this.removeListener('message', onMessage);
+                    resolve(msg);
+                }
+            };
+            const attempt = () => {
+                if (resolved)
+                    return;
+                attempts++;
+                if (attempts > this.retryCount) {
+                    this.removeListener('message', onMessage);
+                    reject(new Error(`No response after ${this.retryCount} retries`));
+                    return;
+                }
+                this.send(ip, port, data);
+                timeoutHandle = setTimeout(() => {
+                    if (!resolved)
+                        attempt();
+                }, attempts === 1 ? this.responseTimeout : this.retryDelay);
+            };
+            this.on('message', onMessage);
+            attempt();
+        });
+    }
+}
+//# sourceMappingURL=socket.js.map

package/socket.js.map

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

package/socket.ts

@@ -0,0 +1,147 @@
+import dgram from 'node:dgram';
+import { EventEmitter } from 'node:events';
+import { UdpSocketOptions, UdpRetryOptions, RemoteInfo } from './types.js';
+
+const DEFAULT_PORT = 0;
+const DEFAULT_BROADCAST = '255.255.255.255';
+const DEFAULT_RETRY_COUNT = 3;
+const DEFAULT_RETRY_DELAY = 100;
+const DEFAULT_RESPONSE_TIMEOUT = 1000;
+
+export class UdpSocket extends EventEmitter {
+    private socket: dgram.Socket;
+    private port: number;
+    private broadcastAddr: string;
+    private bound: boolean = false;
+
+    private retryCount: number = DEFAULT_RETRY_COUNT;
+    private retryDelay: number = DEFAULT_RETRY_DELAY;
+    private responseTimeout: number = DEFAULT_RESPONSE_TIMEOUT;
+
+    constructor(options: UdpSocketOptions = {}) {
+        super();
+        this.port = options.port ?? DEFAULT_PORT;
+        this.broadcastAddr = options.broadcastAddr ?? DEFAULT_BROADCAST;
+
+        this.socket = dgram.createSocket({
+            type: 'udp4',
+            reuseAddr: options.reuseAddr ?? true
+        });
+
+        this.socket.on('message', (msg: Buffer, rinfo: dgram.RemoteInfo) => {
+            this.emit('message', msg, rinfo as RemoteInfo);
+        });
+
+        this.socket.on('error', (err: Error) => {
+            this.emit('error', err);
+        });
+
+        this.socket.on('close', () => {
+            this.bound = false;
+            this.emit('close');
+        });
+    }
+
+    /** Bind to port and enable broadcast */
+    bind(): Promise<void> {
+        return new Promise((resolve, reject) => {
+            if (this.bound) {
+                resolve();
+                return;
+            }
+
+            this.socket.once('error', reject);
+
+            this.socket.bind(this.port, () => {
+                this.socket.removeListener('error', reject);
+                this.socket.setBroadcast(true);
+                this.bound = true;
+                this.port = this.socket.address().port;
+                this.emit('bound');
+                resolve();
+            });
+        });
+    }
+
+    /** Close socket */
+    close(): void {
+        if (this.bound) {
+            this.socket.close();
+        }
+    }
+
+    /** Get bound port */
+    getPort(): number {
+        return this.port;
+    }
+
+    /** Set retry options at runtime */
+    setRetryOptions(options: UdpRetryOptions): void {
+        if (options.retryCount !== undefined) this.retryCount = options.retryCount;
+        if (options.retryDelay !== undefined) this.retryDelay = options.retryDelay;
+        if (options.responseTimeout !== undefined) this.responseTimeout = options.responseTimeout;
+    }
+
+    /** Get current retry options */
+    getRetryOptions(): Required<UdpRetryOptions> {
+        return {
+            retryCount: this.retryCount,
+            retryDelay: this.retryDelay,
+            responseTimeout: this.responseTimeout
+        };
+    }
+
+    /** Send data to specific address (fire-and-forget) */
+    send(ip: string, port: number, data: Buffer): void {
+        if (!this.bound) {
+            this.emit('error', new Error('Socket not bound'));
+            return;
+        }
+        this.socket.send(data, 0, data.length, port, ip, (err) => {
+            if (err) this.emit('error', err);
+        });
+    }
+
+    /** Broadcast data (fire-and-forget) */
+    broadcast(data: Buffer, port?: number): void {
+        this.send(this.broadcastAddr, port ?? this.port, data);
+    }
+
+    /** Send with retry - resolves when ack received or retries exhausted */
+    sendWithRetry(ip: string, port: number, data: Buffer, isAck: (msg: Buffer, rinfo: RemoteInfo) => boolean): Promise<Buffer> {
+        return new Promise((resolve, reject) => {
+            let attempts = 0;
+            let timeoutHandle: NodeJS.Timeout;
+            let resolved = false;
+
+            const onMessage = (msg: Buffer, rinfo: RemoteInfo) => {
+                if (rinfo.address === ip && isAck(msg, rinfo)) {
+                    resolved = true;
+                    clearTimeout(timeoutHandle);
+                    this.removeListener('message', onMessage);
+                    resolve(msg);
+                }
+            };
+
+            const attempt = () => {
+                if (resolved) return;
+
+                attempts++;
+                if (attempts > this.retryCount) {
+                    this.removeListener('message', onMessage);
+                    reject(new Error(`No response after ${this.retryCount} retries`));
+                    return;
+                }
+
+                this.send(ip, port, data);
+
+                timeoutHandle = setTimeout(() => {
+                    if (!resolved) attempt();
+                }, attempts === 1 ? this.responseTimeout : this.retryDelay);
+            };
+
+            this.on('message', onMessage);
+            attempt();
+        });
+    }
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "strict": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strictNullChecks": false,
+    "noImplicitAny": true,
+    "noImplicitThis": true,
+    "newLine": "lf"
+  },
+  "exclude": ["node_modules", "cruft", ".git", "tests", "prev"]
+}

package/types.d.ts

@@ -0,0 +1,23 @@
+export interface UdpSocketOptions {
+    port?: number; /** default 0 (ephemeral) */
+    reuseAddr?: boolean; /** default true for port sharing */
+    broadcastAddr?: string; /** default "255.255.255.255" */
+}
+export interface UdpRetryOptions {
+    retryCount?: number; /** default 3 */
+    retryDelay?: number; /** ms between retries, default 100 */
+    responseTimeout?: number; /** ms to wait for response, default 1000 */
+}
+export interface RemoteInfo {
+    address: string;
+    port: number;
+    family: 'IPv4' | 'IPv6';
+    size: number;
+}
+export interface UdpSocketEvents {
+    message: (data: Buffer, rinfo: RemoteInfo) => void;
+    error: (err: Error) => void;
+    bound: () => void;
+    close: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC,CAAE,4BAA4B;IAC5C,SAAS,CAAC,EAAE,OAAO,CAAC,CAAE,oCAAoC;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC,CAAE,gCAAgC;CAC5D;AAED,MAAM,WAAW,eAAe;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,CAAE,gBAAgB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAE,sCAAsC;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC,CAAE,4CAA4C;CAC1E;AAED,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACnD,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;CACrB"}

package/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":""}

package/types.ts

@@ -0,0 +1,25 @@
+export interface UdpSocketOptions {
+    port?: number;  /** default 0 (ephemeral) */
+    reuseAddr?: boolean;  /** default true for port sharing */
+    broadcastAddr?: string;  /** default "255.255.255.255" */
+}
+
+export interface UdpRetryOptions {
+    retryCount?: number;  /** default 3 */
+    retryDelay?: number;  /** ms between retries, default 100 */
+    responseTimeout?: number;  /** ms to wait for response, default 1000 */
+}
+
+export interface RemoteInfo {
+    address: string;
+    port: number;
+    family: 'IPv4' | 'IPv6';
+    size: number;
+}
+
+export interface UdpSocketEvents {
+    message: (data: Buffer, rinfo: RemoteInfo) => void;
+    error: (err: Error) => void;
+    bound: () => void;
+    close: () => void;
+}