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

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

@@ -0,0 +1,376 @@
+/**
+ * @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.
+ */ /*==========================================
+ * AN IN-MEMORY ADMIN FIRESTORE, for the register operations' specs
+ * (AGL-3609) — the CRM's transfer double (AGL-3527), kept beside the
+ * commerce specs because one plugin's testing helpers are not another's
+ * to import.
+ *
+ * Documents by path; the operators the CRM's transfer hooks and the job
+ * engine issue — `where` (equality, ranges, `in`, the array operators),
+ * `orderBy` (a field or the document id), `limit`, `startAfter`, `count`,
+ * `getAll`, batches and read-then-write transactions — and the write
+ * sentinels (`delete`, `serverTimestamp`, `arrayUnion`, `arrayRemove`,
+ * `increment`) applied along dotted paths, as Firestore applies them.
+ *
+ * A spec mocks `firebase-admin/firestore` with {@link memoryFirestoreModule}
+ * so the code under test builds its sentinels from the same table.
+ *=========================================*/ import { _ as _extends } from "@swc/helpers/_/_extends";
+const DOCUMENT_ID = {
+    __documentId: true
+};
+/** What a spec hands `jest.mock('firebase-admin/firestore', …)`. */ export const memoryFirestoreModule = {
+    __esModule: true,
+    FieldValue: {
+        delete: ()=>({
+                __sentinel: 'delete'
+            }),
+        serverTimestamp: ()=>({
+                __sentinel: 'serverTimestamp'
+            }),
+        arrayUnion: (...values)=>({
+                __sentinel: 'arrayUnion',
+                values
+            }),
+        arrayRemove: (...values)=>({
+                __sentinel: 'arrayRemove',
+                values
+            }),
+        increment: (by)=>({
+                __sentinel: 'increment',
+                by
+            })
+    },
+    FieldPath: {
+        documentId: ()=>DOCUMENT_ID
+    },
+    Timestamp: {
+        fromDate: (date)=>date.getTime()
+    }
+};
+const isSentinel = (value)=>Boolean(value && typeof value === 'object' && '__sentinel' in value);
+const copy = (value)=>value === undefined ? value : JSON.parse(JSON.stringify(value));
+function readPath(data, path) {
+    return path.split('.').reduce((node, key)=>node == null ? void 0 : node[key], data);
+}
+/** A fresh in-memory Firestore. */ export function memoryFirestore(clock = ()=>1800000000000) {
+    const docs = new Map();
+    /** A write counter per path, for the transaction's concurrency check. */ const versions = new Map();
+    const bump = (path)=>{
+        var _versions_get;
+        return versions.set(path, ((_versions_get = versions.get(path)) != null ? _versions_get : 0) + 1);
+    };
+    const resolve = (value, current)=>{
+        if (!isSentinel(value)) return Array.isArray(value) || value && typeof value === 'object' ? copy(value) : value;
+        switch(value.__sentinel){
+            case 'serverTimestamp':
+                return clock();
+            case 'arrayUnion':
+                var _value_values;
+                return [
+                    ...new Set([
+                        ...Array.isArray(current) ? current : [],
+                        ...(_value_values = value.values) != null ? _value_values : []
+                    ])
+                ];
+            case 'arrayRemove':
+                return (Array.isArray(current) ? current : []).filter((entry)=>{
+                    var _value_values;
+                    return !((_value_values = value.values) != null ? _value_values : []).includes(entry);
+                });
+            case 'increment':
+                var _value_by;
+                return Number(current != null ? current : 0) + Number((_value_by = value.by) != null ? _value_by : 0);
+            default:
+                return undefined;
+        }
+    };
+    /** Writes `value` at a dotted path, a `delete` sentinel removing the leaf. */ const writePath = (target, path, value)=>{
+        const keys = path.split('.');
+        let node = target;
+        for (const key of keys.slice(0, -1)){
+            if (!node[key] || typeof node[key] !== 'object') node[key] = {};
+            node = node[key];
+        }
+        const leaf = keys[keys.length - 1];
+        if (isSentinel(value) && value.__sentinel === 'delete') delete node[leaf];
+        else node[leaf] = resolve(value, node[leaf]);
+    };
+    /** Every top-level key of `data` with sentinels resolved (a `set`). */ const settle = (data, base = {})=>{
+        const next = copy(base);
+        for (const [key, value] of Object.entries(data)){
+            if (value === undefined) continue;
+            if (isSentinel(value)) writePath(next, key, value);
+            else if (value && typeof value === 'object' && !Array.isArray(value) && base[key] && typeof base[key] === 'object') {
+                next[key] = settle(value, base[key]);
+            } else next[key] = resolve(value, next[key]);
+        }
+        return next;
+    };
+    const snapshot = (path)=>{
+        const data = docs.get(path);
+        return {
+            id: path.slice(path.lastIndexOf('/') + 1),
+            ref: docRef(path),
+            exists: data !== undefined,
+            data: ()=>copy(data),
+            get: (field)=>copy(readPath(data, field))
+        };
+    };
+    const docRef = (path)=>({
+            id: path.slice(path.lastIndexOf('/') + 1),
+            path,
+            get firestore () {
+                return firestore;
+            },
+            get parent () {
+                return collectionRef(path.slice(0, path.lastIndexOf('/')));
+            },
+            collection: (name)=>collectionRef(`${path}/${name}`),
+            get: async ()=>snapshot(path),
+            set: async (data, options)=>{
+                var _docs_get;
+                docs.set(path, settle(data, (options == null ? void 0 : options.merge) ? (_docs_get = docs.get(path)) != null ? _docs_get : {} : {}));
+                bump(path);
+            },
+            create: async (data)=>{
+                if (docs.has(path)) throw Object.assign(new Error(`ALREADY_EXISTS: ${path}`), {
+                    code: 6
+                });
+                docs.set(path, settle(data));
+                bump(path);
+            },
+            update: async (...args)=>{
+                const current = docs.get(path);
+                if (!current) throw Object.assign(new Error(`NOT_FOUND: ${path}`), {
+                    code: 5
+                });
+                const patch = typeof args[0] === 'string' ? Object.fromEntries(Array.from({
+                    length: args.length / 2
+                }, (_unused, at)=>[
+                        String(args[at * 2]),
+                        args[at * 2 + 1]
+                    ])) : args[0];
+                const next = copy(current);
+                for (const [key, value] of Object.entries(patch))writePath(next, key, value);
+                docs.set(path, next);
+                bump(path);
+            },
+            delete: async ()=>{
+                docs.delete(path);
+                bump(path);
+            }
+        });
+    const fieldOf = (data, id, field)=>field === DOCUMENT_ID ? id : readPath(data, field);
+    const compare = (a, b)=>{
+        if (a === b) return 0;
+        if (a === undefined || a === null) return -1;
+        if (b === undefined || b === null) return 1;
+        return a < b ? -1 : 1;
+    };
+    const matches = (data, id, filter)=>{
+        const value = fieldOf(data, id, filter.field);
+        const wanted = filter.value;
+        switch(filter.op){
+            case '==':
+                return JSON.stringify(value) === JSON.stringify(wanted);
+            case '!=':
+                return value !== undefined && JSON.stringify(value) !== JSON.stringify(wanted);
+            case 'in':
+                return wanted.some((entry)=>JSON.stringify(entry) === JSON.stringify(value));
+            case 'not-in':
+                return value !== undefined && !wanted.some((entry)=>JSON.stringify(entry) === JSON.stringify(value));
+            case 'array-contains':
+                return Array.isArray(value) && value.includes(wanted);
+            case 'array-contains-any':
+                return Array.isArray(value) && value.some((entry)=>wanted.includes(entry));
+            case '<':
+                return value !== undefined && compare(value, wanted) < 0;
+            case '<=':
+                return value !== undefined && compare(value, wanted) <= 0;
+            case '>':
+                return value !== undefined && compare(value, wanted) > 0;
+            case '>=':
+                return value !== undefined && compare(value, wanted) >= 0;
+            default:
+                throw new Error(`memory firestore: no operator ${filter.op}`);
+        }
+    };
+    const run = (state)=>{
+        const prefix = `${state.path}/`;
+        let found = [
+            ...docs.entries()
+        ].filter(([path])=>path.startsWith(prefix) && !path.slice(prefix.length).includes('/')).map(([path, data])=>({
+                path,
+                id: path.slice(prefix.length),
+                data
+            })).filter((entry)=>state.filters.every((filter)=>matches(entry.data, entry.id, filter)));
+        const order = state.order.length ? state.order : [
+            {
+                field: DOCUMENT_ID,
+                direction: 'asc'
+            }
+        ];
+        for (const { field } of order){
+            if (field !== DOCUMENT_ID) found = found.filter((entry)=>readPath(entry.data, field) !== undefined);
+        }
+        found.sort((a, b)=>{
+            for (const { field, direction } of [
+                ...order,
+                {
+                    field: DOCUMENT_ID,
+                    direction: 'asc'
+                }
+            ]){
+                const result = compare(fieldOf(a.data, a.id, field), fieldOf(b.data, b.id, field));
+                if (result) return direction === 'desc' ? -result : result;
+            }
+            return 0;
+        });
+        if (state.after) {
+            const at = found.findIndex((entry)=>entry.id === state.after.id);
+            found = at >= 0 ? found.slice(at + 1) : found;
+        }
+        if (state.limit !== undefined) found = found.slice(0, state.limit);
+        return found.map((entry)=>snapshot(entry.path));
+    };
+    const query = (state)=>({
+            where: (field, op, value)=>query(_extends({}, state, {
+                    filters: [
+                        ...state.filters,
+                        {
+                            field,
+                            op,
+                            value
+                        }
+                    ]
+                })),
+            orderBy: (field, direction = 'asc')=>query(_extends({}, state, {
+                    order: [
+                        ...state.order,
+                        {
+                            field,
+                            direction
+                        }
+                    ]
+                })),
+            limit: (count)=>query(_extends({}, state, {
+                    limit: count
+                })),
+            startAfter: (after)=>query(_extends({}, state, {
+                    after
+                })),
+            get: async ()=>{
+                const found = run(state);
+                return {
+                    docs: found,
+                    empty: !found.length,
+                    size: found.length
+                };
+            },
+            count: ()=>({
+                    get: async ()=>({
+                            data: ()=>({
+                                    count: run(_extends({}, state, {
+                                        limit: undefined
+                                    })).length
+                                })
+                        })
+                })
+        });
+    const collectionRef = (path)=>_extends({
+            id: path.slice(path.lastIndexOf('/') + 1),
+            path,
+            get parent () {
+                const at = path.lastIndexOf('/');
+                return at > 0 ? docRef(path.slice(0, at)) : null;
+            },
+            doc: (id)=>docRef(`${path}/${id != null ? id : `auto${Math.random().toString(36).slice(2, 12)}`}`)
+        }, query({
+            path,
+            filters: [],
+            order: []
+        }));
+    const firestore = {
+        collection: (name)=>collectionRef(name),
+        getAll: async (...refs)=>refs.map((ref)=>snapshot(ref.path)),
+        batch: ()=>{
+            const staged = [];
+            const batch = {
+                set: (ref, data, options)=>(staged.push(()=>ref.set(data, options)), batch),
+                create: (ref, data)=>(staged.push(()=>ref.create(data)), batch),
+                update: (ref, ...args)=>(staged.push(()=>ref.update(...args)), batch),
+                delete: (ref)=>(staged.push(()=>ref.delete()), batch),
+                commit: async ()=>{
+                    for (const write of staged)await write();
+                }
+            };
+            return batch;
+        },
+        /**
+     * Read-then-write with OPTIMISTIC CONCURRENCY, as the server SDK commits
+     * one: every document the body read is versioned, and a commit that finds
+     * one of them written since is thrown away and the body run again. Two
+     * transactions racing on one document therefore end the way they do in
+     * Firestore — the second re-reads the first one's write — which is the
+     * property a one-open-shift or a lockout counter rests on.
+     */ runTransaction: async (body)=>{
+            for(let attempt = 0; attempt < 10; attempt += 1){
+                const staged = [];
+                const seen = new Map();
+                const transaction = {
+                    get: async (target)=>{
+                        const result = await target.get();
+                        if (typeof target.path === 'string' && !('docs' in result)) {
+                            var _versions_get;
+                            seen.set(target.path, (_versions_get = versions.get(target.path)) != null ? _versions_get : 0);
+                        } else if (result == null ? void 0 : result.docs) {
+                            var _versions_get1;
+                            for (const doc of result.docs)seen.set(doc.ref.path, (_versions_get1 = versions.get(doc.ref.path)) != null ? _versions_get1 : 0);
+                        }
+                        return result;
+                    },
+                    set: (ref, data, options)=>(staged.push(()=>ref.set(data, options)), transaction),
+                    create: (ref, data)=>(staged.push(()=>ref.create(data)), transaction),
+                    update: (ref, ...args)=>(staged.push(()=>ref.update(...args)), transaction),
+                    delete: (ref)=>(staged.push(()=>ref.delete()), transaction)
+                };
+                const result = await body(transaction);
+                const stale = [
+                    ...seen
+                ].some(([path, version])=>{
+                    var _versions_get;
+                    return ((_versions_get = versions.get(path)) != null ? _versions_get : 0) !== version;
+                });
+                if (stale) continue;
+                // Every write starts before any is awaited, so the commit is atomic
+                // against another transaction checking its own reads.
+                await Promise.all(staged.map((write)=>write()));
+                return result;
+            }
+            throw new Error('memory firestore: transaction contended too many times');
+        }
+    };
+    return {
+        docs,
+        now: clock,
+        firestore: firestore,
+        seed: (path, data)=>docs.set(path, copy(data)),
+        read: (path)=>copy(docs.get(path))
+    };
+}
+
+//# sourceMappingURL=pos-ops-memory-firestore.js.map

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

