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

package/src/lib/app-utils/crm-digest.d.ts

@@ -1,185 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { type CrmLeadFields, type CrmTask } from './crm';
-/**
- * The zone the digest's "today" is read in when nothing else names one.
- *
- * The schedule fires at 13:00 UTC, which is 08:00 here, so the window this
- * zone draws is the morning the mail arrives in for the people the product
- * is built with. A member elsewhere reads a window that is at most a few
- * hours off their own, which is what a morning summary can tolerate and a
- * "due at 9:00" reminder could not — that reminder is the assignment
- * notification's job, not this one's.
- */
-export declare const CRM_DIGEST_DEFAULT_TIME_ZONE = "America/Chicago";
-/** How long a `new` lead may sit untouched before the digest names it. */
-export declare const CRM_DIGEST_LEAD_AGE_MS: number;
-/**
- * The most due tasks one org's sweep reads.
- *
- * One query per org, ordered soonest-due first, so an org with more than this
- * many overdue-or-today tasks digests the oldest five hundred and reports the
- * window as full rather than reading without bound. Five hundred is an org
- * whose problem is not that nobody reminded them.
- */
-export declare const CRM_DIGEST_TASK_CEILING = 500;
-/**
- * The most old leads one site's sweep reads.
- *
- * The same shape the Leads section uses, for the same reason it gives: a
- * lead the capture door wrote carries no `status` field, and Firestore
- * cannot select on a field's absence, so "unworked" is a filter over a
- * loaded window rather than a query. The window is the newest old leads by
- * first sighting, which is where the ones still worth a call are.
- */
-export declare const CRM_DIGEST_LEAD_WINDOW = 200;
-/** How many items one section of the email lists before "and N more". */
-export declare const CRM_DIGEST_LIST_MAX = 10;
-/** Midnight at the start of the calendar day `ms` falls in, in `timeZone`. */
-export declare function startOfDayInZone(ms: number, timeZone: string): number;
-/**
- * Midnight at the start of the NEXT calendar day in `timeZone` — built from
- * the calendar rather than by adding 24 hours, for the reason the tasks
- * section gives: a day a clock change falls in is 23 or 25 hours long.
- */
-export declare function startOfNextDayInZone(ms: number, timeZone: string): number;
-/** `YYYY-MM-DD` of the UTC day `ms` falls in — the digest's idempotence key. */
-export declare function utcDayKey(ms: number): string;
-/** The half-open window `[start of today, start of tomorrow)` in a zone. */
-export interface CrmDigestWindow {
-    startMs: number;
-    endMs: number;
-}
-export declare function crmDigestWindow(nowMs: number, timeZone: string): CrmDigestWindow;
-/** A due task as the digest carries it: the fields a line and a link need. */
-export interface CrmDigestTask extends Pick<CrmTask, 'title' | 'kind' | 'contactId' | 'companyId' | 'dealId'> {
-    id: string;
-    dueAtMs: number;
-    assigneeUid: string;
-    /** The site the task was created on — where its link opens. */
-    hostId: string;
-}
-/** An unworked lead as the digest carries it. */
-export interface CrmDigestLead {
-    id: string;
-    hostId: string;
-    email: string;
-    name?: string;
-    ownerUid?: string;
-    firstSeenAtMs: number;
-}
-export interface CrmDigestCounts {
-    overdue: number;
-    today: number;
-    leads: number;
-}
-/** One member's morning. */
-export interface CrmMemberDigest {
-    overdue: CrmDigestTask[];
-    today: CrmDigestTask[];
-    leads: CrmDigestLead[];
-}
-/**
- * Where a due task stands against the digest's window. Only tasks due
- * BEFORE the window's end are read at all, so `later` names a task the
- * query should not have returned and the bucketing refuses to count.
- */
-export declare function crmDigestTaskState(dueAtMs: number, window: CrmDigestWindow): 'overdue' | 'today' | 'later';
-/**
- * Whether a lead is one the digest should name: still `new` — which an
- * absent status reads as, because the capture door stamps none — and first
- * seen at least {@link CRM_DIGEST_LEAD_AGE_MS} ago.
- */
-export declare function isUnworkedLead(lead: Pick<CrmLeadFields, 'status'> & {
-    firstSeenAtMs?: unknown;
-}, nowMs: number, ageMs?: number): boolean;
-/**
- * Whether a lead is THIS member's to work: theirs by owner, or nobody's on
- * a site they reach. An owned lead is one person's; an unowned one is on
- * everybody's list until somebody takes it, which is what the digest is for.
- */
-export declare function leadIsForMember(lead: Pick<CrmDigestLead, 'ownerUid' | 'hostId'>, member: {
-    uid: string;
-    reachesHost: (hostId: string) => boolean;
-}): boolean;
-/**
- * Whether the org's plan carries the CRM (AGL-2611's `features.crm`).
- *
- * Read by key rather than through the typed flag map so this module does not
- * depend on the key existing: the flag lands with the CRM's gate, and a
- * plan that has not declared it is a plan that does not include it — a
- * digest about a surface the plan cannot open would be a reminder to pay.
- */
-export declare function crmDigestEntitled(features: Record<string, boolean | undefined> | null | undefined): boolean;
-/**
- * Every member's digest, from what the org's sweep read.
- *
- * A task goes to its assignee and to nobody else — an unassigned task is a
- * deliberate choice in the drawer, and an assignee no longer on the roster
- * is a task nobody owes. A lead goes to its owner, or to every member who
- * reaches the site when it has none. Members with nothing owed are simply
- * absent from the result, which is what makes "per member with open work"
- * cost nothing for everyone else.
- */
-export declare function buildMemberDigests(input: {
-    tasks: readonly CrmDigestTask[];
-    leads: readonly CrmDigestLead[];
-    members: ReadonlyArray<{
-        uid: string;
-        reachesHost: (hostId: string) => boolean;
-    }>;
-    window: CrmDigestWindow;
-}): Map<string, CrmMemberDigest>;
-export declare function crmDigestCounts(digest: CrmMemberDigest): CrmDigestCounts;
-/**
- * The one line the notification is: "3 tasks due today, 2 overdue, 4
- * unworked leads". Segments that are zero are left out rather than read as
- * "0 overdue" — the line is what is owed, and nothing owed is no segment.
- */
-export declare function composeCrmDigestSummary(counts: CrmDigestCounts): string;
-export declare function composeCrmDigestSubject(counts: CrmDigestCounts): string;
-/** What the digest email needs from the route besides the digest itself. */
-export interface CrmDigestEmailInput {
-    digest: CrmMemberDigest;
-    nowMs: number;
-    timeZone: string;
-    /** The product name the mail reads as — the org's brand when white-labeled. */
-    productName: string;
-    /** The Tasks section, on the site the member's first task belongs to. */
-    tasksUrl: string;
-    /** The Leads section of a site, for the sites that have unworked leads. */
-    leadsUrl: (hostId: string) => string;
-    /** Account settings → Notifications, where the digest can be switched off. */
-    settingsUrl: string;
-    /** A site's name for a lead line; the id when the site is unknown. */
-    hostName: (hostId: string) => string;
-    /** The brand's support line, already prefixed, or empty. */
-    supportLine?: string;
-    /**
-     * Leave out the closing paragraph and the support line (AGL-3367), for the
-     * copy that goes inside a system email: its footer says why the mail came
-     * and where to get help, and its body links the settings page.
-     */
-    omitClosing?: boolean;
-}
-/**
- * The plain-text email. Text rather than a designed template because the
- * body is a list, and `sendEmail` synthesizes the HTML part that makes its
- * links live. Overdue first — it is the section a reader acts on — then
- * today, then the leads, each capped and counted, and the links last.
- */
-export declare function composeCrmDigestEmailText(input: CrmDigestEmailInput): string;

