@aglyn/plugins-commerce 1.0.0-beta.143

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/commerce-dispute.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 { HostOrder, OrderDispute } from './commerce-orders'\n\n/**\n * Reading a chargeback back out of an order (AGL-1796).\n *\n * AGL-1787 decided that a lost dispute leaves the order `status: 'refunded'`,\n * because five entitlement gates match that literal and a new status would\n * have escaped all of them. The cost of that decision is paid HERE: a merchant\n * opening the order sees \"Refunded\", the one word that says they chose it.\n * The distinction rides on the `dispute` record beside the status, and these\n * are the pure readers that turn it back into something a console can say.\n *\n * Kept out of `commerce-orders.ts` on the same principle the model directory\n * already follows — cart, discounts, shipping and tax each own a file — and\n * because this is presentation-shaped: it answers \"what should the merchant be\n * told\", not \"what is true of the order\".\n *\n * Dates render as `YYYY-MM-DD` through `toISOString`, which is what the\n * webhook's own timeline entries do. Deterministic, and the console shows\n * these strings beside those entries.\n */\n\n/**\n * Stripe dispute statuses that mean it is over.\n *\n * `warning_*` statuses belong to an inquiry that has not become a dispute yet;\n * `warning_closed` is the one that ends. The other `warning_*` values\n * (`warning_needs_response`, `warning_under_review`) are OPEN, which is why\n * this is a settled-list rather than a \"starts with warning\" test.\n */\nconst SETTLED_DISPUTE_STATUSES = new Set(['won', 'lost', 'warning_closed'])\n\n/** How the merchant should read a dispute at a glance. */\nexport type OrderDisputeTone = 'open' | 'lost' | 'won' | 'settled'\n\n/**\n * A dispute Stripe has not decided yet — the case with a DEADLINE attached.\n *\n * Three independent signals, all of which must say \"open\", because saying\n * \"evidence due\" about a settled dispute is the one error with a cost: it\n * sends a merchant to gather documents for a case that is closed. `outcome`\n * and `closedAtMs` are both written by `charge.dispute.closed` and `status` is\n * overwritten with the outcome, so a record that disagrees with itself is\n * malformed — and this resolves a malformed record to \"settled\", the answer\n * that cannot waste anyone's afternoon.\n *\n * Note `evidenceDueByMs` is NOT one of the signals: Stripe sends\n * `evidence_details.due_by` on the `closed` event too, so a closed dispute\n * still carries a deadline and testing for one would report every settled\n * dispute as open.\n */\nexport function isOrderDisputeOpen(dispute?: OrderDispute): boolean {\n  if (!dispute) return false\n  if (dispute.outcome) return false\n  if (dispute.closedAtMs) return false\n  return !SETTLED_DISPUTE_STATUSES.has(String(dispute.status ?? ''))\n}\n\n/** Whether this order has a dispute still running against it. */\nexport function orderHasOpenDispute(\n  order: Pick<HostOrder, 'dispute'>,\n): boolean {\n  return isOrderDisputeOpen(order?.dispute)\n}\n\n/**\n * The OPEN statuses that belong to an INQUIRY — the pre-dispute phase, where\n * no chargeback exists yet and no funds have been pulled.\n *\n * An explicit list rather than a \"starts with warning\" test, for the same\n * reason as `SETTLED_DISPUTE_STATUSES` above: `warning_closed` also starts\n * with `warning`, and an unknown future status must not be mistaken for a\n * refundable inquiry by its prefix.\n */\nconst OPEN_INQUIRY_STATUSES = new Set([\n  'warning_needs_response',\n  'warning_under_review',\n])\n\n/**\n * Whether a refund on this order must be REFUSED because of its dispute\n * (AGL-1809).\n *\n * Not the same question as `orderHasOpenDispute`, and the difference is the\n * whole decision. A formal open dispute (`needs_response`, `under_review`)\n * means the bank has already pulled the disputed funds and Stripe's refund\n * API refuses the charge outright (`charge_disputed` — \"The charge you're\n * attempting to refund has been charged back\"); a refund alongside it would\n * pay the shopper twice, once by the refund and once by the chargeback. An\n * open INQUIRY is the opposite case: no money has moved, Stripe permits the\n * refund, and its docs name \"issuing a full refund\" as the way to resolve an\n * inquiry before it escalates — refusing that would forbid the recommended\n * exit. Settled disputes refuse nothing here: a lost one already moved the\n * order to `refunded` (the status guard's job), and a won or closed one left\n * the charge refundable again.\n *\n * An open dispute whose status is unrecognised blocks — on a question of\n * sending money twice, an unknown state fails closed.\n */\nexport function orderDisputeBlocksRefund(\n  order: Pick<HostOrder, 'dispute'>,\n): boolean {\n  if (!orderHasOpenDispute(order)) return false\n  return !OPEN_INQUIRY_STATUSES.has(String(order.dispute?.status ?? ''))\n}\n\n/** What the console renders beside an order's status when a dispute exists. */\nexport interface OrderDisputeBadge {\n  tone: OrderDisputeTone\n  /** Short chip label, e.g. `Chargeback open`, `Charged back`. */\n  label: string\n  /** A sentence for the tooltip: reason, amount, deadline or outcome. */\n  detail: string\n  /** The deadline, present ONLY while the dispute is open. */\n  evidenceDueByMs?: number\n  /**\n   * Whole days until evidence is due, negative once the deadline has passed.\n   * Present only alongside `evidenceDueByMs`.\n   */\n  evidenceDaysLeft?: number\n}\n\n/** `product_not_received` reads as `product not received`. */\nfunction humanReason(reason?: string): string {\n  return String(reason ?? '')\n    .replace(/_/g, ' ')\n    .trim()\n}\n\nconst isoDay = (ms: number) => new Date(ms).toISOString().slice(0, 10)\n\nconst usd = (cents: number) => `$${(Math.max(0, cents) / 100).toFixed(2)}`\n\n/**\n * The badge for an order's dispute, or `null` when there is none.\n *\n * `nowMs` is a parameter rather than a `Date.now()` call so the deadline\n * arithmetic is testable without freezing the clock.\n */\nexport function describeOrderDispute(\n  order: Pick<HostOrder, 'dispute'>,\n  nowMs: number = Date.now(),\n): OrderDisputeBadge | null {\n  const dispute = order?.dispute\n  if (!dispute) return null\n  const reason = humanReason(dispute.reason)\n  const because = reason ? ` (${reason})` : ''\n\n  if (isOrderDisputeOpen(dispute)) {\n    const dueBy = Number(dispute.evidenceDueByMs ?? 0)\n    // `Math.ceil` so a deadline eight hours away reads as \"1 day left\" rather\n    // than \"0\" — rounding a live deadline down to zero reads as expired.\n    const daysLeft =\n      dueBy > 0 ? Math.ceil((dueBy - nowMs) / 86_400_000) : undefined\n    return {\n      tone: 'open',\n      label: 'Chargeback open',\n      detail:\n        `${usd(dispute.amountCents)} disputed${because}, opened ` +\n        `${isoDay(dispute.openedAtMs)}. ` +\n        (dueBy > 0\n          ? `Evidence is due to Stripe by ${isoDay(dueBy)}` +\n            (daysLeft !== undefined && daysLeft >= 0\n              ? ` — ${daysLeft} day${daysLeft === 1 ? '' : 's'} left.`\n              : ' — that deadline has passed.')\n          : 'Respond in the Stripe dashboard while the case is open.'),\n      ...(dueBy > 0\n        ? { evidenceDueByMs: dueBy, evidenceDaysLeft: daysLeft }\n        : {}),\n    }\n  }\n\n  const outcome = String(dispute.outcome ?? dispute.status ?? '')\n  const closed = dispute.closedAtMs ? ` on ${isoDay(dispute.closedAtMs)}` : ''\n  if (outcome === 'lost') {\n    const reversed = Number(dispute.reversedCents ?? 0)\n    return {\n      tone: 'lost',\n      label: 'Charged back',\n      // The reversed figure can be LESS than the disputed one: AGL-1787 caps\n      // the reversal against what is left, so a partly-refunded order loses\n      // only the remainder. Saying only the disputed amount would overstate\n      // what left the merchant's books.\n      detail:\n        `Dispute lost${closed}. ${usd(reversed)} was taken back` +\n        `${because}` +\n        (reversed < dispute.amountCents\n          ? ` (of ${usd(dispute.amountCents)} disputed — the rest was already refunded).`\n          : '.'),\n    }\n  }\n  if (outcome === 'won') {\n    return {\n      tone: 'won',\n      label: 'Dispute won',\n      detail: `Dispute won${closed}${because} — no money was reversed.`,\n    }\n  }\n  return {\n    tone: 'settled',\n    label: 'Dispute closed',\n    detail:\n      `Dispute closed${closed}${because}` +\n      (outcome ? ` as ${humanReason(outcome)}` : '') +\n      ' — no money was reversed.',\n  }\n}\n\n/** What the orders list needs to raise the alarm, over a window of orders. */\nexport interface OpenDisputeSummary {\n  /** Orders with a dispute still running. */\n  count: number\n  /** The soonest evidence deadline among them, when any carries one. */\n  soonestDueByMs?: number\n  /** Whole days to `soonestDueByMs`; negative once it has passed. */\n  soonestDaysLeft?: number\n  /** True when at least one deadline is already behind us. */\n  overdue: boolean\n}\n\n/**\n * Count the open disputes in a window of orders and find the tightest\n * deadline (AGL-1796).\n *\n * A filter only helps a merchant who already suspects there is something to\n * filter FOR, and an evidence window is days long — so the orders list has to\n * say it unprompted. Computed over every loaded order rather than the visible\n * ones: a merchant filtered to \"delivered\" still needs to know a dispute is\n * running on a `paid` one.\n */\nexport function summariseOpenDisputes(\n  orders: ReadonlyArray<Pick<HostOrder, 'dispute'>>,\n  nowMs: number = Date.now(),\n): OpenDisputeSummary {\n  let count = 0\n  let soonestDueByMs: number | undefined\n  for (const order of orders ?? []) {\n    if (!orderHasOpenDispute(order)) continue\n    count += 1\n    const dueBy = Number(order.dispute?.evidenceDueByMs ?? 0)\n    if (dueBy > 0 && (soonestDueByMs === undefined || dueBy < soonestDueByMs)) {\n      soonestDueByMs = dueBy\n    }\n  }\n  if (soonestDueByMs === undefined) return { count, overdue: false }\n  const soonestDaysLeft = Math.ceil((soonestDueByMs - nowMs) / 86_400_000)\n  return {\n    count,\n    soonestDueByMs,\n    soonestDaysLeft,\n    overdue: soonestDueByMs < nowMs,\n  }\n}\n\n/** Money off this order, split by the door it left through. */\nexport interface OrderReversalSplit {\n  /** Cents refunded by a decision the merchant made. */\n  refundedCents: number\n  /** Cents taken back by a lost chargeback. */\n  chargedBackCents: number\n}\n\n/**\n * Split `order.refundedCents` into the part the merchant chose and the part\n * a chargeback took.\n *\n * AGL-1787 writes BOTH into `refundedCents`, deliberately — money reversed is\n * money reversed, and the CSV, the analytics card and the member drawer all\n * want the total. Only the label needs the split, and `dispute.reversedCents`\n * is the piece to subtract.\n *\n * The chargeback share is clamped to the recorded total, so a `reversedCents`\n * larger than `refundedCents` (which can only mean the two fields disagree)\n * yields a zero refund line rather than a negative one.\n */\nexport function splitOrderReversal(\n  order: Pick<HostOrder, 'refundedCents' | 'dispute'>,\n): OrderReversalSplit {\n  const total = Math.max(0, Number(order?.refundedCents ?? 0) || 0)\n  const chargedBackCents = Math.min(\n    total,\n    Math.max(0, Number(order?.dispute?.reversedCents ?? 0) || 0),\n  )\n  return { refundedCents: total - chargedBackCents, chargedBackCents }\n}\n"],"names":["SETTLED_DISPUTE_STATUSES","Set","isOrderDisputeOpen","dispute","outcome","closedAtMs","has","String","status","orderHasOpenDispute","order","OPEN_INQUIRY_STATUSES","orderDisputeBlocksRefund","humanReason","reason","replace","trim","isoDay","ms","Date","toISOString","slice","usd","cents","Math","max","toFixed","describeOrderDispute","nowMs","now","because","dueBy","Number","evidenceDueByMs","daysLeft","ceil","undefined","tone","label","detail","amountCents","openedAtMs","evidenceDaysLeft","closed","reversed","reversedCents","summariseOpenDisputes","orders","count","soonestDueByMs","overdue","soonestDaysLeft","splitOrderReversal","total","refundedCents","chargedBackCents","min"],"mappings":"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"}

package/src/lib/model/commerce-gift-cards.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @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.
+ */
+/**
+ * Gift-card hold arithmetic (AGL-2449).
+ *
+ * A gift card is CASH, and until this module existed it was the one limited
+ * resource in the order path with no reserve at all. `cart-checkout.ts` read
+ * `balanceCents` with a plain `.get()`, minted a Stripe coupon for that much,
+ * and the webhook decremented the card minutes later with a bare
+ * `FieldValue.increment(-N)`. The increment is atomic, so nothing was ever
+ * LOST — but nothing ever CHECKED either, so two checkouts entering the same
+ * code both read $50, both got $50 off, and the card settled at `-$50`. The
+ * merchant shipped $100 of goods against a $50 card, and the outstanding
+ * liability total went negative — the exact corruption `redeemExistingOrRecord`
+ * already reasons about for a DELETED card, arriving through a live one.
+ *
+ * The stock fix (AGL-2320) could not be copied here: stock is decremented after
+ * the money has moved and therefore cannot refuse, so it locks and reports the
+ * shortfall. A gift card is applied BEFORE Stripe is contacted, so this door can
+ * still say no — and refusing is the only thing that actually keeps the money.
+ *
+ * So the balance is HELD at checkout and SETTLED at the webhook, both in one
+ * transaction against one document. Holds live in a map on the card itself
+ * keyed by Stripe session id, which is what keeps this to a single-document
+ * transaction: no fan-out, no second collection, no index.
+ *
+ * ## Why holds expire rather than being swept
+ *
+ * An abandoned checkout must not stand a customer's money off indefinitely, and
+ * a sweep job is the wrong instrument: `process-abandoned.ts` is the only
+ * existing sweep and it returns 501 when SMTP is unconfigured, so a
+ * release that depended on it would not run at all for a self-hosted store with
+ * no mail transport. Instead every hold carries `expiresAtMs` and EVERY read
+ * prunes, so the release is a consequence of the next read rather than of a job
+ * that may never run. A card nobody touches again holds nothing that matters,
+ * because nobody is reading it either.
+ *
+ * The TTL matches Stripe's Checkout Session lifetime rather than something
+ * shorter. A hold that lapsed while its session was still payable would reopen
+ * the very window this closes — the shopper pays a session whose hold has
+ * evaporated and the balance is spent twice again.
+ */
+/** One in-flight claim on a card's balance, keyed by Stripe session id. */
+export interface GiftCardHold {
+    cents: number;
+    expiresAtMs: number;
+}
+/** `hosts/{hostId}/giftCards/{code}` doc, as far as redemption cares. */
+export interface HostGiftCard {
+    balanceCents?: number;
+    /** Session id → hold. Absent on every card issued before AGL-2449. */
+    holds?: Record<string, GiftCardHold>;
+    voidedAtMs?: number;
+}
+/**
+ * Stripe Checkout Sessions expire 24h after creation, so a hold outlives any
+ * session that can still be paid. See the module docblock for why a shorter
+ * TTL is not the safer choice it looks like.
+ */
+export declare const GIFT_CARD_HOLD_TTL_MS: number;
+/**
+ * The card's holds with the lapsed ones dropped.
+ *
+ * Total, not a filter over a trusted shape: a hold whose `expiresAtMs` is
+ * absent or non-numeric is treated as EXPIRED rather than eternal, so a
+ * malformed row releases the money instead of stranding it. The one direction
+ * that cannot be wrong is the one that keeps a customer from spending their own
+ * balance forever.
+ */
+export declare function pruneGiftCardHolds(holds: Record<string, GiftCardHold> | undefined, nowMs: number): Record<string, GiftCardHold>;
+/**
+ * What a NEW checkout may apply: the balance less every hold still standing.
+ *
+ * Never negative. A card whose holds already exceed its balance (possible only
+ * on a card voided mid-flight, where the console zeroes `balanceCents` while
+ * holds stand) reads as empty rather than as a debt to be collected.
+ */
+export declare function giftCardAvailableCents(card: HostGiftCard | undefined, nowMs: number): number;
+/**
+ * What settling `sessionId` should actually take off the card.
+ *
+ * Capped at the live balance, not at the hold, and that is the point of the
+ * function. The hold is what this session RESERVED; the balance is what the
+ * card can still give up. They diverge when the card was voided or hand-adjusted
+ * between the hold and the payment, and in that window paying out the hold would
+ * drive the balance negative — reintroducing the corrupted liability aggregate
+ * from the other side.
+ *
+ * A session with no hold settles ZERO. That is the redelivery case (the first
+ * delivery consumed it) and the pre-AGL-2449 case (a session that predates
+ * holds), and both must be no-ops rather than a second decrement.
+ */
+export declare function giftCardSettlementCents(card: HostGiftCard | undefined, sessionId: string, _nowMs: number): number;

package/src/lib/model/commerce-gift-cards.js

@@ -0,0 +1,121 @@
+/**
+ * @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.
+ */ /**
+ * Gift-card hold arithmetic (AGL-2449).
+ *
+ * A gift card is CASH, and until this module existed it was the one limited
+ * resource in the order path with no reserve at all. `cart-checkout.ts` read
+ * `balanceCents` with a plain `.get()`, minted a Stripe coupon for that much,
+ * and the webhook decremented the card minutes later with a bare
+ * `FieldValue.increment(-N)`. The increment is atomic, so nothing was ever
+ * LOST — but nothing ever CHECKED either, so two checkouts entering the same
+ * code both read $50, both got $50 off, and the card settled at `-$50`. The
+ * merchant shipped $100 of goods against a $50 card, and the outstanding
+ * liability total went negative — the exact corruption `redeemExistingOrRecord`
+ * already reasons about for a DELETED card, arriving through a live one.
+ *
+ * The stock fix (AGL-2320) could not be copied here: stock is decremented after
+ * the money has moved and therefore cannot refuse, so it locks and reports the
+ * shortfall. A gift card is applied BEFORE Stripe is contacted, so this door can
+ * still say no — and refusing is the only thing that actually keeps the money.
+ *
+ * So the balance is HELD at checkout and SETTLED at the webhook, both in one
+ * transaction against one document. Holds live in a map on the card itself
+ * keyed by Stripe session id, which is what keeps this to a single-document
+ * transaction: no fan-out, no second collection, no index.
+ *
+ * ## Why holds expire rather than being swept
+ *
+ * An abandoned checkout must not stand a customer's money off indefinitely, and
+ * a sweep job is the wrong instrument: `process-abandoned.ts` is the only
+ * existing sweep and it returns 501 when SMTP is unconfigured, so a
+ * release that depended on it would not run at all for a self-hosted store with
+ * no mail transport. Instead every hold carries `expiresAtMs` and EVERY read
+ * prunes, so the release is a consequence of the next read rather than of a job
+ * that may never run. A card nobody touches again holds nothing that matters,
+ * because nobody is reading it either.
+ *
+ * The TTL matches Stripe's Checkout Session lifetime rather than something
+ * shorter. A hold that lapsed while its session was still payable would reopen
+ * the very window this closes — the shopper pays a session whose hold has
+ * evaporated and the balance is spent twice again.
+ */ /** One in-flight claim on a card's balance, keyed by Stripe session id. */ /**
+ * Stripe Checkout Sessions expire 24h after creation, so a hold outlives any
+ * session that can still be paid. See the module docblock for why a shorter
+ * TTL is not the safer choice it looks like.
+ */ export const GIFT_CARD_HOLD_TTL_MS = 24 * 60 * 60 * 1000;
+/** One money figure off an untrusted document, as whole non-negative cents. */ function cents(value) {
+    const number = Math.round(Number(value));
+    return Number.isFinite(number) && number > 0 ? number : 0;
+}
+/**
+ * The card's holds with the lapsed ones dropped.
+ *
+ * Total, not a filter over a trusted shape: a hold whose `expiresAtMs` is
+ * absent or non-numeric is treated as EXPIRED rather than eternal, so a
+ * malformed row releases the money instead of stranding it. The one direction
+ * that cannot be wrong is the one that keeps a customer from spending their own
+ * balance forever.
+ */ export function pruneGiftCardHolds(holds, nowMs) {
+    const live = {};
+    for (const [sessionId, hold] of Object.entries(holds != null ? holds : {})){
+        const expiresAtMs = Number(hold == null ? void 0 : hold.expiresAtMs);
+        if (!Number.isFinite(expiresAtMs) || expiresAtMs <= nowMs) continue;
+        const amount = cents(hold == null ? void 0 : hold.cents);
+        if (amount > 0) live[sessionId] = {
+            cents: amount,
+            expiresAtMs
+        };
+    }
+    return live;
+}
+/**
+ * What a NEW checkout may apply: the balance less every hold still standing.
+ *
+ * Never negative. A card whose holds already exceed its balance (possible only
+ * on a card voided mid-flight, where the console zeroes `balanceCents` while
+ * holds stand) reads as empty rather than as a debt to be collected.
+ */ export function giftCardAvailableCents(card, nowMs) {
+    const held = Object.values(pruneGiftCardHolds(card == null ? void 0 : card.holds, nowMs)).reduce((sum, hold)=>sum + hold.cents, 0);
+    return Math.max(0, cents(card == null ? void 0 : card.balanceCents) - held);
+}
+/**
+ * What settling `sessionId` should actually take off the card.
+ *
+ * Capped at the live balance, not at the hold, and that is the point of the
+ * function. The hold is what this session RESERVED; the balance is what the
+ * card can still give up. They diverge when the card was voided or hand-adjusted
+ * between the hold and the payment, and in that window paying out the hold would
+ * drive the balance negative — reintroducing the corrupted liability aggregate
+ * from the other side.
+ *
+ * A session with no hold settles ZERO. That is the redelivery case (the first
+ * delivery consumed it) and the pre-AGL-2449 case (a session that predates
+ * holds), and both must be no-ops rather than a second decrement.
+ */ export function giftCardSettlementCents(card, sessionId, // Deliberately unused, and kept so this reads as the sibling of
+// `giftCardAvailableCents` at every call site. The asymmetry IS the rule
+// below: availability is a question about now, settlement is not.
+_nowMs) {
+    var _ref;
+    // NOT pruned: a hold that lapsed while its session sat unpaid is still owed
+    // once that session is paid. Expiry governs what a NEW checkout may claim,
+    // never whether a completed payment is honoured — dropping it here would take
+    // the discount from the shopper and give nothing back to the merchant.
+    const hold = ((_ref = card == null ? void 0 : card.holds) != null ? _ref : {})[sessionId];
+    return Math.min(cents(hold == null ? void 0 : hold.cents), cents(card == null ? void 0 : card.balanceCents));
+}
+
+//# sourceMappingURL=commerce-gift-cards.js.map

package/src/lib/model/commerce-gift-cards.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/commerce-gift-cards.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 * Gift-card hold arithmetic (AGL-2449).\n *\n * A gift card is CASH, and until this module existed it was the one limited\n * resource in the order path with no reserve at all. `cart-checkout.ts` read\n * `balanceCents` with a plain `.get()`, minted a Stripe coupon for that much,\n * and the webhook decremented the card minutes later with a bare\n * `FieldValue.increment(-N)`. The increment is atomic, so nothing was ever\n * LOST — but nothing ever CHECKED either, so two checkouts entering the same\n * code both read $50, both got $50 off, and the card settled at `-$50`. The\n * merchant shipped $100 of goods against a $50 card, and the outstanding\n * liability total went negative — the exact corruption `redeemExistingOrRecord`\n * already reasons about for a DELETED card, arriving through a live one.\n *\n * The stock fix (AGL-2320) could not be copied here: stock is decremented after\n * the money has moved and therefore cannot refuse, so it locks and reports the\n * shortfall. A gift card is applied BEFORE Stripe is contacted, so this door can\n * still say no — and refusing is the only thing that actually keeps the money.\n *\n * So the balance is HELD at checkout and SETTLED at the webhook, both in one\n * transaction against one document. Holds live in a map on the card itself\n * keyed by Stripe session id, which is what keeps this to a single-document\n * transaction: no fan-out, no second collection, no index.\n *\n * ## Why holds expire rather than being swept\n *\n * An abandoned checkout must not stand a customer's money off indefinitely, and\n * a sweep job is the wrong instrument: `process-abandoned.ts` is the only\n * existing sweep and it returns 501 when SMTP is unconfigured, so a\n * release that depended on it would not run at all for a self-hosted store with\n * no mail transport. Instead every hold carries `expiresAtMs` and EVERY read\n * prunes, so the release is a consequence of the next read rather than of a job\n * that may never run. A card nobody touches again holds nothing that matters,\n * because nobody is reading it either.\n *\n * The TTL matches Stripe's Checkout Session lifetime rather than something\n * shorter. A hold that lapsed while its session was still payable would reopen\n * the very window this closes — the shopper pays a session whose hold has\n * evaporated and the balance is spent twice again.\n */\n\n/** One in-flight claim on a card's balance, keyed by Stripe session id. */\nexport interface GiftCardHold {\n  cents: number\n  expiresAtMs: number\n}\n\n/** `hosts/{hostId}/giftCards/{code}` doc, as far as redemption cares. */\nexport interface HostGiftCard {\n  balanceCents?: number\n  /** Session id → hold. Absent on every card issued before AGL-2449. */\n  holds?: Record<string, GiftCardHold>\n  voidedAtMs?: number\n}\n\n/**\n * Stripe Checkout Sessions expire 24h after creation, so a hold outlives any\n * session that can still be paid. See the module docblock for why a shorter\n * TTL is not the safer choice it looks like.\n */\nexport const GIFT_CARD_HOLD_TTL_MS = 24 * 60 * 60 * 1000\n\n/** One money figure off an untrusted document, as whole non-negative cents. */\nfunction cents(value: unknown): number {\n  const number = Math.round(Number(value))\n  return Number.isFinite(number) && number > 0 ? number : 0\n}\n\n/**\n * The card's holds with the lapsed ones dropped.\n *\n * Total, not a filter over a trusted shape: a hold whose `expiresAtMs` is\n * absent or non-numeric is treated as EXPIRED rather than eternal, so a\n * malformed row releases the money instead of stranding it. The one direction\n * that cannot be wrong is the one that keeps a customer from spending their own\n * balance forever.\n */\nexport function pruneGiftCardHolds(\n  holds: Record<string, GiftCardHold> | undefined,\n  nowMs: number,\n): Record<string, GiftCardHold> {\n  const live: Record<string, GiftCardHold> = {}\n  for (const [sessionId, hold] of Object.entries(holds ?? {})) {\n    const expiresAtMs = Number(hold?.expiresAtMs)\n    if (!Number.isFinite(expiresAtMs) || expiresAtMs <= nowMs) continue\n    const amount = cents(hold?.cents)\n    if (amount > 0) live[sessionId] = { cents: amount, expiresAtMs }\n  }\n  return live\n}\n\n/**\n * What a NEW checkout may apply: the balance less every hold still standing.\n *\n * Never negative. A card whose holds already exceed its balance (possible only\n * on a card voided mid-flight, where the console zeroes `balanceCents` while\n * holds stand) reads as empty rather than as a debt to be collected.\n */\nexport function giftCardAvailableCents(\n  card: HostGiftCard | undefined,\n  nowMs: number,\n): number {\n  const held = Object.values(pruneGiftCardHolds(card?.holds, nowMs)).reduce(\n    (sum, hold) => sum + hold.cents,\n    0,\n  )\n  return Math.max(0, cents(card?.balanceCents) - held)\n}\n\n/**\n * What settling `sessionId` should actually take off the card.\n *\n * Capped at the live balance, not at the hold, and that is the point of the\n * function. The hold is what this session RESERVED; the balance is what the\n * card can still give up. They diverge when the card was voided or hand-adjusted\n * between the hold and the payment, and in that window paying out the hold would\n * drive the balance negative — reintroducing the corrupted liability aggregate\n * from the other side.\n *\n * A session with no hold settles ZERO. That is the redelivery case (the first\n * delivery consumed it) and the pre-AGL-2449 case (a session that predates\n * holds), and both must be no-ops rather than a second decrement.\n */\nexport function giftCardSettlementCents(\n  card: HostGiftCard | undefined,\n  sessionId: string,\n  // Deliberately unused, and kept so this reads as the sibling of\n  // `giftCardAvailableCents` at every call site. The asymmetry IS the rule\n  // below: availability is a question about now, settlement is not.\n  _nowMs: number,\n): number {\n  // NOT pruned: a hold that lapsed while its session sat unpaid is still owed\n  // once that session is paid. Expiry governs what a NEW checkout may claim,\n  // never whether a completed payment is honoured — dropping it here would take\n  // the discount from the shopper and give nothing back to the merchant.\n  const hold = (card?.holds ?? {})[sessionId]\n  return Math.min(cents(hold?.cents), cents(card?.balanceCents))\n}\n"],"names":["GIFT_CARD_HOLD_TTL_MS","cents","value","number","Math","round","Number","isFinite","pruneGiftCardHolds","holds","nowMs","live","sessionId","hold","Object","entries","expiresAtMs","amount","giftCardAvailableCents","card","held","values","reduce","sum","max","balanceCents","giftCardSettlementCents","_nowMs","min"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCC,GAED,yEAAyE,GAczE;;;;CAIC,GACD,OAAO,MAAMA,wBAAwB,KAAK,KAAK,KAAK,KAAI;AAExD,6EAA6E,GAC7E,SAASC,MAAMC,KAAc;IAC3B,MAAMC,SAASC,KAAKC,KAAK,CAACC,OAAOJ;IACjC,OAAOI,OAAOC,QAAQ,CAACJ,WAAWA,SAAS,IAAIA,SAAS;AAC1D;AAEA;;;;;;;;CAQC,GACD,OAAO,SAASK,mBACdC,KAA+C,EAC/CC,KAAa;IAEb,MAAMC,OAAqC,CAAC;IAC5C,KAAK,MAAM,CAACC,WAAWC,KAAK,IAAIC,OAAOC,OAAO,CAACN,gBAAAA,QAAS,CAAC,GAAI;QAC3D,MAAMO,cAAcV,OAAOO,wBAAAA,KAAMG,WAAW;QAC5C,IAAI,CAACV,OAAOC,QAAQ,CAACS,gBAAgBA,eAAeN,OAAO;QAC3D,MAAMO,SAAShB,MAAMY,wBAAAA,KAAMZ,KAAK;QAChC,IAAIgB,SAAS,GAAGN,IAAI,CAACC,UAAU,GAAG;YAAEX,OAAOgB;YAAQD;QAAY;IACjE;IACA,OAAOL;AACT;AAEA;;;;;;CAMC,GACD,OAAO,SAASO,uBACdC,IAA8B,EAC9BT,KAAa;IAEb,MAAMU,OAAON,OAAOO,MAAM,CAACb,mBAAmBW,wBAAAA,KAAMV,KAAK,EAAEC,QAAQY,MAAM,CACvE,CAACC,KAAKV,OAASU,MAAMV,KAAKZ,KAAK,EAC/B;IAEF,OAAOG,KAAKoB,GAAG,CAAC,GAAGvB,MAAMkB,wBAAAA,KAAMM,YAAY,IAAIL;AACjD;AAEA;;;;;;;;;;;;;CAaC,GACD,OAAO,SAASM,wBACdP,IAA8B,EAC9BP,SAAiB,EACjB,gEAAgE;AAChE,yEAAyE;AACzE,kEAAkE;AAClEe,MAAc;;IAEd,4EAA4E;IAC5E,2EAA2E;IAC3E,8EAA8E;IAC9E,uEAAuE;IACvE,MAAMd,OAAO,SAACM,wBAAAA,KAAMV,KAAK,mBAAI,CAAC,EAAE,CAACG,UAAU;IAC3C,OAAOR,KAAKwB,GAAG,CAAC3B,MAAMY,wBAAAA,KAAMZ,KAAK,GAAGA,MAAMkB,wBAAAA,KAAMM,YAAY;AAC9D"}

package/src/lib/model/commerce-io.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @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.
+ */
+/**
+ * Catalog CSV import/export (AGL-282) speaking Shopify's product CSV
+ * dialect — the migration wedge for switchers: `Handle` groups variant
+ * rows into one product, `Option1..3 Name/Value` build the option axes,
+ * `Variant *` columns carry per-variant data, and repeated-handle rows
+ * with only `Image Src` add media. Export mirrors the same columns so
+ * round-trips are lossless for the fields both sides share.
+ */
+import { type HostProduct } from './commerce';
+export declare const PRODUCT_CSV_HEADER: readonly ["Handle", "Title", "Body (HTML)", "Type", "Tags", "Published", "Option1 Name", "Option1 Value", "Option2 Name", "Option2 Value", "Option3 Name", "Option3 Value", "Variant SKU", "Variant Barcode", "Variant Price", "Variant Compare At Price", "Variant Inventory Qty", "Variant Grams", "Image Src"];
+/** One row per variant; extra image rows follow Shopify's convention. */
+export declare function productsToCsv(products: Array<HostProduct & {
+    $id?: string;
+}>): string;
+export interface ProductCsvImport {
+    products: HostProduct[];
+    /** Row-anchored problems; importable products still parse. */
+    errors: string[];
+}
+export declare function parseProductsCsv(text: string): ProductCsvImport;

package/src/lib/model/commerce-io.js

@@ -0,0 +1,245 @@
+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.
+ */ /**
+ * Catalog CSV import/export (AGL-282) speaking Shopify's product CSV
+ * dialect — the migration wedge for switchers: `Handle` groups variant
+ * rows into one product, `Option1..3 Name/Value` build the option axes,
+ * `Variant *` columns carry per-variant data, and repeated-handle rows
+ * with only `Image Src` add media. Export mirrors the same columns so
+ * round-trips are lossless for the fields both sides share.
+ */ import { commerceSlug, validateProduct } from "./commerce.js";
+import { parseCsv } from "@aglyn/aglyn/app-utils/dataset-csv";
+export const PRODUCT_CSV_HEADER = [
+    'Handle',
+    'Title',
+    'Body (HTML)',
+    'Type',
+    'Tags',
+    'Published',
+    'Option1 Name',
+    'Option1 Value',
+    'Option2 Name',
+    'Option2 Value',
+    'Option3 Name',
+    'Option3 Value',
+    'Variant SKU',
+    'Variant Barcode',
+    'Variant Price',
+    'Variant Compare At Price',
+    'Variant Inventory Qty',
+    'Variant Grams',
+    'Image Src'
+];
+function csvCell(value) {
+    const text = value == null ? '' : String(value);
+    return /[",\n]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
+}
+/** One row per variant; extra image rows follow Shopify's convention. */ export function productsToCsv(products) {
+    const lines = [
+        PRODUCT_CSV_HEADER.join(',')
+    ];
+    for (const product of products){
+        var _product_options, _product_mediaUrls;
+        const options = (_product_options = product.options) != null ? _product_options : [];
+        product.variants.forEach((variant, index)=>{
+            var _product_description, _product_tags, _variant_sku, _variant_barcode, _variant_compareAtPriceUsd, _variant_inventory, _variant_weightGrams, _ref;
+            var _product_mediaUrls;
+            const optionCells = [];
+            for(let axis = 0; axis < 3; axis += 1){
+                var _ref1, _ref2;
+                var _variant_options;
+                const option = options[axis];
+                optionCells.push(index === 0 ? (_ref1 = option == null ? void 0 : option.name) != null ? _ref1 : '' : '', option ? (_ref2 = (_variant_options = variant.options) == null ? void 0 : _variant_options[option.name]) != null ? _ref2 : '' : '');
+            }
+            lines.push([
+                csvCell(product.slug),
+                csvCell(index === 0 ? product.name : ''),
+                csvCell(index === 0 ? (_product_description = product.description) != null ? _product_description : '' : ''),
+                csvCell(index === 0 ? product.type : ''),
+                csvCell(index === 0 ? ((_product_tags = product.tags) != null ? _product_tags : []).join(', ') : ''),
+                csvCell(index === 0 ? String(product.status === 'active') : ''),
+                ...optionCells.map(csvCell),
+                csvCell((_variant_sku = variant.sku) != null ? _variant_sku : ''),
+                csvCell((_variant_barcode = variant.barcode) != null ? _variant_barcode : ''),
+                csvCell(variant.priceUsd),
+                csvCell((_variant_compareAtPriceUsd = variant.compareAtPriceUsd) != null ? _variant_compareAtPriceUsd : ''),
+                csvCell((_variant_inventory = variant.inventory) != null ? _variant_inventory : ''),
+                csvCell((_variant_weightGrams = variant.weightGrams) != null ? _variant_weightGrams : ''),
+                csvCell(index === 0 ? (_ref = (_product_mediaUrls = product.mediaUrls) == null ? void 0 : _product_mediaUrls[0]) != null ? _ref : '' : '')
+            ].join(','));
+        });
+        for (const url of ((_product_mediaUrls = product.mediaUrls) != null ? _product_mediaUrls : []).slice(1)){
+            lines.push([
+                csvCell(product.slug),
+                ...Array(PRODUCT_CSV_HEADER.length - 2).fill(''),
+                csvCell(url)
+            ].join(','));
+        }
+    }
+    return lines.join('\n');
+}
+/** Case-insensitive column lookup so hand-edited headers still map. */ function headerIndex(header) {
+    const map = new Map();
+    header.forEach((cell, index)=>map.set(cell.trim().toLowerCase(), index));
+    return map;
+}
+export function parseProductsCsv(text) {
+    const rows = parseCsv(text);
+    if (rows.length < 2) {
+        return {
+            products: [],
+            errors: [
+                'No data rows found'
+            ]
+        };
+    }
+    const columns = headerIndex(rows[0]);
+    const cell = (row, name)=>{
+        var _row_index;
+        const index = columns.get(name.toLowerCase());
+        return index == null ? '' : ((_row_index = row[index]) != null ? _row_index : '').trim();
+    };
+    if (!columns.has('handle') || !columns.has('title')) {
+        return {
+            products: [],
+            errors: [
+                'Missing required columns: Handle, Title'
+            ]
+        };
+    }
+    const byHandle = new Map();
+    const errors = [];
+    rows.slice(1).forEach((row, rowIndex)=>{
+        var _product_mediaUrls;
+        const line = rowIndex + 2;
+        const handle = commerceSlug(cell(row, 'handle'));
+        if (!handle) {
+            if (row.some((value)=>value.trim())) {
+                errors.push(`Row ${line}: missing Handle`);
+            }
+            return;
+        }
+        let product = byHandle.get(handle);
+        const title = cell(row, 'title');
+        if (!product) {
+            if (!title) {
+                // Image-only continuation row for a product we never saw.
+                errors.push(`Row ${line}: first row for "${handle}" needs a Title`);
+                return;
+            }
+            const published = cell(row, 'published').toLowerCase();
+            const type = cell(row, 'type').toLowerCase();
+            product = {
+                name: title,
+                slug: handle,
+                description: cell(row, 'body (html)') || undefined,
+                type: [
+                    'physical',
+                    'digital',
+                    'service'
+                ].includes(type) ? type : 'physical',
+                status: published === 'false' ? 'draft' : 'active',
+                tags: cell(row, 'tags') ? cell(row, 'tags').split(',').map((tag)=>tag.trim()).filter(Boolean) : undefined,
+                options: [],
+                variants: [],
+                mediaUrls: []
+            };
+            byHandle.set(handle, product);
+        }
+        const imageSrc = cell(row, 'image src');
+        if (imageSrc && !((_product_mediaUrls = product.mediaUrls) != null ? _product_mediaUrls : []).includes(imageSrc)) {
+            var _product_mediaUrls1;
+            product.mediaUrls = [
+                ...(_product_mediaUrls1 = product.mediaUrls) != null ? _product_mediaUrls1 : [],
+                imageSrc
+            ];
+        }
+        const priceRaw = cell(row, 'variant price');
+        const hasVariant = priceRaw !== '' || cell(row, 'variant sku') !== '';
+        if (!hasVariant) return;
+        const options = {};
+        for(let axis = 1; axis <= 3; axis += 1){
+            var _product_options_;
+            const name = cell(row, `option${axis} name`);
+            const value = cell(row, `option${axis} value`);
+            if (name && product.options[axis - 1] == null) {
+                product.options[axis - 1] = {
+                    name,
+                    values: []
+                };
+            }
+            const optionName = (_product_options_ = product.options[axis - 1]) == null ? void 0 : _product_options_.name;
+            if (optionName && value) {
+                options[optionName] = value;
+                const axisOption = product.options[axis - 1];
+                if (!axisOption.values.includes(value)) {
+                    axisOption.values.push(value);
+                }
+            }
+        }
+        const price = Number(priceRaw);
+        if (!Number.isFinite(price) || price < 0) {
+            errors.push(`Row ${line}: invalid Variant Price "${priceRaw}"`);
+            return;
+        }
+        const qtyRaw = cell(row, 'variant inventory qty');
+        const compareRaw = cell(row, 'variant compare at price');
+        const gramsRaw = cell(row, 'variant grams');
+        const variant = _extends({
+            id: `v${product.variants.length + 1}`
+        }, Object.keys(options).length ? {
+            options
+        } : {}, {
+            priceUsd: price
+        }, cell(row, 'variant sku') ? {
+            sku: cell(row, 'variant sku')
+        } : {}, cell(row, 'variant barcode') ? {
+            barcode: cell(row, 'variant barcode')
+        } : {}, compareRaw && Number.isFinite(Number(compareRaw)) ? {
+            compareAtPriceUsd: Number(compareRaw)
+        } : {}, {
+            inventory: qtyRaw === '' ? null : Math.max(0, Math.round(Number(qtyRaw)))
+        }, gramsRaw && Number.isFinite(Number(gramsRaw)) ? {
+            weightGrams: Number(gramsRaw)
+        } : {});
+        product.variants.push(variant);
+    });
+    const products = [];
+    for (const [handle, product] of byHandle){
+        var _product_options, _ref;
+        var _product_mediaUrls;
+        product.options = ((_product_options = product.options) != null ? _product_options : []).filter(Boolean);
+        if (product.options.length === 0) delete product.options;
+        if (((_ref = (_product_mediaUrls = product.mediaUrls) == null ? void 0 : _product_mediaUrls.length) != null ? _ref : 0) === 0) delete product.mediaUrls;
+        if (product.variants.length === 0) {
+            errors.push(`"${handle}": no variant rows (needs Variant Price)`);
+            continue;
+        }
+        const problem = validateProduct(product);
+        if (problem) {
+            errors.push(`"${handle}": ${problem}`);
+            continue;
+        }
+        products.push(product);
+    }
+    return {
+        products,
+        errors
+    };
+}
+
+//# sourceMappingURL=commerce-io.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/commerce-io.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 * Catalog CSV import/export (AGL-282) speaking Shopify's product CSV\n * dialect — the migration wedge for switchers: `Handle` groups variant\n * rows into one product, `Option1..3 Name/Value` build the option axes,\n * `Variant *` columns carry per-variant data, and repeated-handle rows\n * with only `Image Src` add media. Export mirrors the same columns so\n * round-trips are lossless for the fields both sides share.\n */\n\nimport {\n  commerceSlug,\n  validateProduct,\n  type HostProduct,\n  type ProductOption,\n  type ProductStatus,\n  type ProductVariant,\n} from './commerce'\nimport { parseCsv } from '@aglyn/aglyn/app-utils/dataset-csv'\n\nexport const PRODUCT_CSV_HEADER = [\n  'Handle',\n  'Title',\n  'Body (HTML)',\n  'Type',\n  'Tags',\n  'Published',\n  'Option1 Name',\n  'Option1 Value',\n  'Option2 Name',\n  'Option2 Value',\n  'Option3 Name',\n  'Option3 Value',\n  'Variant SKU',\n  'Variant Barcode',\n  'Variant Price',\n  'Variant Compare At Price',\n  'Variant Inventory Qty',\n  'Variant Grams',\n  'Image Src',\n] as const\n\nfunction csvCell(value: unknown): string {\n  const text = value == null ? '' : String(value)\n  return /[\",\\n]/.test(text) ? `\"${text.replace(/\"/g, '\"\"')}\"` : text\n}\n\n/** One row per variant; extra image rows follow Shopify's convention. */\nexport function productsToCsv(\n  products: Array<HostProduct & { $id?: string }>,\n): string {\n  const lines = [PRODUCT_CSV_HEADER.join(',')]\n  for (const product of products) {\n    const options = product.options ?? []\n    product.variants.forEach((variant, index) => {\n      const optionCells: string[] = []\n      for (let axis = 0; axis < 3; axis += 1) {\n        const option = options[axis]\n        optionCells.push(\n          index === 0 ? (option?.name ?? '') : '',\n          option ? (variant.options?.[option.name] ?? '') : '',\n        )\n      }\n      lines.push(\n        [\n          csvCell(product.slug),\n          csvCell(index === 0 ? product.name : ''),\n          csvCell(index === 0 ? (product.description ?? '') : ''),\n          csvCell(index === 0 ? product.type : ''),\n          csvCell(index === 0 ? (product.tags ?? []).join(', ') : ''),\n          csvCell(index === 0 ? String(product.status === 'active') : ''),\n          ...optionCells.map(csvCell),\n          csvCell(variant.sku ?? ''),\n          csvCell(variant.barcode ?? ''),\n          csvCell(variant.priceUsd),\n          csvCell(variant.compareAtPriceUsd ?? ''),\n          csvCell(variant.inventory ?? ''),\n          csvCell(variant.weightGrams ?? ''),\n          csvCell(index === 0 ? (product.mediaUrls?.[0] ?? '') : ''),\n        ].join(','),\n      )\n    })\n    for (const url of (product.mediaUrls ?? []).slice(1)) {\n      lines.push(\n        [\n          csvCell(product.slug),\n          ...Array(PRODUCT_CSV_HEADER.length - 2).fill(''),\n          csvCell(url),\n        ].join(','),\n      )\n    }\n  }\n  return lines.join('\\n')\n}\n\nexport interface ProductCsvImport {\n  products: HostProduct[]\n  /** Row-anchored problems; importable products still parse. */\n  errors: string[]\n}\n\n/** Case-insensitive column lookup so hand-edited headers still map. */\nfunction headerIndex(header: string[]): Map<string, number> {\n  const map = new Map<string, number>()\n  header.forEach((cell, index) =>\n    map.set(cell.trim().toLowerCase(), index),\n  )\n  return map\n}\n\nexport function parseProductsCsv(text: string): ProductCsvImport {\n  const rows = parseCsv(text)\n  if (rows.length < 2) {\n    return { products: [], errors: ['No data rows found'] }\n  }\n  const columns = headerIndex(rows[0])\n  const cell = (row: string[], name: string): string => {\n    const index = columns.get(name.toLowerCase())\n    return index == null ? '' : (row[index] ?? '').trim()\n  }\n  if (!columns.has('handle') || !columns.has('title')) {\n    return {\n      products: [],\n      errors: ['Missing required columns: Handle, Title'],\n    }\n  }\n\n  const byHandle = new Map<string, HostProduct>()\n  const errors: string[] = []\n  rows.slice(1).forEach((row, rowIndex) => {\n    const line = rowIndex + 2\n    const handle = commerceSlug(cell(row, 'handle'))\n    if (!handle) {\n      if (row.some((value) => value.trim())) {\n        errors.push(`Row ${line}: missing Handle`)\n      }\n      return\n    }\n    let product = byHandle.get(handle)\n    const title = cell(row, 'title')\n    if (!product) {\n      if (!title) {\n        // Image-only continuation row for a product we never saw.\n        errors.push(`Row ${line}: first row for \"${handle}\" needs a Title`)\n        return\n      }\n      const published = cell(row, 'published').toLowerCase()\n      const type = cell(row, 'type').toLowerCase()\n      product = {\n        name: title,\n        slug: handle,\n        description: cell(row, 'body (html)') || undefined,\n        type: ['physical', 'digital', 'service'].includes(type)\n          ? (type as HostProduct['type'])\n          : 'physical',\n        status: (published === 'false'\n          ? 'draft'\n          : 'active') as ProductStatus,\n        tags: cell(row, 'tags')\n          ? cell(row, 'tags')\n              .split(',')\n              .map((tag) => tag.trim())\n              .filter(Boolean)\n          : undefined,\n        options: [],\n        variants: [],\n        mediaUrls: [],\n      }\n      byHandle.set(handle, product)\n    }\n\n    const imageSrc = cell(row, 'image src')\n    if (imageSrc && !(product.mediaUrls ?? []).includes(imageSrc)) {\n      product.mediaUrls = [...(product.mediaUrls ?? []), imageSrc]\n    }\n\n    const priceRaw = cell(row, 'variant price')\n    const hasVariant = priceRaw !== '' || cell(row, 'variant sku') !== ''\n    if (!hasVariant) return\n\n    const options: Record<string, string> = {}\n    for (let axis = 1; axis <= 3; axis += 1) {\n      const name = cell(row, `option${axis} name`)\n      const value = cell(row, `option${axis} value`)\n      if (name && product.options![axis - 1] == null) {\n        product.options![axis - 1] = { name, values: [] }\n      }\n      const optionName = product.options![axis - 1]?.name\n      if (optionName && value) {\n        options[optionName] = value\n        const axisOption = product.options![axis - 1] as ProductOption\n        if (!axisOption.values.includes(value)) {\n          axisOption.values.push(value)\n        }\n      }\n    }\n\n    const price = Number(priceRaw)\n    if (!Number.isFinite(price) || price < 0) {\n      errors.push(`Row ${line}: invalid Variant Price \"${priceRaw}\"`)\n      return\n    }\n    const qtyRaw = cell(row, 'variant inventory qty')\n    const compareRaw = cell(row, 'variant compare at price')\n    const gramsRaw = cell(row, 'variant grams')\n    const variant: ProductVariant = {\n      id: `v${product.variants.length + 1}`,\n      ...(Object.keys(options).length ? { options } : {}),\n      priceUsd: price,\n      ...(cell(row, 'variant sku') ? { sku: cell(row, 'variant sku') } : {}),\n      ...(cell(row, 'variant barcode')\n        ? { barcode: cell(row, 'variant barcode') }\n        : {}),\n      ...(compareRaw && Number.isFinite(Number(compareRaw))\n        ? { compareAtPriceUsd: Number(compareRaw) }\n        : {}),\n      inventory: qtyRaw === '' ? null : Math.max(0, Math.round(Number(qtyRaw))),\n      ...(gramsRaw && Number.isFinite(Number(gramsRaw))\n        ? { weightGrams: Number(gramsRaw) }\n        : {}),\n    }\n    product.variants.push(variant)\n  })\n\n  const products: HostProduct[] = []\n  for (const [handle, product] of byHandle) {\n    product.options = (product.options ?? []).filter(Boolean)\n    if (product.options.length === 0) delete product.options\n    if ((product.mediaUrls?.length ?? 0) === 0) delete product.mediaUrls\n    if (product.variants.length === 0) {\n      errors.push(`\"${handle}\": no variant rows (needs Variant Price)`)\n      continue\n    }\n    const problem = validateProduct(product)\n    if (problem) {\n      errors.push(`\"${handle}\": ${problem}`)\n      continue\n    }\n    products.push(product)\n  }\n  return { products, errors }\n}\n"],"names":["commerceSlug","validateProduct","parseCsv","PRODUCT_CSV_HEADER","csvCell","value","text","String","test","replace","productsToCsv","products","lines","join","product","options","variants","forEach","variant","index","optionCells","axis","option","push","name","slug","description","type","tags","status","map","sku","barcode","priceUsd","compareAtPriceUsd","inventory","weightGrams","mediaUrls","url","slice","Array","length","fill","headerIndex","header","Map","cell","set","trim","toLowerCase","parseProductsCsv","rows","errors","columns","row","get","has","byHandle","rowIndex","line","handle","some","title","published","undefined","includes","split","tag","filter","Boolean","imageSrc","priceRaw","hasVariant","values","optionName","axisOption","price","Number","isFinite","qtyRaw","compareRaw","gramsRaw","id","Object","keys","Math","max","round","problem"],"mappings":"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"}