@@ -0,0 +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":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;2CAe2C;AAU3C,MAAMA,cAAc;IAAEC,cAAc;AAAK;AAEzC,kEAAkE,GAClE,OAAO,MAAMC,wBAAwB;IACnCC,YAAY;IACZC,YAAY;QACVC,QAAQ,IAAiB,CAAA;gBAAEC,YAAY;YAAS,CAAA;QAChDC,iBAAiB,IAAiB,CAAA;gBAAED,YAAY;YAAkB,CAAA;QAClEE,YAAY,CAAC,GAAGC,SAAiC,CAAA;gBAAEH,YAAY;gBAAcG;YAAO,CAAA;QACpFC,aAAa,CAAC,GAAGD,SAAiC,CAAA;gBAAEH,YAAY;gBAAeG;YAAO,CAAA;QACtFE,WAAW,CAACC,KAA0B,CAAA;gBAAEN,YAAY;gBAAaM;YAAG,CAAA;IACtE;IACAC,WAAW;QAAEC,YAAY,IAAMd;IAAY;IAC3Ce,WAAW;QAAEC,UAAU,CAACC,OAAeA,KAAKC,OAAO;IAAG;AACxD,EAAC;AAED,MAAMC,aAAa,CAACC,QAClBC,QAAQD,SAAS,OAAOA,UAAU,YAAY,gBAAiBA;AAEjE,MAAME,OAAO,CAAIF,QAAiBA,UAAUG,YAAYH,QAASI,KAAKC,KAAK,CAACD,KAAKE,SAAS,CAACN;AAE3F,SAASO,SAASC,IAAsB,EAAEC,IAAY;IACpD,OAAOA,KAAKC,KAAK,CAAC,KAAKC,MAAM,CAAU,CAACC,MAAMC,MAASD,wBAAD,AAACA,IAA2B,CAACC,IAAI,EAAEL;AAC3F;AAcA,iCAAiC,GACjC,OAAO,SAASM,gBAAgBC,QAAsB,IAAM,aAAiB;IAC3E,MAAMC,OAAO,IAAIC;IACjB,uEAAuE,GACvE,MAAMC,WAAW,IAAID;IACrB,MAAME,OAAO,CAACV;YAAqCS;eAApBA,SAASE,GAAG,CAACX,MAAM,EAACS,gBAAAA,SAASG,GAAG,CAACZ,iBAAbS,gBAAsB,KAAK;;IAE9E,MAAMI,UAAU,CAACtB,OAAgBuB;QAC/B,IAAI,CAACxB,WAAWC,QAAQ,OAAOwB,MAAMC,OAAO,CAACzB,UAAWA,SAAS,OAAOA,UAAU,WAAYE,KAAKF,SAASA;QAC5G,OAAQA,MAAMd,UAAU;YACtB,KAAK;gBACH,OAAO6B;YACT,KAAK;oBACiEf;gBAApE,OAAO;uBAAI,IAAI0B,IAAI;2BAAKF,MAAMC,OAAO,CAACF,WAAWA,UAAU,EAAE;4BAAOvB,gBAAAA,MAAMX,MAAM,YAAZW,gBAAgB,EAAE;qBAAE;iBAAE;YAC5F,KAAK;gBACH,OAAO,AAACwB,CAAAA,MAAMC,OAAO,CAACF,WAAWA,UAAU,EAAE,AAAD,EAAGI,MAAM,CAAC,CAACC;wBAAY5B;2BAAF,CAAC,EAACA,gBAAAA,MAAMX,MAAM,YAAZW,gBAAgB,EAAE,EAAE6B,QAAQ,CAACD;;YAClG,KAAK;oBACkC5B;gBAArC,OAAO8B,OAAOP,kBAAAA,UAAW,KAAKO,QAAO9B,YAAAA,MAAMR,EAAE,YAARQ,YAAY;YACnD;gBACE,OAAOG;QACX;IACF;IAEA,4EAA4E,GAC5E,MAAM4B,YAAY,CAACC,QAAcvB,MAAcT;QAC7C,MAAMiC,OAAOxB,KAAKC,KAAK,CAAC;QACxB,IAAIE,OAAOoB;QACX,KAAK,MAAMnB,OAAOoB,KAAKC,KAAK,CAAC,GAAG,CAAC,GAAI;YACnC,IAAI,CAACtB,IAAI,CAACC,IAAI,IAAI,OAAOD,IAAI,CAACC,IAAI,KAAK,UAAUD,IAAI,CAACC,IAAI,GAAG,CAAC;YAC9DD,OAAOA,IAAI,CAACC,IAAI;QAClB;QACA,MAAMsB,OAAOF,IAAI,CAACA,KAAKG,MAAM,GAAG,EAAE;QAClC,IAAIrC,WAAWC,UAAUA,MAAMd,UAAU,KAAK,UAAU,OAAO0B,IAAI,CAACuB,KAAK;aACpEvB,IAAI,CAACuB,KAAK,GAAGb,QAAQtB,OAAOY,IAAI,CAACuB,KAAK;IAC7C;IAEA,qEAAqE,GACrE,MAAME,SAAS,CAAC7B,MAAY8B,OAAa,CAAC,CAAC;QACzC,MAAMC,OAAOrC,KAAKoC;QAClB,KAAK,MAAM,CAACzB,KAAKb,MAAM,IAAIwC,OAAOC,OAAO,CAACjC,MAAO;YAC/C,IAAIR,UAAUG,WAAW;YACzB,IAAIJ,WAAWC,QAAQ+B,UAAUQ,MAAM1B,KAAKb;iBACvC,IAAIA,SAAS,OAAOA,UAAU,YAAY,CAACwB,MAAMC,OAAO,CAACzB,UAAUsC,IAAI,CAACzB,IAAI,IAAI,OAAOyB,IAAI,CAACzB,IAAI,KAAK,UAAU;gBAClH0B,IAAI,CAAC1B,IAAI,GAAGwB,OAAOrC,OAAesC,IAAI,CAACzB,IAAI;YAC7C,OAAO0B,IAAI,CAAC1B,IAAI,GAAGS,QAAQtB,OAAOuC,IAAI,CAAC1B,IAAI;QAC7C;QACA,OAAO0B;IACT;IAEA,MAAMG,WAAW,CAACjC;QAChB,MAAMD,OAAOQ,KAAKK,GAAG,CAACZ;QACtB,OAAO;YACLkC,IAAIlC,KAAKyB,KAAK,CAACzB,KAAKmC,WAAW,CAAC,OAAO;YACvCC,KAAKC,OAAOrC;YACZsC,QAAQvC,SAASL;YACjBK,MAAM,IAAMN,KAAKM;YACjBa,KAAK,CAAC2B,QAAkB9C,KAAKK,SAASC,MAAMwC;QAC9C;IACF;IAEA,MAAMF,SAAS,CAACrC,OAAuB,CAAA;YACrCkC,IAAIlC,KAAKyB,KAAK,CAACzB,KAAKmC,WAAW,CAAC,OAAO;YACvCnC;YACA,IAAIwC;gBACF,OAAOA;YACT;YACA,IAAIC;gBACF,OAAOC,cAAc1C,KAAKyB,KAAK,CAAC,GAAGzB,KAAKmC,WAAW,CAAC;YACtD;YACAQ,YAAY,CAACC,OAAiBF,cAAc,GAAG1C,KAAK,CAAC,EAAE4C,MAAM;YAC7DhC,KAAK,UAAYqB,SAASjC;YAC1BW,KAAK,OAAOZ,MAAY8C;oBACwBtC;gBAA9CA,KAAKI,GAAG,CAACX,MAAM4B,OAAO7B,MAAM8C,CAAAA,2BAAAA,QAASC,KAAK,KAAIvC,YAAAA,KAAKK,GAAG,CAACZ,iBAATO,YAAkB,CAAC,IAAK,CAAC;gBACvEG,KAAKV;YACP;YACA+C,QAAQ,OAAOhD;gBACb,IAAIQ,KAAKyC,GAAG,CAAChD,OAAO,MAAM+B,OAAOkB,MAAM,CAAC,IAAIC,MAAM,CAAC,gBAAgB,EAAElD,MAAM,GAAG;oBAAEmD,MAAM;gBAAE;gBACxF5C,KAAKI,GAAG,CAACX,MAAM4B,OAAO7B;gBACtBW,KAAKV;YACP;YACAoD,QAAQ,OAAO,GAAGC;gBAChB,MAAMvC,UAAUP,KAAKK,GAAG,CAACZ;gBACzB,IAAI,CAACc,SAAS,MAAMiB,OAAOkB,MAAM,CAAC,IAAIC,MAAM,CAAC,WAAW,EAAElD,MAAM,GAAG;oBAAEmD,MAAM;gBAAE;gBAC7E,MAAMG,QACJ,OAAOD,IAAI,CAAC,EAAE,KAAK,WACftB,OAAOwB,WAAW,CAChBxC,MAAMyC,IAAI,CAAC;oBAAE7B,QAAQ0B,KAAK1B,MAAM,GAAG;gBAAE,GAAG,CAAC8B,SAASC,KAAO;wBAACC,OAAON,IAAI,CAACK,KAAK,EAAE;wBAAGL,IAAI,CAACK,KAAK,IAAI,EAAE;qBAAC,KAElGL,IAAI,CAAC,EAAE;gBACd,MAAMvB,OAAOrC,KAAKqB;gBAClB,KAAK,MAAM,CAACV,KAAKb,MAAM,IAAIwC,OAAOC,OAAO,CAACsB,OAAQhC,UAAUQ,MAAM1B,KAAKb;gBACvEgB,KAAKI,GAAG,CAACX,MAAM8B;gBACfpB,KAAKV;YACP;YACAxB,QAAQ;gBACN+B,KAAK/B,MAAM,CAACwB;gBACZU,KAAKV;YACP;QACF,CAAA;IAUA,MAAM4D,UAAU,CAAC7D,MAAwBmC,IAAYK,QACnDA,UAAUpE,cAAc+D,KAAKpC,SAASC,MAAMwC;IAE9C,MAAMsB,UAAU,CAACC,GAAYC;QAC3B,IAAID,MAAMC,GAAG,OAAO;QACpB,IAAID,MAAMpE,aAAaoE,MAAM,MAAM,OAAO,CAAC;QAC3C,IAAIC,MAAMrE,aAAaqE,MAAM,MAAM,OAAO;QAC1C,OAAO,AAACD,IAAgBC,IAAe,CAAC,IAAI;IAC9C;IAEA,MAAMC,UAAU,CAACjE,MAAYmC,IAAYhB;QACvC,MAAM3B,QAAQqE,QAAQ7D,MAAMmC,IAAIhB,OAAOqB,KAAK;QAC5C,MAAM0B,SAAS/C,OAAO3B,KAAK;QAC3B,OAAQ2B,OAAOgD,EAAE;YACf,KAAK;gBACH,OAAOvE,KAAKE,SAAS,CAACN,WAAWI,KAAKE,SAAS,CAACoE;YAClD,KAAK;gBACH,OAAO1E,UAAUG,aAAaC,KAAKE,SAAS,CAACN,WAAWI,KAAKE,SAAS,CAACoE;YACzE,KAAK;gBACH,OAAO,AAACA,OAAqBE,IAAI,CAAC,CAAChD,QAAUxB,KAAKE,SAAS,CAACsB,WAAWxB,KAAKE,SAAS,CAACN;YACxF,KAAK;gBACH,OAAOA,UAAUG,aAAa,CAAC,AAACuE,OAAqBE,IAAI,CAAC,CAAChD,QAAUxB,KAAKE,SAAS,CAACsB,WAAWxB,KAAKE,SAAS,CAACN;YAChH,KAAK;gBACH,OAAOwB,MAAMC,OAAO,CAACzB,UAAUA,MAAM6B,QAAQ,CAAC6C;YAChD,KAAK;gBACH,OAAOlD,MAAMC,OAAO,CAACzB,UAAUA,MAAM4E,IAAI,CAAC,CAAChD,QAAU,AAAC8C,OAAqB7C,QAAQ,CAACD;YACtF,KAAK;gBACH,OAAO5B,UAAUG,aAAamE,QAAQtE,OAAO0E,UAAU;YACzD,KAAK;gBACH,OAAO1E,UAAUG,aAAamE,QAAQtE,OAAO0E,WAAW;YAC1D,KAAK;gBACH,OAAO1E,UAAUG,aAAamE,QAAQtE,OAAO0E,UAAU;YACzD,KAAK;gBACH,OAAO1E,UAAUG,aAAamE,QAAQtE,OAAO0E,WAAW;YAC1D;gBACE,MAAM,IAAIf,MAAM,CAAC,8BAA8B,EAAEhC,OAAOgD,EAAE,EAAE;QAChE;IACF;IAEA,MAAME,MAAM,CAACC;QACX,MAAMC,SAAS,GAAGD,MAAMrE,IAAI,CAAC,CAAC,CAAC;QAC/B,IAAIuE,QAAQ;eAAIhE,KAAKyB,OAAO;SAAG,CAC5Bd,MAAM,CAAC,CAAC,CAAClB,KAAK,GAAKA,KAAKwE,UAAU,CAACF,WAAW,CAACtE,KAAKyB,KAAK,CAAC6C,OAAO3C,MAAM,EAAEP,QAAQ,CAAC,MAClFqD,GAAG,CAAC,CAAC,CAACzE,MAAMD,KAAK,GAAM,CAAA;gBAAEC;gBAAMkC,IAAIlC,KAAKyB,KAAK,CAAC6C,OAAO3C,MAAM;gBAAG5B;YAAK,CAAA,GACnEmB,MAAM,CAAC,CAACC,QAAUkD,MAAMK,OAAO,CAACC,KAAK,CAAC,CAACzD,SAAW8C,QAAQ7C,MAAMpB,IAAI,EAAEoB,MAAMe,EAAE,EAAEhB;QACnF,MAAM0D,QAAQP,MAAMO,KAAK,CAACjD,MAAM,GAAG0C,MAAMO,KAAK,GAAG;YAAC;gBAAErC,OAAOpE;gBAAa0G,WAAW;YAAe;SAAE;QACpG,KAAK,MAAM,EAAEtC,KAAK,EAAE,IAAIqC,MAAO;YAC7B,IAAIrC,UAAUpE,aAAaoG,QAAQA,MAAMrD,MAAM,CAAC,CAACC,QAAUrB,SAASqB,MAAMpB,IAAI,EAAEwC,WAAqB7C;QACvG;QACA6E,MAAMO,IAAI,CAAC,CAAChB,GAAGC;YACb,KAAK,MAAM,EAAExB,KAAK,EAAEsC,SAAS,EAAE,IAAI;mBAAID;gBAAO;oBAAErC,OAAOpE;oBAAa0G,WAAW;gBAAe;aAAE,CAAE;gBAChG,MAAME,SAASlB,QAAQD,QAAQE,EAAE/D,IAAI,EAAE+D,EAAE5B,EAAE,EAAEK,QAAQqB,QAAQG,EAAEhE,IAAI,EAAEgE,EAAE7B,EAAE,EAAEK;gBAC3E,IAAIwC,QAAQ,OAAOF,cAAc,SAAS,CAACE,SAASA;YACtD;YACA,OAAO;QACT;QACA,IAAIV,MAAMW,KAAK,EAAE;YACf,MAAMtB,KAAKa,MAAMU,SAAS,CAAC,CAAC9D,QAAUA,MAAMe,EAAE,KAAKmC,MAAMW,KAAK,CAAC9C,EAAE;YACjEqC,QAAQb,MAAM,IAAIa,MAAM9C,KAAK,CAACiC,KAAK,KAAKa;QAC1C;QACA,IAAIF,MAAMa,KAAK,KAAKxF,WAAW6E,QAAQA,MAAM9C,KAAK,CAAC,GAAG4C,MAAMa,KAAK;QACjE,OAAOX,MAAME,GAAG,CAAC,CAACtD,QAAUc,SAASd,MAAMnB,IAAI;IACjD;IAEA,MAAMmF,QAAQ,CAACd,QAA4B,CAAA;YACzCe,OAAO,CAAC7C,OAAoC2B,IAAY3E,QACtD4F,MAAM,aAAKd;oBAAOK,SAAS;2BAAIL,MAAMK,OAAO;wBAAE;4BAAEnC;4BAAO2B;4BAAI3E;wBAAM;qBAAE;;YACrE8F,SAAS,CAAC9C,OAAoCsC,YAA4B,KAAK,GAC7EM,MAAM,aAAKd;oBAAOO,OAAO;2BAAIP,MAAMO,KAAK;wBAAE;4BAAErC;4BAAOsC;wBAAU;qBAAE;;YACjEK,OAAO,CAACI,QAAkBH,MAAM,aAAKd;oBAAOa,OAAOI;;YACnDC,YAAY,CAACP,QAAeG,MAAM,aAAKd;oBAAOW;;YAC9CpE,KAAK;gBACH,MAAM2D,QAAQH,IAAIC;gBAClB,OAAO;oBAAE9D,MAAMgE;oBAAOiB,OAAO,CAACjB,MAAM5C,MAAM;oBAAE8D,MAAMlB,MAAM5C,MAAM;gBAAC;YACjE;YACA2D,OAAO,IAAO,CAAA;oBACZ1E,KAAK,UAAa,CAAA;4BAAEb,MAAM,IAAO,CAAA;oCAAEuF,OAAOlB,IAAI,aAAKC;wCAAOa,OAAOxF;wCAAaiC,MAAM;gCAAC,CAAA;wBAAG,CAAA;gBAC1F,CAAA;QACF,CAAA;IAEA,MAAMe,gBAAgB,CAAC1C,OAAuB;YAC5CkC,IAAIlC,KAAKyB,KAAK,CAACzB,KAAKmC,WAAW,CAAC,OAAO;YACvCnC;YACA,IAAIyC;gBACF,MAAMiB,KAAK1D,KAAKmC,WAAW,CAAC;gBAC5B,OAAOuB,KAAK,IAAIrB,OAAOrC,KAAKyB,KAAK,CAAC,GAAGiC,OAAO;YAC9C;YACAgC,KAAK,CAACxD,KAAgBG,OAAO,GAAGrC,KAAK,CAAC,EAAEkC,aAAAA,KAAM,CAAC,IAAI,EAAEyD,KAAKC,MAAM,GAAGC,QAAQ,CAAC,IAAIpE,KAAK,CAAC,GAAG,KAAK,EAAE;WAC7F0D,MAAM;YAAEnF;YAAM0E,SAAS,EAAE;YAAEE,OAAO,EAAE;QAAC;IAG1C,MAAMpC,YAAY;QAChBG,YAAY,CAACC,OAAiBF,cAAcE;QAC5CkD,QAAQ,OAAO,GAAGC,OAAkCA,KAAKtB,GAAG,CAAC,CAACrC,MAAQH,SAASG,IAAIpC,IAAI;QACvFgG,OAAO;YACL,MAAMC,SAAqC,EAAE;YAC7C,MAAMD,QAAQ;gBACZrF,KAAK,CAACyB,KAAUrC,MAAY8C,UAAmCoD,CAAAA,OAAOC,IAAI,CAAC,IAAM9D,IAAIzB,GAAG,CAACZ,MAAM8C,WAAWmD,KAAI;gBAC9GjD,QAAQ,CAACX,KAAUrC,OAAgBkG,CAAAA,OAAOC,IAAI,CAAC,IAAM9D,IAAIW,MAAM,CAAChD,QAAQiG,KAAI;gBAC5E5C,QAAQ,CAAChB,KAAU,GAAGiB,OAAqB4C,CAAAA,OAAOC,IAAI,CAAC,IAAM9D,IAAIgB,MAAM,IAAIC,QAAQ2C,KAAI;gBACvFxH,QAAQ,CAAC4D,MAAc6D,CAAAA,OAAOC,IAAI,CAAC,IAAM9D,IAAI5D,MAAM,KAAKwH,KAAI;gBAC5DG,QAAQ;oBACN,KAAK,MAAMC,SAASH,OAAQ,MAAMG;gBACpC;YACF;YACA,OAAOJ;QACT;QACA;;;;;;;KAOC,GACDK,gBAAgB,OAAUC;YACxB,IAAK,IAAIC,UAAU,GAAGA,UAAU,IAAIA,WAAW,EAAG;gBAChD,MAAMN,SAAqC,EAAE;gBAC7C,MAAMO,OAAO,IAAIhG;gBACjB,MAAMiG,cAAc;oBAClB7F,KAAK,OAAOW;wBACV,MAAMwD,SAAS,MAAMxD,OAAOX,GAAG;wBAC/B,IAAI,OAAOW,OAAOvB,IAAI,KAAK,YAAY,CAAE,CAAA,UAAU+E,MAAK,GAAI;gCACpCtE;4BAAtB+F,KAAK7F,GAAG,CAACY,OAAOvB,IAAI,GAAES,gBAAAA,SAASG,GAAG,CAACW,OAAOvB,IAAI,aAAxBS,gBAA6B;wBACrD,OAAO,IAAIsE,0BAAAA,OAAQxE,IAAI,EAAE;gCAC+BE;4BAAtD,KAAK,MAAMiF,OAAOX,OAAOxE,IAAI,CAAEiG,KAAK7F,GAAG,CAAC+E,IAAItD,GAAG,CAACpC,IAAI,GAAES,iBAAAA,SAASG,GAAG,CAAC8E,IAAItD,GAAG,CAACpC,IAAI,aAAzBS,iBAA8B;wBACtF;wBACA,OAAOsE;oBACT;oBACApE,KAAK,CAACyB,KAAUrC,MAAY8C,UAAmCoD,CAAAA,OAAOC,IAAI,CAAC,IAAM9D,IAAIzB,GAAG,CAACZ,MAAM8C,WAAW4D,WAAU;oBACpH1D,QAAQ,CAACX,KAAUrC,OAAgBkG,CAAAA,OAAOC,IAAI,CAAC,IAAM9D,IAAIW,MAAM,CAAChD,QAAQ0G,WAAU;oBAClFrD,QAAQ,CAAChB,KAAU,GAAGiB,OAAqB4C,CAAAA,OAAOC,IAAI,CAAC,IAAM9D,IAAIgB,MAAM,IAAIC,QAAQoD,WAAU;oBAC7FjI,QAAQ,CAAC4D,MAAc6D,CAAAA,OAAOC,IAAI,CAAC,IAAM9D,IAAI5D,MAAM,KAAKiI,WAAU;gBACpE;gBACA,MAAM1B,SAAS,MAAMuB,KAAKG;gBAC1B,MAAMC,QAAQ;uBAAIF;iBAAK,CAACrC,IAAI,CAAC,CAAC,CAACnE,MAAM2G,QAAQ;wBAAMlG;2BAAD,EAACA,gBAAAA,SAASG,GAAG,CAACZ,iBAAbS,gBAAsB,OAAOkG;;gBAChF,IAAID,OAAO;gBACX,oEAAoE;gBACpE,sDAAsD;gBACtD,MAAME,QAAQC,GAAG,CAACZ,OAAOxB,GAAG,CAAC,CAAC2B,QAAUA;gBACxC,OAAOrB;YACT;YACA,MAAM,IAAI7B,MAAM;QAClB;IACF;IAEA,OAAO;QACL3C;QACAuG,KAAKxG;QACLkC,WAAWA;QACXuE,MAAM,CAAC/G,MAAMD,OAASQ,KAAKI,GAAG,CAACX,MAAMP,KAAKM;QAC1CiH,MAAM,CAAChH,OAASP,KAAKc,KAAKK,GAAG,CAACZ;IAChC;AACF"}

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

