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

package/ios/BillDogAnalytics.m

@@ -0,0 +1,105 @@
+//
+//  BillDogAnalytics.m
+//  @billdog.io/react-native
+//
+//  RCT_EXTERN bridge declarations for the BillDogAnalytics Swift module.
+//  ⚠️ Requires `pod install` + Xcode to compile/verify — no iOS toolchain in
+//  the authoring environment.
+//
+
+#import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
+
+@interface RCT_EXTERN_MODULE(BillDogAnalytics, RCTEventEmitter)
+
+RCT_EXTERN_METHOD(initialize:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(track:(NSString *)name
+                  properties:(NSDictionary *)properties
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(trackRevenue:(nonnull NSNumber *)amount
+                  currency:(NSString *)currency
+                  productId:(NSString *)productId
+                  properties:(NSDictionary *)properties
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(identify:(NSString *)userId
+                  properties:(NSDictionary *)properties
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(setSuperProperties:(NSDictionary *)properties
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(updateUserProperties:(NSString *)operation
+                  properties:(NSDictionary *)properties
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(flush:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(optOut:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(optIn:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(reset:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(alias:(NSString *)newId
+                  originalId:(NSString *)originalId
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(timeEvent:(NSString *)eventName
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(setGroup:(NSString *)groupType
+                  groupId:(NSString *)groupId
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(setGroupProperties:(NSString *)groupType
+                  groupId:(NSString *)groupId
+                  properties:(NSDictionary *)properties
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(trackScreen:(NSString *)screenName
+                  properties:(NSDictionary *)properties
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(trackDeepLink:(NSString *)url
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(getDeviceId:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(getDistinctId:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(getSessionId:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(registerSuperPropertiesOnce:(NSDictionary *)properties
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(unregisterSuperProperty:(NSString *)key
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(clearSuperProperties:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+@end

package/ios/BillDogAnalytics.swift

@@ -0,0 +1,324 @@
+//
+//  BillDogAnalytics.swift
+//  @billdog.io/react-native
+//
+//  React Native bridge → native `BillDogAnalyticsManager`.
+//
+//  ⚠️ VERIFICATION: there is no iOS/CocoaPods toolchain in the authoring
+//  environment. This file is written to be internally consistent and
+//  compile-ready against the verified native signatures (cited inline as
+//  `BillDogAnalytics.swift:<line>` / `BillDog.swift:<line>`), but it REQUIRES a
+//  `pod install` + Xcode build to actually compile and run.
+//
+//  Manager is looked up per-call via `BillDog.shared.getModules()`
+//  (BillDog.swift:579) — cheap array compactMap. When the analytics module is
+//  not registered (SDK not configured), every mutating call is a best-effort
+//  NO-OP that resolves nil, matching the JS side (which silently no-ops when the
+//  native module is unlinked). Mirrors packages/flutter/.../BillDogAnalyticsChannel.swift.
+//
+
+import Foundation
+import React
+import BillDogFull
+
+@objc(BillDogAnalytics)
+class BillDogAnalytics: RCTEventEmitter {
+
+    private var hasListeners = false
+
+    override static func requiresMainQueueSetup() -> Bool {
+        return false
+    }
+
+    override func supportedEvents() -> [String]! {
+        return ["onAnalyticsFlush"]
+    }
+
+    override func startObserving() {
+        hasListeners = true
+    }
+
+    override func stopObserving() {
+        hasListeners = false
+    }
+
+    // MARK: - Native manager access
+
+    // BillDog.shared.getModules() -> [BillDogModule]   (BillDog.swift:579)
+    // BillDogAnalyticsManager: BillDogModule           (BillDogAnalytics.swift:18)
+    private func manager() -> BillDogAnalyticsManager? {
+        return BillDog.shared.getModules()
+            .compactMap { $0 as? BillDogAnalyticsManager }
+            .first
+    }
+
+    // MARK: - Lifecycle
+
+    // The analytics module is registered by BillDogBridge.configure() via
+    // `BillDog.shared.use(module:)` — NOT by `configure(config:)`, which registers
+    // nothing. (An earlier comment here claimed the latter, which masked the fact
+    // that nothing registered analytics at all and every event was dropped.)
+    // Resolve as a no-op so the JS init handshake completes; warn loudly when the
+    // registry is still empty.
+    @objc
+    func initialize(_ resolve: @escaping RCTPromiseResolveBlock,
+                    rejecter reject: @escaping RCTPromiseRejectBlock) {
+        if manager() == nil {
+            NSLog("[BillDogAnalytics] initialize(): analytics module NOT registered — "
+                + "call BillDog configure() first; track()/identify() will no-op")
+        }
+        resolve(nil)
+    }
+
+    // MARK: - Tracking
+
+    @objc
+    func track(_ name: String,
+               properties: NSDictionary,
+               resolver resolve: @escaping RCTPromiseResolveBlock,
+               rejecter reject: @escaping RCTPromiseRejectBlock) {
+        // Facade: BillDog.shared.trackEvent(_:properties:)  (BillDog.swift:2682)
+        BillDog.shared.trackEvent(name, properties: properties as? [String: Any] ?? [:])
+        resolve(nil)
+    }
+
+    @objc
+    func trackRevenue(_ amount: NSNumber,
+                      currency: String,
+                      productId: String?,
+                      properties: NSDictionary,
+                      resolver resolve: @escaping RCTPromiseResolveBlock,
+                      rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.trackRevenue(amount:currency:productId:properties:)  (BillDogAnalytics.swift:729)
+        mgr.trackRevenue(
+            amount: amount.doubleValue,
+            currency: currency,
+            productId: productId,
+            properties: properties as? [String: Any] ?? [:]
+        )
+        resolve(nil)
+    }
+
+    @objc
+    func identify(_ userId: String,
+                  properties: NSDictionary,
+                  resolver resolve: @escaping RCTPromiseResolveBlock,
+                  rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.identify(userId:properties:)  (BillDogAnalytics.swift:717)
+        mgr.identify(userId: userId, properties: properties as? [String: Any] ?? [:])
+        resolve(nil)
+    }
+
+    @objc
+    func setSuperProperties(_ properties: NSDictionary,
+                            resolver resolve: @escaping RCTPromiseResolveBlock,
+                            rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.registerSuperProperties(_:)  (BillDogAnalytics.swift:479)
+        mgr.registerSuperProperties(properties as? [String: Any] ?? [:])
+        resolve(nil)
+    }
+
+    @objc
+    func updateUserProperties(_ operation: String,
+                              properties: NSDictionary,
+                              resolver resolve: @escaping RCTPromiseResolveBlock,
+                              rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        let props = properties as? [String: Any] ?? [:]
+        // Route by operation to the matching per-key / bulk user-property methods.
+        switch operation {
+        case "$set":
+            // mgr.setUserProperties(_:)  (BillDogAnalytics.swift:760)
+            mgr.setUserProperties(props)
+        case "$set_once":
+            // mgr.setUserPropertyOnce(_:value:)  (BillDogAnalytics.swift:764) — per key
+            for (key, value) in props { mgr.setUserPropertyOnce(key, value: value) }
+        case "$add":
+            // mgr.incrementUserProperty(_:by:)  (BillDogAnalytics.swift:768) — per key, Double
+            for (key, value) in props {
+                let by = (value as? NSNumber)?.doubleValue ?? (value as? Double) ?? 0
+                mgr.incrementUserProperty(key, by: by)
+            }
+        case "$append":
+            // mgr.appendToUserProperty(_:value:)  (BillDogAnalytics.swift:772) — per key
+            for (key, value) in props { mgr.appendToUserProperty(key, value: value) }
+        case "$unset":
+            // mgr.unsetUserProperties(_:)  (BillDogAnalytics.swift:780) — keys
+            mgr.unsetUserProperties(Array(props.keys))
+        case "$remove":
+            // No native counterpart — best-effort no-op.
+            break
+        default:
+            break
+        }
+        resolve(nil)
+    }
+
+    @objc
+    func flush(_ resolve: @escaping RCTPromiseResolveBlock,
+               rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.flush()  (BillDogAnalytics.swift:792)
+        mgr.flush()
+        // The native flush() returns Void (no batch count), so `eventCount` is
+        // reported as 0 — there is no native equivalent for the flushed count.
+        if hasListeners {
+            sendEvent(withName: "onAnalyticsFlush", body: ["eventCount": 0])
+        }
+        resolve(nil)
+    }
+
+    @objc
+    func optOut(_ resolve: @escaping RCTPromiseResolveBlock,
+                rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.optOut()  (BillDogAnalytics.swift:446)
+        mgr.optOut()
+        resolve(nil)
+    }
+
+    @objc
+    func optIn(_ resolve: @escaping RCTPromiseResolveBlock,
+               rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.optIn()  (BillDogAnalytics.swift:465)
+        mgr.optIn()
+        resolve(nil)
+    }
+
+    @objc
+    func reset(_ resolve: @escaping RCTPromiseResolveBlock,
+               rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.reset()  (BillDogAnalytics.swift:959)
+        mgr.reset()
+        resolve(nil)
+    }
+
+    @objc
+    func alias(_ newId: String,
+               originalId: String?,
+               resolver resolve: @escaping RCTPromiseResolveBlock,
+               rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.alias(newId:previousId:)  (BillDogAnalytics.swift:1138) — originalId -> previousId
+        mgr.alias(newId: newId, previousId: originalId)
+        resolve(nil)
+    }
+
+    @objc
+    func timeEvent(_ eventName: String,
+                   resolver resolve: @escaping RCTPromiseResolveBlock,
+                   rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.timeEvent(_:)  (BillDogAnalytics.swift:1130)
+        mgr.timeEvent(eventName)
+        resolve(nil)
+    }
+
+    @objc
+    func setGroup(_ groupType: String,
+                  groupId: String,
+                  resolver resolve: @escaping RCTPromiseResolveBlock,
+                  rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.setGroup(groupType:groupId:)  (BillDogAnalytics.swift:1104)
+        mgr.setGroup(groupType: groupType, groupId: groupId)
+        resolve(nil)
+    }
+
+    @objc
+    func setGroupProperties(_ groupType: String,
+                            groupId: String,
+                            properties: NSDictionary,
+                            resolver resolve: @escaping RCTPromiseResolveBlock,
+                            rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.setGroupProperties(groupType:groupId:properties:)  (BillDogAnalytics.swift:1116)
+        mgr.setGroupProperties(
+            groupType: groupType,
+            groupId: groupId,
+            properties: properties as? [String: Any] ?? [:]
+        )
+        resolve(nil)
+    }
+
+    @objc
+    func trackScreen(_ screenName: String,
+                     properties: NSDictionary,
+                     resolver resolve: @escaping RCTPromiseResolveBlock,
+                     rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.trackScreen(_:properties:)  (BillDogAnalytics.swift:1039)
+        mgr.trackScreen(screenName, properties: properties as? [String: Any] ?? [:])
+        resolve(nil)
+    }
+
+    @objc
+    func trackDeepLink(_ url: String,
+                       resolver resolve: @escaping RCTPromiseResolveBlock,
+                       rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.trackDeepLink(_:)  (BillDogAnalytics.swift:1028) — takes URL, guard nil
+        if let parsed = URL(string: url) {
+            mgr.trackDeepLink(parsed)
+        }
+        resolve(nil)
+    }
+
+    @objc
+    func getDeviceId(_ resolve: @escaping RCTPromiseResolveBlock,
+                     rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.getDeviceId() -> String  (BillDogAnalytics.swift:1082)
+        resolve(mgr.getDeviceId())
+    }
+
+    @objc
+    func getDistinctId(_ resolve: @escaping RCTPromiseResolveBlock,
+                       rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.getDistinctId() -> String  (BillDogAnalytics.swift:1095)
+        resolve(mgr.getDistinctId())
+    }
+
+    @objc
+    func getSessionId(_ resolve: @escaping RCTPromiseResolveBlock,
+                      rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.getSessionId() -> String  (BillDogAnalytics.swift:1045)
+        resolve(mgr.getSessionId())
+    }
+
+    @objc
+    func registerSuperPropertiesOnce(_ properties: NSDictionary,
+                                     resolver resolve: @escaping RCTPromiseResolveBlock,
+                                     rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.registerSuperPropertiesOnce(_:)  (BillDogAnalytics.swift:485)
+        mgr.registerSuperPropertiesOnce(properties as? [String: Any] ?? [:])
+        resolve(nil)
+    }
+
+    @objc
+    func unregisterSuperProperty(_ key: String,
+                                 resolver resolve: @escaping RCTPromiseResolveBlock,
+                                 rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.unregisterSuperProperty(_:)  (BillDogAnalytics.swift:497)
+        mgr.unregisterSuperProperty(key)
+        resolve(nil)
+    }
+
+    @objc
+    func clearSuperProperties(_ resolve: @escaping RCTPromiseResolveBlock,
+                              rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let mgr = manager() else { resolve(nil); return }
+        // mgr.clearSuperProperties()  (BillDogAnalytics.swift:503)
+        mgr.clearSuperProperties()
+        resolve(nil)
+    }
+}

package/ios/BillDogBridge.m

@@ -0,0 +1,222 @@
+//
+//  BillDogBridge.m
+//  @billdog.io/react-native
+//
+//  React Native bridge for the core BillDog module (JS: NativeModules.BillDog).
+//
+//  RCT_EXTERN_MODULE / RCT_EXTERN_METHOD declarations only — the Swift file
+//  (BillDogBridge.swift, `@objc(BillDog) class BillDogBridge`) carries the
+//  implementations, delegating to `BillDog.shared` from the native iOS SDK.
+//
+//  ⚠️ VERIFICATION: there is no iOS/CocoaPods/Xcode toolchain in the authoring
+//  environment. This file is written to be internally consistent and
+//  compile-ready against the verified native signatures (cited inline in the
+//  Swift file as `BillDog.swift:<line>` etc.), but it REQUIRES a `pod install`
+//  + Xcode build in a host RN app to actually compile and run.
+//
+//  Method names + argument shapes are the AUTHORITATIVE contract from
+//  `../src/BillDog.ts` (every `native.<method>(...)` call). Do NOT rename.
+//
+
+#import <React/RCTBridgeModule.h>
+
+@interface RCT_EXTERN_MODULE(BillDog, NSObject)
+
+// ── Configuration ─────────────────────────────────────────────────────────────
+
+// native.configure(apiKey, options) → BillDog.shared.configure(config:)
+RCT_EXTERN_METHOD(configure:(NSString *)apiKey
+                  options:(NSDictionary *)options
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// ── Purchases ───────────────────────────────────────────────────────────────
+
+// BillDog.ts:221 — native.purchase({ ...PurchaseParams, source })
+RCT_EXTERN_METHOD(purchase:(NSDictionary *)params
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// BillDog.ts:266 — native.setPurchaseControllerActive(bool). Fire-and-forget.
+RCT_EXTERN_METHOD(setPurchaseControllerActive:(BOOL)active)
+
+// BillDog.ts:296 — native.restore()
+RCT_EXTERN_METHOD(restore:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// ── CustomerInfo ─────────────────────────────────────────────────────────────
+
+// BillDog.ts:320 — native.getCustomerInfo(policy) — policy is a wire-name string.
+RCT_EXTERN_METHOD(getCustomerInfo:(NSString *)policy
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// BillDog.ts:792 — native.invalidateCustomerInfoCache()
+RCT_EXTERN_METHOD(invalidateCustomerInfoCache:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// ── Store capability surface ─────────────────────────────────────────────────
+
+// BillDog.ts:350 — native.canMakePayments()
+RCT_EXTERN_METHOD(canMakePayments:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// BillDog.ts:359 — native.presentCodeRedemptionSheet()
+RCT_EXTERN_METHOD(presentCodeRedemptionSheet:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// BillDog.ts:375 — native.checkTrialOrIntroDiscountEligibility([productId])
+RCT_EXTERN_METHOD(checkTrialOrIntroDiscountEligibility:(NSArray *)productIds
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// BillDog.ts:388 — native.subscribeStorefront(). Fire-and-forget.
+RCT_EXTERN_METHOD(subscribeStorefront)
+
+// ── Self-hosted proxy ────────────────────────────────────────────────────────
+
+// BillDog.ts:404 — native.setProxyURL(url|null). Fire-and-forget.
+RCT_EXTERN_METHOD(setProxyURL:(NSString *)url)
+
+// BillDog.ts:453 — native.getProxyURL() — read SYNCHRONOUSLY by the JS facade.
+RCT_EXTERN__BLOCKING_SYNCHRONOUS_METHOD(getProxyURL)
+
+// ── Consent ──────────────────────────────────────────────────────────────────
+
+// BillDog.ts:419 — native.setConsentRequired(bool). Fire-and-forget.
+RCT_EXTERN_METHOD(setConsentRequired:(BOOL)required)
+
+// BillDog.ts:428 — native.setConsent(purpose, granted). Fire-and-forget.
+RCT_EXTERN_METHOD(setConsent:(NSString *)purpose
+                  granted:(BOOL)granted)
+
+// BillDog.ts:437 — native.setConsentGiven(bool). Fire-and-forget.
+RCT_EXTERN_METHOD(setConsentGiven:(BOOL)given)
+
+// BillDog.ts:446 — native.consentHeaderValue() (awaited)
+RCT_EXTERN_METHOD(consentHeaderValue:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// ── Attribution ──────────────────────────────────────────────────────────────
+
+// BillDog.ts:484 — native.collectDeviceIdentifiers(). Fire-and-forget.
+RCT_EXTERN_METHOD(collectDeviceIdentifiers)
+
+// native.setAttribution({ key: id, … }) → matching native provider setter.
+RCT_EXTERN_METHOD(setAttribution:(NSDictionary *)data
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// ── Identity ─────────────────────────────────────────────────────────────────
+
+// BillDog.ts:513 — native.logIn(appUserId)
+RCT_EXTERN_METHOD(logIn:(NSString *)appUserId
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// BillDog.ts:536 — native.logOut()
+RCT_EXTERN_METHOD(logOut:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// BillDog.ts:589 — native.setSandboxMode(bool). Fire-and-forget.
+RCT_EXTERN_METHOD(setSandboxMode:(BOOL)enabled)
+
+// ── Placements ───────────────────────────────────────────────────────────────
+
+// BillDog.ts:634 — native.registerPlacement({ placementId, params })
+RCT_EXTERN_METHOD(registerPlacement:(NSDictionary *)args
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// BillDog.ts:679 — native.hasAccessForPlacement(placementId) — read SYNCHRONOUSLY.
+RCT_EXTERN__BLOCKING_SYNCHRONOUS_METHOD(hasAccessForPlacement:(NSString *)placementId)
+
+// BillDog.ts:878 — native.getPresentationResult(placementId)
+RCT_EXTERN_METHOD(getPresentationResult:(NSString *)placementId
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// Experiments & feature flags: the paywall-facade shim was removed. Use the
+// standalone BillDogABTest module (bridged separately) instead.
+
+// ── In-app messages ──────────────────────────────────────────────────────────
+
+// BillDog.ts:722 — native.showInAppMessages(placementId|null)
+RCT_EXTERN_METHOD(showInAppMessages:(NSString *)placementId
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// ── Deep linking ─────────────────────────────────────────────────────────────
+
+// BillDog.ts:731 — native.handleDeepLink(uri)
+RCT_EXTERN_METHOD(handleDeepLink:(NSString *)uri
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// ── Component selection state ─────────────────────────────────────────────────
+
+// BillDog.ts:740 — native.getSelectedProductIndex(componentId) — read SYNCHRONOUSLY.
+RCT_EXTERN__BLOCKING_SYNCHRONOUS_METHOD(getSelectedProductIndex:(NSString *)componentId)
+
+// BillDog.ts:747 — native.setSelectedProductIndex(componentId, index). Fire-and-forget.
+RCT_EXTERN_METHOD(setSelectedProductIndex:(NSString *)componentId
+                  index:(nonnull NSNumber *)index)
+
+// ── Theming ──────────────────────────────────────────────────────────────────
+
+// BillDog.ts:755 — native.updateTheme(overrides). Fire-and-forget.
+RCT_EXTERN_METHOD(updateTheme:(NSDictionary *)overrides)
+
+// BillDog.ts:762 — native.setInterfaceStyle('light'|'dark'|null). Fire-and-forget.
+RCT_EXTERN_METHOD(setInterfaceStyle:(NSString *)style)
+
+// ── Subscription management ──────────────────────────────────────────────────
+
+// BillDog.ts:776 — native.showManageSubscriptions(subscriptionId|null)
+RCT_EXTERN_METHOD(showManageSubscriptions:(NSString *)subscriptionId
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// ── Cache control ────────────────────────────────────────────────────────────
+
+// BillDog.ts:785 — native.clearCache()
+RCT_EXTERN_METHOD(clearCache:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// ── User attributes ──────────────────────────────────────────────────────────
+
+// BillDog.ts:801 — native.setUserAttributes(attributes)
+RCT_EXTERN_METHOD(setUserAttributes:(NSDictionary *)attributes
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// BillDog.ts:812 — native.getUserAttributes() (awaited)
+RCT_EXTERN_METHOD(getUserAttributes:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// ── External-purchase observation ────────────────────────────────────────────
+
+// BillDog.ts:822 — native.observePurchaseStart(productId). Fire-and-forget.
+RCT_EXTERN_METHOD(observePurchaseStart:(NSString *)productId)
+
+// BillDog.ts:829 — native.observePurchaseResult(productId, orderId|null). Fire-and-forget.
+RCT_EXTERN_METHOD(observePurchaseResult:(NSString *)productId
+                  orderId:(NSString *)orderId)
+
+// BillDog.ts:835 — native.observePurchaseError(productId, error). Fire-and-forget.
+RCT_EXTERN_METHOD(observePurchaseError:(NSString *)productId
+                  error:(NSString *)error)
+
+// ── Server-side actions ──────────────────────────────────────────────────────
+
+// BillDog.ts:900 — native.executeAction(paywallId|null, componentId, actionType,
+//                  idempotencyKey|null, metadata?)
+RCT_EXTERN_METHOD(executeAction:(NSString *)paywallId
+                  componentId:(NSString *)componentId
+                  actionType:(NSString *)actionType
+                  idempotencyKey:(NSString *)idempotencyKey
+                  metadata:(NSDictionary *)metadata
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+@end