@ecobridge.xyz/devicemanager 3.0.2

package/dist_ts/helpers/helpers.retry.d.ts

@@ -0,0 +1,25 @@
+import type { IRetryOptions } from '../interfaces/index.js';
+declare const defaultRetryOptions: Required<IRetryOptions>;
+/**
+ * Executes a function with retry logic using exponential backoff
+ *
+ * @param fn - The async function to execute
+ * @param options - Retry configuration options
+ * @returns The result of the function
+ * @throws The last error if all retries fail
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: IRetryOptions): Promise<T>;
+/**
+ * Creates a retryable version of an async function
+ *
+ * @param fn - The async function to wrap
+ * @param options - Retry configuration options
+ * @returns A wrapped function that retries on failure
+ */
+export declare function createRetryable<TArgs extends unknown[], TResult>(fn: (...args: TArgs) => Promise<TResult>, options?: IRetryOptions): (...args: TArgs) => Promise<TResult>;
+/**
+ * Retry decorator for class methods
+ * Note: Use as a wrapper function since TC39 decorators have different semantics
+ */
+export declare function retryMethod<T extends Record<string, unknown>>(target: T, methodName: keyof T & string, options?: IRetryOptions): void;
+export { defaultRetryOptions };

package/dist_ts/helpers/helpers.retry.js

