@capillarytech/creatives-library 9.0.35 → 9.0.36-alpha.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@capillarytech/creatives-library",
   "author": "meharaj",
-  "version": "9.0.35",
+  "version": "9.0.36-alpha.1",
   "description": "Capillary creatives ui",
   "main": "./index.js",
   "module": "./index.es.js",

package/translations/en.json

@@ -63,8 +63,8 @@
   "app.v2containers.SmsTrai.Edit.traiEditTitle": "Message",
   "app.v2containers.SmsTrai.Edit.unicodeLabel": "Allow unicode characters",
   "app.v2containers.SmsTrai.Edit.unsupportedTagsValidationError": "Unsupported tags: {unsupportedTags}. Please remove them from this message.",
-  "creatives.components.AccessForbidden.forbiddenDesc": "This page access has not been provided to you.",
-  "creatives.components.AccessForbidden.forbiddenHeader": "Access Forbidden",
+  "creatives.components.AccessForbidden.forbiddenDesc": "Please contact your organisation administrator to request access.",
+  "creatives.components.AccessForbidden.forbiddenHeader": "You don't have permission to view this page.",
   "creatives.components.BreadCrumbs.header": "This is the BreadCrumbs component !",
   "creatives.components.CapTagList.Cancel": "Cancel",
   "creatives.components.CapTagList.Ok": "Ok",

package/utils/permissions.js

@@ -0,0 +1,59 @@
+import {
+  CREATIVE_VIEW,
+  CREATIVE_CREATE,
+  CREATIVE_EDIT,
+  CREATIVE_DELETE,
+  CREATIVES_UI_VIEW,
+} from '../v2Containers/App/constants';
+
+export const PERMISSIONS = {
+  CREATIVE_VIEW,
+  CREATIVE_CREATE,
+  CREATIVE_EDIT,
+  CREATIVE_DELETE,
+};
+
+export const PERMISSION_IDS = {
+  [CREATIVE_VIEW]: 1508,
+  [CREATIVE_CREATE]: 1509,
+  [CREATIVE_EDIT]: 1510,
+  [CREATIVE_DELETE]: 1511,
+};
+
+/**
+ * Mode-aware access resolver for the tri-modal Creatives app.
+ * Standalone: the `cap` slice is passed as a prop by the connected container.
+ * Library / MFE: the host passes a `cap` (or legacy `Global`) prop.
+ * Reads the prop first, then falls back — mirrors TemplatesV2's existing
+ * `cap.user || Global.user` resolution.
+ */
+export const getUserAccess = (props = {}) => {
+  const { cap = {}, Global = {} } = props;
+  const user = (cap && cap.user) || (Global && Global.user) || {};
+  const isLoaded = !!(
+    user &&
+    typeof user === 'object' &&
+    Object.keys(user).length > 0
+  );
+  return {
+    accessiblePermissions: (isLoaded && user.accessiblePermissions) || [],
+    isLoaded,
+  };
+};
+
+export const hasPermission = (userAccess, code) => {
+  if (!userAccess) return false;
+  const granted = userAccess.accessiblePermissions || [];
+  const id = PERMISSION_IDS[code];
+  return (
+    granted.includes(code) ||
+    granted.includes(id) ||
+    granted.includes(String(id))
+  );
+};
+
+// Zero-impact view gate: honour the new CREATIVE_VIEW OR the legacy CREATIVES_UI_VIEW.
+export const canViewCreatives = userAccess =>
+  hasPermission(userAccess, CREATIVE_VIEW) ||
+  (userAccess &&
+    (userAccess.accessiblePermissions || []).includes(CREATIVES_UI_VIEW));

package/utils/tests/permissions.test.js

