@aglyn/plugins-marketing 1.0.0-beta.143

package/src/lib/model/compile-client-automations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/model/compile-client-automations.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// Import the entitlement/event predicates from the context-free actions\n// subpath, NOT the `@aglyn/aglyn` barrel: this file is in the marketing model,\n// which the plugin's SERVER graph re-exports, and the full barrel pulls client\n// React contexts (createContext) that break the RSC server build (AGL-830).\nimport {\n  hostActionStepsForClient,\n  isClientActionStep,\n  isClientStepEntitled,\n  isSiteEventType,\n  type HostAction,\n} from '@aglyn/aglyn/app-utils/actions'\nimport { overlayMatchesPath } from './overlays'\nimport type { ClientAutomation } from './site-contract'\n\n/** A raw `hosts/{hostId}/actions` doc paired with its id. */\nexport interface RawHostAction {\n  id: string\n  action: HostAction\n}\n\nexport interface CompileClientAutomationsOptions {\n  /** Leading-slash page path for pathPattern targeting. */\n  path: string\n  /**\n   * `actions` entitlement (AGL-577). Basic presentational steps\n   * (menu/drawer/show-hide/class/nav/alert) always load; advanced client\n   * steps (overlay/showHtml/analytics) and server steps drop when false.\n   */\n  actionsEntitled: boolean\n  /** Business-tier gate for `runJs` steps (dropped when false). */\n  allowJs: boolean\n  /**\n   * Ignore each action's `pathPattern` (AGL-830). The besigner Preview shows\n   * a single composed screen and scopes relevance by selector match, so it\n   * skips path filtering rather than resolve the composed path.\n   */\n  matchAllPaths?: boolean\n  /**\n   * Drop every automation that names a `pathPattern` (AGL-2511), for a\n   * surface whose own path is unknown — the designed 404 body, served from a\n   * per-host cache that no request path belongs to.\n   *\n   * The opposite of `matchAllPaths` and deliberately so: Preview knows the\n   * page and only lacks its composed address, so it keeps path-scoped\n   * automations; this caller cannot know the page at all, and running an\n   * automation scoped to `/pricing` on whatever URL 404'd would be a guess\n   * with a side effect. Interactions authored on nodes carry no pattern, so\n   * a nav's hover choreography — the reason this surface is enriched — is\n   * unaffected.\n   */\n  dropPathScoped?: boolean\n}\n\n/**\n * Pure action→client-automation mapping (AGL-256/577, extracted AGL-830):\n * the single place the trigger config + entitlement-trimmed client steps are\n * shaped. Both the server page-enricher (admin fetch) and the editor Preview\n * (client fetch) feed their loaded action docs through this, so live and\n * preview stay byte-for-byte consistent. No I/O, no firebase — safe on the\n * client. Malformed entries are skipped, never thrown.\n */\nexport function compileClientAutomations(\n  actions: RawHostAction[],\n  options: CompileClientAutomationsOptions,\n): ClientAutomation[] {\n  const automations: ClientAutomation[] = []\n  for (const { id, action } of actions) {\n    if (\n      (action as { deletedAt?: unknown }).deletedAt ||\n      action.enabled === false\n    ) {\n      continue\n    }\n    const event = String(action.trigger?.event ?? '')\n    if (!isSiteEventType(event)) continue\n    const pathPattern = action.trigger?.pathPattern?.trim()\n    if (pathPattern && options.dropPathScoped) continue\n    if (\n      !options.matchAllPaths &&\n      pathPattern &&\n      !overlayMatchesPath({ pathPatterns: [pathPattern] }, options.path)\n    ) {\n      continue\n    }\n    /*\n     * TRUNCATED AT THE FIRST WAIT, before anything else is decided.\n     *\n     * The browser runs its slice of the list the moment the trigger fires, so\n     * a client step sitting after a `wait` would execute at once — the popup\n     * an author scheduled for three days later would appear immediately, the\n     * delay would look correct on the server, and the two halves of one\n     * authored flow would disagree about when they happened. Everything past\n     * the first wait belongs to a run the job beat has not started yet.\n     */\n    const reachableSteps = hostActionStepsForClient(action.steps)\n    // Step-level entitlement tiering (AGL-577): basic presentational steps\n    // load on every plan; advanced client steps need `actions` and runJs\n    // needs `webhooks` — see isClientStepEntitled.\n    const clientSteps = reachableSteps.filter((step) =>\n      isClientStepEntitled(step, {\n        actionsEntitled: options.actionsEntitled,\n        allowJs: options.allowJs,\n      }),\n    )\n    // Server steps only dispatch (and are only re-authorized) when the org is\n    // actions-entitled — never advertise them otherwise, so basic-tier pages\n    // don't POST to /api/events/dispatch for a no-op.\n    const hasServerSteps =\n      options.actionsEntitled &&\n      (action.steps ?? []).some((step) => !isClientActionStep(step))\n    if (!clientSteps.length && !hasServerSteps) continue\n    automations.push({\n      id,\n      event,\n      ...(action.trigger?.selector\n        ? { selector: action.trigger.selector }\n        : {}),\n      ...(Number(action.trigger?.threshold) > 0\n        ? { threshold: Number(action.trigger.threshold) }\n        : {}),\n      ...(action.trigger?.oncePerVisitor === true\n        ? { oncePerVisitor: true }\n        : {}),\n      ...(action.trigger?.oncePerSession === true\n        ? { oncePerSession: true }\n        : {}),\n      ...(Number(action.trigger?.cooldownMinutes) >= 1\n        ? { cooldownMinutes: Number(action.trigger?.cooldownMinutes) }\n        : {}),\n      // Repeatable UI choreography (AGL-562): menu/drawer interactions fire on\n      // every occurrence instead of once per pageview.\n      ...(action.trigger?.everyTime === true ? { everyTime: true } : {}),\n      steps: clientSteps,\n      hasServerSteps,\n    })\n  }\n  return automations\n}\n\nexport default compileClientAutomations\n"],"names":["hostActionStepsForClient","isClientActionStep","isClientStepEntitled","isSiteEventType","overlayMatchesPath","compileClientAutomations","actions","options","automations","id","action","deletedAt","enabled","event","String","trigger","pathPattern","trim","dropPathScoped","matchAllPaths","pathPatterns","path","reachableSteps","steps","clientSteps","filter","step","actionsEntitled","allowJs","hasServerSteps","some","length","push","selector","Number","threshold","oncePerVisitor","oncePerSession","cooldownMinutes","everyTime"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,wEAAwE;AACxE,+EAA+E;AAC/E,+EAA+E;AAC/E,4EAA4E;AAC5E,SACEA,wBAAwB,EACxBC,kBAAkB,EAClBC,oBAAoB,EACpBC,eAAe,QAEV,iCAAgC;AACvC,SAASC,kBAAkB,QAAQ,gBAAY;AA0C/C;;;;;;;CAOC,GACD,OAAO,SAASC,yBACdC,OAAwB,EACxBC,OAAwC;IAExC,MAAMC,cAAkC,EAAE;IAC1C,KAAK,MAAM,EAAEC,EAAE,EAAEC,MAAM,EAAE,IAAIJ,QAAS;kBA2CjCI;YApCkBA,iBAEDA,6BAAAA,kBAuCdA,kBAGOA,kBAGPA,kBAGAA,kBAGOA,kBACmBA,kBAI1BA;QAhEN,IACE,AAACA,OAAmCC,SAAS,IAC7CD,OAAOE,OAAO,KAAK,OACnB;YACA;QACF;QACA,MAAMC,QAAQC,gBAAOJ,kBAAAA,OAAOK,OAAO,qBAAdL,gBAAgBG,KAAK,mBAAI;QAC9C,IAAI,CAACV,gBAAgBU,QAAQ;QAC7B,MAAMG,eAAcN,mBAAAA,OAAOK,OAAO,sBAAdL,8BAAAA,iBAAgBM,WAAW,qBAA3BN,4BAA6BO,IAAI;QACrD,IAAID,eAAeT,QAAQW,cAAc,EAAE;QAC3C,IACE,CAACX,QAAQY,aAAa,IACtBH,eACA,CAACZ,mBAAmB;YAAEgB,cAAc;gBAACJ;aAAY;QAAC,GAAGT,QAAQc,IAAI,GACjE;YACA;QACF;QACA;;;;;;;;;KASC,GACD,MAAMC,iBAAiBtB,yBAAyBU,OAAOa,KAAK;QAC5D,uEAAuE;QACvE,qEAAqE;QACrE,+CAA+C;QAC/C,MAAMC,cAAcF,eAAeG,MAAM,CAAC,CAACC,OACzCxB,qBAAqBwB,MAAM;gBACzBC,iBAAiBpB,QAAQoB,eAAe;gBACxCC,SAASrB,QAAQqB,OAAO;YAC1B;QAEF,0EAA0E;QAC1E,yEAAyE;QACzE,kDAAkD;QAClD,MAAMC,iBACJtB,QAAQoB,eAAe,IACvB,EAACjB,gBAAAA,OAAOa,KAAK,YAAZb,gBAAgB,EAAE,EAAEoB,IAAI,CAAC,CAACJ,OAAS,CAACzB,mBAAmByB;QAC1D,IAAI,CAACF,YAAYO,MAAM,IAAI,CAACF,gBAAgB;QAC5CrB,YAAYwB,IAAI,CAAC;YACfvB;YACAI;WACIH,EAAAA,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgBuB,QAAQ,IACxB;YAAEA,UAAUvB,OAAOK,OAAO,CAACkB,QAAQ;QAAC,IACpC,CAAC,GACDC,QAAOxB,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgByB,SAAS,IAAI,IACpC;YAAEA,WAAWD,OAAOxB,OAAOK,OAAO,CAACoB,SAAS;QAAE,IAC9C,CAAC,GACDzB,EAAAA,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgB0B,cAAc,MAAK,OACnC;YAAEA,gBAAgB;QAAK,IACvB,CAAC,GACD1B,EAAAA,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgB2B,cAAc,MAAK,OACnC;YAAEA,gBAAgB;QAAK,IACvB,CAAC,GACDH,QAAOxB,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgB4B,eAAe,KAAK,IAC3C;YAAEA,iBAAiBJ,QAAOxB,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgB4B,eAAe;QAAE,IAC3D,CAAC,GAGD5B,EAAAA,mBAAAA,OAAOK,OAAO,qBAAdL,iBAAgB6B,SAAS,MAAK,OAAO;YAAEA,WAAW;QAAK,IAAI,CAAC;YAChEhB,OAAOC;YACPK;;IAEJ;IACA,OAAOrB;AACT;AAEA,eAAeH,yBAAwB"}

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

