@datalyr/web 1.4.0 → 1.5.0

package/README.md

@@ -1,6 +1,6 @@
 # @datalyr/web
 
-Browser SDK for event tracking, user identity, and attribution. Version 1.4.0.
+Browser SDK for event tracking, user identity, and attribution. Version 1.4.1.
 
 ## Table of Contents
 
@@ -116,7 +116,7 @@ Every event includes:
   workspace_id: 'wk_xxxxx',
   source: 'web',
   timestamp: '2024-01-15T10:30:00Z',
-  sdk_version: '1.4.0',
+  sdk_version: '1.4.1',
   sdk_name: 'datalyr-web-sdk'
 }
 ```

package/dist/datalyr.cjs.js

@@ -1,5 +1,5 @@
 /**
- * @datalyr/web v1.4.0
+ * @datalyr/web v1.5.0
  * Datalyr Web SDK - Modern attribution tracking for web applications
  * (c) 2026 Datalyr Inc.
  * Released under the MIT License
@@ -3707,6 +3707,12 @@ class Datalyr {
      * the React Native and iOS SDKs.
      */
     screen(screenName, properties = {}) {
+        if (!this.initialized) {
+            console.warn('[Datalyr] SDK not initialized. Call init() first.');
+            return;
+        }
+        if (!this.shouldTrack())
+            return;
         this.track('pageview', Object.assign({ screen: screenName }, properties));
     }
     /**
@@ -3753,6 +3759,57 @@ class Datalyr {
     getAnonymousId() {
         return this.identity.getAnonymousId();
     }
+    /**
+     * Get the current visitor ID (alias for getAnonymousId).
+     * Matches the `visitor_id` terminology used in the dashboard, schema,
+     * and integration guides — pass this to Stripe's `client_reference_id`
+     * or webhook metadata for first-party attribution.
+     */
+    getVisitorId() {
+        return this.identity.getAnonymousId();
+    }
+    /**
+     * Returns a metadata bundle ready to pass to Stripe so the webhook can
+     * deterministically link the payment back to this browser session (90%+
+     * attribution match vs. 70-85% email-only).
+     *
+     * Usage (Stripe Checkout Session):
+     *   stripe.checkout.sessions.create({
+     *     ...datalyr.getStripeMetadata(),
+     *     line_items: [...],
+     *   })
+     *
+     * Usage (PaymentIntent / Subscription / Customer):
+     *   stripe.paymentIntents.create({
+     *     amount, currency,
+     *     metadata: datalyr.getStripeMetadata().metadata,
+     *   })
+     *
+     * The server-side Datalyr webhook reads `client_reference_id` on Checkout
+     * and `metadata.visitor_id` on every other Stripe object.
+     */
+    getStripeMetadata() {
+        const visitorId = this.identity.getAnonymousId();
+        return {
+            client_reference_id: visitorId,
+            metadata: { visitor_id: visitorId },
+        };
+    }
+    /**
+     * Returns a metadata object ready to attach to a Whop checkout configuration.
+     * Whop inherits checkout-configuration metadata onto payments and memberships
+     * (https://docs.whop.com/api-reference/checkout-configurations/), so Datalyr
+     * can read `metadata.visitor_id` off every resulting webhook event.
+     *
+     * Usage:
+     *   whop.checkoutConfigurations.create({
+     *     plan_id,
+     *     metadata: datalyr.getWhopCheckoutMetadata(),
+     *   })
+     */
+    getWhopCheckoutMetadata() {
+        return { visitor_id: this.identity.getAnonymousId() };
+    }
     /**
      * Get the current user ID
      */
@@ -3929,7 +3986,7 @@ class Datalyr {
             resolution_method: 'browser_sdk',
             resolution_confidence: 1.0,
             // SDK metadata
-            sdk_version: '1.4.0',
+            sdk_version: '1.4.1',
             sdk_name: 'datalyr-web-sdk'
         };
         return payload;