crexperium-sdk 1.2.6 → 1.2.7

package/dist/index.js

@@ -453,53 +453,134 @@ class ContactsResource extends BaseResource {
     /**
      * Identify a contact (create or update by multiple identifiers)
      *
-     * Accepts at least ONE of: externalId, visitorId, email, or phone
+     * Accepts at least ONE of: externalId, visitorId, email, phone, emailAddresses, or phoneNumbers
      * Priority: externalId > visitorId > email > phone
      *
+     * When creating a new contact, at least one of email/emailAddresses OR phone/phoneNumbers is required.
+     * All name fields are optional.
+     *
      * @example
-     * // Identify by external ID (after login)
+     * // Identify by email only
      * await client.contacts.identify({
-     *   externalId: 'user_123',
-     *   email: 'user@example.com',
-     *   firstName: 'John'
+     *   email: 'user@example.com'
      * });
      *
      * @example
-     * // Identify by visitor ID (anonymous → known)
+     * // Identify by phone only
      * await client.contacts.identify({
-     *   visitorId: client.visitorId.getVisitorId(),
-     *   email: 'user@example.com'
+     *   phone: '+1234567890',
+     *   firstName: 'John'
      * });
      *
      * @example
-     * // Identify by email only
+     * // Identify with multiple emails/phones
      * await client.contacts.identify({
-     *   email: 'user@example.com',
-     *   firstName: 'John'
+     *   externalId: 'user_123',
+     *   emailAddresses: ['user@example.com', 'alt@example.com'],
+     *   phoneNumbers: ['+1234567890']
      * });
      *
      * @example
-     * // Identify by phone only
+     * // Identify by visitor ID (anonymous → known)
      * await client.contacts.identify({
-     *   phone: '+1234567890'
+     *   visitorId: client.visitorId.getVisitorId(),
+     *   email: 'user@example.com'
      * });
      */
     async identify(options) {
         // 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 hasIdentifier = !!(options.externalId ||
+            options.visitorId ||
+            options.email ||
+            options.phone ||
+            (options.emailAddresses && options.emailAddresses.length > 0) ||
+            (options.phoneNumbers && options.phoneNumbers.length > 0));
+        if (!hasIdentifier) {
+            throw new Error('At least one identifier is required: externalId, visitorId, email, phone, emailAddresses, or phoneNumbers');
+        }
+        // Build email_addresses array
+        const emailAddresses = [...(options.emailAddresses || [])];
+        if (options.email && !emailAddresses.includes(options.email)) {
+            emailAddresses.unshift(options.email); // Primary email goes first
+        }
+        // Build phone_numbers array
+        const phoneNumbers = [...(options.phoneNumbers || [])];
+        if (options.phone && !phoneNumbers.includes(options.phone)) {
+            phoneNumbers.unshift(options.phone); // Primary phone goes first
+        }
+        // Build request data
+        const data = {
+            ...this.toSnakeCase(options),
+            email_addresses: emailAddresses.length > 0 ? emailAddresses : undefined,
+            phone_numbers: phoneNumbers.length > 0 ? phoneNumbers : undefined,
+        };
+        // Remove single email/phone since they're now in arrays
+        if (emailAddresses.length > 0) {
+            delete data.email;
         }
-        const data = this.cleanObject(this.toSnakeCase(options));
-        return this.http.post('/api/v1/contacts/identify/', data);
+        if (phoneNumbers.length > 0) {
+            delete data.phone;
+        }
+        const cleanedData = this.cleanObject(data);
+        return this.http.post('/api/v1/contacts/identify/', cleanedData);
     }
     /**
      * Create a new contact
+     *
+     * At least one of email/emailAddresses OR phone/phoneNumbers is required.
+     * All name fields (firstName, lastName) are optional.
+     *
+     * @example
+     * // Create with email only
+     * await client.contacts.create({
+     *   email: 'user@example.com'
+     * });
+     *
+     * @example
+     * // Create with phone only
+     * await client.contacts.create({
+     *   phone: '+1234567890',
+     *   firstName: 'John'
+     * });
+     *
+     * @example
+     * // Create with multiple emails/phones
+     * await client.contacts.create({
+     *   emailAddresses: ['user@example.com', 'alt@example.com'],
+     *   phoneNumbers: ['+1234567890'],
+     *   firstName: 'Jane',
+     *   lastName: 'Doe'
+     * });
      */
     async create(data) {
-        if (!data.email && !data.external_id) {
-            throw new Error('Either email or external_id is required');
+        // Build email_addresses array
+        const emailAddresses = [...(data.emailAddresses || [])];
+        if (data.email && !emailAddresses.includes(data.email)) {
+            emailAddresses.unshift(data.email);
+        }
+        // Build phone_numbers array
+        const phoneNumbers = [...(data.phoneNumbers || [])];
+        if (data.phone && !phoneNumbers.includes(data.phone)) {
+            phoneNumbers.unshift(data.phone);
+        }
+        // Validate at least one contact method
+        if (emailAddresses.length === 0 && phoneNumbers.length === 0) {
+            throw new Error('At least one contact method is required: provide either email/emailAddresses or phone/phoneNumbers');
+        }
+        // Build request data
+        const requestData = {
+            ...this.toSnakeCase(data),
+            email_addresses: emailAddresses.length > 0 ? emailAddresses : undefined,
+            phone_numbers: phoneNumbers.length > 0 ? phoneNumbers : undefined,
+        };
+        // Remove single email/phone since they're now in arrays
+        if (emailAddresses.length > 0) {
+            delete requestData.email;
         }
-        const cleanedData = this.cleanObject(this.toSnakeCase(data));
+        if (phoneNumbers.length > 0) {
+            delete requestData.phone;
+        }
+        const cleanedData = this.cleanObject(requestData);
         return this.http.post('/api/v1/contacts/', cleanedData);
     }
     /**