@aglyn/plugins-commerce 1.0.0-beta.284 → 1.0.0-beta.287

package/src/lib/testing/pos-ops-memory-firestore.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/testing/pos-ops-memory-firestore.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/*==========================================\n * AN IN-MEMORY ADMIN FIRESTORE, for the register operations' specs\n * (AGL-3609) — the CRM's transfer double (AGL-3527), kept beside the\n * commerce specs because one plugin's testing helpers are not another's\n * to import.\n *\n * Documents by path; the operators the CRM's transfer hooks and the job\n * engine issue — `where` (equality, ranges, `in`, the array operators),\n * `orderBy` (a field or the document id), `limit`, `startAfter`, `count`,\n * `getAll`, batches and read-then-write transactions — and the write\n * sentinels (`delete`, `serverTimestamp`, `arrayUnion`, `arrayRemove`,\n * `increment`) applied along dotted paths, as Firestore applies them.\n *\n * A spec mocks `firebase-admin/firestore` with {@link memoryFirestoreModule}\n * so the code under test builds its sentinels from the same table.\n *=========================================*/\n\ntype Data = Record<string, unknown>\n\ninterface Sentinel {\n  __sentinel: 'delete' | 'serverTimestamp' | 'arrayUnion' | 'arrayRemove' | 'increment'\n  values?: unknown[]\n  by?: number\n}\n\nconst DOCUMENT_ID = { __documentId: true }\n\n/** What a spec hands `jest.mock('firebase-admin/firestore', …)`. */\nexport const memoryFirestoreModule = {\n  __esModule: true,\n  FieldValue: {\n    delete: (): Sentinel => ({ __sentinel: 'delete' }),\n    serverTimestamp: (): Sentinel => ({ __sentinel: 'serverTimestamp' }),\n    arrayUnion: (...values: unknown[]): Sentinel => ({ __sentinel: 'arrayUnion', values }),\n    arrayRemove: (...values: unknown[]): Sentinel => ({ __sentinel: 'arrayRemove', values }),\n    increment: (by: number): Sentinel => ({ __sentinel: 'increment', by }),\n  },\n  FieldPath: { documentId: () => DOCUMENT_ID },\n  Timestamp: { fromDate: (date: Date) => date.getTime() },\n}\n\nconst isSentinel = (value: unknown): value is Sentinel =>\n  Boolean(value && typeof value === 'object' && '__sentinel' in (value as object))\n\nconst copy = <T>(value: T): T => (value === undefined ? value : (JSON.parse(JSON.stringify(value)) as T))\n\nfunction readPath(data: Data | undefined, path: string): unknown {\n  return path.split('.').reduce<unknown>((node, key) => (node as Data | undefined)?.[key], data)\n}\n\nexport interface MemoryFirestore {\n  /** Every document, by full path. */\n  docs: Map<string, Data>\n  /** The clock `serverTimestamp` writes. */\n  now: () => number\n  firestore: FirebaseFirestore.Firestore\n  /** Seeds one document at its full path. */\n  seed: (path: string, data: Data) => void\n  /** A document's data, or `undefined`. */\n  read: (path: string) => Data | undefined\n}\n\n/** A fresh in-memory Firestore. */\nexport function memoryFirestore(clock: () => number = () => 1_800_000_000_000): MemoryFirestore {\n  const docs = new Map<string, Data>()\n  /** A write counter per path, for the transaction's concurrency check. */\n  const versions = new Map<string, number>()\n  const bump = (path: string) => versions.set(path, (versions.get(path) ?? 0) + 1)\n\n  const resolve = (value: unknown, current: unknown): unknown => {\n    if (!isSentinel(value)) return Array.isArray(value) || (value && typeof value === 'object') ? copy(value) : value\n    switch (value.__sentinel) {\n      case 'serverTimestamp':\n        return clock()\n      case 'arrayUnion':\n        return [...new Set([...(Array.isArray(current) ? current : []), ...(value.values ?? [])])]\n      case 'arrayRemove':\n        return (Array.isArray(current) ? current : []).filter((entry) => !(value.values ?? []).includes(entry))\n      case 'increment':\n        return Number(current ?? 0) + Number(value.by ?? 0)\n      default:\n        return undefined\n    }\n  }\n\n  /** Writes `value` at a dotted path, a `delete` sentinel removing the leaf. */\n  const writePath = (target: Data, path: string, value: unknown): void => {\n    const keys = path.split('.')\n    let node = target\n    for (const key of keys.slice(0, -1)) {\n      if (!node[key] || typeof node[key] !== 'object') node[key] = {}\n      node = node[key] as Data\n    }\n    const leaf = keys[keys.length - 1] as string\n    if (isSentinel(value) && value.__sentinel === 'delete') delete node[leaf]\n    else node[leaf] = resolve(value, node[leaf])\n  }\n\n  /** Every top-level key of `data` with sentinels resolved (a `set`). */\n  const settle = (data: Data, base: Data = {}): Data => {\n    const next = copy(base)\n    for (const [key, value] of Object.entries(data)) {\n      if (value === undefined) continue\n      if (isSentinel(value)) writePath(next, key, value)\n      else if (value && typeof value === 'object' && !Array.isArray(value) && base[key] && typeof base[key] === 'object') {\n        next[key] = settle(value as Data, base[key] as Data)\n      } else next[key] = resolve(value, next[key])\n    }\n    return next\n  }\n\n  const snapshot = (path: string): any => {\n    const data = docs.get(path)\n    return {\n      id: path.slice(path.lastIndexOf('/') + 1),\n      ref: docRef(path),\n      exists: data !== undefined,\n      data: () => copy(data),\n      get: (field: string) => copy(readPath(data, field)),\n    }\n  }\n\n  const docRef = (path: string): any => ({\n    id: path.slice(path.lastIndexOf('/') + 1),\n    path,\n    get firestore() {\n      return firestore\n    },\n    get parent() {\n      return collectionRef(path.slice(0, path.lastIndexOf('/')))\n    },\n    collection: (name: string) => collectionRef(`${path}/${name}`),\n    get: async () => snapshot(path),\n    set: async (data: Data, options?: { merge?: boolean }) => {\n      docs.set(path, settle(data, options?.merge ? (docs.get(path) ?? {}) : {}))\n      bump(path)\n    },\n    create: async (data: Data) => {\n      if (docs.has(path)) throw Object.assign(new Error(`ALREADY_EXISTS: ${path}`), { code: 6 })\n      docs.set(path, settle(data))\n      bump(path)\n    },\n    update: async (...args: unknown[]) => {\n      const current = docs.get(path)\n      if (!current) throw Object.assign(new Error(`NOT_FOUND: ${path}`), { code: 5 })\n      const patch: Data =\n        typeof args[0] === 'string'\n          ? Object.fromEntries(\n              Array.from({ length: args.length / 2 }, (_unused, at) => [String(args[at * 2]), args[at * 2 + 1]]),\n            )\n          : (args[0] as Data)\n      const next = copy(current)\n      for (const [key, value] of Object.entries(patch)) writePath(next, key, value)\n      docs.set(path, next)\n      bump(path)\n    },\n    delete: async () => {\n      docs.delete(path)\n      bump(path)\n    },\n  })\n\n  interface QueryState {\n    path: string\n    filters: Array<{ field: string | typeof DOCUMENT_ID; op: string; value: unknown }>\n    order: Array<{ field: string | typeof DOCUMENT_ID; direction: 'asc' | 'desc' }>\n    limit?: number\n    after?: any\n  }\n\n  const fieldOf = (data: Data | undefined, id: string, field: string | typeof DOCUMENT_ID) =>\n    field === DOCUMENT_ID ? id : readPath(data, field as string)\n\n  const compare = (a: unknown, b: unknown): number => {\n    if (a === b) return 0\n    if (a === undefined || a === null) return -1\n    if (b === undefined || b === null) return 1\n    return (a as number) < (b as number) ? -1 : 1\n  }\n\n  const matches = (data: Data, id: string, filter: QueryState['filters'][number]): boolean => {\n    const value = fieldOf(data, id, filter.field)\n    const wanted = filter.value\n    switch (filter.op) {\n      case '==':\n        return JSON.stringify(value) === JSON.stringify(wanted)\n      case '!=':\n        return value !== undefined && JSON.stringify(value) !== JSON.stringify(wanted)\n      case 'in':\n        return (wanted as unknown[]).some((entry) => JSON.stringify(entry) === JSON.stringify(value))\n      case 'not-in':\n        return value !== undefined && !(wanted as unknown[]).some((entry) => JSON.stringify(entry) === JSON.stringify(value))\n      case 'array-contains':\n        return Array.isArray(value) && value.includes(wanted)\n      case 'array-contains-any':\n        return Array.isArray(value) && value.some((entry) => (wanted as unknown[]).includes(entry))\n      case '<':\n        return value !== undefined && compare(value, wanted) < 0\n      case '<=':\n        return value !== undefined && compare(value, wanted) <= 0\n      case '>':\n        return value !== undefined && compare(value, wanted) > 0\n      case '>=':\n        return value !== undefined && compare(value, wanted) >= 0\n      default:\n        throw new Error(`memory firestore: no operator ${filter.op}`)\n    }\n  }\n\n  const run = (state: QueryState): any[] => {\n    const prefix = `${state.path}/`\n    let found = [...docs.entries()]\n      .filter(([path]) => path.startsWith(prefix) && !path.slice(prefix.length).includes('/'))\n      .map(([path, data]) => ({ path, id: path.slice(prefix.length), data }))\n      .filter((entry) => state.filters.every((filter) => matches(entry.data, entry.id, filter)))\n    const order = state.order.length ? state.order : [{ field: DOCUMENT_ID, direction: 'asc' as const }]\n    for (const { field } of order) {\n      if (field !== DOCUMENT_ID) found = found.filter((entry) => readPath(entry.data, field as string) !== undefined)\n    }\n    found.sort((a, b) => {\n      for (const { field, direction } of [...order, { field: DOCUMENT_ID, direction: 'asc' as const }]) {\n        const result = compare(fieldOf(a.data, a.id, field), fieldOf(b.data, b.id, field))\n        if (result) return direction === 'desc' ? -result : result\n      }\n      return 0\n    })\n    if (state.after) {\n      const at = found.findIndex((entry) => entry.id === state.after.id)\n      found = at >= 0 ? found.slice(at + 1) : found\n    }\n    if (state.limit !== undefined) found = found.slice(0, state.limit)\n    return found.map((entry) => snapshot(entry.path))\n  }\n\n  const query = (state: QueryState): any => ({\n    where: (field: string | typeof DOCUMENT_ID, op: string, value: unknown) =>\n      query({ ...state, filters: [...state.filters, { field, op, value }] }),\n    orderBy: (field: string | typeof DOCUMENT_ID, direction: 'asc' | 'desc' = 'asc') =>\n      query({ ...state, order: [...state.order, { field, direction }] }),\n    limit: (count: number) => query({ ...state, limit: count }),\n    startAfter: (after: any) => query({ ...state, after }),\n    get: async () => {\n      const found = run(state)\n      return { docs: found, empty: !found.length, size: found.length }\n    },\n    count: () => ({\n      get: async () => ({ data: () => ({ count: run({ ...state, limit: undefined }).length }) }),\n    }),\n  })\n\n  const collectionRef = (path: string): any => ({\n    id: path.slice(path.lastIndexOf('/') + 1),\n    path,\n    get parent() {\n      const at = path.lastIndexOf('/')\n      return at > 0 ? docRef(path.slice(0, at)) : null\n    },\n    doc: (id?: string) => docRef(`${path}/${id ?? `auto${Math.random().toString(36).slice(2, 12)}`}`),\n    ...query({ path, filters: [], order: [] }),\n  })\n\n  const firestore = {\n    collection: (name: string) => collectionRef(name),\n    getAll: async (...refs: Array<{ path: string }>) => refs.map((ref) => snapshot(ref.path)),\n    batch: () => {\n      const staged: Array<() => Promise<void>> = []\n      const batch = {\n        set: (ref: any, data: Data, options?: { merge?: boolean }) => (staged.push(() => ref.set(data, options)), batch),\n        create: (ref: any, data: Data) => (staged.push(() => ref.create(data)), batch),\n        update: (ref: any, ...args: unknown[]) => (staged.push(() => ref.update(...args)), batch),\n        delete: (ref: any) => (staged.push(() => ref.delete()), batch),\n        commit: async () => {\n          for (const write of staged) await write()\n        },\n      }\n      return batch\n    },\n    /**\n     * Read-then-write with OPTIMISTIC CONCURRENCY, as the server SDK commits\n     * one: every document the body read is versioned, and a commit that finds\n     * one of them written since is thrown away and the body run again. Two\n     * transactions racing on one document therefore end the way they do in\n     * Firestore — the second re-reads the first one's write — which is the\n     * property a one-open-shift or a lockout counter rests on.\n     */\n    runTransaction: async <T>(body: (transaction: any) => Promise<T>): Promise<T> => {\n      for (let attempt = 0; attempt < 10; attempt += 1) {\n        const staged: Array<() => Promise<void>> = []\n        const seen = new Map<string, number>()\n        const transaction = {\n          get: async (target: any) => {\n            const result = await target.get()\n            if (typeof target.path === 'string' && !('docs' in result)) {\n              seen.set(target.path, versions.get(target.path) ?? 0)\n            } else if (result?.docs) {\n              for (const doc of result.docs) seen.set(doc.ref.path, versions.get(doc.ref.path) ?? 0)\n            }\n            return result\n          },\n          set: (ref: any, data: Data, options?: { merge?: boolean }) => (staged.push(() => ref.set(data, options)), transaction),\n          create: (ref: any, data: Data) => (staged.push(() => ref.create(data)), transaction),\n          update: (ref: any, ...args: unknown[]) => (staged.push(() => ref.update(...args)), transaction),\n          delete: (ref: any) => (staged.push(() => ref.delete()), transaction),\n        }\n        const result = await body(transaction)\n        const stale = [...seen].some(([path, version]) => (versions.get(path) ?? 0) !== version)\n        if (stale) continue\n        // Every write starts before any is awaited, so the commit is atomic\n        // against another transaction checking its own reads.\n        await Promise.all(staged.map((write) => write()))\n        return result\n      }\n      throw new Error('memory firestore: transaction contended too many times')\n    },\n  }\n\n  return {\n    docs,\n    now: clock,\n    firestore: firestore as unknown as FirebaseFirestore.Firestore,\n    seed: (path, data) => docs.set(path, copy(data)),\n    read: (path) => copy(docs.get(path)),\n  }\n}\n"],"names":["DOCUMENT_ID","__documentId","memoryFirestoreModule","__esModule","FieldValue","delete","__sentinel","serverTimestamp","arrayUnion","values","arrayRemove","increment","by","FieldPath","documentId","Timestamp","fromDate","date","getTime","isSentinel","value","Boolean","copy","undefined","JSON","parse","stringify","readPath","data","path","split","reduce","node","key","memoryFirestore","clock","docs","Map","versions","bump","set","get","resolve","current","Array","isArray","Set","filter","entry","includes","Number","writePath","target","keys","slice","leaf","length","settle","base","next","Object","entries","snapshot","id","lastIndexOf","ref","docRef","exists","field","firestore","parent","collectionRef","collection","name","options","merge","create","has","assign","Error","code","update","args","patch","fromEntries","from","_unused","at","String","fieldOf","compare","a","b","matches","wanted","op","some","run","state","prefix","found","startsWith","map","filters","every","order","direction","sort","result","after","findIndex","limit","query","where","orderBy","count","startAfter","empty","size","doc","Math","random","toString","getAll","refs","batch","staged","push","commit","write","runTransaction","body","attempt","seen","transaction","stale","version","Promise","all","now","seed","read"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/testing/pos-ops-memory-firestore.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/*==========================================\n * AN IN-MEMORY ADMIN FIRESTORE, for the register operations' specs\n * (AGL-3609) — the CRM's transfer double (AGL-3527), kept beside the\n * commerce specs because one plugin's testing helpers are not another's\n * to import.\n *\n * Documents by path; the operators the CRM's transfer hooks and the job\n * engine issue — `collectionGroup` (every collection of that name, at any\n * depth), `where` (equality, ranges, `in`, the array operators),\n * `orderBy` (a field or the document id), `limit`, `startAfter`, `count`,\n * `getAll`, batches and read-then-write transactions — and the write\n * sentinels (`delete`, `serverTimestamp`, `arrayUnion`, `arrayRemove`,\n * `increment`) applied along dotted paths, as Firestore applies them.\n *\n * A spec mocks `firebase-admin/firestore` with {@link memoryFirestoreModule}\n * so the code under test builds its sentinels from the same table.\n *=========================================*/\n\ntype Data = Record<string, unknown>\n\ninterface Sentinel {\n  __sentinel: 'delete' | 'serverTimestamp' | 'arrayUnion' | 'arrayRemove' | 'increment'\n  values?: unknown[]\n  by?: number\n}\n\nconst DOCUMENT_ID = { __documentId: true }\n\n/** What a spec hands `jest.mock('firebase-admin/firestore', …)`. */\nexport const memoryFirestoreModule = {\n  __esModule: true,\n  FieldValue: {\n    delete: (): Sentinel => ({ __sentinel: 'delete' }),\n    serverTimestamp: (): Sentinel => ({ __sentinel: 'serverTimestamp' }),\n    arrayUnion: (...values: unknown[]): Sentinel => ({ __sentinel: 'arrayUnion', values }),\n    arrayRemove: (...values: unknown[]): Sentinel => ({ __sentinel: 'arrayRemove', values }),\n    increment: (by: number): Sentinel => ({ __sentinel: 'increment', by }),\n  },\n  FieldPath: { documentId: () => DOCUMENT_ID },\n  Timestamp: { fromDate: (date: Date) => date.getTime() },\n}\n\nconst isSentinel = (value: unknown): value is Sentinel =>\n  Boolean(value && typeof value === 'object' && '__sentinel' in (value as object))\n\nconst copy = <T>(value: T): T => (value === undefined ? value : (JSON.parse(JSON.stringify(value)) as T))\n\nfunction readPath(data: Data | undefined, path: string): unknown {\n  return path.split('.').reduce<unknown>((node, key) => (node as Data | undefined)?.[key], data)\n}\n\nexport interface MemoryFirestore {\n  /** Every document, by full path. */\n  docs: Map<string, Data>\n  /** The clock `serverTimestamp` writes. */\n  now: () => number\n  firestore: FirebaseFirestore.Firestore\n  /** Seeds one document at its full path. */\n  seed: (path: string, data: Data) => void\n  /** A document's data, or `undefined`. */\n  read: (path: string) => Data | undefined\n}\n\n/** A fresh in-memory Firestore. */\nexport function memoryFirestore(clock: () => number = () => 1_800_000_000_000): MemoryFirestore {\n  const docs = new Map<string, Data>()\n  /** A write counter per path, for the transaction's concurrency check. */\n  const versions = new Map<string, number>()\n  const bump = (path: string) => versions.set(path, (versions.get(path) ?? 0) + 1)\n\n  const resolve = (value: unknown, current: unknown): unknown => {\n    if (!isSentinel(value)) return Array.isArray(value) || (value && typeof value === 'object') ? copy(value) : value\n    switch (value.__sentinel) {\n      case 'serverTimestamp':\n        return clock()\n      case 'arrayUnion':\n        return [...new Set([...(Array.isArray(current) ? current : []), ...(value.values ?? [])])]\n      case 'arrayRemove':\n        return (Array.isArray(current) ? current : []).filter((entry) => !(value.values ?? []).includes(entry))\n      case 'increment':\n        return Number(current ?? 0) + Number(value.by ?? 0)\n      default:\n        return undefined\n    }\n  }\n\n  /** Writes `value` at a dotted path, a `delete` sentinel removing the leaf. */\n  const writePath = (target: Data, path: string, value: unknown): void => {\n    const keys = path.split('.')\n    let node = target\n    for (const key of keys.slice(0, -1)) {\n      if (!node[key] || typeof node[key] !== 'object') node[key] = {}\n      node = node[key] as Data\n    }\n    const leaf = keys[keys.length - 1] as string\n    if (isSentinel(value) && value.__sentinel === 'delete') delete node[leaf]\n    else node[leaf] = resolve(value, node[leaf])\n  }\n\n  /** Every top-level key of `data` with sentinels resolved (a `set`). */\n  const settle = (data: Data, base: Data = {}): Data => {\n    const next = copy(base)\n    for (const [key, value] of Object.entries(data)) {\n      if (value === undefined) continue\n      if (isSentinel(value)) writePath(next, key, value)\n      else if (value && typeof value === 'object' && !Array.isArray(value) && base[key] && typeof base[key] === 'object') {\n        next[key] = settle(value as Data, base[key] as Data)\n      } else next[key] = resolve(value, next[key])\n    }\n    return next\n  }\n\n  const snapshot = (path: string): any => {\n    const data = docs.get(path)\n    return {\n      id: path.slice(path.lastIndexOf('/') + 1),\n      ref: docRef(path),\n      exists: data !== undefined,\n      data: () => copy(data),\n      get: (field: string) => copy(readPath(data, field)),\n    }\n  }\n\n  const docRef = (path: string): any => ({\n    id: path.slice(path.lastIndexOf('/') + 1),\n    path,\n    get firestore() {\n      return firestore\n    },\n    get parent() {\n      return collectionRef(path.slice(0, path.lastIndexOf('/')))\n    },\n    collection: (name: string) => collectionRef(`${path}/${name}`),\n    get: async () => snapshot(path),\n    set: async (data: Data, options?: { merge?: boolean }) => {\n      docs.set(path, settle(data, options?.merge ? (docs.get(path) ?? {}) : {}))\n      bump(path)\n    },\n    create: async (data: Data) => {\n      if (docs.has(path)) throw Object.assign(new Error(`ALREADY_EXISTS: ${path}`), { code: 6 })\n      docs.set(path, settle(data))\n      bump(path)\n    },\n    update: async (...args: unknown[]) => {\n      const current = docs.get(path)\n      if (!current) throw Object.assign(new Error(`NOT_FOUND: ${path}`), { code: 5 })\n      const patch: Data =\n        typeof args[0] === 'string'\n          ? Object.fromEntries(\n              Array.from({ length: args.length / 2 }, (_unused, at) => [String(args[at * 2]), args[at * 2 + 1]]),\n            )\n          : (args[0] as Data)\n      const next = copy(current)\n      for (const [key, value] of Object.entries(patch)) writePath(next, key, value)\n      docs.set(path, next)\n      bump(path)\n    },\n    delete: async () => {\n      docs.delete(path)\n      bump(path)\n    },\n  })\n\n  interface QueryState {\n    path: string\n    /** A collection-group query: `path` is the collection's NAME, matched at any depth. */\n    group?: boolean\n    filters: Array<{ field: string | typeof DOCUMENT_ID; op: string; value: unknown }>\n    order: Array<{ field: string | typeof DOCUMENT_ID; direction: 'asc' | 'desc' }>\n    limit?: number\n    after?: any\n  }\n\n  const fieldOf = (data: Data | undefined, id: string, field: string | typeof DOCUMENT_ID) =>\n    field === DOCUMENT_ID ? id : readPath(data, field as string)\n\n  const compare = (a: unknown, b: unknown): number => {\n    if (a === b) return 0\n    if (a === undefined || a === null) return -1\n    if (b === undefined || b === null) return 1\n    return (a as number) < (b as number) ? -1 : 1\n  }\n\n  const matches = (data: Data, id: string, filter: QueryState['filters'][number]): boolean => {\n    const value = fieldOf(data, id, filter.field)\n    const wanted = filter.value\n    switch (filter.op) {\n      case '==':\n        return JSON.stringify(value) === JSON.stringify(wanted)\n      case '!=':\n        return value !== undefined && JSON.stringify(value) !== JSON.stringify(wanted)\n      case 'in':\n        return (wanted as unknown[]).some((entry) => JSON.stringify(entry) === JSON.stringify(value))\n      case 'not-in':\n        return value !== undefined && !(wanted as unknown[]).some((entry) => JSON.stringify(entry) === JSON.stringify(value))\n      case 'array-contains':\n        return Array.isArray(value) && value.includes(wanted)\n      case 'array-contains-any':\n        return Array.isArray(value) && value.some((entry) => (wanted as unknown[]).includes(entry))\n      case '<':\n        return value !== undefined && compare(value, wanted) < 0\n      case '<=':\n        return value !== undefined && compare(value, wanted) <= 0\n      case '>':\n        return value !== undefined && compare(value, wanted) > 0\n      case '>=':\n        return value !== undefined && compare(value, wanted) >= 0\n      default:\n        throw new Error(`memory firestore: no operator ${filter.op}`)\n    }\n  }\n\n  const inQuery = (state: QueryState, path: string): boolean => {\n    if (state.group) {\n      const segments = path.split('/')\n      return segments.length >= 2 && segments.length % 2 === 0 && segments[segments.length - 2] === state.path\n    }\n    const prefix = `${state.path}/`\n    return path.startsWith(prefix) && !path.slice(prefix.length).includes('/')\n  }\n\n  const run = (state: QueryState): any[] => {\n    let found = [...docs.entries()]\n      .filter(([path]) => inQuery(state, path))\n      .map(([path, data]) => ({ path, id: path.slice(path.lastIndexOf('/') + 1), data }))\n      .filter((entry) => state.filters.every((filter) => matches(entry.data, entry.id, filter)))\n    const order = state.order.length ? state.order : [{ field: DOCUMENT_ID, direction: 'asc' as const }]\n    for (const { field } of order) {\n      if (field !== DOCUMENT_ID) found = found.filter((entry) => readPath(entry.data, field as string) !== undefined)\n    }\n    found.sort((a, b) => {\n      for (const { field, direction } of [...order, { field: DOCUMENT_ID, direction: 'asc' as const }]) {\n        const result = compare(fieldOf(a.data, a.id, field), fieldOf(b.data, b.id, field))\n        if (result) return direction === 'desc' ? -result : result\n      }\n      return 0\n    })\n    if (state.after) {\n      const at = found.findIndex((entry) => entry.id === state.after.id)\n      found = at >= 0 ? found.slice(at + 1) : found\n    }\n    if (state.limit !== undefined) found = found.slice(0, state.limit)\n    return found.map((entry) => snapshot(entry.path))\n  }\n\n  const query = (state: QueryState): any => ({\n    where: (field: string | typeof DOCUMENT_ID, op: string, value: unknown) =>\n      query({ ...state, filters: [...state.filters, { field, op, value }] }),\n    orderBy: (field: string | typeof DOCUMENT_ID, direction: 'asc' | 'desc' = 'asc') =>\n      query({ ...state, order: [...state.order, { field, direction }] }),\n    limit: (count: number) => query({ ...state, limit: count }),\n    startAfter: (after: any) => query({ ...state, after }),\n    get: async () => {\n      const found = run(state)\n      return { docs: found, empty: !found.length, size: found.length }\n    },\n    count: () => ({\n      get: async () => ({ data: () => ({ count: run({ ...state, limit: undefined }).length }) }),\n    }),\n  })\n\n  const collectionRef = (path: string): any => ({\n    id: path.slice(path.lastIndexOf('/') + 1),\n    path,\n    get parent() {\n      const at = path.lastIndexOf('/')\n      return at > 0 ? docRef(path.slice(0, at)) : null\n    },\n    doc: (id?: string) => docRef(`${path}/${id ?? `auto${Math.random().toString(36).slice(2, 12)}`}`),\n    ...query({ path, filters: [], order: [] }),\n  })\n\n  const firestore = {\n    collection: (name: string) => collectionRef(name),\n    collectionGroup: (name: string) => query({ path: name, group: true, filters: [], order: [] }),\n    getAll: async (...refs: Array<{ path: string }>) => refs.map((ref) => snapshot(ref.path)),\n    batch: () => {\n      const staged: Array<() => Promise<void>> = []\n      const batch = {\n        set: (ref: any, data: Data, options?: { merge?: boolean }) => (staged.push(() => ref.set(data, options)), batch),\n        create: (ref: any, data: Data) => (staged.push(() => ref.create(data)), batch),\n        update: (ref: any, ...args: unknown[]) => (staged.push(() => ref.update(...args)), batch),\n        delete: (ref: any) => (staged.push(() => ref.delete()), batch),\n        commit: async () => {\n          for (const write of staged) await write()\n        },\n      }\n      return batch\n    },\n    /**\n     * Read-then-write with OPTIMISTIC CONCURRENCY, as the server SDK commits\n     * one: every document the body read is versioned, and a commit that finds\n     * one of them written since is thrown away and the body run again. Two\n     * transactions racing on one document therefore end the way they do in\n     * Firestore — the second re-reads the first one's write — which is the\n     * property a one-open-shift or a lockout counter rests on.\n     */\n    runTransaction: async <T>(body: (transaction: any) => Promise<T>): Promise<T> => {\n      for (let attempt = 0; attempt < 10; attempt += 1) {\n        const staged: Array<() => Promise<void>> = []\n        const seen = new Map<string, number>()\n        const transaction = {\n          get: async (target: any) => {\n            const result = await target.get()\n            if (typeof target.path === 'string' && !('docs' in result)) {\n              seen.set(target.path, versions.get(target.path) ?? 0)\n            } else if (result?.docs) {\n              for (const doc of result.docs) seen.set(doc.ref.path, versions.get(doc.ref.path) ?? 0)\n            }\n            return result\n          },\n          set: (ref: any, data: Data, options?: { merge?: boolean }) => (staged.push(() => ref.set(data, options)), transaction),\n          create: (ref: any, data: Data) => (staged.push(() => ref.create(data)), transaction),\n          update: (ref: any, ...args: unknown[]) => (staged.push(() => ref.update(...args)), transaction),\n          delete: (ref: any) => (staged.push(() => ref.delete()), transaction),\n        }\n        const result = await body(transaction)\n        const stale = [...seen].some(([path, version]) => (versions.get(path) ?? 0) !== version)\n        if (stale) continue\n        // Every write starts before any is awaited, so the commit is atomic\n        // against another transaction checking its own reads.\n        await Promise.all(staged.map((write) => write()))\n        return result\n      }\n      throw new Error('memory firestore: transaction contended too many times')\n    },\n  }\n\n  return {\n    docs,\n    now: clock,\n    firestore: firestore as unknown as FirebaseFirestore.Firestore,\n    seed: (path, data) => docs.set(path, copy(data)),\n    read: (path) => copy(docs.get(path)),\n  }\n}\n"],"names":["DOCUMENT_ID","__documentId","memoryFirestoreModule","__esModule","FieldValue","delete","__sentinel","serverTimestamp","arrayUnion","values","arrayRemove","increment","by","FieldPath","documentId","Timestamp","fromDate","date","getTime","isSentinel","value","Boolean","copy","undefined","JSON","parse","stringify","readPath","data","path","split","reduce","node","key","memoryFirestore","clock","docs","Map","versions","bump","set","get","resolve","current","Array","isArray","Set","filter","entry","includes","Number","writePath","target","keys","slice","leaf","length","settle","base","next","Object","entries","snapshot","id","lastIndexOf","ref","docRef","exists","field","firestore","parent","collectionRef","collection","name","options","merge","create","has","assign","Error","code","update","args","patch","fromEntries","from","_unused","at","String","fieldOf","compare","a","b","matches","wanted","op","some","inQuery","state","group","segments","prefix","startsWith","run","found","map","filters","every","order","direction","sort","result","after","findIndex","limit","query","where","orderBy","count","startAfter","empty","size","doc","Math","random","toString","collectionGroup","getAll","refs","batch","staged","push","commit","write","runTransaction","body","attempt","seen","transaction","stale","version","Promise","all","now","seed","read"],"mappings":"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"}

package/src/lib/testing/site-register-permissions.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @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.
+ */
+/**
+ * The register's `managePos` as `resolveOrgPermissions(uid, { hostId })`
+ * resolves it for one site (AGL-4047), for the specs that fake that resolver
+ * now that the POS routes ask it alone and no longer read the site's
+ * `memberRoles` themselves.
+ *
+ * Someone with no access to the site holds nothing. Otherwise the site
+ * role's default decides — on for admin and editor, off for author and
+ * viewer, the tier defaults `managePos` is declared with — unless a role or
+ * an override `granted` or refused it.
+ */
+export declare const SITE_ROLE_REGISTER_DEFAULTS: Readonly<Record<string, boolean>>;
+export declare function siteRegisterVerdict(memberRoles: Readonly<Record<string, unknown>> | null | undefined, uid: string, granted?: boolean): boolean;

package/src/lib/testing/site-register-permissions.js

@@ -0,0 +1,38 @@
+/**
+ * @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.
+ */ /**
+ * The register's `managePos` as `resolveOrgPermissions(uid, { hostId })`
+ * resolves it for one site (AGL-4047), for the specs that fake that resolver
+ * now that the POS routes ask it alone and no longer read the site's
+ * `memberRoles` themselves.
+ *
+ * Someone with no access to the site holds nothing. Otherwise the site
+ * role's default decides — on for admin and editor, off for author and
+ * viewer, the tier defaults `managePos` is declared with — unless a role or
+ * an override `granted` or refused it.
+ */ export const SITE_ROLE_REGISTER_DEFAULTS = {
+    admin: true,
+    editor: true,
+    author: false,
+    viewer: false
+};
+export function siteRegisterVerdict(memberRoles, uid, granted) {
+    const role = memberRoles == null ? void 0 : memberRoles[uid];
+    if (typeof role !== 'string' || !role) return false;
+    return typeof granted === 'boolean' ? granted : SITE_ROLE_REGISTER_DEFAULTS[role] === true;
+}
+
+//# sourceMappingURL=site-register-permissions.js.map

package/src/lib/testing/site-register-permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/testing/site-register-permissions.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * The register's `managePos` as `resolveOrgPermissions(uid, { hostId })`\n * resolves it for one site (AGL-4047), for the specs that fake that resolver\n * now that the POS routes ask it alone and no longer read the site's\n * `memberRoles` themselves.\n *\n * Someone with no access to the site holds nothing. Otherwise the site\n * role's default decides — on for admin and editor, off for author and\n * viewer, the tier defaults `managePos` is declared with — unless a role or\n * an override `granted` or refused it.\n */\nexport const SITE_ROLE_REGISTER_DEFAULTS: Readonly<Record<string, boolean>> = {\n  admin: true,\n  editor: true,\n  author: false,\n  viewer: false,\n}\n\nexport function siteRegisterVerdict(\n  memberRoles: Readonly<Record<string, unknown>> | null | undefined,\n  uid: string,\n  granted?: boolean,\n): boolean {\n  const role = memberRoles?.[uid]\n  if (typeof role !== 'string' || !role) return false\n  return typeof granted === 'boolean' ? granted : SITE_ROLE_REGISTER_DEFAULTS[role] === true\n}\n"],"names":["SITE_ROLE_REGISTER_DEFAULTS","admin","editor","author","viewer","siteRegisterVerdict","memberRoles","uid","granted","role"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;CAUC,GACD,OAAO,MAAMA,8BAAiE;IAC5EC,OAAO;IACPC,QAAQ;IACRC,QAAQ;IACRC,QAAQ;AACV,EAAC;AAED,OAAO,SAASC,oBACdC,WAAiE,EACjEC,GAAW,EACXC,OAAiB;IAEjB,MAAMC,OAAOH,+BAAAA,WAAa,CAACC,IAAI;IAC/B,IAAI,OAAOE,SAAS,YAAY,CAACA,MAAM,OAAO;IAC9C,OAAO,OAAOD,YAAY,YAAYA,UAAUR,2BAA2B,CAACS,KAAK,KAAK;AACxF"}

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

@@ -15,11 +15,11 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * 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 { firebaseAdmin, getOrgForHost, memberHasPermissionOnHost, 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 { commerceSitePermissionRefusal } from "../model/plugin-permissions.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";
@@ -50,9 +50,12 @@ import { TRACKING_DEFAULT_POLICY, TRACKING_MATCH_KEYS, matchTrackingRows, planTr
     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.');
+    // "Manage orders" (`commerce.orders`, AGL-4047) on this site, resolved fresh
+    // from the membership: its preset is the site's Admin and Editor this
+    // asked for, then the member's custom role, own permissions and site toggle.
+    const allowed = !!uid && !!(membership == null ? void 0 : membership.member) && await memberHasPermissionOnHost(ctx.orgId, hostId, membership.member, 'commerce.orders');
+    if (!allowed) {
+        throw new TransferEngineError('forbidden', 403, commerceSitePermissionRefusal('commerce.orders'));
     }
     const owner = await getOrgForHost(hostId).catch(()=>null);
     if (!Aglyn.checkEntitlement(owner == null ? void 0 : owner.org, 'commerce')) {

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

@@ -1 +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":"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"}
+{"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 * 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, memberHasPermissionOnHost, 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 { commerceSitePermissionRefusal } from '../model/plugin-permissions'\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  // \"Manage orders\" (`commerce.orders`, AGL-4047) on this site, resolved fresh\n  // from the membership: its preset is the site's Admin and Editor this\n  // asked for, then the member's custom role, own permissions and site toggle.\n  const allowed =\n    !!uid && !!membership?.member &&\n    (await memberHasPermissionOnHost(ctx.orgId, hostId, membership.member, 'commerce.orders'))\n  if (!allowed) {\n    throw new TransferEngineError('forbidden', 403, commerceSitePermissionRefusal('commerce.orders'))\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","Aglyn","firebaseAdmin","getOrgForHost","memberHasPermissionOnHost","resolveOrgMembership","TransferEngineError","normalizeTrackingNumber","parseShippingOrderRef","commerceSitePermissionRefusal","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","allowed","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":"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"}

package/src/lib/utils/add-to-cart.d.ts

@@ -22,6 +22,8 @@ export interface AddToCartRequest {
     productId: string;
     variantId: string;
     quantity: number;
+    /** The day the shopper chose to use a check-in item (AGL-4043), `YYYY-MM-DD`. */
+    useDayKey?: string;
     /** The GA4 line: product id (never the variant's), name, price, quantity. */
     item: AnalyticsItem;
 }

package/src/lib/utils/add-to-cart.js

@@ -1,3 +1,4 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
 /**
  * @license
  * Copyright 2026 Aglyn LLC
@@ -23,19 +24,21 @@ import { CART_UPDATED_EVENT } from "../constants/cart-events.js";
  * (AGL-1591) and refresh every cart badge on the page. Resolves whether the
  * server took the line; the server prices it, never the caller.
  */ export async function addToCart(request) {
-    const { hostId, siteFetch, productId, variantId, quantity, item } = request;
+    const { hostId, siteFetch, productId, variantId, quantity, useDayKey, item } = request;
     const response = await siteFetch('/api/commerce/cart', {
         method: 'POST',
         headers: {
             'Content-Type': 'application/json'
         },
-        body: JSON.stringify({
+        body: JSON.stringify(_extends({
             hostId,
             action: 'add',
             productId,
             variantId,
             quantity
-        })
+        }, useDayKey ? {
+            useDayKey
+        } : {}))
     }).catch(()=>null);
     if (!(response == null ? void 0 : response.ok)) return false;
     recordSiteJourneyStep('cart', productId);

package/src/lib/utils/add-to-cart.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/utils/add-to-cart.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  buildAddToCartParams,\n  trackEvent,\n  type AnalyticsItem,\n} from '@aglyn/aglyn/app-utils/analytics-events'\nimport { recordSiteJourneyStep } from '@aglyn/aglyn/app-utils/site-journey'\nimport { CART_UPDATED_EVENT } from '../constants/cart-events'\n\nexport interface AddToCartRequest {\n  hostId: string\n  /** The site's fetch (`Aglyn.useSiteFetch()`), which carries the cart cookie. */\n  siteFetch: typeof fetch\n  productId: string\n  variantId: string\n  quantity: number\n  /** The GA4 line: product id (never the variant's), name, price, quantity. */\n  item: AnalyticsItem\n}\n\n/**\n * Put one line in the shopper's cart. The product page's Add to cart and the\n * product grid's quick add both go through this one path, so both record the\n * same funnel step (AGL-3605), report the same priced `add_to_cart`\n * (AGL-1591) and refresh every cart badge on the page. Resolves whether the\n * server took the line; the server prices it, never the caller.\n */\nexport async function addToCart(request: AddToCartRequest): Promise<boolean> {\n  const { hostId, siteFetch, productId, variantId, quantity, item } = request\n  const response = await siteFetch('/api/commerce/cart', {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ hostId, action: 'add', productId, variantId, quantity }),\n  }).catch(() => null)\n  if (!response?.ok) return false\n  recordSiteJourneyStep('cart', productId)\n  // `value` describes what was JUST ADDED, not the cart's new total — see\n  // `buildAddToCartParams`.\n  trackEvent('add_to_cart', buildAddToCartParams({ items: [item] }))\n  window.dispatchEvent(new Event(CART_UPDATED_EVENT))\n  return true\n}\n"],"names":["buildAddToCartParams","trackEvent","recordSiteJourneyStep","CART_UPDATED_EVENT","addToCart","request","hostId","siteFetch","productId","variantId","quantity","item","response","method","headers","body","JSON","stringify","action","catch","ok","items","window","dispatchEvent","Event"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,oBAAoB,EACpBC,UAAU,QAEL,0CAAyC;AAChD,SAASC,qBAAqB,QAAQ,sCAAqC;AAC3E,SAASC,kBAAkB,QAAQ,8BAA0B;AAa7D;;;;;;CAMC,GACD,OAAO,eAAeC,UAAUC,OAAyB;IACvD,MAAM,EAAEC,MAAM,EAAEC,SAAS,EAAEC,SAAS,EAAEC,SAAS,EAAEC,QAAQ,EAAEC,IAAI,EAAE,GAAGN;IACpE,MAAMO,WAAW,MAAML,UAAU,sBAAsB;QACrDM,QAAQ;QACRC,SAAS;YAAE,gBAAgB;QAAmB;QAC9CC,MAAMC,KAAKC,SAAS,CAAC;YAAEX;YAAQY,QAAQ;YAAOV;YAAWC;YAAWC;QAAS;IAC/E,GAAGS,KAAK,CAAC,IAAM;IACf,IAAI,EAACP,4BAAAA,SAAUQ,EAAE,GAAE,OAAO;IAC1BlB,sBAAsB,QAAQM;IAC9B,wEAAwE;IACxE,0BAA0B;IAC1BP,WAAW,eAAeD,qBAAqB;QAAEqB,OAAO;YAACV;SAAK;IAAC;IAC/DW,OAAOC,aAAa,CAAC,IAAIC,MAAMrB;IAC/B,OAAO;AACT"}
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/utils/add-to-cart.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  buildAddToCartParams,\n  trackEvent,\n  type AnalyticsItem,\n} from '@aglyn/aglyn/app-utils/analytics-events'\nimport { recordSiteJourneyStep } from '@aglyn/aglyn/app-utils/site-journey'\nimport { CART_UPDATED_EVENT } from '../constants/cart-events'\n\nexport interface AddToCartRequest {\n  hostId: string\n  /** The site's fetch (`Aglyn.useSiteFetch()`), which carries the cart cookie. */\n  siteFetch: typeof fetch\n  productId: string\n  variantId: string\n  quantity: number\n  /** The day the shopper chose to use a check-in item (AGL-4043), `YYYY-MM-DD`. */\n  useDayKey?: string\n  /** The GA4 line: product id (never the variant's), name, price, quantity. */\n  item: AnalyticsItem\n}\n\n/**\n * Put one line in the shopper's cart. The product page's Add to cart and the\n * product grid's quick add both go through this one path, so both record the\n * same funnel step (AGL-3605), report the same priced `add_to_cart`\n * (AGL-1591) and refresh every cart badge on the page. Resolves whether the\n * server took the line; the server prices it, never the caller.\n */\nexport async function addToCart(request: AddToCartRequest): Promise<boolean> {\n  const { hostId, siteFetch, productId, variantId, quantity, useDayKey, item } = request\n  const response = await siteFetch('/api/commerce/cart', {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ hostId, action: 'add', productId, variantId, quantity, ...(useDayKey ? { useDayKey } : {}) }),\n  }).catch(() => null)\n  if (!response?.ok) return false\n  recordSiteJourneyStep('cart', productId)\n  // `value` describes what was JUST ADDED, not the cart's new total — see\n  // `buildAddToCartParams`.\n  trackEvent('add_to_cart', buildAddToCartParams({ items: [item] }))\n  window.dispatchEvent(new Event(CART_UPDATED_EVENT))\n  return true\n}\n"],"names":["buildAddToCartParams","trackEvent","recordSiteJourneyStep","CART_UPDATED_EVENT","addToCart","request","hostId","siteFetch","productId","variantId","quantity","useDayKey","item","response","method","headers","body","JSON","stringify","action","catch","ok","items","window","dispatchEvent","Event"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,oBAAoB,EACpBC,UAAU,QAEL,0CAAyC;AAChD,SAASC,qBAAqB,QAAQ,sCAAqC;AAC3E,SAASC,kBAAkB,QAAQ,8BAA0B;AAe7D;;;;;;CAMC,GACD,OAAO,eAAeC,UAAUC,OAAyB;IACvD,MAAM,EAAEC,MAAM,EAAEC,SAAS,EAAEC,SAAS,EAAEC,SAAS,EAAEC,QAAQ,EAAEC,SAAS,EAAEC,IAAI,EAAE,GAAGP;IAC/E,MAAMQ,WAAW,MAAMN,UAAU,sBAAsB;QACrDO,QAAQ;QACRC,SAAS;YAAE,gBAAgB;QAAmB;QAC9CC,MAAMC,KAAKC,SAAS,CAAC;YAAEZ;YAAQa,QAAQ;YAAOX;YAAWC;YAAWC;WAAcC,YAAY;YAAEA;QAAU,IAAI,CAAC;IACjH,GAAGS,KAAK,CAAC,IAAM;IACf,IAAI,EAACP,4BAAAA,SAAUQ,EAAE,GAAE,OAAO;IAC1BnB,sBAAsB,QAAQM;IAC9B,wEAAwE;IACxE,0BAA0B;IAC1BP,WAAW,eAAeD,qBAAqB;QAAEsB,OAAO;YAACV;SAAK;IAAC;IAC/DW,OAAOC,aAAa,CAAC,IAAIC,MAAMtB;IAC/B,OAAO;AACT"}