@aglyn/plugins-commerce 1.0.0-beta.143

package/src/lib/model/commerce.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/commerce.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { nameSearchFields } from '@aglyn/aglyn/app-utils/name-search'\n\n/**\n * Commerce catalog v1 (AGL-276): products with options/variants,\n * hierarchical categories, tags, and manual/smart collections. Pure\n * model + helpers — no I/O; the products hub and storefront APIs operate\n * over these shapes. Documents live under `hosts/{hostId}/products`,\n * `.../productCategories`, and `.../collections`; the legacy Commerce\n * Starter product doc (AGL-90: name/priceUsd/inventory) lifts into this\n * shape via `liftLegacyProduct`, so existing docs keep working.\n */\n\n/*\n * THERE IS NO STOREFRONT FEE CONSTANT, and that absence is load-bearing\n * (AGL-2295).\n *\n * `COMMERCE_PLATFORM_FEE_PERCENT = 2` lived here with ZERO call sites. It\n * asserted a flat 2% that agrees with the plan table for exactly one cell\n * (Starter, physical) and disagrees with the other fifteen — Starter digital\n * is 5%, Pro digital 3%, Business 2%, Scale 1%, and every physical rate above\n * Starter is 0%. Nothing was wrong while nothing read it; the cost was that\n * the next reader wiring it up would silently re-price every plan, and a\n * constant sitting in the model beside the types reads like the answer.\n *\n * The single source is `resolveTransactionFeePct(org, productType)` in\n * `plan-entitlements.ts`, resolved PER REQUEST from the org — because it\n * depends on the plan, on per-org staff overrides, and on whether the\n * subscription is still alive. A constant cannot express any of that.\n * `commerce-fee-single-source.spec.ts` fails the build if one comes back.\n */\n/** Product price ceiling (whole USD). */\nexport const COMMERCE_MAX_PRICE_USD = 10000\n\nexport type ProductType = 'physical' | 'digital' | 'service'\nexport type ProductStatus = 'draft' | 'active' | 'archived'\n\n/** One axis of variation, e.g. { name: 'Size', values: ['S','M','L'] }. */\nexport interface ProductOption {\n  name: string\n  values: string[]\n}\n\n/** A sellable configuration of a product (every product has ≥ 1). */\nexport interface ProductVariant {\n  /** Stable id unique within the product (never reused after delete). */\n  id: string\n  /** Option selections keyed by option name; {} for the default variant. */\n  options?: Record<string, string>\n  sku?: string\n  barcode?: string\n  priceUsd: number\n  /** Strike-through price; a sale badge shows when > priceUsd. */\n  compareAtPriceUsd?: number\n  weightGrams?: number\n  /** null/undefined = untracked; 0 = sold out (matches AGL-96). */\n  inventory?: number | null\n  /**\n   * Per-location stock (AGL-286); `inventory` stays the summed\n   * denormalization. Absent = single default location.\n   */\n  inventoryByLocation?: Record<string, number>\n  /** Media-library image URL shown when this variant is selected. */\n  imageUrl?: string\n}\n\n/** `hosts/{hostId}/locations/{id}` doc (AGL-286). */\nexport interface InventoryLocation {\n  name: string\n  isDefault?: boolean\n  address?: string\n}\n\n/**\n * `hosts/{hostId}/registers/{id}` doc (AGL-472): a named point-of-sale\n * register. Creation is capped by the plan's `posRegisters` quota (Pro 1,\n * Business 2, Advanced 5; raised by a per-org entitlement override for the\n * $89/mo add-on), enforced server-side by the resources route. Each POS\n * sale stamps its `registerId` so takings are attributable per register.\n */\nexport interface PosRegister {\n  name: string\n  /** Optional default inventory location this register sells from. */\n  locationId?: string\n}\n\n/**\n * The register ids within the plan's `posRegisters` cap (AGL-482), ranked\n * by creation order — the same ordering `pos-order.ts` enforces at sale\n * time. Registers beyond the cap (e.g. after a Business→Pro downgrade) are\n * excluded so the console/POS can dim or hide them instead of surfacing a\n * checkout 403. `cap` of `Infinity` returns all.\n */\nexport function registersWithinCap(\n  registers: Array<{ $id: string; createdAt?: any }>,\n  cap: number,\n): Set<string> {\n  const createdMs = (r: { createdAt?: any }) =>\n    r.createdAt?.toMillis?.() ?? r.createdAt?.seconds ?? 0\n  const ranked = [...registers].sort(\n    (a, b) => createdMs(a) - createdMs(b) || a.$id.localeCompare(b.$id),\n  )\n  return new Set(ranked.slice(0, Math.max(0, cap)).map((r) => r.$id))\n}\n\n/**\n * `hosts/{hostId}/suppliers/{id}` doc (AGL-289): where dropshipped\n * order lines route on payment. Email and webhook are both optional but\n * one must be set for routing to do anything; webhook payloads are\n * HMAC-SHA256-signed with `webhookSecret`.\n */\nexport interface HostSupplier {\n  name: string\n  email?: string\n  webhookUrl?: string\n  webhookSecret?: string\n}\n\n/** `hosts/{hostId}/products/{id}` doc. */\nexport interface HostProduct {\n  name: string\n  /** Host-unique URL segment for /products/{slug}. */\n  slug: string\n  description?: string\n  type: ProductType\n  status: ProductStatus\n  /** Ordered media-library image URLs (first = primary). */\n  mediaUrls?: string[]\n  categoryIds?: string[]\n  tags?: string[]\n  options?: ProductOption[]\n  variants: ProductVariant[]\n  /** Per-product overrides for PDP meta tags (AGL-299 consumes). */\n  seo?: { title?: string; description?: string; imageUrl?: string }\n  /** Supplier for dropship routing (AGL-289). */\n  supplierId?: string\n  /** Out-of-stock behavior (AGL-281): deny (default) or allow backorder. */\n  oversellPolicy?: 'deny' | 'backorder'\n  /** Never taxed regardless of tax settings (AGL-285). */\n  taxExempt?: boolean\n  /**\n   * Digital delivery (AGL-302): downloadable files for `digital`\n   * products. Buyers always download the CURRENT list, so uploading a\n   * new version re-delivers to everyone.\n   */\n  digitalFiles?: Array<{ url: string; fileName: string; version?: string }>\n  /** Max download attempts per order line; absent = unlimited. */\n  downloadLimit?: number\n  /**\n   * Recurring billing (AGL-303): buyers subscribe instead of buying\n   * once; an active subscription is the entitlement content gating\n   * checks (AGL-309).\n   */\n  subscription?: { interval: 'month' | 'year'; trialDays?: number }\n  /**\n   * Buyer-chosen billing (AGL-545): with `subscription` set, true lets\n   * the buyer pick one-time OR subscribe on the PDP (default one-time);\n   * absent/false keeps the product subscription-only.\n   */\n  subscriptionOptional?: boolean\n  /** Members-only videos (AGL-315), streamed via short-TTL links. */\n  gatedVideos?: Array<{ url: string; title?: string }>\n  /** Manual related products for the upsell block (AGL-325). */\n  relatedProductIds?: string[]\n  /** Buying this issues a gift-card code for its price (AGL-322). */\n  giftCard?: boolean\n  /** Tracked-total at/below this alerts host managers (AGL-281). */\n  lowStockThreshold?: number\n  createdAtMs?: number\n  updatedAtMs?: number\n  deletedAt?: number | null\n  /** Legacy Commerce Starter fields kept so old docs read back (AGL-90). */\n  priceUsd?: number\n  inventory?: number | null\n  imageUrl?: string\n}\n\n/** `hosts/{hostId}/productCategories/{id}` doc (tree via parentId). */\nexport interface ProductCategory {\n  name: string\n  slug: string\n  parentId?: string | null\n  order?: number\n}\n\nexport type CollectionRuleField =\n  | 'tag'\n  | 'categoryId'\n  | 'priceUsd'\n  | 'name'\n  | 'type'\nexport type CollectionRuleOp = 'eq' | 'neq' | 'lt' | 'gt' | 'contains'\n\nexport interface CollectionRule {\n  field: CollectionRuleField\n  op: CollectionRuleOp\n  value: string | number\n}\n\n/** `hosts/{hostId}/collections/{id}` doc. */\nexport interface HostCollection {\n  name: string\n  slug: string\n  description?: string\n  mode: 'manual' | 'smart'\n  /** Manual mode: explicit ordered membership. */\n  productIds?: string[]\n  /** Smart mode: rules evaluated over active products. */\n  rules?: CollectionRule[]\n  /** Smart mode: true = every rule must match (default), false = any. */\n  matchAll?: boolean\n  /** Media-library image URL for the collection card/landing hero. */\n  imageUrl?: string\n  order?: number\n}\n\n/**\n * Payment-provider seam (AGL-284): checkout/session creation goes\n * through a provider id so PayPal (etc.) can slot in without reworking\n * callers. Stripe is the only implementation today; store settings\n * (AGL-295) will carry the selection when a second provider exists.\n */\nexport type PaymentProviderId = 'stripe'\n\nexport interface PaymentCheckoutRequest {\n  provider: PaymentProviderId\n  hostId: string\n  amountCents: number\n  feeCents: number\n  productName: string\n  successUrl: string\n  cancelUrl: string\n  metadata?: Record<string, string>\n}\n\n/** Variant ceiling per product (Shopify parity). */\nexport const COMMERCE_MAX_VARIANTS = 100\nexport const COMMERCE_MAX_OPTIONS = 3\nexport const COMMERCE_MAX_OPTION_VALUES = 25\nexport const COMMERCE_SLUG_MAX_LENGTH = 80\n\n/** Lowercase-kebab slug from a product/category/collection name. */\nexport function commerceSlug(name: string): string {\n  return String(name ?? '')\n    .normalize('NFKD')\n    .replace(/[̀-ͯ]/g, '')\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '')\n    .slice(0, COMMERCE_SLUG_MAX_LENGTH)\n}\n\n/**\n * The search keys a product write carries, so the catalog can be searched by\n * the QUERY rather than by the rows a listener happened to fetch (AGL-2501).\n *\n * The hub lists `limit(500)`, and the search compared what that returned — so\n * a product past the window answered \"no products match\", which reads as the\n * product not existing rather than as the search not reaching it. Filtering\n * server-side needs fields Firestore can index, and neither of the two things\n * a merchant searches by is one:\n *\n *   - A NAME needs case-insensitive contains, which Firestore has no operator\n *     for. `nameSearchFields` denormalizes it into the three shapes that are\n *     indexable — an exact key, word-prefix tokens for `array-contains`, and\n *     the key reversed so \"ends with\" becomes a prefix range.\n *   - A SKU lives inside `variants`, an array of OBJECTS, and Firestore cannot\n *     query a field inside one. Flattened here into a top-level array so a SKU\n *     is one `array-contains`.\n *\n * ⛔ A SKU therefore matches WHOLE, not as a substring: \"abc-123\" finds it and\n * \"123\" does not. That is the right way round for a SKU, which is a value\n * somebody copies rather than half-remembers — unlike a name, where the tokens\n * above buy word-prefix matching precisely because names are half-remembered.\n *\n * `barcodes` is the same flattening for the same reason, and it is the one the\n * register depends on: a keyboard-wedge scanner types the code and presses\n * Enter, so the lookup has to be exact and has to reach the whole catalog. A\n * scan is never a half-remembered value.\n *\n * Lower-cased because the translator lower-cases the typed query before it\n * builds the `array-contains`; stored and typed have to be normalized the same\n * way or the two silently disagree.\n *\n * ⚠️ Each array is OMITTED when a product has none, rather than written as\n * `[]`. `isNotEmpty` is served as `!= null`, and an empty array is not null —\n * so a product with no SKUs at all would answer \"has a SKU\" for every row.\n *\n * ⚠️ Spread this at EVERY write that sets a product's name or variants. A\n * write that sets the name without it leaves the keys describing the previous\n * name, and the product becomes findable only by what it used to be called.\n */\nexport function productSearchFields(product: {\n  name: string\n  variants?: ProductVariant[]\n}): {\n  name: string\n  nameLower: string\n  nameTokens: string[]\n  nameReversed: string\n  skus?: string[]\n  barcodes?: string[]\n} {\n  const flatten = (read: (variant: ProductVariant) => string | undefined) => [\n    ...new Set(\n      (product.variants ?? [])\n        .map((variant) => (read(variant) ?? '').trim().toLowerCase())\n        .filter(Boolean),\n    ),\n  ]\n  const skus = flatten((variant) => variant.sku)\n  const barcodes = flatten((variant) => variant.barcode)\n  return {\n    ...nameSearchFields(product.name),\n    ...(skus.length ? { skus } : {}),\n    ...(barcodes.length ? { barcodes } : {}),\n  }\n}\n\n/**\n * Cartesian product of option values → the variant option combinations\n * the products hub materializes into a variants matrix. Empty/absent\n * options yield a single default combination ({}).\n */\nexport function expandVariantMatrix(\n  options: ProductOption[] | undefined,\n): Array<Record<string, string>> {\n  const usable = (options ?? []).filter(\n    (option) => option.name && (option.values?.length ?? 0) > 0,\n  )\n  if (usable.length === 0) return [{}]\n  let combos: Array<Record<string, string>> = [{}]\n  for (const option of usable) {\n    const next: Array<Record<string, string>> = []\n    for (const combo of combos) {\n      for (const value of option.values) {\n        next.push({ ...combo, [option.name]: value })\n      }\n    }\n    combos = next\n    if (combos.length > COMMERCE_MAX_VARIANTS) {\n      return combos.slice(0, COMMERCE_MAX_VARIANTS)\n    }\n  }\n  return combos\n}\n\n/**\n * The option axes renamed, with every variant's selection carried to the new\n * name in place (AGL-3066).\n *\n * A variant keeps its selections keyed by option NAME, so a rename has to move\n * each key rather than rebuild the matrix: a rebuild matches variants by name\n * and value, finds none under the new name, and replaces every variant with a\n * new id holding the first variant's price and stock and no SKU, barcode,\n * compare-at price or weight. Moving the key keeps the id every order line\n * and stock movement refers to, and every field a person set.\n *\n * `names` holds one entry per option, in order; an entry that is not a string\n * keeps that option's name. Each selection keeps its position among a\n * variant's selections, because a variant is labeled by them in order.\n *\n * Two options may share a name for a moment while a person types. A variant\n * cannot hold two selections under one name, so while the new names are not\n * all different nothing is moved, and `validateProduct` refuses the product.\n * The selection left under the old name is found again by its value once the\n * names differ, so typing through a duplicate loses nothing.\n */\nexport function renameProductOptions(\n  product: Pick<HostProduct, 'options' | 'variants'>,\n  names: ReadonlyArray<string | null | undefined>,\n): Pick<HostProduct, 'options' | 'variants'> {\n  const current = product.options ?? []\n  const options = current.map((option, index) => {\n    const name = names[index]\n    return typeof name === 'string' ? { ...option, name } : option\n  })\n  const next = options.map((option) => option.name)\n  if (new Set(next).size !== next.length) return { options, variants: product.variants }\n  const variants = (product.variants ?? []).map((variant) => {\n    const selections = variant.options\n    if (!selections) return variant\n    const axisOf = optionAxesOf(current, selections)\n    const moved: Record<string, string> = {}\n    let changed = false\n    for (const [key, value] of Object.entries(selections)) {\n      const axis = axisOf.get(key)\n      const name = axis === undefined ? key : next[axis]\n      if (name !== key) changed = true\n      moved[name] = value\n    }\n    return changed ? { ...variant, options: moved } : variant\n  })\n  return { options, variants }\n}\n\n/**\n * Which option each of a variant's selections belongs to: the option of the\n * same name first, and then, for a selection under a name no option has any\n * longer, the one remaining option whose values hold its value. A selection\n * that fits neither belongs to no option and is left as it is.\n */\nfunction optionAxesOf(\n  options: readonly ProductOption[],\n  selections: Readonly<Record<string, string>>,\n): Map<string, number> {\n  const axisOf = new Map<string, number>()\n  const taken = new Set<number>()\n  options.forEach((option, index) => {\n    if (Object.prototype.hasOwnProperty.call(selections, option.name) && !axisOf.has(option.name)) {\n      axisOf.set(option.name, index)\n      taken.add(index)\n    }\n  })\n  for (const [key, value] of Object.entries(selections)) {\n    if (axisOf.has(key)) continue\n    const axis = options.findIndex(\n      (option, index) => !taken.has(index) && (option.values ?? []).includes(value),\n    )\n    if (axis === -1) continue\n    axisOf.set(key, axis)\n    taken.add(axis)\n  }\n  return axisOf\n}\n\n/**\n * Whether a variant has a price a sale can charge (AGL-2916).\n *\n * A product proposed by AI is created with every price left empty for the\n * merchant to set, so a stored variant can lack one. `Number(undefined)` is\n * no price, and neither is `null`, which `Number` reads as zero: a sale door\n * that priced either would charge nothing, or fail at the processor.\n */\nexport function variantHasPrice(variant: object | null | undefined): boolean {\n  const price = (variant as { priceUsd?: unknown } | null | undefined)?.priceUsd\n  return typeof price === 'number' && Number.isFinite(price) && price >= 0\n}\n\n/** Whether any variant of a product still needs its price set (AGL-2916). */\nexport function productPriceMissing(product: { variants?: readonly object[] }): boolean {\n  return (product.variants ?? []).some((variant) => !variantHasPrice(variant))\n}\n\n/** Copy proposed for a product, by field (AGL-2916). A field left out is left alone. */\nexport interface ProductCopyValues {\n  description?: string\n  tags?: string[]\n  categoryIds?: string[]\n  /** One name per option the product has, in order. */\n  optionNames?: string[]\n  seoTitle?: string\n  seoDescription?: string\n}\n\n/**\n * The fields proposed copy changes on a product (AGL-2916), in the shape the\n * editor stores them: only the fields `values` names. Tags and categories are\n * each kept once; the search listing keeps its share image; and option names\n * rename the product's options through `renameProductOptions`, keeping every\n * variant, only when they name each option once with a name of its own.\n */\nexport function productCopyPatch(\n  product: Pick<HostProduct, 'options' | 'variants' | 'seo'>,\n  values: ProductCopyValues,\n): Partial<Pick<HostProduct, 'description' | 'tags' | 'categoryIds' | 'seo' | 'options' | 'variants'>> {\n  const patch: Partial<\n    Pick<HostProduct, 'description' | 'tags' | 'categoryIds' | 'seo' | 'options' | 'variants'>\n  > = {}\n  if (typeof values.description === 'string') patch.description = values.description\n  if (Array.isArray(values.tags)) {\n    patch.tags = [...new Set(values.tags.map((tag) => tag.trim()).filter(Boolean))]\n  }\n  if (Array.isArray(values.categoryIds)) {\n    patch.categoryIds = [...new Set(values.categoryIds.filter(Boolean))]\n  }\n  if (typeof values.seoTitle === 'string' || typeof values.seoDescription === 'string') {\n    patch.seo = {\n      ...product.seo,\n      ...(typeof values.seoTitle === 'string' ? { title: values.seoTitle } : {}),\n      ...(typeof values.seoDescription === 'string' ? { description: values.seoDescription } : {}),\n    }\n  }\n  const options = product.options ?? []\n  const names = values.optionNames?.map((name) => name.trim())\n  if (\n    names &&\n    options.length > 0 &&\n    names.length === options.length &&\n    names.every(Boolean) &&\n    new Set(names).size === names.length &&\n    names.some((name, index) => name !== options[index].name)\n  ) {\n    Object.assign(patch, renameProductOptions(product, names))\n  }\n  return patch\n}\n\n/** A product proposed for a store, before anyone has priced it (AGL-2916). */\nexport interface ProposedProduct {\n  name: string\n  type: ProductType\n  description: string\n  tags: string[]\n  options: ProductOption[]\n  seoTitle: string\n  seoDescription: string\n}\n\n/** A new product whose variants carry no price yet. */\nexport type UnpricedProductDraft = Omit<HostProduct, 'variants'> & {\n  variants: Array<Omit<ProductVariant, 'priceUsd'>>\n}\n\n/**\n * The document a proposed product is created as (AGL-2916): a `draft`, under\n * a slug no product in `takenSlugs` has, with one variant for each\n * combination of its options and NO price on any of them. Prices are the\n * merchant's to set: the editor refuses to save the product until every\n * variant has one, and no sale door sells a variant without one\n * (`variantHasPrice`). The search keys travel with the name, as on every\n * create path.\n */\nexport function unpricedProductDraft(\n  proposal: ProposedProduct,\n  takenSlugs: ReadonlySet<string>,\n  nowMs: number,\n): UnpricedProductDraft {\n  const name = proposal.name.trim().slice(0, 120)\n  const base = commerceSlug(name) || 'product'\n  let slug = base\n  for (let suffix = 2; takenSlugs.has(slug); suffix += 1) slug = `${base}-${suffix}`\n  const seen = new Set<string>()\n  const options = proposal.options\n    .map((option) => ({\n      name: option.name.trim(),\n      values: [...new Set(option.values.map((value) => value.trim()).filter(Boolean))].slice(\n        0,\n        COMMERCE_MAX_OPTION_VALUES,\n      ),\n    }))\n    .filter((option) => {\n      if (!option.name || !option.values.length || seen.has(option.name)) return false\n      seen.add(option.name)\n      return true\n    })\n    .slice(0, COMMERCE_MAX_OPTIONS)\n  const variants = options.length\n    ? expandVariantMatrix(options).map((combo, index) => ({\n        id: `v${nowMs.toString(36)}${index}`,\n        options: combo,\n      }))\n    : [{ id: 'default' }]\n  const seoTitle = proposal.seoTitle.trim()\n  const seoDescription = proposal.seoDescription.trim()\n  return {\n    ...productSearchFields({ name }),\n    slug,\n    type: proposal.type,\n    status: 'draft',\n    description: proposal.description,\n    tags: [...new Set(proposal.tags.map((tag) => tag.trim()).filter(Boolean))],\n    ...(options.length ? { options } : {}),\n    variants,\n    ...(seoTitle || seoDescription\n      ? { seo: { ...(seoTitle ? { title: seoTitle } : {}), ...(seoDescription ? { description: seoDescription } : {}) } }\n      : {}),\n    createdAtMs: nowMs,\n    updatedAtMs: nowMs,\n  }\n}\n\n/** Variant whose option selections match exactly; undefined if none. */\nexport function findVariant(\n  product: Pick<HostProduct, 'variants'>,\n  selections: Record<string, string>,\n): ProductVariant | undefined {\n  return product.variants?.find((variant) => {\n    const options = variant.options ?? {}\n    const keys = new Set([...Object.keys(options), ...Object.keys(selections)])\n    for (const key of keys) {\n      if (options[key] !== selections[key]) return false\n    }\n    return true\n  })\n}\n\n/** [min, max] price across variants; [0, 0] when there are none. */\nexport function productPriceRange(\n  product: Pick<HostProduct, 'variants'>,\n): [number, number] {\n  const prices = (product.variants ?? [])\n    .map((variant) => Number(variant.priceUsd))\n    .filter((price) => Number.isFinite(price) && price >= 0)\n  if (prices.length === 0) return [0, 0]\n  return [Math.min(...prices), Math.max(...prices)]\n}\n\n/** Sum of tracked inventory; null when every variant is untracked. */\nexport function productInventory(\n  product: Pick<HostProduct, 'variants'>,\n): number | null {\n  let total: number | null = null\n  for (const variant of product.variants ?? []) {\n    if (variant.inventory == null) continue\n    total = (total ?? 0) + Number(variant.inventory)\n  }\n  return total\n}\n\n/**\n * Reasons an inventory adjustment doc may carry (AGL-281).\n *\n * `cancellation` is the only one written automatically in the PLUS direction\n * (AGL-1808): cancelling an order the transition rules prove was never\n * fulfilled puts back exactly what the sale took. It is deliberately not\n * `refund` — no money moved — and not `correction`, which is what a merchant\n * picks when the count disagreed with the shelf for a reason nobody recorded.\n * Kept out of the \"Adjust stock\" dialog's menu on purpose: a merchant reaching\n * for it by hand means something else happened.\n */\nexport type InventoryAdjustmentReason =\n  'sale' | 'refund' | 'restock' | 'correction' | 'damage' | 'cancellation'\n\n/** `hosts/{hostId}/inventoryAdjustments/{id}` doc. */\nexport interface InventoryAdjustment {\n  productId: string\n  variantId: string\n  /** Positive = stock added, negative = removed. */\n  delta: number\n  /**\n   * What the count ACTUALLY moved by, when the floor in\n   * `adjustVariantInventory` absorbed part of `delta` (AGL-2149). Written only\n   * when the two differ, which for a sale means a backorder product that sold\n   * past zero: `delta` stays the units sold — that is the merchant's stock\n   * history and it must keep saying \"3 went out the door\" — while this says how\n   * many of them the count could give up.\n   *\n   * A REVERSAL MUST READ THIS, NOT `delta`. Restoring `delta` on a backorder\n   * sale that the floor swallowed invents inventory that never existed: 0 sells\n   * 3, the count stays 0, and a `+3` on cancellation leaves 3 units nobody has.\n   * Absent on every row written before AGL-2149 and on every row where nothing\n   * was clamped, so `appliedDelta ?? delta` is the reader.\n   */\n  appliedDelta?: number\n  reason: InventoryAdjustmentReason\n  /** Order id for sale/refund adjustments. */\n  orderId?: string\n  /** Location for multi-location stock (AGL-286); absent = default. */\n  locationId?: string\n  atMs: number\n}\n\n/**\n * Whether `quantity` of a variant is purchasable (AGL-281): untracked\n * stock always is; tracked stock honors the product's oversell policy.\n */\nexport function canPurchase(\n  product: Pick<HostProduct, 'variants' | 'oversellPolicy'>,\n  variantId: string | undefined,\n  quantity = 1,\n): boolean {\n  const variant = variantId\n    ? product.variants?.find((item) => item.id === variantId)\n    : product.variants?.[0]\n  if (!variant) return false\n  if (variant.inventory == null) return true\n  if (product.oversellPolicy === 'backorder') return true\n  return Number(variant.inventory) >= quantity\n}\n\n/**\n * What the register has to SAY about a line it is about to sell (AGL-2357).\n *\n * ## The defect\n *\n * `pos-order.ts` contains no `canPurchase` call. Every storefront door gates on\n * it; the register does not, so a merchant who set `oversellPolicy: 'deny'` in\n * the product editor silently got `backorder` at the counter — the count floors\n * at zero underneath and nothing anywhere says so.\n *\n * ## The decision, and why it is a shortfall and not a refusal\n *\n * Warn, never block. A till is the wrong place for a stale number to stop a\n * real sale: the cashier is holding the goods, the physical shelf is the truth,\n * and refusing loses a sale over data that is behind. But \"deny\" must at least\n * SAY something. So this reports the shortfall and the caller sells anyway.\n * Honouring the policy with a manager-level override is the post-launch shape\n * (AGL-2372) and wants an audit trail this deliberately does not build.\n *\n * ## Why the test is `canPurchase`\n *\n * Exactly the gate the register was missing, and no wider. An untracked variant\n * has no number to be short against, and a `backorder` product's merchant chose\n * to sell past zero — warning them would be noise about a setting they set on\n * purpose. So a shortfall is reported only where a purchase would have been\n * refused anywhere else in the product.\n */\nexport interface StockShortfall {\n  productId: string\n  variantId?: string\n  /** Product name at the time of sale, for a message the cashier can read. */\n  name: string\n  variantLabel?: string\n  /** Units the cashier is ringing up. */\n  requested: number\n  /** Units the count says are on the shelf; never negative. */\n  available: number\n}\n\nexport function stockShortfall(\n  product: Pick<HostProduct, 'variants' | 'oversellPolicy'>,\n  variantId: string | undefined,\n  quantity = 1,\n): { available: number } | null {\n  if (canPurchase(product, variantId, quantity)) return null\n  const variant = variantId\n    ? product.variants?.find((item) => item.id === variantId)\n    : product.variants?.[0]\n  // `canPurchase` answers false for a variant that does not exist at all. That\n  // is not a stock shortfall and must not be reported as \"0 in stock\" — the\n  // register's own line builder falls back to `variants[0]`, so the case is\n  // unreachable from the counter, and inventing a count for it would be the\n  // one failure mode this feature must not have.\n  if (!variant || variant.inventory == null) return null\n  return { available: Math.max(0, Math.round(Number(variant.inventory) || 0)) }\n}\n\n/**\n * Whether stock tracking MEANS anything on a product (AGL-1744).\n *\n * `canPurchase` above gates every checkout on stock, subscription sessions\n * included, but nothing ever decrements for a subscription — not on the\n * initial charge (the `commerce-subscription` webhook branch deliberately\n * writes no order and touches no inventory, AGL-1732) and not on renewal\n * (`invoice.payment_succeeded` is unhandled repo-wide, AGL-1743). So on a\n * subscription-only product that gate is permanently satisfied: one unit of\n * stock sells an unlimited number of subscriptions, and the count never\n * moves however many boxes ship. The merchant set a number, the system\n * checks it on every sale, and the number is never true.\n *\n * AGL-1750 resolved the half AGL-1744 had to leave open: every paid invoice\n * of a PHYSICAL subscription now mints an order and decrements its variant's\n * stock (the `invoice.paid` branch of the commerce webhook), opening cycle\n * included. So the honest split is now three-way:\n *\n *   - `subscriptionOptional` (\"Both\") products have a real one-time path —\n *     the cart only ever builds `mode: 'payment'` sessions, and buy-now with\n *     `billing: 'once'` records a plain order — and that path decrements\n *     honestly. Withdrawing stock tracking there would delete a working\n *     control and re-open the AGL-1711 oversell on the half that works.\n *   - a PHYSICAL subscription box consumes a unit every cycle, and since\n *     AGL-1750 the cycle's own order decrements it — the count moves as the\n *     boxes ship, so the number the merchant sets is kept true again.\n *   - a DIGITAL or SERVICE subscription-only product still has no\n *     decrementing path anywhere, so the field stays withdrawn there: one\n *     unit would still sell unlimited subscriptions.\n *\n * This says nothing about what `canPurchase` returns — that is the gate for\n * every other purchase path and is deliberately untouched. This is a console\n * predicate: it stops the editor inviting a merchant to set a number the\n * system will never keep true.\n */\nexport function stockTrackingApplies(\n  product: Pick<HostProduct, 'subscription' | 'subscriptionOptional' | 'type'>,\n): boolean {\n  return (\n    !product.subscription ||\n    product.subscriptionOptional === true ||\n    product.type === 'physical'\n  )\n}\n\n/** Buyer's requested billing mode on a checkout POST (AGL-545). */\nexport type CheckoutBillingChoice = 'once' | 'subscribe'\n\n/**\n * Resolves the Stripe Checkout mode for a product + the buyer's\n * requested billing choice (AGL-545). The product doc is authoritative:\n * - no `subscription` → always one-time (the request field is ignored)\n * - `subscription` without `subscriptionOptional` → always subscription\n *   (a forged `billing: 'once'` cannot buy a subscription product once)\n * - `subscriptionOptional` → the buyer chooses; absent/invalid choices\n *   default to one-time, matching the PDP default.\n */\nexport function resolveCheckoutBillingMode(\n  product: Pick<HostProduct, 'subscription' | 'subscriptionOptional'>,\n  requested?: string | null,\n): 'payment' | 'subscription' {\n  if (!product.subscription) return 'payment'\n  if (!product.subscriptionOptional) return 'subscription'\n  return requested === 'subscribe' ? 'subscription' : 'payment'\n}\n\n/**\n * Applies a stock delta to one variant, flooring at zero (race-window\n * sales can't drive the display negative), and returns the new variants\n * array — callers persist it plus the `productInventory` denormalization.\n * With `locationId`, the delta lands in that location's bucket and the\n * flat `inventory` re-sums across locations (AGL-286).\n */\nexport function adjustVariantInventory(\n  product: Pick<HostProduct, 'variants'>,\n  variantId: string,\n  delta: number,\n  locationId?: string,\n): ProductVariant[] {\n  return (product.variants ?? []).map((variant) => {\n    if (variant.id !== variantId || variant.inventory == null) return variant\n    if (locationId && variant.inventoryByLocation) {\n      const buckets = {\n        ...variant.inventoryByLocation,\n        [locationId]: Math.max(\n          0,\n          Number(variant.inventoryByLocation[locationId] ?? 0) + delta,\n        ),\n      }\n      return {\n        ...variant,\n        inventoryByLocation: buckets,\n        inventory: Object.values(buckets).reduce(\n          (sum, count) => sum + Number(count),\n          0,\n        ),\n      }\n    }\n    return {\n      ...variant,\n      inventory: Math.max(0, Number(variant.inventory) + delta),\n    }\n  })\n}\n\n/**\n * What `adjustVariantInventory` will ACTUALLY move the count by (AGL-2149).\n *\n * The floor in that helper is not a rounding detail, it is a silent absorber. A\n * backorder product (`oversellPolicy: 'backorder'`, which `canPurchase` admits\n * at any stock level) sitting at 0 sells 3: `Math.max(0, 0 + -3)` is 0, so the\n * count does not move — correctly, since inventory is a shelf count and shelves\n * do not go negative — but the ledger row said `-3` and every reversal read it\n * as three units to put back. Cancelling that order handed the merchant 3 units\n * that never existed and a stock badge that offers them for sale.\n *\n * Removing the floor is not the alternative: every reader of `inventory` — the\n * badges, `canPurchase`, `productInventory`, `isLowStock` — assumes it cannot\n * go negative, and a negative count would be a far wider change than the bug.\n * So the clamp stays and the amount it absorbed is recorded instead.\n *\n * Deliberately mirrors `adjustVariantInventory`'s own arithmetic, including\n * which field the clamp applies to in the location-tracked case, so the two\n * cannot disagree about what happened.\n */\nexport function appliedVariantInventoryDelta(\n  product: Pick<HostProduct, 'variants'>,\n  variantId: string,\n  delta: number,\n  locationId?: string,\n): number {\n  const variant = (product.variants ?? []).find(\n    (item) => item.id === variantId,\n  )\n  if (!variant || variant.inventory == null) return 0\n  if (locationId && variant.inventoryByLocation) {\n    const before = Number(variant.inventoryByLocation[locationId] ?? 0)\n    return Math.max(0, before + delta) - before\n  }\n  const before = Number(variant.inventory)\n  return Math.max(0, before + delta) - before\n}\n\n/**\n * Moves stock between two locations of a tracked variant (AGL-286).\n * Quantity clamps to what the source location holds; the flat total is\n * unchanged by construction.\n */\nexport function transferVariantInventory(\n  product: Pick<HostProduct, 'variants'>,\n  variantId: string,\n  fromLocationId: string,\n  toLocationId: string,\n  quantity: number,\n): ProductVariant[] {\n  return (product.variants ?? []).map((variant) => {\n    if (variant.id !== variantId || variant.inventory == null) return variant\n    const buckets = { ...(variant.inventoryByLocation ?? {}) }\n    const available = Math.max(0, Number(buckets[fromLocationId] ?? 0))\n    const moved = Math.min(available, Math.max(0, Math.round(quantity)))\n    if (moved === 0) return variant\n    buckets[fromLocationId] = available - moved\n    buckets[toLocationId] = Math.max(0, Number(buckets[toLocationId] ?? 0)) + moved\n    return { ...variant, inventoryByLocation: buckets }\n  })\n}\n\n/** True when tracked stock is at/below the product's alert threshold. */\nexport function isLowStock(\n  product: Pick<HostProduct, 'variants' | 'lowStockThreshold'>,\n): boolean {\n  const threshold = product.lowStockThreshold\n  if (threshold == null || !(threshold >= 0)) return false\n  const total = productInventory(product)\n  return total != null && total <= threshold\n}\n\nfunction ruleMatches(product: HostProduct, rule: CollectionRule): boolean {\n  const value = rule.value\n  switch (rule.field) {\n    case 'tag': {\n      const tags = product.tags ?? []\n      const has = tags.includes(String(value))\n      return rule.op === 'neq' ? !has : has\n    }\n    case 'categoryId': {\n      const ids = product.categoryIds ?? []\n      const has = ids.includes(String(value))\n      return rule.op === 'neq' ? !has : has\n    }\n    case 'priceUsd': {\n      const [min, max] = productPriceRange(product)\n      const numeric = Number(value)\n      if (!Number.isFinite(numeric)) return false\n      if (rule.op === 'lt') return min < numeric\n      if (rule.op === 'gt') return max > numeric\n      if (rule.op === 'neq') return min !== numeric || max !== numeric\n      return min <= numeric && numeric <= max\n    }\n    case 'name': {\n      const name = (product.name ?? '').toLowerCase()\n      const needle = String(value).toLowerCase()\n      if (rule.op === 'contains') return name.includes(needle)\n      if (rule.op === 'neq') return name !== needle\n      return name === needle\n    }\n    case 'type': {\n      const matches = product.type === value\n      return rule.op === 'neq' ? !matches : matches\n    }\n    default:\n      return false\n  }\n}\n\n/**\n * Smart-collection membership: draft/archived/deleted products never\n * match; manual collections answer from productIds.\n */\nexport function matchesCollection(\n  product: HostProduct,\n  collection: HostCollection,\n  productId?: string,\n): boolean {\n  if (product.deletedAt || product.status !== 'active') return false\n  if (collection.mode === 'manual') {\n    return productId != null &&\n      (collection.productIds ?? []).includes(productId)\n  }\n  const rules = collection.rules ?? []\n  if (rules.length === 0) return false\n  const matcher = (rule: CollectionRule) => ruleMatches(product, rule)\n  return collection.matchAll === false\n    ? rules.some(matcher)\n    : rules.every(matcher)\n}\n\n/**\n * Lifts a legacy Commerce Starter doc (AGL-90: flat name/priceUsd/\n * inventory/imageUrl) into the catalog shape with a single default\n * variant. Already-lifted docs pass through unchanged.\n */\nexport function liftLegacyProduct(\n  raw: Partial<HostProduct> & { name?: string },\n): HostProduct {\n  if (Array.isArray(raw.variants) && raw.variants.length > 0) {\n    return raw as HostProduct\n  }\n  const priceUsd = Number(raw.priceUsd ?? 0)\n  return {\n    ...raw,\n    name: raw.name ?? 'Product',\n    slug: raw.slug || commerceSlug(raw.name ?? 'product'),\n    type: raw.type ?? 'physical',\n    status: raw.status ?? 'active',\n    variants: [\n      {\n        id: 'default',\n        priceUsd: Number.isFinite(priceUsd) ? priceUsd : 0,\n        inventory: raw.inventory ?? null,\n      },\n    ],\n  }\n}\n\n/** Actionable error, or null when the product is storable. */\nexport function validateProduct(product: HostProduct): string | null {\n  if (!product.name?.trim()) return 'Product name is required'\n  if (!product.slug || product.slug !== commerceSlug(product.slug)) {\n    return 'Slug must be lowercase letters, numbers, and dashes'\n  }\n  if (!['physical', 'digital', 'service'].includes(product.type)) {\n    return 'Unknown product type'\n  }\n  if (!['draft', 'active', 'archived'].includes(product.status)) {\n    return 'Unknown product status'\n  }\n  const options = product.options ?? []\n  if (options.length > COMMERCE_MAX_OPTIONS) {\n    return `At most ${COMMERCE_MAX_OPTIONS} options per product`\n  }\n  for (const option of options) {\n    if (!option.name?.trim()) return 'Option names are required'\n    if ((option.values?.length ?? 0) === 0) {\n      return `Option \"${option.name}\" needs at least one value`\n    }\n    if (option.values.length > COMMERCE_MAX_OPTION_VALUES) {\n      return `Option \"${option.name}\" has too many values`\n    }\n    if (new Set(option.values).size !== option.values.length) {\n      return `Option \"${option.name}\" has duplicate values`\n    }\n  }\n  // A variant keys its selections by option name, so two options with one\n  // name cannot both be selected (AGL-3066).\n  if (new Set(options.map((option) => option.name.trim())).size !== options.length) {\n    return 'Each option needs its own name'\n  }\n  const variants = product.variants ?? []\n  if (variants.length === 0) return 'Products need at least one variant'\n  if (variants.length > COMMERCE_MAX_VARIANTS) {\n    return `At most ${COMMERCE_MAX_VARIANTS} variants per product`\n  }\n  const ids = new Set<string>()\n  const skus = new Set<string>()\n  for (const variant of variants) {\n    if (!variant.id) return 'Variants need stable ids'\n    if (ids.has(variant.id)) return 'Variant ids must be unique'\n    ids.add(variant.id)\n    if (variant.priceUsd === undefined || variant.priceUsd === null) {\n      return 'Set a price for every variant'\n    }\n    const price = Number(variant.priceUsd)\n    if (!Number.isFinite(price) || price < 0) {\n      return 'Variant prices must be zero or more'\n    }\n    if (price > COMMERCE_MAX_PRICE_USD) {\n      return `Prices are capped at $${COMMERCE_MAX_PRICE_USD}`\n    }\n    if (variant.sku) {\n      if (skus.has(variant.sku)) return 'Variant SKUs must be unique'\n      skus.add(variant.sku)\n    }\n    if (\n      variant.compareAtPriceUsd != null &&\n      Number(variant.compareAtPriceUsd) <= price\n    ) {\n      return 'Compare-at price must exceed the price'\n    }\n  }\n  return null\n}\n\n/** Actionable error, or null when the collection is storable. */\nexport function validateCollection(collection: HostCollection): string | null {\n  if (!collection.name?.trim()) return 'Collection name is required'\n  if (\n    !collection.slug ||\n    collection.slug !== commerceSlug(collection.slug)\n  ) {\n    return 'Slug must be lowercase letters, numbers, and dashes'\n  }\n  if (collection.mode !== 'manual' && collection.mode !== 'smart') {\n    return 'Unknown collection mode'\n  }\n  if (collection.mode === 'smart') {\n    const rules = collection.rules ?? []\n    if (rules.length === 0) return 'Smart collections need at least one rule'\n    for (const rule of rules) {\n      if (\n        !['tag', 'categoryId', 'priceUsd', 'name', 'type'].includes(rule.field)\n      ) {\n        return 'Unknown rule field'\n      }\n      if (!['eq', 'neq', 'lt', 'gt', 'contains'].includes(rule.op)) {\n        return 'Unknown rule operator'\n      }\n      if (rule.value === '' || rule.value == null) {\n        return 'Rule values are required'\n      }\n    }\n  }\n  return null\n}\n"],"names":["nameSearchFields","COMMERCE_MAX_PRICE_USD","registersWithinCap","registers","cap","createdMs","r","createdAt","toMillis","seconds","ranked","sort","a","b","$id","localeCompare","Set","slice","Math","max","map","COMMERCE_MAX_VARIANTS","COMMERCE_MAX_OPTIONS","COMMERCE_MAX_OPTION_VALUES","COMMERCE_SLUG_MAX_LENGTH","commerceSlug","name","String","normalize","replace","toLowerCase","productSearchFields","product","flatten","read","variants","variant","trim","filter","Boolean","skus","sku","barcodes","barcode","length","expandVariantMatrix","options","usable","option","values","combos","next","combo","value","push","renameProductOptions","names","current","index","size","selections","axisOf","optionAxesOf","moved","changed","key","Object","entries","axis","get","undefined","Map","taken","forEach","prototype","hasOwnProperty","call","has","set","add","findIndex","includes","variantHasPrice","price","priceUsd","Number","isFinite","productPriceMissing","some","productCopyPatch","patch","description","Array","isArray","tags","tag","categoryIds","seoTitle","seoDescription","seo","title","optionNames","every","assign","unpricedProductDraft","proposal","takenSlugs","nowMs","base","slug","suffix","seen","id","toString","type","status","createdAtMs","updatedAtMs","findVariant","find","keys","productPriceRange","prices","min","productInventory","total","inventory","canPurchase","variantId","quantity","item","oversellPolicy","stockShortfall","available","round","stockTrackingApplies","subscription","subscriptionOptional","resolveCheckoutBillingMode","requested","adjustVariantInventory","delta","locationId","inventoryByLocation","buckets","reduce","sum","count","appliedVariantInventoryDelta","before","transferVariantInventory","fromLocationId","toLocationId","isLowStock","threshold","lowStockThreshold","ruleMatches","rule","field","op","ids","numeric","needle","matches","matchesCollection","collection","productId","deletedAt","mode","productIds","rules","matcher","matchAll","liftLegacyProduct","raw","validateProduct","compareAtPriceUsd","validateCollection"],"mappings":"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"}

package/src/lib/model/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Commerce domain model (AGL-411): pure types + logic relocated from the
+ * core `@aglyn/aglyn` app-utils — the commerce plugin owns its domain.
+ * Context-free and framework-free, so both the plugin's client components
+ * and its `/server` handlers (and other plugins/apps via
+ * `@aglyn/plugins-commerce/model`) can import it.
+ */
+export * from './commerce';
+export * from './commerce-cart';
+export * from './commerce-connect-transfer';
+export * from './commerce-discounts';
+export * from './commerce-dispute';
+export * from './commerce-gift-cards';
+export * from './commerce-io';
+export * from './commerce-orders';
+export * from './commerce-promotions';
+export * from './commerce-reservations';
+export * from './commerce-shipping';
+export * from './commerce-stock-holds';
+export * from './commerce-subscription-status';
+export * from './commerce-tax';
+export * from './commerce-tax-decision';
+export * from './order-figures';
+export * from './purchase-analytics';

package/src/lib/model/index.js

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * Commerce domain model (AGL-411): pure types + logic relocated from the
+ * core `@aglyn/aglyn` app-utils — the commerce plugin owns its domain.
+ * Context-free and framework-free, so both the plugin's client components
+ * and its `/server` handlers (and other plugins/apps via
+ * `@aglyn/plugins-commerce/model`) can import it.
+ */ export * from "./commerce.js";
+export * from "./commerce-cart.js";
+export * from "./commerce-connect-transfer.js";
+export * from "./commerce-discounts.js";
+export * from "./commerce-dispute.js";
+export * from "./commerce-gift-cards.js";
+export * from "./commerce-io.js";
+export * from "./commerce-orders.js";
+export * from "./commerce-promotions.js";
+export * from "./commerce-reservations.js";
+export * from "./commerce-shipping.js";
+export * from "./commerce-stock-holds.js";
+export * from "./commerce-subscription-status.js";
+export * from "./commerce-tax.js";
+export * from "./commerce-tax-decision.js";
+export * from "./order-figures.js";
+export * from "./purchase-analytics.js";
+
+//# sourceMappingURL=index.js.map

package/src/lib/model/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/index.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Commerce domain model (AGL-411): pure types + logic relocated from the\n * core `@aglyn/aglyn` app-utils — the commerce plugin owns its domain.\n * Context-free and framework-free, so both the plugin's client components\n * and its `/server` handlers (and other plugins/apps via\n * `@aglyn/plugins-commerce/model`) can import it.\n */\nexport * from './commerce'\nexport * from './commerce-cart'\nexport * from './commerce-connect-transfer'\nexport * from './commerce-discounts'\nexport * from './commerce-dispute'\nexport * from './commerce-gift-cards'\nexport * from './commerce-io'\nexport * from './commerce-orders'\nexport * from './commerce-promotions'\nexport * from './commerce-reservations'\nexport * from './commerce-shipping'\nexport * from './commerce-stock-holds'\nexport * from './commerce-subscription-status'\nexport * from './commerce-tax'\nexport * from './commerce-tax-decision'\nexport * from './order-figures'\nexport * from './purchase-analytics'\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;CAMC,GACD,cAAc,gBAAY;AAC1B,cAAc,qBAAiB;AAC/B,cAAc,iCAA6B;AAC3C,cAAc,0BAAsB;AACpC,cAAc,wBAAoB;AAClC,cAAc,2BAAuB;AACrC,cAAc,mBAAe;AAC7B,cAAc,uBAAmB;AACjC,cAAc,2BAAuB;AACrC,cAAc,6BAAyB;AACvC,cAAc,yBAAqB;AACnC,cAAc,4BAAwB;AACtC,cAAc,oCAAgC;AAC9C,cAAc,oBAAgB;AAC9B,cAAc,6BAAyB;AACvC,cAAc,qBAAiB;AAC/B,cAAc,0BAAsB"}

package/src/lib/model/order-figures.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Which orders are money, and how much each is (AGL-327, AGL-2915).
+ *
+ * The rules the Analytics tab's card and the insight readers both sum by, in
+ * one place: a pending or canceled order is not money, a rehearsal checkout is
+ * not revenue, and a refund comes off what an order brought in.
+ */
+/** An order as a figure reads it: the stored document with its id. */
+export type OrderFigureSource = Record<string, unknown> & {
+    $id?: string;
+    createdAtMs?: number;
+};
+/** Whether an order counts toward sales figures at all. */
+export declare function orderCountsAsSale(order: OrderFigureSource): boolean;
+/** What an order brought in, in cents: its total less what was refunded. */
+export declare function orderPaidCents(order: OrderFigureSource): number;
+export interface OrderWindowFigures {
+    orders: number;
+    revenueCents: number;
+    /** Revenue over orders, rounded to the cent; 0 with no orders. */
+    averageCents: number;
+}
+/** The sales figures of the orders placed in `[startMs, endMs)`. */
+export declare function orderWindowFigures(orders: readonly OrderFigureSource[], startMs: number, endMs: number): OrderWindowFigures;
+export interface ProductSales {
+    productId: string;
+    name: string;
+    units: number;
+    cents: number;
+}
+/** Each product's units and line revenue across counted orders, largest revenue first. */
+export declare function productSales(orders: readonly OrderFigureSource[]): ProductSales[];

package/src/lib/model/order-figures.js

@@ -0,0 +1,74 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { liftLegacyOrder, orderIsTestMode } from "./commerce-orders.js";
+/** Whether an order counts toward sales figures at all. */ export function orderCountsAsSale(order) {
+    var _lifted_status;
+    const lifted = liftLegacyOrder(order);
+    return ![
+        'pending',
+        'cancelled'
+    ].includes(String((_lifted_status = lifted['status']) != null ? _lifted_status : '')) && !orderIsTestMode(_extends({}, lifted, {
+        $id: order.$id
+    }));
+}
+/** What an order brought in, in cents: its total less what was refunded. */ export function orderPaidCents(order) {
+    var _ref, _ref1, _lifted_refundedCents;
+    var _lifted_totals;
+    const lifted = liftLegacyOrder(order);
+    return ((_ref = (_ref1 = (_lifted_totals = lifted.totals) == null ? void 0 : _lifted_totals.totalCents) != null ? _ref1 : lifted.amountCents) != null ? _ref : 0) - ((_lifted_refundedCents = lifted.refundedCents) != null ? _lifted_refundedCents : 0);
+}
+/** The sales figures of the orders placed in `[startMs, endMs)`. */ export function orderWindowFigures(orders, startMs, endMs) {
+    const counted = orders.filter((order)=>{
+        const at = Number(order.createdAtMs);
+        return Number.isFinite(at) && at >= startMs && at < endMs && orderCountsAsSale(order);
+    });
+    const revenueCents = counted.reduce((sum, order)=>sum + orderPaidCents(order), 0);
+    return {
+        orders: counted.length,
+        revenueCents,
+        averageCents: counted.length ? Math.round(revenueCents / counted.length) : 0
+    };
+}
+/** Each product's units and line revenue across counted orders, largest revenue first. */ export function productSales(orders) {
+    const byProduct = new Map();
+    for (const order of orders){
+        var _order_lineItems;
+        if (!orderCountsAsSale(order)) continue;
+        const lines = (_order_lineItems = order['lineItems']) != null ? _order_lineItems : [];
+        for (const line of lines){
+            var _line_productId, _line_quantity, _line_unitAmountCents, _byProduct_get, _line_name;
+            const productId = String((_line_productId = line['productId']) != null ? _line_productId : '');
+            if (!productId) continue;
+            const quantity = Number((_line_quantity = line['quantity']) != null ? _line_quantity : 0);
+            const unit = Number((_line_unitAmountCents = line['unitAmountCents']) != null ? _line_unitAmountCents : 0);
+            const entry = (_byProduct_get = byProduct.get(productId)) != null ? _byProduct_get : {
+                productId,
+                name: String((_line_name = line['name']) != null ? _line_name : productId),
+                units: 0,
+                cents: 0
+            };
+            entry.units += Number.isFinite(quantity) ? quantity : 0;
+            entry.cents += Number.isFinite(unit) && Number.isFinite(quantity) ? unit * quantity : 0;
+            byProduct.set(productId, entry);
+        }
+    }
+    return [
+        ...byProduct.values()
+    ].sort((a, b)=>b.cents - a.cents || a.name.localeCompare(b.name));
+}
+
+//# sourceMappingURL=order-figures.js.map

package/src/lib/model/order-figures.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/order-figures.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { liftLegacyOrder, orderIsTestMode } from './commerce-orders'\n\n/**\n * Which orders are money, and how much each is (AGL-327, AGL-2915).\n *\n * The rules the Analytics tab's card and the insight readers both sum by, in\n * one place: a pending or canceled order is not money, a rehearsal checkout is\n * not revenue, and a refund comes off what an order brought in.\n */\n\n/** An order as a figure reads it: the stored document with its id. */\nexport type OrderFigureSource = Record<string, unknown> & { $id?: string; createdAtMs?: number }\n\n/** Whether an order counts toward sales figures at all. */\nexport function orderCountsAsSale(order: OrderFigureSource): boolean {\n  const lifted = liftLegacyOrder(order as never) as unknown as Record<string, unknown>\n  return (\n    !['pending', 'cancelled'].includes(String(lifted['status'] ?? '')) &&\n    !orderIsTestMode({ ...lifted, $id: order.$id } as never)\n  )\n}\n\n/** What an order brought in, in cents: its total less what was refunded. */\nexport function orderPaidCents(order: OrderFigureSource): number {\n  const lifted = liftLegacyOrder(order as never) as unknown as {\n    totals?: { totalCents?: number }\n    amountCents?: number\n    refundedCents?: number\n  }\n  return (lifted.totals?.totalCents ?? lifted.amountCents ?? 0) - (lifted.refundedCents ?? 0)\n}\n\nexport interface OrderWindowFigures {\n  orders: number\n  revenueCents: number\n  /** Revenue over orders, rounded to the cent; 0 with no orders. */\n  averageCents: number\n}\n\n/** The sales figures of the orders placed in `[startMs, endMs)`. */\nexport function orderWindowFigures(\n  orders: readonly OrderFigureSource[],\n  startMs: number,\n  endMs: number,\n): OrderWindowFigures {\n  const counted = orders.filter((order) => {\n    const at = Number(order.createdAtMs)\n    return Number.isFinite(at) && at >= startMs && at < endMs && orderCountsAsSale(order)\n  })\n  const revenueCents = counted.reduce((sum, order) => sum + orderPaidCents(order), 0)\n  return {\n    orders: counted.length,\n    revenueCents,\n    averageCents: counted.length ? Math.round(revenueCents / counted.length) : 0,\n  }\n}\n\nexport interface ProductSales {\n  productId: string\n  name: string\n  units: number\n  cents: number\n}\n\n/** Each product's units and line revenue across counted orders, largest revenue first. */\nexport function productSales(orders: readonly OrderFigureSource[]): ProductSales[] {\n  const byProduct = new Map<string, ProductSales>()\n  for (const order of orders) {\n    if (!orderCountsAsSale(order)) continue\n    const lines = (order['lineItems'] ?? []) as Array<Record<string, unknown>>\n    for (const line of lines) {\n      const productId = String(line['productId'] ?? '')\n      if (!productId) continue\n      const quantity = Number(line['quantity'] ?? 0)\n      const unit = Number(line['unitAmountCents'] ?? 0)\n      const entry = byProduct.get(productId) ?? {\n        productId,\n        name: String(line['name'] ?? productId),\n        units: 0,\n        cents: 0,\n      }\n      entry.units += Number.isFinite(quantity) ? quantity : 0\n      entry.cents += Number.isFinite(unit) && Number.isFinite(quantity) ? unit * quantity : 0\n      byProduct.set(productId, entry)\n    }\n  }\n  return [...byProduct.values()].sort((a, b) => b.cents - a.cents || a.name.localeCompare(b.name))\n}\n"],"names":["liftLegacyOrder","orderIsTestMode","orderCountsAsSale","order","lifted","includes","String","$id","orderPaidCents","totals","totalCents","amountCents","refundedCents","orderWindowFigures","orders","startMs","endMs","counted","filter","at","Number","createdAtMs","isFinite","revenueCents","reduce","sum","length","averageCents","Math","round","productSales","byProduct","Map","lines","line","productId","quantity","unit","entry","get","name","units","cents","set","values","sort","a","b","localeCompare"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,eAAe,EAAEC,eAAe,QAAQ,uBAAmB;AAapE,yDAAyD,GACzD,OAAO,SAASC,kBAAkBC,KAAwB;QAGZC;IAF5C,MAAMA,SAASJ,gBAAgBG;IAC/B,OACE,CAAC;QAAC;QAAW;KAAY,CAACE,QAAQ,CAACC,QAAOF,iBAAAA,MAAM,CAAC,SAAS,YAAhBA,iBAAoB,QAC9D,CAACH,gBAAgB,aAAKG;QAAQG,KAAKJ,MAAMI,GAAG;;AAEhD;AAEA,0EAA0E,GAC1E,OAAO,SAASC,eAAeL,KAAwB;QAM7CC,aAAyDA;QAAzDA;IALR,MAAMA,SAASJ,gBAAgBG;IAK/B,OAAO,EAACC,iBAAAA,iBAAAA,OAAOK,MAAM,qBAAbL,eAAeM,UAAU,oBAAIN,OAAOO,WAAW,YAA/CP,OAAmD,OAAMA,wBAAAA,OAAOQ,aAAa,YAApBR,wBAAwB;AAC3F;AASA,kEAAkE,GAClE,OAAO,SAASS,mBACdC,MAAoC,EACpCC,OAAe,EACfC,KAAa;IAEb,MAAMC,UAAUH,OAAOI,MAAM,CAAC,CAACf;QAC7B,MAAMgB,KAAKC,OAAOjB,MAAMkB,WAAW;QACnC,OAAOD,OAAOE,QAAQ,CAACH,OAAOA,MAAMJ,WAAWI,KAAKH,SAASd,kBAAkBC;IACjF;IACA,MAAMoB,eAAeN,QAAQO,MAAM,CAAC,CAACC,KAAKtB,QAAUsB,MAAMjB,eAAeL,QAAQ;IACjF,OAAO;QACLW,QAAQG,QAAQS,MAAM;QACtBH;QACAI,cAAcV,QAAQS,MAAM,GAAGE,KAAKC,KAAK,CAACN,eAAeN,QAAQS,MAAM,IAAI;IAC7E;AACF;AASA,wFAAwF,GACxF,OAAO,SAASI,aAAahB,MAAoC;IAC/D,MAAMiB,YAAY,IAAIC;IACtB,KAAK,MAAM7B,SAASW,OAAQ;YAEXX;QADf,IAAI,CAACD,kBAAkBC,QAAQ;QAC/B,MAAM8B,SAAS9B,mBAAAA,KAAK,CAAC,YAAY,YAAlBA,mBAAsB,EAAE;QACvC,KAAK,MAAM+B,QAAQD,MAAO;gBACCC,iBAEDA,gBACJA,uBACNH,gBAECG;YANf,MAAMC,YAAY7B,QAAO4B,kBAAAA,IAAI,CAAC,YAAY,YAAjBA,kBAAqB;YAC9C,IAAI,CAACC,WAAW;YAChB,MAAMC,WAAWhB,QAAOc,iBAAAA,IAAI,CAAC,WAAW,YAAhBA,iBAAoB;YAC5C,MAAMG,OAAOjB,QAAOc,wBAAAA,IAAI,CAAC,kBAAkB,YAAvBA,wBAA2B;YAC/C,MAAMI,SAAQP,iBAAAA,UAAUQ,GAAG,CAACJ,sBAAdJ,iBAA4B;gBACxCI;gBACAK,MAAMlC,QAAO4B,aAAAA,IAAI,CAAC,OAAO,YAAZA,aAAgBC;gBAC7BM,OAAO;gBACPC,OAAO;YACT;YACAJ,MAAMG,KAAK,IAAIrB,OAAOE,QAAQ,CAACc,YAAYA,WAAW;YACtDE,MAAMI,KAAK,IAAItB,OAAOE,QAAQ,CAACe,SAASjB,OAAOE,QAAQ,CAACc,YAAYC,OAAOD,WAAW;YACtFL,UAAUY,GAAG,CAACR,WAAWG;QAC3B;IACF;IACA,OAAO;WAAIP,UAAUa,MAAM;KAAG,CAACC,IAAI,CAAC,CAACC,GAAGC,IAAMA,EAAEL,KAAK,GAAGI,EAAEJ,KAAK,IAAII,EAAEN,IAAI,CAACQ,aAAa,CAACD,EAAEP,IAAI;AAChG"}

