gotrip-fx-transaction-form 1.0.211-dev → 1.0.213-dev

package/package.json

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

package/types/store/useTrackingStore.d.ts

@@ -0,0 +1,8 @@
+import { TrackingDto } from '../types/tracking.dto';
+export type TrackingState = {
+    anonymousId: string | null;
+    getAnonymousUid: () => string;
+    getTrackingData: () => TrackingDto;
+    _saveAnonymousUid: (uid: string) => void;
+};
+export declare const useTrackingStore: import('zustand').UseBoundStore<import('zustand').StoreApi<TrackingState>>;

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

@@ -0,0 +1,19 @@
+/**
+ * Tracking DTO interface for tracking user behavior
+ * This interface can be extended with additional tracking fields in the future
+ */
+export interface TrackingDto {
+    /** Anonymous user ID for tracking unauthenticated users */
+    anonymousId?: string;
+    /** Google Click ID for tracking Google Ads campaigns */
+    gclid?: string;
+    /** Facebook Click ID for tracking Facebook Ads campaigns */
+    fbid?: string;
+    /** Campaign identifier */
+    campaign?: string;
+}
+/**
+ * Type helper to extend any DTO with tracking fields
+ * Usage: type MyDtoWithTracking = WithTracking<MyDto>
+ */
+export type WithTracking<T> = T & TrackingDto;

package/types/util/tracking.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Generate a new anonymous user ID (15 chars, url-safe).
+ * @see https://alex7kom.github.io/nano-nanoid-cc/
+ */
+export declare const generateAnonymousUid: (size?: number) => string;
+/**
+ * Save anonymous UID to both cookie and localStorage
+ * This ensures persistence across different storage mechanisms
+ */
+export declare const saveAnonymousUid: (uid: string) => void;
+/**
+ * Get anonymous UID with priority: cookie first, then localStorage
+ * If not found, generates a new one and saves it
+ */
+export declare const getAnonymousUid: () => string;
+/**
+ * Parse tracking parameters from URL query string
+ * Extracts gclid, fbid, campaign, etc. from URL
+ */
+export declare const parseTrackingParamsFromUrl: () => {
+    gclid?: string;
+    fbid?: string;
+    campaign?: string;
+    [key: string]: string | undefined;
+};
+/**
+ * Validate tracking data
+ */
+export declare const validateTrackingData: (data: any) => boolean;