cap-creatives-ui 8.0.280 → 8.0.321

package/app/v2Components/CommonTestAndPreview/DeliverySettings/constants.js

@@ -0,0 +1,79 @@
+/**
+ * DeliverySettings constants for Test and Preview (SMS, Email, WhatsApp).
+ * Aligned with cap-campaigns-v2 DeliverySettingsV2/ModifyDeliverySettings field names.
+ */
+
+import { CHANNELS } from '../constants';
+
+/** Placeholder shown in summary when a value is empty */
+export const SUMMARY_EMPTY_PLACEHOLDER = '—';
+
+/** Channel names — use CHANNELS.SMS, CHANNELS.EMAIL, CHANNELS.WHATSAPP from parent constants */
+export { CHANNELS } from '../constants';
+
+/** Delivery settings object keys (for get(deliverySettings, key) / updateSetting(key, value)) */
+export const DELIVERY_SETTING_KEY_DOMAIN_ID = 'domainId';
+export const DELIVERY_SETTING_KEY_DOMAIN_GATEWAY_MAP_ID = 'domainGatewayMapId';
+export const DELIVERY_SETTING_KEY_GSM_SENDER_ID = 'gsmSenderId';
+export const DELIVERY_SETTING_KEY_CDMA_SENDER_ID = 'cdmaSenderId';
+export const DELIVERY_SETTING_KEY_SENDER_EMAIL = 'senderEmail';
+export const DELIVERY_SETTING_KEY_SENDER_LABEL = 'senderLabel';
+export const DELIVERY_SETTING_KEY_SENDER_REPLY_TO = 'senderReplyTo';
+export const DELIVERY_SETTING_KEY_SOURCE_ACCOUNT_IDENTIFIER = 'sourceAccountIdentifier';
+export const DELIVERY_SETTING_KEY_SENDER_MOB_NUM = 'senderMobNum';
+/** RCS: SMS fallback domain (separate from primary RCS domainId) */
+export const DELIVERY_SETTING_KEY_SMS_FALLBACK_DOMAIN_ID = 'smsFallbackDomainId';
+
+/** data-testid for delivery settings edit icon */
+export const TEST_ID_DELIVERY_SETTINGS_EDIT = 'delivery-settings-edit';
+
+/** Prefix for row keys in field list map */
+export const ROW_KEY_PREFIX = 'row-';
+
+export const CHANNELS_WITH_DELIVERY_SETTINGS = [
+  CHANNELS.SMS,
+  CHANNELS.EMAIL,
+  CHANNELS.WHATSAPP,
+  CHANNELS.RCS,
+];
+
+/** Default empty delivery setting per channel (campaigns-style shape) */
+export const DEFAULT_DELIVERY_SETTING_SMS = {
+  domainId: null,
+  domainGatewayMapId: null,
+  gsmSenderId: '',
+  cdmaSenderId: '',
+};
+
+export const DEFAULT_DELIVERY_SETTING_EMAIL = {
+  domainId: null,
+  domainGatewayMapId: null,
+  senderEmail: '',
+  senderLabel: '',
+  senderReplyTo: '',
+};
+
+export const DEFAULT_DELIVERY_SETTING_WHATSAPP = {
+  domainId: null,
+  senderMobNum: '',
+  sourceAccountIdentifier: '',
+};
+
+/** RCS: gsmSenderId = RCS sender, cdmaSenderId = SMS fallback sender (reuse same keys) */
+export const DEFAULT_DELIVERY_SETTING_RCS = {
+  domainId: null,
+  domainGatewayMapId: null,
+  gsmSenderId: '',
+  smsFallbackDomainId: null,
+  cdmaSenderId: '',
+};
+
+export const DEFAULT_DELIVERY_SETTINGS_BY_CHANNEL = {
+  [CHANNELS.SMS]: DEFAULT_DELIVERY_SETTING_SMS,
+  [CHANNELS.EMAIL]: DEFAULT_DELIVERY_SETTING_EMAIL,
+  [CHANNELS.WHATSAPP]: DEFAULT_DELIVERY_SETTING_WHATSAPP,
+  [CHANNELS.RCS]: DEFAULT_DELIVERY_SETTING_RCS,
+};
+
+/** API `contactInfo.type` keys that map to RCS-style GSM sender rows (env-specific naming). */
+export const RCS_CONTACT_INFO_GSM_TYPE_KEYS = ['gsm_sender_id', 'rcs_sender_id', 'rcs_sender'];

