@aglyn/plugins-commerce 1.0.0-beta.217 → 1.0.0-beta.219

package/src/lib/tenant-emails.js

@@ -0,0 +1,511 @@
+/**
+ * @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 emails a site sends its own customers through Commerce (AGL-769/770).
+ *
+ * Declared here, by the plugin that sends them, and compiled into the
+ * platform's tenant email catalog (`TENANT_EMAILS` in
+ * `@aglyn/shared-util-email`) by `tools/scripts/generate-plugin-manifests.mjs`
+ * (AGL-3080): the catalog's readers include the send path, which loads no
+ * plugin code, so a runtime registry it had not filled would quietly send
+ * the text card in place of the site's designed email. Regenerate after
+ * changing an entry; `--check` refuses a stale catalog.
+ *
+ * Most commerce sends are designable in the email besigner; a `fixed` entry
+ * flips to `besigner` when its send site is wired to `renderHostEmail`
+ * (AGL-770).
+ */ export function commerceTenantEmails() {
+    return [
+        {
+            key: 'order-receipt',
+            name: 'Order receipt',
+            description: 'Sent to the buyer after a successful order or checkout.',
+            pluginId: 'commerce',
+            plugin: 'Commerce',
+            control: 'besigner',
+            defaultSubject: 'Receipt for your order',
+            mergeTokens: [
+                {
+                    name: 'order.summary',
+                    description: 'The ordered items, one per line (with any license/download links)',
+                    sample: 'House Blend × 2 — $24.00'
+                },
+                {
+                    name: 'order.total',
+                    description: 'Order total',
+                    sample: '$24.00'
+                },
+                {
+                    name: 'order.ref',
+                    description: 'Order reference id',
+                    sample: 'cs_test_123'
+                }
+            ],
+            defaultBody: [
+                {
+                    block: 'text',
+                    text: 'Thanks for your purchase!',
+                    variant: 'heading'
+                },
+                {
+                    block: 'text',
+                    text: '{{order.summary}}',
+                    variant: 'body'
+                },
+                {
+                    block: 'text',
+                    text: 'Total: {{order.total}}',
+                    variant: 'body'
+                },
+                {
+                    block: 'text',
+                    text: 'Order reference: {{order.ref}}',
+                    variant: 'caption'
+                }
+            ],
+            footerReason: 'You’re receiving this because you placed an order with {{host.businessName}}.'
+        },
+        {
+            key: 'sale-notification',
+            name: 'New sale',
+            description: 'Notifies the seller when an order is placed.',
+            pluginId: 'commerce',
+            plugin: 'Commerce',
+            control: 'besigner',
+            defaultSubject: 'New order on {{site.name}}',
+            mergeTokens: [
+                {
+                    name: 'site.name',
+                    description: 'The site the sale happened on',
+                    sample: 'Northwind Coffee'
+                },
+                {
+                    name: 'order.summary',
+                    description: 'The ordered items',
+                    sample: 'House Blend — $12.00'
+                },
+                {
+                    name: 'order.total',
+                    description: 'Order total',
+                    sample: '$12.00'
+                },
+                {
+                    name: 'buyer.email',
+                    description: "The buyer's email",
+                    sample: 'buyer@example.com'
+                },
+                {
+                    name: 'order.ref',
+                    description: 'Order reference id',
+                    sample: 'cs_test_123'
+                }
+            ],
+            defaultBody: [
+                {
+                    block: 'text',
+                    text: 'You made a sale',
+                    variant: 'heading'
+                },
+                {
+                    block: 'text',
+                    text: 'A new order came in on {{site.name}}.',
+                    variant: 'body'
+                },
+                {
+                    block: 'text',
+                    text: '{{order.summary}}',
+                    variant: 'body'
+                },
+                {
+                    block: 'text',
+                    text: 'Total: {{order.total}}',
+                    variant: 'body'
+                },
+                {
+                    block: 'text',
+                    text: 'Buyer: {{buyer.email}} · Order {{order.ref}}',
+                    variant: 'caption'
+                }
+            ],
+            footerReason: 'You’re receiving this because you manage {{host.businessName}}.'
+        },
+        {
+            key: 'reservation-confirmed',
+            name: 'Reservation confirmed',
+            description: 'Confirms a paid reservation to the customer.',
+            pluginId: 'commerce',
+            plugin: 'Commerce',
+            control: 'besigner',
+            defaultSubject: 'Reservation confirmed',
+            mergeTokens: [
+                {
+                    name: 'reservation.checkIn',
+                    description: 'Check-in date',
+                    sample: 'Mon, 01 Jun 2026'
+                },
+                {
+                    name: 'reservation.nights',
+                    description: 'Number of nights',
+                    sample: '2'
+                },
+                {
+                    name: 'reservation.paid',
+                    description: 'Amount paid today',
+                    sample: '$240.00'
+                },
+                {
+                    name: 'reservation.ref',
+                    description: 'Reservation reference id',
+                    sample: 'resv_123'
+                }
+            ],
+            defaultBody: [
+                {
+                    block: 'text',
+                    text: 'Reservation confirmed',
+                    variant: 'heading'
+                },
+                {
+                    block: 'text',
+                    text: 'Your stay is confirmed!',
+                    variant: 'body'
+                },
+                {
+                    block: 'text',
+                    text: 'Check-in: {{reservation.checkIn}}',
+                    variant: 'body'
+                },
+                {
+                    block: 'text',
+                    text: 'Nights: {{reservation.nights}}',
+                    variant: 'body'
+                },
+                {
+                    block: 'text',
+                    text: 'Paid today: {{reservation.paid}}',
+                    variant: 'body'
+                },
+                {
+                    block: 'text',
+                    text: 'Reference: {{reservation.ref}}',
+                    variant: 'caption'
+                }
+            ],
+            footerReason: 'You’re receiving this because you made a reservation with {{host.businessName}}.'
+        },
+        {
+            key: 'gift-card',
+            name: 'Gift card delivery',
+            description: 'Delivers a purchased gift card to its recipient.',
+            pluginId: 'commerce',
+            plugin: 'Commerce',
+            control: 'besigner',
+            defaultSubject: 'Your gift card',
+            mergeTokens: [
+                {
+                    name: 'giftcard.code',
+                    description: 'The gift card code',
+                    sample: 'GC-ABC123DEF456'
+                },
+                {
+                    name: 'giftcard.value',
+                    description: 'The gift card value',
+                    sample: '$25.00'
+                }
+            ],
+            defaultBody: [
+                {
+                    block: 'text',
+                    text: 'Your gift card',
+                    variant: 'heading'
+                },
+                {
+                    block: 'text',
+                    text: 'Gift card code: {{giftcard.code}}',
+                    variant: 'body'
+                },
+                {
+                    block: 'text',
+                    text: 'Value: {{giftcard.value}}',
+                    variant: 'body'
+                },
+                {
+                    block: 'text',
+                    text: 'Enter it at checkout to apply the balance.',
+                    variant: 'body'
+                }
+            ],
+            footerReason: 'You’re receiving this because a gift card from {{host.businessName}} was sent to this address.'
+        },
+        {
+            key: 'supplier-fulfillment',
+            name: 'Supplier fulfillment',
+            description: 'Tells a dropship supplier there is a new order to fulfill.',
+            pluginId: 'commerce',
+            plugin: 'Commerce',
+            control: 'fixed'
+        },
+        {
+            key: 'back-in-stock',
+            name: 'Back in stock',
+            description: 'Tells a customer a product they watched is available again.',
+            pluginId: 'commerce',
+            plugin: 'Commerce',
+            control: 'besigner',
+            defaultSubject: 'Back in stock: {{product.name}}',
+            mergeTokens: [
+                {
+                    name: 'product.name',
+                    description: 'The product that restocked',
+                    sample: 'House Blend'
+                },
+                {
+                    name: 'product.url',
+                    description: 'Link to the product page',
+                    sample: '/products/house-blend'
+                }
+            ],
+            defaultBody: [
+                {
+                    block: 'text',
+                    text: '{{product.name}} is available again — grab it before it sells out.',
+                    variant: 'body'
+                },
+                {
+                    block: 'button',
+                    label: 'View product',
+                    href: '{{product.url}}'
+                }
+            ],
+            footerReason: 'You’re receiving this because you asked {{host.businessName}} to tell you when this was back.'
+        },
+        {
+            key: 'abandoned-cart',
+            name: 'Abandoned cart',
+            description: 'Reminds a shopper of items left in their cart.',
+            // The cron refuses to send this without the entitlement
+            // (`process-abandoned.ts:92`), so the console has to say so (AGL-2081).
+            requiresFeature: 'abandonedCart',
+            pluginId: 'commerce',
+            plugin: 'Commerce',
+            control: 'besigner',
+            defaultSubject: 'You left something in your cart',
+            mergeTokens: [
+                {
+                    name: 'cart.url',
+                    description: 'Link back to the shopper cart',
+                    sample: 'https://shop.example.com/cart'
+                }
+            ],
+            defaultBody: [
+                {
+                    block: 'text',
+                    text: 'Your cart is still waiting — pick up where you left off.',
+                    variant: 'body'
+                },
+                {
+                    block: 'button',
+                    label: 'Return to cart',
+                    href: '{{cart.url}}'
+                },
+                {
+                    block: 'text',
+                    text: 'Your items are held but not reserved, so they may sell out.',
+                    variant: 'caption'
+                }
+            ],
+            footerReason: 'You’re receiving this because you started a checkout with {{host.businessName}}.'
+        },
+        {
+            key: 'member-post',
+            name: 'New member post',
+            description: 'Notifies members when new members-only content is posted.',
+            pluginId: 'commerce',
+            plugin: 'Commerce',
+            control: 'besigner',
+            defaultSubject: '{{post.title}}',
+            mergeTokens: [
+                {
+                    name: 'post.title',
+                    description: 'The post’s title',
+                    sample: 'This month in the studio'
+                },
+                {
+                    name: 'post.body',
+                    description: 'The post, as its author wrote it',
+                    sample: 'Three new pieces are up for members first.'
+                }
+            ],
+            defaultBody: [
+                {
+                    block: 'text',
+                    text: '{{post.title}}',
+                    variant: 'heading'
+                },
+                {
+                    block: 'text',
+                    text: '{{post.body}}',
+                    variant: 'body'
+                }
+            ],
+            footerReason: 'You’re receiving this because you’re a member of {{host.businessName}}.'
+        },
+        {
+            key: 'member-password-reset',
+            name: 'Member password reset',
+            description: "Resets a site member's password — a store-member account, separate " + 'from a console login. Sent when the member asks, and when a site ' + 'administrator starts a reset for them.',
+            pluginId: 'commerce',
+            plugin: 'Commerce',
+            control: 'besigner',
+            defaultSubject: 'Reset your {{site.name}} password',
+            mergeTokens: [
+                {
+                    name: 'site.name',
+                    description: 'The site’s name',
+                    sample: 'Northwind Coffee'
+                },
+                {
+                    name: 'reset.intro',
+                    description: 'Who started the reset',
+                    sample: 'Someone asked to reset the password for your Northwind Coffee account.'
+                },
+                {
+                    name: 'resetUrl',
+                    description: 'The one-time reset link',
+                    sample: 'https://shop.example.com/recover?token=…'
+                },
+                {
+                    name: 'reset.note',
+                    description: 'How long the link lasts, and what to do if unexpected',
+                    sample: 'The link works once and expires in 1 hour. If you did not ask for ' + 'this, you can safely ignore this email — your password is unchanged.'
+                }
+            ],
+            defaultBody: [
+                {
+                    block: 'text',
+                    text: 'Reset your password',
+                    variant: 'heading'
+                },
+                {
+                    block: 'text',
+                    text: '{{reset.intro}}',
+                    variant: 'body'
+                },
+                {
+                    block: 'button',
+                    label: 'Set a new password',
+                    href: '{{resetUrl}}'
+                },
+                {
+                    block: 'text',
+                    text: '{{reset.note}}',
+                    variant: 'caption'
+                }
+            ],
+            footerReason: 'You’re receiving this because a password reset was started for your ' + '{{host.businessName}} account.'
+        },
+        {
+            key: 'member-password-changed',
+            name: 'Member password changed',
+            description: 'Tells a site member that a site administrator set a new password on ' + 'their account.',
+            pluginId: 'commerce',
+            plugin: 'Commerce',
+            control: 'besigner',
+            defaultSubject: 'Your {{site.name}} password was changed',
+            mergeTokens: [
+                {
+                    name: 'site.name',
+                    description: 'The site’s name',
+                    sample: 'Northwind Coffee'
+                },
+                {
+                    name: 'signInUrl',
+                    description: 'Where the member signs back in',
+                    sample: 'https://shop.example.com'
+                }
+            ],
+            defaultBody: [
+                {
+                    block: 'text',
+                    text: 'Your password was changed',
+                    variant: 'heading'
+                },
+                {
+                    block: 'text',
+                    text: 'An administrator of {{site.name}} set a new password on your ' + 'account. You have been signed out on every device and will need ' + 'the new password to sign back in.',
+                    variant: 'body'
+                },
+                {
+                    block: 'button',
+                    label: 'Sign in',
+                    href: '{{signInUrl}}'
+                },
+                {
+                    block: 'text',
+                    text: 'If you did not expect this, contact the site owner.',
+                    variant: 'caption'
+                }
+            ],
+            footerReason: 'You’re receiving this because the password on your ' + '{{host.businessName}} account was changed.'
+        },
+        {
+            key: 'newsletter-confirmation',
+            name: 'Subscription confirmation',
+            description: 'Asks someone who signed up for a site’s emails to confirm the address ' + 'before anything is sent to it.',
+            pluginId: 'commerce',
+            plugin: 'Commerce',
+            control: 'besigner',
+            defaultSubject: 'Confirm your subscription',
+            mergeTokens: [
+                {
+                    name: 'stream.name',
+                    description: 'What they signed up for',
+                    sample: 'our newsletter'
+                },
+                {
+                    name: 'confirmUrl',
+                    description: 'The confirmation link',
+                    sample: 'https://shop.example.com/subscribe/confirm?token=…'
+                }
+            ],
+            defaultBody: [
+                {
+                    block: 'text',
+                    text: 'Confirm your subscription',
+                    variant: 'heading'
+                },
+                {
+                    block: 'text',
+                    text: 'Please confirm that you want to receive {{stream.name}} at this address.',
+                    variant: 'body'
+                },
+                {
+                    block: 'button',
+                    label: 'Confirm my subscription',
+                    href: '{{confirmUrl}}'
+                },
+                {
+                    block: 'text',
+                    text: 'The link works for three days. If you did not sign up, ignore this ' + 'message — nothing will be sent.',
+                    variant: 'caption'
+                }
+            ],
+            footerReason: 'You’re receiving this because this address was entered on ' + '{{host.businessName}}’s signup form.'
+        }
+    ];
+}
+
+//# sourceMappingURL=tenant-emails.js.map

