@aglyn/plugins-crm 1.0.0-beta.218 → 1.0.0-beta.219

package/src/lib/usage-axes.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { PluginUsageAxesDeclaration } from '@aglyn/aglyn/plugin-manager/plugin-usage-axes';
+/**
+ * THE CRM'S METER (AGL-3080): the records band — contacts, companies and
+ * deals, counted together — in the platform's cost model and utilization
+ * table. Compiled into core by the manifest generator (`register.usageAxes`).
+ *
+ * Priced at `perContactMonth`. The rate was measured on a contact, the most
+ * expensive of the three to hold, so it over-covers a company or a deal
+ * rather than under-pricing one. `crmRecordsCount` REPLACES `contactsCount`
+ * when a rollup carries it — the contacts are inside the sum, and pricing
+ * both would charge the same people twice — and `contactsCount` alone is
+ * read only on a month written before the band was widened (AGL-2611). The
+ * two components are recorded so the sum stays legible.
+ *
+ * The band is org-wide despite the entitlement's name: the records gate
+ * compares `contactsPerHost` against an org-wide headcount, and the tier
+ * model costs it unexpanded.
+ */
+export declare function crmUsageAxes(): PluginUsageAxesDeclaration;

package/src/lib/usage-axes.js

@@ -0,0 +1,68 @@
+/**
+ * @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 METER (AGL-3080): the records band — contacts, companies and
+ * deals, counted together — in the platform's cost model and utilization
+ * table. Compiled into core by the manifest generator (`register.usageAxes`).
+ *
+ * Priced at `perContactMonth`. The rate was measured on a contact, the most
+ * expensive of the three to hold, so it over-covers a company or a deal
+ * rather than under-pricing one. `crmRecordsCount` REPLACES `contactsCount`
+ * when a rollup carries it — the contacts are inside the sum, and pricing
+ * both would charge the same people twice — and `contactsCount` alone is
+ * read only on a month written before the band was widened (AGL-2611). The
+ * two components are recorded so the sum stays legible.
+ *
+ * The band is org-wide despite the entitlement's name: the records gate
+ * compares `contactsPerHost` against an org-wide headcount, and the tier
+ * model costs it unexpanded.
+ */ export function crmUsageAxes() {
+    return {
+        costAxes: [
+            {
+                id: 'contacts',
+                order: 60,
+                fields: [
+                    'crmRecordsCount'
+                ],
+                fallbackFields: [
+                    'contactsCount'
+                ],
+                recordedFields: [
+                    'companiesCount',
+                    'dealsCount'
+                ],
+                rate: 'perContactMonth'
+            }
+        ],
+        bands: [
+            {
+                id: 'contactsCount',
+                label: 'CRM records',
+                order: 70,
+                fields: [
+                    'crmRecordsCount'
+                ],
+                fallbackFields: [
+                    'contactsCount'
+                ],
+                entitlement: 'contactsPerHost'
+            }
+        ]
+    };
+}
+
+//# sourceMappingURL=usage-axes.js.map

