@aglyn/plugins-commerce 1.0.0-beta.230 → 1.0.0-beta.232

package/src/lib/server/channel-order-updates.js

@@ -0,0 +1,290 @@
+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 { createResourceUid } from "@aglyn/aglyn/app-utils/create-resource-uid";
+import { firebaseAdmin } from "@aglyn/tenant-data-admin/server/firebase-admin";
+import * as CommerceModel from "../model/index.js";
+import { ORDER_FULFILLED_EVENT, ORDER_REFUNDED_EVENT } from "../model/order-events.js";
+import { createHash } from "node:crypto";
+import { fulfillmentEventView, stageOrderEvent } from "./order-events.js";
+import { restockCapKey, saleReleaseCaps } from "./restock-flag.js";
+const DOC_ID = /^[A-Za-z0-9_-]{1,200}$/;
+const MAX_CENTS = 10000000000;
+const HANDOFF_KEY = 'channel-handoff';
+/** Refund ids kept on an order: far more than any channel sends for one. */ const MAX_REFUND_IDS = 100;
+const restockKey = restockCapKey;
+/** The hand-off's fulfillment id: one per order, so a second report finds the first. */ const handoffFulfillmentId = (orderId)=>`f-${createHash('sha256').update(`${orderId}:${HANDOFF_KEY}`).digest('hex').slice(0, 20)}`;
+const defaultDeps = ()=>({
+        firestore: ()=>firebaseAdmin.app().firestore(),
+        now: Date.now
+    });
+const clip = (value, max)=>String(value != null ? value : '').trim().slice(0, max);
+const validIds = (hostId, recordId)=>DOC_ID.test(String(hostId != null ? hostId : '')) && DOC_ID.test(String(recordId != null ? recordId : '')) && !/^__.*__$/.test(String(hostId)) && !/^__.*__$/.test(String(recordId));
+/** The channel's courier took the order: every open unit is fulfilled, with nothing shipped from here. */ export async function completeChannelOrder(request, deps = defaultDeps()) {
+    if (!validIds(request == null ? void 0 : request.hostId, request == null ? void 0 : request.recordId)) return {
+        outcome: 'no_such_record'
+    };
+    const firestore = deps.firestore();
+    const orderRef = firestore.collection('hosts').doc(request.hostId).collection('orders').doc(request.recordId);
+    const nowMs = deps.now();
+    const fulfillmentId = handoffFulfillmentId(request.recordId);
+    return firestore.runTransaction(async (transaction)=>{
+        var _snapshot_data, _order_fulfillments, _order_fulfillments1, _snapshot_data1;
+        const snapshot = await transaction.get(orderRef);
+        if (!snapshot.exists) return {
+            outcome: 'no_such_record'
+        };
+        const order = CommerceModel.liftLegacyOrder((_snapshot_data = snapshot.data()) != null ? _snapshot_data : {});
+        if (order.channel !== 'marketplace' || !order.channelSource) return {
+            outcome: 'not_completable',
+            status: order.status
+        };
+        if (((_order_fulfillments = order.fulfillments) != null ? _order_fulfillments : []).some((entry)=>entry.id === fulfillmentId)) return {
+            outcome: 'already'
+        };
+        if (order.status === 'fulfilled' || order.status === 'delivered') return {
+            outcome: 'already'
+        };
+        if (!CommerceModel.canTransitionOrder(order.status, 'fulfilled')) {
+            return {
+                outcome: 'not_completable',
+                status: order.status
+            };
+        }
+        let lines = CommerceModel.remainingFulfillmentLines(order);
+        if (!lines.length) {
+            lines = CommerceModel.orderLineFulfillmentStates(order).filter((state)=>state.remainingQuantity > 0).map((state)=>({
+                    lineItemId: state.lineItemId,
+                    quantity: state.remainingQuantity
+                }));
+        }
+        const carrier = clip(order.channelSource.channelLabel, 40) || 'Courier';
+        const fulfillment = {
+            id: fulfillmentId,
+            lineItemIds: lines.map((entry)=>entry.lineItemId),
+            lines,
+            carrier,
+            status: 'active',
+            // The channel tells its own buyer; nobody is emailed from here.
+            notify: false,
+            atMs: nowMs
+        };
+        const patch = {
+            status: 'fulfilled',
+            fulfillments: [
+                ...(_order_fulfillments1 = order.fulfillments) != null ? _order_fulfillments1 : [],
+                fulfillment
+            ],
+            updatedAtMs: nowMs,
+            timeline: CommerceModel.appendOrderEvent(order, 'fulfilled', clip(request.note, 200) || `Picked up by the ${carrier} courier`, nowMs)
+        };
+        transaction.update(orderRef, patch);
+        stageOrderEvent(transaction, ORDER_FULFILLED_EVENT, {
+            hostId: request.hostId,
+            orderId: request.recordId,
+            key: fulfillment.id,
+            order: _extends({}, (_snapshot_data1 = snapshot.data()) != null ? _snapshot_data1 : {}, patch),
+            extra: {
+                fulfillment: fulfillmentEventView(order, fulfillment)
+            }
+        });
+        return {
+            outcome: 'completed'
+        };
+    });
+}
+/**
+ * What the order's sale took off each shelf, less what has gone back since
+ * (a cancel's or an earlier adjustment's rows): the most a restock may still
+ * return, by product and variant.
+ */ function remainingReleaseCaps(rows) {
+    const caps = saleReleaseCaps(rows.filter((row)=>row.get('reason') === 'sale'));
+    for (const row of rows){
+        var _ref, _row_get, _row_get1, _row_get2, _caps_get;
+        const reason = row.get('reason');
+        if (reason !== 'refund' && reason !== 'cancellation') continue;
+        const delta = Number((_ref = (_row_get = row.get('appliedDelta')) != null ? _row_get : row.get('delta')) != null ? _ref : 0);
+        if (!(delta > 0)) continue;
+        const key = restockKey(String((_row_get1 = row.get('productId')) != null ? _row_get1 : ''), String((_row_get2 = row.get('variantId')) != null ? _row_get2 : ''));
+        if (caps.has(key)) caps.set(key, Math.max(0, ((_caps_get = caps.get(key)) != null ? _caps_get : 0) - delta));
+    }
+    return caps;
+}
+/** The channel refunded its buyer or took items off the order: recorded once, with the named units back on the shelf. */ export async function recordChannelOrderRefund(request, deps = defaultDeps()) {
+    if (!validIds(request == null ? void 0 : request.hostId, request == null ? void 0 : request.recordId)) return {
+        outcome: 'no_such_record'
+    };
+    const refundId = clip(request.refundId, 200);
+    if (!refundId) return {
+        outcome: 'refused',
+        reason: 'The refund has no id on its channel.'
+    };
+    const amount = Number(request.amountCents);
+    if (!Number.isInteger(amount) || amount < 0 || amount > MAX_CENTS) {
+        return {
+            outcome: 'refused',
+            reason: 'The refund is not a whole amount.'
+        };
+    }
+    const asked = (Array.isArray(request.restock) ? request.restock : []).map((entry)=>({
+            lineIndex: Number(entry == null ? void 0 : entry.lineIndex),
+            quantity: Number(entry == null ? void 0 : entry.quantity)
+        })).filter((entry)=>Number.isInteger(entry.lineIndex) && entry.lineIndex >= 0 && Number.isInteger(entry.quantity) && entry.quantity > 0);
+    if (amount === 0 && !asked.length) return {
+        outcome: 'refused',
+        reason: 'The refund moves no money and no stock.'
+    };
+    const firestore = deps.firestore();
+    const hostRef = firestore.collection('hosts').doc(request.hostId);
+    const orderRef = hostRef.collection('orders').doc(request.recordId);
+    const nowMs = deps.now();
+    return firestore.runTransaction(async (transaction)=>{
+        var _snapshot_data, _source_refundIds, _order_lineItems, _ref, _ref1, _order_refundedCents, _source_refundIds1;
+        var _order_totals;
+        const snapshot = await transaction.get(orderRef);
+        if (!snapshot.exists) return {
+            outcome: 'no_such_record'
+        };
+        const order = CommerceModel.liftLegacyOrder((_snapshot_data = snapshot.data()) != null ? _snapshot_data : {});
+        const source = order.channelSource;
+        if (order.channel !== 'marketplace' || !source) return {
+            outcome: 'no_such_record'
+        };
+        if (((_source_refundIds = source.refundIds) != null ? _source_refundIds : []).includes(refundId)) return {
+            outcome: 'already'
+        };
+        // Every read before any write: the ledger, then each product a restock touches.
+        const lineItems = (_order_lineItems = order.lineItems) != null ? _order_lineItems : [];
+        const wanted = new Map();
+        for (const entry of asked){
+            var _wanted_get;
+            const line = lineItems[entry.lineIndex];
+            if (!(line == null ? void 0 : line.productId) || !line.variantId || /^__.*__$/.test(line.productId)) continue;
+            wanted.set(entry.lineIndex, Math.min(Number(line.quantity) || 0, ((_wanted_get = wanted.get(entry.lineIndex)) != null ? _wanted_get : 0) + entry.quantity));
+        }
+        const rows = wanted.size ? (await transaction.get(hostRef.collection('inventoryAdjustments').where('orderId', '==', request.recordId))).docs : [];
+        const caps = remainingReleaseCaps(rows);
+        const productIds = [
+            ...new Set([
+                ...wanted.keys()
+            ].map((index)=>lineItems[index].productId))
+        ];
+        const productSnaps = await Promise.all(productIds.map((id)=>transaction.get(hostRef.collection('products').doc(id))));
+        const products = new Map();
+        productSnaps.forEach((product, index)=>{
+            if (product.exists && !product.get('deletedAt')) {
+                products.set(productIds[index], CommerceModel.liftLegacyProduct(product.data()));
+            }
+        });
+        let restockedUnits = 0;
+        const restockedLines = [];
+        const ledger = [];
+        const changed = new Set();
+        for (const [lineIndex, quantity] of wanted){
+            var _caps_get;
+            const line = lineItems[lineIndex];
+            const product = products.get(line.productId);
+            const variantId = String(line.variantId);
+            const variant = product == null ? void 0 : product.variants.find((entry)=>entry.id === variantId);
+            if (!product || !variant || variant.inventory == null) continue;
+            const key = restockKey(line.productId, variantId);
+            // A pair the ledger never recorded a sale for gave up nothing to return.
+            const budget = (_caps_get = caps.get(key)) != null ? _caps_get : 0;
+            const back = Math.min(quantity, budget);
+            if (back <= 0) continue;
+            caps.set(key, budget - back);
+            products.set(line.productId, _extends({}, product, {
+                variants: CommerceModel.adjustVariantInventory(product, variantId, back)
+            }));
+            changed.add(line.productId);
+            restockedUnits += back;
+            restockedLines.push(lineIndex);
+            ledger.push({
+                productId: line.productId,
+                variantId,
+                delta: back,
+                reason: 'refund',
+                orderId: request.recordId,
+                source: source.channelLabel,
+                atMs: nowMs
+            });
+        }
+        const total = Number((_ref = (_ref1 = (_order_totals = order.totals) == null ? void 0 : _order_totals.totalCents) != null ? _ref1 : order.amountCents) != null ? _ref : 0);
+        const before = Number((_order_refundedCents = order.refundedCents) != null ? _order_refundedCents : 0);
+        const recorded = Math.max(0, Math.min(amount, total - before));
+        const refundedCents = before + recorded;
+        const full = total > 0 && refundedCents >= total;
+        let status = order.status;
+        if (full && status !== 'refunded' && CommerceModel.canTransitionOrder(status, 'refunded')) status = 'refunded';
+        for (const productId of changed){
+            const product = products.get(productId);
+            transaction.update(hostRef.collection('products').doc(productId), _extends({
+                variants: product.variants
+            }, CommerceModel.productStockFields(product), {
+                updatedAtMs: nowMs
+            }));
+        }
+        for (const row of ledger)transaction.set(hostRef.collection('inventoryAdjustments').doc(createResourceUid()), row);
+        const money = (cents)=>`${(cents / 100).toFixed(2)} ${source.currency}`;
+        const reason = clip(request.reason, 200) || `Refunded on ${source.channelLabel}`;
+        const parts = [
+            recorded > 0 ? `${reason}: ${money(recorded)} refunded by ${source.channelLabel}` : reason,
+            ...recorded < amount ? [
+                `${money(amount - recorded)} more than the order had left was not recorded`
+            ] : [],
+            ...restockedUnits > 0 ? [
+                `${restockedUnits} ${restockedUnits === 1 ? 'unit' : 'units'} returned to stock`
+            ] : []
+        ];
+        const patch = {
+            status,
+            refundedCents,
+            channelSource: _extends({}, source, {
+                refundIds: [
+                    ...(_source_refundIds1 = source.refundIds) != null ? _source_refundIds1 : [],
+                    refundId
+                ].slice(-MAX_REFUND_IDS)
+            }),
+            updatedAtMs: nowMs,
+            timeline: CommerceModel.appendOrderEvent(order, 'refund', `${parts.join('. ')}.`, nowMs)
+        };
+        transaction.update(orderRef, patch);
+        if (recorded > 0) {
+            var _snapshot_data1;
+            stageOrderEvent(transaction, ORDER_REFUNDED_EVENT, {
+                hostId: request.hostId,
+                orderId: request.recordId,
+                key: `refund:channel:${refundId}`,
+                order: _extends({}, (_snapshot_data1 = snapshot.data()) != null ? _snapshot_data1 : {}, patch),
+                extra: {
+                    refund: {
+                        id: null,
+                        amountCents: recorded,
+                        lineItemIds: restockedLines,
+                        full
+                    }
+                }
+            });
+        }
+        return {
+            outcome: 'recorded',
+            refundedCents,
+            restockedUnits
+        };
+    });
+}
+
+//# sourceMappingURL=channel-order-updates.js.map

