@datalyr/web 1.4.1 → 1.5.0

package/dist/datalyr.cjs.js

@@ -1,5 +1,5 @@
 /**
- * @datalyr/web v1.4.1
+ * @datalyr/web v1.5.0
  * Datalyr Web SDK - Modern attribution tracking for web applications
  * (c) 2026 Datalyr Inc.
  * Released under the MIT License
@@ -3759,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
      */