@aglyn/tenant-runtime 1.0.0-beta.143

package/src/lib/associate-company-by-domain.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @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 HostContactCreated } from '@aglyn/tenant-data-admin';
+/** What the association did, for the spec and the log. */
+export type CompanyAssociation = {
+    outcome: 'linked' | 'created';
+    companyId: string;
+} | {
+    outcome: 'none';
+    reason: 'no-domain' | 'no-org' | 'ambiguous' | 'no-match' | 'failed';
+};
+/**
+ * Link a NEW contact to the company its email domain names (AGL-2613).
+ *
+ * HubSpot associates a contact with a company on domain the moment the
+ * contact exists, and that is the moment this runs: once, from the capture
+ * door, for a person the org did not hold before. A repeat visit by somebody
+ * already held is not a new person and re-asks nothing; a door that already
+ * knew the company — the console's create drawer, an import row naming one
+ * — has said so in the facet and this is not called at all.
+ *
+ * ## Bounded: one query, one commit
+ *
+ * The query is `companies where domain == d and visibleTo array-contains-any
+ * (the capturing scope's read tokens)`, capped at two — the `(visibleTo
+ * CONTAINS, domain ASC)` composite serves it. Two rather than one because
+ * the answer has to be "exactly one": two companies at one domain visible
+ * to this site is an ambiguity a capture must not resolve by picking the
+ * first, and the contact waits for a person. The scope predicate is the
+ * console's own listener predicate, so a company this site could not open
+ * is not a match — an agency's client at `acme.com` is not linked to a
+ * sibling client's Acme.
+ *
+ * The write is one batch: the facet and the mirror on the contact, and the
+ * count on the company. The contact is fresh, so the plan is the trivial
+ * one — no previous link, nothing held elsewhere — and needs no read of the
+ * document.
+ *
+ * ## Creating is a setting, and off by default
+ *
+ * With `crm.autoCreateCompanies` on the org document, a domain no visible
+ * company carries becomes one, named after the domain and scoped exactly as
+ * the contact was — `crmScopeTokens`, the stamp every CRM creator uses —
+ * with the count starting at one. Public mailbox domains never reach this
+ * branch, because `companyDomainForEmail` answers `null` for them: a
+ * workspace's consumer list is not a list of accounts.
+ *
+ * ## The same posture as the capture
+ *
+ * Never throws. The capture has already succeeded and a form submission
+ * must not fail because the CRM could not file its author; a failure is
+ * logged and answered as `none`, and the person is exactly as capturable
+ * by hand as they were before this existed.
+ */
+export declare function associateCompanyByDomain(created: Pick<HostContactCreated, 'hostId' | 'contactId' | 'email'>): Promise<CompanyAssociation>;
+export default associateCompanyByDomain;

package/src/lib/associate-company-by-domain.js

