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

package/ios/BillDogSurvey.swift

@@ -0,0 +1,257 @@
+//
+//  BillDogSurvey.swift
+//  @billdog.io/react-native
+//
+//  React Native bridge → native `BillDogSurveyPresenter` / `BillDogSurveyManager`.
+//
+//  ⚠️ 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
+//  `BillDog.swift:<line>` / `BillDogSurveyManager.swift:<line>` /
+//  `BillDogSurveyPresenter.swift:<line>`), but it REQUIRES a `pod install` +
+//  Xcode build to actually compile and run.
+//
+//  Survey APIs are @available(iOS 15.0, *) — every call is guarded; on older
+//  OSes each method is a best-effort no-op (resolve nil/false), matching the JS
+//  side which no-ops when the native module is unavailable.
+//
+
+import Foundation
+import React
+import BillDogFull
+
+@objc(BillDogSurvey)
+class BillDogSurvey: RCTEventEmitter {
+
+    private var hasListeners = false
+    private var completedSubId: String?
+    private var dismissedSubId: String?
+
+    override static func requiresMainQueueSetup() -> Bool {
+        return true // presentSurvey touches UIKit — set up on the main queue.
+    }
+
+    override func supportedEvents() -> [String]! {
+        return ["onSurveyCompleted", "onSurveyDismissed"]
+    }
+
+    override func startObserving() {
+        hasListeners = true
+        // Native surveys emit on the in-process EventBus for EVERY present path
+        // (RN, paywall-triggered, event-triggered). Subscribe there so the RN
+        // listeners fire regardless of who presented the survey.
+        // survey_completed carries {survey_id, respondent_id}; survey_dismissed
+        // carries {survey_id}. (BillDogEventBus.swift:40-41,
+        // BillDogSurveyPresenter.swift:59 / :55)
+        completedSubId = BillDogEventBus.shared.subscribe(
+            BillDogEventBus.EventTypes.surveyCompleted
+        ) { [weak self] event in
+            guard let self = self, self.hasListeners else { return }
+            // PARTIAL SurveyResponse — the bus does not carry the answer list.
+            self.sendEvent(withName: "onSurveyCompleted", body: [
+                "survey_id": event.properties["survey_id"] as? String ?? "",
+                "respondent_id": event.properties["respondent_id"] as? String ?? ""
+            ])
+        }
+        dismissedSubId = BillDogEventBus.shared.subscribe(
+            BillDogEventBus.EventTypes.surveyDismissed
+        ) { [weak self] event in
+            guard let self = self, self.hasListeners else { return }
+            // `pageIndex` has no native equivalent on the dismiss event — reported as 0.
+            self.sendEvent(withName: "onSurveyDismissed", body: [
+                "surveyId": event.properties["survey_id"] as? String ?? "",
+                "pageIndex": 0
+            ])
+        }
+    }
+
+    override func stopObserving() {
+        hasListeners = false
+        if let id = completedSubId { BillDogEventBus.shared.unsubscribe(id); completedSubId = nil }
+        if let id = dismissedSubId { BillDogEventBus.shared.unsubscribe(id); dismissedSubId = nil }
+    }
+
+    // MARK: - Lifecycle
+
+    // No native `initialize()` — the presenter is materialized lazily by the
+    // SDK (BillDog.swift:73). Resolve as a best-effort no-op.
+    @objc
+    func initialize(_ resolve: @escaping RCTPromiseResolveBlock,
+                    rejecter reject: @escaping RCTPromiseRejectBlock) {
+        resolve(nil)
+    }
+
+    // MARK: - Presentation
+
+    @objc
+    func presentSurvey(_ options: NSDictionary,
+                       resolver resolve: @escaping RCTPromiseResolveBlock,
+                       rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard #available(iOS 15.0, *) else { resolve(nil); return }
+        // BillDog.getSurveyPresenter() -> BillDogSurveyPresenter?  (BillDog.swift:315)
+        guard let presenter = BillDog.getSurveyPresenter() else { resolve(nil); return }
+
+        let surveyId = options["surveyIdentifier"] as? String ?? ""
+        let customerId = options["customerId"] as? String
+        // NOTE: `context` and `isDismissible` from SurveyPresentationOptions have
+        // no counterpart on presenter.present(...) — they are not forwarded.
+
+        DispatchQueue.main.async {
+            guard let root = self.topViewController() else { resolve(nil); return }
+
+            // Resolve the promise exactly once (complete -> response, dismiss -> nil).
+            var settled = false
+            let settleOnce: (Any?) -> Void = { value in
+                if settled { return }
+                settled = true
+                resolve(value)
+            }
+
+            // presenter.present(surveyId:from:handler:customerId:...)  (BillDogSurveyPresenter.swift:39)
+            // The handler type (SurveyPresentationHandler, SurveyModels.swift:269)
+            // is inferred — closures return SurveySubmitResult (SurveyModels.swift:243).
+            let handler = SurveyPresentationHandler(
+                onComplete: { _, result in
+                    let answers = (result.answers ?? []).map { self.serializeAnswer($0) }
+                    settleOnce([
+                        "survey_id": result.survey_id,
+                        "answers": answers,
+                        "completed_at": ISO8601DateFormatter().string(from: Date())
+                    ])
+                },
+                onDismiss: { _ in
+                    settleOnce(nil)
+                },
+                onError: { error in
+                    if settled { return }
+                    settled = true
+                    reject("BILLDOG_ERROR", error.localizedDescription, error)
+                }
+            )
+
+            presenter.present(
+                surveyId: surveyId,
+                from: root,
+                handler: handler,
+                customerId: customerId
+            )
+        }
+    }
+
+    // MARK: - Fetch
+
+    @objc
+    func fetchSurvey(_ surveyIdentifier: String,
+                     resolver resolve: @escaping RCTPromiseResolveBlock,
+                     rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard #available(iOS 15.0, *) else { resolve(nil); return }
+        guard let presenter = BillDog.getSurveyPresenter() else { resolve(nil); return }
+        let manager = presenter.surveyManager // BillDogSurveyPresenter.swift:10
+        Task {
+            do {
+                // manager.fetchSurvey(surveyId:...) async throws -> SurveyConfig
+                //   (BillDogSurveyManager.swift:49)
+                let config = try await manager.fetchSurvey(surveyId: surveyIdentifier)
+                resolve(self.serializeCodable(config))
+            } catch {
+                reject("BILLDOG_ERROR", error.localizedDescription, error)
+            }
+        }
+    }
+
+    // MARK: - Submit
+
+    @objc
+    func submitResponse(_ response: NSDictionary,
+                        resolver resolve: @escaping RCTPromiseResolveBlock,
+                        rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard #available(iOS 15.0, *) else { resolve(false); return }
+        guard let presenter = BillDog.getSurveyPresenter() else { resolve(false); return }
+        let manager = presenter.surveyManager
+
+        let surveyId = response["survey_id"] as? String ?? ""
+        let rawAnswers = response["answers"] as? [[String: Any]] ?? []
+        let answers = rawAnswers.map { self.deserializeAnswer($0) }
+
+        Task {
+            do {
+                // manager.submitSurvey(surveyId:answers:...) async throws -> SurveySubmitResult
+                //   (BillDogSurveyManager.swift:53)
+                _ = try await manager.submitSurvey(surveyId: surveyId, answers: answers)
+                resolve(true)
+            } catch {
+                reject("BILLDOG_ERROR", error.localizedDescription, error)
+            }
+        }
+    }
+
+    // MARK: - Eligibility
+
+    @objc
+    func canShowSurvey(_ surveyIdentifier: String,
+                       resolver resolve: @escaping RCTPromiseResolveBlock,
+                       rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard #available(iOS 15.0, *) else { resolve(false); return }
+        guard let presenter = BillDog.getSurveyPresenter() else { resolve(false); return }
+        // No native "canShow" eligibility check is exposed. The closest reachable
+        // signal is hasCompletedSurvey(surveyId:) (BillDogSurveyPresenter.swift:122):
+        // a survey the user already completed cannot be shown again. This is an
+        // APPROXIMATION — server-side display_conditions are NOT evaluated here.
+        resolve(!presenter.hasCompletedSurvey(surveyId: surveyIdentifier))
+    }
+
+    // MARK: - Helpers
+
+    /// Topmost presented view controller from the active key window (main thread).
+    private func topViewController() -> UIViewController? {
+        let keyWindow = UIApplication.shared.connectedScenes
+            .compactMap { $0 as? UIWindowScene }
+            .flatMap { $0.windows }
+            .first { $0.isKeyWindow }
+        var vc = keyWindow?.rootViewController
+        while let presented = vc?.presentedViewController {
+            vc = presented
+        }
+        return vc
+    }
+
+    /// SurveyAnswer (BillDogCore/Models/SurveyAnswer.swift:4) -> JS dict.
+    private func serializeAnswer(_ answer: SurveyAnswer) -> [String: Any] {
+        var dict: [String: Any] = ["question_id": answer.question_id]
+        if let choiceId = answer.choice_id { dict["choice_id"] = choiceId }
+        if let text = answer.answer_text { dict["answer_text"] = text }
+        if let number = answer.answer_number { dict["answer_number"] = number }
+        if let json = answer.answer_json { dict["answer_json"] = json.mapValues { $0.value } }
+        return dict
+    }
+
+    /// JS dict -> SurveyAnswer (accepts snake_case or camelCase keys).
+    ///
+    /// NOTE: `answer_json` is intentionally NOT forwarded. Its native type is
+    /// `[String: AnyCodable]`, and `AnyCodable` is declared in more than one
+    /// BillDog target (Core + ABTest), so spelling the type in the umbrella
+    /// `import BillDog` is ambiguous. Scalar answers (choice/text/number) — the
+    /// common survey answer shapes — are forwarded fully.
+    private func deserializeAnswer(_ dict: [String: Any]) -> SurveyAnswer {
+        let questionId = (dict["question_id"] as? String) ?? (dict["questionId"] as? String) ?? ""
+        let choiceId = (dict["choice_id"] as? String) ?? (dict["choiceId"] as? String)
+        let answerText = (dict["answer_text"] as? String) ?? (dict["answerText"] as? String)
+        let answerNumber = (dict["answer_number"] as? NSNumber)?.doubleValue
+            ?? (dict["answerNumber"] as? NSNumber)?.doubleValue
+        return SurveyAnswer(
+            questionId: questionId,
+            choiceId: choiceId,
+            answerText: answerText,
+            answerNumber: answerNumber
+        )
+    }
+
+    /// Encode a Codable native model into a JSON-object graph for the RN bridge.
+    private func serializeCodable<T: Encodable>(_ value: T) -> Any? {
+        guard let data = try? JSONEncoder().encode(value),
+              let object = try? JSONSerialization.jsonObject(with: data) else {
+            return nil
+        }
+        return object
+    }
+}

