stagelinq 1.0.7 → 3.0.0

package/dist/StageLinq/index.d.ts

@@ -0,0 +1,131 @@
+/**
+ * StageLinq - Main entry point for the StageLinq library
+ *
+ * Supports two usage patterns:
+ *
+ * 1. Static class (compatible with TS main v1):
+ *    StageLinq.options = { actingAs: ActingAsDevice.NowPlaying };
+ *    StageLinq.on('trackLoaded', (track) => console.log(track));
+ *    await StageLinq.connect();
+ *
+ * 2. Instance-based (for flexibility):
+ *    const stagelinq = new StageLinqInstance(options);
+ *    stagelinq.on('trackLoaded', (track) => console.log(track));
+ *    await stagelinq.connect();
+ */
+import { EventEmitter } from 'events';
+import { StageLinqDevices } from '../network/StageLinqDevices';
+import { Logger } from '../LogEmitter';
+import { StageLinqOptions } from '../types';
+/**
+ * StageLinq instance class.
+ * Use this for multiple instances or when you need full control.
+ */
+export declare class StageLinqInstance extends EventEmitter {
+    devices: StageLinqDevices;
+    instanceLogger: Logger;
+    instanceOptions: StageLinqOptions;
+    private listener;
+    private _isConnected;
+    constructor(options?: StageLinqOptions);
+    /**
+     * Whether the instance is currently connected
+     */
+    get isConnected(): boolean;
+    /**
+     * Get the options
+     */
+    get options(): StageLinqOptions;
+    /**
+     * Get the logger
+     */
+    get logger(): Logger;
+    /**
+     * Connect to the StageLinq network.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the StageLinq network.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get the databases manager
+     */
+    get databases(): import("../Databases").Databases;
+}
+/**
+ * StageLinq static class.
+ * Provides a singleton interface compatible with TS main v1.
+ *
+ * @example
+ * StageLinq.options = { actingAs: ActingAsDevice.NowPlaying };
+ * StageLinq.devices.on('trackLoaded', (track) => console.log(track));
+ * await StageLinq.connect();
+ */
+export declare class StageLinq {
+    private static _instance;
+    private static _options;
+    /**
+     * Get or set the options for the static instance
+     * Compatible with TS main v1: StageLinq.options = { ... }
+     */
+    static get options(): StageLinqOptions;
+    static set options(value: StageLinqOptions);
+    /**
+     * Get the singleton instance, creating it if necessary
+     */
+    private static get instance();
+    /**
+     * Whether the static instance is currently connected
+     */
+    static get isConnected(): boolean;
+    /**
+     * Get the devices manager
+     * Compatible with TS main v1: StageLinq.devices
+     */
+    static get devices(): StageLinqDevices;
+    /**
+     * Get the databases manager
+     */
+    static get databases(): import("../Databases").Databases;
+    /**
+     * Get the logger instance
+     * Compatible with TS main v1: StageLinq.logger
+     */
+    static get logger(): Logger;
+    /**
+     * Connect to the StageLinq network
+     * Compatible with TS main v1: await StageLinq.connect()
+     */
+    static connect(): Promise<void>;
+    /**
+     * Disconnect from the StageLinq network
+     * Compatible with TS main v1: await StageLinq.disconnect()
+     */
+    static disconnect(): Promise<void>;
+    /**
+     * Register an event listener
+     */
+    static on(event: string, listener: (...args: any[]) => void): void;
+    /**
+     * Register a one-time event listener
+     */
+    static once(event: string, listener: (...args: any[]) => void): void;
+    /**
+     * Remove an event listener
+     */
+    static off(event: string, listener: (...args: any[]) => void): void;
+    /**
+     * Remove all listeners for an event
+     */
+    static removeAllListeners(event?: string): void;
+    /**
+     * Emit an event
+     */
+    static emit(event: string, ...args: any[]): boolean;
+    /**
+     * Reset the static instance (for testing or reconfiguration)
+     */
+    static reset(): void;
+}
+export default StageLinq;

