@dg-kit/protocol 1.3.0 → 1.5.0

package/dist/gatt-utils.d.ts

@@ -0,0 +1,42 @@
+import type { BluetoothRemoteGATTCharacteristicLike, BluetoothRemoteGATTServerLike } from './types.js';
+/**
+ * Shared GATT write with a fallback chain across the three write methods a
+ * characteristic might expose. Standalone (not a class method) so every
+ * 47L12x-family adapter can call it without needing to extend
+ * `BaseCoyoteProtocolAdapter` — Coyote, paw-prints, civet-edging, and
+ * opossum all share this exact write behavior even though their command
+ * shapes differ.
+ */
+export declare function writeCharacteristicValue(characteristic: BluetoothRemoteGATTCharacteristicLike, value: ArrayBufferView | ArrayBuffer, options?: {
+    preferResponse?: boolean;
+}): Promise<void>;
+/**
+ * Newer firmware (flashed via the official app) ignores normal control
+ * writes on the 0x180C/0x150A characteristic until it has seen the same
+ * connect-time sequence the app always sends: an init packet, best-effort
+ * subscription to two legacy/OTA notify channels, and an MTU bump to 140.
+ *
+ * The official app sends this exact same init packet unconditionally to
+ * every 47L12x-family device it connects to — Coyote, paw-prints,
+ * civet-edging, and opossum all share the identical 0x180C GATT skeleton —
+ * old and new firmware alike, with no firmware-version detection gating it.
+ * So this needs to run for all four device adapters, not just Coyote V3;
+ * originally it only ran there, which reproduced the exact "device won't
+ * respond" symptom for the three newer device kinds. Every step is
+ * best-effort/non-fatal, including the init write itself: if any step fails
+ * on a real device this hasn't been tested against, the caller's normal
+ * control writes still proceed rather than the connection being refused.
+ */
+export declare function performV3FamilyConnectHandshake(server: BluetoothRemoteGATTServerLike, writeChar: BluetoothRemoteGATTCharacteristicLike): Promise<void>;
+/**
+ * The 47L12x-family indicator LED is a discrete 8-color enum, not a
+ * continuous byte — confirmed against the community protocol doc's
+ * paw-prints color table (0=熄灭/off, 1=黄, 2=红, 3=紫, 4=蓝, 5=青, 6=绿,
+ * 7=白) and consistent with civet-edging's one documented example
+ * ("01为黄色" — matches index 1 in that same table). Values 8-255 have no
+ * defined meaning on real hardware, so every adapter clamps here rather
+ * than trusting the caller (a stray remote-control byte or a naive 0-255
+ * color picker would otherwise reach the wire unclamped).
+ */
+export declare function clampIndicatorColor(color: number): number;
+//# sourceMappingURL=gatt-utils.d.ts.map

package/dist/gatt-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatt-utils.d.ts","sourceRoot":"","sources":["../src/gatt-utils.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,qCAAqC,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAEvG;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,cAAc,EAAE,qCAAqC,EACrD,KAAK,EAAE,eAAe,GAAG,WAAW,EACpC,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,6BAA6B,EACrC,SAAS,EAAE,qCAAqC,GAC/C,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzD"}

package/dist/gatt-utils.js