@@ -0,0 +1,116 @@
+/**
+ * Test suite for RBAC permission helpers (app/utils/permissions.js).
+ * Covers getUserAccess (loaded/unloaded, cap vs Global, missing perms),
+ * hasPermission (null guard, code/id/string-id match, empty), and
+ * canViewCreatives (new perm, legacy perm, null guard).
+ */
+import {
+  PERMISSIONS,
+  PERMISSION_IDS,
+  getUserAccess,
+  hasPermission,
+  canViewCreatives,
+} from '../permissions';
+import {
+  CREATIVE_VIEW,
+  CREATIVE_CREATE,
+  CREATIVE_EDIT,
+  CREATIVE_DELETE,
+  CREATIVES_UI_VIEW,
+} from '../../v2Containers/App/constants';
+
+describe('permissions - exported maps', () => {
+  it('exposes the four creative permission codes', () => {
+    expect(PERMISSIONS).toEqual({
+      CREATIVE_VIEW,
+      CREATIVE_CREATE,
+      CREATIVE_EDIT,
+      CREATIVE_DELETE,
+    });
+  });
+
+  it('maps each permission code to its id', () => {
+    expect(PERMISSION_IDS[CREATIVE_VIEW]).toBe(1508);
+    expect(PERMISSION_IDS[CREATIVE_CREATE]).toBe(1509);
+    expect(PERMISSION_IDS[CREATIVE_EDIT]).toBe(1510);
+    expect(PERMISSION_IDS[CREATIVE_DELETE]).toBe(1511);
+  });
+});
+
+describe('getUserAccess', () => {
+  it('returns unloaded access with empty perms when no props are passed', () => {
+    expect(getUserAccess()).toEqual({ accessiblePermissions: [], isLoaded: false });
+  });
+
+  it('returns unloaded access for an empty props object', () => {
+    expect(getUserAccess({})).toEqual({ accessiblePermissions: [], isLoaded: false });
+  });
+
+  it('reads accessiblePermissions from cap.user when loaded', () => {
+    const result = getUserAccess({ cap: { user: { accessiblePermissions: [1508, 1509] } } });
+    expect(result).toEqual({ accessiblePermissions: [1508, 1509], isLoaded: true });
+  });
+
+  it('falls back to Global.user when cap.user is absent', () => {
+    const result = getUserAccess({ Global: { user: { accessiblePermissions: ['CREATIVE_VIEW'] } } });
+    expect(result).toEqual({ accessiblePermissions: ['CREATIVE_VIEW'], isLoaded: true });
+  });
+
+  it('is not loaded when the user object is empty', () => {
+    expect(getUserAccess({ cap: { user: {} } })).toEqual({ accessiblePermissions: [], isLoaded: false });
+  });
+
+  it('defaults accessiblePermissions to [] when a loaded user has none', () => {
+    const result = getUserAccess({ cap: { user: { id: 42 } } });
+    expect(result).toEqual({ accessiblePermissions: [], isLoaded: true });
+  });
+});
+
+describe('hasPermission', () => {
+  it('returns false when userAccess is null or undefined', () => {
+    expect(hasPermission(null, CREATIVE_VIEW)).toBe(false);
+    expect(hasPermission(undefined, CREATIVE_VIEW)).toBe(false);
+  });
+
+  it('returns false when accessiblePermissions is missing', () => {
+    expect(hasPermission({}, CREATIVE_VIEW)).toBe(false);
+  });
+
+  it('matches by permission code', () => {
+    expect(hasPermission({ accessiblePermissions: [CREATIVE_CREATE] }, CREATIVE_CREATE)).toBe(true);
+  });
+
+  it('matches by numeric permission id', () => {
+    expect(hasPermission({ accessiblePermissions: [1509] }, CREATIVE_CREATE)).toBe(true);
+  });
+
+  it('matches by string permission id', () => {
+    expect(hasPermission({ accessiblePermissions: ['1509'] }, CREATIVE_CREATE)).toBe(true);
+  });
+
+  it('returns false when the permission is not granted', () => {
+    expect(hasPermission({ accessiblePermissions: [CREATIVE_VIEW] }, CREATIVE_DELETE)).toBe(false);
+    expect(hasPermission({ accessiblePermissions: [] }, CREATIVE_VIEW)).toBe(false);
+  });
+});
+
+describe('canViewCreatives', () => {
+  it('allows when the new CREATIVE_VIEW permission is present', () => {
+    expect(canViewCreatives({ accessiblePermissions: [CREATIVE_VIEW] })).toBe(true);
+    expect(canViewCreatives({ accessiblePermissions: [1508] })).toBe(true);
+  });
+
+  it('allows via the legacy CREATIVES_UI_VIEW permission', () => {
+    expect(canViewCreatives({ accessiblePermissions: [CREATIVES_UI_VIEW] })).toBe(true);
+  });
+
+  it('returns a falsy value when userAccess is null', () => {
+    // short-circuits on `userAccess &&`, so returns null (falsy) rather than false
+    expect(canViewCreatives(null)).toBeFalsy();
+  });
+
+  it('returns false when neither view permission is present', () => {
+    expect(canViewCreatives({ accessiblePermissions: [CREATIVE_CREATE] })).toBe(false);
+    expect(canViewCreatives({})).toBe(false);
+  });
+});

