@aglyn/plugins-marketing 1.0.0-beta.143

package/src/lib/model/overlay-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/model/overlay-copy.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  type HostTokenSource,\n  resolveHostTokens,\n} from '@aglyn/aglyn/app-utils/host-tokens'\nimport {\n  type HostVariable,\n  resolveBindings,\n} from '@aglyn/aglyn/app-utils/variables'\n\n/**\n * The fields of a bar or popup that hold copy: a bar's `text`, a popup's\n * `headline` and `body`. Links, labels and colors are not copy and are never\n * resolved.\n */\nexport const OVERLAY_COPY_FIELDS = ['text', 'headline', 'body'] as const\n\n/**\n * Overlay copy as a visitor reads it: an announcement bar's text, and a\n * popup's headline and body.\n *\n * Every path that puts overlay copy in front of a visitor goes through this\n * one function — the bar and popup a page shows on load, and a bar or popup an\n * automation shows later — so the same overlay cannot read one way when it\n * matches the page and another way when an automation opens it.\n *\n * The order is the one a page's own copy is resolved in: site variables\n * (`{{var:id}}`) first, then the site's details (`{{host.*}}`). A variable\n * whose document is gone renders as nothing, and so does a detail the site has\n * not set; neither ever reaches a visitor as the token.\n *\n * Deep imports rather than either `@aglyn/aglyn` barrel: the server enricher\n * and the console editors both import this module, and the client barrel\n * carries React contexts a server graph must not load.\n *\n * @param variables - the site's variables keyed by document id, as\n *   `getVariables` returns them.\n * @param host - the site document the copy is published on.\n */\nexport function resolveOverlayCopy(\n  text: string,\n  variables: Record<string, HostVariable>,\n  host: HostTokenSource | null | undefined,\n): string {\n  if (typeof text !== 'string' || !text.includes('{{')) return text\n  return resolveHostTokens(resolveBindings(text, variables), host)\n}\n\n/** Any `{{…}}` token, whatever it names. */\nconst ANY_TOKEN_PATTERN = /\\{\\{[^{}]*\\}\\}/g\n\n/**\n * The tokens in stored overlay copy that a visitor would read exactly as\n * typed: every token {@link resolveOverlayCopy} leaves in place.\n *\n * A bare `{{name}}` is one — nothing on a published page resolves that form,\n * which is why an editor rewrites a name it recognizes to `{{var:id}}` before\n * saving — and so is any token overlay copy has no source for, such as a\n * function call or an entry field.\n *\n * Each token is put through the published page's own resolution rather than\n * matched against a list of forms, so what an editor warns about cannot drift\n * from what the page does. A variable whose document is gone and a detail the\n * site has not set both render as nothing, and neither is listed.\n */\nexport function overlayCopyTokensShownAsTyped(\n  text: string | undefined,\n  variables: Record<string, HostVariable>,\n  host: HostTokenSource | null | undefined,\n): string[] {\n  if (typeof text !== 'string' || !text.includes('{{')) return []\n  const shown = new Set<string>()\n  for (const token of text.match(ANY_TOKEN_PATTERN) ?? []) {\n    if (resolveOverlayCopy(token, variables, host) === token) shown.add(token)\n  }\n  return [...shown]\n}\n"],"names":["resolveHostTokens","resolveBindings","OVERLAY_COPY_FIELDS","resolveOverlayCopy","text","variables","host","includes","ANY_TOKEN_PATTERN","overlayCopyTokensShownAsTyped","shown","Set","token","match","add"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAEEA,iBAAiB,QACZ,qCAAoC;AAC3C,SAEEC,eAAe,QACV,mCAAkC;AAEzC;;;;CAIC,GACD,OAAO,MAAMC,sBAAsB;IAAC;IAAQ;IAAY;CAAO,CAAS;AAExE;;;;;;;;;;;;;;;;;;;;;CAqBC,GACD,OAAO,SAASC,mBACdC,IAAY,EACZC,SAAuC,EACvCC,IAAwC;IAExC,IAAI,OAAOF,SAAS,YAAY,CAACA,KAAKG,QAAQ,CAAC,OAAO,OAAOH;IAC7D,OAAOJ,kBAAkBC,gBAAgBG,MAAMC,YAAYC;AAC7D;AAEA,0CAA0C,GAC1C,MAAME,oBAAoB;AAE1B;;;;;;;;;;;;;CAaC,GACD,OAAO,SAASC,8BACdL,IAAwB,EACxBC,SAAuC,EACvCC,IAAwC;QAIpBF;IAFpB,IAAI,OAAOA,SAAS,YAAY,CAACA,KAAKG,QAAQ,CAAC,OAAO,OAAO,EAAE;IAC/D,MAAMG,QAAQ,IAAIC;IAClB,KAAK,MAAMC,UAASR,cAAAA,KAAKS,KAAK,CAACL,8BAAXJ,cAAiC,EAAE,CAAE;QACvD,IAAID,mBAAmBS,OAAOP,WAAWC,UAAUM,OAAOF,MAAMI,GAAG,CAACF;IACtE;IACA,OAAO;WAAIF;KAAM;AACnB"}

package/src/lib/model/overlays.d.ts