package/dist/StageLinq/index.js

@@ -0,0 +1,237 @@
+"use strict";
+/**
+ * StageLinq - Main entry point for the StageLinq library
+ *
+ * Supports two usage patterns:
+ *
+ * 1. Static class (compatible with TS main v1):
+ *    StageLinq.options = { actingAs: ActingAsDevice.NowPlaying };
+ *    StageLinq.on('trackLoaded', (track) => console.log(track));
+ *    await StageLinq.connect();
+ *
+ * 2. Instance-based (for flexibility):
+ *    const stagelinq = new StageLinqInstance(options);
+ *    stagelinq.on('trackLoaded', (track) => console.log(track));
+ *    await stagelinq.connect();
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StageLinq = exports.StageLinqInstance = void 0;
+const network_1 = require("../network");
+const events_1 = require("events");
+const StageLinqDevices_1 = require("../network/StageLinqDevices");
+const LogEmitter_1 = require("../LogEmitter");
+const types_1 = require("../types");
+const config_1 = require("../config");
+const DEFAULT_OPTIONS = {
+    maxRetries: 3,
+    actingAs: types_1.ActingAsDevice.NowPlaying,
+    downloadDbSources: true,
+    enableFileTranfer: true
+};
+/**
+ * StageLinq instance class.
+ * Use this for multiple instances or when you need full control.
+ */
+class StageLinqInstance extends events_1.EventEmitter {
+    constructor(options) {
+        super();
+        this.instanceLogger = LogEmitter_1.Logger.instance;
+        this._isConnected = false;
+        this.instanceOptions = { ...DEFAULT_OPTIONS, ...options };
+        // Apply global config from options
+        if (this.instanceOptions.networkTap) {
+            (0, config_1.setConfig)({ networkTap: this.instanceOptions.networkTap });
+        }
+        this.devices = new StageLinqDevices_1.StageLinqDevices(this.instanceOptions);
+        // Forward device events to this instance
+        this.devices.on('connected', (info) => this.emit('connected', info));
+        this.devices.on('ready', () => this.emit('ready'));
+        this.devices.on('trackLoaded', (status) => this.emit('trackLoaded', status));
+        this.devices.on('nowPlaying', (status) => this.emit('nowPlaying', status));
+        this.devices.on('stateChanged', (status) => this.emit('stateChanged', status));
+        this.devices.on('message', (info, data) => this.emit('message', info, data));
+    }
+    /**
+     * Whether the instance is currently connected
+     */
+    get isConnected() {
+        return this._isConnected;
+    }
+    /**
+     * Get the options
+     */
+    get options() {
+        return this.instanceOptions;
+    }
+    /**
+     * Get the logger
+     */
+    get logger() {
+        return this.instanceLogger;
+    }
+    /**
+     * Connect to the StageLinq network.
+     */
+    async connect() {
+        if (this._isConnected) {
+            LogEmitter_1.Logger.warn('Already connected');
+            return;
+        }
+        this.listener = new network_1.StageLinqListener();
+        const msg = (0, network_1.createDiscoveryMessage)(types_1.Action.Login, this.instanceOptions.actingAs);
+        await (0, network_1.announce)(msg);
+        this.listener.listenForDevices(async (connectionInfo) => {
+            await this.devices.handleDevice(connectionInfo);
+        });
+        this._isConnected = true;
+        this.emit('listening');
+    }
+    /**
+     * Disconnect from the StageLinq network.
+     */
+    async disconnect() {
+        if (!this._isConnected) {
+            LogEmitter_1.Logger.warn('Not connected');
+            return;
+        }
+        try {
+            this.devices.disconnectAll();
+            const msg = (0, network_1.createDiscoveryMessage)(types_1.Action.Logout, this.instanceOptions.actingAs);
+            await (0, network_1.unannounce)(msg);
+            this._isConnected = false;
+            this.emit('disconnected');
+        }
+        catch (e) {
+            this.emit('error', e);
+            throw new Error(e);
+        }
+    }
+    /**
+     * Get the databases manager
+     */
+    get databases() {
+        return this.devices.databases;
+    }
+}
+exports.StageLinqInstance = StageLinqInstance;
+/**
+ * StageLinq static class.
+ * Provides a singleton interface compatible with TS main v1.
+ *
+ * @example
+ * StageLinq.options = { actingAs: ActingAsDevice.NowPlaying };
+ * StageLinq.devices.on('trackLoaded', (track) => console.log(track));
+ * await StageLinq.connect();
+ */
+class StageLinq {
+    /**
+     * Get or set the options for the static instance
+     * Compatible with TS main v1: StageLinq.options = { ... }
+     */
+    static get options() {
+        return this._options;
+    }
+    static set options(value) {
+        this._options = { ...DEFAULT_OPTIONS, ...value };
+        // Reset instance if options change before connection
+        if (this._instance && !this._instance.isConnected) {
+            this._instance = null;
+        }
+    }
+    /**
+     * Get the singleton instance, creating it if necessary
+     */
+    static get instance() {
+        if (!this._instance) {
+            this._instance = new StageLinqInstance(this._options);
+        }
+        return this._instance;
+    }
+    /**
+     * Whether the static instance is currently connected
+     */
+    static get isConnected() {
+        return this._instance?.isConnected ?? false;
+    }
+    /**
+     * Get the devices manager
+     * Compatible with TS main v1: StageLinq.devices
+     */
+    static get devices() {
+        return this.instance.devices;
+    }
+    /**
+     * Get the databases manager
+     */
+    static get databases() {
+        return this.instance.databases;
+    }
+    /**
+     * Get the logger instance
+     * Compatible with TS main v1: StageLinq.logger
+     */
+    static get logger() {
+        return this.instance.logger;
+    }
+    /**
+     * Connect to the StageLinq network
+     * Compatible with TS main v1: await StageLinq.connect()
+     */
+    static async connect() {
+        return this.instance.connect();
+    }
+    /**
+     * Disconnect from the StageLinq network
+     * Compatible with TS main v1: await StageLinq.disconnect()
+     */
+    static async disconnect() {
+        return this.instance.disconnect();
+    }
+    /**
+     * Register an event listener
+     */
+    static on(event, listener) {
+        this.instance.on(event, listener);
+    }
+    /**
+     * Register a one-time event listener
+     */
+    static once(event, listener) {
+        this.instance.once(event, listener);
+    }
+    /**
+     * Remove an event listener
+     */
+    static off(event, listener) {
+        this.instance.off(event, listener);
+    }
+    /**
+     * Remove all listeners for an event
+     */
+    static removeAllListeners(event) {
+        this.instance.removeAllListeners(event);
+    }
+    /**
+     * Emit an event
+     */
+    static emit(event, ...args) {
+        return this.instance.emit(event, ...args);
+    }
+    /**
+     * Reset the static instance (for testing or reconfiguration)
+     */
+    static reset() {
+        if (this._instance) {
+            if (this._instance.isConnected) {
+                LogEmitter_1.Logger.warn('Cannot reset while connected. Call disconnect() first.');
+                return;
+            }
+            this._instance = null;
+        }
+    }
+}
+exports.StageLinq = StageLinq;
+StageLinq._instance = null;
+StageLinq._options = { ...DEFAULT_OPTIONS };
+exports.default = StageLinq;
+//# sourceMappingURL=index.js.map