package/app/v2Components/CommonTestAndPreview/DeliverySettings/index.js

@@ -0,0 +1,314 @@
+/**
+ * DeliverySettings — summary row + CapSlideBox trigger for Test and Preview.
+ * Rendered for SMS, Email, WhatsApp, RCS (ModifyDeliverySettings). RCS uses gsmSenderId + cdmaSenderId (SMS fallback).
+ *
+ * Reference: cap-campaigns-v2 DeliverySettingsV2 (summary + modify panel).
+ */
+
+import React, { useState, useCallback, useMemo } from "react";
+import PropTypes from "prop-types";
+import CapRow from "@capillarytech/cap-ui-library/CapRow";
+import CapHeading from "@capillarytech/cap-ui-library/CapHeading";
+import CapIcon from "@capillarytech/cap-ui-library/CapIcon";
+import CapLabel from "@capillarytech/cap-ui-library/CapLabel";
+import CapSlideBox from "@capillarytech/cap-ui-library/CapSlideBox";
+import { FormattedMessage } from "react-intl";
+import get from "lodash/get";
+import messages from "./messages";
+import ModifyDeliverySettings from "./ModifyDeliverySettings";
+import {
+  CHANNELS,
+  CHANNELS_WITH_DELIVERY_SETTINGS,
+  SUMMARY_EMPTY_PLACEHOLDER,
+  DELIVERY_SETTING_KEY_DOMAIN_ID,
+  DELIVERY_SETTING_KEY_GSM_SENDER_ID,
+  DELIVERY_SETTING_KEY_CDMA_SENDER_ID,
+  DELIVERY_SETTING_KEY_SENDER_EMAIL,
+  DELIVERY_SETTING_KEY_SENDER_LABEL,
+  DELIVERY_SETTING_KEY_SENDER_REPLY_TO,
+  DELIVERY_SETTING_KEY_SOURCE_ACCOUNT_IDENTIFIER,
+  DELIVERY_SETTING_KEY_SENDER_MOB_NUM,
+  TEST_ID_DELIVERY_SETTINGS_EDIT,
+} from "./constants";
+import "./DeliverySettings.scss";
+
+const DeliverySettings = (props) => {
+  const {
+    channel,
+    deliverySettings = {},
+    senderDetailsByChannel = {},
+    wecrmAccounts = [],
+    onSaveDeliverySettings,
+    isLoadingSenderDetails,
+    formatMessage,
+    smsTraiDltEnabled,
+    registeredSenderIds,
+    whatsappAccountFromForm,
+    isChannelSmsFallbackPreviewEnabled,
+  } = props;
+
+  const [isSlideBoxOpen, setSlideBoxOpen] = useState(false);
+
+  const openSlideBox = useCallback(() => setSlideBoxOpen(true), []);
+  const closeSlideBox = useCallback(() => setSlideBoxOpen(false), []);
+
+  const handleSave = useCallback(
+    (values) => {
+      onSaveDeliverySettings(values);
+      closeSlideBox();
+    },
+    [onSaveDeliverySettings, closeSlideBox]
+  );
+
+  const senderDetailsOptions = useMemo(
+    () => (senderDetailsByChannel[channel] || []),
+    [senderDetailsByChannel, channel],
+  );
+  const smsDomainsForRcs = useMemo(
+    () => (channel === CHANNELS.RCS ? (senderDetailsByChannel[CHANNELS.SMS] || []) : []),
+    [channel, senderDetailsByChannel],
+  );
+
+  if (!CHANNELS_WITH_DELIVERY_SETTINGS.includes(channel)) {
+    return null;
+  }
+
+  const notConfiguredLabel = formatMessage(messages.notConfigured);
+
+  const getDisplayFromDomains = (domains, compositeValue) => {
+    if (!compositeValue || !domains?.length) return compositeValue || SUMMARY_EMPTY_PLACEHOLDER;
+    for (const senderDomain of domains) {
+      for (const gsmSenderRow of senderDomain.gsmSenders || []) {
+        const value = senderDomain.domainId != null && gsmSenderRow.value != null
+          ? `${senderDomain.domainId}|${gsmSenderRow.value}`
+          : gsmSenderRow.value;
+        if (value === compositeValue && (senderDomain.domainName || gsmSenderRow.value)) {
+          return [senderDomain.domainName, gsmSenderRow.value].filter(Boolean).join(' · ');
+        }
+      }
+    }
+    return compositeValue || SUMMARY_EMPTY_PLACEHOLDER;
+  };
+
+  /** RCS summary: show sender ID only (no "domain · sender"). */
+  const getSenderIdOnlyFromComposite = (domains, compositeValue) => {
+    if (!compositeValue || !domains?.length) return compositeValue || SUMMARY_EMPTY_PLACEHOLDER;
+    for (const senderDomain of domains) {
+      for (const gsmSenderRow of senderDomain.gsmSenders || []) {
+        const value = senderDomain.domainId != null && gsmSenderRow.value != null
+          ? `${senderDomain.domainId}|${gsmSenderRow.value}`
+          : gsmSenderRow.value;
+        if (value === compositeValue && gsmSenderRow.value != null) {
+          return String(gsmSenderRow.value);
+        }
+      }
+    }
+    return compositeValue || SUMMARY_EMPTY_PLACEHOLDER;
+  };
+
+  const getSummaryText = () => {
+    const empty = SUMMARY_EMPTY_PLACEHOLDER;
+    if (channel === CHANNELS.RCS) {
+      const rcsVal = get(deliverySettings, DELIVERY_SETTING_KEY_GSM_SENDER_ID) || '';
+      const smsVal = get(deliverySettings, DELIVERY_SETTING_KEY_CDMA_SENDER_ID) || '';
+      const summaryRcs = {
+        rcsSenderId: getSenderIdOnlyFromComposite(senderDetailsOptions, rcsVal),
+      };
+      if (isChannelSmsFallbackPreviewEnabled) {
+        summaryRcs.smsFallbackSenderId = getSenderIdOnlyFromComposite(smsDomainsForRcs, smsVal);
+      }
+      return summaryRcs;
+    }
+    if (channel === CHANNELS.SMS) {
+      const domain = (senderDetailsOptions || []).find(
+        (senderDomain) => senderDomain.domainId === get(deliverySettings, DELIVERY_SETTING_KEY_DOMAIN_ID),
+      );
+      const domainName = domain?.domainName || empty;
+      const senderId = get(deliverySettings, DELIVERY_SETTING_KEY_GSM_SENDER_ID) || empty;
+      return { senderDomain: domainName, senderId };
+    }
+    if (channel === CHANNELS.EMAIL) {
+      const domain = (senderDetailsOptions || []).find(
+        (senderDomain) => senderDomain.domainId === get(deliverySettings, DELIVERY_SETTING_KEY_DOMAIN_ID),
+      );
+      const emailDomain = domain?.domainName || empty;
+      const senderEmail = get(deliverySettings, DELIVERY_SETTING_KEY_SENDER_EMAIL) || empty;
+      const senderLabel = get(deliverySettings, DELIVERY_SETTING_KEY_SENDER_LABEL) || empty;
+      const replyToId = get(deliverySettings, DELIVERY_SETTING_KEY_SENDER_REPLY_TO) || empty;
+      return {
+        emailDomain,
+        senderEmail,
+        senderLabel,
+        replyToId,
+      };
+    }
+    if (channel === CHANNELS.WHATSAPP) {
+      const account = (wecrmAccounts || []).find(
+        (a) => a.sourceAccountIdentifier
+          === get(deliverySettings, DELIVERY_SETTING_KEY_SOURCE_ACCOUNT_IDENTIFIER),
+      );
+      const accountName = account?.name || empty;
+      const senderNumber = get(deliverySettings, DELIVERY_SETTING_KEY_SENDER_MOB_NUM) || empty;
+      return { account: accountName, senderNumber };
+    }
+    return { account: empty, sender: empty };
+  };
+
+  const summary = getSummaryText();
+  let hasValues = false;
+  if (channel === CHANNELS.RCS) {
+    hasValues = (summary.rcsSenderId && summary.rcsSenderId !== SUMMARY_EMPTY_PLACEHOLDER)
+      || (isChannelSmsFallbackPreviewEnabled
+        && summary.smsFallbackSenderId
+        && summary.smsFallbackSenderId !== SUMMARY_EMPTY_PLACEHOLDER);
+  } else if (channel === CHANNELS.SMS) {
+    hasValues = summary.senderDomain !== SUMMARY_EMPTY_PLACEHOLDER
+      || summary.senderId !== SUMMARY_EMPTY_PLACEHOLDER;
+  } else if (channel === CHANNELS.EMAIL) {
+    hasValues = summary.emailDomain !== SUMMARY_EMPTY_PLACEHOLDER
+      || summary.senderEmail !== SUMMARY_EMPTY_PLACEHOLDER
+      || summary.senderLabel !== SUMMARY_EMPTY_PLACEHOLDER
+      || summary.replyToId !== SUMMARY_EMPTY_PLACEHOLDER;
+  } else if (channel === CHANNELS.WHATSAPP) {
+    hasValues = summary.account !== SUMMARY_EMPTY_PLACEHOLDER
+      || summary.senderNumber !== SUMMARY_EMPTY_PLACEHOLDER;
+  } else {
+    hasValues = summary.account !== SUMMARY_EMPTY_PLACEHOLDER
+      || summary.sender !== SUMMARY_EMPTY_PLACEHOLDER;
+  }
+
+  const getSummaryObject = () => {
+    if (!hasValues) return null;
+    const label = (msg) => formatMessage(msg);
+    if (channel === CHANNELS.RCS) {
+      const rcsSummary = {
+        [label(messages.rcsSenderIdLabel)]: summary.rcsSenderId,
+      };
+      if (isChannelSmsFallbackPreviewEnabled) {
+        rcsSummary[label(messages.fallbackSmsSenderIdLabel)] = summary.smsFallbackSenderId;
+      }
+      return rcsSummary;
+    }
+    if (channel === CHANNELS.SMS) {
+      return {
+        [label(messages.senderDomainSummary)]: summary.senderDomain,
+        [label(messages.senderId)]: summary.senderId,
+      };
+    }
+    if (channel === CHANNELS.EMAIL) {
+      return {
+        [label(messages.emailDomain)]: summary.emailDomain,
+        [label(messages.senderId)]: summary.senderEmail,
+        [label(messages.senderName)]: summary.senderLabel,
+        [label(messages.replyToId)]: summary.replyToId,
+      };
+    }
+    if (channel === CHANNELS.WHATSAPP) {
+      return {
+        [label(messages.account)]: summary.account,
+        [label(messages.senderNumber)]: summary.senderNumber,
+      };
+    }
+    return {
+      [label(messages.account)]: summary.account,
+      [label(messages.senderNumber)]: summary.sender,
+    };
+  };
+
+  const summaryObject = getSummaryObject();
+
+  return (
+    <CapRow className="delivery-settings">
+      <CapRow className="delivery-settings__heading-row">
+        <CapHeading type="h10">
+          <FormattedMessage {...messages.deliverySettings} />
+        </CapHeading>
+      </CapRow>
+      <CapRow type="flex" className="delivery-settings__summary-row">
+        <CapRow type="flex" className="delivery-settings__summary-inner">
+          {summaryObject == null ? (
+            <CapLabel type="label2">{notConfiguredLabel}</CapLabel>
+          ) : (
+            Object.entries(summaryObject).map(([key, value]) => (
+              <CapRow type="flex" key={key} className="delivery-settings__summary-entry">
+                <CapLabel type="label1" className="delivery-settings__summary-key">{key}</CapLabel>
+                <CapLabel type="label9" className="delivery-settings__summary-value">
+                  :
+                  {' '}
+                  {value}
+                </CapLabel>
+              </CapRow>
+            ))
+          )}
+        </CapRow>
+        <CapIcon
+          type="edit"
+          onClick={openSlideBox}
+          className="delivery-settings__edit-icon"
+          data-testid={TEST_ID_DELIVERY_SETTINGS_EDIT}
+          size="s"
+        />
+      </CapRow>
+
+      {isSlideBoxOpen && (
+        <CapSlideBox
+          show
+          size="size-l"
+          header={<FormattedMessage {...messages.deliverySettings} />}
+          handleClose={closeSlideBox}
+          content={(
+            <ModifyDeliverySettings
+              channel={channel}
+              deliverySettings={deliverySettings}
+              senderDetailsOptions={senderDetailsOptions}
+              smsFallbackSenderDetailsOptions={
+                channel === CHANNELS.RCS && isChannelSmsFallbackPreviewEnabled
+                  ? smsDomainsForRcs
+                  : undefined
+              }
+              wecrmAccounts={wecrmAccounts}
+              onSaveDeliverySettings={handleSave}
+              onClose={closeSlideBox}
+              isLoading={isLoadingSenderDetails}
+              formatMessage={formatMessage}
+              smsTraiDltEnabled={smsTraiDltEnabled}
+              registeredSenderIds={registeredSenderIds}
+              whatsappAccountFromForm={whatsappAccountFromForm}
+            />
+          )}
+        />
+      )}
+    </CapRow>
+  );
+};
+
+DeliverySettings.propTypes = {
+  channel: PropTypes.string.isRequired,
+  deliverySettings: PropTypes.object,
+  senderDetailsByChannel: PropTypes.object,
+  wecrmAccounts: PropTypes.array,
+  onSaveDeliverySettings: PropTypes.func,
+  isLoadingSenderDetails: PropTypes.bool,
+  formatMessage: PropTypes.func,
+  smsTraiDltEnabled: PropTypes.bool,
+  registeredSenderIds: PropTypes.array,
+  whatsappAccountFromForm: PropTypes.shape({
+    accountName: PropTypes.string,
+  }),
+  isChannelSmsFallbackPreviewEnabled: PropTypes.bool,
+};
+
+DeliverySettings.defaultProps = {
+  deliverySettings: {},
+  senderDetailsByChannel: {},
+  wecrmAccounts: [],
+  onSaveDeliverySettings: () => {},
+  isLoadingSenderDetails: false,
+  formatMessage: undefined,
+  smsTraiDltEnabled: false,
+  registeredSenderIds: [],
+  whatsappAccountFromForm: undefined,
+  isChannelSmsFallbackPreviewEnabled: false,
+};
+
+export default DeliverySettings;

