@aglyn/aglyn 1.0.0-beta.250 → 1.0.0-beta.253

package/src/lib/app-utils/email-block-starters.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @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 email plugin's bundle id: the `pluginId` of every element in its bands. */
+export declare const EMAIL_BLOCK_STARTER_PLUGIN_ID = "email";
+/** One element of a nested starter tree, as an element preset's `data` holds it. */
+export interface EmailBlockStarterNode {
+    $id: null;
+    componentId: string;
+    pluginId: string;
+    props: Record<string, unknown>;
+    nodes?: EmailBlockStarterNode[];
+}
+/**
+ * The Footer's small print, a muted gray that still reads at 5:1 on white.
+ * A literal on purpose: it is written into the sent mail's own HTML, where no
+ * theme token resolves.
+ */
+export declare const EMAIL_FOOTER_TEXT_COLOR = "#6b6b6b";
+export declare const EMAIL_BLOCK_STARTER_TREES: Readonly<Record<'header' | 'footer', EmailBlockStarterNode>>;
+/**
+ * {@link EMAIL_BLOCK_STARTER_TREES} as JSON text: the form the native apps
+ * read them in (`Contracts.emailBlockStarterTreesJson`), parsed when a block
+ * is started.
+ */
+export declare const EMAIL_BLOCK_STARTER_TREES_JSON: string;

package/src/lib/app-utils/email-block-starters.js

@@ -0,0 +1,122 @@
+/**
+ * @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 two email bands a Header or Footer email block starts from (AGL-3287),
+ * as plain data: the email plugin registers them as element presets (so an
+ * author can drop one into an email), the Components page starts a reusable
+ * block from the same trees, and the native apps start theirs from the values
+ * generated from here. One tree each, wherever it is started from.
+ *
+ * The words are placeholders to replace. No merge token names the company in
+ * both kinds of email — a campaign supplies `{{org.name}}`, and no token is
+ * supplied by every one of a site's own emails — while a token an email does
+ * not supply is blanked before sending, which would leave the header with no
+ * name at all.
+ *
+ * The footer carries no unsubscribe link: a campaign send appends its own,
+ * and a second one would do the same thing twice.
+ */ /** The email plugin's bundle id: the `pluginId` of every element in its bands. */ export const EMAIL_BLOCK_STARTER_PLUGIN_ID = 'email';
+/**
+ * The Footer's small print, a muted gray that still reads at 5:1 on white.
+ * A literal on purpose: it is written into the sent mail's own HTML, where no
+ * theme token resolves.
+ */ export const EMAIL_FOOTER_TEXT_COLOR = '#6b6b6b';
+const FOOTER_TEXT_COLOR = EMAIL_FOOTER_TEXT_COLOR;
+export const EMAIL_BLOCK_STARTER_TREES = {
+    header: {
+        $id: null,
+        componentId: 'emailSection',
+        pluginId: EMAIL_BLOCK_STARTER_PLUGIN_ID,
+        // Marks the band as the email's header, so the sender's own header is
+        // not drawn above it (AGL-3372).
+        props: {
+            align: 'center',
+            padding: 24,
+            emailRole: 'header'
+        },
+        nodes: [
+            {
+                $id: null,
+                componentId: 'emailImage',
+                pluginId: EMAIL_BLOCK_STARTER_PLUGIN_ID,
+                props: {
+                    alt: 'Your company logo',
+                    width: 160,
+                    align: 'center'
+                }
+            },
+            {
+                $id: null,
+                componentId: 'emailText',
+                pluginId: EMAIL_BLOCK_STARTER_PLUGIN_ID,
+                props: {
+                    children: 'Your company',
+                    variant: 'subheading',
+                    align: 'center'
+                }
+            }
+        ]
+    },
+    footer: {
+        $id: null,
+        componentId: 'emailSection',
+        pluginId: EMAIL_BLOCK_STARTER_PLUGIN_ID,
+        // Marks the band as the email's footer, so the sender's own footer is
+        // not drawn under it (AGL-3372).
+        props: {
+            align: 'center',
+            padding: 24,
+            emailRole: 'footer'
+        },
+        nodes: [
+            {
+                $id: null,
+                componentId: 'emailDivider',
+                pluginId: EMAIL_BLOCK_STARTER_PLUGIN_ID,
+                props: {}
+            },
+            {
+                $id: null,
+                componentId: 'emailText',
+                pluginId: EMAIL_BLOCK_STARTER_PLUGIN_ID,
+                props: {
+                    children: 'Your company · 123 Main St, City',
+                    variant: 'caption',
+                    align: 'center',
+                    color: FOOTER_TEXT_COLOR
+                }
+            },
+            {
+                $id: null,
+                componentId: 'emailText',
+                pluginId: EMAIL_BLOCK_STARTER_PLUGIN_ID,
+                props: {
+                    children: "You're receiving this because you're a customer of Your company.",
+                    variant: 'caption',
+                    align: 'center',
+                    color: FOOTER_TEXT_COLOR
+                }
+            }
+        ]
+    }
+};
+/**
+ * {@link EMAIL_BLOCK_STARTER_TREES} as JSON text: the form the native apps
+ * read them in (`Contracts.emailBlockStarterTreesJson`), parsed when a block
+ * is started.
+ */ export const EMAIL_BLOCK_STARTER_TREES_JSON = JSON.stringify(EMAIL_BLOCK_STARTER_TREES);
+
+//# sourceMappingURL=email-block-starters.js.map