package/src/lib/usage-axes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/plugins/crm/src/lib/usage-axes.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 type { PluginUsageAxesDeclaration } from '@aglyn/aglyn/plugin-manager/plugin-usage-axes'\n\n/**\n * THE CRM'S METER (AGL-3080): the records band — contacts, companies and\n * deals, counted together — in the platform's cost model and utilization\n * table. Compiled into core by the manifest generator (`register.usageAxes`).\n *\n * Priced at `perContactMonth`. The rate was measured on a contact, the most\n * expensive of the three to hold, so it over-covers a company or a deal\n * rather than under-pricing one. `crmRecordsCount` REPLACES `contactsCount`\n * when a rollup carries it — the contacts are inside the sum, and pricing\n * both would charge the same people twice — and `contactsCount` alone is\n * read only on a month written before the band was widened (AGL-2611). The\n * two components are recorded so the sum stays legible.\n *\n * The band is org-wide despite the entitlement's name: the records gate\n * compares `contactsPerHost` against an org-wide headcount, and the tier\n * model costs it unexpanded.\n */\nexport function crmUsageAxes(): PluginUsageAxesDeclaration {\n  return {\n    costAxes: [\n      {\n        id: 'contacts',\n        order: 60,\n        fields: ['crmRecordsCount'],\n        fallbackFields: ['contactsCount'],\n        recordedFields: ['companiesCount', 'dealsCount'],\n        rate: 'perContactMonth',\n      },\n    ],\n    bands: [\n      {\n        id: 'contactsCount',\n        label: 'CRM records',\n        order: 70,\n        fields: ['crmRecordsCount'],\n        fallbackFields: ['contactsCount'],\n        entitlement: 'contactsPerHost',\n      },\n    ],\n  }\n}\n"],"names":["crmUsageAxes","costAxes","id","order","fields","fallbackFields","recordedFields","rate","bands","label","entitlement"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAID;;;;;;;;;;;;;;;;CAgBC,GACD,OAAO,SAASA;IACd,OAAO;QACLC,UAAU;YACR;gBACEC,IAAI;gBACJC,OAAO;gBACPC,QAAQ;oBAAC;iBAAkB;gBAC3BC,gBAAgB;oBAAC;iBAAgB;gBACjCC,gBAAgB;oBAAC;oBAAkB;iBAAa;gBAChDC,MAAM;YACR;SACD;QACDC,OAAO;YACL;gBACEN,IAAI;gBACJO,OAAO;gBACPN,OAAO;gBACPC,QAAQ;oBAAC;iBAAkB;gBAC3BC,gBAAgB;oBAAC;iBAAgB;gBACjCK,aAAa;YACf;SACD;IACH;AACF"}

package/src/lib/components/use-emails-hub-path.d.ts

@@ -1,24 +0,0 @@
-/**
- * The Emails hub of the site this page is on — `/{org}/hosts/{site}/emails`
- * — or `null` when the page is not under a site.
- *
- * The sibling-hub pattern the Emails console uses to reach Marketing, in the
- * other direction: a CRM record page links a campaign entry to the email's
- * own report, which lives on the Emails surface, and the shell's `basePath`
- * names only this surface. Read off the URL rather than derived from
- * `basePath`, because the `[host]` segment is the site's subdomain and
- * nothing a CRM component holds says what that is.
- *
- * ⚠️ Under a site, THIS SITE's hub only. A record page under one site cannot
- * address a sibling site's Emails console without that site's subdomain,
- * which a contact document does not carry.
- *
- * At the ORGANIZATION level (AGL-2634) the URL names no site, and the mount
- * holds the org's site list instead: handed a `hostId`, this answers that
- * site's hub — `${hostsPath}/${subdomain}/emails` — or `null` for a site
- * whose subdomain the list could not answer, which is named and not linked.
- * Handed none, `null`: an org-level page has no hub of its own to fall
- * back to.
- */
-export declare function useEmailsHubPath(hostId?: string | null): string | null;
-export default useEmailsHubPath;

package/src/lib/components/use-emails-hub-path.js

@@ -1,59 +0,0 @@
-/**
- * @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 { buildRoute, Route } from "@aglyn/aglyn";
-import { useParams } from "next/navigation";
-import { useCrmOrgMount } from "../hooks/use-crm-org-mount.js";
-/**
- * The Emails hub of the site this page is on — `/{org}/hosts/{site}/emails`
- * — or `null` when the page is not under a site.
- *
- * The sibling-hub pattern the Emails console uses to reach Marketing, in the
- * other direction: a CRM record page links a campaign entry to the email's
- * own report, which lives on the Emails surface, and the shell's `basePath`
- * names only this surface. Read off the URL rather than derived from
- * `basePath`, because the `[host]` segment is the site's subdomain and
- * nothing a CRM component holds says what that is.
- *
- * ⚠️ Under a site, THIS SITE's hub only. A record page under one site cannot
- * address a sibling site's Emails console without that site's subdomain,
- * which a contact document does not carry.
- *
- * At the ORGANIZATION level (AGL-2634) the URL names no site, and the mount
- * holds the org's site list instead: handed a `hostId`, this answers that
- * site's hub — `${hostsPath}/${subdomain}/emails` — or `null` for a site
- * whose subdomain the list could not answer, which is named and not linked.
- * Handed none, `null`: an org-level page has no hub of its own to fall
- * back to.
- */ export function useEmailsHubPath(hostId) {
-    const params = useParams();
-    const mount = useCrmOrgMount();
-    const orgSlug = params == null ? void 0 : params.orgSlug;
-    const host = params == null ? void 0 : params.host;
-    if (orgSlug && host) {
-        return buildRoute(Route.HOST_PLUGIN, {
-            orgSlug,
-            host,
-            pluginSlug: 'emails'
-        });
-    }
-    if (!mount || !hostId) return null;
-    const subdomain = mount.siteSubdomain(hostId);
-    return subdomain ? `${mount.hostsPath}/${encodeURIComponent(subdomain)}/emails` : null;
-}
-export default useEmailsHubPath;
-
-//# sourceMappingURL=use-emails-hub-path.js.map

