@faiber/faiber-state-sdk 0.24.1 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,62 +2,62 @@ import { ServiceApi, urlEncoded } from "@faiber/sdk-core";
2
2
  import { openMatchRealtime, openRoomRealtime } from "./match-realtime.js";
3
3
  export class StateOperations extends ServiceApi {
4
4
  /**
5
- * Performs the game operation sessions operation for the routes capability.
5
+ * Page configured game-tenant sessions newest first; defaults page=1/page_size=25, page >=1 and size clamped 10..100. Snake_case filters combine with AND; user_id means membership.
6
6
  * Calls `GET /api/v1/game-operations/sessions` through the shared IDP-aware Faiber client.
7
7
  * @param params Typed query parameters; omitted members retain backend defaults.
8
8
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
9
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
10
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:read.
9
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
10
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:read (state management/wildcard/admin aliases accepted).
11
11
  */
12
12
  routesGameOperationSessionsGet(params, options) {
13
13
  return this.client.request({ ...options, method: "GET", url: `/api/v1/game-operations/sessions`, params });
14
14
  }
15
15
  /**
16
- * Performs the game operation events operation for the routes capability.
16
+ * Page configured game-tenant events by descending sequence; defaults page=1/page_size=50, size clamped 10..100. Optional kind and user_id combine; absent session returns404.
17
17
  * Calls `GET /api/v1/game-operations/sessions/{session_id}/events` through the shared IDP-aware Faiber client.
18
18
  * @param sessionId Backend path identifier `session_id`.
19
19
  * @param params Typed query parameters; omitted members retain backend defaults.
20
20
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
21
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
22
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:read.
21
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
22
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:read (state management/wildcard/admin aliases accepted).
23
23
  */
24
24
  routesGameOperationEventsGet(sessionId, params, options) {
25
25
  return this.client.request({ ...options, method: "GET", url: `/api/v1/game-operations/sessions/${encodeURIComponent(sessionId)}/events`, params });
26
26
  }
27
27
  /**
28
- * Performs the game operations summary operation for the routes capability.
28
+ * Read configured game-tenant counts grouped by game, status, payment and settlement status. Runtime tenant comes from service configuration, not x-organization-id.
29
29
  * Calls `GET /api/v1/game-operations/summary` through the shared IDP-aware Faiber client.
30
30
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
31
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
32
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:read.
31
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
32
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:read (state management/wildcard/admin aliases accepted).
33
33
  */
34
34
  routesGameOperationsSummaryGet(options) {
35
35
  return this.client.request({ ...options, method: "GET", url: `/api/v1/game-operations/summary` });
36
36
  }
37
37
  /**
38
- * Performs the game operation worlds operation for the routes capability.
38
+ * Read configured game-tenant economy entries, including disabled worlds, ordered by slug.
39
39
  * Calls `GET /api/v1/game-operations/worlds` through the shared IDP-aware Faiber client.
40
40
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
41
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
42
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:read.
41
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
42
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:read (state management/wildcard/admin aliases accepted).
43
43
  */
44
44
  routesGameOperationWorldsGet(options) {
45
45
  return this.client.request({ ...options, method: "GET", url: `/api/v1/game-operations/worlds` });
46
46
  }
47
47
  /**
48
- * Performs the update game operation economy operation for the routes capability.
48
+ * Replace economy settings: entryCoins 0..1000000 (solo games must remain free), burnPercent 0..100 rounded to basis points; errors422.
49
49
  * Calls `PATCH /api/v1/game-operations/worlds/{game_id}/economy` through the shared IDP-aware Faiber client.
50
50
  * @param gameId Backend path identifier `game_id`.
51
51
  * @param data Typed JSON request body.
52
52
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
53
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
54
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:write.
53
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
54
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:write (state management/wildcard/admin aliases accepted).
55
55
  */
56
56
  routesUpdateGameOperationEconomyPatch(gameId, data, options) {
57
57
  return this.client.request({ ...options, method: "PATCH", url: `/api/v1/game-operations/worlds/${encodeURIComponent(gameId)}/economy`, data: data });
58
58
  }
59
59
  /**
60
- * Open room replication with the ticket returned by join. This operation uses a WebSocket upgrade, not an Axios HTTP request.
60
+ * Open room replication with room_id/player_id/ticket query parameters. Five-minute ticket is validated at upgrade; wrong/expired ticket401. Input identity is bound to the upgrade. Receives snapshot/patch/player/ack/pong/error frames.
61
61
  * Calls `GET /api/v1/realtime` as a WebSocket upgrade.
62
62
  * @param ticket Scoped ticket from the authenticated room join endpoint.
63
63
  * @param options Injectable WebSocket constructor and AbortSignal; cancellation closes the socket.
@@ -68,426 +68,426 @@ export class StateOperations extends ServiceApi {
68
68
  return openRoomRealtime(this.client, ticket, options);
69
69
  }
70
70
  /**
71
- * Performs the delete room operation for the routes capability.
71
+ * Delete an organization room; missing/foreign room404; success data:true.
72
72
  * Calls `DELETE /api/v1/rooms/{room_id}` through the shared IDP-aware Faiber client.
73
73
  * @param roomId Backend path identifier `room_id`.
74
74
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
75
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
76
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:write.
75
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
76
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:write (state management/wildcard/admin aliases accepted).
77
77
  */
78
78
  routesDeleteRoomDelete(roomId, options) {
79
79
  return this.client.request({ ...options, method: "DELETE", url: `/api/v1/rooms/${encodeURIComponent(roomId)}` });
80
80
  }
81
81
  /**
82
- * Performs the get room operation for the routes capability.
82
+ * Read a complete organization room snapshot including players and entities; missing/foreign room404.
83
83
  * Calls `GET /api/v1/rooms/{room_id}` through the shared IDP-aware Faiber client.
84
84
  * @param roomId Backend path identifier `room_id`.
85
85
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
86
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
87
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:read.
86
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
87
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:read (state management/wildcard/admin aliases accepted).
88
88
  */
89
89
  routesGetRoomGet(roomId, options) {
90
90
  return this.client.request({ ...options, method: "GET", url: `/api/v1/rooms/${encodeURIComponent(roomId)}` });
91
91
  }
92
92
  /**
93
- * Performs the update room operation for the routes capability.
93
+ * Update room name, capacity or status; null fields preserve. Capacity clamps1..4096 and cannot shrink below current players (409); blank name400.
94
94
  * Calls `PUT /api/v1/rooms/{room_id}` through the shared IDP-aware Faiber client.
95
95
  * @param roomId Backend path identifier `room_id`.
96
96
  * @param data Typed JSON request body.
97
97
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
98
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
99
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:write.
98
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
99
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:write (state management/wildcard/admin aliases accepted).
100
100
  */
101
101
  routesUpdateRoomPut(roomId, data, options) {
102
102
  return this.client.request({ ...options, method: "PUT", url: `/api/v1/rooms/${encodeURIComponent(roomId)}`, data: data });
103
103
  }
104
104
  /**
105
- * Performs the invoke endpoint operation for the routes capability.
105
+ * Invoke WASM for a caller-owned player (management grants can act for others). Guest must export ()->i32 returning0; numeric writes and fuel limits apply. Returns authoritative patch; execution errors400.
106
106
  * Calls `POST /api/v1/rooms/{room_id}/endpoints/{slug}` through the shared IDP-aware Faiber client.
107
107
  * @param roomId Backend path identifier `room_id`.
108
108
  * @param slug Backend path identifier `slug`.
109
109
  * @param data Typed JSON request body.
110
110
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
111
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
112
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute.
111
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
112
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:execute (state management/wildcard/admin aliases accepted).
113
113
  */
114
114
  routesInvokeEndpointPost(roomId, slug, data, options) {
115
115
  return this.client.request({ ...options, method: "POST", url: `/api/v1/rooms/${encodeURIComponent(roomId)}/endpoints/${encodeURIComponent(slug)}`, data: data });
116
116
  }
117
117
  /**
118
- * Performs the join room operation for the routes capability.
118
+ * Create a player/entity and five-minute scoped room ticket. user_id must match caller unless state management grant; full/foreign/missing room400.
119
119
  * Calls `POST /api/v1/rooms/{room_id}/join` through the shared IDP-aware Faiber client.
120
120
  * @param roomId Backend path identifier `room_id`.
121
121
  * @param data Typed JSON request body.
122
122
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
123
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
124
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute.
123
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
124
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:execute (state management/wildcard/admin aliases accepted).
125
125
  */
126
126
  routesJoinRoomPost(roomId, data, options) {
127
127
  return this.client.request({ ...options, method: "POST", url: `/api/v1/rooms/${encodeURIComponent(roomId)}/join`, data: data });
128
128
  }
129
129
  /**
130
- * Performs the list worlds operation for the routes capability.
130
+ * List organization worlds with managed game worlds, sorted by name. managed worlds cannot be updated/deleted.
131
131
  * Calls `GET /api/v1/worlds` through the shared IDP-aware Faiber client.
132
132
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
133
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
134
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:read.
133
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
134
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:read (state management/wildcard/admin aliases accepted).
135
135
  */
136
136
  routesListWorldsGet(options) {
137
137
  return this.client.request({ ...options, method: "GET", url: `/api/v1/worlds` });
138
138
  }
139
139
  /**
140
- * Performs the create world operation for the routes capability.
140
+ * Create an in-memory world; nonempty name and slug required. Missing replication uses60/20/128/120; physics defaults disabled.
141
141
  * Calls `POST /api/v1/worlds` through the shared IDP-aware Faiber client.
142
142
  * @param data Typed JSON request body.
143
143
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
144
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
145
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:write.
144
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
145
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:write (state management/wildcard/admin aliases accepted).
146
146
  */
147
147
  routesCreateWorldPost(data, options) {
148
148
  return this.client.request({ ...options, method: "POST", url: `/api/v1/worlds`, data: data });
149
149
  }
150
150
  /**
151
- * Performs the delete world operation for the routes capability.
151
+ * Delete an organization world and its rooms, endpoints and WASM modules; managed world409; missing404; success data:true.
152
152
  * Calls `DELETE /api/v1/worlds/{world_id}` through the shared IDP-aware Faiber client.
153
153
  * @param worldId Backend path identifier `world_id`.
154
154
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
155
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
156
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:write.
155
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
156
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:write (state management/wildcard/admin aliases accepted).
157
157
  */
158
158
  routesDeleteWorldDelete(worldId, options) {
159
159
  return this.client.request({ ...options, method: "DELETE", url: `/api/v1/worlds/${encodeURIComponent(worldId)}` });
160
160
  }
161
161
  /**
162
- * Performs the get world operation for the routes capability.
162
+ * Read an organization world or configured managed game projection; absent world404.
163
163
  * Calls `GET /api/v1/worlds/{world_id}` through the shared IDP-aware Faiber client.
164
164
  * @param worldId Backend path identifier `world_id`.
165
165
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
166
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
167
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:read.
166
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
167
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:read (state management/wildcard/admin aliases accepted).
168
168
  */
169
169
  routesGetWorldGet(worldId, options) {
170
170
  return this.client.request({ ...options, method: "GET", url: `/api/v1/worlds/${encodeURIComponent(worldId)}` });
171
171
  }
172
172
  /**
173
- * Performs the update world operation for the routes capability.
173
+ * Update an organization world; null/missing fields preserve values. Supplied nested configs replace existing configs with serde defaults. Managed game worlds409; blank name400.
174
174
  * Calls `PUT /api/v1/worlds/{world_id}` through the shared IDP-aware Faiber client.
175
175
  * @param worldId Backend path identifier `world_id`.
176
176
  * @param data Typed JSON request body.
177
177
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
178
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
179
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:write.
178
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
179
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:write (state management/wildcard/admin aliases accepted).
180
180
  */
181
181
  routesUpdateWorldPut(worldId, data, options) {
182
182
  return this.client.request({ ...options, method: "PUT", url: `/api/v1/worlds/${encodeURIComponent(worldId)}`, data: data });
183
183
  }
184
184
  /**
185
- * Performs the list endpoints operation for the routes capability.
185
+ * List world export bindings; missing/foreign world404.
186
186
  * Calls `GET /api/v1/worlds/{world_id}/endpoints` through the shared IDP-aware Faiber client.
187
187
  * @param worldId Backend path identifier `world_id`.
188
188
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
189
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
190
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:read.
189
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
190
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:read (state management/wildcard/admin aliases accepted).
191
191
  */
192
192
  routesListEndpointsGet(worldId, options) {
193
193
  return this.client.request({ ...options, method: "GET", url: `/api/v1/worlds/${encodeURIComponent(worldId)}/endpoints` });
194
194
  }
195
195
  /**
196
- * Performs the create endpoint operation for the routes capability.
196
+ * Bind a world WASM module export to a component and slug. Foreign module400; module export signature checked on invocation.
197
197
  * Calls `POST /api/v1/worlds/{world_id}/endpoints` through the shared IDP-aware Faiber client.
198
198
  * @param worldId Backend path identifier `world_id`.
199
199
  * @param data Typed JSON request body.
200
200
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
201
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
202
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:write.
201
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
202
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:write (state management/wildcard/admin aliases accepted).
203
203
  */
204
204
  routesCreateEndpointPost(worldId, data, options) {
205
205
  return this.client.request({ ...options, method: "POST", url: `/api/v1/worlds/${encodeURIComponent(worldId)}/endpoints`, data: data });
206
206
  }
207
207
  /**
208
- * Performs the delete endpoint operation for the routes capability.
208
+ * Delete an organization world export binding; missing world/binding404; success data:true.
209
209
  * Calls `DELETE /api/v1/worlds/{world_id}/endpoints/{endpoint_id}` through the shared IDP-aware Faiber client.
210
210
  * @param worldId Backend path identifier `world_id`.
211
211
  * @param endpointId Backend path identifier `endpoint_id`.
212
212
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
213
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
214
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:write.
213
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
214
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:write (state management/wildcard/admin aliases accepted).
215
215
  */
216
216
  routesDeleteEndpointDelete(worldId, endpointId, options) {
217
217
  return this.client.request({ ...options, method: "DELETE", url: `/api/v1/worlds/${encodeURIComponent(worldId)}/endpoints/${encodeURIComponent(endpointId)}` });
218
218
  }
219
219
  /**
220
- * Performs the list rooms operation for the routes capability.
220
+ * List organization rooms for a world. Unknown/foreign world returns an empty list.
221
221
  * Calls `GET /api/v1/worlds/{world_id}/rooms` through the shared IDP-aware Faiber client.
222
222
  * @param worldId Backend path identifier `world_id`.
223
223
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
224
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
225
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:read.
224
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
225
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:read (state management/wildcard/admin aliases accepted).
226
226
  */
227
227
  routesListRoomsGet(worldId, options) {
228
228
  return this.client.request({ ...options, method: "GET", url: `/api/v1/worlds/${encodeURIComponent(worldId)}/rooms` });
229
229
  }
230
230
  /**
231
- * Performs the create room operation for the routes capability.
231
+ * Create a room in an in-memory organization world. capacity defaults32 and clamps1..4096; absent/foreign world400.
232
232
  * Calls `POST /api/v1/worlds/{world_id}/rooms` through the shared IDP-aware Faiber client.
233
233
  * @param worldId Backend path identifier `world_id`.
234
234
  * @param data Typed JSON request body.
235
235
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
236
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
237
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:write.
236
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
237
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:write (state management/wildcard/admin aliases accepted).
238
238
  */
239
239
  routesCreateRoomPost(worldId, data, options) {
240
240
  return this.client.request({ ...options, method: "POST", url: `/api/v1/worlds/${encodeURIComponent(worldId)}/rooms`, data: data });
241
241
  }
242
242
  /**
243
- * Performs the list wasm operation for the routes capability.
243
+ * List organization world WASM metadata; missing/foreign world404.
244
244
  * Calls `GET /api/v1/worlds/{world_id}/wasm` through the shared IDP-aware Faiber client.
245
245
  * @param worldId Backend path identifier `world_id`.
246
246
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
247
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
248
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:read.
247
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
248
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:read (state management/wildcard/admin aliases accepted).
249
249
  */
250
250
  routesListWasmGet(worldId, options) {
251
251
  return this.client.request({ ...options, method: "GET", url: `/api/v1/worlds/${encodeURIComponent(worldId)}/wasm` });
252
252
  }
253
253
  /**
254
- * Performs the upload wasm operation for the routes capability.
254
+ * Upload JSON base64 WASM, validate bytes and return SHA256 metadata. Invalid base64/WASM400, missing/foreign world404.
255
255
  * Calls `POST /api/v1/worlds/{world_id}/wasm` through the shared IDP-aware Faiber client.
256
256
  * @param worldId Backend path identifier `world_id`.
257
257
  * @param data Typed JSON request body.
258
258
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
259
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
260
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:write.
259
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
260
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:write (state management/wildcard/admin aliases accepted).
261
261
  */
262
262
  routesUploadWasmPost(worldId, data, options) {
263
263
  return this.client.request({ ...options, method: "POST", url: `/api/v1/worlds/${encodeURIComponent(worldId)}/wasm`, data: data });
264
264
  }
265
265
  /**
266
- * Performs the delete wasm operation for the routes capability.
266
+ * Delete a world module; attached endpoints must be deleted first(409). Missing world/module404; success data:true.
267
267
  * Calls `DELETE /api/v1/worlds/{world_id}/wasm/{module_id}` through the shared IDP-aware Faiber client.
268
268
  * @param worldId Backend path identifier `world_id`.
269
269
  * @param moduleId Backend path identifier `module_id`.
270
270
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
271
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
272
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:write.
271
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
272
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user, non-nil x-organization-id UUID and state:write (state management/wildcard/admin aliases accepted).
273
273
  */
274
274
  routesDeleteWasmDelete(worldId, moduleId, options) {
275
275
  return this.client.request({ ...options, method: "DELETE", url: `/api/v1/worlds/${encodeURIComponent(worldId)}/wasm/${encodeURIComponent(moduleId)}` });
276
276
  }
277
277
  /**
278
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
278
+ * List the caller latest50 member session projections ordered newest first.
279
279
  * Calls `GET /api/v2/game-history` through the shared IDP-aware Faiber client.
280
280
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
281
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
282
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute and authenticated game membership.
281
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
282
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user with state:execute (management/admin/wildcard aliases accepted); owner/member checks apply where relevant.
283
283
  */
284
284
  gamesRoutesHistoryGet(options) {
285
285
  return this.client.request({ ...options, method: "GET", url: `/api/v2/game-history` });
286
286
  }
287
287
  /**
288
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
288
+ * Read an invite lobby visible to creator or session member; absent/inaccessible lobby422.
289
289
  * Calls `GET /api/v2/game-lobbies/{code}` through the shared IDP-aware Faiber client.
290
290
  * @param code Backend path identifier `code`.
291
291
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
292
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
293
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute and authenticated game membership.
292
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
293
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user with state:execute (management/admin/wildcard aliases accepted); owner/member checks apply where relevant.
294
294
  */
295
295
  gamesRoutesLobbyGet(code, options) {
296
296
  return this.client.request({ ...options, method: "GET", url: `/api/v2/game-lobbies/${encodeURIComponent(code)}` });
297
297
  }
298
298
  /**
299
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
299
+ * Join waiting unexpired invite lobby; code is trimmed and uppercased; invalid/full/expired lobby422.
300
300
  * Calls `POST /api/v2/game-lobbies/{code}/join` through the shared IDP-aware Faiber client.
301
301
  * @param code Backend path identifier `code`.
302
302
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
303
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
304
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute and authenticated game membership.
303
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
304
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user with state:execute (management/admin/wildcard aliases accepted); owner/member checks apply where relevant.
305
305
  */
306
306
  gamesRoutesJoinLobbyPost(code, options) {
307
307
  return this.client.request({ ...options, method: "POST", url: `/api/v2/game-lobbies/${encodeURIComponent(code)}/join` });
308
308
  }
309
309
  /**
310
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
310
+ * Read caller-owned queue ticket; absent/foreign ticket404. sessionId remains null while queued.
311
311
  * Calls `GET /api/v2/game-matchmaking/{ticket_id}` through the shared IDP-aware Faiber client.
312
312
  * @param ticketId Backend path identifier `ticket_id`.
313
313
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
314
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
315
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute and authenticated game membership.
314
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
315
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user with state:execute (management/admin/wildcard aliases accepted); owner/member checks apply where relevant.
316
316
  */
317
317
  gamesRoutesTicketGet(ticketId, options) {
318
318
  return this.client.request({ ...options, method: "GET", url: `/api/v2/game-matchmaking/${encodeURIComponent(ticketId)}` });
319
319
  }
320
320
  /**
321
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
321
+ * Read caller finished-session aggregates by game/difficulty; sufficientData requires at least3 samples.
322
322
  * Calls `GET /api/v2/game-progress` through the shared IDP-aware Faiber client.
323
323
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
324
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
325
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute and authenticated game membership.
324
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
325
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user with state:execute (management/admin/wildcard aliases accepted); owner/member checks apply where relevant.
326
326
  */
327
327
  gamesRoutesProgressGet(options) {
328
328
  return this.client.request({ ...options, method: "GET", url: `/api/v2/game-progress` });
329
329
  }
330
330
  /**
331
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
331
+ * Read caller-member session projection; absent/foreign404. Board/challenge/lastEvent JSON depends on registered game and ruleset.
332
332
  * Calls `GET /api/v2/game-sessions/{session_id}` through the shared IDP-aware Faiber client.
333
333
  * @param sessionId Backend path identifier `session_id`.
334
334
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
335
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
336
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute and authenticated game membership.
335
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
336
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user with state:execute (management/admin/wildcard aliases accepted); owner/member checks apply where relevant.
337
337
  */
338
338
  gamesRoutesViewGet(sessionId, options) {
339
339
  return this.client.request({ ...options, method: "GET", url: `/api/v2/game-sessions/${encodeURIComponent(sessionId)}` });
340
340
  }
341
341
  /**
342
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
342
+ * Apply stable commandId with expectedVersion; duplicate IDs return current projection, stale versions409. Game/ruleset determines answer/action JSON. Never automatically rebase conflicts.
343
343
  * Calls `POST /api/v2/game-sessions/{session_id}/commands` through the shared IDP-aware Faiber client.
344
344
  * @param sessionId Backend path identifier `session_id`.
345
345
  * @param data Typed JSON request body.
346
346
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
347
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
348
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute and authenticated game membership.
347
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
348
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user with state:execute (management/admin/wildcard aliases accepted); owner/member checks apply where relevant.
349
349
  */
350
350
  gamesRoutesCommandPost(sessionId, data, options) {
351
351
  return this.client.request({ ...options, method: "POST", url: `/api/v2/game-sessions/${encodeURIComponent(sessionId)}/commands`, data: data });
352
352
  }
353
353
  /**
354
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
354
+ * Mark member ready; paid sessions enforce readiness timeout and upstream escrow funding. Returns current caller projection; domain errors422.
355
355
  * Calls `POST /api/v2/game-sessions/{session_id}/ready` through the shared IDP-aware Faiber client.
356
356
  * @param sessionId Backend path identifier `session_id`.
357
357
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
358
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
359
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute and authenticated game membership.
358
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
359
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user with state:execute (management/admin/wildcard aliases accepted); owner/member checks apply where relevant.
360
360
  */
361
361
  gamesRoutesReadyPost(sessionId, options) {
362
362
  return this.client.request({ ...options, method: "POST", url: `/api/v2/game-sessions/${encodeURIComponent(sessionId)}/ready` });
363
363
  }
364
364
  /**
365
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
365
+ * Read configured-tenant caller world progression ordered by game.
366
366
  * Calls `GET /api/v2/game-world-progress` through the shared IDP-aware Faiber client.
367
367
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
368
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
369
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute and authenticated game membership.
368
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
369
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user with state:execute (management/admin/wildcard aliases accepted); owner/member checks apply where relevant.
370
370
  */
371
371
  gamesRoutesWorldProgressGet(options) {
372
372
  return this.client.request({ ...options, method: "GET", url: `/api/v2/game-world-progress` });
373
373
  }
374
374
  /**
375
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
375
+ * Read enabled configured-tenant game catalog with current entryCoins and burnPercent. No authentication permission required.
376
376
  * Calls `GET /api/v2/games` through the shared IDP-aware Faiber client.
377
377
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
378
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
378
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
379
379
  * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: public catalog.
380
380
  */
381
381
  gamesRoutesCatalogGet(options) {
382
382
  return this.client.request({ ...options, method: "GET", url: `/api/v2/games` });
383
383
  }
384
384
  /**
385
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
385
+ * Read enabled configured-tenant game definition and economy; unknown/disabled game404.
386
386
  * Calls `GET /api/v2/games/{game_id}` through the shared IDP-aware Faiber client.
387
387
  * @param gameId Backend path identifier `game_id`.
388
388
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
389
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
389
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
390
390
  * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: public catalog.
391
391
  */
392
392
  gamesRoutesGameGet(gameId, options) {
393
393
  return this.client.request({ ...options, method: "GET", url: `/api/v2/games/${encodeURIComponent(gameId)}` });
394
394
  }
395
395
  /**
396
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
396
+ * Create invite lobby for authenticated caller; defaults difficulty11-14/paidfalse, expiry600seconds.
397
397
  * Calls `POST /api/v2/games/{game_id}/lobbies` through the shared IDP-aware Faiber client.
398
398
  * @param gameId Backend path identifier `game_id`.
399
399
  * @param data Typed JSON request body.
400
400
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
401
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
402
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute and authenticated game membership.
401
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
402
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user with state:execute (management/admin/wildcard aliases accepted); owner/member checks apply where relevant.
403
403
  */
404
404
  gamesRoutesCreateLobbyPost(gameId, data, options) {
405
405
  return this.client.request({ ...options, method: "POST", url: `/api/v2/games/${encodeURIComponent(gameId)}/lobbies`, data: data });
406
406
  }
407
407
  /**
408
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
408
+ * Queue authenticated caller by game/difficulty/paid; default difficulty11-14, paidfalse; returns queued/matched receipt with90-second expiry.
409
409
  * Calls `POST /api/v2/games/{game_id}/matchmaking` through the shared IDP-aware Faiber client.
410
410
  * @param gameId Backend path identifier `game_id`.
411
411
  * @param data Typed JSON request body.
412
412
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
413
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
414
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute and authenticated game membership.
413
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
414
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user with state:execute (management/admin/wildcard aliases accepted); owner/member checks apply where relevant.
415
415
  */
416
416
  gamesRoutesEnqueuePost(gameId, data, options) {
417
417
  return this.client.request({ ...options, method: "POST", url: `/api/v2/games/${encodeURIComponent(gameId)}/matchmaking`, data: data });
418
418
  }
419
419
  /**
420
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
420
+ * Queue the authenticated caller for kheradgah only; mode is ranked_duel/ranked_alliance/open_court. Other game404, domain conflict409.
421
421
  * Calls `POST /api/v2/games/{game_id}/matchmaking/tickets` through the shared IDP-aware Faiber client.
422
422
  * @param gameId Backend path identifier `game_id`.
423
423
  * @param data Typed JSON request body.
424
424
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
425
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
426
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute and authenticated game membership.
425
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
426
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user with state:execute (management/admin/wildcard aliases accepted); owner/member checks apply where relevant.
427
427
  */
428
428
  kheradgahRoutesEnqueuePost(gameId, data, options) {
429
429
  return this.client.request({ ...options, method: "POST", url: `/api/v2/games/${encodeURIComponent(gameId)}/matchmaking/tickets`, data: data });
430
430
  }
431
431
  /**
432
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
432
+ * Cancel caller-owned queued kheradgah ticket; matched tickets409, other game404.
433
433
  * Calls `DELETE /api/v2/games/{game_id}/matchmaking/tickets/{ticket_id}` through the shared IDP-aware Faiber client.
434
434
  * @param gameId Backend path identifier `game_id`.
435
435
  * @param ticketId Backend path identifier `ticket_id`.
436
436
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
437
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
438
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute and authenticated game membership.
437
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
438
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user with state:execute (management/admin/wildcard aliases accepted); owner/member checks apply where relevant.
439
439
  */
440
440
  kheradgahRoutesCancelDelete(gameId, ticketId, options) {
441
441
  return this.client.request({ ...options, method: "DELETE", url: `/api/v2/games/${encodeURIComponent(gameId)}/matchmaking/tickets/${encodeURIComponent(ticketId)}` });
442
442
  }
443
443
  /**
444
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
444
+ * Read caller-owned kheradgah matchmaking ticket; unknown game/ticket404.
445
445
  * Calls `GET /api/v2/games/{game_id}/matchmaking/tickets/{ticket_id}` through the shared IDP-aware Faiber client.
446
446
  * @param gameId Backend path identifier `game_id`.
447
447
  * @param ticketId Backend path identifier `ticket_id`.
448
448
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
449
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
450
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute and authenticated game membership.
449
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
450
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user with state:execute (management/admin/wildcard aliases accepted); owner/member checks apply where relevant.
451
451
  */
452
452
  kheradgahRoutesTicketGet(gameId, ticketId, options) {
453
453
  return this.client.request({ ...options, method: "GET", url: `/api/v2/games/${encodeURIComponent(gameId)}/matchmaking/tickets/${encodeURIComponent(ticketId)}` });
454
454
  }
455
455
  /**
456
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
456
+ * Create a server-authoritative session. SDK supplies required gameId from the path; the handler also overrides it. Solo sessions only; paid sessions must use matchmaking. difficulty defaults11-14 and accepts8-10/11-14/15-18; paid defaultsfalse. Invalid game404, domain validation422.
457
457
  * Calls `POST /api/v2/games/{game_id}/sessions` through the shared IDP-aware Faiber client.
458
458
  * @param gameId Backend path identifier `game_id`.
459
459
  * @param data Typed JSON request body.
460
460
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
461
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
462
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute and authenticated game membership.
461
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
462
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user with state:execute (management/admin/wildcard aliases accepted); owner/member checks apply where relevant.
463
463
  */
464
464
  gamesRoutesCreateSessionPost(gameId, data, options) {
465
465
  return this.client.request({ ...options, method: "POST", url: `/api/v2/games/${encodeURIComponent(gameId)}/sessions`, data: { ...data, "gameId": String(gameId) } });
466
466
  }
467
467
  /**
468
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
468
+ * Issue a30-second one-use kheradgah connection ticket to a match member; missing/foreign match404. Send ticket in hello frame within5seconds.
469
469
  * Calls `POST /api/v2/matches/{match_id}/connections` through the shared IDP-aware Faiber client.
470
470
  * @param matchId Backend path identifier `match_id`.
471
471
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
472
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
473
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute and authenticated game membership.
472
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
473
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user with state:execute (management/admin/wildcard aliases accepted); owner/member checks apply where relevant.
474
474
  */
475
475
  kheradgahRoutesConnectionPost(matchId, options) {
476
476
  return this.client.request({ ...options, method: "POST", url: `/api/v2/matches/${encodeURIComponent(matchId)}/connections` });
477
477
  }
478
478
  /**
479
- * Use the server-authoritative v2 game API. Commands require the current version; stale versions return 409. The response is {data}, not a v1 envelope.
479
+ * Read member-specific kheradgah projection: only own hand and answer statistics are disclosed; finished question is null; missing/foreign match404.
480
480
  * Calls `GET /api/v2/matches/{match_id}/view` through the shared IDP-aware Faiber client.
481
481
  * @param matchId Backend path identifier `match_id`.
482
482
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
483
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
484
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: state:execute and authenticated game membership.
483
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
484
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: authenticated IDP user with state:execute (management/admin/wildcard aliases accepted); owner/member checks apply where relevant.
485
485
  */
486
486
  kheradgahRoutesViewGet(matchId, options) {
487
487
  return this.client.request({ ...options, method: "GET", url: `/api/v2/matches/${encodeURIComponent(matchId)}/view` });
488
488
  }
489
489
  /**
490
- * Open the v2 match WebSocket and send its one-use hello ticket within five seconds. Acquire a fresh connection ticket after reconnecting.
490
+ * Open allowed-Origin match WebSocket. Send one-use ticket in hello within5seconds; invalid hello/ticket returns error frame. Commands return accepted result or rejected code then fresh snapshot; conflicts use frames, not HTTP409.
491
491
  * Calls `GET /api/v2/realtime` as a WebSocket upgrade.
492
492
  * @param ticket One-use connection ticket from the authenticated match connection endpoint.
493
493
  * @param options Injectable WebSocket constructor and AbortSignal; cancellation closes the socket.
@@ -497,5 +497,15 @@ export class StateOperations extends ServiceApi {
497
497
  connectMatchRealtime(ticket, options) {
498
498
  return openMatchRealtime(this.client, ticket, options);
499
499
  }
500
+ /**
501
+ * Read the static process advertisement with websocket and kheradgah.v1. This does not attest database, game, gateway, persistence or WebSocket readiness.
502
+ * Calls `GET /health` through the shared IDP-aware Faiber client.
503
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
504
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
505
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: public static process advertisement; deployment gateway policy remains separate.
506
+ */
507
+ mainProcessHealthGet(options) {
508
+ return this.client.request({ ...options, method: "GET", url: `/health` });
509
+ }
500
510
  }
501
511
  //# sourceMappingURL=operations.js.map