@aglyn/shared-util-email 1.0.0-beta.285 → 1.0.0-beta.287

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/shared-util-email",
-  "version": "1.0.0-beta.285",
+  "version": "1.0.0-beta.287",
   "license": "Apache-2.0",
   "homepage": "https://aglyn.com",
   "repository": {
@@ -25,8 +25,8 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@aglyn/shared-data-enums": "1.0.0-beta.285",
-    "@aglyn/shared-util-http": "1.0.0-beta.285",
+    "@aglyn/shared-data-enums": "1.0.0-beta.287",
+    "@aglyn/shared-util-http": "1.0.0-beta.287",
     "@msgpack/msgpack": "^3.1.3",
     "@swc/helpers": "0.5.23"
   },

package/src/index.d.ts

@@ -32,6 +32,7 @@ export * from './lib/site-care-emails';
 export * from './lib/site-care-project-emails';
 export * from './lib/domain-emails';
 export * from './lib/pos-hardware-emails';
+export * from './lib/pos-cellular-emails';
 export * from './lib/welcome-email';
 export * from './lib/tenant-email-catalog';
 export * from './lib/host-email-render';

package/src/index.js

@@ -36,6 +36,7 @@ export * from "./lib/site-care-emails.js";
 export * from "./lib/site-care-project-emails.js";
 export * from "./lib/domain-emails.js";
 export * from "./lib/pos-hardware-emails.js";
