@prenta/core 0.118.0

package/dist/fields/relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.js","sourceRoot":"","sources":["../../src/fields/relations.ts"],"names":[],"mappings":"AAyCA,6EAA6E;AAE7E,SAAS,eAAe,CAAC,KAAsB;IAC7C,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;QAAE,OAAO,EAAE,CAAA;IAC5C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;AAChF,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,EAAE,CAAA;IACpE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAa,CAAA;IAC/E,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IACjE,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAuC,EACvC,IAA6B;IAK7B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAuB,CAAA;IACnD,MAAM,UAAU,GAAmE,EAAE,CAAA;IAErF,SAAS,KAAK,CACZ,SAA0C,EAC1C,GAAsC,EACtC,MAAc;QAEd,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAM;QAC3C,MAAM,MAAM,GAAG,GAA8B,CAAA;QAC7C,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;YAChD,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBAChC,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;gBAC7B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;oBAAE,SAAQ;gBAC9B,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAA;gBAC1C,KAAK,MAAM,MAAM,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC1C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC;wBAAE,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;oBAClE,KAAK,MAAM,EAAE,IAAI,GAAG;wBAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;gBACzD,CAAC;YACH,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACtC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAY,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAA;gBACzD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAA;IACvB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,CAAA;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAuC,EACvC,IAA6B,EAC7B,MAAsB;IAEtB,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACtE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAEnC,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAEtD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC1C,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;YACzB,IAAI,QAAQ,GAAG,KAAK,CAAA;YACpB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;gBAChC,IAAI,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;oBACpB,QAAQ,GAAG,IAAI,CAAA;oBACf,MAAK;gBACP,CAAC;YACH,CAAC;YACD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBACtE,MAAM,IAAI,KAAK,CACb,mBAAmB,GAAG,CAAC,IAAI,0BAA0B,EAAE,yCAAyC,MAAM,IAAI,CAC3G,CAAA;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,KAAK,UAAU,YAAY,CACzB,MAAsB,EACtB,YAAsC;IAEtC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwC,CAAA;IAC7D,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAEzC,MAAM,WAAW,GAAa,EAAE,CAAA;IAChC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAA;IAC7B,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;QACzD,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC5B,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;QAChC,KAAK,MAAM,EAAE,IAAI,KAAK;YAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACrC,CAAC;IAED,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAEhC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAClE,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QACjC,mEAAmE;QACnE,uEAAuE;QACvE,wCAAwC;QACxC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QAC5C,IAAI,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAgBD,SAAS,kBAAkB,CAAC,IAAY,EAAE,KAA+B;IACvE,wEAAwE;IACxE,kEAAkE;IAClE,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IACxB,IAAI,KAAK,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IAC/E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACvC,yCAAyC;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAA;IACzD,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;AAC5B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAuC,EACvC,IAA6B,EAC7B,MAAsB,EACtB,UAA2B,EAAE;IAE7B,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACtE,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;IACxF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAE1C,6CAA6C;IAC7C,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAuB,CAAA;IAC1D,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,KAAK,MAAM,MAAM,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YACpC,IAAI,CAAC,GAAG;gBAAE,SAAQ;YAClB,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;gBACzB,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;oBAChB,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC;wBAAE,mBAAmB,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;oBAChF,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;IAE7D,8DAA8D;IAC9D,MAAM,MAAM,GAA4B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;IAExE,SAAS,aAAa,CAAC,KAAsB,EAAE,EAAU;QACvD,KAAK,MAAM,MAAM,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;YAC1C,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAA;QAC7B,CAAC;QACD,sEAAsE;QACtE,0DAA0D;QAC1D,OAAO,EAAE,CAAA;IACX,CAAC;IAED,SAAS,OAAO,CACd,SAA0C,EAC1C,GAA4B,EAC5B,MAAc;QAEd,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAA;YACvB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;YAChD,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3E,IAAI,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBACxC,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;oBAC7B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;wBAAE,SAAQ;oBAC9B,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAA;gBACrD,CAAC;qBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzD,GAAG,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;gBACvC,CAAC;YACH,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;oBACrB,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;wBACrC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAA+B,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAA;oBACvE,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,CAAA;IAC3B,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAA8B;IAC/D,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAA;IACrB,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;IACxD,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IAC/C,MAAM,KAAK,GAAG,GAAG;SACd,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAA;IAClB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACnC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;IAC9C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AACzB,CAAC"}

