@develemit/commerce-admin 0.4.0 → 0.7.0

package/CHANGELOG.md

@@ -0,0 +1,87 @@
+## 0.7.0 (2026-11-04)
+
+### Features
+
+- Stocking a shop: new `AdminAddSeveral({ onDone })` (pick many photos, one draft per photo, progress, retry for just the failed ones) and `AdminFinishDrafts({ productIds?, categories?, onDone })` (a one-piece-at-a-time queue ending in a summary with "Put N in the shop" or "Keep as drafts"). Without `productIds` it finds drafts through `listProducts({ incomplete: 'true' })`, which `AdminProductQuery` now accepts. Copy lives in `labels.products.stock.*`; new exports `StockLabels` and `PublishOutcome`.
+- New `EmptyState` component. Orders, Discounts and Shipping rates show an icon, a title and a sentence on what happens there. `AdminShippingRates` gains `suggestedRates?` (chips in its empty state) and an "Add an option" button. New labels `orders.emptyHint`, `discounts.emptyHint`, `shipping.emptyTitle`, `shipping.addOption`. **Changed:** `shipping.empty` is now the sentence under the title ("Add one so customers can check out.").
+- Photo-first add and edit: new `AdminProductFlow({ productId?, initialStep?, onDone?, onClose?, categories?, materialSuggestions?, isFirstProduct?, imagesSlot? })`. Phones get four steps (Photos, Basics, Story, Preview) with a step bar and sticky footer; desktops get one two-column page with a sticky live preview. The first photo or name creates a draft and edits autosave (about 600ms) with an inline retry. Publishing a draft ends on a success screen. Copy lives in `labels.products.flow.*` (`photoTip`, `descriptionPrompts`, …). New exports `ProductFlowStep`, `ProductFlowLabels`, `EditProduct` and `Switch` (`.sfa-switch`).
+- **Changed:** the products list shows newest first, and its "All" filter sends `excludeArchived` so the list matches the All count. `AdminProductQuery` gains `excludeArchived`.
+- **Changed:** `AdminProductEditor` keeps its props but now renders `AdminProductFlow`, so its look and flow are new: there is no Status select or Save button (edits autosave, and "Put it in the shop" publishes), `onSaved` runs when the user finishes (Save as draft, Done, Back to products) instead of after every save, and `imagesSlot` replaces the built-in Photos section. It reads `?step=` from the URL when `initialStep` isn't passed.
+- The sheet's Edit details, Photos and "Add the missing details" links now point at `hrefs.product(id)` plus `?step=basics` or `?step=photos`, and `onEdit`/`onEditProduct` receive that step as a second argument.
+
+- Responsive shell: `AdminLayout` is a bottom tab bar with a "More" sheet below 900px and a left sidebar from 900px. New props `navBadges`; `extraNav` items accept `icon` and `badge`. New export `adminNavIcons`, labels `nav.more` and `nav.closeMore`.
+- `AdminPageHeader` puts the page title and actions on one row; every kit screen uses it (the shipping page title is now an `h1`).
+- Unified controls: pill `sfa-btn` (48px, plus `--ghost`), `sfa-chip` filters (44px) and `sfa-input` (52px). Filters changed from `sfa-btn sfa-filter` to `sfa-chip`.
+- Optional tokens `--sf-color-accent-soft`, `--sf-color-success(-soft)`, `--sf-color-warning(-soft)` and `--sf-shadow-raised`, all with fallbacks.
+- Product quick actions: tapping a card in `AdminProductList` opens `AdminProductSheet({ productId, onClose, onEdit?, onChanged? })` — a bottom sheet below 900px and a 420px side panel from 900px, focus-trapped, closing on Escape. It shows a photo carousel, price, status and category, one primary action by state (finish / put in the shop / mark sold / back in stock / restore), and Edit, Photos, Feature on home, Hide from shop, Copy shop link and Archive. Reversible changes offer Undo. Copy lives in `labels.products.sheet.*`.
+- `AdminProductList` props `onOpenProduct` (replaces the sheet) and `onEditProduct` (the sheet's Edit button). **Changed:** the per-card Mark sold / Archive / View in shop buttons and their confirm dialog are gone (the sheet replaces them), and the card's name is now a `button`, not a link.
+- `Notice` accepts an optional `action: { label, onAction }`.
+- `AdminClient.getProductCounts()` and `ProductIncompleteError` (422, `missing`).
+- Admin product responses can have `priceCents` and `category` of `null` (drafts); the list shows an em dash for a missing price. The product form still requires a name and category until the editor is redesigned.
+
+- `AdminProductList` is now a photo grid with status pills, filter chips with counts, a drafts banner, a welcome state for an empty shop and a floating add button on phones. New optional props `welcome`, `setup`, `onAddMany`, `onFinishDrafts`. The product name link no longer sits in a table row; the whole card is clickable.
+- New export `AdminSetupChecklist` and `SetupStep`. New labels `products.welcome`, `products.card`, `products.draftsBanner`, `products.setup`, `products.openSearch` and `products.closeSearch`.
+- The list now calls `getProductCounts()`, so a custom client must implement it.
+
+### Docs
+
+- The package now ships `CHANGELOG.md` and declares `description`, `repository` and `homepage`. The README documents the client error classes, `errorKey`, `useAdminClient` and `OrderActions`.
+
+## 0.6.0 (2026-11-03)
+
+### Features
+
+- `createAdminClient` accepts `onUnauthorized(error)`, called whenever a request answers 401, before the request rejects with the usual `AdminUnauthorizedError`. Errors thrown by the callback are ignored. Additive.
+
+## 0.5.0 (2026-11-02)
+
+### Features
+
+- `MaxRedemptionsBelowUsageError` (400 `MAX_REDEMPTIONS_BELOW_USAGE`) is mapped by the admin client, and `AdminDiscountEditor` shows it on the usage-limit field instead of as a generic error (e.g. when a redemption lands between page load and save).
+
+## 0.4.0 (2026-10-30)
+
+### Features
+
+- `.sfa-badge--refund-pending` and `.sfa-badge--refund-succeeded` have their own colors, from `--sf-*` tokens with neutral fallbacks.
+- Each image tile has an inline "Edit description" control (save, cancel, error shown). `AdminClient` gains `updateProductImage(productId, imageId, { alt })`; `labels.products.images` gains `editAlt`, `saveAlt` and `cancelAlt`. Needs a server with the image alt API (`@develemit/commerce-server`).
+- `AdminDiscountList` (Active, Scheduled, Expired and Inactive tabs, debounced code search, Load more, "12 / 50 used") and `AdminDiscountEditor` (create or edit, percent or fixed, optional minimum subtotal, dates and usage limit, deactivate with confirmation). The code and value are locked once a discount has been used.
+- `AdminClient` gains `listDiscounts`, `getDiscount`, `createDiscount` and `updateDiscount`, plus `DiscountCodeTakenError` and `DiscountInUseError`. `AdminErrorKey` gains `discountCodeTaken` and `discountInUse`; `labels.statuses` gains `scheduled` and `inactive`.
+- `hrefs` gains `discounts`, `discount(id)` and `newDiscount`; `labels` gains `discounts`.
+- `AdminOrderDetail` totals show a "Discount (CODE) −$X" row when the order has a discount. Needs a server with discounts (`@develemit/commerce-server` admin discounts API).
+- `AdminLayout` does not add a Discounts link; pass it through `extraNav`.
+
+## 0.3.0 (2026-10-30)
+
+First published release of `@develemit/commerce-admin`: the React admin UI (products, images, orders with ship/refund/resolve, shipping rates) for `@develemit/commerce-server`'s admin API. Peers: `react`, `react-dom` `^19`.
+
+### Changes for setups linked to pre-release builds
+
+- `AdminClient.listProducts(query?)` returns a page, `{ items, nextCursor }`, instead of an array, and accepts `status`, `q`, `cursor` and `limit`. `AdminProductList` filters and searches on the server (debounced 300ms) and has a "Load more" button; `labels.products` gains `loadMore`.
+
+### Fixes
+
+- Published tarballs no longer include declaration maps (`*.d.ts.map`), which pointed at `src/` files that were not shipped. JS sourcemaps now embed `sourcesContent`.
+- Admin row links now meet the 44px tap target (fix): the order-id and product-name links, the back link, the tracking link and the restock links use the new `sfa-link--tap` class.
+- The status filters in `AdminProductList` and `AdminOrderList` stay on one row that scrolls sideways on narrow screens instead of wrapping (fix). Both groups use the new `sfa-filter-group` class.
+- Built `dist` type resolution: the `client` (and storefront `format`) entries now emit to `dist/<name>/index.js` beside their declarations, so `allowJs` consumers (Next) get real types for `useAdminClient()` instead of `any`. No API change; the `exports` subpaths are unchanged.
+
+### Features
+
+- `AdminClient.listProducts` accepts `stock`. The Live tab sends `status=active&stock=in` and the Sold tab `status=active&stock=sold`, so pages are exact; the client-side stock split is gone.
+- `AdminProductEditor` accepts an optional `categories` prop; the Category input offers them as `<datalist>` suggestions and still takes free text.
+- The default `renderImage` now renders `<img loading="lazy" decoding="async">`, or `loading="eager"` with `fetchpriority="high"` when `priority` is set (non-breaking behavior change). `AdminImageProps` gains an optional `priority`.
+
+- New package `@develemit/commerce-admin` with `AdminProvider` (link adapter, route hrefs, locale, API client slot, labels) and `useAdmin()`.
+
+- Shared admin primitives (`AdminLayout`, `AdminTable`, `StatusBadge`, `Money`, `ConfirmDialog`, `Notice`, `ErrorMessage`) and the `useAdminQuery`/`useAdminMutation` hooks; `labels` gains `nav`, `statuses`, `errors`, `confirm`, `dismiss`, `navLabel`.
+
+- `AdminProductList` and `AdminProductEditor` product screens, `parseMoneyInput`/`formatMoneyInput`, `labels.products`, `hrefs.storefrontProduct`, and a `sold` status label.
+
+- `AdminOrderList` and `AdminOrderDetail` order screens (with an `actions` slot) and `labels.orders`.
+
+- `OrderActions` (ship / re-ship, refund dialog with idempotent retry, resolve) is now the default `AdminOrderDetail` actions; `labels.orders.actions`.
+
+- `AdminShippingRates` shipping-rate editor (add, edit, reorder, deactivate, remove; one `PUT` on save), `onDirtyChange`, and `labels.shipping`.
+
+- `createAdminClient` from `@develemit/commerce-admin/client`, plus a README covering install, the provider, the server-side proxy auth pattern, each view and theming.

package/README.md

@@ -1,6 +1,8 @@
 # @develemit/commerce-admin
 
-Admin UI for the develemit commerce kit: product, order and shipping-rate screens for the `@develemit/commerce-server` admin API.
+Admin UI for the develemit commerce kit: product, order, discount and shipping-rate screens for the `@develemit/commerce-server` admin API.
+
+New here? The [admin guide](https://github.com/develemit/develemit-commerce/blob/main/docs/getting-started/admin.md) wires it into a Next app step by step. What changed in each version is in [CHANGELOG.md](CHANGELOG.md).
 
 Depends on `@develemit/commerce-contracts` only. Themed through the same `--sf-*` CSS variables as `@develemit/storefront`; import `@develemit/commerce-admin/styles.css` for the admin-only `sfa-` classes.
 
@@ -62,11 +64,36 @@ The client calls `${baseUrl}/admin/...`, matching the server's admin routes. `hr
 The server's `admin.authorize(req)` decides who may call the admin API. Never put an admin token in browser code. Two patterns:
 
 1. **Server-side proxy (recommended).** A route handler in your web app checks your own session (for example your login cookie), then forwards the request to the commerce API with the admin token from a server-only env var. The browser client points at the proxy (`baseUrl: '/api'`). See `apps/playground-web/src/app/api/admin/[...path]/route.ts`; it forwards method, query, body (including multipart image uploads) and `idempotency-key`.
-2. **Cookie session.** Serve the commerce API on the same site and have `authorize` read your session cookie. The client then needs no token; use `headers` or a custom `fetch` with `credentials: 'include'` if the API is on another origin.
+2. **Cookie session.** Serve the commerce API on the same site and have `authorize` read your session cookie. The client then needs no token; use `headers` or a custom `fetch` with `credentials: 'include'` if the API is on another origin. Pass `onUnauthorized(error)` to `createAdminClient` to react when any request answers 401 (for example redirect to your login page when the session expires); the request still rejects with `AdminUnauthorizedError`, and errors thrown by the callback are ignored.
+
+## Client errors
+
+Every client method rejects with an `AdminApiError` (`status`, `url`, `code`) or one of its subclasses, so you can branch with `instanceof`:
+
+| Error                           | When                                                                            |
+| ------------------------------- | ------------------------------------------------------------------------------- |
+| `AdminUnauthorizedError`        | 401: `authorize` refused (see `onUnauthorized` above)                           |
+| `AdminNotFoundError`            | 404: product, order, image or discount not found                                |
+| `AdminInvalidInputError`        | 400 `INVALID_INPUT`, with Zod `issues`                                          |
+| `InvalidOrderStateError`        | the order's `status` doesn't allow the action (ship, refund, resolve)           |
+| `InsufficientStockError`        | resolving a `needs_attention` order without stock (`productIds`)                |
+| `RefundExceedsBalanceError`     | refund larger than what's left (`balanceCents`)                                 |
+| `RefundGatewayError`            | the payment gateway rejected the refund                                         |
+| `RefundOutcomeUnknownError`     | the gateway timed out; retry with the same `idempotencyKey`                     |
+| `ProductIncompleteError`        | 422: publishing a draft that lacks a name, price, category or photo (`missing`) |
+| `InvalidImageError`             | upload isn't a supported image                                                  |
+| `ImageTooLargeError`            | 413: upload over the server's limit                                             |
+| `DiscountCodeTakenError`        | 409: the code already exists                                                    |
+| `DiscountInUseError`            | 409: a redeemed discount's code or value can't change                           |
+| `MaxRedemptionsBelowUsageError` | 400: `maxRedemptions` lower than redemptions so far                             |
+
+`client.getProductCounts()` returns `{ all, live, draft, sold, archived, incompleteDrafts }` for list filter chips.
+
+`ErrorMessage` and `errorKey(error)` turn any of these into a `labels.errors` key, so screens show consistent copy.
 
 ## Primitives
 
-This version ships `AdminProvider`, `useAdmin()` and the shared primitives:
+`AdminProvider` supplies the client, adapters and labels. `useAdmin()` reads all of it, and `useAdminClient()` just the client, for host screens that call the admin API. The shared primitives:
 
 - `AdminLayout` — nav from `hrefs`, plus `extraNav` (`{ href, label, position? }`) and `header`/`footer` slots for host content.
 - `AdminTable` — stacks into labeled cards below 640px.
@@ -89,19 +116,41 @@ Override any copy through `AdminProvider`'s `labels` (`nav`, `statuses` and `err
   <AdminProductList />
 </AdminProvider>
 
-<AdminProductEditor
+<AdminProductFlow
   productId={id} // omit to create
-  onSaved={(product) => router.push(hrefs.product(product.id))}
-  imagesSlot={null}
-  categories={['Necklaces', 'Rings']} // optional suggestions
+  initialStep="basics" // optional: photos | basics | story | preview
+  categories={['Necklaces', 'Rings']} // category chips; "Other…" allows any
+  materialSuggestions={['Silver', 'Gold']} // optional chips
+  onDone={() => router.push('/admin/products')}
+  onClose={() => router.push('/admin/products')}
 />
 ```
 
-- `AdminProductList` — status filters (All, Live, Sold, Drafts, Archived; "Sold" is active with zero stock), name search over the loaded list, a single row of filter buttons that scrolls sideways on narrow screens, thumbnails, "View in shop" when `hrefs.storefrontProduct` is set, and confirmed Mark sold / Archive actions.
-- `AdminProductEditor` — create or edit every product field. Validates with the contract schema, shows inline errors with `aria-invalid`/`aria-describedby`, focuses the first invalid field, maps a server `INVALID_INPUT` onto fields, and PATCHes only changed fields. `imagesSlot` renders in edit mode only. Pass `categories` (the categories already in use) to offer them as `<datalist>` suggestions on the Category input; free text is still allowed, and without it the input is a plain text field.
+- `AdminProductList` — a photo grid of product cards (status pill, featured star, price or what a draft still needs), filter chips with counts from `getProductCounts` (All excludes archived; "Sold" is active with zero stock), name search (behind a header button on phones, inline from 900px), a "N drafts need a few details" banner, paging and a quick-action sheet when a card is tapped. An empty shop shows a welcome state with no filters. Props, all optional: `welcome` (brand art for the welcome state; a neutral illustration by default), `setup` (`SetupStep[]` for the checklist), `onAddMany` (shows the "Add several at once" button) and `onFinishDrafts` (shows the banner's Finish button), `onOpenProduct(product)` (replaces the sheet) and `onEditProduct(product)` (the sheet's Edit button; defaults to a link to `hrefs.product`).
+- `AdminProductSheet({ productId, onClose, onEdit?, onChanged? })` — quick actions for one product: a bottom sheet below 900px, a 420px side panel from 900px, focus-trapped. One primary action by state (finish, put in the shop, mark sold, back in stock, restore), plus Edit, Photos, Feature on home, Hide from shop, Copy shop link (needs `hrefs.storefrontProduct`) and Archive. Changes show a toast with Undo. Publishing an incomplete draft lists what is missing. Copy: `labels.products.sheet.*`.
+- `AdminSetupChecklist({ steps })` — a generic setup card with a progress bar. Each `SetupStep` is `{ id, title, detail?, done, href?, onSelect?, locked?, lockedDetail? }`; the host decides the steps. `AdminProductList` shows it in full while the shop is empty and as a compact pill once it has products; it renders nothing when every step is done. Pass `compact` to force the pill.
+- `AdminProductFlow({ productId?, initialStep?, onDone?, onClose?, categories?, materialSuggestions?, isFirstProduct?, imagesSlot? })` — photo-first add and edit. Below 900px it is a full-screen flow of four steps (Photos, Basics, Story, Preview) with a step bar (`aria-current="step"`) and a sticky footer action; from 900px it is one page with a sticky "In the shop" preview and the publish buttons on the right, and `initialStep` scrolls to that section. The first photo or name creates a draft (`createProduct`), later photos upload to it, and edits autosave by PATCH about 600ms after typing stops, with a "Saving…/Saved" note and an inline retry on failure. Tapping a thumbnail makes it the cover (`reorderProductImages`); ✕ removes it. Blank photo descriptions become "name, photo N" when the product is saved. "Put it in the shop" PATCHes `status: 'active'`; a 422 lists what is missing. Publishing a draft shows a success screen ("Add another", "Back to products"); it says "first product" when `isFirstProduct` is true, or, when that prop is omitted, when `getProductCounts().live` is 1. `onDone(product)` runs on Save as draft, Done and Back to products; `onClose(product | null)` runs from ✕, after a "Saved as a draft" toast when a new draft was kept. Without `onClose`, ✕ is a link to `hrefs.products`. Copy: `labels.products.flow.*`, including `photoTip` and `descriptionPrompts` (chips that append text to the description; none by default).
+- `AdminProductEditor({ productId?, onSaved?, imagesSlot?, categories?, initialStep? })` — the previous editor's props, now a thin wrapper around `AdminProductFlow` (`onSaved` is `onDone`). `imagesSlot` replaces the built-in Photos section. Without `initialStep` it reads `?step=` from the URL, which is how the sheet's Edit, Photos and "Add the missing details" links open the right step. `onEditProduct`/`onEdit` receive the step as a second argument.
+- `Switch({ id, label, checked, onChange })` — a native checkbox with `role="switch"`, styled by `.sfa-switch`.
 - Prices are typed in dollars and parsed to integer cents from the string (`parseMoneyInput`, `formatMoneyInput`).
 - Copy lives under `labels.products` and merges key by key.
 
+### Stocking a shop
+
+```tsx
+<AdminAddSeveral onDone={(products) => setIds(products.map((p) => p.id))} />
+<AdminFinishDrafts
+  productIds={ids} // omit to finish every incomplete draft
+  categories={['Mugs', 'Bowls']}
+  onDone={({ published, drafts }) => router.push('/admin/products')}
+/>
+```
+
+- `AdminAddSeveral({ onDone })` — an intro ("One photo, one piece") and a multi-photo picker. Each photo creates an image-only draft and uploads to it, one at a time, with a progress bar. If some fail, it lists those photos and offers **Try again** for just them (a draft that was already created is reused, never duplicated); unsupported or oversized files are listed without a retry. `onDone(products)` receives the drafts that got a photo.
+- `AdminFinishDrafts({ productIds?, categories?, onDone })` — a queue that shows one piece at a time ("Piece N of M"): its cover photo (or an "Add a photo" picker), name, price and category chips, autosaved. **Next piece** is enabled once name, price and category are set; **Skip for now** moves on. The last step is a summary with each piece's price or "Needs details", and **Put N in the shop** (publishes only the complete ones; a 422 leaves that piece a draft) or **Keep as drafts**. Without `productIds` it loads `listProducts({ incomplete: 'true' })`, so `AdminProductList`'s `onFinishDrafts` can just navigate to a page that renders it. `onDone({ published, drafts })` runs when the user leaves.
+- Both render a centered card of at most 640px; the queue puts the photo and the fields side by side from 900px. Copy: `labels.products.stock.{addSeveral,queue,summary}.*`. `AdminClient.listProducts` accepts `incomplete: 'true'`.
+- Orders, Discounts and Shipping rates use `AdminPageHeader` and a shared `EmptyState({ icon, title, body?, action?, children? })` (icons `orders`, `discounts`, `shipping`, `search`). `AdminShippingRates` takes `suggestedRates?: { label, amountCents }[]`, shown as chips in its empty state (none by default); new labels `orders.emptyHint`, `discounts.emptyHint`, `shipping.emptyTitle` and `shipping.addOption`.
+
 ## Order screens
 
 ```tsx
@@ -115,6 +164,7 @@ Override any copy through `AdminProvider`'s `labels` (`nav`, `statuses` and `err
 
 - `AdminOrderList` — tabs To ship (default), Shipped, Needs attention, Pending refund and All; debounced (300ms) search by email or order id; "Load more" cursor paging. Changing a tab or search restarts from the first page.
 - `AdminOrderDetail` — items and totals, buyer, shipping address, fulfillment (carrier and tracking link, or "Not shipped"), refund history with pending refunds marked distinctly, and the remaining balance. Dates use the provider `locale`.
+- `OrderActions({ order, reload })` — the ship form, refund dialog and resolve button that `AdminOrderDetail` shows, exported for hosts that build their own order page.
 - Rows link through `hrefs.order(id)` and `renderLink`. Copy lives under `labels.orders`.
 
 ## Discount screens
@@ -146,3 +196,29 @@ The default `renderImage` is a lazy, async `<img>` (`priority` makes it eager).
 ## Theming
 
 The admin reads the same `--sf-*` variables as the storefront (`--sf-color-accent`, spacing, radius, typography), so a host that already themes its shop gets a matching admin. Admin-only classes carry the `sfa-` prefix.
+
+### Theme tokens
+
+Optional tokens, each with a fallback derived from the tokens above, so existing hosts need nothing:
+
+| Token                     | Fallback                                   | Used for                     |
+| ------------------------- | ------------------------------------------ | ---------------------------- |
+| `--sf-color-accent-soft`  | 12% `--sf-color-accent` on `--sf-color-bg` | Focus halo, hovered nav item |
+| `--sf-color-success`      | `#1b7a3d`                                  | Success text and borders     |
+| `--sf-color-success-soft` | 14% success on `--sf-color-bg`             | Success backgrounds          |
+| `--sf-color-warning`      | `#b26a00`                                  | Warning text and borders     |
+| `--sf-color-warning-soft` | 14% warning on `--sf-color-bg`             | Warning backgrounds          |
+| `--sf-shadow-raised`      | soft shadow from `--sf-color-fg`           | More sheet, floating button  |
+
+`--sf-color-focus` (default: the accent) colors the focus ring. `--sf-font-display` styles page titles.
+
+## Layout
+
+`AdminLayout` is a bottom tab bar below 900px and a sticky 240px left sidebar from 900px.
+
+- `extraNav`: host items, each `{ href, label, position?, icon?, badge? }`. `icon` defaults to a dot; `adminNavIcons` (`products`, `orders`, `shipping`, `discounts`, `more`, `dot`) are the kit's inline SVGs.
+- `navBadges`: `{ products?, orders?, shippingRates? }` counts for the kit items. The kit computes nothing; pass numbers from `client.getProductCounts()` and friends. `0` and `''` hide the badge.
+- `header` and `footer`: the sidebar's brand and bottom slots (put Sign out in `footer`). On a phone they live in the "More" sheet, so they render twice in the DOM, once per layout, and CSS shows one. Avoid fixed `id`s in them.
+- With more than five nav items the fifth tab becomes "More" (`labels.nav.more`, `labels.nav.closeMore`) and lists the rest.
+
+`AdminPageHeader({ title, actions?, floatingAction?, children? })` renders the `h1` and its actions on one row; every kit screen uses it. A `floatingAction` floats above the tab bar on a phone and sits inline with the actions on desktop. Buttons are `sfa-btn` (`--primary`, `--ghost`, `--danger`), filters are `sfa-chip` with `aria-pressed`, and inputs are `sfa-input`.

package/dist/client/admin-client.d.ts

@@ -1,15 +1,16 @@
-import { AdminDiscountListQuery, AdminDiscountPage, AdminOrderDetail, AdminOrderListQuery, AdminOrderPage, AdminProduct, AdminProductListQuery, AdminProductPage, AdminProductInput, AdminProductPatch, Discount, DiscountInput, DiscountPatch, RefundOrderInput, ProductImagePatch, ShippingRate, ShippingRateInput, ShipOrderInput } from '@develemit/commerce-contracts';
+import { AdminDiscountListQuery, AdminDiscountPage, AdminOrderDetail, AdminOrderListQuery, AdminProductCounts, AdminOrderPage, AdminProduct, AdminProductListQuery, AdminProductPage, AdminProductInput, AdminProductPatch, Discount, DiscountInput, DiscountPatch, RefundOrderInput, ProductImagePatch, ShippingRate, ShippingRateInput, ShipOrderInput } from '@develemit/commerce-contracts';
 import { AdminClientOptions } from './transport';
 export type AdminOrderQuery = Partial<Pick<AdminOrderListQuery, 'status' | 'q' | 'hasPendingRefund' | 'cursor'>> & {
     limit?: number;
 };
-export type AdminProductQuery = Pick<AdminProductListQuery, 'status' | 'stock' | 'q' | 'cursor' | 'limit'>;
+export type AdminProductQuery = Pick<AdminProductListQuery, 'status' | 'excludeArchived' | 'incomplete' | 'stock' | 'q' | 'cursor' | 'limit'>;
 export type AdminDiscountQuery = Partial<Pick<AdminDiscountListQuery, 'status' | 'q' | 'cursor' | 'limit'>>;
 export interface RefundOptions {
     idempotencyKey?: string;
 }
 export interface AdminClient {
     listProducts(query?: AdminProductQuery): Promise<AdminProductPage>;
+    getProductCounts(): Promise<AdminProductCounts>;
     getProduct(id: string): Promise<AdminProduct>;
     createProduct(input: AdminProductInput): Promise<AdminProduct>;
     updateProduct(id: string, patch: AdminProductPatch): Promise<AdminProduct>;

package/dist/client/errors.d.ts

@@ -1,3 +1,4 @@
+import { ProductIncompleteField } from '@develemit/commerce-contracts';
 export declare class AdminApiError extends Error {
     readonly status: number;
     readonly url: string;
@@ -45,3 +46,10 @@ export declare class DiscountCodeTakenError extends AdminApiError {
 export declare class DiscountInUseError extends AdminApiError {
     constructor(url: string, message?: string);
 }
+export declare class MaxRedemptionsBelowUsageError extends AdminApiError {
+    constructor(url: string, message?: string);
+}
+export declare class ProductIncompleteError extends AdminApiError {
+    readonly missing: ProductIncompleteField[];
+    constructor(url: string, missing: ProductIncompleteField[], message?: string);
+}

package/dist/client/index.js

@@ -1 +1 @@
-export { n as AdminApiError, r as AdminInvalidInputError, i as AdminNotFoundError, a as AdminUnauthorizedError, o as DiscountCodeTakenError, s as DiscountInUseError, c as ImageTooLargeError, l as InsufficientStockError, u as InvalidImageError, d as InvalidOrderStateError, f as RefundExceedsBalanceError, p as RefundGatewayError, m as RefundOutcomeUnknownError, t as createAdminClient } from "../client--_j5r8ag.js";
+export { n as AdminApiError, r as AdminInvalidInputError, i as AdminNotFoundError, a as AdminUnauthorizedError, o as DiscountCodeTakenError, s as DiscountInUseError, c as ImageTooLargeError, l as InsufficientStockError, u as InvalidImageError, d as InvalidOrderStateError, f as MaxRedemptionsBelowUsageError, p as ProductIncompleteError, m as RefundExceedsBalanceError, h as RefundGatewayError, g as RefundOutcomeUnknownError, t as createAdminClient } from "../client-DCL5DSHP.js";

package/dist/client/transport.d.ts

@@ -1,7 +1,9 @@
+import { AdminUnauthorizedError } from './errors';
 export interface AdminClientOptions {
     baseUrl: string;
     fetch?: typeof fetch;
     headers?: () => HeadersInit | Promise<HeadersInit>;
+    onUnauthorized?: (error: AdminUnauthorizedError) => void;
 }
 type Schema<T> = {
     parse(data: unknown): T;
@@ -15,5 +17,5 @@ export interface RequestOptions {
 export interface Transport {
     request<T>(path: string, schema: Schema<T>, options?: RequestOptions): Promise<T>;
 }
-export declare function createTransport({ baseUrl, fetch: fetchImpl, headers: getHeaders, }: AdminClientOptions): Transport;
+export declare function createTransport({ baseUrl, fetch: fetchImpl, headers: getHeaders, onUnauthorized, }: AdminClientOptions): Transport;
 export {};

package/dist/client-DCL5DSHP.js

@@ -0,0 +1,184 @@
+import { adminDiscountPageSchema as e, adminOrderDetailSchema as t, adminOrderPageSchema as n, adminProductCountsSchema as r, adminProductPageSchema as i, adminProductSchema as a, discountSchema as o, shippingRateSchema as s } from "@develemit/commerce-contracts";
+// src/client/errors.ts
+var c = class extends Error {
+	status;
+	url;
+	code;
+	idempotencyKey;
+	constructor(e, t, n, r) {
+		super(r ?? `Admin API request failed (${e}${n ? ` ${n}` : ""}): ${t}`), this.status = e, this.url = t, this.code = n, this.name = "AdminApiError";
+	}
+}, l = class extends c {
+	constructor(e) {
+		super(401, e, "UNAUTHORIZED", `Not authorized: ${e}`), this.name = "AdminUnauthorizedError";
+	}
+}, u = class extends c {
+	constructor(e, t, n) {
+		super(404, e, t, n ?? `Not found: ${e}`), this.name = "AdminNotFoundError";
+	}
+}, d = class extends c {
+	issues;
+	constructor(e, t) {
+		super(400, e, "INVALID_INPUT", `Invalid input: ${e}`), this.issues = t, this.name = "AdminInvalidInputError";
+	}
+}, f = class extends c {
+	orderStatus;
+	constructor(e, t, n) {
+		super(409, e, "INVALID_ORDER_STATE", n), this.orderStatus = t, this.name = "InvalidOrderStateError";
+	}
+}, p = class extends c {
+	productIds;
+	constructor(e, t, n) {
+		super(409, e, "INSUFFICIENT_STOCK", n), this.productIds = t, this.name = "InsufficientStockError";
+	}
+}, m = class extends c {
+	balanceCents;
+	constructor(e, t, n) {
+		super(400, e, "REFUND_EXCEEDS_BALANCE", n), this.balanceCents = t, this.name = "RefundExceedsBalanceError";
+	}
+}, h = class extends c {
+	constructor(e, t) {
+		super(502, e, "REFUND_GATEWAY_ERROR", t), this.name = "RefundGatewayError";
+	}
+}, g = class extends c {
+	constructor(e, t) {
+		super(502, e, "REFUND_OUTCOME_UNKNOWN", t), this.name = "RefundOutcomeUnknownError";
+	}
+}, _ = class extends c {
+	constructor(e, t, n) {
+		super(400, e, t, n), this.name = "InvalidImageError";
+	}
+}, v = class extends c {
+	constructor(e) {
+		super(413, e, "IMAGE_TOO_LARGE", `Image is too large: ${e}`), this.name = "ImageTooLargeError";
+	}
+}, y = class extends c {
+	constructor(e, t) {
+		super(409, e, "DISCOUNT_CODE_TAKEN", t), this.name = "DiscountCodeTakenError";
+	}
+}, b = class extends c {
+	constructor(e, t) {
+		super(409, e, "DISCOUNT_IN_USE", t), this.name = "DiscountInUseError";
+	}
+}, x = class extends c {
+	constructor(e, t) {
+		super(400, e, "MAX_REDEMPTIONS_BELOW_USAGE", t), this.name = "MaxRedemptionsBelowUsageError";
+	}
+}, S = class extends c {
+	missing;
+	constructor(e, t, n) {
+		super(422, e, "PRODUCT_INCOMPLETE", n), this.missing = t, this.name = "ProductIncompleteError";
+	}
+};
+// src/client/map-error.ts
+async function C(e) {
+	try {
+		let t = await e.json();
+		return t && typeof t == "object" ? t : {};
+	} catch {
+		return {};
+	}
+}
+async function w(e, t) {
+	let n = await C(t), { error: r, message: i } = n;
+	return t.status === 401 ? new l(e) : t.status === 404 ? new u(e, r, i) : t.status === 413 ? new v(e) : r === "INVALID_INPUT" ? new d(e, n.issues ?? []) : r === "INVALID_ORDER_STATE" ? new f(e, n.status ?? "", i) : r === "INSUFFICIENT_STOCK" ? new p(e, n.productIds ?? [], i) : r === "REFUND_EXCEEDS_BALANCE" ? new m(e, n.balanceCents, i) : r === "REFUND_GATEWAY_ERROR" ? new h(e, i) : r === "REFUND_OUTCOME_UNKNOWN" ? new g(e, i) : r === "DISCOUNT_CODE_TAKEN" ? new y(e, i) : r === "MAX_REDEMPTIONS_BELOW_USAGE" ? new x(e, i) : r === "DISCOUNT_IN_USE" ? new b(e, i) : r === "PRODUCT_INCOMPLETE" ? new S(e, n.missing ?? [], i) : r === "INVALID_IMAGE" || r === "INVALID_IMAGE_ORDER" ? new _(e, r, i) : new c(t.status, e, r, i);
+}
+// src/client/transport.ts
+function T({ baseUrl: e, fetch: t = (...e) => globalThis.fetch(...e), headers: n, onUnauthorized: r }) {
+	let i = e.replace(/\/+$/, "");
+	return { async request(e, a, { method: o = "GET", body: s, form: c, headers: u } = {}) {
+		let d = `${i}${e}`, f = new Headers(n ? await n() : void 0);
+		f.set("accept", "application/json"), s !== void 0 && f.set("content-type", "application/json");
+		for (let [e, t] of Object.entries(u ?? {})) f.set(e, t);
+		let p = await t(d, {
+			method: o,
+			headers: f,
+			body: c ?? (s === void 0 ? void 0 : JSON.stringify(s))
+		});
+		if (!p.ok) {
+			let e = await w(d, p);
+			if (e instanceof l) try {
+				r?.(e);
+			} catch {}
+			throw e;
+		}
+		return a.parse(await p.json());
+	} };
+}
+// src/client/admin-client.ts
+var E = encodeURIComponent;
+function D(e) {
+	let t = new URLSearchParams();
+	for (let [n, r] of Object.entries(e)) r !== void 0 && t.set(n, String(r));
+	let n = t.toString();
+	return n ? `?${n}` : "";
+}
+function O(c) {
+	let { request: l } = T(c), u = a, d = o, f = s.array();
+	return {
+		listProducts: (e = {}) => l(`/admin/products${D(e)}`, i),
+		getProductCounts: () => l("/admin/products/counts", r),
+		getProduct: (e) => l(`/admin/products/${E(e)}`, u),
+		createProduct: (e) => l("/admin/products", u, {
+			method: "POST",
+			body: e
+		}),
+		updateProduct: (e, t) => l(`/admin/products/${E(e)}`, u, {
+			method: "PATCH",
+			body: t
+		}),
+		uploadProductImage(e, t, n) {
+			let r = new FormData();
+			return n !== void 0 && r.append("alt", n), r.append("file", t), l(`/admin/products/${E(e)}/images`, u, {
+				method: "POST",
+				form: r
+			});
+		},
+		reorderProductImages: (e, t) => l(`/admin/products/${E(e)}/images/order`, u, {
+			method: "PATCH",
+			body: { imageIds: t }
+		}),
+		updateProductImage: (e, t, n) => l(`/admin/products/${E(e)}/images/${E(t)}`, u, {
+			method: "PATCH",
+			body: n
+		}),
+		deleteProductImage: (e, t) => l(`/admin/products/${E(e)}/images/${E(t)}`, u, { method: "DELETE" }),
+		listDiscounts: (t = {}) => l(`/admin/discounts${D(t)}`, e),
+		getDiscount: (e) => l(`/admin/discounts/${E(e)}`, d),
+		createDiscount: (e) => l("/admin/discounts", d, {
+			method: "POST",
+			body: e
+		}),
+		updateDiscount: (e, t) => l(`/admin/discounts/${E(e)}`, d, {
+			method: "PATCH",
+			body: t
+		}),
+		listShippingRates: () => l("/admin/shipping-rates", f),
+		replaceShippingRates: (e) => l("/admin/shipping-rates", f, {
+			method: "PUT",
+			body: e
+		}),
+		listOrders: (e = {}) => l(`/admin/orders${D(e)}`, n),
+		getOrder: (e) => l(`/admin/orders/${E(e)}`, t),
+		shipOrder: (e, n = {}) => l(`/admin/orders/${E(e)}/ship`, t, {
+			method: "POST",
+			body: n
+		}),
+		resolveOrder: (e) => l(`/admin/orders/${E(e)}/resolve`, t, { method: "POST" }),
+		async refundOrder(e, n = { restock: !1 }, r = {}) {
+			let i = r.idempotencyKey ?? crypto.randomUUID();
+			try {
+				return await l(`/admin/orders/${E(e)}/refunds`, t, {
+					method: "POST",
+					body: n,
+					headers: { "idempotency-key": i }
+				});
+			} catch (e) {
+				throw e instanceof Error && (e.idempotencyKey = i), e;
+			}
+		}
+	};
+}
+export { l as a, v as c, f as d, x as f, g, h, u as i, p as l, m, c as n, y as o, S as p, d as r, b as s, O as t, _ as u };
+
+//# sourceMappingURL=client-DCL5DSHP.js.map

package/dist/client-DCL5DSHP.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-DCL5DSHP.js","names":["AdminApiError","message","status","code","url","AdminUnauthorizedError","AdminNotFoundError","AdminInvalidInputError","issues","InvalidOrderStateError","orderStatus","InsufficientStockError","productIds","RefundExceedsBalanceError","balanceCents","RefundGatewayError","RefundOutcomeUnknownError","InvalidImageError","ImageTooLargeError","DiscountCodeTakenError","DiscountInUseError","MaxRedemptionsBelowUsageError","ProductIncompleteError","missing","readBody","body","res","mapError","createTransport","fetchImpl","args","getHeaders","root","baseUrl","path","merged","name","value","headers","form","error","schema","enc","queryString","params","key","query","qs","createAdminClient","options","product","adminProductSchema","discount","discountSchema","rates","shippingRateSchema","request","adminProductPageSchema","adminProductCountsSchema","id","input","patch","alt","file","imageId","adminDiscountPageSchema","adminOrderPageSchema","adminOrderDetailSchema","refund","err"],"sources":["../src/client/errors.ts","../src/client/map-error.ts","../src/client/transport.ts","../src/client/admin-client.ts"],"sourcesContent":["import type { ProductIncompleteField } from '@develemit/commerce-contracts';\n\nexport class AdminApiError extends Error {\n  idempotencyKey?: string;\n\n  constructor(\n    readonly status: number,\n    readonly url: string,\n    readonly code?: string,\n    message?: string,\n  ) {\n    super(\n      message ??\n        `Admin API request failed (${status}${code ? ` ${code}` : ''}): ${url}`,\n    );\n    this.name = 'AdminApiError';\n  }\n}\n\nexport class AdminUnauthorizedError extends AdminApiError {\n  constructor(url: string) {\n    super(401, url, 'UNAUTHORIZED', `Not authorized: ${url}`);\n    this.name = 'AdminUnauthorizedError';\n  }\n}\n\nexport class AdminNotFoundError extends AdminApiError {\n  constructor(url: string, code?: string, message?: string) {\n    super(404, url, code, message ?? `Not found: ${url}`);\n    this.name = 'AdminNotFoundError';\n  }\n}\n\nexport class AdminInvalidInputError extends AdminApiError {\n  constructor(\n    url: string,\n    readonly issues: unknown[],\n  ) {\n    super(400, url, 'INVALID_INPUT', `Invalid input: ${url}`);\n    this.name = 'AdminInvalidInputError';\n  }\n}\n\nexport class InvalidOrderStateError extends AdminApiError {\n  constructor(\n    url: string,\n    readonly orderStatus: string,\n    message?: string,\n  ) {\n    super(409, url, 'INVALID_ORDER_STATE', message);\n    this.name = 'InvalidOrderStateError';\n  }\n}\n\nexport class InsufficientStockError extends AdminApiError {\n  constructor(\n    url: string,\n    readonly productIds: string[],\n    message?: string,\n  ) {\n    super(409, url, 'INSUFFICIENT_STOCK', message);\n    this.name = 'InsufficientStockError';\n  }\n}\n\nexport class RefundExceedsBalanceError extends AdminApiError {\n  constructor(\n    url: string,\n    readonly balanceCents: number | undefined,\n    message?: string,\n  ) {\n    super(400, url, 'REFUND_EXCEEDS_BALANCE', message);\n    this.name = 'RefundExceedsBalanceError';\n  }\n}\n\nexport class RefundGatewayError extends AdminApiError {\n  constructor(url: string, message?: string) {\n    super(502, url, 'REFUND_GATEWAY_ERROR', message);\n    this.name = 'RefundGatewayError';\n  }\n}\n\nexport class RefundOutcomeUnknownError extends AdminApiError {\n  constructor(url: string, message?: string) {\n    super(502, url, 'REFUND_OUTCOME_UNKNOWN', message);\n    this.name = 'RefundOutcomeUnknownError';\n  }\n}\n\nexport class InvalidImageError extends AdminApiError {\n  constructor(url: string, code: string, message?: string) {\n    super(400, url, code, message);\n    this.name = 'InvalidImageError';\n  }\n}\n\nexport class ImageTooLargeError extends AdminApiError {\n  constructor(url: string) {\n    super(413, url, 'IMAGE_TOO_LARGE', `Image is too large: ${url}`);\n    this.name = 'ImageTooLargeError';\n  }\n}\n\nexport class DiscountCodeTakenError extends AdminApiError {\n  constructor(url: string, message?: string) {\n    super(409, url, 'DISCOUNT_CODE_TAKEN', message);\n    this.name = 'DiscountCodeTakenError';\n  }\n}\n\nexport class DiscountInUseError extends AdminApiError {\n  constructor(url: string, message?: string) {\n    super(409, url, 'DISCOUNT_IN_USE', message);\n    this.name = 'DiscountInUseError';\n  }\n}\n\nexport class MaxRedemptionsBelowUsageError extends AdminApiError {\n  constructor(url: string, message?: string) {\n    super(400, url, 'MAX_REDEMPTIONS_BELOW_USAGE', message);\n    this.name = 'MaxRedemptionsBelowUsageError';\n  }\n}\n\nexport class ProductIncompleteError extends AdminApiError {\n  constructor(\n    url: string,\n    readonly missing: ProductIncompleteField[],\n    message?: string,\n  ) {\n    super(422, url, 'PRODUCT_INCOMPLETE', message);\n    this.name = 'ProductIncompleteError';\n  }\n}\n","import type { ProductIncompleteField } from '@develemit/commerce-contracts';\nimport {\n  AdminApiError,\n  AdminInvalidInputError,\n  AdminNotFoundError,\n  AdminUnauthorizedError,\n  DiscountCodeTakenError,\n  DiscountInUseError,\n  ImageTooLargeError,\n  InsufficientStockError,\n  InvalidImageError,\n  InvalidOrderStateError,\n  MaxRedemptionsBelowUsageError,\n  ProductIncompleteError,\n  RefundExceedsBalanceError,\n  RefundGatewayError,\n  RefundOutcomeUnknownError,\n} from './errors';\n\ninterface ErrorBody {\n  error?: string;\n  message?: string;\n  issues?: unknown[];\n  status?: string;\n  productIds?: string[];\n  missing?: ProductIncompleteField[];\n  balanceCents?: number;\n}\n\nasync function readBody(res: Response): Promise<ErrorBody> {\n  try {\n    const body: unknown = await res.json();\n    return body && typeof body === 'object' ? (body as ErrorBody) : {};\n  } catch {\n    return {};\n  }\n}\n\nexport async function mapError(\n  url: string,\n  res: Response,\n): Promise<AdminApiError> {\n  const body = await readBody(res);\n  const { error: code, message } = body;\n  if (res.status === 401) return new AdminUnauthorizedError(url);\n  if (res.status === 404) return new AdminNotFoundError(url, code, message);\n  if (res.status === 413) return new ImageTooLargeError(url);\n  if (code === 'INVALID_INPUT') {\n    return new AdminInvalidInputError(url, body.issues ?? []);\n  }\n  if (code === 'INVALID_ORDER_STATE') {\n    return new InvalidOrderStateError(url, body.status ?? '', message);\n  }\n  if (code === 'INSUFFICIENT_STOCK') {\n    return new InsufficientStockError(url, body.productIds ?? [], message);\n  }\n  if (code === 'REFUND_EXCEEDS_BALANCE') {\n    return new RefundExceedsBalanceError(url, body.balanceCents, message);\n  }\n  if (code === 'REFUND_GATEWAY_ERROR')\n    return new RefundGatewayError(url, message);\n  if (code === 'REFUND_OUTCOME_UNKNOWN') {\n    return new RefundOutcomeUnknownError(url, message);\n  }\n  if (code === 'DISCOUNT_CODE_TAKEN') {\n    return new DiscountCodeTakenError(url, message);\n  }\n  if (code === 'MAX_REDEMPTIONS_BELOW_USAGE') {\n    return new MaxRedemptionsBelowUsageError(url, message);\n  }\n  if (code === 'DISCOUNT_IN_USE') return new DiscountInUseError(url, message);\n  if (code === 'PRODUCT_INCOMPLETE') {\n    return new ProductIncompleteError(url, body.missing ?? [], message);\n  }\n  if (code === 'INVALID_IMAGE' || code === 'INVALID_IMAGE_ORDER') {\n    return new InvalidImageError(url, code, message);\n  }\n  return new AdminApiError(res.status, url, code, message);\n}\n","import { AdminUnauthorizedError } from './errors';\nimport { mapError } from './map-error';\n\nexport interface AdminClientOptions {\n  baseUrl: string;\n  fetch?: typeof fetch;\n  headers?: () => HeadersInit | Promise<HeadersInit>;\n  onUnauthorized?: (error: AdminUnauthorizedError) => void;\n}\n\ntype Schema<T> = { parse(data: unknown): T };\n\nexport interface RequestOptions {\n  method?: string;\n  body?: unknown;\n  form?: FormData;\n  headers?: Record<string, string>;\n}\n\nexport interface Transport {\n  request<T>(\n    path: string,\n    schema: Schema<T>,\n    options?: RequestOptions,\n  ): Promise<T>;\n}\n\nexport function createTransport({\n  baseUrl,\n  fetch: fetchImpl = (...args) => globalThis.fetch(...args),\n  headers: getHeaders,\n  onUnauthorized,\n}: AdminClientOptions): Transport {\n  const root = baseUrl.replace(/\\/+$/, '');\n\n  return {\n    async request(path, schema, { method = 'GET', body, form, headers } = {}) {\n      const url = `${root}${path}`;\n      const merged = new Headers(getHeaders ? await getHeaders() : undefined);\n      merged.set('accept', 'application/json');\n      if (body !== undefined) merged.set('content-type', 'application/json');\n      for (const [name, value] of Object.entries(headers ?? {})) {\n        merged.set(name, value);\n      }\n      const res = await fetchImpl(url, {\n        method,\n        headers: merged,\n        body: form ?? (body === undefined ? undefined : JSON.stringify(body)),\n      });\n      if (!res.ok) {\n        const error = await mapError(url, res);\n        if (error instanceof AdminUnauthorizedError) {\n          try {\n            onUnauthorized?.(error);\n          } catch {\n            // A host callback failure must not replace the 401 the caller expects.\n          }\n        }\n        throw error;\n      }\n      return schema.parse(await res.json());\n    },\n  };\n}\n","import {\n  adminDiscountPageSchema,\n  adminOrderDetailSchema,\n  adminOrderPageSchema,\n  adminProductCountsSchema,\n  adminProductPageSchema,\n  adminProductSchema,\n  discountSchema,\n  shippingRateSchema,\n  type AdminDiscountListQuery,\n  type AdminDiscountPage,\n  type AdminOrderDetail,\n  type AdminOrderListQuery,\n  type AdminProductCounts,\n  type AdminOrderPage,\n  type AdminProduct,\n  type AdminProductListQuery,\n  type AdminProductPage,\n  type AdminProductInput,\n  type AdminProductPatch,\n  type Discount,\n  type DiscountInput,\n  type DiscountPatch,\n  type RefundOrderInput,\n  type ProductImagePatch,\n  type ShippingRate,\n  type ShippingRateInput,\n  type ShipOrderInput,\n} from '@develemit/commerce-contracts';\nimport { createTransport, type AdminClientOptions } from './transport';\n\nexport type AdminOrderQuery = Partial<\n  Pick<AdminOrderListQuery, 'status' | 'q' | 'hasPendingRefund' | 'cursor'>\n> & { limit?: number };\n\nexport type AdminProductQuery = Pick<\n  AdminProductListQuery,\n  | 'status'\n  | 'excludeArchived'\n  | 'incomplete'\n  | 'stock'\n  | 'q'\n  | 'cursor'\n  | 'limit'\n>;\n\nexport type AdminDiscountQuery = Partial<\n  Pick<AdminDiscountListQuery, 'status' | 'q' | 'cursor' | 'limit'>\n>;\n\nexport interface RefundOptions {\n  idempotencyKey?: string;\n}\n\nexport interface AdminClient {\n  listProducts(query?: AdminProductQuery): Promise<AdminProductPage>;\n  getProductCounts(): Promise<AdminProductCounts>;\n  getProduct(id: string): Promise<AdminProduct>;\n  createProduct(input: AdminProductInput): Promise<AdminProduct>;\n  updateProduct(id: string, patch: AdminProductPatch): Promise<AdminProduct>;\n  uploadProductImage(\n    id: string,\n    file: Blob,\n    alt?: string,\n  ): Promise<AdminProduct>;\n  reorderProductImages(id: string, imageIds: string[]): Promise<AdminProduct>;\n  updateProductImage(\n    id: string,\n    imageId: string,\n    patch: ProductImagePatch,\n  ): Promise<AdminProduct>;\n  deleteProductImage(id: string, imageId: string): Promise<AdminProduct>;\n  listDiscounts(query?: AdminDiscountQuery): Promise<AdminDiscountPage>;\n  getDiscount(id: string): Promise<Discount>;\n  createDiscount(input: DiscountInput): Promise<Discount>;\n  updateDiscount(id: string, patch: DiscountPatch): Promise<Discount>;\n  listShippingRates(): Promise<ShippingRate[]>;\n  replaceShippingRates(rates: ShippingRateInput[]): Promise<ShippingRate[]>;\n  listOrders(query?: AdminOrderQuery): Promise<AdminOrderPage>;\n  getOrder(id: string): Promise<AdminOrderDetail>;\n  shipOrder(id: string, input?: ShipOrderInput): Promise<AdminOrderDetail>;\n  resolveOrder(id: string): Promise<AdminOrderDetail>;\n  /**\n   * Retrying the same intent must reuse the same key. When none is passed one\n   * is generated, and it is set on any thrown error as `idempotencyKey` so the\n   * caller can pass it back on retry.\n   */\n  refundOrder(\n    id: string,\n    input?: RefundOrderInput,\n    options?: RefundOptions,\n  ): Promise<AdminOrderDetail>;\n}\n\nconst enc = encodeURIComponent;\n\nfunction queryString(query: object): string {\n  const params = new URLSearchParams();\n  for (const [key, value] of Object.entries(query)) {\n    if (value !== undefined) params.set(key, String(value));\n  }\n  const qs = params.toString();\n  return qs ? `?${qs}` : '';\n}\n\nexport function createAdminClient(options: AdminClientOptions): AdminClient {\n  const { request } = createTransport(options);\n  const product = adminProductSchema;\n  const discount = discountSchema;\n  const rates = shippingRateSchema.array();\n\n  return {\n    listProducts: (query = {}) =>\n      request(`/admin/products${queryString(query)}`, adminProductPageSchema),\n    getProductCounts: () =>\n      request('/admin/products/counts', adminProductCountsSchema),\n    getProduct: (id) => request(`/admin/products/${enc(id)}`, product),\n    createProduct: (input) =>\n      request('/admin/products', product, { method: 'POST', body: input }),\n    updateProduct: (id, patch) =>\n      request(`/admin/products/${enc(id)}`, product, {\n        method: 'PATCH',\n        body: patch,\n      }),\n    uploadProductImage(id, file, alt) {\n      const form = new FormData();\n      if (alt !== undefined) form.append('alt', alt);\n      form.append('file', file);\n      return request(`/admin/products/${enc(id)}/images`, product, {\n        method: 'POST',\n        form,\n      });\n    },\n    reorderProductImages: (id, imageIds) =>\n      request(`/admin/products/${enc(id)}/images/order`, product, {\n        method: 'PATCH',\n        body: { imageIds },\n      }),\n    updateProductImage: (id, imageId, patch) =>\n      request(`/admin/products/${enc(id)}/images/${enc(imageId)}`, product, {\n        method: 'PATCH',\n        body: patch,\n      }),\n    deleteProductImage: (id, imageId) =>\n      request(`/admin/products/${enc(id)}/images/${enc(imageId)}`, product, {\n        method: 'DELETE',\n      }),\n    listDiscounts: (query = {}) =>\n      request(`/admin/discounts${queryString(query)}`, adminDiscountPageSchema),\n    getDiscount: (id) => request(`/admin/discounts/${enc(id)}`, discount),\n    createDiscount: (input) =>\n      request('/admin/discounts', discount, { method: 'POST', body: input }),\n    updateDiscount: (id, patch) =>\n      request(`/admin/discounts/${enc(id)}`, discount, {\n        method: 'PATCH',\n        body: patch,\n      }),\n    listShippingRates: () => request('/admin/shipping-rates', rates),\n    replaceShippingRates: (input) =>\n      request('/admin/shipping-rates', rates, { method: 'PUT', body: input }),\n    listOrders: (query = {}) =>\n      request(`/admin/orders${queryString(query)}`, adminOrderPageSchema),\n    getOrder: (id) =>\n      request(`/admin/orders/${enc(id)}`, adminOrderDetailSchema),\n    shipOrder: (id, input = {}) =>\n      request(`/admin/orders/${enc(id)}/ship`, adminOrderDetailSchema, {\n        method: 'POST',\n        body: input,\n      }),\n    resolveOrder: (id) =>\n      request(`/admin/orders/${enc(id)}/resolve`, adminOrderDetailSchema, {\n        method: 'POST',\n      }),\n    async refundOrder(id, input = { restock: false }, refund = {}) {\n      const key = refund.idempotencyKey ?? crypto.randomUUID();\n      try {\n        return await request(\n          `/admin/orders/${enc(id)}/refunds`,\n          adminOrderDetailSchema,\n          {\n            method: 'POST',\n            body: input,\n            headers: { 'idempotency-key': key },\n          },\n        );\n      } catch (err) {\n        if (err instanceof Error) {\n          (err as Error & { idempotencyKey?: string }).idempotencyKey = key;\n        }\n        throw err;\n      }\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/components/admin-layout/admin-layout.d.ts

@@ -1,13 +1,12 @@
 import { ReactNode } from 'react';
-export interface ExtraNavItem {
-    href: string;
-    label: string;
-    position?: 'start' | 'end';
-}
+import { ExtraNavItem, NavBadges } from './nav-items';
+export type { ExtraNavItem, NavBadges } from './nav-items';
+export { adminNavIcons } from './nav-icons';
 export interface AdminLayoutProps {
     children: ReactNode;
     extraNav?: ExtraNavItem[];
+    navBadges?: NavBadges;
     header?: ReactNode;
     footer?: ReactNode;
 }
-export declare function AdminLayout({ children, extraNav, header, footer, }: AdminLayoutProps): import('react').JSX.Element;
+export declare function AdminLayout({ children, extraNav, navBadges, header, footer, }: AdminLayoutProps): import('react').JSX.Element;

package/dist/components/admin-layout/nav-icons.d.ts

@@ -0,0 +1,9 @@
+import { ReactNode } from 'react';
+export declare const adminNavIcons: {
+    products: ReactNode;
+    orders: ReactNode;
+    shipping: ReactNode;
+    discounts: ReactNode;
+    more: ReactNode;
+    dot: ReactNode;
+};

package/dist/components/admin-layout/nav-items.d.ts

@@ -0,0 +1,36 @@
+import { ReactNode } from 'react';
+export interface ExtraNavItem {
+    href: string;
+    label: string;
+    position?: 'start' | 'end';
+    icon?: ReactNode;
+    badge?: number | string;
+}
+export interface NavBadges {
+    products?: number | string;
+    orders?: number | string;
+    shippingRates?: number | string;
+}
+export interface NavItem {
+    href: string;
+    label: string;
+    icon: ReactNode;
+    badge?: number | string;
+}
+export declare const TAB_BAR_SLOTS = 5;
+interface KitHrefs {
+    products: string;
+    orders: string;
+    shippingRates: string;
+}
+interface KitLabels {
+    products: string;
+    orders: string;
+    shippingRates: string;
+}
+export declare function buildNavItems(hrefs: KitHrefs, labels: KitLabels, extraNav: ExtraNavItem[], badges: NavBadges): NavItem[];
+export declare function splitForTabBar(items: NavItem[]): {
+    bar: NavItem[];
+    overflow: NavItem[];
+};
+export {};

package/dist/components/admin-layout/use-more-sheet.d.ts

@@ -0,0 +1,5 @@
+export declare function useMoreSheet(): {
+    open: boolean;
+    close: () => void;
+    toggle: () => void;
+};

package/dist/components/empty-state/empty-state.d.ts

@@ -0,0 +1,10 @@
+import { ReactNode } from 'react';
+export type EmptyStateIcon = 'orders' | 'discounts' | 'shipping' | 'search';
+export interface EmptyStateProps {
+    icon: EmptyStateIcon;
+    title: ReactNode;
+    body?: ReactNode;
+    action?: ReactNode;
+    children?: ReactNode;
+}
+export declare function EmptyState({ icon, title, body, action, children, }: EmptyStateProps): import('react').JSX.Element;