@aglyn/plugins-crm 1.0.0-beta.221 → 1.0.0-beta.222

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

@@ -0,0 +1,335 @@
+/**
+ * @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 transfer resources' specs
+ * (AGL-3527).
+ *
+ * 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();
+    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 : {} : {}));
+            },
+            create: async (data)=>{
+                if (docs.has(path)) throw Object.assign(new Error(`ALREADY_EXISTS: ${path}`), {
+                    code: 6
+                });
+                docs.set(path, settle(data));
+            },
+            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);
+            },
+            delete: async ()=>{
+                docs.delete(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;
+        },
+        runTransaction: async (body)=>{
+            const staged = [];
+            const transaction = {
+                get: async (target)=>target.get(),
+                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);
+            for (const write of staged)await write();
+            return result;
+        }
+    };
+    return {
+        docs,
+        now: clock,
+        firestore: firestore,
+        seed: (path, data)=>docs.set(path, copy(data)),
+        read: (path)=>copy(docs.get(path))
+    };
+}
+
+//# sourceMappingURL=memory-firestore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/testing/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 transfer resources' specs\n * (AGL-3527).\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\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    },\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    },\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    },\n    delete: async () => {\n      docs.delete(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    runTransaction: async <T>(body: (transaction: any) => Promise<T>): Promise<T> => {\n      const staged: Array<() => Promise<void>> = []\n      const transaction = {\n        get: async (target: any) => target.get(),\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      for (const write of staged) await write()\n      return result\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","resolve","current","Array","isArray","Set","filter","entry","includes","Number","writePath","target","keys","slice","leaf","length","settle","base","next","Object","entries","snapshot","get","id","lastIndexOf","ref","docRef","exists","field","firestore","parent","collectionRef","collection","name","set","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","transaction","now","seed","read"],"mappings":"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"}

package/src/lib/testing/stand-in-email-send-index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @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 `emailSend` record index the plugin that sends campaigns publishes
+ * (AGL-3080), stood in for this plugin's specs — this plugin may not load
+ * the marketing plugin. A send is named as that plugin's index names it: the
+ * name the team gave it, else its subject, and an unnamed send is left out.
+ * `read` answers the stored send the spec holds for an org and an id; what
+ * the marketing plugin itself answers is held in its own spec.
+ */
+export declare function standInEmailSendIndex(read: (orgId: string, sendId: string) => Readonly<Record<string, unknown>> | undefined): void;

package/src/lib/testing/stand-in-email-send-index.js

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { registerPluginRecordIndex } from "@aglyn/aglyn/plugin-manager/plugin-record-index";
+/**
+ * The `emailSend` record index the plugin that sends campaigns publishes
+ * (AGL-3080), stood in for this plugin's specs — this plugin may not load
+ * the marketing plugin. A send is named as that plugin's index names it: the
+ * name the team gave it, else its subject, and an unnamed send is left out.
+ * `read` answers the stored send the spec holds for an org and an id; what
+ * the marketing plugin itself answers is held in its own spec.
+ */ export function standInEmailSendIndex(read) {
+    const text = (value)=>typeof value === 'string' ? value.trim() : '';
+    registerPluginRecordIndex('emailSend', {
+        async list () {
+            return {
+                records: [],
+                truncated: false
+            };
+        },
+        async get ({ orgId, id }) {
+            const data = orgId ? read(orgId, id) : undefined;
+            const name = data ? text(data['displayName']) || text(data['subject']) : '';
+            return name ? {
+                id,
+                name,
+                facts: {
+                    hostId: text(data == null ? void 0 : data['hostId'])
+                }
+            } : null;
+        }
+    }, {
+        pluginId: 'marketing'
+    });
+}
+
+//# sourceMappingURL=stand-in-email-send-index.js.map