package/src/lib/model/plugin-permissions.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { PluginPermission } from '@aglyn/aglyn';
+/**
+ * Commerce's plugin-declared permissions (AGL-435) — the reference
+ * adopter. Pure data: the client barrel and /server entry both register
+ * it, so console gating and API-side resolution agree.
+ */
+export declare const COMMERCE_PERMISSIONS: readonly PluginPermission[];

package/src/lib/model/plugin-permissions.js

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * Commerce's plugin-declared permissions (AGL-435) — the reference
+ * adopter. Pure data: the client barrel and /server entry both register
+ * it, so console gating and API-side resolution agree.
+ */ export const COMMERCE_PERMISSIONS = [
+    {
+        key: 'managePos',
+        pluginId: 'commerce',
+        label: 'Use the point of sale',
+        description: 'Open the POS page and record in-person sales.',
+        defaults: {
+            admin: true,
+            editor: true,
+            viewer: false
+        }
+    }
+];
+
+//# sourceMappingURL=plugin-permissions.js.map

package/src/lib/model/plugin-permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/plugin-permissions.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { PluginPermission } from '@aglyn/aglyn'\n\n/**\n * Commerce's plugin-declared permissions (AGL-435) — the reference\n * adopter. Pure data: the client barrel and /server entry both register\n * it, so console gating and API-side resolution agree.\n */\nexport const COMMERCE_PERMISSIONS: readonly PluginPermission[] = [\n  {\n    key: 'managePos',\n    pluginId: 'commerce',\n    label: 'Use the point of sale',\n    description: 'Open the POS page and record in-person sales.',\n    defaults: { admin: true, editor: true, viewer: false },\n  },\n]\n"],"names":["COMMERCE_PERMISSIONS","key","pluginId","label","description","defaults","admin","editor","viewer"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAID;;;;CAIC,GACD,OAAO,MAAMA,uBAAoD;IAC/D;QACEC,KAAK;QACLC,UAAU;QACVC,OAAO;QACPC,aAAa;QACbC,UAAU;YAAEC,OAAO;YAAMC,QAAQ;YAAMC,QAAQ;QAAM;IACvD;CACD,CAAA"}