@@ -0,0 +1,130 @@
+/**
+ * @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.
+ */
+/**
+ * A/B experiments (AGL-252): docs at `hosts/{hostId}/experiments/{id}`.
+ * Assignment is deterministic — hash(visitorId + experimentId) buckets a
+ * visitor into a weighted variant, so the same visitor always sees the
+ * same variant with no server state. Exposures/conversions accumulate on
+ * per-variant stats counters via the track API. Business tier
+ * (`abTesting` flag).
+ */
+export type ExperimentStatus = 'draft' | 'running' | 'paused' | 'done';
+/** What the experiment varies. */
+export type ExperimentTarget = 'screen' | 'section' | 'email';
+export interface ExperimentVariant {
+    id: string;
+    name?: string;
+    /** Relative traffic weight; defaults to 1. */
+    weight?: number;
+    /** Screen experiments: the screen version this variant serves. */
+    versionId?: string;
+    /** Email experiments (AGL-255): subject/body overrides. */
+    subject?: string;
+    body?: string;
+}
+export interface HostExperiment {
+    name: string;
+    status: ExperimentStatus;
+    target: ExperimentTarget;
+    /** Screen/section experiments: the screen under test. */
+    screenId?: string;
+    /** Section experiments: canvas node id the variants swap. */
+    nodeId?: string;
+    variants: ExperimentVariant[];
+    /** Conversion goal: a host/site event, optionally filtered. */
+    goal?: {
+        event: string;
+        filter?: string;
+    };
+    /** Set when finished; the renderer then serves only the winner. */
+    winnerVariantId?: string;
+    /**
+     * Epoch millis (AGL-273): past this a running experiment stops serving
+     * variants (visitors get the default) until someone declares a winner.
+     */
+    endAtMs?: number;
+    /**
+     * Opt-in auto-completion (AGL-273): once every variant has
+     * `minExposures` and a challenger clears `confidence` (0..1) against
+     * the control, the track pipeline promotes it and finishes the
+     * experiment. Control wins when every challenger is confidently worse.
+     */
+    autoWinner?: {
+        minExposures: number;
+        confidence: number;
+    };
+    /** Set by the pipeline when `autoWinner` decided the experiment. */
+    autoCompleted?: boolean;
+}
+export declare const EXPERIMENT_MAX_VARIANTS = 4;
+/**
+ * Deterministic weighted assignment: the same visitor always lands in the
+ * same variant of an experiment. Finished experiments return the winner;
+ * non-running experiments without a winner return null (serve default).
+ */
+export declare function assignExperimentVariant(experiment: Pick<HostExperiment, 'status' | 'variants' | 'winnerVariantId' | 'endAtMs'> & {
+    $id?: string;
+}, experimentId: string, visitorId: string, nowMs?: number): ExperimentVariant | null;
+/** Validates an experiment doc shape; human-readable error or null. */
+export declare function validateExperiment(experiment: HostExperiment): string | null;
+/** Naive conversion-rate summary the results table renders. */
+export declare function summarizeVariantStats(stats: {
+    exposures?: number;
+    conversions?: number;
+}): {
+    exposures: number;
+    conversions: number;
+    rate: number;
+};
+export interface VariantComparison {
+    /** Relative conversion-rate lift vs the control; null when unmeasurable. */
+    lift: number | null;
+    /**
+     * One-sided confidence (0..1) that the challenger genuinely beats the
+     * control — a two-proportion z-test through the normal CDF. Null until
+     * both variants have exposures and at least one conversion exists.
+     */
+    confidence: number | null;
+}
+/**
+ * Compares a challenger variant against the control (AGL-265): lift =
+ * relative rate change; confidence = P(challenger > control) from a
+ * pooled two-proportion z-test. Small samples return null confidence
+ * rather than a misleading number.
+ */
+export declare function compareVariants(control: {
+    exposures?: number;
+    conversions?: number;
+}, challenger: {
+    exposures?: number;
+    conversions?: number;
+}): VariantComparison;
+/**
+ * Auto-winner evaluation (AGL-273): decides a running experiment from
+ * per-variant stats once thresholds are met. The first variant is the
+ * control. Undecidable states return null: any arm still under
+ * `minExposures`, or no challenger confidently better while some remain
+ * in the uncertain middle. Control wins only when every challenger is
+ * confidently worse (its win probability is below `1 - confidence`).
+ */
+export declare function evaluateAutoWinner(experiment: Pick<HostExperiment, 'status' | 'variants' | 'autoWinner'>, statsByVariant: Record<string, {
+    exposures?: number;
+    conversions?: number;
+} | undefined>): {
+    variantId: string;
+    confidence: number;
+} | null;