@@ -0,0 +1,99 @@
+import { V3_HANDSHAKE_MTU, V3_INIT_PACKET, V3_LEGACY_NOTIFY_CHAR, V3_LEGACY_SERVICE, V3_NORDIC_OTA_CHAR, V3_NORDIC_OTA_SERVICE, } from './constants.js';
+/**
+ * Shared GATT write with a fallback chain across the three write methods a
+ * characteristic might expose. Standalone (not a class method) so every
+ * 47L12x-family adapter can call it without needing to extend
+ * `BaseCoyoteProtocolAdapter` — Coyote, paw-prints, civet-edging, and
+ * opossum all share this exact write behavior even though their command
+ * shapes differ.
+ */
+export async function writeCharacteristicValue(characteristic, value, options = {}) {
+    const attempts = options.preferResponse
+        ? [
+            characteristic.writeValueWithResponse?.bind(characteristic),
+            characteristic.writeValueWithoutResponse?.bind(characteristic),
+            characteristic.writeValue?.bind(characteristic),
+        ]
+        : [
+            characteristic.writeValueWithoutResponse?.bind(characteristic),
+            characteristic.writeValueWithResponse?.bind(characteristic),
+            characteristic.writeValue?.bind(characteristic),
+        ];
+    let lastError = null;
+    for (const attempt of attempts) {
+        if (!attempt)
+            continue;
+        try {
+            await attempt(value);
+            return;
+        }
+        catch (error) {
+            lastError = error;
+        }
+    }
+    throw lastError ?? new Error('Bluetooth characteristic is not writable');
+}
+/**
+ * Newer firmware (flashed via the official app) ignores normal control
+ * writes on the 0x180C/0x150A characteristic until it has seen the same
+ * connect-time sequence the app always sends: an init packet, best-effort
+ * subscription to two legacy/OTA notify channels, and an MTU bump to 140.
+ *
+ * The official app sends this exact same init packet unconditionally to
+ * every 47L12x-family device it connects to — Coyote, paw-prints,
+ * civet-edging, and opossum all share the identical 0x180C GATT skeleton —
+ * old and new firmware alike, with no firmware-version detection gating it.
+ * So this needs to run for all four device adapters, not just Coyote V3;
+ * originally it only ran there, which reproduced the exact "device won't
+ * respond" symptom for the three newer device kinds. Every step is
+ * best-effort/non-fatal, including the init write itself: if any step fails
+ * on a real device this hasn't been tested against, the caller's normal
+ * control writes still proceed rather than the connection being refused.
+ */
+export async function performV3FamilyConnectHandshake(server, writeChar) {
+    try {
+        await writeCharacteristicValue(writeChar, V3_INIT_PACKET);
+    }
+    catch {
+        // Best-effort — see function comment above.
+    }
+    try {
+        const legacyService = await server.getPrimaryService(V3_LEGACY_SERVICE);
+        const legacyChar = await legacyService.getCharacteristic(V3_LEGACY_NOTIFY_CHAR);
+        await legacyChar.startNotifications();
+    }
+    catch {
+        // Not present on this firmware/hardware — non-fatal.
+    }
+    try {
+        const otaService = await server.getPrimaryService(V3_NORDIC_OTA_SERVICE);
+        const otaChar = await otaService.getCharacteristic(V3_NORDIC_OTA_CHAR);
+        await otaChar.startNotifications();
+    }
+    catch {
+        // Only present on OTA-capable firmware — non-fatal.
+    }
+    try {
+        await server.requestMTU?.(V3_HANDSHAKE_MTU);
+    }
+    catch {
+        // Transport may not support MTU negotiation — non-fatal.
+    }
+}
+/**
+ * The 47L12x-family indicator LED is a discrete 8-color enum, not a
+ * continuous byte — confirmed against the community protocol doc's
+ * paw-prints color table (0=熄灭/off, 1=黄, 2=红, 3=紫, 4=蓝, 5=青, 6=绿,
+ * 7=白) and consistent with civet-edging's one documented example
+ * ("01为黄色" — matches index 1 in that same table). Values 8-255 have no
+ * defined meaning on real hardware, so every adapter clamps here rather
+ * than trusting the caller (a stray remote-control byte or a naive 0-255
+ * color picker would otherwise reach the wire unclamped).
+ */
+export function clampIndicatorColor(color) {
+    const value = Number(color);
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.max(0, Math.min(7, Math.round(value)));
+}
+//# sourceMappingURL=gatt-utils.js.map

package/dist/gatt-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatt-utils.js","sourceRoot":"","sources":["../src/gatt-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAGxB;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,cAAqD,EACrD,KAAoC,EACpC,UAAwC,EAAE;IAE1C,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc;QACrC,CAAC,CAAC;YACE,cAAc,CAAC,sBAAsB,EAAE,IAAI,CAAC,cAAc,CAAC;YAC3D,cAAc,CAAC,yBAAyB,EAAE,IAAI,CAAC,cAAc,CAAC;YAC9D,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC;SAChD;QACH,CAAC,CAAC;YACE,cAAc,CAAC,yBAAyB,EAAE,IAAI,CAAC,cAAc,CAAC;YAC9D,cAAc,CAAC,sBAAsB,EAAE,IAAI,CAAC,cAAc,CAAC;YAC3D,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC;SAChD,CAAC;IAEN,IAAI,SAAS,GAAY,IAAI,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IAED,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,MAAqC,EACrC,SAAgD;IAEhD,IAAI,CAAC;QACH,MAAM,wBAAwB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,4CAA4C;IAC9C,CAAC;IAED,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;QACxE,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,CAAC;QAChF,MAAM,UAAU,CAAC,kBAAkB,EAAE,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;QACvE,MAAM,OAAO,CAAC,kBAAkB,EAAE,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;IACtD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC,gBAAgB,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/dist/index.d.ts

