@cjavdev/believe 0.2.0

package/src/resources/matches/matches.ts

@@ -0,0 +1,391 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as CommentaryAPI from './commentary';
+import { Commentary, CommentaryStreamResponse } from './commentary';
+import { APIPromise } from '../../core/api-promise';
+import { PagePromise, SkipLimitPage, type SkipLimitPageParams } from '../../core/pagination';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Matches extends APIResource {
+  commentary: CommentaryAPI.Commentary = new CommentaryAPI.Commentary(this._client);
+
+  /**
+   * Schedule a new match.
+   *
+   * @example
+   * ```ts
+   * const match = await client.matches.create({
+   *   away_team_id: 'tottenham',
+   *   date: '2024-02-20T19:45:00Z',
+   *   home_team_id: 'afc-richmond',
+   *   match_type: 'cup',
+   * });
+   * ```
+   */
+  create(body: MatchCreateParams, options?: RequestOptions): APIPromise<Match> {
+    return this._client.post('/matches', { body, ...options });
+  }
+
+  /**
+   * Retrieve detailed information about a specific match.
+   *
+   * @example
+   * ```ts
+   * const match = await client.matches.retrieve('match_id');
+   * ```
+   */
+  retrieve(matchID: string, options?: RequestOptions): APIPromise<Match> {
+    return this._client.get(path`/matches/${matchID}`, options);
+  }
+
+  /**
+   * Update specific fields of an existing match (e.g., update score).
+   *
+   * @example
+   * ```ts
+   * const match = await client.matches.update('match_id');
+   * ```
+   */
+  update(matchID: string, body: MatchUpdateParams, options?: RequestOptions): APIPromise<Match> {
+    return this._client.patch(path`/matches/${matchID}`, { body, ...options });
+  }
+
+  /**
+   * Get a paginated list of all matches with optional filtering.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const match of client.matches.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: MatchListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<MatchesSkipLimitPage, Match> {
+    return this._client.getAPIList('/matches', SkipLimitPage<Match>, { query, ...options });
+  }
+
+  /**
+   * Remove a match from the database.
+   *
+   * @example
+   * ```ts
+   * await client.matches.delete('match_id');
+   * ```
+   */
+  delete(matchID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/matches/${matchID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Get the life lesson learned from a specific match.
+   *
+   * @example
+   * ```ts
+   * const response = await client.matches.getLesson('match_id');
+   * ```
+   */
+  getLesson(matchID: string, options?: RequestOptions): APIPromise<MatchGetLessonResponse> {
+    return this._client.get(path`/matches/${matchID}/lesson`, options);
+  }
+
+  /**
+   * Get all turning points from a specific match.
+   *
+   * @example
+   * ```ts
+   * const response = await client.matches.getTurningPoints(
+   *   'match_id',
+   * );
+   * ```
+   */
+  getTurningPoints(matchID: string, options?: RequestOptions): APIPromise<MatchGetTurningPointsResponse> {
+    return this._client.get(path`/matches/${matchID}/turning-points`, options);
+  }
+}
+
+export type MatchesSkipLimitPage = SkipLimitPage<Match>;
+
+/**
+ * Full match model with ID.
+ */
+export interface Match {
+  /**
+   * Unique identifier
+   */
+  id: string;
+
+  /**
+   * Away team ID
+   */
+  away_team_id: string;
+
+  /**
+   * Match date and time
+   */
+  date: string;
+
+  /**
+   * Home team ID
+   */
+  home_team_id: string;
+
+  /**
+   * Type of match
+   */
+  match_type: MatchType;
+
+  /**
+   * Match attendance
+   */
+  attendance?: number | null;
+
+  /**
+   * Away team score
+   */
+  away_score?: number;
+
+  /**
+   * Episode ID where this match is featured
+   */
+  episode_id?: string | null;
+
+  /**
+   * Home team score
+   */
+  home_score?: number;
+
+  /**
+   * The life lesson learned from this match
+   */
+  lesson_learned?: string | null;
+
+  /**
+   * Home team possession percentage
+   */
+  possession_percentage?: number | null;
+
+  /**
+   * Match result from home team perspective
+   */
+  result?: MatchResult;
+
+  /**
+   * Ted's inspirational halftime speech
+   */
+  ted_halftime_speech?: string | null;
+
+  /**
+   * Total ticket revenue in GBP
+   */
+  ticket_revenue_gbp?: string | null;
+
+  /**
+   * Key moments that changed the match
+   */
+  turning_points?: Array<TurningPoint>;
+
+  /**
+   * Temperature at kickoff in Celsius
+   */
+  weather_temp_celsius?: number | null;
+}
+
+/**
+ * Match result types.
+ */
+export type MatchResult = 'win' | 'loss' | 'draw' | 'pending';
+
+/**
+ * Types of matches.
+ */
+export type MatchType = 'league' | 'cup' | 'friendly' | 'playoff' | 'final';
+
+/**
+ * A pivotal moment in a match.
+ */
+export interface TurningPoint {
+  /**
+   * What happened
+   */
+  description: string;
+
+  /**
+   * How this affected the team emotionally
+   */
+  emotional_impact: string;
+
+  /**
+   * Minute of the match
+   */
+  minute: number;
+
+  /**
+   * Character ID who was central to this moment
+   */
+  character_involved?: string | null;
+}
+
+export type MatchGetLessonResponse = { [key: string]: unknown };
+
+export type MatchGetTurningPointsResponse = Array<{ [key: string]: unknown }>;
+
+export interface MatchCreateParams {
+  /**
+   * Away team ID
+   */
+  away_team_id: string;
+
+  /**
+   * Match date and time
+   */
+  date: string;
+
+  /**
+   * Home team ID
+   */
+  home_team_id: string;
+
+  /**
+   * Type of match
+   */
+  match_type: MatchType;
+
+  /**
+   * Match attendance
+   */
+  attendance?: number | null;
+
+  /**
+   * Away team score
+   */
+  away_score?: number;
+
+  /**
+   * Episode ID where this match is featured
+   */
+  episode_id?: string | null;
+
+  /**
+   * Home team score
+   */
+  home_score?: number;
+
+  /**
+   * The life lesson learned from this match
+   */
+  lesson_learned?: string | null;
+
+  /**
+   * Home team possession percentage
+   */
+  possession_percentage?: number | null;
+
+  /**
+   * Match result from home team perspective
+   */
+  result?: MatchResult;
+
+  /**
+   * Ted's inspirational halftime speech
+   */
+  ted_halftime_speech?: string | null;
+
+  /**
+   * Total ticket revenue in GBP
+   */
+  ticket_revenue_gbp?: number | string | null;
+
+  /**
+   * Key moments that changed the match
+   */
+  turning_points?: Array<TurningPoint>;
+
+  /**
+   * Temperature at kickoff in Celsius
+   */
+  weather_temp_celsius?: number | null;
+}
+
+export interface MatchUpdateParams {
+  attendance?: number | null;
+
+  away_score?: number | null;
+
+  away_team_id?: string | null;
+
+  date?: string | null;
+
+  episode_id?: string | null;
+
+  home_score?: number | null;
+
+  home_team_id?: string | null;
+
+  lesson_learned?: string | null;
+
+  /**
+   * Types of matches.
+   */
+  match_type?: MatchType | null;
+
+  possession_percentage?: number | null;
+
+  /**
+   * Match result types.
+   */
+  result?: MatchResult | null;
+
+  ted_halftime_speech?: string | null;
+
+  ticket_revenue_gbp?: number | string | null;
+
+  turning_points?: Array<TurningPoint> | null;
+
+  weather_temp_celsius?: number | null;
+}
+
+export interface MatchListParams extends SkipLimitPageParams {
+  /**
+   * Types of matches.
+   */
+  match_type?: MatchType | null;
+
+  /**
+   * Match result types.
+   */
+  result?: MatchResult | null;
+
+  /**
+   * Filter by team (home or away)
+   */
+  team_id?: string | null;
+}
+
+Matches.Commentary = Commentary;
+
+export declare namespace Matches {
+  export {
+    type Match as Match,
+    type MatchResult as MatchResult,
+    type MatchType as MatchType,
+    type TurningPoint as TurningPoint,
+    type MatchGetLessonResponse as MatchGetLessonResponse,
+    type MatchGetTurningPointsResponse as MatchGetTurningPointsResponse,
+    type MatchesSkipLimitPage as MatchesSkipLimitPage,
+    type MatchCreateParams as MatchCreateParams,
+    type MatchUpdateParams as MatchUpdateParams,
+    type MatchListParams as MatchListParams,
+  };
+
+  export { Commentary as Commentary, type CommentaryStreamResponse as CommentaryStreamResponse };
+}

package/src/resources/matches.ts

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

package/src/resources/pep-talk.ts

@@ -0,0 +1,80 @@
+// 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 { RequestOptions } from '../internal/request-options';
+
+export class PepTalk extends APIResource {
+  /**
+   * Get a motivational pep talk from Ted Lasso himself. By default returns the
+   * complete pep talk. Add `?stream=true` to get Server-Sent Events (SSE) streaming
+   * the pep talk chunk by chunk.
+   *
+   * @example
+   * ```ts
+   * const pepTalk = await client.pepTalk.retrieve();
+   * ```
+   */
+  retrieve(
+    query: PepTalkRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<PepTalkRetrieveResponse> {
+    return this._client.get('/pep-talk', { query, ...options });
+  }
+}
+
+/**
+ * A complete pep talk response.
+ */
+export interface PepTalkRetrieveResponse {
+  /**
+   * Individual chunks of the pep talk
+   */
+  chunks: Array<PepTalkRetrieveResponse.Chunk>;
+
+  /**
+   * The full pep talk text
+   */
+  text: string;
+}
+
+export namespace PepTalkRetrieveResponse {
+  /**
+   * A chunk of a streaming pep talk.
+   */
+  export interface Chunk {
+    /**
+     * Chunk sequence number
+     */
+    chunk_id: number;
+
+    /**
+     * The text of this chunk
+     */
+    text: string;
+
+    /**
+     * The emotional purpose of this chunk
+     */
+    emotional_beat?: string | null;
+
+    /**
+     * Is this the final chunk
+     */
+    is_final?: boolean;
+  }
+}
+
+export interface PepTalkRetrieveParams {
+  /**
+   * If true, returns SSE stream instead of full response
+   */
+  stream?: boolean;
+}
+
+export declare namespace PepTalk {
+  export {
+    type PepTalkRetrieveResponse as PepTalkRetrieveResponse,
+    type PepTalkRetrieveParams as PepTalkRetrieveParams,
+  };
+}

package/src/resources/press.ts

@@ -0,0 +1,76 @@
+// 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 { RequestOptions } from '../internal/request-options';
+
+export class Press extends APIResource {
+  /**
+   * Get Ted's response to press conference questions.
+   *
+   * @example
+   * ```ts
+   * const response = await client.press.simulate({
+   *   question:
+   *     'Ted, your team just lost 5-0. How do you explain this embarrassing defeat?',
+   * });
+   * ```
+   */
+  simulate(body: PressSimulateParams, options?: RequestOptions): APIPromise<PressSimulateResponse> {
+    return this._client.post('/press', { body, ...options });
+  }
+}
+
+/**
+ * Ted's press conference response.
+ */
+export interface PressSimulateResponse {
+  /**
+   * The actual wisdom beneath the humor
+   */
+  actual_wisdom: string;
+
+  /**
+   * How Ted would dodge a follow-up
+   */
+  follow_up_dodge: string;
+
+  /**
+   * How reporters would react
+   */
+  reporter_reaction: string;
+
+  /**
+   * Ted's press conference answer
+   */
+  response: string;
+
+  /**
+   * Humorous deflection if appropriate
+   */
+  deflection_humor?: string | null;
+}
+
+export interface PressSimulateParams {
+  /**
+   * The press question to answer
+   */
+  question: string;
+
+  /**
+   * Is this a hostile question from Trent Crimm?
+   */
+  hostile?: boolean;
+
+  /**
+   * Topic category
+   */
+  topic?: string | null;
+}
+
+export declare namespace Press {
+  export {
+    type PressSimulateResponse as PressSimulateResponse,
+    type PressSimulateParams as PressSimulateParams,
+  };
+}