package/src/lib/app-utils/crm-digest.js

@@ -1,272 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */ /**
- * The daily CRM digest (AGL-2619): what one member is owed this morning,
- * computed from the tasks and leads a scheduled route has read.
- *
- * "Overdue" and "due today" are read off the clock at read time by design
- * (AGL-2599) — nothing stamps them — which is why nothing ever told anybody.
- * The digest is the one reader that runs on a schedule: once a day it
- * counts, per org and per member, the open tasks whose due date has passed
- * or falls today and the leads nobody has worked, and says so once, in the
- * console and by mail. Every judgment here is pure so the route that sends
- * and the spec that proves it read the same arithmetic.
- *
- * ## Whose day
- *
- * A task's "today" on screen is the READER's calendar day, from their own
- * clock. A server has no reader, so the digest reads the day in ONE zone —
- * {@link CRM_DIGEST_DEFAULT_TIME_ZONE}, the zone the schedule was chosen for
- * (08:00 there) — taken as a parameter so an org-level setting can supply
- * its own the day one exists. The idempotence key is the UTC day
- * ({@link utcDayKey}), which is a fact about the run and not about anybody's
- * morning.
- */ import { startOfNextZonedDay, startOfZonedDay } from "@aglyn/shared-util-timestamp/zoned-time";
-import { crmLeadStatus } from "./crm.js";
-/**
- * The zone the digest's "today" is read in when nothing else names one.
- *
- * The schedule fires at 13:00 UTC, which is 08:00 here, so the window this
- * zone draws is the morning the mail arrives in for the people the product
- * is built with. A member elsewhere reads a window that is at most a few
- * hours off their own, which is what a morning summary can tolerate and a
- * "due at 9:00" reminder could not — that reminder is the assignment
- * notification's job, not this one's.
- */ export const CRM_DIGEST_DEFAULT_TIME_ZONE = 'America/Chicago';
-/** How long a `new` lead may sit untouched before the digest names it. */ export const CRM_DIGEST_LEAD_AGE_MS = 2 * 24 * 60 * 60 * 1000;
-/**
- * The most due tasks one org's sweep reads.
- *
- * One query per org, ordered soonest-due first, so an org with more than this
- * many overdue-or-today tasks digests the oldest five hundred and reports the
- * window as full rather than reading without bound. Five hundred is an org
- * whose problem is not that nobody reminded them.
- */ export const CRM_DIGEST_TASK_CEILING = 500;
-/**
- * The most old leads one site's sweep reads.
- *
- * The same shape the Leads section uses, for the same reason it gives: a
- * lead the capture door wrote carries no `status` field, and Firestore
- * cannot select on a field's absence, so "unworked" is a filter over a
- * loaded window rather than a query. The window is the newest old leads by
- * first sighting, which is where the ones still worth a call are.
- */ export const CRM_DIGEST_LEAD_WINDOW = 200;
-/** How many items one section of the email lists before "and N more". */ export const CRM_DIGEST_LIST_MAX = 10;
-/*==========================================
- * CALENDAR DAYS IN A NAMED ZONE
- *
- * The zone math lives in `@aglyn/shared-util-timestamp/zoned-time`, where
- * booking slots and sending windows read it as well; the digest route and
- * its spec call it by the names below.
- *=========================================*/ /** Midnight at the start of the calendar day `ms` falls in, in `timeZone`. */ export function startOfDayInZone(ms, timeZone) {
-    return startOfZonedDay(ms, timeZone);
-}
-/**
- * Midnight at the start of the NEXT calendar day in `timeZone` — built from
- * the calendar rather than by adding 24 hours, for the reason the tasks
- * section gives: a day a clock change falls in is 23 or 25 hours long.
- */ export function startOfNextDayInZone(ms, timeZone) {
-    return startOfNextZonedDay(ms, timeZone);
-}
-/** `YYYY-MM-DD` of the UTC day `ms` falls in — the digest's idempotence key. */ export function utcDayKey(ms) {
-    return new Date(ms).toISOString().slice(0, 10);
-}
-export function crmDigestWindow(nowMs, timeZone) {
-    return {
-        startMs: startOfDayInZone(nowMs, timeZone),
-        endMs: startOfNextDayInZone(nowMs, timeZone)
-    };
-}
-/**
- * Where a due task stands against the digest's window. Only tasks due
- * BEFORE the window's end are read at all, so `later` names a task the
- * query should not have returned and the bucketing refuses to count.
- */ export function crmDigestTaskState(dueAtMs, window) {
-    if (dueAtMs < window.startMs) return 'overdue';
-    if (dueAtMs < window.endMs) return 'today';
-    return 'later';
-}
-/**
- * Whether a lead is one the digest should name: still `new` — which an
- * absent status reads as, because the capture door stamps none — and first
- * seen at least {@link CRM_DIGEST_LEAD_AGE_MS} ago.
- */ export function isUnworkedLead(lead, nowMs, ageMs = CRM_DIGEST_LEAD_AGE_MS) {
-    if (crmLeadStatus(lead) !== 'new') return false;
-    const firstSeen = Number(lead.firstSeenAtMs);
-    return Number.isFinite(firstSeen) && firstSeen > 0 && firstSeen <= nowMs - ageMs;
-}
-/**
- * Whether a lead is THIS member's to work: theirs by owner, or nobody's on
- * a site they reach. An owned lead is one person's; an unowned one is on
- * everybody's list until somebody takes it, which is what the digest is for.
- */ export function leadIsForMember(lead, member) {
-    if (lead.ownerUid) return lead.ownerUid === member.uid;
-    return member.reachesHost(lead.hostId);
-}
-/**
- * Whether the org's plan carries the CRM (AGL-2611's `features.crm`).
- *
- * Read by key rather than through the typed flag map so this module does not
- * depend on the key existing: the flag lands with the CRM's gate, and a
- * plan that has not declared it is a plan that does not include it — a
- * digest about a surface the plan cannot open would be a reminder to pay.
- */ export function crmDigestEntitled(features) {
-    return (features == null ? void 0 : features['crm']) === true;
-}
-/**
- * Every member's digest, from what the org's sweep read.
- *
- * A task goes to its assignee and to nobody else — an unassigned task is a
- * deliberate choice in the drawer, and an assignee no longer on the roster
- * is a task nobody owes. A lead goes to its owner, or to every member who
- * reaches the site when it has none. Members with nothing owed are simply
- * absent from the result, which is what makes "per member with open work"
- * cost nothing for everyone else.
- */ export function buildMemberDigests(input) {
-    const { tasks, leads, members, window } = input;
-    const digests = new Map();
-    const digestFor = (uid)=>{
-        let digest = digests.get(uid);
-        if (!digest) {
-            digest = {
-                overdue: [],
-                today: [],
-                leads: []
-            };
-            digests.set(uid, digest);
-        }
-        return digest;
-    };
-    const roster = new Map(members.map((member)=>[
-            member.uid,
-            member
-        ]));
-    for (const task of tasks){
-        if (!task.assigneeUid || !roster.has(task.assigneeUid)) continue;
-        const state = crmDigestTaskState(task.dueAtMs, window);
-        if (state === 'later') continue;
-        digestFor(task.assigneeUid)[state].push(task);
-    }
-    for (const lead of leads){
-        for (const member of members){
-            if (leadIsForMember(lead, member)) digestFor(member.uid).leads.push(lead);
-        }
-    }
-    for (const digest of digests.values()){
-        digest.overdue.sort((a, b)=>a.dueAtMs - b.dueAtMs);
-        digest.today.sort((a, b)=>a.dueAtMs - b.dueAtMs);
-        digest.leads.sort((a, b)=>a.firstSeenAtMs - b.firstSeenAtMs);
-    }
-    return digests;
-}
-export function crmDigestCounts(digest) {
-    return {
-        overdue: digest.overdue.length,
-        today: digest.today.length,
-        leads: digest.leads.length
-    };
-}
-const plural = (count, noun)=>`${count} ${noun}${count === 1 ? '' : 's'}`;
-/**
- * The one line the notification is: "3 tasks due today, 2 overdue, 4
- * unworked leads". Segments that are zero are left out rather than read as
- * "0 overdue" — the line is what is owed, and nothing owed is no segment.
- */ export function composeCrmDigestSummary(counts) {
-    const segments = [];
-    if (counts.today > 0) segments.push(`${plural(counts.today, 'task')} due today`);
-    if (counts.overdue > 0) {
-        segments.push(counts.today > 0 ? `${counts.overdue} overdue` : `${plural(counts.overdue, 'task')} overdue`);
-    }
-    if (counts.leads > 0) segments.push(`${plural(counts.leads, 'unworked lead')}`);
-    return segments.join(', ');
-}
-export function composeCrmDigestSubject(counts) {
-    return `Your CRM today: ${composeCrmDigestSummary(counts)}`;
-}
-function whenInZone(ms, timeZone) {
-    return new Date(ms).toLocaleString('en-US', {
-        timeZone,
-        weekday: 'short',
-        month: 'short',
-        day: 'numeric',
-        hour: 'numeric',
-        minute: '2-digit'
-    });
-}
-function dateInZone(ms, timeZone) {
-    return new Date(ms).toLocaleDateString('en-US', {
-        timeZone,
-        month: 'short',
-        day: 'numeric'
-    });
-}
-function section(heading, lines) {
-    const shown = lines.slice(0, CRM_DIGEST_LIST_MAX);
-    const rest = lines.length - shown.length;
-    return [
-        `${heading} (${lines.length})`,
-        ...shown.map((line)=>`- ${line}`),
-        ...rest > 0 ? [
-            `  and ${rest} more`
-        ] : [],
-        ''
-    ];
-}
-/**
- * The plain-text email. Text rather than a designed template because the
- * body is a list, and `sendEmail` synthesizes the HTML part that makes its
- * links live. Overdue first — it is the section a reader acts on — then
- * today, then the leads, each capped and counted, and the links last.
- */ export function composeCrmDigestEmailText(input) {
-    var _input_supportLine;
-    const { digest, nowMs, timeZone, productName } = input;
-    const counts = crmDigestCounts(digest);
-    const day = new Date(nowMs).toLocaleDateString('en-US', {
-        timeZone,
-        weekday: 'long',
-        month: 'long',
-        day: 'numeric'
-    });
-    const lines = [
-        `Here is your ${productName} CRM for ${day}: ${composeCrmDigestSummary(counts)}.`,
-        ''
-    ];
-    const taskLine = (task)=>`${task.title} · ${whenInZone(task.dueAtMs, timeZone)}`;
-    if (digest.overdue.length) {
-        lines.push(...section('Overdue', digest.overdue.map(taskLine)));
-    }
-    if (digest.today.length) {
-        lines.push(...section('Due today', digest.today.map(taskLine)));
-    }
-    if (digest.leads.length) {
-        lines.push(...section('Unworked leads', digest.leads.map((lead)=>{
-            const who = lead.name ? `${lead.name} <${lead.email}>` : lead.email;
-            return `${who} · ${input.hostName(lead.hostId)} · first seen ${dateInZone(lead.firstSeenAtMs, timeZone)}`;
-        })));
-    }
-    if (counts.overdue + counts.today > 0) lines.push(`Open your tasks: ${input.tasksUrl}`);
-    const leadHosts = [
-        ...new Set(digest.leads.map((lead)=>lead.hostId))
-    ].slice(0, 3);
-    for (const hostId of leadHosts){
-        lines.push(`Leads on ${input.hostName(hostId)}: ${input.leadsUrl(hostId)}`);
-    }
-    if (input.omitClosing) return lines.join('\n').trimEnd();
-    lines.push('', 'You get this each morning because the Daily CRM digest is on in your ' + `notification settings: ${input.settingsUrl}`);
-    return lines.join('\n') + ((_input_supportLine = input.supportLine) != null ? _input_supportLine : '');
-}
-
-//# sourceMappingURL=crm-digest.js.map

