react-native-insider 8.0.1 → 8.0.2

package/.orbit-output/config/architecture/CODE-CATALOG.md

@@ -0,0 +1,172 @@
+# CODE-CATALOG.md
+
+> Generated by Orbit Init | 2026-04-16 | react-native-insider v8.0.0
+
+## Overview
+
+React Native bridge SDK wrapping native Insider iOS/Android SDKs. Single npm package with JS facade, TypeScript declarations, and native bridge modules. Now includes the **App Cards** module (Promise + callback hybrid API) and **identifier-scoped Message Center**.
+
+---
+
+## Entry Points
+
+| File | Type | Description |
+|------|------|-------------|
+| `index.js` | Main entry | `RNInsider` static class — primary SDK facade. Re-exports `InsiderAppCardsError`, `InsiderAppCardsErrorCode` |
+| `index.d.ts` | Type declarations | TypeScript module declaration for `react-native-insider` |
+
+---
+
+## JS Source Modules (`src/`)
+
+### Classes
+
+| Class | File | Pattern | Description |
+|-------|------|---------|-------------|
+| `RNInsider` | `index.js` | Static facade | All-static class wrapping NativeModules.RNInsider. Entry point for SDK initialization, events, products, pages, recommendations, content optimizer, push, geofence, GDPR, message center, app cards |
+| `RNInsiderUser` | `src/InsiderUser.js` | Builder (fluent) | User profile management. Singleton instance returned by `getCurrentUser()`. Setters for demographics, marketing optins, custom attributes, login/logout, `logoutResettingInsiderID` |
+| `RNInsiderProduct` | `src/InsiderProduct.js` | Builder (fluent) | Product model with `requiredFields`, `optionalFields`, `customParameters`. Constructed via `createNewProduct()`, enriched via chainable setters |
+| `RNInsiderEvent` | `src/InsiderEvent.js` | Builder (fluent) | Event builder. Created via `tagEvent(name)`, parameters added via typed setters, dispatched via `.build()` |
+| `RNInsiderIdentifier` | `src/InsiderIdentifier.js` | Builder (fluent) | Identity builder for login. Accumulates email, phone, userID, custom identifiers into an object |
+| `RNInsiderAppCards` | `src/InsiderAppCards.js` | Frozen singleton object | App cards module exposing `getCampaigns/markAsRead/markAsUnread/delete/view/click/clickButton`. Each method supports both Promise and completion-callback modes via `Util.resolveWithCallback` |
+| `InsiderAppCard` | `src/InsiderAppCard.js` | Domain model | Rich app card with private fields (#) — id, type, isRead, images, content, buttons, action. Provides instance methods `markAsRead/markAsUnread/delete/view/click` |
+| `InsiderAppCardButton` | `src/InsiderAppCard.js` | Domain model | Button on an app card. Holds id, appCardId, text, action, raw data. `click()` delegates to `InsiderAppCards.clickButton(this)` |
+| `InsiderAppCardContent` | `src/InsiderAppCard.js` | Domain model | Title + description value object |
+| `InsiderAppCardImage` | `src/InsiderAppCard.js` | Domain model | Image URL value object |
+| `InsiderAppCardAction` | `src/InsiderAppCard.js` | Polymorphic base | `fromData()` factory dispatches on `data.type` (`deep_link`, `feedback`, `open_settings`) |
+| `InsiderAppCardDeeplinkAction` | `src/InsiderAppCard.js` | Domain model | Deep link action — `url`, `deeplinkType`, `json`, `keysAndValues` |
+| `InsiderAppCardFeedbackAction` | `src/InsiderAppCard.js` | Domain model | Feedback action marker |
+| `InsiderAppCardOpenSettingsAction` | `src/InsiderAppCard.js` | Domain model | Open-settings action marker |
+| `InsiderAppCardsCampaignResponse` | `src/InsiderAppCard.js` | Domain model | Wraps `items` from native into `appCards: InsiderAppCard[]` |
+| `InsiderAppCardsError` | `src/InsiderAppCardsError.js` | Typed Error subclass | Extends `Error` with structured `code`. Static `from(error)` parses native bridge errors `{code, message}` or strings |
+
+### Enums / Constants
+
+| Module | File | Values |
+|--------|------|--------|
+| `InsiderGender` | `src/InsiderGender.js` | `Male=0, Female=1, Other=2` |
+| `InsiderCallbackType` | `src/InsiderCallbackType.js` | `NOTIFICATION_OPEN=0, INAPP_BUTTON_CLICK=1, TEMP_STORE_PURCHASE=2, TEMP_STORE_ADDED_TO_CART=3, TEMP_STORE_CUSTOM_ACTION=4, INAPP_SEEN=5, SESSION_STARTED=6` |
+| `ContentOptimizerDataType` | `src/ContentOptimizerDataType.js` | `Content=0, Element=1` |
+| `CloseButtonPosition` | `src/CloseButtonPosition.js` | `LEFT, RIGHT, NONE` |
+| `InsiderAppCardsErrorCode` | `src/InsiderAppCardsError.js` | `UNKNOWN, SDK_NOT_INITIALIZED, INVALID_PARAMETER, NETWORK_ERROR, SERVER_ERROR, PARSE_ERROR` (string values) |
+
+### Utilities (`src/Util.js`)
+
+| Function | Description |
+|----------|-------------|
+| `shouldNotProceed()` | Returns true if NativeModules.RNInsider is null/undefined |
+| `generateJSONErrorString(error)` | Formats error as `[JavaScript Error] {error}` |
+| `checkParameters(params)` | Validates array of `{type, value}` descriptors against typeof |
+| `showParameterWarningLog(fnName, params)` | Emits `console.warn` with function name and invalid parameter details |
+| `resolveWithCallback(promise, completion)` | **NEW.** Bridges Promise and callback APIs. If `completion` is a function, invokes `completion(err, value)`; otherwise returns the Promise |
+| `isPlainObject(value)` | Checks if value is a plain JS object (not null, array, Date, etc.) |
+| `detectType(value)` | Returns type string: boolean, date, numeric_array, string_array, integer, double, string, unknown |
+| `parseObjectWithTypes(parameters)` | Converts plain object to typed array `[{key, type, value}]` for native bridge. Filters unknown types. Converts Dates to epoch millis |
+
+---
+
+## Native iOS (`ios/RNInsider/`)
+
+| File | Class | Role |
+|------|-------|------|
+| `RNInsider.h/.m` | `RNInsider : NSObject <RCTBridgeModule>` | Main bridge module. Exports all RCT_EXPORT_METHOD bridge methods (init, user, product, event, content optimizer, push, recommendations, message center, app cards). Delegates events to RNNotificationHandler singleton. Runs on main queue |
+| `RNNotificationHandler.h/.m` | `RNNotificationHandler : RCTEventEmitter <RCTBridgeModule>` | Singleton event emitter. Declares supportedEvents, sends native events to JS via `sendEventWithName:body:` |
+| `RNUtils.h/.m` | `RNUtils` | Static utility methods: `parseProductFromRequiredFields:`, `parseEventFromEventName:`, `parseCustomParameters:`. Converts bridge data to native Insider SDK objects |
+
+### iOS Dependencies (RNInsider.podspec)
+
+| Pod | Version | Purpose |
+|-----|---------|---------|
+| InsiderMobile | 15.0.0 | Core Insider iOS SDK |
+| InsiderGeofence | 1.2.4 | Geofencing support |
+| InsiderHybrid | 1.7.6 | Hybrid app bridge utilities |
+
+---
+
+## Native Android (`android/src/main/java/com/useinsider/react/`)
+
+| File | Class | Role |
+|------|-------|------|
+| `RNInsiderModule.java` | `RNInsiderModule extends ReactContextBaseJavaModule` | Main bridge module. All `@ReactMethod` annotated methods (~80 total). Emits events via `RCTDeviceEventEmitter`. Handles init on main looper. Now includes app card bridges and `getMessageCenterDataWithIdentifiers`, `logoutResettingInsiderID` |
+| `RNInsiderPackage.java` | `RNInsiderPackage implements ReactPackage` | Package registration for React Native module system |
+| `RNUtils.java` | `RNUtils` | Static utilities: `parseProduct()`, `parseEvent()`, `parseCustomParameters()`, JSON↔ReadableMap converters. Converts ReadableMap/ReadableArray to native Insider SDK objects |
+
+### Android Dependencies (build.gradle)
+
+| Dependency | Version | Purpose |
+|------------|---------|---------|
+| com.useinsider:insider | 16.0.1 | Core Insider Android SDK |
+| com.useinsider:insiderhybrid | 1.3.4 | Hybrid app bridge |
+| firebase-messaging | 24.0.0 | FCM push notifications |
+| play-services-location | 21.3.0 | Geofencing |
+| play-review | 2.0.1 | Native app review dialog |
+| security-crypto | 1.1.0-alpha06 | Encrypted storage |
+| androidx.lifecycle:lifecycle-process | 2.8.3 | App lifecycle |
+| androidx.work:work-runtime | 2.9.1 | Background work |
+| androidx.legacy:legacy-support-v4 | 1.0.0 | Legacy support |
+| huawei hms:push | 6.13.0.300 | Huawei push notifications |
+| huawei hms:location | 6.16.0.302 | Huawei geofencing |
+| huawei hms:ads-identifier | 3.4.62.300 | Huawei ad identifier |
+
+Build: Android Gradle Plugin 8.4.2, compileSdk 36, minSdk 24, namespace `com.useinsider.react`
+
+---
+
+## Tests (`__tests__/` and `src/__tests__/`)
+
+| File | Scope | Key Coverage |
+|------|-------|--------------|
+| `__tests__/Insider.test.js` | Custom parameters flow | itemPurchased, itemAddedToCart, cartCleared, visitHomePage, visitListingPage, visitProductDetailPage, visitCartPage, itemAddedToWishlist, etc. Tests all 7 types + unknown filtering |
+| `__tests__/Util.test.js` | Top-level Util usage | parseObjectWithTypes, detectType, isPlainObject — edge cases, type detection, null handling |
+| `__tests__/getMessageCenterData.test.js` | Message center | UTC timezone validation, platform response handling (iOS unwrap vs Android direct), date validation, epoch string format |
+| `__tests__/getMessageCenterDataWithIdentifiers.test.js` | Message center w/ identifiers | NEW. Validates identifier-scoped variant of message center fetch |
+| `__tests__/setInternalBrowserCloseButtonPosition.test.js` | Browser close button | CloseButtonPosition enum values, parameter validation, platform-specific behavior |
+| `src/__tests__/Util.test.js` | Util module | NEW. Direct Util coverage (resolveWithCallback, type detection) |
+| `src/__tests__/InsiderAppCard.test.js` | Domain model | NEW. App card construction, action factory dispatch (deep_link/feedback/open_settings), private field access |
+| `src/__tests__/InsiderAppCards.test.js` | App cards API | NEW. getCampaigns/markAsRead/markAsUnread/delete/view/click/clickButton — Promise + callback duality, error wrapping, parameter validation |
+| `src/__tests__/InsiderAppCardsError.test.js` | Typed error | NEW. Error code mapping, `from()` factory parsing structured/string errors |
+
+### Test Mock (`__mocks__/react-native.js`)
+
+Global mock providing: `NativeModules.RNInsider` (all methods as jest.fn() including app card bridges), `NativeEventEmitter` (listener management), `Platform` (default iOS).
+
+---
+
+## Example App (`example/`)
+
+| File | Description |
+|------|-------------|
+| `App.tsx` | Demo app with screens: InitScreen (SDK init), UserScreen, ProductScreen, EventScreen |
+| `example/android/` | Android project with google-services.json, Kotlin MainActivity/MainApplication |
+| `example/ios/` | iOS project with Swift AppDelegate, Notification Service/Content extensions |
+
+---
+
+## CI/CD (`.github/workflows/`)
+
+| Workflow | Trigger | Purpose |
+|----------|---------|---------|
+| `check-pull-request.yml` | PR events | Title format validation (MOB-xxxxx), auto-labeling, assignee |
+| `create-release.yml` | Manual dispatch | Creates release branch, JIRA integration, GPG-signed commits |
+| `publish-release.yml` | PR merged to master | npm publish, GPG-signed tags, dual-track (main + -nh variant), GitHub Deployments |
+
+---
+
+## Internal Specs (`docs/`)
+
+| Path | Purpose |
+|------|---------|
+| `docs/app-cards/` | Internal feature specs for App Cards |
+| `docs/message-center/` | Internal feature specs for Message Center |
+
+---
+
+## Configuration
+
+| File | Purpose |
+|------|---------|
+| `package.json` | npm package definition (v8.0.0), Jest config, version source of truth |
+| `RNInsider.podspec` | CocoaPods spec (reads version from package.json) |
+| `android/build.gradle` | Android library build config, native SDK dependencies |
+| `babel.config.js` | Babel with @react-native/babel-preset |
+| `.npmignore` | Excludes example/, __tests__, .github, .claude, coverage from npm package |

package/.orbit-output/config/architecture/project.yaml

@@ -0,0 +1,138 @@
+# Orbit Project Configuration
+# Generated: 2026-04-16
+# Workflow version: 3.11
+
+project:
+  name: react-native-insider
+  version: "8.0.0"
+  type: library
+  architecture: single-service
+  description: "React Native bridge SDK for Insider marketing platform — wraps native iOS/Android Insider SDKs and adds the App Cards module"
+
+languages:
+  main:
+    - name: JavaScript
+      version: ES6+ (with private fields)
+      locations: ["./", "src/", "__tests__/", "__mocks__/"]
+      file_count: 30
+    - name: TypeScript
+      version: declarations
+      locations: ["./", "src/", "example/"]
+      file_count: 11
+    - name: "Objective-C"
+      locations: ["ios/RNInsider/", "example/ios/"]
+      file_count: 10
+    - name: Java
+      locations: ["android/src/main/java/com/useinsider/react/"]
+      file_count: 3
+    - name: Kotlin
+      locations: ["example/android/"]
+      file_count: 2
+    - name: Swift
+      locations: ["example/ios/InsiderExample/"]
+      file_count: 1
+  other:
+    - name: YAML
+      purpose: configuration
+    - name: JSON
+      purpose: configuration
+    - name: Gradle
+      purpose: build
+    - name: Ruby
+      purpose: podspec
+
+frameworks:
+  main:
+    - name: React Native
+      version: "0.83.0"
+      category: cross-platform-bridge
+    - name: React
+      version: "19.2.0"
+      category: react
+    - name: InsiderMobile
+      version: "15.0.0"
+      category: ios-native-sdk
+    - name: InsiderGeofence
+      version: "1.2.4"
+      category: ios-geofence
+    - name: InsiderHybrid
+      version: "1.7.6"
+      category: ios-hybrid
+    - name: Insider Android SDK
+      version: "16.0.1"
+      category: android-native-sdk
+    - name: insiderhybrid (Android)
+      version: "1.3.4"
+      category: android-hybrid
+  support:
+    - name: Firebase Messaging
+      version: "24.0.0"
+      category: push-notifications
+    - name: "Huawei HMS Push"
+      version: "6.13.0.300"
+      category: push-notifications
+    - name: "Huawei HMS Location"
+      version: "6.16.0.302"
+      category: location
+    - name: play-services-location
+      version: "21.3.0"
+      category: location
+    - name: play-review
+      version: "2.0.1"
+      category: review
+    - name: androidx.security:security-crypto
+      version: "1.1.0-alpha06"
+      category: security
+    - name: Jest
+      version: "29.7.0"
+      category: testing
+    - name: babel-jest
+      version: "30.2.0"
+      category: testing
+    - name: Android Gradle Plugin
+      version: "8.4.2"
+      category: build
+
+services:
+  - name: react-native-insider
+    path: "."
+    type: library
+    primary_language: JavaScript
+    frameworks:
+      - React Native
+      - InsiderMobile (iOS)
+      - Insider (Android)
+    modules:
+      - InsiderUser (fluent builder)
+      - InsiderProduct (fluent builder)
+      - InsiderEvent (fluent builder)
+      - InsiderIdentifier (fluent builder)
+      - InsiderAppCards (frozen singleton; Promise + callback)
+      - InsiderAppCard (domain model with private fields)
+      - InsiderAppCardsError (typed Error subclass)
+      - Util (validation, type detection, resolveWithCallback)
+    description: "React Native bridge SDK wrapping native Insider iOS/Android SDKs. v8.0.0 adds the App Cards module and identifier-scoped Message Center."
+    description_source: code-analysis
+    verified: true
+
+output:
+  architecture_file: ".orbit-output/config/architecture/ARCHITECTURE.md"
+  code_catalog: ".orbit-output/config/architecture/CODE-CATALOG.md"
+  api_docs: ".orbit-output/config/architecture/API_DOCS.md"
+  config_file: ".orbit-output/config/architecture/project.yaml"
+
+analysis:
+  mode: FULL_ANALYSIS
+  date: "2026-04-16"
+  workflow_version: "3.11"
+  zoe_configured: false
+  notable_changes_since_last:
+    - "Bumped package version 7.1.0 → 8.0.0"
+    - "Bumped iOS InsiderMobile 14.3.1 → 15.0.0"
+    - "Bumped Android Insider SDK 15.3.0 → 16.0.1"
+    - "Added App Cards module (InsiderAppCards, InsiderAppCard, InsiderAppCardsError)"
+    - "Added getMessageCenterDataWithIdentifiers method"
+    - "Added RNInsiderUser.logoutResettingInsiderID method"
+    - "Added Util.resolveWithCallback helper for Promise/callback bridging"
+    - "Added per-module test suite under src/__tests__/"
+    - "Added docs/app-cards/ and docs/message-center/ internal specs"

package/.orbit-output/config/automation/AUTOMATION-SETUP.md

@@ -0,0 +1,50 @@
+# Automation Setup for react-native-insider
+
+> Generated: 2026-04-16 | Orbit Init v3.11
+
+## Active Tool
+
+**Claude Code** (detected from CLAUDE.md + .claude/ directory)
+
+## Automation Status
+
+| Feature | Status |
+|---------|--------|
+| .orbit-output/ context | Configured via CLAUDE.md references |
+| Architecture docs | Updated for v8.0.0 (ARCHITECTURE.md, CODE-CATALOG.md, API_DOCS.md) |
+| MASTER.md | Updated as single source of truth |
+| project.yaml | Updated with new module list and SDK versions |
+| Settings | .claude/settings.json + settings.local.json (preserved) |
+| Skills | .claude/skills/ (academy-doc-generator preserved) |
+| Rules | .claude/rules/ (00-ENFORCE-FIRST, code-style, orbit-enforcement preserved) |
+
+## Context Files
+
+Claude Code loads these for project awareness:
+- `.orbit-output/config/MASTER.md` — Quick reference
+- `.orbit-output/config/architecture/ARCHITECTURE.md` — Architecture overview
+- `.orbit-output/config/architecture/CODE-CATALOG.md` — Code catalog
+- `.orbit-output/config/architecture/API_DOCS.md` — API reference
+
+## Notable v8.0.0 Updates Captured
+
+- App Cards module (InsiderAppCards, InsiderAppCard, InsiderAppCardsError) cataloged
+- `getMessageCenterDataWithIdentifiers` documented
+- `RNInsiderUser.logoutResettingInsiderID` documented
+- `Util.resolveWithCallback` Promise/callback bridge helper documented
+- iOS InsiderMobile bumped 14.3.1 → 15.0.0
+- Android Insider SDK bumped 15.3.0 → 16.0.1
+
+## Keeping Docs Updated
+
+Run `/orbit:sync` after significant codebase changes to regenerate architecture docs.
+
+Run `/orbit:init` for a full re-analysis when:
+- Major refactoring occurs
+- New native modules are added
+- Native SDK versions are bumped
+- New platform-specific features are added
+
+---
+
+*Auto-generated by Orbit Init v3.11 | 2026-04-16*

package/.orbit-output/config/enforcement/ENFORCEMENT-RULES.md

@@ -0,0 +1,41 @@
+# ORBIT ENFORCEMENT RULES
+
+> Generated: 2026-04-06 | Orbit Init v3.11
+
+## Overview
+
+This enforcement system ensures AI tools maintain consistency between code and architecture documentation.
+
+## Enforcement Layers
+
+### Layer 0: Session Start
+- `.claude/rules/00-ENFORCE-FIRST.md` — Loads architecture on every Claude Code session
+- Forces reading MASTER.md before first code change
+
+### Layer 1: AI Tool Rules
+- `.claude/rules/orbit-enforcement.md` — Enforces pattern following and doc updates
+- Before changes: read relevant docs
+- After changes: update affected docs
+
+### Layer 2: Pattern Enforcement
+- All code must follow patterns documented in MASTER.md
+- Parameter validation, fluent builders, product serialization patterns
+
+## Required Updates by Change Type
+
+| Change Type | Files to Update |
+|-------------|----------------|
+| New public method on RNInsider | API_DOCS.md, CODE-CATALOG.md, index.d.ts |
+| New class/module | CODE-CATALOG.md, ARCHITECTURE.md |
+| New native bridge method | API_DOCS.md, corresponding .m/.java file |
+| New enum/constant | CODE-CATALOG.md |
+| Architecture change | ARCHITECTURE.md, MASTER.md |
+| Dependency version bump | CODE-CATALOG.md, MASTER.md |
+
+## Keeping Docs Current
+
+Run `/orbit:sync` after significant changes to regenerate docs automatically.
+
+---
+
+*Auto-generated by Orbit Init v3.11 | 2026-04-06*

package/.orbit-output/config/enforcement/validate.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+# Orbit Enforcement Validation Script
+# Checks that all required orbit files exist
+
+ERRORS=0
+
+check_file() {
+  if [ -f "$1" ]; then
+    echo "  ✓ $1"
+  else
+    echo "  ✗ $1 (MISSING)"
+    ERRORS=$((ERRORS + 1))
+  fi
+}
+
+echo "═══════════════════════════════════════════════"
+echo "  ORBIT ENFORCEMENT VALIDATION"
+echo "═══════════════════════════════════════════════"
+echo ""
+
+echo "Architecture Documentation:"
+check_file ".orbit-output/config/MASTER.md"
+check_file ".orbit-output/config/architecture/ARCHITECTURE.md"
+check_file ".orbit-output/config/architecture/CODE-CATALOG.md"
+check_file ".orbit-output/config/architecture/API_DOCS.md"
+check_file ".orbit-output/config/architecture/project.yaml"
+echo ""
+
+echo "Root Config:"
+check_file "CLAUDE.md"
+echo ""
+
+echo "Enforcement Rules:"
+check_file ".claude/rules/00-ENFORCE-FIRST.md"
+check_file ".claude/rules/orbit-enforcement.md"
+check_file ".orbit-output/config/enforcement/ENFORCEMENT-RULES.md"
+echo ""
+
+echo "═══════════════════════════════════════════════"
+if [ $ERRORS -eq 0 ]; then
+  echo "  VALIDATION PASSED: All files intact"
+  echo "═══════════════════════════════════════════════"
+  exit 0
+else
+  echo "  VALIDATION FAILED: $ERRORS issue(s) found"
+  echo "  Run /orbit:init to repair"
+  echo "═══════════════════════════════════════════════"
+  exit 1
+fi