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

package/src/lib/testing/stand-in-recipes.js

@@ -0,0 +1,206 @@
+/**
+ * @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 { registerInteractionRecipes } from "@aglyn/aglyn/plugin-manager/interaction-recipes";
+import { registerPluginRecordListSource } from "@aglyn/aglyn/plugin-manager/plugin-record-lists";
+import { collection, documentId, limit, orderBy, query } from "firebase/firestore";
+/**
+ * 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 const STAND_IN_RECIPES = [
+    {
+        id: 'welcomeNewLead',
+        title: 'Welcome a new lead',
+        description: 'When a form makes a new lead: rotate in an owner, book a call for ' + 'tomorrow, send a thank-you, and tag them website.',
+        build: ()=>({
+                recipe: 'welcomeNewLead',
+                name: 'Welcome a new lead',
+                trigger: {
+                    event: 'lead',
+                    conditions: [
+                        {
+                            field: 'formId',
+                            op: 'notEmpty'
+                        }
+                    ],
+                    combinator: 'and'
+                },
+                steps: [
+                    {
+                        type: 'assignContactOwner',
+                        roundRobin: true
+                    },
+                    {
+                        type: 'createCrmTask',
+                        title: 'Call the new lead',
+                        kind: 'call',
+                        dueInDays: 1
+                    },
+                    {
+                        type: 'sendEmail',
+                        subject: 'Thanks for getting in touch',
+                        body: 'Hi {{firstName|there}},\n\nThanks for reaching out. We have your ' + 'message and will reply to this email address.'
+                    },
+                    {
+                        type: 'addContactTag',
+                        tag: 'website'
+                    }
+                ],
+                enabled: true
+            })
+    },
+    {
+        id: 'followUpWonDeal',
+        title: 'Follow up a won deal',
+        description: 'When a deal is won — which makes the contact a Customer on its own — ' + 'book a check-in call a week out.',
+        build: ()=>({
+                recipe: 'followUpWonDeal',
+                name: 'Follow up a won deal',
+                trigger: {
+                    event: 'dealWon'
+                },
+                steps: [
+                    {
+                        type: 'createCrmTask',
+                        title: 'Check in with the new customer',
+                        kind: 'call',
+                        dueInDays: 7
+                    }
+                ],
+                enabled: true
+            })
+    },
+    {
+        id: 'reengageStaleLead',
+        title: 'Re-engage a stale lead',
+        description: 'When a contact becomes a lead: wait a week, and if their stage has ' + 'not moved, book a call to bring them back.',
+        build: ()=>({
+                recipe: 'reengageStaleLead',
+                name: 'Re-engage a stale lead',
+                trigger: {
+                    event: 'contactStageChanged',
+                    conditions: [
+                        {
+                            field: 'lifecycleStage',
+                            op: 'equals',
+                            value: 'lead'
+                        }
+                    ],
+                    combinator: 'and'
+                },
+                steps: [
+                    {
+                        type: 'waitForEvent',
+                        eventName: 'contactStageChanged',
+                        timeoutMinutes: 7 * 24 * 60
+                    },
+                    {
+                        type: 'createCrmTask',
+                        title: 'Re-engage a lead that has gone quiet',
+                        kind: 'call',
+                        dueInDays: 1,
+                        when: {
+                            conditions: [
+                                {
+                                    field: '_waitTimedOut',
+                                    op: 'notEmpty'
+                                }
+                            ]
+                        }
+                    }
+                ],
+                enabled: true
+            })
+    },
+    {
+        id: 'tagByForm',
+        title: 'Tag by form',
+        description: 'When a form you pick makes a new lead or contact: tag them with the form’s name.',
+        picks: {
+            kind: 'form',
+            label: 'Form',
+            plural: 'forms',
+            prompt: 'Pick the form whose new leads or contacts get the tag.',
+            none: 'This site has no forms yet. Add one in the besigner, then come back.'
+        },
+        build: (input)=>{
+            var _ref;
+            var _form_facts;
+            const form = input == null ? void 0 : input.picked;
+            return {
+                recipe: 'tagByForm',
+                name: form ? `Tag ${form.name.trim()} submissions` : 'Tag by form',
+                trigger: {
+                    // A lead-routed form makes a lead and no contact (AGL-3458).
+                    event: (form == null ? void 0 : (_form_facts = form.facts) == null ? void 0 : _form_facts['routesLeads']) === true ? 'lead' : 'contactCreated',
+                    conditions: [
+                        {
+                            field: 'formId',
+                            op: 'equals',
+                            value: (_ref = form == null ? void 0 : form.id) != null ? _ref : ''
+                        }
+                    ],
+                    combinator: 'and'
+                },
+                steps: [
+                    {
+                        type: 'addContactTag',
+                        tag: form ? form.name.trim().slice(0, 60) : ''
+                    }
+                ],
+                enabled: true
+            };
+        }
+    }
+];
+/** Registers the stood-in recipes as the CRM's declarations would. */ export function standInRecipes() {
+    registerInteractionRecipes(STAND_IN_RECIPES, {
+        pluginId: 'crm'
+    });
+}
+/**
+ * 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 function standInFormList() {
+    registerPluginRecordListSource('form', {
+        query (firestore, request) {
+            if (!request.hostId) return null;
+            return query(collection(firestore, 'hosts', request.hostId, 'forms'), orderBy(documentId()), limit(request.limit));
+        },
+        record (id, data) {
+            var _data_displayName;
+            if (data['archivedAt'] != null) return null;
+            const routing = data['routing'];
+            return {
+                id,
+                name: String((_data_displayName = data['displayName']) != null ? _data_displayName : '').trim() || id,
+                facts: {
+                    routesLeads: (routing == null ? void 0 : routing.lead) === true
+                }
+            };
+        }
+    }, {
+        pluginId: 'forms'
+    });
+}
+
+//# sourceMappingURL=stand-in-recipes.js.map

package/src/lib/testing/stand-in-recipes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/workflows/src/lib/testing/stand-in-recipes.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  type InteractionRecipe,\n  registerInteractionRecipes,\n} from '@aglyn/aglyn/plugin-manager/interaction-recipes'\nimport { registerPluginRecordListSource } from '@aglyn/aglyn/plugin-manager/plugin-record-lists'\nimport { collection, documentId, limit, orderBy, query } from 'firebase/firestore'\n\n/**\n * The CRM's four recipes (AGL-2626), stood in for this plugin's specs — this\n * plugin may not load the CRM, which writes them and registers them through\n * the platform's recipe seam (AGL-3080). Built as the CRM builds them, so the\n * editor is driven with the automations it is really handed; what the CRM's\n * recipes ARE is held in the CRM's own spec, and that each is an automation\n * this plugin accepts in `apps/console/specs/interaction-recipes.spec.ts`.\n */\nexport const STAND_IN_RECIPES: readonly InteractionRecipe[] = [\n  {\n    id: 'welcomeNewLead',\n    title: 'Welcome a new lead',\n    description:\n      'When a form makes a new lead: rotate in an owner, book a call for ' +\n      'tomorrow, send a thank-you, and tag them website.',\n    build: () => ({\n      recipe: 'welcomeNewLead',\n      name: 'Welcome a new lead',\n      trigger: {\n        event: 'lead',\n        conditions: [{ field: 'formId', op: 'notEmpty' }],\n        combinator: 'and',\n      },\n      steps: [\n        { type: 'assignContactOwner', roundRobin: true },\n        { type: 'createCrmTask', title: 'Call the new lead', kind: 'call', dueInDays: 1 },\n        {\n          type: 'sendEmail',\n          subject: 'Thanks for getting in touch',\n          body:\n            'Hi {{firstName|there}},\\n\\nThanks for reaching out. We have your ' +\n            'message and will reply to this email address.',\n        },\n        { type: 'addContactTag', tag: 'website' },\n      ],\n      enabled: true,\n    }),\n  },\n  {\n    id: 'followUpWonDeal',\n    title: 'Follow up a won deal',\n    description:\n      'When a deal is won — which makes the contact a Customer on its own — ' +\n      'book a check-in call a week out.',\n    build: () => ({\n      recipe: 'followUpWonDeal',\n      name: 'Follow up a won deal',\n      trigger: { event: 'dealWon' },\n      steps: [\n        { type: 'createCrmTask', title: 'Check in with the new customer', kind: 'call', dueInDays: 7 },\n      ],\n      enabled: true,\n    }),\n  },\n  {\n    id: 'reengageStaleLead',\n    title: 'Re-engage a stale lead',\n    description:\n      'When a contact becomes a lead: wait a week, and if their stage has ' +\n      'not moved, book a call to bring them back.',\n    build: () => ({\n      recipe: 'reengageStaleLead',\n      name: 'Re-engage a stale lead',\n      trigger: {\n        event: 'contactStageChanged',\n        conditions: [{ field: 'lifecycleStage', op: 'equals', value: 'lead' }],\n        combinator: 'and',\n      },\n      steps: [\n        { type: 'waitForEvent', eventName: 'contactStageChanged', timeoutMinutes: 7 * 24 * 60 },\n        {\n          type: 'createCrmTask',\n          title: 'Re-engage a lead that has gone quiet',\n          kind: 'call',\n          dueInDays: 1,\n          when: { conditions: [{ field: '_waitTimedOut', op: 'notEmpty' }] },\n        },\n      ],\n      enabled: true,\n    }),\n  },\n  {\n    id: 'tagByForm',\n    title: 'Tag by form',\n    description:\n      'When a form you pick makes a new lead or contact: tag them with the form’s name.',\n    picks: {\n      kind: 'form',\n      label: 'Form',\n      plural: 'forms',\n      prompt: 'Pick the form whose new leads or contacts get the tag.',\n      none: 'This site has no forms yet. Add one in the besigner, then come back.',\n    },\n    build: (input) => {\n      const form = input?.picked\n      return {\n        recipe: 'tagByForm',\n        name: form ? `Tag ${form.name.trim()} submissions` : 'Tag by form',\n        trigger: {\n          // A lead-routed form makes a lead and no contact (AGL-3458).\n          event: form?.facts?.['routesLeads'] === true ? 'lead' : 'contactCreated',\n          conditions: [{ field: 'formId', op: 'equals', value: form?.id ?? '' }],\n          combinator: 'and',\n        },\n        steps: [{ type: 'addContactTag', tag: form ? form.name.trim().slice(0, 60) : '' }],\n        enabled: true,\n      }\n    },\n  },\n]\n\n/** Registers the stood-in recipes as the CRM's declarations would. */\nexport function standInRecipes(): void {\n  registerInteractionRecipes(STAND_IN_RECIPES, { pluginId: 'crm' })\n}\n\n/**\n * The `form` list source the Forms plugin publishes (AGL-3080), stood in: a\n * site's forms by document id, an archived one left out, a form named by its\n * display name or its id, and whether it files leads shared as its\n * `routesLeads` fact. What the Forms plugin itself answers is held in its own\n * spec.\n */\nexport function standInFormList(): void {\n  registerPluginRecordListSource(\n    'form',\n    {\n      query(firestore, request) {\n        if (!request.hostId) return null\n        return query(\n          collection(firestore, 'hosts', request.hostId, 'forms'),\n          orderBy(documentId()),\n          limit(request.limit),\n        )\n      },\n      record(id, data) {\n        if (data['archivedAt'] != null) return null\n        const routing = data['routing'] as { lead?: unknown } | null | undefined\n        return {\n          id,\n          name: String(data['displayName'] ?? '').trim() || id,\n          facts: { routesLeads: routing?.lead === true },\n        }\n      },\n    },\n    { pluginId: 'forms' },\n  )\n}\n"],"names":["registerInteractionRecipes","registerPluginRecordListSource","collection","documentId","limit","orderBy","query","STAND_IN_RECIPES","id","title","description","build","recipe","name","trigger","event","conditions","field","op","combinator","steps","type","roundRobin","kind","dueInDays","subject","body","tag","enabled","value","eventName","timeoutMinutes","when","picks","label","plural","prompt","none","input","form","picked","trim","facts","slice","standInRecipes","pluginId","standInFormList","firestore","request","hostId","record","data","routing","String","routesLeads","lead"],"mappings":"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"}

package/src/lib/transfer/org-automations-package.d.ts

@@ -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 type { PackageDependency } from '@aglyn/aglyn/data-transfer/package';
+import { type OrgAutomationFields } from '../model/org-automations';
+/** The resource key, and so the kind every automation item carries. */
+export declare const ORG_AUTOMATIONS_TRANSFER_KEY = "workflows.org-automations";
+/** The kinds a step's references are named under. */
+export declare const ORG_AUTOMATION_REFERENCE_KINDS: {
+    readonly list: "email.lists";
+    readonly campaign: "marketing.campaigns";
+    readonly dataset: "data.datasets";
+    readonly topic: "email.topics";
+    readonly member: "member";
+};
+/** An org automation as a package carries it. */
+export type OrgAutomationPackageContent = Omit<OrgAutomationFields, 'enabled'>;
+/**
+ * The package content of a stored automation, or of an incoming item, read
+ * by the save route's own reader — so an item the reader refuses is `null`
+ * here and a problem at the dry run.
+ */
+export declare function orgAutomationPackageContent(source: unknown): OrgAutomationPackageContent | null;
+/** The incoming content as stored, before it is judged: whatever the file holds, shaped like an automation. */
+export declare function rawOrgAutomationContent(source: unknown): OrgAutomationPackageContent;
+export declare function orgAutomationDependencies(content: OrgAutomationPackageContent): PackageDependency[];
+/**
+ * The automation with every reference moved through `idMap`. A dropped site
+ * leaves the placement; a dropped step reference clears its id and keeps
+ * its name (see the block header).
+ */
+export declare function remapOrgAutomationIds(content: OrgAutomationPackageContent, idMap: ReadonlyMap<string, string>): OrgAutomationPackageContent;
+export declare const ORG_AUTOMATION_PACKAGE_RULES: readonly [{
+    readonly id: "off";
+    readonly label: "An imported automation arrives switched off";
+    readonly reason: "An automation acts on every site it runs on the moment it is on, so an import never switches one on. One you replace keeps whether it was on.";
+}, {
+    readonly id: "pauses";
+    readonly label: "Each site’s own pause stays";
+    readonly reason: "Pausing an automation is a site’s own decision, so a replace keeps the sites that paused it, and nothing about pausing travels in a package.";
+}];

package/src/lib/transfer/org-automations-package.js

@@ -0,0 +1,167 @@
+/**
+ * @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.
+ */ /*==========================================
+ * ORG AUTOMATIONS AS PACKAGE ITEMS (AGL-3535).
+ *
+ * An item is what an org automation does: its name, trigger, steps and
+ * the sites it runs on. Never whether it is switched on, which sites
+ * paused it, or who wrote it — so one exported and imported back is
+ * `identical`, and an import never switches anything on.
+ *
+ * What it names: its sites (`site`), and what its steps reach — an email
+ * list, a campaign, a dataset, a subscription topic, a member who owns or
+ * is assigned. A step names a list, a campaign and a dataset by id AND by
+ * name, and the engine finds one by its name when the id is empty — so a
+ * dropped reference clears the id and keeps the name, and the step finds
+ * the workspace's own list of that name when it runs.
+ *
+ * Pure: the server half (`org-automations-package.server.ts`) reads and
+ * writes.
+ *=========================================*/ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { remapPackageReference, TRANSFER_SITE_KIND } from "@aglyn/aglyn/data-transfer/package-plan";
+import { hostIdsFromScope, hostScopeToken, ORG_SCOPE_TOKEN } from "@aglyn/aglyn/app-utils/scope-tokens";
+import { readOrgAutomation } from "../model/org-automations.js";
+/** The resource key, and so the kind every automation item carries. */ export const ORG_AUTOMATIONS_TRANSFER_KEY = 'workflows.org-automations';
+/** The kinds a step's references are named under. */ export const ORG_AUTOMATION_REFERENCE_KINDS = {
+    list: 'email.lists',
+    campaign: 'marketing.campaigns',
+    dataset: 'data.datasets',
+    topic: 'email.topics',
+    member: 'member'
+};
+/** Each step field that names something, with the kind it names. */ const STEP_REFERENCES = [
+    {
+        field: 'listId',
+        kind: ORG_AUTOMATION_REFERENCE_KINDS.list
+    },
+    {
+        field: 'campaignId',
+        kind: ORG_AUTOMATION_REFERENCE_KINDS.campaign
+    },
+    {
+        field: 'datasetId',
+        kind: ORG_AUTOMATION_REFERENCE_KINDS.dataset
+    },
+    {
+        field: 'topicId',
+        kind: ORG_AUTOMATION_REFERENCE_KINDS.topic
+    },
+    {
+        field: 'ownerUid',
+        kind: ORG_AUTOMATION_REFERENCE_KINDS.member
+    },
+    {
+        field: 'assigneeUid',
+        kind: ORG_AUTOMATION_REFERENCE_KINDS.member
+    }
+];
+/**
+ * The package content of a stored automation, or of an incoming item, read
+ * by the save route's own reader — so an item the reader refuses is `null`
+ * here and a problem at the dry run.
+ */ export function orgAutomationPackageContent(source) {
+    const read = readOrgAutomation(source);
+    if (read.ok === false) return null;
+    const { name, trigger, steps, visibleTo } = read.value;
+    return {
+        name,
+        trigger,
+        steps,
+        visibleTo
+    };
+}
+/** The incoming content as stored, before it is judged: whatever the file holds, shaped like an automation. */ export function rawOrgAutomationContent(source) {
+    var _raw_name, _raw_trigger;
+    const raw = source && typeof source === 'object' ? source : {};
+    return {
+        name: String((_raw_name = raw.name) != null ? _raw_name : ''),
+        trigger: (_raw_trigger = raw.trigger) != null ? _raw_trigger : {
+            event: '',
+            conditions: null,
+            combinator: null
+        },
+        steps: Array.isArray(raw.steps) ? raw.steps : [],
+        visibleTo: Array.isArray(raw.visibleTo) ? raw.visibleTo : []
+    };
+}
+export function orgAutomationDependencies(content) {
+    var _content_steps;
+    const deps = [];
+    const seen = new Set();
+    const add = (kind, id)=>{
+        if (typeof id !== 'string' || !id.trim() || seen.has(`${kind}/${id}`)) return;
+        seen.add(`${kind}/${id}`);
+        deps.push({
+            kind,
+            id
+        });
+    };
+    for (const hostId of hostIdsFromScope(content.visibleTo))add(TRANSFER_SITE_KIND, hostId);
+    for (const step of (_content_steps = content.steps) != null ? _content_steps : []){
+        for (const { field, kind } of STEP_REFERENCES)add(kind, step[field]);
+    }
+    return deps;
+}
+/**
+ * The automation with every reference moved through `idMap`. A dropped site
+ * leaves the placement; a dropped step reference clears its id and keeps
+ * its name (see the block header).
+ */ export function remapOrgAutomationIds(content, idMap) {
+    var _content_steps;
+    const visibleTo = content.visibleTo.flatMap((token)=>{
+        if (token === ORG_SCOPE_TOKEN) return [
+            token
+        ];
+        const [hostId] = hostIdsFromScope([
+            token
+        ]);
+        if (!hostId) return [
+            token
+        ];
+        const mapped = remapPackageReference(idMap, TRANSFER_SITE_KIND, hostId);
+        return mapped ? [
+            hostScopeToken(mapped)
+        ] : [];
+    });
+    const steps = ((_content_steps = content.steps) != null ? _content_steps : []).map((step)=>{
+        const record = _extends({}, step);
+        for (const { field, kind } of STEP_REFERENCES){
+            var _remapPackageReference;
+            const id = record[field];
+            if (typeof id !== 'string' || !id) continue;
+            record[field] = (_remapPackageReference = remapPackageReference(idMap, kind, id)) != null ? _remapPackageReference : '';
+        }
+        return record;
+    });
+    return _extends({}, content, {
+        visibleTo: visibleTo,
+        steps
+    });
+}
+export const ORG_AUTOMATION_PACKAGE_RULES = [
+    {
+        id: 'off',
+        label: 'An imported automation arrives switched off',
+        reason: 'An automation acts on every site it runs on the moment it is on, so an import never switches one on. One you replace keeps whether it was on.'
+    },
+    {
+        id: 'pauses',
+        label: 'Each site’s own pause stays',
+        reason: 'Pausing an automation is a site’s own decision, so a replace keeps the sites that paused it, and nothing about pausing travels in a package.'
+    }
+];
+
+//# sourceMappingURL=org-automations-package.js.map

package/src/lib/transfer/org-automations-package.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/workflows/src/lib/transfer/org-automations-package.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 * ORG AUTOMATIONS AS PACKAGE ITEMS (AGL-3535).\n *\n * An item is what an org automation does: its name, trigger, steps and\n * the sites it runs on. Never whether it is switched on, which sites\n * paused it, or who wrote it — so one exported and imported back is\n * `identical`, and an import never switches anything on.\n *\n * What it names: its sites (`site`), and what its steps reach — an email\n * list, a campaign, a dataset, a subscription topic, a member who owns or\n * is assigned. A step names a list, a campaign and a dataset by id AND by\n * name, and the engine finds one by its name when the id is empty — so a\n * dropped reference clears the id and keeps the name, and the step finds\n * the workspace's own list of that name when it runs.\n *\n * Pure: the server half (`org-automations-package.server.ts`) reads and\n * writes.\n *=========================================*/\n\nimport type { PackageDependency } from '@aglyn/aglyn/data-transfer/package'\nimport { remapPackageReference, TRANSFER_SITE_KIND } from '@aglyn/aglyn/data-transfer/package-plan'\nimport { hostIdsFromScope, hostScopeToken, ORG_SCOPE_TOKEN } from '@aglyn/aglyn/app-utils/scope-tokens'\nimport { readOrgAutomation, type OrgAutomationFields } from '../model/org-automations'\n\n/** The resource key, and so the kind every automation item carries. */\nexport const ORG_AUTOMATIONS_TRANSFER_KEY = 'workflows.org-automations'\n\n/** The kinds a step's references are named under. */\nexport const ORG_AUTOMATION_REFERENCE_KINDS = {\n  list: 'email.lists',\n  campaign: 'marketing.campaigns',\n  dataset: 'data.datasets',\n  topic: 'email.topics',\n  member: 'member',\n} as const\n\n/** An org automation as a package carries it. */\nexport type OrgAutomationPackageContent = Omit<OrgAutomationFields, 'enabled'>\n\ntype StepRecord = Record<string, unknown>\n\n/** Each step field that names something, with the kind it names. */\nconst STEP_REFERENCES: ReadonlyArray<{ field: string; kind: string }> = [\n  { field: 'listId', kind: ORG_AUTOMATION_REFERENCE_KINDS.list },\n  { field: 'campaignId', kind: ORG_AUTOMATION_REFERENCE_KINDS.campaign },\n  { field: 'datasetId', kind: ORG_AUTOMATION_REFERENCE_KINDS.dataset },\n  { field: 'topicId', kind: ORG_AUTOMATION_REFERENCE_KINDS.topic },\n  { field: 'ownerUid', kind: ORG_AUTOMATION_REFERENCE_KINDS.member },\n  { field: 'assigneeUid', kind: ORG_AUTOMATION_REFERENCE_KINDS.member },\n]\n\n/**\n * The package content of a stored automation, or of an incoming item, read\n * by the save route's own reader — so an item the reader refuses is `null`\n * here and a problem at the dry run.\n */\nexport function orgAutomationPackageContent(source: unknown): OrgAutomationPackageContent | null {\n  const read = readOrgAutomation(source)\n  if (read.ok === false) return null\n  const { name, trigger, steps, visibleTo } = read.value\n  return { name, trigger, steps, visibleTo }\n}\n\n/** The incoming content as stored, before it is judged: whatever the file holds, shaped like an automation. */\nexport function rawOrgAutomationContent(source: unknown): OrgAutomationPackageContent {\n  const raw = (source && typeof source === 'object' ? source : {}) as Partial<OrgAutomationPackageContent>\n  return {\n    name: String(raw.name ?? ''),\n    trigger: (raw.trigger ?? { event: '', conditions: null, combinator: null }) as OrgAutomationPackageContent['trigger'],\n    steps: Array.isArray(raw.steps) ? raw.steps : [],\n    visibleTo: Array.isArray(raw.visibleTo) ? raw.visibleTo : [],\n  }\n}\n\nexport function orgAutomationDependencies(content: OrgAutomationPackageContent): PackageDependency[] {\n  const deps: PackageDependency[] = []\n  const seen = new Set<string>()\n  const add = (kind: string, id: unknown) => {\n    if (typeof id !== 'string' || !id.trim() || seen.has(`${kind}/${id}`)) return\n    seen.add(`${kind}/${id}`)\n    deps.push({ kind, id })\n  }\n  for (const hostId of hostIdsFromScope(content.visibleTo)) add(TRANSFER_SITE_KIND, hostId)\n  for (const step of content.steps ?? []) {\n    for (const { field, kind } of STEP_REFERENCES) add(kind, (step as unknown as StepRecord)[field])\n  }\n  return deps\n}\n\n/**\n * The automation with every reference moved through `idMap`. A dropped site\n * leaves the placement; a dropped step reference clears its id and keeps\n * its name (see the block header).\n */\nexport function remapOrgAutomationIds(\n  content: OrgAutomationPackageContent,\n  idMap: ReadonlyMap<string, string>,\n): OrgAutomationPackageContent {\n  const visibleTo = content.visibleTo.flatMap((token) => {\n    if (token === ORG_SCOPE_TOKEN) return [token]\n    const [hostId] = hostIdsFromScope([token])\n    if (!hostId) return [token]\n    const mapped = remapPackageReference(idMap, TRANSFER_SITE_KIND, hostId)\n    return mapped ? [hostScopeToken(mapped)] : []\n  })\n  const steps = (content.steps ?? []).map((step) => {\n    const record = { ...(step as unknown as StepRecord) }\n    for (const { field, kind } of STEP_REFERENCES) {\n      const id = record[field]\n      if (typeof id !== 'string' || !id) continue\n      record[field] = remapPackageReference(idMap, kind, id) ?? ''\n    }\n    return record as unknown as OrgAutomationPackageContent['steps'][number]\n  })\n  return { ...content, visibleTo: visibleTo as OrgAutomationPackageContent['visibleTo'], steps }\n}\n\nexport const ORG_AUTOMATION_PACKAGE_RULES = [\n  {\n    id: 'off',\n    label: 'An imported automation arrives switched off',\n    reason:\n      'An automation acts on every site it runs on the moment it is on, so an import never switches one on. One you replace keeps whether it was on.',\n  },\n  {\n    id: 'pauses',\n    label: 'Each site’s own pause stays',\n    reason: 'Pausing an automation is a site’s own decision, so a replace keeps the sites that paused it, and nothing about pausing travels in a package.',\n  },\n] as const\n"],"names":["remapPackageReference","TRANSFER_SITE_KIND","hostIdsFromScope","hostScopeToken","ORG_SCOPE_TOKEN","readOrgAutomation","ORG_AUTOMATIONS_TRANSFER_KEY","ORG_AUTOMATION_REFERENCE_KINDS","list","campaign","dataset","topic","member","STEP_REFERENCES","field","kind","orgAutomationPackageContent","source","read","ok","name","trigger","steps","visibleTo","value","rawOrgAutomationContent","raw","String","event","conditions","combinator","Array","isArray","orgAutomationDependencies","content","deps","seen","Set","add","id","trim","has","push","hostId","step","remapOrgAutomationIds","idMap","flatMap","token","mapped","map","record","ORG_AUTOMATION_PACKAGE_RULES","label","reason"],"mappings":"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"}

package/src/lib/transfer/org-automations-package.server.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type ExistingPackageItem, type TransferReferenceKind } from '@aglyn/aglyn/data-transfer';
+import type { TransferApplyResult, TransferApplyWriter, TransferPackageItemContent, TransferPackageItemWrite, TransferPackageRevertResult, TransferPackageRevertStep, TransferResourceContext } from '@aglyn/aglyn/plugin-manager/plugin-transfer-resources';
+import { type OrgAutomationPackageContent } from './org-automations-package';
+type Firestore = FirebaseFirestore.Firestore;
+export interface OrgAutomationsPackageDeps {
+    firestore(): Firestore;
+    readOrg(orgId: string): Promise<Record<string, unknown> | null>;
+    memberOf(uid: string, orgId: string): Promise<Record<string, unknown> | null>;
+    logOrgActivity(orgId: string, uid: string, action: string, target: {
+        id: string;
+        name: string;
+    }): Promise<void>;
+}
+export declare function createOrgAutomationsPackage(deps?: OrgAutomationsPackageDeps): {
+    items(ctx: TransferResourceContext): Promise<ExistingPackageItem[]>;
+    readItems(ctx: TransferResourceContext, ids: readonly string[]): Promise<TransferPackageItemContent<OrgAutomationPackageContent>[]>;
+    problems(ctx: TransferResourceContext, write: TransferPackageItemWrite<OrgAutomationPackageContent>): Promise<string[]>;
+    referenceTargets(ctx: TransferResourceContext, kinds: readonly string[]): Promise<TransferReferenceKind[]>;
+    writeItems(ctx: TransferResourceContext, items: ReadonlyArray<TransferPackageItemWrite<OrgAutomationPackageContent>>, writer: TransferApplyWriter): Promise<TransferApplyResult>;
+    revertItems(ctx: TransferResourceContext, steps: ReadonlyArray<TransferPackageRevertStep<OrgAutomationPackageContent>>): Promise<TransferPackageRevertResult>;
+};
+export {};