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

package/src/lib/declarations.console-server.js

@@ -17,7 +17,12 @@
 // registry, not the whole server surface.
 import { registerApiV1Resource, registerApiV1UsageFigures } from "@aglyn/tenant-data-admin/server/api-v1-resources";
 import { listPluginMembershipDetachers, registerPluginMembershipDetacher } from "@aglyn/aglyn/plugin-manager/plugin-membership-detach";
+import { registerPluginPersonRecordsEraser } from "@aglyn/aglyn/plugin-manager/plugin-person-erasure";
+import { registerPluginTransferResource } from "@aglyn/aglyn/plugin-manager/plugin-transfer-resources";
 import { BUNDLE_ID } from "./constants/bundle-common.js";
+import { crmTransferPlanGate, registerCrmTransferResources } from "./transfer/register.js";
+import { CRM_EMAIL_TEMPLATE_PACKAGE_RULES, CRM_EMAIL_TEMPLATES_TRANSFER_KEY, crmEmailTemplateDependencies, remapCrmEmailTemplateIds } from "./transfer/email-templates-package.js";
+/** The email templates package's server half (AGL-3535), loaded when an import or export first asks. */ const templatesPackage = async ()=>(await import("./transfer/email-templates-package.server.js")).createCrmEmailTemplatesPackage();
 /**
  * The plan feature every CRM resource of `/v1` needs, and the sentence its
  * refusal says (AGL-2611, AGL-2851): the whole CRM is included from
@@ -81,6 +86,9 @@ import { BUNDLE_ID } from "./constants/bundle-common.js";
  * records band and collection sizes join `GET /v1/usage`. The API is the
  * console's alone, so the tenant runtime does not register them.
  *
+ * It registers the server half of the CRM's import and export resources
+ * (`transfer/register.ts`).
+ *
  * It also clears a removed container off the CRM's records: a campaign is
  * deleted from the console, and its owner asks every plugin's membership
  * detacher first (`server/container-detach.ts`).
@@ -91,6 +99,30 @@ import { BUNDLE_ID } from "./constants/bundle-common.js";
  * Registering again replaces this plugin's own entries, so a second call (a
  * hot reload, a spec) is harmless.
  */ export function registerCrmConsoleServerDeclarations() {
+    // Email templates in a workspace package (AGL-3535).
+    registerPluginTransferResource(CRM_EMAIL_TEMPLATES_TRANSFER_KEY, {
+        items: async (ctx)=>(await templatesPackage()).items(ctx),
+        dependencies: (item)=>crmEmailTemplateDependencies(item),
+        remapIds: (item, idMap)=>remapCrmEmailTemplateIds(item, idMap),
+        readItems: async (ctx, ids)=>(await templatesPackage()).readItems(ctx, ids),
+        writeItems: async (ctx, items, writer)=>(await templatesPackage()).writeItems(ctx, items, writer),
+        revertItems: async (ctx, steps)=>(await templatesPackage()).revertItems(ctx, steps),
+        problems: async (ctx, write)=>(await templatesPackage()).problems(ctx, write),
+        rules: CRM_EMAIL_TEMPLATE_PACKAGE_RULES,
+        planGate: crmTransferPlanGate('email templates')
+    }, {
+        pluginId: BUNDLE_ID
+    });
+    // The record system's share of a person erasure (AGL-2623, AGL-3080): it
+    // names the person's contacts before anybody erases, and erases them, their
+    // satellites and their lead after everybody else. Required, and loaded with
+    // the first erasure.
+    registerPluginPersonRecordsEraser({
+        locate: async (target)=>(await import("./server/person-eraser.js")).crmPersonEraser().locate(target),
+        erase: async (request)=>(await import("./server/person-eraser.js")).crmPersonEraser().erase(request)
+    }, {
+        pluginId: BUNDLE_ID
+    });
     for (const [resource, handle] of CRM_API_V1_RESOURCES){
         registerApiV1Resource(resource, {
             handle,
@@ -103,6 +135,9 @@ import { BUNDLE_ID } from "./constants/bundle-common.js";
     registerApiV1UsageFigures(async (ctx)=>(await import("./server/api-v1/usage.js")).crmUsageFigures(ctx), {
         pluginId: BUNDLE_ID
     });
+    // What the CRM imports and exports (AGL-3527): each resource's module
+    // loads with the first transfer that asks for it.
+    registerCrmTransferResources(BUNDLE_ID);
     // A removed container — a deleted campaign — comes off every lead and every
     // contact facet naming it, before its owner removes it (AGL-3080).
     if (!listPluginMembershipDetachers().includes(BUNDLE_ID)) {

package/src/lib/declarations.console-server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/crm/src/lib/declarations.console-server.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// The registry's own module, not the data layer's barrel: boot needs one\n// registry, not the whole server surface.\nimport {\n  type ApiV1ResourceHandler,\n  registerApiV1Resource,\n  registerApiV1UsageFigures,\n} from '@aglyn/tenant-data-admin/server/api-v1-resources'\nimport {\n  listPluginMembershipDetachers,\n  registerPluginMembershipDetacher,\n} from '@aglyn/aglyn/plugin-manager/plugin-membership-detach'\nimport { BUNDLE_ID } from './constants/bundle-common'\n\n/**\n * The plan feature every CRM resource of `/v1` needs, and the sentence its\n * refusal says (AGL-2611, AGL-2851): the whole CRM is included from\n * Starter, so a Free workspace reads and changes none of it over the API. A\n * capture still records people on every plan; working them is the CRM.\n */\nconst CRM_SUITE = {\n  feature: 'crm',\n  message:\n    'The CRM — contacts, leads, companies, deals, tasks, pipelines, ' +\n    'activities and email templates — is not included in this organization’s plan',\n} as const\n\n/**\n * The CRM's resources on the customer REST API, each handler loaded with the\n * first request for it. In the order the API root lists them: the people\n * first, then the records a team keeps about them, then a site's leads\n * (`/v1/leads?siteId=`, a top-level path with the site as a parameter), then\n * the letters sent from a record (AGL-2658).\n */\nconst CRM_API_V1_RESOURCES: ReadonlyArray<readonly [string, ApiV1ResourceHandler]> = [\n  ['contacts', async (...args) => (await import('./server/api-v1/contacts')).handleContacts(...args)],\n  ['companies', async (...args) => (await import('./server/api-v1/crm-companies')).handleCompanies(...args)],\n  ['pipelines', async (...args) => (await import('./server/api-v1/crm-pipelines')).handlePipelines(...args)],\n  ['deals', async (...args) => (await import('./server/api-v1/crm-deals')).handleDeals(...args)],\n  ['tasks', async (...args) => (await import('./server/api-v1/crm-tasks')).handleTasks(...args)],\n  ['activities', async (...args) => (await import('./server/api-v1/crm-activities')).handleActivities(...args)],\n  ['leads', async (...args) => (await import('./server/api-v1/crm-leads')).handleLeads(...args)],\n  [\n    'email-templates',\n    async (...args) => (await import('./server/api-v1/crm-email-templates')).handleEmailTemplates(...args),\n  ],\n]\n\n/**\n * The CRM's CONSOLE-ONLY server declarations, named under\n * `consoleServerDeclarations` in `plugins.config.json` and run at the\n * console's boot.\n *\n * It serves the CRM's resources of `/v1` (AGL-2606): the console's router\n * owns the pipeline in front of them — the key, the plan's API access, the\n * quota, the rate limit, the error envelope — and hands every request under\n * `/v1/contacts`, `/v1/deals` and the rest to the CRM once the key is\n * authenticated and the organization's plan carries the CRM. Each resource\n * brings its description for the API's OpenAPI document, and the CRM's\n * records band and collection sizes join `GET /v1/usage`. The API is the\n * console's alone, so the tenant runtime does not register them.\n *\n * It also clears a removed container off the CRM's records: a campaign is\n * deleted from the console, and its owner asks every plugin's membership\n * detacher first (`server/container-detach.ts`).\n *\n * Light at boot: each resource's module is imported with its first request,\n * the descriptions when the document is first built, and the usage reader\n * with the first usage call.\n * Registering again replaces this plugin's own entries, so a second call (a\n * hot reload, a spec) is harmless.\n */\nexport function registerCrmConsoleServerDeclarations(): void {\n  for (const [resource, handle] of CRM_API_V1_RESOURCES) {\n    registerApiV1Resource(\n      resource,\n      {\n        handle,\n        entitlement: CRM_SUITE,\n        describe: async () =>\n          (await import('./server/api-v1/openapi')).CRM_API_V1_DESCRIPTIONS[resource],\n      },\n      { pluginId: BUNDLE_ID },\n    )\n  }\n  registerApiV1UsageFigures(\n    async (ctx) => (await import('./server/api-v1/usage')).crmUsageFigures(ctx),\n    { pluginId: BUNDLE_ID },\n  )\n  // A removed container — a deleted campaign — comes off every lead and every\n  // contact facet naming it, before its owner removes it (AGL-3080).\n  if (!listPluginMembershipDetachers().includes(BUNDLE_ID)) {\n    registerPluginMembershipDetacher(\n      async (request) => (await import('./server/container-detach')).crmContainerDetacher(request),\n      { pluginId: BUNDLE_ID },\n    )\n  }\n}\n"],"names":["registerApiV1Resource","registerApiV1UsageFigures","listPluginMembershipDetachers","registerPluginMembershipDetacher","BUNDLE_ID","CRM_SUITE","feature","message","CRM_API_V1_RESOURCES","args","handleContacts","handleCompanies","handlePipelines","handleDeals","handleTasks","handleActivities","handleLeads","handleEmailTemplates","registerCrmConsoleServerDeclarations","resource","handle","entitlement","describe","CRM_API_V1_DESCRIPTIONS","pluginId","ctx","crmUsageFigures","includes","request","crmContainerDetacher"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,yEAAyE;AACzE,0CAA0C;AAC1C,SAEEA,qBAAqB,EACrBC,yBAAyB,QACpB,mDAAkD;AACzD,SACEC,6BAA6B,EAC7BC,gCAAgC,QAC3B,uDAAsD;AAC7D,SAASC,SAAS,QAAQ,+BAA2B;AAErD;;;;;CAKC,GACD,MAAMC,YAAY;IAChBC,SAAS;IACTC,SACE,oEACA;AACJ;AAEA;;;;;;CAMC,GACD,MAAMC,uBAA+E;IACnF;QAAC;QAAY,OAAO,GAAGC,OAAS,AAAC,CAAA,MAAM,MAAM,CAAC,8BAA0B,EAAGC,cAAc,IAAID;KAAM;IACnG;QAAC;QAAa,OAAO,GAAGA,OAAS,AAAC,CAAA,MAAM,MAAM,CAAC,mCAA+B,EAAGE,eAAe,IAAIF;KAAM;IAC1G;QAAC;QAAa,OAAO,GAAGA,OAAS,AAAC,CAAA,MAAM,MAAM,CAAC,mCAA+B,EAAGG,eAAe,IAAIH;KAAM;IAC1G;QAAC;QAAS,OAAO,GAAGA,OAAS,AAAC,CAAA,MAAM,MAAM,CAAC,+BAA2B,EAAGI,WAAW,IAAIJ;KAAM;IAC9F;QAAC;QAAS,OAAO,GAAGA,OAAS,AAAC,CAAA,MAAM,MAAM,CAAC,+BAA2B,EAAGK,WAAW,IAAIL;KAAM;IAC9F;QAAC;QAAc,OAAO,GAAGA,OAAS,AAAC,CAAA,MAAM,MAAM,CAAC,oCAAgC,EAAGM,gBAAgB,IAAIN;KAAM;IAC7G;QAAC;QAAS,OAAO,GAAGA,OAAS,AAAC,CAAA,MAAM,MAAM,CAAC,+BAA2B,EAAGO,WAAW,IAAIP;KAAM;IAC9F;QACE;QACA,OAAO,GAAGA,OAAS,AAAC,CAAA,MAAM,MAAM,CAAC,yCAAqC,EAAGQ,oBAAoB,IAAIR;KAClG;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;CAuBC,GACD,OAAO,SAASS;IACd,KAAK,MAAM,CAACC,UAAUC,OAAO,IAAIZ,qBAAsB;QACrDR,sBACEmB,UACA;YACEC;YACAC,aAAahB;YACbiB,UAAU,UACR,AAAC,CAAA,MAAM,MAAM,CAAC,6BAAyB,EAAGC,uBAAuB,CAACJ,SAAS;QAC/E,GACA;YAAEK,UAAUpB;QAAU;IAE1B;IACAH,0BACE,OAAOwB,MAAQ,AAAC,CAAA,MAAM,MAAM,CAAC,2BAAuB,EAAGC,eAAe,CAACD,MACvE;QAAED,UAAUpB;IAAU;IAExB,4EAA4E;IAC5E,mEAAmE;IACnE,IAAI,CAACF,gCAAgCyB,QAAQ,CAACvB,YAAY;QACxDD,iCACE,OAAOyB,UAAY,AAAC,CAAA,MAAM,MAAM,CAAC,+BAA2B,EAAGC,oBAAoB,CAACD,UACpF;YAAEJ,UAAUpB;QAAU;IAE1B;AACF"}
+{"version":3,"sources":["../../../../../../libs/plugins/crm/src/lib/declarations.console-server.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// The registry's own module, not the data layer's barrel: boot needs one\n// registry, not the whole server surface.\nimport {\n  type ApiV1ResourceHandler,\n  registerApiV1Resource,\n  registerApiV1UsageFigures,\n} from '@aglyn/tenant-data-admin/server/api-v1-resources'\nimport {\n  listPluginMembershipDetachers,\n  registerPluginMembershipDetacher,\n} from '@aglyn/aglyn/plugin-manager/plugin-membership-detach'\nimport { registerPluginPersonRecordsEraser } from '@aglyn/aglyn/plugin-manager/plugin-person-erasure'\nimport { registerPluginTransferResource } from '@aglyn/aglyn/plugin-manager/plugin-transfer-resources'\nimport { BUNDLE_ID } from './constants/bundle-common'\nimport { crmTransferPlanGate, registerCrmTransferResources } from './transfer/register'\nimport {\n  CRM_EMAIL_TEMPLATE_PACKAGE_RULES,\n  CRM_EMAIL_TEMPLATES_TRANSFER_KEY,\n  crmEmailTemplateDependencies,\n  remapCrmEmailTemplateIds,\n  type CrmEmailTemplatePackageContent,\n} from './transfer/email-templates-package'\n\n/** The email templates package's server half (AGL-3535), loaded when an import or export first asks. */\nconst templatesPackage = async () =>\n  (await import('./transfer/email-templates-package.server')).createCrmEmailTemplatesPackage()\n\n/**\n * The plan feature every CRM resource of `/v1` needs, and the sentence its\n * refusal says (AGL-2611, AGL-2851): the whole CRM is included from\n * Starter, so a Free workspace reads and changes none of it over the API. A\n * capture still records people on every plan; working them is the CRM.\n */\nconst CRM_SUITE = {\n  feature: 'crm',\n  message:\n    'The CRM — contacts, leads, companies, deals, tasks, pipelines, ' +\n    'activities and email templates — is not included in this organization’s plan',\n} as const\n\n/**\n * The CRM's resources on the customer REST API, each handler loaded with the\n * first request for it. In the order the API root lists them: the people\n * first, then the records a team keeps about them, then a site's leads\n * (`/v1/leads?siteId=`, a top-level path with the site as a parameter), then\n * the letters sent from a record (AGL-2658).\n */\nconst CRM_API_V1_RESOURCES: ReadonlyArray<readonly [string, ApiV1ResourceHandler]> = [\n  ['contacts', async (...args) => (await import('./server/api-v1/contacts')).handleContacts(...args)],\n  ['companies', async (...args) => (await import('./server/api-v1/crm-companies')).handleCompanies(...args)],\n  ['pipelines', async (...args) => (await import('./server/api-v1/crm-pipelines')).handlePipelines(...args)],\n  ['deals', async (...args) => (await import('./server/api-v1/crm-deals')).handleDeals(...args)],\n  ['tasks', async (...args) => (await import('./server/api-v1/crm-tasks')).handleTasks(...args)],\n  ['activities', async (...args) => (await import('./server/api-v1/crm-activities')).handleActivities(...args)],\n  ['leads', async (...args) => (await import('./server/api-v1/crm-leads')).handleLeads(...args)],\n  [\n    'email-templates',\n    async (...args) => (await import('./server/api-v1/crm-email-templates')).handleEmailTemplates(...args),\n  ],\n]\n\n/**\n * The CRM's CONSOLE-ONLY server declarations, named under\n * `consoleServerDeclarations` in `plugins.config.json` and run at the\n * console's boot.\n *\n * It serves the CRM's resources of `/v1` (AGL-2606): the console's router\n * owns the pipeline in front of them — the key, the plan's API access, the\n * quota, the rate limit, the error envelope — and hands every request under\n * `/v1/contacts`, `/v1/deals` and the rest to the CRM once the key is\n * authenticated and the organization's plan carries the CRM. Each resource\n * brings its description for the API's OpenAPI document, and the CRM's\n * records band and collection sizes join `GET /v1/usage`. The API is the\n * console's alone, so the tenant runtime does not register them.\n *\n * It registers the server half of the CRM's import and export resources\n * (`transfer/register.ts`).\n *\n * It also clears a removed container off the CRM's records: a campaign is\n * deleted from the console, and its owner asks every plugin's membership\n * detacher first (`server/container-detach.ts`).\n *\n * Light at boot: each resource's module is imported with its first request,\n * the descriptions when the document is first built, and the usage reader\n * with the first usage call.\n * Registering again replaces this plugin's own entries, so a second call (a\n * hot reload, a spec) is harmless.\n */\nexport function registerCrmConsoleServerDeclarations(): void {\n  // Email templates in a workspace package (AGL-3535).\n  registerPluginTransferResource(\n    CRM_EMAIL_TEMPLATES_TRANSFER_KEY,\n    {\n      items: async (ctx) => (await templatesPackage()).items(ctx),\n      dependencies: (item) => crmEmailTemplateDependencies(item as CrmEmailTemplatePackageContent),\n      remapIds: (item, idMap) => remapCrmEmailTemplateIds(item as CrmEmailTemplatePackageContent, idMap),\n      readItems: async (ctx, ids) => (await templatesPackage()).readItems(ctx, ids),\n      writeItems: async (ctx, items, writer) => (await templatesPackage()).writeItems(ctx, items as never, writer),\n      revertItems: async (ctx, steps) => (await templatesPackage()).revertItems(ctx, steps as never),\n      problems: async (ctx, write) => (await templatesPackage()).problems(ctx, write as never),\n      rules: CRM_EMAIL_TEMPLATE_PACKAGE_RULES,\n      planGate: crmTransferPlanGate('email templates'),\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  // The record system's share of a person erasure (AGL-2623, AGL-3080): it\n  // names the person's contacts before anybody erases, and erases them, their\n  // satellites and their lead after everybody else. Required, and loaded with\n  // the first erasure.\n  registerPluginPersonRecordsEraser(\n    {\n      locate: async (target) => (await import('./server/person-eraser')).crmPersonEraser().locate(target),\n      erase: async (request) => (await import('./server/person-eraser')).crmPersonEraser().erase(request),\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  for (const [resource, handle] of CRM_API_V1_RESOURCES) {\n    registerApiV1Resource(\n      resource,\n      {\n        handle,\n        entitlement: CRM_SUITE,\n        describe: async () =>\n          (await import('./server/api-v1/openapi')).CRM_API_V1_DESCRIPTIONS[resource],\n      },\n      { pluginId: BUNDLE_ID },\n    )\n  }\n  registerApiV1UsageFigures(\n    async (ctx) => (await import('./server/api-v1/usage')).crmUsageFigures(ctx),\n    { pluginId: BUNDLE_ID },\n  )\n  // What the CRM imports and exports (AGL-3527): each resource's module\n  // loads with the first transfer that asks for it.\n  registerCrmTransferResources(BUNDLE_ID)\n  // A removed container — a deleted campaign — comes off every lead and every\n  // contact facet naming it, before its owner removes it (AGL-3080).\n  if (!listPluginMembershipDetachers().includes(BUNDLE_ID)) {\n    registerPluginMembershipDetacher(\n      async (request) => (await import('./server/container-detach')).crmContainerDetacher(request),\n      { pluginId: BUNDLE_ID },\n    )\n  }\n}\n"],"names":["registerApiV1Resource","registerApiV1UsageFigures","listPluginMembershipDetachers","registerPluginMembershipDetacher","registerPluginPersonRecordsEraser","registerPluginTransferResource","BUNDLE_ID","crmTransferPlanGate","registerCrmTransferResources","CRM_EMAIL_TEMPLATE_PACKAGE_RULES","CRM_EMAIL_TEMPLATES_TRANSFER_KEY","crmEmailTemplateDependencies","remapCrmEmailTemplateIds","templatesPackage","createCrmEmailTemplatesPackage","CRM_SUITE","feature","message","CRM_API_V1_RESOURCES","args","handleContacts","handleCompanies","handlePipelines","handleDeals","handleTasks","handleActivities","handleLeads","handleEmailTemplates","registerCrmConsoleServerDeclarations","items","ctx","dependencies","item","remapIds","idMap","readItems","ids","writeItems","writer","revertItems","steps","problems","write","rules","planGate","pluginId","locate","target","crmPersonEraser","erase","request","resource","handle","entitlement","describe","CRM_API_V1_DESCRIPTIONS","crmUsageFigures","includes","crmContainerDetacher"],"mappings":"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"}

package/src/lib/declarations.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @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 CRM's DECLARATIONS: what another surface reads of this plugin before any
+ * of its own surfaces load, in both apps and in the console's browser.
+ *
+ * Its recipes (AGL-2626), so the automation editor's Recipes menu offers
+ * "Welcome a new lead" on a site whose CRM pages were never opened, and the
+ * automation it builds names the recipe it began as. Light by construction:
+ * the recipes are definitions, and nothing here reaches Firestore or React.
+ */
+export declare function registerCrmDeclarations(): void;

package/src/lib/declarations.js

@@ -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.
+ */ // The seam from its own module, not the plugin-manager barrel: both apps load
+// this at boot, and the barrel reaches the client contexts.
+import { registerInteractionRecipes } from "@aglyn/aglyn/plugin-manager/interaction-recipes";
+import { BUNDLE_ID } from "./constants/bundle-common.js";
+import { CRM_ACTION_RECIPES } from "./model/crm-recipes.js";
+/**
+ * The CRM's DECLARATIONS: what another surface reads of this plugin before any
+ * of its own surfaces load, in both apps and in the console's browser.
+ *
+ * Its recipes (AGL-2626), so the automation editor's Recipes menu offers
+ * "Welcome a new lead" on a site whose CRM pages were never opened, and the
+ * automation it builds names the recipe it began as. Light by construction:
+ * the recipes are definitions, and nothing here reaches Firestore or React.
+ */ export function registerCrmDeclarations() {
+    registerInteractionRecipes(CRM_ACTION_RECIPES, {
+        pluginId: BUNDLE_ID
+    });
+}
+
+//# sourceMappingURL=declarations.js.map

package/src/lib/declarations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/plugins/crm/src/lib/declarations.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// The seam from its own module, not the plugin-manager barrel: both apps load\n// this at boot, and the barrel reaches the client contexts.\nimport { registerInteractionRecipes } from '@aglyn/aglyn/plugin-manager/interaction-recipes'\nimport { BUNDLE_ID } from './constants/bundle-common'\nimport { CRM_ACTION_RECIPES } from './model/crm-recipes'\n\n/**\n * The CRM's DECLARATIONS: what another surface reads of this plugin before any\n * of its own surfaces load, in both apps and in the console's browser.\n *\n * Its recipes (AGL-2626), so the automation editor's Recipes menu offers\n * \"Welcome a new lead\" on a site whose CRM pages were never opened, and the\n * automation it builds names the recipe it began as. Light by construction:\n * the recipes are definitions, and nothing here reaches Firestore or React.\n */\nexport function registerCrmDeclarations(): void {\n  registerInteractionRecipes(CRM_ACTION_RECIPES, { pluginId: BUNDLE_ID })\n}\n"],"names":["registerInteractionRecipes","BUNDLE_ID","CRM_ACTION_RECIPES","registerCrmDeclarations","pluginId"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,8EAA8E;AAC9E,4DAA4D;AAC5D,SAASA,0BAA0B,QAAQ,kDAAiD;AAC5F,SAASC,SAAS,QAAQ,+BAA2B;AACrD,SAASC,kBAAkB,QAAQ,yBAAqB;AAExD;;;;;;;;CAQC,GACD,OAAO,SAASC;IACdH,2BAA2BE,oBAAoB;QAAEE,UAAUH;IAAU;AACvE"}

package/src/lib/declarations.server.d.ts

@@ -15,6 +15,7 @@
  * limitations under the License.
  */
 import { type PluginContactCaptureWriter } from '@aglyn/aglyn/plugin-manager/plugin-contact-capture';
+import { type PluginPersonRecords } from '@aglyn/aglyn/plugin-manager/plugin-person-records';
 import { type PluginRecordIndex } from '@aglyn/aglyn/plugin-manager/plugin-record-index';
 import { type PluginRecordTimelineWriter } from '@aglyn/aglyn/plugin-manager/plugin-record-timeline';
 /**
@@ -27,11 +28,21 @@ import { type PluginRecordTimelineWriter } from '@aglyn/aglyn/plugin-manager/plu
  * including ones that will never touch the CRM.
  */
 export declare const crmContactCaptureWriter: PluginContactCaptureWriter;
+/**
+ * The CRM as the plugin other plugins ask for people (AGL-3080), deferred
+ * like the capture: `server/person-records.ts` and the Admin SDK it brings
+ * load with the first question, not when the process starts.
+ */
+export declare const crmPersonRecordsService: PluginPersonRecords;
 /**
  * The `pipeline` record index, its reads loaded with the first one — see
  * `server/pipeline-record-index.ts` for what it answers.
  */
 export declare const crmPipelineRecordIndex: PluginRecordIndex;
+/** The companies a person works for, as another plugin reads them (AGL-3080). */
+export declare const crmCompanyRecordIndex: PluginRecordIndex;
+/** The email templates and snippets reps write, as another plugin reads them (AGL-3080). */
+export declare const crmMessageTemplateRecordIndex: PluginRecordIndex;
 /**
  * The CRM's writer on the record-timeline seam (AGL-2981), deferred: the
  * writer and the Admin SDK it brings load with the first entry filed.

package/src/lib/declarations.server.js

@@ -19,12 +19,15 @@ import { registerPluginConsentGroupParticipant } from "@aglyn/aglyn/plugin-manag
 import { registerPluginContactCaptureWriter } from "@aglyn/aglyn/plugin-manager/plugin-contact-capture";
 import { registerPluginLeadConversionListener } from "@aglyn/aglyn/plugin-manager/plugin-lead-conversion";
 import { registerPluginPersonMatcher } from "@aglyn/aglyn/plugin-manager/plugin-person-matches";
+import { registerPluginPersonRecords } from "@aglyn/aglyn/plugin-manager/plugin-person-records";
 import { registerPluginRecordIndex } from "@aglyn/aglyn/plugin-manager/plugin-record-index";
 import { registerPluginRecordEmailStateWriter } from "@aglyn/aglyn/plugin-manager/plugin-record-email-state";
+import { registerPluginRecordOriginWriter } from "@aglyn/aglyn/plugin-manager/plugin-record-origin";
 import { registerPluginRecordTimelineWriter } from "@aglyn/aglyn/plugin-manager/plugin-record-timeline";
 import { registerPluginRecordWrittenListener } from "@aglyn/aglyn/plugin-manager/plugin-record-written";
+import { registerServerStepExecutor } from "@aglyn/aglyn/plugin-manager/plugin-server-steps";
 import { registerPluginUsageMeter } from "@aglyn/aglyn/plugin-manager/plugin-usage-meters";
-import { BUNDLE_ID, CRM_RECORDS_METER_ID } from "./constants/bundle-common.js";
+import { BUNDLE_ID, CRM_RECORDS_METER_ID, CRM_STEP_TYPES } from "./constants/bundle-common.js";
 import { summarizeConsentGroupChange } from "./model/consent-group-summary.js";
 /**
  * The CRM as the plugin that keeps people.
@@ -40,6 +43,36 @@ import { summarizeConsentGroupChange } from "./model/consent-group-summary.js";
         return await captureContactForCrm(request);
     }
 };
+/**
+ * The CRM as the plugin other plugins ask for people (AGL-3080), deferred
+ * like the capture: `server/person-records.ts` and the Admin SDK it brings
+ * load with the first question, not when the process starts.
+ */ export const crmPersonRecordsService = {
+    async find (request) {
+        const { crmPersonRecords } = await import("./server/person-records.js");
+        return crmPersonRecords.find(request);
+    },
+    async read (request) {
+        const { crmPersonRecords } = await import("./server/person-records.js");
+        return crmPersonRecords.read(request);
+    },
+    async fileUnder (request) {
+        const { crmPersonRecords } = await import("./server/person-records.js");
+        return crmPersonRecords.fileUnder(request);
+    },
+    async recordRefund (request) {
+        const { crmPersonRecords } = await import("./server/person-records.js");
+        return crmPersonRecords.recordRefund(request);
+    },
+    async peopleInView (request) {
+        const { crmPersonRecords } = await import("./server/person-records.js");
+        return crmPersonRecords.peopleInView(request);
+    },
+    async wroteIn (request) {
+        const { crmPersonRecords } = await import("./server/person-records.js");
+        return crmPersonRecords.wroteIn(request);
+    }
+};
 /**
  * The `pipeline` record index, its reads loaded with the first one — see
  * `server/pipeline-record-index.ts` for what it answers.
@@ -53,6 +86,20 @@ import { summarizeConsentGroupChange } from "./model/consent-group-summary.js";
         return pipelineRecordIndex.get(request);
     }
 };
+/** One of `server/crm-record-indexes.ts`'s indexes, its reads loaded with the first one. */ function lazyCrmRecordIndex(kind) {
+    return {
+        async list (request) {
+            const { crmRecordIndexes } = await import("./server/crm-record-indexes.js");
+            return crmRecordIndexes()[kind].list(request);
+        },
+        async get (request) {
+            const { crmRecordIndexes } = await import("./server/crm-record-indexes.js");
+            return crmRecordIndexes()[kind].get(request);
+        }
+    };
+}
+/** The companies a person works for, as another plugin reads them (AGL-3080). */ export const crmCompanyRecordIndex = lazyCrmRecordIndex('company');
+/** The email templates and snippets reps write, as another plugin reads them (AGL-3080). */ export const crmMessageTemplateRecordIndex = lazyCrmRecordIndex('messageTemplate');
 /**
  * The CRM's writer on the record-timeline seam (AGL-2981), deferred: the
  * writer and the Admin SDK it brings load with the first entry filed.
@@ -68,6 +115,12 @@ import { summarizeConsentGroupChange } from "./model/consent-group-summary.js";
     async recordEmailDelivery (request) {
         const { createCrmRecordTimelineWriter, defaultCrmRecordTimelineDeps } = await import("./server/record-timeline.js");
         return createCrmRecordTimelineWriter(defaultCrmRecordTimelineDeps()).recordEmailDelivery(request);
+    },
+    // An automation's email to the person its event is about, filed on that
+    // person's timeline with its delivery state (AGL-2615, AGL-3080).
+    async prepareEmail (request) {
+        const { prepareCrmRecordEmail } = await import("./server/automation-steps.js");
+        return prepareCrmRecordEmail(request);
     }
 };
 /**
@@ -96,6 +149,13 @@ import { summarizeConsentGroupChange } from "./model/consent-group-summary.js";
     registerPluginContactCaptureWriter(crmContactCaptureWriter, {
         pluginId: BUNDLE_ID
     });
+    // The other half of keeping people (AGL-3080): another plugin that holds
+    // an address, or a record the CRM handed it, asks here for the person —
+    // a flow email's consent read, a refund, an automation filing somebody
+    // under a campaign — and never opens the CRM's collections itself.
+    registerPluginPersonRecords(crmPersonRecordsService, {
+        pluginId: BUNDLE_ID
+    });
     // The CRM's own share of a lead conversion (AGL-3254): the lead's
     // campaigns go onto the contact's facet. Through the seam every door
     // that converts a lead reaches, and deferred like the capture: the
@@ -146,6 +206,11 @@ import { summarizeConsentGroupChange } from "./model/consent-group-summary.js";
         async reached (request) {
             const { createCrmRecordEmailStateWriter, defaultCrmRecordEmailStateDeps } = await import("./server/record-email-state.js");
             return createCrmRecordEmailStateWriter(defaultCrmRecordEmailStateDeps()).reached(request);
+        },
+        // A lead that wrote back, moved to Working (AGL-3080).
+        async replied (request) {
+            const { createCrmRecordEmailStateWriter, defaultCrmRecordEmailStateDeps } = await import("./server/record-email-state.js");
+            return createCrmRecordEmailStateWriter(defaultCrmRecordEmailStateDeps()).replied(request);
         }
     }, {
         pluginId: BUNDLE_ID
@@ -158,6 +223,18 @@ import { summarizeConsentGroupChange } from "./model/consent-group-summary.js";
     registerPluginRecordTimelineWriter(crmRecordTimelineWriter, {
         pluginId: BUNDLE_ID
     });
+    // Where a person came from (AGL-3519): a door the CRM does not run — the
+    // platform's account sign-up, a sequence enrolling someone — names its
+    // origin, and the CRM stamps the built-in Lead source on a record holding
+    // none. Deferred like the rest.
+    registerPluginRecordOriginWriter({
+        async stamp (request) {
+            const { crmRecordOriginWriter } = await import("./server/record-origin.js");
+            return crmRecordOriginWriter.stamp(request);
+        }
+    }, {
+        pluginId: BUNDLE_ID
+    });
     // Sharing rules (AGL-3336), re-evaluated after every server write of a
     // lead, a contact, a company or a deal: the core tells its record-written
     // listeners from the list-field restamp every such writer ends with, in
@@ -176,6 +253,20 @@ import { summarizeConsentGroupChange } from "./model/consent-group-summary.js";
     registerPluginRecordIndex('pipeline', crmPipelineRecordIndex, {
         pluginId: BUNDLE_ID
     });
+    // The company a person works for, and the templates reps write, as a sales
+    // sequence reads them (AGL-3080). Deferred like the rest.
+    registerPluginRecordIndex('company', crmCompanyRecordIndex, {
+        pluginId: BUNDLE_ID
+    });
+    registerPluginRecordIndex('messageTemplate', crmMessageTemplateRecordIndex, {
+        pluginId: BUNDLE_ID
+    });
+    // The automation steps that write the CRM (AGL-2605, AGL-3080), run for the
+    // workflows engine through the server-step seam and declared under
+    // `serverSteps`. Deferred like the rest: the writes load with the first step.
+    registerServerStepExecutor(CRM_STEP_TYPES, async (request)=>(await import("./server/automation-steps.js")).runCrmAutomationStep(request), {
+        pluginId: BUNDLE_ID
+    });
     registerPluginConsentGroupParticipant({
         async preview (request) {
             const { consentGroupParticipant } = await import("./server/consent-group-participant.js");

package/src/lib/declarations.server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/crm/src/lib/declarations.server.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// The contract from its own module, not the plugin-manager barrel: boot needs\n// the registry and nothing else, and the barrel reaches the client contexts.\nimport { registerPluginConsentGroupParticipant } from '@aglyn/aglyn/plugin-manager/plugin-consent-group-change'\nimport {\n  registerPluginContactCaptureWriter,\n  type PluginContactCaptureWriter,\n} from '@aglyn/aglyn/plugin-manager/plugin-contact-capture'\nimport { registerPluginLeadConversionListener } from '@aglyn/aglyn/plugin-manager/plugin-lead-conversion'\nimport { registerPluginPersonMatcher } from '@aglyn/aglyn/plugin-manager/plugin-person-matches'\nimport {\n  registerPluginRecordIndex,\n  type PluginRecordIndex,\n} from '@aglyn/aglyn/plugin-manager/plugin-record-index'\nimport { registerPluginRecordEmailStateWriter } from '@aglyn/aglyn/plugin-manager/plugin-record-email-state'\nimport {\n  registerPluginRecordTimelineWriter,\n  type PluginRecordTimelineWriter,\n} from '@aglyn/aglyn/plugin-manager/plugin-record-timeline'\nimport { registerPluginRecordWrittenListener } from '@aglyn/aglyn/plugin-manager/plugin-record-written'\nimport { registerPluginUsageMeter } from '@aglyn/aglyn/plugin-manager/plugin-usage-meters'\nimport { BUNDLE_ID, CRM_RECORDS_METER_ID } from './constants/bundle-common'\nimport { summarizeConsentGroupChange } from './model/consent-group-summary'\n\n/**\n * The CRM as the plugin that keeps people.\n *\n * Light by construction, the way the workflows listener is: the capture\n * itself is imported when the first one arrives, not when the process\n * starts, so a process that never captures anybody pays for this object and\n * nothing else. That matters because this registers in EVERY server process,\n * including ones that will never touch the CRM.\n */\nexport const crmContactCaptureWriter: PluginContactCaptureWriter = {\n  async capture(request) {\n    const { captureContactForCrm } = await import('./server/capture-contact')\n    return await captureContactForCrm(request)\n  },\n}\n\n/**\n * The `pipeline` record index, its reads loaded with the first one — see\n * `server/pipeline-record-index.ts` for what it answers.\n */\nexport const crmPipelineRecordIndex: PluginRecordIndex = {\n  async list(request) {\n    const { pipelineRecordIndex } = await import('./server/pipeline-record-index')\n    return pipelineRecordIndex.list(request)\n  },\n  async get(request) {\n    const { pipelineRecordIndex } = await import('./server/pipeline-record-index')\n    return pipelineRecordIndex.get(request)\n  },\n}\n\n/**\n * The CRM's writer on the record-timeline seam (AGL-2981), deferred: the\n * writer and the Admin SDK it brings load with the first entry filed.\n */\nexport const crmRecordTimelineWriter: PluginRecordTimelineWriter = {\n  async logActivity(request) {\n    const { createCrmRecordTimelineWriter, defaultCrmRecordTimelineDeps } =\n      await import('./server/record-timeline')\n    return createCrmRecordTimelineWriter(defaultCrmRecordTimelineDeps()).logActivity(request)\n  },\n  async createTask(request) {\n    const { createCrmRecordTimelineWriter, defaultCrmRecordTimelineDeps } =\n      await import('./server/record-timeline')\n    return createCrmRecordTimelineWriter(defaultCrmRecordTimelineDeps()).createTask(request)\n  },\n  async recordEmailDelivery(request) {\n    const { createCrmRecordTimelineWriter, defaultCrmRecordTimelineDeps } =\n      await import('./server/record-timeline')\n    return createCrmRecordTimelineWriter(defaultCrmRecordTimelineDeps()).recordEmailDelivery!(request)\n  },\n}\n\n/**\n * The plugin's SERVER declarations: what the server must know at boot, before\n * any door of the CRM has been called.\n *\n * ## Why a declaration and not a `tenantApi` registration\n *\n * The doors that meet a person mostly never load this plugin. A form\n * submission is a core route; an order and a booking are captured inside\n * STRIPE WEBHOOKS. None of them has a reason to load the CRM, and a registry\n * filled by a surface that did not load answers `null` — which\n * `capturePluginContact` defines as \"this workspace has no record system\", a\n * sentence that would be false and silent. Orders would stop creating\n * contacts with nothing red anywhere, which is the AGL-3025 shape.\n *\n * Running from both apps' generated server-declarations manifest at boot is\n * what makes the answer true in every process. It is also called from the\n * plugin's own API register functions, so a process whose boot did not run it\n * still registers the writer the first time a CRM door loads. Registering\n * twice replaces in place.\n *\n * ⚠️ The registry holds ONE writer: a workspace keeps one set of people. A\n * second plugin's is refused naming both, and the incumbent keeps serving.\n */\nexport function registerCrmServerDeclarations(): void {\n  registerPluginContactCaptureWriter(crmContactCaptureWriter, {\n    pluginId: BUNDLE_ID,\n  })\n  // The CRM's own share of a lead conversion (AGL-3254): the lead's\n  // campaigns go onto the contact's facet. Through the seam every door\n  // that converts a lead reaches, and deferred like the capture: the\n  // module that writes is loaded when the first conversion arrives, and\n  // it brings the Admin SDK with it — this file defers the plugin's OWN\n  // module only. A library imported statically across the plugin cannot\n  // also be lazy-loaded here: `enforce-module-boundaries` refuses every\n  // static import of a library the project lazy-loads anywhere.\n  registerPluginLeadConversionListener(\n    async (request) => {\n      const { carryLeadCampaignsOnConversion } =\n        await import('./server/lead-campaign-carry')\n      return carryLeadCampaignsOnConversion(request)\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  // \"Did this workspace already know this person?\" (AGL-3289), asked by the\n  // staff console's acquisition card. Deferred like the rest: the reads load\n  // when a staff member first opens a card, not when the process starts.\n  registerPluginPersonMatcher(\n    async (request) => {\n      const { matchCrmPeople } = await import('./server/person-matches')\n      return matchCrmPeople(request)\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  // The CRM's share of a consent group change (AGL-3320): a contact's\n  // per-site refusal carried across a separation, and the records keyed by a\n  // group re-homed after the flip. Registered whether or not a workspace has\n  // the CRM switched on, because the contacts — and the refusals on them —\n  // outlive the switch. Deferred like the rest; the summary is plain words\n  // and answers synchronously.\n  // The record email-state writer (AGL-3245), here as well as in the console\n  // API so the tenant's doors reach it too: a form submission's capture is\n  // checked for deliverability after its response (AGL-3328), and the \"Would\n  // bounce\" that check finds is written through this seam. Deferred like the\n  // rest; the console's own registration replaces this one with the same\n  // writer, loaded eagerly.\n  registerPluginRecordEmailStateWriter(\n    {\n      async stamp(request) {\n        const { createCrmRecordEmailStateWriter, defaultCrmRecordEmailStateDeps } =\n          await import('./server/record-email-state')\n        return createCrmRecordEmailStateWriter(defaultCrmRecordEmailStateDeps()).stamp(request)\n      },\n      // A send's first opens and clicks, stamped on the contacts they name\n      // (AGL-2616) — the campaign webhook's courtesy, deferred like the rest.\n      async engaged(request) {\n        const { createCrmRecordEmailStateWriter, defaultCrmRecordEmailStateDeps } =\n          await import('./server/record-email-state')\n        return createCrmRecordEmailStateWriter(defaultCrmRecordEmailStateDeps()).engaged!(request)\n      },\n      // A delivered campaign's leads, moved to Nurturing (AGL-3446).\n      async reached(request) {\n        const { createCrmRecordEmailStateWriter, defaultCrmRecordEmailStateDeps } =\n          await import('./server/record-email-state')\n        return createCrmRecordEmailStateWriter(defaultCrmRecordEmailStateDeps()).reached!(request)\n      },\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  // The record timeline writer (AGL-2981), here as well as in the API\n  // surfaces so a door in either app reaches it: a booking confirmed on the\n  // tenant, or by the payment webhook, files its meeting and follow-up\n  // through it (AGL-2660). Deferred like the rest; an API registration\n  // replaces this one with the same writer, loaded eagerly.\n  registerPluginRecordTimelineWriter(crmRecordTimelineWriter, { pluginId: BUNDLE_ID })\n  // Sharing rules (AGL-3336), re-evaluated after every server write of a\n  // lead, a contact, a company or a deal: the core tells its record-written\n  // listeners from the list-field restamp every such writer ends with, in\n  // both apps — a form's capture on the tenant, an edit in the console.\n  // Deferred like the rest: an org with no rules pays one cached read.\n  registerPluginRecordWrittenListener(\n    async (event) => {\n      const { crmSharingRecordWritten } = await import('./server/crm-sharing')\n      await crmSharingRecordWritten(event)\n    },\n    { pluginId: BUNDLE_ID, key: 'sharing' },\n  )\n  // The organization's pipelines and their stages, as another plugin reads\n  // them (AGL-3080): an automation the AI drafts names the stage a deal\n  // moves to. Deferred like the rest: the reads load with the first one.\n  registerPluginRecordIndex('pipeline', crmPipelineRecordIndex, { pluginId: BUNDLE_ID })\n  registerPluginConsentGroupParticipant(\n    {\n      async preview(request) {\n        const { consentGroupParticipant } = await import('./server/consent-group-participant')\n        return consentGroupParticipant.preview(request)\n      },\n      async run(request) {\n        const { consentGroupParticipant } = await import('./server/consent-group-participant')\n        return consentGroupParticipant.run(request)\n      },\n      summarize: summarizeConsentGroupChange,\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  // The records band in the monthly usage sweep, a core cron that never\n  // loads a CRM door; declared in `usageAxes` so the sweep refuses to bill a\n  // month without it. Deferred like the rest: the counts load with the\n  // first sweep.\n  registerPluginUsageMeter({\n    pluginId: BUNDLE_ID,\n    id: CRM_RECORDS_METER_ID,\n    measure: async (context) => {\n      const { measureCrmRecords } = await import('./server/crm-records-meter')\n      return measureCrmRecords(context)\n    },\n  })\n}\n\n"],"names":["registerPluginConsentGroupParticipant","registerPluginContactCaptureWriter","registerPluginLeadConversionListener","registerPluginPersonMatcher","registerPluginRecordIndex","registerPluginRecordEmailStateWriter","registerPluginRecordTimelineWriter","registerPluginRecordWrittenListener","registerPluginUsageMeter","BUNDLE_ID","CRM_RECORDS_METER_ID","summarizeConsentGroupChange","crmContactCaptureWriter","capture","request","captureContactForCrm","crmPipelineRecordIndex","list","pipelineRecordIndex","get","crmRecordTimelineWriter","logActivity","createCrmRecordTimelineWriter","defaultCrmRecordTimelineDeps","createTask","recordEmailDelivery","registerCrmServerDeclarations","pluginId","carryLeadCampaignsOnConversion","matchCrmPeople","stamp","createCrmRecordEmailStateWriter","defaultCrmRecordEmailStateDeps","engaged","reached","event","crmSharingRecordWritten","key","preview","consentGroupParticipant","run","summarize","id","measure","context","measureCrmRecords"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../libs/plugins/crm/src/lib/declarations.server.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// The contract from its own module, not the plugin-manager barrel: boot needs\n// the registry and nothing else, and the barrel reaches the client contexts.\nimport { registerPluginConsentGroupParticipant } from '@aglyn/aglyn/plugin-manager/plugin-consent-group-change'\nimport {\n  registerPluginContactCaptureWriter,\n  type PluginContactCaptureWriter,\n} from '@aglyn/aglyn/plugin-manager/plugin-contact-capture'\nimport { registerPluginLeadConversionListener } from '@aglyn/aglyn/plugin-manager/plugin-lead-conversion'\nimport { registerPluginPersonMatcher } from '@aglyn/aglyn/plugin-manager/plugin-person-matches'\nimport {\n  registerPluginPersonRecords,\n  type PluginPersonRecords,\n} from '@aglyn/aglyn/plugin-manager/plugin-person-records'\nimport {\n  registerPluginRecordIndex,\n  type PluginRecordIndex,\n} from '@aglyn/aglyn/plugin-manager/plugin-record-index'\nimport { registerPluginRecordEmailStateWriter } from '@aglyn/aglyn/plugin-manager/plugin-record-email-state'\nimport { registerPluginRecordOriginWriter } from '@aglyn/aglyn/plugin-manager/plugin-record-origin'\nimport {\n  registerPluginRecordTimelineWriter,\n  type PluginRecordTimelineWriter,\n} from '@aglyn/aglyn/plugin-manager/plugin-record-timeline'\nimport { registerPluginRecordWrittenListener } from '@aglyn/aglyn/plugin-manager/plugin-record-written'\nimport { registerServerStepExecutor } from '@aglyn/aglyn/plugin-manager/plugin-server-steps'\nimport { registerPluginUsageMeter } from '@aglyn/aglyn/plugin-manager/plugin-usage-meters'\nimport { BUNDLE_ID, CRM_RECORDS_METER_ID, CRM_STEP_TYPES } from './constants/bundle-common'\nimport { summarizeConsentGroupChange } from './model/consent-group-summary'\n\n/**\n * The CRM as the plugin that keeps people.\n *\n * Light by construction, the way the workflows listener is: the capture\n * itself is imported when the first one arrives, not when the process\n * starts, so a process that never captures anybody pays for this object and\n * nothing else. That matters because this registers in EVERY server process,\n * including ones that will never touch the CRM.\n */\nexport const crmContactCaptureWriter: PluginContactCaptureWriter = {\n  async capture(request) {\n    const { captureContactForCrm } = await import('./server/capture-contact')\n    return await captureContactForCrm(request)\n  },\n}\n\n/**\n * The CRM as the plugin other plugins ask for people (AGL-3080), deferred\n * like the capture: `server/person-records.ts` and the Admin SDK it brings\n * load with the first question, not when the process starts.\n */\nexport const crmPersonRecordsService: PluginPersonRecords = {\n  async find(request) {\n    const { crmPersonRecords } = await import('./server/person-records')\n    return crmPersonRecords.find(request)\n  },\n  async read(request) {\n    const { crmPersonRecords } = await import('./server/person-records')\n    return crmPersonRecords.read(request)\n  },\n  async fileUnder(request) {\n    const { crmPersonRecords } = await import('./server/person-records')\n    return crmPersonRecords.fileUnder(request)\n  },\n  async recordRefund(request) {\n    const { crmPersonRecords } = await import('./server/person-records')\n    return crmPersonRecords.recordRefund(request)\n  },\n  async peopleInView(request) {\n    const { crmPersonRecords } = await import('./server/person-records')\n    return crmPersonRecords.peopleInView(request)\n  },\n  async wroteIn(request) {\n    const { crmPersonRecords } = await import('./server/person-records')\n    return crmPersonRecords.wroteIn(request)\n  },\n}\n\n/**\n * The `pipeline` record index, its reads loaded with the first one — see\n * `server/pipeline-record-index.ts` for what it answers.\n */\nexport const crmPipelineRecordIndex: PluginRecordIndex = {\n  async list(request) {\n    const { pipelineRecordIndex } = await import('./server/pipeline-record-index')\n    return pipelineRecordIndex.list(request)\n  },\n  async get(request) {\n    const { pipelineRecordIndex } = await import('./server/pipeline-record-index')\n    return pipelineRecordIndex.get(request)\n  },\n}\n\n/** One of `server/crm-record-indexes.ts`'s indexes, its reads loaded with the first one. */\nfunction lazyCrmRecordIndex(kind: 'company' | 'messageTemplate'): PluginRecordIndex {\n  return {\n    async list(request) {\n      const { crmRecordIndexes } = await import('./server/crm-record-indexes')\n      return crmRecordIndexes()[kind].list(request)\n    },\n    async get(request) {\n      const { crmRecordIndexes } = await import('./server/crm-record-indexes')\n      return crmRecordIndexes()[kind].get(request)\n    },\n  }\n}\n\n/** The companies a person works for, as another plugin reads them (AGL-3080). */\nexport const crmCompanyRecordIndex = lazyCrmRecordIndex('company')\n\n/** The email templates and snippets reps write, as another plugin reads them (AGL-3080). */\nexport const crmMessageTemplateRecordIndex = lazyCrmRecordIndex('messageTemplate')\n\n/**\n * The CRM's writer on the record-timeline seam (AGL-2981), deferred: the\n * writer and the Admin SDK it brings load with the first entry filed.\n */\nexport const crmRecordTimelineWriter: PluginRecordTimelineWriter = {\n  async logActivity(request) {\n    const { createCrmRecordTimelineWriter, defaultCrmRecordTimelineDeps } =\n      await import('./server/record-timeline')\n    return createCrmRecordTimelineWriter(defaultCrmRecordTimelineDeps()).logActivity(request)\n  },\n  async createTask(request) {\n    const { createCrmRecordTimelineWriter, defaultCrmRecordTimelineDeps } =\n      await import('./server/record-timeline')\n    return createCrmRecordTimelineWriter(defaultCrmRecordTimelineDeps()).createTask(request)\n  },\n  async recordEmailDelivery(request) {\n    const { createCrmRecordTimelineWriter, defaultCrmRecordTimelineDeps } =\n      await import('./server/record-timeline')\n    return createCrmRecordTimelineWriter(defaultCrmRecordTimelineDeps()).recordEmailDelivery!(request)\n  },\n  // An automation's email to the person its event is about, filed on that\n  // person's timeline with its delivery state (AGL-2615, AGL-3080).\n  async prepareEmail(request) {\n    const { prepareCrmRecordEmail } = await import('./server/automation-steps')\n    return prepareCrmRecordEmail(request)\n  },\n}\n\n/**\n * The plugin's SERVER declarations: what the server must know at boot, before\n * any door of the CRM has been called.\n *\n * ## Why a declaration and not a `tenantApi` registration\n *\n * The doors that meet a person mostly never load this plugin. A form\n * submission is a core route; an order and a booking are captured inside\n * STRIPE WEBHOOKS. None of them has a reason to load the CRM, and a registry\n * filled by a surface that did not load answers `null` — which\n * `capturePluginContact` defines as \"this workspace has no record system\", a\n * sentence that would be false and silent. Orders would stop creating\n * contacts with nothing red anywhere, which is the AGL-3025 shape.\n *\n * Running from both apps' generated server-declarations manifest at boot is\n * what makes the answer true in every process. It is also called from the\n * plugin's own API register functions, so a process whose boot did not run it\n * still registers the writer the first time a CRM door loads. Registering\n * twice replaces in place.\n *\n * ⚠️ The registry holds ONE writer: a workspace keeps one set of people. A\n * second plugin's is refused naming both, and the incumbent keeps serving.\n */\nexport function registerCrmServerDeclarations(): void {\n  registerPluginContactCaptureWriter(crmContactCaptureWriter, {\n    pluginId: BUNDLE_ID,\n  })\n  // The other half of keeping people (AGL-3080): another plugin that holds\n  // an address, or a record the CRM handed it, asks here for the person —\n  // a flow email's consent read, a refund, an automation filing somebody\n  // under a campaign — and never opens the CRM's collections itself.\n  registerPluginPersonRecords(crmPersonRecordsService, { pluginId: BUNDLE_ID })\n  // The CRM's own share of a lead conversion (AGL-3254): the lead's\n  // campaigns go onto the contact's facet. Through the seam every door\n  // that converts a lead reaches, and deferred like the capture: the\n  // module that writes is loaded when the first conversion arrives, and\n  // it brings the Admin SDK with it — this file defers the plugin's OWN\n  // module only. A library imported statically across the plugin cannot\n  // also be lazy-loaded here: `enforce-module-boundaries` refuses every\n  // static import of a library the project lazy-loads anywhere.\n  registerPluginLeadConversionListener(\n    async (request) => {\n      const { carryLeadCampaignsOnConversion } =\n        await import('./server/lead-campaign-carry')\n      return carryLeadCampaignsOnConversion(request)\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  // \"Did this workspace already know this person?\" (AGL-3289), asked by the\n  // staff console's acquisition card. Deferred like the rest: the reads load\n  // when a staff member first opens a card, not when the process starts.\n  registerPluginPersonMatcher(\n    async (request) => {\n      const { matchCrmPeople } = await import('./server/person-matches')\n      return matchCrmPeople(request)\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  // The CRM's share of a consent group change (AGL-3320): a contact's\n  // per-site refusal carried across a separation, and the records keyed by a\n  // group re-homed after the flip. Registered whether or not a workspace has\n  // the CRM switched on, because the contacts — and the refusals on them —\n  // outlive the switch. Deferred like the rest; the summary is plain words\n  // and answers synchronously.\n  // The record email-state writer (AGL-3245), here as well as in the console\n  // API so the tenant's doors reach it too: a form submission's capture is\n  // checked for deliverability after its response (AGL-3328), and the \"Would\n  // bounce\" that check finds is written through this seam. Deferred like the\n  // rest; the console's own registration replaces this one with the same\n  // writer, loaded eagerly.\n  registerPluginRecordEmailStateWriter(\n    {\n      async stamp(request) {\n        const { createCrmRecordEmailStateWriter, defaultCrmRecordEmailStateDeps } =\n          await import('./server/record-email-state')\n        return createCrmRecordEmailStateWriter(defaultCrmRecordEmailStateDeps()).stamp(request)\n      },\n      // A send's first opens and clicks, stamped on the contacts they name\n      // (AGL-2616) — the campaign webhook's courtesy, deferred like the rest.\n      async engaged(request) {\n        const { createCrmRecordEmailStateWriter, defaultCrmRecordEmailStateDeps } =\n          await import('./server/record-email-state')\n        return createCrmRecordEmailStateWriter(defaultCrmRecordEmailStateDeps()).engaged!(request)\n      },\n      // A delivered campaign's leads, moved to Nurturing (AGL-3446).\n      async reached(request) {\n        const { createCrmRecordEmailStateWriter, defaultCrmRecordEmailStateDeps } =\n          await import('./server/record-email-state')\n        return createCrmRecordEmailStateWriter(defaultCrmRecordEmailStateDeps()).reached!(request)\n      },\n      // A lead that wrote back, moved to Working (AGL-3080).\n      async replied(request) {\n        const { createCrmRecordEmailStateWriter, defaultCrmRecordEmailStateDeps } =\n          await import('./server/record-email-state')\n        return createCrmRecordEmailStateWriter(defaultCrmRecordEmailStateDeps()).replied!(request)\n      },\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  // The record timeline writer (AGL-2981), here as well as in the API\n  // surfaces so a door in either app reaches it: a booking confirmed on the\n  // tenant, or by the payment webhook, files its meeting and follow-up\n  // through it (AGL-2660). Deferred like the rest; an API registration\n  // replaces this one with the same writer, loaded eagerly.\n  registerPluginRecordTimelineWriter(crmRecordTimelineWriter, { pluginId: BUNDLE_ID })\n  // Where a person came from (AGL-3519): a door the CRM does not run — the\n  // platform's account sign-up, a sequence enrolling someone — names its\n  // origin, and the CRM stamps the built-in Lead source on a record holding\n  // none. Deferred like the rest.\n  registerPluginRecordOriginWriter(\n    {\n      async stamp(request) {\n        const { crmRecordOriginWriter } = await import('./server/record-origin')\n        return crmRecordOriginWriter.stamp(request)\n      },\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  // Sharing rules (AGL-3336), re-evaluated after every server write of a\n  // lead, a contact, a company or a deal: the core tells its record-written\n  // listeners from the list-field restamp every such writer ends with, in\n  // both apps — a form's capture on the tenant, an edit in the console.\n  // Deferred like the rest: an org with no rules pays one cached read.\n  registerPluginRecordWrittenListener(\n    async (event) => {\n      const { crmSharingRecordWritten } = await import('./server/crm-sharing')\n      await crmSharingRecordWritten(event)\n    },\n    { pluginId: BUNDLE_ID, key: 'sharing' },\n  )\n  // The organization's pipelines and their stages, as another plugin reads\n  // them (AGL-3080): an automation the AI drafts names the stage a deal\n  // moves to. Deferred like the rest: the reads load with the first one.\n  registerPluginRecordIndex('pipeline', crmPipelineRecordIndex, { pluginId: BUNDLE_ID })\n  // The company a person works for, and the templates reps write, as a sales\n  // sequence reads them (AGL-3080). Deferred like the rest.\n  registerPluginRecordIndex('company', crmCompanyRecordIndex, { pluginId: BUNDLE_ID })\n  registerPluginRecordIndex('messageTemplate', crmMessageTemplateRecordIndex, { pluginId: BUNDLE_ID })\n  // The automation steps that write the CRM (AGL-2605, AGL-3080), run for the\n  // workflows engine through the server-step seam and declared under\n  // `serverSteps`. Deferred like the rest: the writes load with the first step.\n  registerServerStepExecutor(\n    CRM_STEP_TYPES,\n    async (request) => (await import('./server/automation-steps')).runCrmAutomationStep(request),\n    { pluginId: BUNDLE_ID },\n  )\n  registerPluginConsentGroupParticipant(\n    {\n      async preview(request) {\n        const { consentGroupParticipant } = await import('./server/consent-group-participant')\n        return consentGroupParticipant.preview(request)\n      },\n      async run(request) {\n        const { consentGroupParticipant } = await import('./server/consent-group-participant')\n        return consentGroupParticipant.run(request)\n      },\n      summarize: summarizeConsentGroupChange,\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  // The records band in the monthly usage sweep, a core cron that never\n  // loads a CRM door; declared in `usageAxes` so the sweep refuses to bill a\n  // month without it. Deferred like the rest: the counts load with the\n  // first sweep.\n  registerPluginUsageMeter({\n    pluginId: BUNDLE_ID,\n    id: CRM_RECORDS_METER_ID,\n    measure: async (context) => {\n      const { measureCrmRecords } = await import('./server/crm-records-meter')\n      return measureCrmRecords(context)\n    },\n  })\n}\n\n"],"names":["registerPluginConsentGroupParticipant","registerPluginContactCaptureWriter","registerPluginLeadConversionListener","registerPluginPersonMatcher","registerPluginPersonRecords","registerPluginRecordIndex","registerPluginRecordEmailStateWriter","registerPluginRecordOriginWriter","registerPluginRecordTimelineWriter","registerPluginRecordWrittenListener","registerServerStepExecutor","registerPluginUsageMeter","BUNDLE_ID","CRM_RECORDS_METER_ID","CRM_STEP_TYPES","summarizeConsentGroupChange","crmContactCaptureWriter","capture","request","captureContactForCrm","crmPersonRecordsService","find","crmPersonRecords","read","fileUnder","recordRefund","peopleInView","wroteIn","crmPipelineRecordIndex","list","pipelineRecordIndex","get","lazyCrmRecordIndex","kind","crmRecordIndexes","crmCompanyRecordIndex","crmMessageTemplateRecordIndex","crmRecordTimelineWriter","logActivity","createCrmRecordTimelineWriter","defaultCrmRecordTimelineDeps","createTask","recordEmailDelivery","prepareEmail","prepareCrmRecordEmail","registerCrmServerDeclarations","pluginId","carryLeadCampaignsOnConversion","matchCrmPeople","stamp","createCrmRecordEmailStateWriter","defaultCrmRecordEmailStateDeps","engaged","reached","replied","crmRecordOriginWriter","event","crmSharingRecordWritten","key","runCrmAutomationStep","preview","consentGroupParticipant","run","summarize","id","measure","context","measureCrmRecords"],"mappings":"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"}

package/src/lib/hooks/use-company-picklists.d.ts

@@ -0,0 +1,15 @@
+import type { CrmPicklist, CrmPicklistId } from '@aglyn/aglyn';
+export interface CompanyPicklistsResult {
+    /** Each list a company field holds a value of, by picklist id. */
+    lists: Readonly<Partial<Record<CrmPicklistId, CrmPicklist>>>;
+    /** Every list has answered from the server. */
+    ready: boolean;
+}
+/**
+ * The org's lists behind a company's picklist fields (AGL-3514): Type,
+ * Industry, Rating and Ownership, and the lead source list Account Source
+ * holds a value of. One document listen each, shared with every other
+ * mount asking for the same list.
+ */
+export declare function useCompanyPicklists(orgId: string | null | undefined): CompanyPicklistsResult;
+export default useCompanyPicklists;

package/src/lib/hooks/use-company-picklists.js

@@ -0,0 +1,55 @@
+/**
+ * @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.
+ */ 'use client';
+import { useMemo } from "react";
+import { useCrmPicklist } from "./use-crm-picklist.js";
+/**
+ * The org's lists behind a company's picklist fields (AGL-3514): Type,
+ * Industry, Rating and Ownership, and the lead source list Account Source
+ * holds a value of. One document listen each, shared with every other
+ * mount asking for the same list.
+ */ export function useCompanyPicklists(orgId) {
+    const accountType = useCrmPicklist('accountType', orgId);
+    const industry = useCrmPicklist('industry', orgId);
+    const rating = useCrmPicklist('rating', orgId);
+    const ownership = useCrmPicklist('ownership', orgId);
+    const leadSource = useCrmPicklist('leadSource', orgId);
+    return useMemo(()=>({
+            lists: {
+                accountType: accountType.picklist,
+                industry: industry.picklist,
+                rating: rating.picklist,
+                ownership: ownership.picklist,
+                leadSource: leadSource.picklist
+            },
+            ready: [
+                accountType,
+                industry,
+                rating,
+                ownership,
+                leadSource
+            ].every((list)=>list.ready)
+        }), [
+        accountType,
+        industry,
+        rating,
+        ownership,
+        leadSource
+    ]);
+}
+export default useCompanyPicklists;
+
+//# sourceMappingURL=use-company-picklists.js.map

package/src/lib/hooks/use-company-picklists.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/hooks/use-company-picklists.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'use client'\n\nimport type { CrmPicklist, CrmPicklistId } from '@aglyn/aglyn'\nimport { useMemo } from 'react'\nimport { useCrmPicklist } from './use-crm-picklist'\n\nexport interface CompanyPicklistsResult {\n  /** Each list a company field holds a value of, by picklist id. */\n  lists: Readonly<Partial<Record<CrmPicklistId, CrmPicklist>>>\n  /** Every list has answered from the server. */\n  ready: boolean\n}\n\n/**\n * The org's lists behind a company's picklist fields (AGL-3514): Type,\n * Industry, Rating and Ownership, and the lead source list Account Source\n * holds a value of. One document listen each, shared with every other\n * mount asking for the same list.\n */\nexport function useCompanyPicklists(orgId: string | null | undefined): CompanyPicklistsResult {\n  const accountType = useCrmPicklist('accountType', orgId)\n  const industry = useCrmPicklist('industry', orgId)\n  const rating = useCrmPicklist('rating', orgId)\n  const ownership = useCrmPicklist('ownership', orgId)\n  const leadSource = useCrmPicklist('leadSource', orgId)\n  return useMemo(\n    () => ({\n      lists: {\n        accountType: accountType.picklist,\n        industry: industry.picklist,\n        rating: rating.picklist,\n        ownership: ownership.picklist,\n        leadSource: leadSource.picklist,\n      },\n      ready: [accountType, industry, rating, ownership, leadSource].every((list) => list.ready),\n    }),\n    [accountType, industry, rating, ownership, leadSource],\n  )\n}\n\nexport default useCompanyPicklists\n"],"names":["useMemo","useCrmPicklist","useCompanyPicklists","orgId","accountType","industry","rating","ownership","leadSource","lists","picklist","ready","every","list"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAGA,SAASA,OAAO,QAAQ,QAAO;AAC/B,SAASC,cAAc,QAAQ,wBAAoB;AASnD;;;;;CAKC,GACD,OAAO,SAASC,oBAAoBC,KAAgC;IAClE,MAAMC,cAAcH,eAAe,eAAeE;IAClD,MAAME,WAAWJ,eAAe,YAAYE;IAC5C,MAAMG,SAASL,eAAe,UAAUE;IACxC,MAAMI,YAAYN,eAAe,aAAaE;IAC9C,MAAMK,aAAaP,eAAe,cAAcE;IAChD,OAAOH,QACL,IAAO,CAAA;YACLS,OAAO;gBACLL,aAAaA,YAAYM,QAAQ;gBACjCL,UAAUA,SAASK,QAAQ;gBAC3BJ,QAAQA,OAAOI,QAAQ;gBACvBH,WAAWA,UAAUG,QAAQ;gBAC7BF,YAAYA,WAAWE,QAAQ;YACjC;YACAC,OAAO;gBAACP;gBAAaC;gBAAUC;gBAAQC;gBAAWC;aAAW,CAACI,KAAK,CAAC,CAACC,OAASA,KAAKF,KAAK;QAC1F,CAAA,GACA;QAACP;QAAaC;QAAUC;QAAQC;QAAWC;KAAW;AAE1D;AAEA,eAAeN,oBAAmB"}

package/src/lib/hooks/use-crm-picklist.d.ts

@@ -0,0 +1,25 @@
+import { type CrmPicklist, type CrmPicklistDefinition, type CrmPicklistId } from '@aglyn/aglyn';
+export interface CrmPicklistResult {
+    /** The field the list belongs to — its standard values, groups and targets. */
+    definition: CrmPicklistDefinition;
+    /** The list every picker offers — the org's own values with every standard value. */
+    picklist: CrmPicklist;
+    /** The org has written its own list; false while it reads the standard values alone. */
+    stored: boolean;
+    /** The server has answered, so the list is the org's and not a placeholder. */
+    ready: boolean;
+    /** The document has not been confirmed by the server — `writeGuardedBySeed`'s input. */
+    fromCache: boolean;
+}
+/**
+ * An org's values for one of the CRM's standard picklists (AGL-3510), for
+ * every surface that offers or manages them: a record's select, a create
+ * drawer, a list's filter and the Fields page.
+ *
+ * One document listen, shared by the Firestore SDK across every mount that
+ * asks for the same org and picklist, so a page with the list and a drawer
+ * open pays for it once. `orgId` null issues no read and answers the
+ * standard values, unready.
+ */
+export declare function useCrmPicklist(id: CrmPicklistId, orgId: string | null | undefined): CrmPicklistResult;
+export default useCrmPicklist;

package/src/lib/hooks/use-crm-picklist.js

@@ -0,0 +1,53 @@
+/**
+ * @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.
+ */ 'use client';
+import { CRM_COLLECTIONS, crmPicklistDefinition, effectiveCrmPicklist, normalizeCrmPicklist } from "@aglyn/aglyn";
+import { useFirestore, useFirestoreDoc } from "@aglyn/tenant-feature-instance";
+import { doc } from "firebase/firestore";
+import { useMemo } from "react";
+/**
+ * An org's values for one of the CRM's standard picklists (AGL-3510), for
+ * every surface that offers or manages them: a record's select, a create
+ * drawer, a list's filter and the Fields page.
+ *
+ * One document listen, shared by the Firestore SDK across every mount that
+ * asks for the same org and picklist, so a page with the list and a drawer
+ * open pays for it once. `orgId` null issues no read and answers the
+ * standard values, unready.
+ */ export function useCrmPicklist(id, orgId) {
+    const firestore = useFirestore();
+    const { data, status, fromCache } = useFirestoreDoc(()=>orgId ? doc(firestore, 'orgs', orgId, CRM_COLLECTIONS.picklists, id) : null, [
+        firestore,
+        orgId,
+        id
+    ]);
+    return useMemo(()=>({
+            definition: crmPicklistDefinition(id),
+            picklist: effectiveCrmPicklist(id, data),
+            stored: normalizeCrmPicklist(data) !== null,
+            ready: Boolean(orgId) && status !== 'loading',
+            fromCache
+        }), [
+        id,
+        data,
+        orgId,
+        status,
+        fromCache
+    ]);
+}
+export default useCrmPicklist;
+
+//# sourceMappingURL=use-crm-picklist.js.map