@@ -0,0 +1,113 @@
+/**
+ * @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 { HostAnnouncementBar, HostPopup } from '@aglyn/aglyn';
+/**
+ * Marketing hub overlays (AGL-251): multiple announcement bars and
+ * promotional popups per host at `hosts/{hostId}/overlays/{overlayId}`,
+ * each with its own schedule window and page targeting. The legacy single
+ * `host.announcementBar` / `host.popup` fields keep working as fallbacks
+ * when no overlay doc matches. Pure types + resolution helpers here; the
+ * tenant render picks the first active match per kind.
+ */
+export interface HostOverlay {
+    kind: 'bar' | 'popup';
+    /** Display name in the console list (e.g. "Black Friday bar"). */
+    name?: string;
+    /** Disabled overlays never render; new overlays default enabled. */
+    enabled?: boolean;
+    /** Bar payload when `kind: 'bar'` (the legacy shape, minus enabled). */
+    bar?: Omit<HostAnnouncementBar, 'enabled'>;
+    /** Popup payload when `kind: 'popup'` (the legacy shape, minus enabled). */
+    popup?: Omit<HostPopup, 'enabled' | 'startAtMs' | 'endAtMs'>;
+    /** Showing window (epoch millis; simple to serialize). */
+    startAtMs?: number;
+    endAtMs?: number;
+    /**
+     * Path patterns the overlay shows on; empty/absent = every page.
+     * Patterns are exact paths or prefix globs (`/pricing`, `/blog/*`).
+     */
+    pathPatterns?: string[];
+    /** Path patterns the overlay never shows on; wins over includes. */
+    excludePathPatterns?: string[];
+    /** List order; lower renders first when several match. */
+    order?: number;
+    /**
+     * Aggregate engagement counters (AGL-271), incremented server-side by
+     * the tenant beacon — never written from the console.
+     */
+    stats?: {
+        impressions?: number;
+        clicks?: number;
+        dismissals?: number;
+    };
+}
+/** Exact-or-prefix-glob path match: `/blog/*` matches `/blog/anything`. */
+export declare function overlayPatternMatches(pattern: string, path: string): boolean;
+/** True when the overlay targets the given path (include/exclude rules). */
+export declare function overlayMatchesPath(overlay: Pick<HostOverlay, 'pathPatterns' | 'excludePathPatterns'>, path: string): boolean;
+/** True when `nowMs` falls inside the overlay's schedule window. */
+export declare function overlayActiveAt(overlay: Pick<HostOverlay, 'startAtMs' | 'endAtMs'>, nowMs: number): boolean;
+/**
+ * Picks the overlays to render for a page: enabled, inside their window,
+ * targeting the path — sorted by `order` then name, first of each kind
+ * wins (one bar + one popup per page render).
+ */
+export declare function resolveActiveOverlays(overlays: Array<HostOverlay & {
+    $id?: string;
+}>, context: {
+    path: string;
+    nowMs?: number;
+}): {
+    bar: (HostOverlay & {
+        $id?: string;
+    }) | null;
+    popup: (HostOverlay & {
+        $id?: string;
+    }) | null;
+};
+/** What a popup's frequency cap reads and writes. */
+export type PopupCapStore = 'session' | 'local';
+/**
+ * Which store a popup's frequency cap uses (AGL-2174).
+ *
+ * `sessionStorage` for a per-session cap, because that IS the lifetime the
+ * setting names: it clears when the tab closes. `frequencyDays: 1` cannot
+ * express it — a visitor who dismissed at 23:59 would be suppressed for
+ * one minute and then shown the popup again.
+ *
+ * The read and the write must agree. Stamping `localStorage` for a
+ * session-capped popup leaves a timestamp nothing reads, which outlives
+ * the cap it was meant to record.
+ */
+export declare function popupCapStore(popup: {
+    oncePerSession?: boolean;
+}): PopupCapStore;
+/**
+ * Whether a popup is currently suppressed by its own frequency cap.
+ *
+ * `sessionFlag` is whatever `sessionStorage` holds for it; `lastShownMs`
+ * is the `localStorage` timestamp. Exactly one is consulted — the two caps
+ * are alternative answers to the same question, and honouring both would
+ * suppress a popup for the session AND for a week afterwards.
+ */
+export declare function popupSuppressed(popup: {
+    oncePerSession?: boolean;
+    frequencyDays?: number;
+}, state: {
+    sessionFlag?: string | null;
+    lastShownMs?: number | null;
+}, nowMs: number): boolean;

package/src/lib/model/overlays.js

@@ -0,0 +1,93 @@
+/**
+ * @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.
+ */ /** Exact-or-prefix-glob path match: `/blog/*` matches `/blog/anything`. */ export function overlayPatternMatches(pattern, path) {
+    const cleaned = pattern.trim();
+    if (!cleaned) return false;
+    const normalizedPath = path === '' ? '/' : path;
+    if (cleaned.endsWith('/*')) {
+        const prefix = cleaned.slice(0, -2);
+        if (!prefix || prefix === '/') return normalizedPath.startsWith('/');
+        return normalizedPath === prefix || normalizedPath.startsWith(`${prefix}/`);
+    }
+    return normalizedPath === cleaned;
+}
+/** True when the overlay targets the given path (include/exclude rules). */ export function overlayMatchesPath(overlay, path) {
+    var _overlay_excludePathPatterns, _overlay_pathPatterns;
+    const excludes = (_overlay_excludePathPatterns = overlay.excludePathPatterns) != null ? _overlay_excludePathPatterns : [];
+    if (excludes.some((pattern)=>overlayPatternMatches(pattern, path))) {
+        return false;
+    }
+    const includes = ((_overlay_pathPatterns = overlay.pathPatterns) != null ? _overlay_pathPatterns : []).filter((pattern)=>pattern.trim());
+    if (!includes.length) return true;
+    return includes.some((pattern)=>overlayPatternMatches(pattern, path));
+}
+/** True when `nowMs` falls inside the overlay's schedule window. */ export function overlayActiveAt(overlay, nowMs) {
+    if (overlay.startAtMs && nowMs < overlay.startAtMs) return false;
+    if (overlay.endAtMs && nowMs > overlay.endAtMs) return false;
+    return true;
+}
+/**
+ * Picks the overlays to render for a page: enabled, inside their window,
+ * targeting the path — sorted by `order` then name, first of each kind
+ * wins (one bar + one popup per page render).
+ */ export function resolveActiveOverlays(overlays, context) {
+    var _context_nowMs, _active_find, _active_find1;
+    const nowMs = (_context_nowMs = context.nowMs) != null ? _context_nowMs : Date.now();
+    const active = overlays.filter((overlay)=>overlay.enabled !== false && overlayActiveAt(overlay, nowMs) && overlayMatchesPath(overlay, context.path)).sort((a, b)=>{
+        var _a_order, _b_order, _a_name, _b_name;
+        return ((_a_order = a.order) != null ? _a_order : 0) - ((_b_order = b.order) != null ? _b_order : 0) || String((_a_name = a.name) != null ? _a_name : '').localeCompare(String((_b_name = b.name) != null ? _b_name : ''));
+    });
+    return {
+        bar: (_active_find = active.find((overlay)=>overlay.kind === 'bar' && overlay.bar)) != null ? _active_find : null,
+        popup: (_active_find1 = active.find((overlay)=>overlay.kind === 'popup' && overlay.popup)) != null ? _active_find1 : null
+    };
+}
+/**
+ * Which store a popup's frequency cap uses (AGL-2174).
+ *
+ * `sessionStorage` for a per-session cap, because that IS the lifetime the
+ * setting names: it clears when the tab closes. `frequencyDays: 1` cannot
+ * express it — a visitor who dismissed at 23:59 would be suppressed for
+ * one minute and then shown the popup again.
+ *
+ * The read and the write must agree. Stamping `localStorage` for a
+ * session-capped popup leaves a timestamp nothing reads, which outlives
+ * the cap it was meant to record.
+ */ export function popupCapStore(popup) {
+    return (popup == null ? void 0 : popup.oncePerSession) ? 'session' : 'local';
+}
+/**
+ * Whether a popup is currently suppressed by its own frequency cap.
+ *
+ * `sessionFlag` is whatever `sessionStorage` holds for it; `lastShownMs`
+ * is the `localStorage` timestamp. Exactly one is consulted — the two caps
+ * are alternative answers to the same question, and honouring both would
+ * suppress a popup for the session AND for a week afterwards.
+ */ export function popupSuppressed(popup, state, nowMs) {
+    var _state_lastShownMs, _ref;
+    if (popup == null ? void 0 : popup.oncePerSession) return Boolean(state.sessionFlag);
+    const stamp = Number((_state_lastShownMs = state.lastShownMs) != null ? _state_lastShownMs : 0);
+    if (!stamp) return false;
+    // A missing or zero `frequencyDays` means "no day cap configured", and
+    // the comparison already says so: `now - stamp` is positive for any
+    // real stamp, so it is never below zero. Stated rather than guarded —
+    // an `if (!days) return false` above this line reads like a guard while
+    // being unreachable, which is the kind of line a later reader trusts.
+    const days = Number((_ref = popup == null ? void 0 : popup.frequencyDays) != null ? _ref : 0);
+    return nowMs - stamp < days * 86400000;
+}
+
+//# sourceMappingURL=overlays.js.map

