@aglyn/plugins-workflows 1.0.0-beta.221 → 1.0.0-beta.223

package/src/lib/testing/stand-in-crm-steps.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @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 ServerStepRequest } from '@aglyn/aglyn/plugin-manager/plugin-server-steps';
+/** The contact an event names, as the spec's own Firestore double holds it. */
+export interface CrmContactDouble {
+    id: string;
+    update(patch: Record<string, unknown>): Promise<unknown>;
+}
+/** Where the stand-in finds the person and which site facet it writes. */
+export interface CrmStepsDouble {
+    /** The contact the event names, or `null` for nobody the site can see. */
+    contact(request: ServerStepRequest): Promise<CrmContactDouble | null>;
+    /** The consent group whose facet the site writes. */
+    groupId: string;
+}
+/** The step types the CRM declares under `serverSteps`. */
+export declare const STAND_IN_CRM_STEP_TYPES: readonly ["setContactStage", "addContactTag", "assignContactOwner", "createCrmTask", "logCrmActivity"];
+/**
+ * The CRM steps the CRM runs for this engine (AGL-3080), stood in for this
+ * plugin's specs — this plugin may not load the CRM. Over the spec's own
+ * Firestore double it does what the owner's executor does for the shapes these
+ * specs store: it finds the contact the event names, writes a stage or a tag
+ * inside the site's facet, answers the run history's detail, and answers a
+ * stage that moved as the `contactStageChanged` event for the engine to raise.
+ * An owner, a task and an activity are answered by their detail alone.
+ *
+ * Owners, tasks, scopes, the plan gate and the activity ceiling are the CRM's
+ * own spec's (`automation-steps.spec.ts`), and the real pair runs together in
+ * `apps/console/specs/crm-automation-steps.spec.ts`.
+ */
+export declare function standInCrmSteps(double: CrmStepsDouble): () => void;

package/src/lib/testing/stand-in-crm-steps.js

@@ -0,0 +1,97 @@
+/**
+ * @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 { registerServerStepExecutor } from "@aglyn/aglyn/plugin-manager/plugin-server-steps";
+import { FieldValue } from "firebase-admin/firestore";
+/** The step types the CRM declares under `serverSteps`. */ export const STAND_IN_CRM_STEP_TYPES = [
+    'setContactStage',
+    'addContactTag',
+    'assignContactOwner',
+    'createCrmTask',
+    'logCrmActivity'
+];
+const capitalized = (word)=>word.charAt(0).toUpperCase() + word.slice(1);
+/**
+ * The CRM steps the CRM runs for this engine (AGL-3080), stood in for this
+ * plugin's specs — this plugin may not load the CRM. Over the spec's own
+ * Firestore double it does what the owner's executor does for the shapes these
+ * specs store: it finds the contact the event names, writes a stage or a tag
+ * inside the site's facet, answers the run history's detail, and answers a
+ * stage that moved as the `contactStageChanged` event for the engine to raise.
+ * An owner, a task and an activity are answered by their detail alone.
+ *
+ * Owners, tasks, scopes, the plan gate and the activity ceiling are the CRM's
+ * own spec's (`automation-steps.spec.ts`), and the real pair runs together in
+ * `apps/console/specs/crm-automation-steps.spec.ts`.
+ */ export function standInCrmSteps(double) {
+    return registerServerStepExecutor(STAND_IN_CRM_STEP_TYPES, async (request)=>{
+        var _step_title, _step_kind;
+        const step = request.step;
+        const contact = await double.contact(request);
+        if (!contact) {
+            var _ref, _request_payload_contactId;
+            const named = String((_ref = (_request_payload_contactId = request.payload['contactId']) != null ? _request_payload_contactId : request.payload['email']) != null ? _ref : '');
+            return {
+                error: `no contact or lead this site can see for ${named}`
+            };
+        }
+        const facet = (field)=>`facets.${double.groupId}.${field}`;
+        if (step.type === 'setContactStage') {
+            var _step_lifecycleStage;
+            const stage = String((_step_lifecycleStage = step['lifecycleStage']) != null ? _step_lifecycleStage : '');
+            await contact.update({
+                [facet('lifecycleStage')]: stage,
+                updatedAt: FieldValue.serverTimestamp()
+            });
+            return {
+                detail: capitalized(stage),
+                emit: {
+                    event: 'contactStageChanged',
+                    payload: {
+                        contactId: contact.id,
+                        lifecycleStage: stage
+                    }
+                }
+            };
+        }
+        if (step.type === 'addContactTag') {
+            var _step_tag;
+            const tag = String((_step_tag = step['tag']) != null ? _step_tag : '').trim();
+            await contact.update({
+                [facet('tags')]: FieldValue.arrayUnion(tag),
+                updatedAt: FieldValue.serverTimestamp()
+            });
+            return {
+                detail: tag
+            };
+        }
+        if (step.type === 'assignContactOwner') {
+            var _ref1, _step_ownerEmail;
+            return {
+                detail: step['roundRobin'] === true ? 'round robin' : String((_ref1 = (_step_ownerEmail = step['ownerEmail']) != null ? _step_ownerEmail : step['ownerUid']) != null ? _ref1 : '')
+            };
+        }
+        if (step.type === 'createCrmTask') return {
+            detail: String((_step_title = step['title']) != null ? _step_title : '').slice(0, 60)
+        };
+        return {
+            detail: String((_step_kind = step['kind']) != null ? _step_kind : '')
+        };
+    }, {
+        pluginId: 'crm'
+    });
+}
+
+//# sourceMappingURL=stand-in-crm-steps.js.map