package/dist/forms/analytics.d.ts

@@ -0,0 +1,62 @@
+/**
+ * GA4 event tracking for Prenta CMS forms.
+ *
+ * This module pushes structured events to the site's existing gtag() installation.
+ * It does NOT load the GA4 script — that's the site owner's responsibility via
+ * their Google Analytics snippet or GTM container.
+ */
+export interface FormAnalyticsConfig {
+    enabled: boolean;
+    /** GA4 Measurement ID (e.g. "G-XXXXXXXXXX"). If not set, events go to whatever gtag() is configured globally. */
+    measurementId?: string;
+    /** Custom event name for form submissions. Defaults to "form_submit". */
+    submitEventName?: string;
+    /** Custom event name for form start (first interaction). Defaults to "form_start". */
+    startEventName?: string;
+    /** Send as a GA4 conversion event. */
+    trackAsConversion?: boolean;
+    /** Optional monetary value for conversion tracking (e.g. lead value). */
+    conversionValue?: number;
+    /** Currency code for conversion value. Defaults to "USD". */
+    conversionCurrency?: string;
+    /** Additional custom parameters to include with every event. */
+    customParameters?: Record<string, string | number | boolean>;
+}
+export interface FormConfirmation {
+    type: 'message' | 'redirect';
+    /** Success message shown inline when type is "message". */
+    message?: string;
+    /** URL to redirect to when type is "redirect". */
+    redirectUrl?: string;
+    /** Delay in ms before redirecting. Defaults to 0. */
+    redirectDelay?: number;
+}
+declare global {
+    interface Window {
+        gtag?: (...args: unknown[]) => void;
+        dataLayer?: unknown[];
+    }
+}
+/**
+ * Track when a user first interacts with a form (focus on first field).
+ * Maps to the GA4 recommended "form_start" event.
+ */
+export declare function trackFormStart(formName: string, formId: string, config?: FormAnalyticsConfig): void;
+/**
+ * Track a successful form submission.
+ * Maps to the GA4 recommended "form_submit" event with optional conversion data.
+ */
+export declare function trackFormSubmit(formName: string, formId: string, config?: FormAnalyticsConfig, extra?: Record<string, unknown>): void;
+/**
+ * Track a form submission error.
+ */
+export declare function trackFormError(formName: string, formId: string, errorMessage: string, config?: FormAnalyticsConfig): void;
+/**
+ * Push a custom dataLayer event (for GTM users who prefer dataLayer over gtag).
+ */
+export declare function pushDataLayerEvent(eventName: string, data: Record<string, unknown>): void;
+/** Default confirmation config. */
+export declare function getDefaultConfirmation(): FormConfirmation;
+/** Default analytics config. */
+export declare function getDefaultAnalyticsConfig(): FormAnalyticsConfig;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/forms/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/forms/analytics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,iHAAiH;IACjH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sFAAsF;IACtF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;CAC7D;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,GAAG,UAAU,CAAA;IAC5B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;QACnC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAA;KACtB;CACF;AAyBD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,mBAAmB,GAC3B,IAAI,CAYN;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,mBAAmB,EAC5B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAgBN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,mBAAmB,GAC3B,IAAI,CAaN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAQzF;AAED,mCAAmC;AACnC,wBAAgB,sBAAsB,IAAI,gBAAgB,CAKzD;AAED,gCAAgC;AAChC,wBAAgB,yBAAyB,IAAI,mBAAmB,CAI/D"}

package/dist/forms/analytics.js

