lego-front-web-sdk 0.1.1 → 0.1.2

package/dist/transport/mock.d.ts

@@ -1,41 +0,0 @@
-import type { ConnectFilters, DeviceKind, DisconnectHandler, NotificationHandler, ScannedDevice, Transport, TransportConnection } from "./types.js";
-export interface MockTransportOptions {
-    /** Auto-succeed connect without requiring a prior scan. Default true. */
-    autoConnect?: boolean;
-    /** Log send/connect activity. Default true. */
-    verbose?: boolean;
-    /** Simulated devices available to scan/connect. */
-    devices?: ScannedDevice[];
-}
-/**
- * In-memory transport for development and demos — no Bluetooth required.
- * Command frames use the skeleton's mock JSON encoding (see encodeMockCommand).
- */
-export declare class MockTransport implements Transport {
-    readonly name = "mock";
-    private readonly autoConnect;
-    private readonly verbose;
-    private readonly catalog;
-    private readonly active;
-    private notificationHandler?;
-    /** Mutable mock sensor / motor state for demos. */
-    readonly state: {
-        position: number;
-        speed: number;
-        color: number;
-        leftPercent: number;
-        rightPercent: number;
-    };
-    constructor(options?: MockTransportOptions);
-    scan(kind: DeviceKind, filters?: ConnectFilters, _timeoutMs?: number): Promise<ScannedDevice[]>;
-    connect(kind: DeviceKind, filters?: ConnectFilters, handlers?: {
-        onNotification?: NotificationHandler;
-        onDisconnect?: DisconnectHandler;
-    }): Promise<TransportConnection>;
-    send(connection: TransportConnection, message: Uint8Array): Promise<void>;
-    disconnect(connection: TransportConnection): Promise<void>;
-    shutdownAll(): Promise<void>;
-    private applyCommand;
-    private log;
-}
-//# sourceMappingURL=mock.d.ts.map

package/dist/transport/mock.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/transport/mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B;AAyCD;;;GAGG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,QAAQ,CAAC,IAAI,UAAU;IAEvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,mBAAmB,CAAC,CAAsB;IAElD,mDAAmD;IACnD,QAAQ,CAAC,KAAK;;;;;;MAMZ;gBAEU,OAAO,GAAE,oBAAyB;IAMxC,IAAI,CACR,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,cAAc,EACxB,UAAU,SAAO,GAChB,OAAO,CAAC,aAAa,EAAE,CAAC;IAMrB,OAAO,CACX,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,cAAc,EACxB,QAAQ,CAAC,EAAE;QACT,cAAc,CAAC,EAAE,mBAAmB,CAAC;QACrC,YAAY,CAAC,EAAE,iBAAiB,CAAC;KAClC,GACA,OAAO,CAAC,mBAAmB,CAAC;IAyBzB,IAAI,CAAC,UAAU,EAAE,mBAAmB,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBzE,UAAU,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1D,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC,OAAO,CAAC,YAAY;IAiCpB,OAAO,CAAC,GAAG;CAQZ"}

package/dist/transport/types.d.ts

@@ -1,55 +0,0 @@
-/**
- * Pluggable BLE transport — mirrors the Python package's BLETransport idea:
- * Device APIs stay stable; swap Mock ↔ WebBluetooth (or a future bridge).
- */
-export type DeviceKind = "single-motor" | "double-motor" | "color-sensor" | "controller";
-export interface ConnectFilters {
-    deviceName?: string;
-    deviceMac?: string;
-    cardColor?: number;
-    cardSerial?: string;
-}
-export interface ScannedDevice {
-    id: string;
-    name?: string;
-    kind: DeviceKind;
-    cardColor?: number;
-    cardSerial?: string;
-}
-export type NotificationHandler = (payload: Uint8Array) => void;
-export type DisconnectHandler = () => void;
-export interface TransportConnection {
-    deviceId: string;
-    kind: DeviceKind;
-}
-/**
- * Low-level transport contract.
- * Implementations: MockTransport (dev), WebBluetoothTransport (browser).
- */
-export interface Transport {
-    readonly name: string;
-    scan(kind: DeviceKind, filters?: ConnectFilters, timeoutMs?: number): Promise<ScannedDevice[]>;
-    connect(kind: DeviceKind, filters?: ConnectFilters, handlers?: {
-        onNotification?: NotificationHandler;
-        onDisconnect?: DisconnectHandler;
-    }): Promise<TransportConnection>;
-    /** Send a raw RPC / protocol frame (already encoded). */
-    send(connection: TransportConnection, message: Uint8Array): Promise<void>;
-    disconnect(connection: TransportConnection): Promise<void>;
-    shutdownAll(): Promise<void>;
-    /**
-     * Optional: map high-level method → wire bytes.
-     * Mock omits this (DeviceBase falls back to JSON mock frames).
-     * WebBluetooth provides real RPC packing.
-     */
-    encodeCommand?(method: string, args?: Record<string, unknown>): Uint8Array;
-    /** Optional: wait until a notify frame with this opcode arrives. */
-    waitForOpcode?(opcode: number, timeoutMs?: number): Promise<Uint8Array>;
-}
-/** Encode a high-level command for MockTransport (not the real LEGO RPC wire format). */
-export declare function encodeMockCommand(method: string, args?: Record<string, unknown>): Uint8Array;
-export declare function decodeMockCommand(message: Uint8Array): {
-    method: string;
-    args: Record<string, unknown>;
-};
-//# sourceMappingURL=types.d.ts.map