@@ -1,7 +1,10 @@
 export * from './constants.js';
 export * from './types.js';
-export { BaseCoyoteProtocolAdapter, INACTIVE_FREQ, INACTIVE_INT, SILENT_WAVE_STEP, type ChannelWaveState, type Quad, type StateListener, type WaveStep, type WebBluetoothAvailability, type WebBluetoothConnectionContext, type WebBluetoothProtocolAdapter, } from './base.js';
+export { BaseCoyoteProtocolAdapter, INACTIVE_FREQ, INACTIVE_INT, SILENT_WAVE_STEP, type ChannelWaveState, type Quad, type StateListener, type WaveStep, type WebBluetoothAvailability, type WebBluetoothConnectionContext, type WebBluetoothProtocolAdapter, type WebBluetoothSensorAdapter, } from './base.js';
 export { CoyoteV2ProtocolAdapter } from './v2.js';
 export { CoyoteV3ProtocolAdapter } from './v3.js';
 export { CoyoteProtocolAdapter } from './facade.js';
+export { PawPrintsSensorAdapter, type PawPrintsReading, type PawPrintsReadingListener, type PawPrintsStateListener, } from './paw-prints.js';
+export { CivetPressureSensorAdapter, type CivetPressureReading } from './civet-edging.js';
+export { OpossumVibrateAdapter, createEmptyOpossumState, type OpossumState, type OpossumButton, type OpossumButtonEvent, } from './opossum.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,IAAI,EACT,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,GACjC,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,IAAI,EACT,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,GAC/B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,GAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,0BAA0B,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -4,4 +4,7 @@ export { BaseCoyoteProtocolAdapter, INACTIVE_FREQ, INACTIVE_INT, SILENT_WAVE_STE
 export { CoyoteV2ProtocolAdapter } from './v2.js';
 export { CoyoteV3ProtocolAdapter } from './v3.js';
 export { CoyoteProtocolAdapter } from './facade.js';
+export { PawPrintsSensorAdapter, } from './paw-prints.js';
+export { CivetPressureSensorAdapter } from './civet-edging.js';
+export { OpossumVibrateAdapter, createEmptyOpossumState, } from './opossum.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,YAAY,EACZ,gBAAgB,GAQjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,YAAY,EACZ,gBAAgB,GASjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,sBAAsB,GAIvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,0BAA0B,EAA6B,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GAIxB,MAAM,cAAc,CAAC"}