package/ios/BillDogVirtualCurrencyBridge.m

@@ -0,0 +1,63 @@
+//
+//  BillDogVirtualCurrencyBridge.m
+//  @billdog.io/react-native
+//
+//  React Native bridge for BillDog Virtual Currency module
+//
+
+#import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
+
+@interface RCT_EXTERN_MODULE(BillDogVirtualCurrency, RCTEventEmitter)
+
+// Initialize the Virtual Currency module
+RCT_EXTERN_METHOD(initialize:(NSDictionary *)config
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// Get balance for a specific currency
+RCT_EXTERN_METHOD(getBalance:(NSString *)currencyId
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// Add currency to balance
+RCT_EXTERN_METHOD(addCurrency:(NSString *)currencyId
+                  amount:(NSNumber *)amount
+                  reason:(NSString *)reason
+                  metadata:(NSDictionary *)metadata
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// Deduct currency from balance
+RCT_EXTERN_METHOD(deductCurrency:(NSString *)currencyId
+                  amount:(NSNumber *)amount
+                  reason:(NSString *)reason
+                  metadata:(NSDictionary *)metadata
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// Grant currency (admin/test operation)
+RCT_EXTERN_METHOD(grantCurrency:(NSString *)currencyId
+                  amount:(NSNumber *)amount
+                  reason:(NSString *)reason
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// Get transaction history
+RCT_EXTERN_METHOD(getTransactionHistory:(NSString *)currencyId
+                  limit:(NSNumber *)limit
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// Exchange one currency for another
+RCT_EXTERN_METHOD(exchangeCurrency:(NSString *)fromCurrencyId
+                  toCurrencyId:(NSString *)toCurrencyId
+                  fromAmount:(NSNumber *)fromAmount
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// Get all currencies with balances
+RCT_EXTERN_METHOD(getAllCurrencies:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+@end