package/src/lib/model/experiments.js

@@ -0,0 +1,186 @@
+/**
+ * @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.
+ */ /**
+ * A/B experiments (AGL-252): docs at `hosts/{hostId}/experiments/{id}`.
+ * Assignment is deterministic — hash(visitorId + experimentId) buckets a
+ * visitor into a weighted variant, so the same visitor always sees the
+ * same variant with no server state. Exposures/conversions accumulate on
+ * per-variant stats counters via the track API. Business tier
+ * (`abTesting` flag).
+ */ export const EXPERIMENT_MAX_VARIANTS = 4;
+/** FNV-1a over the visitor+experiment key — stable, dependency-free. */ function bucketHash(value) {
+    let hash = 0x811c9dc5;
+    for(let index = 0; index < value.length; index += 1){
+        hash ^= value.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return hash >>> 0;
+}
+/**
+ * Deterministic weighted assignment: the same visitor always lands in the
+ * same variant of an experiment. Finished experiments return the winner;
+ * non-running experiments without a winner return null (serve default).
+ */ export function assignExperimentVariant(experiment, experimentId, visitorId, nowMs = Date.now()) {
+    var _experiment_variants;
+    const variants = ((_experiment_variants = experiment.variants) != null ? _experiment_variants : []).slice(0, EXPERIMENT_MAX_VARIANTS);
+    if (!variants.length) return null;
+    if (experiment.winnerVariantId) {
+        var _variants_find;
+        return (_variants_find = variants.find((variant)=>variant.id === experiment.winnerVariantId)) != null ? _variants_find : null;
+    }
+    if (experiment.status !== 'running') return null;
+    // Past the end date (AGL-273) visitors get the default until a winner
+    // is declared — stats stop accruing rather than drifting post-test.
+    if (experiment.endAtMs && nowMs > experiment.endAtMs) return null;
+    const totalWeight = variants.reduce((sum, variant)=>{
+        var _variant_weight;
+        return sum + Math.max(0, (_variant_weight = variant.weight) != null ? _variant_weight : 1);
+    }, 0);
+    if (totalWeight <= 0) return null;
+    const bucket = bucketHash(`${visitorId}:${experimentId}`) % totalWeight;
+    let cursor = 0;
+    for (const variant of variants){
+        var _variant_weight;
+        cursor += Math.max(0, (_variant_weight = variant.weight) != null ? _variant_weight : 1);
+        if (bucket < cursor) return variant;
+    }
+    return variants[variants.length - 1];
+}
+/** Validates an experiment doc shape; human-readable error or null. */ export function validateExperiment(experiment) {
+    var _experiment_variants;
+    var _experiment_name, _experiment_nodeId, _experiment_screenId;
+    if (!((_experiment_name = experiment.name) == null ? void 0 : _experiment_name.trim())) return 'Name the experiment';
+    if (![
+        'screen',
+        'section',
+        'email'
+    ].includes(experiment.target)) {
+        return 'Pick what the experiment tests';
+    }
+    const variants = (_experiment_variants = experiment.variants) != null ? _experiment_variants : [];
+    if (variants.length < 2) return 'Add at least two variants';
+    if (variants.length > EXPERIMENT_MAX_VARIANTS) {
+        return `Experiments are capped at ${EXPERIMENT_MAX_VARIANTS} variants`;
+    }
+    const ids = new Set(variants.map((variant)=>variant.id));
+    if (ids.size !== variants.length) return 'Variant ids must be unique';
+    if (experiment.target === 'section' && !((_experiment_nodeId = experiment.nodeId) == null ? void 0 : _experiment_nodeId.trim())) {
+        return 'Section experiments need the canvas element id';
+    }
+    if ((experiment.target === 'screen' || experiment.target === 'section') && !((_experiment_screenId = experiment.screenId) == null ? void 0 : _experiment_screenId.trim())) {
+        return 'Pick the screen under test';
+    }
+    if (experiment.autoWinner) {
+        const { minExposures, confidence } = experiment.autoWinner;
+        if (!Number.isFinite(minExposures) || minExposures < 1) {
+            return 'Auto-winner needs a minimum exposure count of at least 1';
+        }
+        if (!Number.isFinite(confidence) || confidence <= 0.5 || confidence >= 1) {
+            return 'Auto-winner confidence must be between 0.5 and 1';
+        }
+    }
+    return null;
+}
+/** Naive conversion-rate summary the results table renders. */ export function summarizeVariantStats(stats) {
+    var _stats_exposures, _stats_conversions;
+    const exposures = Math.max(0, (_stats_exposures = stats.exposures) != null ? _stats_exposures : 0);
+    const conversions = Math.max(0, (_stats_conversions = stats.conversions) != null ? _stats_conversions : 0);
+    return {
+        exposures,
+        conversions,
+        rate: exposures > 0 ? conversions / exposures : 0
+    };
+}
+/** Abramowitz–Stegun erf approximation (max error ~1.5e-7). */ function erf(x) {
+    const sign = x < 0 ? -1 : 1;
+    const t = 1 / (1 + 0.3275911 * Math.abs(x));
+    const y = 1 - ((((1.061405429 * t - 1.453152027) * t + 1.421413741) * t - 0.284496736) * t + 0.254829592) * t * Math.exp(-x * x);
+    return sign * y;
+}
+/** Standard normal CDF. */ function normalCdf(z) {
+    return 0.5 * (1 + erf(z / Math.SQRT2));
+}
+/**
+ * Compares a challenger variant against the control (AGL-265): lift =
+ * relative rate change; confidence = P(challenger > control) from a
+ * pooled two-proportion z-test. Small samples return null confidence
+ * rather than a misleading number.
+ */ export function compareVariants(control, challenger) {
+    const a = summarizeVariantStats(control);
+    const b = summarizeVariantStats(challenger);
+    const lift = a.rate > 0 ? (b.rate - a.rate) / a.rate : null;
+    if (a.exposures < 1 || b.exposures < 1 || a.conversions + b.conversions < 1) {
+        return {
+            lift,
+            confidence: null
+        };
+    }
+    const pooled = (a.conversions + b.conversions) / (a.exposures + b.exposures);
+    const standardError = Math.sqrt(pooled * (1 - pooled) * (1 / a.exposures + 1 / b.exposures));
+    if (!Number.isFinite(standardError) || standardError === 0) {
+        return {
+            lift,
+            confidence: null
+        };
+    }
+    const z = (b.rate - a.rate) / standardError;
+    return {
+        lift,
+        confidence: normalCdf(z)
+    };
+}
+/**
+ * Auto-winner evaluation (AGL-273): decides a running experiment from
+ * per-variant stats once thresholds are met. The first variant is the
+ * control. Undecidable states return null: any arm still under
+ * `minExposures`, or no challenger confidently better while some remain
+ * in the uncertain middle. Control wins only when every challenger is
+ * confidently worse (its win probability is below `1 - confidence`).
+ */ export function evaluateAutoWinner(experiment, statsByVariant) {
+    var _experiment_variants, _statsByVariant_variants__id, _controlStats_exposures;
+    const config = experiment.autoWinner;
+    if (!config || experiment.status !== 'running') return null;
+    const variants = ((_experiment_variants = experiment.variants) != null ? _experiment_variants : []).slice(0, EXPERIMENT_MAX_VARIANTS);
+    if (variants.length < 2) return null;
+    const controlStats = (_statsByVariant_variants__id = statsByVariant[variants[0].id]) != null ? _statsByVariant_variants__id : {};
+    if (((_controlStats_exposures = controlStats.exposures) != null ? _controlStats_exposures : 0) < config.minExposures) return null;
+    let best = null;
+    let everyLoses = true;
+    for (const challenger of variants.slice(1)){
+        var _statsByVariant_challenger_id, _challengerStats_exposures;
+        const challengerStats = (_statsByVariant_challenger_id = statsByVariant[challenger.id]) != null ? _statsByVariant_challenger_id : {};
+        if (((_challengerStats_exposures = challengerStats.exposures) != null ? _challengerStats_exposures : 0) < config.minExposures) return null;
+        const { confidence } = compareVariants(controlStats, challengerStats);
+        if (confidence === null) return null;
+        if (confidence >= config.confidence && (!best || confidence > best.confidence)) {
+            best = {
+                variantId: challenger.id,
+                confidence
+            };
+        }
+        if (confidence > 1 - config.confidence) everyLoses = false;
+    }
+    if (best) return best;
+    if (everyLoses) {
+        return {
+            variantId: variants[0].id,
+            confidence: config.confidence
+        };
+    }
+    return null;
+}
+
+//# sourceMappingURL=experiments.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/model/experiments.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 * A/B experiments (AGL-252): docs at `hosts/{hostId}/experiments/{id}`.\n * Assignment is deterministic — hash(visitorId + experimentId) buckets a\n * visitor into a weighted variant, so the same visitor always sees the\n * same variant with no server state. Exposures/conversions accumulate on\n * per-variant stats counters via the track API. Business tier\n * (`abTesting` flag).\n */\nexport type ExperimentStatus = 'draft' | 'running' | 'paused' | 'done'\n\n/** What the experiment varies. */\nexport type ExperimentTarget = 'screen' | 'section' | 'email'\n\nexport interface ExperimentVariant {\n  id: string\n  name?: string\n  /** Relative traffic weight; defaults to 1. */\n  weight?: number\n  /** Screen experiments: the screen version this variant serves. */\n  versionId?: string\n  /** Email experiments (AGL-255): subject/body overrides. */\n  subject?: string\n  body?: string\n}\n\nexport interface HostExperiment {\n  name: string\n  status: ExperimentStatus\n  target: ExperimentTarget\n  /** Screen/section experiments: the screen under test. */\n  screenId?: string\n  /** Section experiments: canvas node id the variants swap. */\n  nodeId?: string\n  variants: ExperimentVariant[]\n  /** Conversion goal: a host/site event, optionally filtered. */\n  goal?: { event: string; filter?: string }\n  /** Set when finished; the renderer then serves only the winner. */\n  winnerVariantId?: string\n  /**\n   * Epoch millis (AGL-273): past this a running experiment stops serving\n   * variants (visitors get the default) until someone declares a winner.\n   */\n  endAtMs?: number\n  /**\n   * Opt-in auto-completion (AGL-273): once every variant has\n   * `minExposures` and a challenger clears `confidence` (0..1) against\n   * the control, the track pipeline promotes it and finishes the\n   * experiment. Control wins when every challenger is confidently worse.\n   */\n  autoWinner?: { minExposures: number; confidence: number }\n  /** Set by the pipeline when `autoWinner` decided the experiment. */\n  autoCompleted?: boolean\n}\n\nexport const EXPERIMENT_MAX_VARIANTS = 4\n\n/** FNV-1a over the visitor+experiment key — stable, dependency-free. */\nfunction bucketHash(value: string): number {\n  let hash = 0x811c9dc5\n  for (let index = 0; index < value.length; index += 1) {\n    hash ^= value.charCodeAt(index)\n    hash = Math.imul(hash, 0x01000193)\n  }\n  return hash >>> 0\n}\n\n/**\n * Deterministic weighted assignment: the same visitor always lands in the\n * same variant of an experiment. Finished experiments return the winner;\n * non-running experiments without a winner return null (serve default).\n */\nexport function assignExperimentVariant(\n  experiment: Pick<\n    HostExperiment,\n    'status' | 'variants' | 'winnerVariantId' | 'endAtMs'\n  > & {\n    $id?: string\n  },\n  experimentId: string,\n  visitorId: string,\n  nowMs: number = Date.now(),\n): ExperimentVariant | null {\n  const variants = (experiment.variants ?? []).slice(\n    0,\n    EXPERIMENT_MAX_VARIANTS,\n  )\n  if (!variants.length) return null\n  if (experiment.winnerVariantId) {\n    return (\n      variants.find((variant) => variant.id === experiment.winnerVariantId) ??\n      null\n    )\n  }\n  if (experiment.status !== 'running') return null\n  // Past the end date (AGL-273) visitors get the default until a winner\n  // is declared — stats stop accruing rather than drifting post-test.\n  if (experiment.endAtMs && nowMs > experiment.endAtMs) return null\n  const totalWeight = variants.reduce(\n    (sum, variant) => sum + Math.max(0, variant.weight ?? 1),\n    0,\n  )\n  if (totalWeight <= 0) return null\n  const bucket = bucketHash(`${visitorId}:${experimentId}`) % totalWeight\n  let cursor = 0\n  for (const variant of variants) {\n    cursor += Math.max(0, variant.weight ?? 1)\n    if (bucket < cursor) return variant\n  }\n  return variants[variants.length - 1]\n}\n\n/** Validates an experiment doc shape; human-readable error or null. */\nexport function validateExperiment(\n  experiment: HostExperiment,\n): string | null {\n  if (!experiment.name?.trim()) return 'Name the experiment'\n  if (!['screen', 'section', 'email'].includes(experiment.target)) {\n    return 'Pick what the experiment tests'\n  }\n  const variants = experiment.variants ?? []\n  if (variants.length < 2) return 'Add at least two variants'\n  if (variants.length > EXPERIMENT_MAX_VARIANTS) {\n    return `Experiments are capped at ${EXPERIMENT_MAX_VARIANTS} variants`\n  }\n  const ids = new Set(variants.map((variant) => variant.id))\n  if (ids.size !== variants.length) return 'Variant ids must be unique'\n  if (experiment.target === 'section' && !experiment.nodeId?.trim()) {\n    return 'Section experiments need the canvas element id'\n  }\n  if (\n    (experiment.target === 'screen' || experiment.target === 'section') &&\n    !experiment.screenId?.trim()\n  ) {\n    return 'Pick the screen under test'\n  }\n  if (experiment.autoWinner) {\n    const { minExposures, confidence } = experiment.autoWinner\n    if (!Number.isFinite(minExposures) || minExposures < 1) {\n      return 'Auto-winner needs a minimum exposure count of at least 1'\n    }\n    if (!Number.isFinite(confidence) || confidence <= 0.5 || confidence >= 1) {\n      return 'Auto-winner confidence must be between 0.5 and 1'\n    }\n  }\n  return null\n}\n\n/** Naive conversion-rate summary the results table renders. */\nexport function summarizeVariantStats(stats: {\n  exposures?: number\n  conversions?: number\n}): { exposures: number; conversions: number; rate: number } {\n  const exposures = Math.max(0, stats.exposures ?? 0)\n  const conversions = Math.max(0, stats.conversions ?? 0)\n  return {\n    exposures,\n    conversions,\n    rate: exposures > 0 ? conversions / exposures : 0,\n  }\n}\n\nexport interface VariantComparison {\n  /** Relative conversion-rate lift vs the control; null when unmeasurable. */\n  lift: number | null\n  /**\n   * One-sided confidence (0..1) that the challenger genuinely beats the\n   * control — a two-proportion z-test through the normal CDF. Null until\n   * both variants have exposures and at least one conversion exists.\n   */\n  confidence: number | null\n}\n\n/** Abramowitz–Stegun erf approximation (max error ~1.5e-7). */\nfunction erf(x: number): number {\n  const sign = x < 0 ? -1 : 1\n  const t = 1 / (1 + 0.3275911 * Math.abs(x))\n  const y =\n    1 -\n    (((((1.061405429 * t - 1.453152027) * t) + 1.421413741) * t -\n      0.284496736) *\n      t +\n      0.254829592) *\n      t *\n      Math.exp(-x * x)\n  return sign * y\n}\n\n/** Standard normal CDF. */\nfunction normalCdf(z: number): number {\n  return 0.5 * (1 + erf(z / Math.SQRT2))\n}\n\n/**\n * Compares a challenger variant against the control (AGL-265): lift =\n * relative rate change; confidence = P(challenger > control) from a\n * pooled two-proportion z-test. Small samples return null confidence\n * rather than a misleading number.\n */\nexport function compareVariants(\n  control: { exposures?: number; conversions?: number },\n  challenger: { exposures?: number; conversions?: number },\n): VariantComparison {\n  const a = summarizeVariantStats(control)\n  const b = summarizeVariantStats(challenger)\n  const lift = a.rate > 0 ? (b.rate - a.rate) / a.rate : null\n  if (\n    a.exposures < 1 ||\n    b.exposures < 1 ||\n    a.conversions + b.conversions < 1\n  ) {\n    return { lift, confidence: null }\n  }\n  const pooled =\n    (a.conversions + b.conversions) / (a.exposures + b.exposures)\n  const standardError = Math.sqrt(\n    pooled * (1 - pooled) * (1 / a.exposures + 1 / b.exposures),\n  )\n  if (!Number.isFinite(standardError) || standardError === 0) {\n    return { lift, confidence: null }\n  }\n  const z = (b.rate - a.rate) / standardError\n  return { lift, confidence: normalCdf(z) }\n}\n\n/**\n * Auto-winner evaluation (AGL-273): decides a running experiment from\n * per-variant stats once thresholds are met. The first variant is the\n * control. Undecidable states return null: any arm still under\n * `minExposures`, or no challenger confidently better while some remain\n * in the uncertain middle. Control wins only when every challenger is\n * confidently worse (its win probability is below `1 - confidence`).\n */\nexport function evaluateAutoWinner(\n  experiment: Pick<HostExperiment, 'status' | 'variants' | 'autoWinner'>,\n  statsByVariant: Record<\n    string,\n    { exposures?: number; conversions?: number } | undefined\n  >,\n): { variantId: string; confidence: number } | null {\n  const config = experiment.autoWinner\n  if (!config || experiment.status !== 'running') return null\n  const variants = (experiment.variants ?? []).slice(\n    0,\n    EXPERIMENT_MAX_VARIANTS,\n  )\n  if (variants.length < 2) return null\n  const controlStats = statsByVariant[variants[0].id] ?? {}\n  if ((controlStats.exposures ?? 0) < config.minExposures) return null\n  let best: { variantId: string; confidence: number } | null = null\n  let everyLoses = true\n  for (const challenger of variants.slice(1)) {\n    const challengerStats = statsByVariant[challenger.id] ?? {}\n    if ((challengerStats.exposures ?? 0) < config.minExposures) return null\n    const { confidence } = compareVariants(controlStats, challengerStats)\n    if (confidence === null) return null\n    if (\n      confidence >= config.confidence &&\n      (!best || confidence > best.confidence)\n    ) {\n      best = { variantId: challenger.id, confidence }\n    }\n    if (confidence > 1 - config.confidence) everyLoses = false\n  }\n  if (best) return best\n  if (everyLoses) {\n    return { variantId: variants[0].id, confidence: config.confidence }\n  }\n  return null\n}\n"],"names":["EXPERIMENT_MAX_VARIANTS","bucketHash","value","hash","index","length","charCodeAt","Math","imul","assignExperimentVariant","experiment","experimentId","visitorId","nowMs","Date","now","variants","slice","winnerVariantId","find","variant","id","status","endAtMs","totalWeight","reduce","sum","max","weight","bucket","cursor","validateExperiment","name","trim","includes","target","ids","Set","map","size","nodeId","screenId","autoWinner","minExposures","confidence","Number","isFinite","summarizeVariantStats","stats","exposures","conversions","rate","erf","x","sign","t","abs","y","exp","normalCdf","z","SQRT2","compareVariants","control","challenger","a","b","lift","pooled","standardError","sqrt","evaluateAutoWinner","statsByVariant","controlStats","config","best","everyLoses","challengerStats","variantId"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;CAOC,GA+CD,OAAO,MAAMA,0BAA0B,EAAC;AAExC,sEAAsE,GACtE,SAASC,WAAWC,KAAa;IAC/B,IAAIC,OAAO;IACX,IAAK,IAAIC,QAAQ,GAAGA,QAAQF,MAAMG,MAAM,EAAED,SAAS,EAAG;QACpDD,QAAQD,MAAMI,UAAU,CAACF;QACzBD,OAAOI,KAAKC,IAAI,CAACL,MAAM;IACzB;IACA,OAAOA,SAAS;AAClB;AAEA;;;;CAIC,GACD,OAAO,SAASM,wBACdC,UAKC,EACDC,YAAoB,EACpBC,SAAiB,EACjBC,QAAgBC,KAAKC,GAAG,EAAE;QAERL;IAAlB,MAAMM,WAAW,EAACN,uBAAAA,WAAWM,QAAQ,YAAnBN,uBAAuB,EAAE,EAAEO,KAAK,CAChD,GACAjB;IAEF,IAAI,CAACgB,SAASX,MAAM,EAAE,OAAO;IAC7B,IAAIK,WAAWQ,eAAe,EAAE;YAE5BF;QADF,QACEA,iBAAAA,SAASG,IAAI,CAAC,CAACC,UAAYA,QAAQC,EAAE,KAAKX,WAAWQ,eAAe,aAApEF,iBACA;IAEJ;IACA,IAAIN,WAAWY,MAAM,KAAK,WAAW,OAAO;IAC5C,sEAAsE;IACtE,oEAAoE;IACpE,IAAIZ,WAAWa,OAAO,IAAIV,QAAQH,WAAWa,OAAO,EAAE,OAAO;IAC7D,MAAMC,cAAcR,SAASS,MAAM,CACjC,CAACC,KAAKN;YAA8BA;eAAlBM,MAAMnB,KAAKoB,GAAG,CAAC,IAAGP,kBAAAA,QAAQQ,MAAM,YAAdR,kBAAkB;OACtD;IAEF,IAAII,eAAe,GAAG,OAAO;IAC7B,MAAMK,SAAS5B,WAAW,GAAGW,UAAU,CAAC,EAAED,cAAc,IAAIa;IAC5D,IAAIM,SAAS;IACb,KAAK,MAAMV,WAAWJ,SAAU;YACRI;QAAtBU,UAAUvB,KAAKoB,GAAG,CAAC,IAAGP,kBAAAA,QAAQQ,MAAM,YAAdR,kBAAkB;QACxC,IAAIS,SAASC,QAAQ,OAAOV;IAC9B;IACA,OAAOJ,QAAQ,CAACA,SAASX,MAAM,GAAG,EAAE;AACtC;AAEA,qEAAqE,GACrE,OAAO,SAAS0B,mBACdrB,UAA0B;QAMTA;QAJZA,kBAWmCA,oBAKrCA;IAhBH,IAAI,GAACA,mBAAAA,WAAWsB,IAAI,qBAAftB,iBAAiBuB,IAAI,KAAI,OAAO;IACrC,IAAI,CAAC;QAAC;QAAU;QAAW;KAAQ,CAACC,QAAQ,CAACxB,WAAWyB,MAAM,GAAG;QAC/D,OAAO;IACT;IACA,MAAMnB,YAAWN,uBAAAA,WAAWM,QAAQ,YAAnBN,uBAAuB,EAAE;IAC1C,IAAIM,SAASX,MAAM,GAAG,GAAG,OAAO;IAChC,IAAIW,SAASX,MAAM,GAAGL,yBAAyB;QAC7C,OAAO,CAAC,0BAA0B,EAAEA,wBAAwB,SAAS,CAAC;IACxE;IACA,MAAMoC,MAAM,IAAIC,IAAIrB,SAASsB,GAAG,CAAC,CAAClB,UAAYA,QAAQC,EAAE;IACxD,IAAIe,IAAIG,IAAI,KAAKvB,SAASX,MAAM,EAAE,OAAO;IACzC,IAAIK,WAAWyB,MAAM,KAAK,aAAa,GAACzB,qBAAAA,WAAW8B,MAAM,qBAAjB9B,mBAAmBuB,IAAI,KAAI;QACjE,OAAO;IACT;IACA,IACE,AAACvB,CAAAA,WAAWyB,MAAM,KAAK,YAAYzB,WAAWyB,MAAM,KAAK,SAAQ,KACjE,GAACzB,uBAAAA,WAAW+B,QAAQ,qBAAnB/B,qBAAqBuB,IAAI,KAC1B;QACA,OAAO;IACT;IACA,IAAIvB,WAAWgC,UAAU,EAAE;QACzB,MAAM,EAAEC,YAAY,EAAEC,UAAU,EAAE,GAAGlC,WAAWgC,UAAU;QAC1D,IAAI,CAACG,OAAOC,QAAQ,CAACH,iBAAiBA,eAAe,GAAG;YACtD,OAAO;QACT;QACA,IAAI,CAACE,OAAOC,QAAQ,CAACF,eAAeA,cAAc,OAAOA,cAAc,GAAG;YACxE,OAAO;QACT;IACF;IACA,OAAO;AACT;AAEA,6DAA6D,GAC7D,OAAO,SAASG,sBAAsBC,KAGrC;QAC+BA,kBACEA;IADhC,MAAMC,YAAY1C,KAAKoB,GAAG,CAAC,IAAGqB,mBAAAA,MAAMC,SAAS,YAAfD,mBAAmB;IACjD,MAAME,cAAc3C,KAAKoB,GAAG,CAAC,IAAGqB,qBAAAA,MAAME,WAAW,YAAjBF,qBAAqB;IACrD,OAAO;QACLC;QACAC;QACAC,MAAMF,YAAY,IAAIC,cAAcD,YAAY;IAClD;AACF;AAaA,6DAA6D,GAC7D,SAASG,IAAIC,CAAS;IACpB,MAAMC,OAAOD,IAAI,IAAI,CAAC,IAAI;IAC1B,MAAME,IAAI,IAAK,CAAA,IAAI,YAAYhD,KAAKiD,GAAG,CAACH,EAAC;IACzC,MAAMI,IACJ,IACA,AAAC,CAAA,AAAC,CAAA,AAAC,CAAA,AAAE,CAAA,cAAcF,IAAI,WAAU,IAAKA,IAAK,WAAU,IAAKA,IACxD,WAAU,IACVA,IACA,WAAU,IACVA,IACAhD,KAAKmD,GAAG,CAAC,CAACL,IAAIA;IAClB,OAAOC,OAAOG;AAChB;AAEA,yBAAyB,GACzB,SAASE,UAAUC,CAAS;IAC1B,OAAO,MAAO,CAAA,IAAIR,IAAIQ,IAAIrD,KAAKsD,KAAK,CAAA;AACtC;AAEA;;;;;CAKC,GACD,OAAO,SAASC,gBACdC,OAAqD,EACrDC,UAAwD;IAExD,MAAMC,IAAIlB,sBAAsBgB;IAChC,MAAMG,IAAInB,sBAAsBiB;IAChC,MAAMG,OAAOF,EAAEd,IAAI,GAAG,IAAI,AAACe,CAAAA,EAAEf,IAAI,GAAGc,EAAEd,IAAI,AAAD,IAAKc,EAAEd,IAAI,GAAG;IACvD,IACEc,EAAEhB,SAAS,GAAG,KACdiB,EAAEjB,SAAS,GAAG,KACdgB,EAAEf,WAAW,GAAGgB,EAAEhB,WAAW,GAAG,GAChC;QACA,OAAO;YAAEiB;YAAMvB,YAAY;QAAK;IAClC;IACA,MAAMwB,SACJ,AAACH,CAAAA,EAAEf,WAAW,GAAGgB,EAAEhB,WAAW,AAAD,IAAMe,CAAAA,EAAEhB,SAAS,GAAGiB,EAAEjB,SAAS,AAAD;IAC7D,MAAMoB,gBAAgB9D,KAAK+D,IAAI,CAC7BF,SAAU,CAAA,IAAIA,MAAK,IAAM,CAAA,IAAIH,EAAEhB,SAAS,GAAG,IAAIiB,EAAEjB,SAAS,AAAD;IAE3D,IAAI,CAACJ,OAAOC,QAAQ,CAACuB,kBAAkBA,kBAAkB,GAAG;QAC1D,OAAO;YAAEF;YAAMvB,YAAY;QAAK;IAClC;IACA,MAAMgB,IAAI,AAACM,CAAAA,EAAEf,IAAI,GAAGc,EAAEd,IAAI,AAAD,IAAKkB;IAC9B,OAAO;QAAEF;QAAMvB,YAAYe,UAAUC;IAAG;AAC1C;AAEA;;;;;;;CAOC,GACD,OAAO,SAASW,mBACd7D,UAAsE,EACtE8D,cAGC;QAIiB9D,sBAKG8D,8BAChBC;IARL,MAAMC,SAAShE,WAAWgC,UAAU;IACpC,IAAI,CAACgC,UAAUhE,WAAWY,MAAM,KAAK,WAAW,OAAO;IACvD,MAAMN,WAAW,EAACN,uBAAAA,WAAWM,QAAQ,YAAnBN,uBAAuB,EAAE,EAAEO,KAAK,CAChD,GACAjB;IAEF,IAAIgB,SAASX,MAAM,GAAG,GAAG,OAAO;IAChC,MAAMoE,gBAAeD,+BAAAA,cAAc,CAACxD,QAAQ,CAAC,EAAE,CAACK,EAAE,CAAC,YAA9BmD,+BAAkC,CAAC;IACxD,IAAI,EAACC,0BAAAA,aAAaxB,SAAS,YAAtBwB,0BAA0B,KAAKC,OAAO/B,YAAY,EAAE,OAAO;IAChE,IAAIgC,OAAyD;IAC7D,IAAIC,aAAa;IACjB,KAAK,MAAMZ,cAAchD,SAASC,KAAK,CAAC,GAAI;YAClBuD,+BACnBK;QADL,MAAMA,mBAAkBL,gCAAAA,cAAc,CAACR,WAAW3C,EAAE,CAAC,YAA7BmD,gCAAiC,CAAC;QAC1D,IAAI,EAACK,6BAAAA,gBAAgB5B,SAAS,YAAzB4B,6BAA6B,KAAKH,OAAO/B,YAAY,EAAE,OAAO;QACnE,MAAM,EAAEC,UAAU,EAAE,GAAGkB,gBAAgBW,cAAcI;QACrD,IAAIjC,eAAe,MAAM,OAAO;QAChC,IACEA,cAAc8B,OAAO9B,UAAU,IAC9B,CAAA,CAAC+B,QAAQ/B,aAAa+B,KAAK/B,UAAU,AAAD,GACrC;YACA+B,OAAO;gBAAEG,WAAWd,WAAW3C,EAAE;gBAAEuB;YAAW;QAChD;QACA,IAAIA,aAAa,IAAI8B,OAAO9B,UAAU,EAAEgC,aAAa;IACvD;IACA,IAAID,MAAM,OAAOA;IACjB,IAAIC,YAAY;QACd,OAAO;YAAEE,WAAW9D,QAAQ,CAAC,EAAE,CAACK,EAAE;YAAEuB,YAAY8B,OAAO9B,UAAU;QAAC;IACpE;IACA,OAAO;AACT"}

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

@@ -0,0 +1,26 @@
+/**
+ * @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 domain model (AGL-412): overlays + experiments relocated from core app-utils.
+ * Context-free — importable by client components, /server handlers, and
+ * other plugins/apps via `@aglyn/plugins-marketing/model`.
+ */
+export * from './campaign-membership-figures';
+export * from './overlays';
+export * from './experiments';
+export * from './site-contract';
+export * from './compile-client-automations';

package/src/lib/model/index.js

@@ -0,0 +1,26 @@
+/**
+ * @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 domain model (AGL-412): overlays + experiments relocated from core app-utils.
+ * Context-free — importable by client components, /server handlers, and
+ * other plugins/apps via `@aglyn/plugins-marketing/model`.
+ */ export * from "./campaign-membership-figures.js";
+export * from "./overlays.js";
+export * from "./experiments.js";
+export * from "./site-contract.js";
+export * from "./compile-client-automations.js";
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/model/index.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Marketing domain model (AGL-412): overlays + experiments relocated from core app-utils.\n * Context-free — importable by client components, /server handlers, and\n * other plugins/apps via `@aglyn/plugins-marketing/model`.\n */\nexport * from './campaign-membership-figures'\nexport * from './overlays'\nexport * from './experiments'\nexport * from './site-contract'\nexport * from './compile-client-automations'\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;CAIC,GACD,cAAc,mCAA+B;AAC7C,cAAc,gBAAY;AAC1B,cAAc,mBAAe;AAC7B,cAAc,qBAAiB;AAC/B,cAAc,kCAA8B"}

package/src/lib/model/marketing-record-routes.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Called from the console registrar. The owner is named rather than read off
+ * the loader's marker, so the route registers the same way under a spec that
+ * calls the registrar directly.
+ */
+export declare function registerMarketingRecordRoutes(): void;

package/src/lib/model/marketing-record-routes.js

@@ -0,0 +1,46 @@
+/**
+ * @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 { buildRoute, Route } from "@aglyn/aglyn/app-utils/console-routes";
+import { registerPluginRecordRoute } from "@aglyn/aglyn/plugin-manager/plugin-record-routes";
+import { BUNDLE_ID } from "../constants/bundle-common.js";
+/**
+ * Where a campaign is read, published for every other surface.
+ *
+ * A message's template lists the campaigns its sends belonged to, and a
+ * campaign's pages are this plugin's. A surface elsewhere asks the
+ * record-route registry for `campaign` rather than spelling this plugin's nav
+ * slug, and gets `null` — text instead of a link — where this plugin is not
+ * loaded.
+ */ /** The nav slug the shell resolves this plugin's hub by. */ const MARKETING_SLUG = 'marketing';
+/**
+ * Called from the console registrar. The owner is named rather than read off
+ * the loader's marker, so the route registers the same way under a spec that
+ * calls the registrar directly.
+ */ export function registerMarketingRecordRoutes() {
+    registerPluginRecordRoute('campaign', {
+        // Campaigns belong to one site, so the organization has no address.
+        list: (context)=>context.host ? `${hub(context.orgSlug, context.host)}/campaigns` : null,
+        record: (context, id)=>context.host ? `${hub(context.orgSlug, context.host)}/campaigns/${id}` : null
+    }, {
+        pluginId: BUNDLE_ID
+    });
+}
+function hub(orgSlug, host) {
+    return buildRoute(Route.HOST_PLUGIN, {
+        orgSlug,
+        host,
+        pluginSlug: MARKETING_SLUG
+    });
+}
+
+//# sourceMappingURL=marketing-record-routes.js.map

package/src/lib/model/marketing-record-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/marketing/src/lib/model/marketing-record-routes.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\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 *   http://www.apache.org/licenses/LICENSE-2.0\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 */\nimport { buildRoute, Route } from '@aglyn/aglyn/app-utils/console-routes'\nimport { registerPluginRecordRoute } from '@aglyn/aglyn/plugin-manager/plugin-record-routes'\nimport { BUNDLE_ID } from '../constants/bundle-common'\n\n/**\n * Where a campaign is read, published for every other surface.\n *\n * A message's template lists the campaigns its sends belonged to, and a\n * campaign's pages are this plugin's. A surface elsewhere asks the\n * record-route registry for `campaign` rather than spelling this plugin's nav\n * slug, and gets `null` — text instead of a link — where this plugin is not\n * loaded.\n */\n\n/** The nav slug the shell resolves this plugin's hub by. */\nconst MARKETING_SLUG = 'marketing'\n\n/**\n * Called from the console registrar. The owner is named rather than read off\n * the loader's marker, so the route registers the same way under a spec that\n * calls the registrar directly.\n */\nexport function registerMarketingRecordRoutes(): void {\n  registerPluginRecordRoute(\n    'campaign',\n    {\n      // Campaigns belong to one site, so the organization has no address.\n      list: (context) =>\n        context.host\n          ? `${hub(context.orgSlug, context.host)}/campaigns`\n          : null,\n      record: (context, id) =>\n        context.host\n          ? `${hub(context.orgSlug, context.host)}/campaigns/${id}`\n          : null,\n    },\n    { pluginId: BUNDLE_ID },\n  )\n}\n\nfunction hub(orgSlug: string, host: string): string {\n  return buildRoute(Route.HOST_PLUGIN, {\n    orgSlug,\n    host,\n    pluginSlug: MARKETING_SLUG,\n  })\n}\n"],"names":["buildRoute","Route","registerPluginRecordRoute","BUNDLE_ID","MARKETING_SLUG","registerMarketingRecordRoutes","list","context","host","hub","orgSlug","record","id","pluginId","HOST_PLUGIN","pluginSlug"],"mappings":"AAAA;;;;;;;;;;;;CAYC,GACD,SAASA,UAAU,EAAEC,KAAK,QAAQ,wCAAuC;AACzE,SAASC,yBAAyB,QAAQ,mDAAkD;AAC5F,SAASC,SAAS,QAAQ,gCAA4B;AAEtD;;;;;;;;CAQC,GAED,0DAA0D,GAC1D,MAAMC,iBAAiB;AAEvB;;;;CAIC,GACD,OAAO,SAASC;IACdH,0BACE,YACA;QACE,oEAAoE;QACpEI,MAAM,CAACC,UACLA,QAAQC,IAAI,GACR,GAAGC,IAAIF,QAAQG,OAAO,EAAEH,QAAQC,IAAI,EAAE,UAAU,CAAC,GACjD;QACNG,QAAQ,CAACJ,SAASK,KAChBL,QAAQC,IAAI,GACR,GAAGC,IAAIF,QAAQG,OAAO,EAAEH,QAAQC,IAAI,EAAE,WAAW,EAAEI,IAAI,GACvD;IACR,GACA;QAAEC,UAAUV;IAAU;AAE1B;AAEA,SAASM,IAAIC,OAAe,EAAEF,IAAY;IACxC,OAAOR,WAAWC,MAAMa,WAAW,EAAE;QACnCJ;QACAF;QACAO,YAAYX;IACd;AACF"}

package/src/lib/model/overlay-copy.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @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 HostTokenSource } from '@aglyn/aglyn/app-utils/host-tokens';
+import { type HostVariable } from '@aglyn/aglyn/app-utils/variables';
+/**
+ * The fields of a bar or popup that hold copy: a bar's `text`, a popup's
+ * `headline` and `body`. Links, labels and colors are not copy and are never
+ * resolved.
+ */
+export declare const OVERLAY_COPY_FIELDS: readonly ["text", "headline", "body"];
+/**
+ * Overlay copy as a visitor reads it: an announcement bar's text, and a
+ * popup's headline and body.
+ *
+ * Every path that puts overlay copy in front of a visitor goes through this
+ * one function — the bar and popup a page shows on load, and a bar or popup an
+ * automation shows later — so the same overlay cannot read one way when it
+ * matches the page and another way when an automation opens it.
+ *
+ * The order is the one a page's own copy is resolved in: site variables
+ * (`{{var:id}}`) first, then the site's details (`{{host.*}}`). A variable
+ * whose document is gone renders as nothing, and so does a detail the site has
+ * not set; neither ever reaches a visitor as the token.
+ *
+ * Deep imports rather than either `@aglyn/aglyn` barrel: the server enricher
+ * and the console editors both import this module, and the client barrel
+ * carries React contexts a server graph must not load.
+ *
+ * @param variables - the site's variables keyed by document id, as
+ *   `getVariables` returns them.
+ * @param host - the site document the copy is published on.
+ */
+export declare function resolveOverlayCopy(text: string, variables: Record<string, HostVariable>, host: HostTokenSource | null | undefined): string;
+/**
+ * The tokens in stored overlay copy that a visitor would read exactly as
+ * typed: every token {@link resolveOverlayCopy} leaves in place.
+ *
+ * A bare `{{name}}` is one — nothing on a published page resolves that form,
+ * which is why an editor rewrites a name it recognizes to `{{var:id}}` before
+ * saving — and so is any token overlay copy has no source for, such as a
+ * function call or an entry field.
+ *
+ * Each token is put through the published page's own resolution rather than
+ * matched against a list of forms, so what an editor warns about cannot drift
+ * from what the page does. A variable whose document is gone and a detail the
+ * site has not set both render as nothing, and neither is listed.
+ */
+export declare function overlayCopyTokensShownAsTyped(text: string | undefined, variables: Record<string, HostVariable>, host: HostTokenSource | null | undefined): string[];

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