package/dist/opossum.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Opossum Vibrate Controller (负鼠振动控制器) protocol adapter.
+ *
+ * Unlike Coyote (stim, strength+waveform) or the paw-prints/civet-edging
+ * sensors (pure telemetry), this is a dual-channel vibration device that
+ * both accepts intensity commands (output) AND reports physical button
+ * presses (input). It doesn't fit `WebBluetoothProtocolAdapter` (that
+ * interface's `DeviceCommand`/`DeviceState` are Coyote-strength-shaped with
+ * frequency/waveform concepts this device has no notion of) or
+ * `WebBluetoothSensorAdapter` (this device isn't pure-sensor), so it gets
+ * its own standalone public API instead.
+ *
+ * GATT skeleton is identical to Coyote V3 (service 0x180C, write 0x150A,
+ * notify 0x150B, battery 0x180A/0x1500) — only the opcodes differ.
+ *
+ * Assumption: the community protocol doc's marketing name "Opossum
+ * Vibration Controller 47L127000" suggests a product-name-prefixed BLE
+ * name, but every sibling 47L12x-family device advertises a bare
+ * `47L1XX000`-style model string with no product-name prefix, so the
+ * advertised BLE name is assumed to be just `47L127000`
+ * (`OPOSSUM_DEVICE_NAME_PREFIX`), not literally starting with "Opossum".
+ *
+ * Android side note from the doc: MTU should be negotiated up to 144 for
+ * this device family. That's a transport-layer concern (the caller's BLE
+ * connect step), out of scope here — this file only builds/parses packets.
+ */
+import type { Channel } from '@dg-kit/core';
+import type { WebBluetoothConnectionContext } from './base.js';
+export interface OpossumState {
+    connected: boolean;
+    deviceName?: string;
+    address?: string;
+    battery?: number;
+    intensityA: number;
+    intensityB: number;
+}
+export declare function createEmptyOpossumState(): OpossumState;
+export type OpossumButton = 'SEL_1' | 'SEL_2' | 'HOME' | 'Up' | 'Down' | 'Left' | 'Right' | 'B' | 'A' | 'G' | 'D';
+export interface OpossumButtonEvent {
+    sequence: number;
+    pressed: Set<OpossumButton>;
+}
+type OpossumStateListener = (state: OpossumState) => void;
+type OpossumButtonListener = (event: OpossumButtonEvent) => void;
+export declare class OpossumVibrateAdapter {
+    private state;
+    private writeChar;
+    private notifyChar;
+    private batteryChar;
+    private readonly stateListeners;
+    private readonly buttonListeners;
+    onConnected(context: WebBluetoothConnectionContext): Promise<void>;
+    onDisconnected(): Promise<void>;
+    getState(): OpossumState;
+    subscribeButtons(listener: OpossumButtonListener): () => void;
+    onStateChanged(listener: OpossumStateListener): () => void;
+    /**
+     * 0xB3 direct intensity: A/B in 0-200, or 'unchanged' to leave that
+     * channel as-is (mapped to the 0xFF sentinel byte).
+     */
+    setIntensity(channelA: number | 'unchanged', channelB: number | 'unchanged'): Promise<void>;
+    /**
+     * Relative adjust for one channel, e.g. for a `vibrate_adjust` tool call.
+     * Reads the current intensity and writes the new absolute value in one
+     * call so a caller never has to do `getState()` + `setIntensity()` as two
+     * separate steps — doing it as two steps would let two concurrent adjust
+     * calls (an LLM tool call racing a manual UI tweak, say) both read the
+     * same stale value and the second write silently clobber the first's
+     * delta instead of compounding.
+     */
+    adjustIntensity(channel: Channel, delta: number): Promise<void>;
+    /**
+     * 0xB0 vibration waveform. This is a single packet builder/writer — the
+     * device expects it re-sent (~every 100ms) by the CALLER to sustain a
+     * waveform effect, but that re-send loop is the caller's responsibility;
+     * this device doesn't need (and this adapter doesn't run) a tick loop
+     * the way Coyote does, since 0xB3 is a direct "set now" command.
+     */
+    writeWaveformFrame(channelA: [number, number, number, number], channelB: [number, number, number, number]): Promise<void>;
+    /** 0x50 LED color + button-state-reporting toggle. */
+    setLed(color: number, enableButtonReporting: boolean): Promise<void>;
+    /**
+     * 0xB2 screen display update: fixed 21-byte preamble + current A/B
+     * intensity. The source doc's summary states "23 bytes" total but also
+     * enumerates exactly 21 fixed preamble bytes; 1 (opcode) + 21 + 2 (A/B)
+     * is actually 24. Trusting the literal, unambiguous byte enumeration over
+     * the (likely miscounted) total-length label.
+     */
+    updateDisplay(channelA: number, channelB: number): Promise<void>;
+    /** Best-effort safety call: drive both channels to zero, ignore failures. */
+    emergencyStop(): Promise<void>;
+    private readonly handleNotification;
+    private write;
+    private clamp;
+    private emitState;
+    private emitButtonEvent;
+}
+export {};
+//# sourceMappingURL=opossum.d.ts.map

package/dist/opossum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opossum.d.ts","sourceRoot":"","sources":["../src/opossum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAe/D,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,uBAAuB,IAAI,YAAY,CAEtD;AAED,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,OAAO,GACP,MAAM,GACN,IAAI,GACJ,MAAM,GACN,MAAM,GACN,OAAO,GACP,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,CAAC;AAER,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;CAC7B;AAiBD,KAAK,oBAAoB,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AAC1D,KAAK,qBAAqB,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAEjE,qBAAa,qBAAqB;IAChC,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,SAAS,CAAsD;IACvE,OAAO,CAAC,UAAU,CAAsD;IACxE,OAAO,CAAC,WAAW,CAAsD;IAEzE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmC;IAClE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoC;IAE9D,WAAW,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IA0ClE,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBrC,QAAQ,IAAI,YAAY;IAIxB,gBAAgB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAO7D,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAO1D;;;OAGG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,GAAG,WAAW,EAC9B,QAAQ,EAAE,MAAM,GAAG,WAAW,GAC7B,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;;;;;OAQG;IACG,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrE;;;;;;OAMG;IACG,kBAAkB,CACtB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC1C,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC;IAchB,sDAAsD;IAChD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1E;;;;;;OAMG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IActE,6EAA6E;IACvE,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAQpC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAwBjC;YAEY,KAAK;IAOnB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,eAAe;CAKxB"}

package/dist/opossum.js