@@ -19,6 +19,7 @@ import type { PicklistSpec } from '@aglyn/aglyn/app-utils/picklists';
 import type { DiscountKind, HostDiscount } from '../model/commerce-discounts';
 import { type HostGiftCard } from '../model/commerce-gift-cards';
 import { type HostOrder } from '../model/commerce-orders';
+import { type ProductWeights } from '../model/order-shipping-export';
 /** A planned row's changes, by field id. */
 export declare function rowChanges(row: PlannedTransferRow): Record<string, unknown>;
 /**
@@ -27,6 +28,15 @@ export declare function rowChanges(row: PlannedTransferRow): Record<string, unkn
  * mapped, and a file that only switches discounts off would be refused.
  */
 export declare function planWithCreateRequired(input: BuildTransferPlanInput, required: readonly string[]): TransferPlan;
+/**
+ * What a label tool reads (AGL-3613): the ship-to address split into its
+ * parts, what is still to be packed and what it weighs — `orderShippingRecord`.
+ * The weight is the remaining units' recorded product weights; blank when
+ * no product records one, so the tool uses its default package instead.
+ */
+export declare const ORDER_SHIPPING_FIELDS: readonly TransferField[];
+/** The shipping fields' ids, which an export reads product weights for. */
+export declare const ORDER_SHIPPING_FIELD_IDS: readonly string[];
 export declare const ORDER_TRANSFER_FIELDS: readonly TransferField[];
 export declare const ORDER_TRANSFER_GROUPS: {
     id: string;
@@ -47,7 +57,7 @@ export type StoredOrder = Partial<HostOrder> & {
  * field, and reading those first exported every one of them at $0.00. A
  * legacy row is named from `productNames`, never as "Product".
  */
-export declare function orderRecord(id: string, stored: StoredOrder, productNames?: Readonly<Record<string, string>>): Record<string, unknown>;
+export declare function orderRecord(id: string, stored: StoredOrder, productNames?: Readonly<Record<string, string>>, weights?: ProductWeights): Record<string, unknown>;
 export declare const DISCOUNT_KIND_PICKLIST = "commerce.discountKind";
 export declare const DISCOUNT_KIND_SPEC: PicklistSpec;
 /** A discount kind's id from a label or id in any case, or `null`. */

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

@@ -19,6 +19,7 @@ import { commerceSlug } from "../model/commerce.js";
 import { GIFT_CARD_CONFIRM_STEP_ID } from "./transfer-keys.js";
 import { GIFT_CARD_CURRENCY, giftCardAmountProblem, giftCardCodeOf, giftCardCodeProblem } from "../model/commerce-gift-cards.js";
 import { ORDER_CHANNEL_LABELS, ORDER_STATUS_LABELS, liftLegacyOrder } from "../model/commerce-orders.js";
+import { orderShippingRecord } from "../model/order-shipping-export.js";
 /*
  * ORDERS, DISCOUNTS, COUPONS, GIFT CARDS AND CATEGORIES AS FILES (AGL-3531):
  * each resource's fields, and its stored document as the record a file
@@ -67,7 +68,123 @@ const text = (value)=>value === null || value === undefined ? '' : String(value)
 }
 /*==========================================
  * ORDERS
- *=========================================*/ export const ORDER_TRANSFER_FIELDS = [
+ *=========================================*/ /**
+ * What a label tool reads (AGL-3613): the ship-to address split into its
+ * parts, what is still to be packed and what it weighs — `orderShippingRecord`.
+ * The weight is the remaining units' recorded product weights; blank when
+ * no product records one, so the tool uses its default package instead.
+ */ export const ORDER_SHIPPING_FIELDS = [
+    {
+        id: 'orderRef',
+        label: 'Order reference',
+        group: 'shipping',
+        type: 'text',
+        readOnly: true,
+        description: 'The order number, as a label tool sends it back.'
+    },
+    {
+        id: 'shipName',
+        label: 'Ship to name',
+        group: 'shipping',
+        type: 'text',
+        readOnly: true
+    },
+    {
+        id: 'shipLine1',
+        label: 'Ship to address line 1',
+        group: 'shipping',
+        type: 'text',
+        readOnly: true
+    },
+    {
+        id: 'shipLine2',
+        label: 'Ship to address line 2',
+        group: 'shipping',
+        type: 'text',
+        readOnly: true
+    },
+    {
+        id: 'shipCity',
+        label: 'Ship to city',
+        group: 'shipping',
+        type: 'text',
+        readOnly: true
+    },
+    {
+        id: 'shipState',
+        label: 'Ship to state',
+        group: 'shipping',
+        type: 'text',
+        readOnly: true
+    },
+    {
+        id: 'shipPostalCode',
+        label: 'Ship to postal code',
+        group: 'shipping',
+        type: 'text',
+        readOnly: true
+    },
+    {
+        id: 'shipCountry',
+        label: 'Ship to country',
+        group: 'shipping',
+        type: 'text',
+        readOnly: true
+    },
+    {
+        id: 'shipPhone',
+        label: 'Ship to phone',
+        group: 'shipping',
+        type: 'phone',
+        readOnly: true
+    },
+    {
+        id: 'shipEmail',
+        label: 'Ship to email',
+        group: 'shipping',
+        type: 'email',
+        readOnly: true
+    },
+    {
+        id: 'itemsToShip',
+        label: 'Items to ship',
+        group: 'shipping',
+        type: 'longText',
+        readOnly: true,
+        description: 'What is still to ship: quantity × name (variant), SKU.'
+    },
+    {
+        id: 'unitsToShip',
+        label: 'Units to ship',
+        group: 'shipping',
+        type: 'integer',
+        readOnly: true
+    },
+    {
+        id: 'weightOz',
+        label: 'Weight (oz)',
+        group: 'shipping',
+        type: 'number',
+        readOnly: true
+    },
+    {
+        id: 'weightLb',
+        label: 'Weight (lb)',
+        group: 'shipping',
+        type: 'number',
+        readOnly: true
+    },
+    {
+        id: 'weightUnit',
+        label: 'Weight unit',
+        group: 'shipping',
+        type: 'text',
+        readOnly: true,
+        description: 'Always oz, beside Weight (oz), for tools that ask for the unit.'
+    }
+];
+/** The shipping fields' ids, which an export reads product weights for. */ export const ORDER_SHIPPING_FIELD_IDS = ORDER_SHIPPING_FIELDS.map((field)=>field.id);
+export const ORDER_TRANSFER_FIELDS = [
     {
         id: 'number',
         label: 'Order number',
@@ -232,7 +349,8 @@ const text = (value)=>value === null || value === undefined ? '' : String(value)
         group: TRANSFER_SYSTEM_GROUP.id,
         type: 'text',
         system: true
-    }
+    },
+    ...ORDER_SHIPPING_FIELDS
 ];
 export const ORDER_TRANSFER_GROUPS = [
     {
@@ -250,6 +368,10 @@ export const ORDER_TRANSFER_GROUPS = [
     {
         id: 'money',
         label: 'Money'
+    },
+    {
+        id: 'shipping',
+        label: 'Shipping'
     }
 ];
 const addressLine = (address)=>{
@@ -271,7 +393,7 @@ const addressLine = (address)=>{
  * of old carries nothing else (AGL-1747) — a POS or draft order has no flat
  * field, and reading those first exported every one of them at $0.00. A
  * legacy row is named from `productNames`, never as "Product".
- */ export function orderRecord(id, stored, productNames = {}) {
+ */ export function orderRecord(id, stored, productNames = {}, weights = {}) {
     var _stored_lineItems, _ref, _ref1, _ref2, _stored_productId, _ref3, _ref4, _stored_refundedCents, _iso, _ORDER_STATUS_LABELS_lifted_status, _ref5, _ORDER_CHANNEL_LABELS_, _lifted_channel, _stored_customerEmail, _stored_customerName, _ref6, _ref7, _stored_couponCode, _stored_note, _stored_paymentIntentId;
     var _lineItems_;
     const lifted = liftLegacyOrder(stored);
@@ -280,7 +402,7 @@ const addressLine = (address)=>{
     const totals = lifted.totals;
     const totalCents = Number((_ref3 = (_ref4 = totals == null ? void 0 : totals.totalCents) != null ? _ref4 : stored.amountCents) != null ? _ref3 : 0);
     const refundedCents = Number((_stored_refundedCents = stored.refundedCents) != null ? _stored_refundedCents : 0);
-    return {
+    return _extends({
         id,
         number: typeof stored.number === 'number' ? stored.number : null,
         date: (_iso = iso(stored.createdAt)) != null ? _iso : iso(stored.createdAtMs),
@@ -305,7 +427,7 @@ const addressLine = (address)=>{
         note: (_stored_note = stored.note) != null ? _stored_note : null,
         dispute: stored.dispute ? text(stored.dispute.status) || 'open' : null,
         paymentIntentId: (_stored_paymentIntentId = stored.paymentIntentId) != null ? _stored_paymentIntentId : null
-    };
+    }, orderShippingRecord(id, stored, weights));
 }
 /*==========================================
  * DISCOUNTS