package/src/lib/testing/stand-in-email-send-index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/testing/stand-in-email-send-index.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 { registerPluginRecordIndex } from '@aglyn/aglyn/plugin-manager/plugin-record-index'\n\n/**\n * The `emailSend` record index the plugin that sends campaigns publishes\n * (AGL-3080), stood in for this plugin's specs — this plugin may not load\n * the marketing plugin. A send is named as that plugin's index names it: the\n * name the team gave it, else its subject, and an unnamed send is left out.\n * `read` answers the stored send the spec holds for an org and an id; what\n * the marketing plugin itself answers is held in its own spec.\n */\nexport function standInEmailSendIndex(\n  read: (orgId: string, sendId: string) => Readonly<Record<string, unknown>> | undefined,\n): void {\n  const text = (value: unknown) => (typeof value === 'string' ? value.trim() : '')\n  registerPluginRecordIndex(\n    'emailSend',\n    {\n      async list() {\n        return { records: [], truncated: false }\n      },\n      async get({ orgId, id }) {\n        const data = orgId ? read(orgId, id) : undefined\n        const name = data ? text(data['displayName']) || text(data['subject']) : ''\n        return name ? { id, name, facts: { hostId: text(data?.['hostId']) } } : null\n      },\n    },\n    { pluginId: 'marketing' },\n  )\n}\n"],"names":["registerPluginRecordIndex","standInEmailSendIndex","read","text","value","trim","list","records","truncated","get","orgId","id","data","undefined","name","facts","hostId","pluginId"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,yBAAyB,QAAQ,kDAAiD;AAE3F;;;;;;;CAOC,GACD,OAAO,SAASC,sBACdC,IAAsF;IAEtF,MAAMC,OAAO,CAACC,QAAoB,OAAOA,UAAU,WAAWA,MAAMC,IAAI,KAAK;IAC7EL,0BACE,aACA;QACE,MAAMM;YACJ,OAAO;gBAAEC,SAAS,EAAE;gBAAEC,WAAW;YAAM;QACzC;QACA,MAAMC,KAAI,EAAEC,KAAK,EAAEC,EAAE,EAAE;YACrB,MAAMC,OAAOF,QAAQR,KAAKQ,OAAOC,MAAME;YACvC,MAAMC,OAAOF,OAAOT,KAAKS,IAAI,CAAC,cAAc,KAAKT,KAAKS,IAAI,CAAC,UAAU,IAAI;YACzE,OAAOE,OAAO;gBAAEH;gBAAIG;gBAAMC,OAAO;oBAAEC,QAAQb,KAAKS,wBAAAA,IAAM,CAAC,SAAS;gBAAE;YAAE,IAAI;QAC1E;IACF,GACA;QAAEK,UAAU;IAAY;AAE5B"}

package/src/lib/transfer/activities.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type TransferExportHooks } from './common';
+/** The words an export writes for the records an activity is about. */
+interface ActivityNames {
+    by?: (uid: string) => string | undefined;
+    contact?: (id: string) => string | undefined;
+    company?: (id: string) => string | undefined;
+    deal?: (id: string) => string | undefined;
+    lead?: (id: string) => string | undefined;
+}
+/** One activity as values by field id. */
+export declare function activityTransferValues(id: string, activity: Record<string, unknown>, names?: ActivityNames): Record<string, unknown>;
+/** The `crm.activities` hooks: an export, and the reads undo would ask. */
+export declare function activitiesTransferResource(): TransferExportHooks;
+export {};

package/src/lib/transfer/activities.js