package/src/lib/app-utils/crm-digest.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/crm-digest.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 daily CRM digest (AGL-2619): what one member is owed this morning,\n * computed from the tasks and leads a scheduled route has read.\n *\n * \"Overdue\" and \"due today\" are read off the clock at read time by design\n * (AGL-2599) — nothing stamps them — which is why nothing ever told anybody.\n * The digest is the one reader that runs on a schedule: once a day it\n * counts, per org and per member, the open tasks whose due date has passed\n * or falls today and the leads nobody has worked, and says so once, in the\n * console and by mail. Every judgment here is pure so the route that sends\n * and the spec that proves it read the same arithmetic.\n *\n * ## Whose day\n *\n * A task's \"today\" on screen is the READER's calendar day, from their own\n * clock. A server has no reader, so the digest reads the day in ONE zone —\n * {@link CRM_DIGEST_DEFAULT_TIME_ZONE}, the zone the schedule was chosen for\n * (08:00 there) — taken as a parameter so an org-level setting can supply\n * its own the day one exists. The idempotence key is the UTC day\n * ({@link utcDayKey}), which is a fact about the run and not about anybody's\n * morning.\n */\n\nimport {\n  startOfNextZonedDay,\n  startOfZonedDay,\n} from '@aglyn/shared-util-timestamp/zoned-time'\nimport { type CrmLeadFields, type CrmTask, crmLeadStatus } from './crm'\n\n/**\n * The zone the digest's \"today\" is read in when nothing else names one.\n *\n * The schedule fires at 13:00 UTC, which is 08:00 here, so the window this\n * zone draws is the morning the mail arrives in for the people the product\n * is built with. A member elsewhere reads a window that is at most a few\n * hours off their own, which is what a morning summary can tolerate and a\n * \"due at 9:00\" reminder could not — that reminder is the assignment\n * notification's job, not this one's.\n */\nexport const CRM_DIGEST_DEFAULT_TIME_ZONE = 'America/Chicago'\n\n/** How long a `new` lead may sit untouched before the digest names it. */\nexport const CRM_DIGEST_LEAD_AGE_MS = 2 * 24 * 60 * 60 * 1000\n\n/**\n * The most due tasks one org's sweep reads.\n *\n * One query per org, ordered soonest-due first, so an org with more than this\n * many overdue-or-today tasks digests the oldest five hundred and reports the\n * window as full rather than reading without bound. Five hundred is an org\n * whose problem is not that nobody reminded them.\n */\nexport const CRM_DIGEST_TASK_CEILING = 500\n\n/**\n * The most old leads one site's sweep reads.\n *\n * The same shape the Leads section uses, for the same reason it gives: a\n * lead the capture door wrote carries no `status` field, and Firestore\n * cannot select on a field's absence, so \"unworked\" is a filter over a\n * loaded window rather than a query. The window is the newest old leads by\n * first sighting, which is where the ones still worth a call are.\n */\nexport const CRM_DIGEST_LEAD_WINDOW = 200\n\n/** How many items one section of the email lists before \"and N more\". */\nexport const CRM_DIGEST_LIST_MAX = 10\n\n/*==========================================\n * CALENDAR DAYS IN A NAMED ZONE\n *\n * The zone math lives in `@aglyn/shared-util-timestamp/zoned-time`, where\n * booking slots and sending windows read it as well; the digest route and\n * its spec call it by the names below.\n *=========================================*/\n\n/** Midnight at the start of the calendar day `ms` falls in, in `timeZone`. */\nexport function startOfDayInZone(ms: number, timeZone: string): number {\n  return startOfZonedDay(ms, timeZone)\n}\n\n/**\n * Midnight at the start of the NEXT calendar day in `timeZone` — built from\n * the calendar rather than by adding 24 hours, for the reason the tasks\n * section gives: a day a clock change falls in is 23 or 25 hours long.\n */\nexport function startOfNextDayInZone(ms: number, timeZone: string): number {\n  return startOfNextZonedDay(ms, timeZone)\n}\n\n/** `YYYY-MM-DD` of the UTC day `ms` falls in — the digest's idempotence key. */\nexport function utcDayKey(ms: number): string {\n  return new Date(ms).toISOString().slice(0, 10)\n}\n\n/** The half-open window `[start of today, start of tomorrow)` in a zone. */\nexport interface CrmDigestWindow {\n  startMs: number\n  endMs: number\n}\n\nexport function crmDigestWindow(nowMs: number, timeZone: string): CrmDigestWindow {\n  return {\n    startMs: startOfDayInZone(nowMs, timeZone),\n    endMs: startOfNextDayInZone(nowMs, timeZone),\n  }\n}\n\n/*==========================================\n * WHAT A DIGEST IS MADE OF\n *=========================================*/\n\n/** A due task as the digest carries it: the fields a line and a link need. */\nexport interface CrmDigestTask\n  extends Pick<CrmTask, 'title' | 'kind' | 'contactId' | 'companyId' | 'dealId'> {\n  id: string\n  dueAtMs: number\n  assigneeUid: string\n  /** The site the task was created on — where its link opens. */\n  hostId: string\n}\n\n/** An unworked lead as the digest carries it. */\nexport interface CrmDigestLead {\n  id: string\n  hostId: string\n  email: string\n  name?: string\n  ownerUid?: string\n  firstSeenAtMs: number\n}\n\nexport interface CrmDigestCounts {\n  overdue: number\n  today: number\n  leads: number\n}\n\n/** One member's morning. */\nexport interface CrmMemberDigest {\n  overdue: CrmDigestTask[]\n  today: CrmDigestTask[]\n  leads: CrmDigestLead[]\n}\n\n/**\n * Where a due task stands against the digest's window. Only tasks due\n * BEFORE the window's end are read at all, so `later` names a task the\n * query should not have returned and the bucketing refuses to count.\n */\nexport function crmDigestTaskState(\n  dueAtMs: number,\n  window: CrmDigestWindow,\n): 'overdue' | 'today' | 'later' {\n  if (dueAtMs < window.startMs) return 'overdue'\n  if (dueAtMs < window.endMs) return 'today'\n  return 'later'\n}\n\n/**\n * Whether a lead is one the digest should name: still `new` — which an\n * absent status reads as, because the capture door stamps none — and first\n * seen at least {@link CRM_DIGEST_LEAD_AGE_MS} ago.\n */\nexport function isUnworkedLead(\n  lead: Pick<CrmLeadFields, 'status'> & { firstSeenAtMs?: unknown },\n  nowMs: number,\n  ageMs: number = CRM_DIGEST_LEAD_AGE_MS,\n): boolean {\n  if (crmLeadStatus(lead) !== 'new') return false\n  const firstSeen = Number(lead.firstSeenAtMs)\n  return Number.isFinite(firstSeen) && firstSeen > 0 && firstSeen <= nowMs - ageMs\n}\n\n/**\n * Whether a lead is THIS member's to work: theirs by owner, or nobody's on\n * a site they reach. An owned lead is one person's; an unowned one is on\n * everybody's list until somebody takes it, which is what the digest is for.\n */\nexport function leadIsForMember(\n  lead: Pick<CrmDigestLead, 'ownerUid' | 'hostId'>,\n  member: { uid: string; reachesHost: (hostId: string) => boolean },\n): boolean {\n  if (lead.ownerUid) return lead.ownerUid === member.uid\n  return member.reachesHost(lead.hostId)\n}\n\n/**\n * Whether the org's plan carries the CRM (AGL-2611's `features.crm`).\n *\n * Read by key rather than through the typed flag map so this module does not\n * depend on the key existing: the flag lands with the CRM's gate, and a\n * plan that has not declared it is a plan that does not include it — a\n * digest about a surface the plan cannot open would be a reminder to pay.\n */\nexport function crmDigestEntitled(\n  features: Record<string, boolean | undefined> | null | undefined,\n): boolean {\n  return features?.['crm'] === true\n}\n\n/**\n * Every member's digest, from what the org's sweep read.\n *\n * A task goes to its assignee and to nobody else — an unassigned task is a\n * deliberate choice in the drawer, and an assignee no longer on the roster\n * is a task nobody owes. A lead goes to its owner, or to every member who\n * reaches the site when it has none. Members with nothing owed are simply\n * absent from the result, which is what makes \"per member with open work\"\n * cost nothing for everyone else.\n */\nexport function buildMemberDigests(input: {\n  tasks: readonly CrmDigestTask[]\n  leads: readonly CrmDigestLead[]\n  members: ReadonlyArray<{ uid: string; reachesHost: (hostId: string) => boolean }>\n  window: CrmDigestWindow\n}): Map<string, CrmMemberDigest> {\n  const { tasks, leads, members, window } = input\n  const digests = new Map<string, CrmMemberDigest>()\n  const digestFor = (uid: string): CrmMemberDigest => {\n    let digest = digests.get(uid)\n    if (!digest) {\n      digest = { overdue: [], today: [], leads: [] }\n      digests.set(uid, digest)\n    }\n    return digest\n  }\n  const roster = new Map(members.map((member) => [member.uid, member]))\n  for (const task of tasks) {\n    if (!task.assigneeUid || !roster.has(task.assigneeUid)) continue\n    const state = crmDigestTaskState(task.dueAtMs, window)\n    if (state === 'later') continue\n    digestFor(task.assigneeUid)[state].push(task)\n  }\n  for (const lead of leads) {\n    for (const member of members) {\n      if (leadIsForMember(lead, member)) digestFor(member.uid).leads.push(lead)\n    }\n  }\n  for (const digest of digests.values()) {\n    digest.overdue.sort((a, b) => a.dueAtMs - b.dueAtMs)\n    digest.today.sort((a, b) => a.dueAtMs - b.dueAtMs)\n    digest.leads.sort((a, b) => a.firstSeenAtMs - b.firstSeenAtMs)\n  }\n  return digests\n}\n\nexport function crmDigestCounts(digest: CrmMemberDigest): CrmDigestCounts {\n  return {\n    overdue: digest.overdue.length,\n    today: digest.today.length,\n    leads: digest.leads.length,\n  }\n}\n\nconst plural = (count: number, noun: string): string =>\n  `${count} ${noun}${count === 1 ? '' : 's'}`\n\n/**\n * The one line the notification is: \"3 tasks due today, 2 overdue, 4\n * unworked leads\". Segments that are zero are left out rather than read as\n * \"0 overdue\" — the line is what is owed, and nothing owed is no segment.\n */\nexport function composeCrmDigestSummary(counts: CrmDigestCounts): string {\n  const segments: string[] = []\n  if (counts.today > 0) segments.push(`${plural(counts.today, 'task')} due today`)\n  if (counts.overdue > 0) {\n    segments.push(\n      counts.today > 0 ? `${counts.overdue} overdue` : `${plural(counts.overdue, 'task')} overdue`,\n    )\n  }\n  if (counts.leads > 0) segments.push(`${plural(counts.leads, 'unworked lead')}`)\n  return segments.join(', ')\n}\n\nexport function composeCrmDigestSubject(counts: CrmDigestCounts): string {\n  return `Your CRM today: ${composeCrmDigestSummary(counts)}`\n}\n\n/** What the digest email needs from the route besides the digest itself. */\nexport interface CrmDigestEmailInput {\n  digest: CrmMemberDigest\n  nowMs: number\n  timeZone: string\n  /** The product name the mail reads as — the org's brand when white-labeled. */\n  productName: string\n  /** The Tasks section, on the site the member's first task belongs to. */\n  tasksUrl: string\n  /** The Leads section of a site, for the sites that have unworked leads. */\n  leadsUrl: (hostId: string) => string\n  /** Account settings → Notifications, where the digest can be switched off. */\n  settingsUrl: string\n  /** A site's name for a lead line; the id when the site is unknown. */\n  hostName: (hostId: string) => string\n  /** The brand's support line, already prefixed, or empty. */\n  supportLine?: string\n  /**\n   * Leave out the closing paragraph and the support line (AGL-3367), for the\n   * copy that goes inside a system email: its footer says why the mail came\n   * and where to get help, and its body links the settings page.\n   */\n  omitClosing?: boolean\n}\n\nfunction whenInZone(ms: number, timeZone: string): string {\n  return new Date(ms).toLocaleString('en-US', {\n    timeZone,\n    weekday: 'short',\n    month: 'short',\n    day: 'numeric',\n    hour: 'numeric',\n    minute: '2-digit',\n  })\n}\n\nfunction dateInZone(ms: number, timeZone: string): string {\n  return new Date(ms).toLocaleDateString('en-US', {\n    timeZone,\n    month: 'short',\n    day: 'numeric',\n  })\n}\n\nfunction section(heading: string, lines: string[]): string[] {\n  const shown = lines.slice(0, CRM_DIGEST_LIST_MAX)\n  const rest = lines.length - shown.length\n  return [\n    `${heading} (${lines.length})`,\n    ...shown.map((line) => `- ${line}`),\n    ...(rest > 0 ? [`  and ${rest} more`] : []),\n    '',\n  ]\n}\n\n/**\n * The plain-text email. Text rather than a designed template because the\n * body is a list, and `sendEmail` synthesizes the HTML part that makes its\n * links live. Overdue first — it is the section a reader acts on — then\n * today, then the leads, each capped and counted, and the links last.\n */\nexport function composeCrmDigestEmailText(input: CrmDigestEmailInput): string {\n  const { digest, nowMs, timeZone, productName } = input\n  const counts = crmDigestCounts(digest)\n  const day = new Date(nowMs).toLocaleDateString('en-US', {\n    timeZone,\n    weekday: 'long',\n    month: 'long',\n    day: 'numeric',\n  })\n  const lines: string[] = [\n    `Here is your ${productName} CRM for ${day}: ${composeCrmDigestSummary(counts)}.`,\n    '',\n  ]\n  const taskLine = (task: CrmDigestTask) =>\n    `${task.title} · ${whenInZone(task.dueAtMs, timeZone)}`\n  if (digest.overdue.length) {\n    lines.push(...section('Overdue', digest.overdue.map(taskLine)))\n  }\n  if (digest.today.length) {\n    lines.push(...section('Due today', digest.today.map(taskLine)))\n  }\n  if (digest.leads.length) {\n    lines.push(\n      ...section(\n        'Unworked leads',\n        digest.leads.map((lead) => {\n          const who = lead.name ? `${lead.name} <${lead.email}>` : lead.email\n          return `${who} · ${input.hostName(lead.hostId)} · first seen ${dateInZone(\n            lead.firstSeenAtMs,\n            timeZone,\n          )}`\n        }),\n      ),\n    )\n  }\n  if (counts.overdue + counts.today > 0) lines.push(`Open your tasks: ${input.tasksUrl}`)\n  const leadHosts = [...new Set(digest.leads.map((lead) => lead.hostId))].slice(0, 3)\n  for (const hostId of leadHosts) {\n    lines.push(`Leads on ${input.hostName(hostId)}: ${input.leadsUrl(hostId)}`)\n  }\n  if (input.omitClosing) return lines.join('\\n').trimEnd()\n  lines.push(\n    '',\n    'You get this each morning because the Daily CRM digest is on in your ' +\n      `notification settings: ${input.settingsUrl}`,\n  )\n  return lines.join('\\n') + (input.supportLine ?? '')\n}\n"],"names":["startOfNextZonedDay","startOfZonedDay","crmLeadStatus","CRM_DIGEST_DEFAULT_TIME_ZONE","CRM_DIGEST_LEAD_AGE_MS","CRM_DIGEST_TASK_CEILING","CRM_DIGEST_LEAD_WINDOW","CRM_DIGEST_LIST_MAX","startOfDayInZone","ms","timeZone","startOfNextDayInZone","utcDayKey","Date","toISOString","slice","crmDigestWindow","nowMs","startMs","endMs","crmDigestTaskState","dueAtMs","window","isUnworkedLead","lead","ageMs","firstSeen","Number","firstSeenAtMs","isFinite","leadIsForMember","member","ownerUid","uid","reachesHost","hostId","crmDigestEntitled","features","buildMemberDigests","input","tasks","leads","members","digests","Map","digestFor","digest","get","overdue","today","set","roster","map","task","assigneeUid","has","state","push","values","sort","a","b","crmDigestCounts","length","plural","count","noun","composeCrmDigestSummary","counts","segments","join","composeCrmDigestSubject","whenInZone","toLocaleString","weekday","month","day","hour","minute","dateInZone","toLocaleDateString","section","heading","lines","shown","rest","line","composeCrmDigestEmailText","productName","taskLine","title","who","name","email","hostName","tasksUrl","leadHosts","Set","leadsUrl","omitClosing","trimEnd","settingsUrl","supportLine"],"mappings":"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"}

