keepa-api 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wajeeh Ul Hassan
+
+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,211 @@
+# keepa-api
+
+Lightweight TypeScript SDK for the [Keepa](https://keepa.com) REST API. Mirrors the organizational style of [openai-node](https://github.com/openai/openai-node) — a single `Keepa` client class exposes resources (`products`, etc.) that wrap each endpoint with typed inputs and responses.
+
+Phase 1 ships the **Products** resource only. Categories, Search, and Bestsellers are planned but not yet implemented.
+
+## Requirements
+
+- Node.js **≥ 18** (uses native `fetch`)
+- A Keepa API key — sign up at [keepa.com/api](https://keepa.com/api.html)
+- ESM consumer (your `package.json` should have `"type": "module"`, or you must be able to `import()` an ESM package)
+
+## Installation
+
+This package is **not yet published to npm**. Install it locally or from GitHub.
+
+### From a local checkout (during development)
+
+```bash
+# In keepa-api/
+npm install
+npm run build
+npm link
+
+# In your other project:
+npm link keepa-api
+```
+
+After this, edits in `keepa-api/src/` only need `npm run build` — the consumer sees the new `dist/` immediately.
+
+### From GitHub (no npm publish needed)
+
+```bash
+npm install github:bilalyasin1616/keepa-api#feature/keepa-products-package
+```
+
+(Replace the branch with `main` once the work is merged.)
+
+### From a tarball
+
+```bash
+# In keepa-api/
+npm pack          # produces keepa-api-0.1.0.tgz
+
+# In your other project:
+npm install /absolute/path/to/keepa-api-0.1.0.tgz
+```
+
+## Quickstart
+
+```ts
+import Keepa from 'keepa-api';
+
+const keepa = new Keepa({ apiKey: process.env.KEEPA_API_KEY });
+
+const products = await keepa.products.list({
+  asins: ['B00MNV8E0C'],
+  marketplace: 'US',
+});
+
+console.log(products[0]?.title);
+```
+
+The client reads `process.env.KEEPA_API_KEY` if you don't pass `apiKey` explicitly. Put your key in a gitignored `.env` (see `.env.example` for the shape).
+
+## API
+
+### `new Keepa(options?)`
+
+| Option | Type | Default | Notes |
+|--------|------|---------|-------|
+| `apiKey` | `string` | `process.env.KEEPA_API_KEY` | Throws if neither is set. |
+| `baseURL` | `string` | `'https://api.keepa.com'` | Override for testing/proxying. |
+| `fetch` | `typeof fetch` | `globalThis.fetch` | Plug in a custom fetch (mocks, retries, etc.). |
+
+### `keepa.products.list(params)` → `Promise<KeepaProduct[]>`
+
+| Param | Type | Default | Notes |
+|-------|------|---------|-------|
+| `asins` | `string[]` | (required) | Validated + uppercased. Throws on malformed input. |
+| `marketplace` | `'US' \| 'UK' \| 'DE' \| 'FR' \| 'JP' \| 'CA' \| 'IT' \| 'ES' \| 'IN' \| 'MX' \| 'AU'` | `'US'` | Case-insensitive. Throws on unknown. |
+| `days` | `number` | `1` | Days of price history. Must be a positive integer (validated pre-flight). |
+
+The SDK maps Keepa's raw wire shape into a friendlier `KeepaProduct`:
+
+- `images: string[]` — full image URLs (region-neutral CDN). Replaces Keepa's awkward `imagesCSV` string.
+- `bsr: number | null` — most recent real BSR for the product's `rootCategory`. `null` when missing or every history entry is Keepa's `-1` "no data captured" sentinel.
+
+The raw `salesRanks` record is preserved for consumers that need to walk the full rank history. Other Keepa fields (`title`, `parentAsin`, `categoryTree`, `variations`, `bulletPoints`, …) pass through unchanged.
+
+**Stub records:** Keepa returns one record per requested ASIN even when it has no data — these stubs have `title === undefined`. Filter with `isFoundProduct` (below).
+
+### Helpers
+
+```ts
+import { isFoundProduct } from 'keepa-api';
+
+const real = products.filter(isFoundProduct);
+
+for (const product of real) {
+  console.log(product.bsr);          // already populated by the SDK
+  console.log(product.images[0]);    // already populated by the SDK
+}
+```
+
+| Helper | Signature | Returns |
+|--------|-----------|---------|
+| `isFoundProduct(product)` | `(product: KeepaProduct) => boolean` | `true` only if Keepa returned real data (`title` is non-empty). |
+| `parseImagesCsv(csv)` | `(csv: string \| undefined) => string[]` | Build the full image-URL list from a raw Keepa imagesCSV. Used internally to fill `images`; exported for advanced use. |
+| `extractBsr(salesRanks, rootCategory)` | `(salesRanks: Record<string, number[]> \| undefined, rootCategory: number \| undefined) => number \| null` | Most recent real BSR from Keepa's raw `[ts, rank, ...]` history. Used internally to fill `bsr`; exported for advanced use. |
+| `extractImageUrl(imagesCSV)` | `(imagesCSV: string \| undefined) => string \| null` | Single URL — equivalent to `parseImagesCsv(imagesCSV)[0] ?? null`. Exported for advanced use. |
+
+### ASIN validation
+
+```ts
+import { ASIN_REGEX, ASIN_LENGTH, isValidAsin, normalizeAsins } from 'keepa-api';
+
+isValidAsin('B00MNV8E0C');           // true
+isValidAsin('b00mnv8e0c');           // false (lowercase — use normalizeAsins to coerce)
+isValidAsin('B07XYZ');               // false (too short)
+
+normalizeAsins(['  b00mnv8e0c ']);   // ['B00MNV8E0C']
+normalizeAsins(['B07XYZ']);          // throws: Invalid ASIN(s): B07XYZ. ...
+```
+
+`Products.list` calls `normalizeAsins` for you, so you don't need to pre-validate unless you're doing form-level checking.
+
+**Caveat:** The regex catches *malformed* input. It cannot catch "Keepa has no record" — for example `1234567890` is a structurally valid ISBN-10 shape and passes the regex, but Keepa returns a stub record. Use `isFoundProduct` to filter those.
+
+### Marketplaces
+
+```ts
+import { MARKETPLACE_DOMAINS, resolveDomainId } from 'keepa-api';
+
+MARKETPLACE_DOMAINS.US;   // 1
+resolveDomainId('uk');    // 2 (case-insensitive)
+resolveDomainId(undefined); // 1 (defaults to US)
+```
+
+| Code | Domain ID | Code | Domain ID |
+|------|-----------|------|-----------|
+| US   | 1         | IT   | 8         |
+| UK   | 2         | ES   | 9         |
+| DE   | 3         | IN   | 10        |
+| FR   | 4         | MX   | 11        |
+| JP   | 5         | AU   | 13        |
+| CA   | 6         |      |           |
+
+### Errors
+
+All errors thrown by API calls extend `KeepaError`. Catch the specific subclasses for status-aware handling:
+
+```ts
+import {
+  RateLimitError,
+  AuthenticationError,
+  APIError,
+  NetworkError,
+  KeepaError,
+} from 'keepa-api';
+
+try {
+  await keepa.products.list({ asins: ['B00MNV8E0C'] });
+} catch (err) {
+  if (err instanceof RateLimitError) /* 429 */;
+  else if (err instanceof AuthenticationError) /* 401 — bad API key */;
+  else if (err instanceof APIError) /* 4xx/5xx — err.status, err.body */;
+  else if (err instanceof NetworkError) /* DNS/ECONNREFUSED/abort — err.cause has the original */;
+  else if (err instanceof KeepaError) /* something else from this SDK */;
+  else throw err;
+}
+```
+
+### API key handling
+
+Keepa's REST API requires the key as a `?key=...` query parameter — that's their contract, not a choice we made. Practical implications:
+
+- **Server-side proxy / access logs** will record full URLs (key included). Configure log scrubbing if you can't trust the layer.
+- **Don't run this in the browser.** A client-side request would expose your key in DevTools' Network tab and to any browser extension or middlebox.
+- The `NetworkError.body` and `APIError.body` fields capture Keepa's response body. Keepa doesn't echo your key in error bodies, but if you log them to a customer-facing surface, sanity-check the contents first.
+
+## Scripts
+
+```bash
+npm test            # vitest run — unit tests
+npm run test:watch  # vitest watch
+npm run build       # tsc → dist/
+npm run example     # runs examples/basic.ts against real Keepa (needs .env)
+npm run clean       # rm -rf dist
+```
+
+## Roadmap
+
+**Resources**
+- [ ] `Categories` resource (`fetchKeepaCategories`)
+- [ ] `Categories.search` (`searchKeepaCategories`)
+- [ ] `Bestsellers.retrieve` (`fetchKeepaBestSeller`)
+
+**Request layer**
+- [ ] `AbortSignal` / configurable timeout on `Products.list` (default ~30s) — currently a hung Keepa server keeps the request pending forever
+- [ ] Pass-through `init` (method, headers, signal) on `core/request` for resources that need POST or custom headers
+- [ ] Cap `asins.length` at Keepa's per-call limit (100) instead of letting Keepa silently truncate
+- [ ] Optional `retryOn429` (with backoff) — currently we throw `RateLimitError` immediately; consumers handle pacing in their own code
+
+**Distribution**
+- [ ] CommonJS build alongside ESM
+- [ ] Publish to npm
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/dist/client.d.ts

@@ -0,0 +1,21 @@
+import type { RequestArgs } from './core/request.js';
+import { Products } from './resources/products/products.js';
+export interface ClientOptions {
+    /** Keepa API key. Falls back to `process.env.KEEPA_API_KEY`. */
+    apiKey?: string;
+    /** Base URL for the Keepa API. Defaults to `https://api.keepa.com`. */
+    baseURL?: string;
+    /** Custom fetch implementation. Defaults to `globalThis.fetch`. */
+    fetch?: typeof globalThis.fetch;
+}
+export declare class Keepa {
+    readonly apiKey: string;
+    readonly baseURL: string;
+    readonly fetch: typeof globalThis.fetch;
+    readonly products: Products;
+    constructor(options?: ClientOptions);
+    /** Internal: used by APIResource subclasses to perform a request. */
+    _request<T>(args: RequestArgs): Promise<T>;
+}
+export default Keepa;
+//# 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":"AACA,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAID,qBAAa,KAAK;IAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAExC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBAEhB,OAAO,GAAE,aAAkB;IAuBvC,qEAAqE;IACrE,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;CAQ3C;AAED,eAAe,KAAK,CAAC"}

package/dist/client.js

@@ -0,0 +1,38 @@
+import { request } from './core/request.js';
+import { Products } from './resources/products/products.js';
+const DEFAULT_BASE_URL = 'https://api.keepa.com';
+export class Keepa {
+    apiKey;
+    baseURL;
+    fetch;
+    products;
+    constructor(options = {}) {
+        // `process` is undefined in browsers / Cloudflare Workers / edge runtimes — guard it
+        // so the constructor throws our friendly "Missing Keepa API key" message instead of a
+        // raw ReferenceError on those targets.
+        const envApiKey = typeof process !== 'undefined' ? process.env?.KEEPA_API_KEY : undefined;
+        const apiKey = options.apiKey || envApiKey;
+        if (!apiKey) {
+            throw new Error('Missing Keepa API key. Pass it as `new Keepa({ apiKey })` or set KEEPA_API_KEY in your environment.');
+        }
+        this.apiKey = apiKey;
+        // Strip a trailing slash so `${baseURL}${path}` never produces `//product`.
+        this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+        // Bind `globalThis` once: an unbound reference to Node's fetch throws
+        // "Illegal invocation" when called with an undefined `this`. Bind once at
+        // construction so every _request call uses the cached bound function.
+        this.fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.products = new Products(this);
+    }
+    /** Internal: used by APIResource subclasses to perform a request. */
+    _request(args) {
+        const config = {
+            apiKey: this.apiKey,
+            baseURL: this.baseURL,
+            fetch: this.fetch,
+        };
+        return request(config, args);
+    }
+}
+export default Keepa;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAW5D,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAEjD,MAAM,OAAO,KAAK;IACP,MAAM,CAAS;IACf,OAAO,CAAS;IAChB,KAAK,CAA0B;IAE/B,QAAQ,CAAW;IAE5B,YAAY,UAAyB,EAAE;QACrC,qFAAqF;QACrF,sFAAsF;QACtF,uCAAuC;QACvC,MAAM,SAAS,GACb,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC;QAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,qGAAqG,CACtG,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,4EAA4E;QAC5E,IAAI,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACzE,sEAAsE;QACtE,0EAA0E;QAC1E,sEAAsE;QACtE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEhE,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,qEAAqE;IACrE,QAAQ,CAAI,IAAiB;QAC3B,MAAM,MAAM,GAAkB;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;QACF,OAAO,OAAO,CAAI,MAAM,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;CACF;AAED,eAAe,KAAK,CAAC"}

package/dist/core/error.d.ts

@@ -0,0 +1,27 @@
+/** Replace any `?key=...` or `&key=...` segment with a REDACTED placeholder.
+ *  Defense-in-depth: keeps the API key out of error messages even when an
+ *  underlying transport error or upstream response echoes the request URL.
+ *  Exported for use by callers that build their own error wrappers. */
+export declare function scrubApiKey(text: string): string;
+export declare class KeepaError extends Error {
+    constructor(message: string);
+}
+export declare class APIError extends KeepaError {
+    readonly status: number;
+    readonly context: string;
+    readonly body: string;
+    constructor(status: number, context: string, body: string, message?: string);
+    static from(response: Response, context: string): Promise<APIError>;
+}
+export declare class RateLimitError extends APIError {
+    constructor(context: string, body: string);
+}
+export declare class AuthenticationError extends APIError {
+    constructor(context: string, body: string);
+}
+export declare class NetworkError extends KeepaError {
+    readonly context: string;
+    readonly cause: unknown;
+    constructor(context: string, cause: unknown);
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/core/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/core/error.ts"],"names":[],"mappings":"AAAA;;;uEAGuE;AACvE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,QAAS,SAAQ,UAAU;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;WAS9D,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAW1E;AAED,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAI1C;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAS1C;AAED,qBAAa,YAAa,SAAQ,UAAU;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,SAAkB,KAAK,EAAE,OAAO,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAO5C"}

package/dist/core/error.js

@@ -0,0 +1,61 @@
+/** Replace any `?key=...` or `&key=...` segment with a REDACTED placeholder.
+ *  Defense-in-depth: keeps the API key out of error messages even when an
+ *  underlying transport error or upstream response echoes the request URL.
+ *  Exported for use by callers that build their own error wrappers. */
+export function scrubApiKey(text) {
+    return text.replace(/([?&])key=[^&\s]*/gi, '$1key=REDACTED');
+}
+export class KeepaError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'KeepaError';
+    }
+}
+export class APIError extends KeepaError {
+    status;
+    context;
+    body;
+    constructor(status, context, body, message) {
+        const safeBody = scrubApiKey(body);
+        super(scrubApiKey(message ?? `Keepa ${context} error (${status}): ${safeBody}`));
+        this.name = 'APIError';
+        this.status = status;
+        this.context = context;
+        this.body = safeBody;
+    }
+    static async from(response, context) {
+        const body = await response.text().catch(() => '');
+        switch (response.status) {
+            case 429:
+                return new RateLimitError(context, body);
+            case 401:
+                return new AuthenticationError(context, body);
+            default:
+                return new APIError(response.status, context, body);
+        }
+    }
+}
+export class RateLimitError extends APIError {
+    constructor(context, body) {
+        super(429, context, body, 'Keepa rate limit exceeded, please wait or upgrade plan');
+        this.name = 'RateLimitError';
+    }
+}
+export class AuthenticationError extends APIError {
+    constructor(context, body) {
+        super(401, context, body, `Keepa authentication failed for ${context}: invalid or missing API key`);
+        this.name = 'AuthenticationError';
+    }
+}
+export class NetworkError extends KeepaError {
+    context;
+    cause;
+    constructor(context, cause) {
+        const raw = cause instanceof Error ? cause.message : String(cause);
+        super(`Keepa ${context} network error: ${scrubApiKey(raw)}`);
+        this.name = 'NetworkError';
+        this.context = context;
+        this.cause = cause;
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/core/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/core/error.ts"],"names":[],"mappings":"AAAA;;;uEAGuE;AACvE,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,gBAAgB,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,UAAU;IAC7B,MAAM,CAAS;IACf,OAAO,CAAS;IAChB,IAAI,CAAS;IAEtB,YAAY,MAAc,EAAE,OAAe,EAAE,IAAY,EAAE,OAAgB;QACzE,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,KAAK,CAAC,WAAW,CAAC,OAAO,IAAI,SAAS,OAAO,WAAW,MAAM,MAAM,QAAQ,EAAE,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAkB,EAAE,OAAe;QACnD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACnD,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;YACxB,KAAK,GAAG;gBACN,OAAO,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC3C,KAAK,GAAG;gBACN,OAAO,IAAI,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAChD;gBACE,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAC1C,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,wDAAwD,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;IAC/C,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CACH,GAAG,EACH,OAAO,EACP,IAAI,EACJ,mCAAmC,OAAO,8BAA8B,CACzE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,UAAU;IACjC,OAAO,CAAS;IACP,KAAK,CAAU;IAEjC,YAAY,OAAe,EAAE,KAAc;QACzC,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,KAAK,CAAC,SAAS,OAAO,mBAAmB,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/dist/core/request.d.ts

@@ -0,0 +1,15 @@
+export type QueryValue = string | number | string[] | number[] | undefined;
+export type QueryParams = Record<string, QueryValue>;
+export interface RequestArgs {
+    path: string;
+    query?: QueryParams;
+    context: string;
+}
+export interface RequestConfig {
+    baseURL: string;
+    apiKey: string;
+    fetch: typeof globalThis.fetch;
+}
+export declare function buildUrl(baseURL: string, path: string, query?: QueryParams): string;
+export declare function request<T>(config: RequestConfig, args: RequestArgs): Promise<T>;
+//# sourceMappingURL=request.d.ts.map

package/dist/core/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/core/request.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;AAC3E,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAChC;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,MAAM,CASnF;AAWD,wBAAsB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAWrF"}

package/dist/core/request.js

@@ -0,0 +1,36 @@
+import { APIError, NetworkError } from './error.js';
+export function buildUrl(baseURL, path, query) {
+    if (!query)
+        return `${baseURL}${path}`;
+    const parts = [];
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined)
+            continue;
+        const stringValue = Array.isArray(value) ? value.join(',') : String(value);
+        parts.push(`${encodeURIComponent(key)}=${encodeKeepaValue(stringValue)}`);
+    }
+    return parts.length ? `${baseURL}${path}?${parts.join('&')}` : `${baseURL}${path}`;
+}
+// Keep commas literal — Keepa accepts comma-separated lists (asin=A,B,C, category=1,2,3)
+// and the category endpoint specifically rejects %2C-encoded commas.
+// Currently private to this module: if a future helper builds Keepa URLs outside
+// `request()` (e.g. a paginator) and needs the same encoding, lift this into
+// `core/encoding.ts` rather than duplicating it.
+function encodeKeepaValue(value) {
+    return encodeURIComponent(value).replace(/%2C/g, ',');
+}
+export async function request(config, args) {
+    const query = { key: config.apiKey, ...args.query };
+    const url = buildUrl(config.baseURL, args.path, query);
+    let res;
+    try {
+        res = await config.fetch(url);
+    }
+    catch (cause) {
+        throw new NetworkError(args.context, cause);
+    }
+    if (!res.ok)
+        throw await APIError.from(res, args.context);
+    return (await res.json());
+}
+//# sourceMappingURL=request.js.map

package/dist/core/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/core/request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiBpD,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,IAAY,EAAE,KAAmB;IACzE,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,OAAO,GAAG,IAAI,EAAE,CAAC;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,gBAAgB,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,IAAI,EAAE,CAAC;AACrF,CAAC;AAED,yFAAyF;AACzF,qEAAqE;AACrE,iFAAiF;AACjF,6EAA6E;AAC7E,iDAAiD;AACjD,SAAS,gBAAgB,CAAC,KAAa;IACrC,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAI,MAAqB,EAAE,IAAiB;IACvE,MAAM,KAAK,GAAgB,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IACjE,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvD,IAAI,GAAa,CAAC;IAClB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1D,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;AACjC,CAAC"}

package/dist/core/resource.d.ts

@@ -0,0 +1,6 @@
+import type { Keepa } from '../client.js';
+export declare abstract class APIResource {
+    protected _client: Keepa;
+    constructor(client: Keepa);
+}
+//# sourceMappingURL=resource.d.ts.map

package/dist/core/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/core/resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,8BAAsB,WAAW;IAC/B,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC;gBAEb,MAAM,EAAE,KAAK;CAG1B"}

package/dist/core/resource.js

@@ -0,0 +1,7 @@
+export class APIResource {
+    _client;
+    constructor(client) {
+        this._client = client;
+    }
+}
+//# sourceMappingURL=resource.js.map

package/dist/core/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/core/resource.ts"],"names":[],"mappings":"AAEA,MAAM,OAAgB,WAAW;IACrB,OAAO,CAAQ;IAEzB,YAAY,MAAa;QACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { Keepa as default, Keepa, type ClientOptions } from './client.js';
+export { KeepaError, APIError, RateLimitError, AuthenticationError, NetworkError, } from './core/error.js';
+export { APIResource } from './core/resource.js';
+export { MARKETPLACE_DOMAINS, resolveDomainId, type Marketplace, type DomainId, } from './lib/marketplace.js';
+export { ASIN_LENGTH, ASIN_REGEX, isValidAsin, normalizeAsins, } from './lib/asin.js';
+export * from './resources/index.js';
+export { VERSION } from './version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,KAAK,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAE1E,OAAO,EACL,UAAU,EACV,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,QAAQ,GACd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,cAAc,sBAAsB,CAAC;AAErC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { Keepa as default, Keepa } from './client.js';
+export { KeepaError, APIError, RateLimitError, AuthenticationError, NetworkError, } from './core/error.js';
+export { APIResource } from './core/resource.js';
+export { MARKETPLACE_DOMAINS, resolveDomainId, } from './lib/marketplace.js';
+export { ASIN_LENGTH, ASIN_REGEX, isValidAsin, normalizeAsins, } from './lib/asin.js';
+export * from './resources/index.js';
+export { VERSION } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,KAAK,EAAsB,MAAM,aAAa,CAAC;AAE1E,OAAO,EACL,UAAU,EACV,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EACL,mBAAmB,EACnB,eAAe,GAGhB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,cAAc,sBAAsB,CAAC;AAErC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/lib/asin.d.ts

@@ -0,0 +1,10 @@
+export declare const ASIN_LENGTH = 10;
+export declare const ASIN_REGEX: RegExp;
+/** Returns true if the given string is a structurally valid ASIN
+ *  (10 uppercase alphanumeric characters). Note: a passing ASIN may still
+ *  not exist in Keepa's database — use `isFoundProduct` to check that. */
+export declare function isValidAsin(value: string): boolean;
+/** Trim + uppercase a list of ASINs and validate each. Returns the normalized
+ *  list. Throws with all invalid ASINs listed in the error message. */
+export declare function normalizeAsins(asins: string[]): string[];
+//# sourceMappingURL=asin.d.ts.map

package/dist/lib/asin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asin.d.ts","sourceRoot":"","sources":["../../src/lib/asin.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,UAAU,QAAmB,CAAC;AAE3C;;0EAE0E;AAC1E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;uEACuE;AACvE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CASxD"}

package/dist/lib/asin.js

@@ -0,0 +1,19 @@
+export const ASIN_LENGTH = 10;
+export const ASIN_REGEX = /^[A-Z0-9]{10}$/;
+/** Returns true if the given string is a structurally valid ASIN
+ *  (10 uppercase alphanumeric characters). Note: a passing ASIN may still
+ *  not exist in Keepa's database — use `isFoundProduct` to check that. */
+export function isValidAsin(value) {
+    return ASIN_REGEX.test(value);
+}
+/** Trim + uppercase a list of ASINs and validate each. Returns the normalized
+ *  list. Throws with all invalid ASINs listed in the error message. */
+export function normalizeAsins(asins) {
+    const normalized = asins.map((asin) => asin.trim().toUpperCase());
+    const invalid = normalized.filter((asin) => !isValidAsin(asin));
+    if (invalid.length > 0) {
+        throw new Error(`Invalid ASIN(s): ${invalid.join(', ')}. ASINs must be ${ASIN_LENGTH} alphanumeric characters (e.g. B00MNV8E0C).`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=asin.js.map

package/dist/lib/asin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asin.js","sourceRoot":"","sources":["../../src/lib/asin.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAC9B,MAAM,CAAC,MAAM,UAAU,GAAG,gBAAgB,CAAC;AAE3C;;0EAE0E;AAC1E,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;uEACuE;AACvE,MAAM,UAAU,cAAc,CAAC,KAAe;IAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAChE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,oBAAoB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,WAAW,6CAA6C,CAClH,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/lib/marketplace.d.ts

@@ -0,0 +1,17 @@
+export declare const MARKETPLACE_DOMAINS: {
+    readonly US: 1;
+    readonly UK: 2;
+    readonly DE: 3;
+    readonly FR: 4;
+    readonly JP: 5;
+    readonly CA: 6;
+    readonly IT: 8;
+    readonly ES: 9;
+    readonly IN: 10;
+    readonly MX: 11;
+    readonly AU: 13;
+};
+export type Marketplace = keyof typeof MARKETPLACE_DOMAINS;
+export type DomainId = (typeof MARKETPLACE_DOMAINS)[Marketplace];
+export declare function resolveDomainId(marketplace: string | undefined): DomainId;
+//# sourceMappingURL=marketplace.d.ts.map

package/dist/lib/marketplace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.d.ts","sourceRoot":"","sources":["../../src/lib/marketplace.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;CAYtB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,mBAAmB,CAAC;AAC3D,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,WAAW,CAAC,CAAC;AAIjE,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CASzE"}

package/dist/lib/marketplace.js

@@ -0,0 +1,26 @@
+// The 11 marketplaces consumed by the existing internal projects. Keepa supports more
+// (AE, NL, PL, SE, BR, TR, …); extend this map and the README marketplace table when
+// a new region is needed. The numeric id is Keepa's `domain` query parameter value.
+export const MARKETPLACE_DOMAINS = {
+    US: 1,
+    UK: 2,
+    DE: 3,
+    FR: 4,
+    JP: 5,
+    CA: 6,
+    IT: 8,
+    ES: 9,
+    IN: 10,
+    MX: 11,
+    AU: 13,
+};
+const SUPPORTED_LIST = Object.keys(MARKETPLACE_DOMAINS).join(', ');
+export function resolveDomainId(marketplace) {
+    const key = (marketplace ?? 'US').toUpperCase();
+    const domainId = MARKETPLACE_DOMAINS[key];
+    if (!domainId) {
+        throw new Error(`Invalid marketplace "${marketplace}". Supported: ${SUPPORTED_LIST}`);
+    }
+    return domainId;
+}
+//# sourceMappingURL=marketplace.js.map

package/dist/lib/marketplace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.js","sourceRoot":"","sources":["../../src/lib/marketplace.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,qFAAqF;AACrF,oFAAoF;AACpF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;CACE,CAAC;AAKX,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEnE,MAAM,UAAU,eAAe,CAAC,WAA+B;IAC7D,MAAM,GAAG,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,WAAW,EAAiB,CAAC;IAC/D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,wBAAwB,WAAW,iBAAiB,cAAc,EAAE,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/resources/index.d.ts

@@ -0,0 +1,2 @@
+export * from './products/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/resources/index.js

@@ -0,0 +1,2 @@
+export * from './products/index.js';
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/resources/products/constant.d.ts

@@ -0,0 +1,7 @@
+export declare const PRODUCT_PATH = "/product";
+export declare const PRODUCT_LIST_CONTEXT = "products.list";
+export declare const DEFAULT_DAYS = 1;
+export declare const AMAZON_IMAGE_BASE = "https://m.media-amazon.com/images/I";
+export declare const KEEPA_NO_DATA_SENTINEL = -1;
+export declare const VALID_IMAGE_FILENAME: RegExp;
+//# sourceMappingURL=constant.d.ts.map

package/dist/resources/products/constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.d.ts","sourceRoot":"","sources":["../../../src/resources/products/constant.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,aAAa,CAAC;AAIvC,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AACpD,eAAO,MAAM,YAAY,IAAI,CAAC;AAG9B,eAAO,MAAM,iBAAiB,wCAAwC,CAAC;AAGvE,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAKzC,eAAO,MAAM,oBAAoB,QAA4C,CAAC"}

package/dist/resources/products/constant.js

@@ -0,0 +1,15 @@
+export const PRODUCT_PATH = '/product';
+// Structured tag of the form `<resource>.<method>`. Used as the `context` field on
+// errors thrown from this method — keeps log aggregators able to filter cleanly as
+// more methods land (categories.list, categories.search, bestsellers.retrieve, …).
+export const PRODUCT_LIST_CONTEXT = 'products.list';
+export const DEFAULT_DAYS = 1;
+// Region-neutral Amazon image CDN. Serves the same images globally regardless of marketplace.
+export const AMAZON_IMAGE_BASE = 'https://m.media-amazon.com/images/I';
+// Keepa stores `-1` in salesRanks/price arrays to indicate "no data captured at that timestamp".
+export const KEEPA_NO_DATA_SENTINEL = -1;
+// Allowlist for image filenames in imagesCSV. Defends against path-traversal / SSRF
+// shaped strings (e.g. "../../etc/passwd") in case the CSV is ever influenced by
+// untrusted input. Matches typical Keepa image hashes (e.g. "61abcDEF.jpg").
+export const VALID_IMAGE_FILENAME = /^[A-Za-z0-9._-]+\.(jpg|jpeg|png|webp)$/i;
+//# sourceMappingURL=constant.js.map

package/dist/resources/products/constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.js","sourceRoot":"","sources":["../../../src/resources/products/constant.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AACvC,mFAAmF;AACnF,mFAAmF;AACnF,mFAAmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC;AACpD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAE9B,8FAA8F;AAC9F,MAAM,CAAC,MAAM,iBAAiB,GAAG,qCAAqC,CAAC;AAEvE,iGAAiG;AACjG,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,CAAC;AAEzC,oFAAoF;AACpF,iFAAiF;AACjF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,oBAAoB,GAAG,yCAAyC,CAAC"}

package/dist/resources/products/index.d.ts

@@ -0,0 +1,4 @@
+export { Products, extractBsr, extractImageUrl, isFoundProduct, parseImagesCsv, } from './products.js';
+export type { ProductListParams, KeepaProduct, KeepaVariation, KeepaVariationAttribute, KeepaCategoryNode, } from './product.type.js';
+export { PRODUCT_PATH, PRODUCT_LIST_CONTEXT, DEFAULT_DAYS, AMAZON_IMAGE_BASE, KEEPA_NO_DATA_SENTINEL, } from './constant.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/products/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/products/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,UAAU,EACV,eAAe,EACf,cAAc,EACd,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,eAAe,CAAC"}

package/dist/resources/products/index.js

@@ -0,0 +1,6 @@
+export { Products, extractBsr, extractImageUrl, isFoundProduct, parseImagesCsv, } from './products.js';
+// NOTE: raw Keepa wire types (KeepaProductRaw, KeepaProductResponseRaw) are
+// intentionally NOT re-exported. They are an implementation detail — Products.list
+// maps them to the consumer-friendly KeepaProduct shape before returning.
+export { PRODUCT_PATH, PRODUCT_LIST_CONTEXT, DEFAULT_DAYS, AMAZON_IMAGE_BASE, KEEPA_NO_DATA_SENTINEL, } from './constant.js';
+//# sourceMappingURL=index.js.map

package/dist/resources/products/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/products/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,UAAU,EACV,eAAe,EACf,cAAc,EACd,cAAc,GACf,MAAM,eAAe,CAAC;AAUvB,4EAA4E;AAC5E,mFAAmF;AACnF,0EAA0E;AAE1E,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,eAAe,CAAC"}

package/dist/resources/products/product.raw.type.d.ts

@@ -0,0 +1,28 @@
+export interface KeepaCategoryNodeRaw {
+    catId: number;
+    name: string;
+}
+export interface KeepaVariationAttributeRaw {
+    dimension: string;
+    value: string;
+}
+export interface KeepaVariationRaw {
+    asin: string;
+    attributes?: KeepaVariationAttributeRaw[];
+}
+export interface KeepaProductRaw {
+    asin: string;
+    title?: string;
+    description?: string;
+    parentAsin?: string;
+    categoryTree?: KeepaCategoryNodeRaw[];
+    rootCategory?: number;
+    salesRanks?: Record<string, number[]>;
+    imagesCSV?: string;
+    variations?: KeepaVariationRaw[];
+    bulletPoints?: string[];
+}
+export interface KeepaProductResponseRaw {
+    products?: KeepaProductRaw[];
+}
+//# sourceMappingURL=product.raw.type.d.ts.map

package/dist/resources/products/product.raw.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.raw.type.d.ts","sourceRoot":"","sources":["../../../src/resources/products/product.raw.type.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,0BAA0B,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;CAC9B"}

package/dist/resources/products/product.raw.type.js

@@ -0,0 +1,6 @@
+// Internal: shapes Keepa actually returns over the wire. The Products resource maps
+// these into the consumer-friendly KeepaProduct (see product.type.ts) before returning,
+// so callers never have to deal with the awkward forms (e.g. comma-separated imagesCSV).
+// Not re-exported through resources/index.ts.
+export {};
+//# sourceMappingURL=product.raw.type.js.map

package/dist/resources/products/product.raw.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.raw.type.js","sourceRoot":"","sources":["../../../src/resources/products/product.raw.type.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,wFAAwF;AACxF,yFAAyF;AACzF,8CAA8C"}

package/dist/resources/products/product.type.d.ts

@@ -0,0 +1,41 @@
+import type { Marketplace } from '../../lib/marketplace.js';
+export interface ProductListParams {
+    asins: string[];
+    /** Marketplace code (case-insensitive at runtime). Defaults to 'US'. */
+    marketplace?: Marketplace;
+    /** Days of price history to include. Defaults to 1. */
+    days?: number;
+}
+export interface KeepaCategoryNode {
+    catId: number;
+    name: string;
+}
+export interface KeepaVariationAttribute {
+    dimension: string;
+    value: string;
+}
+export interface KeepaVariation {
+    asin: string;
+    attributes?: KeepaVariationAttribute[];
+}
+/** A Keepa product in the consumer-friendly shape. Derived from the raw Keepa
+ *  response: `imagesCSV` is split into `images: string[]`, and the most-recent
+ *  real BSR is surfaced as `bsr`. The raw `salesRanks` is preserved for
+ *  consumers that need to walk the rank history themselves. */
+export interface KeepaProduct {
+    asin: string;
+    title?: string;
+    description?: string;
+    parentAsin?: string;
+    categoryTree?: KeepaCategoryNode[];
+    rootCategory?: number;
+    salesRanks?: Record<string, number[]>;
+    variations?: KeepaVariation[];
+    bulletPoints?: string[];
+    /** Full image URLs derived from imagesCSV using a region-neutral Amazon CDN. */
+    images: string[];
+    /** Most recent real BSR for the rootCategory. Null when missing or every entry is
+     *  Keepa's `-1` "no data captured" sentinel. */
+    bsr: number | null;
+}
+//# sourceMappingURL=product.type.d.ts.map

package/dist/resources/products/product.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.type.d.ts","sourceRoot":"","sources":["../../../src/resources/products/product.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,wEAAwE;IACxE,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACxC;AAED;;;+DAG+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,gFAAgF;IAChF,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;oDACgD;IAChD,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB"}

package/dist/resources/products/product.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=product.type.js.map

package/dist/resources/products/product.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.type.js","sourceRoot":"","sources":["../../../src/resources/products/product.type.ts"],"names":[],"mappings":""}

package/dist/resources/products/products.d.ts

@@ -0,0 +1,31 @@
+import { APIResource } from '../../core/resource.js';
+import type { KeepaProduct, ProductListParams } from './product.type.js';
+export declare class Products extends APIResource {
+    list(params: ProductListParams): Promise<KeepaProduct[]>;
+}
+/** Returns true when Keepa returned an actual product record (not just a stub
+ *  for an unknown ASIN). Use as a `.filter()` predicate to drop empty matches.
+ *
+ *  We use `title.length > 0` because it's the strongest single correlate of
+ *  "Keepa has data" — stubs for unknown ASINs come back without a title, and
+ *  every real listing has one. If Keepa's stub format changes (e.g. they start
+ *  returning a placeholder title), tighten this predicate to also require
+ *  `categoryTree` or another non-string field. */
+export declare function isFoundProduct(product: KeepaProduct): boolean;
+/** Build the full image-URL list from a Keepa imagesCSV string. Region-neutral CDN.
+ *  Filters out entries that don't look like image filenames (path traversal,
+ *  arbitrary extensions, etc.) — defense in case the CSV is ever influenced by
+ *  untrusted input. Most consumers won't need this directly: `Products.list`
+ *  already fills `images[]` on every returned product. */
+export declare function parseImagesCsv(imagesCSV: string | undefined): string[];
+/** Extract the most recent real BSR from Keepa's `[ts, rank, ts, rank, ...]` salesRanks array.
+ *  Walks backward through rank entries (odd indices) and skips Keepa's `-1` sentinel which
+ *  marks "no data captured at that timestamp". Returns `null` if every entry is sentinel.
+ *  Most consumers won't need this — `Products.list` already fills `bsr` on every returned
+ *  product. Useful when working with a raw Keepa response. */
+export declare function extractBsr(salesRanks: Record<string, number[]> | undefined, rootCategory: number | undefined): number | null;
+/** Build a single Amazon image URL from the first entry in Keepa's imagesCSV.
+ *  Equivalent to `parseImagesCsv(imagesCSV)[0] ?? null`. Useful when working with
+ *  a raw Keepa response. */
+export declare function extractImageUrl(imagesCSV: string | undefined): string | null;
+//# sourceMappingURL=products.d.ts.map

package/dist/resources/products/products.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../../src/resources/products/products.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAWrD,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGzE,qBAAa,QAAS,SAAQ,WAAW;IACjC,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAuB/D;AAmBD;;;;;;;kDAOkD;AAClD,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAE7D;AAED;;;;0DAI0D;AAC1D,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAMtE;AAED;;;;8DAI8D;AAC9D,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,EAChD,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,GAAG,IAAI,CAaf;AAED;;4BAE4B;AAC5B,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAE5E"}

package/dist/resources/products/products.js

@@ -0,0 +1,96 @@
+import { APIResource } from '../../core/resource.js';
+import { resolveDomainId } from '../../lib/marketplace.js';
+import { normalizeAsins } from '../../lib/asin.js';
+import { PRODUCT_PATH, PRODUCT_LIST_CONTEXT, DEFAULT_DAYS, AMAZON_IMAGE_BASE, KEEPA_NO_DATA_SENTINEL, VALID_IMAGE_FILENAME, } from './constant.js';
+export class Products extends APIResource {
+    async list(params) {
+        if (params.asins.length === 0) {
+            throw new Error('At least one ASIN is required');
+        }
+        if (params.days !== undefined &&
+            (!Number.isInteger(params.days) || params.days < 1)) {
+            throw new Error(`Invalid days: ${params.days}. Must be a positive integer.`);
+        }
+        const asins = normalizeAsins(params.asins);
+        const domain = resolveDomainId(params.marketplace);
+        const data = await this._client._request({
+            path: PRODUCT_PATH,
+            query: {
+                domain,
+                asin: asins,
+                days: params.days ?? DEFAULT_DAYS,
+            },
+            context: PRODUCT_LIST_CONTEXT,
+        });
+        return (data.products ?? []).map(toKeepaProduct);
+    }
+}
+/** Map Keepa's raw wire shape into the consumer-friendly KeepaProduct. */
+function toKeepaProduct(raw) {
+    return {
+        asin: raw.asin,
+        title: raw.title,
+        description: raw.description,
+        parentAsin: raw.parentAsin,
+        categoryTree: raw.categoryTree,
+        rootCategory: raw.rootCategory,
+        salesRanks: raw.salesRanks,
+        variations: raw.variations,
+        bulletPoints: raw.bulletPoints,
+        images: parseImagesCsv(raw.imagesCSV),
+        bsr: extractBsr(raw.salesRanks, raw.rootCategory),
+    };
+}
+/** Returns true when Keepa returned an actual product record (not just a stub
+ *  for an unknown ASIN). Use as a `.filter()` predicate to drop empty matches.
+ *
+ *  We use `title.length > 0` because it's the strongest single correlate of
+ *  "Keepa has data" — stubs for unknown ASINs come back without a title, and
+ *  every real listing has one. If Keepa's stub format changes (e.g. they start
+ *  returning a placeholder title), tighten this predicate to also require
+ *  `categoryTree` or another non-string field. */
+export function isFoundProduct(product) {
+    return typeof product.title === 'string' && product.title.length > 0;
+}
+/** Build the full image-URL list from a Keepa imagesCSV string. Region-neutral CDN.
+ *  Filters out entries that don't look like image filenames (path traversal,
+ *  arbitrary extensions, etc.) — defense in case the CSV is ever influenced by
+ *  untrusted input. Most consumers won't need this directly: `Products.list`
+ *  already fills `images[]` on every returned product. */
+export function parseImagesCsv(imagesCSV) {
+    if (!imagesCSV)
+        return [];
+    return imagesCSV
+        .split(',')
+        .filter((entry) => VALID_IMAGE_FILENAME.test(entry))
+        .map((filename) => `${AMAZON_IMAGE_BASE}/${filename}`);
+}
+/** Extract the most recent real BSR from Keepa's `[ts, rank, ts, rank, ...]` salesRanks array.
+ *  Walks backward through rank entries (odd indices) and skips Keepa's `-1` sentinel which
+ *  marks "no data captured at that timestamp". Returns `null` if every entry is sentinel.
+ *  Most consumers won't need this — `Products.list` already fills `bsr` on every returned
+ *  product. Useful when working with a raw Keepa response. */
+export function extractBsr(salesRanks, rootCategory) {
+    if (!salesRanks || rootCategory === undefined)
+        return null;
+    const ranks = salesRanks[String(rootCategory)];
+    if (!ranks || ranks.length < 2)
+        return null;
+    // Keepa pairs are [ts, rank, ts, rank, ...]. If length is even, the last index
+    // is a rank; if odd (truncated/schema drift), it's a dangling timestamp — skip
+    // back one slot so we always start on a rank.
+    const start = ranks.length % 2 === 0 ? ranks.length - 1 : ranks.length - 2;
+    for (let i = start; i >= 1; i -= 2) {
+        const rank = ranks[i];
+        if (rank !== undefined && rank !== KEEPA_NO_DATA_SENTINEL)
+            return rank;
+    }
+    return null;
+}
+/** Build a single Amazon image URL from the first entry in Keepa's imagesCSV.
+ *  Equivalent to `parseImagesCsv(imagesCSV)[0] ?? null`. Useful when working with
+ *  a raw Keepa response. */
+export function extractImageUrl(imagesCSV) {
+    return parseImagesCsv(imagesCSV)[0] ?? null;
+}
+//# sourceMappingURL=products.js.map

package/dist/resources/products/products.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "keepa-api",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the Keepa API.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "example": "tsx examples/basic.ts",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build && npm test"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "keepa",
+    "amazon",
+    "api",
+    "sdk",
+    "asin"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "dotenv": "^16.4.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  }
+}