scavio 0.10.0 → 0.12.0

package/README.md

@@ -65,23 +65,52 @@ await client.google.trends({ query: "bitcoin" });
 
 ### Amazon
 
+Responses are normalized to a stable shape (see the breaking-change note
+below); each call costs 1 credit. `country` is an ISO 3166-1 alpha-2
+marketplace code (`us`, `gb`, `de`, ...) and defaults to `us`.
+
 ```typescript
 // Search products
 await client.amazon.search({
   query: "laptop",
-  domain: "amazon.com",    // optional
-  country: "us",           // optional
-  sort_by: "price_asc",   // optional
-  pages: 1,                // optional
+  country: "de",           // optional, marketplace
+  page: 2,                 // optional, 1-based
 });
 
 // Get product by ASIN
 await client.amazon.product({
   asin: "B09V3KXJPB",
-  domain: "amazon.com",    // optional
+  country: "us",           // optional
 });
+
+// Every seller offering that ASIN, with the buy box winner flagged
+const res = await client.amazon.offers({ asin: "B09V3KXJPB" });
+// res.data   -> { asin, title, count, total_offers, has_more_pages, page, offers[] }
+// res.data.offers[i] -> { price, currency, condition, seller_name,
+//                         is_buy_box_winner, is_fulfilled_by_amazon,
+//                         shipping_price, list_price, delivery, prime_delivery }
+
+// Supported marketplaces (no API key required)
+await client.amazon.options();
 ```
 
+There is no sort parameter: the marketplace was verified to ignore every sort
+value and return the same unordered set, so exposing one would be a filter that
+silently does nothing.
+
+#### Amazon changed in 0.12.0 (breaking)
+
+Amazon moved to a new upstream and the API now returns a normalized shape
+instead of the previous raw provider payload.
+
+- `search` returns `{query, page, total_results, total_results_text, count, products[], filters[], related_searches[]}`.
+  Each product is `{asin, title, url, image, price, currency, rating, reviews_count, is_sponsored, position, badge, sales_volume, delivery{is_free, date, fastest_date}}`.
+- `product` returns flat fields: `price`, `list_price`, `currency`, `rating`, `reviews_count`, `features`, `images`, `videos`, `variants`, `specifications`, `best_sellers_rank`, `shipping`, and more. The old `buybox[]` array no longer exists — use `offers` for per-seller pricing.
+- `offers` is new: every seller for one ASIN. 1 credit, page 1 only.
+- `country` (ISO 3166-1 alpha-2) is the marketplace selector and replaces `domain`; `page` replaces `start_page`. Both old names still work as deprecated aliases.
+- Nine options were removed: `language`, `currency`, `device`, `sort_by`, `pages`, `category_id`, `merchant_id`, `zip_code`, `autoselect_variant`. Sending one anyway still returns 200, with a top-level `warnings` array naming what was ignored.
+- `options()` still returns `domains` and `countries`; `languages` and `currencies` are now always empty, because neither is a request parameter any more.
+
 ### Walmart
 
 ```typescript

package/dist/index.cjs

@@ -311,7 +311,18 @@ var AmazonNamespace = class {
       ...rest
     });
   }
-  /** Supported Amazon domains, languages, currencies, and countries. */
+  /** Every seller offer for one ASIN: price, seller, condition, shipping, and
+   *  which offer holds the buy box. Page 1 only. */
+  async offers(options) {
+    const { asin, ...rest } = options;
+    return this.client._post("/api/v1/amazon/offers", {
+      query: asin,
+      ...rest
+    });
+  }
+  /** Supported Amazon marketplaces, as `domains` and `countries`. `languages`
+   *  and `currencies` remain in the payload but are always empty: neither is a
+   *  request parameter any more. */
   async options() {
     return this.client._get("/api/v1/amazon/options");
   }
@@ -764,7 +775,10 @@ var LinkedInNamespace = class {
   async personAbout(options) {
     return this.client._post("/api/v1/linkedin/person/about", options);
   }
-  /** Recent posts, up to 50. Upstream exposes no further pages. */
+  /**
+   * A member's posts, or the posts they commented on or reacted to via `type`.
+   * 50 per page; pass the previous response's `next_cursor` to advance.
+   */
   async personPosts(options) {
     return this.client._post("/api/v1/linkedin/person/posts", options);
   }
@@ -772,11 +786,14 @@ var LinkedInNamespace = class {
   async company(options) {
     return this.client._post("/api/v1/linkedin/company", options);
   }
-  /** Recent company posts, up to 50. Upstream exposes no further pages. */
+  /** Recent company posts, 50 per page; advance with `next_cursor`. */
   async companyPosts(options) {
     return this.client._post("/api/v1/linkedin/company/posts", options);
   }
-  /** Job search. Upstream rotates its result set, so repeat calls differ. */
+  /**
+   * Job search, 25 per page; advance with `next_cursor`. Upstream rotates its
+   * result set, so pages overlap slightly - dedupe by job id.
+   */
   async searchJobs(options) {
     return this.client._post("/api/v1/linkedin/search/jobs", options);
   }
@@ -788,7 +805,7 @@ var LinkedInNamespace = class {
   async post(options) {
     return this.client._post("/api/v1/linkedin/post", options);
   }
-  /** Comments with their replies, 10 per page. */
+  /** Comments with their replies. Page size varies - keep paging until empty. */
   async postComments(options) {
     return this.client._post("/api/v1/linkedin/post/comments", options);
   }