@@ -0,0 +1,69 @@
+import * as plugins from '../plugins.js';
+const defaultRetryOptions = {
+    maxRetries: 5,
+    baseDelay: 1000,
+    maxDelay: 16000,
+    multiplier: 2,
+    jitter: true,
+};
+/**
+ * Calculates the delay for a retry attempt using exponential backoff
+ */
+function calculateDelay(attempt, options) {
+    const delay = Math.min(options.baseDelay * Math.pow(options.multiplier, attempt), options.maxDelay);
+    if (options.jitter) {
+        // Add random jitter of +/- 25%
+        const jitterRange = delay * 0.25;
+        return delay + (Math.random() * jitterRange * 2 - jitterRange);
+    }
+    return delay;
+}
+/**
+ * Executes a function with retry logic using exponential backoff
+ *
+ * @param fn - The async function to execute
+ * @param options - Retry configuration options
+ * @returns The result of the function
+ * @throws The last error if all retries fail
+ */
+export async function withRetry(fn, options) {
+    const opts = { ...defaultRetryOptions, ...options };
+    let lastError;
+    for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt === opts.maxRetries) {
+                break;
+            }
+            const delay = calculateDelay(attempt, opts);
+            await plugins.smartdelay.delayFor(delay);
+        }
+    }
+    throw lastError ?? new Error('Retry failed with unknown error');
+}
+/**
+ * Creates a retryable version of an async function
+ *
+ * @param fn - The async function to wrap
+ * @param options - Retry configuration options
+ * @returns A wrapped function that retries on failure
+ */
+export function createRetryable(fn, options) {
+    return (...args) => withRetry(() => fn(...args), options);
+}
+/**
+ * Retry decorator for class methods
+ * Note: Use as a wrapper function since TC39 decorators have different semantics
+ */
+export function retryMethod(target, methodName, options) {
+    const originalMethod = target[methodName];
+    if (typeof originalMethod !== 'function') {
+        throw new Error(`${methodName} is not a function`);
+    }
+    target[methodName] = createRetryable(originalMethod.bind(target), options);
+}
+export { defaultRetryOptions };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGVscGVycy5yZXRyeS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2hlbHBlcnMvaGVscGVycy5yZXRyeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQUd6QyxNQUFNLG1CQUFtQixHQUE0QjtJQUNuRCxVQUFVLEVBQUUsQ0FBQztJQUNiLFNBQVMsRUFBRSxJQUFJO0lBQ2YsUUFBUSxFQUFFLEtBQUs7SUFDZixVQUFVLEVBQUUsQ0FBQztJQUNiLE1BQU0sRUFBRSxJQUFJO0NBQ2IsQ0FBQztBQUVGOztHQUVHO0FBQ0gsU0FBUyxjQUFjLENBQ3JCLE9BQWUsRUFDZixPQUFnQztJQUVoQyxNQUFNLEtBQUssR0FBRyxJQUFJLENBQUMsR0FBRyxDQUNwQixPQUFPLENBQUMsU0FBUyxHQUFHLElBQUksQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLFVBQVUsRUFBRSxPQUFPLENBQUMsRUFDekQsT0FBTyxDQUFDLFFBQVEsQ0FDakIsQ0FBQztJQUVGLElBQUksT0FBTyxDQUFDLE1BQU0sRUFBRSxDQUFDO1FBQ25CLCtCQUErQjtRQUMvQixNQUFNLFdBQVcsR0FBRyxLQUFLLEdBQUcsSUFBSSxDQUFDO1FBQ2pDLE9BQU8sS0FBSyxHQUFHLENBQUMsSUFBSSxDQUFDLE1BQU0sRUFBRSxHQUFHLFdBQVcsR0FBRyxDQUFDLEdBQUcsV0FBVyxDQUFDLENBQUM7SUFDakUsQ0FBQztJQUVELE9BQU8sS0FBSyxDQUFDO0FBQ2YsQ0FBQztBQUVEOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLFNBQVMsQ0FDN0IsRUFBb0IsRUFDcEIsT0FBdUI7SUFFdkIsTUFBTSxJQUFJLEdBQTRCLEVBQUUsR0FBRyxtQkFBbUIsRUFBRSxHQUFHLE9BQU8sRUFBRSxDQUFDO0lBQzdFLElBQUksU0FBNEIsQ0FBQztJQUVqQyxLQUFLLElBQUksT0FBTyxHQUFHLENBQUMsRUFBRSxPQUFPLElBQUksSUFBSSxDQUFDLFVBQVUsRUFBRSxPQUFPLEVBQUUsRUFBRSxDQUFDO1FBQzVELElBQUksQ0FBQztZQUNILE9BQU8sTUFBTSxFQUFFLEVBQUUsQ0FBQztRQUNwQixDQUFDO1FBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztZQUNmLFNBQVMsR0FBRyxLQUFLLFlBQVksS0FBSyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLElBQUksS0FBSyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDO1lBRXRFLElBQUksT0FBTyxLQUFLLElBQUksQ0FBQyxVQUFVLEVBQUUsQ0FBQztnQkFDaEMsTUFBTTtZQUNSLENBQUM7WUFFRCxNQUFNLEtBQUssR0FBRyxjQUFjLENBQUMsT0FBTyxFQUFFLElBQUksQ0FBQyxDQUFDO1lBQzVDLE1BQU0sT0FBTyxDQUFDLFVBQVUsQ0FBQyxRQUFRLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDM0MsQ0FBQztJQUNILENBQUM7SUFFRCxNQUFNLFNBQVMsSUFBSSxJQUFJLEtBQUssQ0FBQyxpQ0FBaUMsQ0FBQyxDQUFDO0FBQ2xFLENBQUM7QUFFRDs7Ozs7O0dBTUc7QUFDSCxNQUFNLFVBQVUsZUFBZSxDQUM3QixFQUF3QyxFQUN4QyxPQUF1QjtJQUV2QixPQUFPLENBQUMsR0FBRyxJQUFXLEVBQUUsRUFBRSxDQUFDLFNBQVMsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxFQUFFLENBQUMsR0FBRyxJQUFJLENBQUMsRUFBRSxPQUFPLENBQUMsQ0FBQztBQUNuRSxDQUFDO0FBRUQ7OztHQUdHO0FBQ0gsTUFBTSxVQUFVLFdBQVcsQ0FDekIsTUFBUyxFQUNULFVBQTRCLEVBQzVCLE9BQXVCO0lBRXZCLE1BQU0sY0FBYyxHQUFHLE1BQU0sQ0FBQyxVQUFVLENBQUMsQ0FBQztJQUMxQyxJQUFJLE9BQU8sY0FBYyxLQUFLLFVBQVUsRUFBRSxDQUFDO1FBQ3pDLE1BQU0sSUFBSSxLQUFLLENBQUMsR0FBRyxVQUFVLG9CQUFvQixDQUFDLENBQUM7SUFDckQsQ0FBQztJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsR0FBRyxlQUFlLENBQ2xDLGNBQWMsQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUE2QyxFQUN2RSxPQUFPLENBQ2dCLENBQUM7QUFDNUIsQ0FBQztBQUVELE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxDQUFDIn0=

