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

package/src/lib/transfer/tracking-transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/transfer/tracking-transfer.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 {\n  buildTransferPlan,\n  matchLookupKey,\n  normalizeMatchValue,\n  resolveFieldPolicy,\n  resolveRecordPolicy,\n  withTransferResourceFindings,\n  type BuildTransferPlanInput,\n  type MatchKeySpec,\n  type MatchLookup,\n  type PlannedTransferRow,\n  type RowMatchOutcome,\n  type TransferField,\n  type TransferFieldChange,\n  type TransferPlan,\n  type TransferPlanSummary,\n  type TransferPolicyDefaults,\n  type TransferResourceFinding,\n} from '@aglyn/aglyn/data-transfer'\nimport {\n  ORDER_STATUS_LABELS,\n  formatOrderNumber,\n  liftLegacyOrder,\n  type HostOrder,\n  type OrderFulfillment,\n} from '../model/commerce-orders'\nimport { fulfillmentIsActive, orderLineFulfillmentStates } from '../model/order-fulfillment'\nimport {\n  fulfillmentWithTracking,\n  normalizeTrackingNumber,\n  shippingOrderNumber,\n  shippingOrderRefs,\n} from '../model/order-shipping-export'\n\n/*\n * TRACKING NUMBERS AS A FILE (AGL-3613): what Pirate Ship's shipment export,\n * Shippo's and EasyPost's reports, or any spreadsheet of parcels brings back\n * — an order and the tracking number of the parcel that left for it — made\n * into the order's shipments. Pure; the server half is `tracking.server.ts`.\n *\n * ## A row is a parcel, and a parcel is recorded once\n *\n * Rows are matched to orders by the order number the export wrote (`1042`,\n * `#1042`, or the order's ID). Several rows may name one order — one per\n * parcel — so a row is a duplicate only when it repeats an order AND a\n * tracking number together. A tracking number the order already carries is\n * `unchanged`, so the same file imported twice records nothing twice.\n *\n * ## What a row does to its order\n *\n * - The order still has units to ship: the row SHIPS them, recorded through\n *   the console's own shipment (`recordOrderShipment`) and emailed to the\n *   buyer. A row with a SKU (and a quantity) ships that line; one without\n *   ships everything left.\n * - The order has nothing left to ship: this is the CONFLICT, and the\n *   person decides it on the Conflicts step through the Tracking number\n *   field's choice. Keep existing (the start) leaves the shipment as it is;\n *   Overwrite replaces its tracking; Fill blanks adds tracking only to a\n *   shipment recorded without any.\n * - A pending, canceled or refunded order is refused, by name.\n *\n * Nothing here creates an order: a row naming no order fails with the\n * number it named.\n */\n\nexport const TRACKING_FIELD = {\n  orderRef: 'orderRef',\n  trackingNumber: 'trackingNumber',\n  carrier: 'carrier',\n  service: 'service',\n  trackingUrl: 'trackingUrl',\n  sku: 'sku',\n  quantity: 'quantity',\n  status: 'status',\n  shippedAt: 'shippedAt',\n} as const\n\nexport const TRACKING_TRANSFER_FIELDS: readonly TransferField[] = [\n  {\n    id: TRACKING_FIELD.orderRef,\n    label: 'Order',\n    group: 'parcel',\n    type: 'text',\n    required: true,\n    matchKey: true,\n    description: 'The order number the shipping export wrote (1042 or #1042), or the order’s ID.',\n    aliases: [\n      'order',\n      'order id',\n      'order number',\n      'order #',\n      'order no',\n      'order_number',\n      'order_id',\n      'orderid',\n      'reference',\n      'reference 1',\n      'reference1',\n      'ref',\n      'external order id',\n      'invoice number',\n    ],\n  },\n  {\n    id: TRACKING_FIELD.trackingNumber,\n    label: 'Tracking number',\n    group: 'parcel',\n    type: 'text',\n    required: true,\n    maxLength: 60,\n    aliases: ['tracking', 'tracking #', 'tracking no', 'tracking code', 'tracking_code', 'tracking_number', 'tracking id'],\n  },\n  {\n    id: TRACKING_FIELD.carrier,\n    label: 'Carrier',\n    group: 'parcel',\n    type: 'text',\n    maxLength: 40,\n    aliases: ['provider', 'shipping carrier', 'carrier name'],\n  },\n  {\n    id: TRACKING_FIELD.service,\n    label: 'Service',\n    group: 'parcel',\n    type: 'text',\n    description: 'Read for the timeline; the carrier and the number are what the buyer is sent.',\n    aliases: ['shipping service', 'service level', 'servicelevel', 'mail class'],\n  },\n  {\n    id: TRACKING_FIELD.trackingUrl,\n    label: 'Tracking link',\n    group: 'parcel',\n    type: 'url',\n    description: 'Used instead of the carrier’s own tracking page when given. https only.',\n    aliases: ['tracking url', 'tracking_url', 'tracking_url_provider', 'public_url', 'tracking page'],\n  },\n  {\n    id: TRACKING_FIELD.sku,\n    label: 'SKU',\n    group: 'items',\n    type: 'text',\n    description: 'Ships only this item of the order. Blank ships everything still to ship.',\n    aliases: ['item sku', 'product sku'],\n  },\n  {\n    id: TRACKING_FIELD.quantity,\n    label: 'Quantity',\n    group: 'items',\n    type: 'integer',\n    description: 'How many of the SKU’s units this parcel holds. Blank ships every unit left.',\n    aliases: ['qty', 'item quantity', 'units'],\n  },\n  { id: TRACKING_FIELD.status, label: 'Order status', group: 'order', type: 'text', readOnly: true },\n  { id: TRACKING_FIELD.shippedAt, label: 'Shipped', group: 'order', type: 'datetime', readOnly: true },\n]\n\nexport const TRACKING_TRANSFER_GROUPS = [\n  { id: 'parcel', label: 'Parcel' },\n  { id: 'items', label: 'Items' },\n  { id: 'order', label: 'Order' },\n]\n\nexport const TRACKING_MATCH_KEYS: readonly MatchKeySpec[] = [{ fieldId: TRACKING_FIELD.orderRef, normalizer: 'trim' }]\n\n/**\n * Where the Conflicts step starts: a matched order is updated (shipped), a\n * row naming no order is never made into one, and a tracking number an\n * already-shipped order holds is KEPT until the person chooses otherwise.\n */\nexport const TRACKING_DEFAULT_POLICY: TransferPolicyDefaults = {\n  record: { onMatch: 'update', onNew: 'skip', onAmbiguous: 'ask' },\n  fields: { [TRACKING_FIELD.trackingNumber]: { mode: 'keepExisting', blank: 'leave' } },\n  note:\n    'A row ships what its order still has to ship. For an order that has already shipped, choose ' +\n    'Overwrite for Tracking number to replace its tracking, or keep what it has.',\n}\n\n/** What `apply` does for one planned row. */\nexport type TrackingDecision =\n  | {\n      action: 'ship'\n      orderId: string\n      carrier: string\n      trackingNumber: string\n      trackingUrl?: string\n      /** Absent ships everything still to ship. */\n      lineItems?: Array<{ lineItemId: number; quantity: number }>\n    }\n  | {\n      action: 'replace'\n      orderId: string\n      fulfillmentId: string\n      carrier: string\n      trackingNumber: string\n      trackingUrl?: string\n      previous: { carrier: string | null; trackingNumber: string | null; trackingUrl: string | null }\n    }\n\n/** A planned row with what it will do to its order. */\nexport type TrackingPlannedRow = PlannedTransferRow & { tracking?: TrackingDecision }\n\n/** An order as the plan and the records read it. */\nexport type StoredTrackingOrder = Partial<HostOrder> & { createdAtMs?: number }\n\nconst iso = (ms: unknown): string | null => {\n  const value = Number(ms)\n  return Number.isFinite(value) && value > 0 ? new Date(value).toISOString() : null\n}\n\nconst cell = (value: unknown): string => (value === null || value === undefined ? '' : String(value).trim())\n\n/** The order's latest active shipment, the one a replacement tracking number lands on. */\nexport function latestShipment(order: Pick<HostOrder, 'fulfillments'>): OrderFulfillment | undefined {\n  return (order.fulfillments ?? [])\n    .filter((entry) => fulfillmentIsActive(entry))\n    .reduce<OrderFulfillment | undefined>((latest, entry) => (!latest || entry.atMs >= latest.atMs ? entry : latest), undefined)\n}\n\nconst unitsLeft = (order: Pick<HostOrder, 'lineItems' | 'fulfillments'>): number =>\n  orderLineFulfillmentStates(order)\n    .filter((state) => state.requiresShipping)\n    .reduce((sum, state) => sum + state.remainingQuantity, 0)\n\n/**\n * An order as the import's records name it: its numbers, and the tracking a\n * row would conflict with — the latest shipment's, but only once nothing is\n * left to ship. An order still owed parcels has no \"current\" tracking: the\n * next row is a new parcel, not a change to an old one.\n */\nexport function trackingRecord(id: string, stored: StoredTrackingOrder): Record<string, unknown> {\n  const order = liftLegacyOrder(stored)\n  const open = unitsLeft(order) > 0\n  const latest = open ? undefined : latestShipment(order)\n  return {\n    id,\n    orderRef: shippingOrderNumber(order, id),\n    trackingNumber: latest?.trackingNumber ?? null,\n    carrier: latest?.carrier ?? null,\n    trackingUrl: latest?.trackingUrl ?? null,\n    service: null,\n    sku: null,\n    quantity: null,\n    status: ORDER_STATUS_LABELS[order.status] ?? order.status,\n    shippedAt: iso(latest?.atMs),\n  }\n}\n\n/** The values an order is found by: `1042`, `#1042` and its ID. */\nexport function trackingMatchValues(id: string, stored: StoredTrackingOrder): Record<string, unknown> {\n  return { id, orderRef: shippingOrderRefs(stored, id) }\n}\n\n/** One export row per shipment an order carries, newest last. */\nexport function trackingExportRows(id: string, stored: StoredTrackingOrder): Array<Record<string, unknown>> {\n  const order = liftLegacyOrder(stored)\n  return (order.fulfillments ?? [])\n    .filter((entry) => fulfillmentIsActive(entry) && entry.trackingNumber)\n    .map((entry) => ({\n      id,\n      orderRef: shippingOrderNumber(order, id),\n      trackingNumber: entry.trackingNumber ?? null,\n      carrier: entry.carrier ?? null,\n      trackingUrl: entry.trackingUrl ?? null,\n      service: null,\n      sku: null,\n      quantity: (entry.lines ?? []).reduce((sum, line) => sum + (Number(line.quantity) || 0), 0) || null,\n      status: ORDER_STATUS_LABELS[order.status] ?? order.status,\n      shippedAt: iso(entry.atMs),\n    }))\n}\n\n/**\n * Which order each row names, the import's own way: by order number through\n * the lookup, with a duplicate only when a row repeats an EARLIER row's\n * order and tracking number together. The core's rule — any repeated key is\n * a duplicate — would refuse the second parcel of every two-parcel order.\n */\nexport function matchTrackingRows(\n  rows: ReadonlyArray<Readonly<Record<string, unknown>>>,\n  lookup: MatchLookup,\n): RowMatchOutcome[] {\n  const seen = new Map<string, number>()\n  return rows.map((values, index): RowMatchOutcome => {\n    const ref = normalizeMatchValue('trim', values[TRACKING_FIELD.orderRef])\n    if (!ref) return { kind: 'new' }\n    const via = { fieldId: TRACKING_FIELD.orderRef, value: ref }\n    const ids = lookup.get(matchLookupKey(TRACKING_FIELD.orderRef, ref)) ?? []\n    if (ids.length > 1) return { kind: 'ambiguous', recordIds: [...ids], via }\n    if (!ids.length) return { kind: 'new' }\n    const parcel = `${ids[0]}\\u0000${normalizeTrackingNumber(values[TRACKING_FIELD.trackingNumber])}`\n    const first = seen.get(parcel)\n    if (first !== undefined && normalizeTrackingNumber(values[TRACKING_FIELD.trackingNumber])) {\n      return { kind: 'duplicateInFile', firstRow: first, via }\n    }\n    seen.set(parcel, index)\n    return { kind: 'matched', recordId: ids[0], via }\n  })\n}\n\nconst SHIPPABLE_STATUSES = new Set(['paid', 'partially_fulfilled', 'fulfilled', 'delivered'])\n\nfunction summaryOf(rows: readonly PlannedTransferRow[]): TransferPlanSummary {\n  const summary: TransferPlanSummary = { create: 0, update: 0, unchanged: 0, skip: 0, fail: 0, total: rows.length }\n  for (const row of rows) summary[row.verdict] += 1\n  return summary\n}\n\nfunction change(fieldId: string, before: unknown, after: unknown): TransferFieldChange {\n  return { fieldId, before: before ?? null, after, mode: 'overwrite', source: 'default', rule: 'written' }\n}\n\n/**\n * The dry run: the core's plan for the policy, warnings and acknowledgements,\n * then each matched row decided against its order as the file leaves it —\n * units shipped by an earlier row of the same file are not shipped twice.\n * `orders` holds every matched order, read once.\n */\nexport function planTrackingRows(\n  input: BuildTransferPlanInput,\n  orders: ReadonlyMap<string, StoredTrackingOrder>,\n): TransferPlan {\n  const core = buildTransferPlan(input)\n  const field = input.fields.find((entry) => entry.id === TRACKING_FIELD.trackingNumber)\n  const valuesByIndex = new Map(input.rows.map((row) => [row.index, row.values]))\n  const findings: TransferResourceFinding[] = []\n  /** Units left per order and line, as the rows above have left them. */\n  const left = new Map<string, Map<number, number>>()\n  /** Orders whose last units a row above shipped, by that row. */\n  const closedBy = new Map<string, number>()\n  /** Shipments a row above already re-tracked. */\n  const replaced = new Set<string>()\n\n  const refuse = (row: TrackingPlannedRow, detail: string, fieldId?: string): TrackingPlannedRow => {\n    findings.push({ row: row.index, detail, ...(fieldId ? { fieldId } : {}) })\n    return { ...row, verdict: 'fail', reason: 'resourceRule', diff: [] }\n  }\n\n  const rows = core.rows.map((planned): TrackingPlannedRow => {\n    const row: TrackingPlannedRow = { ...planned }\n    const values = valuesByIndex.get(row.index) ?? {}\n    const ref = cell(values[TRACKING_FIELD.orderRef])\n    if (row.match.kind === 'new') {\n      return ref\n        ? refuse(row, `No order ${ref} on this site. A tracking file records parcels for orders; it never creates one.`, TRACKING_FIELD.orderRef)\n        : refuse(row, 'The row names no order.', TRACKING_FIELD.orderRef)\n    }\n    if (row.match.kind !== 'matched') return row\n    if (row.verdict === 'skip' || resolveRecordPolicy(input.policy, row.index).action === 'skip') {\n      return { ...row, verdict: 'skip', reason: row.reason ?? 'skippedByChoice', diff: [] }\n    }\n    const orderId = row.match.recordId\n    const stored = orders.get(orderId)\n    if (!stored) return { ...row, verdict: 'fail', reason: 'matchedRecordMissing', diff: [] }\n    const order = liftLegacyOrder(stored)\n    const label = formatOrderNumber(order, orderId)\n    const trackingNumber = cell(values[TRACKING_FIELD.trackingNumber]).slice(0, 60)\n    if (!trackingNumber) return refuse(row, `No tracking number for order ${label}.`, TRACKING_FIELD.trackingNumber)\n    if (!SHIPPABLE_STATUSES.has(order.status)) {\n      return refuse(row, `Order ${label} is ${ORDER_STATUS_LABELS[order.status]?.toLowerCase() ?? order.status}; nothing on it ships.`)\n    }\n    if (fulfillmentWithTracking(order, trackingNumber)) {\n      return { ...row, verdict: 'unchanged', diff: [], reason: undefined }\n    }\n    const carrier = cell(values[TRACKING_FIELD.carrier]).slice(0, 40)\n    const trackingUrl = cell(values[TRACKING_FIELD.trackingUrl]) || undefined\n    const states = orderLineFulfillmentStates(order)\n    const remaining =\n      left.get(orderId) ??\n      new Map(states.filter((state) => state.requiresShipping).map((state) => [state.lineItemId, state.remainingQuantity]))\n    left.set(orderId, remaining)\n    const unitsOpen = [...remaining.values()].reduce((sum, units) => sum + units, 0)\n\n    if (unitsOpen > 0) {\n      const sku = cell(values[TRACKING_FIELD.sku]).toLowerCase()\n      let lineItems: Array<{ lineItemId: number; quantity: number }> | undefined\n      if (sku) {\n        const lineItemId = (order.lineItems ?? []).findIndex(\n          (line, index) => (line.sku ?? '').trim().toLowerCase() === sku && (remaining.get(index) ?? 0) > 0,\n        )\n        if (lineItemId < 0) return refuse(row, `Order ${label} has no item with SKU ${cell(values[TRACKING_FIELD.sku])} left to ship.`, TRACKING_FIELD.sku)\n        const open = remaining.get(lineItemId) ?? 0\n        const asked = values[TRACKING_FIELD.quantity]\n        const quantity = asked === null || asked === undefined || cell(asked) === '' ? open : Math.floor(Number(asked))\n        if (!Number.isInteger(quantity) || quantity <= 0) {\n          return refuse(row, `The quantity for order ${label} must be a whole number above zero.`, TRACKING_FIELD.quantity)\n        }\n        if (quantity > open) {\n          return refuse(row, `Order ${label} has only ${open} of SKU ${cell(values[TRACKING_FIELD.sku])} left to ship, not ${quantity}.`, TRACKING_FIELD.quantity)\n        }\n        lineItems = [{ lineItemId, quantity }]\n        remaining.set(lineItemId, open - quantity)\n      } else {\n        for (const key of remaining.keys()) remaining.set(key, 0)\n      }\n      if ([...remaining.values()].every((units) => units === 0)) closedBy.set(orderId, row.index)\n      return {\n        ...row,\n        verdict: 'update',\n        reason: undefined,\n        diff: [change(TRACKING_FIELD.trackingNumber, null, trackingNumber), ...(carrier ? [change(TRACKING_FIELD.carrier, null, carrier)] : [])],\n        tracking: {\n          action: 'ship',\n          orderId,\n          carrier,\n          trackingNumber,\n          ...(trackingUrl ? { trackingUrl } : {}),\n          ...(lineItems ? { lineItems } : {}),\n        },\n      }\n    }\n\n    // Nothing left to ship. Shipped by a row ABOVE in this file: that row's\n    // parcel took everything, so this one has nothing to hold.\n    const closer = closedBy.get(orderId)\n    if (closer !== undefined) {\n      return refuse(\n        row,\n        `Row ${closer + 1} already ships everything left on order ${label}. To split an order across parcels, give each parcel’s SKU and Quantity.`,\n      )\n    }\n    const latest = latestShipment(order)\n    if (!latest) return refuse(row, `Order ${label} has nothing to ship.`)\n    if (replaced.has(latest.id)) {\n      return refuse(row, `An earlier row already replaces the tracking on order ${label}.`)\n    }\n    const mode = field ? resolveFieldPolicy(input.policy, row.index, field).mode : 'keepExisting'\n    const hasTracking = Boolean(cell(latest.trackingNumber))\n    const writes = mode === 'overwrite' || (mode === 'fillBlanks' && !hasTracking)\n    if (!writes) {\n      findings.push({\n        row: row.index,\n        fieldId: TRACKING_FIELD.trackingNumber,\n        value: trackingNumber,\n        detail: hasTracking\n          ? `Order ${label} already shipped with tracking ${latest.trackingNumber}; it is kept. Choose Overwrite for Tracking number to replace it.`\n          : `Order ${label} already shipped without tracking; choose Fill blanks or Overwrite for Tracking number to add it.`,\n      })\n      return { ...row, verdict: 'unchanged', diff: [], reason: undefined }\n    }\n    replaced.add(latest.id)\n    return {\n      ...row,\n      verdict: 'update',\n      reason: undefined,\n      diff: [\n        { ...change(TRACKING_FIELD.trackingNumber, latest.trackingNumber ?? null, trackingNumber), mode },\n        ...(carrier ? [change(TRACKING_FIELD.carrier, latest.carrier ?? null, carrier)] : []),\n      ],\n      tracking: {\n        action: 'replace',\n        orderId,\n        fulfillmentId: latest.id,\n        carrier: carrier || latest.carrier || '',\n        trackingNumber,\n        ...(trackingUrl ? { trackingUrl } : {}),\n        previous: {\n          carrier: latest.carrier ?? null,\n          trackingNumber: latest.trackingNumber ?? null,\n          trackingUrl: latest.trackingUrl ?? null,\n        },\n      },\n    }\n  })\n\n  const decided: TransferPlan = { ...core, rows, summary: summaryOf(rows) }\n  return withTransferResourceFindings(decided, findings)\n}\n"],"names":["buildTransferPlan","matchLookupKey","normalizeMatchValue","resolveFieldPolicy","resolveRecordPolicy","withTransferResourceFindings","ORDER_STATUS_LABELS","formatOrderNumber","liftLegacyOrder","fulfillmentIsActive","orderLineFulfillmentStates","fulfillmentWithTracking","normalizeTrackingNumber","shippingOrderNumber","shippingOrderRefs","TRACKING_FIELD","orderRef","trackingNumber","carrier","service","trackingUrl","sku","quantity","status","shippedAt","TRACKING_TRANSFER_FIELDS","id","label","group","type","required","matchKey","description","aliases","maxLength","readOnly","TRACKING_TRANSFER_GROUPS","TRACKING_MATCH_KEYS","fieldId","normalizer","TRACKING_DEFAULT_POLICY","record","onMatch","onNew","onAmbiguous","fields","mode","blank","note","iso","ms","value","Number","isFinite","Date","toISOString","cell","undefined","String","trim","latestShipment","order","fulfillments","filter","entry","reduce","latest","atMs","unitsLeft","state","requiresShipping","sum","remainingQuantity","trackingRecord","stored","open","trackingMatchValues","trackingExportRows","map","lines","line","matchTrackingRows","rows","lookup","seen","Map","values","index","ref","kind","via","ids","get","length","recordIds","parcel","first","firstRow","set","recordId","SHIPPABLE_STATUSES","Set","summaryOf","summary","create","update","unchanged","skip","fail","total","row","verdict","change","before","after","source","rule","planTrackingRows","input","orders","core","field","find","valuesByIndex","findings","left","closedBy","replaced","refuse","detail","push","reason","diff","planned","match","policy","action","orderId","slice","has","toLowerCase","states","remaining","lineItemId","unitsOpen","units","lineItems","findIndex","asked","Math","floor","isInteger","key","keys","every","tracking","closer","hasTracking","Boolean","writes","add","fulfillmentId","previous","decided"],"mappings":"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"}

package/src/lib/transfer/tracking.server.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @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 BuildTransferPlanInput, type MatchLookupRequest, type PlannedTransferRow, type TransferChunk, type TransferPlan, type TransferUndoSnapshot } from '@aglyn/aglyn/data-transfer';
+import type { PluginTransferResource, TransferApplyResult, TransferApplyWriter, TransferLookupResult, TransferReadOptions, TransferReadPage, TransferResourceContext, TransferRevertDecisions, TransferRevertResult } from '@aglyn/aglyn/plugin-manager/plugin-transfer-resources';
+export declare function lookupTrackingOrders(ctx: TransferResourceContext, requests: readonly MatchLookupRequest[]): Promise<TransferLookupResult>;
+/**
+ * The shipments export: every order that has shipped something, newest
+ * first, one row per shipment with a tracking number. The cursor is the last
+ * order's `createdAtMs` and id, as the orders export pages.
+ */
+export declare function readTrackingPage(ctx: TransferResourceContext, cursor: string | null, fieldIds: readonly string[], options?: TransferReadOptions): Promise<TransferReadPage>;
+/** The dry run, against every matched order read once. */
+export declare function planTracking(ctx: TransferResourceContext, input: BuildTransferPlanInput): Promise<TransferPlan>;
+/** Records one chunk's parcels, each through the order's own shipment paths. */
+export declare function applyTracking(ctx: TransferResourceContext, chunk: TransferChunk<PlannedTransferRow>, writer: TransferApplyWriter): Promise<TransferApplyResult>;
+/**
+ * Undoes one chunk, newest first: a parcel the import recorded is cancelled
+ * and a tracking number it replaced is put back — while the shipment still
+ * holds what the import wrote. A shipment edited since is a conflict, done
+ * only when the person's decision says `revert`.
+ */
+export declare function revertTracking(ctx: TransferResourceContext, snapshot: TransferUndoSnapshot, decisions?: TransferRevertDecisions): Promise<TransferRevertResult>;
+export declare const trackingTransfer: PluginTransferResource;

package/src/lib/transfer/tracking.server.js

@@ -0,0 +1,393 @@
+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 { buildMatchLookup } from "@aglyn/aglyn/data-transfer";
+import { hostRoleFor } from "@aglyn/aglyn/app-utils/organizations";
+import * as Aglyn from "@aglyn/aglyn/server";
+import { firebaseAdmin, getOrgForHost, resolveOrgMembership } from "@aglyn/tenant-data-admin";
+import { TransferEngineError } from "@aglyn/tenant-data-admin/server/transfer-jobs";
+import { normalizeTrackingNumber, parseShippingOrderRef } from "../model/order-shipping-export.js";
+import { cancelOrderFulfillment, recordOrderShipment, updateFulfillmentTracking } from "../server/fulfill-order.js";
+import { NOTHING, ROW_BUDGET_MS, firestoreOf, hostRefOf, readerSeesHost } from "./server-common.js";
+import { TRACKING_DEFAULT_POLICY, TRACKING_MATCH_KEYS, matchTrackingRows, planTrackingRows, trackingExportRows, trackingMatchValues, trackingRecord } from "./tracking-transfer.js";
+/*
+ * THE TRACKING IMPORT'S SERVER HALF (AGL-3613). The plan is
+ * `planTrackingRows`; this module reads the orders it plans against, writes
+ * each parcel through the order's own shipment paths and undoes them.
+ *
+ * - WHO: the site's admins and editors — the roles the console's Fulfill
+ *   button has — on a plan that sells. Asked by the plan, the apply and the
+ *   undo, each server-side.
+ * - HOW: a new parcel through `recordOrderShipment`, keyed by its tracking
+ *   number, so a retried chunk or a second import of the same file is one
+ *   parcel; the buyer is emailed as for any shipment. A replaced tracking
+ *   number through `updateFulfillmentTracking`.
+ * - UNDO: a parcel this import recorded is cancelled (its units go back to
+ *   unfulfilled), and a replaced tracking number is put back — each only
+ *   while the shipment still holds what the import wrote; otherwise it is a
+ *   conflict the person decides.
+ */ const IN_MAX = 30;
+/** Orders a page of the shipments export reads: those that have shipped something. */ const SHIPPED_STATUSES = [
+    'partially_fulfilled',
+    'fulfilled',
+    'delivered'
+];
+/** The member importing, checked for the role and the plan, or the refusal. */ async function shipperOf(ctx) {
+    const hostId = ctx.hostId;
+    if (!hostId) throw new TransferEngineError('invalid', 400, 'Tracking numbers belong to a site; name the site.');
+    const uid = ctx.actorUid;
+    const membership = uid ? await resolveOrgMembership(uid, ctx.orgId) : null;
+    const role = (membership == null ? void 0 : membership.member) ? hostRoleFor(membership.member, hostId) : null;
+    if (!uid || role !== 'admin' && role !== 'editor') {
+        throw new TransferEngineError('forbidden', 403, 'Only a site’s admins and editors can record shipments.');
+    }
+    const owner = await getOrgForHost(hostId).catch(()=>null);
+    if (!Aglyn.checkEntitlement(owner == null ? void 0 : owner.org, 'commerce')) {
+        throw new TransferEngineError('forbidden', 403, 'This site’s plan does not include selling.');
+    }
+    return {
+        hostId
+    };
+}
+const ordersOf = (firestore, ctx)=>hostRefOf(firestore, ctx).collection('orders');
+/** Orders by the values a file names them by: numbers through one query per 30, ids directly. */ async function findOrders(firestore, ctx, requests) {
+    const collection = ordersOf(firestore, ctx);
+    const found = new Map();
+    const numbers = new Set();
+    const ids = new Set();
+    for (const request of requests){
+        for (const value of request.values){
+            const ref = request.fieldId === 'id' ? {
+                id: value
+            } : parseShippingOrderRef(value);
+            if (!ref) continue;
+            if (ref.number !== undefined) numbers.add(ref.number);
+            if (ref.id && !ref.id.includes('/') && !/^__.*__$/.test(ref.id)) ids.add(ref.id);
+        }
+    }
+    const numberList = [
+        ...numbers
+    ];
+    for(let at = 0; at < numberList.length; at += IN_MAX){
+        const snapshot = await collection.where('number', 'in', numberList.slice(at, at + IN_MAX)).get();
+        for (const doc of snapshot.docs)found.set(doc.id, doc);
+    }
+    const idList = [
+        ...ids
+    ].filter((id)=>!found.has(id));
+    for(let at = 0; at < idList.length; at += 100){
+        for (const doc of (await firestore.getAll(...idList.slice(at, at + 100).map((id)=>collection.doc(id))))){
+            if (doc.exists) found.set(doc.id, doc);
+        }
+    }
+    return found;
+}
+export async function lookupTrackingOrders(ctx, requests) {
+    const found = await findOrders(firestoreOf(), ctx, requests);
+    const keys = requests.map((request)=>({
+            fieldId: request.fieldId,
+            normalizer: request.normalizer
+        }));
+    const records = new Map();
+    const entries = [];
+    for (const doc of found.values()){
+        var _doc_data;
+        const data = (_doc_data = doc.data()) != null ? _doc_data : {};
+        records.set(doc.id, trackingRecord(doc.id, data));
+        entries.push({
+            id: doc.id,
+            values: trackingMatchValues(doc.id, data)
+        });
+    }
+    return {
+        lookup: buildMatchLookup(entries, keys),
+        records
+    };
+}
+/**
+ * The shipments export: every order that has shipped something, newest
+ * first, one row per shipment with a tracking number. The cursor is the last
+ * order's `createdAtMs` and id, as the orders export pages.
+ */ export async function readTrackingPage(ctx, cursor, fieldIds, options) {
+    var _ref;
+    if (!readerSeesHost(ctx, options)) return NOTHING;
+    if (options == null ? void 0 : options.filter) throw new Error('Shipments export every shipment, or those of the orders you select.');
+    const firestore = firestoreOf();
+    const collection = ordersOf(firestore, ctx);
+    const pageSize = Math.max(1, Math.min(500, (_ref = options == null ? void 0 : options.pageSize) != null ? _ref : 200));
+    let docs;
+    let next;
+    if (options == null ? void 0 : options.ids) {
+        const offset = cursor ? Number(cursor) : 0;
+        const ids = options.ids.slice(offset, offset + pageSize);
+        docs = ids.length ? (await firestore.getAll(...ids.map((id)=>collection.doc(id)))).filter((doc)=>doc.exists) : [];
+        next = offset + ids.length < options.ids.length ? String(offset + ids.length) : null;
+    } else {
+        var _last_get;
+        const query = collection.where('status', 'in', SHIPPED_STATUSES).orderBy('createdAtMs', 'desc').orderBy(firebaseAdmin.firestore.FieldPath.documentId(), 'desc');
+        const after = cursor ? JSON.parse(cursor) : null;
+        const snapshot = await (after ? query.startAfter(...after) : query).limit(pageSize).get();
+        docs = snapshot.docs;
+        const last = snapshot.docs[snapshot.docs.length - 1];
+        next = last && snapshot.docs.length === pageSize ? JSON.stringify([
+            (_last_get = last.get('createdAtMs')) != null ? _last_get : null,
+            last.id
+        ]) : null;
+    }
+    const rows = docs.flatMap((doc)=>{
+        var _doc_data;
+        return trackingExportRows(doc.id, (_doc_data = doc.data()) != null ? _doc_data : {}).map((record)=>Object.fromEntries(fieldIds.map((fieldId)=>{
+                var _record_fieldId;
+                return [
+                    fieldId,
+                    (_record_fieldId = record[fieldId]) != null ? _record_fieldId : null
+                ];
+            })));
+    });
+    return {
+        rows,
+        next
+    };
+}
+/** The dry run, against every matched order read once. */ export async function planTracking(ctx, input) {
+    await shipperOf(ctx);
+    const firestore = firestoreOf();
+    const ids = [
+        ...new Set(input.matches.map((match)=>match.kind === 'matched' ? match.recordId : null).filter((id)=>Boolean(id)))
+    ];
+    const collection = ordersOf(firestore, ctx);
+    const orders = new Map();
+    for(let at = 0; at < ids.length; at += 100){
+        for (const doc of (await firestore.getAll(...ids.slice(at, at + 100).map((id)=>collection.doc(id))))){
+            var _doc_data;
+            if (doc.exists) orders.set(doc.id, (_doc_data = doc.data()) != null ? _doc_data : {});
+        }
+    }
+    return planTrackingRows(input, orders);
+}
+/** Records one chunk's parcels, each through the order's own shipment paths. */ export async function applyTracking(ctx, chunk, writer) {
+    const { hostId } = await shipperOf(ctx);
+    const results = [];
+    const undo = [];
+    const fail = async (row, message)=>{
+        const result = {
+            row,
+            outcome: 'failed',
+            reason: 'refusedValue',
+            message
+        };
+        results.push(result);
+        await writer.markApplied(result);
+    };
+    for (const row of chunk.rows){
+        const earlier = await writer.alreadyApplied(row.index);
+        if (earlier) {
+            results.push(earlier);
+            continue;
+        }
+        if (writer.timeLeftMs() < ROW_BUDGET_MS) break;
+        const decision = row.tracking;
+        if (row.verdict !== 'update' || !decision) {
+            await fail(row.index, 'A tracking file only records parcels for orders it names.');
+            continue;
+        }
+        if (decision.action === 'ship') {
+            const outcome = await recordOrderShipment(_extends({
+                hostId,
+                orderId: decision.orderId,
+                to: 'fulfilled',
+                carrier: decision.carrier,
+                trackingNumber: decision.trackingNumber
+            }, decision.trackingUrl ? {
+                trackingUrl: decision.trackingUrl
+            } : {}, decision.lineItems ? {
+                lineItems: decision.lineItems
+            } : {}, {
+                idempotencyKey: `tracking-import:${normalizeTrackingNumber(decision.trackingNumber)}`,
+                onceByTracking: true
+            }));
+            if (outcome.outcome === 'recorded' || outcome.outcome === 'already' && outcome.fulfillment) {
+                var _fulfillment_trackingNumber, _fulfillment_carrier;
+                const fulfillment = outcome.fulfillment;
+                const result = {
+                    row: row.index,
+                    outcome: outcome.outcome === 'recorded' ? 'updated' : 'unchanged',
+                    recordId: decision.orderId
+                };
+                // Only a parcel THIS import recorded is undone; one found already
+                // there was somebody else's.
+                const entry = outcome.outcome === 'recorded' && fulfillment ? {
+                    row: row.index,
+                    recordId: decision.orderId,
+                    action: 'updated',
+                    previous: {
+                        fulfillmentId: null
+                    },
+                    written: {
+                        fulfillmentId: fulfillment.id,
+                        trackingNumber: (_fulfillment_trackingNumber = fulfillment.trackingNumber) != null ? _fulfillment_trackingNumber : null,
+                        carrier: (_fulfillment_carrier = fulfillment.carrier) != null ? _fulfillment_carrier : null
+                    }
+                } : undefined;
+                results.push(result);
+                if (entry) undo.push(entry);
+                await writer.markApplied(result, entry);
+                continue;
+            }
+            await fail(row.index, outcome.outcome === 'blocked' ? `The order is ${outcome.from.replace(/_/g, ' ')} and cannot be shipped.` : outcome.outcome === 'invalid_lines' ? outcome.message : outcome.outcome === 'no_such_order' ? 'The order no longer exists.' : 'The order has nothing left to ship.');
+            continue;
+        }
+        const outcome = await updateFulfillmentTracking(_extends({
+            hostId,
+            orderId: decision.orderId,
+            fulfillmentId: decision.fulfillmentId,
+            carrier: decision.carrier,
+            trackingNumber: decision.trackingNumber
+        }, decision.trackingUrl ? {
+            trackingUrl: decision.trackingUrl
+        } : {}));
+        if (outcome.outcome === 'updated' || outcome.outcome === 'already') {
+            var _outcome_fulfillment_trackingNumber, _outcome_fulfillment_carrier;
+            const result = {
+                row: row.index,
+                outcome: outcome.outcome === 'updated' ? 'updated' : 'unchanged',
+                recordId: decision.orderId
+            };
+            const entry = outcome.outcome === 'updated' ? {
+                row: row.index,
+                recordId: decision.orderId,
+                action: 'updated',
+                previous: _extends({
+                    fulfillmentId: decision.fulfillmentId
+                }, decision.previous),
+                written: {
+                    fulfillmentId: decision.fulfillmentId,
+                    trackingNumber: (_outcome_fulfillment_trackingNumber = outcome.fulfillment.trackingNumber) != null ? _outcome_fulfillment_trackingNumber : null,
+                    carrier: (_outcome_fulfillment_carrier = outcome.fulfillment.carrier) != null ? _outcome_fulfillment_carrier : null
+                }
+            } : undefined;
+            results.push(result);
+            if (entry) undo.push(entry);
+            await writer.markApplied(result, entry);
+            continue;
+        }
+        await fail(row.index, outcome.outcome === 'locked' ? `The order is ${outcome.from.replace(/_/g, ' ')}; its shipments can no longer change.` : 'The shipment no longer exists.');
+    }
+    return {
+        results,
+        undo
+    };
+}
+/**
+ * Undoes one chunk, newest first: a parcel the import recorded is cancelled
+ * and a tracking number it replaced is put back — while the shipment still
+ * holds what the import wrote. A shipment edited since is a conflict, done
+ * only when the person's decision says `revert`.
+ */ export async function revertTracking(ctx, snapshot, decisions) {
+    const { hostId } = await shipperOf(ctx);
+    const firestore = firestoreOf();
+    const collection = ordersOf(firestore, ctx);
+    const done = [];
+    const conflicts = [];
+    for (const entry of [
+        ...snapshot.entries
+    ].reverse()){
+        var _entry_written_fulfillmentId, _doc_data, _ref, _ref1, _ref2, _ref3;
+        var _entry_previous, _entry_previous1, _entry_previous2, _entry_previous3, _entry_previous4;
+        const fulfillmentId = String((_entry_written_fulfillmentId = entry.written['fulfillmentId']) != null ? _entry_written_fulfillmentId : '');
+        const doc = await collection.doc(entry.recordId).get();
+        const order = doc.exists ? (_doc_data = doc.data()) != null ? _doc_data : {} : null;
+        const current = ((_ref = order == null ? void 0 : order['fulfillments']) != null ? _ref : []).find((fulfillment)=>fulfillment['id'] === fulfillmentId);
+        if (!doc.exists || !current || current['status'] === 'cancelled') {
+            done.push({
+                action: 'nothing',
+                recordId: entry.recordId,
+                why: doc.exists ? 'alreadyReverted' : 'gone'
+            });
+            continue;
+        }
+        const edited = normalizeTrackingNumber(current['trackingNumber']) !== normalizeTrackingNumber(entry.written['trackingNumber']);
+        if (edited && (decisions == null ? void 0 : decisions[entry.recordId]) !== 'revert') {
+            var _current_trackingNumber;
+            conflicts.push({
+                action: 'conflict',
+                recordId: entry.recordId,
+                fields: [
+                    'trackingNumber'
+                ],
+                values: {
+                    trackingNumber: (_current_trackingNumber = current['trackingNumber']) != null ? _current_trackingNumber : null
+                }
+            });
+            continue;
+        }
+        const recorded = ((_entry_previous = entry.previous) == null ? void 0 : _entry_previous['fulfillmentId']) === null;
+        const outcome = recorded ? await cancelOrderFulfillment({
+            hostId,
+            orderId: entry.recordId,
+            fulfillmentId
+        }) : await updateFulfillmentTracking(_extends({
+            hostId,
+            orderId: entry.recordId,
+            fulfillmentId,
+            carrier: String((_ref1 = (_entry_previous1 = entry.previous) == null ? void 0 : _entry_previous1['carrier']) != null ? _ref1 : ''),
+            trackingNumber: String((_ref2 = (_entry_previous2 = entry.previous) == null ? void 0 : _entry_previous2['trackingNumber']) != null ? _ref2 : '')
+        }, ((_entry_previous3 = entry.previous) == null ? void 0 : _entry_previous3['trackingUrl']) ? {
+            trackingUrl: String(entry.previous['trackingUrl'])
+        } : {}));
+        if (outcome.outcome === 'locked') {
+            conflicts.push({
+                action: 'conflict',
+                recordId: entry.recordId,
+                fields: [
+                    'status'
+                ],
+                values: {
+                    status: outcome.from
+                }
+            });
+            continue;
+        }
+        done.push(recorded ? {
+            action: 'delete',
+            recordId: entry.recordId
+        } : {
+            action: 'restore',
+            recordId: entry.recordId,
+            values: {
+                trackingNumber: (_ref3 = (_entry_previous4 = entry.previous) == null ? void 0 : _entry_previous4['trackingNumber']) != null ? _ref3 : null
+            }
+        });
+    }
+    return {
+        done,
+        conflicts
+    };
+}
+export const trackingTransfer = {
+    matchKeys: TRACKING_MATCH_KEYS,
+    defaultPolicy: TRACKING_DEFAULT_POLICY,
+    readPage: (ctx, cursor, fieldIds, options)=>readTrackingPage(ctx, cursor, fieldIds, options),
+    lookup: (ctx, requests)=>lookupTrackingOrders(ctx, requests),
+    match: (_ctx, input)=>({
+            outcomes: matchTrackingRows(input.rows, input.lookup)
+        }),
+    plan: (ctx, input)=>planTracking(ctx, input),
+    apply: (ctx, chunk, writer)=>applyTracking(ctx, chunk, writer),
+    revert: (ctx, snapshot, decisions)=>revertTracking(ctx, snapshot, decisions)
+};
+
+//# sourceMappingURL=tracking.server.js.map

package/src/lib/transfer/tracking.server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/transfer/tracking.server.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 {\n  buildMatchLookup,\n  type BuildTransferPlanInput,\n  type MatchKeySpec,\n  type MatchLookupRequest,\n  type PlannedTransferRow,\n  type TransferChunk,\n  type TransferPlan,\n  type TransferRowResult,\n  type TransferUndoEntry,\n  type TransferUndoSnapshot,\n  type TransferUndoStep,\n} from '@aglyn/aglyn/data-transfer'\nimport { hostRoleFor } from '@aglyn/aglyn/app-utils/organizations'\nimport * as Aglyn from '@aglyn/aglyn/server'\nimport type {\n  PluginTransferResource,\n  TransferApplyResult,\n  TransferApplyWriter,\n  TransferLookupResult,\n  TransferReadOptions,\n  TransferReadPage,\n  TransferResourceContext,\n  TransferRevertDecisions,\n  TransferRevertResult,\n} from '@aglyn/aglyn/plugin-manager/plugin-transfer-resources'\nimport { firebaseAdmin, getOrgForHost, resolveOrgMembership } from '@aglyn/tenant-data-admin'\nimport { TransferEngineError } from '@aglyn/tenant-data-admin/server/transfer-jobs'\nimport { normalizeTrackingNumber, parseShippingOrderRef } from '../model/order-shipping-export'\nimport {\n  cancelOrderFulfillment,\n  recordOrderShipment,\n  updateFulfillmentTracking,\n} from '../server/fulfill-order'\nimport { NOTHING, ROW_BUDGET_MS, firestoreOf, hostRefOf, readerSeesHost, type Firestore } from './server-common'\nimport {\n  TRACKING_DEFAULT_POLICY,\n  TRACKING_MATCH_KEYS,\n  matchTrackingRows,\n  planTrackingRows,\n  trackingExportRows,\n  trackingMatchValues,\n  trackingRecord,\n  type StoredTrackingOrder,\n  type TrackingPlannedRow,\n} from './tracking-transfer'\n\n/*\n * THE TRACKING IMPORT'S SERVER HALF (AGL-3613). The plan is\n * `planTrackingRows`; this module reads the orders it plans against, writes\n * each parcel through the order's own shipment paths and undoes them.\n *\n * - WHO: the site's admins and editors — the roles the console's Fulfill\n *   button has — on a plan that sells. Asked by the plan, the apply and the\n *   undo, each server-side.\n * - HOW: a new parcel through `recordOrderShipment`, keyed by its tracking\n *   number, so a retried chunk or a second import of the same file is one\n *   parcel; the buyer is emailed as for any shipment. A replaced tracking\n *   number through `updateFulfillmentTracking`.\n * - UNDO: a parcel this import recorded is cancelled (its units go back to\n *   unfulfilled), and a replaced tracking number is put back — each only\n *   while the shipment still holds what the import wrote; otherwise it is a\n *   conflict the person decides.\n */\n\nconst IN_MAX = 30\n\n/** Orders a page of the shipments export reads: those that have shipped something. */\nconst SHIPPED_STATUSES = ['partially_fulfilled', 'fulfilled', 'delivered']\n\n/** The member importing, checked for the role and the plan, or the refusal. */\nasync function shipperOf(ctx: TransferResourceContext): Promise<{ hostId: string }> {\n  const hostId = ctx.hostId\n  if (!hostId) throw new TransferEngineError('invalid', 400, 'Tracking numbers belong to a site; name the site.')\n  const uid = ctx.actorUid\n  const membership = uid ? await resolveOrgMembership(uid, ctx.orgId) : null\n  const role = membership?.member ? hostRoleFor(membership.member, hostId as never) : null\n  if (!uid || (role !== 'admin' && role !== 'editor')) {\n    throw new TransferEngineError('forbidden', 403, 'Only a site’s admins and editors can record shipments.')\n  }\n  const owner = await getOrgForHost(hostId).catch(() => null)\n  if (!Aglyn.checkEntitlement(owner?.org as never, 'commerce')) {\n    throw new TransferEngineError('forbidden', 403, 'This site’s plan does not include selling.')\n  }\n  return { hostId }\n}\n\nconst ordersOf = (firestore: Firestore, ctx: TransferResourceContext) => hostRefOf(firestore, ctx).collection('orders')\n\n/** Orders by the values a file names them by: numbers through one query per 30, ids directly. */\nasync function findOrders(\n  firestore: Firestore,\n  ctx: TransferResourceContext,\n  requests: readonly MatchLookupRequest[],\n): Promise<Map<string, FirebaseFirestore.DocumentSnapshot>> {\n  const collection = ordersOf(firestore, ctx)\n  const found = new Map<string, FirebaseFirestore.DocumentSnapshot>()\n  const numbers = new Set<number>()\n  const ids = new Set<string>()\n  for (const request of requests) {\n    for (const value of request.values) {\n      const ref = request.fieldId === 'id' ? { id: value } : parseShippingOrderRef(value)\n      if (!ref) continue\n      if (ref.number !== undefined) numbers.add(ref.number)\n      if (ref.id && !ref.id.includes('/') && !/^__.*__$/.test(ref.id)) ids.add(ref.id)\n    }\n  }\n  const numberList = [...numbers]\n  for (let at = 0; at < numberList.length; at += IN_MAX) {\n    const snapshot = await collection.where('number', 'in', numberList.slice(at, at + IN_MAX)).get()\n    for (const doc of snapshot.docs) found.set(doc.id, doc)\n  }\n  const idList = [...ids].filter((id) => !found.has(id))\n  for (let at = 0; at < idList.length; at += 100) {\n    for (const doc of await firestore.getAll(...idList.slice(at, at + 100).map((id) => collection.doc(id)))) {\n      if (doc.exists) found.set(doc.id, doc)\n    }\n  }\n  return found\n}\n\nexport async function lookupTrackingOrders(\n  ctx: TransferResourceContext,\n  requests: readonly MatchLookupRequest[],\n): Promise<TransferLookupResult> {\n  const found = await findOrders(firestoreOf(), ctx, requests)\n  const keys: MatchKeySpec[] = requests.map((request) => ({ fieldId: request.fieldId, normalizer: request.normalizer }))\n  const records = new Map<string, Readonly<Record<string, unknown>>>()\n  const entries: Array<{ id: string; values: Record<string, unknown> }> = []\n  for (const doc of found.values()) {\n    const data = (doc.data() ?? {}) as StoredTrackingOrder\n    records.set(doc.id, trackingRecord(doc.id, data))\n    entries.push({ id: doc.id, values: trackingMatchValues(doc.id, data) })\n  }\n  return { lookup: buildMatchLookup(entries, keys), records }\n}\n\n/**\n * The shipments export: every order that has shipped something, newest\n * first, one row per shipment with a tracking number. The cursor is the last\n * order's `createdAtMs` and id, as the orders export pages.\n */\nexport async function readTrackingPage(\n  ctx: TransferResourceContext,\n  cursor: string | null,\n  fieldIds: readonly string[],\n  options?: TransferReadOptions,\n): Promise<TransferReadPage> {\n  if (!readerSeesHost(ctx, options)) return NOTHING\n  if (options?.filter) throw new Error('Shipments export every shipment, or those of the orders you select.')\n  const firestore = firestoreOf()\n  const collection = ordersOf(firestore, ctx)\n  const pageSize = Math.max(1, Math.min(500, options?.pageSize ?? 200))\n  let docs: FirebaseFirestore.DocumentSnapshot[]\n  let next: string | null\n  if (options?.ids) {\n    const offset = cursor ? Number(cursor) : 0\n    const ids = options.ids.slice(offset, offset + pageSize)\n    docs = ids.length ? (await firestore.getAll(...ids.map((id) => collection.doc(id)))).filter((doc) => doc.exists) : []\n    next = offset + ids.length < options.ids.length ? String(offset + ids.length) : null\n  } else {\n    const query = collection\n      .where('status', 'in', SHIPPED_STATUSES)\n      .orderBy('createdAtMs', 'desc')\n      .orderBy(firebaseAdmin.firestore.FieldPath.documentId(), 'desc')\n    const after = cursor ? (JSON.parse(cursor) as unknown[]) : null\n    const snapshot = await (after ? query.startAfter(...after) : query).limit(pageSize).get()\n    docs = snapshot.docs\n    const last = snapshot.docs[snapshot.docs.length - 1]\n    next = last && snapshot.docs.length === pageSize ? JSON.stringify([last.get('createdAtMs') ?? null, last.id]) : null\n  }\n  const rows = docs.flatMap((doc) =>\n    trackingExportRows(doc.id, (doc.data() ?? {}) as StoredTrackingOrder).map((record) =>\n      Object.fromEntries(fieldIds.map((fieldId) => [fieldId, record[fieldId] ?? null])),\n    ),\n  )\n  return { rows, next }\n}\n\n/** The dry run, against every matched order read once. */\nexport async function planTracking(ctx: TransferResourceContext, input: BuildTransferPlanInput): Promise<TransferPlan> {\n  await shipperOf(ctx)\n  const firestore = firestoreOf()\n  const ids = [\n    ...new Set(\n      input.matches\n        .map((match) => (match.kind === 'matched' ? match.recordId : null))\n        .filter((id): id is string => Boolean(id)),\n    ),\n  ]\n  const collection = ordersOf(firestore, ctx)\n  const orders = new Map<string, StoredTrackingOrder>()\n  for (let at = 0; at < ids.length; at += 100) {\n    for (const doc of await firestore.getAll(...ids.slice(at, at + 100).map((id) => collection.doc(id)))) {\n      if (doc.exists) orders.set(doc.id, (doc.data() ?? {}) as StoredTrackingOrder)\n    }\n  }\n  return planTrackingRows(input, orders)\n}\n\n/** Records one chunk's parcels, each through the order's own shipment paths. */\nexport async function applyTracking(\n  ctx: TransferResourceContext,\n  chunk: TransferChunk<PlannedTransferRow>,\n  writer: TransferApplyWriter,\n): Promise<TransferApplyResult> {\n  const { hostId } = await shipperOf(ctx)\n  const results: TransferRowResult[] = []\n  const undo: TransferUndoEntry[] = []\n  const fail = async (row: number, message: string) => {\n    const result: TransferRowResult = { row, outcome: 'failed', reason: 'refusedValue', message }\n    results.push(result)\n    await writer.markApplied(result)\n  }\n  for (const row of chunk.rows as TrackingPlannedRow[]) {\n    const earlier = await writer.alreadyApplied(row.index)\n    if (earlier) {\n      results.push(earlier)\n      continue\n    }\n    if (writer.timeLeftMs() < ROW_BUDGET_MS) break\n    const decision = row.tracking\n    if (row.verdict !== 'update' || !decision) {\n      await fail(row.index, 'A tracking file only records parcels for orders it names.')\n      continue\n    }\n    if (decision.action === 'ship') {\n      const outcome = await recordOrderShipment({\n        hostId,\n        orderId: decision.orderId,\n        to: 'fulfilled',\n        carrier: decision.carrier,\n        trackingNumber: decision.trackingNumber,\n        ...(decision.trackingUrl ? { trackingUrl: decision.trackingUrl } : {}),\n        ...(decision.lineItems ? { lineItems: decision.lineItems } : {}),\n        idempotencyKey: `tracking-import:${normalizeTrackingNumber(decision.trackingNumber)}`,\n        onceByTracking: true,\n      })\n      if (outcome.outcome === 'recorded' || (outcome.outcome === 'already' && outcome.fulfillment)) {\n        const fulfillment = outcome.fulfillment\n        const result: TransferRowResult = {\n          row: row.index,\n          outcome: outcome.outcome === 'recorded' ? 'updated' : 'unchanged',\n          recordId: decision.orderId,\n        }\n        // Only a parcel THIS import recorded is undone; one found already\n        // there was somebody else's.\n        const entry: TransferUndoEntry | undefined =\n          outcome.outcome === 'recorded' && fulfillment\n            ? {\n                row: row.index,\n                recordId: decision.orderId,\n                action: 'updated',\n                previous: { fulfillmentId: null },\n                written: {\n                  fulfillmentId: fulfillment.id,\n                  trackingNumber: fulfillment.trackingNumber ?? null,\n                  carrier: fulfillment.carrier ?? null,\n                },\n              }\n            : undefined\n        results.push(result)\n        if (entry) undo.push(entry)\n        await writer.markApplied(result, entry)\n        continue\n      }\n      await fail(\n        row.index,\n        outcome.outcome === 'blocked'\n          ? `The order is ${outcome.from.replace(/_/g, ' ')} and cannot be shipped.`\n          : outcome.outcome === 'invalid_lines'\n            ? outcome.message\n            : outcome.outcome === 'no_such_order'\n              ? 'The order no longer exists.'\n              : 'The order has nothing left to ship.',\n      )\n      continue\n    }\n    const outcome = await updateFulfillmentTracking({\n      hostId,\n      orderId: decision.orderId,\n      fulfillmentId: decision.fulfillmentId,\n      carrier: decision.carrier,\n      trackingNumber: decision.trackingNumber,\n      ...(decision.trackingUrl ? { trackingUrl: decision.trackingUrl } : {}),\n    })\n    if (outcome.outcome === 'updated' || outcome.outcome === 'already') {\n      const result: TransferRowResult = {\n        row: row.index,\n        outcome: outcome.outcome === 'updated' ? 'updated' : 'unchanged',\n        recordId: decision.orderId,\n      }\n      const entry: TransferUndoEntry | undefined =\n        outcome.outcome === 'updated'\n          ? {\n              row: row.index,\n              recordId: decision.orderId,\n              action: 'updated',\n              previous: { fulfillmentId: decision.fulfillmentId, ...decision.previous },\n              written: {\n                fulfillmentId: decision.fulfillmentId,\n                trackingNumber: outcome.fulfillment.trackingNumber ?? null,\n                carrier: outcome.fulfillment.carrier ?? null,\n              },\n            }\n          : undefined\n      results.push(result)\n      if (entry) undo.push(entry)\n      await writer.markApplied(result, entry)\n      continue\n    }\n    await fail(\n      row.index,\n      outcome.outcome === 'locked'\n        ? `The order is ${outcome.from.replace(/_/g, ' ')}; its shipments can no longer change.`\n        : 'The shipment no longer exists.',\n    )\n  }\n  return { results, undo }\n}\n\n/**\n * Undoes one chunk, newest first: a parcel the import recorded is cancelled\n * and a tracking number it replaced is put back — while the shipment still\n * holds what the import wrote. A shipment edited since is a conflict, done\n * only when the person's decision says `revert`.\n */\nexport async function revertTracking(\n  ctx: TransferResourceContext,\n  snapshot: TransferUndoSnapshot,\n  decisions?: TransferRevertDecisions,\n): Promise<TransferRevertResult> {\n  const { hostId } = await shipperOf(ctx)\n  const firestore = firestoreOf()\n  const collection = ordersOf(firestore, ctx)\n  const done: TransferUndoStep[] = []\n  const conflicts: TransferUndoStep[] = []\n  for (const entry of [...snapshot.entries].reverse()) {\n    const fulfillmentId = String(entry.written['fulfillmentId'] ?? '')\n    const doc = await collection.doc(entry.recordId).get()\n    const order = doc.exists ? ((doc.data() ?? {}) as Record<string, unknown>) : null\n    const current = ((order?.['fulfillments'] as Array<Record<string, unknown>> | undefined) ?? []).find(\n      (fulfillment) => fulfillment['id'] === fulfillmentId,\n    )\n    if (!doc.exists || !current || current['status'] === 'cancelled') {\n      done.push({ action: 'nothing', recordId: entry.recordId, why: doc.exists ? 'alreadyReverted' : 'gone' })\n      continue\n    }\n    const edited =\n      normalizeTrackingNumber(current['trackingNumber']) !== normalizeTrackingNumber(entry.written['trackingNumber'])\n    if (edited && decisions?.[entry.recordId] !== 'revert') {\n      conflicts.push({\n        action: 'conflict',\n        recordId: entry.recordId,\n        fields: ['trackingNumber'],\n        values: { trackingNumber: current['trackingNumber'] ?? null },\n      })\n      continue\n    }\n    const recorded = entry.previous?.['fulfillmentId'] === null\n    const outcome = recorded\n      ? await cancelOrderFulfillment({ hostId, orderId: entry.recordId, fulfillmentId })\n      : await updateFulfillmentTracking({\n          hostId,\n          orderId: entry.recordId,\n          fulfillmentId,\n          carrier: String(entry.previous?.['carrier'] ?? ''),\n          trackingNumber: String(entry.previous?.['trackingNumber'] ?? ''),\n          ...(entry.previous?.['trackingUrl'] ? { trackingUrl: String(entry.previous['trackingUrl']) } : {}),\n        })\n    if (outcome.outcome === 'locked') {\n      conflicts.push({\n        action: 'conflict',\n        recordId: entry.recordId,\n        fields: ['status'],\n        values: { status: outcome.from },\n      })\n      continue\n    }\n    done.push(\n      recorded\n        ? { action: 'delete', recordId: entry.recordId }\n        : {\n            action: 'restore',\n            recordId: entry.recordId,\n            values: { trackingNumber: entry.previous?.['trackingNumber'] ?? null },\n          },\n    )\n  }\n  return { done, conflicts }\n}\n\nexport const trackingTransfer: PluginTransferResource = {\n  matchKeys: TRACKING_MATCH_KEYS,\n  defaultPolicy: TRACKING_DEFAULT_POLICY,\n  readPage: (ctx, cursor, fieldIds, options) => readTrackingPage(ctx, cursor, fieldIds, options),\n  lookup: (ctx, requests) => lookupTrackingOrders(ctx, requests),\n  match: (_ctx, input) => ({ outcomes: matchTrackingRows(input.rows, input.lookup) }),\n  plan: (ctx, input) => planTracking(ctx, input),\n  apply: (ctx, chunk, writer) => applyTracking(ctx, chunk, writer),\n  revert: (ctx, snapshot, decisions) => revertTracking(ctx, snapshot, decisions),\n}\n"],"names":["buildMatchLookup","hostRoleFor","Aglyn","firebaseAdmin","getOrgForHost","resolveOrgMembership","TransferEngineError","normalizeTrackingNumber","parseShippingOrderRef","cancelOrderFulfillment","recordOrderShipment","updateFulfillmentTracking","NOTHING","ROW_BUDGET_MS","firestoreOf","hostRefOf","readerSeesHost","TRACKING_DEFAULT_POLICY","TRACKING_MATCH_KEYS","matchTrackingRows","planTrackingRows","trackingExportRows","trackingMatchValues","trackingRecord","IN_MAX","SHIPPED_STATUSES","shipperOf","ctx","hostId","uid","actorUid","membership","orgId","role","member","owner","catch","checkEntitlement","org","ordersOf","firestore","collection","findOrders","requests","found","Map","numbers","Set","ids","request","value","values","ref","fieldId","id","number","undefined","add","includes","test","numberList","at","length","snapshot","where","slice","get","doc","docs","set","idList","filter","has","getAll","map","exists","lookupTrackingOrders","keys","normalizer","records","entries","data","push","lookup","readTrackingPage","cursor","fieldIds","options","Error","pageSize","Math","max","min","next","offset","Number","String","last","query","orderBy","FieldPath","documentId","after","JSON","parse","startAfter","limit","stringify","rows","flatMap","record","Object","fromEntries","planTracking","input","matches","match","kind","recordId","Boolean","orders","applyTracking","chunk","writer","results","undo","fail","row","message","result","outcome","reason","markApplied","earlier","alreadyApplied","index","timeLeftMs","decision","tracking","verdict","action","orderId","to","carrier","trackingNumber","trackingUrl","lineItems","idempotencyKey","onceByTracking","fulfillment","entry","previous","fulfillmentId","written","from","replace","revertTracking","decisions","done","conflicts","reverse","order","current","find","why","edited","fields","recorded","status","trackingTransfer","matchKeys","defaultPolicy","readPage","_ctx","outcomes","plan","apply","revert"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,gBAAgB,QAWX,6BAA4B;AACnC,SAASC,WAAW,QAAQ,uCAAsC;AAClE,YAAYC,WAAW,sBAAqB;AAY5C,SAASC,aAAa,EAAEC,aAAa,EAAEC,oBAAoB,QAAQ,2BAA0B;AAC7F,SAASC,mBAAmB,QAAQ,gDAA+C;AACnF,SAASC,uBAAuB,EAAEC,qBAAqB,QAAQ,oCAAgC;AAC/F,SACEC,sBAAsB,EACtBC,mBAAmB,EACnBC,yBAAyB,QACpB,6BAAyB;AAChC,SAASC,OAAO,EAAEC,aAAa,EAAEC,WAAW,EAAEC,SAAS,EAAEC,cAAc,QAAwB,qBAAiB;AAChH,SACEC,uBAAuB,EACvBC,mBAAmB,EACnBC,iBAAiB,EACjBC,gBAAgB,EAChBC,kBAAkB,EAClBC,mBAAmB,EACnBC,cAAc,QAGT,yBAAqB;AAE5B;;;;;;;;;;;;;;;;CAgBC,GAED,MAAMC,SAAS;AAEf,oFAAoF,GACpF,MAAMC,mBAAmB;IAAC;IAAuB;IAAa;CAAY;AAE1E,6EAA6E,GAC7E,eAAeC,UAAUC,GAA4B;IACnD,MAAMC,SAASD,IAAIC,MAAM;IACzB,IAAI,CAACA,QAAQ,MAAM,IAAItB,oBAAoB,WAAW,KAAK;IAC3D,MAAMuB,MAAMF,IAAIG,QAAQ;IACxB,MAAMC,aAAaF,MAAM,MAAMxB,qBAAqBwB,KAAKF,IAAIK,KAAK,IAAI;IACtE,MAAMC,OAAOF,CAAAA,8BAAAA,WAAYG,MAAM,IAAGjC,YAAY8B,WAAWG,MAAM,EAAEN,UAAmB;IACpF,IAAI,CAACC,OAAQI,SAAS,WAAWA,SAAS,UAAW;QACnD,MAAM,IAAI3B,oBAAoB,aAAa,KAAK;IAClD;IACA,MAAM6B,QAAQ,MAAM/B,cAAcwB,QAAQQ,KAAK,CAAC,IAAM;IACtD,IAAI,CAAClC,MAAMmC,gBAAgB,CAACF,yBAAAA,MAAOG,GAAG,EAAW,aAAa;QAC5D,MAAM,IAAIhC,oBAAoB,aAAa,KAAK;IAClD;IACA,OAAO;QAAEsB;IAAO;AAClB;AAEA,MAAMW,WAAW,CAACC,WAAsBb,MAAiCZ,UAAUyB,WAAWb,KAAKc,UAAU,CAAC;AAE9G,+FAA+F,GAC/F,eAAeC,WACbF,SAAoB,EACpBb,GAA4B,EAC5BgB,QAAuC;IAEvC,MAAMF,aAAaF,SAASC,WAAWb;IACvC,MAAMiB,QAAQ,IAAIC;IAClB,MAAMC,UAAU,IAAIC;IACpB,MAAMC,MAAM,IAAID;IAChB,KAAK,MAAME,WAAWN,SAAU;QAC9B,KAAK,MAAMO,SAASD,QAAQE,MAAM,CAAE;YAClC,MAAMC,MAAMH,QAAQI,OAAO,KAAK,OAAO;gBAAEC,IAAIJ;YAAM,IAAI1C,sBAAsB0C;YAC7E,IAAI,CAACE,KAAK;YACV,IAAIA,IAAIG,MAAM,KAAKC,WAAWV,QAAQW,GAAG,CAACL,IAAIG,MAAM;YACpD,IAAIH,IAAIE,EAAE,IAAI,CAACF,IAAIE,EAAE,CAACI,QAAQ,CAAC,QAAQ,CAAC,WAAWC,IAAI,CAACP,IAAIE,EAAE,GAAGN,IAAIS,GAAG,CAACL,IAAIE,EAAE;QACjF;IACF;IACA,MAAMM,aAAa;WAAId;KAAQ;IAC/B,IAAK,IAAIe,KAAK,GAAGA,KAAKD,WAAWE,MAAM,EAAED,MAAMrC,OAAQ;QACrD,MAAMuC,WAAW,MAAMtB,WAAWuB,KAAK,CAAC,UAAU,MAAMJ,WAAWK,KAAK,CAACJ,IAAIA,KAAKrC,SAAS0C,GAAG;QAC9F,KAAK,MAAMC,OAAOJ,SAASK,IAAI,CAAExB,MAAMyB,GAAG,CAACF,IAAIb,EAAE,EAAEa;IACrD;IACA,MAAMG,SAAS;WAAItB;KAAI,CAACuB,MAAM,CAAC,CAACjB,KAAO,CAACV,MAAM4B,GAAG,CAAClB;IAClD,IAAK,IAAIO,KAAK,GAAGA,KAAKS,OAAOR,MAAM,EAAED,MAAM,IAAK;QAC9C,KAAK,MAAMM,OAAO,CAAA,MAAM3B,UAAUiC,MAAM,IAAIH,OAAOL,KAAK,CAACJ,IAAIA,KAAK,KAAKa,GAAG,CAAC,CAACpB,KAAOb,WAAW0B,GAAG,CAACb,KAAI,EAAG;YACvG,IAAIa,IAAIQ,MAAM,EAAE/B,MAAMyB,GAAG,CAACF,IAAIb,EAAE,EAAEa;QACpC;IACF;IACA,OAAOvB;AACT;AAEA,OAAO,eAAegC,qBACpBjD,GAA4B,EAC5BgB,QAAuC;IAEvC,MAAMC,QAAQ,MAAMF,WAAW5B,eAAea,KAAKgB;IACnD,MAAMkC,OAAuBlC,SAAS+B,GAAG,CAAC,CAACzB,UAAa,CAAA;YAAEI,SAASJ,QAAQI,OAAO;YAAEyB,YAAY7B,QAAQ6B,UAAU;QAAC,CAAA;IACnH,MAAMC,UAAU,IAAIlC;IACpB,MAAMmC,UAAkE,EAAE;IAC1E,KAAK,MAAMb,OAAOvB,MAAMO,MAAM,GAAI;YAClBgB;QAAd,MAAMc,QAAQd,YAAAA,IAAIc,IAAI,cAARd,YAAc,CAAC;QAC7BY,QAAQV,GAAG,CAACF,IAAIb,EAAE,EAAE/B,eAAe4C,IAAIb,EAAE,EAAE2B;QAC3CD,QAAQE,IAAI,CAAC;YAAE5B,IAAIa,IAAIb,EAAE;YAAEH,QAAQ7B,oBAAoB6C,IAAIb,EAAE,EAAE2B;QAAM;IACvE;IACA,OAAO;QAAEE,QAAQnF,iBAAiBgF,SAASH;QAAOE;IAAQ;AAC5D;AAEA;;;;CAIC,GACD,OAAO,eAAeK,iBACpBzD,GAA4B,EAC5B0D,MAAqB,EACrBC,QAA2B,EAC3BC,OAA6B;;IAE7B,IAAI,CAACvE,eAAeW,KAAK4D,UAAU,OAAO3E;IAC1C,IAAI2E,2BAAAA,QAAShB,MAAM,EAAE,MAAM,IAAIiB,MAAM;IACrC,MAAMhD,YAAY1B;IAClB,MAAM2B,aAAaF,SAASC,WAAWb;IACvC,MAAM8D,WAAWC,KAAKC,GAAG,CAAC,GAAGD,KAAKE,GAAG,CAAC,aAAKL,2BAAAA,QAASE,QAAQ,mBAAI;IAChE,IAAIrB;IACJ,IAAIyB;IACJ,IAAIN,2BAAAA,QAASvC,GAAG,EAAE;QAChB,MAAM8C,SAAST,SAASU,OAAOV,UAAU;QACzC,MAAMrC,MAAMuC,QAAQvC,GAAG,CAACiB,KAAK,CAAC6B,QAAQA,SAASL;QAC/CrB,OAAOpB,IAAIc,MAAM,GAAG,AAAC,CAAA,MAAMtB,UAAUiC,MAAM,IAAIzB,IAAI0B,GAAG,CAAC,CAACpB,KAAOb,WAAW0B,GAAG,CAACb,KAAI,EAAGiB,MAAM,CAAC,CAACJ,MAAQA,IAAIQ,MAAM,IAAI,EAAE;QACrHkB,OAAOC,SAAS9C,IAAIc,MAAM,GAAGyB,QAAQvC,GAAG,CAACc,MAAM,GAAGkC,OAAOF,SAAS9C,IAAIc,MAAM,IAAI;IAClF,OAAO;YAS8DmC;QARnE,MAAMC,QAAQzD,WACXuB,KAAK,CAAC,UAAU,MAAMvC,kBACtB0E,OAAO,CAAC,eAAe,QACvBA,OAAO,CAAChG,cAAcqC,SAAS,CAAC4D,SAAS,CAACC,UAAU,IAAI;QAC3D,MAAMC,QAAQjB,SAAUkB,KAAKC,KAAK,CAACnB,UAAwB;QAC3D,MAAMtB,WAAW,MAAM,AAACuC,CAAAA,QAAQJ,MAAMO,UAAU,IAAIH,SAASJ,KAAI,EAAGQ,KAAK,CAACjB,UAAUvB,GAAG;QACvFE,OAAOL,SAASK,IAAI;QACpB,MAAM6B,OAAOlC,SAASK,IAAI,CAACL,SAASK,IAAI,CAACN,MAAM,GAAG,EAAE;QACpD+B,OAAOI,QAAQlC,SAASK,IAAI,CAACN,MAAM,KAAK2B,WAAWc,KAAKI,SAAS,CAAC;aAACV,YAAAA,KAAK/B,GAAG,CAAC,0BAAT+B,YAA2B;YAAMA,KAAK3C,EAAE;SAAC,IAAI;IAClH;IACA,MAAMsD,OAAOxC,KAAKyC,OAAO,CAAC,CAAC1C;YACGA;eAA5B9C,mBAAmB8C,IAAIb,EAAE,GAAGa,YAAAA,IAAIc,IAAI,cAARd,YAAc,CAAC,GAA2BO,GAAG,CAAC,CAACoC,SACzEC,OAAOC,WAAW,CAAC1B,SAASZ,GAAG,CAAC,CAACrB;oBAAsByD;uBAAV;oBAACzD;qBAASyD,kBAAAA,MAAM,CAACzD,QAAQ,YAAfyD,kBAAmB;iBAAK;;;IAGnF,OAAO;QAAEF;QAAMf;IAAK;AACtB;AAEA,wDAAwD,GACxD,OAAO,eAAeoB,aAAatF,GAA4B,EAAEuF,KAA6B;IAC5F,MAAMxF,UAAUC;IAChB,MAAMa,YAAY1B;IAClB,MAAMkC,MAAM;WACP,IAAID,IACLmE,MAAMC,OAAO,CACVzC,GAAG,CAAC,CAAC0C,QAAWA,MAAMC,IAAI,KAAK,YAAYD,MAAME,QAAQ,GAAG,MAC5D/C,MAAM,CAAC,CAACjB,KAAqBiE,QAAQjE;KAE3C;IACD,MAAMb,aAAaF,SAASC,WAAWb;IACvC,MAAM6F,SAAS,IAAI3E;IACnB,IAAK,IAAIgB,KAAK,GAAGA,KAAKb,IAAIc,MAAM,EAAED,MAAM,IAAK;QAC3C,KAAK,MAAMM,OAAO,CAAA,MAAM3B,UAAUiC,MAAM,IAAIzB,IAAIiB,KAAK,CAACJ,IAAIA,KAAK,KAAKa,GAAG,CAAC,CAACpB,KAAOb,WAAW0B,GAAG,CAACb,KAAI,EAAG;gBAChEa;YAApC,IAAIA,IAAIQ,MAAM,EAAE6C,OAAOnD,GAAG,CAACF,IAAIb,EAAE,GAAGa,YAAAA,IAAIc,IAAI,cAARd,YAAc,CAAC;QACrD;IACF;IACA,OAAO/C,iBAAiB8F,OAAOM;AACjC;AAEA,8EAA8E,GAC9E,OAAO,eAAeC,cACpB9F,GAA4B,EAC5B+F,KAAwC,EACxCC,MAA2B;IAE3B,MAAM,EAAE/F,MAAM,EAAE,GAAG,MAAMF,UAAUC;IACnC,MAAMiG,UAA+B,EAAE;IACvC,MAAMC,OAA4B,EAAE;IACpC,MAAMC,OAAO,OAAOC,KAAaC;QAC/B,MAAMC,SAA4B;YAAEF;YAAKG,SAAS;YAAUC,QAAQ;YAAgBH;QAAQ;QAC5FJ,QAAQ1C,IAAI,CAAC+C;QACb,MAAMN,OAAOS,WAAW,CAACH;IAC3B;IACA,KAAK,MAAMF,OAAOL,MAAMd,IAAI,CAA0B;QACpD,MAAMyB,UAAU,MAAMV,OAAOW,cAAc,CAACP,IAAIQ,KAAK;QACrD,IAAIF,SAAS;YACXT,QAAQ1C,IAAI,CAACmD;YACb;QACF;QACA,IAAIV,OAAOa,UAAU,KAAK3H,eAAe;QACzC,MAAM4H,WAAWV,IAAIW,QAAQ;QAC7B,IAAIX,IAAIY,OAAO,KAAK,YAAY,CAACF,UAAU;YACzC,MAAMX,KAAKC,IAAIQ,KAAK,EAAE;YACtB;QACF;QACA,IAAIE,SAASG,MAAM,KAAK,QAAQ;YAC9B,MAAMV,UAAU,MAAMxH,oBAAoB;gBACxCkB;gBACAiH,SAASJ,SAASI,OAAO;gBACzBC,IAAI;gBACJC,SAASN,SAASM,OAAO;gBACzBC,gBAAgBP,SAASO,cAAc;eACnCP,SAASQ,WAAW,GAAG;gBAAEA,aAAaR,SAASQ,WAAW;YAAC,IAAI,CAAC,GAChER,SAASS,SAAS,GAAG;gBAAEA,WAAWT,SAASS,SAAS;YAAC,IAAI,CAAC;gBAC9DC,gBAAgB,CAAC,gBAAgB,EAAE5I,wBAAwBkI,SAASO,cAAc,GAAG;gBACrFI,gBAAgB;;YAElB,IAAIlB,QAAQA,OAAO,KAAK,cAAeA,QAAQA,OAAO,KAAK,aAAaA,QAAQmB,WAAW,EAAG;oBAkBlEA,6BACPA;gBAlBnB,MAAMA,cAAcnB,QAAQmB,WAAW;gBACvC,MAAMpB,SAA4B;oBAChCF,KAAKA,IAAIQ,KAAK;oBACdL,SAASA,QAAQA,OAAO,KAAK,aAAa,YAAY;oBACtDZ,UAAUmB,SAASI,OAAO;gBAC5B;gBACA,kEAAkE;gBAClE,6BAA6B;gBAC7B,MAAMS,QACJpB,QAAQA,OAAO,KAAK,cAAcmB,cAC9B;oBACEtB,KAAKA,IAAIQ,KAAK;oBACdjB,UAAUmB,SAASI,OAAO;oBAC1BD,QAAQ;oBACRW,UAAU;wBAAEC,eAAe;oBAAK;oBAChCC,SAAS;wBACPD,eAAeH,YAAY/F,EAAE;wBAC7B0F,cAAc,GAAEK,8BAAAA,YAAYL,cAAc,YAA1BK,8BAA8B;wBAC9CN,OAAO,GAAEM,uBAAAA,YAAYN,OAAO,YAAnBM,uBAAuB;oBAClC;gBACF,IACA7F;gBACNoE,QAAQ1C,IAAI,CAAC+C;gBACb,IAAIqB,OAAOzB,KAAK3C,IAAI,CAACoE;gBACrB,MAAM3B,OAAOS,WAAW,CAACH,QAAQqB;gBACjC;YACF;YACA,MAAMxB,KACJC,IAAIQ,KAAK,EACTL,QAAQA,OAAO,KAAK,YAChB,CAAC,aAAa,EAAEA,QAAQwB,IAAI,CAACC,OAAO,CAAC,MAAM,KAAK,uBAAuB,CAAC,GACxEzB,QAAQA,OAAO,KAAK,kBAClBA,QAAQF,OAAO,GACfE,QAAQA,OAAO,KAAK,kBAClB,gCACA;YAEV;QACF;QACA,MAAMA,UAAU,MAAMvH,0BAA0B;YAC9CiB;YACAiH,SAASJ,SAASI,OAAO;YACzBW,eAAef,SAASe,aAAa;YACrCT,SAASN,SAASM,OAAO;YACzBC,gBAAgBP,SAASO,cAAc;WACnCP,SAASQ,WAAW,GAAG;YAAEA,aAAaR,SAASQ,WAAW;QAAC,IAAI,CAAC;QAEtE,IAAIf,QAAQA,OAAO,KAAK,aAAaA,QAAQA,OAAO,KAAK,WAAW;gBAexCA,qCACPA;YAfnB,MAAMD,SAA4B;gBAChCF,KAAKA,IAAIQ,KAAK;gBACdL,SAASA,QAAQA,OAAO,KAAK,YAAY,YAAY;gBACrDZ,UAAUmB,SAASI,OAAO;YAC5B;YACA,MAAMS,QACJpB,QAAQA,OAAO,KAAK,YAChB;gBACEH,KAAKA,IAAIQ,KAAK;gBACdjB,UAAUmB,SAASI,OAAO;gBAC1BD,QAAQ;gBACRW,UAAU;oBAAEC,eAAef,SAASe,aAAa;mBAAKf,SAASc,QAAQ;gBACvEE,SAAS;oBACPD,eAAef,SAASe,aAAa;oBACrCR,cAAc,GAAEd,sCAAAA,QAAQmB,WAAW,CAACL,cAAc,YAAlCd,sCAAsC;oBACtDa,OAAO,GAAEb,+BAAAA,QAAQmB,WAAW,CAACN,OAAO,YAA3Bb,+BAA+B;gBAC1C;YACF,IACA1E;YACNoE,QAAQ1C,IAAI,CAAC+C;YACb,IAAIqB,OAAOzB,KAAK3C,IAAI,CAACoE;YACrB,MAAM3B,OAAOS,WAAW,CAACH,QAAQqB;YACjC;QACF;QACA,MAAMxB,KACJC,IAAIQ,KAAK,EACTL,QAAQA,OAAO,KAAK,WAChB,CAAC,aAAa,EAAEA,QAAQwB,IAAI,CAACC,OAAO,CAAC,MAAM,KAAK,qCAAqC,CAAC,GACtF;IAER;IACA,OAAO;QAAE/B;QAASC;IAAK;AACzB;AAEA;;;;;CAKC,GACD,OAAO,eAAe+B,eACpBjI,GAA4B,EAC5BoC,QAA8B,EAC9B8F,SAAmC;IAEnC,MAAM,EAAEjI,MAAM,EAAE,GAAG,MAAMF,UAAUC;IACnC,MAAMa,YAAY1B;IAClB,MAAM2B,aAAaF,SAASC,WAAWb;IACvC,MAAMmI,OAA2B,EAAE;IACnC,MAAMC,YAAgC,EAAE;IACxC,KAAK,MAAMT,SAAS;WAAIvF,SAASiB,OAAO;KAAC,CAACgF,OAAO,GAAI;YACtBV,8BAEAnF;YAmBZmF,iBAOKA,kBACOA,kBACnBA,kBAiBwBA;QA/ClC,MAAME,gBAAgBxD,QAAOsD,+BAAAA,MAAMG,OAAO,CAAC,gBAAgB,YAA9BH,+BAAkC;QAC/D,MAAMnF,MAAM,MAAM1B,WAAW0B,GAAG,CAACmF,MAAMhC,QAAQ,EAAEpD,GAAG;QACpD,MAAM+F,QAAQ9F,IAAIQ,MAAM,IAAKR,YAAAA,IAAIc,IAAI,cAARd,YAAc,CAAC,IAAiC;QAC7E,MAAM+F,UAAU,SAAED,yBAAAA,KAAO,CAAC,eAAe,mBAAmD,EAAE,EAAEE,IAAI,CAClG,CAACd,cAAgBA,WAAW,CAAC,KAAK,KAAKG;QAEzC,IAAI,CAACrF,IAAIQ,MAAM,IAAI,CAACuF,WAAWA,OAAO,CAAC,SAAS,KAAK,aAAa;YAChEJ,KAAK5E,IAAI,CAAC;gBAAE0D,QAAQ;gBAAWtB,UAAUgC,MAAMhC,QAAQ;gBAAE8C,KAAKjG,IAAIQ,MAAM,GAAG,oBAAoB;YAAO;YACtG;QACF;QACA,MAAM0F,SACJ9J,wBAAwB2J,OAAO,CAAC,iBAAiB,MAAM3J,wBAAwB+I,MAAMG,OAAO,CAAC,iBAAiB;QAChH,IAAIY,UAAUR,CAAAA,6BAAAA,SAAW,CAACP,MAAMhC,QAAQ,CAAC,MAAK,UAAU;gBAK1B4C;YAJ5BH,UAAU7E,IAAI,CAAC;gBACb0D,QAAQ;gBACRtB,UAAUgC,MAAMhC,QAAQ;gBACxBgD,QAAQ;oBAAC;iBAAiB;gBAC1BnH,QAAQ;oBAAE6F,cAAc,GAAEkB,0BAAAA,OAAO,CAAC,iBAAiB,YAAzBA,0BAA6B;gBAAK;YAC9D;YACA;QACF;QACA,MAAMK,WAAWjB,EAAAA,kBAAAA,MAAMC,QAAQ,qBAAdD,eAAgB,CAAC,gBAAgB,MAAK;QACvD,MAAMpB,UAAUqC,WACZ,MAAM9J,uBAAuB;YAAEmB;YAAQiH,SAASS,MAAMhC,QAAQ;YAAEkC;QAAc,KAC9E,MAAM7I,0BAA0B;YAC9BiB;YACAiH,SAASS,MAAMhC,QAAQ;YACvBkC;YACAT,SAAS/C,iBAAOsD,mBAAAA,MAAMC,QAAQ,qBAAdD,gBAAgB,CAAC,UAAU,oBAAI;YAC/CN,gBAAgBhD,iBAAOsD,mBAAAA,MAAMC,QAAQ,qBAAdD,gBAAgB,CAAC,iBAAiB,oBAAI;WACzDA,EAAAA,mBAAAA,MAAMC,QAAQ,qBAAdD,gBAAgB,CAAC,cAAc,IAAG;YAAEL,aAAajD,OAAOsD,MAAMC,QAAQ,CAAC,cAAc;QAAE,IAAI,CAAC;QAEtG,IAAIrB,QAAQA,OAAO,KAAK,UAAU;YAChC6B,UAAU7E,IAAI,CAAC;gBACb0D,QAAQ;gBACRtB,UAAUgC,MAAMhC,QAAQ;gBACxBgD,QAAQ;oBAAC;iBAAS;gBAClBnH,QAAQ;oBAAEqH,QAAQtC,QAAQwB,IAAI;gBAAC;YACjC;YACA;QACF;QACAI,KAAK5E,IAAI,CACPqF,WACI;YAAE3B,QAAQ;YAAUtB,UAAUgC,MAAMhC,QAAQ;QAAC,IAC7C;YACEsB,QAAQ;YACRtB,UAAUgC,MAAMhC,QAAQ;YACxBnE,QAAQ;gBAAE6F,cAAc,YAAEM,mBAAAA,MAAMC,QAAQ,qBAAdD,gBAAgB,CAAC,iBAAiB,oBAAI;YAAK;QACvE;IAER;IACA,OAAO;QAAEQ;QAAMC;IAAU;AAC3B;AAEA,OAAO,MAAMU,mBAA2C;IACtDC,WAAWxJ;IACXyJ,eAAe1J;IACf2J,UAAU,CAACjJ,KAAK0D,QAAQC,UAAUC,UAAYH,iBAAiBzD,KAAK0D,QAAQC,UAAUC;IACtFJ,QAAQ,CAACxD,KAAKgB,WAAaiC,qBAAqBjD,KAAKgB;IACrDyE,OAAO,CAACyD,MAAM3D,QAAW,CAAA;YAAE4D,UAAU3J,kBAAkB+F,MAAMN,IAAI,EAAEM,MAAM/B,MAAM;QAAE,CAAA;IACjF4F,MAAM,CAACpJ,KAAKuF,QAAUD,aAAatF,KAAKuF;IACxC8D,OAAO,CAACrJ,KAAK+F,OAAOC,SAAWF,cAAc9F,KAAK+F,OAAOC;IACzDsD,QAAQ,CAACtJ,KAAKoC,UAAU8F,YAAcD,eAAejI,KAAKoC,UAAU8F;AACtE,EAAC"}

package/src/lib/transfer/transfer-keys.d.ts

@@ -20,8 +20,9 @@ export declare const COMMERCE_DISCOUNTS_TRANSFER = "commerce.discounts";
 export declare const COMMERCE_COUPONS_TRANSFER = "commerce.coupons";
 export declare const COMMERCE_GIFT_CARDS_TRANSFER = "commerce.gift-cards";
 export declare const COMMERCE_CATEGORIES_TRANSFER = "commerce.categories";
+export declare const COMMERCE_TRACKING_TRANSFER = "commerce.tracking";
 /** Every commerce resource key, in the order the hub lists them. */
-export declare const COMMERCE_TRANSFER_RESOURCES: readonly ["commerce.products", "commerce.categories", "commerce.orders", "commerce.discounts", "commerce.coupons", "commerce.gift-cards"];
+export declare const COMMERCE_TRANSFER_RESOURCES: readonly ["commerce.products", "commerce.categories", "commerce.orders", "commerce.discounts", "commerce.coupons", "commerce.gift-cards", "commerce.tracking"];
 /** The resources a file may write; the others are exported only. */
 export declare const COMMERCE_IMPORTABLE_TRANSFERS: ReadonlySet<string>;
 /**

package/src/lib/transfer/transfer-keys.js

@@ -27,26 +27,30 @@
  * | coupons | yes | matched by code; new ones start switched off |
  * | orders | no | an order is the record of a sale, written by checkout alone |
  * | gift cards | yes, by issuing | each row issues a card through the issue path, confirmed by its total; owners and admins only |
+ * | tracking numbers | yes, by shipping | each row is a parcel: it ships what its order still owes, or replaces a shipped order's tracking when the person chooses (AGL-3613) |
  */ export const COMMERCE_PRODUCTS_TRANSFER = 'commerce.products';
 export const COMMERCE_ORDERS_TRANSFER = 'commerce.orders';
 export const COMMERCE_DISCOUNTS_TRANSFER = 'commerce.discounts';
 export const COMMERCE_COUPONS_TRANSFER = 'commerce.coupons';
 export const COMMERCE_GIFT_CARDS_TRANSFER = 'commerce.gift-cards';
 export const COMMERCE_CATEGORIES_TRANSFER = 'commerce.categories';
+export const COMMERCE_TRACKING_TRANSFER = 'commerce.tracking';
 /** Every commerce resource key, in the order the hub lists them. */ export const COMMERCE_TRANSFER_RESOURCES = [
     COMMERCE_PRODUCTS_TRANSFER,
     COMMERCE_CATEGORIES_TRANSFER,
     COMMERCE_ORDERS_TRANSFER,
     COMMERCE_DISCOUNTS_TRANSFER,
     COMMERCE_COUPONS_TRANSFER,
-    COMMERCE_GIFT_CARDS_TRANSFER
+    COMMERCE_GIFT_CARDS_TRANSFER,
+    COMMERCE_TRACKING_TRANSFER
 ];
 /** The resources a file may write; the others are exported only. */ export const COMMERCE_IMPORTABLE_TRANSFERS = new Set([
     COMMERCE_PRODUCTS_TRANSFER,
     COMMERCE_CATEGORIES_TRANSFER,
     COMMERCE_DISCOUNTS_TRANSFER,
     COMMERCE_COUPONS_TRANSFER,
-    COMMERCE_GIFT_CARDS_TRANSFER
+    COMMERCE_GIFT_CARDS_TRANSFER,
+    COMMERCE_TRACKING_TRANSFER
 ]);
 /**
  * The gift card import's Confirm step (AGL-3551), and the key its answer