@@ -0,0 +1,95 @@
+/**
+ * GA4 event tracking for Prenta CMS forms.
+ *
+ * This module pushes structured events to the site's existing gtag() installation.
+ * It does NOT load the GA4 script — that's the site owner's responsibility via
+ * their Google Analytics snippet or GTM container.
+ */
+const isBrowser = typeof window !== 'undefined';
+function hasGtag() {
+    return isBrowser && typeof window.gtag === 'function';
+}
+function sendEvent(eventName, params, measurementId) {
+    if (!hasGtag())
+        return;
+    if (measurementId) {
+        window.gtag('event', eventName, {
+            send_to: measurementId,
+            ...params,
+        });
+    }
+    else {
+        window.gtag('event', eventName, params);
+    }
+}
+/**
+ * Track when a user first interacts with a form (focus on first field).
+ * Maps to the GA4 recommended "form_start" event.
+ */
+export function trackFormStart(formName, formId, config) {
+    if (!config?.enabled)
+        return;
+    sendEvent(config.startEventName ?? 'form_start', {
+        form_name: formName,
+        form_id: formId,
+        ...config.customParameters,
+    }, config.measurementId);
+}
+/**
+ * Track a successful form submission.
+ * Maps to the GA4 recommended "form_submit" event with optional conversion data.
+ */
+export function trackFormSubmit(formName, formId, config, extra) {
+    if (!config?.enabled)
+        return;
+    const params = {
+        form_name: formName,
+        form_id: formId,
+        ...config.customParameters,
+        ...extra,
+    };
+    if (config.trackAsConversion) {
+        params.value = config.conversionValue ?? 0;
+        params.currency = config.conversionCurrency ?? 'USD';
+    }
+    sendEvent(config.submitEventName ?? 'form_submit', params, config.measurementId);
+}
+/**
+ * Track a form submission error.
+ */
+export function trackFormError(formName, formId, errorMessage, config) {
+    if (!config?.enabled)
+        return;
+    sendEvent('form_error', {
+        form_name: formName,
+        form_id: formId,
+        error_message: errorMessage,
+        ...config.customParameters,
+    }, config.measurementId);
+}
+/**
+ * Push a custom dataLayer event (for GTM users who prefer dataLayer over gtag).
+ */
+export function pushDataLayerEvent(eventName, data) {
+    if (!isBrowser)
+        return;
+    window.dataLayer = window.dataLayer ?? [];
+    window.dataLayer.push({
+        event: eventName,
+        ...data,
+    });
+}
+/** Default confirmation config. */
+export function getDefaultConfirmation() {
+    return {
+        type: 'message',
+        message: 'Thank you! Your submission has been received.',
+    };
+}
+/** Default analytics config. */
+export function getDefaultAnalyticsConfig() {
+    return {
+        enabled: false,
+    };
+}
+//# sourceMappingURL=analytics.js.map

package/dist/forms/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../src/forms/analytics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqCH,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,WAAW,CAAA;AAE/C,SAAS,OAAO;IACd,OAAO,SAAS,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,CAAA;AACvD,CAAC;AAED,SAAS,SAAS,CAChB,SAAiB,EACjB,MAA+B,EAC/B,aAAsB;IAEtB,IAAI,CAAC,OAAO,EAAE;QAAE,OAAM;IAEtB,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,CAAC,IAAK,CAAC,OAAO,EAAE,SAAS,EAAE;YAC/B,OAAO,EAAE,aAAa;YACtB,GAAG,MAAM;SACV,CAAC,CAAA;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAK,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;IAC1C,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,MAAc,EACd,MAA4B;IAE5B,IAAI,CAAC,MAAM,EAAE,OAAO;QAAE,OAAM;IAE5B,SAAS,CACP,MAAM,CAAC,cAAc,IAAI,YAAY,EACrC;QACE,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,MAAM;QACf,GAAG,MAAM,CAAC,gBAAgB;KAC3B,EACD,MAAM,CAAC,aAAa,CACrB,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,MAAc,EACd,MAA4B,EAC5B,KAA+B;IAE/B,IAAI,CAAC,MAAM,EAAE,OAAO;QAAE,OAAM;IAE5B,MAAM,MAAM,GAA4B;QACtC,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,MAAM;QACf,GAAG,MAAM,CAAC,gBAAgB;QAC1B,GAAG,KAAK;KACT,CAAA;IAED,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC7B,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,eAAe,IAAI,CAAC,CAAA;QAC1C,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,kBAAkB,IAAI,KAAK,CAAA;IACtD,CAAC;IAED,SAAS,CAAC,MAAM,CAAC,eAAe,IAAI,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC,CAAA;AAClF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,MAAc,EACd,YAAoB,EACpB,MAA4B;IAE5B,IAAI,CAAC,MAAM,EAAE,OAAO;QAAE,OAAM;IAE5B,SAAS,CACP,YAAY,EACZ;QACE,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,MAAM;QACf,aAAa,EAAE,YAAY;QAC3B,GAAG,MAAM,CAAC,gBAAgB;KAC3B,EACD,MAAM,CAAC,aAAa,CACrB,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,IAA6B;IACjF,IAAI,CAAC,SAAS;QAAE,OAAM;IAEtB,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAA;IACzC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;QACpB,KAAK,EAAE,SAAS;QAChB,GAAG,IAAI;KACR,CAAC,CAAA;AACJ,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,+CAA+C;KACzD,CAAA;AACH,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,OAAO,EAAE,KAAK;KACf,CAAA;AACH,CAAC"}

