@kelnishi/satmouse-client 0.1.0

package/dist/chunk-I5MEZZOT.cjs

@@ -0,0 +1,34 @@
+'use strict';
+
+// src/core/emitter.ts
+var TypedEmitter = class {
+  listeners = /* @__PURE__ */ new Map();
+  on(event, listener) {
+    let set = this.listeners.get(event);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.listeners.set(event, set);
+    }
+    set.add(listener);
+    return this;
+  }
+  off(event, listener) {
+    this.listeners.get(event)?.delete(listener);
+    return this;
+  }
+  emit(event, ...args) {
+    const set = this.listeners.get(event);
+    if (set) {
+      for (const fn of set) {
+        fn(...args);
+      }
+    }
+  }
+  removeAllListeners() {
+    this.listeners.clear();
+  }
+};
+
+exports.TypedEmitter = TypedEmitter;
+//# sourceMappingURL=chunk-I5MEZZOT.cjs.map
+//# sourceMappingURL=chunk-I5MEZZOT.cjs.map

package/dist/chunk-I5MEZZOT.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/emitter.ts"],"names":[],"mappings":";;;AAEO,IAAM,eAAN,MAA2B;AAAA,EACxB,SAAA,uBAAgB,GAAA,EAA2B;AAAA,EAEnD,EAAA,CAAoC,OAAU,QAAA,EAAsC;AAClF,IAAA,IAAI,GAAA,GAAM,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA;AAClC,IAAA,IAAI,CAAC,GAAA,EAAK;AACR,MAAA,GAAA,uBAAU,GAAA,EAAI;AACd,MAAA,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,KAAA,EAAO,GAAG,CAAA;AAAA,IAC/B;AACA,IAAA,GAAA,CAAI,IAAI,QAAQ,CAAA;AAChB,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEA,GAAA,CAAqC,OAAU,QAAA,EAAsC;AACnF,IAAA,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA,EAAG,OAAO,QAAQ,CAAA;AAC1C,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEU,IAAA,CACR,UACG,IAAA,EACG;AACN,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA;AACpC,IAAA,IAAI,GAAA,EAAK;AACP,MAAA,KAAA,MAAW,MAAM,GAAA,EAAK;AACpB,QAAC,EAAA,CAAgB,GAAG,IAAI,CAAA;AAAA,MAC1B;AAAA,IACF;AAAA,EACF;AAAA,EAEA,kBAAA,GAA2B;AACzB,IAAA,IAAA,CAAK,UAAU,KAAA,EAAM;AAAA,EACvB;AACF","file":"chunk-I5MEZZOT.cjs","sourcesContent":["/** Minimal typed event emitter — no node:events dependency for browser compatibility */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport class TypedEmitter<Events> {\n  private listeners = new Map<string, Set<Function>>();\n\n  on<K extends string & keyof Events>(event: K, listener: Events[K] & Function): this {\n    let set = this.listeners.get(event);\n    if (!set) {\n      set = new Set();\n      this.listeners.set(event, set);\n    }\n    set.add(listener);\n    return this;\n  }\n\n  off<K extends string & keyof Events>(event: K, listener: Events[K] & Function): this {\n    this.listeners.get(event)?.delete(listener);\n    return this;\n  }\n\n  protected emit<K extends string & keyof Events>(\n    event: K,\n    ...args: Events[K] extends (...a: infer A) => void ? A : never\n  ): void {\n    const set = this.listeners.get(event);\n    if (set) {\n      for (const fn of set) {\n        (fn as Function)(...args);\n      }\n    }\n  }\n\n  removeAllListeners(): void {\n    this.listeners.clear();\n  }\n}\n"]}

package/dist/chunk-X6NIARXW.js

@@ -0,0 +1,32 @@
+// src/core/emitter.ts
+var TypedEmitter = class {
+  listeners = /* @__PURE__ */ new Map();
+  on(event, listener) {
+    let set = this.listeners.get(event);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.listeners.set(event, set);
+    }
+    set.add(listener);
+    return this;
+  }
+  off(event, listener) {
+    this.listeners.get(event)?.delete(listener);
+    return this;
+  }
+  emit(event, ...args) {
+    const set = this.listeners.get(event);
+    if (set) {
+      for (const fn of set) {
+        fn(...args);
+      }
+    }
+  }
+  removeAllListeners() {
+    this.listeners.clear();
+  }
+};
+
+export { TypedEmitter };
+//# sourceMappingURL=chunk-X6NIARXW.js.map
+//# sourceMappingURL=chunk-X6NIARXW.js.map

