gotrip-fx-transaction-form 1.0.281-dev → 1.0.283-dev

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gotrip-fx-transaction-form",
-  "version": "1.0.281-dev",
+  "version": "1.0.283-dev",
   "description": "FX Transaction Form ES6 module",
   "main": "index.js",
   "types": "types/index.d.ts",

package/types/embeded-main.d.ts

@@ -5,6 +5,7 @@ type InitProps = {
     apiKey: string;
     type?: ESdkFormType;
     scrollable?: boolean;
+    utm?: Record<string, string> | null;
 };
 interface GoTripSDKProps {
     init: (props: InitProps) => void;

package/types/types/tracking.dto.d.ts

@@ -11,6 +11,8 @@ export interface TrackingDto {
     fbid?: string;
     /** Campaign identifier */
     campaign?: string;
+    /** UTM and ad network parameters (utm_source, utm_campaign, gclid, fbclid, ttclid, etc.) */
+    utm?: Record<string, string>;
 }
 /**
  * Type helper to extend any DTO with tracking fields

package/types/util/tracking.d.ts

@@ -14,16 +14,23 @@ export declare const saveAnonymousUid: (uid: string) => void;
  */
 export declare const getAnonymousUid: () => string;
 /**
- * Parse tracking parameters from URL query string
- * Extracts gclid, fbid, campaign, etc. from URL
+ * Parse UTM and ad network parameters from URL query string
+ * Extracts all UTM params (utm_source, utm_campaign, etc.) and ad network params (gclid, fbclid, ttclid, etc.)
  */
-export declare const parseTrackingParamsFromUrl: () => {
-    gclid?: string;
-    fbid?: string;
-    campaign?: string;
-    [key: string]: string | undefined;
-};
+export declare const parseUTMParamsFromUrl: () => Record<string, string>;
 /**
  * Validate tracking data
  */
 export declare const validateTrackingData: (data: any) => boolean;
+/**
+ * Capture UTM and ad network parameters into a 7-day cookie
+ * If params are explicitly provided, use them; otherwise read from URL params
+ * Always overrides existing params (last-click wins)
+ * Expires in 7 days
+ */
+export declare const captureUTMParams: (explicitParams?: Record<string, string> | null) => void;
+/**
+ * Get UTM and ad network parameters from cookie
+ * Returns empty object if not found or expired
+ */
+export declare const getUTMParams: () => Record<string, string>;