package/app/v2Components/CommonTestAndPreview/DeliverySettings/messages.js

@@ -0,0 +1,141 @@
+/**
+ * DeliverySettings messages for Test and Preview.
+ * Aligned with cap-campaigns-v2 DeliverySettingsV2 and ModifyDeliverySettings messages.
+ */
+
+import { defineMessages } from 'react-intl';
+
+const prefix = 'creatives.CommonTestAndPreview.DeliverySettings';
+
+export default defineMessages({
+  deliverySettings: {
+    id: `${prefix}.deliverySettings`,
+    defaultMessage: 'Delivery settings',
+  },
+  notConfigured: {
+    id: `${prefix}.notConfigured`,
+    defaultMessage: 'Not configured',
+  },
+  account: {
+    id: `${prefix}.account`,
+    defaultMessage: 'Account',
+  },
+  senderNumber: {
+    id: `${prefix}.senderNumber`,
+    defaultMessage: 'Sender number',
+  },
+  senderDomain: {
+    id: `${prefix}.senderDomain`,
+    defaultMessage: 'Sender domain',
+  },
+  senderId: {
+    id: `${prefix}.senderId`,
+    defaultMessage: 'Sender ID',
+  },
+  senderName: {
+    id: `${prefix}.senderName`,
+    defaultMessage: 'Sender name',
+  },
+  replyToId: {
+    id: `${prefix}.replyToId`,
+    defaultMessage: 'Reply-to ID',
+  },
+  done: {
+    id: `${prefix}.done`,
+    defaultMessage: 'Done',
+  },
+  smsDomain: {
+    id: `${prefix}.smsDomain`,
+    defaultMessage: 'SMS Domain',
+  },
+  /** SMS summary & form: "Sender Domain" (capital D) for summary line */
+  senderDomainSummary: {
+    id: `${prefix}.senderDomainSummary`,
+    defaultMessage: 'Sender Domain',
+  },
+  /** SMS form label with colon: "Sender domain:" */
+  senderDomainLabel: {
+    id: `${prefix}.senderDomainLabel`,
+    defaultMessage: 'Sender domain:',
+  },
+  /** SMS form label with colon: "Sender ID:" */
+  senderIdLabel: {
+    id: `${prefix}.senderIdLabel`,
+    defaultMessage: 'Sender ID:',
+  },
+  emailDomain: {
+    id: `${prefix}.emailDomain`,
+    defaultMessage: 'Email Domain',
+  },
+  /** Email form/summary: "Email domain:" (with colon) */
+  emailDomainLabel: {
+    id: `${prefix}.emailDomainLabel`,
+    defaultMessage: 'Email domain:',
+  },
+  /** Email form: "Sender ID:" (with colon) */
+  senderNameLabelEmail: {
+    id: `${prefix}.senderIdLabelEmail`,
+    defaultMessage: 'Sender Name:',
+  },
+  /** Email form/summary: "Reply-to ID:" (with colon) */
+  replyToIdLabel: {
+    id: `${prefix}.replyToIdLabel`,
+    defaultMessage: 'Reply-to ID:',
+  },
+  whatsappBusinessAcc: {
+    id: `${prefix}.whatsappBusinessAcc`,
+    defaultMessage: 'WhatsApp business account',
+  },
+  whatsappSenderNum: {
+    id: `${prefix}.whatsappSenderNum`,
+    defaultMessage: 'WhatsApp sender number',
+  },
+  /** WhatsApp form/summary: "Account:" (with colon) */
+  accountLabel: {
+    id: `${prefix}.accountLabel`,
+    defaultMessage: 'Account:',
+  },
+  /** WhatsApp form/summary: "Sender number:" (with colon) */
+  senderNumberLabel: {
+    id: `${prefix}.senderNumberLabel`,
+    defaultMessage: 'Sender number:',
+  },
+  noOptions: {
+    id: `${prefix}.noOptions`,
+    defaultMessage: 'No options',
+  },
+  disabledMessage: {
+    id: `${prefix}.disabledMessage`,
+    defaultMessage: 'Message template selected belongs to this account',
+  },
+  /** RCS: primary domain (slidebox) */
+  rcsDomainLabel: {
+    id: `${prefix}.rcsDomainLabel`,
+    defaultMessage: 'RCS domain:',
+  },
+  /** RCS: SMS fallback domain (slidebox) */
+  fallbackSmsDomainLabel: {
+    id: `${prefix}.fallbackSmsDomainLabel`,
+    defaultMessage: 'Fallback SMS domain:',
+  },
+  /** RCS: "RCS sender ID" */
+  rcsSenderIdLabel: {
+    id: `${prefix}.rcsSenderIdLabel`,
+    defaultMessage: 'RCS sender ID',
+  },
+  /** RCS: "Fallback SMS sender ID" */
+  fallbackSmsSenderIdLabel: {
+    id: `${prefix}.fallbackSmsSenderIdLabel`,
+    defaultMessage: 'Fallback SMS sender ID',
+  },
+  /** RCS: "Domain" (for domain · sender ID display) */
+  domainLabel: {
+    id: `${prefix}.domainLabel`,
+    defaultMessage: 'Domain',
+  },
+  /** RCS: placeholder for sender ID dropdown */
+  selectSenderId: {
+    id: `${prefix}.selectSenderId`,
+    defaultMessage: 'Select sender ID',
+  },
+});

