@pollen-robotics/reachy-mini-sdk 1.7.3 → 1.8.0-rc1

package/CHANGELOG.md

@@ -0,0 +1,188 @@
+# Changelog
+
+All notable changes to `@pollen-robotics/reachy-mini-sdk` are
+documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Versions
+are kept in lock-step with the Reachy Mini Python daemon and are
+driven from `pyproject.toml` at the repo root (the npm publish CI
+overrides the `version` placeholder in `package.json`).
+
+The host shell shares this package's version (single source of
+truth); the wire protocol is versioned separately in
+`PROTOCOL_VERSION` (see [host/SPEC.md §11](./host/SPEC.md#11-backlog)).
+
+## Unreleased — succeeds 1.7.3
+
+> **Breaking change.** Every app currently using
+> `@pollen-robotics/reachy-mini-host` has to update its imports
+> when it upgrades. Existing `1.7.x` installs keep working against
+> the legacy `reachy-mini-host@1.7.x` tarball that stays on npm;
+> only consumers who upgrade past `1.7.3` need to migrate. The
+> target version is intentionally left unset in this PR — it will
+> be picked at release time when `pyproject.toml` is bumped from
+> `1.7.3` to the next number (the npm publish CI mirrors that bump
+> into the package manifest).
+
+**Single-package release: `@pollen-robotics/reachy-mini-host` is folded
+into `@pollen-robotics/reachy-mini-sdk`.** App authors install,
+version, and import from one entry point. The old package stays
+available on npm at `1.7.x` for one minor cycle for graceful
+migration and will then be `npm deprecate`d with a pointer to the
+new subpaths.
+
+### Migration
+
+```diff
+- "@pollen-robotics/reachy-mini-host": "^1.7.x",
+- "@pollen-robotics/reachy-mini-sdk":  "^1.7.x"
++ "@pollen-robotics/reachy-mini-sdk":  "^<next-release>"
+```
+
+```diff
+- import { mountHost }        from '@pollen-robotics/reachy-mini-host/auto';
+- import { connectToHost }    from '@pollen-robotics/reachy-mini-host/embed';
+- import { PROTOCOL_VERSION } from '@pollen-robotics/reachy-mini-host/protocol';
++ import { mountHost }        from '@pollen-robotics/reachy-mini-sdk/host/auto';
++ import { connectToHost }    from '@pollen-robotics/reachy-mini-sdk/host/embed';
++ import { PROTOCOL_VERSION } from '@pollen-robotics/reachy-mini-sdk/host/protocol';
+```
+
+The host CDN bundles also moved:
+
+```diff
+- https://cdn.jsdelivr.net/npm/@pollen-robotics/reachy-mini-host@1/dist/entry/auto.js
++ https://cdn.jsdelivr.net/npm/@pollen-robotics/reachy-mini-sdk@1/host/dist/entry/auto.js
+```
+
+### Added
+
+- New subpath exports on `@pollen-robotics/reachy-mini-sdk`:
+  - `./host`           — `mountHost`, `connectToHost`, types
+  - `./host/auto`      — CDN auto bundle for standalone apps
+  - `./host/embed`     — CDN embed bundle for the iframe side
+  - `./host/protocol`  — `PROTOCOL_VERSION`, `decodeCredsFromHash`, etc.
+- `reachy-mini-sdk.d.ts` ships next to `reachy-mini-sdk.js` as the
+  canonical SDK type surface. The host re-exports from there
+  (`host/src/lib/sdk-types.ts` is now a thin barrel), removing the
+  earlier duplication TODO.
+
+### Changed
+
+- The host bundles (`./host`, `./host/auto`, `./host/embed`) now
+  import the SDK runtime directly and self-assign
+  `window.ReachyMini` (when unset) at module-load time, dispatching
+  `reachymini:ready`. App `index.html` files no longer need a
+  separate `<script type="module">` to load the SDK on the global,
+  and `useSdk` + `connectToHost` no longer race against a
+  late-arriving global. Apps that still set `window.ReachyMini`
+  themselves are unaffected — we only assign when it's missing.
+- Log-prefix tag harmonised to `[reachy-mini-sdk/host]` /
+  `[reachy-mini-sdk/host/embed]` for greppability.
+- Internal repo layout: `js/sdk/*` collapsed into `js/*` now that
+  there is only one package. The host source lives at `js/host/`,
+  the SDK runtime at `js/reachy-mini-sdk.js`, the package manifest
+  at `js/package.json`. No effect on consumers; only the
+  `repository.directory` field and the npm-publish CI working
+  directory changed.
+
+### Removed
+
+- Workspace coordinator `js/package.json` (was an npm workspace
+  root) and `js/package-lock.json` at the workspace level. The
+  single package's lockfile lives at `js/package-lock.json`.
+- `@pollen-robotics/reachy-mini-host` package manifest — the host
+  ships under `@pollen-robotics/reachy-mini-sdk/host*` now. The
+  legacy npm package stays on `1.7.x` for one minor cycle for
+  graceful migration, then will be `npm deprecate`d.
+
+### SDK changes drafted between 1.7.3 and the package merge
+
+The following landed on `main` after `1.7.3` was published but
+were never released on their own; they ship with this release:
+
+- **Breaking (SDK)**: `wakeUp()` and `gotoSleep()` now return
+  `Promise<void>` (previously `boolean`). The promise resolves on
+  the daemon's `{command, completed: true}` response, after the
+  trajectory player has fully landed. Apps that previously relied
+  on the boolean return are unaffected in practice; apps that
+  *want* to await trajectory completion (e.g. to chain
+  `setMotorMode("disabled")` after a `gotoSleep`) can now do so
+  without racing.
+- **SDK**: both motion helpers take an optional `{ timeoutMs }`
+  (default 8000 ms). The promise rejects on session teardown
+  (`stopSession` / `disconnect`) so consumers never wait forever
+  on an interrupted trajectory.
+- **SDK**: `POST /send` responses with a 4xx / 5xx status now
+  produce a `console.warn` carrying the rejected message `type`
+  and the response body, making racy `setPeerStatus` /
+  `endSession` failures easier to diagnose.
+- **Host types**: `src/lib/sdk-types.ts` refreshed to cover the
+  full SDK public surface (`autoConnect`, `gotoTarget`,
+  `setMotorTorque`, `subscribeLogs`, `requestState`, version /
+  hardware-id helpers, `robotState`, `isEmbedded`, jitter buffer
+  option, `autoStartFromUrl`). The motion helpers now type as
+  `Promise<void>` to match the SDK.
+
+## 0.3.0 - 2026-05-16 (unreleased)
+
+**This release is a full rewrite of the package against
+[SPEC.md v1.0](./host/SPEC.md).** The public surface and the wire
+protocol both change in incompatible ways.
+
+### Breaking changes
+
+- **API**: `mountHost()` options reduced to the documented surface
+  (`appName`, `appIconUrl`, `appEmoji`, `enableMicrophone`,
+  `clientId`, `devToken`, `target`). The following are removed:
+  - `theme: { light, dark }` (host owns its bundled MUI theme).
+  - `skipTheme` (no consumer-driven theming).
+  - `skipAuth` (host owns OAuth).
+- **API**: `ConnectedHandle` reduced to the documented surface.
+  The following are removed:
+  - `sendCustom()` / `onCustom()` (no free-form bidi channel).
+  - `requestConfigUpdate()` (apps don't push config upstream).
+- **API**: `devToken` payload renamed `{ token, username }` →
+  `{ token, userName }` for camelCase consistency with `appName`
+  and `hostName`.
+- **API**: `ConnectedHandle.username` renamed to `ConnectedHandle.userName`.
+- **Protocol**: `host:custom` / `embed:custom` removed.
+- **Protocol**: `embed:request-config-update` removed.
+- **Host shell**: removed the legacy `?app=<owner>/<space>`
+  branding-swap behaviour. The host renders exactly the app it
+  ships with, never another. Multi-app routing now lives in the
+  mobile catalog only.
+
+### Added
+
+- `SPEC.md` (v1.0): behavioural contract, state machines,
+  4 engineering invariants (single SDK per tab, token hygiene,
+  bundle pinning, React Strict Mode safety).
+- `APP_AUTHOR_GUIDE.md`: step-by-step guide for building a new
+  app on top of the host.
+- `REBUILD_PLAN.md`: project plan tracking the rewrite (deleted
+  once 0.3.0 ships).
+- `LICENSE` (MIT).
+
+### Changed
+
+- **Documentation**: replaced the legacy `SPEC.md` (823 lines,
+  ambitious-future spec) with a focused v1.0 spec (~620 lines)
+  matching what we actually want to ship.
+- **Package metadata**: `repository.url` now points at the
+  host-only repo. `homepage` and `bugs` added.
+- **Versioning policy**: stays permissive pre-1.0 (see SPEC §11
+  "Versioning policy"); each minor release between 0.x.y may
+  ship breaking changes. Semver-strict starts at 1.0.
+
+### Why a rewrite instead of a refactor
+
+See `REBUILD_PLAN.md` § "Why a rebuild, not a refactor". TL;DR:
+the API surface shrinks too much, and the previous code carried
+half-implemented features (protocol-version negotiation,
+heartbeat, custom channels) that were cheaper to retype than to
+selectively remove.
+
+## 0.2.0 - 2026-05-15
+
+Initial extraction of the host shell into a standalone package.
+Predates the SPEC.md v1.0 rewrite; deprecated in favour of 0.3.0.

package/README.md

@@ -1,8 +1,13 @@
 # @pollen-robotics/reachy-mini-sdk
 
-Browser SDK for controlling a [Reachy Mini](https://github.com/pollen-robotics/reachy_mini) robot over WebRTC.
+The JS package for [Reachy Mini](https://github.com/pollen-robotics/reachy_mini). It ships:
 
-The full API reference lives in the JSDoc header of [`reachy-mini-sdk.js`](./reachy-mini-sdk.js): constructor options, read-only properties, the `disconnected → connected → streaming` state machine, the event list, and every command helper.
+- The **browser SDK** (`ReachyMini` class) for direct WebRTC control — the default export.
+- An optional **host shell** (OAuth + robot picker + iframe bridge) for apps deployed as Hugging Face Spaces, exposed under the `./host*` subpaths.
+
+Both used to be separate npm packages (`@pollen-robotics/reachy-mini-sdk` + `@pollen-robotics/reachy-mini-host`); they were merged into a single entry point so app authors only install, version, and import from one place.
+
+The full SDK API reference lives in the JSDoc header of [`reachy-mini-sdk.js`](./reachy-mini-sdk.js): constructor options, read-only properties, the `disconnected → connected → streaming` state machine, the event list, and every command helper.
 
 ## Install
 
@@ -13,7 +18,13 @@ npm install @pollen-robotics/reachy-mini-sdk
 ```
 
 ```js
+// Low-level robot control
 import { ReachyMini } from "@pollen-robotics/reachy-mini-sdk";
+
+// Host shell for Hugging Face Spaces apps (OAuth + picker + iframe)
+import { mountHost } from "@pollen-robotics/reachy-mini-sdk/host";
+import { connectToHost } from "@pollen-robotics/reachy-mini-sdk/host/embed";
+import { PROTOCOL_VERSION } from "@pollen-robotics/reachy-mini-sdk/host/protocol";
 ```
 
 ### From a browser, no build step (Hugging Face Spaces, static hosting…)
@@ -21,16 +32,38 @@ import { ReachyMini } from "@pollen-robotics/reachy-mini-sdk";
 Use an ESM CDN. The `+esm` suffix tells jsdelivr to resolve bare specifiers (the `@huggingface/hub` dependency) recursively, so the import just works:
 
 ```js
-import { ReachyMini } from "https://cdn.jsdelivr.net/npm/@pollen-robotics/reachy-mini-sdk@1.7.3/+esm";
+import { ReachyMini } from "https://cdn.jsdelivr.net/npm/@pollen-robotics/reachy-mini-sdk@1/+esm";
 ```
 
 Or via esm.sh:
 
 ```js
-import { ReachyMini } from "https://esm.sh/@pollen-robotics/reachy-mini-sdk@1.7.3";
+import { ReachyMini } from "https://esm.sh/@pollen-robotics/reachy-mini-sdk@1";
+```
+
+Track bleeding-edge from `main`:
+
+```js
+import { ReachyMini } from "https://cdn.jsdelivr.net/npm/@pollen-robotics/reachy-mini-sdk@main/+esm";
+```
+
+The host CDN bundles live under the same package:
+
+```html
+<!-- Standalone host shell entry -->
+<script type="module"
+  src="https://cdn.jsdelivr.net/npm/@pollen-robotics/reachy-mini-sdk@1/host/dist/entry/auto.js">
+</script>
+
+<!-- Embed-side client (inside the iframe) -->
+<script type="module"
+  src="https://cdn.jsdelivr.net/npm/@pollen-robotics/reachy-mini-sdk@1/host/dist/entry/embed.js">
+</script>
 ```
 
-## Quick start
+Both bundles auto-install the SDK on `window.ReachyMini` at load time, so an app that uses the host no longer needs a separate `<script type="module">` to expose the SDK.
+
+## Quick start (SDK only)
 
 ```js
 import { ReachyMini } from "@pollen-robotics/reachy-mini-sdk";
@@ -61,6 +94,36 @@ robot.playSound("wake_up.wav");
 
 See the JSDoc header in [`reachy-mini-sdk.js`](./reachy-mini-sdk.js) for the full surface (events, raw `setTarget`, audio controls, embedded-mode auto-start, etc.).
 
+## Host shell
+
+For Hugging Face Spaces apps that need OAuth + a robot picker + iframe lifecycle management:
+
+- [`host/README.md`](./host/README.md) — quickstart and integration overview
+- [`host/APP_AUTHOR_GUIDE.md`](./host/APP_AUTHOR_GUIDE.md) — full guide for app authors
+- [`host/SPEC.md`](./host/SPEC.md) — host ↔ embed protocol spec
+
+## Migration from `@pollen-robotics/reachy-mini-host`
+
+```diff
+- import { mountHost }      from '@pollen-robotics/reachy-mini-host/auto';
+- import { connectToHost }  from '@pollen-robotics/reachy-mini-host/embed';
+- import { PROTOCOL_VERSION } from '@pollen-robotics/reachy-mini-host/protocol';
++ import { mountHost }      from '@pollen-robotics/reachy-mini-sdk/host/auto';
++ import { connectToHost }  from '@pollen-robotics/reachy-mini-sdk/host/embed';
++ import { PROTOCOL_VERSION } from '@pollen-robotics/reachy-mini-sdk/host/protocol';
+```
+
+You can drop `@pollen-robotics/reachy-mini-host` from your `package.json`. The host CDN bundles also moved — adjust the jsdelivr URL in your `index.html`:
+
+```diff
+- https://cdn.jsdelivr.net/npm/@pollen-robotics/reachy-mini-host@1/dist/entry/auto.js
++ https://cdn.jsdelivr.net/npm/@pollen-robotics/reachy-mini-sdk@1/host/dist/entry/auto.js
+```
+
+The host bundles now import the SDK directly and assign it on `window.ReachyMini` at load time, so apps no longer need a second `<script type="module">` for the SDK alone.
+
+See the [CHANGELOG](./CHANGELOG.md) for the full release history.
+
 ## License
 
 Apache-2.0 — see [LICENSE](./LICENSE).

package/dist/lib/math.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Math utilities for the ReachyMini SDK.
+ *
+ * These are the canonical conversions between human-readable
+ * roll/pitch/yaw degrees and the wire format the daemon expects
+ * (4×4 rotation matrices, ZYX convention).
+ */
+export declare function degToRad(deg: number): number;
+export declare function radToDeg(rad: number): number;
+/**
+ * Roll/pitch/yaw (degrees) → 4×4 rotation matrix (ZYX convention).
+ * This is the wire format for the robot's `set_target` command.
+ */
+export declare function rpyToMatrix(rollDeg: number, pitchDeg: number, yawDeg: number): number[][];
+/**
+ * Rotation matrix (3×3 or 4×4) → { roll, pitch, yaw } in degrees.
+ */
+export declare function matrixToRpy(m: number[][]): {
+    roll: number;
+    pitch: number;
+    yaw: number;
+};
+//# sourceMappingURL=math.d.ts.map

package/dist/lib/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../lib/math.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACvB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACf,MAAM,EAAE,EAAE,CAWZ;AAED;;GAEG;AACH,wBAAgB,WAAW,CACvB,CAAC,EAAE,MAAM,EAAE,EAAE,GACd;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAM9C"}

package/dist/lib/math.js

@@ -0,0 +1,40 @@
+/**
+ * Math utilities for the ReachyMini SDK.
+ *
+ * These are the canonical conversions between human-readable
+ * roll/pitch/yaw degrees and the wire format the daemon expects
+ * (4×4 rotation matrices, ZYX convention).
+ */
+export function degToRad(deg) {
+    return deg * Math.PI / 180;
+}
+export function radToDeg(rad) {
+    return rad * 180 / Math.PI;
+}
+/**
+ * Roll/pitch/yaw (degrees) → 4×4 rotation matrix (ZYX convention).
+ * This is the wire format for the robot's `set_target` command.
+ */
+export function rpyToMatrix(rollDeg, pitchDeg, yawDeg) {
+    const r = degToRad(rollDeg), p = degToRad(pitchDeg), y = degToRad(yawDeg);
+    const cy = Math.cos(y), sy = Math.sin(y);
+    const cp = Math.cos(p), sp = Math.sin(p);
+    const cr = Math.cos(r), sr = Math.sin(r);
+    return [
+        [cy * cp, cy * sp * sr - sy * cr, cy * sp * cr + sy * sr, 0],
+        [sy * cp, sy * sp * sr + cy * cr, sy * sp * cr - cy * sr, 0],
+        [-sp, cp * sr, cp * cr, 0],
+        [0, 0, 0, 1],
+    ];
+}
+/**
+ * Rotation matrix (3×3 or 4×4) → { roll, pitch, yaw } in degrees.
+ */
+export function matrixToRpy(m) {
+    return {
+        roll: radToDeg(Math.atan2(m[2][1], m[2][2])),
+        pitch: radToDeg(Math.asin(-m[2][0])),
+        yaw: radToDeg(Math.atan2(m[1][0], m[0][0])),
+    };
+}
+//# sourceMappingURL=math.js.map

package/dist/lib/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../lib/math.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAChC,OAAO,GAAG,GAAG,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAChC,OAAO,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACvB,OAAe,EACf,QAAgB,EAChB,MAAc;IAEd,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzC,OAAO;QACH,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC5D,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC5D,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC1B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;KACf,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACvB,CAAa;IAEb,OAAO;QACH,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAE,CAAC,CAAC;QAChD,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAE,CAAC,CAAC;QACtC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAE,CAAC,CAAC;KAClD,CAAC;AACN,CAAC"}

package/dist/lib/reachy-mini.d.ts

@@ -0,0 +1,150 @@
+/**
+ * ReachyMini — Browser SDK for controlling a Reachy Mini robot over WebRTC.
+ * See `../reachy-mini-sdk.ts` for the package's barrel and the README for
+ * a quick-start guide.
+ */
+import type { ApplyAudioConfigOptions, AudioConfigEntry, AutoConnectOptions, AutoConnectResult, MotionAwaitOptions, MoveData, PlayMoveOptions, PlayMoveResult, PlayUploadedAudioOptions, ReachyMiniInstance, ReachyMiniOptions, RobotInfo, RobotState, SubscribeLogsOptions, UploadAudioOptions } from './types.js';
+export declare class ReachyMini extends EventTarget implements ReachyMiniInstance {
+    private readonly _signalingUrl;
+    private readonly _clientId;
+    private readonly _appName;
+    private readonly _videoJitterBufferTargetMs;
+    private _autoStartFromUrl;
+    private _autoStartAttempted;
+    private _state;
+    private _robots;
+    private _robotState;
+    private readonly _preselectedRobotId;
+    private _token;
+    private _username;
+    private _tokenExpires;
+    private _sseAbortController;
+    _pc: RTCPeerConnection | null;
+    private _dc;
+    private _sessionId;
+    private _selectedRobotId;
+    private _pendingRemoteIce;
+    _micStream: MediaStream | null;
+    private _micMuted;
+    private _audioMuted;
+    private _micSupported;
+    private _latencyMonitorId;
+    private _stateRefreshInterval;
+    private _versionResolve;
+    private _hardwareIdResolve;
+    private _volumeResolve;
+    private _micVolumeResolve;
+    private _applyAudioConfigResolve;
+    private _readAudioParameterResolve;
+    private readonly _logSubscribers;
+    private _broadcastWaiters;
+    private _activeMoveUploadId;
+    private _activeAudioUploadId;
+    private _sessionResolve;
+    private _sessionReject;
+    private _iceConnected;
+    private _dcOpen;
+    private readonly _pendingMotionCompletions;
+    private _videoElement;
+    constructor(options?: ReachyMiniOptions);
+    get state(): 'disconnected' | 'connected' | 'streaming';
+    get robots(): RobotInfo[];
+    get robotState(): RobotState;
+    get username(): string | null;
+    get isAuthenticated(): boolean;
+    get micSupported(): boolean;
+    get micMuted(): boolean;
+    get audioMuted(): boolean;
+    get preselectedRobotId(): string | null;
+    get isEmbedded(): boolean;
+    /**
+     * Internal: try to honour the `autoStartFromUrl` constructor
+     * option. Called from the signaling-message handler after every
+     * `robotsChanged` emit, so a robot that comes online after the
+     * SDK is already `connected` still triggers the auto-start.
+     */
+    _maybeAutoStart(): void;
+    authenticate(): Promise<boolean>;
+    login(): Promise<void>;
+    logout(): void;
+    connect(token?: string): Promise<void>;
+    autoConnect(options?: AutoConnectOptions): Promise<AutoConnectResult>;
+    private _fetchOwnedRobots;
+    private _waitForRobotInList;
+    startSession(robotId: string): Promise<void>;
+    private _failSessionRejected;
+    stopSession(): Promise<void>;
+    disconnect(): void;
+    setTarget({ head, antennas, body_yaw }?: {
+        head?: number[];
+        antennas?: number[];
+        body_yaw?: number;
+    }): boolean;
+    gotoTarget({ head, antennas, body_yaw, duration }: {
+        head?: number[];
+        antennas?: number[];
+        body_yaw?: number;
+        duration: number;
+    }): boolean;
+    setHeadRpyDeg(rollDeg: number, pitchDeg: number, yawDeg: number): boolean;
+    setAntennasDeg(rightDeg: number, leftDeg: number): boolean;
+    setBodyYawDeg(yawDeg: number): boolean;
+    playSound(file: string): boolean;
+    setMotorMode(mode: 'enabled' | 'disabled' | 'gravity_compensation'): boolean;
+    setMotorTorque(on: boolean, ids?: string[] | null): boolean;
+    wakeUp({ timeoutMs }?: MotionAwaitOptions): Promise<void>;
+    gotoSleep({ timeoutMs }?: MotionAwaitOptions): Promise<void>;
+    private _sendCommandAwaitCompletion;
+    private _rejectPendingMotionCompletions;
+    isAwake(): boolean;
+    ensureAwake(timeoutMs?: number): Promise<boolean>;
+    getVersion(): Promise<string | null>;
+    getHardwareId(): Promise<string | null>;
+    getVolume(): Promise<number | null>;
+    setVolume(volume: number): Promise<number | null>;
+    getMicrophoneVolume(): Promise<number | null>;
+    setMicrophoneVolume(volume: number): Promise<number | null>;
+    applyAudioConfig(config: AudioConfigEntry[], { verify }?: ApplyAudioConfigOptions): Promise<boolean>;
+    readAudioParameter(name: string): Promise<number[] | null>;
+    /**
+     * Internal: send a command and await the matching daemon response in a
+     * named single-resolver slot. Used by the volume helpers and the
+     * XVF3800 audio-config helpers — every one of them has a strict
+     * request/response shape where a single in-flight call per slot is
+     * sufficient. If a previous request on the same slot is still
+     * pending when a new one comes in, the older promise is resolved to
+     * `null` so its caller doesn't hang forever.
+     *
+     * Slot access is passed in as getter/setter closures rather than a
+     * key into `this`: that keeps the helper fully generic-checked (T is
+     * inferred from the slot's resolver type at each call site) with no
+     * indexed-property casts.
+     */
+    private _slotRoundtrip;
+    sendRaw(data: unknown): boolean;
+    subscribeLogs({ onLine, onError }: SubscribeLogsOptions): () => void;
+    requestState(): boolean;
+    setAudioMuted(muted: boolean): void;
+    setMicMuted(muted: boolean): void;
+    attachVideo(videoElement: HTMLVideoElement): () => void;
+    playMove(motion: MoveData, { audioBlob, audioLeadMs, description, encoding, playFrequency, initialGotoDuration, startTimeoutMs, onProgress, onStarted, }?: PlayMoveOptions): Promise<PlayMoveResult>;
+    cancelMove(uploadId?: string | null): boolean;
+    uploadAudio(audioBlob: Blob, { description, onProgress }?: UploadAudioOptions): Promise<string>;
+    playUploadedAudio(uploadId: string, { timeoutMs }?: PlayUploadedAudioOptions): Promise<{
+        started: true;
+    }>;
+    cancelAudio(uploadId?: string | null): boolean;
+    private _emit;
+    private _waitForBroadcast;
+    private _awaitDataChannelDrain;
+    private _sendToServer;
+    private _sendCommand;
+    private _checkSessionReady;
+    private _handleSignalingMessage;
+    private _handleEndSession;
+    private _handlePeerMessage;
+    private _handleRobotMessage;
+    /** Snap video playback to live edge if buffered lag exceeds 0.5 s. */
+    private _startLatencyMonitor;
+}
+//# sourceMappingURL=reachy-mini.d.ts.map

package/dist/lib/reachy-mini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reachy-mini.d.ts","sourceRoot":"","sources":["../../lib/reachy-mini.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuBH,OAAO,KAAK,EACR,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EAEjB,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,cAAc,EACd,wBAAwB,EAExB,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,UAAU,EAEV,oBAAoB,EACpB,kBAAkB,EACrB,MAAM,YAAY,CAAC;AA0CpB,qBAAa,UAAW,SAAQ,WAAY,YAAW,kBAAkB;IAGrE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAS;IACpD,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,mBAAmB,CAAU;IAGrC,OAAO,CAAC,MAAM,CAA8D;IAC5E,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAgB;IAGpD,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,aAAa,CAA8B;IAGnD,OAAO,CAAC,mBAAmB,CAAgC;IAG3D,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IACrC,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,iBAAiB,CAA8C;IAGvE,UAAU,EAAE,WAAW,GAAG,IAAI,CAAQ;IACtC,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,aAAa,CAAS;IAG9B,OAAO,CAAC,iBAAiB,CAA+C;IACxE,OAAO,CAAC,qBAAqB,CAA+C;IAG5E,OAAO,CAAC,eAAe,CAA6C;IACpE,OAAO,CAAC,kBAAkB,CAA6C;IACvE,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,iBAAiB,CAA6C;IAItE,OAAO,CAAC,wBAAwB,CAA8C;IAC9E,OAAO,CAAC,0BAA0B,CAA+C;IAGjF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiC;IAGjE,OAAO,CAAC,iBAAiB,CAAyB;IAGlD,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,oBAAoB,CAAuB;IAGnD,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,cAAc,CAAuC;IAC7D,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAS;IAGxB,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAGxC;IAGF,OAAO,CAAC,aAAa,CAAiC;gBAE1C,OAAO,GAAE,iBAAsB;IAiB3C,IAAI,KAAK,IAAI,cAAc,GAAG,WAAW,GAAG,WAAW,CAAwB;IAC/E,IAAI,MAAM,IAAI,SAAS,EAAE,CAAyB;IAClD,IAAI,UAAU,IAAI,UAAU,CAA6B;IACzD,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAA2B;IACxD,IAAI,eAAe,IAAI,OAAO,CAA0B;IACxD,IAAI,YAAY,IAAI,OAAO,CAA+B;IAC1D,IAAI,QAAQ,IAAI,OAAO,CAA2B;IAClD,IAAI,UAAU,IAAI,OAAO,CAA6B;IACtD,IAAI,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAAqC;IAC5E,IAAI,UAAU,IAAI,OAAO,CAA8C;IAEvE;;;;;OAKG;IACH,eAAe,IAAI,IAAI;IAmBjB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAoChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,MAAM,IAAI,IAAI;IAWR,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0EtC,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YA8EjE,iBAAiB;IA+C/B,OAAO,CAAC,mBAAmB;IAkBrB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuHlD,OAAO,CAAC,oBAAoB;IA0BtB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAwClC,UAAU,IAAI,IAAI;IAwClB,SAAS,CACL,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/F,OAAO;IAiCV,UAAU,CACN,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAClC;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAClF,OAAO;IAuCV,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAIzE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAI1D,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAItC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,sBAAsB,GAAG,OAAO;IAI5E,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,GAAE,MAAM,EAAE,GAAG,IAAW,GAAG,OAAO;IAIjE,MAAM,CAAC,EAAE,SAAgB,EAAE,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpE,SAAS,CAAC,EAAE,SAAgB,EAAE,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE,OAAO,CAAC,2BAA2B;IAsBnC,OAAO,CAAC,+BAA+B;IAWvC,OAAO,IAAI,OAAO;IAKZ,WAAW,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBrD,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAcpC,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAcvC,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQnC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQjD,mBAAmB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQ7C,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQ3D,gBAAgB,CACZ,MAAM,EAAE,gBAAgB,EAAE,EAC1B,EAAE,MAAa,EAAE,GAAE,uBAA4B,GAChD,OAAO,CAAC,OAAO,CAAC;IAQnB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IAQ1D;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAI/B,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAoBpE,YAAY,IAAI,OAAO;IAMvB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAKnC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IASjC,WAAW,CAAC,YAAY,EAAE,gBAAgB,GAAG,MAAM,IAAI;IA6BjD,QAAQ,CACV,MAAM,EAAE,QAAQ,EAChB,EACI,SAAgB,EAChB,WAAkB,EAClB,WAAoB,EACpB,QAAwB,EACxB,aAAmB,EACnB,mBAAuB,EACvB,cAAqB,EACrB,UAAkC,EAClC,SAAiC,GACpC,GAAE,eAAoB,GACxB,OAAO,CAAC,cAAc,CAAC;IAkJ1B,UAAU,CAAC,QAAQ,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO;IAM7C,WAAW,CACb,SAAS,EAAE,IAAI,EACf,EAAE,WAAqB,EAAE,UAAkC,EAAE,GAAE,kBAAuB,GACvF,OAAO,CAAC,MAAM,CAAC;IAqCZ,iBAAiB,CACnB,QAAQ,EAAE,MAAM,EAChB,EAAE,SAAgB,EAAE,GAAE,wBAA6B,GACpD,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,CAAA;KAAE,CAAC;IAkB7B,WAAW,CAAC,QAAQ,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO;IAWpD,OAAO,CAAC,KAAK;IAOb,OAAO,CAAC,iBAAiB;YAkBX,sBAAsB;YAStB,aAAa;IA4B3B,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,kBAAkB;YAYZ,uBAAuB;IAiCrC,OAAO,CAAC,iBAAiB;YAsCX,kBAAkB;IA2DhC,OAAO,CAAC,mBAAmB;IA8G3B,sEAAsE;IACtE,OAAO,CAAC,oBAAoB;CAe/B"}