@rydr/game-sdk 2.1.1 → 3.0.0

package/dist/protocol/buttons.d.ts

@@ -1,23 +1,22 @@
 /**
  * Canonical, source-agnostic controller vocabulary.
  *
- * Every physical controller (phone, keyboard, Zwift Play) is normalised to
- * these names by the platform before it reaches a game. The game never learns
- * which device produced a press — only the canonical name and edge. This keeps
- * games decoupled from hardware specifics and is the same vocabulary the
- * platform's input layer already uses.
+ * Every physical controller (Zwift Play, keyboard, phone) is normalised to these names by the
+ * platform before it reaches a game. The game never learns which device produced a press — only
+ * the canonical name and edge — which keeps games decoupled from hardware specifics.
  *
- * The action buttons are intentionally neutral: `PRIMARY`/`SECONDARY` carry no
- * built-in meaning (confirm, back, reload, hide, …) — each game assigns its own.
+ * - **Directions** — `UP`/`DOWN`/`LEFT`/`RIGHT` (the D-pad / arrow keys).
+ * - **Face buttons** — `A`/`B`/`Y`/`Z`, the four buttons on the controller (Zwift Play layout:
+ *   A right, B bottom, Y top, Z left). They carry no built-in meaning — each game assigns its
+ *   own — but the platform **house convention** is `A` = **confirm / primary action** and `Z` =
+ *   **back / cancel**, with `B`/`Y` as contextual extras. Follow it so confirm/back stay
+ *   consistent across the library, and show the actual button glyph (A/B/Y/Z, by colour) in
+ *   on-screen prompts rather than a generic label.
  *
- * The four Zwift face buttons are streamed ADDITIVELY: each press emits BOTH its
- * raw hardware label (`A`/`B`/`Y`/`Z`, arranged right/bottom/top/left on the
- * controller — for games that want all four distinctly) AND the neutral collapse
- * (`A`/`B` → `PRIMARY`, `Y`/`Z` → `SECONDARY` — what most games listen for). A
- * game subscribes to whichever vocabulary it wants. Phone / keyboard emit
- * `PRIMARY`/`SECONDARY` for their two neutral action buttons.
+ * Devices with fewer than four face buttons (e.g. a phone) expose at least the `A`/`Z`
+ * confirm/back pair — don't require `B`/`Y` for a flow that must work on every input.
  */
-export type ButtonName = "PRIMARY" | "SECONDARY" | "UP" | "DOWN" | "LEFT" | "RIGHT" | "A" | "B" | "Y" | "Z";
+export type ButtonName = "UP" | "DOWN" | "LEFT" | "RIGHT" | "A" | "B" | "Y" | "Z";
 /** Press = "down", release = "up". A held button emits one of each. */
 export type ButtonEdge = "down" | "up";
 //# sourceMappingURL=buttons.d.ts.map

package/dist/protocol/buttons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buttons.d.ts","sourceRoot":"","sources":["../../src/protocol/buttons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,WAAW,GACX,IAAI,GACJ,MAAM,GACN,MAAM,GACN,OAAO,GAEP,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,CAAC;AAER,uEAAuE;AACvE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC"}
+{"version":3,"file":"buttons.d.ts","sourceRoot":"","sources":["../../src/protocol/buttons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,UAAU,GAClB,IAAI,GACJ,MAAM,GACN,MAAM,GACN,OAAO,GAGP,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,CAAC;AAER,uEAAuE;AACvE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC"}

package/dist/protocol/version.d.ts

@@ -6,8 +6,8 @@
  * built against an older protocol keeps working. Evolve the protocol
  * ADDITIVELY — never change or remove an existing message shape.
  */
-export declare const RYDR_PROTOCOL_VERSION: 10;
+export declare const RYDR_PROTOCOL_VERSION: 11;
 /** Semver of this SDK build. Sent in the handshake for telemetry/debugging.
  *  (Bumped to 2.0.0 by `npm version major` on release — see CHANGELOG [Unreleased].) */
-export declare const RYDR_SDK_VERSION = "2.1.1";
+export declare const RYDR_SDK_VERSION = "3.0.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/protocol/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/protocol/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH,eAAO,MAAM,qBAAqB,EAAG,EAAW,CAAC;AAEjD;wFACwF;AACxF,eAAO,MAAM,gBAAgB,UAAU,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/protocol/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqBH,eAAO,MAAM,qBAAqB,EAAG,EAAW,CAAC;AAEjD;wFACwF;AACxF,eAAO,MAAM,gBAAgB,UAAU,CAAC"}

package/dist/protocol/version.js

@@ -22,8 +22,12 @@
 // Bumped 9 → 10: adds `rydr/leaderboard.rankQuery` so a game can ask where an arbitrary value would
 // rank WITHOUT submitting it — a read-only standing for an in-progress score (`getRank`). Additive —
 // older shells never reply, so the call rejects (timeout) and callers treat the rank as optional.
-export const RYDR_PROTOCOL_VERSION = 10;
+// Bumped 10 → 11: button vocabulary dropped the neutral `PRIMARY`/`SECONDARY` pair (BREAKING — the
+// `input.button` `name` values no longer include them). Every controller now normalises to the four
+// raw face buttons `A`/`B`/`Y`/`Z` (+ `UP`/`DOWN`/`LEFT`/`RIGHT`), with the house convention
+// A = confirm, Z = back. Migrate: `name === "PRIMARY"` → `"A"`, `name === "SECONDARY"` → `"Z"`.
+export const RYDR_PROTOCOL_VERSION = 11;
 /** Semver of this SDK build. Sent in the handshake for telemetry/debugging.
  *  (Bumped to 2.0.0 by `npm version major` on release — see CHANGELOG [Unreleased].) */
-export const RYDR_SDK_VERSION = "2.1.1";
+export const RYDR_SDK_VERSION = "3.0.0";
 //# sourceMappingURL=version.js.map

package/dist/protocol/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/protocol/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,8FAA8F;AAC9F,yDAAyD;AACzD,4FAA4F;AAC5F,oGAAoG;AACpG,kGAAkG;AAClG,6EAA6E;AAC7E,kGAAkG;AAClG,uGAAuG;AACvG,wFAAwF;AACxF,oGAAoG;AACpG,gGAAgG;AAChG,yFAAyF;AACzF,kHAAkH;AAClH,oGAAoG;AACpG,qGAAqG;AACrG,kGAAkG;AAClG,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAW,CAAC;AAEjD;wFACwF;AACxF,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/protocol/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,8FAA8F;AAC9F,yDAAyD;AACzD,4FAA4F;AAC5F,oGAAoG;AACpG,kGAAkG;AAClG,6EAA6E;AAC7E,kGAAkG;AAClG,uGAAuG;AACvG,wFAAwF;AACxF,oGAAoG;AACpG,gGAAgG;AAChG,yFAAyF;AACzF,kHAAkH;AAClH,oGAAoG;AACpG,qGAAqG;AACrG,kGAAkG;AAClG,mGAAmG;AACnG,oGAAoG;AACpG,6FAA6F;AAC7F,gGAAgG;AAChG,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAW,CAAC;AAEjD;wFACwF;AACxF,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rydr/game-sdk",
-  "version": "2.1.1",
+  "version": "3.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/bdefrenne/rydr-game-sdk.git"