@explorins/pers-shared 2.1.174 → 2.1.176

package/dist/esm/shared-lib/types/data-source.type.js

@@ -67,4 +67,178 @@ export function isDataSourceChannel(value) {
 export const DEFAULT_DATA_SOURCE = {
     channel: 'admin',
 };
+/**
+ * Known domain mappings for auto-detecting source from referrer.
+ * Maps hostnames to normalized source names.
+ */
+export const KNOWN_SOURCE_DOMAINS = {
+    // Google
+    'google.com': 'google',
+    'google.co.uk': 'google',
+    'google.de': 'google',
+    'google.fr': 'google',
+    'google.es': 'google',
+    'google.it': 'google',
+    'google.nl': 'google',
+    'google.pt': 'google',
+    'google.pl': 'google',
+    'google.ru': 'google',
+    'google.com.br': 'google',
+    'google.ca': 'google',
+    'google.com.au': 'google',
+    'google.co.jp': 'google',
+    'google.co.in': 'google',
+    // Facebook
+    'facebook.com': 'facebook',
+    'fb.com': 'facebook',
+    'm.facebook.com': 'facebook',
+    'l.facebook.com': 'facebook',
+    'lm.facebook.com': 'facebook',
+    // Instagram
+    'instagram.com': 'instagram',
+    'l.instagram.com': 'instagram',
+    // Twitter/X
+    'twitter.com': 'twitter',
+    'x.com': 'twitter',
+    't.co': 'twitter',
+    'mobile.twitter.com': 'twitter',
+    // LinkedIn
+    'linkedin.com': 'linkedin',
+    'lnkd.in': 'linkedin',
+    // YouTube
+    'youtube.com': 'youtube',
+    'youtu.be': 'youtube',
+    'm.youtube.com': 'youtube',
+    // TikTok
+    'tiktok.com': 'tiktok',
+    'vm.tiktok.com': 'tiktok',
+    // Other social
+    'pinterest.com': 'pinterest',
+    'reddit.com': 'reddit',
+    'tumblr.com': 'tumblr',
+    'snapchat.com': 'snapchat',
+    // Search engines
+    'bing.com': 'bing',
+    'yahoo.com': 'yahoo',
+    'duckduckgo.com': 'duckduckgo',
+    'baidu.com': 'baidu',
+    'yandex.com': 'yandex',
+    'yandex.ru': 'yandex',
+    // Email providers (for tracking email clicks)
+    'mail.google.com': 'gmail',
+    'outlook.live.com': 'outlook',
+    'outlook.office.com': 'outlook',
+};
+/**
+ * Auto-detect source from referrer URL domain.
+ * Maps common domains to friendly source names.
+ *
+ * @param referrer - Full referrer URL
+ * @returns Normalized source name or undefined
+ *
+ * @example
+ * detectSourceFromReferrer('https://www.google.com/search?q=test') // 'google'
+ * detectSourceFromReferrer('https://l.facebook.com/...') // 'facebook'
+ * detectSourceFromReferrer('https://partner.example.com') // 'example'
+ */
+export function detectSourceFromReferrer(referrer) {
+    if (!referrer)
+        return undefined;
+    try {
+        const url = new URL(referrer);
+        const hostname = url.hostname.toLowerCase().replace(/^www\./, '');
+        // Check exact match first
+        if (KNOWN_SOURCE_DOMAINS[hostname]) {
+            return KNOWN_SOURCE_DOMAINS[hostname];
+        }
+        // Check if hostname ends with known domain (for subdomains)
+        for (const [domain, source] of Object.entries(KNOWN_SOURCE_DOMAINS)) {
+            if (hostname.endsWith('.' + domain)) {
+                return source;
+            }
+        }
+        // Fallback: extract main domain name (e.g., 'example' from 'mail.example.com')
+        const parts = hostname.split('.');
+        if (parts.length >= 2) {
+            return parts[parts.length - 2]; // Returns 'example' from 'sub.example.com'
+        }
+        return hostname;
+    }
+    catch {
+        // Invalid URL, return undefined
+        return undefined;
+    }
+}
+/**
+ * Auto-detect channel from User-Agent string.
+ *
+ * @param userAgent - User-Agent header value
+ * @param path - Optional request path for webhook detection
+ * @returns Detected channel
+ *
+ * @example
+ * detectChannelFromUserAgent('Mozilla/5.0 (iPhone; ...)') // 'mobile'
+ * detectChannelFromUserAgent('Mozilla/5.0 (Windows NT...)') // 'web'
+ * detectChannelFromUserAgent('', '/webhook/stripe') // 'webhook'
+ */
+export function detectChannelFromUserAgent(userAgent, path) {
+    // Check for webhook paths
+    if (path?.includes('/webhook')) {
+        return 'webhook';
+    }
+    const ua = (userAgent || '').toLowerCase();
+    // Check for mobile user-agents
+    if (/mobile|android|iphone|ipad|ipod|blackberry|windows phone/i.test(ua)) {
+        return 'mobile';
+    }
+    // Check for bot/crawler patterns (system)
+    if (/bot|crawler|spider|scraper|curl|wget|python|node-fetch|axios/i.test(ua)) {
+        return 'api';
+    }
+    // Default to web for browser-like user agents
+    return 'web';
+}
+/**
+ * Parse UTM parameters from a URL (deep link, referrer, etc.).
+ * Supports standard Google Analytics UTM parameters.
+ *
+ * @param url - Full URL containing UTM query parameters
+ * @returns Parsed UTM parameters object
+ *
+ * @example
+ * // Deep link from email campaign
+ * parseUtmParams('myapp://screen?utm_source=mailchimp&utm_medium=email&utm_campaign=summer_2026')
+ * // Returns: { source: 'mailchimp', medium: 'email', campaign: 'summer_2026' }
+ *
+ * @example
+ * // Web URL with full UTM tracking
+ * parseUtmParams('https://app.example.com?utm_source=google&utm_medium=cpc&utm_campaign=brand&utm_term=loyalty+app')
+ * // Returns: { source: 'google', medium: 'cpc', campaign: 'brand', term: 'loyalty+app' }
+ */
+export function parseUtmParams(url) {
+    const params = {};
+    try {
+        const urlObj = new URL(url);
+        const searchParams = urlObj.searchParams;
+        const source = searchParams.get('utm_source');
+        const medium = searchParams.get('utm_medium');
+        const campaign = searchParams.get('utm_campaign');
+        const term = searchParams.get('utm_term');
+        const content = searchParams.get('utm_content');
+        if (source)
+            params.source = source;
+        if (medium)
+            params.medium = medium;
+        if (campaign)
+            params.campaign = campaign;
+        if (term)
+            params.term = term;
+        if (content)
+            params.content = content;
+    }
+    catch {
+        // Invalid URL, return empty params
+    }
+    return params;
+}
 //# sourceMappingURL=data-source.type.js.map

package/dist/esm/shared-lib/types/data-source.type.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-source.type.js","sourceRoot":"","sources":["../../../../src/shared-lib/types/data-source.type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,KAAK,EAAQ,0BAA0B;IACvC,QAAQ,EAAK,2BAA2B;IACxC,KAAK,EAAQ,yBAAyB;IACtC,OAAO,EAAM,0BAA0B;IACvC,QAAQ,EAAK,+BAA+B;IAC5C,QAAQ,EAAK,yBAAyB;IACtC,SAAS,EAAI,4BAA4B;IACzC,MAAM,EAAO,uCAAuC;IACpD,WAAW,EAAE,iBAAiB;CACtB,CAAC;AA0CX;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,oBAAoB,CAAC,QAAQ,CAAC,KAA0B,CAAC,CAAC;AAChG,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,OAAO,EAAE,OAAO;CACjB,CAAC"}
+{"version":3,"file":"data-source.type.js","sourceRoot":"","sources":["../../../../src/shared-lib/types/data-source.type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,KAAK,EAAQ,0BAA0B;IACvC,QAAQ,EAAK,2BAA2B;IACxC,KAAK,EAAQ,yBAAyB;IACtC,OAAO,EAAM,0BAA0B;IACvC,QAAQ,EAAK,+BAA+B;IAC5C,QAAQ,EAAK,yBAAyB;IACtC,SAAS,EAAI,4BAA4B;IACzC,MAAM,EAAO,uCAAuC;IACpD,WAAW,EAAE,iBAAiB;CACtB,CAAC;AAsEX;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,oBAAoB,CAAC,QAAQ,CAAC,KAA0B,CAAC,CAAC;AAChG,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,OAAO,EAAE,OAAO;CACjB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAC1D,SAAS;IACT,YAAY,EAAE,QAAQ;IACtB,cAAc,EAAE,QAAQ;IACxB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,eAAe,EAAE,QAAQ;IACzB,WAAW,EAAE,QAAQ;IACrB,eAAe,EAAE,QAAQ;IACzB,cAAc,EAAE,QAAQ;IACxB,cAAc,EAAE,QAAQ;IACxB,WAAW;IACX,cAAc,EAAE,UAAU;IAC1B,QAAQ,EAAE,UAAU;IACpB,gBAAgB,EAAE,UAAU;IAC5B,gBAAgB,EAAE,UAAU;IAC5B,iBAAiB,EAAE,UAAU;IAC7B,YAAY;IACZ,eAAe,EAAE,WAAW;IAC5B,iBAAiB,EAAE,WAAW;IAC9B,YAAY;IACZ,aAAa,EAAE,SAAS;IACxB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IACjB,oBAAoB,EAAE,SAAS;IAC/B,WAAW;IACX,cAAc,EAAE,UAAU;IAC1B,SAAS,EAAE,UAAU;IACrB,UAAU;IACV,aAAa,EAAE,SAAS;IACxB,UAAU,EAAE,SAAS;IACrB,eAAe,EAAE,SAAS;IAC1B,SAAS;IACT,YAAY,EAAE,QAAQ;IACtB,eAAe,EAAE,QAAQ;IACzB,eAAe;IACf,eAAe,EAAE,WAAW;IAC5B,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,QAAQ;IACtB,cAAc,EAAE,UAAU;IAC1B,iBAAiB;IACjB,UAAU,EAAE,MAAM;IAClB,WAAW,EAAE,OAAO;IACpB,gBAAgB,EAAE,YAAY;IAC9B,WAAW,EAAE,OAAO;IACpB,YAAY,EAAE,QAAQ;IACtB,WAAW,EAAE,QAAQ;IACrB,8CAA8C;IAC9C,iBAAiB,EAAE,OAAO;IAC1B,kBAAkB,EAAE,SAAS;IAC7B,oBAAoB,EAAE,SAAS;CAChC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAiB;IACxD,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAElE,0BAA0B;QAC1B,IAAI,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,OAAO,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC;QAED,4DAA4D;QAC5D,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC;YACpE,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC;gBACpC,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,+EAA+E;QAC/E,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,2CAA2C;QAC7E,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,gCAAgC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,0BAA0B,CAAC,SAAkB,EAAE,IAAa;IAC1E,0BAA0B;IAC1B,IAAI,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAE3C,+BAA+B;IAC/B,IAAI,2DAA2D,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACzE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,0CAA0C;IAC1C,IAAI,+DAA+D,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8CAA8C;IAC9C,OAAO,KAAK,CAAC;AACf,CAAC;AAuBD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,MAAM,GAAc,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QAEzC,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAEhD,IAAI,MAAM;YAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACnC,IAAI,MAAM;YAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACnC,IAAI,QAAQ;YAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzC,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QAC7B,IAAI,OAAO;YAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-shared",
-  "version": "2.1.174",
+  "version": "2.1.176",
   "scripts": {
     "clean": "find dist -type f -delete 2>/dev/null || true",
     "build:esm": "tsc -p tsconfig.esm.json && node scripts/add-js-extensions.js",