@tacocarlos/luna-cs-uil 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Carlos Luna
+
+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

@@ -1,3 +1,51 @@
-# Temporary Holding Version
+# @tacocarlos/luna-cs-uil
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+TypeScript client for the UIL Computer Science problems API at `https://api.lunaghs.dev`: past contests' competitions, problems, statements and judge data.
+
+> **Unofficial.** This project is not affiliated with or endorsed by the University Interscholastic League (UIL).
+
+## Install
+
+```sh
+npm install @tacocarlos/luna-cs-uil
+```
+
+Works anywhere `fetch` is available (Node 18+, Bun, Deno, browsers).
+
+## Usage
+
+```ts
+import { LunaCsUilClient } from "@tacocarlos/luna-cs-uil";
+
+const client = new LunaCsUilClient();
+
+const competitions = await client.competitions.getAllCompetitions();
+const problems = await client.competitions.getCompetitionProblems({ id: competitions[0].id });
+
+// The statement as markdown, with figure links pointing at their images.
+const statement = await client.getProblemStatement(problems[0].id);
+```
+
+`client.problems`, `client.competitions` and `client.meta` expose every endpoint. Failed requests throw `ResponseError`; a missing problem or competition is a 404:
+
+```ts
+import { ResponseError } from "@tacocarlos/luna-cs-uil";
+
+try {
+  await client.problems.getProblemById({ id: 123 });
+} catch (error) {
+  if (error instanceof ResponseError && error.response.status === 404) {
+    // no such problem
+  }
+}
+```
+
+Options: `new LunaCsUilClient({ baseUrl, fetch })`. `baseUrl` is the API origin without `/api`.
+
+## Figures
+
+Statements refer to figures by placeholder, e.g. `![Figure 1](uil-cs-api-figure:1)`, and `getProblemMarkdownById` returns each placeholder's current URL in `images`. Image URLs can change, so resolve them when you render rather than storing them. `getProblemStatement` does this for you, or call `resolveFigures(markdown, images)` yourself. Placeholders without an image are left unchanged.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

package/dist/client.d.ts

@@ -0,0 +1,29 @@
+import { CompetitionApi, MetaApi, ProblemApi } from "./generated/index.js";
+/** Where the API is hosted. */
+export declare const DEFAULT_BASE_URL = "https://api.lunaghs.dev";
+export interface LunaCsUilClientOptions {
+    /** API origin, without the `/api` prefix. Defaults to {@link DEFAULT_BASE_URL}. */
+    baseUrl?: string;
+    /** `fetch` implementation to use, e.g. for tests or older runtimes. */
+    fetch?: typeof fetch;
+}
+/**
+ * Client for the UIL CS problems API.
+ *
+ * ```ts
+ * const client = new LunaCsUilClient();
+ * const competitions = await client.competitions.getAllCompetitions();
+ * const statement = await client.getProblemStatement(competitions[0].id);
+ * ```
+ */
+export declare class LunaCsUilClient {
+    readonly problems: ProblemApi;
+    readonly competitions: CompetitionApi;
+    readonly meta: MetaApi;
+    constructor(options?: LunaCsUilClientOptions);
+    /**
+     * A problem's statement as markdown, with figure placeholders replaced by
+     * their current image URLs.
+     */
+    getProblemStatement(id: number): Promise<string>;
+}

package/dist/client.js