package/src/lib/model/purchase-analytics.d.ts

@@ -0,0 +1,186 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { AnalyticsEventParams } from '@aglyn/aglyn/app-utils/analytics-events';
+import type { HostOrder } from './commerce-orders';
+/**
+ * The GA-safe projection of a storefront order (AGL-1641). Deliberately NOT
+ * `HostOrder`: this shape crosses the wire to a shopper's browser, so it can
+ * only ever hold what a `purchase` event needs. `customerEmail`,
+ * `customerName`, `shippingAddress` and `billingAddress` are absent by
+ * construction rather than by a `delete` somebody has to remember.
+ */
+export interface StorefrontPurchaseSource {
+    /** Stripe Checkout Session id — also the order doc id. */
+    transactionId: string;
+    totalCents: number;
+    taxCents: number;
+    /**
+     * Stripe's `total_details.amount_shipping` as the webhook stored it — or
+     * `shipping_cost.amount_total` on a subscription invoice, which has no
+     * `total_details`. Reported as GA4's `shipping`, NOT subtracted from
+     * `value`: it is part of what the merchant sold.
+     */
+    shippingCents: number;
+    lineItems: {
+        productId: string;
+        name: string;
+        quantity: number;
+        unitAmountCents: number;
+    }[];
+}
+/**
+ * Build the `purchase` a TENANT STOREFRONT reports to the MERCHANT's GA4
+ * property (AGL-1641).
+ *
+ * ## Whose revenue this is — the decision, not an inference
+ *
+ * This is the exact inverse of the marketplace call in AGL-1639, and the
+ * reason is the property the hit lands in. There, the GA property is OURS, the
+ * platform fee IS what Aglyn was paid, and `value` had to be platform net so
+ * that a marketplace sale and a subscription meant the same thing when GA
+ * added them up. Here the property is the MERCHANT's — `gtag` on a tenant site
+ * is loaded with `host.analytics.gaMeasurementId`, their measurement id — and
+ * on their storefront the merchant is the seller. Aglyn's cut is not a share
+ * of this sale from their side; it is a cost of making it.
+ *
+ * So `feeCents` is NOT subtracted. Subtracting it would report the merchant's
+ * gross margin after our fee as though it were their sales revenue, which is
+ * not a number any merchant's books, tax return or ad platform recognises.
+ *
+ * Getting this backwards is the expensive mistake: reporting platform net into
+ * a merchant's property would show every merchant on Aglyn a revenue figure a
+ * few percent of their real one.
+ *
+ * ## Tax is excluded, and no `tax` param is sent
+ *
+ * Tax collected is money held for a taxing authority, not revenue, whoever
+ * holds it — and on a storefront that is often Aglyn rather than the merchant,
+ * since Terms §10.7 makes Aglyn a marketplace facilitator where applicable law
+ * gives it a collection obligation (AGL-1956). Either way it is not the
+ * merchant's sales revenue. Every mature ecommerce integration reports revenue
+ * ex-tax and so do we.
+ *
+ * No GA4 `tax` param either, following AGL-1639 for the same reason it applied
+ * there: `value` already EXCLUDES tax, and GA4's `tax` is documented as a cost
+ * associated with the transaction — a component of the value beside it. Sent
+ * next to an ex-tax `value` it asserts a relationship that does not hold, and
+ * invites exactly the subtraction that would double-remove it.
+ *
+ * ## Why `value` derives from `totalCents` and not from the parts
+ *
+ * `totalCents` is overwritten with Stripe's `amount_total` when the webhook
+ * writes the order (`billing-webhook.ts`), so it is the one field that
+ * reconciles with Stripe by construction: it is Stripe's own number, verbatim.
+ *
+ * `taxCents` was described here as likewise `total_details.amount_tax`, Stripe's
+ * own. On the cart path it is. On the BUY-NOW path it was 0 on every order,
+ * because `checkout.ts` sends manual destination tax as an ordinary
+ * `line_items[1]` product line that Stripe never classifies as tax — so this
+ * `value` reported tax-inclusive gross into the merchant's property, the
+ * AGL-1639 overstatement, live. AGL-1711 composes the stored `taxCents` from
+ * `amount_tax` plus that line-item tax, and fixes `quantity` and
+ * `unitAmountCents` (hardcoded to 1 and to the whole charge) in the same place.
+ * Nothing here changed: the three fields this reads are simply true now.
+ *
+ * The parts used NOT to reconcile, and that is why this derivation exists.
+ * `computeOrderTotals` was called with `feeCents`, `taxCents` and
+ * `discountCents` but **never `shippingCents`**, so a stored `OrderTotals`
+ * recorded `shippingCents: 0` on every online order while the shipping the
+ * shopper paid sat inside `amount_total`. Building `value` from
+ * `itemsCents + shippingCents - discountCents` would therefore have silently
+ * dropped all shipping revenue, understating orders that carried it and
+ * leaving orders that did not looking correct. Same failure shape as the
+ * AGL-1639 overstatement, opposite sign.
+ *
+ * AGL-1698 fixed the storage — `computeCheckoutSessionTotals` passes
+ * `total_details.amount_shipping`, and the parts now sum to the total. The
+ * derivation stays on `totalCents` anyway, for a reason that outlives the bug:
+ * `totalCents` is Stripe's `amount_total` verbatim, whereas `itemsCents` is
+ * priced from the host's product docs, so a price edit between session
+ * creation and webhook delivery would make our sum disagree with the charge.
+ *
+ * ## A GA4 `shipping` param IS sent — and a `tax` one still is not
+ *
+ * These two look like an inconsistency and are not. Do not tidy them into
+ * agreement in either direction (AGL-1722).
+ *
+ * `shipping` is a COMPONENT of the `value` reported beside it: `value` is
+ * `totalCents - taxCents`, and the shipping the shopper paid is inside that
+ * number. GA4's `shipping` is documented as exactly that — shipping charged
+ * ON the transaction — so sending it decomposes the value rather than
+ * contradicting it, and a merchant can read "of the $105 you sold, $10 was
+ * shipping" without any figure being counted twice.
+ *
+ * `tax` is the opposite: `value` already EXCLUDES it. Sending a `tax` beside
+ * an ex-tax `value` asserts a relationship that does not hold and invites the
+ * subtraction that removes tax a second time. AGL-1639 and AGL-1641 both
+ * declined it for that reason and this change does not disturb them.
+ *
+ * The param was withheld until now for a truthfulness reason that has since
+ * expired twice. AGL-1641 left it out because the stored `shippingCents` was
+ * structurally 0 — sending it would have asserted FREE SHIPPING on every
+ * order rather than saying nothing. AGL-1698 fixed the storage but the Stripe
+ * figure was still structurally 0, because no Checkout Session we created
+ * declared `shipping_options`. AGL-1707 wired the merchant's configured zones
+ * and rates into the cart session and AGL-1720 into the buy-now one, so
+ * `amount_shipping` is a real number on both storefront paths for a merchant
+ * who set shipping up. Only the plumbing was left, and it is built here:
+ * `shippingCents` rides `StorefrontPurchaseSource` to the wire shape.
+ *
+ * A 0 now means what it says. A download ships nothing, a merchant who saved
+ * no rates charges nothing, and POS and draft orders resolve no shipping — on
+ * all of those `shipping: 0` is a true statement about that order, not the old
+ * structural zero, so it is sent rather than omitted. Omitting it would leave
+ * the merchant's shipping column sparse for a reason GA cannot tell apart from
+ * "not tracked".
+ *
+ * ## Worked example — the spec fixture
+ *
+ * A $100 item, a $5 coupon, $10 shipping chosen at Stripe Checkout, $9.08 tax,
+ * and a 5% Aglyn fee:
+ *
+ *   itemsCents            10000   line snapshot
+ *   - discountCents         500   Stripe `total_details.amount_discount`
+ *   + shippingCents        1000   Stripe `total_details.amount_shipping`
+ *   + taxCents              908   Stripe `total_details.amount_tax`
+ *   = totalCents          11408   Stripe `amount_total`, verbatim
+ *   - taxCents            - 908   held for the state, not revenue
+ *   = GA `value`          10500   sent as 105.00 (goods 95.00 + shipping 10.00)
+ *     GA `shipping`        1000   sent as 10.00 — INSIDE the 105.00 above, a
+ *                                 decomposition of it and not an addition
+ *     GA `tax`               —    not sent; `value` is already ex-tax
+ *
+ *   feeCents                475   Aglyn's cut — NOT subtracted; the merchant's
+ *                                 cost of sale, and our revenue is reported in
+ *                                 OUR property by the subscription/marketplace
+ *                                 `purchase`, not by this one.
+ *
+ * Before AGL-1698 the stored parts summed to 10408, not 11408: the 1000 gap was
+ * the shipping, and it is exactly what a parts-based `value` would have lost.
+ * They reconcile now, which `commerce-orders.spec.ts` pins; the guard below
+ * survives as a guard, since the derivation must not drift back to the parts.
+ *
+ * Returns `null` when there is nothing truthful to send — no transaction id,
+ * or a non-positive value. A dropped event is a gap in the merchant's report;
+ * a fabricated one is a wrong number in it, and the second is worse.
+ */
+export declare function buildStorefrontPurchaseParams(source: StorefrontPurchaseSource): AnalyticsEventParams['purchase'] | null;
+/**
+ * Reduce a stored order to the wire shape above. Server-side only — it reads
+ * fields the projection exists to withhold.
+ */
+export declare function toStorefrontPurchaseSource(transactionId: string, order: Pick<HostOrder, 'totals' | 'lineItems'>): StorefrontPurchaseSource;