package/dist/chunk-X6NIARXW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/emitter.ts"],"names":[],"mappings":";AAEO,IAAM,eAAN,MAA2B;AAAA,EACxB,SAAA,uBAAgB,GAAA,EAA2B;AAAA,EAEnD,EAAA,CAAoC,OAAU,QAAA,EAAsC;AAClF,IAAA,IAAI,GAAA,GAAM,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA;AAClC,IAAA,IAAI,CAAC,GAAA,EAAK;AACR,MAAA,GAAA,uBAAU,GAAA,EAAI;AACd,MAAA,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,KAAA,EAAO,GAAG,CAAA;AAAA,IAC/B;AACA,IAAA,GAAA,CAAI,IAAI,QAAQ,CAAA;AAChB,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEA,GAAA,CAAqC,OAAU,QAAA,EAAsC;AACnF,IAAA,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA,EAAG,OAAO,QAAQ,CAAA;AAC1C,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEU,IAAA,CACR,UACG,IAAA,EACG;AACN,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA;AACpC,IAAA,IAAI,GAAA,EAAK;AACP,MAAA,KAAA,MAAW,MAAM,GAAA,EAAK;AACpB,QAAC,EAAA,CAAgB,GAAG,IAAI,CAAA;AAAA,MAC1B;AAAA,IACF;AAAA,EACF;AAAA,EAEA,kBAAA,GAA2B;AACzB,IAAA,IAAA,CAAK,UAAU,KAAA,EAAM;AAAA,EACvB;AACF","file":"chunk-X6NIARXW.js","sourcesContent":["/** Minimal typed event emitter — no node:events dependency for browser compatibility */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport class TypedEmitter<Events> {\n  private listeners = new Map<string, Set<Function>>();\n\n  on<K extends string & keyof Events>(event: K, listener: Events[K] & Function): this {\n    let set = this.listeners.get(event);\n    if (!set) {\n      set = new Set();\n      this.listeners.set(event, set);\n    }\n    set.add(listener);\n    return this;\n  }\n\n  off<K extends string & keyof Events>(event: K, listener: Events[K] & Function): this {\n    this.listeners.get(event)?.delete(listener);\n    return this;\n  }\n\n  protected emit<K extends string & keyof Events>(\n    event: K,\n    ...args: Events[K] extends (...a: infer A) => void ? A : never\n  ): void {\n    const set = this.listeners.get(event);\n    if (set) {\n      for (const fn of set) {\n        (fn as Function)(...args);\n      }\n    }\n  }\n\n  removeAllListeners(): void {\n    this.listeners.clear();\n  }\n}\n"]}

package/dist/connection-CH2YsPn1.d.cts

