@dg-kit/transport-webbluetooth 0.1.0

package/README.md

@@ -0,0 +1,31 @@
+# @dg-kit/transport-webbluetooth
+
+Browser-side `DeviceClient` for DG-Lab Coyote, built on Web Bluetooth.
+
+This package is the glue between the browser's `navigator.bluetooth.requestDevice()` chooser and `@dg-kit/protocol`. The protocol code itself is environment-agnostic; this package provides the GATT connection layer that drives it.
+
+## Usage
+
+```ts
+import { CoyoteProtocolAdapter } from '@dg-kit/protocol';
+import {
+  WebBluetoothDeviceClient,
+  getWebBluetoothAvailability,
+} from '@dg-kit/transport-webbluetooth';
+
+const availability = getWebBluetoothAvailability();
+if (!availability.supported) {
+  throw new Error(availability.reason);
+}
+
+const protocol = new CoyoteProtocolAdapter();
+const device = new WebBluetoothDeviceClient({ protocol });
+await device.connect(); // pops the browser chooser
+```
+
+`CoyoteProtocolAdapter` auto-detects V2 vs V3 from the connecting device's name prefix.
+
+## Requirements
+
+- Browser: Chrome/Edge with Web Bluetooth (HTTPS or localhost).
+- Mobile: Bluefy (iOS) / Chrome (Android).

package/dist/availability.d.ts

@@ -0,0 +1,3 @@
+import type { NavigatorBluetoothLike, WebBluetoothAvailability } from '@dg-kit/protocol';
+export declare function getWebBluetoothAvailability(nav?: NavigatorBluetoothLike | undefined): WebBluetoothAvailability;
+//# sourceMappingURL=availability.d.ts.map

package/dist/availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.d.ts","sourceRoot":"","sources":["../src/availability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAEzF,wBAAgB,2BAA2B,CACzC,GAAG,GAAE,sBAAsB,GAAG,SAEsB,GACnD,wBAAwB,CAa1B"}

package/dist/availability.js

@@ -0,0 +1,15 @@
+export function getWebBluetoothAvailability(nav = typeof navigator === 'undefined'
+    ? undefined
+    : navigator) {
+    if (!nav) {
+        return { supported: false, reason: '当前环境中无法访问浏览器导航对象' };
+    }
+    if (!nav.bluetooth) {
+        return {
+            supported: false,
+            reason: '当前环境不支持 Web Bluetooth，请使用 Chrome 或 Edge，并通过 HTTPS 或 localhost 访问',
+        };
+    }
+    return { supported: true };
+}
+//# sourceMappingURL=availability.js.map