package/dist_ts/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @push.rocks/devicemanager
+ * A comprehensive device manager for discovering and communicating with network devices
+ * Supports: Scanners, Printers, SNMP devices, UPS, DLNA, Sonos, AirPlay, Chromecast
+ */
+export { DeviceManager, MdnsDiscovery, NetworkScanner, SsdpDiscovery, SERVICE_TYPES, SSDP_SERVICE_TYPES, } from './devicemanager.classes.devicemanager.js';
+export { UniversalDevice, type IUniversalDeviceInfo, type IDeviceCreateOptions } from './device/device.classes.device.js';
+export { Feature, ScanFeature, PrintFeature, PlaybackFeature, VolumeFeature, PowerFeature, SnmpFeature, SwitchFeature, SensorFeature, LightFeature, CoverFeature, LockFeature, FanFeature, ClimateFeature, CameraFeature, type TDeviceReference, type IScanFeatureOptions, type IPrintFeatureOptions, type IPlaybackFeatureOptions, type IVolumeFeatureOptions, type IVolumeController, type IPowerFeatureOptions, type ISnmpFeatureOptions, type ISwitchFeatureOptions, type ISensorFeatureOptions, type ILightFeatureOptions, type ICoverFeatureOptions, type ILockFeatureOptions, type IFanFeatureOptions, type IClimateFeatureOptions, type ICameraFeatureOptions, } from './features/index.js';
+export { createScanner, createPrinter, createSnmpDevice, createUpsDevice, createSpeaker, createDlnaRenderer, createSmartSwitch, createSmartSensor, createSmartLight, createSmartCover, createSmartLock, createSmartFan, createSmartClimate, createSmartCamera, type IScannerDiscoveryInfo, type IPrinterDiscoveryInfo, type ISnmpDiscoveryInfo, type IUpsDiscoveryInfo, type ISpeakerDiscoveryInfo, type IDlnaRendererDiscoveryInfo, type ISmartSwitchDiscoveryInfo, type ISmartSensorDiscoveryInfo, type ISmartLightDiscoveryInfo, type ISmartCoverDiscoveryInfo, type ISmartLockDiscoveryInfo, type ISmartFanDiscoveryInfo, type ISmartClimateDiscoveryInfo, type ISmartCameraDiscoveryInfo, } from './factories/index.js';
+export { EsclProtocol, SaneProtocol, IppProtocol, SnmpProtocol, SNMP_OIDS, NutProtocol, NUT_COMMANDS, NUT_VARIABLES, UpnpSoapClient, UPNP_SERVICE_TYPES, UPNP_DEVICE_TYPES, UpsSnmpHandler, UPS_SNMP_OIDS, HomeAssistantProtocol, type ISnmpOptions, type ISnmpVarbind, type TSnmpValueType, type TNutStatusFlag, type INutUpsInfo, type INutVariable, type TDlnaTransportState, type TDlnaTransportStatus, type IDlnaPositionInfo, type IDlnaTransportInfo, type IDlnaMediaInfo, type IDlnaContentItem, type IDlnaBrowseResult, type TUpsBatteryStatus, type TUpsOutputSource, type TUpsTestResult, type IUpsSnmpStatus, } from './protocols/index.js';
+export { HomeAssistantDiscovery, HA_SERVICE_TYPE } from './discovery/discovery.classes.homeassistant.js';
+export { withRetry, createRetryable, defaultRetryOptions } from './helpers/helpers.retry.js';
+export { isValidIp, ipToNumber, numberToIp, ipRangeToIps, cidrToIps, getLocalSubnet, countIpsInCidr, } from './helpers/helpers.iprange.js';
+export * from './interfaces/index.js';
+export type { ISsdpDevice, ISsdpDeviceDescription, ISsdpService, ISsdpIcon, } from './discovery/discovery.classes.ssdp.js';