package/src/lib/app-utils/email-block-starters.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/email-block-starters.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 * The two email bands a Header or Footer email block starts from (AGL-3287),\n * as plain data: the email plugin registers them as element presets (so an\n * author can drop one into an email), the Components page starts a reusable\n * block from the same trees, and the native apps start theirs from the values\n * generated from here. One tree each, wherever it is started from.\n *\n * The words are placeholders to replace. No merge token names the company in\n * both kinds of email — a campaign supplies `{{org.name}}`, and no token is\n * supplied by every one of a site's own emails — while a token an email does\n * not supply is blanked before sending, which would leave the header with no\n * name at all.\n *\n * The footer carries no unsubscribe link: a campaign send appends its own,\n * and a second one would do the same thing twice.\n */\n\n/** The email plugin's bundle id: the `pluginId` of every element in its bands. */\nexport const EMAIL_BLOCK_STARTER_PLUGIN_ID = 'email'\n\n/** One element of a nested starter tree, as an element preset's `data` holds it. */\nexport interface EmailBlockStarterNode {\n  $id: null\n  componentId: string\n  pluginId: string\n  props: Record<string, unknown>\n  nodes?: EmailBlockStarterNode[]\n}\n\n/**\n * The Footer's small print, a muted gray that still reads at 5:1 on white.\n * A literal on purpose: it is written into the sent mail's own HTML, where no\n * theme token resolves.\n */\nexport const EMAIL_FOOTER_TEXT_COLOR = '#6b6b6b'\nconst FOOTER_TEXT_COLOR = EMAIL_FOOTER_TEXT_COLOR\n\nexport const EMAIL_BLOCK_STARTER_TREES: Readonly<\n  Record<'header' | 'footer', EmailBlockStarterNode>\n> = {\n  header: {\n    $id: null,\n    componentId: 'emailSection',\n    pluginId: EMAIL_BLOCK_STARTER_PLUGIN_ID,\n    // Marks the band as the email's header, so the sender's own header is\n    // not drawn above it (AGL-3372).\n    props: { align: 'center', padding: 24, emailRole: 'header' },\n    nodes: [\n      {\n        $id: null,\n        componentId: 'emailImage',\n        pluginId: EMAIL_BLOCK_STARTER_PLUGIN_ID,\n        props: { alt: 'Your company logo', width: 160, align: 'center' },\n      },\n      {\n        $id: null,\n        componentId: 'emailText',\n        pluginId: EMAIL_BLOCK_STARTER_PLUGIN_ID,\n        props: {\n          children: 'Your company',\n          variant: 'subheading',\n          align: 'center',\n        },\n      },\n    ],\n  },\n  footer: {\n    $id: null,\n    componentId: 'emailSection',\n    pluginId: EMAIL_BLOCK_STARTER_PLUGIN_ID,\n    // Marks the band as the email's footer, so the sender's own footer is\n    // not drawn under it (AGL-3372).\n    props: { align: 'center', padding: 24, emailRole: 'footer' },\n    nodes: [\n      {\n        $id: null,\n        componentId: 'emailDivider',\n        pluginId: EMAIL_BLOCK_STARTER_PLUGIN_ID,\n        props: {},\n      },\n      {\n        $id: null,\n        componentId: 'emailText',\n        pluginId: EMAIL_BLOCK_STARTER_PLUGIN_ID,\n        props: {\n          children: 'Your company · 123 Main St, City',\n          variant: 'caption',\n          align: 'center',\n          color: FOOTER_TEXT_COLOR,\n        },\n      },\n      {\n        $id: null,\n        componentId: 'emailText',\n        pluginId: EMAIL_BLOCK_STARTER_PLUGIN_ID,\n        props: {\n          children:\n            \"You're receiving this because you're a customer of Your company.\",\n          variant: 'caption',\n          align: 'center',\n          color: FOOTER_TEXT_COLOR,\n        },\n      },\n    ],\n  },\n}\n\n/**\n * {@link EMAIL_BLOCK_STARTER_TREES} as JSON text: the form the native apps\n * read them in (`Contracts.emailBlockStarterTreesJson`), parsed when a block\n * is started.\n */\nexport const EMAIL_BLOCK_STARTER_TREES_JSON: string = JSON.stringify(\n  EMAIL_BLOCK_STARTER_TREES,\n)\n"],"names":["EMAIL_BLOCK_STARTER_PLUGIN_ID","EMAIL_FOOTER_TEXT_COLOR","FOOTER_TEXT_COLOR","EMAIL_BLOCK_STARTER_TREES","header","$id","componentId","pluginId","props","align","padding","emailRole","nodes","alt","width","children","variant","footer","color","EMAIL_BLOCK_STARTER_TREES_JSON","JSON","stringify"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;CAeC,GAED,gFAAgF,GAChF,OAAO,MAAMA,gCAAgC,QAAO;AAWpD;;;;CAIC,GACD,OAAO,MAAMC,0BAA0B,UAAS;AAChD,MAAMC,oBAAoBD;AAE1B,OAAO,MAAME,4BAET;IACFC,QAAQ;QACNC,KAAK;QACLC,aAAa;QACbC,UAAUP;QACV,sEAAsE;QACtE,iCAAiC;QACjCQ,OAAO;YAAEC,OAAO;YAAUC,SAAS;YAAIC,WAAW;QAAS;QAC3DC,OAAO;YACL;gBACEP,KAAK;gBACLC,aAAa;gBACbC,UAAUP;gBACVQ,OAAO;oBAAEK,KAAK;oBAAqBC,OAAO;oBAAKL,OAAO;gBAAS;YACjE;YACA;gBACEJ,KAAK;gBACLC,aAAa;gBACbC,UAAUP;gBACVQ,OAAO;oBACLO,UAAU;oBACVC,SAAS;oBACTP,OAAO;gBACT;YACF;SACD;IACH;IACAQ,QAAQ;QACNZ,KAAK;QACLC,aAAa;QACbC,UAAUP;QACV,sEAAsE;QACtE,iCAAiC;QACjCQ,OAAO;YAAEC,OAAO;YAAUC,SAAS;YAAIC,WAAW;QAAS;QAC3DC,OAAO;YACL;gBACEP,KAAK;gBACLC,aAAa;gBACbC,UAAUP;gBACVQ,OAAO,CAAC;YACV;YACA;gBACEH,KAAK;gBACLC,aAAa;gBACbC,UAAUP;gBACVQ,OAAO;oBACLO,UAAU;oBACVC,SAAS;oBACTP,OAAO;oBACPS,OAAOhB;gBACT;YACF;YACA;gBACEG,KAAK;gBACLC,aAAa;gBACbC,UAAUP;gBACVQ,OAAO;oBACLO,UACE;oBACFC,SAAS;oBACTP,OAAO;oBACPS,OAAOhB;gBACT;YACF;SACD;IACH;AACF,EAAC;AAED;;;;CAIC,GACD,OAAO,MAAMiB,iCAAyCC,KAAKC,SAAS,CAClElB,2BACD"}

package/src/lib/app-utils/health-report.js

@@ -1465,6 +1465,17 @@ export function meteredPricingHealth(facts, ms) {
         graceMinutes: 90,
         drives: 'Sends each new account the getting-started email its stage owes it, once per crossing: confirm your email, build your site, publish your changes, your site is live, pick up where you left off (AGL-3692). If it stops, an account that stalls hears nothing after the welcome email.'
     },
+    {
+        id: 'ad-audience-sync',
+        label: 'Account-holder ad audiences',
+        // Nightly (AGL-3780). It beats on every scheduled POST, flag on or off,
+        // so the row is watched from the first night.
+        cron: '40 7 * * *',
+        runner: 'cloud-scheduler',
+        target: '/api/admin/ad-audience-sync',
+        graceMinutes: 90,
+        drives: 'Keeps the operator’s own Meta, Google and LinkedIn customer-list audiences in step with eligible US account holders, as hashed addresses (AGL-3780). If it stops, an account that was erased, banned or opted out stays in the audiences, and new sign-ups are never added.'
+    },
     {
         id: 'firestore-export',
         label: 'Weekly Firestore export',