package/src/lib/testing/stand-in-crm-steps.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/workflows/src/lib/testing/stand-in-crm-steps.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  registerServerStepExecutor,\n  type ServerStepRequest,\n} from '@aglyn/aglyn/plugin-manager/plugin-server-steps'\nimport { FieldValue } from 'firebase-admin/firestore'\n\n/** The contact an event names, as the spec's own Firestore double holds it. */\nexport interface CrmContactDouble {\n  id: string\n  update(patch: Record<string, unknown>): Promise<unknown>\n}\n\n/** Where the stand-in finds the person and which site facet it writes. */\nexport interface CrmStepsDouble {\n  /** The contact the event names, or `null` for nobody the site can see. */\n  contact(request: ServerStepRequest): Promise<CrmContactDouble | null>\n  /** The consent group whose facet the site writes. */\n  groupId: string\n}\n\n/** The step types the CRM declares under `serverSteps`. */\nexport const STAND_IN_CRM_STEP_TYPES = [\n  'setContactStage',\n  'addContactTag',\n  'assignContactOwner',\n  'createCrmTask',\n  'logCrmActivity',\n] as const\n\nconst capitalized = (word: string) => word.charAt(0).toUpperCase() + word.slice(1)\n\n/**\n * The CRM steps the CRM runs for this engine (AGL-3080), stood in for this\n * plugin's specs — this plugin may not load the CRM. Over the spec's own\n * Firestore double it does what the owner's executor does for the shapes these\n * specs store: it finds the contact the event names, writes a stage or a tag\n * inside the site's facet, answers the run history's detail, and answers a\n * stage that moved as the `contactStageChanged` event for the engine to raise.\n * An owner, a task and an activity are answered by their detail alone.\n *\n * Owners, tasks, scopes, the plan gate and the activity ceiling are the CRM's\n * own spec's (`automation-steps.spec.ts`), and the real pair runs together in\n * `apps/console/specs/crm-automation-steps.spec.ts`.\n */\nexport function standInCrmSteps(double: CrmStepsDouble): () => void {\n  return registerServerStepExecutor(\n    STAND_IN_CRM_STEP_TYPES,\n    async (request) => {\n      const step = request.step as Record<string, unknown> & { type: string }\n      const contact = await double.contact(request)\n      if (!contact) {\n        const named = String(request.payload['contactId'] ?? request.payload['email'] ?? '')\n        return { error: `no contact or lead this site can see for ${named}` }\n      }\n      const facet = (field: string) => `facets.${double.groupId}.${field}`\n      if (step.type === 'setContactStage') {\n        const stage = String(step['lifecycleStage'] ?? '')\n        await contact.update({\n          [facet('lifecycleStage')]: stage,\n          updatedAt: FieldValue.serverTimestamp(),\n        })\n        return {\n          detail: capitalized(stage),\n          emit: {\n            event: 'contactStageChanged',\n            payload: { contactId: contact.id, lifecycleStage: stage },\n          },\n        }\n      }\n      if (step.type === 'addContactTag') {\n        const tag = String(step['tag'] ?? '').trim()\n        await contact.update({\n          [facet('tags')]: FieldValue.arrayUnion(tag),\n          updatedAt: FieldValue.serverTimestamp(),\n        })\n        return { detail: tag }\n      }\n      if (step.type === 'assignContactOwner') {\n        return { detail: step['roundRobin'] === true ? 'round robin' : String(step['ownerEmail'] ?? step['ownerUid'] ?? '') }\n      }\n      if (step.type === 'createCrmTask') return { detail: String(step['title'] ?? '').slice(0, 60) }\n      return { detail: String(step['kind'] ?? '') }\n    },\n    { pluginId: 'crm' },\n  )\n}\n"],"names":["registerServerStepExecutor","FieldValue","STAND_IN_CRM_STEP_TYPES","capitalized","word","charAt","toUpperCase","slice","standInCrmSteps","double","request","step","contact","named","String","payload","error","facet","field","groupId","type","stage","update","updatedAt","serverTimestamp","detail","emit","event","contactId","id","lifecycleStage","tag","trim","arrayUnion","pluginId"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,0BAA0B,QAErB,kDAAiD;AACxD,SAASC,UAAU,QAAQ,2BAA0B;AAgBrD,yDAAyD,GACzD,OAAO,MAAMC,0BAA0B;IACrC;IACA;IACA;IACA;IACA;CACD,CAAS;AAEV,MAAMC,cAAc,CAACC,OAAiBA,KAAKC,MAAM,CAAC,GAAGC,WAAW,KAAKF,KAAKG,KAAK,CAAC;AAEhF;;;;;;;;;;;;CAYC,GACD,OAAO,SAASC,gBAAgBC,MAAsB;IACpD,OAAOT,2BACLE,yBACA,OAAOQ;YAiCsDC,aACnCA;QAjCxB,MAAMA,OAAOD,QAAQC,IAAI;QACzB,MAAMC,UAAU,MAAMH,OAAOG,OAAO,CAACF;QACrC,IAAI,CAACE,SAAS;gBACSF,MAAAA;YAArB,MAAMG,QAAQC,QAAOJ,QAAAA,6BAAAA,QAAQK,OAAO,CAAC,YAAY,YAA5BL,6BAAgCA,QAAQK,OAAO,CAAC,QAAQ,YAAxDL,OAA4D;YACjF,OAAO;gBAAEM,OAAO,CAAC,yCAAyC,EAAEH,OAAO;YAAC;QACtE;QACA,MAAMI,QAAQ,CAACC,QAAkB,CAAC,OAAO,EAAET,OAAOU,OAAO,CAAC,CAAC,EAAED,OAAO;QACpE,IAAIP,KAAKS,IAAI,KAAK,mBAAmB;gBACdT;YAArB,MAAMU,QAAQP,QAAOH,uBAAAA,IAAI,CAAC,iBAAiB,YAAtBA,uBAA0B;YAC/C,MAAMC,QAAQU,MAAM,CAAC;gBACnB,CAACL,MAAM,kBAAkB,EAAEI;gBAC3BE,WAAWtB,WAAWuB,eAAe;YACvC;YACA,OAAO;gBACLC,QAAQtB,YAAYkB;gBACpBK,MAAM;oBACJC,OAAO;oBACPZ,SAAS;wBAAEa,WAAWhB,QAAQiB,EAAE;wBAAEC,gBAAgBT;oBAAM;gBAC1D;YACF;QACF;QACA,IAAIV,KAAKS,IAAI,KAAK,iBAAiB;gBACdT;YAAnB,MAAMoB,MAAMjB,QAAOH,YAAAA,IAAI,CAAC,MAAM,YAAXA,YAAe,IAAIqB,IAAI;YAC1C,MAAMpB,QAAQU,MAAM,CAAC;gBACnB,CAACL,MAAM,QAAQ,EAAEhB,WAAWgC,UAAU,CAACF;gBACvCR,WAAWtB,WAAWuB,eAAe;YACvC;YACA,OAAO;gBAAEC,QAAQM;YAAI;QACvB;QACA,IAAIpB,KAAKS,IAAI,KAAK,sBAAsB;gBACgCT,OAAAA;YAAtE,OAAO;gBAAEc,QAAQd,IAAI,CAAC,aAAa,KAAK,OAAO,gBAAgBG,QAAOH,SAAAA,mBAAAA,IAAI,CAAC,aAAa,YAAlBA,mBAAsBA,IAAI,CAAC,WAAW,YAAtCA,QAA0C;YAAI;QACtH;QACA,IAAIA,KAAKS,IAAI,KAAK,iBAAiB,OAAO;YAAEK,QAAQX,QAAOH,cAAAA,IAAI,CAAC,QAAQ,YAAbA,cAAiB,IAAIJ,KAAK,CAAC,GAAG;QAAI;QAC7F,OAAO;YAAEkB,QAAQX,QAAOH,aAAAA,IAAI,CAAC,OAAO,YAAZA,aAAgB;QAAI;IAC9C,GACA;QAAEuB,UAAU;IAAM;AAEtB"}