package/src/lib/app-utils/form-dataset-binding.d.ts

@@ -1,50 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import type { AglynNodeSchema, NodeId } from '../foundation';
-/**
- * Where a form's submissions are also written as dataset records, read off
- * the form as a page renders it.
- */
-export interface FormDatasetBinding {
-    /** The dataset, by id, so renaming it never breaks the binding (AGL-556). */
-    datasetId?: string;
-    /** The legacy by-name binding, honored when no id is set (AGL-141). */
-    datasetName?: string;
-    /** Submitted field name → the dataset field id the value is stored under. */
-    fieldMap: Record<string, string>;
-}
-/** The most fields a submission may carry, and so the most a map can name. */
-export declare const FORM_DATASET_BINDING_MAX_FIELDS = 20;
-/**
- * The dataset binding a `form` node declares, or null when it declares none.
- *
- * The map is built the way the browser builds the submission: every
- * `formField` under the form, in reading order, keyed by the name the field
- * submits under (`fieldName`, or `field` when it has none), and a later field
- * under the same name replaces an earlier one. A field with no
- * `datasetFieldId` maps nothing and its value falls back to matching dataset
- * fields by name.
- *
- * Read from the COMPOSED tree, so a form grafted from a layout, a reusable
- * component or a form entity is read exactly as the page renders it.
- */
-export declare function formDatasetBindingOf(nodes: Record<NodeId, AglynNodeSchema | undefined> | undefined | null, formNodeId: NodeId): FormDatasetBinding | null;
-/** Every `form` node in a composed tree that declares a dataset binding. */
-export declare function formDatasetBindingsOf(nodes: Record<NodeId, AglynNodeSchema | undefined> | undefined | null): Array<{
-    nodeId: NodeId;
-    binding: FormDatasetBinding;
-}>;