@@ -0,0 +1,144 @@
+/** Minimal typed event emitter — no node:events dependency for browser compatibility */
+declare class TypedEmitter<Events> {
+    private listeners;
+    on<K extends string & keyof Events>(event: K, listener: Events[K] & Function): this;
+    off<K extends string & keyof Events>(event: K, listener: Events[K] & Function): this;
+    protected emit<K extends string & keyof Events>(event: K, ...args: Events[K] extends (...a: infer A) => void ? A : never): void;
+    removeAllListeners(): void;
+}
+
+interface Vec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+/** 6DOF spatial input frame — matches spatial-data.schema.json */
+interface SpatialData {
+    translation: Vec3;
+    rotation: Vec3;
+    timestamp: number;
+}
+/** Button press/release event — matches button-event.schema.json */
+interface ButtonEvent {
+    button: number;
+    pressed: boolean;
+    timestamp: number;
+}
+/** Device metadata from the bridge */
+interface DeviceInfo {
+    id: string;
+    name: string;
+    model?: string;
+    vendor?: string;
+    vendorId?: number;
+    productId?: number;
+    connectionType?: "usb" | "wireless" | "bluetooth" | "unknown";
+    connected?: boolean;
+}
+type ConnectionState = "disconnected" | "connecting" | "connected";
+type TransportProtocol = "webtransport" | "websocket" | "none";
+interface SatMouseEvents {
+    spatialData: (data: SpatialData) => void;
+    buttonEvent: (data: ButtonEvent) => void;
+    stateChange: (state: ConnectionState, protocol: TransportProtocol) => void;
+    deviceStatus: (event: "connected" | "disconnected", device: DeviceInfo) => void;
+    error: (error: Error) => void;
+}
+interface ThingDescription {
+    title: string;
+    id: string;
+    base?: string;
+    version?: {
+        instance: string;
+    };
+    "satmouse:certHash"?: string;
+    properties?: {
+        deviceInfo?: {
+            forms: Array<{
+                href: string;
+                op: string;
+            }>;
+        };
+    };
+    events?: {
+        spatialData?: {
+            forms: Array<{
+                href: string;
+                subprotocol: string;
+                contentType: string;
+            }>;
+        };
+        buttonEvent?: {
+            forms: Array<{
+                href: string;
+                subprotocol: string;
+                contentType: string;
+            }>;
+        };
+    };
+}
+interface ConnectOptions {
+    /**
+     * SatMouse URI: satmouse://connect?host=<ip>&wsPort=<port>&wtPort=<port>
+     * When provided, host/ports are extracted and used for discovery + transport.
+     * All params are optional — defaults to localhost:4444/4443.
+     */
+    uri?: string;
+    /** URL to td.json. Defaults to /td.json relative to window.location */
+    tdUrl?: string;
+    /** Direct WebSocket URL (skips discovery) */
+    wsUrl?: string;
+    /** Direct WebTransport URL (skips discovery) */
+    wtUrl?: string;
+    /** Certificate hash for self-signed WebTransport certs (base64) */
+    certHash?: string;
+    /** Preferred transport order. Default: ["webtransport", "websocket"] */
+    transports?: TransportProtocol[];
+    /** Auto-reconnect delay in ms. 0 to disable. Default: 2000 */
+    reconnectDelay?: number;
+    /** WebSocket subprotocol. Default: "satmouse-json" */
+    wsSubprotocol?: "satmouse-json" | "satmouse-binary";
+}
+
+/**
+ * Build a satmouse:// connect URI from connection parameters.
+ */
+declare function buildSatMouseUri(host?: string, wsPort?: number, wtPort?: number): string;
+/**
+ * Parse a satmouse:// URI into connection parameters.
+ *
+ * Format: satmouse://connect?host=<ip>&wsPort=<port>&wtPort=<port>
+ * All query params are optional. Defaults: host=localhost, wsPort=4444, wtPort=4443.
+ */
+declare function parseSatMouseUri(uri: string): {
+    tdUrl: string;
+    wsUrl: string;
+    wtUrl: string;
+};
+/**
+ * Core connection to a SatMouse bridge.
+ *
+ * Handles discovery (via WoT Thing Description), transport negotiation
+ * (WebTransport with WebSocket fallback), event dispatch, and auto-reconnect.
+ */
+declare class SatMouseConnection extends TypedEmitter<SatMouseEvents> {
+    private options;
+    private transport;
+    private reconnectTimer;
+    private intentionalClose;
+    private deviceInfoUrl;
+    private _state;
+    private _protocol;
+    get state(): ConnectionState;
+    get protocol(): TransportProtocol;
+    constructor(options?: ConnectOptions);
+    connect(): Promise<void>;
+    disconnect(): void;
+    fetchDeviceInfo(): Promise<DeviceInfo[]>;
+    private tryTransport;
+    private setState;
+    private scheduleReconnect;
+    private clearReconnect;
+}
+
+export { type ButtonEvent as B, type ConnectOptions as C, type DeviceInfo as D, type SpatialData as S, type ThingDescription as T, type Vec3 as V, type ConnectionState as a, SatMouseConnection as b, type SatMouseEvents as c, type TransportProtocol as d, TypedEmitter as e, buildSatMouseUri as f, parseSatMouseUri as p };

package/dist/connection-CH2YsPn1.d.ts