@@ -0,0 +1,238 @@
+import { V3_BATTERY_CHAR, V3_BATTERY_SERVICE, V3_NOTIFY_CHAR, V3_PRIMARY_SERVICE, V3_WRITE_CHAR, } from './constants.js';
+import { clampIndicatorColor, performV3FamilyConnectHandshake, writeCharacteristicValue, } from './gatt-utils.js';
+export function createEmptyOpossumState() {
+    return { connected: false, battery: 0, intensityA: 0, intensityB: 0 };
+}
+/** Bit position (in the little-endian 16-bit bitmap) for each named button. */
+const BUTTON_BITS = [
+    ['SEL_1', 0],
+    ['SEL_2', 1],
+    ['HOME', 2],
+    ['Up', 8],
+    ['Down', 9],
+    ['Left', 10],
+    ['Right', 11],
+    ['B', 12],
+    ['A', 13],
+    ['G', 14],
+    ['D', 15],
+];
+export class OpossumVibrateAdapter {
+    state = createEmptyOpossumState();
+    writeChar = null;
+    notifyChar = null;
+    batteryChar = null;
+    stateListeners = new Set();
+    buttonListeners = new Set();
+    async onConnected(context) {
+        try {
+            const primaryService = await context.server.getPrimaryService(V3_PRIMARY_SERVICE);
+            this.writeChar = await primaryService.getCharacteristic(V3_WRITE_CHAR);
+            this.notifyChar = await primaryService.getCharacteristic(V3_NOTIFY_CHAR);
+            await this.notifyChar.startNotifications();
+            this.notifyChar.addEventListener('characteristicvaluechanged', this.handleNotification);
+            await performV3FamilyConnectHandshake(context.server, this.writeChar);
+            let battery = 0;
+            try {
+                const batteryService = await context.server.getPrimaryService(V3_BATTERY_SERVICE);
+                this.batteryChar = await batteryService.getCharacteristic(V3_BATTERY_CHAR);
+                const value = await this.batteryChar.readValue();
+                battery = value.getUint8(0);
+            }
+            catch {
+                // Best-effort: some units don't expose (or fail to read) battery.
+                this.batteryChar = null;
+                battery = 0;
+            }
+            this.state = {
+                connected: true,
+                deviceName: context.device.name ?? '',
+                address: context.device.id ?? '',
+                battery,
+                intensityA: 0,
+                intensityB: 0,
+            };
+            this.emitState();
+        }
+        catch (error) {
+            // Tear down the same way onDisconnected() does — if startNotifications()
+            // and addEventListener() above already succeeded before a later step
+            // threw (e.g. the handshake or battery read), leaving the subscription
+            // live here would leak it silently, since nothing else will ever call
+            // stopNotifications()/removeEventListener() for this failed attempt.
+            await this.onDisconnected();
+            throw error;
+        }
+    }
+    async onDisconnected() {
+        if (this.notifyChar) {
+            this.notifyChar.removeEventListener('characteristicvaluechanged', this.handleNotification);
+            try {
+                await this.notifyChar.stopNotifications();
+            }
+            catch {
+                // ignore best effort
+            }
+        }
+        this.writeChar = null;
+        this.notifyChar = null;
+        this.batteryChar = null;
+        this.state = createEmptyOpossumState();
+        this.emitState();
+    }
+    getState() {
+        return { ...this.state };
+    }
+    subscribeButtons(listener) {
+        this.buttonListeners.add(listener);
+        return () => {
+            this.buttonListeners.delete(listener);
+        };
+    }
+    onStateChanged(listener) {
+        this.stateListeners.add(listener);
+        return () => {
+            this.stateListeners.delete(listener);
+        };
+    }
+    /**
+     * 0xB3 direct intensity: A/B in 0-200, or 'unchanged' to leave that
+     * channel as-is (mapped to the 0xFF sentinel byte).
+     */
+    async setIntensity(channelA, channelB) {
+        const byteA = channelA === 'unchanged' ? 0xff : this.clamp(channelA, 0, 200);
+        const byteB = channelB === 'unchanged' ? 0xff : this.clamp(channelB, 0, 200);
+        const packet = new Uint8Array([0xb3, byteA, byteB]);
+        await this.write(packet);
+        if (channelA !== 'unchanged')
+            this.state.intensityA = byteA;
+        if (channelB !== 'unchanged')
+            this.state.intensityB = byteB;
+        this.emitState();
+    }
+    /**
+     * Relative adjust for one channel, e.g. for a `vibrate_adjust` tool call.
+     * Reads the current intensity and writes the new absolute value in one
+     * call so a caller never has to do `getState()` + `setIntensity()` as two
+     * separate steps — doing it as two steps would let two concurrent adjust
+     * calls (an LLM tool call racing a manual UI tweak, say) both read the
+     * same stale value and the second write silently clobber the first's
+     * delta instead of compounding.
+     */
+    async adjustIntensity(channel, delta) {
+        const current = channel === 'A' ? this.state.intensityA : this.state.intensityB;
+        const next = this.clamp(current + delta, 0, 200);
+        if (channel === 'A') {
+            await this.setIntensity(next, 'unchanged');
+        }
+        else {
+            await this.setIntensity('unchanged', next);
+        }
+    }
+    /**
+     * 0xB0 vibration waveform. This is a single packet builder/writer — the
+     * device expects it re-sent (~every 100ms) by the CALLER to sustain a
+     * waveform effect, but that re-send loop is the caller's responsibility;
+     * this device doesn't need (and this adapter doesn't run) a tick loop
+     * the way Coyote does, since 0xB3 is a direct "set now" command.
+     */
+    async writeWaveformFrame(channelA, channelB) {
+        const packet = new Uint8Array(20);
+        packet[0] = 0xb0;
+        // bytes 1-7 are reserved/zero
+        for (let i = 0; i < 4; i++) {
+            // Doc doesn't fully specify "invalidates" semantics for >100 bytes;
+            // clamping to 100 is the conservative reading rather than wrapping.
+            packet[8 + i] = this.clamp(channelA[i] ?? 0, 0, 100);
+            packet[16 + i] = this.clamp(channelB[i] ?? 0, 0, 100);
+        }
+        // bytes 12-15 are reserved/zero
+        await this.write(packet);
+    }
+    /** 0x50 LED color + button-state-reporting toggle. */
+    async setLed(color, enableButtonReporting) {
+        const packet = new Uint8Array([
+            0x50,
+            clampIndicatorColor(color),
+            enableButtonReporting ? 0x01 : 0x00,
+        ]);
+        await this.write(packet);
+    }
+    /**
+     * 0xB2 screen display update: fixed 21-byte preamble + current A/B
+     * intensity. The source doc's summary states "23 bytes" total but also
+     * enumerates exactly 21 fixed preamble bytes; 1 (opcode) + 21 + 2 (A/B)
+     * is actually 24. Trusting the literal, unambiguous byte enumeration over
+     * the (likely miscounted) total-length label.
+     */
+    async updateDisplay(channelA, channelB) {
+        const preamble = [
+            0xff, 0xff, 0x00, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff,
+            0xff, 0xff, 0xff, 0xff, 0x08, 0x09,
+        ];
+        const packet = new Uint8Array([
+            0xb2,
+            ...preamble,
+            this.clamp(channelA, 0, 200),
+            this.clamp(channelB, 0, 200),
+        ]);
+        await this.write(packet);
+    }
+    /** Best-effort safety call: drive both channels to zero, ignore failures. */
+    async emergencyStop() {
+        try {
+            await this.setIntensity(0, 0);
+        }
+        catch {
+            // ignore best effort
+        }
+    }
+    handleNotification = (event) => {
+        const target = event.target;
+        const value = target?.value;
+        if (!value || value.byteLength < 1)
+            return;
+        const opcode = value.getUint8(0);
+        if (opcode === 0xb3 && value.byteLength >= 3) {
+            this.state.intensityA = value.getUint8(1);
+            this.state.intensityB = value.getUint8(2);
+            this.emitState();
+            return;
+        }
+        if (opcode === 0xd0 && value.byteLength >= 4) {
+            const sequence = value.getUint8(1);
+            const bitmap = value.getUint8(2) | (value.getUint8(3) << 8);
+            const pressed = new Set();
+            for (const [button, bit] of BUTTON_BITS) {
+                if ((bitmap & (1 << bit)) !== 0) {
+                    pressed.add(button);
+                }
+            }
+            this.emitButtonEvent({ sequence, pressed });
+        }
+    };
+    async write(packet) {
+        if (!this.writeChar) {
+            throw new Error('Opossum device is not connected');
+        }
+        await writeCharacteristicValue(this.writeChar, packet);
+    }
+    clamp(value, min, max) {
+        const number = Number(value);
+        if (!Number.isFinite(number))
+            return min;
+        return Math.max(min, Math.min(max, Math.round(number)));
+    }
+    emitState() {
+        const snapshot = this.getState();
+        for (const listener of this.stateListeners) {
+            listener(snapshot);
+        }
+    }
+    emitButtonEvent(event) {
+        for (const listener of this.buttonListeners) {
+            listener(event);
+        }
+    }
+}
+//# sourceMappingURL=opossum.js.map

