crexperium-sdk 1.2.2 → 1.2.4

package/dist/index.js

@@ -451,11 +451,43 @@ class EventsResource extends BaseResource {
  */
 class ContactsResource extends BaseResource {
     /**
-     * Identify a contact (create or update)
+     * Identify a contact (create or update by multiple identifiers)
+     *
+     * Accepts at least ONE of: externalId, visitorId, email, or phone
+     * Priority: externalId > visitorId > email > phone
+     *
+     * @example
+     * // Identify by external ID (after login)
+     * await client.contacts.identify({
+     *   externalId: 'user_123',
+     *   email: 'user@example.com',
+     *   firstName: 'John'
+     * });
+     *
+     * @example
+     * // Identify by visitor ID (anonymous → known)
+     * await client.contacts.identify({
+     *   visitorId: client.visitorId.getVisitorId(),
+     *   email: 'user@example.com'
+     * });
+     *
+     * @example
+     * // Identify by email only
+     * await client.contacts.identify({
+     *   email: 'user@example.com',
+     *   firstName: 'John'
+     * });
+     *
+     * @example
+     * // Identify by phone only
+     * await client.contacts.identify({
+     *   phone: '+1234567890'
+     * });
      */
     async identify(options) {
-        if (!options.externalId) {
-            throw new Error('externalId is required');
+        // Validate that at least one identifier is provided
+        if (!options.externalId && !options.visitorId && !options.email && !options.phone) {
+            throw new Error('At least one identifier is required: externalId, visitorId, email, or phone');
         }
         const data = this.cleanObject(this.toSnakeCase(options));
         return this.http.post('/api/v1/contacts/identify/', data);
@@ -13187,18 +13219,13 @@ class SessionReplayPlugin {
      */
     async init() {
         try {
-            console.log('[SessionReplay] Initializing session replay...');
             // Start session on backend
             await this.startSession();
-            console.log('[SessionReplay] Session started on backend, sessionId:', this.session?.sessionId);
             // Start rrweb recording
-            console.log('[SessionReplay] Starting rrweb recording...');
             this.startRrwebRecording();
-            console.log('[SessionReplay] rrweb recording started');
             // IMPORTANT: Flush initial events (Type 4 Meta + Type 2 Full Snapshot) immediately
             // so the session is playable right away, don't wait for the 5s flush interval
             setTimeout(() => {
-                console.log('[SessionReplay] Performing initial flush of critical events...');
                 this.flush();
             }, 100); // Small delay to ensure rrweb events are captured
             // Intercept console methods
@@ -13273,17 +13300,9 @@ class SessionReplayPlugin {
         this.stopRecording = record({
             emit: (event) => {
                 // Debug: Log event types
-                if (event.type === 4) {
-                    console.log('[SessionReplay] Captured Meta event (type 4)');
-                }
-                else if (event.type === 2) {
-                    console.log('[SessionReplay] Captured Full Snapshot event (type 2)');
-                }
                 this.eventBuffer.push(event);
-                console.log(`[SessionReplay] Event buffered. Type: ${event.type}, Buffer size: ${this.eventBuffer.length}`);
                 // Auto-flush if buffer reaches max size
                 if (this.eventBuffer.length >= (this.config.buffering?.maxBufferSize || 100)) {
-                    console.log('[SessionReplay] Buffer full, flushing...');
                     this.flush();
                 }
             },
@@ -13625,16 +13644,12 @@ class SessionReplayPlugin {
      * Flush buffered events to backend
      */
     async flush() {
-        console.log(`[SessionReplay] flush() called. Session: ${!!this.session}, Event buffer: ${this.eventBuffer.length}, Telemetry buffer: ${this.telemetryBuffer.length}`);
         if (!this.session) {
-            console.warn('[SessionReplay] flush() skipped - no session yet!');
             return;
         }
         if (this.eventBuffer.length === 0 && this.telemetryBuffer.length === 0) {
-            console.log('[SessionReplay] flush() skipped - buffers empty');
             return;
         }
-        console.log(`[SessionReplay] Flushing ${this.eventBuffer.length} events to backend...`);
         const eventsToSend = [...this.eventBuffer];
         const telemetryToSend = [...this.telemetryBuffer];
         // Clear buffers