@datalyr/web 1.0.7 → 1.1.1

package/README.md

@@ -21,6 +21,76 @@ The official Datalyr Web SDK for browser-based analytics. Track user behavior, m
 - 🔌 **Extensible** - Plugin system for custom functionality
 - 📦 **Container Scripts** - Securely manage third-party pixels and tracking scripts
 
+## Choosing the Right Installation Method
+
+Datalyr offers two installation methods. Choose based on your needs:
+
+### Script Tag (Recommended for Most Cases)
+
+**Use when:** Simple setup, zero bundle size, no build step needed
+
+```html
+<script defer src="https://track.datalyr.com/container.js"
+        data-workspace-id="YOUR_WORKSPACE_ID"></script>
+```
+
+**Pros:**
+- ✅ Zero bundle size (external script)
+- ✅ No npm install needed
+- ✅ Works in any HTML page
+- ✅ Automatic initialization
+- ✅ Perfect for Next.js, React, Vue
+
+**API Usage:**
+```javascript
+// Available globally after script loads
+window.datalyr.track('event_name', { key: 'value' })
+window.datalyr.identify('user_123', { email: 'user@example.com' })
+window.datalyr.getVisitorId()
+```
+
+[See Script Tag Documentation →](https://docs.datalyr.com/installation/script-tag)
+
+---
+
+### NPM Package (For TypeScript/Bundlers)
+
+**Use when:** You need TypeScript support, ES modules, or tree-shaking
+
+```bash
+npm install @datalyr/web
+```
+
+**Pros:**
+- ✅ Full TypeScript definitions
+- ✅ ES module imports
+- ✅ Tree-shaking support
+- ✅ Better IDE autocomplete
+
+**API Usage:**
+```javascript
+import datalyr from '@datalyr/web'
+
+datalyr.init({ workspaceId: 'YOUR_WORKSPACE_ID' })
+datalyr.track('event_name', { key: 'value' })
+datalyr.identify('user_123', { email: 'user@example.com' })
+```
+
+---
+
+### ⚠️ Important: Don't Mix Both Methods
+
+Choose **one** installation method. Using both can cause conflicts:
+
+```html
+<!-- ❌ DON'T DO THIS -->
+<script src="https://track.datalyr.com/container.js"></script>
+<script>
+  import datalyr from '@datalyr/web'  // Both methods at once!
+  datalyr.init({...})
+</script>
+```
+
 ## Installation
 
 ```bash
@@ -65,19 +135,17 @@ import datalyr from '@datalyr/web';
 // Initialize the SDK with configuration
 datalyr.init({
   workspaceId: 'YOUR_WORKSPACE_ID',
-  
+
   // Optional configuration
-  // endpoint: 'https://custom.endpoint.com',  // Optional: Custom endpoint
   debug: false,                             // Enable debug logging
-  // batchSize: 10,                           // Optional: Events per batch
-  // flushInterval: 5000,                     // Optional: Flush interval (ms)
   sessionTimeout: 1800000,                 // 30 minutes
   privacyMode: 'standard',                 // 'standard' or 'strict'
   respectDoNotTrack: false,                // Honor browser DNT
   respectGlobalPrivacyControl: true,       // Honor GPC
   cookieDomain: 'auto',                    // Auto-detect for subdomains
   trackSPA: true,                          // Track SPA route changes
-  trackPageViews: true                     // Track initial page view
+  trackPageViews: true,                    // Track initial page view
+  enableContainer: true                    // Enable container script loading
 });
 ```
 
@@ -202,11 +270,11 @@ datalyr.setConsent({
 // Get current session ID
 const sessionId = datalyr.getSessionId();
 
-// Manually end session
-datalyr.endSession();
-
 // Start new session
 datalyr.startNewSession();
+
+// Get session data
+const sessionData = datalyr.getSessionData();
 ```
 
 ## Advanced Features
@@ -221,7 +289,7 @@ datalyr.track('Purchase', { value: 99.99 });
 datalyr.track('Signup', { plan: 'premium' });
 datalyr.track('Subscribe', { plan: 'annual' });
 
-// E-commerce events  
+// E-commerce events
 datalyr.track('Add to Cart', { product_id: 'SKU-123' });
 datalyr.track('Begin Checkout', { cart_value: 199.99 });
 ```
@@ -365,19 +433,19 @@ import datalyr from '@datalyr/web';
 // Create a plugin
 const myPlugin = {
   name: 'my-plugin',
-  
+
   initialize(datalyr) {
     console.log('Plugin initialized');
   },
-  
+
   track(eventName, properties) {
     console.log('Event tracked:', eventName);
   },
-  
+
   identify(userId, traits) {
     console.log('User identified:', userId);
   },
-  
+
   page(properties) {
     console.log('Page tracked');
   }
@@ -435,13 +503,13 @@ function App() {
       workspaceId: 'YOUR_WORKSPACE_ID'
     });
   }, []);
-  
+
   const handleClick = () => {
     datalyr.track('Button Clicked', {
       button_name: 'CTA'
     });
   };
-  
+
   return <button onClick={handleClick}>Click Me</button>;
 }
 ```
@@ -481,10 +549,19 @@ import datalyr from '@datalyr/web';
 export function AnalyticsProvider({ children }) {
   useEffect(() => {
     datalyr.init({
-      workspaceId: process.env.NEXT_PUBLIC_DATALYR_WORKSPACE_ID
+      workspaceId: process.env.NEXT_PUBLIC_DATALYR_WORKSPACE_ID,
+      debug: process.env.NODE_ENV === 'development'
     });
+
+    // Verify initialization
+    console.log('✅ Datalyr initialized');
+    console.log('Session ID:', datalyr.getSessionId());
+    console.log('Anonymous ID:', datalyr.getAnonymousId());
+
+    // Track initial page view
+    datalyr.page();
   }, []);
-  
+
   return children;
 }
 
@@ -516,13 +593,13 @@ When implementing authentication flows (login, signup, OAuth), you **MUST** call
 // ❌ WRONG - Server-side identify breaks attribution
 app.post('/api/login', async (req, res) => {
   const user = await authenticate(email, password);
-  
+
   // This creates a NEW session without attribution data!
   await serverAnalytics.identify({
     userId: user.id,
     traits: { email: user.email }
   });
-  
+
   res.json({ userId: user.id });
 });
 // Result: Lost UTM params, fbclid, gclid, referrer - all gone!
@@ -540,16 +617,16 @@ function LoginPage() {
       method: 'POST',
       body: JSON.stringify({ email, password })
     });
-    
+
     const { userId, email, name } = await response.json();
-    
+
     // 2. Identify in browser - this preserves attribution!
     datalyr.identify(userId, {
       email: email,
       name: name,
       login_method: 'email'
     });
-    
+
     // 3. Then redirect
     router.push('/dashboard');
   };
@@ -558,7 +635,7 @@ function LoginPage() {
 // Server endpoint - NO identify, just auth
 app.post('/api/login', async (req, res) => {
   const user = await authenticate(email, password);
-  
+
   // Just return user data for client-side identify
   res.json({
     userId: user.id,
@@ -605,7 +682,7 @@ useEffect(() => {
           auth_method: 'google',
           signup_source: localStorage.getItem('signup_source') || 'organic'
         });
-        
+
         // Track the appropriate event
         if (user.isNewUser) {
           datalyr.track('Signup Completed', { method: 'oauth' });
@@ -619,9 +696,9 @@ useEffect(() => {
 // Server-side: OAuth callback - NO identify!
 export async function GET(request: Request) {
   const { user } = await validateOAuthCallback(request);
-  
+
   const existingUser = await getUserByEmail(user.email);
-  
+
   if (existingUser) {
     // Set session, but DON'T identify
     await createSession(existingUser.id);
@@ -644,10 +721,10 @@ Use server-side for **tracking events** with userId (not identify):
 // Stripe webhook example
 app.post('/webhook/stripe', async (req, res) => {
   const event = stripe.webhooks.constructEvent(req.body, sig, secret);
-  
+
   if (event.type === 'checkout.session.completed') {
     const session = event.data.object;
-    
+
     // Track purchase event with userId (NOT identify)
     await analytics.track({
       userId: session.client_reference_id,  // Your user ID
@@ -733,9 +810,9 @@ async function handleLogin(email, password) {
     method: 'POST',
     body: JSON.stringify({ email, password })
   });
-  
+
   const user = await response.json();
-  
+
   // Identify in browser - preserves attribution!
   datalyr.identify(user.id, {
     email: user.email,
@@ -748,16 +825,14 @@ async function handleLogin(email, password) {
 // This breaks attribution tracking!
 app.post('/api/login', async (req, res) => {
   const user = await authenticate(req.body);
-  
+
   // DON'T DO THIS - Creates new session
   await serverAnalytics.identify(user.id, {
     signup_date: new Date().toISOString()
   });
-  
-  datalyr.track('Signup Completed', {
-    method: 'email'
-  });
-}
+
+  res.json({ success: true });
+});
 ```
 
 ### 5. Handle Errors Gracefully