package/dist_ts/index.js

@@ -0,0 +1,40 @@
+/**
+ * @push.rocks/devicemanager
+ * A comprehensive device manager for discovering and communicating with network devices
+ * Supports: Scanners, Printers, SNMP devices, UPS, DLNA, Sonos, AirPlay, Chromecast
+ */
+// ============================================================================
+// Core Device Manager
+// ============================================================================
+export { DeviceManager, MdnsDiscovery, NetworkScanner, SsdpDiscovery, SERVICE_TYPES, SSDP_SERVICE_TYPES, } from './devicemanager.classes.devicemanager.js';
+// ============================================================================
+// Universal Device & Features
+// ============================================================================
+export { UniversalDevice } from './device/device.classes.device.js';
+export { Feature, ScanFeature, PrintFeature, PlaybackFeature, VolumeFeature, PowerFeature, SnmpFeature, 
+// Smart home features
+SwitchFeature, SensorFeature, LightFeature, CoverFeature, LockFeature, FanFeature, ClimateFeature, CameraFeature, } from './features/index.js';
+// ============================================================================
+// Device Factories
+// ============================================================================
+export { createScanner, createPrinter, createSnmpDevice, createUpsDevice, createSpeaker, createDlnaRenderer, 
+// Smart home factories
+createSmartSwitch, createSmartSensor, createSmartLight, createSmartCover, createSmartLock, createSmartFan, createSmartClimate, createSmartCamera, } from './factories/index.js';
+// ============================================================================
+// Protocol Implementations
+// ============================================================================
+export { EsclProtocol, SaneProtocol, IppProtocol, SnmpProtocol, SNMP_OIDS, NutProtocol, NUT_COMMANDS, NUT_VARIABLES, UpnpSoapClient, UPNP_SERVICE_TYPES, UPNP_DEVICE_TYPES, UpsSnmpHandler, UPS_SNMP_OIDS, 
+// Home Assistant protocol
+HomeAssistantProtocol, } from './protocols/index.js';
+// Home Assistant Discovery
+export { HomeAssistantDiscovery, HA_SERVICE_TYPE } from './discovery/discovery.classes.homeassistant.js';
+// ============================================================================
+// Helpers
+// ============================================================================
+export { withRetry, createRetryable, defaultRetryOptions } from './helpers/helpers.retry.js';
+export { isValidIp, ipToNumber, numberToIp, ipRangeToIps, cidrToIps, getLocalSubnet, countIpsInCidr, } from './helpers/helpers.iprange.js';
+// ============================================================================
+// All Interfaces and Types
+// ============================================================================
+export * from './interfaces/index.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7OztHQUlHO0FBRUgsK0VBQStFO0FBQy9FLHNCQUFzQjtBQUN0QiwrRUFBK0U7QUFFL0UsT0FBTyxFQUNMLGFBQWEsRUFDYixhQUFhLEVBQ2IsY0FBYyxFQUNkLGFBQWEsRUFDYixhQUFhLEVBQ2Isa0JBQWtCLEdBQ25CLE1BQU0sMENBQTBDLENBQUM7QUFFbEQsK0VBQStFO0FBQy9FLDhCQUE4QjtBQUM5QiwrRUFBK0U7QUFFL0UsT0FBTyxFQUFFLGVBQWUsRUFBd0QsTUFBTSxtQ0FBbUMsQ0FBQztBQUMxSCxPQUFPLEVBQ0wsT0FBTyxFQUNQLFdBQVcsRUFDWCxZQUFZLEVBQ1osZUFBZSxFQUNmLGFBQWEsRUFDYixZQUFZLEVBQ1osV0FBVztBQUNYLHNCQUFzQjtBQUN0QixhQUFhLEVBQ2IsYUFBYSxFQUNiLFlBQVksRUFDWixZQUFZLEVBQ1osV0FBVyxFQUNYLFVBQVUsRUFDVixjQUFjLEVBQ2QsYUFBYSxHQWlCZCxNQUFNLHFCQUFxQixDQUFDO0FBRTdCLCtFQUErRTtBQUMvRSxtQkFBbUI7QUFDbkIsK0VBQStFO0FBRS9FLE9BQU8sRUFDTCxhQUFhLEVBQ2IsYUFBYSxFQUNiLGdCQUFnQixFQUNoQixlQUFlLEVBQ2YsYUFBYSxFQUNiLGtCQUFrQjtBQUNsQix1QkFBdUI7QUFDdkIsaUJBQWlCLEVBQ2pCLGlCQUFpQixFQUNqQixnQkFBZ0IsRUFDaEIsZ0JBQWdCLEVBQ2hCLGVBQWUsRUFDZixjQUFjLEVBQ2Qsa0JBQWtCLEVBQ2xCLGlCQUFpQixHQWVsQixNQUFNLHNCQUFzQixDQUFDO0FBRTlCLCtFQUErRTtBQUMvRSwyQkFBMkI7QUFDM0IsK0VBQStFO0FBRS9FLE9BQU8sRUFDTCxZQUFZLEVBQ1osWUFBWSxFQUNaLFdBQVcsRUFDWCxZQUFZLEVBQ1osU0FBUyxFQUNULFdBQVcsRUFDWCxZQUFZLEVBQ1osYUFBYSxFQUNiLGNBQWMsRUFDZCxrQkFBa0IsRUFDbEIsaUJBQWlCLEVBQ2pCLGNBQWMsRUFDZCxhQUFhO0FBQ2IsMEJBQTBCO0FBQzFCLHFCQUFxQixHQWtCdEIsTUFBTSxzQkFBc0IsQ0FBQztBQUU5QiwyQkFBMkI7QUFDM0IsT0FBTyxFQUFFLHNCQUFzQixFQUFFLGVBQWUsRUFBRSxNQUFNLGdEQUFnRCxDQUFDO0FBRXpHLCtFQUErRTtBQUMvRSxVQUFVO0FBQ1YsK0VBQStFO0FBRS9FLE9BQU8sRUFBRSxTQUFTLEVBQUUsZUFBZSxFQUFFLG1CQUFtQixFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFDN0YsT0FBTyxFQUNMLFNBQVMsRUFDVCxVQUFVLEVBQ1YsVUFBVSxFQUNWLFlBQVksRUFDWixTQUFTLEVBQ1QsY0FBYyxFQUNkLGNBQWMsR0FDZixNQUFNLDhCQUE4QixDQUFDO0FBRXRDLCtFQUErRTtBQUMvRSwyQkFBMkI7QUFDM0IsK0VBQStFO0FBRS9FLGNBQWMsdUJBQXVCLENBQUMifQ==

