@loyalytics/swan-react-native-sdk 2.1.3-beta.2 → 2.1.3-beta.4

package/lib/commonjs/version.js

@@ -8,5 +8,5 @@ exports.SDK_VERSION = void 0;
 // This file is generated from package.json version during build.
 // See scripts/generate-version.js
 
-const SDK_VERSION = exports.SDK_VERSION = '2.1.3-beta.2';
+const SDK_VERSION = exports.SDK_VERSION = '2.1.3-beta.4';
 //# sourceMappingURL=version.js.map

package/lib/module/version.js

@@ -4,5 +4,5 @@
 // This file is generated from package.json version during build.
 // See scripts/generate-version.js
 
-export const SDK_VERSION = '2.1.3-beta.2';
+export const SDK_VERSION = '2.1.3-beta.4';
 //# sourceMappingURL=version.js.map

package/lib/typescript/commonjs/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION = "2.1.3-beta.2";
+export declare const SDK_VERSION = "2.1.3-beta.4";
 //# sourceMappingURL=version.d.ts.map

package/lib/typescript/module/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION = "2.1.3-beta.2";
+export declare const SDK_VERSION = "2.1.3-beta.4";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loyalytics/swan-react-native-sdk",
-  "version": "2.1.3-beta.2",
+  "version": "2.1.3-beta.4",
   "description": "React Native SDK for Swan",
   "source": "./src/index.tsx",
   "main": "./lib/commonjs/index.js",
@@ -23,7 +23,6 @@
     "ios",
     "cpp",
     "scripts",
-    "docs",
     "*.podspec",
     "react-native.config.json",
     "!ios/build",
@@ -35,7 +34,9 @@
     "!**/__tests__",
     "!**/__fixtures__",
     "!**/__mocks__",
