keepa-api 0.3.2 → 0.4.0

package/dist/index.d.cts

@@ -41,6 +41,56 @@ type Marketplace = keyof typeof MARKETPLACE_DOMAINS;
 type DomainId = (typeof MARKETPLACE_DOMAINS)[Marketplace];
 declare function resolveDomainId(marketplace: string | undefined): DomainId;
 
+declare const PRODUCT_PATH = "/product";
+declare const PRODUCT_LIST_CONTEXT = "products.list";
+declare const DEFAULT_DAYS = 1;
+declare const AMAZON_IMAGE_BASE = "https://m.media-amazon.com/images/I";
+declare const KEEPA_NO_DATA_SENTINEL = -1;
+declare const CsvType: {
+    readonly AMAZON: 0;
+    readonly NEW: 1;
+    readonly USED: 2;
+    readonly SALES: 3;
+    readonly LISTPRICE: 4;
+    readonly COLLECTIBLE: 5;
+    readonly REFURBISHED: 6;
+    readonly NEW_FBM_SHIPPING: 7;
+    readonly LIGHTNING_DEAL: 8;
+    readonly WAREHOUSE: 9;
+    readonly NEW_FBA: 10;
+    readonly COUNT_NEW: 11;
+    readonly COUNT_USED: 12;
+    readonly COUNT_REFURBISHED: 13;
+    readonly COUNT_COLLECTIBLE: 14;
+    readonly EXTRA_INFO_UPDATES: 15;
+    readonly RATING: 16;
+    readonly COUNT_REVIEWS: 17;
+    readonly BUY_BOX_SHIPPING: 18;
+    readonly USED_NEW_SHIPPING: 19;
+    readonly USED_VERY_GOOD_SHIPPING: 20;
+    readonly USED_GOOD_SHIPPING: 21;
+    readonly USED_ACCEPTABLE_SHIPPING: 22;
+    readonly COLLECTIBLE_NEW_SHIPPING: 23;
+    readonly COLLECTIBLE_VERY_GOOD_SHIPPING: 24;
+    readonly COLLECTIBLE_GOOD_SHIPPING: 25;
+    readonly COLLECTIBLE_ACCEPTABLE_SHIPPING: 26;
+    readonly REFURBISHED_SHIPPING: 27;
+    readonly EBAY_NEW_SHIPPING: 28;
+    readonly EBAY_USED_SHIPPING: 29;
+    readonly TRADE_IN: 30;
+    readonly RENTAL: 31;
+    readonly BUY_BOX_USED_SHIPPING: 32;
+    readonly PRIME_EXCL: 33;
+    readonly COUNT_NEW_FBA: 34;
+    readonly COUNT_NEW_FBM: 35;
+};
+type CsvType = (typeof CsvType)[keyof typeof CsvType];
+declare const SavingBasisType: {
+    readonly LIST_PRICE: 0;
+    readonly WAS_PRICE: 1;
+};
+type SavingBasisType = (typeof SavingBasisType)[keyof typeof SavingBasisType];
+
 interface ProductRequestOptions {
     /** Case-insensitive at runtime. Defaults to 'US'. */
     marketplace?: Marketplace;
@@ -49,6 +99,9 @@ interface ProductRequestOptions {
     /** When true, populates `history.price.*` and the scalar `price` / `listPrice`
      *  fields on each returned product. Increases token cost. */
     history?: boolean;
+    /** When true, populates the `stats` namespace (buy-box saving basis, etc.).
+     *  Increases token cost. */
+    stats?: boolean;
 }
 interface ProductListParams extends ProductRequestOptions {
     asins: string[];
@@ -98,6 +151,11 @@ interface KeepaProduct {
     newPrice: number | null;
     /** Latest list price / MSRP (csv[4]) in the marketplace's major unit. */
     listPrice: number | null;
+    /** Keepa's monthly-sold estimate from Amazon's "X+ bought in past month"
+     *  widget. Null when Amazon doesn't show the widget for this ASIN — common
+     *  for lower-velocity / non-US listings. Distinguishable from a genuine
+     *  zero, which surfaces as `0`. */
+    monthlySold: number | null;
     history: {
         price: {
             /** Empty when `history: false`. Sentinel-filtered. */
@@ -108,6 +166,14 @@ interface KeepaProduct {
             list: PriceHistoryEntry[];
         };
     };
+    stats: {
+        /** Buy box strikethrough reference price in the marketplace's major unit.
+         *  Null when `stats: false` was used or Keepa has no saving-basis data. */
+        buyBoxSavingBasis: number | null;
+        /** Reference type for the strikethrough price (`LIST_PRICE` or `WAS_PRICE`).
+         *  Null when unavailable. */
+        buyBoxSavingBasisType: SavingBasisType | null;
+    };
 }
 
 declare class Products extends APIResource {
@@ -116,6 +182,96 @@ declare class Products extends APIResource {
     retrieve(params: ProductRetrieveParams): Promise<KeepaProduct>;
 }
 
+interface CategoryListParams {
+    /** Browse-node ids to look up. Sent as a comma-separated list to Keepa. */
+    ids: number[];
+    /** Case-insensitive at runtime. Defaults to 'US'. */
+    marketplace?: Marketplace;
+    /** When true, requests Keepa to include ancestor records in the response.
+     *  Empirically the response shape doesn't change for most categories — the
+     *  flag is exposed for completeness but most consumers will leave it off
+     *  (the default) and walk the breadcrumb from the product's `categoryTree`. */
+    withParents?: boolean;
+}
+interface CategorySearchParams {
+    /** Free-text query (e.g. "dog hat", "yoga mat"). Keepa runs its own
+     *  category-name fuzzy match. */
+    term: string;
+    /** Case-insensitive at runtime. Defaults to 'US'. */
+    marketplace?: Marketplace;
+}
+interface KeepaCategory {
+    catId: number;
+    /** Leaf-only name (e.g. "Coats, Jackets & Gilets"). Collides across
+     *  departments — use `contextFreeName` for the disambiguated form. */
+    name: string;
+    /** Keepa's pre-built disambiguated label (e.g. "Women's Coats, Jackets &
+     *  Gilets"). Missing on very old / experimental nodes; callers should fall
+     *  back to `name`. */
+    contextFreeName?: string;
+    children: number[] | null;
+    /** Parent browse-node id. `0` marks a root category. */
+    parent: number;
+    productCount: number;
+}
+interface CategorySearchHit {
+    catId: number;
+    name: string;
+    /** Lowest BSR seen for any product currently in the category — a rough
+     *  proxy for "how competitive is this category at the top". */
+    lowestRank: number;
+    /** Highest BSR (i.e. weakest top performer) in the category. */
+    highestRank: number;
+    productCount: number;
+}
+
+declare class Categories extends APIResource {
+    /**
+     * Resolve category metadata by browse-node id. Returns a map keyed by
+     * `catId` for easy lookup; missing ids in the response (Keepa silently
+     * omits unknown nodes) are simply absent from the result.
+     */
+    list(params: CategoryListParams): Promise<Record<number, KeepaCategory>>;
+    /**
+     * Free-text search against Keepa's category index. Hits the
+     * `/search?type=category` endpoint — Keepa's `/search` is category-
+     * specific despite the generic-sounding path, so it lives here as a
+     * Categories method rather than a separate resource.
+     *
+     * Empty array on "no matches" — Keepa doesn't distinguish that from a
+     * missing `categories` field in the response.
+     */
+    search(params: CategorySearchParams): Promise<CategorySearchHit[]>;
+}
+
+interface BestSellerRetrieveParams {
+    /** Browse-node id of the category to fetch the best-seller list for. */
+    categoryId: number;
+    /** Case-insensitive at runtime. Defaults to 'US'. */
+    marketplace?: Marketplace;
+    /** When true, asks Keepa for the sub-category top list (shorter, faster).
+     *  Default true — full lists run into thousands of ASINs per category and
+     *  are rarely what callers want. */
+    sublist?: boolean;
+}
+interface KeepaBestSellerList {
+    categoryId: number;
+    /** Ordered top-to-bottom. May be empty when Keepa has no list for the
+     *  category — non-leaf nodes and some sparse leaves return null at the
+     *  response level (see `BestSellers.retrieve` return type). */
+    asinList: string[];
+}
+
+declare class BestSellers extends APIResource {
+    /**
+     * Fetch the best-seller list for a category. Returns null when Keepa has
+     * no list (typical for non-leaf nodes and sparse leaves) rather than
+     * throwing — callers usually want to surface "no data" as a row state,
+     * not an error.
+     */
+    retrieve(params: BestSellerRetrieveParams): Promise<KeepaBestSellerList | null>;
+}
+
 interface ClientOptions {
     /** Falls back to `process.env.KEEPA_API_KEY` when omitted. */
     apiKey?: string;
@@ -127,6 +283,8 @@ declare class KeepaClient {
     readonly baseURL: string;
     readonly fetch: typeof globalThis.fetch;
     readonly products: Products;
+    readonly categories: Categories;
+    readonly bestSellers: BestSellers;
     /** Latest rate-limit snapshot from Keepa, updated after every response.
      *  Null until the first request completes. */
     rateLimit: RateLimitInfo | null;
@@ -166,6 +324,16 @@ declare const ASIN_REGEX: RegExp;
 declare function isValidAsin(value: string): boolean;
 declare function normalizeAsins(asins: string[]): string[];
 
+/** Keepa's smallest-currency unit (cents/pence/…) → marketplace's major unit.
+ *  Keepa scales JPY/INR/BRL by 100 too, so /100 produces the right unit across
+ *  every supported region. Returns null for missing values, non-finite numbers,
+ *  and the `-1` no-data sentinel. */
+declare function parsePrice(value: unknown): number | null;
+/** Keepa returns `-1` when Amazon doesn't show the "bought in past month"
+ *  widget for the ASIN; surface that as null so callers can distinguish "no
+ *  data" from a genuine zero. */
+declare function parseMonthlySold(value: unknown): number | null;
+declare function parseSavingBasisType(value: unknown): SavingBasisType | null;
 declare function parsePriceHistory(series: number[] | undefined): PriceHistoryEntry[];
 /** Stubs for unknown ASINs come back with `title: null`. */
 declare function isFoundProduct(product: KeepaProduct): boolean;
@@ -180,51 +348,6 @@ declare class ProductNotFoundError extends KeepaError {
     constructor(asin: string);
 }
 
-declare const PRODUCT_PATH = "/product";
-declare const PRODUCT_LIST_CONTEXT = "products.list";
-declare const DEFAULT_DAYS = 1;
-declare const AMAZON_IMAGE_BASE = "https://m.media-amazon.com/images/I";
-declare const KEEPA_NO_DATA_SENTINEL = -1;
-declare const CsvType: {
-    readonly AMAZON: 0;
-    readonly NEW: 1;
-    readonly USED: 2;
-    readonly SALES: 3;
-    readonly LISTPRICE: 4;
-    readonly COLLECTIBLE: 5;
-    readonly REFURBISHED: 6;
-    readonly NEW_FBM_SHIPPING: 7;
-    readonly LIGHTNING_DEAL: 8;
-    readonly WAREHOUSE: 9;
-    readonly NEW_FBA: 10;
-    readonly COUNT_NEW: 11;
-    readonly COUNT_USED: 12;
-    readonly COUNT_REFURBISHED: 13;
-    readonly COUNT_COLLECTIBLE: 14;
-    readonly EXTRA_INFO_UPDATES: 15;
-    readonly RATING: 16;
-    readonly COUNT_REVIEWS: 17;
-    readonly BUY_BOX_SHIPPING: 18;
-    readonly USED_NEW_SHIPPING: 19;
-    readonly USED_VERY_GOOD_SHIPPING: 20;
-    readonly USED_GOOD_SHIPPING: 21;
-    readonly USED_ACCEPTABLE_SHIPPING: 22;
-    readonly COLLECTIBLE_NEW_SHIPPING: 23;
-    readonly COLLECTIBLE_VERY_GOOD_SHIPPING: 24;
-    readonly COLLECTIBLE_GOOD_SHIPPING: 25;
-    readonly COLLECTIBLE_ACCEPTABLE_SHIPPING: 26;
-    readonly REFURBISHED_SHIPPING: 27;
-    readonly EBAY_NEW_SHIPPING: 28;
-    readonly EBAY_USED_SHIPPING: 29;
-    readonly TRADE_IN: 30;
-    readonly RENTAL: 31;
-    readonly BUY_BOX_USED_SHIPPING: 32;
-    readonly PRIME_EXCL: 33;
-    readonly COUNT_NEW_FBA: 34;
-    readonly COUNT_NEW_FBM: 35;
-};
-type CsvType = (typeof CsvType)[keyof typeof CsvType];
-
 declare const VERSION = "0.1.0";
 
-export { AMAZON_IMAGE_BASE, APIError, APIResource, ASIN_LENGTH, ASIN_REGEX, AuthenticationError, type ClientOptions, CsvType, DEFAULT_DAYS, type DomainId, KEEPA_NO_DATA_SENTINEL, type KeepaCategoryNode, KeepaClient, KeepaError, type KeepaProduct, type KeepaVariation, type KeepaVariationAttribute, MARKETPLACE_DOMAINS, type Marketplace, NetworkError, PRODUCT_LIST_CONTEXT, PRODUCT_PATH, type PriceHistoryEntry, type ProductListParams, ProductNotFoundError, type ProductRequestOptions, type ProductRetrieveParams, Products, RateLimitError, type RateLimitInfo, VERSION, KeepaClient as default, extractBsr, isFoundProduct, isValidAsin, normalizeAsins, parsePriceHistory, resolveDomainId };
+export { AMAZON_IMAGE_BASE, APIError, APIResource, ASIN_LENGTH, ASIN_REGEX, AuthenticationError, type BestSellerRetrieveParams, BestSellers, Categories, type CategoryListParams, type CategorySearchHit, type CategorySearchParams, type ClientOptions, CsvType, DEFAULT_DAYS, type DomainId, KEEPA_NO_DATA_SENTINEL, type KeepaBestSellerList, type KeepaCategory, type KeepaCategoryNode, KeepaClient, KeepaError, type KeepaProduct, type KeepaVariation, type KeepaVariationAttribute, MARKETPLACE_DOMAINS, type Marketplace, NetworkError, PRODUCT_LIST_CONTEXT, PRODUCT_PATH, type PriceHistoryEntry, type ProductListParams, ProductNotFoundError, type ProductRequestOptions, type ProductRetrieveParams, Products, RateLimitError, type RateLimitInfo, SavingBasisType, VERSION, KeepaClient as default, extractBsr, isFoundProduct, isValidAsin, normalizeAsins, parseMonthlySold, parsePrice, parsePriceHistory, parseSavingBasisType, resolveDomainId };

package/dist/index.d.ts

@@ -41,6 +41,56 @@ type Marketplace = keyof typeof MARKETPLACE_DOMAINS;
 type DomainId = (typeof MARKETPLACE_DOMAINS)[Marketplace];
 declare function resolveDomainId(marketplace: string | undefined): DomainId;
 
+declare const PRODUCT_PATH = "/product";
+declare const PRODUCT_LIST_CONTEXT = "products.list";
+declare const DEFAULT_DAYS = 1;
+declare const AMAZON_IMAGE_BASE = "https://m.media-amazon.com/images/I";
+declare const KEEPA_NO_DATA_SENTINEL = -1;
+declare const CsvType: {
+    readonly AMAZON: 0;
+    readonly NEW: 1;
+    readonly USED: 2;
+    readonly SALES: 3;
+    readonly LISTPRICE: 4;
+    readonly COLLECTIBLE: 5;
+    readonly REFURBISHED: 6;
+    readonly NEW_FBM_SHIPPING: 7;
+    readonly LIGHTNING_DEAL: 8;
+    readonly WAREHOUSE: 9;
+    readonly NEW_FBA: 10;
+    readonly COUNT_NEW: 11;
+    readonly COUNT_USED: 12;
+    readonly COUNT_REFURBISHED: 13;
+    readonly COUNT_COLLECTIBLE: 14;
+    readonly EXTRA_INFO_UPDATES: 15;
+    readonly RATING: 16;
+    readonly COUNT_REVIEWS: 17;
+    readonly BUY_BOX_SHIPPING: 18;
+    readonly USED_NEW_SHIPPING: 19;
+    readonly USED_VERY_GOOD_SHIPPING: 20;
+    readonly USED_GOOD_SHIPPING: 21;
+    readonly USED_ACCEPTABLE_SHIPPING: 22;
+    readonly COLLECTIBLE_NEW_SHIPPING: 23;
+    readonly COLLECTIBLE_VERY_GOOD_SHIPPING: 24;
+    readonly COLLECTIBLE_GOOD_SHIPPING: 25;
+    readonly COLLECTIBLE_ACCEPTABLE_SHIPPING: 26;
+    readonly REFURBISHED_SHIPPING: 27;
+    readonly EBAY_NEW_SHIPPING: 28;
+    readonly EBAY_USED_SHIPPING: 29;
+    readonly TRADE_IN: 30;
+    readonly RENTAL: 31;
+    readonly BUY_BOX_USED_SHIPPING: 32;
+    readonly PRIME_EXCL: 33;
+    readonly COUNT_NEW_FBA: 34;
+    readonly COUNT_NEW_FBM: 35;
+};
+type CsvType = (typeof CsvType)[keyof typeof CsvType];
+declare const SavingBasisType: {
+    readonly LIST_PRICE: 0;
+    readonly WAS_PRICE: 1;
+};
+type SavingBasisType = (typeof SavingBasisType)[keyof typeof SavingBasisType];
+
 interface ProductRequestOptions {
     /** Case-insensitive at runtime. Defaults to 'US'. */
     marketplace?: Marketplace;
@@ -49,6 +99,9 @@ interface ProductRequestOptions {
     /** When true, populates `history.price.*` and the scalar `price` / `listPrice`
      *  fields on each returned product. Increases token cost. */
     history?: boolean;
+    /** When true, populates the `stats` namespace (buy-box saving basis, etc.).
+     *  Increases token cost. */
+    stats?: boolean;
 }
 interface ProductListParams extends ProductRequestOptions {
     asins: string[];
@@ -98,6 +151,11 @@ interface KeepaProduct {
     newPrice: number | null;
     /** Latest list price / MSRP (csv[4]) in the marketplace's major unit. */
     listPrice: number | null;
+    /** Keepa's monthly-sold estimate from Amazon's "X+ bought in past month"
+     *  widget. Null when Amazon doesn't show the widget for this ASIN — common
+     *  for lower-velocity / non-US listings. Distinguishable from a genuine
+     *  zero, which surfaces as `0`. */
+    monthlySold: number | null;
     history: {
         price: {
             /** Empty when `history: false`. Sentinel-filtered. */
@@ -108,6 +166,14 @@ interface KeepaProduct {
             list: PriceHistoryEntry[];
         };
     };
+    stats: {
+        /** Buy box strikethrough reference price in the marketplace's major unit.
+         *  Null when `stats: false` was used or Keepa has no saving-basis data. */
+        buyBoxSavingBasis: number | null;
+        /** Reference type for the strikethrough price (`LIST_PRICE` or `WAS_PRICE`).
+         *  Null when unavailable. */
+        buyBoxSavingBasisType: SavingBasisType | null;
+    };
 }
 
 declare class Products extends APIResource {
@@ -116,6 +182,96 @@ declare class Products extends APIResource {
     retrieve(params: ProductRetrieveParams): Promise<KeepaProduct>;
 }
 
+interface CategoryListParams {
+    /** Browse-node ids to look up. Sent as a comma-separated list to Keepa. */
+    ids: number[];
+    /** Case-insensitive at runtime. Defaults to 'US'. */
+    marketplace?: Marketplace;
+    /** When true, requests Keepa to include ancestor records in the response.
+     *  Empirically the response shape doesn't change for most categories — the
+     *  flag is exposed for completeness but most consumers will leave it off
+     *  (the default) and walk the breadcrumb from the product's `categoryTree`. */
+    withParents?: boolean;
+}
+interface CategorySearchParams {
+    /** Free-text query (e.g. "dog hat", "yoga mat"). Keepa runs its own
+     *  category-name fuzzy match. */
+    term: string;
+    /** Case-insensitive at runtime. Defaults to 'US'. */
+    marketplace?: Marketplace;
+}
+interface KeepaCategory {
+    catId: number;
+    /** Leaf-only name (e.g. "Coats, Jackets & Gilets"). Collides across
+     *  departments — use `contextFreeName` for the disambiguated form. */
+    name: string;
+    /** Keepa's pre-built disambiguated label (e.g. "Women's Coats, Jackets &
+     *  Gilets"). Missing on very old / experimental nodes; callers should fall
+     *  back to `name`. */
+    contextFreeName?: string;
+    children: number[] | null;
+    /** Parent browse-node id. `0` marks a root category. */
+    parent: number;
+    productCount: number;
+}
+interface CategorySearchHit {
+    catId: number;
+    name: string;
+    /** Lowest BSR seen for any product currently in the category — a rough
+     *  proxy for "how competitive is this category at the top". */
+    lowestRank: number;
+    /** Highest BSR (i.e. weakest top performer) in the category. */
+    highestRank: number;
+    productCount: number;
+}
+
+declare class Categories extends APIResource {
+    /**
+     * Resolve category metadata by browse-node id. Returns a map keyed by
+     * `catId` for easy lookup; missing ids in the response (Keepa silently
+     * omits unknown nodes) are simply absent from the result.
+     */
+    list(params: CategoryListParams): Promise<Record<number, KeepaCategory>>;
+    /**
+     * Free-text search against Keepa's category index. Hits the
+     * `/search?type=category` endpoint — Keepa's `/search` is category-
+     * specific despite the generic-sounding path, so it lives here as a
+     * Categories method rather than a separate resource.
+     *
+     * Empty array on "no matches" — Keepa doesn't distinguish that from a
+     * missing `categories` field in the response.
+     */
+    search(params: CategorySearchParams): Promise<CategorySearchHit[]>;
+}
+
+interface BestSellerRetrieveParams {
+    /** Browse-node id of the category to fetch the best-seller list for. */
+    categoryId: number;
+    /** Case-insensitive at runtime. Defaults to 'US'. */
+    marketplace?: Marketplace;
+    /** When true, asks Keepa for the sub-category top list (shorter, faster).
+     *  Default true — full lists run into thousands of ASINs per category and
+     *  are rarely what callers want. */
+    sublist?: boolean;
+}
+interface KeepaBestSellerList {
+    categoryId: number;
+    /** Ordered top-to-bottom. May be empty when Keepa has no list for the
+     *  category — non-leaf nodes and some sparse leaves return null at the
+     *  response level (see `BestSellers.retrieve` return type). */
+    asinList: string[];
+}
+
+declare class BestSellers extends APIResource {
+    /**
+     * Fetch the best-seller list for a category. Returns null when Keepa has
+     * no list (typical for non-leaf nodes and sparse leaves) rather than
+     * throwing — callers usually want to surface "no data" as a row state,
+     * not an error.
+     */
+    retrieve(params: BestSellerRetrieveParams): Promise<KeepaBestSellerList | null>;
+}
+
 interface ClientOptions {
     /** Falls back to `process.env.KEEPA_API_KEY` when omitted. */
     apiKey?: string;
@@ -127,6 +283,8 @@ declare class KeepaClient {
     readonly baseURL: string;
     readonly fetch: typeof globalThis.fetch;
     readonly products: Products;
+    readonly categories: Categories;
+    readonly bestSellers: BestSellers;
     /** Latest rate-limit snapshot from Keepa, updated after every response.
      *  Null until the first request completes. */
     rateLimit: RateLimitInfo | null;
@@ -166,6 +324,16 @@ declare const ASIN_REGEX: RegExp;
 declare function isValidAsin(value: string): boolean;
 declare function normalizeAsins(asins: string[]): string[];
 
+/** Keepa's smallest-currency unit (cents/pence/…) → marketplace's major unit.
+ *  Keepa scales JPY/INR/BRL by 100 too, so /100 produces the right unit across
+ *  every supported region. Returns null for missing values, non-finite numbers,
+ *  and the `-1` no-data sentinel. */
+declare function parsePrice(value: unknown): number | null;
+/** Keepa returns `-1` when Amazon doesn't show the "bought in past month"
+ *  widget for the ASIN; surface that as null so callers can distinguish "no
+ *  data" from a genuine zero. */
+declare function parseMonthlySold(value: unknown): number | null;
+declare function parseSavingBasisType(value: unknown): SavingBasisType | null;
 declare function parsePriceHistory(series: number[] | undefined): PriceHistoryEntry[];
 /** Stubs for unknown ASINs come back with `title: null`. */
 declare function isFoundProduct(product: KeepaProduct): boolean;
@@ -180,51 +348,6 @@ declare class ProductNotFoundError extends KeepaError {
     constructor(asin: string);
 }
 
-declare const PRODUCT_PATH = "/product";
-declare const PRODUCT_LIST_CONTEXT = "products.list";
-declare const DEFAULT_DAYS = 1;
-declare const AMAZON_IMAGE_BASE = "https://m.media-amazon.com/images/I";
-declare const KEEPA_NO_DATA_SENTINEL = -1;
-declare const CsvType: {
-    readonly AMAZON: 0;
-    readonly NEW: 1;
-    readonly USED: 2;
-    readonly SALES: 3;
-    readonly LISTPRICE: 4;
-    readonly COLLECTIBLE: 5;
-    readonly REFURBISHED: 6;
-    readonly NEW_FBM_SHIPPING: 7;
-    readonly LIGHTNING_DEAL: 8;
-    readonly WAREHOUSE: 9;
-    readonly NEW_FBA: 10;
-    readonly COUNT_NEW: 11;
-    readonly COUNT_USED: 12;
-    readonly COUNT_REFURBISHED: 13;
-    readonly COUNT_COLLECTIBLE: 14;
-    readonly EXTRA_INFO_UPDATES: 15;
-    readonly RATING: 16;
-    readonly COUNT_REVIEWS: 17;
-    readonly BUY_BOX_SHIPPING: 18;
-    readonly USED_NEW_SHIPPING: 19;
-    readonly USED_VERY_GOOD_SHIPPING: 20;
-    readonly USED_GOOD_SHIPPING: 21;
-    readonly USED_ACCEPTABLE_SHIPPING: 22;
-    readonly COLLECTIBLE_NEW_SHIPPING: 23;
-    readonly COLLECTIBLE_VERY_GOOD_SHIPPING: 24;
-    readonly COLLECTIBLE_GOOD_SHIPPING: 25;
-    readonly COLLECTIBLE_ACCEPTABLE_SHIPPING: 26;
-    readonly REFURBISHED_SHIPPING: 27;
-    readonly EBAY_NEW_SHIPPING: 28;
-    readonly EBAY_USED_SHIPPING: 29;
-    readonly TRADE_IN: 30;
-    readonly RENTAL: 31;
-    readonly BUY_BOX_USED_SHIPPING: 32;
-    readonly PRIME_EXCL: 33;
-    readonly COUNT_NEW_FBA: 34;
-    readonly COUNT_NEW_FBM: 35;
-};
-type CsvType = (typeof CsvType)[keyof typeof CsvType];
-
 declare const VERSION = "0.1.0";
 
-export { AMAZON_IMAGE_BASE, APIError, APIResource, ASIN_LENGTH, ASIN_REGEX, AuthenticationError, type ClientOptions, CsvType, DEFAULT_DAYS, type DomainId, KEEPA_NO_DATA_SENTINEL, type KeepaCategoryNode, KeepaClient, KeepaError, type KeepaProduct, type KeepaVariation, type KeepaVariationAttribute, MARKETPLACE_DOMAINS, type Marketplace, NetworkError, PRODUCT_LIST_CONTEXT, PRODUCT_PATH, type PriceHistoryEntry, type ProductListParams, ProductNotFoundError, type ProductRequestOptions, type ProductRetrieveParams, Products, RateLimitError, type RateLimitInfo, VERSION, KeepaClient as default, extractBsr, isFoundProduct, isValidAsin, normalizeAsins, parsePriceHistory, resolveDomainId };
+export { AMAZON_IMAGE_BASE, APIError, APIResource, ASIN_LENGTH, ASIN_REGEX, AuthenticationError, type BestSellerRetrieveParams, BestSellers, Categories, type CategoryListParams, type CategorySearchHit, type CategorySearchParams, type ClientOptions, CsvType, DEFAULT_DAYS, type DomainId, KEEPA_NO_DATA_SENTINEL, type KeepaBestSellerList, type KeepaCategory, type KeepaCategoryNode, KeepaClient, KeepaError, type KeepaProduct, type KeepaVariation, type KeepaVariationAttribute, MARKETPLACE_DOMAINS, type Marketplace, NetworkError, PRODUCT_LIST_CONTEXT, PRODUCT_PATH, type PriceHistoryEntry, type ProductListParams, ProductNotFoundError, type ProductRequestOptions, type ProductRetrieveParams, Products, RateLimitError, type RateLimitInfo, SavingBasisType, VERSION, KeepaClient as default, extractBsr, isFoundProduct, isValidAsin, normalizeAsins, parseMonthlySold, parsePrice, parsePriceHistory, parseSavingBasisType, resolveDomainId };