package/src/lib/testing/stand-in-dataset-list.js

@@ -13,11 +13,19 @@
  * 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 { datasetDisplayName } from "@aglyn/aglyn/app-utils/datasets";
-import { scopeTokensForHost } from "@aglyn/aglyn/app-utils/scope-tokens";
+ */ import { scopeTokensForHost } from "@aglyn/aglyn/app-utils/scope-tokens";
 import { registerPluginRecordListSource } from "@aglyn/aglyn/plugin-manager/plugin-record-lists";
 import { unregisterPluginServices } from "@aglyn/aglyn/plugin-manager/plugin-services";
 import { collection, documentId, limit, orderBy, query, where } from "firebase/firestore";
+/** A dataset's name as the Data page shows it: its display name, else its legacy name. */ function datasetName(data) {
+    for (const candidate of [
+        data['displayName'],
+        data['name']
+    ]){
+        if (typeof candidate === 'string' && candidate.trim()) return candidate.trim();
+    }
+    return '';
+}
 /**
  * The `dataset` list source the plugin that keeps the workspace's datasets
  * publishes (AGL-3080), stood in for this plugin's specs — this plugin may
@@ -37,7 +45,7 @@ import { collection, documentId, limit, orderBy, query, where } from "firebase/f
             if (!data || data['deletedAt'] != null) return null;
             return {
                 id,
-                name: datasetDisplayName(data) || id,
+                name: datasetName(data) || id,
                 facts: {
                     fields: [],
                     visibleTo: Array.isArray(data['visibleTo']) ? data['visibleTo'] : []

package/src/lib/testing/stand-in-dataset-list.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/workflows/src/lib/testing/stand-in-dataset-list.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 { datasetDisplayName } from '@aglyn/aglyn/app-utils/datasets'\nimport { scopeTokensForHost } from '@aglyn/aglyn/app-utils/scope-tokens'\nimport { registerPluginRecordListSource } from '@aglyn/aglyn/plugin-manager/plugin-record-lists'\nimport { unregisterPluginServices } from '@aglyn/aglyn/plugin-manager/plugin-services'\nimport { collection, documentId, limit, orderBy, query, where } from 'firebase/firestore'\n\n/**\n * The `dataset` list source the plugin that keeps the workspace's datasets\n * publishes (AGL-3080), stood in for this plugin's specs — this plugin may\n * not load the data plugin. It builds the query that plugin's\n * `dataset-record-list.ts` builds (a site's answer narrowed by its scope\n * tokens, ordered by document id) from whatever `firebase/firestore` the spec\n * stages, and reads a row as a live dataset named as the Data page names it.\n * What the data plugin itself answers is held in its own spec.\n */\nexport function standInDatasetList(): void {\n  registerPluginRecordListSource(\n    'dataset',\n    {\n      query(firestore, request) {\n        if (!request.orgId) return null\n        const datasets = collection(firestore, 'orgs', request.orgId, 'datasets')\n        return request.hostId\n          ? query(\n              datasets,\n              where('visibleTo', 'array-contains-any', scopeTokensForHost(request.hostId)),\n              orderBy(documentId()),\n              limit(request.limit),\n            )\n          : query(datasets, orderBy(documentId()), limit(request.limit))\n      },\n      record(id, data) {\n        if (!data || data['deletedAt'] != null) return null\n        return {\n          id,\n          name: datasetDisplayName(data) || id,\n          facts: { fields: [], visibleTo: Array.isArray(data['visibleTo']) ? data['visibleTo'] : [] },\n        }\n      },\n    },\n    { pluginId: 'data' },\n  )\n}\n\n/** Forgets it, so a spec can ask what happens where no plugin keeps datasets. */\nexport function removeStandInDatasetList(): void {\n  unregisterPluginServices('data')\n}\n"],"names":["datasetDisplayName","scopeTokensForHost","registerPluginRecordListSource","unregisterPluginServices","collection","documentId","limit","orderBy","query","where","standInDatasetList","firestore","request","orgId","datasets","hostId","record","id","data","name","facts","fields","visibleTo","Array","isArray","pluginId","removeStandInDatasetList"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,kBAAkB,QAAQ,kCAAiC;AACpE,SAASC,kBAAkB,QAAQ,sCAAqC;AACxE,SAASC,8BAA8B,QAAQ,kDAAiD;AAChG,SAASC,wBAAwB,QAAQ,8CAA6C;AACtF,SAASC,UAAU,EAAEC,UAAU,EAAEC,KAAK,EAAEC,OAAO,EAAEC,KAAK,EAAEC,KAAK,QAAQ,qBAAoB;AAEzF;;;;;;;;CAQC,GACD,OAAO,SAASC;IACdR,+BACE,WACA;QACEM,OAAMG,SAAS,EAAEC,OAAO;YACtB,IAAI,CAACA,QAAQC,KAAK,EAAE,OAAO;YAC3B,MAAMC,WAAWV,WAAWO,WAAW,QAAQC,QAAQC,KAAK,EAAE;YAC9D,OAAOD,QAAQG,MAAM,GACjBP,MACEM,UACAL,MAAM,aAAa,sBAAsBR,mBAAmBW,QAAQG,MAAM,IAC1ER,QAAQF,eACRC,MAAMM,QAAQN,KAAK,KAErBE,MAAMM,UAAUP,QAAQF,eAAeC,MAAMM,QAAQN,KAAK;QAChE;QACAU,QAAOC,EAAE,EAAEC,IAAI;YACb,IAAI,CAACA,QAAQA,IAAI,CAAC,YAAY,IAAI,MAAM,OAAO;YAC/C,OAAO;gBACLD;gBACAE,MAAMnB,mBAAmBkB,SAASD;gBAClCG,OAAO;oBAAEC,QAAQ,EAAE;oBAAEC,WAAWC,MAAMC,OAAO,CAACN,IAAI,CAAC,YAAY,IAAIA,IAAI,CAAC,YAAY,GAAG,EAAE;gBAAC;YAC5F;QACF;IACF,GACA;QAAEO,UAAU;IAAO;AAEvB;AAEA,+EAA+E,GAC/E,OAAO,SAASC;IACdvB,yBAAyB;AAC3B"}
+{"version":3,"sources":["../../../../../../../libs/plugins/workflows/src/lib/testing/stand-in-dataset-list.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 { scopeTokensForHost } from '@aglyn/aglyn/app-utils/scope-tokens'\nimport { registerPluginRecordListSource } from '@aglyn/aglyn/plugin-manager/plugin-record-lists'\nimport { unregisterPluginServices } from '@aglyn/aglyn/plugin-manager/plugin-services'\nimport { collection, documentId, limit, orderBy, query, where } from 'firebase/firestore'\n\n/** A dataset's name as the Data page shows it: its display name, else its legacy name. */\nfunction datasetName(data: Readonly<Record<string, unknown>>): string {\n  for (const candidate of [data['displayName'], data['name']]) {\n    if (typeof candidate === 'string' && candidate.trim()) return candidate.trim()\n  }\n  return ''\n}\n\n/**\n * The `dataset` list source the plugin that keeps the workspace's datasets\n * publishes (AGL-3080), stood in for this plugin's specs — this plugin may\n * not load the data plugin. It builds the query that plugin's\n * `dataset-record-list.ts` builds (a site's answer narrowed by its scope\n * tokens, ordered by document id) from whatever `firebase/firestore` the spec\n * stages, and reads a row as a live dataset named as the Data page names it.\n * What the data plugin itself answers is held in its own spec.\n */\nexport function standInDatasetList(): void {\n  registerPluginRecordListSource(\n    'dataset',\n    {\n      query(firestore, request) {\n        if (!request.orgId) return null\n        const datasets = collection(firestore, 'orgs', request.orgId, 'datasets')\n        return request.hostId\n          ? query(\n              datasets,\n              where('visibleTo', 'array-contains-any', scopeTokensForHost(request.hostId)),\n              orderBy(documentId()),\n              limit(request.limit),\n            )\n          : query(datasets, orderBy(documentId()), limit(request.limit))\n      },\n      record(id, data) {\n        if (!data || data['deletedAt'] != null) return null\n        return {\n          id,\n          name: datasetName(data) || id,\n          facts: { fields: [], visibleTo: Array.isArray(data['visibleTo']) ? data['visibleTo'] : [] },\n        }\n      },\n    },\n    { pluginId: 'data' },\n  )\n}\n\n/** Forgets it, so a spec can ask what happens where no plugin keeps datasets. */\nexport function removeStandInDatasetList(): void {\n  unregisterPluginServices('data')\n}\n"],"names":["scopeTokensForHost","registerPluginRecordListSource","unregisterPluginServices","collection","documentId","limit","orderBy","query","where","datasetName","data","candidate","trim","standInDatasetList","firestore","request","orgId","datasets","hostId","record","id","name","facts","fields","visibleTo","Array","isArray","pluginId","removeStandInDatasetList"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,kBAAkB,QAAQ,sCAAqC;AACxE,SAASC,8BAA8B,QAAQ,kDAAiD;AAChG,SAASC,wBAAwB,QAAQ,8CAA6C;AACtF,SAASC,UAAU,EAAEC,UAAU,EAAEC,KAAK,EAAEC,OAAO,EAAEC,KAAK,EAAEC,KAAK,QAAQ,qBAAoB;AAEzF,wFAAwF,GACxF,SAASC,YAAYC,IAAuC;IAC1D,KAAK,MAAMC,aAAa;QAACD,IAAI,CAAC,cAAc;QAAEA,IAAI,CAAC,OAAO;KAAC,CAAE;QAC3D,IAAI,OAAOC,cAAc,YAAYA,UAAUC,IAAI,IAAI,OAAOD,UAAUC,IAAI;IAC9E;IACA,OAAO;AACT;AAEA;;;;;;;;CAQC,GACD,OAAO,SAASC;IACdZ,+BACE,WACA;QACEM,OAAMO,SAAS,EAAEC,OAAO;YACtB,IAAI,CAACA,QAAQC,KAAK,EAAE,OAAO;YAC3B,MAAMC,WAAWd,WAAWW,WAAW,QAAQC,QAAQC,KAAK,EAAE;YAC9D,OAAOD,QAAQG,MAAM,GACjBX,MACEU,UACAT,MAAM,aAAa,sBAAsBR,mBAAmBe,QAAQG,MAAM,IAC1EZ,QAAQF,eACRC,MAAMU,QAAQV,KAAK,KAErBE,MAAMU,UAAUX,QAAQF,eAAeC,MAAMU,QAAQV,KAAK;QAChE;QACAc,QAAOC,EAAE,EAAEV,IAAI;YACb,IAAI,CAACA,QAAQA,IAAI,CAAC,YAAY,IAAI,MAAM,OAAO;YAC/C,OAAO;gBACLU;gBACAC,MAAMZ,YAAYC,SAASU;gBAC3BE,OAAO;oBAAEC,QAAQ,EAAE;oBAAEC,WAAWC,MAAMC,OAAO,CAAChB,IAAI,CAAC,YAAY,IAAIA,IAAI,CAAC,YAAY,GAAG,EAAE;gBAAC;YAC5F;QACF;IACF,GACA;QAAEiB,UAAU;IAAO;AAEvB;AAEA,+EAA+E,GAC/E,OAAO,SAASC;IACd1B,yBAAyB;AAC3B"}

package/src/lib/testing/stand-in-dataset-steps.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @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 ServerStepRequest } from '@aglyn/aglyn/plugin-manager/plugin-server-steps';
+/** The dataset a step names, as the spec's own Firestore double holds it. */
+interface DatasetDouble {
+    exists: boolean;
+    get(field: string): unknown;
+}
+/** Where the stand-in reads a dataset and writes its records: the spec's own double. */
+export interface DatasetStepsDouble {
+    dataset(request: ServerStepRequest, datasetId: string): Promise<DatasetDouble>;
+    append(request: ServerStepRequest, datasetId: string, record: {
+        values: Record<string, string>;
+    }): Promise<unknown>;
+}
+/**
+ * The dataset steps the data plugin runs for this engine (AGL-3080), stood in
+ * for this plugin's specs — this plugin may not load the data plugin. Over the
+ * spec's own Firestore double it does what the owner's executor does for the
+ * shapes these specs store: it finds the dataset the step names by id, writes
+ * the event's fields the dataset has as text, and answers the dataset's name
+ * as the run's detail — or the owner's words for a dataset it cannot find, or
+ * for an event with no field the dataset has. Models, caps, merges and the
+ * live-page refresh are the data plugin's own spec's
+ * (`dataset-steps.server.spec.ts`), and the real pair runs together in
+ * `apps/console/specs/dataset-automation-steps.spec.ts`.
+ */
+export declare function standInDatasetSteps(double: DatasetStepsDouble): () => void;
+export {};

package/src/lib/testing/stand-in-dataset-steps.js

@@ -0,0 +1,65 @@
+/**
+ * @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 { registerServerStepExecutor } from "@aglyn/aglyn/plugin-manager/plugin-server-steps";
+/**
+ * The dataset steps the data plugin runs for this engine (AGL-3080), stood in
+ * for this plugin's specs — this plugin may not load the data plugin. Over the
+ * spec's own Firestore double it does what the owner's executor does for the
+ * shapes these specs store: it finds the dataset the step names by id, writes
+ * the event's fields the dataset has as text, and answers the dataset's name
+ * as the run's detail — or the owner's words for a dataset it cannot find, or
+ * for an event with no field the dataset has. Models, caps, merges and the
+ * live-page refresh are the data plugin's own spec's
+ * (`dataset-steps.server.spec.ts`), and the real pair runs together in
+ * `apps/console/specs/dataset-automation-steps.spec.ts`.
+ */ export function standInDatasetSteps(double) {
+    return registerServerStepExecutor([
+        'datasetAppend',
+        'updateDataset'
+    ], async (request)=>{
+        var _step_datasetId, _ref, _dataset_get, _dataset_get1;
+        const step = request.step;
+        const datasetId = String((_step_datasetId = step.datasetId) != null ? _step_datasetId : '');
+        const dataset = await double.dataset(request, datasetId);
+        if (!dataset.exists || dataset.get('deletedAt')) {
+            return {
+                error: `unknown dataset "${step.datasetName || step.datasetId}"`
+            };
+        }
+        const label = String((_ref = (_dataset_get = dataset.get('displayName')) != null ? _dataset_get : step.datasetName) != null ? _ref : '');
+        const fields = (_dataset_get1 = dataset.get('fields')) != null ? _dataset_get1 : [];
+        const values = {};
+        for (const field of fields){
+            const value = request.payload[field];
+            if (value != null && String(value) !== '') values[field] = String(value);
+        }
+        if (!Object.keys(values).length) {
+            return {
+                error: `no event field matches a field in dataset "${label}"`
+            };
+        }
+        await double.append(request, datasetId, {
+            values
+        });
+        return step.type === 'datasetAppend' ? {
+            detail: label
+        } : {};
+    }, {
+        pluginId: 'data'
+    });
+}
+
+//# sourceMappingURL=stand-in-dataset-steps.js.map

package/src/lib/testing/stand-in-dataset-steps.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/workflows/src/lib/testing/stand-in-dataset-steps.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  registerServerStepExecutor,\n  type ServerStepRequest,\n} from '@aglyn/aglyn/plugin-manager/plugin-server-steps'\n\n/** The dataset a step names, as the spec's own Firestore double holds it. */\ninterface DatasetDouble {\n  exists: boolean\n  get(field: string): unknown\n}\n\n/** Where the stand-in reads a dataset and writes its records: the spec's own double. */\nexport interface DatasetStepsDouble {\n  dataset(request: ServerStepRequest, datasetId: string): Promise<DatasetDouble>\n  append(request: ServerStepRequest, datasetId: string, record: { values: Record<string, string> }): Promise<unknown>\n}\n\n/**\n * The dataset steps the data plugin runs for this engine (AGL-3080), stood in\n * for this plugin's specs — this plugin may not load the data plugin. Over the\n * spec's own Firestore double it does what the owner's executor does for the\n * shapes these specs store: it finds the dataset the step names by id, writes\n * the event's fields the dataset has as text, and answers the dataset's name\n * as the run's detail — or the owner's words for a dataset it cannot find, or\n * for an event with no field the dataset has. Models, caps, merges and the\n * live-page refresh are the data plugin's own spec's\n * (`dataset-steps.server.spec.ts`), and the real pair runs together in\n * `apps/console/specs/dataset-automation-steps.spec.ts`.\n */\nexport function standInDatasetSteps(double: DatasetStepsDouble): () => void {\n  return registerServerStepExecutor(\n    ['datasetAppend', 'updateDataset'],\n    async (request) => {\n      const step = request.step as { type: string; datasetId?: string; datasetName?: string }\n      const datasetId = String(step.datasetId ?? '')\n      const dataset = await double.dataset(request, datasetId)\n      if (!dataset.exists || dataset.get('deletedAt')) {\n        return { error: `unknown dataset \"${step.datasetName || step.datasetId}\"` }\n      }\n      const label = String(dataset.get('displayName') ?? step.datasetName ?? '')\n      const fields = (dataset.get('fields') as string[] | undefined) ?? []\n      const values: Record<string, string> = {}\n      for (const field of fields) {\n        const value = request.payload[field]\n        if (value != null && String(value) !== '') values[field] = String(value)\n      }\n      if (!Object.keys(values).length) {\n        return { error: `no event field matches a field in dataset \"${label}\"` }\n      }\n      await double.append(request, datasetId, { values })\n      return step.type === 'datasetAppend' ? { detail: label } : {}\n    },\n    { pluginId: 'data' },\n  )\n}\n"],"names":["registerServerStepExecutor","standInDatasetSteps","double","request","step","dataset","datasetId","String","exists","get","error","datasetName","label","fields","values","field","value","payload","Object","keys","length","append","type","detail","pluginId"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,0BAA0B,QAErB,kDAAiD;AAcxD;;;;;;;;;;;CAWC,GACD,OAAO,SAASC,oBAAoBC,MAA0B;IAC5D,OAAOF,2BACL;QAAC;QAAiB;KAAgB,EAClC,OAAOG;YAEoBC,iBAKJC,MAAAA,cACLA;QAPhB,MAAMD,OAAOD,QAAQC,IAAI;QACzB,MAAME,YAAYC,QAAOH,kBAAAA,KAAKE,SAAS,YAAdF,kBAAkB;QAC3C,MAAMC,UAAU,MAAMH,OAAOG,OAAO,CAACF,SAASG;QAC9C,IAAI,CAACD,QAAQG,MAAM,IAAIH,QAAQI,GAAG,CAAC,cAAc;YAC/C,OAAO;gBAAEC,OAAO,CAAC,iBAAiB,EAAEN,KAAKO,WAAW,IAAIP,KAAKE,SAAS,CAAC,CAAC,CAAC;YAAC;QAC5E;QACA,MAAMM,QAAQL,QAAOF,QAAAA,eAAAA,QAAQI,GAAG,CAAC,0BAAZJ,eAA8BD,KAAKO,WAAW,YAA9CN,OAAkD;QACvE,MAAMQ,UAAUR,gBAAAA,QAAQI,GAAG,CAAC,qBAAZJ,gBAAkD,EAAE;QACpE,MAAMS,SAAiC,CAAC;QACxC,KAAK,MAAMC,SAASF,OAAQ;YAC1B,MAAMG,QAAQb,QAAQc,OAAO,CAACF,MAAM;YACpC,IAAIC,SAAS,QAAQT,OAAOS,WAAW,IAAIF,MAAM,CAACC,MAAM,GAAGR,OAAOS;QACpE;QACA,IAAI,CAACE,OAAOC,IAAI,CAACL,QAAQM,MAAM,EAAE;YAC/B,OAAO;gBAAEV,OAAO,CAAC,2CAA2C,EAAEE,MAAM,CAAC,CAAC;YAAC;QACzE;QACA,MAAMV,OAAOmB,MAAM,CAAClB,SAASG,WAAW;YAAEQ;QAAO;QACjD,OAAOV,KAAKkB,IAAI,KAAK,kBAAkB;YAAEC,QAAQX;QAAM,IAAI,CAAC;IAC9D,GACA;QAAEY,UAAU;IAAO;AAEvB"}

