@capillarytech/creatives-library 8.0.329 → 8.0.330-alpha.0

package/v2Containers/Rcs/index.js

@@ -44,10 +44,12 @@ import {
   normalizeLibraryLoadedTitleDesc,
   mergeRcsSmsFallBackContentFromDetails,
   mergeRcsSmsFallbackVarMapLayers,
+  extractRegisteredSenderIdsFromSmsFallbackRecord,
   pickFirstSmsFallbackTemplateString,
   syncCardVarMappedSemanticsFromSlots,
   hasMeaningfulSmsFallbackShape,
   getLibrarySmsFallbackApiBaselineFromTemplateData,
+  pickRcsCardVarMappedEntries,
 } from './rcsLibraryHydrationUtils';
 import {
   RCS,
@@ -118,6 +120,7 @@ import {
   getTemplateStatusType,
   normalizeCardVarMapped,
   coalesceCardVarMappedToTemplate,
+  getRcsSemanticVarNamesSpanningTitleAndDesc,
   resolveCardVarMappedSlotValue,
   sanitizeCardVarMappedValue,
 } from './utils';
@@ -386,6 +389,12 @@ export const Rcs = (props) => {
 
   const splitTemplateVarStringRcs = (str) => splitTemplateVarString(str, rcsVarRegex);
 
+  /** Same `{{tag}}` in both title and description must not share one semantic map entry. */
+  const rcsSpanningSemanticVarNames = useMemo(
+    () => getRcsSemanticVarNamesSpanningTitleAndDesc(templateTitle, templateDesc, rcsVarRegex),
+    [templateTitle, templateDesc],
+  );
+
   /** Global slot index (0-based, title vars then desc) for a VarSegmentMessageEditor `id` (`{{tok}}_segIdx`), or null if not found. */
   const getGlobalSlotIndexForRcsFieldId = (varSegmentCompositeId, fieldTemplateStr, fieldType) => {
     const titleVarTokenMatches = templateTitle?.match(rcsVarRegex) ?? [];
@@ -418,6 +427,7 @@ export const Rcs = (props) => {
           key,
           globalSlot,
           isEditLike,
+          rcsSpanningSemanticVarNames.has(key),
         );
         if (isNil(v) || String(v)?.trim?.() === '') return elem;
         return String(v);
@@ -484,6 +494,7 @@ export const Rcs = (props) => {
     isFullMode,
     isEditFlow,
     cardVarMapped,
+    rcsSpanningSemanticVarNames,
   ]);
 
   const testAndPreviewContent = useMemo(() => getTemplateContent(), [getTemplateContent]);
@@ -514,7 +525,7 @@ export const Rcs = (props) => {
       const nextVarMap = {};
       let varOrdinal = 0;
       arr.forEach((elem, idx) => {
-        // RCS placeholders are alphanumeric/underscore (e.g. {{user_name}}), not numeric-only
+        // Mustache tokens: {{1}}, {{user_name}}, {{tag.FORMAT_1}}, etc.
         if (rcsVarTestRegex.test(elem)) {
           const id = `${elem}_${idx}`;
           const varName = getVarNameFromToken(elem);
@@ -525,6 +536,7 @@ export const Rcs = (props) => {
             varName,
             globalSlot,
             isEditLike,
+            rcsSpanningSemanticVarNames.has(varName),
           );
           nextVarMap[id] = mappedValue;
         }
@@ -534,7 +546,7 @@ export const Rcs = (props) => {
 
     initField(templateTitle, setTitleVarMappedData, 0);
     initField(templateDesc, setDescVarMappedData, titleTokenCount);
-  }, [templateTitle, templateDesc, cardVarMapped, isEditFlow, isFullMode]);
+  }, [templateTitle, templateDesc, cardVarMapped, isEditFlow, isFullMode, rcsSpanningSemanticVarNames]);
 
   useEffect(() => {
     if (!isEditFlow && isFullMode) {
@@ -780,12 +792,17 @@ export const Rcs = (props) => {
           typeof smsFallbackContent.unicodeValidity === 'boolean'
             ? smsFallbackContent.unicodeValidity
             : (typeof base['unicode-validity'] === 'boolean' ? base['unicode-validity'] : true);
+        const registeredSenderIdsFromApi =
+          extractRegisteredSenderIdsFromSmsFallbackRecord(smsFallbackContent);
         const nextSmsState = {
           templateName: smsFallbackContent.smsTemplateName || '',
           content: fallbackMessage,
           templateContent: fallbackMessage,
           unicodeValidity: unicodeFromApi,
           ...(hasVarMapped && { rcsSmsFallbackVarMapped: varMappedFromPayload }),
+          ...(Array.isArray(registeredSenderIdsFromApi) && registeredSenderIdsFromApi.length > 0
+            ? { registeredSenderIds: registeredSenderIdsFromApi }
+            : {}),
         };
         const hydrationKey = JSON.stringify({
           creativeKey: details._id || details.name || details.creativeName || '',
@@ -793,6 +810,10 @@ export const Rcs = (props) => {
           content: nextSmsState.content,
           unicodeValidity: nextSmsState.unicodeValidity,
           varMapped: nextSmsState.rcsSmsFallbackVarMapped || {},
+          senderIds:
+            Array.isArray(registeredSenderIdsFromApi)
+              ? registeredSenderIdsFromApi.join('\u001f')
+              : '',
         });
         if (
           isFullMode
@@ -892,58 +913,87 @@ export const Rcs = (props) => {
     return templateStr.replace(re, `{{${tagName}}}`);
   };
 
-  const onTagSelect = (data, areaId, field) => {
-    if (!areaId) return;
-    const sep = areaId.lastIndexOf('_');
-    if (sep === -1) return;
-    const slotSuffix = areaId.slice(sep + 1);
-    if (slotSuffix === '' || isNaN(Number(slotSuffix))) return;
-    const token = areaId.slice(0, sep);
-    const variableName = getVarNameFromToken(token);
-    if (!variableName) return;
-    const isNumericSlot = RCS_NUMERIC_VAR_NAME_REGEX.test(String(variableName));
-    const fieldStr = field === RCS_TAG_AREA_FIELD_TITLE ? templateTitle : templateDesc;
-    const fieldType = field === RCS_TAG_AREA_FIELD_TITLE ? TITLE_TEXT : MESSAGE_TEXT;
-    const globalSlotForArea = getGlobalSlotIndexForRcsFieldId(areaId, fieldStr, fieldType);
-
-    setCardVarMapped((prev) => {
-      const base = (prev?.[variableName] ?? '').toString();
-      const nextVal = `${base}{{${data}}}`;
-      const next = { ...(prev || {}) };
-      if (isNumericSlot) {
-        delete next[variableName];
-        next[data] = nextVal;
+  const onTagSelect = (selectedTagNameFromPicker, varSegmentCompositeDomId, tagAreaField) => {
+    if (!varSegmentCompositeDomId) return;
+    const underscoreIndexInCompositeId = varSegmentCompositeDomId.lastIndexOf('_');
+    if (underscoreIndexInCompositeId === -1) return;
+    const segmentIndexSuffix = varSegmentCompositeDomId.slice(underscoreIndexInCompositeId + 1);
+    if (segmentIndexSuffix === '' || isNaN(Number(segmentIndexSuffix))) return;
+    const mustacheTokenFromCompositeId = varSegmentCompositeDomId.slice(0, underscoreIndexInCompositeId);
+    const semanticOrNumericVarName = getVarNameFromToken(mustacheTokenFromCompositeId);
+    if (!semanticOrNumericVarName) return;
+    const isNumericPlaceholderSlot = RCS_NUMERIC_VAR_NAME_REGEX.test(String(semanticOrNumericVarName));
+    const templateStringForField =
+      tagAreaField === RCS_TAG_AREA_FIELD_TITLE ? templateTitle : templateDesc;
+    const titleOrMessageFieldType =
+      tagAreaField === RCS_TAG_AREA_FIELD_TITLE ? TITLE_TEXT : MESSAGE_TEXT;
+    const globalVarSlotIndexZeroBased = getGlobalSlotIndexForRcsFieldId(
+      varSegmentCompositeDomId,
+      templateStringForField,
+      titleOrMessageFieldType,
+    );
+    const cardVarMappedNumericSlotKey =
+      globalVarSlotIndexZeroBased !== null && globalVarSlotIndexZeroBased !== undefined
+        ? String(globalVarSlotIndexZeroBased + 1)
+        : null;
+
+    setCardVarMapped((previousCardVarMapped) => {
+      const updatedCardVarMapped = { ...(previousCardVarMapped || {}) };
+      if (isNumericPlaceholderSlot) {
+        const existingValueBeforeAppend = (
+          previousCardVarMapped?.[semanticOrNumericVarName] ?? ''
+        ).toString();
+        const mappedValueAfterAppendingTag = `${existingValueBeforeAppend}{{${selectedTagNameFromPicker}}}`;
+        delete updatedCardVarMapped[semanticOrNumericVarName];
+        updatedCardVarMapped[selectedTagNameFromPicker] = mappedValueAfterAppendingTag;
       } else {
-        // Use the global slot index key only — writing by semantic name (variableName)
-        // would contaminate any other field that shares the same var name (e.g. {{gt}}
-        // in both title and description), causing the label value to bleed across fields.
-        if (globalSlotForArea !== null && globalSlotForArea !== undefined) {
-          next[String(globalSlotForArea + 1)] = nextVal;
-          // Same reasoning as handleRcsVarChange: delete the semantic key so
-          // resolveCardVarMappedSlotValue uses only the numeric slot and the
-          // value cannot bleed across fields that share the same var name.
-          delete next[variableName];
+        // Same semantic token (e.g. {{adv}}) in title and body must not share one map key for
+        // "existing value" — that appends the new tag onto the other field. Match handleRcsVarChange:
+        // read/write the global numeric slot only and drop the shared semantic key.
+        const existingValueBeforeAppend = cardVarMappedNumericSlotKey
+          ? String(previousCardVarMapped?.[cardVarMappedNumericSlotKey] ?? '')
+          : String(previousCardVarMapped?.[semanticOrNumericVarName] ?? '');
+        const mappedValueAfterAppendingTag = `${existingValueBeforeAppend}{{${selectedTagNameFromPicker}}}`;
+        delete updatedCardVarMapped[semanticOrNumericVarName];
+        if (cardVarMappedNumericSlotKey) {
+          updatedCardVarMapped[cardVarMappedNumericSlotKey] = mappedValueAfterAppendingTag;
         } else {
-          next[variableName] = nextVal;
+          updatedCardVarMapped[semanticOrNumericVarName] = mappedValueAfterAppendingTag;
         }
       }
-      return next;
+      return updatedCardVarMapped;
     });
 
-    if (isNumericSlot && (field === RCS_TAG_AREA_FIELD_TITLE || field === RCS_TAG_AREA_FIELD_DESC)) {
-      if (field === RCS_TAG_AREA_FIELD_TITLE) {
-        setTemplateTitle((prev) => {
-          const nextStr = replaceNumericPlaceholderWithTagInTemplate(prev || '', variableName, data);
-          if (nextStr === prev) return prev;
-          setTemplateTitleError(variableErrorHandling(nextStr));
-          return nextStr;
+    if (
+      isNumericPlaceholderSlot
+      && (tagAreaField === RCS_TAG_AREA_FIELD_TITLE || tagAreaField === RCS_TAG_AREA_FIELD_DESC)
+    ) {
+      if (tagAreaField === RCS_TAG_AREA_FIELD_TITLE) {
+        setTemplateTitle((previousTitle) => {
+          const titleAfterReplacingNumericPlaceholder = replaceNumericPlaceholderWithTagInTemplate(
+            previousTitle || '',
+            semanticOrNumericVarName,
+            selectedTagNameFromPicker,
+          );
+          if (titleAfterReplacingNumericPlaceholder === previousTitle) return previousTitle;
+          setTemplateTitleError(variableErrorHandling(titleAfterReplacingNumericPlaceholder));
+          // Remount segment editor: tag insert replaces {{n}} with e.g. {{tag.FORMAT_1}} — slot ids change; avoids stale UI vs manual typing in full-mode TextArea
+          setRcsVarSegmentEditorRemountKey((k) => k + 1);
+          return titleAfterReplacingNumericPlaceholder;
         });
       } else {
-        setTemplateDesc((prev) => {
-          const nextStr = replaceNumericPlaceholderWithTagInTemplate(prev || '', variableName, data);
-          if (nextStr === prev) return prev;
-          setTemplateDescError(variableErrorHandling(nextStr));
-          return nextStr;
+        setTemplateDesc((previousDescription) => {
+          const descriptionAfterReplacingNumericPlaceholder = replaceNumericPlaceholderWithTagInTemplate(
+            previousDescription || '',
+            semanticOrNumericVarName,
+            selectedTagNameFromPicker,
+          );
+          if (descriptionAfterReplacingNumericPlaceholder === previousDescription) {
+            return previousDescription;
+          }
+          setTemplateDescError(variableErrorHandling(descriptionAfterReplacingNumericPlaceholder));
+          setRcsVarSegmentEditorRemountKey((k) => k + 1);
+          return descriptionAfterReplacingNumericPlaceholder;
         });
       }
     }
@@ -1101,7 +1151,8 @@ export const Rcs = (props) => {
       if(!isFullMode){
         return false;
       }
-      if (!/^\w+$/.test(paramName)) {
+      // Allow Liquid-style param names: letters, digits, underscore, dots (e.g. dynamic_expiry_date_after_3_days.FORMAT_1)
+      if (!/^[\w.]+$/.test(paramName)) {
         return formatMessage(messages.unknownCharactersError);
       }
     }
@@ -1214,6 +1265,7 @@ const onTitleAddVar = () => {
           varName,
           globalSlot,
           isEditLike,
+          rcsSpanningSemanticVarNames.has(varName),
         );
       }
     });
@@ -1222,42 +1274,37 @@ const onTitleAddVar = () => {
 
   const titleVarSegmentValueMapById = useMemo(
     () => getRcsValueMap(templateTitle, TITLE_TEXT),
-    [templateTitle, cardVarMapped, isEditFlow, isFullMode],
+    [templateTitle, cardVarMapped, isEditFlow, isFullMode, rcsSpanningSemanticVarNames],
   );
   const descriptionVarSegmentValueMapById = useMemo(
     () => getRcsValueMap(templateDesc, MESSAGE_TEXT),
-    [templateDesc, templateTitle, cardVarMapped, isEditFlow, isFullMode],
+    [templateDesc, templateTitle, cardVarMapped, isEditFlow, isFullMode, rcsSpanningSemanticVarNames],
   );
 
-  const handleRcsVarChange = (id, value, type) => {
-    const sep = id.lastIndexOf('_');
-    if (sep === -1) return;
-    const token = id.slice(0, sep);
-    const variableName = getVarNameFromToken(token);
+  const handleRcsVarChange = (varSegmentCompositeDomId, value, type) => {
+    const underscoreIndexInCompositeId = varSegmentCompositeDomId.lastIndexOf('_');
+    if (underscoreIndexInCompositeId === -1) return;
+    const mustacheTokenFromCompositeId = varSegmentCompositeDomId.slice(0, underscoreIndexInCompositeId);
+    const variableName = getVarNameFromToken(mustacheTokenFromCompositeId);
     if (variableName === undefined || variableName === null || variableName === '') return;
     const isInvalidValue = value?.trim() === '';
     const coercedSlotValue = isInvalidValue ? '' : value;
-    const fieldStr = type === TITLE_TEXT ? templateTitle : templateDesc;
-    const globalSlot = getGlobalSlotIndexForRcsFieldId(id, fieldStr, type);
-    setCardVarMapped((previousVarMap) => {
-      const nextVarMap = { ...previousVarMap };
-      if (globalSlot !== null && globalSlot !== undefined) {
-        // Write by global slot index only — title and description can share the
-        // same var name (e.g. {{gt}}), and writing by semantic name would cause
-        // the description slot to resolve the title's value and vice-versa.
-        const numericKey = String(globalSlot + 1);
-        nextVarMap[numericKey] = coercedSlotValue;
-        // Remove any stale semantic key so resolveCardVarMappedSlotValue never
-        // falls back to it. Guard: when variableName is already the numeric slot
-        // key (e.g. {{1}} at slot 0 → both equal "1"), skip the delete or it
-        // would erase the value we just wrote.
-        if (variableName !== numericKey) {
-          delete nextVarMap[variableName];
-        }
-      } else {
-        nextVarMap[variableName] = coercedSlotValue;
+    const templateStringForField = type === TITLE_TEXT ? templateTitle : templateDesc;
+    const globalVarSlotIndexZeroBased = getGlobalSlotIndexForRcsFieldId(
+      varSegmentCompositeDomId,
+      templateStringForField,
+      type,
+    );
+    setCardVarMapped((previousCardVarMapped) => {
+      const updatedCardVarMapped = { ...previousCardVarMapped };
+      // Remove stale semantic key: keeping it causes every other slot sharing the same
+      // variable name (e.g. {{adv}} in both title and description) to read the same value
+      // via the semantic-key fallback in resolveCardVarMappedSlotValue.
+      delete updatedCardVarMapped[variableName];
+      if (globalVarSlotIndexZeroBased !== null && globalVarSlotIndexZeroBased !== undefined) {
+        updatedCardVarMapped[String(globalVarSlotIndexZeroBased + 1)] = coercedSlotValue;
       }
-      return nextVarMap;
+      return updatedCardVarMapped;
     });
   };
 
@@ -1375,6 +1422,7 @@ const onTitleAddVar = () => {
         </CapRow>
         <CapRow className="rcs-create-template-message-input">
           <div className="rcs_text_area_wrapper">
+            {/* Edit/library: segmented inputs (split on {{…}}). Full-mode create: single TextArea below — manual entry there never hits segment split. TagList replaces {{n}} in template string here. */}
             {(isEditFlow || !isFullMode)
               ? (
                 <VarSegmentMessageEditor
@@ -1990,23 +2038,25 @@ const onTitleAddVar = () => {
                         ...(templateTitle?.match(rcsVarRegex) ?? []),
                         ...(templateDesc?.match(rcsVarRegex) ?? []),
                       ];
+                      const cardVarMappedForRcsCardOnly = pickRcsCardVarMappedEntries(
+                        cardVarMapped,
+                      );
+                      // Persist numeric slot keys only ("1","2",…) — avoids duplicating the same value under
+                      // semantic names (e.g. both "1" and dynamic_expiry_date_after_3_days.FORMAT_1). Hydration
+                      // and coalesceCardVarMappedToTemplate still resolve from numeric keys + template tokens.
                       const persistedSlotVarMap = {};
-                      const seenSemanticVarNames = new Set();
                       templateVarTokens.forEach((token, slotIndexZeroBased) => {
                         const varName = getVarNameFromToken(token);
                         if (!varName) return;
                         const resolvedRawValue = resolveCardVarMappedSlotValue(
-                          cardVarMapped,
+                          cardVarMappedForRcsCardOnly,
                           varName,
                           slotIndexZeroBased,
                           isSlotMappingMode,
+                          rcsSpanningSemanticVarNames.has(varName),
                         );
                         const sanitizedSlotValue = sanitizeCardVarMappedValue(resolvedRawValue);
                         persistedSlotVarMap[String(slotIndexZeroBased + 1)] = sanitizedSlotValue;
-                        if (!seenSemanticVarNames.has(varName)) {
-                          seenSemanticVarNames.add(varName);
-                          persistedSlotVarMap[varName] = sanitizedSlotValue;
-                        }
                       });
                       return { cardVarMapped: persistedSlotVarMap };
                     })()),
@@ -2023,6 +2073,53 @@ const onTitleAddVar = () => {
                   || smsFallbackForPayload.message
                   || smsFallbackForPayload.smsContent
                   || '';
+                /**
+                 * Campaigns `getTraiSenderIds` / Iris read `smsFallBackContent.templateConfigs.registeredSenderIds`.
+                 * Library `smsFallbackForPayload` omits ids — use merged state (`smsFallbackMerged`) like test preview.
+                 */
+                const m = smsFallbackMerged || {};
+                const tcSibling = m.templateConfigs && typeof m.templateConfigs === 'object'
+                  ? m.templateConfigs
+                  : {};
+                const smsFallbackTemplateId =
+                  (m.smsTemplateId != null && String(m.smsTemplateId).trim() !== ''
+                    ? String(m.smsTemplateId)
+                    : '')
+                  || (tcSibling.templateId != null && String(tcSibling.templateId).trim() !== ''
+                    ? String(tcSibling.templateId)
+                    : '');
+                const smsFallbackTemplateStr =
+                  pickFirstSmsFallbackTemplateString(m)
+                  || (typeof m.templateContent === 'string' ? m.templateContent : '')
+                  || (typeof tcSibling.template === 'string' ? tcSibling.template : '')
+                  || '';
+                const smsFallbackTemplateName =
+                  m.templateName
+                  || m.smsTemplateName
+                  || tcSibling.templateName
+                  || tcSibling.name
+                  || '';
+                const registeredSenderIdsForPayload = Array.isArray(m.registeredSenderIds)
+                  ? m.registeredSenderIds
+                  : Array.isArray(tcSibling.registeredSenderIds)
+                    ? tcSibling.registeredSenderIds
+                    : Array.isArray(tcSibling.header)
+                      ? tcSibling.header
+                      : null;
+                const hasRegisteredSenderIds = Array.isArray(registeredSenderIdsForPayload);
+                const smsFallbackTemplateConfigs =
+                  smsFallbackTemplateId || hasRegisteredSenderIds
+                    ? {
+                        ...(smsFallbackTemplateId && { templateId: smsFallbackTemplateId }),
+                        ...(smsFallbackTemplateStr && { template: smsFallbackTemplateStr }),
+                        ...(smsFallbackTemplateName && {
+                          templateName: smsFallbackTemplateName,
+                        }),
+                        ...(hasRegisteredSenderIds && {
+                          registeredSenderIds: registeredSenderIdsForPayload,
+                        }),
+                      }
+                    : null;
                 return {
                   smsFallBackContent: {
                     smsTemplateName: smsFallbackForPayload.templateName || '',
@@ -2036,6 +2133,9 @@ const onTitleAddVar = () => {
                       && Object.keys(smsFallbackForPayload.rcsSmsFallbackVarMapped).length > 0 && {
                       [RCS_SMS_FALLBACK_VAR_MAPPED_PROP]: smsFallbackForPayload.rcsSmsFallbackVarMapped,
                     }),
+                    ...(smsFallbackTemplateConfigs && {
+                      templateConfigs: smsFallbackTemplateConfigs,
+                    }),
                   },
                 };
               })()),
@@ -2058,13 +2158,36 @@ const onTitleAddVar = () => {
       (wecrmAccountId != null && String(wecrmAccountId).trim() !== '')
         ? String(wecrmAccountId)
         : accountId;
-    const rcsForTest = {
+    const isSlotMappingModeForPreview = isEditFlow || !isFullMode;
+    let rcsForTest = {
       ...rcs,
       rcsContent: {
         ...rcs.rcsContent,
         ...(accountIdForCreateMessageMeta ? { accountId: accountIdForCreateMessageMeta } : {}),
       },
     };
+    /** Approval payload keeps numeric-only `cardVarMapped`; preview APIs still need semantic keys. */
+    if (isSlotMappingModeForPreview) {
+      const cardContent = rcsForTest.rcsContent?.cardContent;
+      if (Array.isArray(cardContent) && cardContent[0]) {
+        const fullCardVarMapped = coalesceCardVarMappedToTemplate(
+          pickRcsCardVarMappedEntries(cardVarMapped),
+          templateTitle,
+          templateDesc,
+          rcsVarRegex,
+        );
+        rcsForTest = {
+          ...rcsForTest,
+          rcsContent: {
+            ...rcsForTest.rcsContent,
+            cardContent: [
+              { ...cardContent[0], cardVarMapped: fullCardVarMapped },
+              ...cardContent.slice(1),
+            ],
+          },
+        };
+      }
+    }
     const out = {
       versions: {
         base: {
@@ -2235,7 +2358,13 @@ const onTitleAddVar = () => {
       return true;
     }
     return orderedVarNames.some((name, globalIdx) => {
-      const v = resolveCardVarMappedSlotValue(cardVarMapped, name, globalIdx, true);
+      const v = resolveCardVarMappedSlotValue(
+        cardVarMapped,
+        name,
+        globalIdx,
+        true,
+        rcsSpanningSemanticVarNames.has(name),
+      );
       const s = v == null ? '' : String(v);
       return s.trim() === '';
     });
@@ -2554,13 +2683,19 @@ const onTitleAddVar = () => {
         content={testAndPreviewContent}
         currentChannel={RCS}
         orgUnitId={orgUnitId}
+        rcsTestPreviewOptions={{ isLibraryMode: !isFullMode }}
         smsFallbackContent={
           smsFallbackData && (smsFallbackData.templateContent || smsFallbackData.content)
             ? {
               templateContent:
                 smsFallbackData.templateContent || smsFallbackData.content || '',
               templateName: smsFallbackData.templateName || '',
-              [RCS_SMS_FALLBACK_VAR_MAPPED_PROP]: smsFallbackData?.rcsSmsFallbackVarMapped ?? {},
+              [RCS_SMS_FALLBACK_VAR_MAPPED_PROP]: !isFullMode
+                ? mergeRcsSmsFallbackVarMapLayers(
+                  getLibrarySmsFallbackApiBaselineFromTemplateData(templateData),
+                  smsFallbackData,
+                )
+                : mergeRcsSmsFallbackVarMapLayers({}, smsFallbackData),
             }
             : null
         }

package/v2Containers/Rcs/messages.js

@@ -466,7 +466,8 @@ export default defineMessages({
   },
   unknownCharactersError: {
     id: `${prefix}.unknownCharactersError`,
-    defaultMessage: 'Only alphanumeric characters and underscore are allowed in custom param. Spaces/other special characters are not allowed.',
+    defaultMessage:
+      'Only letters, numbers, underscores, and dots are allowed in custom param (e.g. tag.FORMAT_1). Spaces and other special characters are not allowed.',
   },
   emptyVariableError: {
     id: `${prefix}.emptyVariableError`,

package/v2Containers/Rcs/rcsLibraryHydrationUtils.js

@@ -1,6 +1,24 @@
 import isEmpty from 'lodash/isEmpty';
 import get from 'lodash/get';
 import { RCS_SMS_FALLBACK_VAR_MAPPED_PROP } from '../../v2Components/CommonTestAndPreview/constants';
+import {
+  RCS_NUMERIC_VAR_NAME_REGEX,
+  RCS_CARD_VAR_MAPPED_SEMANTIC_KEY_REGEX,
+} from './constants';
+
+/** RCS card `cardVarMapped` / `rcsCardVarMapped` only (SMS fallback slot keys stay on `smsFallBackContent`). */
+export function pickRcsCardVarMappedEntries(record) {
+  if (record == null || typeof record !== 'object' || Array.isArray(record)) return {};
+  return Object.fromEntries(
+    Object.entries(record).filter(([k]) => {
+      const key = String(k);
+      return (
+        RCS_NUMERIC_VAR_NAME_REGEX.test(key)
+        || RCS_CARD_VAR_MAPPED_SEMANTIC_KEY_REGEX.test(key)
+      );
+    }),
+  );
+}
 
 /**
  * Nested `versions…smsFallBackContent` and root `smsFallBackContent` (CreativesContainer mirror)
@@ -88,6 +106,8 @@ export function getLibrarySmsFallbackApiBaselineFromTemplateData(templateData) {
   };
 }
 
+export { extractRegisteredSenderIdsFromSmsFallbackRecord } from '../../utils/commonUtils';
+
 export function pickFirstSmsFallbackTemplateString(sms = {}) {
   if (!sms || typeof sms !== 'object') return '';
   const keys = [