package/dist/StageLinq/index.js.map

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

package/dist/cli/beatinfo.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * StageLinq BeatInfo CLI Tool
+ *
+ * Connects to a StageLinq device and displays real-time beat information.
+ *
+ * Usage: npx ts-node cli/beatinfo.ts
+ *
+ * Note: This tool requires a StageLinq-compatible device on the network.
+ */
+export {};

package/dist/cli/beatinfo.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * StageLinq BeatInfo CLI Tool
+ *
+ * Connects to a StageLinq device and displays real-time beat information.
+ *
+ * Usage: npx ts-node cli/beatinfo.ts
+ *
+ * Note: This tool requires a StageLinq-compatible device on the network.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const StageLinq_1 = require("../StageLinq");
+const types_1 = require("../types");
+const sleep_1 = require("../utils/sleep");
+require('console-stamp')(console, {
+    format: ':date(HH:MM:ss) :label',
+});
+async function main() {
+    console.log('StageLinq BeatInfo Demo');
+    console.log('=======================');
+    console.log('');
+    console.log('Connecting to StageLinq network...');
+    const stageLinq = new StageLinq_1.StageLinqInstance({
+        actingAs: types_1.ActingAsDevice.NowPlaying,
+        downloadDbSources: false,
+        maxRetries: 3,
+    });
+    // Setup logging
+    stageLinq.logger.on('error', (...args) => console.error(...args));
+    stageLinq.logger.on('warn', (...args) => console.warn(...args));
+    stageLinq.logger.on('info', (...args) => console.info(...args));
+    // Track connection
+    stageLinq.devices.on('connected', (info) => {
+        console.log(`Connected to: ${info.software.name} (${info.address}:${info.port})`);
+    });
+    stageLinq.devices.on('ready', () => {
+        console.log('');
+        console.log('Ready! Listening for beat information...');
+        console.log('Press Ctrl+C to exit.');
+        console.log('');
+    });
+    // Display now playing info
+    stageLinq.devices.on('nowPlaying', (status) => {
+        console.log('');
+        console.log(`Now Playing on ${status.deck}:`);
+        console.log(`  Title:  ${status.title}`);
+        console.log(`  Artist: ${status.artist}`);
+    });
+    // Display state changes (includes beat/BPM info)
+    stageLinq.devices.on('stateChanged', (status) => {
+        // Only show if we have BPM info
+        if (status.currentBpm) {
+            const playState = status.playState ? 'playing' : 'paused';
+            process.stdout.write(`\r[${status.deck}] BPM: ${status.currentBpm.toFixed(1).padStart(6)} | ` +
+                `State: ${playState.padEnd(10)}`);
+        }
+    });
+    // Handle graceful shutdown
+    process.on('SIGINT', async () => {
+        console.log('\n\nShutting down...');
+        try {
+            await stageLinq.disconnect();
+        }
+        catch (err) {
+            console.error('Error during disconnect:', err);
+        }
+        process.exit(0);
+    });
+    // Connect and run
+    try {
+        await stageLinq.connect();
+        // Keep running
+        while (true) {
+            await (0, sleep_1.sleep)(1000);
+        }
+    }
+    catch (err) {
+        console.error('Error:', err);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=beatinfo.js.map

package/dist/cli/beatinfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beatinfo.js","sourceRoot":"","sources":["../../cli/beatinfo.ts"],"names":[],"mappings":";;AACA;;;;;;;;GAQG;;AAEH,4CAAiD;AACjD,oCAA0C;AAC1C,0CAAuC;AAEvC,OAAO,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE;IAChC,MAAM,EAAE,wBAAwB;CACjC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IAElD,MAAM,SAAS,GAAG,IAAI,6BAAiB,CAAC;QACtC,QAAQ,EAAE,sBAAc,CAAC,UAAU;QACnC,iBAAiB,EAAE,KAAK;QACxB,UAAU,EAAE,CAAC;KACd,CAAC,CAAC;IAEH,gBAAgB;IAChB,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,IAAS,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACvE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,IAAS,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACrE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,IAAS,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAErE,mBAAmB;IACnB,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE;QACzC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACjC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,2BAA2B;IAC3B,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;QAC5C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,iDAAiD;IACjD,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE;QAC9C,gCAAgC;QAChC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,MAAM,MAAM,CAAC,IAAI,UAAU,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK;gBACxE,UAAU,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CACjC,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,UAAU,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,kBAAkB;IAClB,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,OAAO,EAAE,CAAC;QAE1B,eAAe;QACf,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,IAAA,aAAK,EAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/cli/discover.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * StageLinq Discovery CLI Tool
+ *
+ * Discovers StageLinq and EAAS devices on the local network.
+ *
+ * Usage: npx ts-node cli/discover.ts [--timeout=5000] [--eaas]
+ */
+export {};

package/dist/cli/discover.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * StageLinq Discovery CLI Tool
+ *
+ * Discovers StageLinq and EAAS devices on the local network.
+ *
+ * Usage: npx ts-node cli/discover.ts [--timeout=5000] [--eaas]
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const network_1 = require("../network");
+const __1 = require("../");
+require('console-stamp')(console, {
+    format: ':date(HH:MM:ss) :label',
+});
+function parseArgs() {
+    const args = process.argv.slice(2);
+    let timeout = 5000;
+    let includeEAAS = false;
+    for (const arg of args) {
+        if (arg.startsWith('--timeout=')) {
+            timeout = parseInt(arg.split('=')[1], 10);
+        }
+        else if (arg === '--eaas') {
+            includeEAAS = true;
+        }
+        else if (arg === '--help' || arg === '-h') {
+            console.log('Usage: npx ts-node cli/discover.ts [options]');
+            console.log('');
+            console.log('Options:');
+            console.log('  --timeout=<ms>  Discovery timeout in milliseconds (default: 5000)');
+            console.log('  --eaas          Also discover EAAS devices');
+            console.log('  --help, -h      Show this help message');
+            process.exit(0);
+        }
+    }
+    return { timeout, includeEAAS };
+}
+async function discoverStageLinq(timeout) {
+    const devices = [];
+    const seen = new Set();
+    return new Promise((resolve) => {
+        const listener = new network_1.StageLinqListener();
+        listener.listenForDevices((info) => {
+            const key = `${info.address}:${info.port}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                devices.push(info);
+                console.log('');
+                console.log(`StageLinq Device Found:`);
+                console.log(`  Name:     ${info.software.name}`);
+                console.log(`  Version:  ${info.software.version}`);
+                console.log(`  Address:  ${info.address}:${info.port}`);
+                console.log(`  Source:   ${info.source}`);
+                console.log(`  Token:    ${(0, __1.formatToken)(info.token)}`);
+                console.log(`  Action:   ${info.action}`);
+            }
+        });
+        setTimeout(() => {
+            resolve(devices);
+        }, timeout);
+    });
+}
+async function discoverEAAS(timeout) {
+    const discoverer = new __1.EAAS.EAASDiscoverer({ timeout });
+    discoverer.on('discovered', (device) => {
+        console.log('');
+        console.log(`EAAS Device Found:`);
+        console.log(`  Hostname: ${device.hostname}`);
+        console.log(`  Version:  ${device.softwareVersion}`);
+        console.log(`  Address:  ${device.address}`);
+        console.log(`  gRPC:     ${device.address}:${device.grpcPort}`);
+        console.log(`  HTTP:     ${device.address}:${device.httpPort}`);
+        console.log(`  Token:    ${(0, __1.formatToken)(device.token)}`);
+    });
+    await discoverer.discover();
+}
+async function main() {
+    const options = parseArgs();
+    console.log(`Discovering devices (timeout: ${options.timeout}ms)...`);
+    console.log('');
+    const promises = [
+        discoverStageLinq(options.timeout),
+    ];
+    if (options.includeEAAS) {
+        promises.push(discoverEAAS(options.timeout));
+    }
+    await Promise.all(promises);
+    console.log('');
+    console.log('Discovery complete.');
+    process.exit(0);
+}
+main().catch((err) => {
+    console.error('Error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=discover.js.map

package/dist/cli/discover.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1 @@
+export {};