node-poweredup 10.0.0 → 10.1.0

package/dist/node/hub.d.ts

@@ -1,291 +0,0 @@
-/**
- * Hub - Main hub class for LEGO Powered UP hubs
- *
- * Follows the event-driven pattern from node-coral/node-wedo/node-controllab.
- * Hubs emit device attach/detach events when peripherals are connected/disconnected.
- */
-import { EventEmitter } from "events";
-import { HubType, DeviceType, Color, HubEventMap, HubProperties, BrakingStyle, DeviceInfo } from "./types";
-import { LWP3Connection, WeDo2Connection, BLEPeripheral } from "./connection";
-import { Device } from "./devices";
-/**
- * Base class for all LEGO Powered UP hubs
- */
-export declare abstract class BaseHub extends EventEmitter {
-    protected _connection: LWP3Connection | WeDo2Connection;
-    protected _peripheral: BLEPeripheral;
-    protected _properties: HubProperties;
-    protected _ports: Map<number, DeviceInfo>;
-    protected _devices: Map<number, Device>;
-    protected _isConnected: boolean;
-    readonly hubType: HubType;
-    constructor(peripheral: BLEPeripheral, hubType: HubType);
-    /**
-     * Connect to the hub
-     */
-    abstract connect(): Promise<void>;
-    /**
-     * Disconnect from the hub
-     */
-    abstract disconnect(): Promise<void>;
-    /**
-     * Shutdown the hub (power off)
-     */
-    abstract shutdown(): Promise<void>;
-    /**
-     * Get hub name
-     */
-    get name(): string;
-    /**
-     * Set hub name
-     */
-    abstract setName(name: string): Promise<void>;
-    /**
-     * Get firmware version
-     */
-    get firmwareVersion(): string;
-    /**
-     * Get hardware version
-     */
-    get hardwareVersion(): string;
-    /**
-     * Get battery level (0-100)
-     */
-    get batteryLevel(): number;
-    /**
-     * Get RSSI signal strength
-     */
-    get rssi(): number;
-    /**
-     * Check if hub is connected
-     */
-    get isConnected(): boolean;
-    /**
-     * Get attached ports
-     */
-    get ports(): Map<number, DeviceInfo>;
-    /**
-     * Get port info by port ID
-     */
-    getPort(portId: number): DeviceInfo | undefined;
-    /**
-     * Get ports by device type
-     */
-    getPortsByType(deviceType: DeviceType): DeviceInfo[];
-    /**
-     * Wait for a device of a specific type to be attached
-     * @param deviceType The device type to wait for
-     * @param timeout Timeout in milliseconds (default: 10000)
-     * @returns Promise that resolves to the Device
-     */
-    waitForDeviceByType(deviceType: DeviceType, timeout?: number): Promise<Device>;
-    /**
-     * Wait for a device at a specific port
-     * @param portName The port name (e.g., "A", "B", "LEFT", "RIGHT")
-     * @param timeout Timeout in milliseconds (default: 10000)
-     * @returns Promise that resolves to the Device
-     */
-    waitForDeviceAtPort(portName: string, timeout?: number): Promise<Device>;
-    /**
-     * Get existing device or create and register a new one
-     */
-    protected _getOrCreateDevice(portId: number, portInfo: DeviceInfo): Device;
-    /**
-     * Convert port name to port ID
-     */
-    protected _portNameToId(portName: string): number;
-    /**
-     * Sleep for a specified time
-     * @param ms Time to sleep in milliseconds
-     */
-    sleep(ms: number): Promise<void>;
-    on<K extends keyof HubEventMap>(event: K, listener: HubEventMap[K]): this;
-    once<K extends keyof HubEventMap>(event: K, listener: HubEventMap[K]): this;
-    emit<K extends keyof HubEventMap>(event: K, ...args: Parameters<HubEventMap[K]>): boolean;
-}
-/**
- * Hub class for LWP3-based hubs (Powered UP, Boost Move Hub, Technic, etc.)
- */
-export declare class LWP3Hub extends BaseHub {
-    protected _connection: LWP3Connection;
-    constructor(peripheral: BLEPeripheral, hubType: HubType);
-    /**
-     * Connect to the hub and initialize
-     */
-    connect(): Promise<void>;
-    /**
-     * Disconnect from the hub
-     */
-    disconnect(): Promise<void>;
-    /**
-     * Shutdown the hub (power off)
-     */
-    shutdown(): Promise<void>;
-    /**
-     * Set the hub name
-     */
-    setName(name: string): Promise<void>;
-    /**
-     * Set the hub LED color
-     */
-    setLEDColor(color: Color): Promise<void>;
-    /**
-     * Set the hub LED to RGB color
-     */
-    setLEDRGB(red: number, green: number, blue: number): Promise<void>;
-    /**
-     * Run a motor at a given power level (-100 to 100)
-     */
-    motorPower(portId: number, power: number): Promise<void>;
-    /**
-     * Run a motor at a given speed (-100 to 100) with power regulation
-     */
-    motorSpeed(portId: number, speed: number, maxPower?: number): Promise<void>;
-    /**
-     * Run a motor for a specified time
-     */
-    motorRunForTime(portId: number, time: number, speed: number, maxPower?: number, endState?: BrakingStyle): Promise<void>;
-    /**
-     * Run a motor for a specified number of degrees
-     */
-    motorRunForDegrees(portId: number, degrees: number, speed: number, maxPower?: number, endState?: BrakingStyle): Promise<void>;
-    /**
-     * Move motor to absolute position
-     */
-    motorGotoPosition(portId: number, position: number, speed: number, maxPower?: number, endState?: BrakingStyle): Promise<void>;
-    /**
-     * Stop a motor
-     */
-    motorStop(portId: number): Promise<void>;
-    /**
-     * Brake a motor
-     */
-    motorBrake(portId: number): Promise<void>;
-    /**
-     * Subscribe to sensor updates on a port
-     */
-    subscribe(portId: number, mode?: number, deltaInterval?: number): Promise<void>;
-    /**
-     * Unsubscribe from sensor updates on a port
-     */
-    unsubscribe(portId: number, mode?: number): Promise<void>;
-    /**
-     * Send raw command to the hub
-     */
-    sendRaw(data: Buffer): Promise<void>;
-    private _requestHubProperties;
-    private _enableButtonNotifications;
-    private _handleMessage;
-    private _handleHubProperty;
-    private _handleAttachedIO;
-    private _handlePortValue;
-    private _handleCommandFeedback;
-    private _handleAlert;
-    private _handleError;
-    private _handleDisconnect;
-    private _findPortByDeviceType;
-    private _parseVersion;
-}
-/**
- * Hub class for WeDo 2.0 Smart Hub
- */
-export declare class WeDo2Hub extends BaseHub {
-    protected _connection: WeDo2Connection;
-    constructor(peripheral: BLEPeripheral);
-    /**
-     * Connect to the hub and initialize
-     */
-    connect(): Promise<void>;
-    /**
-     * Disconnect from the hub
-     */
-    disconnect(): Promise<void>;
-    /**
-     * Shutdown the hub (WeDo 2.0 doesn't support remote shutdown)
-     */
-    shutdown(): Promise<void>;
-    /**
-     * Set the hub name
-     */
-    setName(name: string): Promise<void>;
-    /**
-     * Set the hub LED color
-     */
-    setLEDColor(color: Color): Promise<void>;
-    /**
-     * Set the hub LED to RGB color
-     */
-    setLEDRGB(red: number, green: number, blue: number): Promise<void>;
-    /**
-     * Run a motor at a given power level (-100 to 100)
-     */
-    motorPower(portId: number, power: number): Promise<void>;
-    /**
-     * Stop a motor
-     */
-    motorStop(portId: number): Promise<void>;
-    /**
-     * Play a tone
-     */
-    playTone(frequency: number, duration: number): Promise<void>;
-    /**
-     * Stop tone playback
-     */
-    stopTone(): Promise<void>;
-    /**
-     * Set sensor mode
-     */
-    setSensorMode(portId: number, mode: number): Promise<void>;
-    /**
-     * Send raw command
-     */
-    sendRaw(characteristicUUID: string, data: Buffer): Promise<void>;
-    private _handleMessage;
-    private _handlePortInfo;
-    private _handleSensorValue;
-    private _handleButton;
-    private _handleBattery;
-    private _handleDisconnect;
-}
-/**
- * Create a hub instance based on the hub type
- */
-export declare function createHub(peripheral: BLEPeripheral, hubType: HubType): BaseHub;
-/**
- * Move Hub (Boost) with built-in tilt sensor and motors
- */
-export declare class MoveHub extends LWP3Hub {
-    constructor(peripheral: BLEPeripheral);
-    get motorAPort(): number;
-    get motorBPort(): number;
-    get tiltSensorPort(): number;
-    get colorSensorPort(): number;
-}
-/**
- * Technic Medium Hub with gyro and accelerometer
- */
-export declare class TechnicMediumHub extends LWP3Hub {
-    constructor(peripheral: BLEPeripheral);
-    get gyroPort(): number;
-    get accelerometerPort(): number;
-    get tiltSensorPort(): number;
-}
-/**
- * Remote Control
- */
-export declare class RemoteControl extends LWP3Hub {
-    constructor(peripheral: BLEPeripheral);
-    get leftButtonPort(): number;
-    get rightButtonPort(): number;
-}
-/**
- * Duplo Train Base
- */
-export declare class DuploTrainBase extends LWP3Hub {
-    constructor(peripheral: BLEPeripheral);
-    get motorPort(): number;
-    get colorSensorPort(): number;
-    get speedometerPort(): number;
-    get speakerPort(): number;
-    playSound(sound: number): Promise<void>;
-}