@@ -0,0 +1,144 @@
+/** Minimal typed event emitter — no node:events dependency for browser compatibility */
+declare class TypedEmitter<Events> {
+    private listeners;
+    on<K extends string & keyof Events>(event: K, listener: Events[K] & Function): this;
+    off<K extends string & keyof Events>(event: K, listener: Events[K] & Function): this;
+    protected emit<K extends string & keyof Events>(event: K, ...args: Events[K] extends (...a: infer A) => void ? A : never): void;
+    removeAllListeners(): void;
+}
+
+interface Vec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+/** 6DOF spatial input frame — matches spatial-data.schema.json */
+interface SpatialData {
+    translation: Vec3;
+    rotation: Vec3;
+    timestamp: number;
+}
+/** Button press/release event — matches button-event.schema.json */
+interface ButtonEvent {
+    button: number;
+    pressed: boolean;
+    timestamp: number;
+}
+/** Device metadata from the bridge */
+interface DeviceInfo {
+    id: string;
+    name: string;
+    model?: string;
+    vendor?: string;
+    vendorId?: number;
+    productId?: number;
+    connectionType?: "usb" | "wireless" | "bluetooth" | "unknown";
+    connected?: boolean;
+}
+type ConnectionState = "disconnected" | "connecting" | "connected";
+type TransportProtocol = "webtransport" | "websocket" | "none";
+interface SatMouseEvents {
+    spatialData: (data: SpatialData) => void;
+    buttonEvent: (data: ButtonEvent) => void;
+    stateChange: (state: ConnectionState, protocol: TransportProtocol) => void;
+    deviceStatus: (event: "connected" | "disconnected", device: DeviceInfo) => void;
+    error: (error: Error) => void;
+}
+interface ThingDescription {
+    title: string;
+    id: string;
+    base?: string;
+    version?: {
+        instance: string;
+    };
+    "satmouse:certHash"?: string;
+    properties?: {
+        deviceInfo?: {
+            forms: Array<{
+                href: string;
+                op: string;
+            }>;
+        };
+    };
+    events?: {
+        spatialData?: {
+            forms: Array<{
+                href: string;
+                subprotocol: string;
+                contentType: string;
+            }>;
+        };
+        buttonEvent?: {
+            forms: Array<{
+                href: string;
+                subprotocol: string;
+                contentType: string;
+            }>;
+        };
+    };
+}
+interface ConnectOptions {
+    /**
+     * SatMouse URI: satmouse://connect?host=<ip>&wsPort=<port>&wtPort=<port>
+     * When provided, host/ports are extracted and used for discovery + transport.
+     * All params are optional — defaults to localhost:4444/4443.
+     */
+    uri?: string;
+    /** URL to td.json. Defaults to /td.json relative to window.location */
+    tdUrl?: string;
+    /** Direct WebSocket URL (skips discovery) */
+    wsUrl?: string;
+    /** Direct WebTransport URL (skips discovery) */
+    wtUrl?: string;
+    /** Certificate hash for self-signed WebTransport certs (base64) */
+    certHash?: string;
+    /** Preferred transport order. Default: ["webtransport", "websocket"] */
+    transports?: TransportProtocol[];
+    /** Auto-reconnect delay in ms. 0 to disable. Default: 2000 */
+    reconnectDelay?: number;
+    /** WebSocket subprotocol. Default: "satmouse-json" */
+    wsSubprotocol?: "satmouse-json" | "satmouse-binary";
+}
+
+/**
+ * Build a satmouse:// connect URI from connection parameters.
+ */
+declare function buildSatMouseUri(host?: string, wsPort?: number, wtPort?: number): string;
+/**
+ * Parse a satmouse:// URI into connection parameters.
+ *
+ * Format: satmouse://connect?host=<ip>&wsPort=<port>&wtPort=<port>
+ * All query params are optional. Defaults: host=localhost, wsPort=4444, wtPort=4443.
+ */
+declare function parseSatMouseUri(uri: string): {
+    tdUrl: string;
+    wsUrl: string;
+    wtUrl: string;
+};
+/**
+ * Core connection to a SatMouse bridge.
+ *
+ * Handles discovery (via WoT Thing Description), transport negotiation
+ * (WebTransport with WebSocket fallback), event dispatch, and auto-reconnect.
+ */
+declare class SatMouseConnection extends TypedEmitter<SatMouseEvents> {
+    private options;
+    private transport;
+    private reconnectTimer;
+    private intentionalClose;
+    private deviceInfoUrl;
+    private _state;
+    private _protocol;
+    get state(): ConnectionState;
+    get protocol(): TransportProtocol;
+    constructor(options?: ConnectOptions);
+    connect(): Promise<void>;
+    disconnect(): void;
+    fetchDeviceInfo(): Promise<DeviceInfo[]>;
+    private tryTransport;
+    private setState;
+    private scheduleReconnect;
+    private clearReconnect;
+}
+
+export { type ButtonEvent as B, type ConnectOptions as C, type DeviceInfo as D, type SpatialData as S, type ThingDescription as T, type Vec3 as V, type ConnectionState as a, SatMouseConnection as b, type SatMouseEvents as c, type TransportProtocol as d, TypedEmitter as e, buildSatMouseUri as f, parseSatMouseUri as p };