@sonordev/contracts 2.17.0 → 2.20.0

package/dist/broadcast-layouts.d.ts

@@ -85,6 +85,14 @@ export declare const BROADCAST_STYLES: readonly ['glass', 'editorial', 'poster',
 export type BroadcastStyleId = (typeof BROADCAST_STYLES)[number];
 export declare const DEFAULT_BROADCAST_STYLE: BroadcastStyleId;
 export declare const isBroadcastStyleId: (value: unknown) => value is BroadcastStyleId;
+/** Explicit per-review photo presentation; absence keeps the existing automatic layout. */
+export declare const REVIEW_PHOTO_PRESENTATIONS: readonly ['background'];
+export type ReviewPhotoPresentation = (typeof REVIEW_PHOTO_PRESENTATIONS)[number];
+/**
+ * A supported explicit photo presentation. Optional input boundaries handle
+ * omission (preserve) and null (clear) separately; neither is an explicit value.
+ */
+export declare const isReviewPhotoPresentation: (value: unknown) => value is ReviewPhotoPresentation;
 /**
  * The review compositions Broadcast draws: `signature` (photo up top, the
  * quote low) and `frame` (centered). Order matters: a review whose v1 draw

package/dist/broadcast-layouts.js

@@ -29,6 +29,8 @@ var SAVED_PUBLICATION_CARD_LAYOUTS = [AUTO_CARD_LAYOUT, ...CARD_LAYOUTS];
 var BROADCAST_STYLES = ["glass", "editorial", "poster", "cinematic", "blueprint", "focus"];
 var DEFAULT_BROADCAST_STYLE = "glass";
 var isBroadcastStyleId = (value) => typeof value === "string" && BROADCAST_STYLES.includes(value);
+var REVIEW_PHOTO_PRESENTATIONS = ["background"];
+var isReviewPhotoPresentation = (value) => typeof value === "string" && REVIEW_PHOTO_PRESENTATIONS.includes(value);
 var REVIEW_CARD_VARIATIONS = ["signature", "frame"];
 var DEFAULT_REVIEW_CARD_VARIATION = "signature";
 var RETIRED_REVIEW_CARD_VARIATIONS = {
@@ -71,12 +73,14 @@ exports.REVIEW_CARD_VARIATIONS = REVIEW_CARD_VARIATIONS;
 exports.REVIEW_CARD_VARIATION_LABELS = REVIEW_CARD_VARIATION_LABELS;
 exports.REVIEW_CARD_VARIATION_OPTIONS = REVIEW_CARD_VARIATION_OPTIONS;
 exports.REVIEW_CARD_VARIATION_V1_DRAW = REVIEW_CARD_VARIATION_V1_DRAW;
+exports.REVIEW_PHOTO_PRESENTATIONS = REVIEW_PHOTO_PRESENTATIONS;
 exports.SAVED_PUBLICATION_CARD_LAYOUTS = SAVED_PUBLICATION_CARD_LAYOUTS;
 exports.isArticleCoverLayoutId = isArticleCoverLayoutId;
 exports.isBroadcastStyleId = isBroadcastStyleId;
 exports.isCardLayoutId = isCardLayoutId;
 exports.isRetiredCardLayoutId = isRetiredCardLayoutId;
 exports.isReviewCardVariation = isReviewCardVariation;
+exports.isReviewPhotoPresentation = isReviewPhotoPresentation;
 exports.normalizeArticleCoverLayout = normalizeArticleCoverLayout;
 exports.normalizeReviewCardVariation = normalizeReviewCardVariation;
 exports.reviewCardVariationFromDigest = reviewCardVariationFromDigest;

package/dist/broadcast-layouts.mjs

@@ -27,6 +27,8 @@ var SAVED_PUBLICATION_CARD_LAYOUTS = [AUTO_CARD_LAYOUT, ...CARD_LAYOUTS];
 var BROADCAST_STYLES = ["glass", "editorial", "poster", "cinematic", "blueprint", "focus"];
 var DEFAULT_BROADCAST_STYLE = "glass";
 var isBroadcastStyleId = (value) => typeof value === "string" && BROADCAST_STYLES.includes(value);
+var REVIEW_PHOTO_PRESENTATIONS = ["background"];
+var isReviewPhotoPresentation = (value) => typeof value === "string" && REVIEW_PHOTO_PRESENTATIONS.includes(value);
 var REVIEW_CARD_VARIATIONS = ["signature", "frame"];
 var DEFAULT_REVIEW_CARD_VARIATION = "signature";
 var RETIRED_REVIEW_CARD_VARIATIONS = {
@@ -53,4 +55,4 @@ function reviewCardVariationFromDigest(digest) {
   return isReviewCardVariation(drawn) ? drawn : REVIEW_CARD_VARIATIONS[uint32BE(digest, 4) % REVIEW_CARD_VARIATIONS.length];
 }
 
-export { ARTICLE_COVER_LAYOUTS, AUTO_CARD_LAYOUT, BROADCAST_LAYOUTS_CONTRACT_VERSION, BROADCAST_STYLES, CARD_LAYOUTS, CARD_LAYOUT_LABELS, CARD_LAYOUT_OPTIONS, DEFAULT_BROADCAST_STYLE, DEFAULT_REVIEW_CARD_VARIATION, PUBLICATION_CARD_LAYOUTS, RETIRED_CARD_LAYOUTS, RETIRED_REVIEW_CARD_VARIATIONS, REVIEW_CARD_VARIATIONS, REVIEW_CARD_VARIATION_LABELS, REVIEW_CARD_VARIATION_OPTIONS, REVIEW_CARD_VARIATION_V1_DRAW, SAVED_PUBLICATION_CARD_LAYOUTS, isArticleCoverLayoutId, isBroadcastStyleId, isCardLayoutId, isRetiredCardLayoutId, isReviewCardVariation, normalizeArticleCoverLayout, normalizeReviewCardVariation, reviewCardVariationFromDigest, reviewCompositionSeed };
+export { ARTICLE_COVER_LAYOUTS, AUTO_CARD_LAYOUT, BROADCAST_LAYOUTS_CONTRACT_VERSION, BROADCAST_STYLES, CARD_LAYOUTS, CARD_LAYOUT_LABELS, CARD_LAYOUT_OPTIONS, DEFAULT_BROADCAST_STYLE, DEFAULT_REVIEW_CARD_VARIATION, PUBLICATION_CARD_LAYOUTS, RETIRED_CARD_LAYOUTS, RETIRED_REVIEW_CARD_VARIATIONS, REVIEW_CARD_VARIATIONS, REVIEW_CARD_VARIATION_LABELS, REVIEW_CARD_VARIATION_OPTIONS, REVIEW_CARD_VARIATION_V1_DRAW, REVIEW_PHOTO_PRESENTATIONS, SAVED_PUBLICATION_CARD_LAYOUTS, isArticleCoverLayoutId, isBroadcastStyleId, isCardLayoutId, isRetiredCardLayoutId, isReviewCardVariation, isReviewPhotoPresentation, normalizeArticleCoverLayout, normalizeReviewCardVariation, reviewCardVariationFromDigest, reviewCompositionSeed };

package/dist/decision-roles.d.ts

@@ -0,0 +1,39 @@
+/**
+ * What a job title says about a person's part in a buying decision. Single
+ * source of truth for the site-people scan: the Sonor API's deterministic scan
+ * (JSON-LD persons) and Signal's site-people scout both read this map, so the
+ * same person can't be an influencer on one side and an owner on the other.
+ *
+ * The role is never a model's opinion. A model finds the people; the title the
+ * page gives them decides the role, by the rules below, in this order (first
+ * match wins):
+ *
+ *   gatekeeper      someone who works for a person, whatever that person's
+ *                   title is: "Executive Assistant to the President",
+ *                   "Receptionist"
+ *   decision_maker  a vice president, matched before the president rule can
+ *                   claim the word
+ *   owner           owner, founder, president, CEO, a managing, senior, name
+ *                   or equity partner, a lone "Partner", and "Principal"
+ *                   unless it names a job ("Principal Engineer")
+ *   decision_maker  a chief of something that isn't the CEO, a general
+ *                   manager (or GM), a director, an operations or project
+ *                   manager, an estimator, a superintendent
+ *   gatekeeper      an office manager, an administrator
+ *   influencer      marketing, HR, recruiting, sales, business development
+ *   gatekeeper      a coordinator, last of all
+ *
+ * So "Vice President of Sales" is a decision maker (not an owner because it
+ * says president, not an influencer because it says sales), "Marketing
+ * Director" is a decision maker (director beats marketing) and "Marketing
+ * Coordinator" is an influencer. A title that names none of these
+ * ("Technician", a bare "Manager") has no role: no guess.
+ *
+ * Pure data and one small function, no dependencies. The four role values are
+ * stored and sent, so they never change.
+ */
+/** The four parts a person can play in a buying decision, strongest first. */
+export declare const DECISION_ROLES: readonly ['owner', 'decision_maker', 'influencer', 'gatekeeper'];
+export type DecisionRole = (typeof DECISION_ROLES)[number];
+/** The buying role a job title says, or null when it says none ("Technician", "Manager", no title). */
+export declare function decisionRoleForTitle(title: string | null | undefined): DecisionRole | null;

package/dist/decision-roles.js

@@ -0,0 +1,31 @@
+'use strict';
+
+// src/contracts/decision-roles.ts
+var DECISION_ROLES = ["owner", "decision_maker", "influencer", "gatekeeper"];
+var MAX_TITLE_LENGTH = 200;
+var RULES = [
+  // Someone who works for a person, whatever that person's title is.
+  [/\b(?:executive|administrative|admin|office|personal)\s+assistant\b|\bassistant to\b|\bsecretary\b|\breceptionist\b|\bfront desk\b/, "gatekeeper"],
+  // A vice president before the president rule below can claim the word.
+  [/\b(?:vice[ -]president|vp|svp|evp|avp)\b/, "decision_maker"],
+  [
+    /\b(?:owner|co-?owner|founder|co-?founder|proprietor|president|ceo|chief executive(?: officer)?|managing partner|senior partner|name partner|equity partner)\b|\bprincipal\b(?!\s+(?:engineer|architect|consultant|designer|developer|analyst))|^partner$/,
+    "owner"
+  ],
+  // Chief of something else (not the CEO, matched above).
+  [/\bchief\b.*\bofficer\b|\b(?:coo|cfo|cto|cmo)\b/, "decision_maker"],
+  [/\b(?:general manager|gm|director|operations manager|estimator|estimating manager|project manager|superintendent)\b/, "decision_maker"],
+  [/\boffice manager\b|\badministrat(?:or|ive)\b|\badmin\b/, "gatekeeper"],
+  [/\b(?:marketing|hr|human resources|recruit(?:er|ing)|talent acquisition|sales|business development)\b/, "influencer"],
+  [/\bcoordinator\b/, "gatekeeper"]
+];
+function decisionRoleForTitle(title) {
+  if (typeof title !== "string") return null;
+  const t = title.slice(0, MAX_TITLE_LENGTH).toLowerCase().replace(/&/g, " and ").replace(/\./g, "").replace(/\s+/g, " ").trim();
+  if (!t) return null;
+  for (const [pattern, role] of RULES) if (pattern.test(t)) return role;
+  return null;
+}
+
+exports.DECISION_ROLES = DECISION_ROLES;
+exports.decisionRoleForTitle = decisionRoleForTitle;

package/dist/decision-roles.mjs

@@ -0,0 +1,28 @@
+// src/contracts/decision-roles.ts
+var DECISION_ROLES = ["owner", "decision_maker", "influencer", "gatekeeper"];
+var MAX_TITLE_LENGTH = 200;
+var RULES = [
+  // Someone who works for a person, whatever that person's title is.
+  [/\b(?:executive|administrative|admin|office|personal)\s+assistant\b|\bassistant to\b|\bsecretary\b|\breceptionist\b|\bfront desk\b/, "gatekeeper"],
+  // A vice president before the president rule below can claim the word.
+  [/\b(?:vice[ -]president|vp|svp|evp|avp)\b/, "decision_maker"],
+  [
+    /\b(?:owner|co-?owner|founder|co-?founder|proprietor|president|ceo|chief executive(?: officer)?|managing partner|senior partner|name partner|equity partner)\b|\bprincipal\b(?!\s+(?:engineer|architect|consultant|designer|developer|analyst))|^partner$/,
+    "owner"
+  ],
+  // Chief of something else (not the CEO, matched above).
+  [/\bchief\b.*\bofficer\b|\b(?:coo|cfo|cto|cmo)\b/, "decision_maker"],
+  [/\b(?:general manager|gm|director|operations manager|estimator|estimating manager|project manager|superintendent)\b/, "decision_maker"],
+  [/\boffice manager\b|\badministrat(?:or|ive)\b|\badmin\b/, "gatekeeper"],
+  [/\b(?:marketing|hr|human resources|recruit(?:er|ing)|talent acquisition|sales|business development)\b/, "influencer"],
+  [/\bcoordinator\b/, "gatekeeper"]
+];
+function decisionRoleForTitle(title) {
+  if (typeof title !== "string") return null;
+  const t = title.slice(0, MAX_TITLE_LENGTH).toLowerCase().replace(/&/g, " and ").replace(/\./g, "").replace(/\s+/g, " ").trim();
+  if (!t) return null;
+  for (const [pattern, role] of RULES) if (pattern.test(t)) return role;
+  return null;
+}
+
+export { DECISION_ROLES, decisionRoleForTitle };

package/dist/funnels.d.ts

@@ -152,6 +152,27 @@ export interface PublishedFunnelPage {
     tracking: {
         campaignSlug: string;
     };
+    /** Optional reviewed content only. Requires a compatible installed renderer;
+     * older strict page parsers reject this field. No assignment/publication grant. */
+    experimentContent?: FunnelExperimentContentManifest;
+}
+export interface FunnelExperimentContentManifest {
+    schemaVersion: 1;
+    kind: 'funnel_experiment_content_v1';
+    experimentId: string;
+    experimentRevision: number;
+    goalRevision: string;
+    controlVariantKey: string;
+    /** contentDigest covers effective FULL content, including the fixed base offer.
+     * Native funnelHash owns canonical hashing; this parser checks digest shape only. */
+    variants: Array<{
+        variantKey: string;
+        content: {
+            headline: string;
+            body: FunnelBodyBlock[];
+        };
+        contentDigest: string;
+    }>;
 }
 export interface FunnelOperationReceipt {
     operationId: string;
@@ -276,6 +297,24 @@ export declare const FUNNEL_DEFINITION_JSON_SCHEMA: {
     readonly oneOf?: readonly Shape[];
     readonly $schema: 'http://json-schema.org/draft-07/schema#';
 };
+export declare const FUNNEL_EXPERIMENT_CONTENT_JSON_SCHEMA: {
+    readonly type?: 'object' | 'array' | 'string' | 'integer' | 'boolean' | 'null';
+    readonly properties?: Record<string, Shape>;
+    readonly required?: readonly string[];
+    readonly additionalProperties?: false;
+    readonly items?: Shape;
+    readonly minItems?: number;
+    readonly maxItems?: number;
+    readonly minLength?: number;
+    readonly maxLength?: number;
+    readonly pattern?: string;
+    readonly minimum?: number;
+    readonly maximum?: number;
+    readonly enum?: readonly unknown[];
+    readonly const?: unknown;
+    readonly oneOf?: readonly Shape[];
+    readonly $schema: 'http://json-schema.org/draft-07/schema#';
+};
 export declare const PUBLISHED_FUNNEL_PAGE_JSON_SCHEMA: {
     readonly type?: 'object' | 'array' | 'string' | 'integer' | 'boolean' | 'null';
     readonly properties?: Record<string, Shape>;
@@ -306,6 +345,13 @@ export declare function isSafeFunnelPublicUrl(value: string): boolean;
 export declare function managedFunnelPath(value: string): string;
 export declare function parseFunnelDefinition(value: unknown): FunnelDefinition;
 export declare function parsePublishedFunnelPage(value: unknown): PublishedFunnelPage;
+/** Shape/content checks only. Native owners verify the complete original Signal
+ * variant set and hash each effective FULL content with existing funnelHash. */
+export declare function parseFunnelExperimentContent(value: unknown): FunnelExperimentContentManifest;
+/** One effective-content composition for native hashing and existing rendering.
+ * Offer and all page identity/form/brand/tracking fields stay on the base page;
+ * a client-provided digest or key grants no native permission. */
+export declare function resolveFunnelExperimentContent(value: unknown, variantKey: string): PublishedFunnelPage['content'];
 export declare function parseFunnelLaunchArgs(value: unknown): FunnelLaunchArgs;
 export declare function parseFunnelLifecycleArgs(value: unknown, operation?: 'pause' | 'resume' | 'rollback'): FunnelLifecycleArgs;
 /** Apply presentation-only overrides to an already resolved canonical brand. Null means inherit. */

package/dist/funnels.js

@@ -82,6 +82,7 @@ var integer = (minimum, maximum = Number.MAX_SAFE_INTEGER) => ({ type: "integer"
 var nullable = (shape) => ({ oneOf: [shape, { type: "null" }] });
 var isoDate = { type: "string", pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?Z$" };
 var uuid = { type: "string", pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$" };
+var fingerprint = { type: "string", pattern: "^[a-f0-9]{64}$" };
 var slug = { ...string(80), pattern: "^[a-z0-9]+(?:-[a-z0-9]+)*$" };
 var fieldSlug = { ...string(80), pattern: "^[a-zA-Z0-9_-]+$" };
 var path = { ...string(512), pattern: "^/(?!/)[a-zA-Z0-9/_-]*$" };
@@ -99,6 +100,16 @@ var override = object({
 }, []);
 var bodyBlock = { oneOf: [object({ type: literal("paragraph"), text: string(2e3) }), object({ type: literal("bullets"), items: array(string(500), 8, 1) })] };
 var body = array(bodyBlock, 12);
+var publishedContentFields = { headline: string(160), body };
+var experimentContentShape = object({
+  schemaVersion: literal(1),
+  kind: literal("funnel_experiment_content_v1"),
+  experimentId: uuid,
+  experimentRevision: integer(1),
+  goalRevision: { ...string(128), pattern: "^[a-zA-Z0-9._:-]+$" },
+  controlVariantKey: string(80),
+  variants: array(object({ variantKey: string(80), content: object(publishedContentFields), contentDigest: fingerprint }), 50, 2)
+});
 var publicBrand = object({ displayName: string(120), tagline: string(300, 0), fullLogoUrl: nullable(string(2048)), squareLogoUrl: nullable(string(2048)), colors, typography, scheme: enumeration("light", "dark") });
 var step = { oneOf: [
   object({ id: uuid, type: literal("wait"), durationSeconds: integer(60, 2592e3) }),
@@ -178,11 +189,13 @@ var publishedShape = object({
   revision: integer(1),
   site,
   path,
-  content: object({ headline: string(160), body, offer: object({ label: string(120), href: string(2048) }) }, ["headline", "body"]),
+  content: object({ ...publishedContentFields, offer: object({ label: string(120), href: string(2048) }) }, ["headline", "body"]),
   brand: publicBrand,
   conversion: object({ formSlug: fieldSlug }),
-  tracking: object({ campaignSlug: slug })
-});
+  tracking: object({ campaignSlug: slug }),
+  experimentContent: experimentContentShape
+}, ["schemaVersion", "id", "versionId", "revision", "site", "path", "content", "brand", "conversion", "tracking"]);
+var FUNNEL_EXPERIMENT_CONTENT_JSON_SCHEMA = { $schema: "http://json-schema.org/draft-07/schema#", ...experimentContentShape };
 var PUBLISHED_FUNNEL_PAGE_JSON_SCHEMA = { $schema: "http://json-schema.org/draft-07/schema#", ...publishedShape };
 var FUNNEL_LAUNCH_JSON_SCHEMA = object({ expectedRevision: integer(1), previewId: uuid, idempotencyKey: string(200), confirm: literal(true) });
 var FUNNEL_LIFECYCLE_JSON_SCHEMA = object({ expectedActiveVersionId: uuid, idempotencyKey: string(200), confirm: literal(true) });
@@ -285,8 +298,24 @@ function parsePublishedFunnelPage(value) {
   checkFonts(result.brand, "page.brand");
   checkBody(result.content.body, "page.content.body");
   if (result.content.offer && !isSafeFunnelPublicUrl(result.content.offer.href)) fail("page.content.offer.href", "unsafe public URL");
+  if (result.experimentContent) result.experimentContent = parseFunnelExperimentContent(result.experimentContent);
   return result;
 }
+function parseFunnelExperimentContent(value) {
+  check(value, experimentContentShape, "experimentContent");
+  const result = JSON.parse(JSON.stringify(value));
+  const keys = result.variants.map((v) => v.variantKey);
+  if (new Set(keys).size !== keys.length) fail("experimentContent.variants", "variant keys must be unique");
+  if (!keys.includes(result.controlVariantKey)) fail("experimentContent.controlVariantKey", "must identify an existing reviewed variant");
+  result.variants.forEach((variant, i) => checkBody(variant.content.body, `experimentContent.variants[${i}].content.body`));
+  return result;
+}
+function resolveFunnelExperimentContent(value, variantKey) {
+  const page = parsePublishedFunnelPage(value);
+  const variant = page.experimentContent?.variants.find((v) => v.variantKey === variantKey);
+  if (!variant) fail("page.experimentContent.variants", "an existing reviewed variant is required");
+  return { ...page.content, headline: variant.content.headline, body: variant.content.body };
+}
 function parseFunnelLaunchArgs(value) {
   check(value, FUNNEL_LAUNCH_JSON_SCHEMA, "launch");
   return JSON.parse(JSON.stringify(value));
@@ -351,7 +380,6 @@ function parseFunnelRetryArgs(value) {
   check(value, FUNNEL_RETRY_JSON_SCHEMA, "retry");
   return JSON.parse(JSON.stringify(value));
 }
-var fingerprint = { type: "string", pattern: "^[a-f0-9]{64}$" };
 var issue = object({ code: { ...string(80), pattern: "^[A-Z][A-Z0-9_]*$" }, path: string(300), message: string(500), fixRef: object({ section: string(80), field: string(80), resourceId: uuid }, ["section"]) }, ["code", "path", "message"]);
 var FUNNEL_READINESS_JSON_SCHEMA = object({ definitionRevision: integer(1), brandFingerprint: fingerprint, resourceFingerprint: fingerprint, ready: { type: "boolean" }, blockers: array(issue, 50), warnings: array(issue, 50), capabilities: object({ managedPage: { type: "boolean" } }) });
 function parseFunnelReadiness(value) {
@@ -567,6 +595,7 @@ exports.FUNNEL_DETAIL_JSON_SCHEMA = FUNNEL_DETAIL_JSON_SCHEMA;
 exports.FUNNEL_DRAFT_DEFINITION_JSON_SCHEMA = FUNNEL_DRAFT_DEFINITION_JSON_SCHEMA;
 exports.FUNNEL_DRAFT_JSON_SCHEMAS = FUNNEL_DRAFT_JSON_SCHEMAS;
 exports.FUNNEL_ENROLLMENT_JSON_SCHEMA = FUNNEL_ENROLLMENT_JSON_SCHEMA;
+exports.FUNNEL_EXPERIMENT_CONTENT_JSON_SCHEMA = FUNNEL_EXPERIMENT_CONTENT_JSON_SCHEMA;
 exports.FUNNEL_LAUNCH_EVIDENCE_JSON_SCHEMA = FUNNEL_LAUNCH_EVIDENCE_JSON_SCHEMA;
 exports.FUNNEL_LAUNCH_JSON_SCHEMA = FUNNEL_LAUNCH_JSON_SCHEMA;
 exports.FUNNEL_LIFECYCLE_JSON_SCHEMA = FUNNEL_LIFECYCLE_JSON_SCHEMA;
@@ -600,6 +629,7 @@ exports.parseFunnelDetail = parseFunnelDetail;
 exports.parseFunnelDraftArgs = parseFunnelDraftArgs;
 exports.parseFunnelDraftDefinition = parseFunnelDraftDefinition;
 exports.parseFunnelEnrollmentSummary = parseFunnelEnrollmentSummary;
+exports.parseFunnelExperimentContent = parseFunnelExperimentContent;
 exports.parseFunnelLaunchArgs = parseFunnelLaunchArgs;
 exports.parseFunnelLaunchEvidence = parseFunnelLaunchEvidence;
 exports.parseFunnelLifecycleArgs = parseFunnelLifecycleArgs;
@@ -615,3 +645,4 @@ exports.parseFunnelSummary = parseFunnelSummary;
 exports.parseFunnelTimeline = parseFunnelTimeline;
 exports.parseFunnelUpdateArgs = parseFunnelUpdateArgs;
 exports.parsePublishedFunnelPage = parsePublishedFunnelPage;
+exports.resolveFunnelExperimentContent = resolveFunnelExperimentContent;

package/dist/funnels.mjs

@@ -80,6 +80,7 @@ var integer = (minimum, maximum = Number.MAX_SAFE_INTEGER) => ({ type: "integer"
 var nullable = (shape) => ({ oneOf: [shape, { type: "null" }] });
 var isoDate = { type: "string", pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?Z$" };
 var uuid = { type: "string", pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$" };
+var fingerprint = { type: "string", pattern: "^[a-f0-9]{64}$" };
 var slug = { ...string(80), pattern: "^[a-z0-9]+(?:-[a-z0-9]+)*$" };
 var fieldSlug = { ...string(80), pattern: "^[a-zA-Z0-9_-]+$" };
 var path = { ...string(512), pattern: "^/(?!/)[a-zA-Z0-9/_-]*$" };
@@ -97,6 +98,16 @@ var override = object({
 }, []);
 var bodyBlock = { oneOf: [object({ type: literal("paragraph"), text: string(2e3) }), object({ type: literal("bullets"), items: array(string(500), 8, 1) })] };
 var body = array(bodyBlock, 12);
+var publishedContentFields = { headline: string(160), body };
+var experimentContentShape = object({
+  schemaVersion: literal(1),
+  kind: literal("funnel_experiment_content_v1"),
+  experimentId: uuid,
+  experimentRevision: integer(1),
+  goalRevision: { ...string(128), pattern: "^[a-zA-Z0-9._:-]+$" },
+  controlVariantKey: string(80),
+  variants: array(object({ variantKey: string(80), content: object(publishedContentFields), contentDigest: fingerprint }), 50, 2)
+});
 var publicBrand = object({ displayName: string(120), tagline: string(300, 0), fullLogoUrl: nullable(string(2048)), squareLogoUrl: nullable(string(2048)), colors, typography, scheme: enumeration("light", "dark") });
 var step = { oneOf: [
   object({ id: uuid, type: literal("wait"), durationSeconds: integer(60, 2592e3) }),
@@ -176,11 +187,13 @@ var publishedShape = object({
   revision: integer(1),
   site,
   path,
-  content: object({ headline: string(160), body, offer: object({ label: string(120), href: string(2048) }) }, ["headline", "body"]),
+  content: object({ ...publishedContentFields, offer: object({ label: string(120), href: string(2048) }) }, ["headline", "body"]),
   brand: publicBrand,
   conversion: object({ formSlug: fieldSlug }),
-  tracking: object({ campaignSlug: slug })
-});
+  tracking: object({ campaignSlug: slug }),
+  experimentContent: experimentContentShape
+}, ["schemaVersion", "id", "versionId", "revision", "site", "path", "content", "brand", "conversion", "tracking"]);
+var FUNNEL_EXPERIMENT_CONTENT_JSON_SCHEMA = { $schema: "http://json-schema.org/draft-07/schema#", ...experimentContentShape };
 var PUBLISHED_FUNNEL_PAGE_JSON_SCHEMA = { $schema: "http://json-schema.org/draft-07/schema#", ...publishedShape };
 var FUNNEL_LAUNCH_JSON_SCHEMA = object({ expectedRevision: integer(1), previewId: uuid, idempotencyKey: string(200), confirm: literal(true) });
 var FUNNEL_LIFECYCLE_JSON_SCHEMA = object({ expectedActiveVersionId: uuid, idempotencyKey: string(200), confirm: literal(true) });
@@ -283,8 +296,24 @@ function parsePublishedFunnelPage(value) {
   checkFonts(result.brand, "page.brand");
   checkBody(result.content.body, "page.content.body");
   if (result.content.offer && !isSafeFunnelPublicUrl(result.content.offer.href)) fail("page.content.offer.href", "unsafe public URL");
+  if (result.experimentContent) result.experimentContent = parseFunnelExperimentContent(result.experimentContent);
   return result;
 }
+function parseFunnelExperimentContent(value) {
+  check(value, experimentContentShape, "experimentContent");
+  const result = JSON.parse(JSON.stringify(value));
+  const keys = result.variants.map((v) => v.variantKey);
+  if (new Set(keys).size !== keys.length) fail("experimentContent.variants", "variant keys must be unique");
+  if (!keys.includes(result.controlVariantKey)) fail("experimentContent.controlVariantKey", "must identify an existing reviewed variant");
+  result.variants.forEach((variant, i) => checkBody(variant.content.body, `experimentContent.variants[${i}].content.body`));
+  return result;
+}
+function resolveFunnelExperimentContent(value, variantKey) {
+  const page = parsePublishedFunnelPage(value);
+  const variant = page.experimentContent?.variants.find((v) => v.variantKey === variantKey);
+  if (!variant) fail("page.experimentContent.variants", "an existing reviewed variant is required");
+  return { ...page.content, headline: variant.content.headline, body: variant.content.body };
+}
 function parseFunnelLaunchArgs(value) {
   check(value, FUNNEL_LAUNCH_JSON_SCHEMA, "launch");
   return JSON.parse(JSON.stringify(value));
@@ -349,7 +378,6 @@ function parseFunnelRetryArgs(value) {
   check(value, FUNNEL_RETRY_JSON_SCHEMA, "retry");
   return JSON.parse(JSON.stringify(value));
 }
-var fingerprint = { type: "string", pattern: "^[a-f0-9]{64}$" };
 var issue = object({ code: { ...string(80), pattern: "^[A-Z][A-Z0-9_]*$" }, path: string(300), message: string(500), fixRef: object({ section: string(80), field: string(80), resourceId: uuid }, ["section"]) }, ["code", "path", "message"]);
 var FUNNEL_READINESS_JSON_SCHEMA = object({ definitionRevision: integer(1), brandFingerprint: fingerprint, resourceFingerprint: fingerprint, ready: { type: "boolean" }, blockers: array(issue, 50), warnings: array(issue, 50), capabilities: object({ managedPage: { type: "boolean" } }) });
 function parseFunnelReadiness(value) {
@@ -557,4 +585,4 @@ function parseFunnelPublishedVersionDetail(value) {
 }
 for (const schema of [FUNNEL_LAUNCH_EVIDENCE_JSON_SCHEMA, FUNNEL_ROLLBACK_EVIDENCE_JSON_SCHEMA, FUNNEL_VERSION_JSON_SCHEMA, FUNNEL_VERSION_DETAIL_JSON_SCHEMA]) freezeSchema(schema);
 
-export { FUNNEL_BRAND_SNAPSHOT_JSON_SCHEMA, FUNNEL_CATALOG_JSON_SCHEMA, FUNNEL_CREATE_JSON_SCHEMA, FUNNEL_DEFINITION_JSON_SCHEMA, FUNNEL_DETAIL_JSON_SCHEMA, FUNNEL_DRAFT_DEFINITION_JSON_SCHEMA, FUNNEL_DRAFT_JSON_SCHEMAS, FUNNEL_ENROLLMENT_JSON_SCHEMA, FUNNEL_LAUNCH_EVIDENCE_JSON_SCHEMA, FUNNEL_LAUNCH_JSON_SCHEMA, FUNNEL_LIFECYCLE_JSON_SCHEMA, FUNNEL_OPERATION_RECEIPT_JSON_SCHEMA, FUNNEL_PREVIEW_JSON_SCHEMA, FUNNEL_READINESS_JSON_SCHEMA, FUNNEL_RETRY_JSON_SCHEMA, FUNNEL_REVISION_JSON_SCHEMA, FUNNEL_ROLLBACK_EVIDENCE_JSON_SCHEMA, FUNNEL_ROLLBACK_JSON_SCHEMA, FUNNEL_SCHEMA_VERSION, FUNNEL_SUMMARY_JSON_SCHEMA, FUNNEL_TEMPLATES, FUNNEL_TIMELINE_JSON_SCHEMA, FUNNEL_UPDATE_JSON_SCHEMA, FUNNEL_VERSION_DETAIL_JSON_SCHEMA, FUNNEL_VERSION_JSON_SCHEMA, FunnelValidationError, MANAGED_FUNNEL_PATH_PREFIX, PUBLISHED_FUNNEL_PAGE_JSON_SCHEMA, applyFunnelBrandOverride, createFunnelDraft, isSafeFunnelPublicUrl, managedFunnelPath, normalizeCampaignSlug, parseFunnelBrandSnapshot, parseFunnelCatalog, parseFunnelCreateArgs, parseFunnelDefinition, parseFunnelDetail, parseFunnelDraftArgs, parseFunnelDraftDefinition, parseFunnelEnrollmentSummary, parseFunnelLaunchArgs, parseFunnelLaunchEvidence, parseFunnelLifecycleArgs, parseFunnelOperationReceipt, parseFunnelPreview, parseFunnelPublishedVersion, parseFunnelPublishedVersionDetail, parseFunnelReadiness, parseFunnelRetryArgs, parseFunnelRevisionArgs, parseFunnelRollbackEvidence, parseFunnelSummary, parseFunnelTimeline, parseFunnelUpdateArgs, parsePublishedFunnelPage };
+export { FUNNEL_BRAND_SNAPSHOT_JSON_SCHEMA, FUNNEL_CATALOG_JSON_SCHEMA, FUNNEL_CREATE_JSON_SCHEMA, FUNNEL_DEFINITION_JSON_SCHEMA, FUNNEL_DETAIL_JSON_SCHEMA, FUNNEL_DRAFT_DEFINITION_JSON_SCHEMA, FUNNEL_DRAFT_JSON_SCHEMAS, FUNNEL_ENROLLMENT_JSON_SCHEMA, FUNNEL_EXPERIMENT_CONTENT_JSON_SCHEMA, FUNNEL_LAUNCH_EVIDENCE_JSON_SCHEMA, FUNNEL_LAUNCH_JSON_SCHEMA, FUNNEL_LIFECYCLE_JSON_SCHEMA, FUNNEL_OPERATION_RECEIPT_JSON_SCHEMA, FUNNEL_PREVIEW_JSON_SCHEMA, FUNNEL_READINESS_JSON_SCHEMA, FUNNEL_RETRY_JSON_SCHEMA, FUNNEL_REVISION_JSON_SCHEMA, FUNNEL_ROLLBACK_EVIDENCE_JSON_SCHEMA, FUNNEL_ROLLBACK_JSON_SCHEMA, FUNNEL_SCHEMA_VERSION, FUNNEL_SUMMARY_JSON_SCHEMA, FUNNEL_TEMPLATES, FUNNEL_TIMELINE_JSON_SCHEMA, FUNNEL_UPDATE_JSON_SCHEMA, FUNNEL_VERSION_DETAIL_JSON_SCHEMA, FUNNEL_VERSION_JSON_SCHEMA, FunnelValidationError, MANAGED_FUNNEL_PATH_PREFIX, PUBLISHED_FUNNEL_PAGE_JSON_SCHEMA, applyFunnelBrandOverride, createFunnelDraft, isSafeFunnelPublicUrl, managedFunnelPath, normalizeCampaignSlug, parseFunnelBrandSnapshot, parseFunnelCatalog, parseFunnelCreateArgs, parseFunnelDefinition, parseFunnelDetail, parseFunnelDraftArgs, parseFunnelDraftDefinition, parseFunnelEnrollmentSummary, parseFunnelExperimentContent, parseFunnelLaunchArgs, parseFunnelLaunchEvidence, parseFunnelLifecycleArgs, parseFunnelOperationReceipt, parseFunnelPreview, parseFunnelPublishedVersion, parseFunnelPublishedVersionDetail, parseFunnelReadiness, parseFunnelRetryArgs, parseFunnelRevisionArgs, parseFunnelRollbackEvidence, parseFunnelSummary, parseFunnelTimeline, parseFunnelUpdateArgs, parsePublishedFunnelPage, resolveFunnelExperimentContent };

package/dist/resonance-constants.d.ts

@@ -0,0 +1,4 @@
+/** Single source of truth for inert Resonance wire literals; safe in browser entry graphs. */
+export declare const RESONANCE_ATTRIBUTION_MODEL: 'first_party_last_touch_marker_v1';
+export declare const RESONANCE_SOURCE_MARKER_PARAMETER: 'sonor_source';
+export declare const RESONANCE_SUBJECT_HEADER: 'X-Sonor-Resonance-Subject';

package/dist/resonance-constants.js

@@ -0,0 +1,10 @@
+'use strict';
+
+// src/contracts/resonance-constants.ts
+var RESONANCE_ATTRIBUTION_MODEL = "first_party_last_touch_marker_v1";
+var RESONANCE_SOURCE_MARKER_PARAMETER = "sonor_source";
+var RESONANCE_SUBJECT_HEADER = "X-Sonor-Resonance-Subject";
+
+exports.RESONANCE_ATTRIBUTION_MODEL = RESONANCE_ATTRIBUTION_MODEL;
+exports.RESONANCE_SOURCE_MARKER_PARAMETER = RESONANCE_SOURCE_MARKER_PARAMETER;
+exports.RESONANCE_SUBJECT_HEADER = RESONANCE_SUBJECT_HEADER;

package/dist/resonance-constants.mjs

@@ -0,0 +1,6 @@
+// src/contracts/resonance-constants.ts
+var RESONANCE_ATTRIBUTION_MODEL = "first_party_last_touch_marker_v1";
+var RESONANCE_SOURCE_MARKER_PARAMETER = "sonor_source";
+var RESONANCE_SUBJECT_HEADER = "X-Sonor-Resonance-Subject";
+
+export { RESONANCE_ATTRIBUTION_MODEL, RESONANCE_SOURCE_MARKER_PARAMETER, RESONANCE_SUBJECT_HEADER };