@develemit/commerce-admin 0.0.0-stage → 0.3.0

package/README.md

@@ -1,3 +1,137 @@
-# Temporary Holding Version
+# @develemit/commerce-admin
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Admin UI for the develemit commerce kit: product, order and shipping-rate screens for the `@develemit/commerce-server` admin API.
+
+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.
+
+```tsx
+import { AdminProvider } from '@develemit/commerce-admin';
+import '@develemit/commerce-admin/styles.css';
+```
+
+## Install
+
+```bash
+pnpm add @develemit/commerce-admin @develemit/commerce-contracts
+```
+
+Peers: `react` and `react-dom` `^19`. Import `@develemit/commerce-admin/styles.css` in the admin layout only, so the `sfa-` classes stay out of your storefront pages.
+
+## Provider and client
+
+```tsx
+'use client';
+import { AdminLayout, AdminProvider } from '@develemit/commerce-admin';
+import { createAdminClient } from '@develemit/commerce-admin/client';
+import Link from 'next/link';
+import Image from 'next/image';
+
+const client = createAdminClient({ baseUrl: '/api' });
+
+export function Admin({ children }) {
+  return (
+    <AdminProvider
+      client={client}
+      renderLink={({ href, className, children }) => (
+        <Link href={href} className={className}>
+          {children}
+        </Link>
+      )}
+      renderImage={({ src, alt, className }) => (
+        <Image
+          src={src}
+          alt={alt}
+          className={className}
+          width={96}
+          height={96}
+          unoptimized
+        />
+      )}
+      hrefs={{ storefrontProduct: (slug) => `/shop/${slug}` }}
+    >
+      <AdminLayout>{children}</AdminLayout>
+    </AdminProvider>
+  );
+}
+```
+
+The client calls `${baseUrl}/admin/...`, matching the server's admin routes. `hrefs` defaults to `/admin/products`, `/admin/products/:id`, `/admin/products/new`, `/admin/orders`, `/admin/orders/:id` and `/admin/shipping-rates`.
+
+## Auth
+
+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.
+
+## Primitives
+
+This version ships `AdminProvider`, `useAdmin()` and 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.
+- `StatusBadge` — text comes from `labels.statuses`.
+- `Money` — integer cents and an ISO-4217 currency, formatted with `locale`.
+- `ConfirmDialog` — modal with focus trap, Escape and focus return.
+- `Notice` — `success`/`warning` use `role="status"`, `error` uses `role="alert"`; `toast` auto-hides after `duration` and sits above the safe-area inset.
+- `ErrorMessage` — maps the typed client errors to copy in `labels.errors`.
+- `useAdminQuery(key, fn)` → `{ data, error, loading, reload }` (ignores stale responses) and `useAdminMutation(fn)` → `{ run, pending, error, reset }`. No cache; call `reload()` after a mutation.
+
+Override any copy through `AdminProvider`'s `labels` (`nav`, `statuses` and `errors` merge key by key).
+
+## Product screens
+
+```tsx
+<AdminProvider
+  client={client}
+  hrefs={{ storefrontProduct: (slug) => `/shop/${slug}` }}
+>
+  <AdminProductList />
+</AdminProvider>
+
+<AdminProductEditor
+  productId={id} // omit to create
+  onSaved={(product) => router.push(hrefs.product(product.id))}
+  imagesSlot={null}
+  categories={['Necklaces', 'Rings']} // optional suggestions
+/>
+```
+
+- `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.
+- 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.
+
+## Order screens
+
+```tsx
+<AdminOrderList />
+
+<AdminOrderDetail
+  orderId={id}
+  actions={({ order, reload }) => null} // slot for ship/refund/resolve
+/>
+```
+
+- `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`.
+- Rows link through `hrefs.order(id)` and `renderLink`. Copy lives under `labels.orders`.
+
+## Shipping rates
+
+```tsx
+<AdminShippingRates onDirtyChange={(dirty) => setBlockNavigation(dirty)} />
+```
+
+- `AdminShippingRates` — loads the shop's rates into local state, then one "Save changes" sends the whole ordered list in a single `PUT`. Rates can be added, edited, reordered (move earlier/later), deactivated and removed.
+- Removing a rate asks for confirmation and warns that it disappears from checkout once saved. Past orders keep the rate name they were placed with.
+- Saving is blocked client-side for duplicate names, a fastest-days value above slowest-days, bad prices, and zero active rates (checkout needs at least one). A server `INVALID_INPUT` is shown on the offending rows and local edits are kept.
+- `onDirtyChange(dirty)` fires when unsaved edits appear or are cleared, so a host can guard its router. Copy lives under `labels.shipping`.
+
+## Images
+
+The default `renderImage` is a lazy, async `<img>` (`priority` makes it eager). Uploads can be up to 8MB and the default does not resize, so production hosts should supply a resizing `renderImage` (for example `next/image`) or serve through a CDN.
+
+## 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.

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

@@ -0,0 +1,31 @@
+import { AdminOrderDetail, AdminOrderListQuery, AdminOrderPage, AdminProduct, AdminProductListQuery, AdminProductPage, AdminProductInput, AdminProductPatch, RefundOrderInput, 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 interface RefundOptions {
+    idempotencyKey?: string;
+}
+export interface AdminClient {
+    listProducts(query?: AdminProductQuery): Promise<AdminProductPage>;
+    getProduct(id: string): Promise<AdminProduct>;
+    createProduct(input: AdminProductInput): Promise<AdminProduct>;
+    updateProduct(id: string, patch: AdminProductPatch): Promise<AdminProduct>;
+    uploadProductImage(id: string, file: Blob, alt?: string): Promise<AdminProduct>;
+    reorderProductImages(id: string, imageIds: string[]): Promise<AdminProduct>;
+    deleteProductImage(id: string, imageId: string): Promise<AdminProduct>;
+    listShippingRates(): Promise<ShippingRate[]>;
+    replaceShippingRates(rates: ShippingRateInput[]): Promise<ShippingRate[]>;
+    listOrders(query?: AdminOrderQuery): Promise<AdminOrderPage>;
+    getOrder(id: string): Promise<AdminOrderDetail>;
+    shipOrder(id: string, input?: ShipOrderInput): Promise<AdminOrderDetail>;
+    resolveOrder(id: string): Promise<AdminOrderDetail>;
+    /**
+     * Retrying the same intent must reuse the same key. When none is passed one
+     * is generated, and it is set on any thrown error as `idempotencyKey` so the
+     * caller can pass it back on retry.
+     */
+    refundOrder(id: string, input?: RefundOrderInput, options?: RefundOptions): Promise<AdminOrderDetail>;
+}
+export declare function createAdminClient(options: AdminClientOptions): AdminClient;

package/dist/client/errors.d.ts

@@ -0,0 +1,41 @@
+export declare class AdminApiError extends Error {
+    readonly status: number;
+    readonly url: string;
+    readonly code?: string | undefined;
+    idempotencyKey?: string;
+    constructor(status: number, url: string, code?: string | undefined, message?: string);
+}
+export declare class AdminUnauthorizedError extends AdminApiError {
+    constructor(url: string);
+}
+export declare class AdminNotFoundError extends AdminApiError {
+    constructor(url: string, code?: string, message?: string);
+}
+export declare class AdminInvalidInputError extends AdminApiError {
+    readonly issues: unknown[];
+    constructor(url: string, issues: unknown[]);
+}
+export declare class InvalidOrderStateError extends AdminApiError {
+    readonly orderStatus: string;
+    constructor(url: string, orderStatus: string, message?: string);
+}
+export declare class InsufficientStockError extends AdminApiError {
+    readonly productIds: string[];
+    constructor(url: string, productIds: string[], message?: string);
+}
+export declare class RefundExceedsBalanceError extends AdminApiError {
+    readonly balanceCents: number | undefined;
+    constructor(url: string, balanceCents: number | undefined, message?: string);
+}
+export declare class RefundGatewayError extends AdminApiError {
+    constructor(url: string, message?: string);
+}
+export declare class RefundOutcomeUnknownError extends AdminApiError {
+    constructor(url: string, message?: string);
+}
+export declare class InvalidImageError extends AdminApiError {
+    constructor(url: string, code: string, message?: string);
+}
+export declare class ImageTooLargeError extends AdminApiError {
+    constructor(url: string);
+}

package/dist/client/index.d.ts

@@ -0,0 +1,3 @@
+export * from './admin-client';
+export * from './errors';
+export type { AdminClientOptions } from './transport';

package/dist/client/index.js

@@ -0,0 +1 @@
+export { n as AdminApiError, r as AdminInvalidInputError, i as AdminNotFoundError, a as AdminUnauthorizedError, o as ImageTooLargeError, s as InsufficientStockError, c as InvalidImageError, l as InvalidOrderStateError, u as RefundExceedsBalanceError, d as RefundGatewayError, f as RefundOutcomeUnknownError, t as createAdminClient } from "../client-n_IYb4iK.js";

package/dist/client/map-error.d.ts

@@ -0,0 +1,2 @@
+import { AdminApiError } from './errors';
+export declare function mapError(url: string, res: Response): Promise<AdminApiError>;

package/dist/client/transport.d.ts

@@ -0,0 +1,19 @@
+export interface AdminClientOptions {
+    baseUrl: string;
+    fetch?: typeof fetch;
+    headers?: () => HeadersInit | Promise<HeadersInit>;
+}
+type Schema<T> = {
+    parse(data: unknown): T;
+};
+export interface RequestOptions {
+    method?: string;
+    body?: unknown;
+    form?: FormData;
+    headers?: Record<string, string>;
+}
+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 {};

package/dist/client-n_IYb4iK.js

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

package/dist/client-n_IYb4iK.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-n_IYb4iK.js","names":["AdminApiError","message","status","code","url","AdminUnauthorizedError","AdminNotFoundError","AdminInvalidInputError","issues","InvalidOrderStateError","orderStatus","InsufficientStockError","productIds","RefundExceedsBalanceError","balanceCents","RefundGatewayError","RefundOutcomeUnknownError","InvalidImageError","ImageTooLargeError","readBody","body","res","mapError","createTransport","fetchImpl","args","getHeaders","root","baseUrl","path","merged","name","value","headers","form","schema","enc","queryString","params","key","query","qs","createAdminClient","options","product","adminProductSchema","rates","shippingRateSchema","request","adminProductPageSchema","id","input","patch","alt","file","imageId","adminOrderPageSchema","adminOrderDetailSchema","refund","err"],"sources":["../src/client/errors.ts","../src/client/map-error.ts","../src/client/transport.ts","../src/client/admin-client.ts"],"sourcesContent":["export 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","import {\n  AdminApiError,\n  AdminInvalidInputError,\n  AdminNotFoundError,\n  AdminUnauthorizedError,\n  ImageTooLargeError,\n  InsufficientStockError,\n  InvalidImageError,\n  InvalidOrderStateError,\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  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 === '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 { mapError } from './map-error';\n\nexport interface AdminClientOptions {\n  baseUrl: string;\n  fetch?: typeof fetch;\n  headers?: () => HeadersInit | Promise<HeadersInit>;\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}: 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) throw await mapError(url, res);\n      return schema.parse(await res.json());\n    },\n  };\n}\n","import {\n  adminOrderDetailSchema,\n  adminOrderPageSchema,\n  adminProductPageSchema,\n  adminProductSchema,\n  shippingRateSchema,\n  type AdminOrderDetail,\n  type AdminOrderListQuery,\n  type AdminOrderPage,\n  type AdminProduct,\n  type AdminProductListQuery,\n  type AdminProductPage,\n  type AdminProductInput,\n  type AdminProductPatch,\n  type RefundOrderInput,\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' | 'stock' | 'q' | 'cursor' | 'limit'\n>;\n\nexport interface RefundOptions {\n  idempotencyKey?: string;\n}\n\nexport interface AdminClient {\n  listProducts(query?: AdminProductQuery): Promise<AdminProductPage>;\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  deleteProductImage(id: string, imageId: string): Promise<AdminProduct>;\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 rates = shippingRateSchema.array();\n\n  return {\n    listProducts: (query = {}) =>\n      request(`/admin/products${queryString(query)}`, adminProductPageSchema),\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    deleteProductImage: (id, imageId) =>\n      request(`/admin/products/${enc(id)}/images/${enc(imageId)}`, product, {\n        method: 'DELETE',\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

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

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

@@ -0,0 +1,13 @@
+import { ReactNode } from 'react';
+export interface AdminColumn<T> {
+    key: string;
+    header: string;
+    render: (row: T) => ReactNode;
+}
+export interface AdminTableProps<T> {
+    columns: AdminColumn<T>[];
+    rows: T[];
+    rowKey: (row: T) => string;
+    caption?: string;
+}
+export declare function AdminTable<T>({ columns, rows, rowKey, caption, }: AdminTableProps<T>): import('react').JSX.Element;

package/dist/components/confirm-dialog/confirm-dialog.d.ts

@@ -0,0 +1,12 @@
+import { ReactNode } from 'react';
+export interface ConfirmDialogProps {
+    open: boolean;
+    title: string;
+    children?: ReactNode;
+    confirmLabel?: string;
+    destructive?: boolean;
+    pending?: boolean;
+    onConfirm: () => void;
+    onCancel: () => void;
+}
+export declare function ConfirmDialog({ open, title, children, confirmLabel, destructive, pending, onConfirm, onCancel, }: ConfirmDialogProps): import('react').JSX.Element | null;

package/dist/components/error-message/error-message.d.ts

@@ -0,0 +1,5 @@
+import { AdminErrorKey } from '../../lib/provider';
+export declare function errorKey(error: unknown): AdminErrorKey;
+export declare function ErrorMessage({ error }: {
+    error: unknown;
+}): import('react').JSX.Element | null;

package/dist/components/money/money.d.ts

@@ -0,0 +1,5 @@
+export interface MoneyProps {
+    cents: number;
+    currency: string;
+}
+export declare function Money({ cents, currency }: MoneyProps): import('react').JSX.Element;

package/dist/components/notice/notice.d.ts

@@ -0,0 +1,9 @@
+import { ReactNode } from 'react';
+export interface NoticeProps {
+    variant: 'success' | 'error' | 'warning';
+    children: ReactNode;
+    toast?: boolean;
+    duration?: number;
+    onDismiss?: () => void;
+}
+export declare function Notice({ variant, children, toast, duration, onDismiss, }: NoticeProps): import('react').JSX.Element;

package/dist/components/status-badge/status-badge.d.ts

@@ -0,0 +1,3 @@
+export declare function StatusBadge({ status }: {
+    status: string;
+}): import('react').JSX.Element;

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export * from './lib/provider';
+export * from './lib/use-admin-query';
+export * from './lib/use-admin-mutation';
+export * from './components/admin-layout/admin-layout';
+export * from './components/admin-table/admin-table';
+export * from './components/status-badge/status-badge';
+export * from './components/money/money';
+export * from './components/confirm-dialog/confirm-dialog';
+export * from './components/notice/notice';
+export * from './components/error-message/error-message';
+export type { AdminClient } from './client';
+export * from './views/products/admin-product-list';
+export * from './views/products/admin-product-editor';
+export * from './views/products/admin-product-images';
+export type { ImageLabels } from './lib/image-labels';
+export type { ProductLabels, ProductFilter } from './lib/product-labels';
+export { parseMoneyInput, formatMoneyInput } from './lib/money-input';
+export * from './views/orders/admin-order-list';
+export * from './views/orders/admin-order-detail';
+export type { OrderLabels, OrderTab } from './lib/order-labels';
+export * from './views/orders/order-actions';
+export type { OrderActionLabels } from './lib/order-action-labels';
+export * from './views/shipping/admin-shipping-rates';
+export type { ShippingLabels } from './lib/shipping-labels';