package/dist/opossum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opossum.js","sourceRoot":"","sources":["../src/opossum.ts"],"names":[],"mappings":"AA4BA,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAYzB,MAAM,UAAU,uBAAuB;IACrC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;AACxE,CAAC;AAoBD,+EAA+E;AAC/E,MAAM,WAAW,GAAoD;IACnE,CAAC,OAAO,EAAE,CAAC,CAAC;IACZ,CAAC,OAAO,EAAE,CAAC,CAAC;IACZ,CAAC,MAAM,EAAE,CAAC,CAAC;IACX,CAAC,IAAI,EAAE,CAAC,CAAC;IACT,CAAC,MAAM,EAAE,CAAC,CAAC;IACX,CAAC,MAAM,EAAE,EAAE,CAAC;IACZ,CAAC,OAAO,EAAE,EAAE,CAAC;IACb,CAAC,GAAG,EAAE,EAAE,CAAC;IACT,CAAC,GAAG,EAAE,EAAE,CAAC;IACT,CAAC,GAAG,EAAE,EAAE,CAAC;IACT,CAAC,GAAG,EAAE,EAAE,CAAC;CACV,CAAC;AAKF,MAAM,OAAO,qBAAqB;IACxB,KAAK,GAAiB,uBAAuB,EAAE,CAAC;IAChD,SAAS,GAAiD,IAAI,CAAC;IAC/D,UAAU,GAAiD,IAAI,CAAC;IAChE,WAAW,GAAiD,IAAI,CAAC;IAExD,cAAc,GAAG,IAAI,GAAG,EAAwB,CAAC;IACjD,eAAe,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEpE,KAAK,CAAC,WAAW,CAAC,OAAsC;QACtD,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;YAClF,IAAI,CAAC,SAAS,GAAG,MAAM,cAAc,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;YACvE,IAAI,CAAC,UAAU,GAAG,MAAM,cAAc,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;YACzE,MAAM,IAAI,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC;YAC3C,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,4BAA4B,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAExF,MAAM,+BAA+B,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAEtE,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;gBAClF,IAAI,CAAC,WAAW,GAAG,MAAM,cAAc,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;gBAC3E,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;gBACjD,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC9B,CAAC;YAAC,MAAM,CAAC;gBACP,kEAAkE;gBAClE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;gBACxB,OAAO,GAAG,CAAC,CAAC;YACd,CAAC;YAED,IAAI,CAAC,KAAK,GAAG;gBACX,SAAS,EAAE,IAAI;gBACf,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE;gBACrC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE;gBAChC,OAAO;gBACP,UAAU,EAAE,CAAC;gBACb,UAAU,EAAE,CAAC;aACd,CAAC;YACF,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yEAAyE;YACzE,qEAAqE;YACrE,uEAAuE;YACvE,sEAAsE;YACtE,qEAAqE;YACrE,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;YAC5B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,4BAA4B,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC3F,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,qBAAqB;YACvB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,uBAAuB,EAAE,CAAC;QACvC,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,gBAAgB,CAAC,QAA+B;QAC9C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,QAA8B;QAC3C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAChB,QAA8B,EAC9B,QAA8B;QAE9B,MAAM,KAAK,GAAG,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QAE7E,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACpD,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEzB,IAAI,QAAQ,KAAK,WAAW;YAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC;QAC5D,IAAI,QAAQ,KAAK,WAAW;YAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC;QAC5D,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,eAAe,CAAC,OAAgB,EAAE,KAAa;QACnD,MAAM,OAAO,GAAG,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;QAChF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QACjD,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YACpB,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,kBAAkB,CACtB,QAA0C,EAC1C,QAA0C;QAE1C,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QACjB,8BAA8B;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,oEAAoE;YACpE,oEAAoE;YACpE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;YACrD,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QACxD,CAAC;QACD,gCAAgC;QAChC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,qBAA8B;QACxD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC;YAC5B,IAAI;YACJ,mBAAmB,CAAC,KAAK,CAAC;YAC1B,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;SACpC,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,QAAgB;QACpD,MAAM,QAAQ,GAAG;YACf,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;YACxF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;SACnC,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC;YAC5B,IAAI;YACJ,GAAG,QAAQ;YACX,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,GAAG,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,GAAG,CAAC;SAC7B,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IAEgB,kBAAkB,GAAG,CAAC,KAAY,EAAQ,EAAE;QAC3D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAsD,CAAC;QAC5E,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,CAAC;QAC5B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC;YAAE,OAAO;QAE3C,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1C,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QAED,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;YACzC,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,WAAW,EAAE,CAAC;gBACxC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;oBAChC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;YACD,IAAI,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,MAAkB;QACpC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QACD,MAAM,wBAAwB,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IAEO,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;QACnD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,GAAG,CAAC;QACzC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAEO,SAAS;QACf,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC3C,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,KAAyB;QAC/C,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5C,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CACF"}