package/dist/availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.js","sourceRoot":"","sources":["../src/availability.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,2BAA2B,CACzC,MAA0C,OAAO,SAAS,KAAK,WAAW;IACxE,CAAC,CAAC,SAAS;IACX,CAAC,CAAE,SAA+C;IAEpD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC1D,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACnB,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,kEAAkE;SAC3E,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,25 @@
+import type { DeviceClient } from '@dg-kit/core';
+import type { DeviceCommand, DeviceCommandResult, DeviceState } from '@dg-kit/core';
+import { type NavigatorBluetoothLike, type RequestDeviceOptionsLike, type WebBluetoothProtocolAdapter } from '@dg-kit/protocol';
+export interface WebBluetoothDeviceClientOptions {
+    protocol: WebBluetoothProtocolAdapter;
+    navigatorRef?: NavigatorBluetoothLike;
+    requestDeviceOptions?: RequestDeviceOptionsLike;
+}
+export declare class WebBluetoothDeviceClient implements DeviceClient {
+    private readonly options;
+    private readonly listeners;
+    private readonly nav;
+    private device;
+    private disconnecting;
+    constructor(options: WebBluetoothDeviceClientOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    getState(): Promise<DeviceState>;
+    execute(command: DeviceCommand): Promise<DeviceCommandResult>;
+    emergencyStop(): Promise<void>;
+    onStateChanged(listener: (state: DeviceState) => void): () => void;
+    private readonly onDisconnected;
+    private emit;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EACjC,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,2BAA2B,CAAC;IACtC,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,oBAAoB,CAAC,EAAE,wBAAwB,CAAC;CACjD;AAED,qBAAa,wBAAyB,YAAW,YAAY;IAM/C,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2C;IACrE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqC;IACzD,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,aAAa,CAAS;gBAED,OAAO,EAAE,+BAA+B;IAY/D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgDxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;IAIhC,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI7D,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI;IAOlE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAO7B;IAEF,OAAO,CAAC,IAAI;CAKb"}

package/dist/client.js

@@ -0,0 +1,117 @@
+import { COYOTE_REQUEST_DEVICE_OPTIONS, } from '@dg-kit/protocol';
+import { getWebBluetoothAvailability } from './availability.js';
+export class WebBluetoothDeviceClient {
+    options;
+    listeners = new Set();
+    nav;
+    device = null;
+    disconnecting = false;
+    constructor(options) {
+        this.options = options;
+        this.nav =
+            options.navigatorRef ??
+                (typeof navigator === 'undefined'
+                    ? undefined
+                    : navigator);
+        this.options.protocol.subscribe((state) => {
+            this.emit(state);
+        });
+    }
+    async connect() {
+        const availability = getWebBluetoothAvailability(this.nav);
+        if (!availability.supported) {
+            throw new Error(availability.reason);
+        }
+        const bluetooth = this.nav?.bluetooth;
+        if (!bluetooth) {
+            throw new Error('当前环境不支持 Web Bluetooth');
+        }
+        const nextDevice = await bluetooth.requestDevice(this.options.requestDeviceOptions ?? COYOTE_REQUEST_DEVICE_OPTIONS);
+        const gatt = nextDevice.gatt;
+        if (!gatt) {
+            throw new Error('所选蓝牙设备不支持 GATT');
+        }
+        const server = await gatt.connect();
+        const previousDevice = this.device;
+        const shouldReplacePrevious = !!previousDevice && previousDevice !== nextDevice;
+        if (shouldReplacePrevious) {
+            previousDevice.removeEventListener('gattserverdisconnected', this.onDisconnected);
+        }
+        try {
+            await this.options.protocol.onConnected({ device: nextDevice, server });
+        }
+        catch (error) {
+            if (shouldReplacePrevious && isGattConnected(previousDevice)) {
+                previousDevice.addEventListener('gattserverdisconnected', this.onDisconnected);
+            }
+            if (gatt.connected) {
+                gatt.disconnect();
+            }
+            throw error;
+        }
+        this.device = nextDevice;
+        nextDevice.addEventListener('gattserverdisconnected', this.onDisconnected);
+        if (shouldReplacePrevious) {
+            disconnectDevice(previousDevice);
+        }
+    }
+    async disconnect() {
+        this.disconnecting = true;
+        try {
+            await this.options.protocol.emergencyStop();
+            const device = this.device;
+            if (device?.gatt?.connected) {
+                device.gatt.disconnect();
+            }
+            await this.options.protocol.onDisconnected();
+        }
+        finally {
+            if (this.device) {
+                this.device.removeEventListener('gattserverdisconnected', this.onDisconnected);
+            }
+            this.device = null;
+            this.disconnecting = false;
+        }
+    }
+    async getState() {
+        return this.options.protocol.getState();
+    }
+    async execute(command) {
+        return this.options.protocol.execute(command);
+    }
+    async emergencyStop() {
+        await this.options.protocol.emergencyStop();
+    }
+    onStateChanged(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    onDisconnected = async () => {
+        if (this.disconnecting)
+            return;
+        await this.options.protocol.onDisconnected();
+        if (this.device) {
+            this.device.removeEventListener('gattserverdisconnected', this.onDisconnected);
+        }
+        this.device = null;
+    };
+    emit(state) {
+        for (const listener of this.listeners) {
+            listener(state);
+        }
+    }
+}
+function isGattConnected(device) {
+    return !!device?.gatt?.connected;
+}
+function disconnectDevice(device) {
+    if (!device)
+        return;
+    const gatt = device.gatt;
+    if (!gatt?.connected)
+        return;
+    gatt.disconnect();
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { getWebBluetoothAvailability } from './availability.js';
+export { WebBluetoothDeviceClient, type WebBluetoothDeviceClientOptions } from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,KAAK,+BAA+B,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { getWebBluetoothAvailability } from './availability.js';
+export { WebBluetoothDeviceClient } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAwC,MAAM,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@dg-kit/transport-webbluetooth",
+  "version": "0.1.0",
+  "description": "Web Bluetooth DeviceClient for DG-Lab Coyote (browser-only)",
+  "license": "MIT",
+  "author": "0xNullAI",
+  "homepage": "https://github.com/0xNullAI/DG-Kit/tree/main/packages/transport-webbluetooth",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/0xNullAI/DG-Kit.git",
+    "directory": "packages/transport-webbluetooth"
+  },
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      }
+    }
+  },
+  "dependencies": {
+    "@dg-kit/core": "0.1.0",
+    "@dg-kit/protocol": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "keywords": [
+    "dg-lab",
+    "coyote",
+    "ble",
+    "web-bluetooth",
+    "browser"
+  ]
+}