@haatlabs-core/provider-amazon 0.0.0-stage → 0.11.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "{}"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Haatlabs
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,64 @@
-# Temporary Holding Version
+# @haatlabs-core/provider-amazon
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+## Install
+
+    pnpm add @haatlabs-core/provider-amazon
+
+It leaves one package to your app, so the app holds one copy: `zod`.
+
+## What it does
+
+Amazon search, products and suggestions through an Amazon scraper, called directly or through a
+services gateway: `createAmazonSource(options)` gives a `ProductSource` (`search`,
+`product`, `autocomplete`, `parseLink`, `health`). It caches nothing: wrap a call in
+`cachedCall` (@haatlabs-core/providers) for `AMAZON_CACHE_SECONDS` (search and product an hour,
+suggestions a day). `AMAZON_IMAGE_HOSTS` are the hosts a content security policy names.
+
+## Options
+
+`baseUrl` (the scraper, the gateway's `/amazon`, or the hosted API), `timeoutMs`, `apiKey`
+(the hosted API's) or `gatewayKey` (the gateway's; setting both is a `RangeError`),
+`proxyEnabled` (Japan and Australia need a proxy that exits there), `fetch`,
+`maxConcurrent` (12 calls in flight), `maxWaitMs` (10 s for a place before the call is
+refused) and `maxResponseBytes` (2 MiB).
+
+## Errors
+
+`SOURCE_BAD_REQUEST` (400), `SOURCE_PRODUCT_NOT_FOUND` (404, for a product only),
+`SOURCE_UNAVAILABLE` (503, transient: away, slow, busy, or no place within `maxWaitMs`) and
+`SOURCE_ERROR` (503: an answer that cannot be used). A project spreads
+`PROVIDER_AMAZON_ERRORS` into `defineErrors`. A 429 or 5xx carries `retryAfterMs` from its
+Retry-After (seconds or a date, at most five minutes). Called directly, a refusal's body is
+never read: the connection is let go.
+
+## Gateway and deadlines
+
+Each call takes a `CallContext` (tier, priority, `deadlineMs`); with `gatewayKey` it sends
+the gateway's headers, tier 4 in the background when there is none. The call's time limit is
+`timeoutMs`, or `deadlineMs` when that is sooner (`localTimeoutMs`), and it starts before the
+wait for one of the `maxConcurrent` places: the wait counts, and a call whose time ran out
+while it waited is never made. The gateway is given what is left of that limit, never longer.
+The deadline is each call's: a caller's retry starts it again, so a caller that retries
+gives each try what is left of its own budget. Through the gateway a refusal carries an `UpstreamStatusError` as its
+cause: `isGatewayRefusal(error)` is true for the gateway's 401 and 403 (both
+`SOURCE_UNAVAILABLE`), and only the gateway's own `bad_request` 400 is a contract error.
+
+## Fixtures
+
+`@haatlabs-core/provider-amazon/fixtures`: `amazonFixtures.product`, `.search` and
+`.autocomplete`, answers recorded from the real scraper.
+
+## Testing
+
+`@haatlabs-core/provider-amazon/testing`: `createFakeSource(options)`, a second `ProductSource`
+with one market, for tests that must not assume Amazon. The package's own tests are unit
+tests on the fixtures: `pnpm --filter @haatlabs-core/provider-amazon test`.
+
+## Hosted services
+
+Without a scraper of your own, read Amazon through the Haatlabs API on RapidAPI: set
+`haatlabsApiKey` (your RapidAPI key) and `baseUrl: 'https://haatlabs-api.p.rapidapi.com'`
+(`apiKey` and `gatewayKey` stay null). Every marketplace is available; there are no
+suggestions (`autocomplete` is absent); a refusal keeps its message, and a used-up quota or a
+refused key is `SOURCE_UNAVAILABLE` that is not transient. See `@haatlabs-core/services` and
+https://haatlabs.shop/docs/services/

package/dist/amazon-source.d.ts

