@usethrottle/catalog 1.3.0 → 1.4.1

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @usethrottle/catalog
 
+## 1.4.1
+
+### Patch Changes
+
+- c3f11bd: Throttle Builder preparation. The SDK exports the answer types of two new public storefront routes, `StorefrontLookupAnswer` (`GET /v1/storefront/lookup`: the current handle and title of catalog ids, public items only) and `StorefrontLatestReviewsAnswer` (`GET /v1/storefront/reviews`: the latest approved reviews across public products, each with its product). `settings.product.sections[].pageHandle` of `/config` can now be the slug of a Throttle Builder page (the product page `shipping` section's new `builderPageHandle`); its type is unchanged.
+- a3baea5: Money range aligned with `@usethrottle/money` 1.1 so stores install one copy.
+
+## 1.4.0
+
+### Minor Changes
+
+- c9636d7: Dynamic storefront. Everything is additive except the cache defaults below.
+
+  - `client.settings()` returns the store's theme, navigation, home page, strings and route patterns with `settingsVersion` and `generation`. `t(settings, key, vars)`, `resolveMenuTarget(settings, target)`, `DEFAULT_STRINGS` and `fontStylesheetHref` read them.
+  - `client.pages.list()` and `client.pages.get(handle)` read the store's content pages.
+  - `createServerCatalogClient({ cachePolicy })` sets how long each kind of read is cached (`'until-changed'`, `'no-store'` or a duration such as `'90s'`), with `DEFAULT_CACHE_POLICY`, `cacheKindForPath` and `policyToNext` exported from `/server`. Every read is tagged by family (`throttle-catalog:config`, `:pages`, `:data`) as well as by route and handle, and `scopesToTags(scopes)` turns the scopes of a change notice into the tags to clear.
+  - New entry `@usethrottle/catalog/next` for the Next.js App Router (`next` 14 or later, an optional peer): `createRevalidateHandler` verifies the signed `storefront.changed` webhook and revalidates the matching tags; the helpers `previewMiddleware` and `getPreviewToken` carry a dashboard preview token in an HTTP-only cookie; `noteMinGeneration` makes the next `/config` read at least that fresh.
+  - `previewToken` client option and a per-call `minGeneration` on settings and pages reads.
+  - React: `useStorefrontSettings` and `useGenerationWatch` (`/react`), `usePages` and `usePage` (`/react/extras`).
+
+  Behaviour changes: the default `revalidate` of `/config`, settings, pages and product reads is now 3600 seconds (it was 60), cleared sooner by tag revalidation; lists, filters, related products, reviews and search keep 60 seconds. Set `cachePolicy` to restore the old numbers. `x-storefront-preview` is a reserved header: the SDK sets it from `previewToken`.
+
 ## 1.3.0
 
 ### Minor Changes

package/README.md

@@ -36,14 +36,15 @@ Prices are integers in the minor units of their currency; format them with `form
 
 ## Entries
 
-| Import                              | What it holds                                                                                                                                                                                                                                                                           |
-| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `@usethrottle/catalog`              | `createCatalogClient`, the error classes and `isCatalogError`, the answer types, and the `@usethrottle/money` helpers (`money`, `formatMoney`, …). No DOM and no Node-only API.                                                                                                         |
-| `@usethrottle/catalog/react`        | `CatalogProvider`, the read hooks, `useCart`, `useSubmitReview` and `useCustomerKey` (marked `"use client"`).                                                                                                                                                                           |
-| `@usethrottle/catalog/react/extras` | `useTags`, `useCollections` and `useReviewEligibility` (marked `"use client"`). They share `CatalogProvider` and the cache with `/react`: import the provider from `/react` and these three from here.                                                                                  |
-| `@usethrottle/catalog/server`       | `createServerCatalogClient`, `catalogTags`, `syncCatalogGeneration` and the paging helpers (`listAllProductHandles`, `staticProductParams`, `listAllCollectionHandles`, `listAllCategoryHandles`: it asks for `CATEGORY_TREE_MAX_DEPTH` levels, 10, so a sitemap lists the whole tree). |
-| `@usethrottle/catalog/url`          | `parseShopQuery`, `serializeShopQuery`, `toProductsQuery`, `parseRange` and `formatRange`. Standalone: none of the client or React code (the ESM and CommonJS builds each load one tiny shared helper file).                                                                            |
-| `@usethrottle/catalog/admin`        | **Experimental, server only.** `createCatalogAdmin` and `verifyCatalogWebhook` for the catalog push API (sync jobs, single batches, runs, products, stock), and the push request and answer types. See [Admin](#admin-server-only-experimental).                                        |
+| Import                              | What it holds                                                                                                                                                                                                                                                                                     |
+| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `@usethrottle/catalog`              | `createCatalogClient`, the error classes and `isCatalogError`, the answer types, and the `@usethrottle/money` helpers (`money`, `formatMoney`, …). No DOM and no Node-only API.                                                                                                                   |
+| `@usethrottle/catalog/react`        | `CatalogProvider`, the read hooks, `useCart`, `useSubmitReview` and `useCustomerKey` (marked `"use client"`).                                                                                                                                                                                     |
+| `@usethrottle/catalog/react/extras` | `useTags`, `useCollections` and `useReviewEligibility` (marked `"use client"`). They share `CatalogProvider` and the cache with `/react`: import the provider from `/react` and these three from here.                                                                                            |
+| `@usethrottle/catalog/server`       | `createServerCatalogClient`, `catalogTags`, `syncCatalogGeneration` and the paging helpers (`listAllProductHandles`, `staticProductParams`, `listAllCollectionHandles`, `listAllCategoryHandles`: it asks for `CATEGORY_TREE_MAX_DEPTH` levels, 10, so a sitemap lists the whole tree).           |
+| `@usethrottle/catalog/next`         | **Server only.** `createRevalidateHandler` (the change-notice webhook), `previewMiddleware`, `getPreviewToken` and `noteMinGeneration` for the Next.js App Router. `next` (14 or later) is an optional peer. See [Revalidation webhook](#revalidation-webhook) and [Preview mode](#preview-mode). |
+| `@usethrottle/catalog/url`          | `parseShopQuery`, `serializeShopQuery`, `toProductsQuery`, `parseRange` and `formatRange`. Standalone: none of the client or React code (the ESM and CommonJS builds each load one tiny shared helper file).                                                                                      |
+| `@usethrottle/catalog/admin`        | **Experimental, server only.** `createCatalogAdmin` and `verifyCatalogWebhook` for the catalog push API (sync jobs, single batches, runs, products, stock), and the push request and answer types. See [Admin](#admin-server-only-experimental).                                                  |
 
 Everything `/react` exports is a client reference in a server component, `SDK_VERSION` and `catalogQueryKey` included: in server code import `SDK_VERSION` from the root or `/server`, and call `catalogQueryKey` only in client code.
 
@@ -312,7 +313,7 @@ function ReviewButton({ handle }: { handle: string }) {
 
 ## Next.js
 
-On the server, use a **server** key and `createServerCatalogClient`. Every catalog read's `fetch` carries `next: { revalidate, tags }` (60 seconds by default); carts, Throttle calls and any request with a customer token are `cache: 'no-store'`. Next.js itself is never imported.
+On the server, use a **server** key and `createServerCatalogClient`. Every catalog read's `fetch` carries `next: { revalidate, tags }` (an hour for settings, pages and products, cleared sooner by tags; 60 seconds for lists, filters, related products, reviews and search: see [Cache policy](#cache-policy)); carts, Throttle calls and any request with a customer token are `cache: 'no-store'`. Next.js itself is never imported.
 
 ```ts
 // lib/catalog.ts
@@ -349,6 +350,101 @@ export async function GET() {
 
 `staticProductParams(catalog)` feeds `generateStaticParams`, and `listAllProductHandles(catalog)` (an async iterable) feeds a sitemap. In the browser, use a browser key and the React provider.
 
+## Storefront settings
+
+The store's theme, navigation, home page, strings and route patterns are edited in the dashboard and read with `client.settings()`. It is `/config` cut to `{ settings, settingsVersion, generation }`.
+
+```ts
+import { t, resolveMenuTarget } from '@usethrottle/catalog';
+import { catalog } from '@/lib/catalog'; // createServerCatalogClient(...)
+
+const { settings } = await catalog.settings();
+t(settings, 'cart.checkout'); // "Checkout", in the locale of the read; falls back to English
+settings.navigation.header.map((item) => ({
+  label: item.label,
+  href: resolveMenuTarget(settings, item.target), // null when it points at nothing
+}));
+```
+
+In React, `useStorefrontSettings()` (from `/react`) returns the same answer, and `useGenerationWatch({ onChange })` polls the generation (every 60 seconds by default, only while the tab is visible) and refreshes the cached reads when it moves. Settings and pages calls take `minGeneration`, the generation a change notice named: a read above what the edge holds is answered fresh.
+
+## Pages
+
+Pages are the store's own content pages (shipping, about, ...). `catalog.pages.list()` returns `{ pages: [{ handle, title, position }] }` and `catalog.pages.get(handle)` returns `{ handle, title, bodyHtml, seo }`. In React, `usePages()` and `usePage(handle)` come from `/react/extras`.
+
+```ts
+const { bodyHtml, seo } = await catalog.pages.get('shipping');
+```
+
+`bodyHtml` is HTML: render it only where you trust the store's editors, or sanitize it first.
+
+## Cache policy
+
+`createServerCatalogClient({ cachePolicy })` sets how long each kind of read is cached. Kinds: `settings`, `navigation`, `pages`, `listings`, `facets`, `product`, `related`, `reviews` and `search`. A policy is `'until-changed'` (an hour's safety TTL, cleared sooner by cache tags), `'no-store'`, or a duration such as `'90s'` or `'5m'`. The defaults are `'until-changed'` for `settings`, `navigation`, `pages` and `product`, and `'60s'` for the rest. Customer-token, cart and preview requests are always `no-store`.
+
+```ts
+export const catalog = createServerCatalogClient({
+  publishableKey: process.env.CATALOG_SERVER_KEY ?? '',
+  cachePolicy: { product: '5m', search: 'no-store' },
+});
+```
+
+Every read carries its tags: `throttle-catalog`, a family tag (`throttle-catalog:config`, `:pages` or `:data`), the route's own and, for one handle, `throttle-catalog:<route>:<handle>`. `scopesToTags(scopes)` turns the scopes of a change notice into the tags to clear.
+
+## Revalidation webhook
+
+Instead of polling, point a catalog webhook at a route handler. The catalog sends `storefront.changed` with the changed scopes; the handler checks the `x-catalog-signature` header, clears the matching tags and makes the next `/config` read fresh. Several secrets can be passed while one is being rotated.
+
+```ts
+// app/api/throttle/revalidate/route.ts
+import { createRevalidateHandler } from '@usethrottle/catalog/next';
+
+export const POST = createRevalidateHandler({
+  secret: process.env.THROTTLE_WEBHOOK_SECRET,
+});
+```
+
+It answers `200 { revalidated: [...tags] }`, `401` for a missing, wrong or older-than-5-minutes signature, `400` for a body that is not a change notice, `413` for a body over 64 KB and `500` when no secret is set. The secret is read on each request, so an unset variable at build time does not fail `next build`. The route expires the tags immediately (`revalidateTag(tag, { expire: 0 })`), so the next request after a change is rendered fresh rather than stale. Each notice also raises a generation floor: the server client's next `/config` read (and so `settings()`) asks for at least that generation until an answer reaches it. The floor applies to every client of the process unless you name it. With one store that needs nothing. On a server with several stores, a handler without `floorKey` raises the floor for every store, so the other stores' reads skip the cache (`no-store`) until it clears: always pass each store's publishable key. With several stores in one app, give each handler the publishable key of its store's server client (or a `floorKey` set on both), so one store's notice never touches another's reads. If the variable is unset, `floorKey: process.env.X` is `undefined` and falls back to the shared floor.
+
+```ts
+export const POST = createRevalidateHandler({
+  secret: process.env.STORE_A_WEBHOOK_SECRET,
+  floorKey: process.env.STORE_A_KEY, // the publishableKey of store A's createServerCatalogClient
+});
+```
+
+Pass `revalidateTag` to use your own function instead of the one from `next/cache`.
+
+## Preview mode
+
+The dashboard's preview opens your storefront with `?throttle_preview=<token>`. The middleware moves the token into an HTTP-only cookie (`SameSite=None; Secure`, one hour, so it works inside the preview iframe) and redirects to the same URL without it. Pass the token to the server client and settings and pages answer the draft, uncached.
+
+```ts
+// middleware.ts
+import { previewMiddleware } from '@usethrottle/catalog/next';
+
+export function middleware(req: Request) {
+  return previewMiddleware(req) ?? undefined;
+}
+```
+
+```ts
+// lib/catalog.ts
+import { createServerCatalogClient } from '@usethrottle/catalog/server';
+import { getPreviewToken } from '@usethrottle/catalog/next';
+
+export async function getCatalog() {
+  return createServerCatalogClient({
+    publishableKey: process.env.CATALOG_SERVER_KEY ?? '',
+    previewToken: await getPreviewToken(),
+  });
+}
+```
+
+Safari may drop `Secure` cookies on `http://localhost`: develop the preview over https, or use Chrome. With `exactOptionalPropertyTypes` on, pass `previewToken` only when there is one (`...(token ? { previewToken: token } : {})`), since `getPreviewToken()` can return `undefined`.
+
+`x-storefront-preview` is a reserved header: the SDK sets it from `previewToken`, and a `headers` option may not.
+
 ## URL helpers
 
 `@usethrottle/catalog/url` keeps a shop page's selection in its URL, with one canonical string per selection and every parameter it does not know kept in order:

package/dist/admin.cjs

@@ -10,7 +10,7 @@
 
 
 
-var _chunk2YQNMBDIcjs = require('./chunk-2YQNMBDI.cjs');
+var _chunk2ODFFMZ4cjs = require('./chunk-2ODFFMZ4.cjs');
 require('./chunk-ETV4XYOV.cjs');
 
 // src/generated/push-types.ts
@@ -45,7 +45,7 @@ var MAX_IDEMPOTENCY_KEY = 200;
 var HEADER_SAFE = /^[\x21-\x7e]+$/u;
 var MAX_RETRY_AFTER_S = 86400;
 function invalidRequest(message) {
-  return new (0, _chunk2YQNMBDIcjs.CatalogError)({
+  return new (0, _chunk2ODFFMZ4cjs.CatalogError)({
     code: "INVALID_REQUEST",
     message,
     statusCode: 0,
@@ -54,7 +54,7 @@ function invalidRequest(message) {
   });
 }
 function clientError(code, message) {
-  return new (0, _chunk2YQNMBDIcjs.CatalogError)({
+  return new (0, _chunk2ODFFMZ4cjs.CatalogError)({
     code,
     message,
     statusCode: 0,
@@ -126,13 +126,13 @@ function toError(status, headers, text) {
     requestId
   };
   if (status === 429) {
-    return new (0, _chunk2YQNMBDIcjs.RateLimitedError)({
+    return new (0, _chunk2ODFFMZ4cjs.RateLimitedError)({
       ...init,
       retryable: true,
-      retryAfterSeconds: retryAfter !== null && retryAfter >= 1 ? retryAfter : _chunk2YQNMBDIcjs.RATE_LIMIT_DEFAULT_RETRY_S
+      retryAfterSeconds: retryAfter !== null && retryAfter >= 1 ? retryAfter : _chunk2ODFFMZ4cjs.RATE_LIMIT_DEFAULT_RETRY_S
     });
   }
-  return new (0, _chunk2YQNMBDIcjs.CatalogError)(init);
+  return new (0, _chunk2ODFFMZ4cjs.CatalogError)(init);
 }
 function guarded(work, callerSignal, timeoutMs) {
   if (_optionalChain([callerSignal, 'optionalAccess', _8 => _8.aborted])) return Promise.reject(callerSignal.reason);
@@ -151,7 +151,7 @@ function guarded(work, callerSignal, timeoutMs) {
     const timer = setTimeout(() => {
       finish();
       controller.abort();
-      reject(new (0, _chunk2YQNMBDIcjs.TimeoutError)({ timeoutMs }));
+      reject(new (0, _chunk2ODFFMZ4cjs.TimeoutError)({ timeoutMs }));
     }, timeoutMs);
     _optionalChain([callerSignal, 'optionalAccess', _12 => _12.addEventListener, 'call', _13 => _13("abort", onAbort, { once: true })]);
     work(controller.signal).then(
@@ -194,7 +194,7 @@ function createHttp(key, baseUrl, fetchFn, timeoutMs) {
                 signal
               });
             } catch (cause) {
-              throw new (0, _chunk2YQNMBDIcjs.NetworkError)({ cause });
+              throw new (0, _chunk2ODFFMZ4cjs.NetworkError)({ cause });
             }
             try {
               return {
@@ -203,14 +203,14 @@ function createHttp(key, baseUrl, fetchFn, timeoutMs) {
                 text: await response.text()
               };
             } catch (cause) {
-              throw new (0, _chunk2YQNMBDIcjs.NetworkError)({ cause });
+              throw new (0, _chunk2ODFFMZ4cjs.NetworkError)({ cause });
             }
           },
           spec.signal,
           timeoutMs
         );
       } catch (error) {
-        if (error instanceof _chunk2YQNMBDIcjs.NetworkError && attempt < attempts) continue;
+        if (error instanceof _chunk2ODFFMZ4cjs.NetworkError && attempt < attempts) continue;
         throw error;
       }
     }
@@ -223,7 +223,7 @@ function createHttp(key, baseUrl, fetchFn, timeoutMs) {
         throw toError(answer.status, answer.headers, answer.text);
       const parsed = parseJson(answer.text);
       if (parsed === void 0)
-        throw new (0, _chunk2YQNMBDIcjs.CatalogError)({
+        throw new (0, _chunk2ODFFMZ4cjs.CatalogError)({
           code: "INVALID_RESPONSE",
           message: "The server answered with a body that is not JSON.",
           statusCode: answer.status,
@@ -278,7 +278,7 @@ function refQuery(ref) {
   return [[field, value]];
 }
 function unreadable() {
-  return new (0, _chunk2YQNMBDIcjs.CatalogError)({
+  return new (0, _chunk2ODFFMZ4cjs.CatalogError)({
     code: "INVALID_RESPONSE",
     message: "The server answered with an unexpected shape.",
     statusCode: 200,
@@ -367,7 +367,7 @@ async function pollUntil(read, done, options = {}) {
     const value = await read(options.signal);
     if (done(value)) return value;
     const remaining = deadline - Date.now();
-    if (remaining <= 0) throw new (0, _chunk2YQNMBDIcjs.TimeoutError)({ timeoutMs });
+    if (remaining <= 0) throw new (0, _chunk2ODFFMZ4cjs.TimeoutError)({ timeoutMs });
     await sleep(Math.min(intervalMs, remaining), options.signal);
   }
 }
@@ -452,7 +452,7 @@ function createJobs(http) {
         await handle.send(rows, { idempotencyKey });
         return;
       } catch (error) {
-        if (!(error instanceof _chunk2YQNMBDIcjs.RateLimitedError) || retry >= QUEUE_RETRIES)
+        if (!(error instanceof _chunk2ODFFMZ4cjs.RateLimitedError) || retry >= QUEUE_RETRIES)
           throw error;
         await sleep(error.retryAfterSeconds * 1e3, signal);
       }
@@ -589,7 +589,7 @@ function assertServer() {
 function createCatalogAdmin(options) {
   assertServer();
   const key = checkKey(options.key);
-  const baseUrl = (_nullishCoalesce(options.baseUrl, () => ( _chunk2YQNMBDIcjs.DEFAULT_BASE_URL))).replace(/\/+$/u, "");
+  const baseUrl = (_nullishCoalesce(options.baseUrl, () => ( _chunk2ODFFMZ4cjs.DEFAULT_BASE_URL))).replace(/\/+$/u, "");
   if (!/^https?:\/\/[^\s/]+/iu.test(baseUrl))
     throw invalidRequest("baseUrl must be an absolute http or https URL.");
   const http = createHttp(
@@ -678,4 +678,4 @@ async function verifyCatalogWebhook(input) {
 
 
 
-exports.CartLineError = _chunk2YQNMBDIcjs.CartLineError; exports.CatalogError = _chunk2YQNMBDIcjs.CatalogError; exports.CustomerTokenInvalidError = _chunk2YQNMBDIcjs.CustomerTokenInvalidError; exports.FeatureUnavailableError = _chunk2YQNMBDIcjs.FeatureUnavailableError; exports.NetworkError = _chunk2YQNMBDIcjs.NetworkError; exports.OriginNotAllowedError = _chunk2YQNMBDIcjs.OriginNotAllowedError; exports.RateLimitedError = _chunk2YQNMBDIcjs.RateLimitedError; exports.TimeoutError = _chunk2YQNMBDIcjs.TimeoutError; exports.createCatalogAdmin = createCatalogAdmin; exports.isCatalogError = _chunk2YQNMBDIcjs.isCatalogError; exports.verifyCatalogWebhook = verifyCatalogWebhook;
+exports.CartLineError = _chunk2ODFFMZ4cjs.CartLineError; exports.CatalogError = _chunk2ODFFMZ4cjs.CatalogError; exports.CustomerTokenInvalidError = _chunk2ODFFMZ4cjs.CustomerTokenInvalidError; exports.FeatureUnavailableError = _chunk2ODFFMZ4cjs.FeatureUnavailableError; exports.NetworkError = _chunk2ODFFMZ4cjs.NetworkError; exports.OriginNotAllowedError = _chunk2ODFFMZ4cjs.OriginNotAllowedError; exports.RateLimitedError = _chunk2ODFFMZ4cjs.RateLimitedError; exports.TimeoutError = _chunk2ODFFMZ4cjs.TimeoutError; exports.createCatalogAdmin = createCatalogAdmin; exports.isCatalogError = _chunk2ODFFMZ4cjs.isCatalogError; exports.verifyCatalogWebhook = verifyCatalogWebhook;

package/dist/admin.d.cts

@@ -1,5 +1,5 @@
-export { C as CartLineError, a as CartLineProblem, b as CatalogError, c as CatalogErrorCode, d as CatalogErrorInit, e as CatalogErrorIssue, f as CatalogErrorSource, g as ClientErrorCode, h as CustomerTokenInvalidError, F as FeatureUnavailableError, N as NetworkError, O as OriginNotAllowedError, R as RateLimitedError, T as TimeoutError, i as isCatalogError } from './catalog-error-BOaSKgY3.cjs';
-import './contract-types-BRyonOYH.cjs';
+export { C as CartLineError, a as CartLineProblem, b as CatalogError, c as CatalogErrorCode, d as CatalogErrorInit, e as CatalogErrorIssue, f as CatalogErrorSource, g as ClientErrorCode, h as CustomerTokenInvalidError, F as FeatureUnavailableError, N as NetworkError, O as OriginNotAllowedError, R as RateLimitedError, T as TimeoutError, i as isCatalogError } from './catalog-error-bG1XHquN.cjs';
+import './contract-types-BJMeJSTz.cjs';
 import '@usethrottle/money';
 
 type JobBatchAnswer = {
@@ -85,6 +85,16 @@ type PushJob = {
     updated?: number | undefined;
     unchanged?: number | undefined;
     reportExpiresAt?: string | null | undefined;
+    failureMessage?: string | null | undefined;
+    progressUpdatedAt?: string | undefined;
+    attempts?: number | undefined;
+    lastAttempt?: {
+        attempt: number;
+        at: string;
+        result: 'success' | 'retryable_failure' | 'terminal_failure';
+        code: string;
+    } | null | undefined;
+    nextAttemptAt?: string | null | undefined;
     batches?: {
         batchId: string;
         sequence: number;
@@ -139,6 +149,8 @@ type PushProduct = {
     held: boolean;
     apiArchived: boolean;
     purgeAfter: string | null;
+    createdAt: string;
+    updatedAt: string;
     vendorId: string | null;
     attributes: {
         [key: string]: JsonValue;

package/dist/admin.d.ts

@@ -1,5 +1,5 @@
-export { C as CartLineError, a as CartLineProblem, b as CatalogError, c as CatalogErrorCode, d as CatalogErrorInit, e as CatalogErrorIssue, f as CatalogErrorSource, g as ClientErrorCode, h as CustomerTokenInvalidError, F as FeatureUnavailableError, N as NetworkError, O as OriginNotAllowedError, R as RateLimitedError, T as TimeoutError, i as isCatalogError } from './catalog-error-CSoPS0-d.js';
-import './contract-types-BRyonOYH.js';
+export { C as CartLineError, a as CartLineProblem, b as CatalogError, c as CatalogErrorCode, d as CatalogErrorInit, e as CatalogErrorIssue, f as CatalogErrorSource, g as ClientErrorCode, h as CustomerTokenInvalidError, F as FeatureUnavailableError, N as NetworkError, O as OriginNotAllowedError, R as RateLimitedError, T as TimeoutError, i as isCatalogError } from './catalog-error-c3BVgU6k.js';
+import './contract-types-BJMeJSTz.js';
 import '@usethrottle/money';
 
 type JobBatchAnswer = {
@@ -85,6 +85,16 @@ type PushJob = {
     updated?: number | undefined;
     unchanged?: number | undefined;
     reportExpiresAt?: string | null | undefined;
+    failureMessage?: string | null | undefined;
+    progressUpdatedAt?: string | undefined;
+    attempts?: number | undefined;
+    lastAttempt?: {
+        attempt: number;
+        at: string;
+        result: 'success' | 'retryable_failure' | 'terminal_failure';
+        code: string;
+    } | null | undefined;
+    nextAttemptAt?: string | null | undefined;
     batches?: {
         batchId: string;
         sequence: number;
@@ -139,6 +149,8 @@ type PushProduct = {
     held: boolean;
     apiArchived: boolean;
     purgeAfter: string | null;
+    createdAt: string;
+    updatedAt: string;
     vendorId: string | null;
     attributes: {
         [key: string]: JsonValue;

package/dist/admin.js

@@ -10,7 +10,7 @@ import {
   RateLimitedError,
   TimeoutError,
   isCatalogError
-} from "./chunk-3DLH56OX.js";
+} from "./chunk-STNQNHNZ.js";
 import "./chunk-PKBMQBKP.js";
 
 // src/generated/push-types.ts

package/dist/{catalog-error-BOaSKgY3.d.cts → catalog-error-bG1XHquN.d.cts}

@@ -1,4 +1,4 @@
-import { i as CatalogContractErrorCode } from './contract-types-BRyonOYH.cjs';
+import { k as CatalogContractErrorCode } from './contract-types-BJMeJSTz.cjs';
 
 /**
  * Shared error type for every Throttle SDK.

package/dist/{catalog-error-CSoPS0-d.d.ts → catalog-error-c3BVgU6k.d.ts}

@@ -1,4 +1,4 @@
-import { i as CatalogContractErrorCode } from './contract-types-BRyonOYH.js';
+import { k as CatalogContractErrorCode } from './contract-types-BJMeJSTz.js';
 
 /**
  * Shared error type for every Throttle SDK.