crexperium-sdk 1.2.1 → 1.2.3

package/dist/index.mjs

@@ -449,11 +449,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);
@@ -13193,6 +13225,12 @@ class SessionReplayPlugin {
             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
             if (this.config.telemetry?.captureConsole) {
                 this.interceptConsole();