@@ -0,0 +1,37 @@
+import type { ProductSource } from './source.js';
+/** Real products are under 100 KB, so 2 MiB is plenty. */
+export declare const DEFAULT_AMAZON_MAX_RESPONSE_BYTES: number;
+/** How long each kind of answer may be kept, in seconds. */
+export declare const AMAZON_CACHE_SECONDS: {
+    readonly search: 3600;
+    readonly product: 3600;
+    readonly autocomplete: 86400;
+};
+/** Where Amazon serves product images from: the dashboards' content security policy names each. */
+export declare const AMAZON_IMAGE_HOSTS: readonly ["https://m.media-amazon.com", "https://images-na.ssl-images-amazon.com", "https://images-eu.ssl-images-amazon.com", "https://images-fe.ssl-images-amazon.com"];
+export interface AmazonSourceOptions {
+    /** The scraper container, or the author's hosted API (which needs `apiKey`). */
+    baseUrl: string;
+    timeoutMs: number;
+    /** The hosted API's key. Mutually exclusive with `gatewayKey`: setting both is refused. */
+    apiKey: string | null;
+    /**
+     * haatlabs-shared's gateway key; null reaches a scraper (or the hosted API) directly.
+     * Mutually exclusive with `apiKey`.
+     */
+    gatewayKey: string | null;
+    /**
+     * Your RapidAPI key for the Haatlabs API (`@haatlabs-core/services`), with `baseUrl` its address
+     * (`https://haatlabs-api.p.rapidapi.com`). Mutually exclusive with `apiKey` and `gatewayKey`.
+     */
+    haatlabsApiKey?: string | null;
+    /** True when the scraper has a proxy that exits in Japan and Australia. */
+    proxyEnabled: boolean;
+    fetch?: typeof fetch;
+    maxConcurrent?: number;
+    /** How long a call may wait for one of the `maxConcurrent` places before it is refused. */
+    maxWaitMs?: number;
+    /** The largest answer read; default 2 MiB. */
+    maxResponseBytes?: number;
+}
+export declare function createAmazonSource(options: AmazonSourceOptions): ProductSource;

package/dist/amazon-source.js

