@cjavdev/believe 0.3.0 → 0.4.0

package/resources/matches/matches.mjs

@@ -100,6 +100,55 @@ export class Matches extends APIResource {
     getTurningPoints(matchID, options) {
         return this._client.get(path `/matches/${matchID}/turning-points`, options);
     }
+    /**
+     * WebSocket endpoint for real-time live match simulation.
+     *
+     * Connect to receive a stream of match events as they happen in a simulated
+     * football match.
+     *
+     * ## Connection
+     *
+     * Connect via WebSocket with optional query parameters to customize the
+     * simulation.
+     *
+     * ## Example WebSocket URL
+     *
+     * ```
+     * ws://localhost:8000/matches/live?home_team=AFC%20Richmond&away_team=Manchester%20City&speed=2.0&excitement_level=7
+     * ```
+     *
+     * ## Server Messages
+     *
+     * The server sends JSON messages with these types:
+     *
+     * - `match_start` - When the match begins
+     * - `match_event` - For each match event (goals, fouls, cards, etc.)
+     * - `match_end` - When the match concludes
+     * - `error` - If an error occurs
+     * - `pong` - Response to client ping
+     *
+     * ## Client Messages
+     *
+     * Send JSON to control the simulation:
+     *
+     * - `{"action": "ping"}` - Keep-alive, server responds with `{"type": "pong"}`
+     * - `{"action": "pause"}` - Pause the simulation
+     * - `{"action": "resume"}` - Resume a paused simulation
+     * - `{"action": "set_speed", "speed": 2.0}` - Change playback speed (0.1-10.0)
+     * - `{"action": "get_status"}` - Request current match status
+     *
+     * @example
+     * ```ts
+     * await client.matches.streamLive();
+     * ```
+     */
+    streamLive(query = {}, options) {
+        return this._client.get('/matches/live', {
+            query,
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
 }
 Matches.Commentary = Commentary;
 //# sourceMappingURL=matches.mjs.map

package/resources/matches/matches.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"matches.mjs","sourceRoot":"","sources":["../../src/resources/matches/matches.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,aAAa;OAClB,EAAE,UAAU,EAA4B;OAExC,EAAe,aAAa,EAA4B;OACxD,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,OAAQ,SAAQ,WAAW;IAAxC;;QACE,eAAU,GAA6B,IAAI,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAqGpF,CAAC;IAnGC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAe,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,OAAe,EAAE,IAAuB,EAAE,OAAwB;QACvE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,YAAY,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAA,aAAoB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,OAAe,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,YAAY,OAAO,EAAE,EAAE;YACpD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,OAAe,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,OAAO,SAAS,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;OASG;IACH,gBAAgB,CAAC,OAAe,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,OAAO,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;CACF;AAoQD,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC"}
+{"version":3,"file":"matches.mjs","sourceRoot":"","sources":["../../src/resources/matches/matches.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,aAAa;OAClB,EAAE,UAAU,EAA4B;OAExC,EAAe,aAAa,EAA4B;OACxD,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,OAAQ,SAAQ,WAAW;IAAxC;;QACE,eAAU,GAA6B,IAAI,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA0JpF,CAAC;IAxJC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAe,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,OAAe,EAAE,IAAuB,EAAE,OAAwB;QACvE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,YAAY,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAA,aAAoB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,OAAe,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,YAAY,OAAO,EAAE,EAAE;YACpD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,OAAe,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,OAAO,SAAS,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;OASG;IACH,gBAAgB,CAAC,OAAe,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,OAAO,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACH,UAAU,CACR,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE;YACvC,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AA0RD,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC"}

package/resources/pep-talk.d.mts

@@ -29,25 +29,26 @@ export interface PepTalkRetrieveResponse {
 }
 export declare namespace PepTalkRetrieveResponse {
     /**
-     * A chunk of a streaming pep talk.
+     * A chunk of a streaming pep talk from Ted.
      */
     interface Chunk {
         /**
          * Chunk sequence number
          */
         chunk_id: number;
+        /**
+         * Is this the final chunk
+         */
+        is_final: boolean;
         /**
          * The text of this chunk
          */
         text: string;
         /**
-         * The emotional purpose of this chunk
+         * The emotional purpose of this chunk (e.g., greeting, acknowledgment, wisdom,
+         * affirmation, encouragement)
          */
         emotional_beat?: string | null;
-        /**
-         * Is this the final chunk
-         */
-        is_final?: boolean;
     }
 }
 export interface PepTalkRetrieveParams {

package/resources/pep-talk.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"pep-talk.d.mts","sourceRoot":"","sources":["../src/resources/pep-talk.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;OASG;IACH,QAAQ,CACN,KAAK,GAAE,qBAAqB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,uBAAuB,CAAC;CAGvC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAE7C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yBAAiB,uBAAuB,CAAC;IACvC;;OAEG;IACH,UAAiB,KAAK;QACpB;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE/B;;WAEG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB;CACF;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,qBAAqB,IAAI,qBAAqB,GACpD,CAAC;CACH"}
+{"version":3,"file":"pep-talk.d.mts","sourceRoot":"","sources":["../src/resources/pep-talk.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;OASG;IACH,QAAQ,CACN,KAAK,GAAE,qBAAqB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,uBAAuB,CAAC;CAGvC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAE7C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yBAAiB,uBAAuB,CAAC;IACvC;;OAEG;IACH,UAAiB,KAAK;QACpB;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;WAEG;QACH,QAAQ,EAAE,OAAO,CAAC;QAElB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;;WAGG;QACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC;CACF;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,qBAAqB,IAAI,qBAAqB,GACpD,CAAC;CACH"}

package/resources/pep-talk.d.ts

@@ -29,25 +29,26 @@ export interface PepTalkRetrieveResponse {
 }
 export declare namespace PepTalkRetrieveResponse {
     /**
-     * A chunk of a streaming pep talk.
+     * A chunk of a streaming pep talk from Ted.
      */
     interface Chunk {
         /**
          * Chunk sequence number
          */
         chunk_id: number;
+        /**
+         * Is this the final chunk
+         */
+        is_final: boolean;
         /**
          * The text of this chunk
          */
         text: string;
         /**
-         * The emotional purpose of this chunk
+         * The emotional purpose of this chunk (e.g., greeting, acknowledgment, wisdom,
+         * affirmation, encouragement)
          */
         emotional_beat?: string | null;
-        /**
-         * Is this the final chunk
-         */
-        is_final?: boolean;
     }
 }
 export interface PepTalkRetrieveParams {

package/resources/pep-talk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pep-talk.d.ts","sourceRoot":"","sources":["../src/resources/pep-talk.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;OASG;IACH,QAAQ,CACN,KAAK,GAAE,qBAAqB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,uBAAuB,CAAC;CAGvC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAE7C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yBAAiB,uBAAuB,CAAC;IACvC;;OAEG;IACH,UAAiB,KAAK;QACpB;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE/B;;WAEG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB;CACF;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,qBAAqB,IAAI,qBAAqB,GACpD,CAAC;CACH"}
+{"version":3,"file":"pep-talk.d.ts","sourceRoot":"","sources":["../src/resources/pep-talk.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;OASG;IACH,QAAQ,CACN,KAAK,GAAE,qBAAqB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,uBAAuB,CAAC;CAGvC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAE7C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yBAAiB,uBAAuB,CAAC;IACvC;;OAEG;IACH,UAAiB,KAAK;QACpB;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;WAEG;QACH,QAAQ,EAAE,OAAO,CAAC;QAElB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;;WAGG;QACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC;CACF;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,qBAAqB,IAAI,qBAAqB,GACpD,CAAC;CACH"}

package/src/client.ts

@@ -112,6 +112,7 @@ import {
   MatchGetTurningPointsResponse,
   MatchListParams,
   MatchResult,
+  MatchStreamLiveParams,
   MatchType,
   MatchUpdateParams,
   Matches,
@@ -144,6 +145,7 @@ import {
   parseLogLevel,
 } from './internal/utils/log';
 import { isEmptyObj } from './internal/utils/values';
+import { Client } from './resources/client/client';
 
 export interface ClientOptions {
   /**
@@ -873,6 +875,7 @@ export class Believe {
   webhooks: API.Webhooks = new API.Webhooks(this);
   health: API.Health = new API.Health(this);
   version: API.Version = new API.Version(this);
+  client: API.Client = new API.Client(this);
 }
 
 Believe.Characters = Characters;
@@ -892,6 +895,7 @@ Believe.TeamMembers = TeamMembers;
 Believe.Webhooks = Webhooks;
 Believe.Health = Health;
 Believe.Version = Version;
+Believe.Client = Client;
 
 export declare namespace Believe {
   export type RequestOptions = Opts.RequestOptions;
@@ -944,6 +948,7 @@ export declare namespace Believe {
     type MatchCreateParams as MatchCreateParams,
     type MatchUpdateParams as MatchUpdateParams,
     type MatchListParams as MatchListParams,
+    type MatchStreamLiveParams as MatchStreamLiveParams,
   };
 
   export {
@@ -1054,4 +1059,6 @@ export declare namespace Believe {
   export { Health as Health, type HealthCheckResponse as HealthCheckResponse };
 
   export { Version as Version, type VersionRetrieveResponse as VersionRetrieveResponse };
+
+  export { Client as Client };
 }

package/src/resources/characters.ts

@@ -67,7 +67,7 @@ export class Characters extends APIResource {
   }
 
   /**
-   * Get a paginated list of all Ted Lasso characters with optional filtering.
+   * Get a paginated list of Ted Lasso characters with optional filtering.
    *
    * @example
    * ```ts

package/src/resources/client/client.ts

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as WsAPI from './ws';
+import { Ws } from './ws';
+
+export class Client extends APIResource {
+  ws: WsAPI.Ws = new WsAPI.Ws(this._client);
+}
+
+Client.Ws = Ws;
+
+export declare namespace Client {
+  export { Ws as Ws };
+}

package/src/resources/client/index.ts

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Client } from './client';
+export { Ws } from './ws';

package/src/resources/client/ws.ts

@@ -0,0 +1,31 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+
+export class Ws extends APIResource {
+  /**
+   * Simple WebSocket test endpoint for connectivity testing.
+   *
+   * Connect to test WebSocket functionality. The server will:
+   *
+   * 1. Send a welcome message on connection
+   * 2. Echo back any message you send
+   *
+   * ## Example
+   *
+   * ```javascript
+   * const ws = new WebSocket("ws://localhost:8000/ws/test");
+   * ws.onmessage = (event) => console.log(event.data);
+   * ws.send("Hello!"); // Server responds with echo
+   * ```
+   */
+  test(options?: RequestOptions): APIPromise<void> {
+    return this._client.get('/ws/test', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}

package/src/resources/client.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './client/index';

package/src/resources/index.ts

@@ -14,6 +14,7 @@ export {
   type CharacterListParams,
   type CharactersSkipLimitPage,
 } from './characters';
+export { Client } from './client/client';
 export { Coaching } from './coaching/coaching';
 export { Conflicts, type ConflictResolveResponse, type ConflictResolveParams } from './conflicts';
 export {
@@ -39,6 +40,7 @@ export {
   type MatchCreateParams,
   type MatchUpdateParams,
   type MatchListParams,
+  type MatchStreamLiveParams,
   type MatchesSkipLimitPage,
 } from './matches/matches';
 export { PepTalk, type PepTalkRetrieveResponse, type PepTalkRetrieveParams } from './pep-talk';

package/src/resources/matches/index.ts

@@ -12,5 +12,6 @@ export {
   type MatchCreateParams,
   type MatchUpdateParams,
   type MatchListParams,
+  type MatchStreamLiveParams,
   type MatchesSkipLimitPage,
 } from './matches';

package/src/resources/matches/matches.ts

@@ -111,6 +111,59 @@ export class Matches extends APIResource {
   getTurningPoints(matchID: string, options?: RequestOptions): APIPromise<MatchGetTurningPointsResponse> {
     return this._client.get(path`/matches/${matchID}/turning-points`, options);
   }
+
+  /**
+   * WebSocket endpoint for real-time live match simulation.
+   *
+   * Connect to receive a stream of match events as they happen in a simulated
+   * football match.
+   *
+   * ## Connection
+   *
+   * Connect via WebSocket with optional query parameters to customize the
+   * simulation.
+   *
+   * ## Example WebSocket URL
+   *
+   * ```
+   * ws://localhost:8000/matches/live?home_team=AFC%20Richmond&away_team=Manchester%20City&speed=2.0&excitement_level=7
+   * ```
+   *
+   * ## Server Messages
+   *
+   * The server sends JSON messages with these types:
+   *
+   * - `match_start` - When the match begins
+   * - `match_event` - For each match event (goals, fouls, cards, etc.)
+   * - `match_end` - When the match concludes
+   * - `error` - If an error occurs
+   * - `pong` - Response to client ping
+   *
+   * ## Client Messages
+   *
+   * Send JSON to control the simulation:
+   *
+   * - `{"action": "ping"}` - Keep-alive, server responds with `{"type": "pong"}`
+   * - `{"action": "pause"}` - Pause the simulation
+   * - `{"action": "resume"}` - Resume a paused simulation
+   * - `{"action": "set_speed", "speed": 2.0}` - Change playback speed (0.1-10.0)
+   * - `{"action": "get_status"}` - Request current match status
+   *
+   * @example
+   * ```ts
+   * await client.matches.streamLive();
+   * ```
+   */
+  streamLive(
+    query: MatchStreamLiveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    return this._client.get('/matches/live', {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
 }
 
 export type MatchesSkipLimitPage = SkipLimitPage<Match>;
@@ -371,6 +424,28 @@ export interface MatchListParams extends SkipLimitPageParams {
   team_id?: string | null;
 }
 
+export interface MatchStreamLiveParams {
+  /**
+   * Away team name
+   */
+  away_team?: string;
+
+  /**
+   * How eventful the match should be (1=boring, 10=chaos)
+   */
+  excitement_level?: number;
+
+  /**
+   * Home team name
+   */
+  home_team?: string;
+
+  /**
+   * Simulation speed multiplier (1.0 = real-time)
+   */
+  speed?: number;
+}
+
 Matches.Commentary = Commentary;
 
 export declare namespace Matches {
@@ -385,6 +460,7 @@ export declare namespace Matches {
     type MatchCreateParams as MatchCreateParams,
     type MatchUpdateParams as MatchUpdateParams,
     type MatchListParams as MatchListParams,
+    type MatchStreamLiveParams as MatchStreamLiveParams,
   };
 
   export { Commentary as Commentary, type CommentaryStreamResponse as CommentaryStreamResponse };

package/src/resources/pep-talk.ts

@@ -40,7 +40,7 @@ export interface PepTalkRetrieveResponse {
 
 export namespace PepTalkRetrieveResponse {
   /**
-   * A chunk of a streaming pep talk.
+   * A chunk of a streaming pep talk from Ted.
    */
   export interface Chunk {
     /**
@@ -49,19 +49,20 @@ export namespace PepTalkRetrieveResponse {
     chunk_id: number;
 
     /**
-     * The text of this chunk
+     * Is this the final chunk
      */
-    text: string;
+    is_final: boolean;
 
     /**
-     * The emotional purpose of this chunk
+     * The text of this chunk
      */
-    emotional_beat?: string | null;
+    text: string;
 
     /**
-     * Is this the final chunk
+     * The emotional purpose of this chunk (e.g., greeting, acknowledgment, wisdom,
+     * affirmation, encouragement)
      */
-    is_final?: boolean;
+    emotional_beat?: string | null;
   }
 }
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.3.0'; // x-release-please-version
+export const VERSION = '0.4.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.3.0";
+export declare const VERSION = "0.4.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.3.0";
+export declare const VERSION = "0.4.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.3.0'; // x-release-please-version
+exports.VERSION = '0.4.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.3.0'; // x-release-please-version
+export const VERSION = '0.4.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map