riotapi-fetch-typed 1.1.4-dev → 1.2.1-dev

package/README.md

@@ -1,109 +1,110 @@
-<a href="https://github.com/TournamentStats/riotapi-fetch-typed/actions/workflows/test.yml"><img src="https://github.com/TournamentStats/riotapi-fetch-typed/actions/workflows/test.yml/badge.svg" alt="test workflow"></a>
-<a href="https://www.npmjs.com/package/riotapi-fetch-typed"><img src="https://img.shields.io/npm/v/riotapi-fetch-typed.svg" alt="npm registry"></a>
-
-# riotapi-fetch-typed
-
-Fetch the Riot Games API with type safety, thanks to the OpenAPI specification.
-
-## Features
-
-- Just a thin wrapper around fetch
-- (Almost) Fully Type-safe
-  - Regions (based on API Route)
-  - API Routes
-  - HTTP Methods
-  - Request Body
-  - Response Body
-  - Errors
-- Almost instant updates with zero maintenance, Updates on the API just need a regeneration of the src/types/openapi.d.ts file using `openapi-typescript`
-- supports all endpoints that are in the [OpenAPI specification](https://github.com/MingweiSamuel/riotapi-schema)
-
-## Usage
-
-### Without Error throwing
-
-```typescript
-import { createRiotFetch } from "riotapi-fetch-typed";
-
-const riotFetch = createRiotFetch({ apiKey: process.env.RIOT_API_KEY! });
-
-const puuid =
-  "Zz2sEt4n_mfS37AyXSqXnNw4eXDHHRfsYXD2FQb7jOLIrttOjtIe88cu_fKqwkPVgCSc_4slSNSrbg";
-// theoretically the route could support autofill, but current vscode typescript language doesn't support it, sadge. See below for issues
-const { response, data, error } = await riotFetch(
-  `/riot/account/v1/accounts/by-puuid/${puuid}`,
-  {
-    region: "europe", // type-safe
-  }
-);
-
-if (!error) {
-  const { gameName, tagLine } = data;
-}
-```
-
-### With Error throwing
-
-```typescript
-const riotFetch = createRiotFetch({
-  apiKey: process.env.RIOT_API_KEY!,
-  throwOnResponseError: true,
-});
-
-try {
-  const { response, data } = await riotFetch("/lol/tournament/v5/codes", {
-    region: "europe",
-    method: "post", // also type-safe
-    body: {
-      enoughPlayers: false,
-      mapType: "SUMMONERS_RIFT",
-      pickType: "TOURNAMENT_DRAFT",
-      spectatorType: "ALL",
-      teamSize: 5,
-    }, // body is also fully typed and annotated (if exists)
-  });
-  const tournamentCodes = data;
-} catch (e: unknown) {
-  if (e instanceof RiotError) {
-    console.error(e.statusCode, e.data);
-  }
-}
-```
-
-## Installation
-
-Install it using your package manager:
-
-```bash
-$ npm install riot-games-fetch-typed
-# or
-$ pnpm install riot-games-fetch-typed
-# or
-$ yarn install riot-games-fetch-typed
-# or
-$ bun install riot-games-fetch-typed
-```
-
-## Autocomplete related issues
-
-This library would be much more DX-friendly if typescript could autocomplete / give suggestions for template literal types. I think in theory
-this could be possible, but in reality I have no clue if the typescript eco-system would allow something like that.
-
-Issues/PRs i found that maybe relates to the autocompletion of template literals.
-
-- https://github.com/microsoft/TypeScript/issues/57902
-- https://github.com/microsoft/TypeScript/pull/59794
-- https://github.com/microsoft/TypeScript/issues/61217
-
-## How it works
-
-This module uses the `openapi-typescript` module to generate typescript data from the Riot API OpenAPI Specification, that itself is generated from the officially documentation. Huge thanks to [Mingwei Samuel](https://github.com/MingweiSamuel) who provides them at https://github.com/MingweiSamuel/riotapi-schema. With these type information, typescript's flexible typing system including template literals and type infering, we can infer the type of response and method and applicable regions from the fetch parameters.
-
-## Contributing
-
-Feel free to contribute.
-
-## This also exist
-
-- https://openapi-ts.dev/openapi-fetch/
-  - Much more feature complete, riotapi-fetch-typed is tailored for the Riot API and would require much more work to be as general as openapi-fetch
+<a href="https://github.com/TournamentStats/riotapi-fetch-typed/actions/workflows/test.yml"><img src="https://github.com/TournamentStats/riotapi-fetch-typed/actions/workflows/test.yml/badge.svg" alt="test workflow"></a>
+<a href="https://www.npmjs.com/package/riotapi-fetch-typed"><img src="https://img.shields.io/npm/v/riotapi-fetch-typed.svg" alt="npm registry"></a>
+
+# riotapi-fetch-typed
+
+Fetch the Riot Games API with type safety, thanks to the OpenAPI specification.
+
+## Features
+
+- Just a thin wrapper around fetch
+- (Almost) Fully Type-safe
+  - Regions (based on API Route)
+  - API Routes
+  - HTTP Methods
+  - Request Body
+  - Query Parameters
+  - Response Body
+  - Errors
+- Almost instant updates with zero maintenance, Updates on the API just need a regeneration of the src/types/openapi.d.ts file using `openapi-typescript`
+- supports all endpoints that are in the [OpenAPI specification](https://github.com/MingweiSamuel/riotapi-schema)
+
+## Usage
+
+### Without Error throwing
+
+```typescript
+import { createRiotFetch } from "riotapi-fetch-typed";
+
+const riotFetch = createRiotFetch({ apiKey: process.env.RIOT_API_KEY! });
+
+const puuid =
+  "Zz2sEt4n_mfS37AyXSqXnNw4eXDHHRfsYXD2FQb7jOLIrttOjtIe88cu_fKqwkPVgCSc_4slSNSrbg";
+// theoretically the route could support autofill, but current vscode typescript language doesn't support it, sadge. See below for issues
+const { response, data, error } = await riotFetch(
+  `/riot/account/v1/accounts/by-puuid/${puuid}`,
+  {
+    region: "europe", // type-safe
+  }
+);
+
+if (!error) {
+  const { gameName, tagLine } = data;
+}
+```
+
+### With Error throwing
+
+```typescript
+const riotFetch = createRiotFetch({
+  apiKey: process.env.RIOT_API_KEY!,
+  throwOnResponseError: true,
+});
+
+try {
+  const { response, data } = await riotFetch("/lol/tournament/v5/codes", {
+    region: "europe",
+    method: "post", // also type-safe
+    body: {
+      enoughPlayers: false,
+      mapType: "SUMMONERS_RIFT",
+      pickType: "TOURNAMENT_DRAFT",
+      spectatorType: "ALL",
+      teamSize: 5,
+    }, // body is also fully typed and annotated (if exists)
+  });
+  const tournamentCodes = data;
+} catch (e: unknown) {
+  if (e instanceof RiotError) {
+    console.error(e.statusCode, e.data);
+  }
+}
+```
+
+## Installation
+
+Install it using your package manager:
+
+```bash
+$ npm install riot-games-fetch-typed
+# or
+$ pnpm install riot-games-fetch-typed
+# or
+$ yarn install riot-games-fetch-typed
+# or
+$ bun install riot-games-fetch-typed
+```
+
+## Autocomplete related issues
+
+This library would be much more DX-friendly if typescript could autocomplete / give suggestions for template literal types. I think in theory
+this could be possible, but in reality I have no clue if the typescript eco-system would allow something like that.
+
+Issues/PRs i found that maybe relates to the autocompletion of template literals.
+
+- https://github.com/microsoft/TypeScript/issues/57902
+- https://github.com/microsoft/TypeScript/pull/59794
+- https://github.com/microsoft/TypeScript/issues/61217
+
+## How it works
+
+This module uses the `openapi-typescript` module to generate typescript data from the Riot API OpenAPI Specification, that itself is generated from the officially documentation. Huge thanks to [Mingwei Samuel](https://github.com/MingweiSamuel) who provides them at https://github.com/MingweiSamuel/riotapi-schema. With these type information, typescript's flexible typing system including template literals and type infering, we can infer the type of response and method and applicable regions from the fetch parameters.
+
+## Contributing
+
+Feel free to contribute.
+
+## This also exist
+
+- https://openapi-ts.dev/openapi-fetch/
+  - Much more feature complete, riotapi-fetch-typed is tailored for the Riot API and would require much more work to be as general as openapi-fetch

package/dist/index.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  Queues: () => Queues,
   RiotError: () => RiotError,
   createRiotFetch: () => createRiotFetch
 });
@@ -61,10 +62,11 @@ function createRiotFetch({
   defaultOptions.headers = headers;
   return async (request, options) => {
     const baseURL = baseUrl(options.region);
-    let req = new URL(request, baseURL).toString();
+    const req = new URL(request, baseURL);
     if (options.query) {
-      const query = Object.entries(options.query).map(([key, value]) => [key, String(value)]);
-      req += new URLSearchParams(query).toString();
+      for (const [key, value] of Object.entries(options.query)) {
+        req.searchParams.set(key, String(value));
+      }
     }
     const response = await fetchFn(req, {
       ...defaultOptions,
@@ -93,8 +95,45 @@ function createRiotFetch({
     };
   };
 }
+var Queues = {
+  CUSTOM: 0,
+  HEXAKILL: 75,
+  URF: [76, 1900],
+  AR_URF: 900,
+  ARAM: {
+    BUTCHERS_BRIDGE: 100,
+    HOWLING_ABYSS: 450,
+    ALL: [100, 450]
+  },
+  ALL_RANDOM: 325,
+  BLIND: 430,
+  DRAFT: 400,
+  QUICKPLAY: 490,
+  RANKED_SOLO: 420,
+  RANKED_FLEX: 440,
+  CLASH: {
+    SUMMONERS_RIFT: 700,
+    HOWLING_ABYSS: 720,
+    ARAM: 720,
+    ALL: [700, 720]
+  },
+  COOP_VS_AI: {
+    INTRO: 870,
+    BEGINNER: 880,
+    INTERMEDIATE: 890,
+    ALL: [870, 880, 890]
+  },
+  DOOM_BOTS: 960,
+  ONE_FOR_ALL: 1020,
+  NEXUS_BLITZ: 1300,
+  SPELLBOOK: 1400,
+  ARENA: [1700, 1710],
+  SWARM: [1810, 1820, 1830, 1840],
+  TUTORIAL: [2e3, 2010, 2020]
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  Queues,
   RiotError,
   createRiotFetch
 });

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { paths, components } from './types/openapi.d.js';\n\nexport * from './types/openapi.d.js';\n\n\n/** Every possible API path, based on the OpenAPI document */\nexport type Paths = keyof paths;\n\n/**\n * Type util that replaces all occurences of curly brackets pairs in a string literal type to string placeholders,\n * resulting in a template literal type. For that it recursively tests the string for curly bracket pairs.\n *\n * @example TemplatifyPath<'summoner/{summonerName}/ranked'> -> `summoner/${string}/ranked`\n */\nexport type TemplatifyPath<Path extends string> =\n\tPath extends `${infer Start}/{${string}}${infer End}`\n\t\t? `${Start}/${string}${TemplatifyPath<End>}`\n\t\t: Path;\n\n\n/** Every possible API path, but templatified */\nexport type TemplatePaths = TemplatifyPath<Paths>;\n\n/** Splits a Path by `/` into an array */\nexport type SplitPath<Path extends string> = Path extends `${infer Head}/${infer Tail}`\n\t? [Head, ...SplitPath<Tail>]\n\t: [Path];\n\n/**\n * Compares two splitted paths.\n *\n * Type is true if both splitted paths have the same length and every segment of Concrete extends its corresponding segment Template\n * */\nexport type MatchSegments<Template extends string[], Concrete extends string[]> =\n  Template extends [infer TemplateSegment, ...infer TemplateRest]\n  \t? Concrete extends [infer ConcreteSegment, ...infer ConcreteRest]\n  \t\t? ConcreteSegment extends TemplateSegment\n  \t\t\t? TemplateRest extends string[]\n  \t\t\t\t? ConcreteRest extends string[]\n  \t\t\t\t\t? MatchSegments<TemplateRest, ConcreteRest>\n  \t\t\t\t\t: never\n  \t\t\t\t: never\n  \t\t\t: false\n  \t\t: Concrete extends []\n  \t\t\t? Template extends []\n  \t\t\t\t? true\n  \t\t\t\t: false\n  \t\t\t: false\n  \t: Template extends []\n  \t\t? Concrete extends []\n  \t\t\t? true\n  \t\t\t: false\n  \t\t: false;\n\n/**\n * Gives all API Paths that matches the path. Basically the reverse operation of TemplatifyPath\n *\n * @example ResolveTemplatePath<`/riot/account/v1/accounts/by-puuid/${string}`>\n * -> \"/riot/account/v1/accounts/by-puuid/{puuid}\"\n *\n * @example ResolveTemplatePath<`/riot/account/v1/accounts/by-riot-id/gameName/gameTag`>\n * -> \"/riot/account/v1/accounts/by-riot-id/{gameName}/{tagLine}\"\n */\nexport type ResolveTemplatePath<Path extends TemplatePaths> = {\n\t[P in Paths]: MatchSegments<SplitPath<TemplatifyPath<P>>, SplitPath<Path>> extends true ? P : never\n}[Paths];\n\nexport type HTTPMethods = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace';\n\n/**\n * Get all available methods for a specific API path\n */\nexport type Methods<Path extends Paths> = Exclude<keyof {\n\t[K in keyof paths[Path] as paths[Path][K] extends undefined ? never : K]: paths[Path][K]\n}, 'parameters'>;\n\n/** Get all possible responses for a specific API path and method */\nexport type GetResponses<Path extends Paths, Method extends Methods<Path>> =\n\tpaths[Path][Method] extends { responses: infer Responses }\n\t\t? Responses\n\t\t: never;\n\n\n/** Get the response body for a specific API path, method and status code */\nexport type GetResponseBody<Path extends Paths, Method extends Methods<Path>, StatusCode extends number> =\n\tGetResponses<Path, Method> extends Record<StatusCode, { content?: { 'application/json': infer Body } }>\n\t\t? Body\n\t\t: never;\n\n\nexport type GetRequestBody<Path extends Paths, Method extends Methods<Path>> =\n  paths[Path][Method] extends { requestBody?: never }\n  \t? { body?: never }\n  \t: paths[Path][Method] extends { requestBody: { content: { 'application/json': infer U } } }\n  \t\t? { body: U }\n  \t\t: paths[Path][Method] extends { requestBody?: { content: { 'application/json': infer U } } }\n  \t\t\t? { body?: U }\n  \t\t\t: unknown;\n\n\n/** Get the query parameters for a specific API path and method */\nexport type GetQuery<Path extends Paths, Method extends Methods<Path>> =\n  Pick<paths[Path][Method]['parameters'], 'query'>;\n\n\n/** Regions for /riot/account/ endpoints */\nexport type AccountRegion =  'americas' | 'asia' | 'europe';\n/** Regions for some lol and tft endpoints */\nexport type LolRegion = 'br1' | 'eun1' | 'euw1' | 'jp1' | 'kr' | 'la1' | 'la2' | 'me1' | 'na1' | 'oc1' | 'ph2' | 'ru' | 'sg2' | 'th2' | 'tr1' | 'tw2' | 'vn2';\n/** Regions for lol and tft matches endpoints */\nexport type MatchRegion = 'americas' | 'asia' | 'europe' | 'sea';\n/** Regions for /lor/ endpoints */\nexport type LorRegion = 'americas' | 'europe' | 'sea';\n/** Regions for /val/ endpoints */\nexport type ValorantRegion = 'ap' | 'br' | 'eu' | 'latam' | 'na' | 'esports' | 'kr';\n\n\n/** Get the relevant subdomains, depending on the endpoint */\n// i dont like eslint indenting here\n/* eslint-disable @stylistic/indent */\nexport type GetSubdomain<Path extends TemplatePaths> =\n\tPath extends `/riot/account/${string}` ? AccountRegion :\n\tPath extends `/lol/champion-mastery/${string}` ? LolRegion :\n\tPath extends `/lol/platform/${string}` ? LolRegion :\n\tPath extends `/lol/clash/${string}` ? LolRegion :\n\tPath extends `/lol/league-exp/${string}` ? LolRegion :\n\tPath extends `/lol/league/${string}` ? LolRegion :\n\tPath extends `/lol/challenges/${string}` ? LolRegion :\n\tPath extends `/lol/rso-match/${string}` ? MatchRegion :\n\tPath extends `/lol/status/${string}` ? LolRegion :\n\tPath extends `/lor/deck/${string}` ? LorRegion :\n\tPath extends `/lor/inventory/${string}` ? LorRegion :\n\tPath extends `/lor/match/${string}` ? LorRegion | 'apac' :\n\tPath extends `/lor/ranked/${string}` ? LorRegion :\n\tPath extends `/lor/status/${string}` ? LorRegion :\n\tPath extends `/lol/match/${string}` ? MatchRegion :\n\tPath extends `/lol/spectator/${string}` ? LolRegion :\n\tPath extends `/fulfillment/${string}` ? LolRegion :\n\tPath extends `/lol/summoner/${string}` ? LolRegion :\n\tPath extends `/tft/league/${string}` ? LolRegion :\n\tPath extends `/tft/match/${string}` ? MatchRegion | 'esports' | 'esportseu' :\n\tPath extends `/tft/status/${string}` ? LolRegion :\n\tPath extends `/tft/summoner/${string}` ? LolRegion :\n\t// seems like only americas but not sure\n\tPath extends `/lol/tournament-stub/${string}` ? 'americas' :\n\t// don't know, can't see in api reference\n\tPath extends `/lol/tournament/${string}` ? LolRegion | MatchRegion :\n\t// The api docs do not include all regions for console, but for stability we will just include them\n\tPath extends `/val/match/console/${string}` ? ValorantRegion :\n\tPath extends `/val/console/ranked/${string}` ? ValorantRegion :\n\tPath extends `/val/content/${string}` ? ValorantRegion :\n\tPath extends `/val/match/${string}` ? ValorantRegion :\n\tPath extends `/val/ranked/${string}` ? ValorantRegion :\n\tPath extends `/val/status/${string}` ? Exclude<ValorantRegion, 'esports'>\n\t: never;\n/* eslint-enable @stylistic/indent */\n\n/** Typical structure for a RiotError json object. */\nexport type RiotErrorData = components['schemas']['Error'];\n\n/**\n * Error Class for a 4xx/5xx response code in a fetch to the Riot API\n */\nexport class RiotError extends Error {\n\tconstructor(message: string, statusCode: number, data?: RiotErrorData) {\n\t\tsuper(message);\n\t\tthis.statusCode = statusCode;\n\t\tthis.data = data;\n\t}\n\tstatusCode: number;\n\tdata: RiotErrorData | undefined;\n}\n\n/**\n * Type guard to check if an object is in the form of an riot error.\n * The API may return a structure like that on error, but we cannot be sure.\n *\n * @param obj obj to be checked\n * @returns true if obj has the form of RiotErroData\n */\nfunction isRiotErrorData(obj: unknown): obj is RiotErrorData {\n\tif (typeof obj !== 'object' || obj === null) return false;\n\n\tconst data = obj as RiotErrorData;\n\n\tif (data.status !== undefined) {\n\t\tif (typeof data.status !== 'object') {\n\t\t\treturn false;\n\t\t}\n\n\t\tif ('status_code' in data.status && typeof data.status.status_code !== 'number')\t\t{\n\t\t\treturn false;\n\t\t}\n\n\t\tif ('message' in data.status && typeof data.status.message !== 'string')\t\t{\n\t\t\treturn false;\n\t\t}\n\t}\n\n\treturn true;\n}\n\n\n/**\n * This is a mess. I am sorry for this type abonimation.\n *\n * @template Path the Path of the API route\n * @template ChosenMethod the Method that is chosen, has to be one of the available methods of the Path\n * @template ThrowOnError Wether createRiotFetch is configured to throw on http errors or not\n * @template error response.ok, used for type narrowing\n */\nexport type RiotFetchReturn<\n\tPath extends TemplatePaths,\n\tChosenMethod extends Methods<ResolveTemplatePath<Path>>,\n\tThrowOnError extends boolean,\n\terror extends boolean,\n> = ThrowOnError extends true\n\t? error extends false\n\t\t? {\n\t\t\t/** The response object of the fetch */\n\t\t\tresponse: Response;\n\t\t\t/** Typed result of response.json() */\n\t\t\tdata: GetResponseBody<ResolveTemplatePath<Path>, ChosenMethod, 200>;\n\t\t}\n\t\t: never\n\t: error extends false\n\t\t? {\n\t\t\t/** The response object of the fetch */\n\t\t\tresponse: Response;\n\t\t\t/** Typed result of response.json() or eventual error data */\n\t\t\tdata: GetResponseBody<ResolveTemplatePath<Path>, ChosenMethod, 200>;\n\t\t\t/** Wether the fetch errored */\n\t\t\terror: false;\n\t\t}\n\t\t: {\n\t\t\t/** The response object of the fetch */\n\t\t\tresponse: Response;\n\t\t\t/** Typed result of response.json() or eventual error data */\n\t\t\tdata:RiotErrorData | undefined;\n\t\t\t/** Wether the fetch errored */\n\t\t\terror: true;\n\t\t};\n\n/**\n * Options for the createRiotFetch functions\n * @template FetchOptions Options the fetch function can accept\n * @template ThrowOnError We set throwOnResponseError as a generic literal boolean, so that we can better type it\n */\nexport interface CreateRiotFetchOptions<FetchOptions, ThrowOnError extends boolean> {\n\t/** The Api Key obtained from Riot Games */\n\tapiKey: string\n\t/** fetch function that gets called (default: `undici.fetch`) */\n\tfetchFn?: (request: string, fetchOptions: FetchOptions) => Promise<Response>\n\t/** Function for dynamically creating the base url based on the given region. (default: standard riot api) */\n\tbaseUrl?: (region: string) => string,\n\t/**\n\t * Wether on 4xx/5xx response status the fetch should error or set error = true and include eventual error data in data\n\t * @see RiotError\n\t */\n\tthrowOnResponseError?: ThrowOnError,\n}\n\n/**\n * Basic Fetch Options that are essential for the functioning of createRiotFetch\n */\nexport interface BaseFetchOptions {\n\tmethod?: HTTPMethods,\n\theaders?: Headers,\n}\n\n/**\n * Creates a new function that basically wraps the provided fetch function to provide type information.\n *\n * @param {CreateRiotFetchOptions} createRiotFetchOptions Options for the createRiotFetch function\n * @param defaultOptions Options that get passed to the fetch function by default\n * @returns A fetch function to get fetch the Riot Games API type-safe\n */\nexport function createRiotFetch<\n\tFetchOptions extends BaseFetchOptions & Record<string, unknown>,\n\tThrowOnError extends boolean = false\n>(\n\t{\n\t\tapiKey,\n\t\tfetchFn = fetch,\n\t\tbaseUrl = (region: string) => `https://${region}.api.riotgames.com/`,\n\t\tthrowOnResponseError = false as ThrowOnError\n\t}: CreateRiotFetchOptions<FetchOptions & { body?: BodyInit }, ThrowOnError>,\n\tdefaultOptions: FetchOptions = {} as FetchOptions\n) {\n\tconst headers = new Headers(defaultOptions.headers);\n\theaders.append('X-Riot-Token', apiKey);\n\theaders.append('Content-Type', 'application/json');\n\tdefaultOptions.headers = headers;\n\n\t/**\n\t * A functions that can be used to fetch the Riot Games API with already defined defaults and type information\n\t * based on it's OpenAPI specification.\n\t *\n\t * @template Path The literal type of the path, inferred by `request`\n\t * @template UsableMethods All Methods that can be selected, used to autocomplete `method`\n\t * @template ChosenMethod The method\n\t * @param request The path of the resource requested. Gets merged using `URL`\n\t * @returns Response Object, a promise for the return body, depending on Path, Method and Status Code and an error indicator\n\t * @throws { RiotError } if `throwOnResponseError = true` and !response.ok\n\t */\n\treturn async <\n\t\tPath extends TemplatePaths,\n\t\tUsableMethods extends Methods<ResolveTemplatePath<Path>>,\n\t\tChosenMethod extends UsableMethods | undefined = 'get' extends UsableMethods ? 'get' : UsableMethods,\n\t>(\n\t\trequest: Path,\n\t\toptions: FetchOptions & {\n\t\t\tregion: GetSubdomain<ResolveTemplatePath<Path>>,\n\t\t\tmethod?: UsableMethods,\n\t\t}\n\t\t\t& GetRequestBody<ResolveTemplatePath<Path>, Extract<ChosenMethod, HTTPMethods>>\n\t\t\t& GetQuery<ResolveTemplatePath<Path>, Extract<ChosenMethod, HTTPMethods>>,\n\t) => {\n\t\tconst baseURL = baseUrl(options.region);\n\t\tlet req = new URL(request, baseURL).toString();\n\t\tif (options.query) {\n\t\t\tconst query = Object.entries(options.query).map(([key, value]) => [key, String(value)]);\n\t\t\treq += new URLSearchParams(query).toString();\n\t\t}\n\n\t\tconst response = await fetchFn(req, {\n\t\t\t...defaultOptions,\n\t\t\t...options,\n\t\t\tbody: JSON.stringify(options.body)\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tconst riotErrorData = await response.json()\n\t\t\t\t.then(obj => isRiotErrorData(obj) ? obj : undefined)\n\t\t\t\t.catch(() => undefined);\n\n\n\t\t\tif (throwOnResponseError) {\n\t\t\t\tthrow new RiotError(\n\t\t\t\t\t'Riot Games Fetch Error',\n\t\t\t\t\tresponse.status,\n\t\t\t\t\triotErrorData\n\t\t\t\t);\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\tresponse,\n\t\t\t\tdata: riotErrorData,\n\t\t\t\terror: true,\n\t\t\t} as RiotFetchReturn<Path, Extract<ChosenMethod, HTTPMethods>, ThrowOnError, true>;\n\t\t}\n\n\t\treturn {\n\t\t\tresponse,\n\t\t\tdata: await response.json() as GetResponseBody<ResolveTemplatePath<Path>, Extract<ChosenMethod, HTTPMethods>, 200>,\n\t\t\terror: false,\n\t\t} as RiotFetchReturn<Path, Extract<ChosenMethod, HTTPMethods>, ThrowOnError, false>;\n\t};\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmKO,IAAM,YAAN,cAAwB,MAAM;AAAA,EACpC,YAAY,SAAiB,YAAoB,MAAsB;AACtE,UAAM,OAAO;AACb,SAAK,aAAa;AAClB,SAAK,OAAO;AAAA,EACb;AAAA,EACA;AAAA,EACA;AACD;AASA,SAAS,gBAAgB,KAAoC;AAC5D,MAAI,OAAO,QAAQ,YAAY,QAAQ,KAAM,QAAO;AAEpD,QAAM,OAAO;AAEb,MAAI,KAAK,WAAW,QAAW;AAC9B,QAAI,OAAO,KAAK,WAAW,UAAU;AACpC,aAAO;AAAA,IACR;AAEA,QAAI,iBAAiB,KAAK,UAAU,OAAO,KAAK,OAAO,gBAAgB,UAAW;AACjF,aAAO;AAAA,IACR;AAEA,QAAI,aAAa,KAAK,UAAU,OAAO,KAAK,OAAO,YAAY,UAAW;AACzE,aAAO;AAAA,IACR;AAAA,EACD;AAEA,SAAO;AACR;AA6EO,SAAS,gBAIf;AAAA,EACC;AAAA,EACA,UAAU;AAAA,EACV,UAAU,CAAC,WAAmB,WAAW,MAAM;AAAA,EAC/C,uBAAuB;AACxB,GACA,iBAA+B,CAAC,GAC/B;AACD,QAAM,UAAU,IAAI,QAAQ,eAAe,OAAO;AAClD,UAAQ,OAAO,gBAAgB,MAAM;AACrC,UAAQ,OAAO,gBAAgB,kBAAkB;AACjD,iBAAe,UAAU;AAazB,SAAO,OAKN,SACA,YAMI;AACJ,UAAM,UAAU,QAAQ,QAAQ,MAAM;AACtC,QAAI,MAAM,IAAI,IAAI,SAAS,OAAO,EAAE,SAAS;AAC7C,QAAI,QAAQ,OAAO;AAClB,YAAM,QAAQ,OAAO,QAAQ,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,OAAO,KAAK,CAAC,CAAC;AACtF,aAAO,IAAI,gBAAgB,KAAK,EAAE,SAAS;AAAA,IAC5C;AAEA,UAAM,WAAW,MAAM,QAAQ,KAAK;AAAA,MACnC,GAAG;AAAA,MACH,GAAG;AAAA,MACH,MAAM,KAAK,UAAU,QAAQ,IAAI;AAAA,IAClC,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AACjB,YAAM,gBAAgB,MAAM,SAAS,KAAK,EACxC,KAAK,SAAO,gBAAgB,GAAG,IAAI,MAAM,MAAS,EAClD,MAAM,MAAM,MAAS;AAGvB,UAAI,sBAAsB;AACzB,cAAM,IAAI;AAAA,UACT;AAAA,UACA,SAAS;AAAA,UACT;AAAA,QACD;AAAA,MACD;AAEA,aAAO;AAAA,QACN;AAAA,QACA,MAAM;AAAA,QACN,OAAO;AAAA,MACR;AAAA,IACD;AAEA,WAAO;AAAA,MACN;AAAA,MACA,MAAM,MAAM,SAAS,KAAK;AAAA,MAC1B,OAAO;AAAA,IACR;AAAA,EACD;AACD;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { paths, components } from './types/openapi.d.js';\n\nexport * from './types/openapi.d.js';\n\n\n/** Every possible API path, based on the OpenAPI document */\nexport type Paths = keyof paths;\n\n/**\n * Type util that replaces all occurences of curly brackets pairs in a string literal type to string placeholders,\n * resulting in a template literal type. For that it recursively tests the string for curly bracket pairs.\n *\n * @example TemplatifyPath<'summoner/{summonerName}/ranked'> -> `summoner/${string}/ranked`\n */\nexport type TemplatifyPathRecursive<Path extends string> =\n\tPath extends `${infer Start}/{${string}}${infer End}`\n\t\t? `${Start}/${string}${TemplatifyPathRecursive<End>}`\n\t\t: Path;\n\n\n/** Every possible API path, but templatified */\nexport type TemplatePaths = TemplatifyPathRecursive<Paths>;\n\n/** Splits a Path by `/` into an array */\nexport type SplitPathRecursive<Path extends string> = Path extends `${infer Head}/${infer Tail}`\n\t? [Head, ...SplitPathRecursive<Tail>]\n\t: [Path];\n\nexport type SplitPath<Path extends string> =\n  Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}/${infer F}/${infer G}/${infer H}/${infer I}`\n  \t? [A, B, C, D, E, F, G, H, I]\n  \t: Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}/${infer F}/${infer G}/${infer H}`\n  \t\t? [A, B, C, D, E, F, G, H]\n  \t\t: Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}/${infer F}/${infer G}`\n  \t\t\t? [A, B, C, D, E, F, G]\n  \t\t\t: Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}/${infer F}`\n  \t\t\t\t? [A, B, C, D, E, F]\n  \t\t\t\t: Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}`\n  \t\t\t\t\t? [A, B, C, D, E]\n  \t\t\t\t\t: Path extends `${infer A}/${infer B}/${infer C}/${infer D}`\n  \t\t\t\t\t\t? [A, B, C, D]\n  \t\t\t\t\t\t: Path extends `${infer A}/${infer B}/${infer C}`\n  \t\t\t\t\t\t\t? [A, B, C]\n  \t\t\t\t\t\t\t: Path extends `${infer A}/${infer B}`\n  \t\t\t\t\t\t\t\t? [A, B]\n  \t\t\t\t\t\t\t\t: [Path];\n\n/**\n * Compares two splitted paths.\n *\n * Type is true if both splitted paths have the same length and every segment of Concrete extends its corresponding segment Template\n * */\nexport type MatchSegmentsRecursive<Template extends string[], Concrete extends string[]> =\n  Template extends [infer TemplateSegment, ...infer TemplateRest]\n  \t? Concrete extends [infer ConcreteSegment, ...infer ConcreteRest]\n  \t\t? ConcreteSegment extends TemplateSegment\n  \t\t\t? TemplateRest extends string[]\n  \t\t\t\t? ConcreteRest extends string[]\n  \t\t\t\t\t? MatchSegmentsRecursive<TemplateRest, ConcreteRest>\n  \t\t\t\t\t: never\n  \t\t\t\t: never\n  \t\t\t: false\n  \t\t: Concrete extends []\n  \t\t\t? Template extends []\n  \t\t\t\t? true\n  \t\t\t\t: false\n  \t\t\t: false\n  \t: Template extends []\n  \t\t? Concrete extends []\n  \t\t\t? true\n  \t\t\t: false\n  \t\t: false;\n\nexport type MatchSegments<\n\tT extends [string?, string?, string?, string?, string?, string?, string?, string?, string?],\n\tC extends [string?, string?, string?, string?, string?, string?, string?, string?, string?]\n> =\n  T['length'] extends C['length'] ? (\n  \tC[0] extends T[0] ?\n  \t\tC[1] extends T[1] ?\n  \t\t\tC[2] extends T[2] ?\n  \t\t\t\tC[3] extends T[3] ?\n  \t\t\t\t\tC[4] extends T[4] ?\n  \t\t\t\t\t\tC[5] extends T[5] ?\n  \t\t\t\t\t\t\tC[6] extends T[6] ?\n  \t\t\t\t\t\t\t\tC[7] extends T[7] ?\n  \t\t\t\t\t\t\t\t\tC[8] extends T[8] ?\n  \t\t\t\t\t\t\t\t\t\ttrue :\n  \t\t\t\t\t\t\t\t\t\tfalse :\n  \t\t\t\t\t\t\t\t\tfalse :\n  \t\t\t\t\t\t\t\tfalse :\n  \t\t\t\t\t\t\tfalse :\n  \t\t\t\t\t\tfalse :\n  \t\t\t\t\tfalse :\n  \t\t\t\tfalse :\n  \t\t\tfalse :\n  \t\tfalse\n  )\n  \t: false;\n\n/**\n * Gives all API Paths that matches the path. Basically the reverse operation of TemplatifyPath\n *\n * @example ResolveTemplatePath<`/riot/account/v1/accounts/by-puuid/${string}`>\n * -> \"/riot/account/v1/accounts/by-puuid/{puuid}\"\n *\n * @example ResolveTemplatePath<`/riot/account/v1/accounts/by-riot-id/gameName/gameTag`>\n * -> \"/riot/account/v1/accounts/by-riot-id/{gameName}/{tagLine}\"\n */\nexport type ResolveTemplatePath<Path extends TemplatePaths> = {\n\t[P in Paths]: MatchSegments<SplitPath<TemplatifyPathRecursive<P>>, SplitPath<Path>> extends true ? P : never\n}[Paths];\n\nexport type HTTPMethods = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace';\n\n/**\n * Get all available methods for a specific API path\n */\nexport type Methods<Path extends Paths> = Exclude<keyof {\n\t[K in keyof paths[Path] as paths[Path][K] extends undefined ? never : K]: paths[Path][K]\n}, 'parameters'>;\n\n/** Get all possible responses for a specific API path and method */\nexport type GetResponses<Path extends Paths, Method extends Methods<Path>> =\n\tpaths[Path][Method] extends { responses: infer Responses }\n\t\t? Responses\n\t\t: never;\n\n\n/** Get the response body for a specific API path, method and status code */\nexport type GetResponseBody<Path extends Paths, Method extends Methods<Path>, StatusCode extends number> =\n\tGetResponses<Path, Method> extends Record<StatusCode, { content?: { 'application/json': infer Body } }>\n\t\t? Body\n\t\t: never;\n\n\nexport type GetRequestBody<Path extends Paths, Method extends Methods<Path>> =\n  paths[Path][Method] extends { requestBody?: never }\n  \t? { body?: never }\n  \t: paths[Path][Method] extends { requestBody: { content: { 'application/json': infer U } } }\n  \t\t? { body: U }\n  \t\t: paths[Path][Method] extends { requestBody?: { content: { 'application/json': infer U } } }\n  \t\t\t? { body?: U }\n  \t\t\t: unknown;\n\n\n/** Get the query parameters for a specific API path and method */\nexport type GetQuery<Path extends Paths, Method extends Methods<Path>> = Pick<paths[Path][Method]['parameters'], 'query'>;\n\n/** Regions for /riot/account/ endpoints */\nexport type AccountRegion =  'americas' | 'asia' | 'europe';\n/** Regions for some lol and tft endpoints */\nexport type LolRegion = 'br1' | 'eun1' | 'euw1' | 'jp1' | 'kr' | 'la1' | 'la2' | 'me1' | 'na1' | 'oc1' | 'ph2' | 'ru' | 'sg2' | 'th2' | 'tr1' | 'tw2' | 'vn2';\n/** Regions for lol and tft matches endpoints */\nexport type MatchRegion = 'americas' | 'asia' | 'europe' | 'sea';\n/** Regions for /lor/ endpoints */\nexport type LorRegion = 'americas' | 'europe' | 'sea';\n/** Regions for /val/ endpoints */\nexport type ValorantRegion = 'ap' | 'br' | 'eu' | 'latam' | 'na' | 'esports' | 'kr';\n\n\n/** Get the relevant subdomains, depending on the endpoint */\n// i dont like eslint indenting here\n/* eslint-disable @stylistic/indent */\nexport type GetSubdomain<Path extends TemplatePaths> =\n\tPath extends `/riot/account/${string}` ? AccountRegion :\n\tPath extends `/lol/champion-mastery/${string}` ? LolRegion :\n\tPath extends `/lol/platform/${string}` ? LolRegion :\n\tPath extends `/lol/clash/${string}` ? LolRegion :\n\tPath extends `/lol/league-exp/${string}` ? LolRegion :\n\tPath extends `/lol/league/${string}` ? LolRegion :\n\tPath extends `/lol/challenges/${string}` ? LolRegion :\n\tPath extends `/lol/rso-match/${string}` ? MatchRegion :\n\tPath extends `/lol/status/${string}` ? LolRegion :\n\tPath extends `/lor/deck/${string}` ? LorRegion :\n\tPath extends `/lor/inventory/${string}` ? LorRegion :\n\tPath extends `/lor/match/${string}` ? LorRegion | 'apac' :\n\tPath extends `/lor/ranked/${string}` ? LorRegion :\n\tPath extends `/lor/status/${string}` ? LorRegion :\n\tPath extends `/lol/match/${string}` ? MatchRegion :\n\tPath extends `/lol/spectator/${string}` ? LolRegion :\n\tPath extends `/fulfillment/${string}` ? LolRegion :\n\tPath extends `/lol/summoner/${string}` ? LolRegion :\n\tPath extends `/tft/league/${string}` ? LolRegion :\n\tPath extends `/tft/match/${string}` ? MatchRegion | 'esports' | 'esportseu' :\n\tPath extends `/tft/status/${string}` ? LolRegion :\n\tPath extends `/tft/summoner/${string}` ? LolRegion :\n\t// seems like only americas but not sure\n\tPath extends `/lol/tournament-stub/${string}` ? 'americas' :\n\t// don't know, can't see in api reference\n\tPath extends `/lol/tournament/${string}` ? LolRegion | MatchRegion :\n\t// The api docs do not include all regions for console, but for stability we will just include them\n\tPath extends `/val/match/console/${string}` ? ValorantRegion :\n\tPath extends `/val/console/ranked/${string}` ? ValorantRegion :\n\tPath extends `/val/content/${string}` ? ValorantRegion :\n\tPath extends `/val/match/${string}` ? ValorantRegion :\n\tPath extends `/val/ranked/${string}` ? ValorantRegion :\n\tPath extends `/val/status/${string}` ? Exclude<ValorantRegion, 'esports'>\n\t: never;\n/* eslint-enable @stylistic/indent */\n\n/** Typical structure for a RiotError json object. */\nexport type RiotErrorData = components['schemas']['Error'];\n\n/**\n * Error Class for a 4xx/5xx response code in a fetch to the Riot API\n */\nexport class RiotError extends Error {\n\tconstructor(message: string, statusCode: number, data?: RiotErrorData) {\n\t\tsuper(message);\n\t\tthis.statusCode = statusCode;\n\t\tthis.data = data;\n\t}\n\tstatusCode: number;\n\tdata: RiotErrorData | undefined;\n}\n\n/**\n * Type guard to check if an object is in the form of an riot error.\n * The API may return a structure like that on error, but we cannot be sure.\n *\n * @param obj obj to be checked\n * @returns true if obj has the form of RiotErroData\n */\nfunction isRiotErrorData(obj: unknown): obj is RiotErrorData {\n\tif (typeof obj !== 'object' || obj === null) return false;\n\n\tconst data = obj as RiotErrorData;\n\n\tif (data.status !== undefined) {\n\t\tif (typeof data.status !== 'object') {\n\t\t\treturn false;\n\t\t}\n\n\t\tif ('status_code' in data.status && typeof data.status.status_code !== 'number')\t\t{\n\t\t\treturn false;\n\t\t}\n\n\t\tif ('message' in data.status && typeof data.status.message !== 'string')\t\t{\n\t\t\treturn false;\n\t\t}\n\t}\n\n\treturn true;\n}\n\n\n/**\n * This is a mess. I am sorry for this type abonimation.\n *\n * @template Path the Path of the API route\n * @template ChosenMethod the Method that is chosen, has to be one of the available methods of the Path\n * @template ThrowOnError Wether createRiotFetch is configured to throw on http errors or not\n * @template error response.ok, used for type narrowing\n */\nexport type RiotFetchReturn<\n\tPath extends TemplatePaths,\n\tChosenMethod extends Methods<ResolveTemplatePath<Path>>,\n\tThrowOnError extends boolean,\n\terror extends boolean,\n> = ThrowOnError extends true\n\t? error extends false\n\t\t? {\n\t\t\t/** The response object of the fetch */\n\t\t\tresponse: Response;\n\t\t\t/** Typed result of response.json() */\n\t\t\tdata: GetResponseBody<ResolveTemplatePath<Path>, ChosenMethod, 200>;\n\t\t}\n\t\t: never\n\t: error extends false\n\t\t? {\n\t\t\t/** The response object of the fetch */\n\t\t\tresponse: Response;\n\t\t\t/** Typed result of response.json() or eventual error data */\n\t\t\tdata: GetResponseBody<ResolveTemplatePath<Path>, ChosenMethod, 200>;\n\t\t\t/** Wether the fetch errored */\n\t\t\terror: false;\n\t\t}\n\t\t: {\n\t\t\t/** The response object of the fetch */\n\t\t\tresponse: Response;\n\t\t\t/** Typed result of response.json() or eventual error data */\n\t\t\tdata:RiotErrorData | undefined;\n\t\t\t/** Wether the fetch errored */\n\t\t\terror: true;\n\t\t};\n\n/**\n * Options for the createRiotFetch functions\n * @template FetchOptions Options the fetch function can accept\n * @template ThrowOnError We set throwOnResponseError as a generic literal boolean, so that we can better type it\n */\nexport interface CreateRiotFetchOptions<FetchOptions, ThrowOnError extends boolean> {\n\t/** The Api Key obtained from Riot Games */\n\tapiKey: string\n\t/** fetch function that gets called (default: `undici.fetch`) */\n\tfetchFn?: (request: URL | RequestInfo, fetchOptions: FetchOptions) => Promise<Response>\n\t/** Function for dynamically creating the base url based on the given region. (default: standard riot api) */\n\tbaseUrl?: (region: string) => string,\n\t/**\n\t * Wether on 4xx/5xx response status the fetch should error or set error = true and include eventual error data in data\n\t * @see RiotError\n\t */\n\tthrowOnResponseError?: ThrowOnError,\n}\n\n/**\n * Basic Fetch Options that are essential for the functioning of createRiotFetch\n */\nexport interface BaseFetchOptions {\n\tmethod?: HTTPMethods,\n\theaders?: Headers,\n}\n\n/**\n * Creates a new function that basically wraps the provided fetch function to provide type information.\n *\n * @param {CreateRiotFetchOptions} createRiotFetchOptions Options for the createRiotFetch function\n * @param defaultOptions Options that get passed to the fetch function by default\n * @returns A fetch function to get fetch the Riot Games API type-safe\n */\nexport function createRiotFetch<\n\tFetchOptions extends BaseFetchOptions & Record<string, unknown>,\n\tThrowOnError extends boolean = false\n>(\n\t{\n\t\tapiKey,\n\t\tfetchFn = fetch,\n\t\tbaseUrl = (region: string) => `https://${region}.api.riotgames.com/`,\n\t\tthrowOnResponseError = false as ThrowOnError\n\t}: CreateRiotFetchOptions<FetchOptions & { body?: BodyInit }, ThrowOnError>,\n\tdefaultOptions: FetchOptions = {} as FetchOptions\n) {\n\tconst headers = new Headers(defaultOptions.headers);\n\theaders.append('X-Riot-Token', apiKey);\n\theaders.append('Content-Type', 'application/json');\n\tdefaultOptions.headers = headers;\n\n\t/**\n\t * A functions that can be used to fetch the Riot Games API with already defined defaults and type information\n\t * based on it's OpenAPI specification.\n\t *\n\t * @template Path The literal type of the path, inferred by `request`\n\t * @template UsableMethods All Methods that can be selected, used to autocomplete `method`\n\t * @template ChosenMethod The method\n\t * @param request The path of the resource requested. Gets merged using `URL`\n\t * @returns Response Object, a promise for the return body, depending on Path, Method and Status Code and an error indicator\n\t * @throws { RiotError } if `throwOnResponseError = true` and !response.ok\n\t */\n\treturn async <\n\t\tPath extends TemplatePaths,\n\t\tUsableMethods extends Methods<ResolveTemplatePath<Path>>,\n\t\tChosenMethod extends UsableMethods | undefined = 'get' extends UsableMethods ? 'get' : UsableMethods,\n\t>(\n\t\trequest: Path,\n\t\toptions: FetchOptions & {\n\t\t\tregion: GetSubdomain<ResolveTemplatePath<Path>>,\n\t\t\tmethod?: UsableMethods,\n\t\t}\n\t\t\t& GetRequestBody<ResolveTemplatePath<Path>, Extract<ChosenMethod, HTTPMethods>>\n\t\t\t& GetQuery<ResolveTemplatePath<Path>, Extract<ChosenMethod, HTTPMethods>>,\n\t): Promise<\n\tRiotFetchReturn<Path, Extract<ChosenMethod, HTTPMethods>, ThrowOnError, true>\n\t|\tRiotFetchReturn<Path, Extract<ChosenMethod, HTTPMethods>, ThrowOnError, false>\n\t> => {\n\t\tconst baseURL = baseUrl(options.region);\n\t\tconst req = new URL(request, baseURL);\n\t\tif (options.query) {\n\t\t\tfor (const [key, value] of Object.entries(options.query)) {\n\t\t\t\treq.searchParams.set(key, String(value));\n\t\t\t}\n\t\t}\n\n\t\tconst response = await fetchFn(req, {\n\t\t\t...defaultOptions,\n\t\t\t...options,\n\t\t\tbody: JSON.stringify(options.body)\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tconst riotErrorData = await response.json()\n\t\t\t\t.then(obj => isRiotErrorData(obj) ? obj : undefined)\n\t\t\t\t.catch(() => undefined);\n\n\n\t\t\tif (throwOnResponseError) {\n\t\t\t\tthrow new RiotError(\n\t\t\t\t\t'Riot Games Fetch Error',\n\t\t\t\t\tresponse.status,\n\t\t\t\t\triotErrorData\n\t\t\t\t);\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\tresponse,\n\t\t\t\tdata: riotErrorData,\n\t\t\t\terror: true,\n\t\t\t} as RiotFetchReturn<Path, Extract<ChosenMethod, HTTPMethods>, ThrowOnError, true>;\n\t\t}\n\n\t\treturn {\n\t\t\tresponse,\n\t\t\tdata: await response.json() as GetResponseBody<ResolveTemplatePath<Path>, Extract<ChosenMethod, HTTPMethods>, 200>,\n\t\t\terror: false,\n\t\t} as RiotFetchReturn<Path, Extract<ChosenMethod, HTTPMethods>, ThrowOnError, false>;\n\t};\n}\n\nexport const Queues = {\n\tCUSTOM: 0,\n\tHEXAKILL: 75,\n\tURF: [76, 1900],\n\tAR_URF: 900,\n\tARAM: {\n\t\tBUTCHERS_BRIDGE: 100,\n\t\tHOWLING_ABYSS: 450,\n\t\tALL: [100, 450]\n\t},\n\tALL_RANDOM: 325,\n\tBLIND: 430,\n\tDRAFT: 400,\n\tQUICKPLAY: 490,\n\tRANKED_SOLO: 420,\n\tRANKED_FLEX: 440,\n\tCLASH: {\n\t\tSUMMONERS_RIFT: 700,\n\t\tHOWLING_ABYSS: 720,\n\t\tARAM: 720,\n\t\tALL: [700, 720]\n\t},\n\tCOOP_VS_AI: {\n\t\tINTRO: 870,\n\t\tBEGINNER: 880,\n\t\tINTERMEDIATE: 890,\n\t\tALL: [870, 880, 890],\n\t},\n\tDOOM_BOTS: 960,\n\tONE_FOR_ALL: 1020,\n\tNEXUS_BLITZ: 1300,\n\tSPELLBOOK: 1400,\n\tARENA: [1700, 1710],\n\tSWARM: [1810, 1820, 1830, 1840],\n\tTUTORIAL: [2000, 2010, 2020]\n} as const;"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -13475,17 +13475,19 @@ type Paths = keyof paths;
  *
  * @example TemplatifyPath<'summoner/{summonerName}/ranked'> -> `summoner/${string}/ranked`
  */
-type TemplatifyPath<Path extends string> = Path extends `${infer Start}/{${string}}${infer End}` ? `${Start}/${string}${TemplatifyPath<End>}` : Path;
+type TemplatifyPathRecursive<Path extends string> = Path extends `${infer Start}/{${string}}${infer End}` ? `${Start}/${string}${TemplatifyPathRecursive<End>}` : Path;
 /** Every possible API path, but templatified */
-type TemplatePaths = TemplatifyPath<Paths>;
+type TemplatePaths = TemplatifyPathRecursive<Paths>;
 /** Splits a Path by `/` into an array */
-type SplitPath<Path extends string> = Path extends `${infer Head}/${infer Tail}` ? [Head, ...SplitPath<Tail>] : [Path];
+type SplitPathRecursive<Path extends string> = Path extends `${infer Head}/${infer Tail}` ? [Head, ...SplitPathRecursive<Tail>] : [Path];
+type SplitPath<Path extends string> = Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}/${infer F}/${infer G}/${infer H}/${infer I}` ? [A, B, C, D, E, F, G, H, I] : Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}/${infer F}/${infer G}/${infer H}` ? [A, B, C, D, E, F, G, H] : Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}/${infer F}/${infer G}` ? [A, B, C, D, E, F, G] : Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}/${infer F}` ? [A, B, C, D, E, F] : Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}` ? [A, B, C, D, E] : Path extends `${infer A}/${infer B}/${infer C}/${infer D}` ? [A, B, C, D] : Path extends `${infer A}/${infer B}/${infer C}` ? [A, B, C] : Path extends `${infer A}/${infer B}` ? [A, B] : [Path];
 /**
  * Compares two splitted paths.
  *
  * Type is true if both splitted paths have the same length and every segment of Concrete extends its corresponding segment Template
  * */
-type MatchSegments<Template extends string[], Concrete extends string[]> = Template extends [infer TemplateSegment, ...infer TemplateRest] ? Concrete extends [infer ConcreteSegment, ...infer ConcreteRest] ? ConcreteSegment extends TemplateSegment ? TemplateRest extends string[] ? ConcreteRest extends string[] ? MatchSegments<TemplateRest, ConcreteRest> : never : never : false : Concrete extends [] ? Template extends [] ? true : false : false : Template extends [] ? Concrete extends [] ? true : false : false;
+type MatchSegmentsRecursive<Template extends string[], Concrete extends string[]> = Template extends [infer TemplateSegment, ...infer TemplateRest] ? Concrete extends [infer ConcreteSegment, ...infer ConcreteRest] ? ConcreteSegment extends TemplateSegment ? TemplateRest extends string[] ? ConcreteRest extends string[] ? MatchSegmentsRecursive<TemplateRest, ConcreteRest> : never : never : false : Concrete extends [] ? Template extends [] ? true : false : false : Template extends [] ? Concrete extends [] ? true : false : false;
+type MatchSegments<T extends [string?, string?, string?, string?, string?, string?, string?, string?, string?], C extends [string?, string?, string?, string?, string?, string?, string?, string?, string?]> = T['length'] extends C['length'] ? (C[0] extends T[0] ? C[1] extends T[1] ? C[2] extends T[2] ? C[3] extends T[3] ? C[4] extends T[4] ? C[5] extends T[5] ? C[6] extends T[6] ? C[7] extends T[7] ? C[8] extends T[8] ? true : false : false : false : false : false : false : false : false : false) : false;
 /**
  * Gives all API Paths that matches the path. Basically the reverse operation of TemplatifyPath
  *
@@ -13496,7 +13498,7 @@ type MatchSegments<Template extends string[], Concrete extends string[]> = Templ
  * -> "/riot/account/v1/accounts/by-riot-id/{gameName}/{tagLine}"
  */
 type ResolveTemplatePath<Path extends TemplatePaths> = {
-    [P in Paths]: MatchSegments<SplitPath<TemplatifyPath<P>>, SplitPath<Path>> extends true ? P : never;
+    [P in Paths]: MatchSegments<SplitPath<TemplatifyPathRecursive<P>>, SplitPath<Path>> extends true ? P : never;
 }[Paths];
 type HTTPMethods = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace';
 /**
@@ -13597,7 +13599,7 @@ interface CreateRiotFetchOptions<FetchOptions, ThrowOnError extends boolean> {
     /** The Api Key obtained from Riot Games */
     apiKey: string;
     /** fetch function that gets called (default: `undici.fetch`) */
-    fetchFn?: (request: string, fetchOptions: FetchOptions) => Promise<Response>;
+    fetchFn?: (request: URL | RequestInfo, fetchOptions: FetchOptions) => Promise<Response>;
     /** Function for dynamically creating the base url based on the given region. (default: standard riot api) */
     baseUrl?: (region: string) => string;
     /**
@@ -13626,5 +13628,41 @@ declare function createRiotFetch<FetchOptions extends BaseFetchOptions & Record<
     region: GetSubdomain<ResolveTemplatePath<Path>>;
     method?: UsableMethods;
 } & GetRequestBody<ResolveTemplatePath<Path>, Extract<ChosenMethod, HTTPMethods>> & GetQuery<ResolveTemplatePath<Path>, Extract<ChosenMethod, HTTPMethods>>) => Promise<RiotFetchReturn<Path, Extract<ChosenMethod, HTTPMethods>, ThrowOnError, true> | RiotFetchReturn<Path, Extract<ChosenMethod, HTTPMethods>, ThrowOnError, false>>;
+declare const Queues: {
+    readonly CUSTOM: 0;
+    readonly HEXAKILL: 75;
+    readonly URF: readonly [76, 1900];
+    readonly AR_URF: 900;
+    readonly ARAM: {
+        readonly BUTCHERS_BRIDGE: 100;
+        readonly HOWLING_ABYSS: 450;
+        readonly ALL: readonly [100, 450];
+    };
+    readonly ALL_RANDOM: 325;
+    readonly BLIND: 430;
+    readonly DRAFT: 400;
+    readonly QUICKPLAY: 490;
+    readonly RANKED_SOLO: 420;
+    readonly RANKED_FLEX: 440;
+    readonly CLASH: {
+        readonly SUMMONERS_RIFT: 700;
+        readonly HOWLING_ABYSS: 720;
+        readonly ARAM: 720;
+        readonly ALL: readonly [700, 720];
+    };
+    readonly COOP_VS_AI: {
+        readonly INTRO: 870;
+        readonly BEGINNER: 880;
+        readonly INTERMEDIATE: 890;
+        readonly ALL: readonly [870, 880, 890];
+    };
+    readonly DOOM_BOTS: 960;
+    readonly ONE_FOR_ALL: 1020;
+    readonly NEXUS_BLITZ: 1300;
+    readonly SPELLBOOK: 1400;
+    readonly ARENA: readonly [1700, 1710];
+    readonly SWARM: readonly [1810, 1820, 1830, 1840];
+    readonly TUTORIAL: readonly [2000, 2010, 2020];
+};
 
-export { type $defs, type AccountRegion, type BaseFetchOptions, type CreateRiotFetchOptions, type GetQuery, type GetRequestBody, type GetResponseBody, type GetResponses, type GetSubdomain, type HTTPMethods, type LolRegion, type LorRegion, type MatchRegion, type MatchSegments, type Methods, type Paths, type ResolveTemplatePath, RiotError, type RiotErrorData, type RiotFetchReturn, type SplitPath, type TemplatePaths, type TemplatifyPath, type ValorantRegion, type components, createRiotFetch, type operations, type paths, type webhooks };
+export { type $defs, type AccountRegion, type BaseFetchOptions, type CreateRiotFetchOptions, type GetQuery, type GetRequestBody, type GetResponseBody, type GetResponses, type GetSubdomain, type HTTPMethods, type LolRegion, type LorRegion, type MatchRegion, type MatchSegments, type MatchSegmentsRecursive, type Methods, type Paths, Queues, type ResolveTemplatePath, RiotError, type RiotErrorData, type RiotFetchReturn, type SplitPath, type SplitPathRecursive, type TemplatePaths, type TemplatifyPathRecursive, type ValorantRegion, type components, createRiotFetch, type operations, type paths, type webhooks };

package/dist/index.d.ts

@@ -13475,17 +13475,19 @@ type Paths = keyof paths;
  *
  * @example TemplatifyPath<'summoner/{summonerName}/ranked'> -> `summoner/${string}/ranked`
  */
-type TemplatifyPath<Path extends string> = Path extends `${infer Start}/{${string}}${infer End}` ? `${Start}/${string}${TemplatifyPath<End>}` : Path;
+type TemplatifyPathRecursive<Path extends string> = Path extends `${infer Start}/{${string}}${infer End}` ? `${Start}/${string}${TemplatifyPathRecursive<End>}` : Path;
 /** Every possible API path, but templatified */
-type TemplatePaths = TemplatifyPath<Paths>;
+type TemplatePaths = TemplatifyPathRecursive<Paths>;
 /** Splits a Path by `/` into an array */
-type SplitPath<Path extends string> = Path extends `${infer Head}/${infer Tail}` ? [Head, ...SplitPath<Tail>] : [Path];
+type SplitPathRecursive<Path extends string> = Path extends `${infer Head}/${infer Tail}` ? [Head, ...SplitPathRecursive<Tail>] : [Path];
+type SplitPath<Path extends string> = Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}/${infer F}/${infer G}/${infer H}/${infer I}` ? [A, B, C, D, E, F, G, H, I] : Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}/${infer F}/${infer G}/${infer H}` ? [A, B, C, D, E, F, G, H] : Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}/${infer F}/${infer G}` ? [A, B, C, D, E, F, G] : Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}/${infer F}` ? [A, B, C, D, E, F] : Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}` ? [A, B, C, D, E] : Path extends `${infer A}/${infer B}/${infer C}/${infer D}` ? [A, B, C, D] : Path extends `${infer A}/${infer B}/${infer C}` ? [A, B, C] : Path extends `${infer A}/${infer B}` ? [A, B] : [Path];
 /**
  * Compares two splitted paths.
  *
  * Type is true if both splitted paths have the same length and every segment of Concrete extends its corresponding segment Template
  * */