@@ -775,31 +850,149 @@ window.addEventListener('error', (event) => {
 });
 ```
 
+## Troubleshooting
+
+### Events Not Showing in Dashboard?
+
+**Step 1: Verify SDK is initialized**
+```javascript
+import datalyr from '@datalyr/web'
+
+// Check these return values
+console.log('Anonymous ID:', datalyr.getAnonymousId())  // Should return "anon_xxxxx"
+console.log('Session ID:', datalyr.getSessionId())      // Should return "sess_xxxxx"
+```
+
+If these return `undefined`, the SDK isn't initialized properly.
+
+**Step 2: Check for errors**
+```javascript
+console.log('Errors:', datalyr.getErrors())  // Should be empty [] or show errors
+```
+
+**Step 3: Enable debug mode**
+```javascript
+datalyr.init({
+  workspaceId: 'YOUR_WORKSPACE_ID',
+  debug: true  // Shows [Datalyr] logs in console
+})
+```
+
+**Step 4: Verify network requests**
+1. Open DevTools → Network tab
+2. Filter by "ingest"
+3. Track a test event: `datalyr.track('test', {})`
+4. You should see POST to `ingest.datalyr.com`
+
+### Common Errors
+
+**"Cannot find module '@datalyr/web'"**
+- Run `npm install @datalyr/web`
+- Restart your dev server
+
+**"process.env.NEXT_PUBLIC_DATALYR_WORKSPACE_ID is undefined"**
+- Create `.env.local` file in project root
+- Add: `NEXT_PUBLIC_DATALYR_WORKSPACE_ID=your_id`
+- Restart dev server (required for env changes)
+
+**"datalyr.getAnonymousId() returns undefined"**
+- You're calling it during SSR (server-side rendering)
+- Make sure you're in a Client Component with `'use client'`
+- Call it inside `useEffect` or after component mounts
+
+**Events tracked but not in dashboard**
+- Verify workspace ID matches your dashboard
+- Events may take 1-2 minutes to appear
+- Check Network tab - requests should return 200 OK
+- Check if ad blocker is enabled (disable it)
+
+### Script Tag vs SDK Confusion
+
+**If you're using the script tag:**
+```javascript
+// Check if loaded
+window.datalyr._isLoaded        // Should be true
+window.datalyr.getVisitorId()   // Should return ID
+
+// Use object methods, not function calls
+window.datalyr.track('event', {})     // ✅ Correct
+window.datalyr("track", "event", {})  // ❌ Wrong
+```
+
+**If you're using the NPM SDK:**
+```javascript
+import datalyr from '@datalyr/web'
+
+// Check if loaded
+datalyr.getAnonymousId()  // Should return ID
+datalyr.getSessionId()    // Should return ID
+```
+
 ## Migration from Script Tag
 
-If you're currently using the Datalyr script tag, migration is straightforward:
+If you're currently using the Datalyr script tag and want to switch to the NPM package:
 
 ### Before (Script Tag):
 ```html
