@pokemontcgapi/sdk 0.1.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,185 @@
+# @pokemontcgapi/sdk
+
+TypeScript client for the Pokémon TCG API at [pokemontcgapi.com](https://pokemontcgapi.com) —
+**615 sets and 52,337 cards** across three print regions (379 Japanese, 176 international, 60
+Simplified Chinese), card names in six languages, 399 illustrators, images, and prices that state
+their source, basis, grade and sample size.
+
+**Zero runtime dependencies.** Uses the global `fetch`, so it runs unchanged on Node ≥ 20, Bun, Deno,
+Cloudflare Workers and in the browser.
+
+Unofficial. Not produced, endorsed, supported by or affiliated with Nintendo, Creatures Inc.,
+GAME FREAK inc. or The Pokémon Company International. Pokémon and all related marks are trademarks of
+their respective owners.
+
+## Install
+
+```bash
+npm install @pokemontcgapi/sdk
+```
+
+## Use
+
+```ts
+import { PokemonTcgApi } from '@pokemontcgapi/sdk';
+
+const client = new PokemonTcgApi({ apiKey: process.env.PTCG_API_KEY });
+
+const card = await client.cards.get('base1-4', { include: ['prices'] });
+console.log(card.id, card.name, card.index_eur);
+// bs-4 Charizard 561.84
+```
+
+`base1-4` and `bs-4` both resolve: the id is the printed coordinate — set code, dash, collector
+number — and the alternate legacy id resolves on the same route, so a catalogue you already have does
+not start with a matching problem.
+
+### Pagination that you never have to think about
+
+Every list method returns a `Page`, which is also an `AsyncIterable`. Iterating it follows
+`links.next` for you:
+
+```ts
+for await (const set of await client.sets.list({ region: 'JP' })) {
+  console.log(set.code, set.name, set.release_date);
+}
+```
+
+The cursor carries a signature of the sort order, so it must never be reconstructed by hand — the SDK
+follows the URL the API returned, which is the failure mode this avoids. `.toArray({ max })` requires
+an explicit ceiling, because the catalogue is large enough that an unbounded materialisation is a
+mistake rather than a choice.
+
+### One call for a hundred cards
+
+```ts
+const { data, requested, found } = await client.cards.batch(['bs-4', 'sv3-001'], {
+  select: ['id', 'name', 'index_eur'],
+});
+```
+
+Ids that do not exist are omitted rather than reported one by one — compare `requested` with `found`.
+
+### Japanese, and the other five locales
+
+```ts
+const page = await client.sets.cards('sv8', { lang: 'ja', limit: 1 });
+console.log(page.data[0]?.name); // タマタマ
+```
+
+`lang` replaces the `name` field itself and falls back to English where a translation is missing.
+Locales: `en`, `ja`, `fr`, `de`, `es`, `it`.
+
+### Conditional requests are free
+
+```ts
+const client = new PokemonTcgApi({ cache: 'etag' });
+```
+
+Every collection carries a strong ETag. With the cache on, the client stores it and replays a `304`
+without a body — no quota consumed. A mirror that re-syncs often pays only for what changed.
+
+### A photo instead of an id
+
+```ts
+const { data } = await client.vision.identify(file, { set: 'sv3' });
+
+// Read `decision` before `id`. Always.
+switch (data.decision) {
+  case 'match':
+    // One candidate, close, and clear of the next.
+    add(data.id!);
+    break;
+  case 'ambiguous':
+    // Two printings share this illustration. `data.id` is null on purpose.
+    showPicker(data.candidates);
+    break;
+  case 'no_match':
+    askForABetterPhoto();
+}
+```
+
+Reprints and regional twins share their artwork, so artwork alone cannot name a printing — not here
+and not anywhere. The endpoint returns candidates with a `distance` (0–512, lower is closer; real
+matches land well under 150) and refuses to pick when two are within a few bits of each other.
+Passing `set` or `region` when your workflow knows them is what resolves the tie.
+
+It costs 25 credits a call against 1 for a lookup: it is the whole image index answering, not a row
+being read. Do not put it in a loop.
+
+### Errors you can branch on
+
+```ts
+import { NotFoundError, RateLimitedError, QuotaExceededError } from '@pokemontcgapi/sdk';
+
+try {
+  await client.cards.get('nope-1');
+} catch (error) {
+  if (error instanceof NotFoundError) { /* ... */ }
+  if (error instanceof RateLimitedError) { /* error.retryAfter */ }
+  if (error instanceof QuotaExceededError) { /* retrying will never help */ }
+}
+```
+
+Every error carries `code`, `status`, `details` and `requestId` — quote the request id in a support
+message, it is the only thing that can be looked up. Retries use exponential backoff with full
+jitter on 429, 5xx and network failures, honour `Retry-After`, and never retry a quota exhaustion.
+
+## What this API does not have
+
+Stated up front so you find out here rather than three days into an integration:
+
+- **No Korean cards.** Zero `KR` sets, zero `ko` translations. Both are modelled in the schema and
+  carry no data.
+- **No card game text.** `attacks`, `abilities`, `weaknesses`, `resistances`, `subtypes`,
+  `retreat_cost`, `rules`, `flavor_text` and `legalities` are empty for every card; `types` and
+  `national_pokedex_numbers` are populated only on part of the Scarlet & Violet era. The types in
+  this package say so on each field. If you are building a deck checker or a rules engine, this is
+  not the data source you need.
+
+What it does have: the printing itself — set, number, rarity, region, release date, illustrator,
+image, marketplace ids, six-language names — and prices.
+
+## Prices
+
+```ts
+const card = await client.cards.get('base1-4', { include: ['prices'] });
+for (const price of card.prices ?? []) {
+  console.log(price.source, price.basis, price.price, price.currency, price.as_of, price.sample_n);
+}
+```
+
+There is no printing filter: first edition, holofoil and graded rows come back together, so read
+`printing`, `condition` and `grading` per row. `basis` separates `GUIDE` (published upstream) from
+`DERIVED` (computed by us). `PTCG_INDEX` is a composite index in EUR carrying `sample_n`, and it is
+also on every card row as `index_eur`, so a list already has a comparable number without a second
+request per card.
+
+## Also available
+
+- **MCP server** for agents: [`@pokemontcgapi/mcp`](https://www.npmjs.com/package/@pokemontcgapi/mcp) — [source](https://github.com/pokemontcgapi/mcp-server)
+- **Docs**: <https://pokemontcgapi.com/docs>
+- **Coverage, measured live**: <https://pokemontcgapi.com/coverage>
+
+## Build from source
+
+```bash
+npm ci
+npm run typecheck
+npm run build
+```
+
+Node >= 20. No test suite lives here yet: what CI enforces is that the package
+typechecks and builds on both Node 20 and Node 22, and that `npm pack` produces
+the file list the registry is meant to receive.
+
+This package is developed inside the private monorepo that runs
+[pokemontcgapi.com](https://pokemontcgapi.com) and mirrored here on each release,
+so a merged pull request travels back by hand rather than by merge button. That
+is not a reason to send patches elsewhere — open the issue or the PR here, it is
+the address that gets read.
+
+## Licence
+
+MIT. Data served by the API carries per-source redistribution terms — see
+<https://pokemontcgapi.com/legal/attribution>.

package/dist/client.d.ts

@@ -0,0 +1,99 @@
+import type { Collection } from './types.js';
+/**
+ * Il trasporto.
+ *
+ * Nessuna dipendenza a runtime: `fetch` globale, che c'e' su Node 20+, Bun,
+ * Deno, i Workers e i browser. Un client HTTP portato dentro il pacchetto
+ * costerebbe piu' della funzione che sostituisce, e ogni sua CVE diventerebbe
+ * nostra.
+ */
+export interface ClientOptions {
+    /** Se assente si legge `PTCG_API_KEY` dall'ambiente, dove esiste. */
+    readonly apiKey?: string;
+    readonly baseUrl?: string;
+    /** Millisecondi per singolo tentativo, non per l'operazione intera. */
+    readonly timeout?: number;
+    /** Tentativi RIPETUTI, oltre al primo. 0 disattiva. */
+    readonly maxRetries?: number;
+    /** Iniettabile per i test e per gli ambienti che avvolgono fetch. */
+    readonly fetch?: typeof globalThis.fetch;
+    /**
+     * Ricorda gli ETag e rispedisce `If-None-Match`.
+     *
+     * Vale la pena accenderlo: un 304 non ha corpo e non consuma quota, quindi
+     * un mirror che risincronizza spesso paga solo le pagine cambiate. La cache
+     * e' in memoria e per-istanza: non sopravvive al processo, di proposito —
+     * una cache su disco dentro un SDK e' una sorgente di bug che il chiamante
+     * non puo' ispezionare.
+     */
+    readonly cache?: 'none' | 'etag';
+    readonly userAgent?: string;
+}
+export declare function serializeParams(params: Record<string, unknown> | undefined): URLSearchParams;
+export declare class HttpClient {
+    readonly baseUrl: string;
+    private readonly apiKey;
+    private readonly timeout;
+    private readonly maxRetries;
+    private readonly doFetch;
+    private readonly userAgent;
+    private readonly etags;
+    constructor(options?: ClientOptions);
+    /** URL assoluto da un path applicativo piu' i parametri. */
+    url(path: string, params?: Record<string, unknown>): string;
+    get<T>(path: string, params?: Record<string, unknown>): Promise<T>;
+    /**
+     * POST con un corpo.
+     *
+     * Non passa dalla cache ETag e non viene mai ritentato su un errore di rete:
+     * il ritentativo automatico e' sicuro solo su richieste idempotenti, e una
+     * POST che potrebbe essere arrivata a destinazione non lo e'. Un 429 con
+     * `Retry-After` resta ritentabile perche' li' sappiamo che non e' stata
+     * eseguita.
+     */
+    post<T>(path: string, body: BodyInit, contentType?: string, params?: Record<string, unknown>): Promise<T>;
+    /**
+     * Segue un URL gia' costruito dall'API (`links.next`).
+     *
+     * Esiste come metodo pubblico perche' il cursore porta la firma
+     * dell'ordinamento: ricostruire l'URL a mano e rimetterci dentro il cursore
+     * e' esattamente cio' che l'API rifiuta con `INVALID_CURSOR`.
+     */
+    follow<T>(absoluteUrl: string): Promise<T>;
+    private request;
+    private attempt;
+    /**
+     * Un 5xx puo' arrivare da un proxy davanti all'API, quindi in HTML: se il
+     * corpo non e' il nostro envelope si costruisce un errore comunque, invece di
+     * far esplodere il parser e nascondere lo status vero.
+     */
+    private readErrorBody;
+}
+/**
+ * Una pagina che e' anche un iteratore.
+ *
+ * `for await (const card of client.cards.search(...))` cammina l'intera
+ * collezione seguendo `links.next`, senza che il chiamante veda mai un cursore.
+ * E' il motivo per cui vale la pena usare l'SDK invece di `fetch`: la paginazione
+ * a cursore e' corretta ma noiosa, ed e' il punto in cui le integrazioni scritte
+ * a mano perdono righe.
+ */
+export declare class Page<T> implements AsyncIterable<T> {
+    readonly data: readonly T[];
+    readonly meta: Collection<T>['meta'];
+    private readonly nextUrl;
+    private readonly http;
+    constructor(http: HttpClient, body: Collection<T>);
+    get hasMore(): boolean;
+    nextPage(): Promise<Page<T> | null>;
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+    /**
+     * Materializza in un array. `max` e' OBBLIGATORIO: il catalogo ha oltre
+     * 52.000 carte, e un `.toArray()` senza tetto e' il modo piu' rapido di
+     * riempire la memoria di un processo per sbaglio.
+     */
+    toArray({ max }: {
+        max: number;
+    }): Promise<T[]>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;GAOG;AAEH,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACzC;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAuCD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,eAAe,CAgB5F;AAED,qBAAa,UAAU;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsD;gBAEhE,OAAO,GAAE,aAAkB;IAUvC,4DAA4D;IAC5D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAKrD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIxE;;;;;;;;OAQG;IACG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/G;;;;;;OAMG;IACG,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;YAIlC,OAAO;YAiBP,OAAO;IA0DrB;;;;OAIG;YACW,aAAa;CAY5B;AAED;;;;;;;;GAQG;AACH,qBAAa,IAAI,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;IAOjD,IAAI,OAAO,IAAI,OAAO,CAErB;IAEK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAMlC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;IAQjD;;;;OAIG;IACG,OAAO,CAAC,EAAE,GAAG,EAAE,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;CAQtD"}

package/dist/client.js

@@ -0,0 +1,247 @@
+import { ApiConnectionError, ApiTimeoutError, PokemonTcgApiError, QuotaExceededError, RateLimitedError, ServerError, toApiError, } from './errors.js';
+const DEFAULT_BASE_URL = 'https://api.pokemontcgapi.com';
+const DEFAULT_TIMEOUT = 30_000;
+const DEFAULT_MAX_RETRIES = 2;
+/** Errore di rete o 5xx/429: e' l'unico insieme su cui riprovare ha senso. */
+function isRetryable(error) {
+    if (error instanceof QuotaExceededError)
+        return false;
+    if (error instanceof RateLimitedError)
+        return true;
+    if (error instanceof ServerError)
+        return true;
+    if (error instanceof ApiConnectionError)
+        return true;
+    if (error instanceof PokemonTcgApiError)
+        return error.status === 408;
+    return false;
+}
+/**
+ * Backoff esponenziale con jitter pieno.
+ *
+ * Il jitter non e' un dettaglio: senza, mille client che prendono lo stesso 429
+ * riprovano tutti nello stesso millisecondo e ricostruiscono la coda che
+ * stavano cercando di far smaltire.
+ */
+function backoffMs(attempt, retryAfter) {
+    if (retryAfter !== undefined)
+        return Math.min(retryAfter * 1000, 60_000);
+    const ceiling = Math.min(500 * 2 ** attempt, 8_000);
+    return Math.random() * ceiling;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function readEnv(name) {
+    // `process` non esiste nei browser ne' nei Workers: si guarda senza assumerlo.
+    const proc = globalThis.process;
+    return proc?.env?.[name];
+}
+export function serializeParams(params) {
+    const search = new URLSearchParams();
+    if (!params)
+        return search;
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null)
+            continue;
+        // Gli array (select, include, ids) viaggiano come lista separata da virgole,
+        // che e' la forma che l'API accetta — non come chiavi ripetute.
+        if (Array.isArray(value)) {
+            if (value.length === 0)
+                continue;
+            search.set(key, value.join(','));
+            continue;
+        }
+        search.set(key, String(value));
+    }
+    return search;
+}
+export class HttpClient {
+    baseUrl;
+    apiKey;
+    timeout;
+    maxRetries;
+    doFetch;
+    userAgent;
+    etags;
+    constructor(options = {}) {
+        this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+        this.apiKey = options.apiKey ?? readEnv('PTCG_API_KEY');
+        this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
+        this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this.doFetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.userAgent = options.userAgent ?? '@pokemontcgapi/sdk';
+        this.etags = options.cache === 'etag' ? new Map() : null;
+    }
+    /** URL assoluto da un path applicativo piu' i parametri. */
+    url(path, params) {
+        const search = serializeParams(params).toString();
+        return `${this.baseUrl}${path}${search === '' ? '' : `?${search}`}`;
+    }
+    async get(path, params) {
+        return this.request(this.url(path, params));
+    }
+    /**
+     * POST con un corpo.
+     *
+     * Non passa dalla cache ETag e non viene mai ritentato su un errore di rete:
+     * il ritentativo automatico e' sicuro solo su richieste idempotenti, e una
+     * POST che potrebbe essere arrivata a destinazione non lo e'. Un 429 con
+     * `Retry-After` resta ritentabile perche' li' sappiamo che non e' stata
+     * eseguita.
+     */
+    async post(path, body, contentType, params) {
+        return this.attempt(this.url(path, params), { method: 'POST', body, contentType });
+    }
+    /**
+     * Segue un URL gia' costruito dall'API (`links.next`).
+     *
+     * Esiste come metodo pubblico perche' il cursore porta la firma
+     * dell'ordinamento: ricostruire l'URL a mano e rimetterci dentro il cursore
+     * e' esattamente cio' che l'API rifiuta con `INVALID_CURSOR`.
+     */
+    async follow(absoluteUrl) {
+        return this.request(absoluteUrl);
+    }
+    async request(url) {
+        let lastError;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt += 1) {
+            try {
+                return await this.attempt(url);
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt === this.maxRetries || !isRetryable(error))
+                    throw error;
+                const retryAfter = error instanceof RateLimitedError ? error.retryAfter : undefined;
+                await sleep(backoffMs(attempt, retryAfter));
+            }
+        }
+        throw lastError;
+    }
+    async attempt(url, write) {
+        const headers = {
+            accept: 'application/json',
+            'user-agent': this.userAgent,
+        };
+        if (this.apiKey !== undefined)
+            headers['x-api-key'] = this.apiKey;
+        // `contentType` si imposta solo se lo si conosce: su un FormData va lasciato
+        // scrivere a fetch, che ci mette dentro il `boundary`. Scriverlo a mano
+        // produce un multipart che il server non riesce a separare, e l'errore che
+        // ne esce parla di un campo mancante invece che di un'intestazione sbagliata.
+        if (write?.contentType !== undefined)
+            headers['content-type'] = write.contentType;
+        // Nessuna cache condizionale sulle scritture: l'ETag e' l'impronta di un
+        // corpo, e su una risposta che dipende da cio' che hai appena caricato non
+        // significherebbe niente.
+        const cached = write === undefined ? this.etags?.get(url) : undefined;
+        if (cached !== undefined)
+            headers['if-none-match'] = cached.etag;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        let response;
+        try {
+            response = await this.doFetch(url, {
+                method: write?.method ?? 'GET',
+                headers,
+                ...(write === undefined ? {} : { body: write.body }),
+                signal: controller.signal,
+            });
+        }
+        catch (error) {
+            if (controller.signal.aborted)
+                throw new ApiTimeoutError(this.timeout, error);
+            throw new ApiConnectionError(`Request to ${url} failed`, error);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        // 304: il corpo e' vuoto per definizione, la risposta e' quella in cache.
+        if (response.status === 304 && cached !== undefined)
+            return cached.body;
+        if (!response.ok) {
+            const retryAfterHeader = response.headers.get('retry-after');
+            const retryAfter = retryAfterHeader === null ? undefined : Number.parseInt(retryAfterHeader, 10);
+            const body = await this.readErrorBody(response);
+            throw toApiError(response.status, body, Number.isFinite(retryAfter) ? retryAfter : undefined);
+        }
+        const body = (await response.json());
+        const etag = response.headers.get('etag');
+        if (write === undefined && this.etags !== null && etag !== null)
+            this.etags.set(url, { etag, body });
+        return body;
+    }
+    /**
+     * Un 5xx puo' arrivare da un proxy davanti all'API, quindi in HTML: se il
+     * corpo non e' il nostro envelope si costruisce un errore comunque, invece di
+     * far esplodere il parser e nascondere lo status vero.
+     */
+    async readErrorBody(response) {
+        try {
+            const parsed = (await response.json());
+            if (parsed.error !== undefined && typeof parsed.error.code === 'string')
+                return parsed.error;
+        }
+        catch {
+            /* cade sotto */
+        }
+        return {
+            code: `HTTP_${response.status}`,
+            message: response.statusText === '' ? `HTTP ${response.status}` : response.statusText,
+        };
+    }
+}
+/**
+ * Una pagina che e' anche un iteratore.
+ *
+ * `for await (const card of client.cards.search(...))` cammina l'intera
+ * collezione seguendo `links.next`, senza che il chiamante veda mai un cursore.
+ * E' il motivo per cui vale la pena usare l'SDK invece di `fetch`: la paginazione
+ * a cursore e' corretta ma noiosa, ed e' il punto in cui le integrazioni scritte
+ * a mano perdono righe.
+ */
+export class Page {
+    data;
+    meta;
+    nextUrl;
+    http;
+    constructor(http, body) {
+        this.http = http;
+        this.data = body.data;
+        this.meta = body.meta;
+        this.nextUrl = body.links?.next;
+    }
+    get hasMore() {
+        return this.nextUrl !== undefined;
+    }
+    async nextPage() {
+        if (this.nextUrl === undefined)
+            return null;
+        const body = await this.http.follow(this.nextUrl);
+        return new Page(this.http, body);
+    }
+    async *[Symbol.asyncIterator]() {
+        let page = this;
+        while (page !== null) {
+            for (const item of page.data)
+                yield item;
+            page = await page.nextPage();
+        }
+    }
+    /**
+     * Materializza in un array. `max` e' OBBLIGATORIO: il catalogo ha oltre
+     * 52.000 carte, e un `.toArray()` senza tetto e' il modo piu' rapido di
+     * riempire la memoria di un processo per sbaglio.
+     */
+    async toArray({ max }) {
+        const out = [];
+        for await (const item of this) {
+            out.push(item);
+            if (out.length >= max)
+                break;
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Gerarchia degli errori.
+ *
+ * Sottoclassi e non un solo tipo con un campo `code`, per una ragione pratica:
+ * chi integra scrive `catch (e) { if (e instanceof RateLimited) ... }`, e con un
+ * tipo solo dovrebbe confrontare stringhe — cioe' riscrivere a mano la
+ * tassonomia che noi gia' conosciamo, sbagliando i nomi.
+ *
+ * `QuotaExceeded` e' separato da `RateLimited` di proposito: sembrano lo stesso
+ * errore (entrambi 429) ma si trattano in modo opposto. Un rate limit passa
+ * aspettando; una quota mensile finita non passa mai, e riprovare e' solo un
+ * modo di consumare tempo. Il retry automatico di questo client riprova il
+ * primo e non riprova mai il secondo.
+ */
+export interface ApiErrorBody {
+    readonly code: string;
+    readonly message: string;
+    readonly details?: Record<string, unknown>;
+    readonly request_id?: string;
+}
+export declare class PokemonTcgApiError extends Error {
+    /** Codice stabile della tassonomia, es. `CARD_NOT_FOUND`. */
+    readonly code: string;
+    readonly status: number;
+    /**
+     * Sempre valorizzato quando la risposta e' passata dall'API: e' l'unica cosa
+     * che il supporto puo' cercare nei log. Va incluso in ogni bug report.
+     */
+    readonly requestId: string | undefined;
+    readonly details: Record<string, unknown> | undefined;
+    constructor(status: number, body: ApiErrorBody);
+}
+/** 401 — chiave assente, malformata o revocata. */
+export declare class AuthenticationError extends PokemonTcgApiError {
+}
+/** 403 — la chiave e' valida ma non puo' fare questa cosa. */
+export declare class PermissionDeniedError extends PokemonTcgApiError {
+}
+/** 402 / UPGRADE_REQUIRED — serve un piano superiore. */
+export declare class UpgradeRequiredError extends PokemonTcgApiError {
+    /** Finestra concessa dal piano corrente, quando l'API la dichiara. */
+    get permittedWindow(): unknown;
+}
+/** 404 — la risorsa non esiste. Non e' un errore di rete: non si riprova. */
+export declare class NotFoundError extends PokemonTcgApiError {
+}
+/** 400 / 422 — la richiesta e' sbagliata. `field` dice quale parametro. */
+export declare class InvalidRequestError extends PokemonTcgApiError {
+    get field(): string | undefined;
+}
+/** 429 con Retry-After: passa aspettando. */
+export declare class RateLimitedError extends PokemonTcgApiError {
+    /** Secondi da aspettare, dall'header `Retry-After`, se c'era. */
+    readonly retryAfter: number | undefined;
+    constructor(status: number, body: ApiErrorBody, retryAfter?: number);
+}
+/** 429 per quota di periodo esaurita: NON passa aspettando, e non si riprova. */
+export declare class QuotaExceededError extends PokemonTcgApiError {
+}
+/** 5xx. */
+export declare class ServerError extends PokemonTcgApiError {
+}
+/** La richiesta non e' mai arrivata: DNS, TLS, socket. */
+export declare class ApiConnectionError extends Error {
+    /** `override` perche' Error dichiara gia' `cause` da ES2022. */
+    readonly cause: unknown;
+    constructor(message: string, cause: unknown);
+}
+/** La richiesta e' stata abbandonata da noi dopo `timeout`. */
+export declare class ApiTimeoutError extends ApiConnectionError {
+    constructor(timeoutMs: number, cause: unknown);
+}
+/**
+ * Dal corpo dell'errore alla classe giusta.
+ *
+ * Si guarda PRIMA il `code` e poi lo status: lo status dice la famiglia, il
+ * code dice il caso, e i due casi che contano davvero (limite contro quota)
+ * condividono lo stesso status.
+ */
+export declare function toApiError(status: number, body: ApiErrorBody, retryAfter?: number): PokemonTcgApiError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;gBAE1C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAQ/C;AAED,mDAAmD;AACnD,qBAAa,mBAAoB,SAAQ,kBAAkB;CAAG;AAE9D,8DAA8D;AAC9D,qBAAa,qBAAsB,SAAQ,kBAAkB;CAAG;AAEhE,yDAAyD;AACzD,qBAAa,oBAAqB,SAAQ,kBAAkB;IAC1D,sEAAsE;IACtE,IAAI,eAAe,IAAI,OAAO,CAE7B;CACF;AAED,6EAA6E;AAC7E,qBAAa,aAAc,SAAQ,kBAAkB;CAAG;AAExD,2EAA2E;AAC3E,qBAAa,mBAAoB,SAAQ,kBAAkB;IACzD,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAG9B;CACF;AAED,6CAA6C;AAC7C,qBAAa,gBAAiB,SAAQ,kBAAkB;IACtD,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE5B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM;CAIpE;AAED,iFAAiF;AACjF,qBAAa,kBAAmB,SAAQ,kBAAkB;CAAG;AAE7D,WAAW;AACX,qBAAa,WAAY,SAAQ,kBAAkB;CAAG;AAEtD,0DAA0D;AAC1D,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,gEAAgE;IAChE,SAAkB,KAAK,EAAE,OAAO,CAAC;gBACrB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAK5C;AAED,+DAA+D;AAC/D,qBAAa,eAAgB,SAAQ,kBAAkB;gBACzC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAI9C;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAatG"}