package/src/lib/app-utils/form-dataset-binding.js

@@ -1,74 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */ import { _ as _extends } from "@swc/helpers/_/_extends";
-import { collectFormFieldNodeIds, FORM_COMPONENT_ID } from "./forms.js";
-/** The most fields a submission may carry, and so the most a map can name. */ export const FORM_DATASET_BINDING_MAX_FIELDS = 20;
-const text = (value, max)=>typeof value === 'string' ? value.trim().slice(0, max) : '';
-/**
- * The dataset binding a `form` node declares, or null when it declares none.
- *
- * The map is built the way the browser builds the submission: every
- * `formField` under the form, in reading order, keyed by the name the field
- * submits under (`fieldName`, or `field` when it has none), and a later field
- * under the same name replaces an earlier one. A field with no
- * `datasetFieldId` maps nothing and its value falls back to matching dataset
- * fields by name.
- *
- * Read from the COMPOSED tree, so a form grafted from a layout, a reusable
- * component or a form entity is read exactly as the page renders it.
- */ export function formDatasetBindingOf(nodes, formNodeId) {
-    var _node_props;
-    const node = nodes == null ? void 0 : nodes[formNodeId];
-    if ((node == null ? void 0 : node.componentId) !== FORM_COMPONENT_ID) return null;
-    const props = (_node_props = node.props) != null ? _node_props : {};
-    const datasetId = text(props['datasetId'], 128);
-    const datasetName = text(props['datasetName'], 60);
-    if (!datasetId && !datasetName) return null;
-    const fieldMap = {};
-    for (const fieldNodeId of collectFormFieldNodeIds(nodes, formNodeId)){
-        var _ref;
-        var _nodes_fieldNodeId;
-        const fieldProps = (_ref = nodes == null ? void 0 : (_nodes_fieldNodeId = nodes[fieldNodeId]) == null ? void 0 : _nodes_fieldNodeId.props) != null ? _ref : {};
-        const datasetFieldId = text(fieldProps['datasetFieldId'], 64);
-        if (!datasetFieldId) continue;
-        const submittedKey = text(fieldProps['fieldName'], 64) || 'field';
-        if (!(submittedKey in fieldMap) && Object.keys(fieldMap).length >= FORM_DATASET_BINDING_MAX_FIELDS) {
-            continue;
-        }
-        fieldMap[submittedKey] = datasetFieldId;
-    }
-    return _extends({}, datasetId ? {
-        datasetId
-    } : {}, datasetName ? {
-        datasetName
-    } : {}, {
-        fieldMap
-    });
-}
-/** Every `form` node in a composed tree that declares a dataset binding. */ export function formDatasetBindingsOf(nodes) {
-    const found = [];
-    for (const [nodeId, node] of Object.entries(nodes != null ? nodes : {})){
-        if ((node == null ? void 0 : node.componentId) !== FORM_COMPONENT_ID) continue;
-        const binding = formDatasetBindingOf(nodes, nodeId);
-        if (binding) found.push({
-            nodeId: nodeId,
-            binding
-        });
-    }
-    return found;
-}
-
-//# sourceMappingURL=form-dataset-binding.js.map