@@ -0,0 +1,240 @@
+import { createConcurrencyLimit, GATEWAY_HEADER, gatewayAuthorization, gatewayErrorOf, gatewayHeadersFor, localTimeoutMs, readAtMost, retryAfterMsOf, UpstreamStatusError, sharedCall, } from '@haatlabs-core/providers';
+import { AmazonErrorCode, createAmazonError } from './errors.js';
+import { ASIN, parseAmazonLink } from './links.js';
+import { mapProduct, mapSearch } from './map.js';
+import { AMAZON_MARKETS, marketByCode } from './markets.js';
+import { RawAutocompleteSchema, RawProductSchema, RawSearchSchema } from './raw.js';
+import { SearchFilter, SortOrder } from './schemas.js';
+import { createHaatlabsAmazonSource } from './haatlabs.js';
+import { cleanText } from './text.js';
+/** Real products are under 100 KB, so 2 MiB is plenty. */
+export const DEFAULT_AMAZON_MAX_RESPONSE_BYTES = 2 * 1024 * 1024;
+const HEALTH_TIMEOUT_MS = 5000;
+const DEFAULT_MAX_CONCURRENT = 12;
+// A burst queues briefly; past this the scraper is overwhelmed, and the person is told so.
+const DEFAULT_MAX_WAIT_MS = 10_000;
+const MAX_SUGGESTIONS = 10;
+/** How long each kind of answer may be kept, in seconds. */
+export const AMAZON_CACHE_SECONDS = { search: 3600, product: 3600, autocomplete: 86_400 };
+/** Where Amazon serves product images from: the dashboards' content security policy names each. */
+export const AMAZON_IMAGE_HOSTS = [
+    'https://m.media-amazon.com',
+    'https://images-na.ssl-images-amazon.com',
+    'https://images-eu.ssl-images-amazon.com',
+    'https://images-fe.ssl-images-amazon.com',
+];
+const PRODUCT_PATH = '/products/details';
+const NOT_RESPONDING = 'Amazon is not responding. Try again shortly.';
+/** Settles as `work` does, or rejects with the signal's reason once it aborts first. */
+async function untilAborted(work, signal) {
+    // `work` still settles after an abort; nothing is left waiting on it.
+    work.catch(() => undefined);
+    let onAbort = () => undefined;
+    const aborted = new Promise((_resolve, reject) => {
+        onAbort = () => reject(signal.reason);
+        if (signal.aborted)
+            onAbort();
+        else
+            signal.addEventListener('abort', onAbort, { once: true });
+    });
+    try {
+        return await Promise.race([work, aborted]);
+    }
+    finally {
+        signal.removeEventListener('abort', onAbort);
+    }
+}
+const fail = (code, message, cause, retryAfterMs) => createAmazonError(code, message, { cause, retryAfterMs });
+export function createAmazonSource(options) {
+    if (options.apiKey && options.gatewayKey) {
+        throw new RangeError('Amazon source: apiKey and gatewayKey are mutually exclusive; set one');
+    }
+    if (options.haatlabsApiKey && (options.apiKey || options.gatewayKey)) {
+        throw new RangeError('Amazon source: haatlabsApiKey cannot be set with apiKey or gatewayKey; set one');
+    }
+    const fetchImpl = options.fetch ?? fetch;
+    const base = options.baseUrl.replace(/\/$/, '');
+    const maxResponseBytes = options.maxResponseBytes ?? DEFAULT_AMAZON_MAX_RESPONSE_BYTES;
+    const limit = createConcurrencyLimit(options.maxConcurrent ?? DEFAULT_MAX_CONCURRENT, options.maxWaitMs ?? DEFAULT_MAX_WAIT_MS);
+    const headers = {
+        accept: 'application/json',
+        ...gatewayAuthorization(options.gatewayKey),
+    };
+    if (options.apiKey) {
+        headers['x-rapidapi-key'] = options.apiKey;
+        headers['x-rapidapi-host'] = new URL(base).hostname;
+    }
+    // The gateway is given no longer than this call still waits for it.
+    const forCall = (call, leftMs) => ({
+        ...headers,
+        ...gatewayHeadersFor(options.gatewayKey, call && { ...call, deadlineMs: leftMs }, leftMs),
+    });
+    const available = (needsProxy) => !needsProxy || options.proxyEnabled;
+    const info = {
+        id: 'amazon',
+        name: 'Amazon',
+        defaultMarket: 'US',
+        markets: AMAZON_MARKETS.map((market) => ({
+            code: market.code,
+            name: market.name,
+            domain: market.domain,
+            currency: market.currency,
+            available: available(market.needsProxy),
+        })),
+        capabilities: {
+            autocomplete: true,
+            sorts: Object.values(SortOrder),
+            filters: Object.values(SearchFilter),
+            productIdPattern: '^[A-Za-z0-9]{10}$',
+        },
+        imageHosts: [...AMAZON_IMAGE_HOSTS],
+    };
+    if (options.haatlabsApiKey) {
+        return createHaatlabsAmazonSource({
+            baseUrl: options.baseUrl,
+            apiKey: options.haatlabsApiKey,
+            timeoutMs: options.timeoutMs,
+            info,
+            ...(options.fetch ? { fetch: options.fetch } : {}),
+            maxConcurrent: options.maxConcurrent ?? DEFAULT_MAX_CONCURRENT,
+            maxWaitMs: options.maxWaitMs ?? DEFAULT_MAX_WAIT_MS,
+        });
+    }
+    const marketFor = (code) => {
+        const market = marketByCode(code);
+        if (!market || !available(market.needsProxy)) {
+            throw fail(AmazonErrorCode.SOURCE_BAD_REQUEST, `Amazon has no marketplace ${code} that can be read here`);
+        }
+        return market;
+    };
+    async function get(path, params, schema, call) {
+        const url = `${base}${path}?${new URLSearchParams(params).toString()}`;
+        // The timer starts before the wait for a place, so the wait counts against it.
+        const budgetMs = localTimeoutMs(options.timeoutMs, call);
+        const signal = AbortSignal.timeout(budgetMs);
+        const startedAt = performance.now();
+        let response;
+        try {
+            response = await untilAborted(limit(() => {
+                signal.throwIfAborted();
+                const leftMs = budgetMs - (performance.now() - startedAt);
+                return sharedCall('amazon', () => fetchImpl(url, { headers: forCall(call, leftMs), signal }), (answer) => answer.status);
+            }), signal);
+        }
+        catch (error) {
+            throw fail('SOURCE_UNAVAILABLE', NOT_RESPONDING, error);
+        }
+        const status = response.status;
+        const busy = [429, 502, 503, 504].includes(status);
+        if (!response.ok && options.gatewayKey) {
+            const retryAfterMs = retryAfterMsOf(response.headers);
+            const gatewayError = await gatewayErrorOf(response);
+            const refused = status === 401 || status === 403;
+            // Only the gateway's own 400 says `bad_request`; a relayed scraper 400 is about the query.
+            const contract = status === 400 && gatewayError === 'bad_request';
+            const detail = new UpstreamStatusError(status, gatewayError, refused, contract);
+            if (refused)
+                throw fail('SOURCE_UNAVAILABLE', NOT_RESPONDING, detail);
+            if (status === 400)
+                throw fail('SOURCE_BAD_REQUEST', 'Amazon did not accept this search or product reference.', detail);
+            if (status === 404 && path === PRODUCT_PATH)
+                throw fail('SOURCE_PRODUCT_NOT_FOUND', 'Amazon has no such product.', detail);
+            if (busy)
+                throw fail('SOURCE_UNAVAILABLE', NOT_RESPONDING, detail, retryAfterMs);
+            throw fail('SOURCE_ERROR', `Something went wrong reading Amazon (HTTP ${status}).`, detail);
+        }
+        if (!response.ok) {
+            // A refusal's body is never read: let the connection go.
+            await response.body?.cancel().catch(() => undefined);
+            if (status === 400)
+                throw fail('SOURCE_BAD_REQUEST', 'Amazon did not accept this search or product reference.');
+            if (status === 404 && path === PRODUCT_PATH)
+                throw fail('SOURCE_PRODUCT_NOT_FOUND', 'Amazon has no such product.');
+            if (busy)
+                throw fail('SOURCE_UNAVAILABLE', NOT_RESPONDING, undefined, retryAfterMsOf(response.headers));
+            throw fail('SOURCE_ERROR', `Something went wrong reading Amazon (HTTP ${status}).`);
+        }
+        let body;
+        try {
+            body = await readAtMost(response, maxResponseBytes);
+        }
+        catch (error) {
+            throw fail('SOURCE_UNAVAILABLE', NOT_RESPONDING, error);
+        }
+        if (body === null)
+            throw fail('SOURCE_ERROR', 'Amazon sent more than can be read.');
+        let json;
+        try {
+            json = JSON.parse(body.toString('utf8'));
+        }
+        catch (error) {
+            throw fail('SOURCE_ERROR', 'Something went wrong reading Amazon.', error);
+        }
+        const parsed = schema.safeParse(json);
+        if (!parsed.success)
+            throw fail('SOURCE_ERROR', 'Something went wrong reading Amazon.', parsed.error);
+        return parsed.data;
+    }
+    return {
+        info,
+        cacheSeconds: AMAZON_CACHE_SECONDS,
+        async search(query, call) {
+            const market = marketFor(query.market);
+            const params = {
+                query: query.q,
+                country: market.code,
+                page: String(query.page),
+                sort: query.sort,
+            };
+            if (query.minPrice !== undefined)
+                params.min_price = String(query.minPrice);
+            if (query.maxPrice !== undefined)
+                params.max_price = String(query.maxPrice);
+            if (query.brand !== undefined)
+                params.brand = query.brand;
+            if (query.primeOnly)
+                params.is_prime = 'true';
+            if (query.fourStarsAndUp)
+                params.four_stars_and_up = 'true';
+            if (query.dealsOnly)
+                params.deals = 'all_discounts';
+            return mapSearch(await get('/search', params, RawSearchSchema, call), query);
+        },
+        async product(input, call) {
+            const market = marketFor(input.market);
+            const asin = input.id.toUpperCase();
+            if (!ASIN.test(asin))
+                throw fail(AmazonErrorCode.SOURCE_BAD_REQUEST, 'An Amazon product id is ten letters and digits.');
+            return mapProduct(await get(PRODUCT_PATH, { product: asin, country: market.code }, RawProductSchema, call), market);
+        },
+        async autocomplete(input, call) {
+            const market = marketFor(input.market);
+            const raw = await get('/search/autocomplete', { query: input.q, country: market.code }, RawAutocompleteSchema, call);
+            return (raw.suggestions ?? [])
+                .map((suggestion) => cleanText(suggestion?.value, 200))
+                .filter((value) => value !== null)
+                .slice(0, MAX_SUGGESTIONS);
+        },
+        parseLink: parseAmazonLink,
+        async health() {
+            try {
+                const response = await fetchImpl(`${base}/health`, {
+                    headers: options.gatewayKey
+                        ? {
+                            ...headers,
+                            [GATEWAY_HEADER.deadlineMs]: String(Math.min(options.timeoutMs, HEALTH_TIMEOUT_MS)),
+                        }
+                        : headers,
+                    signal: AbortSignal.timeout(Math.min(options.timeoutMs, HEALTH_TIMEOUT_MS)),
+                });
+                return response.ok
+                    ? { healthy: true }
+                    : { healthy: false, detail: `HTTP ${response.status}` };
+            }
+            catch {
+                return { healthy: false, detail: 'no answer' };
+            }
+        },
+    };
+}
+//# sourceMappingURL=amazon-source.js.map