@@ -0,0 +1,150 @@
+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 { companyDomainForEmail, companyNameForDomain, CRM_COLLECTIONS, crmReadTokens, crmScopeTokens, nameSearchFields, orgAutoCreatesCompanies } from "@aglyn/aglyn/server";
+import { consentGroupForSite, contactCompanyLinkFields, firebaseAdmin, getOrgForHost, writeContactCompanyLink } from "@aglyn/tenant-data-admin";
+import { COMPANY_CONTACTS_COUNT_FIELD, planContactCompanyLink } from "@aglyn/aglyn/server";
+import { FieldValue } from "firebase-admin/firestore";
+/**
+ * Link a NEW contact to the company its email domain names (AGL-2613).
+ *
+ * HubSpot associates a contact with a company on domain the moment the
+ * contact exists, and that is the moment this runs: once, from the capture
+ * door, for a person the org did not hold before. A repeat visit by somebody
+ * already held is not a new person and re-asks nothing; a door that already
+ * knew the company — the console's create drawer, an import row naming one
+ * — has said so in the facet and this is not called at all.
+ *
+ * ## Bounded: one query, one commit
+ *
+ * The query is `companies where domain == d and visibleTo array-contains-any
+ * (the capturing scope's read tokens)`, capped at two — the `(visibleTo
+ * CONTAINS, domain ASC)` composite serves it. Two rather than one because
+ * the answer has to be "exactly one": two companies at one domain visible
+ * to this site is an ambiguity a capture must not resolve by picking the
+ * first, and the contact waits for a person. The scope predicate is the
+ * console's own listener predicate, so a company this site could not open
+ * is not a match — an agency's client at `acme.com` is not linked to a
+ * sibling client's Acme.
+ *
+ * The write is one batch: the facet and the mirror on the contact, and the
+ * count on the company. The contact is fresh, so the plan is the trivial
+ * one — no previous link, nothing held elsewhere — and needs no read of the
+ * document.
+ *
+ * ## Creating is a setting, and off by default
+ *
+ * With `crm.autoCreateCompanies` on the org document, a domain no visible
+ * company carries becomes one, named after the domain and scoped exactly as
+ * the contact was — `crmScopeTokens`, the stamp every CRM creator uses —
+ * with the count starting at one. Public mailbox domains never reach this
+ * branch, because `companyDomainForEmail` answers `null` for them: a
+ * workspace's consumer list is not a list of accounts.
+ *
+ * ## The same posture as the capture
+ *
+ * Never throws. The capture has already succeeded and a form submission
+ * must not fail because the CRM could not file its author; a failure is
+ * logged and answered as `none`, and the person is exactly as capturable
+ * by hand as they were before this existed.
+ */ export async function associateCompanyByDomain(created) {
+    const domain = companyDomainForEmail(created.email);
+    if (!domain) return {
+        outcome: 'none',
+        reason: 'no-domain'
+    };
+    try {
+        const resolved = await getOrgForHost(created.hostId);
+        if (!resolved) return {
+            outcome: 'none',
+            reason: 'no-org'
+        };
+        const org = resolved.org;
+        const group = await consentGroupForSite(created.hostId, org);
+        const firestore = firebaseAdmin.app().firestore();
+        const orgRef = firestore.collection('orgs').doc(resolved.orgId);
+        const companiesRef = orgRef.collection(CRM_COLLECTIONS.companies);
+        const contactRef = orgRef.collection('contacts').doc(created.contactId);
+        const matches = await companiesRef.where('domain', '==', domain).where('visibleTo', 'array-contains-any', crmReadTokens(group)).limit(2).get();
+        if (matches.size > 1) return {
+            outcome: 'none',
+            reason: 'ambiguous'
+        };
+        if (matches.size === 1) {
+            const companyId = matches.docs[0].id;
+            await writeContactCompanyLink({
+                firestore,
+                contactRef,
+                contact: null,
+                companiesRef,
+                groupId: group.groupId,
+                companyId
+            });
+            return {
+                outcome: 'linked',
+                companyId
+            };
+        }
+        if (!orgAutoCreatesCompanies(org)) {
+            return {
+                outcome: 'none',
+                reason: 'no-match'
+            };
+        }
+        /*
+     * The company and the link in one commit, so a company never exists
+     * with a count of one and no contact naming it — or the reverse. The
+     * count is written as a value rather than an increment because the
+     * document is being created in the same batch, and the plan's `+1` is
+     * exactly what a fresh company with one contact stores.
+     */ const plan = planContactCompanyLink({
+            companyId: null,
+            companyIds: [],
+            heldElsewhere: []
+        }, companiesRef.doc().id);
+        if (!(plan == null ? void 0 : plan.companyId)) return {
+            outcome: 'none',
+            reason: 'failed'
+        };
+        const companyRef = companiesRef.doc(plan.companyId);
+        const batch = firestore.batch();
+        batch.set(companyRef, _extends({}, nameSearchFields(companyNameForDomain(domain)), {
+            domain,
+            visibleTo: crmScopeTokens(org, group),
+            hostId: created.hostId,
+            [COMPANY_CONTACTS_COUNT_FIELD]: 1,
+            createdAt: FieldValue.serverTimestamp(),
+            updatedAt: FieldValue.serverTimestamp()
+        }));
+        batch.update(contactRef, _extends({}, contactCompanyLinkFields(plan, group.groupId), {
+            updatedAt: FieldValue.serverTimestamp()
+        }));
+        await batch.commit();
+        return {
+            outcome: 'created',
+            companyId: plan.companyId
+        };
+    } catch (error) {
+        console.error('associateCompanyByDomain failed', created.hostId, created.contactId, error);
+        return {
+            outcome: 'none',
+            reason: 'failed'
+        };
+    }
+}
+export default associateCompanyByDomain;
+
+//# sourceMappingURL=associate-company-by-domain.js.map