@@ -0,0 +1,78 @@
+/**
+ * @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 { resolveHostTokens } from "@aglyn/aglyn/app-utils/host-tokens";
+import { resolveBindings } from "@aglyn/aglyn/app-utils/variables";
+/**
+ * The fields of a bar or popup that hold copy: a bar's `text`, a popup's
+ * `headline` and `body`. Links, labels and colors are not copy and are never
+ * resolved.
+ */ export const OVERLAY_COPY_FIELDS = [
+    'text',
+    'headline',
+    'body'
+];
+/**
+ * Overlay copy as a visitor reads it: an announcement bar's text, and a
+ * popup's headline and body.
+ *
+ * Every path that puts overlay copy in front of a visitor goes through this
+ * one function — the bar and popup a page shows on load, and a bar or popup an
+ * automation shows later — so the same overlay cannot read one way when it
+ * matches the page and another way when an automation opens it.
+ *
+ * The order is the one a page's own copy is resolved in: site variables
+ * (`{{var:id}}`) first, then the site's details (`{{host.*}}`). A variable
+ * whose document is gone renders as nothing, and so does a detail the site has
+ * not set; neither ever reaches a visitor as the token.
+ *
+ * Deep imports rather than either `@aglyn/aglyn` barrel: the server enricher
+ * and the console editors both import this module, and the client barrel
+ * carries React contexts a server graph must not load.
+ *
+ * @param variables - the site's variables keyed by document id, as
+ *   `getVariables` returns them.
+ * @param host - the site document the copy is published on.
+ */ export function resolveOverlayCopy(text, variables, host) {
+    if (typeof text !== 'string' || !text.includes('{{')) return text;
+    return resolveHostTokens(resolveBindings(text, variables), host);
+}
+/** Any `{{…}}` token, whatever it names. */ const ANY_TOKEN_PATTERN = /\{\{[^{}]*\}\}/g;
+/**
+ * The tokens in stored overlay copy that a visitor would read exactly as
+ * typed: every token {@link resolveOverlayCopy} leaves in place.
+ *
+ * A bare `{{name}}` is one — nothing on a published page resolves that form,
+ * which is why an editor rewrites a name it recognizes to `{{var:id}}` before
+ * saving — and so is any token overlay copy has no source for, such as a
+ * function call or an entry field.
+ *
+ * Each token is put through the published page's own resolution rather than
+ * matched against a list of forms, so what an editor warns about cannot drift
+ * from what the page does. A variable whose document is gone and a detail the
+ * site has not set both render as nothing, and neither is listed.
+ */ export function overlayCopyTokensShownAsTyped(text, variables, host) {
+    var _text_match;
+    if (typeof text !== 'string' || !text.includes('{{')) return [];
+    const shown = new Set();
+    for (const token of (_text_match = text.match(ANY_TOKEN_PATTERN)) != null ? _text_match : []){
+        if (resolveOverlayCopy(token, variables, host) === token) shown.add(token);
+    }
+    return [
+        ...shown
+    ];
+}
+
+//# sourceMappingURL=overlay-copy.js.map