package/src/lib/testing/stand-in-person-records.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @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 PluginPersonFileRequest, type PluginPersonFindRequest, type PluginPersonRecord } from '@aglyn/aglyn/plugin-manager/plugin-person-records';
+/**
+ * A plugin that keeps people, standing in for the one that does (AGL-3080).
+ *
+ * An automation asks for the person an event names, and files them under a
+ * campaign, through `plugin-person-records` and imports no record system, so
+ * its specs stand an owner up the way the loader would. One plugin may not
+ * import another, which is why this is here rather than borrowed from the CRM.
+ *
+ * `find` is the spec's: it answers from the spec's own fixture. Every filing
+ * is recorded as asked, so a spec asserts what the step REPORTED; what a
+ * filing writes on the person is held by the CRM's `person-records.spec.ts`.
+ */
+export declare function standInPersonRecords(options: {
+    find: (request: PluginPersonFindRequest) => PluginPersonRecord | null;
+}): {
+    asked: PluginPersonFindRequest[];
+    filings: PluginPersonFileRequest[];
+};

package/src/lib/testing/stand-in-person-records.js

@@ -0,0 +1,54 @@
+/**
+ * @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 { registerPluginPersonRecords } from "@aglyn/aglyn/plugin-manager/plugin-person-records";
+/**
+ * A plugin that keeps people, standing in for the one that does (AGL-3080).
+ *
+ * An automation asks for the person an event names, and files them under a
+ * campaign, through `plugin-person-records` and imports no record system, so
+ * its specs stand an owner up the way the loader would. One plugin may not
+ * import another, which is why this is here rather than borrowed from the CRM.
+ *
+ * `find` is the spec's: it answers from the spec's own fixture. Every filing
+ * is recorded as asked, so a spec asserts what the step REPORTED; what a
+ * filing writes on the person is held by the CRM's `person-records.spec.ts`.
+ */ export function standInPersonRecords(options) {
+    const asked = [];
+    const filings = [];
+    registerPluginPersonRecords({
+        async find (request) {
+            asked.push(request);
+            return options.find(request);
+        },
+        async read (request) {
+            return request.records.map(()=>null);
+        },
+        async fileUnder (request) {
+            filings.push(request);
+            return {
+                filed: true
+            };
+        }
+    }, {
+        pluginId: 'record-system'
+    });
+    return {
+        asked,
+        filings
+    };
+}
+
+//# sourceMappingURL=stand-in-person-records.js.map