package/src/lib/associate-company-by-domain.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/tenant/runtime/src/lib/associate-company-by-domain.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  companyDomainForEmail,\n  companyNameForDomain,\n  CRM_COLLECTIONS,\n  crmReadTokens,\n  crmScopeTokens,\n  nameSearchFields,\n  orgAutoCreatesCompanies,\n} from '@aglyn/aglyn/server'\nimport {\n  consentGroupForSite,\n  contactCompanyLinkFields,\n  firebaseAdmin,\n  getOrgForHost,\n  type HostContactCreated,\n  writeContactCompanyLink,\n} from '@aglyn/tenant-data-admin'\nimport { COMPANY_CONTACTS_COUNT_FIELD, planContactCompanyLink } from '@aglyn/aglyn/server'\nimport { FieldValue } from 'firebase-admin/firestore'\n\n/** What the association did, for the spec and the log. */\nexport type CompanyAssociation =\n  | { outcome: 'linked' | 'created'; companyId: string }\n  | {\n      outcome: 'none'\n      reason: 'no-domain' | 'no-org' | 'ambiguous' | 'no-match' | 'failed'\n    }\n\n/**\n * Link a NEW contact to the company its email domain names (AGL-2613).\n *\n * HubSpot associates a contact with a company on domain the moment the\n * contact exists, and that is the moment this runs: once, from the capture\n * door, for a person the org did not hold before. A repeat visit by somebody\n * already held is not a new person and re-asks nothing; a door that already\n * knew the company — the console's create drawer, an import row naming one\n * — has said so in the facet and this is not called at all.\n *\n * ## Bounded: one query, one commit\n *\n * The query is `companies where domain == d and visibleTo array-contains-any\n * (the capturing scope's read tokens)`, capped at two — the `(visibleTo\n * CONTAINS, domain ASC)` composite serves it. Two rather than one because\n * the answer has to be \"exactly one\": two companies at one domain visible\n * to this site is an ambiguity a capture must not resolve by picking the\n * first, and the contact waits for a person. The scope predicate is the\n * console's own listener predicate, so a company this site could not open\n * is not a match — an agency's client at `acme.com` is not linked to a\n * sibling client's Acme.\n *\n * The write is one batch: the facet and the mirror on the contact, and the\n * count on the company. The contact is fresh, so the plan is the trivial\n * one — no previous link, nothing held elsewhere — and needs no read of the\n * document.\n *\n * ## Creating is a setting, and off by default\n *\n * With `crm.autoCreateCompanies` on the org document, a domain no visible\n * company carries becomes one, named after the domain and scoped exactly as\n * the contact was — `crmScopeTokens`, the stamp every CRM creator uses —\n * with the count starting at one. Public mailbox domains never reach this\n * branch, because `companyDomainForEmail` answers `null` for them: a\n * workspace's consumer list is not a list of accounts.\n *\n * ## The same posture as the capture\n *\n * Never throws. The capture has already succeeded and a form submission\n * must not fail because the CRM could not file its author; a failure is\n * logged and answered as `none`, and the person is exactly as capturable\n * by hand as they were before this existed.\n */\nexport async function associateCompanyByDomain(\n  created: Pick<HostContactCreated, 'hostId' | 'contactId' | 'email'>,\n): Promise<CompanyAssociation> {\n  const domain = companyDomainForEmail(created.email)\n  if (!domain) return { outcome: 'none', reason: 'no-domain' }\n  try {\n    const resolved = await getOrgForHost(created.hostId)\n    if (!resolved) return { outcome: 'none', reason: 'no-org' }\n    const org = resolved.org as Record<string, unknown>\n    const group = await consentGroupForSite(created.hostId, org)\n    const firestore = firebaseAdmin.app().firestore()\n    const orgRef = firestore.collection('orgs').doc(resolved.orgId)\n    const companiesRef = orgRef.collection(CRM_COLLECTIONS.companies)\n    const contactRef = orgRef.collection('contacts').doc(created.contactId)\n\n    const matches = await companiesRef\n      .where('domain', '==', domain)\n      .where('visibleTo', 'array-contains-any', crmReadTokens(group))\n      .limit(2)\n      .get()\n    if (matches.size > 1) return { outcome: 'none', reason: 'ambiguous' }\n    if (matches.size === 1) {\n      const companyId = matches.docs[0].id\n      await writeContactCompanyLink({\n        firestore,\n        contactRef,\n        contact: null,\n        companiesRef,\n        groupId: group.groupId,\n        companyId,\n      })\n      return { outcome: 'linked', companyId }\n    }\n    if (!orgAutoCreatesCompanies(org)) {\n      return { outcome: 'none', reason: 'no-match' }\n    }\n\n    /*\n     * The company and the link in one commit, so a company never exists\n     * with a count of one and no contact naming it — or the reverse. The\n     * count is written as a value rather than an increment because the\n     * document is being created in the same batch, and the plan's `+1` is\n     * exactly what a fresh company with one contact stores.\n     */\n    const plan = planContactCompanyLink(\n      { companyId: null, companyIds: [], heldElsewhere: [] },\n      companiesRef.doc().id,\n    )\n    if (!plan?.companyId) return { outcome: 'none', reason: 'failed' }\n    const companyRef = companiesRef.doc(plan.companyId)\n    const batch = firestore.batch()\n    batch.set(companyRef, {\n      ...nameSearchFields(companyNameForDomain(domain)),\n      domain,\n      visibleTo: crmScopeTokens(org, group),\n      hostId: created.hostId,\n      [COMPANY_CONTACTS_COUNT_FIELD]: 1,\n      createdAt: FieldValue.serverTimestamp(),\n      updatedAt: FieldValue.serverTimestamp(),\n    })\n    batch.update(contactRef, {\n      ...contactCompanyLinkFields(plan, group.groupId),\n      updatedAt: FieldValue.serverTimestamp(),\n    })\n    await batch.commit()\n    return { outcome: 'created', companyId: plan.companyId }\n  } catch (error) {\n    console.error(\n      'associateCompanyByDomain failed',\n      created.hostId,\n      created.contactId,\n      error,\n    )\n    return { outcome: 'none', reason: 'failed' }\n  }\n}\n\nexport default associateCompanyByDomain\n"],"names":["companyDomainForEmail","companyNameForDomain","CRM_COLLECTIONS","crmReadTokens","crmScopeTokens","nameSearchFields","orgAutoCreatesCompanies","consentGroupForSite","contactCompanyLinkFields","firebaseAdmin","getOrgForHost","writeContactCompanyLink","COMPANY_CONTACTS_COUNT_FIELD","planContactCompanyLink","FieldValue","associateCompanyByDomain","created","domain","email","outcome","reason","resolved","hostId","org","group","firestore","app","orgRef","collection","doc","orgId","companiesRef","companies","contactRef","contactId","matches","where","limit","get","size","companyId","docs","id","contact","groupId","plan","companyIds","heldElsewhere","companyRef","batch","set","visibleTo","createdAt","serverTimestamp","updatedAt","update","commit","error","console"],"mappings":"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"}