package/dist/transport/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,UAAU,GAClB,cAAc,GACd,cAAc,GACd,cAAc,GACd,YAAY,CAAC;AAEjB,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;AAChE,MAAM,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC;AAE3C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,IAAI,CACF,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,cAAc,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAE5B,OAAO,CACL,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,cAAc,EACxB,QAAQ,CAAC,EAAE;QACT,cAAc,CAAC,EAAE,mBAAmB,CAAC;QACrC,YAAY,CAAC,EAAE,iBAAiB,CAAC;KAClC,GACA,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC,yDAAyD;IACzD,IAAI,CAAC,UAAU,EAAE,mBAAmB,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1E,UAAU,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B;;;;OAIG;IACH,aAAa,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC;IAE3E,oEAAoE;IACpE,aAAa,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACzE;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,UAAU,CAGZ;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAMA"}

package/dist/transport/web-bluetooth.d.ts

@@ -1,47 +0,0 @@
-import { type InfoResponse } from "../protocol/codec.js";
-import type { ConnectFilters, DeviceKind, DisconnectHandler, NotificationHandler, ScannedDevice, Transport, TransportConnection } from "./types.js";
-export interface WebBluetoothTransportOptions {
-    /** Reject connect if INFO_RESPONSE productGroupDevice mismatches kind. Default true. */
-    enforceProductGroup?: boolean;
-    /** Warn (default) or throw when RPC version ≠ package expectation. */
-    rpcVersionMode?: "warn" | "throw" | "ignore";
-    /** Default timeout waiting for RPC result notify. */
-    defaultTimeoutMs?: number;
-}
-/**
- * Browser Web Bluetooth transport (Chrome / Edge, HTTPS or localhost).
- *
- * Connect skeleton: requestDevice(fd02) → GATT → notify → INFO_REQUEST handshake.
- * Command encoding uses `encodeRpcCommand` (official-aligned frames).
- */
-export declare class WebBluetoothTransport implements Transport {
-    readonly name = "web-bluetooth";
-    private readonly enforceProductGroup;
-    private readonly rpcVersionMode;
-    private readonly defaultTimeoutMs;
-    private readonly live;
-    /** FIFO waiters per opcode (matches official Python deque). */
-    private readonly waiters;
-    constructor(options?: WebBluetoothTransportOptions);
-    encodeCommand(method: string, args?: Record<string, unknown>): Uint8Array;
-    scan(_kind: DeviceKind, _filters?: ConnectFilters, _timeoutMs?: number): Promise<ScannedDevice[]>;
-    connect(kind: DeviceKind, _filters?: ConnectFilters, handlers?: {
-        onNotification?: NotificationHandler;
-        onDisconnect?: DisconnectHandler;
-    }): Promise<TransportConnection>;
-    send(connection: TransportConnection, message: Uint8Array): Promise<void>;
-    waitForOpcode(opcode: number, timeoutMs?: number): Promise<Uint8Array>;
-    disconnect(connection: TransportConnection): Promise<void>;
-    shutdownAll(): Promise<void>;
-    /** Last INFO_RESPONSE for a connection (if handshake completed). */
-    getInfo(connection: TransportConnection): InfoResponse | undefined;
-    static isSupported(): boolean;
-    private writeRaw;
-    private requireLive;
-    private checkRpcVersion;
-    private checkProductGroup;
-    private resolveWaiter;
-    private rejectAllWaiters;
-    private assertBrowser;
-}
-//# sourceMappingURL=web-bluetooth.d.ts.map

package/dist/transport/web-bluetooth.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"web-bluetooth.d.ts","sourceRoot":"","sources":["../../src/transport/web-bluetooth.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAgB9B,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAmDpB,MAAM,WAAW,4BAA4B;IAC3C,wFAAwF;IACxF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,qBAAa,qBAAsB,YAAW,SAAS;IACrD,QAAQ,CAAC,IAAI,mBAAmB;IAEhC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8B;IAC7D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqC;IAC1D,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAOpB;gBAEQ,OAAO,GAAE,4BAAiC;IAMtD,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,UAAU;IAIvE,IAAI,CACR,KAAK,EAAE,UAAU,EACjB,QAAQ,CAAC,EAAE,cAAc,EACzB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,EAAE,CAAC;IAMrB,OAAO,CACX,IAAI,EAAE,UAAU,EAChB,QAAQ,CAAC,EAAE,cAAc,EACzB,QAAQ,CAAC,EAAE;QACT,cAAc,CAAC,EAAE,mBAAmB,CAAC;QACrC,YAAY,CAAC,EAAE,iBAAiB,CAAC;KAClC,GACA,OAAO,CAAC,mBAAmB,CAAC;IA2EzB,IAAI,CAAC,UAAU,EAAE,mBAAmB,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,SAAwB,GAAG,OAAO,CAAC,UAAU,CAAC;IA4BrF,UAAU,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAW1D,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAOlC,oEAAoE;IACpE,OAAO,CAAC,UAAU,EAAE,mBAAmB,GAAG,YAAY,GAAG,SAAS;IAIlE,MAAM,CAAC,WAAW,IAAI,OAAO;YAQf,QAAQ;IAatB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,aAAa;CAOtB"}