-<script>
-  window.datalyr = window.datalyr || [];
-  window.datalyr.push(['init', { workspace_id: 'YOUR_WORKSPACE_ID' }]);
-  window.datalyr.push(['track', 'Button Clicked']);
-</script>
-<script async src="https://cdn.datalyr.io/datalyr.js"></script>
+<!-- In your HTML -->
+<script defer src="https://track.datalyr.com/container.js"
+        data-workspace-id="YOUR_WORKSPACE_ID"></script>
+```
+
+```javascript
+// In your JavaScript
+window.datalyr.track('Button Clicked', {
+  button_name: 'Sign Up'
+});
+
+window.datalyr.identify('user_123', {
+  email: 'user@example.com'
+});
 ```
 
-### After (Web SDK):
+### After (NPM SDK):
 ```javascript
+// Remove the script tag from your HTML
+
+// Install the package
+// npm install @datalyr/web
+
+// In your app initialization
 import datalyr from '@datalyr/web';
 
 datalyr.init({
   workspaceId: 'YOUR_WORKSPACE_ID'
 });
 
-datalyr.track('Button Clicked');
+// In your components
+datalyr.track('Button Clicked', {
+  button_name: 'Sign Up'
+});
+
+datalyr.identify('user_123', {
+  email: 'user@example.com'
+});
 ```
 
+**Note:** Most users should stay with the script tag unless they specifically need TypeScript support or ES module imports. The script tag has zero bundle size and works perfectly with Next.js, React, and Vue.
+
+## API Comparison: Script Tag vs NPM SDK
+
+| Feature | Script Tag | NPM SDK |
+|---------|-----------|---------|
+| **Installation** | Add `<script>` to HTML | `npm install @datalyr/web` |
+| **Bundle Size** | 0 (external) | ~15KB |
+| **TypeScript** | No types | ✅ Full types |
+| **Import** | `window.datalyr` | `import datalyr from '@datalyr/web'` |
+| **Initialize** | Automatic | `datalyr.init({...})` |
+| **Track Event** | `window.datalyr.track(...)` | `datalyr.track(...)` |
+| **Identify** | `window.datalyr.identify(...)` | `datalyr.identify(...)` |
+| **Get Visitor ID** | `window.datalyr.getVisitorId()` | `datalyr.getAnonymousId()` |
+| **Get Session** | `window.datalyr._getSessionId()` | `datalyr.getSessionId()` |
+| **Check Loaded** | `window.datalyr._isLoaded` | `datalyr.getAnonymousId() !== undefined` |
+
+Both methods use the same tracking backend and provide identical attribution tracking.
+
 ## Browser Support
 
 The SDK supports all modern browsers:
@@ -823,7 +1016,7 @@ For older browsers, the SDK will gracefully degrade with fallback implementation
 The SDK is designed with privacy in mind:
 
 - **GDPR Compliant**: Built-in consent management
-- **CCPA Support**: "Do Not Sell" preference support  
+- **CCPA Support**: "Do Not Sell" preference support
 - **Cookie Control**: Configurable cookie settings
 - **Data Minimization**: Collect only what you need
 - **User Rights**: Easy opt-out and data deletion
@@ -841,8 +1034,9 @@ datalyr.init({
 });
 
 // Check console for detailed logs:
+// [Datalyr] SDK initialized
 // [Datalyr] Event tracked: Button Clicked
-// [Datalyr] Events sent successfully
+// [Datalyr] Batch sent successfully: 5 events
 ```
 
 ## API Reference