package/src/lib/components/use-emails-hub-path.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/use-emails-hub-path.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 { buildRoute, Route } from '@aglyn/aglyn'\nimport { useParams } from 'next/navigation'\nimport { useCrmOrgMount } from '../hooks/use-crm-org-mount'\n\n/**\n * The Emails hub of the site this page is on — `/{org}/hosts/{site}/emails`\n * — or `null` when the page is not under a site.\n *\n * The sibling-hub pattern the Emails console uses to reach Marketing, in the\n * other direction: a CRM record page links a campaign entry to the email's\n * own report, which lives on the Emails surface, and the shell's `basePath`\n * names only this surface. Read off the URL rather than derived from\n * `basePath`, because the `[host]` segment is the site's subdomain and\n * nothing a CRM component holds says what that is.\n *\n * ⚠️ Under a site, THIS SITE's hub only. A record page under one site cannot\n * address a sibling site's Emails console without that site's subdomain,\n * which a contact document does not carry.\n *\n * At the ORGANIZATION level (AGL-2634) the URL names no site, and the mount\n * holds the org's site list instead: handed a `hostId`, this answers that\n * site's hub — `${hostsPath}/${subdomain}/emails` — or `null` for a site\n * whose subdomain the list could not answer, which is named and not linked.\n * Handed none, `null`: an org-level page has no hub of its own to fall\n * back to.\n */\nexport function useEmailsHubPath(hostId?: string | null): string | null {\n  const params = useParams<{ orgSlug: string; host: string }>()\n  const mount = useCrmOrgMount()\n  const orgSlug = params?.orgSlug\n  const host = params?.host\n  if (orgSlug && host) {\n    return buildRoute(Route.HOST_PLUGIN, { orgSlug, host, pluginSlug: 'emails' })\n  }\n  if (!mount || !hostId) return null\n  const subdomain = mount.siteSubdomain(hostId)\n  return subdomain ? `${mount.hostsPath}/${encodeURIComponent(subdomain)}/emails` : null\n}\n\nexport default useEmailsHubPath\n"],"names":["buildRoute","Route","useParams","useCrmOrgMount","useEmailsHubPath","hostId","params","mount","orgSlug","host","HOST_PLUGIN","pluginSlug","subdomain","siteSubdomain","hostsPath","encodeURIComponent"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAASA,UAAU,EAAEC,KAAK,QAAQ,eAAc;AAChD,SAASC,SAAS,QAAQ,kBAAiB;AAC3C,SAASC,cAAc,QAAQ,gCAA4B;AAE3D;;;;;;;;;;;;;;;;;;;;;CAqBC,GACD,OAAO,SAASC,iBAAiBC,MAAsB;IACrD,MAAMC,SAASJ;IACf,MAAMK,QAAQJ;IACd,MAAMK,UAAUF,0BAAAA,OAAQE,OAAO;IAC/B,MAAMC,OAAOH,0BAAAA,OAAQG,IAAI;IACzB,IAAID,WAAWC,MAAM;QACnB,OAAOT,WAAWC,MAAMS,WAAW,EAAE;YAAEF;YAASC;YAAME,YAAY;QAAS;IAC7E;IACA,IAAI,CAACJ,SAAS,CAACF,QAAQ,OAAO;IAC9B,MAAMO,YAAYL,MAAMM,aAAa,CAACR;IACtC,OAAOO,YAAY,GAAGL,MAAMO,SAAS,CAAC,CAAC,EAAEC,mBAAmBH,WAAW,OAAO,CAAC,GAAG;AACpF;AAEA,eAAeR,iBAAgB"}