@@ -0,0 +1,132 @@
+/**
+ * @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.
+ */ /*==========================================
+ * WHAT THE TEAM LOGGED, AS A FILE (AGL-3528) — `crm.activities`, exported.
+ *
+ * Every call, email, meeting and note logged against a contact, a company,
+ * a deal or a lead, with who logged it and what it was about: the record of
+ * the team's work, taken out to report on or to keep. An activity is
+ * logged on a record, as it happens, so the resource is exported and never
+ * imported (`directions: ["export"]`).
+ *=========================================*/ import { CRM_ACTIVITY_DIRECTION_LABELS, CRM_ACTIVITY_KIND_LABELS, CRM_COLLECTIONS, CRM_EMAIL_DELIVERY_STATE_LABELS } from "@aglyn/aglyn/server";
+import { TRANSFER_ID_FIELD } from "@aglyn/aglyn/data-transfer";
+import { countCrmExport, crmMemberEmails, crmTransferEnv, isoOf, lookupById, lookupResult, pickValues, readCrmExportPage, requireCrmRecords, textOf, visibleIn } from "./common.js";
+import { ACTIVITY_TRANSFER_FIELDS, ACTIVITY_TRANSFER_GROUPS, CRM_TIMESTAMP_FIELDS } from "./fields.js";
+const activitiesOf = (env)=>env.orgRef.collection(CRM_COLLECTIONS.activities);
+/** One activity as values by field id. */ export function activityTransferValues(id, activity, names = {}) {
+    var _CRM_ACTIVITY_KIND_LABELS_kind, _CRM_ACTIVITY_DIRECTION_LABELS_direction, _link, _CRM_EMAIL_DELIVERY_STATE_LABELS_delivery;
+    const text = (value)=>textOf(value) || null;
+    const link = (value, resolve)=>{
+        var _ref;
+        const linked = text(value);
+        return linked ? (_ref = resolve == null ? void 0 : resolve(linked)) != null ? _ref : linked : null;
+    };
+    const kind = textOf(activity['kind']);
+    const direction = textOf(activity['direction']);
+    const delivery = textOf(activity['deliveryState']);
+    return {
+        subject: text(activity['subject']),
+        kind: (_CRM_ACTIVITY_KIND_LABELS_kind = CRM_ACTIVITY_KIND_LABELS[kind]) != null ? _CRM_ACTIVITY_KIND_LABELS_kind : text(kind),
+        direction: (_CRM_ACTIVITY_DIRECTION_LABELS_direction = CRM_ACTIVITY_DIRECTION_LABELS[direction]) != null ? _CRM_ACTIVITY_DIRECTION_LABELS_direction : text(direction),
+        at: isoOf(activity['atMs']),
+        body: text(activity['body']),
+        outcome: text(activity['outcome']),
+        durationMinutes: typeof activity['durationMinutes'] === 'number' ? activity['durationMinutes'] : null,
+        by: (_link = link(activity['byUid'], names.by)) != null ? _link : text(activity['byName']),
+        to: text(activity['to']),
+        from: text(activity['from']),
+        deliveryState: (_CRM_EMAIL_DELIVERY_STATE_LABELS_delivery = CRM_EMAIL_DELIVERY_STATE_LABELS[delivery]) != null ? _CRM_EMAIL_DELIVERY_STATE_LABELS_delivery : text(delivery),
+        contact: link(activity['contactId'], names.contact),
+        company: link(activity['companyId'], names.company),
+        deal: link(activity['dealId'], names.deal),
+        lead: link(activity['leadId'], names.lead),
+        createdAt: isoOf(activity['createdAt']),
+        updatedAt: isoOf(activity['updatedAt']),
+        [TRANSFER_ID_FIELD]: id
+    };
+}
+/** Reads one field of each linked record by id. */ async function namesOf(env, collection, ids, field) {
+    const out = new Map();
+    const wanted = [
+        ...new Set(ids)
+    ].filter((id)=>id && !id.includes('/'));
+    for(let at = 0; at < wanted.length; at += 500){
+        const refs = wanted.slice(at, at + 500).map((id)=>env.orgRef.collection(collection).doc(id));
+        for (const snapshot of (await env.firestore.getAll(...refs))){
+            var _snapshot_data;
+            if (snapshot.exists) out.set(snapshot.id, field((_snapshot_data = snapshot.data()) != null ? _snapshot_data : {}));
+        }
+    }
+    return out;
+}
+/** The `crm.activities` hooks: an export, and the reads undo would ask. */ export function activitiesTransferResource() {
+    return {
+        fields: ()=>({
+                standard: ACTIVITY_TRANSFER_FIELDS,
+                system: CRM_TIMESTAMP_FIELDS,
+                groups: ACTIVITY_TRANSFER_GROUPS
+            }),
+        matchKeys: [
+            {
+                fieldId: TRANSFER_ID_FIELD,
+                normalizer: 'aglynId'
+            }
+        ],
+        async count (ctx, options) {
+            const env = await crmTransferEnv(ctx);
+            requireCrmRecords(env, 'activities');
+            return countCrmExport(env, activitiesOf(env), options, (data)=>visibleIn(env, data['visibleTo'], options.scopeTokens));
+        },
+        async readPage (ctx, cursor, fieldIds, options) {
+            const env = await crmTransferEnv(ctx);
+            requireCrmRecords(env, 'activities');
+            const emails = fieldIds.includes('by') ? await crmMemberEmails(env.orgId) : new Map();
+            return readCrmExportPage(env, activitiesOf(env), cursor, options, (data)=>visibleIn(env, data['visibleTo'], options == null ? void 0 : options.scopeTokens), async (docs)=>{
+                const ids = (field)=>docs.map((doc)=>textOf(doc.data[field])).filter(Boolean);
+                const wants = (field)=>fieldIds.includes(field);
+                const empty = new Map();
+                const [contacts, companies, deals, leads] = await Promise.all([
+                    wants('contact') ? namesOf(env, 'contacts', ids('contactId'), (data)=>textOf(data['email'])) : empty,
+                    wants('company') ? namesOf(env, CRM_COLLECTIONS.companies, ids('companyId'), (data)=>textOf(data['name'])) : empty,
+                    wants('deal') ? namesOf(env, CRM_COLLECTIONS.deals, ids('dealId'), (data)=>textOf(data['title'])) : empty,
+                    wants('lead') ? namesOf(env, 'leads', ids('leadId'), (data)=>textOf(data['email'])) : empty
+                ]);
+                return docs.map((doc)=>pickValues(activityTransferValues(doc.id, doc.data, {
+                        by: (uid)=>emails.get(uid),
+                        contact: (id)=>contacts.get(id) || undefined,
+                        company: (id)=>companies.get(id) || undefined,
+                        deal: (id)=>deals.get(id) || undefined,
+                        lead: (id)=>leads.get(id) || undefined
+                    }), fieldIds));
+            });
+        },
+        async lookup (ctx, requests) {
+            const env = await crmTransferEnv(ctx);
+            const found = {
+                lookup: new Map(),
+                docs: new Map()
+            };
+            for (const request of requests){
+                if (request.fieldId === TRANSFER_ID_FIELD) {
+                    await lookupById(env, activitiesOf(env), request, (data)=>visibleIn(env, data['visibleTo']), found);
+                }
+            }
+            return lookupResult(found, (id, data)=>activityTransferValues(id, data));
+        }
+    };
+}
+
+//# sourceMappingURL=activities.js.map