package/src/lib/app-utils/form-dataset-binding.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/form-dataset-binding.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 { AglynNodeSchema, NodeId } from '../foundation'\nimport { collectFormFieldNodeIds, FORM_COMPONENT_ID } from './forms'\n\n/**\n * Where a form's submissions are also written as dataset records, read off\n * the form as a page renders it.\n */\nexport interface FormDatasetBinding {\n  /** The dataset, by id, so renaming it never breaks the binding (AGL-556). */\n  datasetId?: string\n  /** The legacy by-name binding, honored when no id is set (AGL-141). */\n  datasetName?: string\n  /** Submitted field name → the dataset field id the value is stored under. */\n  fieldMap: Record<string, string>\n}\n\n/** The most fields a submission may carry, and so the most a map can name. */\nexport const FORM_DATASET_BINDING_MAX_FIELDS = 20\n\nconst text = (value: unknown, max: number): string =>\n  typeof value === 'string' ? value.trim().slice(0, max) : ''\n\n/**\n * The dataset binding a `form` node declares, or null when it declares none.\n *\n * The map is built the way the browser builds the submission: every\n * `formField` under the form, in reading order, keyed by the name the field\n * submits under (`fieldName`, or `field` when it has none), and a later field\n * under the same name replaces an earlier one. A field with no\n * `datasetFieldId` maps nothing and its value falls back to matching dataset\n * fields by name.\n *\n * Read from the COMPOSED tree, so a form grafted from a layout, a reusable\n * component or a form entity is read exactly as the page renders it.\n */\nexport function formDatasetBindingOf(\n  nodes: Record<NodeId, AglynNodeSchema | undefined> | undefined | null,\n  formNodeId: NodeId,\n): FormDatasetBinding | null {\n  const node = nodes?.[formNodeId]\n  if (node?.componentId !== FORM_COMPONENT_ID) return null\n  const props = (node.props ?? {}) as Record<string, unknown>\n  const datasetId = text(props['datasetId'], 128)\n  const datasetName = text(props['datasetName'], 60)\n  if (!datasetId && !datasetName) return null\n  const fieldMap: Record<string, string> = {}\n  for (const fieldNodeId of collectFormFieldNodeIds(nodes, formNodeId)) {\n    const fieldProps = (nodes?.[fieldNodeId]?.props ?? {}) as Record<\n      string,\n      unknown\n    >\n    const datasetFieldId = text(fieldProps['datasetFieldId'], 64)\n    if (!datasetFieldId) continue\n    const submittedKey = text(fieldProps['fieldName'], 64) || 'field'\n    if (\n      !(submittedKey in fieldMap) &&\n      Object.keys(fieldMap).length >= FORM_DATASET_BINDING_MAX_FIELDS\n    ) {\n      continue\n    }\n    fieldMap[submittedKey] = datasetFieldId\n  }\n  return {\n    ...(datasetId ? { datasetId } : {}),\n    ...(datasetName ? { datasetName } : {}),\n    fieldMap,\n  }\n}\n\n/** Every `form` node in a composed tree that declares a dataset binding. */\nexport function formDatasetBindingsOf(\n  nodes: Record<NodeId, AglynNodeSchema | undefined> | undefined | null,\n): Array<{ nodeId: NodeId; binding: FormDatasetBinding }> {\n  const found: Array<{ nodeId: NodeId; binding: FormDatasetBinding }> = []\n  for (const [nodeId, node] of Object.entries(nodes ?? {})) {\n    if (node?.componentId !== FORM_COMPONENT_ID) continue\n    const binding = formDatasetBindingOf(nodes, nodeId as NodeId)\n    if (binding) found.push({ nodeId: nodeId as NodeId, binding })\n  }\n  return found\n}\n"],"names":["collectFormFieldNodeIds","FORM_COMPONENT_ID","FORM_DATASET_BINDING_MAX_FIELDS","text","value","max","trim","slice","formDatasetBindingOf","nodes","formNodeId","node","componentId","props","datasetId","datasetName","fieldMap","fieldNodeId","fieldProps","datasetFieldId","submittedKey","Object","keys","length","formDatasetBindingsOf","found","nodeId","entries","binding","push"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SAASA,uBAAuB,EAAEC,iBAAiB,QAAQ,aAAS;AAepE,4EAA4E,GAC5E,OAAO,MAAMC,kCAAkC,GAAE;AAEjD,MAAMC,OAAO,CAACC,OAAgBC,MAC5B,OAAOD,UAAU,WAAWA,MAAME,IAAI,GAAGC,KAAK,CAAC,GAAGF,OAAO;AAE3D;;;;;;;;;;;;CAYC,GACD,OAAO,SAASG,qBACdC,KAAqE,EACrEC,UAAkB;QAIHC;IAFf,MAAMA,OAAOF,yBAAAA,KAAO,CAACC,WAAW;IAChC,IAAIC,CAAAA,wBAAAA,KAAMC,WAAW,MAAKX,mBAAmB,OAAO;IACpD,MAAMY,SAASF,cAAAA,KAAKE,KAAK,YAAVF,cAAc,CAAC;IAC9B,MAAMG,YAAYX,KAAKU,KAAK,CAAC,YAAY,EAAE;IAC3C,MAAME,cAAcZ,KAAKU,KAAK,CAAC,cAAc,EAAE;IAC/C,IAAI,CAACC,aAAa,CAACC,aAAa,OAAO;IACvC,MAAMC,WAAmC,CAAC;IAC1C,KAAK,MAAMC,eAAejB,wBAAwBS,OAAOC,YAAa;;YAChDD;QAApB,MAAMS,qBAAcT,0BAAAA,qBAAAA,KAAO,CAACQ,YAAY,qBAApBR,mBAAsBI,KAAK,mBAAI,CAAC;QAIpD,MAAMM,iBAAiBhB,KAAKe,UAAU,CAAC,iBAAiB,EAAE;QAC1D,IAAI,CAACC,gBAAgB;QACrB,MAAMC,eAAejB,KAAKe,UAAU,CAAC,YAAY,EAAE,OAAO;QAC1D,IACE,CAAEE,CAAAA,gBAAgBJ,QAAO,KACzBK,OAAOC,IAAI,CAACN,UAAUO,MAAM,IAAIrB,iCAChC;YACA;QACF;QACAc,QAAQ,CAACI,aAAa,GAAGD;IAC3B;IACA,OAAO,aACDL,YAAY;QAAEA;IAAU,IAAI,CAAC,GAC7BC,cAAc;QAAEA;IAAY,IAAI,CAAC;QACrCC;;AAEJ;AAEA,0EAA0E,GAC1E,OAAO,SAASQ,sBACdf,KAAqE;IAErE,MAAMgB,QAAgE,EAAE;IACxE,KAAK,MAAM,CAACC,QAAQf,KAAK,IAAIU,OAAOM,OAAO,CAAClB,gBAAAA,QAAS,CAAC,GAAI;QACxD,IAAIE,CAAAA,wBAAAA,KAAMC,WAAW,MAAKX,mBAAmB;QAC7C,MAAM2B,UAAUpB,qBAAqBC,OAAOiB;QAC5C,IAAIE,SAASH,MAAMI,IAAI,CAAC;YAAEH,QAAQA;YAAkBE;QAAQ;IAC9D;IACA,OAAOH;AACT"}