package/dist/amazon-source.js.map

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

package/dist/cjs/amazon-source.d.ts

@@ -0,0 +1,37 @@
+import type { ProductSource } from './source.js';
+/** Real products are under 100 KB, so 2 MiB is plenty. */
+export declare const DEFAULT_AMAZON_MAX_RESPONSE_BYTES: number;
+/** How long each kind of answer may be kept, in seconds. */
+export declare const AMAZON_CACHE_SECONDS: {
+    readonly search: 3600;
+    readonly product: 3600;
+    readonly autocomplete: 86400;
+};
+/** Where Amazon serves product images from: the dashboards' content security policy names each. */
+export declare const AMAZON_IMAGE_HOSTS: readonly ["https://m.media-amazon.com", "https://images-na.ssl-images-amazon.com", "https://images-eu.ssl-images-amazon.com", "https://images-fe.ssl-images-amazon.com"];
+export interface AmazonSourceOptions {
+    /** The scraper container, or the author's hosted API (which needs `apiKey`). */
+    baseUrl: string;
+    timeoutMs: number;
+    /** The hosted API's key. Mutually exclusive with `gatewayKey`: setting both is refused. */
+    apiKey: string | null;
+    /**
+     * haatlabs-shared's gateway key; null reaches a scraper (or the hosted API) directly.
+     * Mutually exclusive with `apiKey`.
+     */
+    gatewayKey: string | null;
+    /**
+     * Your RapidAPI key for the Haatlabs API (`@haatlabs-core/services`), with `baseUrl` its address
+     * (`https://haatlabs-api.p.rapidapi.com`). Mutually exclusive with `apiKey` and `gatewayKey`.
+     */
+    haatlabsApiKey?: string | null;
+    /** True when the scraper has a proxy that exits in Japan and Australia. */
+    proxyEnabled: boolean;
+    fetch?: typeof fetch;
+    maxConcurrent?: number;
+    /** How long a call may wait for one of the `maxConcurrent` places before it is refused. */
+    maxWaitMs?: number;
+    /** The largest answer read; default 2 MiB. */
+    maxResponseBytes?: number;
+}
+export declare function createAmazonSource(options: AmazonSourceOptions): ProductSource;