+export * from "./lib/pos-cellular-emails.js";
 export * from "./lib/welcome-email.js";
 export * from "./lib/tenant-email-catalog.js";
 export * from "./lib/host-email-render.js";

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/shared/util/email/src/index.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\nexport * from './lib/send-email'\n// Who carries the mail (AGL-3080): the provider contract, and the selection\n// of the deployment's provider from the built-ins and any a plugin\n// registered. The providers themselves are imported by their own paths —\n// `@aglyn/shared-util-email/mail-provider-resend`, `…/mail-provider-webhook`\n// — because nothing outside the seam should name one.\nexport * from './lib/mail-provider'\nexport * from './lib/mail-providers'\nexport * from './lib/send-rate'\nexport * from './lib/sender-reputation'\nexport * from './lib/send-ceilings'\nexport * from './lib/sending-domain'\nexport * from './lib/tracking-host'\nexport * from './lib/sending-mailbox'\nexport * from './lib/host-sender'\nexport * from './lib/platform-sending-domain'\nexport * from './lib/email-health'\nexport * from './lib/system-email-catalog'\nexport * from './lib/retention-emails'\nexport * from './lib/site-care-emails'\nexport * from './lib/site-care-project-emails'\nexport * from './lib/domain-emails'\nexport * from './lib/pos-hardware-emails'\nexport * from './lib/welcome-email'\nexport * from './lib/tenant-email-catalog'\nexport * from './lib/host-email-render'\nexport * from './lib/email-render'\nexport * from './lib/text-email-html'\nexport * from './lib/marketing-send'\n// The List-Unsubscribe setting sequences and campaigns share (AGL-3307).\nexport * from './lib/list-unsubscribe'\nexport * from './lib/email-delivery-events'\n// Received mail in the platform's vocabulary, which the CRM's capture route\n// files from (AGL-2657); the provider reads it.\n// Its neighbor `./lib/svix-signature` is deliberately NOT re-exported here:\n// it holds a `crypto` HMAC, and this barrel is reached from the browser\n// through `@aglyn/shared-ui-email-campaigns`, so a webhook imports it by its\n// own path — `@aglyn/shared-util-email/svix-signature`.\nexport * from './lib/received-email'\nexport * from './lib/email-revenue-window'\n// Exported so the console drift guard can pin it against @aglyn/aglyn.\nexport * from './lib/email-media-src'\n// Same arrangement, same reason (AGL-1223): a copy of `decodeStoredNodes`\n// this scope:shared lib may not import, pinned by `email-nodes-drift.spec.ts`.\nexport * from './lib/stored-email-nodes'\nexport * from './lib/email-merge'\n// The deliverability engine every send path asks (AGL-3328): the gateway an\n// MX names and its ledger, the bounce reader, and the address verdicts. Pure\n// — the DNS lookup and the store are injected by `@aglyn/tenant-data-admin`,\n// so nothing here reaches `node:dns` from the browser.\nexport * from './lib/mail-gateway'\nexport * from './lib/mail-bounce'\nexport * from './lib/email-deliverability'\n// The sender's side of the same engine (AGL-3328): SPF, DKIM and DMARC for\n// the domain mail leaves from, and whether they align. Pure as well; the\n// lookups are `@aglyn/tenant-data-admin`'s.\nexport * from './lib/sender-readiness'\n// The outbound phishing screen a young workspace's campaigns and automated\n// email pass (AGL-3356). Pure; the hold it leads to is `tenant-data-admin`'s.\nexport * from './lib/outbound-phishing-screen'\n// The send seam's gate for that screen — the store a hold writes is injected\n// by `@aglyn/tenant-data-admin`, like the governor's.\nexport * from './lib/outbound-screen-gate'\n// The same screen read over a published page (AGL-3356): lookalike links and\n// embeds, author-defined credential fields, a brand's call to action.\nexport * from './lib/hosted-page-screen'\n// The reputation lookup every foreign link a page, an email or a redirect\n// points at passes (AGL-3451). Pure; the lookup is injected by\n// `@aglyn/tenant-data-admin`, which holds the credential and the cache.\nexport * from './lib/link-reputation'\n// The site's theme palette as plain data (AGL-3370), so a palette token an\n// author picked resolves in mail. Built without MUI; `shared-ui-theme`'s\n// parity spec holds it equal to the theme.\nexport * from './lib/email-palette'\nexport * from './lib/email-design-chrome'\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,cAAc,sBAAkB;AAChC,4EAA4E;AAC5E,mEAAmE;AACnE,yEAAyE;AACzE,6EAA6E;AAC7E,sDAAsD;AACtD,cAAc,yBAAqB;AACnC,cAAc,0BAAsB;AACpC,cAAc,qBAAiB;AAC/B,cAAc,6BAAyB;AACvC,cAAc,yBAAqB;AACnC,cAAc,0BAAsB;AACpC,cAAc,yBAAqB;AACnC,cAAc,2BAAuB;AACrC,cAAc,uBAAmB;AACjC,cAAc,mCAA+B;AAC7C,cAAc,wBAAoB;AAClC,cAAc,gCAA4B;AAC1C,cAAc,4BAAwB;AACtC,cAAc,4BAAwB;AACtC,cAAc,oCAAgC;AAC9C,cAAc,yBAAqB;AACnC,cAAc,+BAA2B;AACzC,cAAc,yBAAqB;AACnC,cAAc,gCAA4B;AAC1C,cAAc,6BAAyB;AACvC,cAAc,wBAAoB;AAClC,cAAc,2BAAuB;AACrC,cAAc,0BAAsB;AACpC,yEAAyE;AACzE,cAAc,4BAAwB;AACtC,cAAc,iCAA6B;AAC3C,4EAA4E;AAC5E,gDAAgD;AAChD,4EAA4E;AAC5E,wEAAwE;AACxE,6EAA6E;AAC7E,wDAAwD;AACxD,cAAc,0BAAsB;AACpC,cAAc,gCAA4B;AAC1C,uEAAuE;AACvE,cAAc,2BAAuB;AACrC,0EAA0E;AAC1E,+EAA+E;AAC/E,cAAc,8BAA0B;AACxC,cAAc,uBAAmB;AACjC,4EAA4E;AAC5E,6EAA6E;AAC7E,6EAA6E;AAC7E,uDAAuD;AACvD,cAAc,wBAAoB;AAClC,cAAc,uBAAmB;AACjC,cAAc,gCAA4B;AAC1C,2EAA2E;AAC3E,yEAAyE;AACzE,4CAA4C;AAC5C,cAAc,4BAAwB;AACtC,2EAA2E;AAC3E,8EAA8E;AAC9E,cAAc,oCAAgC;AAC9C,6EAA6E;AAC7E,sDAAsD;AACtD,cAAc,gCAA4B;AAC1C,6EAA6E;AAC7E,sEAAsE;AACtE,cAAc,8BAA0B;AACxC,0EAA0E;AAC1E,+DAA+D;AAC/D,wEAAwE;AACxE,cAAc,2BAAuB;AACrC,2EAA2E;AAC3E,yEAAyE;AACzE,2CAA2C;AAC3C,cAAc,yBAAqB;AACnC,cAAc,+BAA2B"}
+{"version":3,"sources":["../../../../../../libs/shared/util/email/src/index.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\nexport * from './lib/send-email'\n// Who carries the mail (AGL-3080): the provider contract, and the selection\n// of the deployment's provider from the built-ins and any a plugin\n// registered. The providers themselves are imported by their own paths —\n// `@aglyn/shared-util-email/mail-provider-resend`, `…/mail-provider-webhook`\n// — because nothing outside the seam should name one.\nexport * from './lib/mail-provider'\nexport * from './lib/mail-providers'\nexport * from './lib/send-rate'\nexport * from './lib/sender-reputation'\nexport * from './lib/send-ceilings'\nexport * from './lib/sending-domain'\nexport * from './lib/tracking-host'\nexport * from './lib/sending-mailbox'\nexport * from './lib/host-sender'\nexport * from './lib/platform-sending-domain'\nexport * from './lib/email-health'\nexport * from './lib/system-email-catalog'\nexport * from './lib/retention-emails'\nexport * from './lib/site-care-emails'\nexport * from './lib/site-care-project-emails'\nexport * from './lib/domain-emails'\nexport * from './lib/pos-hardware-emails'\nexport * from './lib/pos-cellular-emails'\nexport * from './lib/welcome-email'\nexport * from './lib/tenant-email-catalog'\nexport * from './lib/host-email-render'\nexport * from './lib/email-render'\nexport * from './lib/text-email-html'\nexport * from './lib/marketing-send'\n// The List-Unsubscribe setting sequences and campaigns share (AGL-3307).\nexport * from './lib/list-unsubscribe'\nexport * from './lib/email-delivery-events'\n// Received mail in the platform's vocabulary, which the CRM's capture route\n// files from (AGL-2657); the provider reads it.\n// Its neighbor `./lib/svix-signature` is deliberately NOT re-exported here:\n// it holds a `crypto` HMAC, and this barrel is reached from the browser\n// through `@aglyn/shared-ui-email-campaigns`, so a webhook imports it by its\n// own path — `@aglyn/shared-util-email/svix-signature`.\nexport * from './lib/received-email'\nexport * from './lib/email-revenue-window'\n// Exported so the console drift guard can pin it against @aglyn/aglyn.\nexport * from './lib/email-media-src'\n// Same arrangement, same reason (AGL-1223): a copy of `decodeStoredNodes`\n// this scope:shared lib may not import, pinned by `email-nodes-drift.spec.ts`.\nexport * from './lib/stored-email-nodes'\nexport * from './lib/email-merge'\n// The deliverability engine every send path asks (AGL-3328): the gateway an\n// MX names and its ledger, the bounce reader, and the address verdicts. Pure\n// — the DNS lookup and the store are injected by `@aglyn/tenant-data-admin`,\n// so nothing here reaches `node:dns` from the browser.\nexport * from './lib/mail-gateway'\nexport * from './lib/mail-bounce'\nexport * from './lib/email-deliverability'\n// The sender's side of the same engine (AGL-3328): SPF, DKIM and DMARC for\n// the domain mail leaves from, and whether they align. Pure as well; the\n// lookups are `@aglyn/tenant-data-admin`'s.\nexport * from './lib/sender-readiness'\n// The outbound phishing screen a young workspace's campaigns and automated\n// email pass (AGL-3356). Pure; the hold it leads to is `tenant-data-admin`'s.\nexport * from './lib/outbound-phishing-screen'\n// The send seam's gate for that screen — the store a hold writes is injected\n// by `@aglyn/tenant-data-admin`, like the governor's.\nexport * from './lib/outbound-screen-gate'\n// The same screen read over a published page (AGL-3356): lookalike links and\n// embeds, author-defined credential fields, a brand's call to action.\nexport * from './lib/hosted-page-screen'\n// The reputation lookup every foreign link a page, an email or a redirect\n// points at passes (AGL-3451). Pure; the lookup is injected by\n// `@aglyn/tenant-data-admin`, which holds the credential and the cache.\nexport * from './lib/link-reputation'\n// The site's theme palette as plain data (AGL-3370), so a palette token an\n// author picked resolves in mail. Built without MUI; `shared-ui-theme`'s\n// parity spec holds it equal to the theme.\nexport * from './lib/email-palette'\nexport * from './lib/email-design-chrome'\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,cAAc,sBAAkB;AAChC,4EAA4E;AAC5E,mEAAmE;AACnE,yEAAyE;AACzE,6EAA6E;AAC7E,sDAAsD;AACtD,cAAc,yBAAqB;AACnC,cAAc,0BAAsB;AACpC,cAAc,qBAAiB;AAC/B,cAAc,6BAAyB;AACvC,cAAc,yBAAqB;AACnC,cAAc,0BAAsB;AACpC,cAAc,yBAAqB;AACnC,cAAc,2BAAuB;AACrC,cAAc,uBAAmB;AACjC,cAAc,mCAA+B;AAC7C,cAAc,wBAAoB;AAClC,cAAc,gCAA4B;AAC1C,cAAc,4BAAwB;AACtC,cAAc,4BAAwB;AACtC,cAAc,oCAAgC;AAC9C,cAAc,yBAAqB;AACnC,cAAc,+BAA2B;AACzC,cAAc,+BAA2B;AACzC,cAAc,yBAAqB;AACnC,cAAc,gCAA4B;AAC1C,cAAc,6BAAyB;AACvC,cAAc,wBAAoB;AAClC,cAAc,2BAAuB;AACrC,cAAc,0BAAsB;AACpC,yEAAyE;AACzE,cAAc,4BAAwB;AACtC,cAAc,iCAA6B;AAC3C,4EAA4E;AAC5E,gDAAgD;AAChD,4EAA4E;AAC5E,wEAAwE;AACxE,6EAA6E;AAC7E,wDAAwD;AACxD,cAAc,0BAAsB;AACpC,cAAc,gCAA4B;AAC1C,uEAAuE;AACvE,cAAc,2BAAuB;AACrC,0EAA0E;AAC1E,+EAA+E;AAC/E,cAAc,8BAA0B;AACxC,cAAc,uBAAmB;AACjC,4EAA4E;AAC5E,6EAA6E;AAC7E,6EAA6E;AAC7E,uDAAuD;AACvD,cAAc,wBAAoB;AAClC,cAAc,uBAAmB;AACjC,cAAc,gCAA4B;AAC1C,2EAA2E;AAC3E,yEAAyE;AACzE,4CAA4C;AAC5C,cAAc,4BAAwB;AACtC,2EAA2E;AAC3E,8EAA8E;AAC9E,cAAc,oCAAgC;AAC9C,6EAA6E;AAC7E,sDAAsD;AACtD,cAAc,gCAA4B;AAC1C,6EAA6E;AAC7E,sEAAsE;AACtE,cAAc,8BAA0B;AACxC,0EAA0E;AAC1E,+DAA+D;AAC/D,wEAAwE;AACxE,cAAc,2BAAuB;AACrC,2EAA2E;AAC3E,yEAAyE;AACzE,2CAA2C;AAC3C,cAAc,yBAAqB;AACnC,cAAc,+BAA2B"}

package/src/lib/pos-cellular-emails.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @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 { SystemEmailTemplateDefinition } from './system-email-catalog';
+export declare const POS_CELLULAR_EMAIL_KEYS: {
+    readonly paymentDue: "pos-cellular-payment-due";
+    readonly turnedOffUnpaid: "pos-cellular-turned-off-unpaid";
+};
+export declare function posCellularSystemEmailTemplates(origin: string): SystemEmailTemplateDefinition[];

package/src/lib/pos-cellular-emails.js

@@ -0,0 +1,230 @@
+/**
+ * @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.
+ */ /*==========================================
+ * 4G FOR CARD READERS, AS SYSTEM EMAILS (AGL-4038).
+ *
+ * Two emails to the people who manage a workspace's billing, about its
+ * monthly charge for 4G on its Stripe Reader S710s:
+ *
+ * - PAYMENT DUE, the day the charge doesn't go through: how much, for which
+ *   month, and the day 4G turns off for its stores unless the open invoice
+ *   is paid (pay it on the Billing page, and nothing else changes).
+ * - TURNED OFF, once that day comes and it is still unpaid: which month went
+ *   unpaid and for how much, which stores lost 4G, and the way back (pay it
+ *   on the Billing page, then turn 4G on again on the store's POS devices
+ *   card).
+ *
+ * The platform bills the charge, so they are SYSTEM emails in the platform's
+ * brand (or the workspace's white label), not a store's mail.
+ *
+ * It lives here, beside the catalog, for the reason `domain-emails.ts`
+ * gives: system emails have no plugin seam, and the staff System emails page
+ * reads this registry before any plugin loads.
+ *
+ * Amounts and dates arrive formatted; a template never does arithmetic.
+ *=========================================*/ export const POS_CELLULAR_EMAIL_KEYS = {
+    paymentDue: 'pos-cellular-payment-due',
+    turnedOffUnpaid: 'pos-cellular-turned-off-unpaid'
+};
+const SOURCE = 'libs/plugins/commerce/src/lib/server/pos-cellular-notify.ts';
+function tokens(origin) {
+    return {
+        org: {
+            name: 'org.name',
+            description: 'The workspace whose 4G was turned off',
+            sample: 'Test Org'
+        },
+        orgDue: {
+            name: 'org.name',
+            description: 'The workspace whose 4G charge is due',
+            sample: 'Test Org'
+        },
+        month: {
+            name: 'cellular.month',
+            description: 'The month whose 4G charge went unpaid',
+            sample: 'October 2026'
+        },
+        amount: {
+            name: 'cellular.amount',
+            description: 'What that month’s 4G charge came to',
+            sample: '$21.65'
+        },
+        readers: {
+            name: 'cellular.readers',
+            description: 'How many Stripe Reader S710s that month’s charge was for',
+            sample: '2 Stripe Reader S710s'
+        },
+        openedOn: {
+            name: 'cellular.openedOn',
+            description: 'The day the charge did not go through',
+            sample: 'November 2, 2026'
+        },
+        turnedOffOn: {
+            name: 'cellular.turnedOffOn',
+            description: 'The day 4G was turned off',
+            sample: 'November 16, 2026'
+        },
+        turnsOffOn: {
+            name: 'cellular.turnsOffOn',
+            description: 'The day 4G turns off for the workspace’s stores unless the charge is paid, in its time zone',
+            sample: 'November 16, 2026'
+        },
+        stores: {
+            name: 'cellular.stores',
+            description: 'The stores 4G was turned off for, one per line',
+            sample: 'Test Bakery'
+        },
+        storesWithCellular: {
+            name: 'cellular.stores',
+            description: 'The stores that have 4G now and would lose it, one per line (blank, and the row left out, when none has)',
+            sample: 'Test Bakery'
+        },
+        billingUrl: {
+            name: 'cellular.billingUrl',
+            description: 'The workspace’s Billing page, where the open invoice is paid',
+            sample: `${origin}/test-org/billing`
+        }
+    };
+}
+export function posCellularSystemEmailTemplates(origin) {
+    const t = tokens(origin);
+    return [
+        {
+            key: POS_CELLULAR_EMAIL_KEYS.paymentDue,
+            name: '4G charge unpaid: the day 4G turns off',
+            description: 'Sent to the people who manage a workspace’s billing the day its ' + 'monthly charge for 4G on Stripe Reader S710s doesn’t go through, ' + 'once: the amount, and the day 4G turns off for its stores unless ' + 'the open invoice is paid.',
+            deliveredBy: 'resend',
+            defaultSubject: '4G turns off on {{cellular.turnsOffOn}} unless the {{cellular.month}} charge is paid',
+            mergeTokens: [
+                t.orgDue,
+                t.month,
+                t.amount,
+                t.readers,
+                t.openedOn,
+                t.turnsOffOn,
+                t.storesWithCellular,
+                t.billingUrl
+            ],
+            defaultBody: [
+                {
+                    block: 'text',
+                    text: '{{org.name}} · 4G for card readers',
+                    variant: 'eyebrow'
+                },
+                {
+                    block: 'text',
+                    text: 'Your 4G charge didn’t go through',
+                    variant: 'heading'
+                },
+                {
+                    block: 'text',
+                    text: 'On {{cellular.openedOn}} we tried to charge {{cellular.amount}} for your card readers’ 4G in {{cellular.month}}, and the payment didn’t go through. The invoice is open on your Billing page. Unless it’s paid before {{cellular.turnsOffOn}}, 4G turns off for your stores that day.',
+                    variant: 'body'
+                },
+                {
+                    block: 'text',
+                    text: 'Amount due: {{cellular.amount}} for {{cellular.month}}\n4G turns off on: {{cellular.turnsOffOn}}\nReaders: {{cellular.readers}}\nStores with 4G: {{cellular.stores}}',
+                    variant: 'details'
+                },
+                {
+                    block: 'text',
+                    text: 'How to keep 4G on',
+                    variant: 'subheading'
+                },
+                {
+                    block: 'text',
+                    text: 'Pay the open invoice on your Billing page. If your card has changed, update your payment method there first. Once it’s paid, 4G stays on and there’s nothing else to do. Either way, your readers keep working on Wi-Fi or Ethernet.',
+                    variant: 'body'
+                },
+                {
+                    block: 'button',
+                    label: 'Pay on the Billing page',
+                    href: '{{cellular.billingUrl}}'
+                },
+                {
+                    block: 'text',
+                    text: 'Questions about the charge? Contact support: {{brand.supportUrl}}',
+                    variant: 'caption'
+                }
+            ],
+            footerReason: 'You’re receiving this because you manage billing for {{org.name}} on {{brand.productName}}.',
+            source: SOURCE
+        },
+        {
+            key: POS_CELLULAR_EMAIL_KEYS.turnedOffUnpaid,
+            name: '4G turned off: charge unpaid',
+            description: 'Sent to the people who manage a workspace’s billing when its monthly ' + 'charge for 4G on Stripe Reader S710s is still unpaid after the grace ' + 'period, and 4G has been turned off for its stores.',
+            deliveredBy: 'resend',
+            defaultSubject: '4G is off for your card readers: the {{cellular.month}} charge is unpaid',
+            mergeTokens: [
+                t.org,
+                t.month,
+                t.amount,
+                t.readers,
+                t.openedOn,
+                t.turnedOffOn,
+                t.stores,
+                t.billingUrl
+            ],
+            defaultBody: [
+                {
+                    block: 'text',
+                    text: '{{org.name}} · 4G for card readers',
+                    variant: 'eyebrow'
+                },
+                {
+                    block: 'text',
+                    text: 'We turned off 4G for your card readers',
+                    variant: 'heading'
+                },
+                {
+                    block: 'text',
+                    text: 'The 4G charge for {{cellular.month}} didn’t go through on {{cellular.openedOn}}, and it is still unpaid. So on {{cellular.turnedOffOn}} we turned 4G off for your stores. Your readers keep working on Wi-Fi or Ethernet.',
+                    variant: 'body'
+                },
+                {
+                    block: 'text',
+                    text: 'Unpaid: {{cellular.amount}} for {{cellular.month}}\nReaders: {{cellular.readers}}\nStores with 4G turned off: {{cellular.stores}}',
+                    variant: 'details'
+                },
+                {
+                    block: 'text',
+                    text: 'How to turn it back on',
+                    variant: 'subheading'
+                },
+                {
+                    block: 'text',
+                    text: 'Pay the open invoice on your Billing page. 4G doesn’t come back on by itself once it’s paid: turn it on again from each store’s POS devices card, in its point of sale settings.',
+                    variant: 'body'
+                },
+                {
+                    block: 'button',
+                    label: 'Pay on the Billing page',
+                    href: '{{cellular.billingUrl}}'
+                },
+                {
+                    block: 'text',
+                    text: 'Questions about the charge? Contact support: {{brand.supportUrl}}',
+                    variant: 'caption'
+                }
+            ],
+            footerReason: 'You’re receiving this because you manage billing for {{org.name}} on {{brand.productName}}.',
+            source: SOURCE
+        }
+    ];
+}
+
+//# sourceMappingURL=pos-cellular-emails.js.map

package/src/lib/pos-cellular-emails.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/shared/util/email/src/lib/pos-cellular-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\n/*==========================================\n * 4G FOR CARD READERS, AS SYSTEM EMAILS (AGL-4038).\n *\n * Two emails to the people who manage a workspace's billing, about its\n * monthly charge for 4G on its Stripe Reader S710s:\n *\n * - PAYMENT DUE, the day the charge doesn't go through: how much, for which\n *   month, and the day 4G turns off for its stores unless the open invoice\n *   is paid (pay it on the Billing page, and nothing else changes).\n * - TURNED OFF, once that day comes and it is still unpaid: which month went\n *   unpaid and for how much, which stores lost 4G, and the way back (pay it\n *   on the Billing page, then turn 4G on again on the store's POS devices\n *   card).\n *\n * The platform bills the charge, so they are SYSTEM emails in the platform's\n * brand (or the workspace's white label), not a store's mail.\n *\n * It lives here, beside the catalog, for the reason `domain-emails.ts`\n * gives: system emails have no plugin seam, and the staff System emails page\n * reads this registry before any plugin loads.\n *\n * Amounts and dates arrive formatted; a template never does arithmetic.\n *=========================================*/\n\nimport type {\n  SystemEmailMergeToken,\n  SystemEmailTemplateDefinition,\n} from './system-email-catalog'\n\nexport const POS_CELLULAR_EMAIL_KEYS = {\n  paymentDue: 'pos-cellular-payment-due',\n  turnedOffUnpaid: 'pos-cellular-turned-off-unpaid',\n} as const\n\nconst SOURCE = 'libs/plugins/commerce/src/lib/server/pos-cellular-notify.ts'\n\nfunction tokens(origin: string): Record<string, SystemEmailMergeToken> {\n  return {\n    org: { name: 'org.name', description: 'The workspace whose 4G was turned off', sample: 'Test Org' },\n    orgDue: { name: 'org.name', description: 'The workspace whose 4G charge is due', sample: 'Test Org' },\n    month: { name: 'cellular.month', description: 'The month whose 4G charge went unpaid', sample: 'October 2026' },\n    amount: { name: 'cellular.amount', description: 'What that month’s 4G charge came to', sample: '$21.65' },\n    readers: {\n      name: 'cellular.readers',\n      description: 'How many Stripe Reader S710s that month’s charge was for',\n      sample: '2 Stripe Reader S710s',\n    },\n    openedOn: { name: 'cellular.openedOn', description: 'The day the charge did not go through', sample: 'November 2, 2026' },\n    turnedOffOn: { name: 'cellular.turnedOffOn', description: 'The day 4G was turned off', sample: 'November 16, 2026' },\n    turnsOffOn: {\n      name: 'cellular.turnsOffOn',\n      description: 'The day 4G turns off for the workspace’s stores unless the charge is paid, in its time zone',\n      sample: 'November 16, 2026',\n    },\n    stores: {\n      name: 'cellular.stores',\n      description: 'The stores 4G was turned off for, one per line',\n      sample: 'Test Bakery',\n    },\n    storesWithCellular: {\n      name: 'cellular.stores',\n      description: 'The stores that have 4G now and would lose it, one per line (blank, and the row left out, when none has)',\n      sample: 'Test Bakery',\n    },\n    billingUrl: {\n      name: 'cellular.billingUrl',\n      description: 'The workspace’s Billing page, where the open invoice is paid',\n      sample: `${origin}/test-org/billing`,\n    },\n  }\n}\n\nexport function posCellularSystemEmailTemplates(origin: string): SystemEmailTemplateDefinition[] {\n  const t = tokens(origin)\n  return [\n    {\n      key: POS_CELLULAR_EMAIL_KEYS.paymentDue,\n      name: '4G charge unpaid: the day 4G turns off',\n      description:\n        'Sent to the people who manage a workspace’s billing the day its ' +\n        'monthly charge for 4G on Stripe Reader S710s doesn’t go through, ' +\n        'once: the amount, and the day 4G turns off for its stores unless ' +\n        'the open invoice is paid.',\n      deliveredBy: 'resend',\n      defaultSubject: '4G turns off on {{cellular.turnsOffOn}} unless the {{cellular.month}} charge is paid',\n      mergeTokens: [t.orgDue, t.month, t.amount, t.readers, t.openedOn, t.turnsOffOn, t.storesWithCellular, t.billingUrl],\n      defaultBody: [\n        { block: 'text', text: '{{org.name}} · 4G for card readers', variant: 'eyebrow' },\n        { block: 'text', text: 'Your 4G charge didn’t go through', variant: 'heading' },\n        {\n          block: 'text',\n          text: 'On {{cellular.openedOn}} we tried to charge {{cellular.amount}} for your card readers’ 4G in {{cellular.month}}, and the payment didn’t go through. The invoice is open on your Billing page. Unless it’s paid before {{cellular.turnsOffOn}}, 4G turns off for your stores that day.',\n          variant: 'body',\n        },\n        {\n          block: 'text',\n          text: 'Amount due: {{cellular.amount}} for {{cellular.month}}\\n4G turns off on: {{cellular.turnsOffOn}}\\nReaders: {{cellular.readers}}\\nStores with 4G: {{cellular.stores}}',\n          variant: 'details',\n        },\n        { block: 'text', text: 'How to keep 4G on', variant: 'subheading' },\n        {\n          block: 'text',\n          text: 'Pay the open invoice on your Billing page. If your card has changed, update your payment method there first. Once it’s paid, 4G stays on and there’s nothing else to do. Either way, your readers keep working on Wi-Fi or Ethernet.',\n          variant: 'body',\n        },\n        { block: 'button', label: 'Pay on the Billing page', href: '{{cellular.billingUrl}}' },\n        { block: 'text', text: 'Questions about the charge? Contact support: {{brand.supportUrl}}', variant: 'caption' },\n      ],\n      footerReason:\n        'You’re receiving this because you manage billing for {{org.name}} on {{brand.productName}}.',\n      source: SOURCE,\n    },\n    {\n      key: POS_CELLULAR_EMAIL_KEYS.turnedOffUnpaid,\n      name: '4G turned off: charge unpaid',\n      description:\n        'Sent to the people who manage a workspace’s billing when its monthly ' +\n        'charge for 4G on Stripe Reader S710s is still unpaid after the grace ' +\n        'period, and 4G has been turned off for its stores.',\n      deliveredBy: 'resend',\n      defaultSubject: '4G is off for your card readers: the {{cellular.month}} charge is unpaid',\n      mergeTokens: [t.org, t.month, t.amount, t.readers, t.openedOn, t.turnedOffOn, t.stores, t.billingUrl],\n      defaultBody: [\n        { block: 'text', text: '{{org.name}} · 4G for card readers', variant: 'eyebrow' },\n        { block: 'text', text: 'We turned off 4G for your card readers', variant: 'heading' },\n        {\n          block: 'text',\n          text: 'The 4G charge for {{cellular.month}} didn’t go through on {{cellular.openedOn}}, and it is still unpaid. So on {{cellular.turnedOffOn}} we turned 4G off for your stores. Your readers keep working on Wi-Fi or Ethernet.',\n          variant: 'body',\n        },\n        {\n          block: 'text',\n          text: 'Unpaid: {{cellular.amount}} for {{cellular.month}}\\nReaders: {{cellular.readers}}\\nStores with 4G turned off: {{cellular.stores}}',\n          variant: 'details',\n        },\n        { block: 'text', text: 'How to turn it back on', variant: 'subheading' },\n        {\n          block: 'text',\n          text: 'Pay the open invoice on your Billing page. 4G doesn’t come back on by itself once it’s paid: turn it on again from each store’s POS devices card, in its point of sale settings.',\n          variant: 'body',\n        },\n        { block: 'button', label: 'Pay on the Billing page', href: '{{cellular.billingUrl}}' },\n        { block: 'text', text: 'Questions about the charge? Contact support: {{brand.supportUrl}}', variant: 'caption' },\n      ],\n      footerReason:\n        'You’re receiving this because you manage billing for {{org.name}} on {{brand.productName}}.',\n      source: SOURCE,\n    },\n  ]\n}\n"],"names":["POS_CELLULAR_EMAIL_KEYS","paymentDue","turnedOffUnpaid","SOURCE","tokens","origin","org","name","description","sample","orgDue","month","amount","readers","openedOn","turnedOffOn","turnsOffOn","stores","storesWithCellular","billingUrl","posCellularSystemEmailTemplates","t","key","deliveredBy","defaultSubject","mergeTokens","defaultBody","block","text","variant","label","href","footerReason","source"],"mappings":"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"}

package/src/lib/pos-hardware-emails.d.ts

@@ -19,5 +19,9 @@ export declare const POS_HARDWARE_EMAIL_KEYS: {
     readonly received: "pos-hardware-order-received";
     readonly shipped: "pos-hardware-order-shipped";
     readonly delivered: "pos-hardware-order-delivered";
+    readonly canceled: "pos-hardware-order-canceled";
+    readonly refunded: "pos-hardware-order-refunded";
+    readonly invited: "pos-hardware-sign-up-invite";
+    readonly returnRefunded: "pos-hardware-return-refunded";
 };
 export declare function posHardwareSystemEmailTemplates(origin: string): SystemEmailTemplateDefinition[];