package/src/lib/author-page-nodes.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @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 * as Aglyn from '@aglyn/aglyn/server';
+type NodesMap = Record<string, Aglyn.AglynNodeSchema>;
+export interface AuthorPageNodesOptions {
+    /** The addressed segment, for building this page's own pager links. */
+    slug: string;
+    /** The byline — the record's name, or the raw segment for an unknown one. */
+    name: string;
+    /** The record, when the slug named one. */
+    author?: Aglyn.ContentAuthorRecord | null;
+    hasEntries: boolean;
+    page: number;
+    perPage: number;
+    totalPages: number;
+}
+/**
+ * The author page's node tree, root first. Grafted into a layout's slot by
+ * `composeNodesWithChrome`, exactly like a screen's own nodes.
+ */
+export declare function buildAuthorPageNodes(options: AuthorPageNodesOptions): NodesMap;
+export default buildAuthorPageNodes;

package/src/lib/author-page-nodes.js

@@ -0,0 +1,296 @@
+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 * as Aglyn from "@aglyn/aglyn/server";
+/**
+ * The built-in author page as canvas nodes (AGL-2518).
+ *
+ * A designated template screen is the intended way to build this page, and
+ * this is what renders when a site has not designated one — which is every
+ * site on the day the feature ships, and every site that never designates one.
+ * It cannot be optional: bylines link here, so the address has to answer.
+ *
+ * The `collection-fallback-nodes.ts` precedent (AGL-551), down to the
+ * synthetic id prefix — building the body as NODES rather than as React is
+ * what lets it sit inside the site's shared layout, on the same render path
+ * as everything else, instead of on a second chrome-less one.
+ *
+ * Ids are synthetic and NEVER persisted; the `apx__` prefix keeps them out of
+ * every id space an author's document uses.
+ */ const ID_PREFIX = 'apx__';
+const id = (suffix)=>`${ID_PREFIX}${suffix}`;
+/**
+ * The author page's node tree, root first. Grafted into a layout's slot by
+ * `composeNodesWithChrome`, exactly like a screen's own nodes.
+ */ export function buildAuthorPageNodes(options) {
+    var _author_links;
+    const { slug, name, author, hasEntries, page, perPage, totalPages } = options;
+    const nodes = {};
+    const stackChildren = [];
+    const push = (nodeId, parentId, node)=>{
+        nodes[nodeId] = _extends({
+            $id: nodeId,
+            parentId
+        }, node);
+        stackChildren.push(nodeId);
+        return nodeId;
+    };
+    nodes[Aglyn.NODE_ROOT_ID] = {
+        $id: Aglyn.NODE_ROOT_ID,
+        componentId: 'div',
+        nodes: [
+            id('container')
+        ]
+    };
+    nodes[id('container')] = {
+        $id: id('container'),
+        parentId: Aglyn.NODE_ROOT_ID,
+        componentId: 'muiContainer',
+        pluginId: 'mui',
+        // `md`, as a collection article takes: this page is a profile above a
+        // reading list, not a dense grid.
+        props: {
+            maxWidth: 'md',
+            sx: {
+                paddingTop: 6,
+                paddingBottom: 8
+            }
+        },
+        nodes: [
+            id('stack')
+        ]
+    };
+    nodes[id('stack')] = {
+        $id: id('stack'),
+        parentId: id('container'),
+        componentId: 'muiStack',
+        pluginId: 'mui',
+        props: {
+            spacing: 5
+        },
+        nodes: stackChildren
+    };
+    /*
+    The profile. Props are set from the record HERE rather than left to
+    `expandContentAuthorProfile`, because this body is built with the record
+    already in hand — the expansion exists for a designed template, where the
+    block was placed long before any author was routed through it.
+
+    `name` falls back to the raw segment so an unknown slug still renders a
+    page with a heading on it, which is the same "empty archive, not a crash"
+    the category route settled on.
+  */ push(id('profile'), id('stack'), {
+        componentId: Aglyn.CONTENT_AUTHOR_PROFILE_COMPONENT_ID,
+        pluginId: 'mui',
+        props: _extends({
+            name: name || (author == null ? void 0 : author.name) || ''
+        }, (author == null ? void 0 : author.bio) ? {
+            bio: author.bio
+        } : {}, (author == null ? void 0 : author.image) ? {
+            image: author.image
+        } : {}, (author == null ? void 0 : author.jobTitle) ? {
+            jobTitle: author.jobTitle
+        } : {}, (author == null ? void 0 : author.worksFor) ? {
+            worksFor: author.worksFor
+        } : {}, (author == null ? void 0 : author.url) ? {
+            url: author.url
+        } : {}, (author == null ? void 0 : (_author_links = author.links) == null ? void 0 : _author_links.length) ? {
+            links: author.links
+        } : {})
+    });
+    if (!hasEntries) {
+        push(id('empty'), id('stack'), {
+            componentId: 'muiTypography',
+            pluginId: 'mui',
+            props: {
+                variant: 'body1',
+                // Named, not "This author has published nothing" — the page is about
+                // a person, and the sentence should read like one.
+                children: `${name} hasn’t published anything yet.`,
+                sx: {
+                    color: 'text.secondary'
+                }
+            }
+        });
+        return nodes;
+    }
+    push(id('heading'), id('stack'), {
+        componentId: 'muiTypography',
+        pluginId: 'mui',
+        props: {
+            variant: 'h5',
+            // `h2`: the Author Profile block above owns the page's `h1`.
+            component: 'h2',
+            children: `Posts by ${name}`
+        }
+    });
+    /*
+    The entries block, over the author's OWN entries.
+
+    `page`/`perPage` are pinned rather than inherited, because the routed
+    "collection" here is synthetic (`AUTHOR_ENTRIES_SOURCE_SLUG`) and the
+    window the loader already computed is the one this page is paging.
+
+    Each card labels which section its post came from — the one thing a
+    single-collection listing never has to say and a cross-collection one
+    always does. `{{entry.collection}}` is empty on every other listing, so
+    the same card template is correct everywhere.
+  */ push(id('entries'), id('stack'), {
+        componentId: Aglyn.COLLECTION_ENTRIES_COMPONENT_ID,
+        pluginId: 'mui',
+        props: {
+            spacing: 4,
+            perPage,
+            page
+        },
+        nodes: [
+            id('item')
+        ]
+    });
+    nodes[id('item')] = {
+        $id: id('item'),
+        parentId: id('entries'),
+        componentId: 'muiStack',
+        pluginId: 'mui',
+        props: {
+            spacing: 0.5
+        },
+        nodes: [
+            id('item-collection'),
+            id('item-title'),
+            id('item-date'),
+            id('item-excerpt'),
+            id('item-link')
+        ]
+    };
+    const item = (suffix, props, componentId = 'muiTypography')=>{
+        nodes[id(suffix)] = {
+            $id: id(suffix),
+            parentId: id('item'),
+            componentId,
+            pluginId: 'mui',
+            props
+        };
+    };
+    /*
+    The collection and the date are two NODES, not one string joined by a
+    middle dot.
+
+    A `·` written into the template is a literal, and a token beside it is
+    not: an entry that is live with no `publishedAt` — a legacy post, or one
+    flipped due without a timestamp — would render `Blog · ` with the
+    separator dangling off the end. The joined form is right where the values
+    are computed together and the empty ones can be dropped (Entry Meta does
+    exactly that); it is wrong in a template, which has no conditional and
+    substitutes each token independently.
+
+    Stacked rather than in a row for the same reason, and it puts the card on
+    the collection fallback's own shape (AGL-551) — one extra line above it,
+    nothing else different.
+  */ item('item-collection', {
+        variant: 'overline',
+        children: '{{entry.collection}}',
+        sx: {
+            color: 'text.secondary'
+        }
+    });
+    item('item-title', {
+        variant: 'h6',
+        component: 'h3',
+        children: '{{entry.title}}'
+    });
+    item('item-date', {
+        variant: 'caption',
+        children: '{{entry.date}}',
+        sx: {
+            color: 'text.secondary'
+        }
+    });
+    item('item-excerpt', {
+        variant: 'body1',
+        children: '{{entry.excerpt}}'
+    });
+    item('item-link', {
+        href: '{{entry.url}}',
+        children: 'Read more',
+        size: 'small',
+        sx: {
+            alignSelf: 'flex-start'
+        }
+    }, 'muiScreenLink');
+    if (totalPages > 1) {
+        // Through the shared pager computation, so this fallback and the
+        // `{{pagination.*}}` tokens a designed template binds cannot disagree
+        // about which page they are on. An edge is the empty string, which is
+        // exactly the "no link here" this body already meant.
+        const pager = Aglyn.contentAuthorPaginationLinks(_extends({}, author ? {
+            author
+        } : {
+            authorName: slug
+        }, {
+            page,
+            totalPages
+        }));
+        const pagerChildren = [];
+        const pagerLink = (suffix, href, label)=>{
+            nodes[id(suffix)] = {
+                $id: id(suffix),
+                parentId: id('pager'),
+                componentId: 'muiScreenLink',
+                pluginId: 'mui',
+                props: {
+                    href,
+                    children: label
+                }
+            };
+            pagerChildren.push(id(suffix));
+        };
+        if (pager.prevUrl) pagerLink('prev', pager.prevUrl, '← Newer');
+        nodes[id('pageinfo')] = {
+            $id: id('pageinfo'),
+            parentId: id('pager'),
+            componentId: 'muiTypography',
+            pluginId: 'mui',
+            props: {
+                variant: 'body2',
+                children: `Page ${pager.page} of ${pager.totalPages}`,
+                sx: {
+                    color: 'text.secondary'
+                }
+            }
+        };
+        pagerChildren.push(id('pageinfo'));
+        if (pager.nextUrl) pagerLink('next', pager.nextUrl, 'Older →');
+        push(id('pager'), id('stack'), {
+            componentId: 'muiStack',
+            pluginId: 'mui',
+            props: {
+                direction: 'row',
+                spacing: 3,
+                sx: {
+                    alignItems: 'center',
+                    justifyContent: 'center',
+                    paddingTop: 2
+                }
+            },
+            nodes: pagerChildren
+        });
+    }
+    return nodes;
+}
+export default buildAuthorPageNodes;
+
+//# sourceMappingURL=author-page-nodes.js.map

