@crawlora-org/sdk 1.2.0-sdk.18 → 1.3.0-sdk.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## v1.3.0-sdk.1
+
+- Added `CrawloraClientError`, `CrawloraServerError`, and `CrawloraNetworkError`
+  subclasses of `CrawloraError` so callers can branch on 4xx vs 5xx vs transport
+  failures.
+- Added `client.paginate(operationId, params, options?)`, an async iterator that
+  advances the page/offset query parameter and stops on an empty page.
+- Added the generated `OperationIds` map for typo-safe dynamic operation ids,
+  e.g. `client.request(OperationIds.BingSearch, { q: "coffee" })`.
+- The generator now shares a single language-neutral core with the Go and Python
+  SDKs; generated output is unchanged.
+
+## v1.2.0-sdk.19
+
+- Regenerated the public SDK contract with the promoted Shopify endpoint family.
+- Added the generated `shopify` group with 11 active Shopify operations.
+- Updated the generated operation reference to 330 public SDK operations.
+
 ## v1.2.0-sdk.18
 
 - Regenerated the public SDK contract for the Shop.app endpoint family.

package/README.md

@@ -142,6 +142,23 @@ The error includes `status`, optional API `code`, parsed `body`, response
 headers, capped at 30 seconds. Externally aborted requests fail with
 `Crawlora request aborted` and are not retried.
 
+`CrawloraError` has three subclasses so you can branch on the failure kind:
+`CrawloraClientError` (4xx, request rejected), `CrawloraServerError` (5xx), and
+`CrawloraNetworkError` (transport failure, timeout, or abort before a response).
+
+## Pagination
+
+`client.paginate` is an async iterator that advances the page/offset query
+parameter and stops when a page returns no data:
+
+```js
+for await (const page of crawlora.paginate("ebay-seller-feedback", { seller: "acme" })) {
+  for (const review of page.data) console.log(review);
+}
+```
+
+Override detection with `{ pageParam, start, step, maxPages }`.
+
 ## Examples
 
 Runnable examples live under `examples/` and skip cleanly when required

package/docs/operations.md

@@ -2,7 +2,7 @@
 
 Generated from `openapi/public.json`. Deprecated, admin, and internal operations are excluded from this SDK contract.
 
-Total operations: `319`
+Total operations: `330`
 
 | Group | SDK method | Operation ID | HTTP | Params | Auth | Response | Notes |
 | --- | --- | --- | --- | --- | --- | --- | --- |
@@ -186,6 +186,17 @@ Total operations: `319`
 | shopApp | `shopApp.shopReviews` | `shop-app-shop-reviews` | `GET /shop-app/shops/{handle}/reviews` | `handle` (path string required)<br>`limit` (query number) | `ApiKeyAuth` | `ShopAppShopReviewsResponse` |  |
 | shopApp | `shopApp.shopTypeahead` | `shop-app-shop-typeahead` | `GET /shop-app/shops/{handle}/typeahead` | `handle` (path string required)<br>`query` (query string required)<br>`limit` (query number) | `ApiKeyAuth` | `ShopAppShopTypeaheadResponse` |  |
 | shopApp | `shopApp.suggestions` | `shop-app-suggestions` | `GET /shop-app/suggestions` | `query` (query string required)<br>`limit` (query number) | `ApiKeyAuth` | `ShopAppSuggestionsResponse` |  |
+| shopify | `shopify.collections` | `shopify-collections` | `GET /shopify/collections` | `url` (query string required)<br>`page` (query number)<br>`limit` (query number) | `ApiKeyAuth` | `ShopifyCollectionsResponse` |  |
+| shopify | `shopify.collectionProducts` | `shopify-collection-products` | `GET /shopify/collections/{handle}/products` | `handle` (path string required)<br>`url` (query string required)<br>`page` (query number)<br>`limit` (query number) | `ApiKeyAuth` | `ShopifyCollectionProductsResponse` |  |
+| shopify | `shopify.pages` | `shopify-pages` | `GET /shopify/pages` | `url` (query string required)<br>`page` (query number)<br>`limit` (query number) | `ApiKeyAuth` | `ShopifyPagesResponse` |  |
+| shopify | `shopify.page` | `shopify-page` | `GET /shopify/pages/{handle}` | `handle` (path string required)<br>`url` (query string required) | `ApiKeyAuth` | `ShopifyPageResponse` |  |
+| shopify | `shopify.products` | `shopify-products` | `GET /shopify/products` | `url` (query string required)<br>`page` (query number)<br>`limit` (query number) | `ApiKeyAuth` | `ShopifyProductsResponse` |  |
+| shopify | `shopify.product` | `shopify-product` | `GET /shopify/products/{handle}` | `handle` (path string required)<br>`url` (query string required) | `ApiKeyAuth` | `ShopifyProductResponse` |  |
+| shopify | `shopify.productRecommendations` | `shopify-product-recommendations` | `GET /shopify/products/{handle}/recommendations` | `handle` (path string required)<br>`url` (query string required)<br>`limit` (query number)<br>`intent` (query "related" \| "complementary") | `ApiKeyAuth` | `ShopifyProductRecommendationsResponse` |  |
+| shopify | `shopify.searchSuggest` | `shopify-search-suggest` | `GET /shopify/search/suggest` | `url` (query string required)<br>`q` (query string required)<br>`types` (query string)<br>`limit` (query number) | `ApiKeyAuth` | `ShopifySearchSuggestResponse` |  |
+| shopify | `shopify.sitemapUrls` | `shopify-sitemap-urls` | `GET /shopify/sitemap/urls` | `url` (query string required)<br>`type` (query "all" \| "products" \| "collections" \| "pages" \| "blogs" \| "agentic_discovery" \| "other")<br>`limit` (query number) | `ApiKeyAuth` | `ShopifySitemapUrlsResponse` |  |
+| shopify | `shopify.sitemaps` | `shopify-sitemaps` | `GET /shopify/sitemaps` | `url` (query string required) | `ApiKeyAuth` | `ShopifySitemapsResponse` |  |
+| shopify | `shopify.store` | `shopify-store` | `GET /shopify/store` | `url` (query string required) | `ApiKeyAuth` | `ShopifyStoreResponse` |  |
 | similarWeb | `similarWeb.search` | `similarweb-search` | `GET /similarweb/search` | `q` (query string required) | `ApiKeyAuth` | `SimilarWebSearchResponse` |  |
 | similarWeb | `similarWeb.web` | `similarweb-web` | `GET /similarweb/web/{domain}` | `domain` (path string required) | `ApiKeyAuth` | `SimilarWebWebResponse` |  |
 | spotifyPodcasts | `spotifyPodcasts.categories` | `spotify-podcasts-categories` | `GET /spotify-podcasts/categories` | `uri` (query string)<br>`page_offset` (query number)<br>`page_limit` (query number)<br>`section_offset` (query number)<br>`section_limit` (query number)<br>`include_episode_content_ratings_v2` (query boolean) | `ApiKeyAuth` | `SpotifyPodcastsCategoriesResponse` |  |