@@ -0,0 +1,38 @@
+import { CompetitionApi, Configuration, MetaApi, ProblemApi, } from "./generated/index.js";
+import { resolveFigures } from "./figures.js";
+/** Where the API is hosted. */
+export const DEFAULT_BASE_URL = "https://api.lunaghs.dev";
+/**
+ * Client for the UIL CS problems API.
+ *
+ * ```ts
+ * const client = new LunaCsUilClient();
+ * const competitions = await client.competitions.getAllCompetitions();
+ * const statement = await client.getProblemStatement(competitions[0].id);
+ * ```
+ */
+export class LunaCsUilClient {
+    problems;
+    competitions;
+    meta;
+    constructor(options = {}) {
+        const configuration = new Configuration({
+            basePath: (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, ""),
+            fetchApi: options.fetch,
+        });
+        this.problems = new ProblemApi(configuration);
+        this.competitions = new CompetitionApi(configuration);
+        this.meta = new MetaApi(configuration);
+    }
+    /**
+     * A problem's statement as markdown, with figure placeholders replaced by
+     * their current image URLs.
+     */
+    async getProblemStatement(id) {
+        const { markdown, images } = await this.problems.getProblemMarkdownById({
+            id,
+        });
+        return resolveFigures(markdown, images);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,aAAa,EACb,OAAO,EACP,UAAU,GACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,+BAA+B;AAC/B,MAAM,CAAC,MAAM,gBAAgB,GAAG,yBAAyB,CAAC;AAS1D;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAe;IACjB,QAAQ,CAAa;IACrB,YAAY,CAAiB;IAC7B,IAAI,CAAU;IAEvB,YAAY,UAAkC,EAAE;QAC9C,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC;YACtC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACnE,QAAQ,EAAE,OAAO,CAAC,KAAK;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,IAAI,UAAU,CAAC,aAAa,CAAC,CAAC;QAC9C,IAAI,CAAC,YAAY,GAAG,IAAI,cAAc,CAAC,aAAa,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CAAC,EAAU;QAClC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACtE,EAAE;SACH,CAAC,CAAC;QACH,OAAO,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/dist/figures.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Problem statements refer to figures by placeholder, e.g.
+ * `![Figure 1](uil-cs-api-figure:1)`, and the API returns the current URL for
+ * each placeholder alongside the markdown. URLs can change when the server
+ * moves its storage, so resolve them when rendering instead of saving them.
+ */
+/**
+ * Returns `markdown` with every figure placeholder that `images` knows replaced
+ * by its URL. Placeholders without a URL are left as they are, so a renderer
+ * can show them as missing.
+ *
+ * Only link targets are replaced (`](placeholder)`); the placeholder format
+ * itself is the server's business, so nothing here depends on it.
+ */
+export declare function resolveFigures(markdown: string, images: Readonly<Record<string, string>>): string;

package/dist/figures.js

@@ -0,0 +1,22 @@
+/**
+ * Problem statements refer to figures by placeholder, e.g.
+ * `![Figure 1](uil-cs-api-figure:1)`, and the API returns the current URL for
+ * each placeholder alongside the markdown. URLs can change when the server
+ * moves its storage, so resolve them when rendering instead of saving them.
+ */
+/**
+ * Returns `markdown` with every figure placeholder that `images` knows replaced
+ * by its URL. Placeholders without a URL are left as they are, so a renderer
+ * can show them as missing.
+ *
+ * Only link targets are replaced (`](placeholder)`); the placeholder format
+ * itself is the server's business, so nothing here depends on it.
+ */
+export function resolveFigures(markdown, images) {
+    let resolved = markdown;
+    for (const [placeholder, url] of Object.entries(images)) {
+        resolved = resolved.split(`](${placeholder})`).join(`](${url})`);
+    }
+    return resolved;
+}
+//# sourceMappingURL=figures.js.map

package/dist/figures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figures.js","sourceRoot":"","sources":["../src/figures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,MAAwC;IAExC,IAAI,QAAQ,GAAG,QAAQ,CAAC;IACxB,KAAK,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/generated/apis/CompetitionApi.d.ts

@@ -0,0 +1,77 @@
+/**
+ * UIL CS API
+ * Public API for UIL Computer Science competitions and problems.
+ *
+ * The version of the OpenAPI document: 0.0.1
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import * as runtime from '../runtime.js';
+import { type Competition } from '../models/Competition.js';
+import { type Problem } from '../models/Problem.js';
+export interface GetAllCompetitionsRequest {
+    /**
+     *
+     */
+    limit?: number;
+    /**
+     *
+     */
+    offset?: number;
+}
+export interface GetCompetitionByIdRequest {
+    /**
+     *
+     */
+    id: number;
+}
+export interface GetCompetitionProblemsRequest {
+    /**
+     *
+     */
+    id: number;
+}
+/**
+ *
+ */
+export declare class CompetitionApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for getAllCompetitions without sending the request
+     */
+    getAllCompetitionsRequestOpts(requestParameters: GetAllCompetitionsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Returns a list of all competitions
+     */
+    getAllCompetitionsRaw(requestParameters: GetAllCompetitionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<Competition>>>;
+    /**
+     * Returns a list of all competitions
+     */
+    getAllCompetitions(requestParameters?: GetAllCompetitionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<Competition>>;
+    /**
+     * Creates request options for getCompetitionById without sending the request
+     */
+    getCompetitionByIdRequestOpts(requestParameters: GetCompetitionByIdRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Get competition data
+     */
+    getCompetitionByIdRaw(requestParameters: GetCompetitionByIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Competition>>;
+    /**
+     * Get competition data
+     */
+    getCompetitionById(requestParameters: GetCompetitionByIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Competition>;
+    /**
+     * Creates request options for getCompetitionProblems without sending the request
+     */
+    getCompetitionProblemsRequestOpts(requestParameters: GetCompetitionProblemsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Returns all problems for a given competition
+     */
+    getCompetitionProblemsRaw(requestParameters: GetCompetitionProblemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<Problem>>>;
+    /**
+     * Returns all problems for a given competition
+     */
+    getCompetitionProblems(requestParameters: GetCompetitionProblemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<Problem>>;
+}

package/dist/generated/apis/CompetitionApi.js

@@ -0,0 +1,123 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * UIL CS API
+ * Public API for UIL Computer Science competitions and problems.
+ *
+ * The version of the OpenAPI document: 0.0.1
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import * as runtime from '../runtime.js';
+import { CompetitionFromJSON, } from '../models/Competition.js';
+import { ProblemFromJSON, } from '../models/Problem.js';
+/**
+ *
+ */
+export class CompetitionApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for getAllCompetitions without sending the request
+     */
+    async getAllCompetitionsRequestOpts(requestParameters) {
+        const queryParameters = {};
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+        if (requestParameters['offset'] != null) {
+            queryParameters['offset'] = requestParameters['offset'];
+        }
+        const headerParameters = {};
+        let urlPath = `/api/competition`;
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Returns a list of all competitions
+     */
+    async getAllCompetitionsRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.getAllCompetitionsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(CompetitionFromJSON));
+    }
+    /**
+     * Returns a list of all competitions
+     */
+    async getAllCompetitions(requestParameters = {}, initOverrides) {
+        const response = await this.getAllCompetitionsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for getCompetitionById without sending the request
+     */
+    async getCompetitionByIdRequestOpts(requestParameters) {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling getCompetitionById().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        let urlPath = `/api/competition/{id}`;
+        urlPath = urlPath.replace('{id}', encodeURIComponent(String(requestParameters['id'])));
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Get competition data
+     */
+    async getCompetitionByIdRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.getCompetitionByIdRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => CompetitionFromJSON(jsonValue));
+    }
+    /**
+     * Get competition data
+     */
+    async getCompetitionById(requestParameters, initOverrides) {
+        const response = await this.getCompetitionByIdRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for getCompetitionProblems without sending the request
+     */
+    async getCompetitionProblemsRequestOpts(requestParameters) {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling getCompetitionProblems().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        let urlPath = `/api/competition/{id}/problems`;
+        urlPath = urlPath.replace('{id}', encodeURIComponent(String(requestParameters['id'])));
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Returns all problems for a given competition
+     */
+    async getCompetitionProblemsRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.getCompetitionProblemsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(ProblemFromJSON));
+    }
+    /**
+     * Returns all problems for a given competition
+     */
+    async getCompetitionProblems(requestParameters, initOverrides) {
+        const response = await this.getCompetitionProblemsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+}
+//# sourceMappingURL=CompetitionApi.js.map

package/dist/generated/apis/CompetitionApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompetitionApi.js","sourceRoot":"","sources":["../../../src/generated/apis/CompetitionApi.ts"],"names":[],"mappings":"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"}

package/dist/generated/apis/MetaApi.d.ts

@@ -0,0 +1,29 @@
+/**
+ * UIL CS API
+ * Public API for UIL Computer Science competitions and problems.
+ *
+ * The version of the OpenAPI document: 0.0.1
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import * as runtime from '../runtime.js';
+/**
+ *
+ */
+export declare class MetaApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for getVersion without sending the request
+     */
+    getVersionRequestOpts(): Promise<runtime.RequestOpts>;
+    /**
+     * Returns the API version
+     */
+    getVersionRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<string>>;
+    /**
+     * Returns the API version
+     */
+    getVersion(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<string>;
+}

package/dist/generated/apis/MetaApi.js

@@ -0,0 +1,54 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * UIL CS API
+ * Public API for UIL Computer Science competitions and problems.
+ *
+ * The version of the OpenAPI document: 0.0.1
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import * as runtime from '../runtime.js';
+/**
+ *
+ */
+export class MetaApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for getVersion without sending the request
+     */
+    async getVersionRequestOpts() {
+        const queryParameters = {};
+        const headerParameters = {};
+        let urlPath = `/api/version`;
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Returns the API version
+     */
+    async getVersionRaw(initOverrides) {
+        const requestOptions = await this.getVersionRequestOpts();
+        const response = await this.request(requestOptions, initOverrides);
+        if (this.isJsonMime(response.headers.get('content-type'))) {
+            return new runtime.JSONApiResponse(response);
+        }
+        else {
+            return new runtime.TextApiResponse(response);
+        }
+    }
+    /**
+     * Returns the API version
+     */
+    async getVersion(initOverrides) {
+        const response = await this.getVersionRaw(initOverrides);
+        return await response.value();
+    }
+}
+//# sourceMappingURL=MetaApi.js.map

package/dist/generated/apis/MetaApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetaApi.js","sourceRoot":"","sources":["../../../src/generated/apis/MetaApi.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,oBAAoB;AACpB;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,OAAO,CAAC,OAAO;IAExC;;OAEG;IACH,KAAK,CAAC,qBAAqB;QACvB,MAAM,eAAe,GAAQ,EAAE,CAAC;QAEhC,MAAM,gBAAgB,GAAwB,EAAE,CAAC;QAGjD,IAAI,OAAO,GAAG,cAAc,CAAC;QAE7B,OAAO;YACH,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,gBAAgB;YACzB,KAAK,EAAE,eAAe;SACzB,CAAC;IACN,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,aAA0D;QAC1E,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;QAEnE,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;YACxD,OAAO,IAAI,OAAO,CAAC,eAAe,CAAS,QAAQ,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACJ,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAQ,CAAC;QACxD,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,aAA0D;QACvE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;QACzD,OAAO,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC;CAEJ"}

package/dist/generated/apis/ProblemApi.d.ts

@@ -0,0 +1,84 @@
+/**
+ * UIL CS API
+ * Public API for UIL Computer Science competitions and problems.
+ *
+ * The version of the OpenAPI document: 0.0.1
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import * as runtime from '../runtime.js';
+import { type Problem } from '../models/Problem.js';
+import { type ProblemMarkdown } from '../models/ProblemMarkdown.js';
+import { type ShortProblem } from '../models/ShortProblem.js';
+export interface GetAllProblemsRequest {
+    /**
+     *
+     */
+    limit?: number;
+    /**
+     *
+     */
+    offset?: number;
+}
+export interface GetProblemByIdRequest {
+    /**
+     *
+     */
+    id: number;
+}
+export interface GetProblemMarkdownByIdRequest {
+    /**
+     *
+     */
+    id: number;
+}
+/**
+ *
+ */
+export declare class ProblemApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for getAllProblems without sending the request
+     */
+    getAllProblemsRequestOpts(requestParameters: GetAllProblemsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Returns the id, competition id, name, and problem number for all problems. If a limit or offset are provided, then they are used.
+     * Returns minimal data for all problems, or up to a limit if specified
+     */
+    getAllProblemsRaw(requestParameters: GetAllProblemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<ShortProblem>>>;
+    /**
+     * Returns the id, competition id, name, and problem number for all problems. If a limit or offset are provided, then they are used.
+     * Returns minimal data for all problems, or up to a limit if specified
+     */
+    getAllProblems(requestParameters?: GetAllProblemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<ShortProblem>>;
+    /**
+     * Creates request options for getProblemById without sending the request
+     */
+    getProblemByIdRequestOpts(requestParameters: GetProblemByIdRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Retrieves the data for a single problem.
+     * Get all problem data by id
+     */
+    getProblemByIdRaw(requestParameters: GetProblemByIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Problem>>;
+    /**
+     * Retrieves the data for a single problem.
+     * Get all problem data by id
+     */
+    getProblemById(requestParameters: GetProblemByIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Problem>;
+    /**
+     * Creates request options for getProblemMarkdownById without sending the request
+     */
+    getProblemMarkdownByIdRequestOpts(requestParameters: GetProblemMarkdownByIdRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Returns the problem statement and the URLs of its figures. The markdown refers to each figure by placeholder; substitute the URL from `images` when rendering.
+     * Get problem markdown by id
+     */
+    getProblemMarkdownByIdRaw(requestParameters: GetProblemMarkdownByIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ProblemMarkdown>>;
+    /**
+     * Returns the problem statement and the URLs of its figures. The markdown refers to each figure by placeholder; substitute the URL from `images` when rendering.
+     * Get problem markdown by id
+     */
+    getProblemMarkdownById(requestParameters: GetProblemMarkdownByIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ProblemMarkdown>;
+}