@loyalytics/swan-react-native-sdk 2.1.3-beta.0 → 2.1.3-beta.1

package/scripts/setup-ios-extension.js

@@ -63,7 +63,7 @@ function copyFileOrDirectory(src, dest) {
 
     // Copy all files in directory
     const files = fs.readdirSync(src);
-    files.forEach(file => {
+    files.forEach((file) => {
       const srcPath = path.join(src, file);
       const destPath = path.join(dest, file);
       copyFileOrDirectory(srcPath, destPath);
@@ -93,7 +93,9 @@ function setup() {
   // Check if ios/ directory exists
   const iosDir = path.join(projectRoot, 'ios');
   if (!fs.existsSync(iosDir)) {
-    logError('iOS directory not found! This script must be run from a React Native project root.');
+    logError(
+      'iOS directory not found! This script must be run from a React Native project root.'
+    );
     logError('Expected directory: ' + iosDir);
     process.exit(1);
   }
@@ -112,10 +114,17 @@ function setup() {
   logSuccess(`Project name: ${projectName}`);
 
   // Find SDK directory
-  const sdkDir = path.join(projectRoot, 'node_modules', '@loyalytics', 'swan-react-native-sdk');
+  const sdkDir = path.join(
+    projectRoot,
+    'node_modules',
+    '@loyalytics',
+    'swan-react-native-sdk'
+  );
   if (!fs.existsSync(sdkDir)) {
     logError('@loyalytics/swan-react-native-sdk not found in node_modules!');
-    logError('Make sure the SDK is installed: npm install @loyalytics/swan-react-native-sdk');
+    logError(
+      'Make sure the SDK is installed: npm install @loyalytics/swan-react-native-sdk'
+    );
     process.exit(1);
   }
   logSuccess('Swan SDK found');
@@ -142,7 +151,7 @@ function setup() {
 
   if (missingDeps.length > 0) {
     logWarning('Missing required dependencies:');
-    missingDeps.forEach(dep => {
+    missingDeps.forEach((dep) => {
       log(`  - ${dep}`, colors.yellow);
     });
     logInfo('Install missing dependencies with:');
@@ -153,8 +162,15 @@ function setup() {
   // Step 3: Copy extension files
   logStep(3, 'Copying Notification Service Extension files');
 
-  const extensionSrcDir = path.join(sdkDir, 'ios', 'SwanNotificationServiceExtension');
-  const extensionDestDir = path.join(iosDir, 'SwanNotificationServiceExtension');
+  const extensionSrcDir = path.join(
+    sdkDir,
+    'ios',
+    'SwanNotificationServiceExtension'
+  );
+  const extensionDestDir = path.join(
+    iosDir,
+    'SwanNotificationServiceExtension'
+  );
 
   if (fs.existsSync(extensionDestDir)) {
     logWarning('SwanNotificationServiceExtension directory already exists');
@@ -163,21 +179,62 @@ function setup() {
 
   try {
     copyFileOrDirectory(extensionSrcDir, extensionDestDir);
-    logSuccess('Extension files copied successfully');
+    logSuccess('Service Extension files copied successfully');
     logInfo(`Destination: ${extensionDestDir}`);
   } catch (error) {
     logError(`Failed to copy extension files: ${error.message}`);
     process.exit(1);
   }
 
+  // Step 3b: Copy Content Extension files (for carousel, rich notifications)
+  logStep('3b', 'Copying Notification Content Extension files');
+
+  const contentExtSrcDir = path.join(
+    sdkDir,
+    'ios',
+    'SwanNotificationContentExtension'
+  );
+  const contentExtDestDir = path.join(
+    iosDir,
+    'SwanNotificationContentExtension'
+  );
+
+  if (fs.existsSync(contentExtSrcDir)) {
+    if (fs.existsSync(contentExtDestDir)) {
+      logWarning('SwanNotificationContentExtension directory already exists');
+      logInfo('Overwriting existing files...');
+    }
+
+    try {
+      copyFileOrDirectory(contentExtSrcDir, contentExtDestDir);
+      logSuccess('Content Extension files copied successfully');
+      logInfo(`Destination: ${contentExtDestDir}`);
+    } catch (error) {
+      logWarning(`Failed to copy Content Extension files: ${error.message}`);
+      logInfo(
+        'Content Extension is optional — carousel push will fall back to standard notification'
+      );
+    }
+  } else {
+    logInfo(
+      'Content Extension source not found (optional, carousel will use standard notification)'
+    );
+  }
+
   // Step 4: Generate manual setup instructions
   logStep(4, 'Setup Instructions');
 
   log('\n' + '─'.repeat(60), colors.cyan);
-  log('IMPORTANT: Manual Xcode Configuration Required', colors.bright + colors.yellow);
+  log(
+    'IMPORTANT: Manual Xcode Configuration Required',
+    colors.bright + colors.yellow
+  );
   log('─'.repeat(60) + '\n', colors.cyan);
 
-  log('The extension files have been copied to your ios/ directory.', colors.cyan);
+  log(
+    'The extension files have been copied to your ios/ directory.',
+    colors.cyan
+  );
   log('You must now complete the setup in Xcode:\n');
 
   const instructions = [
@@ -192,7 +249,7 @@ function setup() {
         'Click Finish',
         'When prompted "Activate scheme?", click "Cancel"',
         'STOP HERE: If you have not done this, the next steps will fail or be overwritten.',
-      ]
+      ],
     },
     {
       title: '2. Verify Files in Xcode Project',
@@ -202,7 +259,7 @@ function setup() {
         'In Xcode Project Navigator, expand `SwanNotificationServiceExtension` folder.',
         'Verify that `NotificationService.swift`, `Info.plist`, and `SwanNotificationServiceExtension.entitlements` are present and contain the SwanSDK code.',
         'If any files are missing from the Xcode Project Navigator (even if they exist on disk), right-click on the `SwanNotificationServiceExtension` folder in Xcode and choose "Add Files to YourProject" to re-add them, making sure "Add to target: SwanNotificationServiceExtension" is checked and "Copy items if needed" is UNCHECKED.',
-      ]
+      ],
     },
     {
       title: '3. Configure App Groups',
@@ -216,18 +273,36 @@ function setup() {
         'Click "+ Capability" and add "App Groups"',
         'Click "+" under App Groups and add: group.swan.sdk.notifications',
         '(IMPORTANT: Both targets must have the SAME App Group ID)',
-      ]
+      ],
     },
     {
-      title: '4. Build and Test',
+      title: '4. Add Content Extension Target (OPTIONAL — for carousel push)',
+      steps: [
+        'In Xcode, go to File → New → Target',
+        'Choose "Notification Content Extension"',
+        'Product Name: SwanNotificationContentExtension',
+        'Language: Swift',
+        'Click Finish, click "Cancel" when prompted to activate scheme',
+        'Delete the auto-generated files and verify the Swan files are visible:',
+        '  - NotificationViewController.swift',
+        '  - templates/CarouselView.swift',
+        '  - common/ImageDownloader.swift',
+        '  - Info.plist, MainInterface.storyboard, entitlements',
+        'Add App Group "group.swan.sdk.notifications" to this target too',
+        'Set deployment target to match your main app',
+      ],
+    },
+    {
+      title: '5. Build and Test',
       steps: [
         'Build your app: Product → Build (Cmd+B)',
         'Archive your app: Product → Archive',
-        'Test on a REAL device (push doesn\'t work on simulator)',
+        "Test on a REAL device (push doesn't work on simulator)",
         'Send a test notification and check Xcode console for logs',
         'Look for: [SwanSDK Extension] logs',
-      ]
-    }
+        'Test carousel: send push with notificationType: "carousel" and long-press',
+      ],
+    },
   ];
 
   instructions.forEach((section, index) => {
@@ -247,19 +322,24 @@ function setup() {
   log('Troubleshooting', colors.bright);
   log('─'.repeat(60) + '\n', colors.cyan);
 
-  log('If extension logs don\'t appear:', colors.yellow);
+  log("If extension logs don't appear:", colors.yellow);
   log('  • Make sure App Groups are configured in BOTH targets');
   log('  • Verify App Group ID matches: group.swan.sdk.notifications');
   log('  • Check that mutable-content: 1 is in FCM APNS payload');
   log('  • Extension only runs for APNS notifications with mutable-content');
   log('  • Test on a real device, not simulator\n');
 
-  log('If you see "CocoaPods Error: Unable to find compatibility version string for object version 70":', colors.yellow);
+  log(
+    'If you see "CocoaPods Error: Unable to find compatibility version string for object version 70":',
+    colors.yellow
+  );
   log('  • In Xcode, select your Project → Build Settings → Project Format');
   log('  • Set it to "Xcode 16.0-compatible" or later\n');
 
   log('For detailed documentation, see:', colors.cyan);
-  log('  node_modules/@loyalytics/swan-react-native-sdk/docs/IOS_NOTIFICATION_EXTENSION_SETUP.md\n');
+  log(
+    '  node_modules/@loyalytics/swan-react-native-sdk/docs/IOS_NOTIFICATION_EXTENSION_SETUP.md\n'
+  );
 
   logSuccess('Setup script completed!');
   log('');

package/scripts/test-carousel-push.js

@@ -0,0 +1,266 @@
+#!/usr/bin/env node
+
+/**
+ * Swan SDK - Carousel Push Notification Test Script
+ *
+ * Sends test carousel push notifications via Firebase Admin SDK.
+ * Requires firebase-admin to be installed (already in devDependencies).
+ *
+ * Usage:
+ *   node scripts/test-carousel-push.js --token <FCM_TOKEN> [--mode manual|auto] [--scenario <name>]
+ *
+ * Environment:
+ *   GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json
+ *
+ * Scenarios:
+ *   manual-3     — Manual carousel with 3 products (default)
+ *   auto-5       — Auto carousel with 5 products, 2s interval (ViewFlipper)
+ *   filmstrip-4  — Filmstrip variant with 4 products (3-image preview strip)
+ *   single-item  — Single item carousel (should hide arrows)
+ *   invalid-json — Invalid carouselItems JSON (tests fallback)
+ *   no-images    — Items without imageUrl (tests filtering)
+ */
+
+const admin = require('firebase-admin');
+
+// Parse CLI args
+const args = process.argv.slice(2);
+const getArg = (name) => {
+  const idx = args.indexOf(`--${name}`);
+  return idx !== -1 ? args[idx + 1] : undefined;
+};
+
+const fcmToken = getArg('token');
+const mode = getArg('mode') || 'manual';
+const scenarioName = getArg('scenario') || 'manual-3';
+
+if (!fcmToken) {
+  console.error(
+    'Usage: node scripts/test-carousel-push.js --token <FCM_TOKEN> [--mode manual|auto] [--scenario <name>]'
+  );
+  console.error(
+    '\nAvailable scenarios: manual-3, auto-5, filmstrip-4, single-item, invalid-json, no-images'
+  );
+  process.exit(1);
+}
+
+// Initialize Firebase Admin
+if (!admin.apps.length) {
+  admin.initializeApp({
+    credential: admin.credential.applicationDefault(),
+  });
+}
+
+const SAMPLE_IMAGES = [
+  'https://picsum.photos/seed/swan1/400/200',
+  'https://picsum.photos/seed/swan2/400/200',
+  'https://picsum.photos/seed/swan3/400/200',
+  'https://picsum.photos/seed/swan4/400/200',
+  'https://picsum.photos/seed/swan5/400/200',
+];
+
+const scenarios = {
+  'manual-3': {
+    name: 'Manual carousel — 3 products',
+    data: {
+      notificationType: 'carousel',
+      carouselMode: 'manual',
+      title: 'Flash Sale - Top Picks!',
+      body: 'Swipe to see our best deals',
+      channelId: 'swan_promotional',
+      carouselItems: JSON.stringify([
+        {
+          imageUrl: SAMPLE_IMAGES[0],
+          title: 'Wireless Earbuds',
+          body: '50% off - $29.99',
+          route: '/product/101',
+        },
+        {
+          imageUrl: SAMPLE_IMAGES[1],
+          title: 'Smart Watch',
+          body: 'New arrival',
+          route: '/product/102',
+        },
+        {
+          imageUrl: SAMPLE_IMAGES[2],
+          title: 'Phone Case',
+          body: 'Best seller',
+          route: '/product/103',
+        },
+      ]),
+    },
+  },
+  'auto-5': {
+    name: 'Auto carousel — 5 products, 2s interval (ViewFlipper)',
+    data: {
+      notificationType: 'carousel',
+      carouselMode: 'auto',
+      carouselInterval: '2000',
+      title: 'Recommended for You',
+      body: 'Based on your recent browsing',
+      channelId: 'swan_general',
+      defaultRoute: '/recommended',
+      carouselItems: JSON.stringify([
+        {
+          imageUrl: SAMPLE_IMAGES[0],
+          title: 'Product A',
+          body: '$19.99',
+          route: '/product/201',
+        },
+        {
+          imageUrl: SAMPLE_IMAGES[1],
+          title: 'Product B',
+          body: '$24.99',
+          route: '/product/202',
+        },
+        {
+          imageUrl: SAMPLE_IMAGES[2],
+          title: 'Product C',
+          body: '$14.99',
+          route: '/product/203',
+        },
+        {
+          imageUrl: SAMPLE_IMAGES[3],
+          title: 'Product D',
+          body: '$39.99',
+          route: '/product/204',
+        },
+        {
+          imageUrl: SAMPLE_IMAGES[4],
+          title: 'Product E',
+          body: '$9.99',
+          route: '/product/205',
+        },
+      ]),
+    },
+  },
+  'filmstrip-4': {
+    name: 'Filmstrip carousel — 4 products with side previews',
+    data: {
+      notificationType: 'carousel',
+      carouselMode: 'manual',
+      carouselVariant: 'filmstrip',
+      title: 'Summer Collection',
+      body: 'Tap the side images to browse',
+      channelId: 'swan_promotional',
+      carouselItems: JSON.stringify([
+        {
+          imageUrl: SAMPLE_IMAGES[0],
+          title: 'Summer Dress',
+          body: '$49.99',
+          route: '/product/401',
+        },
+        {
+          imageUrl: SAMPLE_IMAGES[1],
+          title: 'Beach Sandals',
+          body: '$29.99',
+          route: '/product/402',
+        },
+        {
+          imageUrl: SAMPLE_IMAGES[2],
+          title: 'Sun Hat',
+          body: '$19.99',
+          route: '/product/403',
+        },
+        {
+          imageUrl: SAMPLE_IMAGES[3],
+          title: 'Sunglasses',
+          body: '$34.99',
+          route: '/product/404',
+        },
+      ]),
+    },
+  },
+  'single-item': {
+    name: 'Single item carousel (should look like normal image notification)',
+    data: {
+      notificationType: 'carousel',
+      carouselMode: 'manual',
+      title: 'Just for You',
+      body: 'Check this out',
+      channelId: 'swan_promotional',
+      carouselItems: JSON.stringify([
+        {
+          imageUrl: SAMPLE_IMAGES[0],
+          title: 'Featured Product',
+          body: 'Limited time offer',
+          route: '/product/301',
+        },
+      ]),
+    },
+  },
+  'invalid-json': {
+    name: 'Invalid carouselItems JSON (should fall back to standard notification)',
+    data: {
+      notificationType: 'carousel',
+      carouselMode: 'manual',
+      title: 'Bad Payload Test',
+      body: 'Should show as standard notification',
+      channelId: 'swan_general',
+      carouselItems: 'this is not valid json {{{',
+    },
+  },
+  'no-images': {
+    name: 'Items without imageUrl (should filter and fall back)',
+    data: {
+      notificationType: 'carousel',
+      carouselMode: 'manual',
+      title: 'No Images Test',
+      body: 'Items lack imageUrl',
+      channelId: 'swan_general',
+      carouselItems: JSON.stringify([
+        { title: 'No image 1', body: 'Missing imageUrl' },
+        { title: 'No image 2', body: 'Also missing' },
+      ]),
+    },
+  },
+};
+
+async function sendPush(scenario) {
+  console.log(`\nSending: ${scenario.name}`);
+  console.log(`Mode: ${scenario.data.carouselMode || 'manual'}`);
+  console.log(`Token: ${fcmToken.substring(0, 20)}...`);
+
+  const message = {
+    token: fcmToken,
+    data: scenario.data,
+    android: {
+      priority: 'high',
+    },
+    apns: {
+      payload: {
+        aps: {
+          'mutable-content': 1,
+          'category': 'swan_carousel',
+        },
+      },
+    },
+  };
+
+  try {
+    const response = await admin.messaging().send(message);
+    console.log(`Sent successfully! messageId: ${response}`);
+    return response;
+  } catch (error) {
+    console.error(`Failed to send: ${error.message}`);
+    return null;
+  }
+}
+
+async function main() {
+  const scenario = scenarios[scenarioName];
+  if (!scenario) {
+    console.error(`Unknown scenario: ${scenarioName}`);
+    console.error(`Available: ${Object.keys(scenarios).join(', ')}`);
+    process.exit(1);
+  }
+
+  // Override mode if --mode flag is provided and scenario supports it
+  if (mode && scenario.data.carouselMode !== undefined) {
+    scenario.data.carouselMode = mode;
+  }
+
+  await sendPush(scenario);
+}
+
+main().catch(console.error);

package/swan-react-native-sdk.podspec

@@ -0,0 +1,18 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "swan-react-native-sdk"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+  s.source       = { :git => package["repository"]["url"], :tag => "v#{s.version}" }
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+
+  install_modules_dependencies(s)
+end