package/v2Components/AccessForbidden/_accessForbidden.scss

@@ -0,0 +1,14 @@
+// Access-denied screen: rbac-lock icon + heading + subtext (matches the shared
+// "no access" screen used across Loyalty+ / Org Settings).
+.no-access-icon {
+  font-size: 48px;
+  color: #8c8c8c;
+}
+.no-access-title {
+  margin-top: 16px;
+}
+.no-access-text {
+  margin-top: 8px;
+  color: #6b778c;
+  max-width: 420px;
+}

package/v2Components/AccessForbidden/index.js

@@ -1,14 +1,16 @@
 import React from 'react';
 import { FormattedMessage } from 'react-intl';
-import { CapRow, CapHeading } from '@capillarytech/cap-ui-library';
+import { CapRow, CapHeading, CapIcon } from '@capillarytech/cap-ui-library';
 import messages from './messages';
+import './_accessForbidden.scss';
 
 const AccessForbidden = () => (
   <CapRow type='flex' vertical justify='center' align='middle' className="margin-t-32 text-align-center">
-    <CapHeading type="h2">
+    <CapIcon type="rbac-lock" className="no-access-icon" />
+    <CapHeading type="h3" className="no-access-title">
       <FormattedMessage {...messages.forbiddenHeader} />
     </CapHeading>
-    <CapHeading type="h3" className="margin-t-24">
+    <CapHeading type="h6" className="no-access-text">
       <FormattedMessage {...messages.forbiddenDesc} />
     </CapHeading>
   </CapRow>

package/v2Components/AccessForbidden/messages.js

@@ -5,10 +5,11 @@ const prefix = 'creatives.components.AccessForbidden';
 export default defineMessages({
   forbiddenHeader: {
     id: `${prefix}.forbiddenHeader`,
-    defaultMessage: 'Access Forbidden',
+    defaultMessage: "You don't have permission to view this page.",
   },
   forbiddenDesc: {
     id: `${prefix}.forbiddenDesc`,
-    defaultMessage: 'This page access has not been provided to you.',
+    defaultMessage:
+      'Please contact your organisation administrator to request access.',
   },
 });

package/v2Components/CommonTestAndPreview/UnifiedPreview/ViberCarouselPreviewCards.js

@@ -0,0 +1,132 @@
+import React, { useLayoutEffect, useMemo, useRef, useState } from 'react';
+import PropTypes from 'prop-types';
+import CapRow from '@capillarytech/cap-ui-library/CapRow';
+import CapLabel from '@capillarytech/cap-ui-library/CapLabel';
+import CapImage from '@capillarytech/cap-ui-library/CapImage';
+
+const getTrimmedText = (value = '') => (value ?? '').trim();
+const hasTrimmedText = (value = '') => Boolean(getTrimmedText(value));
+
+const getCarouselButtonsWithTitles = (card) => (
+  (card?.buttons ?? []).filter((button) => hasTrimmedText(button?.title)).slice(0, 2)
+);
+
+const getCarouselButtonSlotCount = (cards = []) => {
+  const buttonCounts = cards.map((card) => getCarouselButtonsWithTitles(card).length);
+  return Math.min(2, Math.max(0, ...buttonCounts, 0));
+};
+
+const ViberCarouselPreviewCards = ({ cards = [] }) => {
+  const previewCards = Array.isArray(cards) && cards.length ? cards : [{}];
+  const carouselButtonSlotCount = useMemo(
+    () => getCarouselButtonSlotCount(previewCards),
+    [previewCards],
+  );
+  const carouselTitleRefs = useRef([]);
+  const [carouselTitleLineCount, setCarouselTitleLineCount] = useState(1);
+
+  carouselTitleRefs.current = previewCards.map(() => null);
+
+  useLayoutEffect(() => {
+    let maxLines = 1;
+    carouselTitleRefs.current.forEach((node) => {
+      if (!node) {
+        return;
+      }
+      const { lineHeight } = window.getComputedStyle(node);
+      const parsedLineHeight = parseFloat(lineHeight) || 18;
+      const lines = Math.min(2, Math.max(1, Math.round(node.scrollHeight / parsedLineHeight)));
+      if (lines > maxLines) {
+        maxLines = lines;
+      }
+    });
+    setCarouselTitleLineCount((prev) => (prev === maxLines ? prev : maxLines));
+  }, [previewCards]);
+
+  return (
+    <CapRow type="flex" noWrap className="viber-carousel-preview-scroll">
+      {previewCards.map((card, index) => {
+        const cardButtons = getCarouselButtonsWithTitles(card);
+        const titleLineClass = `viber-carousel-preview-text-wrap--${carouselTitleLineCount}-line`;
+
+        return (
+          <CapRow type="flex-column" className="viber-carousel-preview-card" key={`viber-carousel-preview-card-${index}`}>
+            {hasTrimmedText(card?.mediaUrl) ? (
+              <CapImage
+                src={card?.mediaUrl}
+                className="viber-carousel-preview-image"
+                alt="Viber carousel card"
+              />
+            ) : (
+              <CapRow className="viber-carousel-preview-image-placeholder" />
+            )}
+            <CapRow className="viber-carousel-preview-card-body">
+              <CapRow className={`viber-carousel-preview-text-wrap ${titleLineClass}`}>
+                {hasTrimmedText(card?.text) ? (
+                  <CapRow
+                    className="viber-carousel-preview-text-inner"
+                    ref={(node) => {
+                      carouselTitleRefs.current[index] = node;
+                    }}
+                  >
+                    <CapLabel type="label15" className="viber-carousel-preview-text">
+                      {card?.text}
+                    </CapLabel>
+                  </CapRow>
+                ) : (
+                  <CapLabel type="label15" className="viber-carousel-preview-text-placeholder" />
+                )}
+              </CapRow>
+              {carouselButtonSlotCount > 0 && (
+                <CapRow className="viber-carousel-preview-buttons">
+                  {Array.from({ length: carouselButtonSlotCount }).map((_, btnIndex) => {
+                    const cardButton = cardButtons[btnIndex];
+                    const trimmedCardButtonTitle = cardButton
+                      ? getTrimmedText(cardButton?.title)
+                      : '';
+
+                    if (!trimmedCardButtonTitle) {
+                      return (
+                        <CapRow
+                          className="viber-carousel-preview-button viber-carousel-preview-button-placeholder"
+                          key={`viber-carousel-preview-btn-placeholder-${index}-${btnIndex}`}
+                          aria-hidden="true"
+                        />
+                      );
+                    }
+
+                    return (
+                      <CapLabel
+                        className={`viber-carousel-preview-button ${btnIndex === 1 ? 'viber-carousel-preview-button-secondary' : ''}`}
+                        key={`viber-carousel-preview-btn-${index}-${btnIndex}-${trimmedCardButtonTitle}`}
+                      >
+                        {trimmedCardButtonTitle}
+                      </CapLabel>
+                    );
+                  })}
+                </CapRow>
+              )}
+            </CapRow>
+          </CapRow>
+        );
+      })}
+    </CapRow>
+  );
+};
+
+ViberCarouselPreviewCards.propTypes = {
+  cards: PropTypes.arrayOf(PropTypes.shape({
+    text: PropTypes.string,
+    mediaUrl: PropTypes.string,
+    buttons: PropTypes.arrayOf(PropTypes.shape({
+      title: PropTypes.string,
+      action: PropTypes.string,
+    })),
+  })),
+};
+
+ViberCarouselPreviewCards.defaultProps = {
+  cards: [],
+};
+
+export default ViberCarouselPreviewCards;

package/v2Components/CommonTestAndPreview/UnifiedPreview/ViberPreviewContent.js

@@ -14,14 +14,25 @@ import CapSpin from '@capillarytech/cap-ui-library/CapSpin';
 import CapImage from '@capillarytech/cap-ui-library/CapImage';
 import CapTooltip from '@capillarytech/cap-ui-library/CapTooltip';
 import CapRow from '@capillarytech/cap-ui-library/CapRow';
-import { ANDROID, IOS, ANDROID_DEVICE_NAME, IOS_DEVICE_NAME, VIBER_ACCOUNT_NAME } from '../constants';
+import {
+  ANDROID,
+  IOS,
+  ANDROID_DEVICE_NAME,
+  IOS_DEVICE_NAME,
+  VIBER_ACCOUNT_NAME,
+  MEDIA_TYPE_CAROUSEL,
+} from '../constants';
 import messages from '../messages';
 import videoPlay from '../../../assets/videoPlay.svg';
+import ViberCarouselPreviewCards from './ViberCarouselPreviewCards';
 
 // Import device mockup images (same as SMS)
 const smsMobileAndroid = require('../../../assets/Android.png');
 const smsMobileIos = require('../../../assets/iOS.png');
 
+const getTrimmedText = (value = '') => (value ?? '').trim();
+const hasTrimmedText = (value = '') => Boolean(getTrimmedText(value));
+
 const ViberPreviewContent = ({
   content,
   device,
@@ -43,7 +54,35 @@ const ViberPreviewContent = ({
     imageURL = '',
     videoParams = {},
     buttonText = '',
+    type = '',
+    cards = [],
+    showCarouselEditorPreview = false,
   } = viberContent;
+  const hasCarouselContent = type === MEDIA_TYPE_CAROUSEL;
+
+  const cardHasMeaningfulContent = (card) => {
+    if (!card || typeof card !== 'object') return false;
+    return (
+      hasTrimmedText(card?.text) ||
+      hasTrimmedText(card?.mediaUrl) ||
+      (card.buttons ?? []).some(button => hasTrimmedText(button?.title))
+    );
+  };
+
+  const hasMeaningfulCarousel =
+    hasCarouselContent &&
+    Array.isArray(cards) &&
+    cards.length > 0 &&
+    cards.some(cardHasMeaningfulContent);
+
+  const showCarouselInPreview =
+    hasCarouselContent && (Boolean(showCarouselEditorPreview) || hasMeaningfulCarousel);
+
+  const previewCarouselCards =
+    hasCarouselContent && Array.isArray(cards) && cards.length ? cards : hasCarouselContent ? [{}] : [];
+
+  const trimmedMessageContent = getTrimmedText(messageContent);
+  const trimmedButtonText = getTrimmedText(buttonText);
 
   // Get account name (first letter for icon)
   const accountIcon = (accountName || brandName || 'V')[0]?.toUpperCase();
@@ -99,8 +138,15 @@ const ViberPreviewContent = ({
     );
   }
 
-  // Check if there's any content to display
-  const hasContent = messageContent || imageURL || videoParams?.viberVideoSrc || buttonText;
+  // Check if there's any content to display (whitespace-only strings do not count)
+  const hasContent = Boolean(
+    trimmedMessageContent
+    || hasTrimmedText(imageURL)
+    || videoParams?.viberVideoSrc
+    || trimmedButtonText
+    || hasMeaningfulCarousel
+    || (hasCarouselContent && showCarouselEditorPreview)
+  );
 
   // Render normal Viber preview
   return (
@@ -125,23 +171,34 @@ const ViberPreviewContent = ({
 
         {/* Viber Message Container */}
         {hasContent && (
-          <CapRow className={`viber-message-container ${device !== ANDROID ? 'viber-message-container-ios' : ''}`}>
+          <CapRow className={`viber-message-container ${showCarouselInPreview ? 'viber-message-container-carousel' : ''} ${device !== ANDROID ? 'viber-message-container-ios' : ''}`}>
             {/* Brand Name Display (from TemplatePreview line 1136) */}
-            <CapRow type="flex" align="middle" className="msg-container viber-preview">
+            <CapRow
+              type="flex"
+              align="middle"
+              fullWidth={showCarouselInPreview}
+              className={`msg-container viber-preview ${showCarouselInPreview ? 'viber-preview-carousel' : ''}`}
+            >
               {/* Account Icon (from TemplatePreview line 1146-1160) */}
-              <CapRow type='flex' className="viber-account-icon">
-                {accountIcon}
-              </CapRow>
+              {!hasCarouselContent && (
+                <CapRow type="flex" className="viber-account-icon">
+                  {accountIcon}
+                </CapRow>
+              )}
 
               {/* Message Bubble (from TemplatePreview line 1161-1223) */}
-              <CapRow useLegacy className="message-pop align-left viber-message-pop">
+              <CapRow
+                useLegacy
+                fullWidth={showCarouselInPreview}
+                className={`message-pop align-left viber-message-pop ${showCarouselInPreview ? 'viber-message-pop-carousel' : ''}`}
+              >
                 {/* Text Viber preview */}
-                {messageContent && (
+                {trimmedMessageContent && !hasCarouselContent && (
                   <CapLabel type="label15" className="viber-message-text">{messageContent}</CapLabel>
                 )}
 
                 {/* Image Viber preview */}
-                {imageURL && (
+                {hasTrimmedText(imageURL) && (
                   <CapImage
                     src={imageURL}
                     className="viber-image-preview"
@@ -171,16 +228,42 @@ const ViberPreviewContent = ({
                 )}
 
                 {/* Button Viber preview */}
-                {buttonText && (
+                {trimmedButtonText && (
                   <CapLabel className="viber-button-base">
                     <p className="viber-button-card-text">
                       {buttonText}
                     </p>
                   </CapLabel>
                 )}
-                <CapLabel type="label1" className="viber-timestamp">
-                  {timestamp}
-                </CapLabel>
+                {/* Carousel Viber preview */}
+                {showCarouselInPreview && (
+                  <CapRow type="flex-column" fullWidth className="viber-carousel-preview">
+                    <CapRow type="flex-column" className="viber-carousel-message-pop">
+                      {trimmedMessageContent ? (
+                        <CapLabel
+                          type="label15"
+                          className="message-pop-item align-left viber-message-text viber-carousel-message-box-text"
+                        >
+                          {messageContent}
+                        </CapLabel>
+                      ) : (
+                        <CapRow className="viber-carousel-message-box-placeholder" />
+                      )}
+                      <CapLabel type="label1" className="viber-carousel-message-timestamp">
+                        {timestamp}
+                      </CapLabel>
+                    </CapRow>
+
+                    <CapRow type="flex-column" fullWidth className="viber-carousel-cards-pop">
+                      <ViberCarouselPreviewCards cards={previewCarouselCards} />
+                    </CapRow>
+                  </CapRow>
+                )}
+                {!showCarouselInPreview && (
+                  <CapLabel type="label1" className="viber-timestamp">
+                    {timestamp}
+                  </CapLabel>
+                )}
                 <CapRow useLegacy className="empty-placeholder" />
               </CapRow>
 
@@ -214,6 +297,16 @@ ViberPreviewContent.propTypes = {
         viberVideoPreviewImg: PropTypes.string,
       }),
       buttonText: PropTypes.string,
+      type: PropTypes.string,
+      cards: PropTypes.arrayOf(PropTypes.shape({
+        text: PropTypes.string,
+        mediaUrl: PropTypes.string,
+        buttons: PropTypes.arrayOf(PropTypes.shape({
+          title: PropTypes.string,
+          action: PropTypes.string,
+        })),
+      })),
+      showCarouselEditorPreview: PropTypes.bool,
     }),
   }),
   device: PropTypes.oneOf([ANDROID, IOS]),