kempo-commerce 0.1.0 → 0.1.2

package/public/components/checkoutSections.js

@@ -1,76 +1,76 @@
-/*
-  How another extension puts something on the checkout page, served at /commerce/components/checkoutSections.js.
-
-  The left side of the checkout is an accordion, one panel open at a time. Contact, billing, credits and payment
-  are the checkout's own panels. An extension adds a panel of its own, such as a shipping address, or puts an
-  element under the order summary:
-
-  ```javascript
-  import { registerCheckoutSection } from '/commerce/components/checkoutSections.js';
-
-  const TAG = 'k-shipping-address';
-  customElements.define(TAG, ShippingAddress);
-  registerCheckoutSection(TAG, { title: 'Shipping address', priority: 300 });
-  ```
-
-  Options:
-
-    title       the panel's heading (required for a panel)
-    priority    where the panel goes, highest first. The checkout's own are contact 500, billing 400,
-                credits 200 and payment 100, so 300 lands between billing and credits
-    id          names the panel (default: the tag). contact, billing, credits and payment are reserved
-    where       'panel' (default) for an accordion panel, or 'summary' for an element under the order
-                summary, above the button that places the order
-
-  The checkout opens a panel while it is not done and closes it once it is, and opens the next panel when one
-  becomes done. An element says when its panel is done with a `complete` property (`get complete(){ ... }`,
-  true when the customer has filled in what it asks for). The checkout looks again only when something on the
-  page changes, so an element calls `checkout.setData(key, value)` whenever what it holds changes, which is
-  what makes the checkout look at it. Without a `complete`, its panel stays as the customer left it.
-
-  Each element is created by the checkout and handed `checkout`: the page itself. What it can use:
-
-    checkout.quote        the server's current answer (cart, totals, tenders, plan). A Lit element is asked to
-                          draw again whenever the checkout does, so it can read this in `render`
-    checkout.form         the contact and billing details typed so far
-    checkout.reprice()    asks the server for the totals again, which is what an element calls after it
-                          changed something the totals depend on (it applied a coupon to the cart)
-    checkout.setData(key, value)   a value sent with the order as `data`, which the `checkout:validate` guard
-                          on the server receives
-
-  An element can also keep the order from being placed with a `blocker` property (`get blocker(){ ... }`): a sentence for
-  the customer saying why, or '' when nothing stops it. While it is not empty the button is disabled and the sentence is
-  shown under it. The server must refuse the order too (in `checkout:validate`), as this is only the page being clear.
-
-  The server side of a section is the extension's own: money it takes off goes through the cart's
-  adjustments, and what it needs to check goes in the `checkout:validate` guard.
-
-  The registry lives in this module, so every script that imports it shares one.
-*/
-
-const RESERVED = ['contact', 'billing', 'credits', 'payment'];
-
-const sections = new Map();
-
-const changed = () => window.dispatchEvent(new CustomEvent('checkout-sections-changed'));
-
-export const registerCheckoutSection = (tag, { id = tag, title = '', priority = 0, where = 'panel' } = {}) => {
-  if(typeof tag !== 'string' || !tag.includes('-')) throw new Error('A checkout section is a custom element tag, such as k-shipping-address');
-  if(!['panel', 'summary'].includes(where)) throw new Error('A checkout section goes in a "panel" or in the "summary"');
-  if(where === 'panel' && !title) throw new Error('A checkout panel needs a title');
-  if(where === 'panel' && RESERVED.includes(id)) throw new Error(`"${id}" is the checkout's own panel; choose another id`);
-  if(where === 'panel' && [...sections.values()].some(section => section.where === 'panel' && section.id === id && section.tag !== tag)){
-    throw new Error(`Another checkout panel already has the id "${id}"`);
-  }
-  sections.set(tag, { tag, id, title, priority, where });
-  changed();
-};
-
-export const unregisterCheckoutSection = tag => {
-  if(sections.delete(tag)) changed();
-};
-
-/* The registered sections for a place (`panel` or `summary`), highest priority first. */
-export const checkoutSections = where => [...sections.values()]
-  .filter(section => section.where === where)
-  .sort((a, b) => b.priority - a.priority || a.tag.localeCompare(b.tag));
+/*
+  How another extension puts something on the checkout page, served at /commerce/components/checkoutSections.js.
+
+  The left side of the checkout is an accordion, one panel open at a time. Contact, billing, credits and payment
+  are the checkout's own panels. An extension adds a panel of its own, such as a shipping address, or puts an
+  element under the order summary:
+
+  ```javascript
+  import { registerCheckoutSection } from '/commerce/components/checkoutSections.js';
+
+  const TAG = 'k-shipping-address';
+  customElements.define(TAG, ShippingAddress);
+  registerCheckoutSection(TAG, { title: 'Shipping address', priority: 300 });
+  ```
+
+  Options:
+
+    title       the panel's heading (required for a panel)
+    priority    where the panel goes, highest first. The checkout's own are contact 500, billing 400,
+                credits 200 and payment 100, so 300 lands between billing and credits
+    id          names the panel (default: the tag). contact, billing, credits and payment are reserved
+    where       'panel' (default) for an accordion panel, or 'summary' for an element under the order
+                summary, above the button that places the order
+
+  The checkout opens a panel while it is not done and closes it once it is, and opens the next panel when one
+  becomes done. An element says when its panel is done with a `complete` property (`get complete(){ ... }`,
+  true when the customer has filled in what it asks for). The checkout looks again only when something on the
+  page changes, so an element calls `checkout.setData(key, value)` whenever what it holds changes, which is
+  what makes the checkout look at it. Without a `complete`, its panel stays as the customer left it.
+
+  Each element is created by the checkout and handed `checkout`: the page itself. What it can use:
+
+    checkout.quote        the server's current answer (cart, totals, tenders, plan). A Lit element is asked to
+                          draw again whenever the checkout does, so it can read this in `render`
+    checkout.form         the contact and billing details typed so far
+    checkout.reprice()    asks the server for the totals again, which is what an element calls after it
+                          changed something the totals depend on (it applied a coupon to the cart)
+    checkout.setData(key, value)   a value sent with the order as `data`, which the `checkout:validate` guard
+                          on the server receives
+
+  An element can also keep the order from being placed with a `blocker` property (`get blocker(){ ... }`): a sentence for
+  the customer saying why, or '' when nothing stops it. While it is not empty the button is disabled and the sentence is
+  shown under it. The server must refuse the order too (in `checkout:validate`), as this is only the page being clear.
+
+  The server side of a section is the extension's own: money it takes off goes through the cart's
+  adjustments, and what it needs to check goes in the `checkout:validate` guard.
+
+  The registry lives in this module, so every script that imports it shares one.
+*/
+
+const RESERVED = ['contact', 'billing', 'credits', 'payment'];
+
+const sections = new Map();
+
+const changed = () => window.dispatchEvent(new CustomEvent('checkout-sections-changed'));
+
+export const registerCheckoutSection = (tag, { id = tag, title = '', priority = 0, where = 'panel' } = {}) => {
+  if(typeof tag !== 'string' || !tag.includes('-')) throw new Error('A checkout section is a custom element tag, such as k-shipping-address');
+  if(!['panel', 'summary'].includes(where)) throw new Error('A checkout section goes in a "panel" or in the "summary"');
+  if(where === 'panel' && !title) throw new Error('A checkout panel needs a title');
+  if(where === 'panel' && RESERVED.includes(id)) throw new Error(`"${id}" is the checkout's own panel; choose another id`);
+  if(where === 'panel' && [...sections.values()].some(section => section.where === 'panel' && section.id === id && section.tag !== tag)){
+    throw new Error(`Another checkout panel already has the id "${id}"`);
+  }
+  sections.set(tag, { tag, id, title, priority, where });
+  changed();
+};
+
+export const unregisterCheckoutSection = tag => {
+  if(sections.delete(tag)) changed();
+};
+
+/* The registered sections for a place (`panel` or `summary`), highest priority first. */
+export const checkoutSections = where => [...sections.values()]
+  .filter(section => section.where === where)
+  .sort((a, b) => b.priority - a.priority || a.tag.localeCompare(b.tag));