package/src/lib/model/overlays.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/model/overlays.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 {\n  HostAnnouncementBar,\n  HostPopup,\n} from '@aglyn/aglyn'\n\n/**\n * Marketing hub overlays (AGL-251): multiple announcement bars and\n * promotional popups per host at `hosts/{hostId}/overlays/{overlayId}`,\n * each with its own schedule window and page targeting. The legacy single\n * `host.announcementBar` / `host.popup` fields keep working as fallbacks\n * when no overlay doc matches. Pure types + resolution helpers here; the\n * tenant render picks the first active match per kind.\n */\nexport interface HostOverlay {\n  kind: 'bar' | 'popup'\n  /** Display name in the console list (e.g. \"Black Friday bar\"). */\n  name?: string\n  /** Disabled overlays never render; new overlays default enabled. */\n  enabled?: boolean\n  /** Bar payload when `kind: 'bar'` (the legacy shape, minus enabled). */\n  bar?: Omit<HostAnnouncementBar, 'enabled'>\n  /** Popup payload when `kind: 'popup'` (the legacy shape, minus enabled). */\n  popup?: Omit<HostPopup, 'enabled' | 'startAtMs' | 'endAtMs'>\n  /** Showing window (epoch millis; simple to serialize). */\n  startAtMs?: number\n  endAtMs?: number\n  /**\n   * Path patterns the overlay shows on; empty/absent = every page.\n   * Patterns are exact paths or prefix globs (`/pricing`, `/blog/*`).\n   */\n  pathPatterns?: string[]\n  /** Path patterns the overlay never shows on; wins over includes. */\n  excludePathPatterns?: string[]\n  /** List order; lower renders first when several match. */\n  order?: number\n  /**\n   * Aggregate engagement counters (AGL-271), incremented server-side by\n   * the tenant beacon — never written from the console.\n   */\n  stats?: {\n    impressions?: number\n    clicks?: number\n    dismissals?: number\n  }\n}\n\n/** Exact-or-prefix-glob path match: `/blog/*` matches `/blog/anything`. */\nexport function overlayPatternMatches(pattern: string, path: string): boolean {\n  const cleaned = pattern.trim()\n  if (!cleaned) return false\n  const normalizedPath = path === '' ? '/' : path\n  if (cleaned.endsWith('/*')) {\n    const prefix = cleaned.slice(0, -2)\n    if (!prefix || prefix === '/') return normalizedPath.startsWith('/')\n    return (\n      normalizedPath === prefix || normalizedPath.startsWith(`${prefix}/`)\n    )\n  }\n  return normalizedPath === cleaned\n}\n\n/** True when the overlay targets the given path (include/exclude rules). */\nexport function overlayMatchesPath(\n  overlay: Pick<HostOverlay, 'pathPatterns' | 'excludePathPatterns'>,\n  path: string,\n): boolean {\n  const excludes = overlay.excludePathPatterns ?? []\n  if (excludes.some((pattern) => overlayPatternMatches(pattern, path))) {\n    return false\n  }\n  const includes = (overlay.pathPatterns ?? []).filter((pattern) =>\n    pattern.trim(),\n  )\n  if (!includes.length) return true\n  return includes.some((pattern) => overlayPatternMatches(pattern, path))\n}\n\n/** True when `nowMs` falls inside the overlay's schedule window. */\nexport function overlayActiveAt(\n  overlay: Pick<HostOverlay, 'startAtMs' | 'endAtMs'>,\n  nowMs: number,\n): boolean {\n  if (overlay.startAtMs && nowMs < overlay.startAtMs) return false\n  if (overlay.endAtMs && nowMs > overlay.endAtMs) return false\n  return true\n}\n\n/**\n * Picks the overlays to render for a page: enabled, inside their window,\n * targeting the path — sorted by `order` then name, first of each kind\n * wins (one bar + one popup per page render).\n */\nexport function resolveActiveOverlays(\n  overlays: Array<HostOverlay & { $id?: string }>,\n  context: { path: string; nowMs?: number },\n): {\n  bar: (HostOverlay & { $id?: string }) | null\n  popup: (HostOverlay & { $id?: string }) | null\n} {\n  const nowMs = context.nowMs ?? Date.now()\n  const active = overlays\n    .filter(\n      (overlay) =>\n        overlay.enabled !== false &&\n        overlayActiveAt(overlay, nowMs) &&\n        overlayMatchesPath(overlay, context.path),\n    )\n    .sort(\n      (a, b) =>\n        (a.order ?? 0) - (b.order ?? 0) ||\n        String(a.name ?? '').localeCompare(String(b.name ?? '')),\n    )\n  return {\n    bar: active.find((overlay) => overlay.kind === 'bar' && overlay.bar) ?? null,\n    popup:\n      active.find((overlay) => overlay.kind === 'popup' && overlay.popup) ??\n      null,\n  }\n}\n\n/** What a popup's frequency cap reads and writes. */\nexport type PopupCapStore = 'session' | 'local'\n\n/**\n * Which store a popup's frequency cap uses (AGL-2174).\n *\n * `sessionStorage` for a per-session cap, because that IS the lifetime the\n * setting names: it clears when the tab closes. `frequencyDays: 1` cannot\n * express it — a visitor who dismissed at 23:59 would be suppressed for\n * one minute and then shown the popup again.\n *\n * The read and the write must agree. Stamping `localStorage` for a\n * session-capped popup leaves a timestamp nothing reads, which outlives\n * the cap it was meant to record.\n */\nexport function popupCapStore(popup: {\n  oncePerSession?: boolean\n}): PopupCapStore {\n  return popup?.oncePerSession ? 'session' : 'local'\n}\n\n/**\n * Whether a popup is currently suppressed by its own frequency cap.\n *\n * `sessionFlag` is whatever `sessionStorage` holds for it; `lastShownMs`\n * is the `localStorage` timestamp. Exactly one is consulted — the two caps\n * are alternative answers to the same question, and honouring both would\n * suppress a popup for the session AND for a week afterwards.\n */\nexport function popupSuppressed(\n  popup: { oncePerSession?: boolean; frequencyDays?: number },\n  state: { sessionFlag?: string | null; lastShownMs?: number | null },\n  nowMs: number,\n): boolean {\n  if (popup?.oncePerSession) return Boolean(state.sessionFlag)\n  const stamp = Number(state.lastShownMs ?? 0)\n  if (!stamp) return false\n  // A missing or zero `frequencyDays` means \"no day cap configured\", and\n  // the comparison already says so: `now - stamp` is positive for any\n  // real stamp, so it is never below zero. Stated rather than guarded —\n  // an `if (!days) return false` above this line reads like a guard while\n  // being unreachable, which is the kind of line a later reader trusts.\n  const days = Number(popup?.frequencyDays ?? 0)\n  return nowMs - stamp < days * 86_400_000\n}\n"],"names":["overlayPatternMatches","pattern","path","cleaned","trim","normalizedPath","endsWith","prefix","slice","startsWith","overlayMatchesPath","overlay","excludes","excludePathPatterns","some","includes","pathPatterns","filter","length","overlayActiveAt","nowMs","startAtMs","endAtMs","resolveActiveOverlays","overlays","context","active","Date","now","enabled","sort","a","b","order","String","name","localeCompare","bar","find","kind","popup","popupCapStore","oncePerSession","popupSuppressed","state","Boolean","sessionFlag","stamp","Number","lastShownMs","days","frequencyDays"],"mappings":"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"}

package/src/lib/model/site-contract.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @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 marketing plugin's site wire contract (AGL-419): shapes its server
+ * page-enricher writes into the page props and its client site-runtime
+ * reads back. Pure types — shared by the /server graph and the client
+ * runtime without pulling either's dependencies.
+ */
+import type { HostActionStep, SiteEventType } from '@aglyn/aglyn';
+import type { ExperimentStatus } from './experiments';
+export interface ClientAutomation {
+    id: string;
+    event: SiteEventType;
+    selector?: string;
+    threshold?: number;
+    /** Fire at most once per visitor (AGL-266). */
+    oncePerVisitor?: boolean;
+    /** Fire at most once per browser session (AGL-274). */
+    oncePerSession?: boolean;
+    /** Minimum minutes between fires for the same visitor (AGL-274). */
+    cooldownMinutes?: number;
+    /** Fire on every occurrence, not once per pageview (AGL-562). */
+    everyTime?: boolean;
+    steps: HostActionStep[];
+    hasServerSteps: boolean;
+}
+export interface ScreenExperiment {
+    id: string;
+    target: 'screen' | 'section';
+    status: ExperimentStatus;
+    nodeId?: string;
+    winnerVariantId?: string;
+    /** Past this the client runner serves the default (AGL-273). */
+    endAtMs?: number;
+    goal?: {
+        event: string;
+        filter?: string;
+    };
+    variants: Array<{
+        id: string;
+        weight?: number;
+        versionId?: string;
+    }>;
+    payloads: Record<string, Record<string, any> | null>;
+}
+export interface AnnouncementBarData {
+    text: string;
+    href?: string;
+    backgroundColor?: string;
+    textColor?: string;
+    dismissible: boolean;
+    contentHash: string;
+    overlayId?: string;
+}
+export interface PopupData {
+    headline?: string;
+    body: string;
+    imageUrl?: string;
+    /**
+     * Alt text for {@link imageUrl} (AGL-1896).
+     *
+     * The popup image used to render with a hardcoded `alt=""` and there was
+     * no field anywhere that could have changed it — an author-chosen banner,
+     * on a paying customer's published site, invisible to a screen reader by
+     * construction. Defaults from the DAM asset's own alt when the author
+     * picks one through "Browse media"; an empty value still renders `alt=""`,
+     * which is the right markup for a genuinely decorative banner.
+     */
+    imageAlt?: string;
+    ctaLabel?: string;
+    ctaHref?: string;
+    trigger: string;
+    triggerValue: number;
+    frequencyDays: number;
+    /**
+     * Cap the popup to one showing per browser session (AGL-2174). When
+     * set, `frequencyDays` is not consulted — the two are alternative
+     * answers to the same question.
+     */
+    oncePerSession?: boolean;
+    collectEmail?: boolean;
+    startAtMs?: number;
+    endAtMs?: number;
+    contentHash: string;
+    overlayId?: string;
+}

package/src/lib/model/site-contract.js

@@ -0,0 +1,23 @@
+/**
+ * @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 marketing plugin's site wire contract (AGL-419): shapes its server
+ * page-enricher writes into the page props and its client site-runtime
+ * reads back. Pure types — shared by the /server graph and the client
+ * runtime without pulling either's dependencies.
+ */ export { };
+
+//# sourceMappingURL=site-contract.js.map

package/src/lib/model/site-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/model/site-contract.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 marketing plugin's site wire contract (AGL-419): shapes its server\n * page-enricher writes into the page props and its client site-runtime\n * reads back. Pure types — shared by the /server graph and the client\n * runtime without pulling either's dependencies.\n */\n\nimport type { HostActionStep, SiteEventType } from '@aglyn/aglyn'\nimport type { ExperimentStatus } from './experiments'\n\nexport interface ClientAutomation {\n  id: string\n  event: SiteEventType\n  selector?: string\n  threshold?: number\n  /** Fire at most once per visitor (AGL-266). */\n  oncePerVisitor?: boolean\n  /** Fire at most once per browser session (AGL-274). */\n  oncePerSession?: boolean\n  /** Minimum minutes between fires for the same visitor (AGL-274). */\n  cooldownMinutes?: number\n  /** Fire on every occurrence, not once per pageview (AGL-562). */\n  everyTime?: boolean\n  steps: HostActionStep[]\n  hasServerSteps: boolean\n}\n\nexport interface ScreenExperiment {\n  id: string\n  target: 'screen' | 'section'\n  status: ExperimentStatus\n  nodeId?: string\n  winnerVariantId?: string\n  /** Past this the client runner serves the default (AGL-273). */\n  endAtMs?: number\n  goal?: { event: string; filter?: string }\n  variants: Array<{ id: string; weight?: number; versionId?: string }>\n  payloads: Record<string, Record<string, any> | null>\n}\n\nexport interface AnnouncementBarData {\n  text: string\n  href?: string\n  backgroundColor?: string\n  textColor?: string\n  dismissible: boolean\n  contentHash: string\n  overlayId?: string\n}\n\nexport interface PopupData {\n  headline?: string\n  body: string\n  imageUrl?: string\n  /**\n   * Alt text for {@link imageUrl} (AGL-1896).\n   *\n   * The popup image used to render with a hardcoded `alt=\"\"` and there was\n   * no field anywhere that could have changed it — an author-chosen banner,\n   * on a paying customer's published site, invisible to a screen reader by\n   * construction. Defaults from the DAM asset's own alt when the author\n   * picks one through \"Browse media\"; an empty value still renders `alt=\"\"`,\n   * which is the right markup for a genuinely decorative banner.\n   */\n  imageAlt?: string\n  ctaLabel?: string\n  ctaHref?: string\n  trigger: string\n  triggerValue: number\n  frequencyDays: number\n  /**\n   * Cap the popup to one showing per browser session (AGL-2174). When\n   * set, `frequencyDays` is not consulted — the two are alternative\n   * answers to the same question.\n   */\n  oncePerSession?: boolean\n  collectEmail?: boolean\n  startAtMs?: number\n  endAtMs?: number\n  contentHash: string\n  overlayId?: string\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;CAKC,GA6CD,WA+BC"}

package/src/lib/plugin.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @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.
+ */
+/**
+ * Marketing feature plugin (AGL-395). Console-only — overlays and popups
+ * render on published sites through the tenant runtime, not a canvas
+ * element of their own, so there is no UI bundle. The console half declares
+ * the Marketing nav + page through the ConsoleExtension registry (always-on;
+ * the surface itself is not release-flagged — its overlays/A-B cards run
+ * their own per-plan checks off the passed `org`). The popup image picker
+ * uses the shell's media browser via `useMediaPicker`.
+ */
+export declare function registerMarketingConsole(): void;
+export * from './site';

package/src/lib/plugin.js

@@ -0,0 +1,168 @@
+/**
+ * @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";
+import { registerPluginZone } from "@aglyn/aglyn/plugin-manager/plugin-zones";
+import { mdiBullhornOutline } from "@aglyn/shared-data-mdi";
+import { lazy } from "react";
+import { CAMPAIGN_DESIGN_CREATE_ZONE, CAMPAIGN_DESIGN_PREVIEW_ZONE, CAMPAIGN_SENDER_EDITOR_ZONE, CAMPAIGN_TOPIC_OPTIONS_ZONE, CAMPAIGN_TOPIC_SELECT_ZONE } from "./components/campaign-email-zones.js";
+import { EXPERIMENT_RESULT_ZONE, EXPERIMENT_VARIANTS_ZONE } from "./components/experiment-zones.js";
+import { MARKETING_CONSOLE_SECTIONS } from "./components/marketing-console-sections.js";
+import { BUNDLE_ID } from "./constants/bundle-common.js";
+import { registerMarketingRecordRoutes } from "./model/marketing-record-routes.js";
+/** Code-split: the Marketing console page only loads when opened. */ const MarketingConsolePage = lazy(()=>import("./components/marketing-console-page.js"));
+/** Dashboard glance card, loaded only where the shell renders the slot. */ const CampaignGlanceCard = lazy(()=>import("./components/campaign-glance-card.component.js"));
+/** The site's campaigns, drawn in the Inbox's Campaigns section. */ const HostCampaignsCard = lazy(()=>import("./components/campaigns-card.js"));
+/** The Emails page's Messages section: the list, one message, its composer. */ const EmailMessagesWidget = lazy(()=>import("./components/email-messages-widget.js"));
+/** Who received the sends built from one template, on the template's page. */ const EmailRecipientsCard = lazy(()=>import("./components/email-recipients-card.js"));
+/** Loaded where a record page draws one of the attribution zones. */ const RecordAttributionWidget = lazy(()=>import("./components/record-attribution-widget.js"));
+/**
+ * Marketing feature plugin (AGL-395). Console-only — overlays and popups
+ * render on published sites through the tenant runtime, not a canvas
+ * element of their own, so there is no UI bundle. The console half declares
+ * the Marketing nav + page through the ConsoleExtension registry (always-on;
+ * the surface itself is not release-flagged — its overlays/A-B cards run
+ * their own per-plan checks off the passed `org`). The popup image picker
+ * uses the shell's media browser via `useMediaPicker`.
+ */ export function registerMarketingConsole() {
+    /*
+   * The two positions the A/B testing card hosts (AGL-2914), declared before
+   * the extension that draws the card. An id another plugin has already taken
+   * is refused, naming both. What each zone hands a widget is carried on its
+   * token, in `components/experiment-zones`, so a widget elsewhere is written
+   * against the same shape without importing this plugin.
+   */ registerPluginZone({
+        zone: EXPERIMENT_VARIANTS_ZONE,
+        label: 'A/B test variants',
+        surface: 'console',
+        description: 'In the experiment editor, beside the variants. A widget here proposes copy for the variants the editor holds; the dialog’s Save is the write, and nothing a widget returns starts or changes a test.'
+    }, // Named rather than left to the loader's marker, because this function is
+    // also called directly — by a spec, and by an app that loads the plugin
+    // without the loader — and a zone with no owner is refused.
+    {
+        pluginId: BUNDLE_ID
+    });
+    registerPluginZone({
+        zone: EXPERIMENT_RESULT_ZONE,
+        label: 'A/B test result',
+        surface: 'console',
+        description: 'Below the results of one test. A widget here explains what the figures show. There is nothing to apply, and a widget may not declare a winner the card has not.'
+    }, {
+        pluginId: BUNDLE_ID
+    });
+    /*
+   * What a campaign email asks of whichever plugin keeps the mail itself —
+   * the topic catalog, the sending identities, the design document and its
+   * renderer. Each is a zone the composer or a message's page hosts; see
+   * `components/campaign-email-zones` for what each hands a widget. All are
+   * `bare`: a widget there is a field, a button, a drawer or nothing at all,
+   * and the stack's spacing around it would be a gap in a form.
+   */ const bareZone = (zone, label, description)=>registerPluginZone({
+            zone,
+            label,
+            description,
+            surface: 'console',
+            layout: 'bare'
+        }, {
+            pluginId: BUNDLE_ID
+        });
+    bareZone(CAMPAIGN_TOPIC_SELECT_ZONE, 'An email’s topic', 'In the campaign composer’s field stack. A widget here is the picker for the stream the email belongs to: it is handed the chosen id and reports a new one through `onChange`. The composer records it; the widget writes nothing.');
+    bareZone(CAMPAIGN_TOPIC_OPTIONS_ZONE, 'The topics a campaign can open on', 'Beside the drawers that create and edit a campaign. A widget here draws nothing: while `enabled` it reads the streams a recipient can still leave and answers through `onTopics`.');
+    bareZone(CAMPAIGN_SENDER_EDITOR_ZONE, 'Add a sender while composing', 'Mounted by the campaign composer once its author asks to add a sender. A widget here is that editor, open in its add mode; `onSaved` names the sender it created.');
+    bareZone(CAMPAIGN_DESIGN_CREATE_ZONE, 'A design for one email', 'In the campaign composer, beside the design picker. A widget here is the control that mints a design document and names it through `onCreated`; the composer records the choice on the campaign and opens the editor.');
+    bareZone(CAMPAIGN_DESIGN_PREVIEW_ZONE, 'A sent email as an inbox receives it', 'On one message’s page. A widget here renders the stored design, or the plain-text body, through the renderer the send path uses.');
+    registerMarketingRecordRoutes();
+    Aglyn.registerConsoleExtension({
+        pluginId: BUNDLE_ID,
+        displayName: 'Marketing',
+        /*
+     * The host dashboard's `Last campaign` card (AGL-433). A widget rather
+     * than a direct import by the dashboard page, so it appears only on
+     * workspaces that have the plugin that owns the campaign history — a card
+     * about campaigns on a console with no campaigns page could only ever be
+     * blank, and its header links straight into `/marketing/campaigns`.
+     */ widgets: [
+            {
+                slot: Aglyn.CONSOLE_WIDGET_SLOTS.hostDashboard,
+                // The id a reader's dashboard preferences already name — it is what
+                // `isDashboardWidgetHidden` and the customize order are keyed on, so
+                // it is persisted and does not follow the plugin.
+                widgetId: 'email-campaign-glance',
+                title: 'Last campaign',
+                Component: CampaignGlanceCard
+            },
+            // Which campaign or link brought a person, drawn where the plugins that
+            // keep and list people host a zone for it. They hand over what the
+            // record is and its id; neither imports this plugin.
+            {
+                slot: 'crmRecordAttribution',
+                widgetId: 'marketing-crm-record-attribution',
+                title: 'Campaign attribution',
+                Component: RecordAttributionWidget
+            },
+            // The Emails page hosts its Messages section as a zone: a message is
+            // one send of a campaign, and every action on it is this plugin's route.
+            {
+                slot: 'emailMessages',
+                widgetId: 'marketing-email-messages',
+                title: 'Messages',
+                Component: EmailMessagesWidget
+            },
+            {
+                slot: 'emailTemplateRecipients',
+                widgetId: 'marketing-email-template-recipients',
+                title: 'Recipients',
+                Component: EmailRecipientsCard
+            },
+            // The Inbox's Campaigns tab is a zone; this is the card that fills it.
+            {
+                slot: 'inboxCampaigns',
+                widgetId: 'marketing-inbox-campaigns',
+                title: 'Campaigns',
+                Component: HostCampaignsCard
+            },
+            {
+                slot: 'inboxRecordAttribution',
+                widgetId: 'marketing-inbox-record-attribution',
+                title: 'Campaign attribution',
+                Component: RecordAttributionWidget
+            }
+        ],
+        navItems: [
+            {
+                label: 'Marketing',
+                href: '/marketing',
+                // Sections as ROUTES (AGL-2501): each is a real URL the shell
+                // resolves and gates, so the page mounts the one being read.
+                sections: MARKETING_CONSOLE_SECTIONS,
+                navTabId: 'nav-tab-marketing',
+                icon: {
+                    path: mdiBullhornOutline.path
+                },
+                header: {
+                    title: 'Marketing',
+                    icon: {
+                        path: mdiBullhornOutline.path
+                    },
+                    docsTopic: 'marketingOverlays'
+                },
+                Component: MarketingConsolePage
+            }
+        ]
+    });
+}
+export * from "./site.js";
+
+//# sourceMappingURL=plugin.js.map

package/src/lib/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/plugins/marketing/src/lib/plugin.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'\nimport {\n  registerPluginZone,\n  type PluginZone,\n} from '@aglyn/aglyn/plugin-manager/plugin-zones'\nimport { mdiBullhornOutline } from '@aglyn/shared-data-mdi'\nimport { lazy } from 'react'\nimport {\n  CAMPAIGN_DESIGN_CREATE_ZONE,\n  CAMPAIGN_DESIGN_PREVIEW_ZONE,\n  CAMPAIGN_SENDER_EDITOR_ZONE,\n  CAMPAIGN_TOPIC_OPTIONS_ZONE,\n  CAMPAIGN_TOPIC_SELECT_ZONE,\n} from './components/campaign-email-zones'\nimport {\n  EXPERIMENT_RESULT_ZONE,\n  EXPERIMENT_VARIANTS_ZONE,\n} from './components/experiment-zones'\nimport { MARKETING_CONSOLE_SECTIONS } from './components/marketing-console-sections'\nimport { BUNDLE_ID } from './constants/bundle-common'\nimport { registerMarketingRecordRoutes } from './model/marketing-record-routes'\n\n/** Code-split: the Marketing console page only loads when opened. */\nconst MarketingConsolePage = lazy(\n  () => import('./components/marketing-console-page'),\n)\n\n/** Dashboard glance card, loaded only where the shell renders the slot. */\nconst CampaignGlanceCard = lazy(\n  () => import('./components/campaign-glance-card.component'),\n)\n\n/** The site's campaigns, drawn in the Inbox's Campaigns section. */\nconst HostCampaignsCard = lazy(() => import('./components/campaigns-card'))\n\n/** The Emails page's Messages section: the list, one message, its composer. */\nconst EmailMessagesWidget = lazy(\n  () => import('./components/email-messages-widget'),\n)\n\n/** Who received the sends built from one template, on the template's page. */\nconst EmailRecipientsCard = lazy(\n  () => import('./components/email-recipients-card'),\n)\n\n/** Loaded where a record page draws one of the attribution zones. */\nconst RecordAttributionWidget = lazy(\n  () => import('./components/record-attribution-widget'),\n)\n\n/**\n * Marketing feature plugin (AGL-395). Console-only — overlays and popups\n * render on published sites through the tenant runtime, not a canvas\n * element of their own, so there is no UI bundle. The console half declares\n * the Marketing nav + page through the ConsoleExtension registry (always-on;\n * the surface itself is not release-flagged — its overlays/A-B cards run\n * their own per-plan checks off the passed `org`). The popup image picker\n * uses the shell's media browser via `useMediaPicker`.\n */\nexport function registerMarketingConsole(): void {\n  /*\n   * The two positions the A/B testing card hosts (AGL-2914), declared before\n   * the extension that draws the card. An id another plugin has already taken\n   * is refused, naming both. What each zone hands a widget is carried on its\n   * token, in `components/experiment-zones`, so a widget elsewhere is written\n   * against the same shape without importing this plugin.\n   */\n  registerPluginZone(\n    {\n      zone: EXPERIMENT_VARIANTS_ZONE,\n      label: 'A/B test variants',\n      surface: 'console',\n      description:\n        'In the experiment editor, beside the variants. A widget here proposes copy for the variants the editor holds; the dialog’s Save is the write, and nothing a widget returns starts or changes a test.',\n    },\n    // Named rather than left to the loader's marker, because this function is\n    // also called directly — by a spec, and by an app that loads the plugin\n    // without the loader — and a zone with no owner is refused.\n    { pluginId: BUNDLE_ID },\n  )\n  registerPluginZone(\n    {\n      zone: EXPERIMENT_RESULT_ZONE,\n      label: 'A/B test result',\n      surface: 'console',\n      description:\n        'Below the results of one test. A widget here explains what the figures show. There is nothing to apply, and a widget may not declare a winner the card has not.',\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  /*\n   * What a campaign email asks of whichever plugin keeps the mail itself —\n   * the topic catalog, the sending identities, the design document and its\n   * renderer. Each is a zone the composer or a message's page hosts; see\n   * `components/campaign-email-zones` for what each hands a widget. All are\n   * `bare`: a widget there is a field, a button, a drawer or nothing at all,\n   * and the stack's spacing around it would be a gap in a form.\n   */\n  const bareZone = <Props,>(\n    zone: PluginZone<Props>,\n    label: string,\n    description: string,\n  ) =>\n    registerPluginZone(\n      { zone, label, description, surface: 'console', layout: 'bare' },\n      { pluginId: BUNDLE_ID },\n    )\n  bareZone(\n    CAMPAIGN_TOPIC_SELECT_ZONE,\n    'An email’s topic',\n    'In the campaign composer’s field stack. A widget here is the picker for the stream the email belongs to: it is handed the chosen id and reports a new one through `onChange`. The composer records it; the widget writes nothing.',\n  )\n  bareZone(\n    CAMPAIGN_TOPIC_OPTIONS_ZONE,\n    'The topics a campaign can open on',\n    'Beside the drawers that create and edit a campaign. A widget here draws nothing: while `enabled` it reads the streams a recipient can still leave and answers through `onTopics`.',\n  )\n  bareZone(\n    CAMPAIGN_SENDER_EDITOR_ZONE,\n    'Add a sender while composing',\n    'Mounted by the campaign composer once its author asks to add a sender. A widget here is that editor, open in its add mode; `onSaved` names the sender it created.',\n  )\n  bareZone(\n    CAMPAIGN_DESIGN_CREATE_ZONE,\n    'A design for one email',\n    'In the campaign composer, beside the design picker. A widget here is the control that mints a design document and names it through `onCreated`; the composer records the choice on the campaign and opens the editor.',\n  )\n  bareZone(\n    CAMPAIGN_DESIGN_PREVIEW_ZONE,\n    'A sent email as an inbox receives it',\n    'On one message’s page. A widget here renders the stored design, or the plain-text body, through the renderer the send path uses.',\n  )\n  registerMarketingRecordRoutes()\n  Aglyn.registerConsoleExtension({\n    pluginId: BUNDLE_ID,\n    displayName: 'Marketing',\n    /*\n     * The host dashboard's `Last campaign` card (AGL-433). A widget rather\n     * than a direct import by the dashboard page, so it appears only on\n     * workspaces that have the plugin that owns the campaign history — a card\n     * about campaigns on a console with no campaigns page could only ever be\n     * blank, and its header links straight into `/marketing/campaigns`.\n     */\n    widgets: [\n      {\n        slot: Aglyn.CONSOLE_WIDGET_SLOTS.hostDashboard,\n        // The id a reader's dashboard preferences already name — it is what\n        // `isDashboardWidgetHidden` and the customize order are keyed on, so\n        // it is persisted and does not follow the plugin.\n        widgetId: 'email-campaign-glance',\n        title: 'Last campaign',\n        Component: CampaignGlanceCard,\n      },\n      // Which campaign or link brought a person, drawn where the plugins that\n      // keep and list people host a zone for it. They hand over what the\n      // record is and its id; neither imports this plugin.\n      {\n        slot: 'crmRecordAttribution',\n        widgetId: 'marketing-crm-record-attribution',\n        title: 'Campaign attribution',\n        Component: RecordAttributionWidget,\n      },\n      // The Emails page hosts its Messages section as a zone: a message is\n      // one send of a campaign, and every action on it is this plugin's route.\n      {\n        slot: 'emailMessages',\n        widgetId: 'marketing-email-messages',\n        title: 'Messages',\n        Component: EmailMessagesWidget,\n      },\n      {\n        slot: 'emailTemplateRecipients',\n        widgetId: 'marketing-email-template-recipients',\n        title: 'Recipients',\n        Component: EmailRecipientsCard,\n      },\n      // The Inbox's Campaigns tab is a zone; this is the card that fills it.\n      {\n        slot: 'inboxCampaigns',\n        widgetId: 'marketing-inbox-campaigns',\n        title: 'Campaigns',\n        Component: HostCampaignsCard,\n      },\n      {\n        slot: 'inboxRecordAttribution',\n        widgetId: 'marketing-inbox-record-attribution',\n        title: 'Campaign attribution',\n        Component: RecordAttributionWidget,\n      },\n    ],\n    navItems: [\n      {\n        label: 'Marketing',\n        href: '/marketing',\n        // Sections as ROUTES (AGL-2501): each is a real URL the shell\n        // resolves and gates, so the page mounts the one being read.\n        sections: MARKETING_CONSOLE_SECTIONS,\n        navTabId: 'nav-tab-marketing',\n        icon: { path: mdiBullhornOutline.path },\n        header: {\n          title: 'Marketing',\n          icon: { path: mdiBullhornOutline.path },\n          docsTopic: 'marketingOverlays',\n        },\n        Component: MarketingConsolePage,\n      },\n    ],\n  })\n}\n\nexport * from './site'\n"],"names":["Aglyn","registerPluginZone","mdiBullhornOutline","lazy","CAMPAIGN_DESIGN_CREATE_ZONE","CAMPAIGN_DESIGN_PREVIEW_ZONE","CAMPAIGN_SENDER_EDITOR_ZONE","CAMPAIGN_TOPIC_OPTIONS_ZONE","CAMPAIGN_TOPIC_SELECT_ZONE","EXPERIMENT_RESULT_ZONE","EXPERIMENT_VARIANTS_ZONE","MARKETING_CONSOLE_SECTIONS","BUNDLE_ID","registerMarketingRecordRoutes","MarketingConsolePage","CampaignGlanceCard","HostCampaignsCard","EmailMessagesWidget","EmailRecipientsCard","RecordAttributionWidget","registerMarketingConsole","zone","label","surface","description","pluginId","bareZone","layout","registerConsoleExtension","displayName","widgets","slot","CONSOLE_WIDGET_SLOTS","hostDashboard","widgetId","title","Component","navItems","href","sections","navTabId","icon","path","header","docsTopic"],"mappings":"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"}

package/src/lib/preview-props.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @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 { SiteRuntimePreviewContext } from '@aglyn/aglyn';
+/**
+ * The marketing site-runtime's client-side page-props for the besigner
+ * Preview (AGL-830). No server enricher runs there, so this reads the host's
+ * `actions` with the client SDK and compiles them the same way the enricher
+ * does — the Preview then mounts the SAME MarketingSiteRuntime the tenant
+ * uses, and hover-to-open menus/drawers behave exactly like the live site.
+ *
+ * Compiled with `actionsEntitled: false`, so only basic PRESENTATIONAL steps
+ * (menu/drawer/show-hide/class/nav) run and `hasServerSteps` stays false —
+ * preview never fires analytics, webhooks, or server events. `matchAllPaths`
+ * because the Preview renders one composed screen and scopes relevance by
+ * selector match, not page path.
+ */
+export declare function loadMarketingPreviewProps(ctx: SiteRuntimePreviewContext): Promise<Record<string, unknown>>;