package/src/lib/server/channel-order-updates.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/server/channel-order-updates.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 { createResourceUid } from '@aglyn/aglyn/app-utils/create-resource-uid'\nimport type {\n  PluginChannelOrderHandoff,\n  PluginChannelOrderHandoffOutcome,\n  PluginChannelOrderRefund,\n  PluginChannelOrderRefundOutcome,\n} from '@aglyn/aglyn/plugin-manager/plugin-channel-orders'\nimport { firebaseAdmin } from '@aglyn/tenant-data-admin/server/firebase-admin'\nimport * as CommerceModel from '../model'\nimport { ORDER_FULFILLED_EVENT, ORDER_REFUNDED_EVENT } from '../model/order-events'\nimport { createHash } from 'node:crypto'\nimport { fulfillmentEventView, stageOrderEvent } from './order-events'\nimport { restockCapKey, saleReleaseCaps } from './restock-flag'\n\n/**\n * WHAT A CHANNEL SAYS AFTER ITS ORDER CAME IN (AGL-3644): commerce's half of\n * `completeOrder` and `recordRefund` on core's `core.channel-orders`.\n *\n * A delivery app's order is handed to its own courier over the counter, and\n * the app — not the store — refunds its buyer or takes an item off the order.\n * So, for an order the channel sent (`channel: 'marketplace'`):\n *\n * - **A hand-off** closes the order as fulfilled with one fulfillment for\n *   every unit still open, carrying the channel as its carrier and no\n *   tracking: nothing was shipped from here. Keyed, so a second report of the\n *   same pickup writes nothing.\n * - **A refund or adjustment** is RECORDED: `refundedCents` grows by the\n *   amount (never past the order's total), the order is `refunded` once the\n *   whole of it is, and the channel's id for it is kept so the same report\n *   twice records once. No money moves: the channel refunded its own buyer.\n *   Units the channel names as never having left go back on the shelf, at\n *   most what the order's own sale took less what was already put back —\n *   the ledger bound the console's cancel uses.\n *\n * Each is ONE transaction that reads the order (and, for a restock, each\n * product) before it writes, and stages its order event in the same write.\n */\n\ntype Firestore = FirebaseFirestore.Firestore\n\nconst DOC_ID = /^[A-Za-z0-9_-]{1,200}$/\nconst MAX_CENTS = 100_000_000_00\nconst HANDOFF_KEY = 'channel-handoff'\n/** Refund ids kept on an order: far more than any channel sends for one. */\nconst MAX_REFUND_IDS = 100\n\nconst restockKey = restockCapKey\n\n/** The hand-off's fulfillment id: one per order, so a second report finds the first. */\nconst handoffFulfillmentId = (orderId: string) =>\n  `f-${createHash('sha256').update(`${orderId}:${HANDOFF_KEY}`).digest('hex').slice(0, 20)}`\n\nexport interface ChannelOrderUpdateDeps {\n  firestore: () => Firestore\n  now: () => number\n}\n\nconst defaultDeps = (): ChannelOrderUpdateDeps => ({ firestore: () => firebaseAdmin.app().firestore(), now: Date.now })\n\nconst clip = (value: unknown, max: number): string => String(value ?? '').trim().slice(0, max)\n\nconst validIds = (hostId: unknown, recordId: unknown): boolean =>\n  DOC_ID.test(String(hostId ?? '')) &&\n  DOC_ID.test(String(recordId ?? '')) &&\n  !/^__.*__$/.test(String(hostId)) &&\n  !/^__.*__$/.test(String(recordId))\n\n/** The channel's courier took the order: every open unit is fulfilled, with nothing shipped from here. */\nexport async function completeChannelOrder(\n  request: PluginChannelOrderHandoff,\n  deps: ChannelOrderUpdateDeps = defaultDeps(),\n): Promise<PluginChannelOrderHandoffOutcome> {\n  if (!validIds(request?.hostId, request?.recordId)) return { outcome: 'no_such_record' }\n  const firestore = deps.firestore()\n  const orderRef = firestore.collection('hosts').doc(request.hostId).collection('orders').doc(request.recordId)\n  const nowMs = deps.now()\n  const fulfillmentId = handoffFulfillmentId(request.recordId)\n  return firestore.runTransaction(async (transaction): Promise<PluginChannelOrderHandoffOutcome> => {\n    const snapshot = await transaction.get(orderRef)\n    if (!snapshot.exists) return { outcome: 'no_such_record' }\n    const order = CommerceModel.liftLegacyOrder((snapshot.data() ?? {}) as never)\n    if (order.channel !== 'marketplace' || !order.channelSource) return { outcome: 'not_completable', status: order.status }\n    if ((order.fulfillments ?? []).some((entry) => entry.id === fulfillmentId)) return { outcome: 'already' }\n    if (order.status === 'fulfilled' || order.status === 'delivered') return { outcome: 'already' }\n    if (!CommerceModel.canTransitionOrder(order.status, 'fulfilled')) {\n      return { outcome: 'not_completable', status: order.status }\n    }\n    let lines = CommerceModel.remainingFulfillmentLines(order)\n    if (!lines.length) {\n      lines = CommerceModel.orderLineFulfillmentStates(order)\n        .filter((state) => state.remainingQuantity > 0)\n        .map((state) => ({ lineItemId: state.lineItemId, quantity: state.remainingQuantity }))\n    }\n    const carrier = clip(order.channelSource.channelLabel, 40) || 'Courier'\n    const fulfillment: CommerceModel.OrderFulfillment = {\n      id: fulfillmentId,\n      lineItemIds: lines.map((entry) => entry.lineItemId),\n      lines,\n      carrier,\n      status: 'active',\n      // The channel tells its own buyer; nobody is emailed from here.\n      notify: false,\n      atMs: nowMs,\n    }\n    const patch = {\n      status: 'fulfilled' as const,\n      fulfillments: [...(order.fulfillments ?? []), fulfillment],\n      updatedAtMs: nowMs,\n      timeline: CommerceModel.appendOrderEvent(\n        order,\n        'fulfilled',\n        clip(request.note, 200) || `Picked up by the ${carrier} courier`,\n        nowMs,\n      ),\n    }\n    transaction.update(orderRef, patch)\n    stageOrderEvent(transaction, ORDER_FULFILLED_EVENT, {\n      hostId: request.hostId,\n      orderId: request.recordId,\n      key: fulfillment.id,\n      order: { ...(snapshot.data() ?? {}), ...patch },\n      extra: { fulfillment: fulfillmentEventView(order, fulfillment) },\n    })\n    return { outcome: 'completed' }\n  })\n}\n\n/**\n * What the order's sale took off each shelf, less what has gone back since\n * (a cancel's or an earlier adjustment's rows): the most a restock may still\n * return, by product and variant.\n */\nfunction remainingReleaseCaps(rows: readonly { get: (field: string) => unknown }[]): Map<string, number> {\n  const caps = saleReleaseCaps(rows.filter((row) => row.get('reason') === 'sale'))\n  for (const row of rows) {\n    const reason = row.get('reason')\n    if (reason !== 'refund' && reason !== 'cancellation') continue\n    const delta = Number(row.get('appliedDelta') ?? row.get('delta') ?? 0)\n    if (!(delta > 0)) continue\n    const key = restockKey(String(row.get('productId') ?? ''), String(row.get('variantId') ?? ''))\n    if (caps.has(key)) caps.set(key, Math.max(0, (caps.get(key) ?? 0) - delta))\n  }\n  return caps\n}\n\n/** The channel refunded its buyer or took items off the order: recorded once, with the named units back on the shelf. */\nexport async function recordChannelOrderRefund(\n  request: PluginChannelOrderRefund,\n  deps: ChannelOrderUpdateDeps = defaultDeps(),\n): Promise<PluginChannelOrderRefundOutcome> {\n  if (!validIds(request?.hostId, request?.recordId)) return { outcome: 'no_such_record' }\n  const refundId = clip(request.refundId, 200)\n  if (!refundId) return { outcome: 'refused', reason: 'The refund has no id on its channel.' }\n  const amount = Number(request.amountCents)\n  if (!Number.isInteger(amount) || amount < 0 || amount > MAX_CENTS) {\n    return { outcome: 'refused', reason: 'The refund is not a whole amount.' }\n  }\n  const asked = (Array.isArray(request.restock) ? request.restock : [])\n    .map((entry) => ({ lineIndex: Number(entry?.lineIndex), quantity: Number(entry?.quantity) }))\n    .filter((entry) => Number.isInteger(entry.lineIndex) && entry.lineIndex >= 0 && Number.isInteger(entry.quantity) && entry.quantity > 0)\n  if (amount === 0 && !asked.length) return { outcome: 'refused', reason: 'The refund moves no money and no stock.' }\n\n  const firestore = deps.firestore()\n  const hostRef = firestore.collection('hosts').doc(request.hostId)\n  const orderRef = hostRef.collection('orders').doc(request.recordId)\n  const nowMs = deps.now()\n  return firestore.runTransaction(async (transaction): Promise<PluginChannelOrderRefundOutcome> => {\n    const snapshot = await transaction.get(orderRef)\n    if (!snapshot.exists) return { outcome: 'no_such_record' }\n    const order = CommerceModel.liftLegacyOrder((snapshot.data() ?? {}) as never)\n    const source = order.channelSource\n    if (order.channel !== 'marketplace' || !source) return { outcome: 'no_such_record' }\n    if ((source.refundIds ?? []).includes(refundId)) return { outcome: 'already' }\n\n    // Every read before any write: the ledger, then each product a restock touches.\n    const lineItems = order.lineItems ?? []\n    const wanted = new Map<number, number>()\n    for (const entry of asked) {\n      const line = lineItems[entry.lineIndex]\n      if (!line?.productId || !line.variantId || /^__.*__$/.test(line.productId)) continue\n      wanted.set(entry.lineIndex, Math.min(Number(line.quantity) || 0, (wanted.get(entry.lineIndex) ?? 0) + entry.quantity))\n    }\n    const rows = wanted.size\n      ? (await transaction.get(hostRef.collection('inventoryAdjustments').where('orderId', '==', request.recordId))).docs\n      : []\n    const caps = remainingReleaseCaps(rows)\n    const productIds = [...new Set([...wanted.keys()].map((index) => lineItems[index].productId))]\n    const productSnaps = await Promise.all(productIds.map((id) => transaction.get(hostRef.collection('products').doc(id))))\n    const products = new Map<string, CommerceModel.HostProduct>()\n    productSnaps.forEach((product, index) => {\n      if (product.exists && !product.get('deletedAt')) {\n        products.set(productIds[index], CommerceModel.liftLegacyProduct(product.data() as never))\n      }\n    })\n\n    let restockedUnits = 0\n    const restockedLines: number[] = []\n    const ledger: CommerceModel.InventoryAdjustment[] = []\n    const changed = new Set<string>()\n    for (const [lineIndex, quantity] of wanted) {\n      const line = lineItems[lineIndex]\n      const product = products.get(line.productId)\n      const variantId = String(line.variantId)\n      const variant = product?.variants.find((entry) => entry.id === variantId)\n      if (!product || !variant || variant.inventory == null) continue\n      const key = restockKey(line.productId, variantId)\n      // A pair the ledger never recorded a sale for gave up nothing to return.\n      const budget = caps.get(key) ?? 0\n      const back = Math.min(quantity, budget)\n      if (back <= 0) continue\n      caps.set(key, budget - back)\n      products.set(line.productId, {\n        ...product,\n        variants: CommerceModel.adjustVariantInventory(product, variantId, back),\n      })\n      changed.add(line.productId)\n      restockedUnits += back\n      restockedLines.push(lineIndex)\n      ledger.push({\n        productId: line.productId,\n        variantId,\n        delta: back,\n        reason: 'refund',\n        orderId: request.recordId,\n        source: source.channelLabel,\n        atMs: nowMs,\n      })\n    }\n\n    const total = Number(order.totals?.totalCents ?? order.amountCents ?? 0)\n    const before = Number(order.refundedCents ?? 0)\n    const recorded = Math.max(0, Math.min(amount, total - before))\n    const refundedCents = before + recorded\n    const full = total > 0 && refundedCents >= total\n    let status = order.status\n    if (full && status !== 'refunded' && CommerceModel.canTransitionOrder(status, 'refunded')) status = 'refunded'\n\n    for (const productId of changed) {\n      const product = products.get(productId) as CommerceModel.HostProduct\n      transaction.update(hostRef.collection('products').doc(productId), {\n        variants: product.variants,\n        ...CommerceModel.productStockFields(product),\n        updatedAtMs: nowMs,\n      })\n    }\n    for (const row of ledger) transaction.set(hostRef.collection('inventoryAdjustments').doc(createResourceUid()), row)\n\n    const money = (cents: number) => `${(cents / 100).toFixed(2)} ${source.currency}`\n    const reason = clip(request.reason, 200) || `Refunded on ${source.channelLabel}`\n    const parts = [\n      recorded > 0 ? `${reason}: ${money(recorded)} refunded by ${source.channelLabel}` : reason,\n      ...(recorded < amount ? [`${money(amount - recorded)} more than the order had left was not recorded`] : []),\n      ...(restockedUnits > 0 ? [`${restockedUnits} ${restockedUnits === 1 ? 'unit' : 'units'} returned to stock`] : []),\n    ]\n    const patch = {\n      status,\n      refundedCents,\n      channelSource: { ...source, refundIds: [...(source.refundIds ?? []), refundId].slice(-MAX_REFUND_IDS) },\n      updatedAtMs: nowMs,\n      timeline: CommerceModel.appendOrderEvent(order, 'refund', `${parts.join('. ')}.`, nowMs),\n    }\n    transaction.update(orderRef, patch)\n    if (recorded > 0) {\n      stageOrderEvent(transaction, ORDER_REFUNDED_EVENT, {\n        hostId: request.hostId,\n        orderId: request.recordId,\n        key: `refund:channel:${refundId}`,\n        order: { ...(snapshot.data() ?? {}), ...patch },\n        extra: { refund: { id: null, amountCents: recorded, lineItemIds: restockedLines, full } },\n      })\n    }\n    return { outcome: 'recorded', refundedCents, restockedUnits }\n  })\n}\n"],"names":["createResourceUid","firebaseAdmin","CommerceModel","ORDER_FULFILLED_EVENT","ORDER_REFUNDED_EVENT","createHash","fulfillmentEventView","stageOrderEvent","restockCapKey","saleReleaseCaps","DOC_ID","MAX_CENTS","HANDOFF_KEY","MAX_REFUND_IDS","restockKey","handoffFulfillmentId","orderId","update","digest","slice","defaultDeps","firestore","app","now","Date","clip","value","max","String","trim","validIds","hostId","recordId","test","completeChannelOrder","request","deps","outcome","orderRef","collection","doc","nowMs","fulfillmentId","runTransaction","transaction","snapshot","order","get","exists","liftLegacyOrder","data","channel","channelSource","status","fulfillments","some","entry","id","canTransitionOrder","lines","remainingFulfillmentLines","length","orderLineFulfillmentStates","filter","state","remainingQuantity","map","lineItemId","quantity","carrier","channelLabel","fulfillment","lineItemIds","notify","atMs","patch","updatedAtMs","timeline","appendOrderEvent","note","key","extra","remainingReleaseCaps","rows","caps","row","reason","delta","Number","has","set","Math","recordChannelOrderRefund","refundId","amount","amountCents","isInteger","asked","Array","isArray","restock","lineIndex","hostRef","source","refundIds","includes","lineItems","wanted","Map","line","productId","variantId","min","size","where","docs","productIds","Set","keys","index","productSnaps","Promise","all","products","forEach","product","liftLegacyProduct","restockedUnits","restockedLines","ledger","changed","variant","variants","find","inventory","budget","back","adjustVariantInventory","add","push","total","totals","totalCents","before","refundedCents","recorded","full","productStockFields","money","cents","toFixed","currency","parts","join","refund"],"mappings":"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"}

package/src/lib/server/channel-orders.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @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 { PluginChannelOrder, PluginChannelOrderCancelOutcome, PluginChannelOrderFee, PluginChannelOrderOutcome, PluginChannelOrders } from '@aglyn/aglyn/plugin-manager/plugin-channel-orders';
+/**
+ * ORDERS SOLD ON ANOTHER CHANNEL (AGL-3638): commerce's implementation of
+ * core's `core.channel-orders`, which a marketplace plugin records each
+ * order it brings in through.
+ *
+ * ## One transaction, so two channels cannot sell the last unit twice
+ *
+ * The order, its number, every product's count, every count's ledger row and
+ * the `order.paid` event are ONE Firestore transaction. Each product is read
+ * with `transaction.get`, which serializes this write with every other sale
+ * of that product (the AGL-2320 reasoning): a storefront checkout landing at
+ * the same moment decrements from the count this write left, never from the
+ * one it read. The marketplace plugin then pushes the new count to every
+ * other channel.
+ *
+ * A marketplace order is already sold and paid when it arrives, so a shelf
+ * that cannot cover it does not refuse it: the units the shelf held are
+ * taken, the order is recorded whole, and the merchant is told which units
+ * are short — the same loud oversell `reserve-stock.ts` raises.
+ *
+ * ## Once per outside order
+ *
+ * The order's id is derived from the channel and its order id
+ * ({@link channelOrderDocId}), and the transaction refuses to write over an
+ * order that exists, so a retried import answers `already` and moves nothing.
+ *
+ * ## No money moves here
+ *
+ * The buyer paid the channel. `totals.feeCents` — Aglyn's own take — is 0,
+ * the channel's charges are recorded on `channelSource.fees` for the
+ * merchant's books, the tax is the channel's to remit, and refunds happen on
+ * the channel. No buyer email is sent: a marketplace forbids contacting its
+ * buyers outside it, and none of them hands over a real address.
+ */
+type Firestore = FirebaseFirestore.Firestore;
+/**
+ * The order document's id for one outside order: the channel, then a hash of
+ * the channel's own id. Deterministic, so a second import of the same order
+ * finds the first; hashed, because a channel's id may hold characters a
+ * document id may not.
+ */
+export declare function channelOrderDocId(channelId: string, externalOrderId: string): string;
+/** What a seller refuses before reading anything, in the merchant's words; `null` when the order is well formed. */
+export declare function channelOrderProblem(order: PluginChannelOrder): string | null;
+export interface ChannelOrderDeps {
+    firestore: () => Firestore;
+    now: () => number;
+}
+/** Records one outside order; see the module header. */
+export declare function importChannelOrder(order: PluginChannelOrder, deps?: ChannelOrderDeps): Promise<PluginChannelOrderOutcome>;
+/**
+ * The channel canceled an order it sent: the order is cancelled here, and
+ * the units its sale took go back on the shelf — bounded by its own ledger,
+ * exactly as the console's cancel bounds them. Refuses once anything shipped.
+ */
+export declare function cancelChannelOrder(request: {
+    hostId: string;
+    recordId: string;
+    reason: string;
+}, deps?: ChannelOrderDeps): Promise<PluginChannelOrderCancelOutcome>;
+/** The channel's charges on a sale, recorded once it says; a later answer replaces an earlier one. */
+export declare function recordChannelOrderFees(request: {
+    hostId: string;
+    recordId: string;
+    fees: PluginChannelOrderFee[];
+}, deps?: ChannelOrderDeps): Promise<'recorded' | 'no_such_record'>;
+export declare const commerceChannelOrders: PluginChannelOrders;
+export {};