feat(example): rebuild app with sectioned UI, JS-first init, API coverage

Replace the legacy button-wall demo with an interactive, sectioned example
that covers the full Klaviyo SDK public API surface and initializes the SDK
from JavaScript instead of native code.

- App.tsx: SectionList layout with Profile / Events / Forms / Geofencing /
  Push / Deep Links sections
- Profile section: External ID / Email / Phone inputs with individual set
  buttons, plus a collapsible "Additional Attributes" accordion for
  first/last name, title, organization and a "Location" accordion for
  city/country/zip/lat/long, aggregate Set Profile button, Reset Profile
- Events: test event + Viewed Product, both with value + uniqueId + custom
  properties
- Push: Firebase-backed permission request, Set Push Token, Set Badge Count
  (iOS-only, with number input)
- Forms: explicit Register / Unregister
- Geofencing: explicit Register / Unregister, Get Current Geofences modal
- Deep link handling via Klaviyo.handleUniversalTrackingLink in a Linking
  useEffect with a proper cleanup
- Env loading migrated to react-native-dotenv (.env + .env.example) with a
  typed @env declaration — no more try/require gymnastics
- index.js registers a Firebase background message handler before
  AppRegistry as required by @react-native-firebase/messaging
- Bumps @react-native-firebase/app and /messaging to ^24.0.0 for RN 0.81
  bridgeless compatibility; adds react-native-dotenv dev dep
- Drops legacy AppViewInterface, KlaviyoReactWrapper, RandomGenerators

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>

Author: evan-masseau

.gitignore

@@ -29,7 +29,7 @@ DerivedData
 *.xcuserstate
 project.xcworkspace
 .xcode.env.local
-GoogleService-info.plist
+GoogleService-Info.plist
 
 # Android/IJ
 #
@@ -80,5 +80,8 @@ android/keystores/debug.keystore
 # generated by bob
 lib/
 
+# Local environment config (API keys, etc.)
+example/.env
+
 # Local AI settings files
 .claude

example/.env.example

@@ -0,0 +1 @@
+KLAVIYO_API_KEY=YOUR_KLAVIYO_PUBLIC_API_KEY

example/babel.config.js

@@ -7,6 +7,19 @@ const root = path.resolve(__dirname, '..');
 module.exports = getConfig(
   {
     presets: ['module:@react-native/babel-preset'],
+    plugins: [
+      // allowUndefined: true so cold clones (no .env) build and show the friendly
+      // warning UI rather than failing at Metro transform time. The runtime check
+      // in App.tsx handles the missing-key case gracefully.
+      [
+        'module:react-native-dotenv',
+        {
+          moduleName: '@env',
+          path: '.env',
+          allowUndefined: true,
+        },
+      ],
+    ],
   },
   { root, pkg }
 );

example/index.js

@@ -2,4 +2,19 @@ import { AppRegistry } from 'react-native';
 import App from './src/App';
 import { name as appName } from './app.json';
 
+// Register a background message handler BEFORE the app mounts.
+// `@react-native-firebase/messaging` requires this — without it, native-side
+// events fire with no JS listener attached and RN throws
+// "RCTEventEmitter.receiveEvent ... module has not been registered as callable".
+// The handler is a no-op here; a real app would forward the payload to
+// Klaviyo.handleBackgroundMessage or similar.
+try {
+  // Guard the require so the app still runs when Firebase isn't linked.
+
+  const messaging = require('@react-native-firebase/messaging').default;
+  messaging().setBackgroundMessageHandler(async () => {});
+} catch {
+  // Firebase not available — no-op.
+}
+
 AppRegistry.registerComponent(appName, () => App);

example/package.json

@@ -11,6 +11,8 @@
     "build:ios": "react-native build-ios --scheme KlaviyoReactNativeSdkExample --mode Debug --extra-params \"-sdk iphonesimulator CC=clang CPLUSPLUS=clang++ LD=clang LDPLUSPLUS=clang++ GCC_OPTIMIZATION_LEVEL=0 GCC_PRECOMPILE_PREFIX_HEADER=YES ASSETCATALOG_COMPILER_OPTIMIZATION=time DEBUG_INFORMATION_FORMAT=dwarf COMPILER_INDEX_STORE_ENABLE=NO\""
   },
   "dependencies": {
+    "@react-native-firebase/app": "^24.0.0",
+    "@react-native-firebase/messaging": "^24.0.0",
     "@react-native/new-app-screen": "0.81.5",
     "react": "19.1.0",
     "react-native": "0.81.5",
@@ -27,7 +29,8 @@
     "@react-native/babel-preset": "0.81.5",
     "@react-native/metro-config": "0.81.5",
     "@react-native/typescript-config": "0.81.5",
-    "react-native-builder-bob": "^0.36.0"
+    "react-native-builder-bob": "^0.36.0",
+    "react-native-dotenv": "^3.4.11"
   },
   "engines": {
     "node": ">=20"