package/dist_ts/interfaces/feature.interfaces.d.ts

@@ -0,0 +1,255 @@
+/**
+ * Feature Type Definitions
+ * Features are composable capabilities that can be attached to devices
+ */
+import type { IRetryOptions } from './index.js';
+/**
+ * All supported feature types
+ */
+export type TFeatureType = 'scan' | 'print' | 'fax' | 'copy' | 'playback' | 'volume' | 'power' | 'snmp' | 'dlna-render' | 'dlna-serve' | 'light' | 'climate' | 'sensor' | 'camera' | 'cover' | 'switch' | 'lock' | 'fan';
+/**
+ * Feature connection state
+ */
+export type TFeatureState = 'disconnected' | 'connecting' | 'connected' | 'error';
+/**
+ * Base interface for all features
+ */
+export interface IFeature {
+    /** Feature type identifier */
+    readonly type: TFeatureType;
+    /** Protocol used by this feature */
+    readonly protocol: string;
+    /** Current feature state */
+    readonly state: TFeatureState;
+    /** Port used by this feature (may differ from device port) */
+    readonly port: number;
+    /** Connect to the feature endpoint */
+    connect(): Promise<void>;
+    /** Disconnect from the feature endpoint */
+    disconnect(): Promise<void>;
+}
+/**
+ * Feature info for serialization
+ */
+export interface IFeatureInfo {
+    type: TFeatureType;
+    protocol: string;
+    port: number;
+    state: TFeatureState;
+}
+export type TScanProtocol = 'escl' | 'sane' | 'wia';
+export type TScanFormat = 'png' | 'jpeg' | 'pdf' | 'tiff';
+export type TColorMode = 'color' | 'grayscale' | 'blackwhite';
+export type TScanSource = 'flatbed' | 'adf' | 'adf-duplex';
+export interface IScanCapabilities {
+    resolutions: number[];
+    formats: TScanFormat[];
+    colorModes: TColorMode[];
+    sources: TScanSource[];
+    maxWidth: number;
+    maxHeight: number;
+    minWidth: number;
+    minHeight: number;
+}
+export interface IScanArea {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface IScanOptions {
+    resolution?: number;
+    format?: TScanFormat;
+    colorMode?: TColorMode;
+    source?: TScanSource;
+    area?: IScanArea;
+    intent?: 'document' | 'photo' | 'preview';
+    quality?: number;
+}
+export interface IScanResult {
+    data: Buffer;
+    format: TScanFormat;
+    width: number;
+    height: number;
+    resolution: number;
+    colorMode: TColorMode;
+    mimeType: string;
+}
+export interface IScanFeatureInfo extends IFeatureInfo {
+    type: 'scan';
+    protocol: TScanProtocol;
+    supportedFormats: TScanFormat[];
+    supportedResolutions: number[];
+    supportedColorModes: TColorMode[];
+    supportedSources: TScanSource[];
+    hasAdf: boolean;
+    hasDuplex: boolean;
+}
+export type TPrintProtocol = 'ipp' | 'jetdirect' | 'lpd';
+export type TPrintSides = 'one-sided' | 'two-sided-long-edge' | 'two-sided-short-edge';
+export type TPrintQuality = 'draft' | 'normal' | 'high';
+export type TPrintColorMode = 'color' | 'monochrome';
+export interface IPrintCapabilities {
+    colorSupported: boolean;
+    duplexSupported: boolean;
+    mediaSizes: string[];
+    mediaTypes: string[];
+    resolutions: number[];
+    maxCopies: number;
+    sidesSupported: TPrintSides[];
+    qualitySupported: TPrintQuality[];
+}
+export interface IPrintOptions {
+    copies?: number;
+    mediaSize?: string;
+    mediaType?: string;
+    sides?: TPrintSides;
+    quality?: TPrintQuality;
+    colorMode?: TPrintColorMode;
+    jobName?: string;
+}
+export interface IPrintJob {
+    id: number;
+    name: string;
+    state: 'pending' | 'processing' | 'completed' | 'canceled' | 'aborted';
+    stateReason?: string;
+    createdAt: Date;
+    completedAt?: Date;
+    pagesPrinted?: number;
+    pagesTotal?: number;
+}
+export interface IPrintFeatureInfo extends IFeatureInfo {
+    type: 'print';
+    protocol: TPrintProtocol;
+    supportsColor: boolean;
+    supportsDuplex: boolean;
+    supportedMediaSizes: string[];
+}
+export type TPlaybackProtocol = 'sonos' | 'airplay' | 'chromecast' | 'dlna';
+export type TPlaybackState = 'playing' | 'paused' | 'stopped' | 'buffering' | 'unknown';
+export interface ITrackInfo {
+    title?: string;
+    artist?: string;
+    album?: string;
+    albumArtUri?: string;
+    duration?: number;
+    uri?: string;
+}
+export interface IPlaybackStatus {
+    state: TPlaybackState;
+    position: number;
+    duration: number;
+    track?: ITrackInfo;
+}
+export interface IPlaybackFeatureInfo extends IFeatureInfo {
+    type: 'playback';
+    protocol: TPlaybackProtocol;
+    supportsQueue: boolean;
+    supportsSeek: boolean;
+}
+export interface IVolumeFeatureInfo extends IFeatureInfo {
+    type: 'volume';
+    minVolume: number;
+    maxVolume: number;
+    volumeStep: number;
+    supportsMute: boolean;
+}
+export type TPowerProtocol = 'nut' | 'snmp' | 'smart-plug';
+export type TPowerStatus = 'online' | 'onbattery' | 'lowbattery' | 'charging' | 'discharging' | 'bypass' | 'offline' | 'error' | 'unknown';
+export interface IBatteryInfo {
+    charge: number;
+    runtime: number;
+    voltage?: number;
+    temperature?: number;
+    health?: 'good' | 'weak' | 'replace';
+}
+export interface IPowerInfo {
+    inputVoltage?: number;
+    outputVoltage?: number;
+    inputFrequency?: number;
+    outputFrequency?: number;
+    load?: number;
+    power?: number;
+}
+export interface IPowerFeatureInfo extends IFeatureInfo {
+    type: 'power';
+    protocol: TPowerProtocol;
+    hasBattery: boolean;
+    supportsShutdown: boolean;
+    supportsTest: boolean;
+}
+export type TSnmpVersion = 'v1' | 'v2c' | 'v3';
+export interface ISnmpVarbind {
+    oid: string;
+    type: number;
+    value: unknown;
+}
+export interface ISnmpFeatureInfo extends IFeatureInfo {
+    type: 'snmp';
+    version: TSnmpVersion;
+    community?: string;
+    sysDescr?: string;
+    sysName?: string;
+    sysLocation?: string;
+}
+export interface IDlnaTransportInfo {
+    state: 'STOPPED' | 'PLAYING' | 'PAUSED' | 'TRANSITIONING' | 'NO_MEDIA_PRESENT';
+    status: string;
+    speed: string;
+}
+export interface IDlnaPositionInfo {
+    track: number;
+    trackDuration: string;
+    trackMetaData?: string;
+    trackUri?: string;
+    relTime: string;
+    absTime: string;
+}
+export interface IDlnaRenderFeatureInfo extends IFeatureInfo {
+    type: 'dlna-render';
+    udn: string;
+    friendlyName: string;
+    supportsVolume: boolean;
+    supportedProtocols: string[];
+}
+export interface IDlnaContentItem {
+    id: string;
+    parentId: string;
+    title: string;
+    class: string;
+    restricted: boolean;
+    uri?: string;
+    albumArtUri?: string;
+    duration?: string;
+    size?: number;
+    isContainer: boolean;
+    childCount?: number;
+}
+export interface IDlnaBrowseResult {
+    items: IDlnaContentItem[];
+    numberReturned: number;
+    totalMatches: number;
+    updateId: number;
+}
+export interface IDlnaServeFeatureInfo extends IFeatureInfo {
+    type: 'dlna-serve';
+    udn: string;
+    friendlyName: string;
+    contentCount?: number;
+}
+/**
+ * Feature discovered during network scan or mDNS/SSDP
+ */
+export interface IDiscoveredFeature {
+    type: TFeatureType;
+    protocol: string;
+    port: number;
+    metadata: Record<string, unknown>;
+}
+/**
+ * Options for creating a feature instance
+ */
+export interface IFeatureOptions {
+    retryOptions?: IRetryOptions;
+    metadata?: Record<string, unknown>;
+}

package/dist_ts/interfaces/feature.interfaces.js

@@ -0,0 +1,6 @@
+/**
+ * Feature Type Definitions
+ * Features are composable capabilities that can be attached to devices
+ */
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVhdHVyZS5pbnRlcmZhY2VzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvaW50ZXJmYWNlcy9mZWF0dXJlLmludGVyZmFjZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7OztHQUdHIn0=