package/public/sdk.js

@@ -1,130 +1,130 @@
-/*
-  Browser client, served at /commerce/sdk.js.
-
-  Every call returns an `[error, data]` tuple like the rest of kempo. An error carries the extra fields
-  a route sent with it — the `notices` that block a cart, the real `totals` when the total changed,
-  `account` rules, `retryAfter` — so a page can say something more useful than "no".
-
-  The browser names a product and a quantity, never a price: every amount comes from the server.
-
-  When anything changes the cart, call `announceCartChanged(source, cart)`. It fires a bubbling,
-  composed `cart-changed` event from `source` (the mini-cart, the cart button and the cart page all
-  listen) and tells the other tabs through a BroadcastChannel, so a cart open in two tabs never shows
-  two different things. Methods cause actions; events only say that something happened.
-*/
-
-const BASE = '/commerce/api';
-
-const request = async (path, options = {}) => {
-  try {
-    const response = await fetch(`${BASE}${path}`, { credentials: 'same-origin', ...options });
-    const data = await response.json().catch(() => ({}));
-    if(!response.ok){
-      const { error, ...details } = data;
-      return [{ code: response.status, msg: error || response.statusText, ...details }, null];
-    }
-    return [null, data];
-  } catch(error) {
-    return [{ code: 0, msg: error.message }, null];
-  }
-};
-
-const send = (method, body) => ({
-  method,
-  headers: { 'Content-Type': 'application/json' },
-  body: JSON.stringify(body ?? {}),
-});
-
-const query = params => {
-  const search = new URLSearchParams();
-  for(const [name, value] of Object.entries(params || {})){
-    if(value !== undefined && value !== null && value !== '') search.set(name, value);
-  }
-  const string = search.toString();
-  return string ? `?${string}` : '';
-};
-
-/*
-  An id for one checkout, sent as its idempotency key so a double click, a reload or a second tab
-  places the order once. A page keeps it for as long as the same checkout is going on.
-*/
-export const newKey = () => crypto.randomUUID();
-
-/*
-  Cart
-*/
-
-export const getConfig = () => request('/config');
-export const getRegions = () => request('/regions');
-export const getCart = () => request('/cart');
-export const addToCart = ({ productId, quantity = 1, selections = {}, data = {} }) => request('/cart/lines', send('POST', { productId, quantity, selections, data }));
-export const updateLine = (lineId, quantity) => request(`/cart/lines/${encodeURIComponent(lineId)}`, send('PATCH', { quantity }));
-export const removeLine = lineId => request(`/cart/lines/${encodeURIComponent(lineId)}`, { method: 'DELETE' });
-export const clearCart = () => request('/cart', { method: 'DELETE' });
-
-/*
-  Checkout
-*/
-
-export const startCheckout = () => request('/checkout');
-export const validateCheckout = ({ billing, data, tenders }) => request('/checkout/validate', send('POST', { billing, data, tenders }));
-export const placeOrder = ({ checkoutKey, billing, data, tenders, account, expectedTotal }) => request('/checkout/place', send('POST', { checkoutKey, billing, data, tenders, account, expectedTotal }));
-
-/* Asks the server to check with the processor: the browser's word that a payment worked is never believed. */
-export const confirmPayment = (orderId, key) => request(`/checkout/orders/${encodeURIComponent(orderId)}/confirm`, send('POST', { key }));
-
-/*
-  Orders
-*/
-
-export const getMyOrders = (params = {}) => request(`/my/orders${query(params)}`);
-export const getMyOrder = id => request(`/my/orders/${encodeURIComponent(id)}`);
-export const cancelOrder = id => request(`/my/orders/${encodeURIComponent(id)}/cancel`, send('POST'));
-
-/* A guest's order, reached with the key in their link. */
-export const getOrderByKey = (id, key) => request(`/orders/${encodeURIComponent(id)}/guest${query({ key })}`);
-export const cancelOrderByKey = (id, key) => request(`/orders/${encodeURIComponent(id)}/guest/cancel`, send('POST', { key }));
-
-/*
-  The shop's side (each needs its own permission)
-*/
-
-export const listOrders = (params = {}) => request(`/orders${query(params)}`);
-export const getOrder = id => request(`/orders/${encodeURIComponent(id)}`);
-export const setOrderStatus = (id, status, note) => request(`/orders/${encodeURIComponent(id)}/status`, send('PATCH', { status, note }));
-export const addNote = (id, body, visibleToCustomer) => request(`/orders/${encodeURIComponent(id)}/notes`, send('POST', { body, visibleToCustomer }));
-export const contactCustomer = (id, subject, body) => request(`/orders/${encodeURIComponent(id)}/contact`, send('POST', { subject, body }));
-export const setFulfillment = (id, lineId, fulfillment) => request(`/orders/${encodeURIComponent(id)}/lines/${encodeURIComponent(lineId)}`, send('PATCH', { fulfillment }));
-export const cancelUnpaid = (id, reason) => request(`/orders/${encodeURIComponent(id)}/cancel`, send('POST', { reason }));
-export const markPaid = (id, note) => request(`/orders/${encodeURIComponent(id)}/mark-paid`, send('POST', { note }));
-export const previewRefund = options => request('/refunds/preview', send('POST', options));
-export const refundOrder = (id, options) => request(`/orders/${encodeURIComponent(id)}/refund`, send('POST', options));
-export const finishRefund = refundId => request(`/refunds/${encodeURIComponent(refundId)}/finish`, send('POST'));
-export const listCarts = (params = {}) => request(`/carts${query(params)}`);
-export const getSummary = () => request('/summary');
-export const getSettings = () => request('/settings');
-export const saveSettings = values => request('/settings', send('PUT', values));
-
-/*
-  Telling everyone the cart changed
-*/
-
-const CHANNEL = 'kempo-commerce-cart';
-const channel = 'BroadcastChannel' in window ? new BroadcastChannel(CHANNEL) : null;
-
-export const announceCartChanged = (source, cart) => {
-  (source || window).dispatchEvent(new CustomEvent('cart-changed', { detail: { cart }, bubbles: true, composed: true }));
-  channel?.postMessage({ type: 'cart-changed' });
-};
-
-/* Runs `callback` when the cart changed in this tab (any component) or another. Returns a function that stops listening. */
-export const onCartChanged = callback => {
-  const here = event => callback(event.detail?.cart ?? null);
-  const elsewhere = () => callback(null);
-  window.addEventListener('cart-changed', here);
-  channel?.addEventListener('message', elsewhere);
-  return () => {
-    window.removeEventListener('cart-changed', here);
-    channel?.removeEventListener('message', elsewhere);
-  };
-};
+/*
+  Browser client, served at /commerce/sdk.js.
+
+  Every call returns an `[error, data]` tuple like the rest of kempo. An error carries the extra fields
+  a route sent with it — the `notices` that block a cart, the real `totals` when the total changed,
+  `account` rules, `retryAfter` — so a page can say something more useful than "no".
+
+  The browser names a product and a quantity, never a price: every amount comes from the server.
+
+  When anything changes the cart, call `announceCartChanged(source, cart)`. It fires a bubbling,
+  composed `cart-changed` event from `source` (the mini-cart, the cart button and the cart page all
+  listen) and tells the other tabs through a BroadcastChannel, so a cart open in two tabs never shows
+  two different things. Methods cause actions; events only say that something happened.
+*/
+
+const BASE = '/commerce/api';
+
+const request = async (path, options = {}) => {
+  try {
+    const response = await fetch(`${BASE}${path}`, { credentials: 'same-origin', ...options });
+    const data = await response.json().catch(() => ({}));
+    if(!response.ok){
+      const { error, ...details } = data;
+      return [{ code: response.status, msg: error || response.statusText, ...details }, null];
+    }
+    return [null, data];
+  } catch(error) {
+    return [{ code: 0, msg: error.message }, null];
+  }
+};
+
+const send = (method, body) => ({
+  method,
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify(body ?? {}),
+});
+
+const query = params => {
+  const search = new URLSearchParams();
+  for(const [name, value] of Object.entries(params || {})){
+    if(value !== undefined && value !== null && value !== '') search.set(name, value);
+  }
+  const string = search.toString();
+  return string ? `?${string}` : '';
+};
+
+/*
+  An id for one checkout, sent as its idempotency key so a double click, a reload or a second tab
+  places the order once. A page keeps it for as long as the same checkout is going on.
+*/
+export const newKey = () => crypto.randomUUID();
+
+/*
+  Cart
+*/
+
+export const getConfig = () => request('/config');
+export const getRegions = () => request('/regions');
+export const getCart = () => request('/cart');
+export const addToCart = ({ productId, quantity = 1, selections = {}, data = {} }) => request('/cart/lines', send('POST', { productId, quantity, selections, data }));
+export const updateLine = (lineId, quantity) => request(`/cart/lines/${encodeURIComponent(lineId)}`, send('PATCH', { quantity }));
+export const removeLine = lineId => request(`/cart/lines/${encodeURIComponent(lineId)}`, { method: 'DELETE' });
+export const clearCart = () => request('/cart', { method: 'DELETE' });
+
+/*
+  Checkout
+*/
+
+export const startCheckout = () => request('/checkout');
+export const validateCheckout = ({ billing, data, tenders }) => request('/checkout/validate', send('POST', { billing, data, tenders }));
+export const placeOrder = ({ checkoutKey, billing, data, tenders, account, expectedTotal }) => request('/checkout/place', send('POST', { checkoutKey, billing, data, tenders, account, expectedTotal }));
+
+/* Asks the server to check with the processor: the browser's word that a payment worked is never believed. */
+export const confirmPayment = (orderId, key) => request(`/checkout/orders/${encodeURIComponent(orderId)}/confirm`, send('POST', { key }));
+
+/*
+  Orders
+*/
+
+export const getMyOrders = (params = {}) => request(`/my/orders${query(params)}`);
+export const getMyOrder = id => request(`/my/orders/${encodeURIComponent(id)}`);
+export const cancelOrder = id => request(`/my/orders/${encodeURIComponent(id)}/cancel`, send('POST'));
+
+/* A guest's order, reached with the key in their link. */
+export const getOrderByKey = (id, key) => request(`/orders/${encodeURIComponent(id)}/guest${query({ key })}`);
+export const cancelOrderByKey = (id, key) => request(`/orders/${encodeURIComponent(id)}/guest/cancel`, send('POST', { key }));
+
+/*
+  The shop's side (each needs its own permission)
+*/
+
+export const listOrders = (params = {}) => request(`/orders${query(params)}`);
+export const getOrder = id => request(`/orders/${encodeURIComponent(id)}`);
+export const setOrderStatus = (id, status, note) => request(`/orders/${encodeURIComponent(id)}/status`, send('PATCH', { status, note }));
+export const addNote = (id, body, visibleToCustomer) => request(`/orders/${encodeURIComponent(id)}/notes`, send('POST', { body, visibleToCustomer }));
+export const contactCustomer = (id, subject, body) => request(`/orders/${encodeURIComponent(id)}/contact`, send('POST', { subject, body }));
+export const setFulfillment = (id, lineId, fulfillment) => request(`/orders/${encodeURIComponent(id)}/lines/${encodeURIComponent(lineId)}`, send('PATCH', { fulfillment }));
+export const cancelUnpaid = (id, reason) => request(`/orders/${encodeURIComponent(id)}/cancel`, send('POST', { reason }));
+export const markPaid = (id, note) => request(`/orders/${encodeURIComponent(id)}/mark-paid`, send('POST', { note }));
+export const previewRefund = options => request('/refunds/preview', send('POST', options));
+export const refundOrder = (id, options) => request(`/orders/${encodeURIComponent(id)}/refund`, send('POST', options));
+export const finishRefund = refundId => request(`/refunds/${encodeURIComponent(refundId)}/finish`, send('POST'));
+export const listCarts = (params = {}) => request(`/carts${query(params)}`);
+export const getSummary = () => request('/summary');
+export const getSettings = () => request('/settings');
+export const saveSettings = values => request('/settings', send('PUT', values));
+
+/*
+  Telling everyone the cart changed
+*/
+
+const CHANNEL = 'kempo-commerce-cart';
+const channel = 'BroadcastChannel' in window ? new BroadcastChannel(CHANNEL) : null;
+
+export const announceCartChanged = (source, cart) => {
+  (source || window).dispatchEvent(new CustomEvent('cart-changed', { detail: { cart }, bubbles: true, composed: true }));
+  channel?.postMessage({ type: 'cart-changed' });
+};
+
+/* Runs `callback` when the cart changed in this tab (any component) or another. Returns a function that stops listening. */
+export const onCartChanged = callback => {
+  const here = event => callback(event.detail?.cart ?? null);
+  const elsewhere = () => callback(null);
+  window.addEventListener('cart-changed', here);
+  channel?.addEventListener('message', elsewhere);
+  return () => {
+    window.removeEventListener('cart-changed', here);
+    channel?.removeEventListener('message', elsewhere);
+  };
+};