-type MatchSegments<Template extends string[], Concrete extends string[]> = Template extends [infer TemplateSegment, ...infer TemplateRest] ? Concrete extends [infer ConcreteSegment, ...infer ConcreteRest] ? ConcreteSegment extends TemplateSegment ? TemplateRest extends string[] ? ConcreteRest extends string[] ? MatchSegments<TemplateRest, ConcreteRest> : never : never : false : Concrete extends [] ? Template extends [] ? true : false : false : Template extends [] ? Concrete extends [] ? true : false : false;
+type MatchSegmentsRecursive<Template extends string[], Concrete extends string[]> = Template extends [infer TemplateSegment, ...infer TemplateRest] ? Concrete extends [infer ConcreteSegment, ...infer ConcreteRest] ? ConcreteSegment extends TemplateSegment ? TemplateRest extends string[] ? ConcreteRest extends string[] ? MatchSegmentsRecursive<TemplateRest, ConcreteRest> : never : never : false : Concrete extends [] ? Template extends [] ? true : false : false : Template extends [] ? Concrete extends [] ? true : false : false;
+type MatchSegments<T extends [string?, string?, string?, string?, string?, string?, string?, string?, string?], C extends [string?, string?, string?, string?, string?, string?, string?, string?, string?]> = T['length'] extends C['length'] ? (C[0] extends T[0] ? C[1] extends T[1] ? C[2] extends T[2] ? C[3] extends T[3] ? C[4] extends T[4] ? C[5] extends T[5] ? C[6] extends T[6] ? C[7] extends T[7] ? C[8] extends T[8] ? true : false : false : false : false : false : false : false : false : false) : false;
 /**
  * Gives all API Paths that matches the path. Basically the reverse operation of TemplatifyPath
  *
@@ -13496,7 +13498,7 @@ type MatchSegments<Template extends string[], Concrete extends string[]> = Templ
  * -> "/riot/account/v1/accounts/by-riot-id/{gameName}/{tagLine}"
  */
 type ResolveTemplatePath<Path extends TemplatePaths> = {
-    [P in Paths]: MatchSegments<SplitPath<TemplatifyPath<P>>, SplitPath<Path>> extends true ? P : never;
+    [P in Paths]: MatchSegments<SplitPath<TemplatifyPathRecursive<P>>, SplitPath<Path>> extends true ? P : never;
 }[Paths];
 type HTTPMethods = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace';
 /**
@@ -13597,7 +13599,7 @@ interface CreateRiotFetchOptions<FetchOptions, ThrowOnError extends boolean> {
     /** The Api Key obtained from Riot Games */
     apiKey: string;
     /** fetch function that gets called (default: `undici.fetch`) */