package/dist/paw-prints.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Protocol adapter for the "Paw-Prints" (爪印) wireless button/motion sensor.
+ *
+ * Shares the exact GATT skeleton with Coyote V3 (service 0x180C, write
+ * 0x150A, notify 0x150B, battery 0x180A/0x1500) — only the application-layer
+ * opcodes differ, so the transport wiring below mirrors `v3.ts` but the
+ * command/notification framing is Paw-Prints-specific.
+ *
+ * NOTE: the byte layout below is transcribed from a paraphrased summary of
+ * the community protocol doc, not a byte-exact spec or a real device
+ * capture. Fields called out with a comment are best-effort interpretations
+ * that need confirming against real hardware before being treated as
+ * authoritative.
+ */
+import { type SensorState } from '@dg-kit/core';
+import type { WebBluetoothConnectionContext, WebBluetoothSensorAdapter } from './base.js';
+export type PawPrintsReading = {
+    type: 'status';
+    color: number;
+    deviceType: number;
+    battery: number;
+} | {
+    type: 'trigger';
+    eventId: number;
+    parameterValue: number;
+} | {
+    type: 'triggerCancel';
+    eventId: number;
+} | {
+    type: 'parameterChange';
+    eventId: number;
+    value: number;
+} | {
+    type: 'physical';
+    sequence: number;
+    pressState: number;
+    acceleration: number;
+    angleX: number;
+    angleY: number;
+    angleZ: number;
+    extVoltage: number;
+} | {
+    type: 'autoDetectResult';
+    xRange: [number, number];
+    yRange: [number, number];
+    zRange: [number, number];
+};
+export type PawPrintsReadingListener = (reading: PawPrintsReading) => void;
+export type PawPrintsStateListener = (state: SensorState) => void;
+export declare class PawPrintsSensorAdapter implements WebBluetoothSensorAdapter<PawPrintsReading> {
+    private state;
+    private writeChar;
+    private notifyChar;
+    private batteryChar;
+    private readonly readingListeners;
+    private readonly stateListeners;
+    onConnected(context: WebBluetoothConnectionContext): Promise<void>;
+    onDisconnected(): Promise<void>;
+    getState(): SensorState;
+    subscribe(listener: PawPrintsReadingListener): () => void;
+    onStateChanged(listener: PawPrintsStateListener): () => void;
+    /**
+     * Sends the 0x50 config/trigger command. `config` is copied into the
+     * 14-byte trailing config block (truncated if longer, zero-padded if
+     * shorter/omitted).
+     */
+    configureTrigger(mode: number, color: number, config?: Uint8Array): Promise<void>;
+    resetParameters(): Promise<void>;
+    startAngleDetection(): Promise<void>;
+    setLedSolid(color: number): Promise<void>;
+    setLedBlink(color1: number, color2: number, speed: number): Promise<void>;
+    private resetConnection;
+    private emitState;
+    private writeCommand;
+    private readonly handleNotification;
+    private parseReading;
+}
+//# sourceMappingURL=paw-prints.d.ts.map

package/dist/paw-prints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paw-prints.d.ts","sourceRoot":"","sources":["../src/paw-prints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAA0B,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAQxE,OAAO,KAAK,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAQ1F,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3D;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1B,CAAC;AAEN,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAC3E,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAiBlE,qBAAa,sBAAuB,YAAW,yBAAyB,CAAC,gBAAgB,CAAC;IACxF,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,SAAS,CAAsD;IACvE,OAAO,CAAC,UAAU,CAAsD;IACxE,OAAO,CAAC,WAAW,CAAsD;IAEzE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuC;IACxE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqC;IAE9D,WAAW,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IAsClE,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC,QAAQ,IAAI,WAAW;IAIvB,SAAS,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,IAAI;IAOzD,cAAc,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,IAAI;IAO5D;;;;OAIG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjF,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAWjE,eAAe;IA2B7B,OAAO,CAAC,SAAS;YAOH,YAAY;IAO1B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAWjC;IAEF,OAAO,CAAC,YAAY;CA8ErB"}