-    "!**/.*"
+    "!**/.*",
+    "!android/src/test",
+    "!scripts/test-carousel-push.js"
   ],
   "scripts": {
     "test": "jest",
@@ -214,9 +215,6 @@
     "@react-native-async-storage/async-storage": "2.2.0",
     "@react-native-community/geolocation": "^3.4.0",
     "@react-native-community/netinfo": "^11.0.0",
-    "expo": "~52.0.47",
-    "react": "*",
-    "react-native": "*",
     "react-native-base64": "^0.2.1",
     "react-native-device-info": "^14.0.1",
     "react-native-shared-group-preferences": "^1.1.24",

package/android/src/test/kotlin/com/loyalytics/swan/templates/carousel/CarouselTemplateTest.kt

@@ -1,125 +0,0 @@
-package com.loyalytics.swan.templates.carousel
-
-import org.junit.Assert.*
-import org.junit.Test
-
-class CarouselTemplateTest {
-
-    // --- wrapIndex ---
-
-    @Test
-    fun `wrapIndex forward at end wraps to first`() {
-        assertEquals(0, wrapIndex(3, 3))
-    }
-
-    @Test
-    fun `wrapIndex backward at start wraps to last`() {
-        assertEquals(2, wrapIndex(-1, 3))
-    }
-
-    @Test
-    fun `wrapIndex normal forward`() {
-        assertEquals(1, wrapIndex(1, 3))
-        assertEquals(2, wrapIndex(2, 3))
-    }
-
-    @Test
-    fun `wrapIndex normal backward`() {
-        assertEquals(1, wrapIndex(1, 3))
-    }
-
-    @Test
-    fun `wrapIndex with single item always returns 0`() {
-        assertEquals(0, wrapIndex(0, 1))
-        assertEquals(0, wrapIndex(1, 1))
-        assertEquals(0, wrapIndex(-1, 1))
-    }
-
-    @Test
-    fun `wrapIndex with size 0 returns 0`() {
-        assertEquals(0, wrapIndex(0, 0))
-        assertEquals(0, wrapIndex(5, 0))
-    }
-
-    @Test
-    fun `wrapIndex large negative wraps correctly`() {
-        // -5 with size 3: -5 mod 3 = -2, + 3 = 1
-        assertEquals(1, wrapIndex(-5, 3))
-    }
-
-    @Test
-    fun `wrapIndex large positive wraps correctly`() {
-        // 7 with size 3: 7 mod 3 = 1
-        assertEquals(1, wrapIndex(7, 3))
-    }
-
-    @Test
-    fun `wrapIndex full cycle returns to start`() {
-        // Going forward through all items returns to 0
-        val size = 5
-        for (i in 0 until size) {
-            assertEquals(i, wrapIndex(i, size))
-        }
-        assertEquals(0, wrapIndex(size, size))
-    }
-
-    @Test
-    fun `wrapIndex two items alternates correctly`() {
-        assertEquals(0, wrapIndex(0, 2))
-        assertEquals(1, wrapIndex(1, 2))
-        assertEquals(0, wrapIndex(2, 2))
-        assertEquals(1, wrapIndex(-1, 2))
-    }
-
-    @Test
-    fun `wrapIndex filmstrip prev-current-next for 3 items`() {
-        val size = 3
-        // At index 0: prev=2, current=0, next=1
-        assertEquals(2, wrapIndex(0 - 1, size))
-        assertEquals(0, wrapIndex(0, size))
-        assertEquals(1, wrapIndex(0 + 1, size))
-
-        // At index 2: prev=1, current=2, next=0
-        assertEquals(1, wrapIndex(2 - 1, size))
-        assertEquals(2, wrapIndex(2, size))
-        assertEquals(0, wrapIndex(2 + 1, size))
-    }
-
-    // --- canHandle ---
-
-    @Test
-    fun `canHandle returns true for carousel type`() {
-        val template = CarouselTemplate()
-        assertTrue(template.canHandle("carousel"))
-    }
-
-    @Test
-    fun `canHandle returns false for other types`() {
-        val template = CarouselTemplate()
-        assertFalse(template.canHandle("timer"))
-        assertFalse(template.canHandle("cta"))
-        assertFalse(template.canHandle(""))
-        assertFalse(template.canHandle("CAROUSEL"))
-        assertFalse(template.canHandle("Carousel"))
-    }
-
-    // --- CarouselAutoRemoteViews.MAX_FLIPPER_IMAGES cap ---
-    // (Cannot directly test private const, but we verify the build method
-    //  is accessible and the type is correct)
-
-    @Test
-    fun `CarouselAutoRemoteViews is a singleton object`() {
-        // Verify the object exists and is accessible
-        assertNotNull(CarouselAutoRemoteViews)
-    }
-
-    @Test
-    fun `CarouselFilmstripRemoteViews is a singleton object`() {
-        assertNotNull(CarouselFilmstripRemoteViews)
-    }
-
-    @Test
-    fun `CarouselRemoteViews is a singleton object`() {
-        assertNotNull(CarouselRemoteViews)
-    }
-}

package/docs/IOS_NOTIFICATION_EXTENSION_SETUP.md

@@ -1,335 +0,0 @@
-# iOS Notification Service Extension Setup
-
-## Overview
-
-The Swan SDK's Notification Service Extension enables:
-- ✅ **Delivery tracking** when app is killed or in background
-- ✅ **Rich media support** (images in notifications)
-- ✅ **Reliable ACKs** even when app is not running
-
-This extension is **required for iOS** to track push notification delivery in all app states.
-
----
-
-## Why is this needed?
-
-### The iOS Limitation
-
-On iOS, when your app is in background or killed state and receives a push notification with a visible alert, React Native's `setBackgroundMessageHandler` **is NOT called**. This is fundamental iOS behavior, not a bug.
-
-**What this means:**
-- ❌ No delivery tracking when app is killed
-- ❌ No custom notification display logic in background
-- ❌ No image processing without extension
-
-### The Solution: Notification Service Extension
-
-A Notification Service Extension is a separate iOS app extension that:
-- ✅ Runs in a **separate process** from your main app
-- ✅ Intercepts **all incoming notifications** before they're displayed
-- ✅ Has **30 seconds** to process the notification
-- ✅ Can send delivery ACKs, download images, and modify content
-
-**Industry standard:** Firebase, OneSignal, CleverTap, Airship all use this approach.
-
----
-
-## Installation
-
-### Step 1: Install Dependencies
-
-```bash
-npm install react-native-shared-group-preferences
-cd ios && pod install && cd ..
-```
-
-**Why needed:** Share credentials between app and extension.
-
----
-
-### Step 2: Configure in Xcode
-
-#### 2.1 Add Extension Target
-
-1. Open `ios/*.xcworkspace` in Xcode
-2. Go to **File → New → Target**
-3. Choose **"Notification Service Extension"**
-4. **Product Name:** `SwanNotificationServiceExtension`
-5. **Language:** Swift
-6. Click **Finish**
-7. When prompted "Activate scheme?", click **Cancel**
-
-#### 2.2 Configure App Groups
-
-**App Groups** allow the main app and extension to share credentials.
-
-##### Main App Target
-
-1. Select your **main app target** (e.g., `YourApp`)
-2. Go to **"Signing & Capabilities"** tab
-3. Click **"+ Capability"**
-4. Search for and add **"App Groups"**
-5. Click **"+"** under App Groups
-6. Enter: `group.swan.sdk.notifications`
-7. Click **OK**
-
-##### Extension Target
-
-1. Select **SwanNotificationServiceExtension** target
-2. Go to **"Signing & Capabilities"** tab
-3. Click **"+ Capability"**
-4. Search for and add **"App Groups"**
-5. Click **"+"** under App Groups
-6. Enter: `group.swan.sdk.notifications` (**MUST match main app!**)
-7. Click **OK**
-
-**⚠️ IMPORTANT:** Both targets must have the **exact same** App Group ID.
-
-#### 2.3 Verify Bundle Identifier
-
-1. Select **SwanNotificationServiceExtension** target
-2. Go to **"General"** tab
-3. Check **Bundle Identifier**: Should be `com.yourcompany.app.SwanNotificationServiceExtension`
-4. Make sure it's a **child** of your main app's bundle ID
-
----
-
-### Step 3: Run Setup Script
-
-Now that the extension target is created, run the setup script to copy the Swan implementation files. This will overwrite the default files created by Xcode.
-
-```bash
-node node_modules/swan-react-native-sdk/scripts/setup-ios-extension.js
-```
-
-**What it does:**
-- Copies extension files to `ios/SwanNotificationServiceExtension/`
-- Validates dependencies
-- Ensures the correct implementation is in place
-
----
-
-### Step 4: Testing
-
-### Build and Archive
-
-```bash
-# Clean build
-cd ios
-rm -rf build
-xcodebuild clean -workspace YourApp.xcworkspace -scheme YourApp
-
-# Build
-xcodebuild -workspace YourApp.xcworkspace -scheme YourApp -configuration Release
-
-# Archive (for TestFlight or Ad Hoc)
-xcodebuild -workspace YourApp.xcworkspace -scheme YourApp -configuration Release archive
-```
-
-### Test on Real Device
-
-**IMPORTANT:** Push notifications don't work on iOS Simulator!
-
-1. Archive your app (Product → Archive in Xcode)
-2. Export to device or upload to TestFlight
-3. Install on a real iOS device
-4. Send a test notification
-5. Check Xcode **Device Console** for logs
-
-### Expected Logs
-
-When extension receives a notification:
-
-```
-[SwanSDK Extension] Notification Service Extension triggered
-[SwanSDK Extension] Request identifier: 1234567890
-[SwanSDK Extension] UserInfo: {...}
-[SwanSDK Extension] Found messageId in gcm.message_id: 0:1234567890
-[SwanSDK Extension] Sending delivery ACK for messageId: 0:1234567890
-[SwanSDK Extension] Credentials loaded - appId: YOUR_APP_ID
-[SwanSDK Extension] ACK payload: {...}
-[SwanSDK Extension] ACK response status: 200
-[SwanSDK Extension] ✅ Delivery ACK sent successfully
-```
-
-If image is present:
-```
-[SwanSDK Extension] Downloading notification image: https://example.com/image.png
-[SwanSDK Extension] ✅ Image downloaded successfully
-```
-
-### View Logs on Real Device
-
-**Option 1: Xcode Device Console**
-1. Connect device via USB
-2. Xcode → Window → Devices and Simulators
-3. Select your device
-4. Click **"Open Console"**
-5. Filter by "SwanSDK Extension"
-
-**Option 2: Console.app (macOS)**
-1. Open Console app on Mac
-2. Select your connected device
-3. Search for "SwanSDK Extension"
-
----
-
-## Troubleshooting
-
-### Extension logs don't appear
-
-**Symptom:** No `[SwanSDK Extension]` logs when notification arrives
-
-**Possible causes:**
-
-1. **Missing mutable-content: 1**
-   - Check FCM payload includes `mutable-content: 1` in APNS
-   - Without it, iOS won't trigger the extension
-
-2. **App Groups not configured**
-   - Verify both targets have "App Groups" capability
-   - Verify App Group ID is `group.swan.sdk.notifications` in BOTH targets
-   - IDs must match exactly (no typos!)
-
-3. **Extension not included in build**
-   - In Xcode, go to Product → Scheme → Edit Scheme
-   - Check that SwanNotificationServiceExtension is included
-
-4. **Testing on simulator**
-   - Push notifications don't work on iOS Simulator
-   - Test on a real device
-
-### Extension runs but no ACK sent
-
-**Symptom:** See extension logs but backend doesn't receive ACK
-
-**Possible causes:**
-
-1. **Credentials not saved to App Group**
-   - Ensure SDK is initialized: `SwanSDK.init({ appId: '...' })`
-   - Credentials are saved automatically on init
-   - Check logs for: `[SharedCredentials] ✅ Credentials saved to iOS App Group`
-
-2. **App Group ID mismatch**
-   - Extension uses `group.swan.sdk.notifications` by default
-   - If you changed it, update `NotificationService.swift` line 143
-
-3. **Network issue**
-   - Extension has only 30 seconds to complete
-   - Check device has internet connection
-
-### Images not appearing
-
-**Symptom:** Notification arrives but image doesn't display
-
-**Possible causes:**
-
-1. **Image URL invalid**
-   - Check image URL is accessible (try in browser)
-   - Must be HTTPS (HTTP won't work)
-
-2. **Image format unsupported**
-   - Supported: JPEG, PNG, GIF
-   - Max size: 10MB (iOS limit)
-
-3. **mutable-content missing**
-   - Extension won't run without `mutable-content: 1`
-
-### Build errors
-
-**Error:** `No such module 'UserNotifications'`
-- Solution: Make sure deployment target is iOS 10.0+
-
-**Error:** `Use of undeclared type 'UNNotificationServiceExtension'`
-- Solution: Verify extension target is set to iOS 10.0+ deployment target
-
-**Error:** `Could not find or use auto-linked library 'swiftFoundation'`
-- Solution: Add `use_frameworks!` to Podfile
-
-**Error:** `CocoaPods Error: Unable to find compatibility version string for object version '70'`
-- Solution: In Xcode, select your Project (blue icon) → Build Settings (or Info) → Project Format. Change it to **Xcode 16.0-compatible** or later.
-
----
-
-## Customization
-
-### Custom App Group ID
-
-If you want to use a different App Group ID:
-
-1. **In Xcode:** Update App Groups in both targets to use your custom ID (e.g., `group.com.yourcompany.app`)
-
-2. **In SDK:** Configure before calling `SwanSDK.init()`:
-
-```typescript
-import { SharedCredentialsManager } from 'swan-react-native-sdk';
-
-// Set custom App Group ID BEFORE SDK init
-SharedCredentialsManager.setAppGroupId('group.com.yourcompany.app');
-
-// Then initialize SDK
-await SwanSDK.init({ appId: 'YOUR_APP_ID' });
-```
-
-3. **In Extension:** Update `NotificationService.swift`:
-
-```swift
-let appGroupId = "group.com.yourcompany.app"
-```
-
-
-
-## FAQs
-
-### Q: Do I need to modify the extension code?
-
-**A:** No. The extension works out of the box. Only modify if you need custom App Group ID.
-
-### Q: Will this increase my app size?
-
-**A:** Minimally. The extension adds ~50KB to your IPA.
-
-### Q: Does this affect app performance?
-
-**A:** No. The extension runs in a separate process and only when notifications arrive.
-
-### Q: Can I test without archiving?
-
-**A:** Yes, but you must run on a real device. Push doesn't work on simulator.
-
-### Q: What if I already have a Notification Service Extension?
-
-**A:** You'll need to merge Swan's code into your existing extension. The key parts are:
-1. Reading credentials from App Group
-2. Sending delivery ACK
-3. Downloading images
-
-### Q: Do I need this for Android?
-
-**A:** No. Android data-only push notifications work without an extension. This is iOS-only.
-
----
-
-## Support
-
-If you encounter issues:
-
-1. Check logs in Xcode Device Console
-2. Verify all steps in this guide
-3. Test with the provided FCM payload example
-4. Check that App Group IDs match in both targets
-
-For detailed debugging, enable verbose logging:
-- Main app: `SwanSDK.setLoggingEnabled(true)`
-- Extension: Logs are always enabled, check Device Console
-
----
-
-## Summary
-
-✅ **Install:** `npm install react-native-shared-group-preferences`
-✅ **Xcode:** Add extension target + configure App Groups
-✅ **Run:** `node node_modules/swan-react-native-sdk/scripts/setup-ios-extension.js`
-✅ **Test:** Archive and test on real device
-
-That's it! Your iOS notifications now have reliable delivery tracking and rich media support. 🎉