package/src/lib/testing/stand-in-person-records.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/workflows/src/lib/testing/stand-in-person-records.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  registerPluginPersonRecords,\n  type PluginPersonFileRequest,\n  type PluginPersonFindRequest,\n  type PluginPersonRecord,\n} from '@aglyn/aglyn/plugin-manager/plugin-person-records'\n\n/**\n * A plugin that keeps people, standing in for the one that does (AGL-3080).\n *\n * An automation asks for the person an event names, and files them under a\n * campaign, through `plugin-person-records` and imports no record system, so\n * its specs stand an owner up the way the loader would. One plugin may not\n * import another, which is why this is here rather than borrowed from the CRM.\n *\n * `find` is the spec's: it answers from the spec's own fixture. Every filing\n * is recorded as asked, so a spec asserts what the step REPORTED; what a\n * filing writes on the person is held by the CRM's `person-records.spec.ts`.\n */\nexport function standInPersonRecords(options: {\n  find: (request: PluginPersonFindRequest) => PluginPersonRecord | null\n}): { asked: PluginPersonFindRequest[]; filings: PluginPersonFileRequest[] } {\n  const asked: PluginPersonFindRequest[] = []\n  const filings: PluginPersonFileRequest[] = []\n  registerPluginPersonRecords(\n    {\n      async find(request) {\n        asked.push(request)\n        return options.find(request)\n      },\n      async read(request) {\n        return request.records.map(() => null)\n      },\n      async fileUnder(request) {\n        filings.push(request)\n        return { filed: true }\n      },\n    },\n    { pluginId: 'record-system' },\n  )\n  return { asked, filings }\n}\n"],"names":["registerPluginPersonRecords","standInPersonRecords","options","asked","filings","find","request","push","read","records","map","fileUnder","filed","pluginId"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,2BAA2B,QAItB,oDAAmD;AAE1D;;;;;;;;;;;CAWC,GACD,OAAO,SAASC,qBAAqBC,OAEpC;IACC,MAAMC,QAAmC,EAAE;IAC3C,MAAMC,UAAqC,EAAE;IAC7CJ,4BACE;QACE,MAAMK,MAAKC,OAAO;YAChBH,MAAMI,IAAI,CAACD;YACX,OAAOJ,QAAQG,IAAI,CAACC;QACtB;QACA,MAAME,MAAKF,OAAO;YAChB,OAAOA,QAAQG,OAAO,CAACC,GAAG,CAAC,IAAM;QACnC;QACA,MAAMC,WAAUL,OAAO;YACrBF,QAAQG,IAAI,CAACD;YACb,OAAO;gBAAEM,OAAO;YAAK;QACvB;IACF,GACA;QAAEC,UAAU;IAAgB;IAE9B,OAAO;QAAEV;QAAOC;IAAQ;AAC1B"}

package/src/lib/testing/stand-in-recipes.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @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 InteractionRecipe } from '@aglyn/aglyn/plugin-manager/interaction-recipes';
+/**
+ * The CRM's four recipes (AGL-2626), stood in for this plugin's specs — this
+ * plugin may not load the CRM, which writes them and registers them through
+ * the platform's recipe seam (AGL-3080). Built as the CRM builds them, so the
+ * editor is driven with the automations it is really handed; what the CRM's
+ * recipes ARE is held in the CRM's own spec, and that each is an automation
+ * this plugin accepts in `apps/console/specs/interaction-recipes.spec.ts`.
+ */
+export declare const STAND_IN_RECIPES: readonly InteractionRecipe[];
+/** Registers the stood-in recipes as the CRM's declarations would. */
+export declare function standInRecipes(): void;
+/**
+ * The `form` list source the Forms plugin publishes (AGL-3080), stood in: a
+ * site's forms by document id, an archived one left out, a form named by its
+ * display name or its id, and whether it files leads shared as its
+ * `routesLeads` fact. What the Forms plugin itself answers is held in its own
+ * spec.
+ */
+export declare function standInFormList(): void;