package/dist/forms/attribution.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Marketing attribution capture for Prenta CMS forms.
+ *
+ * Client-safe (no Node dependencies) — published standalone at
+ * `@prenta/core/forms/attribution` so public-site form renderers
+ * can import it without pulling in the server bundle.
+ *
+ * Model (first/last-touch, merged at submit):
+ *  - Every page view with acquisition signal (UTM params, ad click IDs, or an
+ *    external referrer) records a "touch".
+ *  - The **first touch** is kept for 30 days (localStorage) — it answers
+ *    "what originally brought this visitor here?".
+ *  - The **last touch** is kept for 24 hours — it answers "what brought them
+ *    back for the visit that converted?".
+ *  - `getAttributionForSubmission()` merges both (last-touch wins per key,
+ *    the first *external* referrer is preferred) and returns the payload the
+ *    form renderer attaches to the submission body. The server stores it in
+ *    the `attribution` JSON column and denormalizes source/medium/campaign.
+ *
+ * Referrers are classified into a marketing channel (`paid`, `search_organic`,
+ * `social`, `email`, `ai`, `referral`, `direct`) with a friendly source name
+ * ("ChatGPT" instead of "chat.openai.com") via a single known-referrer
+ * registry. LLM assistants get their own `ai` channel — bucketing that
+ * traffic under `referral` would bury an increasingly important signal.
+ *
+ * Consent: this module never checks consent itself (cms-core cannot depend on
+ * plugin-consent). Callers — e.g. `PrentaForm` in sections-react — gate
+ * capture behind the site's consent state before invoking it.
+ */
+export type AttributionChannel = 'paid' | 'search_organic' | 'social' | 'email' | 'ai' | 'referral' | 'direct';
+/** Top-tier ad click IDs — always present on the payload ('' when absent). */
+export interface AttributionClickIds {
+    gclid: string;
+    fbclid: string;
+    msclkid: string;
+    ttclid: string;
+    li_fat_id: string;
+    dclid: string;
+    twclid: string;
+    rdt_cid: string;
+}
+/**
+ * The merged attribution payload attached to form submissions (version 2).
+ *
+ * The server denormalizes `source` / `medium` / `campaign` into indexed
+ * columns; everything else lives in the `attribution` JSON column.
+ */
+export interface AttributionData {
+    source: string;
+    medium: string;
+    campaign: string;
+    term: string;
+    content: string;
+    landingPage: string;
+    referrer: string;
+    deviceType: 'desktop' | 'tablet' | 'mobile';
+    clickIds: AttributionClickIds;
+    sessionStart: string;
+    pageViews: number;
+    /** Coarse marketing channel resolved from click IDs, UTMs, and referrer. */
+    channel: AttributionChannel;
+    /** Friendly source label from the known-referrer registry ('' when unknown). */
+    referrerName: string;
+    /** Long-tail click IDs (gbraid, wbraid, epik, …) — never needs a schema change. */
+    extraIds: Record<string, string>;
+    firstTouchAt: string;
+    lastTouchAt: string;
+    version: number;
+}
+/** A single acquisition touch (one attributed page view). */
+export interface AttributionTouch {
+    capturedAt: string;
+    landingPage: string;
+    referrer: string;
+    utm: {
+        source: string;
+        medium: string;
+        campaign: string;
+        term: string;
+        content: string;
+    };
+    clickIds: AttributionClickIds;
+    extraIds: Record<string, string>;
+}
+/** Click IDs with dedicated payload keys (queried often in reporting). */
+export declare const TOP_TIER_CLICK_IDS: ReadonlyArray<keyof AttributionClickIds>;
+/**
+ * Long-tail click IDs collected into `extraIds` — adding a network here never
+ * requires a payload/schema change. `ScCid` covers Snapchat's mixed-case
+ * variant seen in the wild (normalized to `sccid`).
+ */
+export declare const LONG_TAIL_CLICK_IDS: readonly string[];
+interface KnownReferrer {
+    name: string;
+    channel: AttributionChannel;
+    /** 'substring' handles ccTLD spreads (google.com / google.co.uk / …). */
+    match?: 'substring';
+}
+/** Registry lookup: exact-or-suffix by default, substring for ccTLD spreads. */
+export declare function lookupKnownReferrer(host: string): KnownReferrer | null;
+export declare function getDeviceType(): 'desktop' | 'tablet' | 'mobile';
+export declare function emptyClickIds(): AttributionClickIds;
+export interface ParsedAttributionParams {
+    source: string;
+    medium: string;
+    campaign: string;
+    term: string;
+    content: string;
+    clickIds: AttributionClickIds;
+    extraIds: Record<string, string>;
+}
+/**
+ * Extract allow-listed attribution query params (UTMs + click IDs) from a URL.
+ * Non-allowlisted params are never captured.
+ */
+export declare function parseAttributionParams(url?: string): ParsedAttributionParams;
+/**
+ * Legacy helper kept for backwards compatibility — prefer
+ * {@link parseAttributionParams}, which also collects long-tail click IDs.
+ */
+export declare function parseUtmParams(url?: string): Partial<AttributionData>;
+/**
+ * Resolve the marketing channel. Priority: paid (any click ID, or an explicit
+ * paid medium) > explicit medium hints > known-referrer registry > referral >
+ * direct (no referrer, no UTMs).
+ */
+export declare function classifyChannel(input: {
+    referrer: string;
+    medium?: string;
+    clickIds?: AttributionClickIds;
+    extraIds?: Record<string, string>;
+}): {
+    channel: AttributionChannel;
+    referrerName: string;
+};
+export declare function inferSource(referrer: string, utmSource?: string): string;
+export declare function inferMedium(utmMedium?: string, clickIds?: Record<string, string> | AttributionClickIds): string;
+/** A touch carries signal when it has any UTM, click ID, or external referrer. */
+export declare function touchHasSignal(touch: AttributionTouch | null | undefined): boolean;
+/** Build a touch from an explicit page URL + referrer (pure, testable). */
+export declare function buildTouch(pageUrl: string, referrer: string, capturedAt?: string): AttributionTouch;
+/**
+ * Merge first + last touch into the canonical submission payload values.
+ * Last-touch wins per key; first-touch fills gaps. The first *external*
+ * referrer wins (it identifies the acquisition source; the return visit's
+ * referrer is often internal or empty). `extraIds` are deep-merged so a
+ * long-tail click ID seen at first touch survives a different-network return.
+ */
+export declare function mergeTouches(first: AttributionTouch | null, last: AttributionTouch | null): Pick<AttributionData, 'source' | 'medium' | 'campaign' | 'term' | 'content' | 'referrer' | 'landingPage' | 'clickIds' | 'extraIds' | 'firstTouchAt' | 'lastTouchAt'>;
+/**
+ * Record the current page view as an attribution touch and return the merged
+ * attribution snapshot. Safe to call on every page load — the first touch is
+ * only written once per 30-day window, and pages without acquisition signal
+ * (internal navigation) never overwrite stored touches.
+ */
+export declare function captureAttribution(): AttributionData;
+/** Increment the page-view counter (and capture a touch when signal exists). */
+export declare function trackPageView(): void;
+/**
+ * Read the merged attribution snapshot without recording a page view.
+ * Returns `null` when nothing has been captured yet.
+ */
+export declare function getStoredAttribution(): AttributionData | null;
+/**
+ * Legacy no-op-ish setter kept for backwards compatibility: persists the
+ * snapshot's session meta. Touches are managed by {@link captureAttribution}.
+ */
+export declare function storeAttribution(data: AttributionData): void;
+/**
+ * The payload to attach to a form submission: captures the current page as a
+ * final touch, merges first + last, and counts the page view.
+ */
+export declare function getAttributionForSubmission(): AttributionData;
+export {};
+//# sourceMappingURL=attribution.d.ts.map

package/dist/forms/attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../../src/forms/attribution.ts"],"names":[],"mappings":"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"}