@ecobridge.xyz/devicemanager 3.0.2

package/dist_ts/features/feature.switch.js

@@ -0,0 +1,126 @@
+/**
+ * Switch Feature
+ * Provides binary on/off control for smart switches, outlets, etc.
+ */
+import { Feature } from './feature.abstract.js';
+/**
+ * Switch Feature - binary on/off control
+ *
+ * Protocol-agnostic: works with Home Assistant, MQTT, Tasmota, Tuya, etc.
+ *
+ * @example
+ * ```typescript
+ * const sw = device.getFeature<SwitchFeature>('switch');
+ * if (sw) {
+ *   await sw.turnOn();
+ *   await sw.toggle();
+ *   console.log(`Switch is ${sw.isOn ? 'on' : 'off'}`);
+ * }
+ * ```
+ */
+export class SwitchFeature extends Feature {
+    type = 'switch';
+    protocol;
+    /** Entity ID (e.g., "switch.living_room") */
+    entityId;
+    /** Capabilities */
+    capabilities;
+    /** Current state */
+    _isOn = false;
+    /** Protocol client for controlling the switch */
+    protocolClient;
+    constructor(device, port, options) {
+        super(device, port, options);
+        this.protocol = options.protocol;
+        this.entityId = options.entityId;
+        this.protocolClient = options.protocolClient;
+        this.capabilities = {
+            deviceClass: options.deviceClass,
+        };
+    }
+    // ============================================================================
+    // Properties
+    // ============================================================================
+    /**
+     * Get current on/off state (cached)
+     */
+    get isOn() {
+        return this._isOn;
+    }
+    // ============================================================================
+    // Connection
+    // ============================================================================
+    async doConnect() {
+        // Fetch initial state
+        try {
+            const state = await this.protocolClient.getState(this.entityId);
+            this._isOn = state.isOn;
+        }
+        catch {
+            // Ignore errors fetching initial state
+        }
+    }
+    async doDisconnect() {
+        // Nothing to disconnect
+    }
+    // ============================================================================
+    // Switch Control
+    // ============================================================================
+    /**
+     * Turn on the switch
+     */
+    async turnOn() {
+        await this.protocolClient.turnOn(this.entityId);
+        this._isOn = true;
+        this.emit('state:changed', { isOn: true });
+    }
+    /**
+     * Turn off the switch
+     */
+    async turnOff() {
+        await this.protocolClient.turnOff(this.entityId);
+        this._isOn = false;
+        this.emit('state:changed', { isOn: false });
+    }
+    /**
+     * Toggle the switch
+     */
+    async toggle() {
+        await this.protocolClient.toggle(this.entityId);
+        this._isOn = !this._isOn;
+        this.emit('state:changed', { isOn: this._isOn });
+    }
+    /**
+     * Refresh state from the device
+     */
+    async refreshState() {
+        const state = await this.protocolClient.getState(this.entityId);
+        this._isOn = state.isOn;
+        return state;
+    }
+    /**
+     * Update state from external source (e.g., state change event)
+     */
+    updateState(state) {
+        const changed = this._isOn !== state.isOn;
+        this._isOn = state.isOn;
+        if (changed) {
+            this.emit('state:changed', state);
+        }
+    }
+    // ============================================================================
+    // Feature Info
+    // ============================================================================
+    getFeatureInfo() {
+        return {
+            ...this.getBaseFeatureInfo(),
+            type: 'switch',
+            protocol: this.protocol,
+            capabilities: this.capabilities,
+            currentState: {
+                isOn: this._isOn,
+            },
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVhdHVyZS5zd2l0Y2guanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9mZWF0dXJlcy9mZWF0dXJlLnN3aXRjaC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7O0dBR0c7QUFFSCxPQUFPLEVBQUUsT0FBTyxFQUF5QixNQUFNLHVCQUF1QixDQUFDO0FBd0J2RTs7Ozs7Ozs7Ozs7Ozs7R0FjRztBQUNILE1BQU0sT0FBTyxhQUFjLFNBQVEsT0FBTztJQUN4QixJQUFJLEdBQUcsUUFBaUIsQ0FBQztJQUN6QixRQUFRLENBQWtCO0lBRTFDLDZDQUE2QztJQUM3QixRQUFRLENBQVM7SUFFakMsbUJBQW1CO0lBQ0gsWUFBWSxDQUFzQjtJQUVsRCxvQkFBb0I7SUFDVixLQUFLLEdBQVksS0FBSyxDQUFDO0lBRWpDLGlEQUFpRDtJQUN6QyxjQUFjLENBQXdCO0lBRTlDLFlBQ0UsTUFBd0IsRUFDeEIsSUFBWSxFQUNaLE9BQThCO1FBRTlCLEtBQUssQ0FBQyxNQUFNLEVBQUUsSUFBSSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBQzdCLElBQUksQ0FBQyxRQUFRLEdBQUcsT0FBTyxDQUFDLFFBQVEsQ0FBQztRQUNqQyxJQUFJLENBQUMsUUFBUSxHQUFHLE9BQU8sQ0FBQyxRQUFRLENBQUM7UUFDakMsSUFBSSxDQUFDLGNBQWMsR0FBRyxPQUFPLENBQUMsY0FBYyxDQUFDO1FBQzdDLElBQUksQ0FBQyxZQUFZLEdBQUc7WUFDbEIsV0FBVyxFQUFFLE9BQU8sQ0FBQyxXQUFXO1NBQ2pDLENBQUM7SUFDSixDQUFDO0lBRUQsK0VBQStFO0lBQy9FLGFBQWE7SUFDYiwrRUFBK0U7SUFFL0U7O09BRUc7SUFDSCxJQUFXLElBQUk7UUFDYixPQUFPLElBQUksQ0FBQyxLQUFLLENBQUM7SUFDcEIsQ0FBQztJQUVELCtFQUErRTtJQUMvRSxhQUFhO0lBQ2IsK0VBQStFO0lBRXJFLEtBQUssQ0FBQyxTQUFTO1FBQ3ZCLHNCQUFzQjtRQUN0QixJQUFJLENB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

package/dist_ts/features/feature.volume.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Volume Feature
+ * Provides volume control capability
+ */
+import { Feature, type TDeviceReference } from './feature.abstract.js';
+import type { IVolumeFeatureInfo, IFeatureOptions } from '../interfaces/feature.interfaces.js';
+/**
+ * Options for creating a VolumeFeature
+ */
+export interface IVolumeFeatureOptions extends IFeatureOptions {
+    /** Volume control protocol (usually same as device protocol) */
+    volumeProtocol?: string;
+    /** Minimum volume level */
+    minVolume?: number;
+    /** Maximum volume level */
+    maxVolume?: number;
+    /** Volume step increment */
+    volumeStep?: number;
+    /** Whether mute is supported */
+    supportsMute?: boolean;
+    /** Protocol-specific volume controller */
+    volumeController?: IVolumeController;
+}
+/**
+ * Interface for protocol-specific volume control
+ */
+export interface IVolumeController {
+    getVolume(): Promise<number>;
+    setVolume(level: number): Promise<void>;
+    getMute(): Promise<boolean>;
+    setMute(muted: boolean): Promise<void>;
+}
+/**
+ * Volume Feature - provides volume control capability
+ *
+ * Separated from PlaybackFeature because some devices have volume control
+ * without playback capability (e.g., amplifiers, HDMI matrix switches).
+ *
+ * @example
+ * ```typescript
+ * const volume = device.getFeature<VolumeFeature>('volume');
+ * if (volume) {
+ *   const current = await volume.getVolume();
+ *   await volume.setVolume(current + 10);
+ *   await volume.toggleMute();
+ * }
+ * ```
+ */
+export declare class VolumeFeature extends Feature {
+    readonly type: "volume";
+    readonly protocol: string;
+    readonly minVolume: number;
+    readonly maxVolume: number;
+    readonly volumeStep: number;
+    readonly supportsMute: boolean;
+    protected _volume: number;
+    protected _muted: boolean;
+    protected volumeController: IVolumeController | null;
+    constructor(device: TDeviceReference, port: number, options?: IVolumeFeatureOptions);
+    /**
+     * Get current volume level (cached)
+     */
+    get volume(): number;
+    /**
+     * Get mute state (cached)
+     */
+    get muted(): boolean;
+    protected doConnect(): Promise<void>;
+    protected doDisconnect(): Promise<void>;
+    /**
+     * Get current volume level
+     */
+    getVolume(): Promise<number>;
+    /**
+     * Set volume level
+     * @param level Volume level (clamped to min/max)
+     */
+    setVolume(level: number): Promise<void>;
+    /**
+     * Increase volume by step
+     */
+    volumeUp(step?: number): Promise<number>;
+    /**
+     * Decrease volume by step
+     */
+    volumeDown(step?: number): Promise<number>;
+    /**
+     * Get mute state
+     */
+    getMute(): Promise<boolean>;
+    /**
+     * Set mute state
+     */
+    setMute(muted: boolean): Promise<void>;
+    /**
+     * Toggle mute state
+     */
+    toggleMute(): Promise<boolean>;
+    getFeatureInfo(): IVolumeFeatureInfo;
+    /**
+     * Create from discovery metadata
+     */
+    static fromDiscovery(device: TDeviceReference, port: number, protocol: string, metadata: Record<string, unknown>): VolumeFeature;
+}

package/dist_ts/features/feature.volume.js

@@ -0,0 +1,186 @@
+/**
+ * Volume Feature
+ * Provides volume control capability
+ */
+import { Feature } from './feature.abstract.js';
+/**
+ * Volume Feature - provides volume control capability
+ *
+ * Separated from PlaybackFeature because some devices have volume control
+ * without playback capability (e.g., amplifiers, HDMI matrix switches).
+ *
+ * @example
+ * ```typescript
+ * const volume = device.getFeature<VolumeFeature>('volume');
+ * if (volume) {
+ *   const current = await volume.getVolume();
+ *   await volume.setVolume(current + 10);
+ *   await volume.toggleMute();
+ * }
+ * ```
+ */
+export class VolumeFeature extends Feature {
+    type = 'volume';
+    protocol;
+    // Capabilities
+    minVolume;
+    maxVolume;
+    volumeStep;
+    supportsMute;
+    // Current state
+    _volume = 0;
+    _muted = false;
+    // Volume controller (protocol-specific)
+    volumeController = null;
+    constructor(device, port, options) {
+        super(device, port, options);
+        this.protocol = options?.volumeProtocol ?? 'generic';
+        this.minVolume = options?.minVolume ?? 0;
+        this.maxVolume = options?.maxVolume ?? 100;
+        this.volumeStep = options?.volumeStep ?? 5;
+        this.supportsMute = options?.supportsMute ?? true;
+        if (options?.volumeController) {
+            this.volumeController = options.volumeController;
+        }
+    }
+    // ============================================================================
+    // Properties
+    // ============================================================================
+    /**
+     * Get current volume level (cached)
+     */
+    get volume() {
+        return this._volume;
+    }
+    /**
+     * Get mute state (cached)
+     */
+    get muted() {
+        return this._muted;
+    }
+    // ============================================================================
+    // Connection
+    // ============================================================================
+    async doConnect() {
+        // Fetch initial state if we have a controller
+        if (this.volumeController) {
+            try {
+                this._volume = await this.volumeController.getVolume();
+                this._muted = await this.volumeController.getMute();
+            }
+            catch {
+                // Ignore errors fetching initial state
+            }
+        }
+    }
+    async doDisconnect() {
+        // Nothing to disconnect for volume control
+    }
+    // ============================================================================
+    // Volume Control
+    // ============================================================================
+    /**
+     * Get current volume level
+     */
+    async getVolume() {
+        if (this.volumeController) {
+            this._volume = await this.volumeController.getVolume();
+        }
+        return this._volume;
+    }
+    /**
+     * Set volume level
+     * @param level Volume level (clamped to min/max)
+     */
+    async setVolume(level) {
+        const clampedLevel = Math.max(this.minVolume, Math.min(this.maxVolume, level));
+        if (this.volumeController) {
+            await this.volumeController.setVolume(clampedLevel);
+        }
+        const oldVolume = this._volume;
+        this._volume = clampedLevel;
+        if (oldVolume !== clampedLevel) {
+            this.emit('volume:changed', { oldVolume, newVolume: clampedLevel });
+        }
+    }
+    /**
+     * Increase volume by step
+     */
+    async volumeUp(step) {
+        const increment = step ?? this.volumeStep;
+        const newVolume = Math.min(this.maxVolume, this._volume + increment);
+        await this.setVolume(newVolume);
+        return this._volume;
+    }
+    /**
+     * Decrease volume by step
+     */
+    async volumeDown(step) {
+        const decrement = step ?? this.volumeStep;
+        const newVolume = Math.max(this.minVolume, this._volume - decrement);
+        await this.setVolume(newVolume);
+        return this._volume;
+    }
+    /**
+     * Get mute state
+     */
+    async getMute() {
+        if (this.volumeController && this.supportsMute) {
+            this._muted = await this.volumeController.getMute();
+        }
+        return this._muted;
+    }
+    /**
+     * Set mute state
+     */
+    async setMute(muted) {
+        if (!this.supportsMute) {
+            throw new Error('Mute not supported');
+        }
+        if (this.volumeController) {
+            await this.volumeController.setMute(muted);
+        }
+        const oldMuted = this._muted;
+        this._muted = muted;
+        if (oldMuted !== muted) {
+            this.emit('mute:changed', { oldMuted, newMuted: muted });
+        }
+    }
+    /**
+     * Toggle mute state
+     */
+    async toggleMute() {
+        const currentMuted = await this.getMute();
+        await this.setMute(!currentMuted);
+        return this._muted;
+    }
+    // ============================================================================
+    // Serialization
+    // ============================================================================
+    getFeatureInfo() {
+        return {
+            ...this.getBaseFeatureInfo(),
+            type: 'volume',
+            minVolume: this.minVolume,
+            maxVolume: this.maxVolume,
+            volumeStep: this.volumeStep,
+            supportsMute: this.supportsMute,
+        };
+    }
+    // ============================================================================
+    // Static Factory
+    // ============================================================================
+    /**
+     * Create from discovery metadata
+     */
+    static fromDiscovery(device, port, protocol, metadata) {
+        return new VolumeFeature(device, port, {
+            volumeProtocol: protocol,
+            minVolume: metadata.minVolume ?? 0,
+            maxVolume: metadata.maxVolume ?? 100,
+            volumeStep: metadata.volumeStep ?? 5,
+            supportsMute: metadata.supportsMute ?? true,
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVhdHVyZS52b2x1bWUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9mZWF0dXJlcy9mZWF0dXJlLnZvbHVtZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7O0dBR0c7QUFFSCxPQUFPLEVBQUUsT0FBTyxFQUF5QixNQUFNLHVCQUF1QixDQUFDO0FBa0N2RTs7Ozs7Ozs7Ozs7Ozs7O0dBZUc7QUFDSCxNQUFNLE9BQU8sYUFBYyxTQUFRLE9BQU87SUFDeEIsSUFBSSxHQUFHLFFBQWlCLENBQUM7SUFDekIsUUFBUSxDQUFTO0lBRWpDLGVBQWU7SUFDQyxTQUFTLENBQVM7SUFDbEIsU0FBUyxDQUFTO0lBQ2xCLFVBQVUsQ0FBUztJQUNuQixZQUFZLENBQVU7SUFFdEMsZ0JBQWdCO0lBQ04sT0FBTyxHQUFXLENBQUMsQ0FBQztJQUNwQixNQUFNLEdBQVksS0FBSyxDQUFDO0lBRWxDLHdDQUF3QztJQUM5QixnQkFBZ0IsR0FBNkIsSUFBSSxDQUFDO0lBRTVELFlBQ0UsTUFBd0IsRUFDeEIsSUFBWSxFQUNaLE9BQStCO1FBRS9CLEtBQUssQ0FBQyxNQUFNLEVBQUUsSUFBSSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBQzdCLElBQUksQ0FBQyxRQUFRLEdBQUcsT0FBTyxFQUFFLGNBQWMsSUFBSSxTQUFTLENBQUM7UUFDckQsSUFBSSxDQUFDLFNBQVMsR0FBRyxPQUFPLEVBQUUsU0FBUyxJQUFJLENBQUMsQ0FBQztRQUN6QyxJQUFJLENBQUMsU0FBUyxHQUFHLE9BQU8sRUFBRSxTQUFTLElBQUksR0FBRyxDQUFDO1FBQzNDLElBQUksQ0FBQyxVQUFVLEdBQUcsT0FBTyxFQUFFLFVBQVUsSUFBSSxDQUFDLENBQUM7UUFDM0MsSUFBSSxDQUFDLFlBQVksR0FBRyxPQUFPLEVBQUUsWUFBWSxJQUFJLElBQUksQ0FBQztRQUVsRCxJQUFJLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxDQUFDO1lBQzlCLElBQUksQ0FBQyxnQkFBZ0IsR0FBRyxP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

package/dist_ts/features/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Features Module
+ * Exports all feature classes and types
+ */
+export { Feature, type TDeviceReference } from './feature.abstract.js';
+export { ScanFeature, type IScanFeatureOptions } from './feature.scan.js';
+export { PrintFeature, type IPrintFeatureOptions } from './feature.print.js';
+export { PlaybackFeature, type IPlaybackFeatureOptions } from './feature.playback.js';
+export { VolumeFeature, type IVolumeFeatureOptions, type IVolumeController } from './feature.volume.js';
+export { PowerFeature, type IPowerFeatureOptions } from './feature.power.js';
+export { SnmpFeature, type ISnmpFeatureOptions } from './feature.snmp.js';
+export { SwitchFeature, type ISwitchFeatureOptions } from './feature.switch.js';
+export { SensorFeature, type ISensorFeatureOptions } from './feature.sensor.js';
+export { LightFeature, type ILightFeatureOptions } from './feature.light.js';
+export { CoverFeature, type ICoverFeatureOptions } from './feature.cover.js';
+export { LockFeature, type ILockFeatureOptions } from './feature.lock.js';
+export { FanFeature, type IFanFeatureOptions } from './feature.fan.js';
+export { ClimateFeature, type IClimateFeatureOptions } from './feature.climate.js';
+export { CameraFeature, type ICameraFeatureOptions } from './feature.camera.js';

package/dist_ts/features/index.js

@@ -0,0 +1,23 @@
+/**
+ * Features Module
+ * Exports all feature classes and types
+ */
+// Abstract base
+export { Feature } from './feature.abstract.js';
+// Concrete features - Document/Infrastructure
+export { ScanFeature } from './feature.scan.js';
+export { PrintFeature } from './feature.print.js';
+export { PlaybackFeature } from './feature.playback.js';
+export { VolumeFeature } from './feature.volume.js';
+export { PowerFeature } from './feature.power.js';
+export { SnmpFeature } from './feature.snmp.js';
+// Smart Home Features (protocol-agnostic: home-assistant, hue, mqtt, etc.)
+export { SwitchFeature } from './feature.switch.js';
+export { SensorFeature } from './feature.sensor.js';
+export { LightFeature } from './feature.light.js';
+export { CoverFeature } from './feature.cover.js';
+export { LockFeature } from './feature.lock.js';
+export { FanFeature } from './feature.fan.js';
+export { ClimateFeature } from './feature.climate.js';
+export { CameraFeature } from './feature.camera.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9mZWF0dXJlcy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7O0dBR0c7QUFFSCxnQkFBZ0I7QUFDaEIsT0FBTyxFQUFFLE9BQU8sRUFBeUIsTUFBTSx1QkFBdUIsQ0FBQztBQUV2RSw4Q0FBOEM7QUFDOUMsT0FBTyxFQUFFLFdBQVcsRUFBNEIsTUFBTSxtQkFBbUIsQ0FBQztBQUMxRSxPQUFPLEVBQUUsWUFBWSxFQUE2QixNQUFNLG9CQUFvQixDQUFDO0FBQzdFLE9BQU8sRUFBRSxlQUFlLEVBQWdDLE1BQU0sdUJBQXVCLENBQUM7QUFDdEYsT0FBTyxFQUFFLGFBQWEsRUFBc0QsTUFBTSxxQkFBcUIsQ0FBQztBQUN4RyxPQUFPLEVBQUUsWUFBWSxFQUE2QixNQUFNLG9CQUFvQixDQUFDO0FBQzdFLE9BQU8sRUFBRSxXQUFXLEVBQTRCLE1BQU0sbUJBQW1CLENBQUM7QUFFMUUsMkVBQTJFO0FBQzNFLE9BQU8sRUFBRSxhQUFhLEVBQThCLE1BQU0scUJBQXFCLENBQUM7QUFDaEYsT0FBTyxFQUFFLGFBQWEsRUFBOEIsTUFBTSxxQkFBcUIsQ0FBQztBQUNoRixPQUFPLEVBQUUsWUFBWSxFQUE2QixNQUFNLG9CQUFvQixDQUFDO0FBQzdFLE9BQU8sRUFBRSxZQUFZLEVBQTZCLE1BQU0sb0JBQW9CLENBQUM7QUFDN0UsT0FBTyxFQUFFLFdBQVcsRUFBNEIsTUFBTSxtQkFBbUIsQ0FBQztBQUMxRSxPQUFPLEVBQUUsVUFBVSxFQUEyQixNQUFNLGtCQUFrQixDQUFDO0FBQ3ZFLE9BQU8sRUFBRSxjQUFjLEVBQStCLE1BQU0sc0JBQXNCLENBQUM7QUFDbkYsT0FBTyxFQUFFLGFBQWEsRUFBOEIsTUFBTSxxQkFBcUIsQ0FBQyJ9

package/dist_ts/helpers/helpers.iprange.d.ts

@@ -0,0 +1,35 @@
+/**
+ * IP Range utility functions for network scanning
+ */
+/**
+ * Validates an IPv4 address
+ */
+export declare function isValidIp(ip: string): boolean;
+/**
+ * Converts an IPv4 address to a 32-bit number
+ */
+export declare function ipToNumber(ip: string): number;
+/**
+ * Converts a 32-bit number to an IPv4 address
+ */
+export declare function numberToIp(num: number): string;
+/**
+ * Generates an array of IP addresses from a start to end range
+ * Excludes network address (.0) and broadcast address (.255) for /24 ranges
+ */
+export declare function ipRangeToIps(startIp: string, endIp: string): string[];
+/**
+ * Parses CIDR notation and returns an array of usable host IPs
+ * Excludes network address and broadcast address
+ * Example: "192.168.1.0/24" returns 192.168.1.1 through 192.168.1.254
+ */
+export declare function cidrToIps(cidr: string): string[];
+/**
+ * Gets the local network interfaces and returns the first non-loopback IPv4 subnet
+ * Returns CIDR notation (e.g., "192.168.1.0/24")
+ */
+export declare function getLocalSubnet(): string | null;
+/**
+ * Counts the number of IPs in a CIDR range (excluding network and broadcast)
+ */
+export declare function countIpsInCidr(cidr: string): number;

package/dist_ts/helpers/helpers.iprange.js

@@ -0,0 +1,151 @@
+/**
+ * IP Range utility functions for network scanning
+ */
+import * as os from 'os';
+/**
+ * Validates an IPv4 address
+ */
+export function isValidIp(ip) {
+    const parts = ip.split('.');
+    if (parts.length !== 4)
+        return false;
+    return parts.every((part) => {
+        const num = parseInt(part, 10);
+        return !isNaN(num) && num >= 0 && num <= 255 && part === num.toString();
+    });
+}
+/**
+ * Converts an IPv4 address to a 32-bit number
+ */
+export function ipToNumber(ip) {
+    const parts = ip.split('.').map((p) => parseInt(p, 10));
+    return ((parts[0] << 24) | (parts[1] << 16) | (parts[2] << 8) | parts[3]) >>> 0;
+}
+/**
+ * Converts a 32-bit number to an IPv4 address
+ */
+export function numberToIp(num) {
+    return [
+        (num >>> 24) & 255,
+        (num >>> 16) & 255,
+        (num >>> 8) & 255,
+        num & 255,
+    ].join('.');
+}
+/**
+ * Generates an array of IP addresses from a start to end range
+ * Excludes network address (.0) and broadcast address (.255) for /24 ranges
+ */
+export function ipRangeToIps(startIp, endIp) {
+    if (!isValidIp(startIp) || !isValidIp(endIp)) {
+        throw new Error(`Invalid IP address: ${!isValidIp(startIp) ? startIp : endIp}`);
+    }
+    const start = ipToNumber(startIp);
+    const end = ipToNumber(endIp);
+    if (start > end) {
+        throw new Error(`Start IP (${startIp}) must be less than or equal to end IP (${endIp})`);
+    }
+    const ips = [];
+    for (let i = start; i <= end; i++) {
+        ips.push(numberToIp(i));
+    }
+    return ips;
+}
+/**
+ * Parses CIDR notation and returns an array of usable host IPs
+ * Excludes network address and broadcast address
+ * Example: "192.168.1.0/24" returns 192.168.1.1 through 192.168.1.254
+ */
+export function cidrToIps(cidr) {
+    const match = cidr.match(/^(\d+\.\d+\.\d+\.\d+)\/(\d+)$/);
+    if (!match) {
+        throw new Error(`Invalid CIDR notation: ${cidr}`);
+    }
+    const [, networkIp, prefixStr] = match;
+    const prefix = parseInt(prefixStr, 10);
+    if (!isValidIp(networkIp)) {
+        throw new Error(`Invalid network address: ${networkIp}`);
+    }
+    if (prefix < 0 || prefix > 32) {
+        throw new Error(`Invalid prefix length: ${prefix}`);
+    }
+    // For /32, just return the single IP
+    if (prefix === 32) {
+        return [networkIp];
+    }
+    // For /31 (point-to-point), return both IPs
+    if (prefix === 31) {
+        const networkNum = ipToNumber(networkIp);
+        const mask = (0xffffffff << (32 - prefix)) >>> 0;
+        const network = (networkNum & mask) >>> 0;
+        return [numberToIp(network), numberToIp(network + 1)];
+    }
+    // Calculate network and broadcast addresses
+    const networkNum = ipToNumber(networkIp);
+    const mask = (0xffffffff << (32 - prefix)) >>> 0;
+    const network = (networkNum & mask) >>> 0;
+    const broadcast = (network | (~mask >>> 0)) >>> 0;
+    // Generate usable host IPs (exclude network and broadcast)
+    const ips = [];
+    for (let i = network + 1; i < broadcast; i++) {
+        ips.push(numberToIp(i));
+    }
+    return ips;
+}
+/**
+ * Gets the local network interfaces and returns the first non-loopback IPv4 subnet
+ * Returns CIDR notation (e.g., "192.168.1.0/24")
+ */
+export function getLocalSubnet() {
+    try {
+        const interfaces = os.networkInterfaces();
+        for (const name of Object.keys(interfaces)) {
+            const iface = interfaces[name];
+            if (!iface)
+                continue;
+            for (const info of iface) {
+                // Skip loopback and non-IPv4
+                if (info.family !== 'IPv4' || info.internal)
+                    continue;
+                // Calculate the network address from IP and netmask
+                const ip = ipToNumber(info.address);
+                const mask = ipToNumber(info.netmask);
+                const network = (ip & mask) >>> 0;
+                // Calculate prefix length from netmask
+                const maskBits = info.netmask.split('.').reduce((acc, octet) => {
+                    const byte = parseInt(octet, 10);
+                    let bits = 0;
+                    for (let i = 7; i >= 0; i--) {
+                        if ((byte >> i) & 1)
+                            bits++;
+                        else
+                            break;
+                    }
+                    return acc + bits;
+                }, 0);
+                return `${numberToIp(network)}/${maskBits}`;
+            }
+        }
+    }
+    catch {
+        // Failed to get network interfaces
+    }
+    return null;
+}
+/**
+ * Counts the number of IPs in a CIDR range (excluding network and broadcast)
+ */
+export function countIpsInCidr(cidr) {
+    const match = cidr.match(/^(\d+\.\d+\.\d+\.\d+)\/(\d+)$/);
+    if (!match) {
+        throw new Error(`Invalid CIDR notation: ${cidr}`);
+    }
+    const prefix = parseInt(match[2], 10);
+    if (prefix === 32)
+        return 1;
+    if (prefix === 31)
+        return 2;
+    // 2^(32-prefix) - 2 (minus network and broadcast)
+    return Math.pow(2, 32 - prefix) - 2;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGVscGVycy5pcHJhbmdlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvaGVscGVycy9oZWxwZXJzLmlwcmFuZ2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7O0dBRUc7QUFFSCxPQUFPLEtBQUssRUFBRSxNQUFNLElBQUksQ0FBQztBQUV6Qjs7R0FFRztBQUNILE1BQU0sVUFBVSxTQUFTLENBQUMsRUFBVTtJQUNsQyxNQUFNLEtBQUssR0FBRyxFQUFFLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQzVCLElBQUksS0FBSyxDQUFDLE1BQU0sS0FBSyxDQUFDO1FBQUUsT0FBTyxLQUFLLENBQUM7SUFFckMsT0FBTyxLQUFLLENBQUMsS0FBSyxDQUFDLENBQUMsSUFBSSxFQUFFLEVBQUU7UUFDMUIsTUFBTSxHQUFHLEdBQUcsUUFBUSxDQUFDLElBQUksRUFBRSxFQUFFLENBQUMsQ0FBQztRQUMvQixPQUFPLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxJQUFJLEdBQUcsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLEdBQUcsSUFBSSxJQUFJLEtBQUssR0FBRyxDQUFDLFFBQVEsRUFBRSxDQUFDO0lBQzFFLENBQUMsQ0FBQyxDQUFDO0FBQ0wsQ0FBQztBQUVEOztHQUVHO0FBQ0gsTUFBTSxVQUFVLFVBQVUsQ0FBQyxFQUFVO0lBQ25DLE1BQU0sS0FBSyxHQUFHLEVBQUUsQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxRQUFRLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUM7SUFDeEQsT0FBTyxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxHQUFHLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQztBQUNsRixDQUFDO0FBRUQ7O0dBRUc7QUFDSCxNQUFNLFVBQVUsVUFBVSxDQUFDLEdBQVc7SUFDcEMsT0FBTztRQUNMLENBQUMsR0FBRyxLQUFLLEVBQUUsQ0FBQyxHQUFHLEdBQUc7UUFDbEIsQ0FBQyxHQUFHLEtBQUssRUFBRSxDQUFDLEdBQUcsR0FBRztRQUNsQixDQUFDLEdBQUcsS0FBSyxDQUFDLENBQUMsR0FBRyxHQUFHO1FBQ2pCLEdBQUcsR0FBRyxHQUFHO0tBQ1YsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUM7QUFDZCxDQUFDO0FBRUQ7OztHQUdHO0FBQ0gsTUFBTSxVQUFVLFlBQVksQ0FBQyxPQUFlLEVBQUUsS0FBYTtJQUN6RCxJQUFJLENBQUMsU0FBUyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDN0MsTUFBTSxJQUFJLEtBQUssQ0FBQyx1QkFBdUIsQ0FBQyxTQUFTLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsS0FBSyxFQUFFLENBQUMsQ0FBQztJQUNsRixDQUFDO0lBRUQsTUFBTSxLQUFLLEdBQUcsVUFBVSxDQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQ2xDLE1BQU0sR0FBRyxHQUFHLFVBQVUsQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUU5QixJQUFJLEtBQUssR0FBRyxHQUFHLEVBQUUsQ0FBQztRQUNoQixNQUFNLElBQUksS0FBSyxDQUFDLGFBQWEsT0FBTywyQ0FBMkMsS0FBSyxHQUFHLENBQUMsQ0FBQztJQUMzRixDQUFDO0lBRUQsTUFBTSxHQUFHLEdBQWEsRUFBRSxDQUFDO0lBQ3pCLEtBQUssSUFBSSxDQUFDLEdBQUcsS0FBSyxFQUFFLENBQUMsSUFBSSxHQUFHLEVBQUUsQ0FBQyxFQUFFLEVBQUUsQ0FBQztRQUNsQyxHQUFHLENBQUMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBQzFCLENBQUM7SUFFRCxPQUFPLEdBQUcsQ0FBQztBQUNiLENBQUM7QUFFRDs7OztHQUlHO0FBQ0gsTUFBTSxVQUFVLFNBQVMsQ0FBQyxJQUFZO0lBQ3BDLE1BQU0sS0FBSyxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsK0JBQStCLENBQUMsQ0FBQztJQUMxRCxJQUFJLENBQUMsS0FBSyxFQUFFLENBQUM7UUFDWCxNQUFNLElBQUksS0FBSyxDQUFDLDBCQUEwQixJQUFJLEVBQUUsQ0FBQyxDQUFDO0lBQ3BELENBQUM7SUFFRCxNQUFNLENBQUMsRUFBRSxTQUFTLEVBQUUsU0FBUyxDQUFDLEdBQUcsS0FBSyxDQUFDO0lBQ3ZDLE1BQU0sTUFBTSxHQUFHLFFBQVEsQ0FBQyxTQUFTLEVBQUUsRUFBRSxDQUFDLENBQUM7SUFFdkMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxTQUFTLENBQUMsRUFBRSxDQUFDO1FBQzFCLE1BQU0sSUFBSSxLQUFLLENBQUMsNEJBQTRCLFNBQVMsRUFBRSxDQUFDLENBQUM7SUFDM0QsQ0FBQztJQUVELElBQUksTUFBTSxHQUFHLENBQUMsSUFBSSxNQUFNLEdBQUcsRUFBRSxFQUFFLENBQUM7UUFDOUIsTUFBTSxJQUFJLEtBQUssQ0FBQywwQkFBMEIsTUFBTSxFQUFFLENBQUMsQ0FBQztJQUN0RCxDQUFDO0lBRUQscUNBQXFDO0lBQ3JDLElBQUksTUFBTSxLQUFLLEVBQUUsRUFBRSxDQUFDO1FBQ2xCLE9BQU8sQ0FBQyxTQUFTLENBQUMsQ0FBQztJQUNyQixDQUFDO0lBRUQsNENBQTRDO0lBQzVDLElBQUksTUFBTSxLQUFLLEVBQUUsRUFBRSxDQUFDO1FBQ2xCLE1BQU0sVUFBVSxHQUFHLFVBQVUsQ0FBQyxTQUFTLENBQUMsQ0FBQztRQUN6QyxNQUFNLElBQUksR0FBRyxDQUFDLFVBQVUsSUFBSSxDQUFDLEVBQUUsR0FBRyxNQUFNLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUNqRCxNQUFNLE9BQU8sR0FBRyxDQUFDLFVBQVUsR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDMUMsT0FBTyxDQUFDLFVBQVUsQ0FBQyxPQUFPLENBQUMsRUFBRSxVQUFVLENBQUMsT0FBTyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDeEQsQ0FBQztJQUVELDRDQUE0QztJQUM1QyxNQUFNLFVBQVUsR0FBRyxVQUFVLENBQUMsU0FBUyxDQUFDLENBQUM7SUFDekMsTUFBTSxJQUFJLEdBQUcsQ0FBQyxVQUFVLElBQUksQ0FBQyxFQUFFLEdBQUcsTUFBTSxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUM7SUFDakQsTUFBTSxPQUFPLEdBQUcsQ0FBQyxVQUFVLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDO0lBQzFDLE1BQU0sU0FBUyxHQUFHLENBQUMsT0FBTyxHQUFHLENBQUMsQ0FBQyxJQUFJLEtBQUssQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUM7SUFFbEQsMkRBQTJEO0lBQzNELE1BQU0sR0FBRyxHQUFhLEVBQUUsQ0FBQztJQUN6QixLQUFLLElBQUksQ0FBQyxHQUFHLE9BQU8sR0FBRyxDQUFDLEVBQUUsQ0FBQyxHQUFHLFNBQVMsRUFBRSxDQUFDLEVBQUUsRUFBRSxDQUFDO1FBQzdDLEdBQUcsQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDMUIsQ0FBQztJQUVELE9BQU8sR0FBRyxDQUFDO0FBQ2IsQ0FBQztBQUVEOzs7R0FHRztBQUNILE1BQU0sVUFBVSxjQUFjO0lBQzVCLElBQUksQ0FBQztRQUNILE1BQU0sVUFBVSxHQUFHLEVBQUUsQ0FBQyxpQkFBaUIsRUFBRSxDQUFDO1FBRTFDLEtBQUssTUFBTSxJQUFJLElBQUksTUFBTSxDQUFDLElBQUksQ0FBQyxVQUFVLENBQUMsRUFBRSxDQUFDO1lBQzNDLE1BQU0sS0FBSyxHQUFHLFVBQVUsQ0FBQyxJQUFJLENBQUMsQ0FBQztZQUMvQixJQUFJLENBQUMsS0FBSztnQkFBRSxTQUFTO1lBRXJCLEtBQUssTUFBTSxJQUFJLElBQUksS0FBSyxFQUFFLENBQUM7Z0JBQ3pCLDZCQUE2QjtnQkFDN0IsSUFBSSxJQUFJLENBQUMsTUFBTSxLQUFLLE1BQU0sSUFBSSxJQUFJLENBQUMsUUFBUTtvQkFBRSxTQUFTO2dCQUV0RCxvREFBb0Q7Z0JBQ3BELE1BQU0sRUFBRSxHQUFHLFVBQVUsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUM7Z0JBQ3BDLE1BQU0sSUFBSSxHQUFHLFVBQVUsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUM7Z0JBQ3RDLE1BQU0sT0FBTyxHQUFHLENBQUMsRUFBRSxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQztnQkFFbEMsdUNBQXVDO2dCQUN2QyxNQUFNLFFBQVEsR0FBRyxJQUFJLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsQ0FBQyxNQUFNLENBQUMsQ0FBQyxHQUFXLEVBQUUsS0FBYSxFQUFFLEVBQUU7b0JBQzdFLE1BQU0sSUFBSSxHQUFHLFFBQVEsQ0FBQyxLQUFLLEVBQUUsRUFBRSxDQUFDLENBQUM7b0JBQ2pDLElBQUksSUFBSSxHQUFHLENBQUMsQ0FBQztvQkFDYixLQUFLLElBQUksQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsRUFBRSxFQUFFLENBQUM7d0JBQzVCLElBQUksQ0FBQyxJQUFJLElBQUksQ0FBQyxDQUFDLEdBQUcsQ0FBQzs0QkFBRSxJQUFJLEVBQUUsQ0FBQzs7NEJBQ3ZCLE1BQU07b0JBQ2IsQ0FBQztvQkFDRCxPQUFPLEdBQUcsR0FBRyxJQUFJLENBQUM7Z0JBQ3BCLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQztnQkFFTixPQUFPLEdBQUcsVUFBVSxDQUFDLE9BQU8sQ0FBQyxJQUFJLFFBQVEsRUFBRSxDQUFDO1lBQzlDLENBQUM7UUFDSCxDQUFDO0lBQ0gsQ0FBQztJQUFDLE1BQU0sQ0FBQztRQUNQLG1DQUFtQztJQUNyQyxDQUFDO0lBRUQsT0FBTyxJQUFJLENBQUM7QUFDZCxDQUFDO0FBRUQ7O0dBRUc7QUFDSCxNQUFNLFVBQVUsY0FBYyxDQUFDLElBQVk7SUFDekMsTUFBTSxLQUFLLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQywrQkFBK0IsQ0FBQyxDQUFDO0lBQzFELElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztRQUNYLE1BQU0sSUFBSSxLQUFLLENBQUMsMEJBQTBCLElBQUksRUFBRSxDQUFDLENBQUM7SUFDcEQsQ0FBQztJQUVELE1BQU0sTUFBTSxHQUFHLFFBQVEsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUM7SUFFdEMsSUFBSSxNQUFNLEtBQUssRUFBRTtRQUFFLE9BQU8sQ0FBQyxDQUFDO0lBQzVCLElBQUksTUFBTSxLQUFLLEVBQUU7UUFBRSxPQUFPLENBQUMsQ0FBQztJQUU1QixrREFBa0Q7SUFDbEQsT0FBTyxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUMsRUFBRSxFQUFFLEdBQUcsTUFBTSxDQUFDLEdBQUcsQ0FBQyxDQUFDO0FBQ3RDLENBQUMifQ==