package/src/lib/tenant-emails.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/plugins/commerce/src/lib/tenant-emails.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 { TenantEmailEntry } from '@aglyn/shared-util-email'\n\n/**\n * The emails a site sends its own customers through Commerce (AGL-769/770).\n *\n * Declared here, by the plugin that sends them, and compiled into the\n * platform's tenant email catalog (`TENANT_EMAILS` in\n * `@aglyn/shared-util-email`) by `tools/scripts/generate-plugin-manifests.mjs`\n * (AGL-3080): the catalog's readers include the send path, which loads no\n * plugin code, so a runtime registry it had not filled would quietly send\n * the text card in place of the site's designed email. Regenerate after\n * changing an entry; `--check` refuses a stale catalog.\n *\n * Most commerce sends are designable in the email besigner; a `fixed` entry\n * flips to `besigner` when its send site is wired to `renderHostEmail`\n * (AGL-770).\n */\nexport function commerceTenantEmails(): readonly TenantEmailEntry[] {\n  return [\n    {\n      key: 'order-receipt',\n      name: 'Order receipt',\n      description: 'Sent to the buyer after a successful order or checkout.',\n      pluginId: 'commerce',\n      plugin: 'Commerce',\n      control: 'besigner',\n      defaultSubject: 'Receipt for your order',\n      mergeTokens: [\n        {\n          name: 'order.summary',\n          description: 'The ordered items, one per line (with any license/download links)',\n          sample: 'House Blend × 2 — $24.00',\n        },\n        {\n          name: 'order.total',\n          description: 'Order total',\n          sample: '$24.00',\n        },\n        {\n          name: 'order.ref',\n          description: 'Order reference id',\n          sample: 'cs_test_123',\n        },\n      ],\n      defaultBody: [\n        { block: 'text', text: 'Thanks for your purchase!', variant: 'heading' },\n        { block: 'text', text: '{{order.summary}}', variant: 'body' },\n        { block: 'text', text: 'Total: {{order.total}}', variant: 'body' },\n        {\n          block: 'text',\n          text: 'Order reference: {{order.ref}}',\n          variant: 'caption',\n        },\n      ],\n      footerReason:\n        'You’re receiving this because you placed an order with {{host.businessName}}.',\n    },\n    {\n      key: 'sale-notification',\n      name: 'New sale',\n      description: 'Notifies the seller when an order is placed.',\n      pluginId: 'commerce',\n      plugin: 'Commerce',\n      control: 'besigner',\n      defaultSubject: 'New order on {{site.name}}',\n      mergeTokens: [\n        {\n          name: 'site.name',\n          description: 'The site the sale happened on',\n          sample: 'Northwind Coffee',\n        },\n        {\n          name: 'order.summary',\n          description: 'The ordered items',\n          sample: 'House Blend — $12.00',\n        },\n        { name: 'order.total', description: 'Order total', sample: '$12.00' },\n        {\n          name: 'buyer.email',\n          description: \"The buyer's email\",\n          sample: 'buyer@example.com',\n        },\n        {\n          name: 'order.ref',\n          description: 'Order reference id',\n          sample: 'cs_test_123',\n        },\n      ],\n      defaultBody: [\n        { block: 'text', text: 'You made a sale', variant: 'heading' },\n        {\n          block: 'text',\n          text: 'A new order came in on {{site.name}}.',\n          variant: 'body',\n        },\n        { block: 'text', text: '{{order.summary}}', variant: 'body' },\n        { block: 'text', text: 'Total: {{order.total}}', variant: 'body' },\n        {\n          block: 'text',\n          text: 'Buyer: {{buyer.email}} · Order {{order.ref}}',\n          variant: 'caption',\n        },\n      ],\n      footerReason:\n        'You’re receiving this because you manage {{host.businessName}}.',\n    },\n    {\n      key: 'reservation-confirmed',\n      name: 'Reservation confirmed',\n      description: 'Confirms a paid reservation to the customer.',\n      pluginId: 'commerce',\n      plugin: 'Commerce',\n      control: 'besigner',\n      defaultSubject: 'Reservation confirmed',\n      mergeTokens: [\n        {\n          name: 'reservation.checkIn',\n          description: 'Check-in date',\n          sample: 'Mon, 01 Jun 2026',\n        },\n        {\n          name: 'reservation.nights',\n          description: 'Number of nights',\n          sample: '2',\n        },\n        {\n          name: 'reservation.paid',\n          description: 'Amount paid today',\n          sample: '$240.00',\n        },\n        {\n          name: 'reservation.ref',\n          description: 'Reservation reference id',\n          sample: 'resv_123',\n        },\n      ],\n      defaultBody: [\n        { block: 'text', text: 'Reservation confirmed', variant: 'heading' },\n        { block: 'text', text: 'Your stay is confirmed!', variant: 'body' },\n        {\n          block: 'text',\n          text: 'Check-in: {{reservation.checkIn}}',\n          variant: 'body',\n        },\n        { block: 'text', text: 'Nights: {{reservation.nights}}', variant: 'body' },\n        {\n          block: 'text',\n          text: 'Paid today: {{reservation.paid}}',\n          variant: 'body',\n        },\n        {\n          block: 'text',\n          text: 'Reference: {{reservation.ref}}',\n          variant: 'caption',\n        },\n      ],\n      footerReason:\n        'You’re receiving this because you made a reservation with {{host.businessName}}.',\n    },\n    {\n      key: 'gift-card',\n      name: 'Gift card delivery',\n      description: 'Delivers a purchased gift card to its recipient.',\n      pluginId: 'commerce',\n      plugin: 'Commerce',\n      control: 'besigner',\n      defaultSubject: 'Your gift card',\n      mergeTokens: [\n        {\n          name: 'giftcard.code',\n          description: 'The gift card code',\n          sample: 'GC-ABC123DEF456',\n        },\n        {\n          name: 'giftcard.value',\n          description: 'The gift card value',\n          sample: '$25.00',\n        },\n      ],\n      defaultBody: [\n        { block: 'text', text: 'Your gift card', variant: 'heading' },\n        {\n          block: 'text',\n          text: 'Gift card code: {{giftcard.code}}',\n          variant: 'body',\n        },\n        { block: 'text', text: 'Value: {{giftcard.value}}', variant: 'body' },\n        {\n          block: 'text',\n          text: 'Enter it at checkout to apply the balance.',\n          variant: 'body',\n        },\n      ],\n      footerReason:\n        'You’re receiving this because a gift card from {{host.businessName}} was sent to this address.',\n    },\n    {\n      key: 'supplier-fulfillment',\n      name: 'Supplier fulfillment',\n      description: 'Tells a dropship supplier there is a new order to fulfill.',\n      pluginId: 'commerce',\n      plugin: 'Commerce',\n      control: 'fixed',\n    },\n    {\n      key: 'back-in-stock',\n      name: 'Back in stock',\n      description: 'Tells a customer a product they watched is available again.',\n      pluginId: 'commerce',\n      plugin: 'Commerce',\n      control: 'besigner',\n      defaultSubject: 'Back in stock: {{product.name}}',\n      mergeTokens: [\n        {\n          name: 'product.name',\n          description: 'The product that restocked',\n          sample: 'House Blend',\n        },\n        {\n          name: 'product.url',\n          description: 'Link to the product page',\n          sample: '/products/house-blend',\n        },\n      ],\n      defaultBody: [\n        {\n          block: 'text',\n          text:\n            '{{product.name}} is available again — grab it before it sells out.',\n          variant: 'body',\n        },\n        { block: 'button', label: 'View product', href: '{{product.url}}' },\n      ],\n      footerReason:\n        'You’re receiving this because you asked {{host.businessName}} to tell you when this was back.',\n    },\n    {\n      key: 'abandoned-cart',\n      name: 'Abandoned cart',\n      description: 'Reminds a shopper of items left in their cart.',\n      // The cron refuses to send this without the entitlement\n      // (`process-abandoned.ts:92`), so the console has to say so (AGL-2081).\n      requiresFeature: 'abandonedCart',\n      pluginId: 'commerce',\n      plugin: 'Commerce',\n      control: 'besigner',\n      defaultSubject: 'You left something in your cart',\n      mergeTokens: [\n        {\n          name: 'cart.url',\n          description: 'Link back to the shopper cart',\n          sample: 'https://shop.example.com/cart',\n        },\n      ],\n      defaultBody: [\n        {\n          block: 'text',\n          text: 'Your cart is still waiting — pick up where you left off.',\n          variant: 'body',\n        },\n        { block: 'button', label: 'Return to cart', href: '{{cart.url}}' },\n        {\n          block: 'text',\n          text:\n            'Your items are held but not reserved, so they may sell out.',\n          variant: 'caption',\n        },\n      ],\n      footerReason:\n        'You’re receiving this because you started a checkout with {{host.businessName}}.',\n    },\n    {\n      key: 'member-post',\n      name: 'New member post',\n      description: 'Notifies members when new members-only content is posted.',\n      pluginId: 'commerce',\n      plugin: 'Commerce',\n      control: 'besigner',\n      defaultSubject: '{{post.title}}',\n      mergeTokens: [\n        { name: 'post.title', description: 'The post’s title', sample: 'This month in the studio' },\n        {\n          name: 'post.body',\n          description: 'The post, as its author wrote it',\n          sample: 'Three new pieces are up for members first.',\n        },\n      ],\n      defaultBody: [\n        { block: 'text', text: '{{post.title}}', variant: 'heading' },\n        { block: 'text', text: '{{post.body}}', variant: 'body' },\n      ],\n      footerReason: 'You’re receiving this because you’re a member of {{host.businessName}}.',\n    },\n    {\n      key: 'member-password-reset',\n      name: 'Member password reset',\n      description:\n        \"Resets a site member's password — a store-member account, separate \" +\n        'from a console login. Sent when the member asks, and when a site ' +\n        'administrator starts a reset for them.',\n      pluginId: 'commerce',\n      plugin: 'Commerce',\n      control: 'besigner',\n      defaultSubject: 'Reset your {{site.name}} password',\n      mergeTokens: [\n        { name: 'site.name', description: 'The site’s name', sample: 'Northwind Coffee' },\n        {\n          name: 'reset.intro',\n          description: 'Who started the reset',\n          sample: 'Someone asked to reset the password for your Northwind Coffee account.',\n        },\n        {\n          name: 'resetUrl',\n          description: 'The one-time reset link',\n          sample: 'https://shop.example.com/recover?token=…',\n        },\n        {\n          name: 'reset.note',\n          description: 'How long the link lasts, and what to do if unexpected',\n          sample:\n            'The link works once and expires in 1 hour. If you did not ask for ' +\n            'this, you can safely ignore this email — your password is unchanged.',\n        },\n      ],\n      defaultBody: [\n        { block: 'text', text: 'Reset your password', variant: 'heading' },\n        { block: 'text', text: '{{reset.intro}}', variant: 'body' },\n        { block: 'button', label: 'Set a new password', href: '{{resetUrl}}' },\n        { block: 'text', text: '{{reset.note}}', variant: 'caption' },\n      ],\n      footerReason:\n        'You’re receiving this because a password reset was started for your ' +\n        '{{host.businessName}} account.',\n    },\n    {\n      key: 'member-password-changed',\n      name: 'Member password changed',\n      description:\n        'Tells a site member that a site administrator set a new password on ' +\n        'their account.',\n      pluginId: 'commerce',\n      plugin: 'Commerce',\n      control: 'besigner',\n      defaultSubject: 'Your {{site.name}} password was changed',\n      mergeTokens: [\n        { name: 'site.name', description: 'The site’s name', sample: 'Northwind Coffee' },\n        {\n          name: 'signInUrl',\n          description: 'Where the member signs back in',\n          sample: 'https://shop.example.com',\n        },\n      ],\n      defaultBody: [\n        { block: 'text', text: 'Your password was changed', variant: 'heading' },\n        {\n          block: 'text',\n          text:\n            'An administrator of {{site.name}} set a new password on your ' +\n            'account. You have been signed out on every device and will need ' +\n            'the new password to sign back in.',\n          variant: 'body',\n        },\n        { block: 'button', label: 'Sign in', href: '{{signInUrl}}' },\n        {\n          block: 'text',\n          text: 'If you did not expect this, contact the site owner.',\n          variant: 'caption',\n        },\n      ],\n      footerReason:\n        'You’re receiving this because the password on your ' +\n        '{{host.businessName}} account was changed.',\n    },\n    {\n      key: 'newsletter-confirmation',\n      name: 'Subscription confirmation',\n      description:\n        'Asks someone who signed up for a site’s emails to confirm the address ' +\n        'before anything is sent to it.',\n      pluginId: 'commerce',\n      plugin: 'Commerce',\n      control: 'besigner',\n      defaultSubject: 'Confirm your subscription',\n      mergeTokens: [\n        {\n          name: 'stream.name',\n          description: 'What they signed up for',\n          sample: 'our newsletter',\n        },\n        {\n          name: 'confirmUrl',\n          description: 'The confirmation link',\n          sample: 'https://shop.example.com/subscribe/confirm?token=…',\n        },\n      ],\n      defaultBody: [\n        { block: 'text', text: 'Confirm your subscription', variant: 'heading' },\n        {\n          block: 'text',\n          text: 'Please confirm that you want to receive {{stream.name}} at this address.',\n          variant: 'body',\n        },\n        { block: 'button', label: 'Confirm my subscription', href: '{{confirmUrl}}' },\n        {\n          block: 'text',\n          text:\n            'The link works for three days. If you did not sign up, ignore this ' +\n            'message — nothing will be sent.',\n          variant: 'caption',\n        },\n      ],\n      footerReason:\n        'You’re receiving this because this address was entered on ' +\n        '{{host.businessName}}’s signup form.',\n    },\n  ]\n}\n"],"names":["commerceTenantEmails","key","name","description","pluginId","plugin","control","defaultSubject","mergeTokens","sample","defaultBody","block","text","variant","footerReason","label","href","requiresFeature"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAID;;;;;;;;;;;;;;CAcC,GACD,OAAO,SAASA;IACd,OAAO;QACL;YACEC,KAAK;YACLC,MAAM;YACNC,aAAa;YACbC,UAAU;YACVC,QAAQ;YACRC,SAAS;YACTC,gBAAgB;YAChBC,aAAa;gBACX;oBACEN,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;gBACA;oBACEP,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;gBACA;oBACEP,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;aACD;YACDC,aAAa;gBACX;oBAAEC,OAAO;oBAAQC,MAAM;oBAA6BC,SAAS;gBAAU;gBACvE;oBAAEF,OAAO;oBAAQC,MAAM;oBAAqBC,SAAS;gBAAO;gBAC5D;oBAAEF,OAAO;oBAAQC,MAAM;oBAA0BC,SAAS;gBAAO;gBACjE;oBACEF,OAAO;oBACPC,MAAM;oBACNC,SAAS;gBACX;aACD;YACDC,cACE;QACJ;QACA;YACEb,KAAK;YACLC,MAAM;YACNC,aAAa;YACbC,UAAU;YACVC,QAAQ;YACRC,SAAS;YACTC,gBAAgB;YAChBC,aAAa;gBACX;oBACEN,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;gBACA;oBACEP,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;gBACA;oBAAEP,MAAM;oBAAeC,aAAa;oBAAeM,QAAQ;gBAAS;gBACpE;oBACEP,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;gBACA;oBACEP,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;aACD;YACDC,aAAa;gBACX;oBAAEC,OAAO;oBAAQC,MAAM;oBAAmBC,SAAS;gBAAU;gBAC7D;oBACEF,OAAO;oBACPC,MAAM;oBACNC,SAAS;gBACX;gBACA;oBAAEF,OAAO;oBAAQC,MAAM;oBAAqBC,SAAS;gBAAO;gBAC5D;oBAAEF,OAAO;oBAAQC,MAAM;oBAA0BC,SAAS;gBAAO;gBACjE;oBACEF,OAAO;oBACPC,MAAM;oBACNC,SAAS;gBACX;aACD;YACDC,cACE;QACJ;QACA;YACEb,KAAK;YACLC,MAAM;YACNC,aAAa;YACbC,UAAU;YACVC,QAAQ;YACRC,SAAS;YACTC,gBAAgB;YAChBC,aAAa;gBACX;oBACEN,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;gBACA;oBACEP,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;gBACA;oBACEP,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;gBACA;oBACEP,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;aACD;YACDC,aAAa;gBACX;oBAAEC,OAAO;oBAAQC,MAAM;oBAAyBC,SAAS;gBAAU;gBACnE;oBAAEF,OAAO;oBAAQC,MAAM;oBAA2BC,SAAS;gBAAO;gBAClE;oBACEF,OAAO;oBACPC,MAAM;oBACNC,SAAS;gBACX;gBACA;oBAAEF,OAAO;oBAAQC,MAAM;oBAAkCC,SAAS;gBAAO;gBACzE;oBACEF,OAAO;oBACPC,MAAM;oBACNC,SAAS;gBACX;gBACA;oBACEF,OAAO;oBACPC,MAAM;oBACNC,SAAS;gBACX;aACD;YACDC,cACE;QACJ;QACA;YACEb,KAAK;YACLC,MAAM;YACNC,aAAa;YACbC,UAAU;YACVC,QAAQ;YACRC,SAAS;YACTC,gBAAgB;YAChBC,aAAa;gBACX;oBACEN,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;gBACA;oBACEP,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;aACD;YACDC,aAAa;gBACX;oBAAEC,OAAO;oBAAQC,MAAM;oBAAkBC,SAAS;gBAAU;gBAC5D;oBACEF,OAAO;oBACPC,MAAM;oBACNC,SAAS;gBACX;gBACA;oBAAEF,OAAO;oBAAQC,MAAM;oBAA6BC,SAAS;gBAAO;gBACpE;oBACEF,OAAO;oBACPC,MAAM;oBACNC,SAAS;gBACX;aACD;YACDC,cACE;QACJ;QACA;YACEb,KAAK;YACLC,MAAM;YACNC,aAAa;YACbC,UAAU;YACVC,QAAQ;YACRC,SAAS;QACX;QACA;YACEL,KAAK;YACLC,MAAM;YACNC,aAAa;YACbC,UAAU;YACVC,QAAQ;YACRC,SAAS;YACTC,gBAAgB;YAChBC,aAAa;gBACX;oBACEN,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;gBACA;oBACEP,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;aACD;YACDC,aAAa;gBACX;oBACEC,OAAO;oBACPC,MACE;oBACFC,SAAS;gBACX;gBACA;oBAAEF,OAAO;oBAAUI,OAAO;oBAAgBC,MAAM;gBAAkB;aACnE;YACDF,cACE;QACJ;QACA;YACEb,KAAK;YACLC,MAAM;YACNC,aAAa;YACb,wDAAwD;YACxD,wEAAwE;YACxEc,iBAAiB;YACjBb,UAAU;YACVC,QAAQ;YACRC,SAAS;YACTC,gBAAgB;YAChBC,aAAa;gBACX;oBACEN,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;aACD;YACDC,aAAa;gBACX;oBACEC,OAAO;oBACPC,MAAM;oBACNC,SAAS;gBACX;gBACA;oBAAEF,OAAO;oBAAUI,OAAO;oBAAkBC,MAAM;gBAAe;gBACjE;oBACEL,OAAO;oBACPC,MACE;oBACFC,SAAS;gBACX;aACD;YACDC,cACE;QACJ;QACA;YACEb,KAAK;YACLC,MAAM;YACNC,aAAa;YACbC,UAAU;YACVC,QAAQ;YACRC,SAAS;YACTC,gBAAgB;YAChBC,aAAa;gBACX;oBAAEN,MAAM;oBAAcC,aAAa;oBAAoBM,QAAQ;gBAA2B;gBAC1F;oBACEP,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;aACD;YACDC,aAAa;gBACX;oBAAEC,OAAO;oBAAQC,MAAM;oBAAkBC,SAAS;gBAAU;gBAC5D;oBAAEF,OAAO;oBAAQC,MAAM;oBAAiBC,SAAS;gBAAO;aACzD;YACDC,cAAc;QAChB;QACA;YACEb,KAAK;YACLC,MAAM;YACNC,aACE,wEACA,sEACA;YACFC,UAAU;YACVC,QAAQ;YACRC,SAAS;YACTC,gBAAgB;YAChBC,aAAa;gBACX;oBAAEN,MAAM;oBAAaC,aAAa;oBAAmBM,QAAQ;gBAAmB;gBAChF;oBACEP,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;gBACA;oBACEP,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;gBACA;oBACEP,MAAM;oBACNC,aAAa;oBACbM,QACE,uEACA;gBACJ;aACD;YACDC,aAAa;gBACX;oBAAEC,OAAO;oBAAQC,MAAM;oBAAuBC,SAAS;gBAAU;gBACjE;oBAAEF,OAAO;oBAAQC,MAAM;oBAAmBC,SAAS;gBAAO;gBAC1D;oBAAEF,OAAO;oBAAUI,OAAO;oBAAsBC,MAAM;gBAAe;gBACrE;oBAAEL,OAAO;oBAAQC,MAAM;oBAAkBC,SAAS;gBAAU;aAC7D;YACDC,cACE,yEACA;QACJ;QACA;YACEb,KAAK;YACLC,MAAM;YACNC,aACE,yEACA;YACFC,UAAU;YACVC,QAAQ;YACRC,SAAS;YACTC,gBAAgB;YAChBC,aAAa;gBACX;oBAAEN,MAAM;oBAAaC,aAAa;oBAAmBM,QAAQ;gBAAmB;gBAChF;oBACEP,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;aACD;YACDC,aAAa;gBACX;oBAAEC,OAAO;oBAAQC,MAAM;oBAA6BC,SAAS;gBAAU;gBACvE;oBACEF,OAAO;oBACPC,MACE,kEACA,qEACA;oBACFC,SAAS;gBACX;gBACA;oBAAEF,OAAO;oBAAUI,OAAO;oBAAWC,MAAM;gBAAgB;gBAC3D;oBACEL,OAAO;oBACPC,MAAM;oBACNC,SAAS;gBACX;aACD;YACDC,cACE,wDACA;QACJ;QACA;YACEb,KAAK;YACLC,MAAM;YACNC,aACE,2EACA;YACFC,UAAU;YACVC,QAAQ;YACRC,SAAS;YACTC,gBAAgB;YAChBC,aAAa;gBACX;oBACEN,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;gBACA;oBACEP,MAAM;oBACNC,aAAa;oBACbM,QAAQ;gBACV;aACD;YACDC,aAAa;gBACX;oBAAEC,OAAO;oBAAQC,MAAM;oBAA6BC,SAAS;gBAAU;gBACvE;oBACEF,OAAO;oBACPC,MAAM;oBACNC,SAAS;gBACX;gBACA;oBAAEF,OAAO;oBAAUI,OAAO;oBAA2BC,MAAM;gBAAiB;gBAC5E;oBACEL,OAAO;oBACPC,MACE,wEACA;oBACFC,SAAS;gBACX;aACD;YACDC,cACE,+DACA;QACJ;KACD;AACH"}

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

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The CRM's `contact`, `lead` and `company` record routes (AGL-3080), stood in
+ * for this plugin's specs, which may not load the CRM. They answer what the
+ * CRM publishes — a record's page under the site's hub or the organization's,
+ * and the Contacts list opened on one address — and what it publishes is held
+ * in its own `crm-record-routes.spec.ts`. Registered under the owner's id,
+ * `crm`, so a spec asking what happens where it is not loaded unregisters it.
+ */
+export declare function standInCrmRecordRoutes(): void;

package/src/lib/testing/stand-in-crm-record-routes.js

@@ -0,0 +1,46 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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 { registerPluginRecordRoute } from "@aglyn/aglyn/plugin-manager/plugin-record-routes";
+/**
+ * The CRM's `contact`, `lead` and `company` record routes (AGL-3080), stood in
+ * for this plugin's specs, which may not load the CRM. They answer what the
+ * CRM publishes — a record's page under the site's hub or the organization's,
+ * and the Contacts list opened on one address — and what it publishes is held
+ * in its own `crm-record-routes.spec.ts`. Registered under the owner's id,
+ * `crm`, so a spec asking what happens where it is not loaded unregisters it.
+ */ export function standInCrmRecordRoutes() {
+    const hub = ({ orgSlug, host })=>host ? `/${orgSlug}/hosts/${host}/crm` : `/${orgSlug}/crm`;
+    const sectionRoute = (section)=>({
+            list: (context)=>`${hub(context)}/${section}`,
+            record: (context, id)=>`${hub(context)}/${section}/${encodeURIComponent(id)}`
+        });
+    registerPluginRecordRoute('contact', _extends({}, sectionRoute('contacts'), {
+        byEmail: (context, email)=>`${hub(context)}/contacts?${new URLSearchParams({
+                email
+            }).toString()}`
+    }), {
+        pluginId: 'crm'
+    });
+    registerPluginRecordRoute('lead', sectionRoute('leads'), {
+        pluginId: 'crm'
+    });
+    registerPluginRecordRoute('company', sectionRoute('companies'), {
+        pluginId: 'crm'
+    });
+}
+
+//# sourceMappingURL=stand-in-crm-record-routes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/testing/stand-in-crm-record-routes.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  registerPluginRecordRoute,\n  type PluginRecordRoute,\n  type PluginRecordRouteContext,\n} from '@aglyn/aglyn/plugin-manager/plugin-record-routes'\n\n/**\n * The CRM's `contact`, `lead` and `company` record routes (AGL-3080), stood in\n * for this plugin's specs, which may not load the CRM. They answer what the\n * CRM publishes — a record's page under the site's hub or the organization's,\n * and the Contacts list opened on one address — and what it publishes is held\n * in its own `crm-record-routes.spec.ts`. Registered under the owner's id,\n * `crm`, so a spec asking what happens where it is not loaded unregisters it.\n */\nexport function standInCrmRecordRoutes(): void {\n  const hub = ({ orgSlug, host }: PluginRecordRouteContext) =>\n    host ? `/${orgSlug}/hosts/${host}/crm` : `/${orgSlug}/crm`\n  const sectionRoute = (section: string): PluginRecordRoute => ({\n    list: (context) => `${hub(context)}/${section}`,\n    record: (context, id) => `${hub(context)}/${section}/${encodeURIComponent(id)}`,\n  })\n  registerPluginRecordRoute(\n    'contact',\n    {\n      ...sectionRoute('contacts'),\n      byEmail: (context, email) =>\n        `${hub(context)}/contacts?${new URLSearchParams({ email }).toString()}`,\n    },\n    { pluginId: 'crm' },\n  )\n  registerPluginRecordRoute('lead', sectionRoute('leads'), { pluginId: 'crm' })\n  registerPluginRecordRoute('company', sectionRoute('companies'), { pluginId: 'crm' })\n}\n"],"names":["registerPluginRecordRoute","standInCrmRecordRoutes","hub","orgSlug","host","sectionRoute","section","list","context","record","id","encodeURIComponent","byEmail","email","URLSearchParams","toString","pluginId"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,yBAAyB,QAGpB,mDAAkD;AAEzD;;;;;;;CAOC,GACD,OAAO,SAASC;IACd,MAAMC,MAAM,CAAC,EAAEC,OAAO,EAAEC,IAAI,EAA4B,GACtDA,OAAO,CAAC,CAAC,EAAED,QAAQ,OAAO,EAAEC,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,EAAED,QAAQ,IAAI,CAAC;IAC5D,MAAME,eAAe,CAACC,UAAwC,CAAA;YAC5DC,MAAM,CAACC,UAAY,GAAGN,IAAIM,SAAS,CAAC,EAAEF,SAAS;YAC/CG,QAAQ,CAACD,SAASE,KAAO,GAAGR,IAAIM,SAAS,CAAC,EAAEF,QAAQ,CAAC,EAAEK,mBAAmBD,KAAK;QACjF,CAAA;IACAV,0BACE,WACA,aACKK,aAAa;QAChBO,SAAS,CAACJ,SAASK,QACjB,GAAGX,IAAIM,SAAS,UAAU,EAAE,IAAIM,gBAAgB;gBAAED;YAAM,GAAGE,QAAQ,IAAI;QAE3E;QAAEC,UAAU;IAAM;IAEpBhB,0BAA0B,QAAQK,aAAa,UAAU;QAAEW,UAAU;IAAM;IAC3EhB,0BAA0B,WAAWK,aAAa,cAAc;QAAEW,UAAU;IAAM;AACpF"}