package/src/lib/author-page-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/tenant/runtime/src/lib/author-page-nodes.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 * as Aglyn from '@aglyn/aglyn/server'\n\n/**\n * The built-in author page as canvas nodes (AGL-2518).\n *\n * A designated template screen is the intended way to build this page, and\n * this is what renders when a site has not designated one — which is every\n * site on the day the feature ships, and every site that never designates one.\n * It cannot be optional: bylines link here, so the address has to answer.\n *\n * The `collection-fallback-nodes.ts` precedent (AGL-551), down to the\n * synthetic id prefix — building the body as NODES rather than as React is\n * what lets it sit inside the site's shared layout, on the same render path\n * as everything else, instead of on a second chrome-less one.\n *\n * Ids are synthetic and NEVER persisted; the `apx__` prefix keeps them out of\n * every id space an author's document uses.\n */\n\nconst ID_PREFIX = 'apx__'\nconst id = (suffix: string) => `${ID_PREFIX}${suffix}`\n\ntype NodesMap = Record<string, Aglyn.AglynNodeSchema>\n\nexport interface AuthorPageNodesOptions {\n  /** The addressed segment, for building this page's own pager links. */\n  slug: string\n  /** The byline — the record's name, or the raw segment for an unknown one. */\n  name: string\n  /** The record, when the slug named one. */\n  author?: Aglyn.ContentAuthorRecord | null\n  hasEntries: boolean\n  page: number\n  perPage: number\n  totalPages: number\n}\n\n/**\n * The author page's node tree, root first. Grafted into a layout's slot by\n * `composeNodesWithChrome`, exactly like a screen's own nodes.\n */\nexport function buildAuthorPageNodes(\n  options: AuthorPageNodesOptions,\n): NodesMap {\n  const { slug, name, author, hasEntries, page, perPage, totalPages } = options\n  const nodes: NodesMap = {}\n  const stackChildren: string[] = []\n\n  const push = (\n    nodeId: string,\n    parentId: string,\n    node: Omit<Aglyn.AglynNodeSchema, '$id' | 'parentId'>,\n  ) => {\n    nodes[nodeId] = { $id: nodeId, parentId, ...node } as Aglyn.AglynNodeSchema\n    stackChildren.push(nodeId)\n    return nodeId\n  }\n\n  nodes[Aglyn.NODE_ROOT_ID] = {\n    $id: Aglyn.NODE_ROOT_ID,\n    componentId: 'div',\n    nodes: [id('container')],\n  } as Aglyn.AglynNodeSchema\n  nodes[id('container')] = {\n    $id: id('container'),\n    parentId: Aglyn.NODE_ROOT_ID,\n    componentId: 'muiContainer',\n    pluginId: 'mui',\n    // `md`, as a collection article takes: this page is a profile above a\n    // reading list, not a dense grid.\n    props: { maxWidth: 'md', sx: { paddingTop: 6, paddingBottom: 8 } },\n    nodes: [id('stack')],\n  } as Aglyn.AglynNodeSchema\n  nodes[id('stack')] = {\n    $id: id('stack'),\n    parentId: id('container'),\n    componentId: 'muiStack',\n    pluginId: 'mui',\n    props: { spacing: 5 },\n    nodes: stackChildren,\n  } as Aglyn.AglynNodeSchema\n\n  /*\n    The profile. Props are set from the record HERE rather than left to\n    `expandContentAuthorProfile`, because this body is built with the record\n    already in hand — the expansion exists for a designed template, where the\n    block was placed long before any author was routed through it.\n\n    `name` falls back to the raw segment so an unknown slug still renders a\n    page with a heading on it, which is the same \"empty archive, not a crash\"\n    the category route settled on.\n  */\n  push(id('profile'), id('stack'), {\n    componentId: Aglyn.CONTENT_AUTHOR_PROFILE_COMPONENT_ID,\n    pluginId: 'mui',\n    props: {\n      name: name || author?.name || '',\n      ...(author?.bio ? { bio: author.bio } : {}),\n      ...(author?.image ? { image: author.image } : {}),\n      ...(author?.jobTitle ? { jobTitle: author.jobTitle } : {}),\n      ...(author?.worksFor ? { worksFor: author.worksFor } : {}),\n      ...(author?.url ? { url: author.url } : {}),\n      ...(author?.links?.length ? { links: author.links } : {}),\n    },\n  })\n\n  if (!hasEntries) {\n    push(id('empty'), id('stack'), {\n      componentId: 'muiTypography',\n      pluginId: 'mui',\n      props: {\n        variant: 'body1',\n        // Named, not \"This author has published nothing\" — the page is about\n        // a person, and the sentence should read like one.\n        children: `${name} hasn’t published anything yet.`,\n        sx: { color: 'text.secondary' },\n      },\n    })\n    return nodes\n  }\n\n  push(id('heading'), id('stack'), {\n    componentId: 'muiTypography',\n    pluginId: 'mui',\n    props: {\n      variant: 'h5',\n      // `h2`: the Author Profile block above owns the page's `h1`.\n      component: 'h2',\n      children: `Posts by ${name}`,\n    },\n  })\n\n  /*\n    The entries block, over the author's OWN entries.\n\n    `page`/`perPage` are pinned rather than inherited, because the routed\n    \"collection\" here is synthetic (`AUTHOR_ENTRIES_SOURCE_SLUG`) and the\n    window the loader already computed is the one this page is paging.\n\n    Each card labels which section its post came from — the one thing a\n    single-collection listing never has to say and a cross-collection one\n    always does. `{{entry.collection}}` is empty on every other listing, so\n    the same card template is correct everywhere.\n  */\n  push(id('entries'), id('stack'), {\n    componentId: Aglyn.COLLECTION_ENTRIES_COMPONENT_ID,\n    pluginId: 'mui',\n    props: { spacing: 4, perPage, page },\n    nodes: [id('item')],\n  })\n  nodes[id('item')] = {\n    $id: id('item'),\n    parentId: id('entries'),\n    componentId: 'muiStack',\n    pluginId: 'mui',\n    props: { spacing: 0.5 },\n    nodes: [\n      id('item-collection'),\n      id('item-title'),\n      id('item-date'),\n      id('item-excerpt'),\n      id('item-link'),\n    ],\n  } as Aglyn.AglynNodeSchema\n  const item = (\n    suffix: string,\n    props: Record<string, unknown>,\n    componentId = 'muiTypography',\n  ) => {\n    nodes[id(suffix)] = {\n      $id: id(suffix),\n      parentId: id('item'),\n      componentId,\n      pluginId: 'mui',\n      props,\n    } as Aglyn.AglynNodeSchema\n  }\n  /*\n    The collection and the date are two NODES, not one string joined by a\n    middle dot.\n\n    A `·` written into the template is a literal, and a token beside it is\n    not: an entry that is live with no `publishedAt` — a legacy post, or one\n    flipped due without a timestamp — would render `Blog · ` with the\n    separator dangling off the end. The joined form is right where the values\n    are computed together and the empty ones can be dropped (Entry Meta does\n    exactly that); it is wrong in a template, which has no conditional and\n    substitutes each token independently.\n\n    Stacked rather than in a row for the same reason, and it puts the card on\n    the collection fallback's own shape (AGL-551) — one extra line above it,\n    nothing else different.\n  */\n  item('item-collection', {\n    variant: 'overline',\n    children: '{{entry.collection}}',\n    sx: { color: 'text.secondary' },\n  })\n  item('item-title', {\n    variant: 'h6',\n    component: 'h3',\n    children: '{{entry.title}}',\n  })\n  item('item-date', {\n    variant: 'caption',\n    children: '{{entry.date}}',\n    sx: { color: 'text.secondary' },\n  })\n  item('item-excerpt', { variant: 'body1', children: '{{entry.excerpt}}' })\n  item(\n    'item-link',\n    {\n      href: '{{entry.url}}',\n      children: 'Read more',\n      size: 'small',\n      sx: { alignSelf: 'flex-start' },\n    },\n    'muiScreenLink',\n  )\n\n  if (totalPages > 1) {\n    // Through the shared pager computation, so this fallback and the\n    // `{{pagination.*}}` tokens a designed template binds cannot disagree\n    // about which page they are on. An edge is the empty string, which is\n    // exactly the \"no link here\" this body already meant.\n    const pager = Aglyn.contentAuthorPaginationLinks({\n      ...(author ? { author } : { authorName: slug }),\n      page,\n      totalPages,\n    })\n    const pagerChildren: string[] = []\n    const pagerLink = (suffix: string, href: string, label: string) => {\n      nodes[id(suffix)] = {\n        $id: id(suffix),\n        parentId: id('pager'),\n        componentId: 'muiScreenLink',\n        pluginId: 'mui',\n        props: { href, children: label },\n      } as Aglyn.AglynNodeSchema\n      pagerChildren.push(id(suffix))\n    }\n    if (pager.prevUrl) pagerLink('prev', pager.prevUrl, '← Newer')\n    nodes[id('pageinfo')] = {\n      $id: id('pageinfo'),\n      parentId: id('pager'),\n      componentId: 'muiTypography',\n      pluginId: 'mui',\n      props: {\n        variant: 'body2',\n        children: `Page ${pager.page} of ${pager.totalPages}`,\n        sx: { color: 'text.secondary' },\n      },\n    } as Aglyn.AglynNodeSchema\n    pagerChildren.push(id('pageinfo'))\n    if (pager.nextUrl) pagerLink('next', pager.nextUrl, 'Older →')\n    push(id('pager'), id('stack'), {\n      componentId: 'muiStack',\n      pluginId: 'mui',\n      props: {\n        direction: 'row',\n        spacing: 3,\n        sx: { alignItems: 'center', justifyContent: 'center', paddingTop: 2 },\n      },\n      nodes: pagerChildren,\n    })\n  }\n\n  return nodes\n}\n\nexport default buildAuthorPageNodes\n"],"names":["Aglyn","ID_PREFIX","id","suffix","buildAuthorPageNodes","options","author","slug","name","hasEntries","page","perPage","totalPages","nodes","stackChildren","push","nodeId","parentId","node","$id","NODE_ROOT_ID","componentId","pluginId","props","maxWidth","sx","paddingTop","paddingBottom","spacing","CONTENT_AUTHOR_PROFILE_COMPONENT_ID","bio","image","jobTitle","worksFor","url","links","length","variant","children","color","component","COLLECTION_ENTRIES_COMPONENT_ID","item","href","size","alignSelf","pager","contentAuthorPaginationLinks","authorName","pagerChildren","pagerLink","label","prevUrl","nextUrl","direction","alignItems","justifyContent"],"mappings":"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"}

package/src/lib/built-in-page-layout.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @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.
+ */
+/**
+ * Which shared layout wraps the pages the platform builds rather than the
+ * author does (AGL-2513) — site search today, and the collection article a
+ * site with no entry template falls back to.
+ *
+ * ## Why a setting and not just the home screen's layout
+ *
+ * The home screen's layout was already the implicit answer for the collection
+ * fallback, and it is the right DEFAULT — a site with one layout needs to
+ * configure nothing, and every site has a home page. It is the wrong RULE.
+ * Plenty of sites give the home page a layout of its own: a transparent
+ * header over a hero, no breadcrumb, a fat marketing footer. Search results
+ * inheriting that is how `/search` ends up with a header designed to sit on
+ * top of an image it does not have.
+ *
+ * `host.builtInPageLayoutId` is the escape hatch, and it is a LAYOUT id
+ * rather than a screen id on purpose. What a built-in page needs is the
+ * site's chrome around a body the platform composes; designating a screen
+ * would mean designating a page whose content is ignored — a slot the author
+ * cannot fill and cannot see the shape of.
+ *
+ * Returns `undefined` when neither is available, and every caller treats that
+ * as "render the body with no chrome" rather than as a failure: a search page
+ * without a header is worse than one with, and a search page that 500s
+ * because a layout was deleted is worse than both.
+ */
+export declare const BUILT_IN_PAGE_LAYOUT_FIELD: "builtInPageLayoutId";
+export declare function resolveBuiltInPageLayoutId(options: {
+    hostId: string;
+    host: any;
+}): Promise<string | undefined>;
+export default resolveBuiltInPageLayoutId;