-    fetchFn?: (request: string, fetchOptions: FetchOptions) => Promise<Response>;
+    fetchFn?: (request: URL | RequestInfo, fetchOptions: FetchOptions) => Promise<Response>;
     /** Function for dynamically creating the base url based on the given region. (default: standard riot api) */
     baseUrl?: (region: string) => string;
     /**
@@ -13626,5 +13628,41 @@ declare function createRiotFetch<FetchOptions extends BaseFetchOptions & Record<
     region: GetSubdomain<ResolveTemplatePath<Path>>;
     method?: UsableMethods;
 } & GetRequestBody<ResolveTemplatePath<Path>, Extract<ChosenMethod, HTTPMethods>> & GetQuery<ResolveTemplatePath<Path>, Extract<ChosenMethod, HTTPMethods>>) => Promise<RiotFetchReturn<Path, Extract<ChosenMethod, HTTPMethods>, ThrowOnError, true> | RiotFetchReturn<Path, Extract<ChosenMethod, HTTPMethods>, ThrowOnError, false>>;
+declare const Queues: {
+    readonly CUSTOM: 0;
+    readonly HEXAKILL: 75;
+    readonly URF: readonly [76, 1900];
+    readonly AR_URF: 900;
+    readonly ARAM: {
+        readonly BUTCHERS_BRIDGE: 100;
+        readonly HOWLING_ABYSS: 450;
+        readonly ALL: readonly [100, 450];
+    };
+    readonly ALL_RANDOM: 325;
+    readonly BLIND: 430;
+    readonly DRAFT: 400;
+    readonly QUICKPLAY: 490;
+    readonly RANKED_SOLO: 420;
+    readonly RANKED_FLEX: 440;
+    readonly CLASH: {
+        readonly SUMMONERS_RIFT: 700;
+        readonly HOWLING_ABYSS: 720;
+        readonly ARAM: 720;
+        readonly ALL: readonly [700, 720];
+    };
+    readonly COOP_VS_AI: {
+        readonly INTRO: 870;
+        readonly BEGINNER: 880;
+        readonly INTERMEDIATE: 890;
+        readonly ALL: readonly [870, 880, 890];
+    };
+    readonly DOOM_BOTS: 960;
+    readonly ONE_FOR_ALL: 1020;
+    readonly NEXUS_BLITZ: 1300;
+    readonly SPELLBOOK: 1400;
+    readonly ARENA: readonly [1700, 1710];
+    readonly SWARM: readonly [1810, 1820, 1830, 1840];
+    readonly TUTORIAL: readonly [2000, 2010, 2020];
+};
 
-export { type $defs, type AccountRegion, type BaseFetchOptions, type CreateRiotFetchOptions, type GetQuery, type GetRequestBody, type GetResponseBody, type GetResponses, type GetSubdomain, type HTTPMethods, type LolRegion, type LorRegion, type MatchRegion, type MatchSegments, type Methods, type Paths, type ResolveTemplatePath, RiotError, type RiotErrorData, type RiotFetchReturn, type SplitPath, type TemplatePaths, type TemplatifyPath, type ValorantRegion, type components, createRiotFetch, type operations, type paths, type webhooks };
+export { type $defs, type AccountRegion, type BaseFetchOptions, type CreateRiotFetchOptions, type GetQuery, type GetRequestBody, type GetResponseBody, type GetResponses, type GetSubdomain, type HTTPMethods, type LolRegion, type LorRegion, type MatchRegion, type MatchSegments, type MatchSegmentsRecursive, type Methods, type Paths, Queues, type ResolveTemplatePath, RiotError, type RiotErrorData, type RiotFetchReturn, type SplitPath, type SplitPathRecursive, type TemplatePaths, type TemplatifyPathRecursive, type ValorantRegion, type components, createRiotFetch, type operations, type paths, type webhooks };

package/dist/index.js

@@ -36,10 +36,11 @@ function createRiotFetch({
   defaultOptions.headers = headers;
   return async (request, options) => {
     const baseURL = baseUrl(options.region);
-    let req = new URL(request, baseURL).toString();
+    const req = new URL(request, baseURL);
     if (options.query) {
-      const query = Object.entries(options.query).map(([key, value]) => [key, String(value)]);
-      req += new URLSearchParams(query).toString();
+      for (const [key, value] of Object.entries(options.query)) {
+        req.searchParams.set(key, String(value));
+      }
     }
     const response = await fetchFn(req, {
       ...defaultOptions,
@@ -68,7 +69,44 @@ function createRiotFetch({
     };
   };
 }
+var Queues = {
+  CUSTOM: 0,
+  HEXAKILL: 75,
+  URF: [76, 1900],
+  AR_URF: 900,
+  ARAM: {
+    BUTCHERS_BRIDGE: 100,
+    HOWLING_ABYSS: 450,
+    ALL: [100, 450]
+  },
+  ALL_RANDOM: 325,
+  BLIND: 430,
+  DRAFT: 400,
+  QUICKPLAY: 490,
+  RANKED_SOLO: 420,
+  RANKED_FLEX: 440,
+  CLASH: {
+    SUMMONERS_RIFT: 700,
+    HOWLING_ABYSS: 720,
+    ARAM: 720,
+    ALL: [700, 720]
+  },
+  COOP_VS_AI: {
+    INTRO: 870,
+    BEGINNER: 880,
+    INTERMEDIATE: 890,
+    ALL: [870, 880, 890]
+  },
+  DOOM_BOTS: 960,
+  ONE_FOR_ALL: 1020,
+  NEXUS_BLITZ: 1300,
+  SPELLBOOK: 1400,
+  ARENA: [1700, 1710],
+  SWARM: [1810, 1820, 1830, 1840],
+  TUTORIAL: [2e3, 2010, 2020]
+};
 export {
+  Queues,
   RiotError,
   createRiotFetch
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { paths, components } from './types/openapi.d.js';\n\nexport * from './types/openapi.d.js';\n\n\n/** Every possible API path, based on the OpenAPI document */\nexport type Paths = keyof paths;\n\n/**\n * Type util that replaces all occurences of curly brackets pairs in a string literal type to string placeholders,\n * resulting in a template literal type. For that it recursively tests the string for curly bracket pairs.\n *\n * @example TemplatifyPath<'summoner/{summonerName}/ranked'> -> `summoner/${string}/ranked`\n */\nexport type TemplatifyPath<Path extends string> =\n\tPath extends `${infer Start}/{${string}}${infer End}`\n\t\t? `${Start}/${string}${TemplatifyPath<End>}`\n\t\t: Path;\n\n\n/** Every possible API path, but templatified */\nexport type TemplatePaths = TemplatifyPath<Paths>;\n\n/** Splits a Path by `/` into an array */\nexport type SplitPath<Path extends string> = Path extends `${infer Head}/${infer Tail}`\n\t? [Head, ...SplitPath<Tail>]\n\t: [Path];\n\n/**\n * Compares two splitted paths.\n *\n * Type is true if both splitted paths have the same length and every segment of Concrete extends its corresponding segment Template\n * */\nexport type MatchSegments<Template extends string[], Concrete extends string[]> =\n  Template extends [infer TemplateSegment, ...infer TemplateRest]\n  \t? Concrete extends [infer ConcreteSegment, ...infer ConcreteRest]\n  \t\t? ConcreteSegment extends TemplateSegment\n  \t\t\t? TemplateRest extends string[]\n  \t\t\t\t? ConcreteRest extends string[]\n  \t\t\t\t\t? MatchSegments<TemplateRest, ConcreteRest>\n  \t\t\t\t\t: never\n  \t\t\t\t: never\n  \t\t\t: false\n  \t\t: Concrete extends []\n  \t\t\t? Template extends []\n  \t\t\t\t? true\n  \t\t\t\t: false\n  \t\t\t: false\n  \t: Template extends []\n  \t\t? Concrete extends []\n  \t\t\t? true\n  \t\t\t: false\n  \t\t: false;\n\n/**\n * Gives all API Paths that matches the path. Basically the reverse operation of TemplatifyPath\n *\n * @example ResolveTemplatePath<`/riot/account/v1/accounts/by-puuid/${string}`>\n * -> \"/riot/account/v1/accounts/by-puuid/{puuid}\"\n *\n * @example ResolveTemplatePath<`/riot/account/v1/accounts/by-riot-id/gameName/gameTag`>\n * -> \"/riot/account/v1/accounts/by-riot-id/{gameName}/{tagLine}\"\n */\nexport type ResolveTemplatePath<Path extends TemplatePaths> = {\n\t[P in Paths]: MatchSegments<SplitPath<TemplatifyPath<P>>, SplitPath<Path>> extends true ? P : never\n}[Paths];\n\nexport type HTTPMethods = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace';\n\n/**\n * Get all available methods for a specific API path\n */\nexport type Methods<Path extends Paths> = Exclude<keyof {\n\t[K in keyof paths[Path] as paths[Path][K] extends undefined ? never : K]: paths[Path][K]\n}, 'parameters'>;\n\n/** Get all possible responses for a specific API path and method */\nexport type GetResponses<Path extends Paths, Method extends Methods<Path>> =\n\tpaths[Path][Method] extends { responses: infer Responses }\n\t\t? Responses\n\t\t: never;\n\n\n/** Get the response body for a specific API path, method and status code */\nexport type GetResponseBody<Path extends Paths, Method extends Methods<Path>, StatusCode extends number> =\n\tGetResponses<Path, Method> extends Record<StatusCode, { content?: { 'application/json': infer Body } }>\n\t\t? Body\n\t\t: never;\n\n\nexport type GetRequestBody<Path extends Paths, Method extends Methods<Path>> =\n  paths[Path][Method] extends { requestBody?: never }\n  \t? { body?: never }\n  \t: paths[Path][Method] extends { requestBody: { content: { 'application/json': infer U } } }\n  \t\t? { body: U }\n  \t\t: paths[Path][Method] extends { requestBody?: { content: { 'application/json': infer U } } }\n  \t\t\t? { body?: U }\n  \t\t\t: unknown;\n\n\n/** Get the query parameters for a specific API path and method */\nexport type GetQuery<Path extends Paths, Method extends Methods<Path>> =\n  Pick<paths[Path][Method]['parameters'], 'query'>;\n\n\n/** Regions for /riot/account/ endpoints */\nexport type AccountRegion =  'americas' | 'asia' | 'europe';\n/** Regions for some lol and tft endpoints */\nexport type LolRegion = 'br1' | 'eun1' | 'euw1' | 'jp1' | 'kr' | 'la1' | 'la2' | 'me1' | 'na1' | 'oc1' | 'ph2' | 'ru' | 'sg2' | 'th2' | 'tr1' | 'tw2' | 'vn2';\n/** Regions for lol and tft matches endpoints */\nexport type MatchRegion = 'americas' | 'asia' | 'europe' | 'sea';\n/** Regions for /lor/ endpoints */\nexport type LorRegion = 'americas' | 'europe' | 'sea';\n/** Regions for /val/ endpoints */\nexport type ValorantRegion = 'ap' | 'br' | 'eu' | 'latam' | 'na' | 'esports' | 'kr';\n\n\n/** Get the relevant subdomains, depending on the endpoint */\n// i dont like eslint indenting here\n/* eslint-disable @stylistic/indent */\nexport type GetSubdomain<Path extends TemplatePaths> =\n\tPath extends `/riot/account/${string}` ? AccountRegion :\n\tPath extends `/lol/champion-mastery/${string}` ? LolRegion :\n\tPath extends `/lol/platform/${string}` ? LolRegion :\n\tPath extends `/lol/clash/${string}` ? LolRegion :\n\tPath extends `/lol/league-exp/${string}` ? LolRegion :\n\tPath extends `/lol/league/${string}` ? LolRegion :\n\tPath extends `/lol/challenges/${string}` ? LolRegion :\n\tPath extends `/lol/rso-match/${string}` ? MatchRegion :\n\tPath extends `/lol/status/${string}` ? LolRegion :\n\tPath extends `/lor/deck/${string}` ? LorRegion :\n\tPath extends `/lor/inventory/${string}` ? LorRegion :\n\tPath extends `/lor/match/${string}` ? LorRegion | 'apac' :\n\tPath extends `/lor/ranked/${string}` ? LorRegion :\n\tPath extends `/lor/status/${string}` ? LorRegion :\n\tPath extends `/lol/match/${string}` ? MatchRegion :\n\tPath extends `/lol/spectator/${string}` ? LolRegion :\n\tPath extends `/fulfillment/${string}` ? LolRegion :\n\tPath extends `/lol/summoner/${string}` ? LolRegion :\n\tPath extends `/tft/league/${string}` ? LolRegion :\n\tPath extends `/tft/match/${string}` ? MatchRegion | 'esports' | 'esportseu' :\n\tPath extends `/tft/status/${string}` ? LolRegion :\n\tPath extends `/tft/summoner/${string}` ? LolRegion :\n\t// seems like only americas but not sure\n\tPath extends `/lol/tournament-stub/${string}` ? 'americas' :\n\t// don't know, can't see in api reference\n\tPath extends `/lol/tournament/${string}` ? LolRegion | MatchRegion :\n\t// The api docs do not include all regions for console, but for stability we will just include them\n\tPath extends `/val/match/console/${string}` ? ValorantRegion :\n\tPath extends `/val/console/ranked/${string}` ? ValorantRegion :\n\tPath extends `/val/content/${string}` ? ValorantRegion :\n\tPath extends `/val/match/${string}` ? ValorantRegion :\n\tPath extends `/val/ranked/${string}` ? ValorantRegion :\n\tPath extends `/val/status/${string}` ? Exclude<ValorantRegion, 'esports'>\n\t: never;\n/* eslint-enable @stylistic/indent */\n\n/** Typical structure for a RiotError json object. */\nexport type RiotErrorData = components['schemas']['Error'];\n\n/**\n * Error Class for a 4xx/5xx response code in a fetch to the Riot API\n */\nexport class RiotError extends Error {\n\tconstructor(message: string, statusCode: number, data?: RiotErrorData) {\n\t\tsuper(message);\n\t\tthis.statusCode = statusCode;\n\t\tthis.data = data;\n\t}\n\tstatusCode: number;\n\tdata: RiotErrorData | undefined;\n}\n\n/**\n * Type guard to check if an object is in the form of an riot error.\n * The API may return a structure like that on error, but we cannot be sure.\n *\n * @param obj obj to be checked\n * @returns true if obj has the form of RiotErroData\n */\nfunction isRiotErrorData(obj: unknown): obj is RiotErrorData {\n\tif (typeof obj !== 'object' || obj === null) return false;\n\n\tconst data = obj as RiotErrorData;\n\n\tif (data.status !== undefined) {\n\t\tif (typeof data.status !== 'object') {\n\t\t\treturn false;\n\t\t}\n\n\t\tif ('status_code' in data.status && typeof data.status.status_code !== 'number')\t\t{\n\t\t\treturn false;\n\t\t}\n\n\t\tif ('message' in data.status && typeof data.status.message !== 'string')\t\t{\n\t\t\treturn false;\n\t\t}\n\t}\n\n\treturn true;\n}\n\n\n/**\n * This is a mess. I am sorry for this type abonimation.\n *\n * @template Path the Path of the API route\n * @template ChosenMethod the Method that is chosen, has to be one of the available methods of the Path\n * @template ThrowOnError Wether createRiotFetch is configured to throw on http errors or not\n * @template error response.ok, used for type narrowing\n */\nexport type RiotFetchReturn<\n\tPath extends TemplatePaths,\n\tChosenMethod extends Methods<ResolveTemplatePath<Path>>,\n\tThrowOnError extends boolean,\n\terror extends boolean,\n> = ThrowOnError extends true\n\t? error extends false\n\t\t? {\n\t\t\t/** The response object of the fetch */\n\t\t\tresponse: Response;\n\t\t\t/** Typed result of response.json() */\n\t\t\tdata: GetResponseBody<ResolveTemplatePath<Path>, ChosenMethod, 200>;\n\t\t}\n\t\t: never\n\t: error extends false\n\t\t? {\n\t\t\t/** The response object of the fetch */\n\t\t\tresponse: Response;\n\t\t\t/** Typed result of response.json() or eventual error data */\n\t\t\tdata: GetResponseBody<ResolveTemplatePath<Path>, ChosenMethod, 200>;\n\t\t\t/** Wether the fetch errored */\n\t\t\terror: false;\n\t\t}\n\t\t: {\n\t\t\t/** The response object of the fetch */\n\t\t\tresponse: Response;\n\t\t\t/** Typed result of response.json() or eventual error data */\n\t\t\tdata:RiotErrorData | undefined;\n\t\t\t/** Wether the fetch errored */\n\t\t\terror: true;\n\t\t};\n\n/**\n * Options for the createRiotFetch functions\n * @template FetchOptions Options the fetch function can accept\n * @template ThrowOnError We set throwOnResponseError as a generic literal boolean, so that we can better type it\n */\nexport interface CreateRiotFetchOptions<FetchOptions, ThrowOnError extends boolean> {\n\t/** The Api Key obtained from Riot Games */\n\tapiKey: string\n\t/** fetch function that gets called (default: `undici.fetch`) */\n\tfetchFn?: (request: string, fetchOptions: FetchOptions) => Promise<Response>\n\t/** Function for dynamically creating the base url based on the given region. (default: standard riot api) */\n\tbaseUrl?: (region: string) => string,\n\t/**\n\t * Wether on 4xx/5xx response status the fetch should error or set error = true and include eventual error data in data\n\t * @see RiotError\n\t */\n\tthrowOnResponseError?: ThrowOnError,\n}\n\n/**\n * Basic Fetch Options that are essential for the functioning of createRiotFetch\n */\nexport interface BaseFetchOptions {\n\tmethod?: HTTPMethods,\n\theaders?: Headers,\n}\n\n/**\n * Creates a new function that basically wraps the provided fetch function to provide type information.\n *\n * @param {CreateRiotFetchOptions} createRiotFetchOptions Options for the createRiotFetch function\n * @param defaultOptions Options that get passed to the fetch function by default\n * @returns A fetch function to get fetch the Riot Games API type-safe\n */\nexport function createRiotFetch<\n\tFetchOptions extends BaseFetchOptions & Record<string, unknown>,\n\tThrowOnError extends boolean = false\n>(\n\t{\n\t\tapiKey,\n\t\tfetchFn = fetch,\n\t\tbaseUrl = (region: string) => `https://${region}.api.riotgames.com/`,\n\t\tthrowOnResponseError = false as ThrowOnError\n\t}: CreateRiotFetchOptions<FetchOptions & { body?: BodyInit }, ThrowOnError>,\n\tdefaultOptions: FetchOptions = {} as FetchOptions\n) {\n\tconst headers = new Headers(defaultOptions.headers);\n\theaders.append('X-Riot-Token', apiKey);\n\theaders.append('Content-Type', 'application/json');\n\tdefaultOptions.headers = headers;\n\n\t/**\n\t * A functions that can be used to fetch the Riot Games API with already defined defaults and type information\n\t * based on it's OpenAPI specification.\n\t *\n\t * @template Path The literal type of the path, inferred by `request`\n\t * @template UsableMethods All Methods that can be selected, used to autocomplete `method`\n\t * @template ChosenMethod The method\n\t * @param request The path of the resource requested. Gets merged using `URL`\n\t * @returns Response Object, a promise for the return body, depending on Path, Method and Status Code and an error indicator\n\t * @throws { RiotError } if `throwOnResponseError = true` and !response.ok\n\t */\n\treturn async <\n\t\tPath extends TemplatePaths,\n\t\tUsableMethods extends Methods<ResolveTemplatePath<Path>>,\n\t\tChosenMethod extends UsableMethods | undefined = 'get' extends UsableMethods ? 'get' : UsableMethods,\n\t>(\n\t\trequest: Path,\n\t\toptions: FetchOptions & {\n\t\t\tregion: GetSubdomain<ResolveTemplatePath<Path>>,\n\t\t\tmethod?: UsableMethods,\n\t\t}\n\t\t\t& GetRequestBody<ResolveTemplatePath<Path>, Extract<ChosenMethod, HTTPMethods>>\n\t\t\t& GetQuery<ResolveTemplatePath<Path>, Extract<ChosenMethod, HTTPMethods>>,\n\t) => {\n\t\tconst baseURL = baseUrl(options.region);\n\t\tlet req = new URL(request, baseURL).toString();\n\t\tif (options.query) {\n\t\t\tconst query = Object.entries(options.query).map(([key, value]) => [key, String(value)]);\n\t\t\treq += new URLSearchParams(query).toString();\n\t\t}\n\n\t\tconst response = await fetchFn(req, {\n\t\t\t...defaultOptions,\n\t\t\t...options,\n\t\t\tbody: JSON.stringify(options.body)\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tconst riotErrorData = await response.json()\n\t\t\t\t.then(obj => isRiotErrorData(obj) ? obj : undefined)\n\t\t\t\t.catch(() => undefined);\n\n\n\t\t\tif (throwOnResponseError) {\n\t\t\t\tthrow new RiotError(\n\t\t\t\t\t'Riot Games Fetch Error',\n\t\t\t\t\tresponse.status,\n\t\t\t\t\triotErrorData\n\t\t\t\t);\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\tresponse,\n\t\t\t\tdata: riotErrorData,\n\t\t\t\terror: true,\n\t\t\t} as RiotFetchReturn<Path, Extract<ChosenMethod, HTTPMethods>, ThrowOnError, true>;\n\t\t}\n\n\t\treturn {\n\t\t\tresponse,\n\t\t\tdata: await response.json() as GetResponseBody<ResolveTemplatePath<Path>, Extract<ChosenMethod, HTTPMethods>, 200>,\n\t\t\terror: false,\n\t\t} as RiotFetchReturn<Path, Extract<ChosenMethod, HTTPMethods>, ThrowOnError, false>;\n\t};\n}"],"mappings":";AAmKO,IAAM,YAAN,cAAwB,MAAM;AAAA,EACpC,YAAY,SAAiB,YAAoB,MAAsB;AACtE,UAAM,OAAO;AACb,SAAK,aAAa;AAClB,SAAK,OAAO;AAAA,EACb;AAAA,EACA;AAAA,EACA;AACD;AASA,SAAS,gBAAgB,KAAoC;AAC5D,MAAI,OAAO,QAAQ,YAAY,QAAQ,KAAM,QAAO;AAEpD,QAAM,OAAO;AAEb,MAAI,KAAK,WAAW,QAAW;AAC9B,QAAI,OAAO,KAAK,WAAW,UAAU;AACpC,aAAO;AAAA,IACR;AAEA,QAAI,iBAAiB,KAAK,UAAU,OAAO,KAAK,OAAO,gBAAgB,UAAW;AACjF,aAAO;AAAA,IACR;AAEA,QAAI,aAAa,KAAK,UAAU,OAAO,KAAK,OAAO,YAAY,UAAW;AACzE,aAAO;AAAA,IACR;AAAA,EACD;AAEA,SAAO;AACR;AA6EO,SAAS,gBAIf;AAAA,EACC;AAAA,EACA,UAAU;AAAA,EACV,UAAU,CAAC,WAAmB,WAAW,MAAM;AAAA,EAC/C,uBAAuB;AACxB,GACA,iBAA+B,CAAC,GAC/B;AACD,QAAM,UAAU,IAAI,QAAQ,eAAe,OAAO;AAClD,UAAQ,OAAO,gBAAgB,MAAM;AACrC,UAAQ,OAAO,gBAAgB,kBAAkB;AACjD,iBAAe,UAAU;AAazB,SAAO,OAKN,SACA,YAMI;AACJ,UAAM,UAAU,QAAQ,QAAQ,MAAM;AACtC,QAAI,MAAM,IAAI,IAAI,SAAS,OAAO,EAAE,SAAS;AAC7C,QAAI,QAAQ,OAAO;AAClB,YAAM,QAAQ,OAAO,QAAQ,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,OAAO,KAAK,CAAC,CAAC;AACtF,aAAO,IAAI,gBAAgB,KAAK,EAAE,SAAS;AAAA,IAC5C;AAEA,UAAM,WAAW,MAAM,QAAQ,KAAK;AAAA,MACnC,GAAG;AAAA,MACH,GAAG;AAAA,MACH,MAAM,KAAK,UAAU,QAAQ,IAAI;AAAA,IAClC,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AACjB,YAAM,gBAAgB,MAAM,SAAS,KAAK,EACxC,KAAK,SAAO,gBAAgB,GAAG,IAAI,MAAM,MAAS,EAClD,MAAM,MAAM,MAAS;AAGvB,UAAI,sBAAsB;AACzB,cAAM,IAAI;AAAA,UACT;AAAA,UACA,SAAS;AAAA,UACT;AAAA,QACD;AAAA,MACD;AAEA,aAAO;AAAA,QACN;AAAA,QACA,MAAM;AAAA,QACN,OAAO;AAAA,MACR;AAAA,IACD;AAEA,WAAO;AAAA,MACN;AAAA,MACA,MAAM,MAAM,SAAS,KAAK;AAAA,MAC1B,OAAO;AAAA,IACR;AAAA,EACD;AACD;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { paths, components } from './types/openapi.d.js';\n\nexport * from './types/openapi.d.js';\n\n\n/** Every possible API path, based on the OpenAPI document */\nexport type Paths = keyof paths;\n\n/**\n * Type util that replaces all occurences of curly brackets pairs in a string literal type to string placeholders,\n * resulting in a template literal type. For that it recursively tests the string for curly bracket pairs.\n *\n * @example TemplatifyPath<'summoner/{summonerName}/ranked'> -> `summoner/${string}/ranked`\n */\nexport type TemplatifyPathRecursive<Path extends string> =\n\tPath extends `${infer Start}/{${string}}${infer End}`\n\t\t? `${Start}/${string}${TemplatifyPathRecursive<End>}`\n\t\t: Path;\n\n\n/** Every possible API path, but templatified */\nexport type TemplatePaths = TemplatifyPathRecursive<Paths>;\n\n/** Splits a Path by `/` into an array */\nexport type SplitPathRecursive<Path extends string> = Path extends `${infer Head}/${infer Tail}`\n\t? [Head, ...SplitPathRecursive<Tail>]\n\t: [Path];\n\nexport type SplitPath<Path extends string> =\n  Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}/${infer F}/${infer G}/${infer H}/${infer I}`\n  \t? [A, B, C, D, E, F, G, H, I]\n  \t: Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}/${infer F}/${infer G}/${infer H}`\n  \t\t? [A, B, C, D, E, F, G, H]\n  \t\t: Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}/${infer F}/${infer G}`\n  \t\t\t? [A, B, C, D, E, F, G]\n  \t\t\t: Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}/${infer F}`\n  \t\t\t\t? [A, B, C, D, E, F]\n  \t\t\t\t: Path extends `${infer A}/${infer B}/${infer C}/${infer D}/${infer E}`\n  \t\t\t\t\t? [A, B, C, D, E]\n  \t\t\t\t\t: Path extends `${infer A}/${infer B}/${infer C}/${infer D}`\n  \t\t\t\t\t\t? [A, B, C, D]\n  \t\t\t\t\t\t: Path extends `${infer A}/${infer B}/${infer C}`\n  \t\t\t\t\t\t\t? [A, B, C]\n  \t\t\t\t\t\t\t: Path extends `${infer A}/${infer B}`\n  \t\t\t\t\t\t\t\t? [A, B]\n  \t\t\t\t\t\t\t\t: [Path];\n\n/**\n * Compares two splitted paths.\n *\n * Type is true if both splitted paths have the same length and every segment of Concrete extends its corresponding segment Template\n * */\nexport type MatchSegmentsRecursive<Template extends string[], Concrete extends string[]> =\n  Template extends [infer TemplateSegment, ...infer TemplateRest]\n  \t? Concrete extends [infer ConcreteSegment, ...infer ConcreteRest]\n  \t\t? ConcreteSegment extends TemplateSegment\n  \t\t\t? TemplateRest extends string[]\n  \t\t\t\t? ConcreteRest extends string[]\n  \t\t\t\t\t? MatchSegmentsRecursive<TemplateRest, ConcreteRest>\n  \t\t\t\t\t: never\n  \t\t\t\t: never\n  \t\t\t: false\n  \t\t: Concrete extends []\n  \t\t\t? Template extends []\n  \t\t\t\t? true\n  \t\t\t\t: false\n  \t\t\t: false\n  \t: Template extends []\n  \t\t? Concrete extends []\n  \t\t\t? true\n  \t\t\t: false\n  \t\t: false;\n\nexport type MatchSegments<\n\tT extends [string?, string?, string?, string?, string?, string?, string?, string?, string?],\n\tC extends [string?, string?, string?, string?, string?, string?, string?, string?, string?]\n> =\n  T['length'] extends C['length'] ? (\n  \tC[0] extends T[0] ?\n  \t\tC[1] extends T[1] ?\n  \t\t\tC[2] extends T[2] ?\n  \t\t\t\tC[3] extends T[3] ?\n  \t\t\t\t\tC[4] extends T[4] ?\n  \t\t\t\t\t\tC[5] extends T[5] ?\n  \t\t\t\t\t\t\tC[6] extends T[6] ?\n  \t\t\t\t\t\t\t\tC[7] extends T[7] ?\n  \t\t\t\t\t\t\t\t\tC[8] extends T[8] ?\n  \t\t\t\t\t\t\t\t\t\ttrue :\n  \t\t\t\t\t\t\t\t\t\tfalse :\n  \t\t\t\t\t\t\t\t\tfalse :\n  \t\t\t\t\t\t\t\tfalse :\n  \t\t\t\t\t\t\tfalse :\n  \t\t\t\t\t\tfalse :\n  \t\t\t\t\tfalse :\n  \t\t\t\tfalse :\n  \t\t\tfalse :\n  \t\tfalse\n  )\n  \t: false;\n\n/**\n * Gives all API Paths that matches the path. Basically the reverse operation of TemplatifyPath\n *\n * @example ResolveTemplatePath<`/riot/account/v1/accounts/by-puuid/${string}`>\n * -> \"/riot/account/v1/accounts/by-puuid/{puuid}\"\n *\n * @example ResolveTemplatePath<`/riot/account/v1/accounts/by-riot-id/gameName/gameTag`>\n * -> \"/riot/account/v1/accounts/by-riot-id/{gameName}/{tagLine}\"\n */\nexport type ResolveTemplatePath<Path extends TemplatePaths> = {\n\t[P in Paths]: MatchSegments<SplitPath<TemplatifyPathRecursive<P>>, SplitPath<Path>> extends true ? P : never\n}[Paths];\n\nexport type HTTPMethods = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace';\n\n/**\n * Get all available methods for a specific API path\n */\nexport type Methods<Path extends Paths> = Exclude<keyof {\n\t[K in keyof paths[Path] as paths[Path][K] extends undefined ? never : K]: paths[Path][K]\n}, 'parameters'>;\n\n/** Get all possible responses for a specific API path and method */\nexport type GetResponses<Path extends Paths, Method extends Methods<Path>> =\n\tpaths[Path][Method] extends { responses: infer Responses }\n\t\t? Responses\n\t\t: never;\n\n\n/** Get the response body for a specific API path, method and status code */\nexport type GetResponseBody<Path extends Paths, Method extends Methods<Path>, StatusCode extends number> =\n\tGetResponses<Path, Method> extends Record<StatusCode, { content?: { 'application/json': infer Body } }>\n\t\t? Body\n\t\t: never;\n\n\nexport type GetRequestBody<Path extends Paths, Method extends Methods<Path>> =\n  paths[Path][Method] extends { requestBody?: never }\n  \t? { body?: never }\n  \t: paths[Path][Method] extends { requestBody: { content: { 'application/json': infer U } } }\n  \t\t? { body: U }\n  \t\t: paths[Path][Method] extends { requestBody?: { content: { 'application/json': infer U } } }\n  \t\t\t? { body?: U }\n  \t\t\t: unknown;\n\n\n/** Get the query parameters for a specific API path and method */\nexport type GetQuery<Path extends Paths, Method extends Methods<Path>> = Pick<paths[Path][Method]['parameters'], 'query'>;\n\n/** Regions for /riot/account/ endpoints */\nexport type AccountRegion =  'americas' | 'asia' | 'europe';\n/** Regions for some lol and tft endpoints */\nexport type LolRegion = 'br1' | 'eun1' | 'euw1' | 'jp1' | 'kr' | 'la1' | 'la2' | 'me1' | 'na1' | 'oc1' | 'ph2' | 'ru' | 'sg2' | 'th2' | 'tr1' | 'tw2' | 'vn2';\n/** Regions for lol and tft matches endpoints */\nexport type MatchRegion = 'americas' | 'asia' | 'europe' | 'sea';\n/** Regions for /lor/ endpoints */\nexport type LorRegion = 'americas' | 'europe' | 'sea';\n/** Regions for /val/ endpoints */\nexport type ValorantRegion = 'ap' | 'br' | 'eu' | 'latam' | 'na' | 'esports' | 'kr';\n\n\n/** Get the relevant subdomains, depending on the endpoint */\n// i dont like eslint indenting here\n/* eslint-disable @stylistic/indent */\nexport type GetSubdomain<Path extends TemplatePaths> =\n\tPath extends `/riot/account/${string}` ? AccountRegion :\n\tPath extends `/lol/champion-mastery/${string}` ? LolRegion :\n\tPath extends `/lol/platform/${string}` ? LolRegion :\n\tPath extends `/lol/clash/${string}` ? LolRegion :\n\tPath extends `/lol/league-exp/${string}` ? LolRegion :\n\tPath extends `/lol/league/${string}` ? LolRegion :\n\tPath extends `/lol/challenges/${string}` ? LolRegion :\n\tPath extends `/lol/rso-match/${string}` ? MatchRegion :\n\tPath extends `/lol/status/${string}` ? LolRegion :\n\tPath extends `/lor/deck/${string}` ? LorRegion :\n\tPath extends `/lor/inventory/${string}` ? LorRegion :\n\tPath extends `/lor/match/${string}` ? LorRegion | 'apac' :\n\tPath extends `/lor/ranked/${string}` ? LorRegion :\n\tPath extends `/lor/status/${string}` ? LorRegion :\n\tPath extends `/lol/match/${string}` ? MatchRegion :\n\tPath extends `/lol/spectator/${string}` ? LolRegion :\n\tPath extends `/fulfillment/${string}` ? LolRegion :\n\tPath extends `/lol/summoner/${string}` ? LolRegion :\n\tPath extends `/tft/league/${string}` ? LolRegion :\n\tPath extends `/tft/match/${string}` ? MatchRegion | 'esports' | 'esportseu' :\n\tPath extends `/tft/status/${string}` ? LolRegion :\n\tPath extends `/tft/summoner/${string}` ? LolRegion :\n\t// seems like only americas but not sure\n\tPath extends `/lol/tournament-stub/${string}` ? 'americas' :\n\t// don't know, can't see in api reference\n\tPath extends `/lol/tournament/${string}` ? LolRegion | MatchRegion :\n\t// The api docs do not include all regions for console, but for stability we will just include them\n\tPath extends `/val/match/console/${string}` ? ValorantRegion :\n\tPath extends `/val/console/ranked/${string}` ? ValorantRegion :\n\tPath extends `/val/content/${string}` ? ValorantRegion :\n\tPath extends `/val/match/${string}` ? ValorantRegion :\n\tPath extends `/val/ranked/${string}` ? ValorantRegion :\n\tPath extends `/val/status/${string}` ? Exclude<ValorantRegion, 'esports'>\n\t: never;\n/* eslint-enable @stylistic/indent */\n\n/** Typical structure for a RiotError json object. */\nexport type RiotErrorData = components['schemas']['Error'];\n\n/**\n * Error Class for a 4xx/5xx response code in a fetch to the Riot API\n */\nexport class RiotError extends Error {\n\tconstructor(message: string, statusCode: number, data?: RiotErrorData) {\n\t\tsuper(message);\n\t\tthis.statusCode = statusCode;\n\t\tthis.data = data;\n\t}\n\tstatusCode: number;\n\tdata: RiotErrorData | undefined;\n}\n\n/**\n * Type guard to check if an object is in the form of an riot error.\n * The API may return a structure like that on error, but we cannot be sure.\n *\n * @param obj obj to be checked\n * @returns true if obj has the form of RiotErroData\n */\nfunction isRiotErrorData(obj: unknown): obj is RiotErrorData {\n\tif (typeof obj !== 'object' || obj === null) return false;\n\n\tconst data = obj as RiotErrorData;\n\n\tif (data.status !== undefined) {\n\t\tif (typeof data.status !== 'object') {\n\t\t\treturn false;\n\t\t}\n\n\t\tif ('status_code' in data.status && typeof data.status.status_code !== 'number')\t\t{\n\t\t\treturn false;\n\t\t}\n\n\t\tif ('message' in data.status && typeof data.status.message !== 'string')\t\t{\n\t\t\treturn false;\n\t\t}\n\t}\n\n\treturn true;\n}\n\n\n/**\n * This is a mess. I am sorry for this type abonimation.\n *\n * @template Path the Path of the API route\n * @template ChosenMethod the Method that is chosen, has to be one of the available methods of the Path\n * @template ThrowOnError Wether createRiotFetch is configured to throw on http errors or not\n * @template error response.ok, used for type narrowing\n */\nexport type RiotFetchReturn<\n\tPath extends TemplatePaths,\n\tChosenMethod extends Methods<ResolveTemplatePath<Path>>,\n\tThrowOnError extends boolean,\n\terror extends boolean,\n> = ThrowOnError extends true\n\t? error extends false\n\t\t? {\n\t\t\t/** The response object of the fetch */\n\t\t\tresponse: Response;\n\t\t\t/** Typed result of response.json() */\n\t\t\tdata: GetResponseBody<ResolveTemplatePath<Path>, ChosenMethod, 200>;\n\t\t}\n\t\t: never\n\t: error extends false\n\t\t? {\n\t\t\t/** The response object of the fetch */\n\t\t\tresponse: Response;\n\t\t\t/** Typed result of response.json() or eventual error data */\n\t\t\tdata: GetResponseBody<ResolveTemplatePath<Path>, ChosenMethod, 200>;\n\t\t\t/** Wether the fetch errored */\n\t\t\terror: false;\n\t\t}\n\t\t: {\n\t\t\t/** The response object of the fetch */\n\t\t\tresponse: Response;\n\t\t\t/** Typed result of response.json() or eventual error data */\n\t\t\tdata:RiotErrorData | undefined;\n\t\t\t/** Wether the fetch errored */\n\t\t\terror: true;\n\t\t};\n\n/**\n * Options for the createRiotFetch functions\n * @template FetchOptions Options the fetch function can accept\n * @template ThrowOnError We set throwOnResponseError as a generic literal boolean, so that we can better type it\n */\nexport interface CreateRiotFetchOptions<FetchOptions, ThrowOnError extends boolean> {\n\t/** The Api Key obtained from Riot Games */\n\tapiKey: string\n\t/** fetch function that gets called (default: `undici.fetch`) */\n\tfetchFn?: (request: URL | RequestInfo, fetchOptions: FetchOptions) => Promise<Response>\n\t/** Function for dynamically creating the base url based on the given region. (default: standard riot api) */\n\tbaseUrl?: (region: string) => string,\n\t/**\n\t * Wether on 4xx/5xx response status the fetch should error or set error = true and include eventual error data in data\n\t * @see RiotError\n\t */\n\tthrowOnResponseError?: ThrowOnError,\n}\n\n/**\n * Basic Fetch Options that are essential for the functioning of createRiotFetch\n */\nexport interface BaseFetchOptions {\n\tmethod?: HTTPMethods,\n\theaders?: Headers,\n}\n\n/**\n * Creates a new function that basically wraps the provided fetch function to provide type information.\n *\n * @param {CreateRiotFetchOptions} createRiotFetchOptions Options for the createRiotFetch function\n * @param defaultOptions Options that get passed to the fetch function by default\n * @returns A fetch function to get fetch the Riot Games API type-safe\n */\nexport function createRiotFetch<\n\tFetchOptions extends BaseFetchOptions & Record<string, unknown>,\n\tThrowOnError extends boolean = false\n>(\n\t{\n\t\tapiKey,\n\t\tfetchFn = fetch,\n\t\tbaseUrl = (region: string) => `https://${region}.api.riotgames.com/`,\n\t\tthrowOnResponseError = false as ThrowOnError\n\t}: CreateRiotFetchOptions<FetchOptions & { body?: BodyInit }, ThrowOnError>,\n\tdefaultOptions: FetchOptions = {} as FetchOptions\n) {\n\tconst headers = new Headers(defaultOptions.headers);\n\theaders.append('X-Riot-Token', apiKey);\n\theaders.append('Content-Type', 'application/json');\n\tdefaultOptions.headers = headers;\n\n\t/**\n\t * A functions that can be used to fetch the Riot Games API with already defined defaults and type information\n\t * based on it's OpenAPI specification.\n\t *\n\t * @template Path The literal type of the path, inferred by `request`\n\t * @template UsableMethods All Methods that can be selected, used to autocomplete `method`\n\t * @template ChosenMethod The method\n\t * @param request The path of the resource requested. Gets merged using `URL`\n\t * @returns Response Object, a promise for the return body, depending on Path, Method and Status Code and an error indicator\n\t * @throws { RiotError } if `throwOnResponseError = true` and !response.ok\n\t */\n\treturn async <\n\t\tPath extends TemplatePaths,\n\t\tUsableMethods extends Methods<ResolveTemplatePath<Path>>,\n\t\tChosenMethod extends UsableMethods | undefined = 'get' extends UsableMethods ? 'get' : UsableMethods,\n\t>(\n\t\trequest: Path,\n\t\toptions: FetchOptions & {\n\t\t\tregion: GetSubdomain<ResolveTemplatePath<Path>>,\n\t\t\tmethod?: UsableMethods,\n\t\t}\n\t\t\t& GetRequestBody<ResolveTemplatePath<Path>, Extract<ChosenMethod, HTTPMethods>>\n\t\t\t& GetQuery<ResolveTemplatePath<Path>, Extract<ChosenMethod, HTTPMethods>>,\n\t): Promise<\n\tRiotFetchReturn<Path, Extract<ChosenMethod, HTTPMethods>, ThrowOnError, true>\n\t|\tRiotFetchReturn<Path, Extract<ChosenMethod, HTTPMethods>, ThrowOnError, false>\n\t> => {\n\t\tconst baseURL = baseUrl(options.region);\n\t\tconst req = new URL(request, baseURL);\n\t\tif (options.query) {\n\t\t\tfor (const [key, value] of Object.entries(options.query)) {\n\t\t\t\treq.searchParams.set(key, String(value));\n\t\t\t}\n\t\t}\n\n\t\tconst response = await fetchFn(req, {\n\t\t\t...defaultOptions,\n\t\t\t...options,\n\t\t\tbody: JSON.stringify(options.body)\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tconst riotErrorData = await response.json()\n\t\t\t\t.then(obj => isRiotErrorData(obj) ? obj : undefined)\n\t\t\t\t.catch(() => undefined);\n\n\n\t\t\tif (throwOnResponseError) {\n\t\t\t\tthrow new RiotError(\n\t\t\t\t\t'Riot Games Fetch Error',\n\t\t\t\t\tresponse.status,\n\t\t\t\t\triotErrorData\n\t\t\t\t);\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\tresponse,\n\t\t\t\tdata: riotErrorData,\n\t\t\t\terror: true,\n\t\t\t} as RiotFetchReturn<Path, Extract<ChosenMethod, HTTPMethods>, ThrowOnError, true>;\n\t\t}\n\n\t\treturn {\n\t\t\tresponse,\n\t\t\tdata: await response.json() as GetResponseBody<ResolveTemplatePath<Path>, Extract<ChosenMethod, HTTPMethods>, 200>,\n\t\t\terror: false,\n\t\t} as RiotFetchReturn<Path, Extract<ChosenMethod, HTTPMethods>, ThrowOnError, false>;\n\t};\n}\n\nexport const Queues = {\n\tCUSTOM: 0,\n\tHEXAKILL: 75,\n\tURF: [76, 1900],\n\tAR_URF: 900,\n\tARAM: {\n\t\tBUTCHERS_BRIDGE: 100,\n\t\tHOWLING_ABYSS: 450,\n\t\tALL: [100, 450]\n\t},\n\tALL_RANDOM: 325,\n\tBLIND: 430,\n\tDRAFT: 400,\n\tQUICKPLAY: 490,\n\tRANKED_SOLO: 420,\n\tRANKED_FLEX: 440,\n\tCLASH: {\n\t\tSUMMONERS_RIFT: 700,\n\t\tHOWLING_ABYSS: 720,\n\t\tARAM: 720,\n\t\tALL: [700, 720]\n\t},\n\tCOOP_VS_AI: {\n\t\tINTRO: 870,\n\t\tBEGINNER: 880,\n\t\tINTERMEDIATE: 890,\n\t\tALL: [870, 880, 890],\n\t},\n\tDOOM_BOTS: 960,\n\tONE_FOR_ALL: 1020,\n\tNEXUS_BLITZ: 1300,\n\tSPELLBOOK: 1400,\n\tARENA: [1700, 1710],\n\tSWARM: [1810, 1820, 1830, 1840],\n\tTUTORIAL: [2000, 2010, 2020]\n} as const;"],"mappings":";AA+MO,IAAM,YAAN,cAAwB,MAAM;AAAA,EACpC,YAAY,SAAiB,YAAoB,MAAsB;AACtE,UAAM,OAAO;AACb,SAAK,aAAa;AAClB,SAAK,OAAO;AAAA,EACb;AAAA,EACA;AAAA,EACA;AACD;AASA,SAAS,gBAAgB,KAAoC;AAC5D,MAAI,OAAO,QAAQ,YAAY,QAAQ,KAAM,QAAO;AAEpD,QAAM,OAAO;AAEb,MAAI,KAAK,WAAW,QAAW;AAC9B,QAAI,OAAO,KAAK,WAAW,UAAU;AACpC,aAAO;AAAA,IACR;AAEA,QAAI,iBAAiB,KAAK,UAAU,OAAO,KAAK,OAAO,gBAAgB,UAAW;AACjF,aAAO;AAAA,IACR;AAEA,QAAI,aAAa,KAAK,UAAU,OAAO,KAAK,OAAO,YAAY,UAAW;AACzE,aAAO;AAAA,IACR;AAAA,EACD;AAEA,SAAO;AACR;AA6EO,SAAS,gBAIf;AAAA,EACC;AAAA,EACA,UAAU;AAAA,EACV,UAAU,CAAC,WAAmB,WAAW,MAAM;AAAA,EAC/C,uBAAuB;AACxB,GACA,iBAA+B,CAAC,GAC/B;AACD,QAAM,UAAU,IAAI,QAAQ,eAAe,OAAO;AAClD,UAAQ,OAAO,gBAAgB,MAAM;AACrC,UAAQ,OAAO,gBAAgB,kBAAkB;AACjD,iBAAe,UAAU;AAazB,SAAO,OAKN,SACA,YASI;AACJ,UAAM,UAAU,QAAQ,QAAQ,MAAM;AACtC,UAAM,MAAM,IAAI,IAAI,SAAS,OAAO;AACpC,QAAI,QAAQ,OAAO;AAClB,iBAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,QAAQ,KAAK,GAAG;AACzD,YAAI,aAAa,IAAI,KAAK,OAAO,KAAK,CAAC;AAAA,MACxC;AAAA,IACD;AAEA,UAAM,WAAW,MAAM,QAAQ,KAAK;AAAA,MACnC,GAAG;AAAA,MACH,GAAG;AAAA,MACH,MAAM,KAAK,UAAU,QAAQ,IAAI;AAAA,IAClC,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AACjB,YAAM,gBAAgB,MAAM,SAAS,KAAK,EACxC,KAAK,SAAO,gBAAgB,GAAG,IAAI,MAAM,MAAS,EAClD,MAAM,MAAM,MAAS;AAGvB,UAAI,sBAAsB;AACzB,cAAM,IAAI;AAAA,UACT;AAAA,UACA,SAAS;AAAA,UACT;AAAA,QACD;AAAA,MACD;AAEA,aAAO;AAAA,QACN;AAAA,QACA,MAAM;AAAA,QACN,OAAO;AAAA,MACR;AAAA,IACD;AAEA,WAAO;AAAA,MACN;AAAA,MACA,MAAM,MAAM,SAAS,KAAK;AAAA,MAC1B,OAAO;AAAA,IACR;AAAA,EACD;AACD;AAEO,IAAM,SAAS;AAAA,EACrB,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,KAAK,CAAC,IAAI,IAAI;AAAA,EACd,QAAQ;AAAA,EACR,MAAM;AAAA,IACL,iBAAiB;AAAA,IACjB,eAAe;AAAA,IACf,KAAK,CAAC,KAAK,GAAG;AAAA,EACf;AAAA,EACA,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,OAAO;AAAA,EACP,WAAW;AAAA,EACX,aAAa;AAAA,EACb,aAAa;AAAA,EACb,OAAO;AAAA,IACN,gBAAgB;AAAA,IAChB,eAAe;AAAA,IACf,MAAM;AAAA,IACN,KAAK,CAAC,KAAK,GAAG;AAAA,EACf;AAAA,EACA,YAAY;AAAA,IACX,OAAO;AAAA,IACP,UAAU;AAAA,IACV,cAAc;AAAA,IACd,KAAK,CAAC,KAAK,KAAK,GAAG;AAAA,EACpB;AAAA,EACA,WAAW;AAAA,EACX,aAAa;AAAA,EACb,aAAa;AAAA,EACb,WAAW;AAAA,EACX,OAAO,CAAC,MAAM,IAAI;AAAA,EAClB,OAAO,CAAC,MAAM,MAAM,MAAM,IAAI;AAAA,EAC9B,UAAU,CAAC,KAAM,MAAM,IAAI;AAC5B;","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "riotapi-fetch-typed",
   "type": "module",
-  "version": "1.1.4-dev",
+  "version": "1.2.1-dev",
   "description": "Fetch the Riot Games API with type safety, thanks to the OpenAPI specification.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",