package/app/v2Components/CommonTestAndPreview/DeliverySettings/utils/parseSenderDetailsResponse.js

@@ -0,0 +1,156 @@
+/**
+ * Normalize getSenderDetails(channel, orgUnitId) API response for a single channel.
+ * Output shape matches cap-campaigns-v2 parseSenderDetails so UI can consume
+ * domains with domainId, domainName, gsmSenders, emailSenders, emailRepliers, etc.
+ *
+ * Reference: cap-campaigns-v2 app/utils/parseSenderDetails.js
+ * No cross-repo imports; logic aligned with campaigns domain structure.
+ */
+
+import get from 'lodash/get';
+import { CHANNELS } from '../../constants';
+import { RCS_CONTACT_INFO_GSM_TYPE_KEYS } from '../constants';
+
+/** Match API contactInfo.type (some envs use different casing). */
+const typeMatches = (itemType, expectedKey) => {
+  if (!itemType || !expectedKey) return false;
+  const a = String(itemType).toLowerCase().replace(/-/g, '_');
+  const b = String(expectedKey).toLowerCase().replace(/-/g, '_');
+  return a === b;
+};
+
+/**
+ * Include row unless explicitly invalid — many APIs omit `valid`, which would
+ * otherwise filter out every sender (RCS/SMS lists empty in UI).
+ */
+const getSenderOptions = (contactInfo, key) =>
+  (contactInfo || [])
+    .filter((contactInfoItem) => typeMatches(contactInfoItem.type, key) && contactInfoItem.valid !== false)
+    .sort((contact) => (contact.default ? -1 : 0));
+
+/** RCS APIs may label senders under several `contactInfo.type` keys — see `RCS_CONTACT_INFO_GSM_TYPE_KEYS`. */
+const getRcsLikeGsmSenders = (contactInfo) => {
+  const seen = new Set();
+  const merged = [];
+  RCS_CONTACT_INFO_GSM_TYPE_KEYS.forEach((key) => {
+    getSenderOptions(contactInfo, key).forEach((row) => {
+      const v = row?.value;
+      // Skip empty/whitespace — they still pass `v != null` for "" and pollute RCS sender dropdowns.
+      if (v == null || String(v).trim() === '' || seen.has(v)) return;
+      seen.add(v);
+      merged.push(row);
+    });
+  });
+  return merged.sort((a, b) => (a.default ? -1 : 0) - (b.default ? -1 : 0));
+};
+
+/**
+ * Campaigns domainProperties may return { entity } or { result: { entity } } / { data: { entity } }.
+ */
+function unwrapEntity(response) {
+  if (!response || typeof response !== 'object') return null;
+  if (response.entity != null) return response.entity;
+  const nested = get(response, 'result.entity') ?? get(response, 'data.entity');
+  if (nested != null) return nested;
+  if (response.entity === null) return null;
+  return response;
+}
+
+/**
+ * Parse raw API response for one channel into { domains: [...] }
+ * @param {string} channel - SMS | EMAIL | WHATSAPP | RCS
+ * @param {Object} response - API response (e.g. { entity: { SMS: [...] } } or { entity: [...] })
+ * @returns {{ domains: Array }} - domains array compatible with campaigns DeliverySettingsV2
+ */
+export function parseSenderDetailsResponse(channel, response) {
+  const entity = unwrapEntity(response);
+  if (entity == null || entity === '') {
+    return { domains: [] };
+  }
+
+  // Normalize once: entity keys may be any casing (SMS/sms/rcs) but downstream branches use CHANNELS.* (uppercase).
+  const normalizedChannel =
+    channel == null || String(channel).trim() === ''
+      ? ''
+      : String(channel).trim().toUpperCase();
+
+  // Single-channel API: entity may be { [channel]: [...] } or direct array.
+  // Some responses use different casing (e.g. rcs vs RCS) or a single domain object instead of an array.
+  let channelSenderDetails =
+    get(entity, channel, null)
+    ?? (normalizedChannel ? get(entity, normalizedChannel, null) : null)
+    ?? (normalizedChannel ? get(entity, normalizedChannel.toLowerCase(), null) : null);
+
+  if (channelSenderDetails == null && Array.isArray(entity)) {
+    channelSenderDetails = entity;
+  }
+
+  if (channelSenderDetails != null && !Array.isArray(channelSenderDetails)) {
+    const single = channelSenderDetails;
+    if (single && typeof single === 'object' && single.domainProperties) {
+      channelSenderDetails = [single];
+    } else {
+      return { domains: [] };
+    }
+  }
+
+  if (!Array.isArray(channelSenderDetails)) {
+    return { domains: [] };
+  }
+
+  const domains = [];
+
+  channelSenderDetails.forEach((element) => {
+    const { id: dgmId, priority, domainProperties = {} } = element;
+    const {
+      domainName,
+      hostName,
+      id = -1,
+      contactInfo,
+      connectionProperties: {
+        sourceAccountIdentifier = '',
+        wabaId = '',
+        userid = '',
+      } = {},
+    } = domainProperties;
+
+    const resolvedDomainName = domainName || hostName;
+
+    const domain = {
+      dgmId,
+      domainName: resolvedDomainName,
+      domainId: id,
+      priority: priority != null ? priority : 0,
+    };
+
+    if ([CHANNELS.SMS, CHANNELS.WHATSAPP, CHANNELS.RCS].includes(normalizedChannel)) {
+      domain.cdmaSenders = getSenderOptions(contactInfo, 'cdma_sender_id');
+      domain.gsmSenders = normalizedChannel === CHANNELS.RCS
+        ? getRcsLikeGsmSenders(contactInfo)
+        : getSenderOptions(contactInfo, 'gsm_sender_id');
+      domain.sourceAccountIdentifier =
+        sourceAccountIdentifier || wabaId || userid || '';
+    }
+
+    if (normalizedChannel === CHANNELS.EMAIL) {
+      domain.emailSenders = getSenderOptions(contactInfo, 'sender_id');
+      domain.emailRepliers = getSenderOptions(contactInfo, 'reply_to_id');
+    }
+
+    domains.push(domain);
+  });
+
+  // Sort by priority and dedupe by domainName (match campaigns behaviour)
+  domains.sort((a, b) => (a.priority || 0) - (b.priority || 0));
+  const deduped = domains.reduce((acc, domain) => {
+    const key = domain.domainName ?? domain.domainId;
+    if (!acc.find((existing) => (existing.domainName ?? existing.domainId) === key)) {
+      acc.push(domain);
+    }
+    return acc;
+  }, []);
+
+  return { domains: deduped };
+}
+
+export default parseSenderDetailsResponse;