@billdog.io/react-native 1.0.0-beta.2

package/BillDogReactNative.podspec

@@ -0,0 +1,30 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  # Bundles ALL RN iOS bridge modules (paywall, analytics, survey, A/B, live
+  # activities, virtual currency) via the source_files glob below — the pod is
+  # NOT virtual-currency-specific, so it carries the package name.
+  s.name         = "BillDogReactNative"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = "https://billdog.app"
+  s.license      = package["license"]
+  s.authors      = package["author"]
+  # iOS 15 to match the native BillDog pod's deployment target (was 13.0).
+  s.platforms    = { :ios => "15.0" }
+  # Informational only — React Native autolinking installs this pod via :path
+  # into the consumer's node_modules; :source is used only for standalone
+  # `pod install` from git.
+  s.source       = { :git => "https://github.com/billdogai/billdog.git", :tag => "react-native-#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+
+  s.dependency "React-Core"
+  # Native BillDog iOS SDK (Full subspec). Thin-bridge architecture: every RN native
+  # module delegates to `BillDog.shared` instead of reimplementing logic. Phase 0.
+  s.dependency "BillDog"
+
+  s.swift_version = "5.0"
+end

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 BillDog
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,330 @@
+# @billdog.io/react-native
+
+React Native library for rendering BillDog paywalls with native components.
+
+## What's New in 1.4 — Purchase Parity APIs
+
+The RN bridge now exposes the full purchase parity surface (PurchaseParams,
+PurchaseController, CustomProduct, attribution setters, setProxyURL, eligibility,
+canMakePayments, presentCodeRedemptionSheet, storefront observer):
+
+```typescript
+import { BillDog, PurchaseParams } from '@billdog.io/react-native';
+
+const result = await BillDog.purchase(
+  PurchaseParams.builder('pro_yearly')
+    .promoOfferId('intro_2024')
+    .appAccountToken(uuid)
+    .isPersonalizedOffer(true)
+    .build()
+);
+// result.kind: 'purchased' | 'cancelled' | 'pending' | 'failed' | 'restored'
+
+await BillDog.setAdjustID(adid);
+await BillDog.setAppsflyerID(appsflyerId);
+await BillDog.setProxyURL('https://billdog-edge.example.com');
+```
+
+Full guides: [Custom Purchases](https://billdog.io/docs/custom-purchases) ·
+[Attribution](https://billdog.io/docs/attribution) ·
+[Self-Hosted Proxy](https://billdog.io/docs/self-hosted-proxy)
+
+
+## Features
+
+✨ **AI-Generated Paywalls** - Create paywalls using AI prompts or templates  
+⚡ **Smart Caching** - Instant display with <100ms load time (Phase 3)  
+🎨 **Cross-Platform** - Works on iOS and Android  
+📊 **Real-time Analytics** - Track conversions and revenue  
+🔌 **Offline Support** - Cached paywalls work without network  
+🎯 **A/B Testing** - Run experiments without app updates  
+📱 **Dynamic Updates** - Update paywalls remotely
+
+## Advanced Caching System
+
+BillDog SDK includes a production-grade caching system that dramatically improves performance:
+
+⚡ **60% Storage Reduction** - GZIP compression automatically reduces cache size  
+🚀 **Sub-50ms Load Times** - Multi-level caching (memory + AsyncStorage)  
+🧠 **Intelligent Prefetching** - Learns user patterns and preloads paywalls  
+📊 **Real-time Analytics** - Monitor cache performance and hit rates  
+🔄 **Background Updates** - Silent version checking keeps content fresh  
+📴 **Offline Support** - Cached paywalls work without network
+
+### Quick Start with Caching
+
+```typescript
+import { PaywallView } from '@billdog.io/react-native';
+
+function MyPaywall() {
+  return (
+    <PaywallView
+      paywallIdentifier="premium_offer"
+      apiKey="your_api_key"
+      projectUrl="https://yourproject.supabase.co"
+      cacheConfig={{
+        enabled: true,                    // Enable caching (default: true)
+        compressionEnabled: true,         // Enable GZIP (default: true)
+        memoryCacheEnabled: true,         // Memory cache (default: true)
+        maxAge: 24 * 60 * 60 * 1000,     // 24 hours (default: 7 days)
+        prefetchEnabled: true,            // Smart prefetching (default: false)
+      }}
+      onButtonPress={(id, action) => handlePurchase(id, action)}
+    />
+  );
+}
+```
+
+### Cache Analytics
+
+```typescript
+import { AdvancedPaywallCache } from '@billdog.io/react-native';
+
+const cache = new AdvancedPaywallCache({
+  enabled: true,
+  compressionEnabled: true,
+});
+
+// Get real-time analytics
+const analytics = await cache.getAnalytics();
+console.log(`Hit Rate: ${(analytics.hitRate * 100).toFixed(1)}%`);
+console.log(`Avg Load Time: ${analytics.avgLoadTime.toFixed(0)}ms`);
+console.log(`Storage Saved: ${(analytics.compressionRatio * 100).toFixed(0)}%`);
+```
+
+📖 **Full Caching Guide**: See [CACHING_GUIDE.md](../CACHING_GUIDE.md) for advanced configuration, platform comparison, and best practices.
+
+## Installation
+
+```bash
+npm install @billdog.io/react-native
+# or
+yarn add @billdog.io/react-native
+```
+
+## Usage
+
+### Basic Usage
+
+```tsx
+import { PaywallView } from '@billdog.io/react-native';
+
+function App() {
+  return (
+    <PaywallView
+      paywallIdentifier="premium_offer"
+      apiKey="your_api_key"
+      projectUrl="https://yourproject.supabase.co"
+      onButtonPress={(componentId, action) => {
+        console.log('Button pressed:', componentId, action);
+        // Handle purchase flow
+      }}
+      onDismiss={() => {
+        console.log('Paywall dismissed');
+      }}
+    />
+  );
+}
+```
+
+### With Direct Configuration
+
+```tsx
+import { PaywallView, PaywallConfiguration } from '@billdog.io/react-native';
+
+const config: PaywallConfiguration = {
+  components: [
+    {
+      id: 'title',
+      type: 'text',
+      name: 'Title',
+      position: { x: 0, y: 0 },
+      size: { width: '100%', height: 'auto' },
+      layout: { width: 'fill', height: 'hug' },
+      appearance: {},
+      properties: {
+        text: 'Unlock Premium Features',
+        fontSize: 24,
+        fontWeight: 'bold',
+        textAlign: 'center',
+      },
+    },
+    // ... more components
+  ],
+};
+
+function App() {
+  return (
+    <PaywallView
+      configuration={config}
+      onButtonPress={(id, action) => {
+        // Handle purchase
+      }}
+    />
+  );
+}
+```
+
+### Custom Loading and Error Components
+
+```tsx
+import { PaywallView } from '@billdog.io/react-native';
+import { Text, View } from 'react-native';
+
+function LoadingPaywall() {
+  return (
+    <View>
+      <Text>Loading your offers...</Text>
+    </View>
+  );
+}
+
+function ErrorPaywall({ error }: { error: Error }) {
+  return (
+    <View>
+      <Text>Failed to load: {error.message}</Text>
+    </View>
+  );
+}
+
+function App() {
+  return (
+    <PaywallView
+      paywallIdentifier="premium_offer"
+      apiKey="your_api_key"
+      projectUrl="https://yourproject.supabase.co"
+      LoadingComponent={LoadingPaywall}
+      ErrorComponent={ErrorPaywall}
+    />
+  );
+}
+```
+
+## API Reference
+
+### PaywallView Props
+
+| Prop | Type | Required | Description |
+|------|------|----------|-------------|
+| `paywallIdentifier` | `string` | No | Paywall identifier to fetch from API |
+| `configuration` | `PaywallConfiguration` | No | Direct configuration (skips API fetch) |
+| `apiKey` | `string` | No | API key for authentication |
+| `projectUrl` | `string` | No | Project URL (e.g., https://yourproject.supabase.co) |
+| `onButtonPress` | `(id: string, action: string) => void` | No | Called when user presses buttons |
+| `onDismiss` | `() => void` | No | Called when paywall is dismissed |
+| `LoadingComponent` | `ComponentType` | No | Custom loading component |
+| `ErrorComponent` | `ComponentType<{ error: Error }>` | No | Custom error component |
+
+### usePaywall Hook
+
+```tsx
+import { usePaywall } from '@billdog.io/react-native';
+
+const { configuration, loading, error, refetch } = usePaywall({
+  paywallIdentifier: 'premium_offer',
+  apiKey: 'your_api_key',
+  projectUrl: 'https://yourproject.supabase.co',
+  userContext: {
+    app_user_id: 'user_123',
+    country: 'US',
+    platform: 'ios',
+  },
+});
+```
+
+### useOfferings Hook
+
+Fetch a list of offerings with filtering, pagination, and expansion options:
+
+```tsx
+import { useOfferings } from '@billdog.io/react-native';
+
+const { offerings, pagination, loading, error, refetch } = useOfferings({
+  apiKey: 'your_api_key',
+  projectUrl: 'https://yourproject.supabase.co',
+  limit: 10,
+  offset: 0,
+  is_current: true,
+  expand: 'packages,products,paywall',
+  sort_by: 'display_name',
+  sort_order: 'asc',
+});
+
+// offerings is an array of offering objects
+// pagination contains: { total, limit, offset, has_more }
+```
+
+#### useOfferings Options
+
+- `apiKey` (required): Your API key
+- `projectUrl` (required): Your project URL
+- `limit`: Number of offerings to fetch (default: 20)
+- `offset`: Pagination offset (default: 0)
+- `is_current`: Filter by current offerings only
+- `is_default`: Filter by default offerings only
+- `identifier`: Search by identifier substring
+- `expand`: Comma-separated list of relations to include: 'packages', 'products', 'paywall'
+- `sort_by`: Sort field - 'created_at', 'display_name', or 'identifier' (default: 'created_at')
+- `sort_order`: 'asc' or 'desc' (default: 'desc')
+- `skipFetch`: Skip automatic fetching (default: false)
+
+## Supported Component Types
+
+- `text` - Text labels and headings
+- `image` - Images and icons
+- `button` - Call-to-action buttons
+- `stack` - Container for layout (vertical/horizontal)
+- `package` - Subscription package display
+- `feature-list` - List of features with checkmarks
+- `price` - Price display with currency
+- `badge` - Small labels (e.g., "Popular")
+- `divider` - Visual separator
+- `spacer` - Empty space for layout
+- `icon` - Icon components
+- `video` - Video players
+
+## Theme Support
+
+Paywalls support custom themes with colors and fonts:
+
+```tsx
+const config: PaywallConfiguration = {
+  components: [...],
+  theme: {
+    colors: {
+      primary: '#007AFF',
+      background: '#FFFFFF',
+      text: '#000000',
+    },
+    fonts: {
+      body: 'System',
+      heading: 'System-Bold',
+    },
+  },
+};
+```
+
+## Variable Substitution
+
+Use `{{variableName}}` in text to inject dynamic values:
+
+```tsx
+const config: PaywallConfiguration = {
+  components: [
+    {
+      id: 'welcome',
+      type: 'text',
+      properties: {
+        text: 'Welcome, {{userName}}!',
+      },
+    },
+  ],
+  variables: {
+    userName: 'John Doe',
+  },
+};
+```
+
+## License
+
+MIT

package/android/build.gradle

@@ -0,0 +1,99 @@
+// Android native module for @billdog.io/react-native.
+// Thin-bridge architecture: this module delegates to the native BillDog Android SDK
+// (io.billdog:billdog-core) rather than reimplementing logic in JS. See thin-bridge plan.
+//
+// Local dev: the native BillDog artifacts may not be on Maven Central yet. To resolve
+// them locally, run once:  cd native-sdks/android && ./gradlew publishToMavenLocal
+// (mavenLocal() below picks them up).
+
+buildscript {
+    // Must match the native BillDog Android SDK's Kotlin version (2.0.21) — its
+    // published artifacts carry Kotlin 2.0 metadata that a 1.8 compiler cannot read
+    // ("incompatible version of Kotlin … metadata is 2.0.0"). Prefer the app-wide
+    // `android.kotlinVersion` gradle property (set by RN/Expo), then the legacy
+    // `kotlinVersion` ext, then the native-SDK-matched default.
+    ext.billdog_kotlin_version = project.hasProperty('android.kotlinVersion') ? project.property('android.kotlinVersion')
+        : (project.hasProperty('kotlinVersion') ? project.kotlinVersion : '2.0.21')
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:7.4.2'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$billdog_kotlin_version"
+    }
+}
+
+def safeExtGet(prop, fallback) {
+    rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+
+android {
+    namespace 'io.billdog.virtualcurrency'
+    compileSdkVersion safeExtGet('compileSdkVersion', 34)
+
+    defaultConfig {
+        minSdkVersion safeExtGet('minSdkVersion', 24)
+        targetSdkVersion safeExtGet('targetSdkVersion', 34)
+    }
+
+    // React Native 0.73+ (and the Expo prebuild toolchain) build with JDK 17 and
+    // force sourceCompatibility 17 on subprojects. Kotlin's jvmTarget must match or
+    // AGP fails compileDebugKotlin with a jvm-target mismatch. Align both to 17.
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+
+    kotlinOptions {
+        jvmTarget = '17'
+        // The native BillDog Android SDK ships Kotlin 2.0 metadata. When the host app
+        // pins an older Kotlin (e.g. Expo SDK 50 / RN 0.73 cap at 1.9, since Kotlin 2.0
+        // breaks expo-modules-core), this bridge still needs to read those 2.0 classes.
+        // Skip the metadata-version gate for THIS module only. Remove once the app
+        // toolchain is Kotlin 2.0+ (Expo SDK 51+ / RN 0.74+).
+        freeCompilerArgs += ['-Xskip-metadata-version-check']
+    }
+
+    sourceSets {
+        main.java.srcDirs += 'src/main/kotlin'
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+    mavenLocal() // resolves locally-published BillDog artifacts during development
+}
+
+dependencies {
+    implementation "com.facebook.react:react-native:+" // provided by the host app
+    implementation "org.jetbrains.kotlin:kotlin-stdlib:$billdog_kotlin_version"
+
+    // The native modules bridge the SDK's suspend APIs on a coroutine scope.
+    // billdog-core declares coroutines as `implementation` (not `api`), so declare
+    // them here explicitly (pinned to billdog-core's version).
+    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3"
+
+    // Native BillDog Android SDK — the delegation target for this bridge.
+    def billdogVersion = safeExtGet('billdogVersion', '1.0.0-beta.2')
+    implementation "io.billdog:billdog-core:$billdogVersion"
+    // Concrete satellite managers, resolved via BillDog.getModules() and cast by the
+    // BillDogAnalytics / BillDogABTest / BillDogSurvey RN modules.
+    implementation "io.billdog:billdog-analytics:$billdogVersion"
+    implementation "io.billdog:billdog-ab-test:$billdogVersion"
+    implementation "io.billdog:billdog-survey:$billdogVersion"
+    // billdog-compose provides @Composable PaywallScreen for the native BDPaywallView
+    // (SimpleViewManager hosting a ComposeView) — inline paywall rendering.
+    implementation "io.billdog:billdog-compose:$billdogVersion"
+
+    // Compose runtime for hosting PaywallScreen inside a ComposeView in the ViewManager.
+    def composeBom = platform('androidx.compose:compose-bom:2023.10.01')
+    implementation composeBom
+    implementation 'androidx.compose.ui:ui'
+    implementation 'androidx.activity:activity-compose:1.7.2'
+    // billdog-compose (PaywallScreen) is added with the native paywall ViewManager increment.
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" />