flowgrid-sdk 1.6.9 → 1.7.0

package/dist/lib/features/analytics/identify.js

@@ -298,11 +298,14 @@ class Identify extends transport_1.FlowGridTransport {
             const visitorId = resolveVisitorId();
             if (!this.webId || !visitorId)
                 return;
-            if (!captured.email && !captured.emailHash && !captured.firstName && !captured.lastName)
+            if (!captured.email && !captured.emailHash && !captured.firstName && !captured.lastName && !captured.phone)
                 return;
             const traits = {
                 email: captured.email ?? null,
                 email_hash: captured.emailHash ?? null,
+                // Raw phone is only populated on an explicit form submit (consent);
+                // passive blur/input keeps phone hash-only.
+                phone: captured.phone ?? null,
                 phone_hash: captured.phoneHash ?? null,
                 first_name: captured.firstName ?? null,
                 last_name: captured.lastName ?? null,
@@ -382,6 +385,31 @@ class Identify extends transport_1.FlowGridTransport {
                 return;
             doc.querySelectorAll("input, textarea, select").forEach(attach);
         };
+        // Explicit submit is treated as consent — capture the RAW phone (the one
+        // identity field passive tracking keeps hash-only) so the CRM cascade can
+        // match by phone, then flush. All other fields are already captured passively.
+        const onSubmit = (e) => {
+            const form = e.target;
+            if (!form || form.tagName !== "FORM")
+                return;
+            if (EXCLUDED_PATH_RE.test(win.location.pathname))
+                return;
+            let phoneOnSubmit = false;
+            form.querySelectorAll("input, textarea, select").forEach((el) => {
+                const cls = classify(el);
+                if (!cls || "blocked" in cls || cls.trait !== "phone")
+                    return;
+                const raw = (fieldEl(el).value || "").trim();
+                if (raw) {
+                    captured.phone = raw;
+                    phoneOnSubmit = true;
+                }
+            });
+            if (phoneOnSubmit)
+                sendIdentity();
+        };
+        doc.addEventListener("submit", onSubmit, true);
+        teardowns.push(() => doc.removeEventListener("submit", onSubmit, true));
         scanPage();
         let mo = null;
         try {

package/dist/lib/features/analytics/identify.js.map

@@ -1 +1 @@
-{"version":3,"file":"identify.js","sourceRoot":"","sources":["../../../../src/lib/features/analytics/identify.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"identify.js","sourceRoot":"","sources":["../../../../src/lib/features/analytics/identify.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;;;AAEH,sDAA2D;AAC3D,iDAAuF;AAyGvF,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAa,QAAS,SAAQ,6BAAiB;IAC7C;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,KAAK,CAAC,IAAI,CAAC,MAAsB;QAC/B,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE;YACtC,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;YAC3B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,MAAkB;QACnD,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE;YACtC,IAAI,EAAE,eAAe;YACrB,MAAM;YACN,MAAM;YACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,KAAK,CAAC,MAAmB;QAC7B,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;YACnC,IAAI,EAAE,OAAO;YACb,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,KAAK,CAAC,MAAmB;QAC7B,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;YACnC,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;YAC3B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,MAAc;QACxB,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;YACvC,IAAI,EAAE,OAAO;YACb,MAAM;YACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CAAC,UAAkC,EAAE;QACjD,IAAI,CAAC,IAAA,mBAAS,GAAE;YAAE,OAAO,GAAG,EAAE,GAA6B,CAAC,CAAC;QAC7D,IAAI,CAAC,6BAAiB,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,OAAO,GAAG,EAAE,GAA6B,CAAC,CAAC;QAE3F,MAAM,GAAG,GAAG,IAAA,mBAAS,GAAG,CAAC;QACzB,MAAM,GAAG,GAAG,IAAA,qBAAW,GAAG,CAAC;QAC3B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC;QAE7C,MAAM,gBAAgB,GAAG,OAAO,CAAC,WAAW,IAAI,6CAA6C,CAAC;QAC9F,MAAM,UAAU,GAAG,6EAA6E,CAAC;QACjG,MAAM,OAAO,GAAG,+CAA+C,CAAC;QAGhE,MAAM,SAAS,GAAgB;YAC7B,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;YACzE,EAAE,EAAE,EAAE,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;YAC7E,EAAE,EAAE,EAAE,6BAA6B,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;YACtF,EAAE,EAAE,EAAE,qCAAqC,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;YAC7F,EAAE,EAAE,EAAE,wCAAwC,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;YAC/F,EAAE,EAAE,EAAE,gDAAgD,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;YACvG,EAAE,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;YACnE,EAAE,EAAE,EAAE,qCAAqC,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;YAC7F,wEAAwE;YACxE,wDAAwD;YACxD,EAAE,EAAE,EAAE,6DAA6D,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;SACvH,CAAC;QAEF,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,OAAO,EAAW,CAAC;QACpC,MAAM,cAAc,GAAG,IAAI,OAAO,EAA0C,CAAC;QAC7E,MAAM,SAAS,GAAsB,EAAE,CAAC;QAExC,MAAM,OAAO,GAAG,CAAC,EAAW,EAAE,EAAE,CAAC,EAAsB,CAAC;QAExD,MAAM,SAAS,GAAG,CAAC,EAAW,EAAU,EAAE,CACxC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;aACvF,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAEpE,MAAM,SAAS,GAAG,CAAC,EAAW,EAAE,GAAW,EAAW,EAAE;YACtD,MAAM,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;YAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACtE,IAAI,EAAE,CAAC,YAAY,CAAC,gBAAgB,CAAC,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAChE,IAAI,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAAE,OAAO,IAAI,CAAC;YACnE,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC,CAAC;QAEF,MAAM,QAAQ,GAAG,CAAC,EAAW,EAAwC,EAAE;YACrE,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;YAC1B,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC;YACtB,IAAI,SAAS,CAAC,EAAE,EAAE,GAAG,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACjD,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YACnC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;QACvD,CAAC,CAAC;QAEF,MAAM,SAAS,GAAG,KAAK,EAAE,KAAa,EAA0B,EAAE;YAChE,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;gBACzE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;gBAC3D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9F,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,gBAAgB,GAAG,GAAW,EAAE,CACpC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACtF,MAAM,gBAAgB,GAAG,GAAkB,EAAE,CAC3C,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAEpE,6EAA6E;QAC7E,wEAAwE;QACxE,yEAAyE;QACzE,MAAM,YAAY,GAAG,GAAG,EAAE;YACxB,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS;gBAAE,OAAO;YACtC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK;gBAAE,OAAO;YAEnH,MAAM,MAAM,GAAG;gBACb,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,IAAI;gBAC7B,UAAU,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI;gBACtC,oEAAoE;gBACpE,4CAA4C;gBAC5C,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,IAAI;gBAC7B,UAAU,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI;gBACtC,UAAU,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI;gBACtC,SAAS,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI;gBACpC,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,IAAI;gBACjC,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,IAAI;gBACjC,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,IAAI;gBAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI;aACpC,CAAC;YACF,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,2BAA2B,CAAC;YACxD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC7B,MAAM,EAAE,IAAI,CAAC,KAAK;gBAClB,UAAU,EAAE,SAAS;gBACrB,UAAU,EAAE,gBAAgB,EAAE;gBAC9B,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ;gBAChC,MAAM;aACP,CAAC,CAAC;YACH,IAAI,CAAC;gBACH,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,CAAC,UAAU;oBAC1D,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC,EAAE,CAAC;oBAC/E,kBAAkB;gBACpB,CAAC;qBAAM,CAAC;oBACN,KAAK,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAiB,CAAC,CAAC,CAAC;gBACtJ,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;QAC3B,CAAC,CAAC;QAEF,MAAM,YAAY,GAAG,CAAC,EAAW,EAAE,EAAE;YACnC,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;YACzB,IAAI,CAAC,GAAG,IAAI,SAAS,IAAI,GAAG;gBAAE,OAAO;YACrC,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,IAAI,CAAC,KAAK;gBAAE,OAAO;YAEnB,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;gBACZ,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;gBAC5E,KAAK,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;oBACnC,IAAI,GAAG,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;wBAAC,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;wBAAC,IAAI,IAAI;4BAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;oBAAC,CAAC;yBACtF,IAAI,GAAG,CAAC,KAAK,KAAK,OAAO,IAAI,IAAI,EAAE,CAAC;wBAAC,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;oBAAC,CAAC;oBACtE,IAAI,GAAG,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK;wBAAE,YAAY,EAAE,CAAC;gBACrD,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;gBAC5B,IAAI,QAAQ,CAAC,KAAK;oBAAE,YAAY,EAAE,CAAC;YACrC,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,MAAM,GAAG,CAAC,EAAW,EAAE,EAAE;YAC7B,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,OAAO;YACzB,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;YACzB,IAAI,CAAC,GAAG,IAAI,SAAS,IAAI,GAAG;gBAAE,OAAO,CAAC,2CAA2C;YACjF,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YACtC,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,YAAY,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;gBACrC,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;YACzE,CAAC,CAAC;YACF,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAA6B,CAAC,CAAC;YAClF,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAA6B,CAAC,CAAC;YACpF,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE;gBAClB,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACvC,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC3C,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAAE,OAAO;YACzD,GAAG,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClE,CAAC,CAAC;QAEF,yEAAyE;QACzE,0EAA0E;QAC1E,+EAA+E;QAC/E,MAAM,QAAQ,GAAG,CAAC,CAAQ,EAAE,EAAE;YAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,MAA4B,CAAC;YAC5C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM;gBAAE,OAAO;YAC7C,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAAE,OAAO;YACzD,IAAI,aAAa,GAAG,KAAK,CAAC;YACzB,IAAwB,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;gBACnF,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACzB,IAAI,CAAC,GAAG,IAAI,SAAS,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,KAAK,OAAO;oBAAE,OAAO;gBAC9D,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC7C,IAAI,GAAG,EAAE,CAAC;oBAAC,QAAQ,CAAC,KAAK,GAAG,GAAG,CAAC;oBAAC,aAAa,GAAG,IAAI,CAAC;gBAAC,CAAC;YAC1D,CAAC,CAAC,CAAC;YACH,IAAI,aAAa;gBAAE,YAAY,EAAE,CAAC;QACpC,CAAC,CAAC;QACF,GAAG,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/C,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QAExE,QAAQ,EAAE,CAAC;QACX,IAAI,EAAE,GAA4B,IAAI,CAAC;QACvC,IAAI,CAAC;YACH,EAAE,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC5C,IAAI,GAAG,CAAC,IAAI;gBAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC,CAAC,kCAAkC,CAAC,CAAC;QAE9C,OAAO,GAAG,EAAE;YACV,IAAI,EAAE;gBAAE,IAAI,CAAC;oBAAC,EAAE,CAAC,UAAU,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;YACrD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBAAC,IAAI,CAAC;oBAAC,CAAC,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;YAAC,CAAC;QAClE,CAAC,CAAC;IACJ,CAAC;CAEF;AAzUD,4BAyUC;AAED,kBAAe,QAAQ,CAAC"}

package/dist/lib/features/core/declarativeExperiments.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @fileoverview Declarative, attribute-driven experiment tracking (no-code).
+ * @module features/core/declarativeExperiments
+ *
+ * @description
+ * Lets a non-technical user (WordPress / Wix / Squarespace marketer) wire
+ * experiment conversions, page-level goals, and exposures using ONLY HTML
+ * attributes — no JavaScript. It does not contain any experiment logic itself:
+ * it reads the visitor's already-assigned variant from the real engine
+ * (`Experiment` in `experiment.ts`) and calls its public tracking methods, so
+ * the deterministic assignment, anti-flicker, holdout and exposure semantics
+ * ("dynamic integrity") are untouched. This is purely the wiring layer.
+ *
+ * @attributes
+ *   data-fg-goal="<experimentId>"   Mark an element as a conversion trigger for
+ *                                   that experiment. Use "*" for every experiment
+ *                                   the visitor is currently bucketed into.
+ *   data-fg-metric="signup"         Metric name recorded (default "conversion").
+ *   data-fg-value="49"              Numeric value, e.g. order total (default 1).
+ *   data-fg-on="click"              Trigger: click (default) | load | submit | view.
+ *                                     click  — on element click
+ *                                     load   — once on page load (e.g. thank-you page)
+ *                                     submit — on the element's (or nearest) form submit
+ *                                     view   — once when scrolled into view
+ *   data-fg-event="<name>"          Fire a generic `track(name)` event on the same
+ *                                   trigger (page-level/interaction tracking). Can be
+ *                                   combined with or used instead of data-fg-goal.
+ *
+ * @example
+ * ```html
+ * <!-- count a click on the signup button as a conversion for the hero test -->
+ * <button data-fg-goal="homepage-hero-headline" data-fg-metric="signup">Start free</button>
+ *
+ * <!-- a thank-you page: count the visit as a conversion for every active test -->
+ * <body data-fg-goal="*" data-fg-on="load" data-fg-metric="purchase">
+ * ```
+ *
+ * Robust to dynamically-injected DOM: a MutationObserver re-scans on changes, so
+ * page builders and SPA route changes keep working with zero extra calls.
+ */
+/** Minimal surface of the FlowGrid instance this layer depends on. */
+export interface DeclarativeExperimentHost {
+    experiments: {
+        trackLocalConversion(experimentId: string, metricName?: string, value?: number): Promise<void> | void;
+        getAssignments(): Record<string, string>;
+    };
+    track(eventName: string, properties?: Record<string, unknown>): unknown;
+}
+/**
+ * Wire every `[data-fg-goal]` / `[data-fg-event]` element under `root` that
+ * isn't already wired, according to its trigger. Idempotent per element.
+ */
+export declare function wireDeclarativeExperiments(host: DeclarativeExperimentHost): {
+    rescan: () => void;
+    flushLoad: () => void;
+    disconnect: () => void;
+};

package/dist/lib/features/core/declarativeExperiments.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * @fileoverview Declarative, attribute-driven experiment tracking (no-code).
+ * @module features/core/declarativeExperiments
+ *
+ * @description
+ * Lets a non-technical user (WordPress / Wix / Squarespace marketer) wire
+ * experiment conversions, page-level goals, and exposures using ONLY HTML
+ * attributes — no JavaScript. It does not contain any experiment logic itself:
+ * it reads the visitor's already-assigned variant from the real engine
+ * (`Experiment` in `experiment.ts`) and calls its public tracking methods, so
+ * the deterministic assignment, anti-flicker, holdout and exposure semantics
+ * ("dynamic integrity") are untouched. This is purely the wiring layer.
+ *
+ * @attributes
+ *   data-fg-goal="<experimentId>"   Mark an element as a conversion trigger for
+ *                                   that experiment. Use "*" for every experiment
+ *                                   the visitor is currently bucketed into.
+ *   data-fg-metric="signup"         Metric name recorded (default "conversion").
+ *   data-fg-value="49"              Numeric value, e.g. order total (default 1).
+ *   data-fg-on="click"              Trigger: click (default) | load | submit | view.
+ *                                     click  — on element click
+ *                                     load   — once on page load (e.g. thank-you page)
+ *                                     submit — on the element's (or nearest) form submit
+ *                                     view   — once when scrolled into view
+ *   data-fg-event="<name>"          Fire a generic `track(name)` event on the same
+ *                                   trigger (page-level/interaction tracking). Can be
+ *                                   combined with or used instead of data-fg-goal.
+ *
+ * @example
+ * ```html
+ * <!-- count a click on the signup button as a conversion for the hero test -->
+ * <button data-fg-goal="homepage-hero-headline" data-fg-metric="signup">Start free</button>
+ *
+ * <!-- a thank-you page: count the visit as a conversion for every active test -->
+ * <body data-fg-goal="*" data-fg-on="load" data-fg-metric="purchase">
+ * ```
+ *
+ * Robust to dynamically-injected DOM: a MutationObserver re-scans on changes, so
+ * page builders and SPA route changes keep working with zero extra calls.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wireDeclarativeExperiments = wireDeclarativeExperiments;
+const WIRED_ATTR = "data-fg-wired";
+const GOAL_ATTR = "data-fg-goal";
+const EVENT_ATTR = "data-fg-event";
+function parseTrigger(raw) {
+    switch ((raw || "").toLowerCase()) {
+        case "load": return "load";
+        case "submit": return "submit";
+        case "view": return "view";
+        default: return "click";
+    }
+}
+/** Resolve the experiment ids a `data-fg-goal` value targets. "*" = all active. */
+function resolveExperimentIds(host, goal) {
+    const trimmed = goal.trim();
+    if (trimmed === "*") {
+        try {
+            return Object.keys(host.experiments.getAssignments());
+        }
+        catch {
+            return [];
+        }
+    }
+    // Allow a comma-separated list of ids for multi-experiment conversions.
+    return trimmed.split(",").map((s) => s.trim()).filter(Boolean);
+}
+/**
+ * Run the element's goal + event side effects once. `trackLocalConversion` is a
+ * safe no-op when the visitor isn't bucketed into a given experiment (control,
+ * holdout, or no running test), so firing for every resolved id is harmless.
+ */
+function fire(host, el) {
+    const goal = el.getAttribute(GOAL_ATTR);
+    if (goal) {
+        const metric = el.getAttribute("data-fg-metric") || "conversion";
+        const rawValue = el.getAttribute("data-fg-value");
+        const value = rawValue != null && rawValue.trim() !== "" && Number.isFinite(Number(rawValue))
+            ? Number(rawValue)
+            : 1;
+        for (const id of resolveExperimentIds(host, goal)) {
+            try {
+                void host.experiments.trackLocalConversion(id, metric, value);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    const eventName = el.getAttribute(EVENT_ATTR);
+    if (eventName) {
+        try {
+            host.track(eventName, { source: "declarative", trigger: el.getAttribute("data-fg-on") || "click" });
+        }
+        catch { /* ignore */ }
+    }
+}
+/**
+ * Wire every `[data-fg-goal]` / `[data-fg-event]` element under `root` that
+ * isn't already wired, according to its trigger. Idempotent per element.
+ */
+function wireDeclarativeExperiments(host) {
+    if (typeof document === "undefined") {
+        return { rescan: () => { }, flushLoad: () => { }, disconnect: () => { } };
+    }
+    // Whether the engine has had a chance to resolve assignments. `load`/`view`
+    // goals discovered before this is true are deferred so a conversion is never
+    // recorded before the visitor is bucketed.
+    let assignmentsReady = false;
+    const pendingImmediate = [];
+    let viewObserver = null;
+    const fireOrDefer = (el) => {
+        if (assignmentsReady)
+            fire(host, el);
+        else
+            pendingImmediate.push(el);
+    };
+    const wireElement = (el) => {
+        if (el.hasAttribute(WIRED_ATTR))
+            return;
+        el.setAttribute(WIRED_ATTR, "");
+        const trigger = parseTrigger(el.getAttribute("data-fg-on"));
+        switch (trigger) {
+            case "click":
+                el.addEventListener("click", () => fire(host, el));
+                break;
+            case "submit": {
+                const form = el.tagName === "FORM" ? el : el.closest("form");
+                (form || el).addEventListener("submit", () => fire(host, el));
+                break;
+            }
+            case "view":
+                if (typeof IntersectionObserver !== "undefined") {
+                    if (!viewObserver) {
+                        viewObserver = new IntersectionObserver((entries, obs) => {
+                            for (const entry of entries) {
+                                if (entry.isIntersecting) {
+                                    obs.unobserve(entry.target);
+                                    fireOrDefer(entry.target);
+                                }
+                            }
+                        }, { threshold: 0.5 });
+                    }
+                    viewObserver.observe(el);
+                }
+                else {
+                    fireOrDefer(el); // no IO support — count it as seen
+                }
+                break;
+            case "load":
+                fireOrDefer(el);
+                break;
+        }
+    };
+    const scan = (root = document) => {
+        const sel = `[${GOAL_ATTR}]:not([${WIRED_ATTR}]),[${EVENT_ATTR}]:not([${WIRED_ATTR}])`;
+        root.querySelectorAll(sel).forEach(wireElement);
+    };
+    scan();
+    // Re-scan when the DOM changes (page builders, SPA navigation, lazy content).
+    const observer = typeof MutationObserver !== "undefined"
+        ? new MutationObserver((mutations) => {
+            for (const m of mutations) {
+                m.addedNodes.forEach((node) => {
+                    if (node.nodeType === 1)
+                        scan(node);
+                });
+            }
+        })
+        : null;
+    observer?.observe(document.documentElement, { childList: true, subtree: true });
+    return {
+        rescan: () => scan(),
+        /**
+         * Mark assignments as resolved and fire any `load`/`view` goals that were
+         * discovered before the engine had bucketed the visitor. Call once
+         * `initFromServer()` settles. Idempotent.
+         */
+        flushLoad: () => {
+            if (assignmentsReady)
+                return;
+            assignmentsReady = true;
+            const queued = pendingImmediate.splice(0, pendingImmediate.length);
+            for (const el of queued)
+                fire(host, el);
+        },
+        disconnect: () => {
+            try {
+                observer?.disconnect();
+            }
+            catch { /* ignore */ }
+            try {
+                viewObserver?.disconnect();
+            }
+            catch { /* ignore */ }
+        },
+    };
+}
+//# sourceMappingURL=declarativeExperiments.js.map

package/dist/lib/features/core/declarativeExperiments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarativeExperiments.js","sourceRoot":"","sources":["../../../../src/lib/features/core/declarativeExperiments.ts"],"names":[],"mappings":"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"}

package/dist/lib/features/core/experiment.d.ts

@@ -239,6 +239,36 @@ export interface VariantResponse {
     variantId: string;
     assignedAt: string;
 }
+/**
+ * A single declarative DOM change applied for an assigned variant — the no-code
+ * rendering primitive. The engine applies these on `init()` so a marketer can
+ * run a test (different headline, hidden banner, redirect to another page)
+ * without an engineer hand-writing `if (variant === "B")` branching.
+ */
+export type VariantChange = {
+    type: 'redirect';
+    url: string;
+} | {
+    type: 'text';
+    selector: string;
+    value: string;
+} | {
+    type: 'html';
+    selector: string;
+    value: string;
+} | {
+    type: 'hide';
+    selector: string;
+} | {
+    type: 'style';
+    selector: string;
+    property: string;
+    value: string;
+} | {
+    type: 'addClass';
+    selector: string;
+    value: string;
+};
 /**
  * Local experiment variant definition used by the client-side
  * assignment engine (ported from sdk.js).
@@ -248,6 +278,15 @@ export interface ExperimentVariant {
     id: string;
     /** Traffic allocation weight */
     weight: number;
+    /** Optional human-readable label (shown in the dashboard). */
+    label?: string;
+    /**
+     * Split-URL / redirect test shortcut — visitors assigned this variant are
+     * sent to `redirectUrl`. Equivalent to a single `{ type: 'redirect' }` change.
+     */
+    redirectUrl?: string;
+    /** Declarative DOM changes applied when this variant is assigned. */
+    changes?: VariantChange[];
 }
 /**
  * Lightweight experiment config passed to `initExperiments()`.
@@ -432,6 +471,38 @@ export declare class Experiment extends FlowGridTransport {
      * @param experiments - Array of experiment configs to register
      */
     initExperiments(experiments: ExperimentInitConfig[]): Promise<void>;
+    private antiFlickerStyleEl;
+    private antiFlickerTimer;
+    /** Experiments whose assigned variant has already had its changes applied + exposure fired. */
+    private appliedExperiments;
+    /** Normalises a variant's `redirectUrl` shortcut + `changes` into one list. */
+    private variantChanges;
+    /** All non-redirect selectors across the passed configs — used for anti-flicker. */
+    private collectChangeSelectors;
+    private injectAntiFlicker;
+    private removeAntiFlicker;
+    private applyDomChange;
+    /**
+     * Apply the assigned variant's declarative changes for every registered
+     * experiment, then fire one exposure per experiment. Redirects take priority
+     * and short-circuit (the new page re-runs init). DOM changes wait for the
+     * document to be ready. Idempotent per experiment.
+     */
+    private applyAssignedChanges;
+    /**
+     * Manually (re-)apply the assigned variant's changes for one experiment —
+     * useful after client-side navigation re-renders the DOM.
+     */
+    applyVariant(experimentId: string): void;
+    /**
+     * Zero-config init: fetch this site's running experiments from the server and
+     * run them. This is what lets the no-build snippet run experiments with no
+     * author JS — the dashboard is the only place experiments are configured.
+     *
+     * Best-effort: a network/permission failure is a silent no-op (the page just
+     * shows its control experience), never a thrown error.
+     */
+    initFromServer(): Promise<void>;
     /**
      * Returns the locally assigned variant for an experiment.
      *

package/dist/lib/features/core/experiment.js

@@ -184,6 +184,13 @@ class Experiment extends transport_1.FlowGridTransport {
         this.experiments = {};
         /** Local variant assignments: { [experiment_id]: variant_id } */
         this.assignments = {};
+        // ---------------------------------------------------------------------------
+        // CLIENT-SIDE ENGINE — declarative variant rendering (no-code)
+        // ---------------------------------------------------------------------------
+        this.antiFlickerStyleEl = null;
+        this.antiFlickerTimer = null;
+        /** Experiments whose assigned variant has already had its changes applied + exposure fired. */
+        this.appliedExperiments = new Set();
     }
     // ---------------------------------------------------------------------------
     // CLIENT-SIDE ENGINE — SSR-safe persistence (localStorage + cookie mirror)
@@ -534,8 +541,163 @@ class Experiment extends transport_1.FlowGridTransport {
      */
     async initExperiments(experiments) {
         this.assignments = this.loadAssignments();
-        if (experiments.length > 0) {
-            await this.verifyExperiments(experiments);
+        // Anti-flicker: hide every element a variant might change *before* the
+        // (async) verify round-trip, so visitors never see the original flash to
+        // the variant. A safety timeout reveals everything even if init stalls.
+        const selectors = this.collectChangeSelectors(experiments);
+        if (selectors.length > 0)
+            this.injectAntiFlicker(selectors);
+        try {
+            if (experiments.length > 0) {
+                await this.verifyExperiments(experiments);
+            }
+            this.applyAssignedChanges();
+        }
+        finally {
+            this.removeAntiFlicker();
+        }
+    }
+    /** Normalises a variant's `redirectUrl` shortcut + `changes` into one list. */
+    variantChanges(variant) {
+        if (!variant)
+            return [];
+        const out = [];
+        if (variant.redirectUrl)
+            out.push({ type: 'redirect', url: variant.redirectUrl });
+        if (Array.isArray(variant.changes))
+            out.push(...variant.changes);
+        return out;
+    }
+    /** All non-redirect selectors across the passed configs — used for anti-flicker. */
+    collectChangeSelectors(experiments) {
+        const set = new Set();
+        for (const exp of experiments) {
+            for (const v of exp.variants) {
+                for (const c of this.variantChanges(v)) {
+                    if (c.type !== 'redirect')
+                        set.add(c.selector);
+                }
+            }
+        }
+        return Array.from(set);
+    }
+    injectAntiFlicker(selectors) {
+        if (typeof document === 'undefined' || this.antiFlickerStyleEl)
+            return;
+        try {
+            const style = document.createElement('style');
+            style.setAttribute('data-flowgrid-antiflicker', '');
+            style.textContent = `${selectors.join(',')}{visibility:hidden !important}`;
+            (document.head || document.documentElement).appendChild(style);
+            this.antiFlickerStyleEl = style;
+            // Never leave the page hidden — reveal after 4s no matter what.
+            this.antiFlickerTimer = setTimeout(() => this.removeAntiFlicker(), 4000);
+        }
+        catch { /* ignore */ }
+    }
+    removeAntiFlicker() {
+        if (this.antiFlickerTimer) {
+            clearTimeout(this.antiFlickerTimer);
+            this.antiFlickerTimer = null;
+        }
+        try {
+            this.antiFlickerStyleEl?.remove();
+        }
+        catch { /* ignore */ }
+        this.antiFlickerStyleEl = null;
+    }
+    applyDomChange(change) {
+        if (typeof document === 'undefined')
+            return;
+        const nodes = document.querySelectorAll(change.selector);
+        nodes.forEach((el) => {
+            switch (change.type) {
+                case 'text':
+                    el.textContent = change.value;
+                    break;
+                case 'html':
+                    el.innerHTML = change.value;
+                    break;
+                case 'hide':
+                    el.style.display = 'none';
+                    break;
+                case 'style':
+                    el.style.setProperty(change.property, change.value);
+                    break;
+                case 'addClass':
+                    el.classList.add(...change.value.split(/\s+/).filter(Boolean));
+                    break;
+            }
+        });
+    }
+    /**
+     * Apply the assigned variant's declarative changes for every registered
+     * experiment, then fire one exposure per experiment. Redirects take priority
+     * and short-circuit (the new page re-runs init). DOM changes wait for the
+     * document to be ready. Idempotent per experiment.
+     */
+    applyAssignedChanges() {
+        if (typeof window === 'undefined')
+            return;
+        for (const [experimentId, config] of Object.entries(this.experiments)) {
+            if (this.appliedExperiments.has(experimentId))
+                continue;
+            const variantId = this.assignments[experimentId];
+            if (!variantId)
+                continue;
+            const variant = config.variants.find((v) => v.id === variantId);
+            const changes = this.variantChanges(variant);
+            // Redirect first — if we're not already on the target, go there. The
+            // destination page's own init() handles exposure for the redirected view.
+            const redirect = changes.find((c) => c.type === 'redirect');
+            if (redirect) {
+                const target = new URL(redirect.url, window.location.href);
+                if (target.href !== window.location.href) {
+                    this.appliedExperiments.add(experimentId);
+                    this.trackLocalExposure(experimentId).catch(() => { });
+                    window.location.replace(target.href);
+                    return;
+                }
+            }
+            const domChanges = changes.filter((c) => c.type !== 'redirect');
+            const run = () => domChanges.forEach((c) => this.applyDomChange(c));
+            if (typeof document !== 'undefined' && document.readyState === 'loading') {
+                document.addEventListener('DOMContentLoaded', run, { once: true });
+            }
+            else {
+                run();
+            }
+            this.appliedExperiments.add(experimentId);
+            // Auto-fire exposure so no-code users get results without extra calls.
+            this.trackLocalExposure(experimentId).catch(() => { });
+        }
+    }
+    /**
+     * Manually (re-)apply the assigned variant's changes for one experiment —
+     * useful after client-side navigation re-renders the DOM.
+     */
+    applyVariant(experimentId) {
+        this.appliedExperiments.delete(experimentId);
+        this.applyAssignedChanges();
+    }
+    /**
+     * Zero-config init: fetch this site's running experiments from the server and
+     * run them. This is what lets the no-build snippet run experiments with no
+     * author JS — the dashboard is the only place experiments are configured.
+     *
+     * Best-effort: a network/permission failure is a silent no-op (the page just
+     * shows its control experience), never a thrown error.
+     */
+    async initFromServer() {
+        try {
+            const res = await fetch(`${this.endpoint}/api/v1/experiments/active?web_id=${encodeURIComponent(this.webId)}`);
+            const json = await res.json();
+            if (json?.ok && Array.isArray(json.data) && json.data.length > 0) {
+                await this.initExperiments(json.data);
+            }
+        }
+        catch {
+            /* offline, blocked, or no experiments — leave the control experience */
         }
     }
     /**