package/sdk.js

@@ -1,66 +1,66 @@
-/*
-  Server-side entry point — what shipping, coupons, digital delivery and every other extension that
-  builds on a store imports.
-
-  ```js
-  import { getCart, addToCart, placeOrder, getOrder, setLineFulfillment, registerTender } from 'kempo-commerce/sdk';
-
-  // Something was shipped: mark the line, and the order completes when no line is waiting.
-  await setLineFulfillment(order.id, line.id, 'done', { actor: 'kempo-shipping', data: { shipmentId } });
-  ```
-
-  Every function returns `[error, data]` with `error = { code, msg }`, and none throws. These are data
-  operations with **no permission checks of their own**: the routes under public/api decide who may
-  do what, and anything calling in here is server-side code that has already decided it is allowed.
-  Everything that changes an order takes an optional `{ actor }` (your extension's name), which is
-  written to the order's history.
-
-  Extending checkout is done with hooks (see README.md for every one): `cart:before_add` to refuse or
-  change an add, `totals:fees` to add shipping, `checkout:fields` and `checkout:validate` to collect
-  and check a delivery address, `checkout:tenders` to offer a way to pay, `order:paid` to do the work
-  once money has arrived, `order:line_fulfillment` to say which lines need sending, `refund:issued` to
-  put things back.
-
-  The model is WooCommerce's: carts for visitors and customers, an order with a status and a history,
-  guest checkout, and refunds issued by an administrator. Discounts, coupons, shipping, categories and
-  the catalog itself are other extensions' business.
-*/
-
-export {
-  resolveCart,
-  getCart,
-  addToCart,
-  updateCartLine,
-  removeCartLine,
-  clearCart,
-  mergeCarts,
-  setCartData,
-  listCarts,
-} from './server/utils/carts/cart.js';
-
-export { computeTotals, collectAdjustments } from './server/utils/totals.js';
-export { resolveUnitDiscounts, resolveDiscountRows } from './server/utils/discounts.js';
-
-export { startCheckout, accountRules } from './server/utils/checkout/quote.js';
-export { placeOrder } from './server/utils/checkout/place.js';
-export { completeOrder, markPaid } from './server/utils/checkout/complete.js';
-export { failOrder, cancelUnpaidOrder } from './server/utils/checkout/unwind.js';
-export { registerTender, unregisterTender, listTenders, getTender } from './server/utils/checkout/tenders.js';
-
-export { getOrder, getOrderByKey, listOrders, forCustomer, STATUSES as orderStatuses } from './server/utils/orders/read.js';
-export { setOrderStatus } from './server/utils/orders/status.js';
-export { setLineFulfillment } from './server/utils/orders/fulfillment.js';
-export { addOrderNote } from './server/utils/orders/notes.js';
-export { setOrderData, addOrderEvent } from './server/utils/orders/data.js';
-export { contactCustomer } from './server/utils/orders/contact.js';
-export { getOrderEvents } from './server/utils/orders/events.js';
-export { linkGuestOrders } from './server/utils/orders/link.js';
-export { formatOrderNumber } from './server/utils/orders/number.js';
-export { sendOrderEmail } from './server/utils/orders/emails.js';
-
-export { readConfig, publicConfig, OWNER } from './server/utils/config/settings.js';
-export { EVENTS } from './server/utils/events.js';
-export { runSweep } from './server/utils/sweeps.js';
-
-export { previewRefund } from './server/utils/refunds/preview.js';
-export { refundOrder, finishRefund, getRefund } from './server/utils/refunds/issue.js';
+/*
+  Server-side entry point — what shipping, coupons, digital delivery and every other extension that
+  builds on a store imports.
+
+  ```js
+  import { getCart, addToCart, placeOrder, getOrder, setLineFulfillment, registerTender } from 'kempo-commerce/sdk';
+
+  // Something was shipped: mark the line, and the order completes when no line is waiting.
+  await setLineFulfillment(order.id, line.id, 'done', { actor: 'kempo-shipping', data: { shipmentId } });
+  ```
+
+  Every function returns `[error, data]` with `error = { code, msg }`, and none throws. These are data
+  operations with **no permission checks of their own**: the routes under public/api decide who may
+  do what, and anything calling in here is server-side code that has already decided it is allowed.
+  Everything that changes an order takes an optional `{ actor }` (your extension's name), which is
+  written to the order's history.
+
+  Extending checkout is done with hooks (see README.md for every one): `cart:before_add` to refuse or
+  change an add, `totals:fees` to add shipping, `checkout:fields` and `checkout:validate` to collect
+  and check a delivery address, `checkout:tenders` to offer a way to pay, `order:paid` to do the work
+  once money has arrived, `order:line_fulfillment` to say which lines need sending, `refund:issued` to
+  put things back.
+
+  The model is WooCommerce's: carts for visitors and customers, an order with a status and a history,
+  guest checkout, and refunds issued by an administrator. Discounts, coupons, shipping, categories and
+  the catalog itself are other extensions' business.
+*/
+
+export {
+  resolveCart,
+  getCart,
+  addToCart,
+  updateCartLine,
+  removeCartLine,
+  clearCart,
+  mergeCarts,
+  setCartData,
+  listCarts,
+} from './server/utils/carts/cart.js';
+
+export { computeTotals, collectAdjustments } from './server/utils/totals.js';
+export { resolveUnitDiscounts, resolveDiscountRows } from './server/utils/discounts.js';
+
+export { startCheckout, accountRules } from './server/utils/checkout/quote.js';
+export { placeOrder } from './server/utils/checkout/place.js';
+export { completeOrder, markPaid } from './server/utils/checkout/complete.js';
+export { failOrder, cancelUnpaidOrder } from './server/utils/checkout/unwind.js';
+export { registerTender, unregisterTender, listTenders, getTender } from './server/utils/checkout/tenders.js';
+
+export { getOrder, getOrderByKey, listOrders, forCustomer, STATUSES as orderStatuses } from './server/utils/orders/read.js';
+export { setOrderStatus } from './server/utils/orders/status.js';
+export { setLineFulfillment } from './server/utils/orders/fulfillment.js';
+export { addOrderNote } from './server/utils/orders/notes.js';
+export { setOrderData, addOrderEvent } from './server/utils/orders/data.js';
+export { contactCustomer } from './server/utils/orders/contact.js';
+export { getOrderEvents } from './server/utils/orders/events.js';
+export { linkGuestOrders } from './server/utils/orders/link.js';
+export { formatOrderNumber } from './server/utils/orders/number.js';
+export { sendOrderEmail } from './server/utils/orders/emails.js';
+
+export { readConfig, publicConfig, OWNER } from './server/utils/config/settings.js';
+export { EVENTS } from './server/utils/events.js';
+export { runSweep } from './server/utils/sweeps.js';
+
+export { previewRefund } from './server/utils/refunds/preview.js';
+export { refundOrder, finishRefund, getRefund } from './server/utils/refunds/issue.js';