@v5x/events 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Beanarchy Studios
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,64 @@
+# @v5x/events
+
+Strictly typed TypeScript client for the [VEX Events API v2](https://events.vex.com/api/v2).
+
+## Install
+
+```sh
+bun add @v5x/events
+```
+
+## Usage
+
+Create a personal access token in your VEX Events account, then pass it to the
+client. The package works in browsers, Bun, and modern Node.js runtimes with
+`fetch`.
+
+```ts
+import { VexEventsClient } from "@v5x/events";
+
+const vex = new VexEventsClient({
+  token: process.env.VEX_EVENTS_TOKEN!,
+});
+
+const teams = await vex.teams.list({
+  numbers: ["123A"],
+  registered: true,
+  perPage: 100,
+});
+
+for (const team of teams.data ?? []) {
+  console.log(team.number, team.team_name);
+}
+```
+
+Resources mirror the API:
+
+- `vex.events`: events, event teams, skills, awards, division matches, and rankings
+- `vex.teams`: teams and their events, matches, rankings, skills, and awards
+- `vex.programs`: programs
+- `vex.seasons`: seasons and season events
+
+All filters, response models, pagination metadata, and API error bodies are
+exported as TypeScript types. Array filters use normal arrays; the client
+encodes them using the API's repeated `field[]` query parameters. `Date` values
+are converted to RFC 3339 strings automatically.
+
+```ts
+import { VexEventsApiError } from "@v5x/events";
+
+try {
+  const event = await vex.events.get(123);
+  console.log(event.name);
+} catch (error) {
+  if (error instanceof VexEventsApiError) {
+    console.error(error.status, error.body);
+  }
+}
+```
+
+## Build
+
+```sh
+bun run build
+```

package/dist/client.d.ts

@@ -0,0 +1,55 @@
+import type { Award, Event, ListDivisionMatchesOptions, ListDivisionRankingsOptions, ListEventAwardsOptions, ListEventsOptions, ListEventSkillsOptions, ListEventTeamsOptions, ListProgramsOptions, ListSeasonEventsOptions, ListSeasonsOptions, ListTeamAwardsOptions, ListTeamEventsOptions, ListTeamMatchesOptions, ListTeamRankingsOptions, ListTeamsOptions, ListTeamSkillsOptions, Match, PaginatedResponse, Program, Ranking, Season, Skill, Team } from "./types.js";
+export interface RequestOptions {
+    signal?: AbortSignal;
+}
+export type Fetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+export interface VexEventsClientOptions {
+    /** Personal access token sent using bearer authentication. */
+    token: string;
+    /** Override for tests, proxies, or compatible API deployments. */
+    baseUrl?: string;
+    /** Fetch implementation to use. Defaults to globalThis.fetch. */
+    fetch?: Fetch;
+    /** Additional headers included with every request. */
+    headers?: Readonly<Record<string, string>>;
+}
+export interface EventsResource {
+    list(options?: ListEventsOptions, request?: RequestOptions): Promise<PaginatedResponse<Event>>;
+    get(id: number, request?: RequestOptions): Promise<Event>;
+    teams(id: number, options?: ListEventTeamsOptions, request?: RequestOptions): Promise<PaginatedResponse<Team>>;
+    skills(id: number, options?: ListEventSkillsOptions, request?: RequestOptions): Promise<PaginatedResponse<Skill>>;
+    awards(id: number, options?: ListEventAwardsOptions, request?: RequestOptions): Promise<PaginatedResponse<Award>>;
+    matches(id: number, division: number, options?: ListDivisionMatchesOptions, request?: RequestOptions): Promise<PaginatedResponse<Match>>;
+    finalistRankings(id: number, division: number, options?: ListDivisionRankingsOptions, request?: RequestOptions): Promise<PaginatedResponse<Ranking>>;
+    rankings(id: number, division: number, options?: ListDivisionRankingsOptions, request?: RequestOptions): Promise<PaginatedResponse<Ranking>>;
+}
+export interface TeamsResource {
+    list(options?: ListTeamsOptions, request?: RequestOptions): Promise<PaginatedResponse<Team>>;
+    get(id: number, request?: RequestOptions): Promise<Team>;
+    events(id: number, options?: ListTeamEventsOptions, request?: RequestOptions): Promise<PaginatedResponse<Event>>;
+    matches(id: number, options?: ListTeamMatchesOptions, request?: RequestOptions): Promise<PaginatedResponse<Match>>;
+    rankings(id: number, options?: ListTeamRankingsOptions, request?: RequestOptions): Promise<PaginatedResponse<Ranking>>;
+    skills(id: number, options?: ListTeamSkillsOptions, request?: RequestOptions): Promise<PaginatedResponse<Skill>>;
+    awards(id: number, options?: ListTeamAwardsOptions, request?: RequestOptions): Promise<PaginatedResponse<Award>>;
+}
+export interface ProgramsResource {
+    list(options?: ListProgramsOptions, request?: RequestOptions): Promise<PaginatedResponse<Program>>;
+    get(id: number, request?: RequestOptions): Promise<Program>;
+}
+export interface SeasonsResource {
+    list(options?: ListSeasonsOptions, request?: RequestOptions): Promise<PaginatedResponse<Season>>;
+    get(id: number, request?: RequestOptions): Promise<Season>;
+    events(id: number, options?: ListSeasonEventsOptions, request?: RequestOptions): Promise<PaginatedResponse<Event>>;
+}
+export declare class VexEventsClient {
+    readonly events: EventsResource;
+    readonly teams: TeamsResource;
+    readonly programs: ProgramsResource;
+    readonly seasons: SeasonsResource;
+    private readonly token;
+    private readonly baseUrl;
+    private readonly fetch;
+    private readonly headers;
+    constructor(options: VexEventsClientOptions);
+    private request;
+}

package/dist/errors.d.ts

@@ -0,0 +1,15 @@
+import type { ApiErrorBody } from "./types.js";
+export declare class VexEventsApiError extends Error {
+    readonly status: number;
+    readonly statusText: string;
+    readonly body: ApiErrorBody | string | null;
+    readonly url: string;
+    readonly name = "VexEventsApiError";
+    constructor(status: number, statusText: string, body: ApiErrorBody | string | null, url: string);
+}
+export declare class VexEventsResponseError extends Error {
+    readonly url: string;
+    readonly cause?: unknown;
+    readonly name = "VexEventsResponseError";
+    constructor(message: string, url: string, cause?: unknown);
+}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import * as client from "./client.js";
+import * as errors from "./errors.js";
+export declare const VexEventsClient: typeof client.VexEventsClient;
+export declare const VexEventsApiError: typeof errors.VexEventsApiError;
+export declare const VexEventsResponseError: typeof errors.VexEventsResponseError;
+export type VexEventsClient = client.VexEventsClient;
+export type VexEventsApiError = errors.VexEventsApiError;
+export type VexEventsResponseError = errors.VexEventsResponseError;
+export type { EventsResource, Fetch, ProgramsResource, RequestOptions, SeasonsResource, TeamsResource, VexEventsClientOptions, } from "./client.js";
+export type * from "./types.js";

package/dist/index.js

@@ -0,0 +1,300 @@
+// src/errors.ts
+class VexEventsApiError extends Error {
+  status;
+  statusText;
+  body;
+  url;
+  name = "VexEventsApiError";
+  constructor(status, statusText, body, url) {
+    const apiMessage = typeof body === "object" && body !== null ? body.message : undefined;
+    super(apiMessage ?? `VEX Events API request failed: ${status} ${statusText}`);
+    this.status = status;
+    this.statusText = statusText;
+    this.body = body;
+    this.url = url;
+  }
+}
+
+class VexEventsResponseError extends Error {
+  url;
+  cause;
+  name = "VexEventsResponseError";
+  constructor(message, url, cause) {
+    super(message, cause === undefined ? undefined : { cause });
+    this.url = url;
+    this.cause = cause;
+  }
+}
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://events.vex.com/api/v2";
+function paginationEntries(options) {
+  return [
+    ["page", options.page],
+    ["per_page", options.perPage]
+  ];
+}
+function serializeDate(value) {
+  return value instanceof Date ? value.toISOString() : value;
+}
+function appendQuery(url, entries) {
+  for (const [name, value] of entries) {
+    if (value === undefined)
+      continue;
+    if (Array.isArray(value)) {
+      for (const item of value)
+        url.searchParams.append(name, String(item));
+      continue;
+    }
+    url.searchParams.set(name, value instanceof Date ? serializeDate(value) : String(value));
+  }
+}
+function isApiErrorBody(value) {
+  if (typeof value !== "object" || value === null)
+    return false;
+  const body = value;
+  return (body.code === undefined || typeof body.code === "number") && (body.message === undefined || typeof body.message === "string");
+}
+function normalizeErrorBody(value) {
+  if (isApiErrorBody(value))
+    return value;
+  return typeof value === "string" ? value : null;
+}
+function isJsonContentType(contentType) {
+  const mediaType = contentType.split(";", 1)[0]?.trim().toLowerCase();
+  return mediaType === "application/json" || mediaType?.endsWith("+json") === true;
+}
+function isObjectResponse(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isPaginatedResponse(value) {
+  if (!isObjectResponse(value))
+    return false;
+  return (value.data === undefined || Array.isArray(value.data)) && (value.meta === undefined || isObjectResponse(value.meta));
+}
+function hasResponseShape(value, responseShape) {
+  return responseShape === "paginated" ? isPaginatedResponse(value) : isObjectResponse(value);
+}
+
+class VexEventsClient {
+  events;
+  teams;
+  programs;
+  seasons;
+  token;
+  baseUrl;
+  fetch;
+  headers;
+  constructor(options) {
+    if (options.token.trim() === "") {
+      throw new TypeError("token must not be empty");
+    }
+    this.token = options.token;
+    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.fetch = options.fetch ?? globalThis.fetch;
+    this.headers = options.headers ?? {};
+    this.events = {
+      list: (options2 = {}, request) => this.request("/events", eventEntries(options2), request, "paginated"),
+      get: (id, request) => this.request(`/events/${id}`, [], request, "object"),
+      teams: (id, options2 = {}, request) => this.request(`/events/${id}/teams`, eventTeamEntries(options2), request, "paginated"),
+      skills: (id, options2 = {}, request) => this.request(`/events/${id}/skills`, eventSkillEntries(options2), request, "paginated"),
+      awards: (id, options2 = {}, request) => this.request(`/events/${id}/awards`, eventAwardEntries(options2), request, "paginated"),
+      matches: (id, division, options2 = {}, request) => this.request(`/events/${id}/divisions/${division}/matches`, divisionMatchEntries(options2), request, "paginated"),
+      finalistRankings: (id, division, options2 = {}, request) => this.request(`/events/${id}/divisions/${division}/finalistRankings`, divisionRankingEntries(options2), request, "paginated"),
+      rankings: (id, division, options2 = {}, request) => this.request(`/events/${id}/divisions/${division}/rankings`, divisionRankingEntries(options2), request, "paginated")
+    };
+    this.teams = {
+      list: (options2 = {}, request) => this.request("/teams", teamEntries(options2), request, "paginated"),
+      get: (id, request) => this.request(`/teams/${id}`, [], request, "object"),
+      events: (id, options2 = {}, request) => this.request(`/teams/${id}/events`, teamEventEntries(options2), request, "paginated"),
+      matches: (id, options2 = {}, request) => this.request(`/teams/${id}/matches`, teamMatchEntries(options2), request, "paginated"),
+      rankings: (id, options2 = {}, request) => this.request(`/teams/${id}/rankings`, teamRankingEntries(options2), request, "paginated"),
+      skills: (id, options2 = {}, request) => this.request(`/teams/${id}/skills`, teamSkillEntries(options2), request, "paginated"),
+      awards: (id, options2 = {}, request) => this.request(`/teams/${id}/awards`, teamAwardEntries(options2), request, "paginated")
+    };
+    this.programs = {
+      list: (options2 = {}, request) => this.request("/programs", [...paginationEntries(options2), ["id[]", options2.ids]], request, "paginated"),
+      get: (id, request) => this.request(`/programs/${id}`, [], request, "object")
+    };
+    this.seasons = {
+      list: (options2 = {}, request) => this.request("/seasons", seasonEntries(options2), request, "paginated"),
+      get: (id, request) => this.request(`/seasons/${id}`, [], request, "object"),
+      events: (id, options2 = {}, request) => this.request(`/seasons/${id}/events`, seasonEventEntries(options2), request, "paginated")
+    };
+  }
+  async request(path, query, options, responseShape) {
+    const url = new URL(`${this.baseUrl}${path}`);
+    appendQuery(url, query);
+    const response = await this.fetch(url, {
+      headers: {
+        ...this.headers,
+        Accept: "application/json",
+        Authorization: `Bearer ${this.token}`
+      },
+      signal: options?.signal
+    });
+    const contentType = response.headers.get("content-type") ?? "";
+    const isJson = isJsonContentType(contentType);
+    let body;
+    try {
+      body = isJson ? await response.json() : await response.text();
+    } catch (error) {
+      throw new VexEventsResponseError("VEX Events API returned an unreadable response", url.toString(), error);
+    }
+    if (!response.ok) {
+      throw new VexEventsApiError(response.status, response.statusText, normalizeErrorBody(body), url.toString());
+    }
+    if (!isJson) {
+      throw new VexEventsResponseError("VEX Events API returned a non-JSON response", url.toString());
+    }
+    if (!hasResponseShape(body, responseShape)) {
+      throw new VexEventsResponseError(`VEX Events API returned an invalid response for ${path}`, url.toString());
+    }
+    return body;
+  }
+}
+function eventEntries(options) {
+  return [
+    ...paginationEntries(options),
+    ["id[]", options.ids],
+    ["sku[]", options.skus],
+    ["team[]", options.teams],
+    ["season[]", options.seasons],
+    ["start", options.start],
+    ["end", options.end],
+    ["region", options.region],
+    ["level[]", options.levels],
+    ["myEvents", options.myEvents],
+    ["eventTypes[]", options.eventTypes]
+  ];
+}
+function eventTeamEntries(options) {
+  return [
+    ...paginationEntries(options),
+    ["number[]", options.numbers],
+    ["registered", options.registered],
+    ["grade[]", options.grades],
+    ["country[]", options.countries],
+    ["myTeams", options.myTeams]
+  ];
+}
+function eventSkillEntries(options) {
+  return [
+    ...paginationEntries(options),
+    ["team[]", options.teams],
+    ["type[]", options.types]
+  ];
+}
+function eventAwardEntries(options) {
+  return [
+    ...paginationEntries(options),
+    ["team[]", options.teams],
+    ["winner[]", options.winners]
+  ];
+}
+function divisionMatchEntries(options) {
+  return [
+    ...paginationEntries(options),
+    ["team[]", options.teams],
+    ["round[]", options.rounds],
+    ["instance[]", options.instances],
+    ["matchnum[]", options.matchNumbers]
+  ];
+}
+function divisionRankingEntries(options) {
+  return [
+    ...paginationEntries(options),
+    ["team[]", options.teams],
+    ["rank[]", options.ranks]
+  ];
+}
+function teamEntries(options) {
+  return [
+    ...paginationEntries(options),
+    ["id[]", options.ids],
+    ["number[]", options.numbers],
+    ["event[]", options.events],
+    ["registered", options.registered],
+    ["program[]", options.programs],
+    ["grade[]", options.grades],
+    ["country[]", options.countries],
+    ["myTeams", options.myTeams]
+  ];
+}
+function teamEventEntries(options) {
+  return [
+    ...paginationEntries(options),
+    ["sku[]", options.skus],
+    ["season[]", options.seasons],
+    ["start", options.start],
+    ["end", options.end],
+    ["level[]", options.levels]
+  ];
+}
+function teamMatchEntries(options) {
+  return [
+    ...paginationEntries(options),
+    ["event[]", options.events],
+    ["season[]", options.seasons],
+    ["round[]", options.rounds],
+    ["instance[]", options.instances],
+    ["matchnum[]", options.matchNumbers]
+  ];
+}
+function teamRankingEntries(options) {
+  return [
+    ...paginationEntries(options),
+    ["event[]", options.events],
+    ["rank[]", options.ranks],
+    ["season[]", options.seasons]
+  ];
+}
+function teamSkillEntries(options) {
+  return [
+    ...paginationEntries(options),
+    ["event[]", options.events],
+    ["type[]", options.types],
+    ["season[]", options.seasons]
+  ];
+}
+function teamAwardEntries(options) {
+  return [
+    ...paginationEntries(options),
+    ["event[]", options.events],
+    ["season[]", options.seasons]
+  ];
+}
+function seasonEntries(options) {
+  return [
+    ...paginationEntries(options),
+    ["id[]", options.ids],
+    ["program[]", options.programs],
+    ["team[]", options.teams],
+    ["start", options.start],
+    ["end", options.end],
+    ["active", options.active]
+  ];
+}
+function seasonEventEntries(options) {
+  return [
+    ...paginationEntries(options),
+    ["sku[]", options.skus],
+    ["team[]", options.teams],
+    ["start", options.start],
+    ["end", options.end],
+    ["level[]", options.levels]
+  ];
+}
+
+// src/index.ts
+var VexEventsClient2 = VexEventsClient;
+var VexEventsApiError2 = VexEventsApiError;
+var VexEventsResponseError2 = VexEventsResponseError;
+export {
+  VexEventsResponseError2 as VexEventsResponseError,
+  VexEventsClient2 as VexEventsClient,
+  VexEventsApiError2 as VexEventsApiError
+};
+
+//# debugId=794DCB1DDF226CF164756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/errors.ts", "../src/client.ts", "../src/index.ts"],
+  "sourcesContent": [
+    "import type { ApiErrorBody } from \"./types.js\";\n\nexport class VexEventsApiError extends Error {\n  override readonly name = \"VexEventsApiError\";\n\n  constructor(\n    readonly status: number,\n    readonly statusText: string,\n    readonly body: ApiErrorBody | string | null,\n    readonly url: string,\n  ) {\n    const apiMessage =\n      typeof body === \"object\" && body !== null ? body.message : undefined;\n    super(\n      apiMessage ?? `VEX Events API request failed: ${status} ${statusText}`,\n    );\n  }\n}\n\nexport class VexEventsResponseError extends Error {\n  override readonly name = \"VexEventsResponseError\";\n\n  constructor(\n    message: string,\n    readonly url: string,\n    override readonly cause?: unknown,\n  ) {\n    super(message, cause === undefined ? undefined : { cause });\n  }\n}\n",
+    "import { VexEventsApiError, VexEventsResponseError } from \"./errors.js\";\nimport type {\n  ApiErrorBody,\n  Award,\n  DateInput,\n  Event,\n  ListDivisionMatchesOptions,\n  ListDivisionRankingsOptions,\n  ListEventAwardsOptions,\n  ListEventsOptions,\n  ListEventSkillsOptions,\n  ListEventTeamsOptions,\n  ListProgramsOptions,\n  ListSeasonEventsOptions,\n  ListSeasonsOptions,\n  ListTeamAwardsOptions,\n  ListTeamEventsOptions,\n  ListTeamMatchesOptions,\n  ListTeamRankingsOptions,\n  ListTeamsOptions,\n  ListTeamSkillsOptions,\n  Match,\n  PaginatedResponse,\n  PaginationOptions,\n  Program,\n  Ranking,\n  Season,\n  Skill,\n  Team,\n} from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://events.vex.com/api/v2\";\n\ntype QueryValue = DateInput | boolean | number | readonly (number | string)[];\ntype QueryEntry = readonly [name: string, value: QueryValue | undefined];\ntype ResponseShape = \"object\" | \"paginated\";\n\nexport interface RequestOptions {\n  signal?: AbortSignal;\n}\n\nexport type Fetch = (\n  input: RequestInfo | URL,\n  init?: RequestInit,\n) => Promise<Response>;\n\nexport interface VexEventsClientOptions {\n  /** Personal access token sent using bearer authentication. */\n  token: string;\n  /** Override for tests, proxies, or compatible API deployments. */\n  baseUrl?: string;\n  /** Fetch implementation to use. Defaults to globalThis.fetch. */\n  fetch?: Fetch;\n  /** Additional headers included with every request. */\n  headers?: Readonly<Record<string, string>>;\n}\n\nexport interface EventsResource {\n  list(\n    options?: ListEventsOptions,\n    request?: RequestOptions,\n  ): Promise<PaginatedResponse<Event>>;\n  get(id: number, request?: RequestOptions): Promise<Event>;\n  teams(\n    id: number,\n    options?: ListEventTeamsOptions,\n    request?: RequestOptions,\n  ): Promise<PaginatedResponse<Team>>;\n  skills(\n    id: number,\n    options?: ListEventSkillsOptions,\n    request?: RequestOptions,\n  ): Promise<PaginatedResponse<Skill>>;\n  awards(\n    id: number,\n    options?: ListEventAwardsOptions,\n    request?: RequestOptions,\n  ): Promise<PaginatedResponse<Award>>;\n  matches(\n    id: number,\n    division: number,\n    options?: ListDivisionMatchesOptions,\n    request?: RequestOptions,\n  ): Promise<PaginatedResponse<Match>>;\n  finalistRankings(\n    id: number,\n    division: number,\n    options?: ListDivisionRankingsOptions,\n    request?: RequestOptions,\n  ): Promise<PaginatedResponse<Ranking>>;\n  rankings(\n    id: number,\n    division: number,\n    options?: ListDivisionRankingsOptions,\n    request?: RequestOptions,\n  ): Promise<PaginatedResponse<Ranking>>;\n}\n\nexport interface TeamsResource {\n  list(\n    options?: ListTeamsOptions,\n    request?: RequestOptions,\n  ): Promise<PaginatedResponse<Team>>;\n  get(id: number, request?: RequestOptions): Promise<Team>;\n  events(\n    id: number,\n    options?: ListTeamEventsOptions,\n    request?: RequestOptions,\n  ): Promise<PaginatedResponse<Event>>;\n  matches(\n    id: number,\n    options?: ListTeamMatchesOptions,\n    request?: RequestOptions,\n  ): Promise<PaginatedResponse<Match>>;\n  rankings(\n    id: number,\n    options?: ListTeamRankingsOptions,\n    request?: RequestOptions,\n  ): Promise<PaginatedResponse<Ranking>>;\n  skills(\n    id: number,\n    options?: ListTeamSkillsOptions,\n    request?: RequestOptions,\n  ): Promise<PaginatedResponse<Skill>>;\n  awards(\n    id: number,\n    options?: ListTeamAwardsOptions,\n    request?: RequestOptions,\n  ): Promise<PaginatedResponse<Award>>;\n}\n\nexport interface ProgramsResource {\n  list(\n    options?: ListProgramsOptions,\n    request?: RequestOptions,\n  ): Promise<PaginatedResponse<Program>>;\n  get(id: number, request?: RequestOptions): Promise<Program>;\n}\n\nexport interface SeasonsResource {\n  list(\n    options?: ListSeasonsOptions,\n    request?: RequestOptions,\n  ): Promise<PaginatedResponse<Season>>;\n  get(id: number, request?: RequestOptions): Promise<Season>;\n  events(\n    id: number,\n    options?: ListSeasonEventsOptions,\n    request?: RequestOptions,\n  ): Promise<PaginatedResponse<Event>>;\n}\n\nfunction paginationEntries(options: PaginationOptions): QueryEntry[] {\n  return [\n    [\"page\", options.page],\n    [\"per_page\", options.perPage],\n  ];\n}\n\nfunction serializeDate(value: DateInput): string {\n  return value instanceof Date ? value.toISOString() : value;\n}\n\nfunction appendQuery(url: URL, entries: readonly QueryEntry[]): void {\n  for (const [name, value] of entries) {\n    if (value === undefined) continue;\n    if (Array.isArray(value)) {\n      for (const item of value) url.searchParams.append(name, String(item));\n      continue;\n    }\n    url.searchParams.set(\n      name,\n      value instanceof Date ? serializeDate(value) : String(value),\n    );\n  }\n}\n\nfunction isApiErrorBody(value: unknown): value is ApiErrorBody {\n  if (typeof value !== \"object\" || value === null) return false;\n  const body = value as Record<string, unknown>;\n  return (\n    (body.code === undefined || typeof body.code === \"number\") &&\n    (body.message === undefined || typeof body.message === \"string\")\n  );\n}\n\nfunction normalizeErrorBody(value: unknown): ApiErrorBody | string | null {\n  if (isApiErrorBody(value)) return value;\n  return typeof value === \"string\" ? value : null;\n}\n\nfunction isJsonContentType(contentType: string): boolean {\n  const mediaType = contentType.split(\";\", 1)[0]?.trim().toLowerCase();\n  return (\n    mediaType === \"application/json\" || mediaType?.endsWith(\"+json\") === true\n  );\n}\n\nfunction isObjectResponse(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isPaginatedResponse(value: unknown): boolean {\n  if (!isObjectResponse(value)) return false;\n  return (\n    (value.data === undefined || Array.isArray(value.data)) &&\n    (value.meta === undefined || isObjectResponse(value.meta))\n  );\n}\n\nfunction hasResponseShape<T>(\n  value: unknown,\n  responseShape: ResponseShape,\n): value is T {\n  return responseShape === \"paginated\"\n    ? isPaginatedResponse(value)\n    : isObjectResponse(value);\n}\n\nexport class VexEventsClient {\n  readonly events: EventsResource;\n  readonly teams: TeamsResource;\n  readonly programs: ProgramsResource;\n  readonly seasons: SeasonsResource;\n\n  private readonly token: string;\n  private readonly baseUrl: string;\n  private readonly fetch: Fetch;\n  private readonly headers: Readonly<Record<string, string>>;\n\n  constructor(options: VexEventsClientOptions) {\n    if (options.token.trim() === \"\") {\n      throw new TypeError(\"token must not be empty\");\n    }\n\n    this.token = options.token;\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, \"\");\n    this.fetch = options.fetch ?? globalThis.fetch;\n    this.headers = options.headers ?? {};\n\n    this.events = {\n      list: (options = {}, request) =>\n        this.request(\"/events\", eventEntries(options), request, \"paginated\"),\n      get: (id, request) =>\n        this.request(`/events/${id}`, [], request, \"object\"),\n      teams: (id, options = {}, request) =>\n        this.request(\n          `/events/${id}/teams`,\n          eventTeamEntries(options),\n          request,\n          \"paginated\",\n        ),\n      skills: (id, options = {}, request) =>\n        this.request(\n          `/events/${id}/skills`,\n          eventSkillEntries(options),\n          request,\n          \"paginated\",\n        ),\n      awards: (id, options = {}, request) =>\n        this.request(\n          `/events/${id}/awards`,\n          eventAwardEntries(options),\n          request,\n          \"paginated\",\n        ),\n      matches: (id, division, options = {}, request) =>\n        this.request(\n          `/events/${id}/divisions/${division}/matches`,\n          divisionMatchEntries(options),\n          request,\n          \"paginated\",\n        ),\n      finalistRankings: (id, division, options = {}, request) =>\n        this.request(\n          `/events/${id}/divisions/${division}/finalistRankings`,\n          divisionRankingEntries(options),\n          request,\n          \"paginated\",\n        ),\n      rankings: (id, division, options = {}, request) =>\n        this.request(\n          `/events/${id}/divisions/${division}/rankings`,\n          divisionRankingEntries(options),\n          request,\n          \"paginated\",\n        ),\n    };\n\n    this.teams = {\n      list: (options = {}, request) =>\n        this.request(\"/teams\", teamEntries(options), request, \"paginated\"),\n      get: (id, request) => this.request(`/teams/${id}`, [], request, \"object\"),\n      events: (id, options = {}, request) =>\n        this.request(\n          `/teams/${id}/events`,\n          teamEventEntries(options),\n          request,\n          \"paginated\",\n        ),\n      matches: (id, options = {}, request) =>\n        this.request(\n          `/teams/${id}/matches`,\n          teamMatchEntries(options),\n          request,\n          \"paginated\",\n        ),\n      rankings: (id, options = {}, request) =>\n        this.request(\n          `/teams/${id}/rankings`,\n          teamRankingEntries(options),\n          request,\n          \"paginated\",\n        ),\n      skills: (id, options = {}, request) =>\n        this.request(\n          `/teams/${id}/skills`,\n          teamSkillEntries(options),\n          request,\n          \"paginated\",\n        ),\n      awards: (id, options = {}, request) =>\n        this.request(\n          `/teams/${id}/awards`,\n          teamAwardEntries(options),\n          request,\n          \"paginated\",\n        ),\n    };\n\n    this.programs = {\n      list: (options = {}, request) =>\n        this.request(\n          \"/programs\",\n          [...paginationEntries(options), [\"id[]\", options.ids]],\n          request,\n          \"paginated\",\n        ),\n      get: (id, request) =>\n        this.request(`/programs/${id}`, [], request, \"object\"),\n    };\n\n    this.seasons = {\n      list: (options = {}, request) =>\n        this.request(\"/seasons\", seasonEntries(options), request, \"paginated\"),\n      get: (id, request) =>\n        this.request(`/seasons/${id}`, [], request, \"object\"),\n      events: (id, options = {}, request) =>\n        this.request(\n          `/seasons/${id}/events`,\n          seasonEventEntries(options),\n          request,\n          \"paginated\",\n        ),\n    };\n  }\n\n  private async request<T>(\n    path: string,\n    query: readonly QueryEntry[],\n    options: RequestOptions | undefined,\n    responseShape: ResponseShape,\n  ): Promise<T> {\n    const url = new URL(`${this.baseUrl}${path}`);\n    appendQuery(url, query);\n\n    const response = await this.fetch(url, {\n      headers: {\n        ...this.headers,\n        Accept: \"application/json\",\n        Authorization: `Bearer ${this.token}`,\n      },\n      signal: options?.signal,\n    });\n\n    const contentType = response.headers.get(\"content-type\") ?? \"\";\n    const isJson = isJsonContentType(contentType);\n    let body: unknown;\n    try {\n      body = isJson ? await response.json() : await response.text();\n    } catch (error) {\n      throw new VexEventsResponseError(\n        \"VEX Events API returned an unreadable response\",\n        url.toString(),\n        error,\n      );\n    }\n\n    if (!response.ok) {\n      throw new VexEventsApiError(\n        response.status,\n        response.statusText,\n        normalizeErrorBody(body),\n        url.toString(),\n      );\n    }\n\n    if (!isJson) {\n      throw new VexEventsResponseError(\n        \"VEX Events API returned a non-JSON response\",\n        url.toString(),\n      );\n    }\n\n    if (!hasResponseShape<T>(body, responseShape)) {\n      throw new VexEventsResponseError(\n        `VEX Events API returned an invalid response for ${path}`,\n        url.toString(),\n      );\n    }\n\n    return body;\n  }\n}\n\nfunction eventEntries(options: ListEventsOptions): QueryEntry[] {\n  return [\n    ...paginationEntries(options),\n    [\"id[]\", options.ids],\n    [\"sku[]\", options.skus],\n    [\"team[]\", options.teams],\n    [\"season[]\", options.seasons],\n    [\"start\", options.start],\n    [\"end\", options.end],\n    [\"region\", options.region],\n    [\"level[]\", options.levels],\n    [\"myEvents\", options.myEvents],\n    [\"eventTypes[]\", options.eventTypes],\n  ];\n}\n\nfunction eventTeamEntries(options: ListEventTeamsOptions): QueryEntry[] {\n  return [\n    ...paginationEntries(options),\n    [\"number[]\", options.numbers],\n    [\"registered\", options.registered],\n    [\"grade[]\", options.grades],\n    [\"country[]\", options.countries],\n    [\"myTeams\", options.myTeams],\n  ];\n}\n\nfunction eventSkillEntries(options: ListEventSkillsOptions): QueryEntry[] {\n  return [\n    ...paginationEntries(options),\n    [\"team[]\", options.teams],\n    [\"type[]\", options.types],\n  ];\n}\n\nfunction eventAwardEntries(options: ListEventAwardsOptions): QueryEntry[] {\n  return [\n    ...paginationEntries(options),\n    [\"team[]\", options.teams],\n    [\"winner[]\", options.winners],\n  ];\n}\n\nfunction divisionMatchEntries(\n  options: ListDivisionMatchesOptions,\n): QueryEntry[] {\n  return [\n    ...paginationEntries(options),\n    [\"team[]\", options.teams],\n    [\"round[]\", options.rounds],\n    [\"instance[]\", options.instances],\n    [\"matchnum[]\", options.matchNumbers],\n  ];\n}\n\nfunction divisionRankingEntries(\n  options: ListDivisionRankingsOptions,\n): QueryEntry[] {\n  return [\n    ...paginationEntries(options),\n    [\"team[]\", options.teams],\n    [\"rank[]\", options.ranks],\n  ];\n}\n\nfunction teamEntries(options: ListTeamsOptions): QueryEntry[] {\n  return [\n    ...paginationEntries(options),\n    [\"id[]\", options.ids],\n    [\"number[]\", options.numbers],\n    [\"event[]\", options.events],\n    [\"registered\", options.registered],\n    [\"program[]\", options.programs],\n    [\"grade[]\", options.grades],\n    [\"country[]\", options.countries],\n    [\"myTeams\", options.myTeams],\n  ];\n}\n\nfunction teamEventEntries(options: ListTeamEventsOptions): QueryEntry[] {\n  return [\n    ...paginationEntries(options),\n    [\"sku[]\", options.skus],\n    [\"season[]\", options.seasons],\n    [\"start\", options.start],\n    [\"end\", options.end],\n    [\"level[]\", options.levels],\n  ];\n}\n\nfunction teamMatchEntries(options: ListTeamMatchesOptions): QueryEntry[] {\n  return [\n    ...paginationEntries(options),\n    [\"event[]\", options.events],\n    [\"season[]\", options.seasons],\n    [\"round[]\", options.rounds],\n    [\"instance[]\", options.instances],\n    [\"matchnum[]\", options.matchNumbers],\n  ];\n}\n\nfunction teamRankingEntries(options: ListTeamRankingsOptions): QueryEntry[] {\n  return [\n    ...paginationEntries(options),\n    [\"event[]\", options.events],\n    [\"rank[]\", options.ranks],\n    [\"season[]\", options.seasons],\n  ];\n}\n\nfunction teamSkillEntries(options: ListTeamSkillsOptions): QueryEntry[] {\n  return [\n    ...paginationEntries(options),\n    [\"event[]\", options.events],\n    [\"type[]\", options.types],\n    [\"season[]\", options.seasons],\n  ];\n}\n\nfunction teamAwardEntries(options: ListTeamAwardsOptions): QueryEntry[] {\n  return [\n    ...paginationEntries(options),\n    [\"event[]\", options.events],\n    [\"season[]\", options.seasons],\n  ];\n}\n\nfunction seasonEntries(options: ListSeasonsOptions): QueryEntry[] {\n  return [\n    ...paginationEntries(options),\n    [\"id[]\", options.ids],\n    [\"program[]\", options.programs],\n    [\"team[]\", options.teams],\n    [\"start\", options.start],\n    [\"end\", options.end],\n    [\"active\", options.active],\n  ];\n}\n\nfunction seasonEventEntries(options: ListSeasonEventsOptions): QueryEntry[] {\n  return [\n    ...paginationEntries(options),\n    [\"sku[]\", options.skus],\n    [\"team[]\", options.teams],\n    [\"start\", options.start],\n    [\"end\", options.end],\n    [\"level[]\", options.levels],\n  ];\n}\n",
+    "import * as client from \"./client.js\";\nimport * as errors from \"./errors.js\";\n\nexport const VexEventsClient = client.VexEventsClient;\nexport const VexEventsApiError = errors.VexEventsApiError;\nexport const VexEventsResponseError = errors.VexEventsResponseError;\nexport type VexEventsClient = client.VexEventsClient;\nexport type VexEventsApiError = errors.VexEventsApiError;\nexport type VexEventsResponseError = errors.VexEventsResponseError;\nexport type {\n  EventsResource,\n  Fetch,\n  ProgramsResource,\n  RequestOptions,\n  SeasonsResource,\n  TeamsResource,\n  VexEventsClientOptions,\n} from \"./client.js\";\nexport type * from \"./types.js\";\n"
+  ],
+  "mappings": "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",
+  "debugId": "794DCB1DDF226CF164756E2164756E21",
+  "names": []
+}

package/dist/types.d.ts

@@ -0,0 +1,261 @@
+/** A value accepted by date filters. Strings must use RFC 3339 format. */
+export type DateInput = Date | string;
+export type EventType = "tournament" | "league" | "workshop" | "virtual";
+export type EventLevel = "World" | "National" | "Regional" | "State" | "Signature" | "Other";
+/** Event levels accepted by the API's event-list filters. */
+export type EventLevelFilter = Exclude<EventLevel, "Regional">;
+export type Grade = "College" | "High School" | "Middle School" | "Elementary School";
+export type SkillType = "driver" | "programming" | "package_delivery_time";
+/** Skill types accepted by the API's skills-list filters. */
+export type SkillTypeFilter = Exclude<SkillType, "package_delivery_time">;
+export interface Coordinates {
+    lat?: number;
+    lon?: number;
+}
+export interface Location {
+    venue?: string;
+    address_1?: string;
+    address_2?: string;
+    city?: string;
+    region?: string;
+    postcode?: string;
+    country?: string;
+    coordinates?: Coordinates;
+}
+export type NamedLocations = Record<string, Location>;
+export interface IdInfo {
+    id: number;
+    name: string;
+    code?: string | null;
+}
+export interface Division {
+    id?: number;
+    name?: string;
+    order?: number;
+}
+export interface Event {
+    id: number;
+    sku: string;
+    name: string;
+    start?: string;
+    end?: string;
+    season: IdInfo;
+    program: IdInfo;
+    location: Location;
+    locations?: NamedLocations[];
+    divisions?: Division[];
+    level?: EventLevel;
+    ongoing?: boolean;
+    awards_finalized?: boolean;
+    event_type?: EventType;
+}
+export interface Program {
+    id?: number;
+    abbr?: string;
+    name?: string;
+}
+export interface Team {
+    id: number;
+    number: string;
+    team_name?: string;
+    robot_name?: string;
+    organization?: string;
+    location?: Location;
+    registered?: boolean;
+    program: IdInfo;
+    grade?: Grade;
+}
+export interface AllianceTeam {
+    team?: IdInfo;
+    sitting?: boolean;
+}
+export interface Alliance {
+    color: "red" | "blue";
+    score: number;
+    teams: AllianceTeam[];
+}
+export interface Match {
+    id: number;
+    event: IdInfo;
+    division: IdInfo;
+    round: number;
+    instance: number;
+    matchnum: number;
+    scheduled?: string;
+    started?: string;
+    field?: string;
+    scored: boolean;
+    name: string;
+    alliances: Alliance[];
+}
+export interface Ranking {
+    id?: number;
+    event?: IdInfo;
+    division?: IdInfo;
+    rank?: number;
+    team?: IdInfo;
+    wins?: number;
+    losses?: number;
+    ties?: number;
+    wp?: number;
+    ap?: number;
+    sp?: number;
+    high_score?: number;
+    average_points?: number;
+    total_points?: number;
+}
+export interface Skill {
+    id?: number;
+    event?: IdInfo;
+    team?: IdInfo;
+    type?: SkillType;
+    season?: IdInfo;
+    division?: IdInfo;
+    rank?: number;
+    score?: number;
+    attempts?: number;
+}
+export interface TeamAwardWinner {
+    division?: IdInfo;
+    team?: IdInfo;
+}
+export interface Award {
+    id?: number;
+    event?: IdInfo;
+    order?: number;
+    title?: string;
+    qualifications?: string[];
+    designation?: "tournament" | "division" | null;
+    classification?: "champion" | "finalist" | "semifinalist" | "quarterfinalist" | null;
+    teamWinners?: TeamAwardWinner[];
+    individualWinners?: string[];
+}
+export interface Season {
+    id?: number;
+    name?: string;
+    program?: IdInfo;
+    start?: string;
+    end?: string;
+    years_start?: number;
+    years_end?: number;
+}
+export interface ApiErrorBody {
+    code?: number;
+    message?: string;
+}
+export interface PageMeta {
+    current_page?: number;
+    first_page_url?: string;
+    from?: number | null;
+    last_page?: number;
+    last_page_url?: string;
+    next_page_url?: string | null;
+    path?: string;
+    per_page?: number;
+    prev_page_url?: string | null;
+    to?: number | null;
+    total?: number;
+}
+export interface PaginatedResponse<T> {
+    meta?: PageMeta;
+    data?: T[];
+}
+export interface PaginationOptions {
+    /** One-indexed page number. */
+    page?: number;
+    /** Number of results per page. The API maximum is 250. */
+    perPage?: number;
+}
+export interface ListEventsOptions extends PaginationOptions {
+    ids?: readonly number[];
+    skus?: readonly string[];
+    teams?: readonly number[];
+    seasons?: readonly number[];
+    start?: DateInput;
+    end?: DateInput;
+    region?: string;
+    levels?: readonly EventLevelFilter[];
+    myEvents?: boolean;
+    eventTypes?: readonly EventType[];
+}
+export interface ListEventTeamsOptions extends PaginationOptions {
+    numbers?: readonly string[];
+    registered?: boolean;
+    grades?: readonly Grade[];
+    countries?: readonly string[];
+    myTeams?: boolean;
+}
+export interface ListEventSkillsOptions extends PaginationOptions {
+    teams?: readonly number[];
+    types?: readonly SkillTypeFilter[];
+}
+export interface ListEventAwardsOptions extends PaginationOptions {
+    teams?: readonly number[];
+    winners?: readonly string[];
+}
+export interface ListDivisionMatchesOptions extends PaginationOptions {
+    teams?: readonly number[];
+    rounds?: readonly number[];
+    instances?: readonly number[];
+    matchNumbers?: readonly number[];
+}
+export interface ListDivisionRankingsOptions extends PaginationOptions {
+    teams?: readonly number[];
+    ranks?: readonly number[];
+}
+export interface ListTeamsOptions extends PaginationOptions {
+    ids?: readonly number[];
+    numbers?: readonly string[];
+    events?: readonly number[];
+    registered?: boolean;
+    programs?: readonly number[];
+    grades?: readonly Grade[];
+    countries?: readonly string[];
+    myTeams?: boolean;
+}
+export interface ListTeamEventsOptions extends PaginationOptions {
+    skus?: readonly string[];
+    seasons?: readonly number[];
+    start?: DateInput;
+    end?: DateInput;
+    levels?: readonly EventLevelFilter[];
+}
+export interface ListTeamMatchesOptions extends PaginationOptions {
+    events?: readonly number[];
+    seasons?: readonly number[];
+    rounds?: readonly number[];
+    instances?: readonly number[];
+    matchNumbers?: readonly number[];
+}
+export interface ListTeamRankingsOptions extends PaginationOptions {
+    events?: readonly number[];
+    ranks?: readonly number[];
+    seasons?: readonly number[];
+}
+export interface ListTeamSkillsOptions extends PaginationOptions {
+    events?: readonly number[];
+    types?: readonly SkillTypeFilter[];
+    seasons?: readonly number[];
+}
+export interface ListTeamAwardsOptions extends PaginationOptions {
+    events?: readonly number[];
+    seasons?: readonly number[];
+}
+export interface ListProgramsOptions extends PaginationOptions {
+    ids?: readonly number[];
+}
+export interface ListSeasonsOptions extends PaginationOptions {
+    ids?: readonly number[];
+    programs?: readonly number[];
+    teams?: readonly number[];
+    start?: DateInput;
+    end?: DateInput;
+    active?: boolean;
+}
+export interface ListSeasonEventsOptions extends PaginationOptions {
+    skus?: readonly string[];
+    teams?: readonly number[];
+    start?: DateInput;
+    end?: DateInput;
+    levels?: readonly EventLevelFilter[];
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@v5x/events",
+  "version": "0.1.1",
+  "description": "Strictly typed TypeScript client for the VEX Events API",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "bun run clean && bun run build:dts && bun run build:esm",
+    "build:esm": "bun build ./src/index.ts --target browser --format esm --sourcemap=linked --outdir ./dist --entry-naming=index.js",
+    "build:dts": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint src --type-aware",
+    "test": "bun test",
+    "prepack": "bun run build",
+    "clean": "rm -rf dist"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/v5x-dev/v5x.git",
+    "directory": "packages/events"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "vex",
+    "vex-robotics",
+    "robotics",
+    "events",
+    "api",
+    "typescript"
+  ],
+  "author": "qainguin <slimaster14@gmail.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/v5x-dev/v5x/issues"
+  },
+  "homepage": "https://docs.v5x.dev/events/overview",
+  "devDependencies": {
+    "@types/bun": "latest"
+  }
+}