@@ -883,6 +1077,8 @@ datalyr.init({
 | `getUserId()` | Get user ID |
 | `getDistinctId()` | Get distinct ID |
 | `getSessionId()` | Get session ID |
+| `getSessionData()` | Get session data |
+| `getErrors()` | Get SDK errors |
 | `loadScript(scriptId)` | Manually trigger a container script |
 | `getLoadedScripts()` | Get list of loaded container scripts |
 | `destroy()` | Clean up resources |
@@ -899,4 +1095,4 @@ MIT License - see [LICENSE](LICENSE) file for details.
 
 ---
 
-Built with ❤️ by the Datalyr team
+Built with ❤️ by the Datalyr team

package/dist/attribution.d.ts

@@ -6,6 +6,7 @@ import type { Attribution, TouchPoint } from './types';
 export declare class AttributionManager {
     private attributionWindow;
     private trackedParams;
+    private queryParamsCache;
     private UTM_PARAMS;
     private CLICK_IDS;
     private DEFAULT_TRACKED_PARAMS;
@@ -13,24 +14,34 @@ export declare class AttributionManager {
         attributionWindow?: number;
         trackedParams?: string[];
     });
+    /**
+     * Clear query params cache (called on page navigation)
+     * FIXED: Prevents stale attribution data on SPA navigation
+     */
+    clearCache(): void;
     /**
      * Capture current attribution from URL
      */
     captureAttribution(): Attribution;
     /**
-     * Store first touch attribution
+     * Store first touch attribution with 90-day expiration
+     *
+     * FIXED (DATA-01): Removed paid priority logic that was corrupting first-touch attribution.
+     * First-touch is now IMMUTABLE except for expiration - this ensures accurate revenue attribution.
      */
     storeFirstTouch(attribution: Attribution): void;
     /**
      * Get first touch attribution
+     * Checks expiry and removes if expired (Issue #4)
      */
     getFirstTouch(): Attribution | null;
     /**
-     * Store last touch attribution
+     * Store last touch attribution with 90-day expiration
      */
     storeLastTouch(attribution: Attribution): void;
     /**
      * Get last touch attribution
+     * Checks expiry and removes if expired (Issue #4)
      */
     getLastTouch(): Attribution | null;
     /**
@@ -47,10 +58,12 @@ export declare class AttributionManager {
     private captureAdCookies;
     /**
      * Check if we have a specific click ID in current params
+     * Uses cached params to avoid multiple URL parses (Issue #3)
      */
     private hasClickId;
     /**
      * Get current fbclid from URL if present
+     * Uses cached params to avoid multiple URL parses (Issue #3)
      */
     private getCurrentFbclid;
     /**

package/dist/attribution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../src/attribution.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEvD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,aAAa,CAAW;IAChC,OAAO,CAAC,UAAU,CAA2E;IAE7F,OAAO,CAAC,SAAS,CAgBf;IAEF,OAAO,CAAC,sBAAsB,CAO5B;gBAEU,OAAO,GAAE;QACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB;IAMN;;OAEG;IACH,kBAAkB,IAAI,WAAW;IAwDjC;;OAEG;IACH,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAU/C;;OAEG;IACH,aAAa,IAAI,WAAW,GAAG,IAAI;IAInC;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAO9C;;OAEG;IACH,YAAY,IAAI,WAAW,GAAG,IAAI;IAIlC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI;IAqBhE;;OAEG;IACH,UAAU,IAAI,UAAU,EAAE;IAI1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA8CxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAsDzC;;OAEG;IACH,OAAO,CAAC,eAAe;IA6CvB;;OAEG;IACH,OAAO,CAAC,eAAe;IA2BvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAKvD;;OAEG;IACH,uBAAuB,IAAI,IAAI;CAYhC"}
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../src/attribution.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEvD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,aAAa,CAAW;IAChC,OAAO,CAAC,gBAAgB,CAAuC;IAC/D,OAAO,CAAC,UAAU,CAA2E;IAE7F,OAAO,CAAC,SAAS,CAgBf;IAEF,OAAO,CAAC,sBAAsB,CAO5B;gBAEU,OAAO,GAAE;QACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB;IAMN;;;OAGG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,kBAAkB,IAAI,WAAW;IA8DjC;;;;;OAKG;IACH,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAwB/C;;;OAGG;IACH,aAAa,IAAI,WAAW,GAAG,IAAI;IASnC;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAQ9C;;;OAGG;IACH,YAAY,IAAI,WAAW,GAAG,IAAI;IASlC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI;IAqBhE;;OAEG;IACH,UAAU,IAAI,UAAU,EAAE;IAI1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA8CxB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAKlB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IA0EzC;;OAEG;IACH,OAAO,CAAC,eAAe;IA6CvB;;OAEG;IACH,OAAO,CAAC,eAAe;IA2BvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAKvD;;OAEG;IACH,uBAAuB,IAAI,IAAI;CAYhC"}

package/dist/auto-identify.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Auto-Identify Module
+ *
+ * Automatically captures user identity (email) from:
+ * 1. Fetch/XHR API requests (email in request/response)
+ * 2. Form submissions (email inputs)
+ * 3. Shopify-specific endpoints (/account.json)
+ *
+ * SECURITY:
+ * - Email validation to prevent false positives
+ * - Whitelist approach for trusted domains
+ * - Rate limiting to prevent spam
+ * - Privacy controls integration
+ */
+interface AutoIdentifyConfig {
+    enabled?: boolean;
+    captureFromForms?: boolean;
+    captureFromAPI?: boolean;
+    captureFromShopify?: boolean;
+    trustedDomains?: string[];
+    debug?: boolean;
+}
+export declare class AutoIdentifyManager {
+    private config;
+    private identifyCallback?;
+    private originalFetch?;
+    private originalXHROpen?;
+    private originalXHRSend?;
+    private formListeners;
+    private lastIdentifyTime;
+    private RATE_LIMIT_MS;
+    private shopifyCheckInterval?;
+    constructor(config?: AutoIdentifyConfig);
+    /**
+     * Initialize auto-identify system
+     */
+    initialize(identifyCallback: (email: string, source: string) => void): void;
+    /**
+     * Setup form monitoring for email capture
+     */
+    private setupFormMonitoring;
+    /**
+     * Scan DOM for forms with email inputs
+     */
+    private scanForEmailForms;
+    /**
+     * Handle form submission
+     */
+    private handleFormSubmit;
+    /**
+     * Setup fetch interception for API email capture
+     */
+    private setupFetchInterception;
+    /**
+     * Setup XHR interception for API email capture
+     */
+    private setupXHRInterception;
+    /**
+     * Setup Shopify-specific monitoring
+     */
+    private setupShopifyMonitoring;
+    /**
+     * Check if running on Shopify
+     */
+    private isShopify;
+    /**
+     * Check Shopify customer endpoint for email
+     */
+    private checkShopifyCustomer;
+    /**
+     * Extract email from data (object, string, FormData)
+     */
+    private extractEmailFromData;
+    /**
+     * Recursively find emails in object
+     */
+    private findEmailsInObject;
+    /**
+     * Check if domain is trusted for auto-identify
+     */
+    private isTrustedDomain;
+    /**
+     * Validate email format
+     */
+    private isValidEmail;
+    /**
+     * Trigger identify with rate limiting
+     */
+    private triggerIdentify;
+    /**
+     * Destroy and cleanup
+     */
+    destroy(): void;
+    /**
+     * Debug logging
+     */
+    private log;
+}
+export {};
+//# sourceMappingURL=auto-identify.d.ts.map

package/dist/auto-identify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-identify.d.ts","sourceRoot":"","sources":["../src/auto-identify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,UAAU,kBAAkB;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,gBAAgB,CAAC,CAA0C;IACnE,OAAO,CAAC,aAAa,CAAC,CAAsB;IAC5C,OAAO,CAAC,eAAe,CAAC,CAAuC;IAC/D,OAAO,CAAC,eAAe,CAAC,CAAuC;IAC/D,OAAO,CAAC,aAAa,CAA+D;IACpF,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,oBAAoB,CAAC,CAAiC;gBAElD,MAAM,GAAE,kBAAuB;IAW3C;;OAEG;IACH,UAAU,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAgC3E;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgD9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA2C5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAmB9B;;OAEG;IACH,OAAO,CAAC,SAAS;IAQjB;;OAEG;YACW,oBAAoB;IA0BlC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAwC5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB;;OAEG;IACH,OAAO,IAAI,IAAI;IAiCf;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ"}