@tinkerlandai/indiana-react-native 0.9.2 → 0.10.1

package/native-sdk/ios/FunnelView.swift

@@ -0,0 +1,125 @@
+#if canImport(UIKit)
+import Foundation
+import UIKit
+@preconcurrency import WebKit
+@preconcurrency import SafariServices
+import SwiftUI
+
+/// A native container for the single published Funnel renderer. Embed as a child or present over the app.
+@MainActor public final class IndianaFunnelViewController: UIViewController, @preconcurrency SFSafariViewControllerDelegate {
+    public let session: IndianaFunnelSession
+    public var onPurchase: (@MainActor (IndianaJSON) async throws -> Void)?
+    public var onEvent: (@MainActor (String) async throws -> Void)?
+    /// Opens an external page or Paywall link (`openIn` is `same_window` or `new_window`). Return false when it could
+    /// not be opened; an external page then takes its failed route. Default: in-app browser for `same_window`,
+    /// the system browser for `new_window`.
+    public var onOpenURL: (@MainActor (URL, String) async throws -> Bool)?
+    public var onComplete: (@MainActor (IndianaFunnelRun) -> Void)?
+    public var onDismiss: (@MainActor () -> Void)?
+    public var onError: (@MainActor (Error) -> Void)?
+    private var host: IndianaBundledWebView!
+    private var configurationRelay: IndianaFunnelConfigurationRelay?
+    private var stopped = false; private var completed = false; private var dismissed = false
+    private var observer: IndianaForegroundObserver?
+    public init(session: IndianaFunnelSession) { self.session = session; super.init(nibName: nil, bundle: nil) }
+    required init?(coder: NSCoder) { fatalError("Use init(session:)") }
+    public override func loadView() {
+        host = IndianaBundledWebView(label:"Funnel", dispatch: { [weak self] method,payload in
+            guard let self, !self.stopped else { throw IndianaFunnelError.identityChanged }
+            return try await self.dispatch(method,payload:payload)
+        },onError: { [weak self] error in self?.onError?(error) })
+        view = host.webView
+        Task {
+            await session.onInvalidation { [weak self] in Task { @MainActor in self?.invalidate() } }
+            guard !stopped else { return }; host.start()
+        }
+        observer = IndianaForegroundObserver { [weak self] in
+            Task { @MainActor in self?.sendEvent("refresh") }
+        }
+    }
+    public func close() async {
+        guard !stopped else { return }
+        do { _ = try await session.close() } catch { onError?(error) }
+        invalidate()
+    }
+    private func invalidate() {
+        guard !stopped else { return }
+        host?.destroy(); stopped = true; configurationRelay = nil
+        presentedViewController?.dismiss(animated: false)
+        if !dismissed { dismissed = true; onDismiss?() }
+    }
+    private func dispatch(_ method: String, payload: IndianaJSON) async throws -> IndianaJSON {
+        switch method {
+        case "ready":
+            let config = await session.hostConfiguration()
+            // UUID's synthesized Codable form is uppercase; the wire scope is canonical lowercase.
+            let scope: IndianaJSON = .object([
+                "projectId": .string(config.scope.projectId.uuidString.lowercased()),
+                "environment": .string(config.scope.environment.rawValue),
+            ])
+            send(.object(["event":.string("init"),"scope":scope,"apiOrigin":.string(config.apiOrigin)])); return .null
+        case "pendingCommand": return await session.hostPendingCommand()
+        case "configuration":
+            if configurationRelay == nil { configurationRelay = IndianaFunnelConfigurationRelay(configuration: await session.hostConfiguration()) }
+            guard let relay = configurationRelay, !stopped else { throw IndianaFunnelError.identityChanged }
+            return try await relay.read(payload)
+        case "paywallContent":
+            return try await session.hostPaywallContent(payload)
+        case "command":
+            guard let command = payload.object else { throw IndianaFunnelError.invalidCommand }
+            return try JSONDecoder().decode(IndianaJSON.self, from: await session.hostCommand(command))
+        case "purchase":
+            guard let operation = payload.object?["operation"], let onPurchase else { throw IndianaClientError.unsupportedCapability }
+            let trusted = try await session.trustedPurchase(operation)
+            try await onPurchase(trusted);return .null
+        case "checkout":
+            guard let raw = payload.object?["url"]?.string else { throw IndianaFunnelError.invalidCommand }
+            let url = try await session.trustedCheckoutURL(raw)
+            let browser = SFSafariViewController(url: url);browser.delegate = self;present(browser, animated: true);return .null
+        case "open":
+            let url = try await session.trustedOpen(payload), openIn = payload.object?["openIn"]?.string ?? "same_window"
+            if let onOpenURL { return .bool(try await onOpenURL(url, openIn)) }
+            if openIn == "new_window" { return .bool(await UIApplication.shared.open(url)) }
+            let browser = SFSafariViewController(url: url);browser.delegate = self;present(browser, animated: true);return .bool(true)
+        case "event":
+            guard let name = payload.object?["event"]?.string, let onEvent else { throw IndianaClientError.unsupportedCapability }
+            try await onEvent(try await session.trustedEvent(name)); return .null
+        case "complete":
+            guard let run = await session.current, run.status == "completed", run.instruction == nil || run.instruction == .null else { throw IndianaFunnelError.invalidCommand }
+            if !completed { completed = true; onComplete?(run) }; return .null
+        case "dismiss":
+            if !dismissed { dismissed = true; onDismiss?() }; return .null
+        default: throw IndianaFunnelError.invalidCommand
+        }
+    }
+    private func send(_ value: IndianaJSON) { host?.send(value) }
+    private func sendEvent(_ event: String) { send(.object(["event":.string(event)])) }
+    public func safariViewControllerDidFinish(_ controller: SFSafariViewController) { controller.dismiss(animated: true); sendEvent("refresh") }
+
+}
+
+final class IndianaForegroundObserver {
+    private let token: NSObjectProtocol
+    init(_ action: @escaping @Sendable () -> Void) {
+        token = NotificationCenter.default.addObserver(forName: UIApplication.didBecomeActiveNotification, object: nil, queue: .main) { _ in action() }
+    }
+    deinit { NotificationCenter.default.removeObserver(token) }
+}
+
+/// Supports embedding in an existing product screen; node presentation stays authored by the Funnel.
+@MainActor public struct IndianaFunnelView: UIViewControllerRepresentable {
+    public let session: IndianaFunnelSession
+    public var onPurchase: (@MainActor (IndianaJSON) async throws -> Void)?
+    public var onEvent: (@MainActor (String) async throws -> Void)?
+    public var onComplete: (@MainActor (IndianaFunnelRun) -> Void)?
+    public var onDismiss: (@MainActor () -> Void)?
+    public var onError: (@MainActor (Error) -> Void)?
+    public var onOpenURL: (@MainActor (URL, String) async throws -> Bool)?
+    public init(session: IndianaFunnelSession, onPurchase: (@MainActor (IndianaJSON) async throws -> Void)? = nil, onEvent: (@MainActor (String) async throws -> Void)? = nil, onComplete: (@MainActor (IndianaFunnelRun) -> Void)? = nil, onDismiss: (@MainActor () -> Void)? = nil, onError: (@MainActor (Error) -> Void)? = nil, onOpenURL: (@MainActor (URL, String) async throws -> Bool)? = nil) {
+        self.session = session;self.onPurchase = onPurchase;self.onEvent = onEvent;self.onComplete = onComplete;self.onDismiss = onDismiss;self.onError = onError;self.onOpenURL = onOpenURL
+    }
+    public func makeUIViewController(context: Context) -> IndianaFunnelViewController { let controller = IndianaFunnelViewController(session: session); updateUIViewController(controller, context: context); return controller }
+    public func updateUIViewController(_ controller: IndianaFunnelViewController, context: Context) { controller.onPurchase = onPurchase; controller.onEvent = onEvent; controller.onComplete = onComplete; controller.onDismiss = onDismiss; controller.onError = onError; controller.onOpenURL = onOpenURL }
+    public static func dismantleUIViewController(_ controller: IndianaFunnelViewController, coordinator: ()) { Task { await controller.close() } }
+}
+#endif

package/native-sdk/ios/GeneratedProtocol.swift

@@ -0,0 +1,16 @@
+// Generated by scripts/sdk/generate-native-protocol.mjs. Do not edit.
+import Foundation
+public enum IndianaEnvironment: String, Codable, Sendable { case sandbox, live }
+enum IndianaProtocol {
+    static let wireProtocol = "0.10"
+    static let uuidPattern = "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+    static let utcPattern = "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+    static let scopeKeys: Set<String> = ["projectId", "environment"]
+    static let runKeys: Set<String> = ["id", "source", "revision", "visit", "nodeId", "nodeType", "status", "stopped", "canBack", "authenticated", "locale", "answers", "parameters", "variables", "output", "screen", "paywall", "instruction", "pendingRequest", "runExpiresAt", "credentialExpiresAt"]
+    static let runRequiredKeys: Set<String> = ["id", "source", "revision", "visit", "nodeId", "nodeType", "status", "stopped", "canBack", "authenticated", "locale", "answers", "parameters", "variables", "output", "screen", "paywall", "instruction", "pendingRequest", "runExpiresAt", "credentialExpiresAt"]
+    static let nodeTypes: Set<String> = ["entry", "screen", "condition", "split", "feature", "action", "external_page", "wait", "end", "offering", "coupon", "coupons", "output"]
+    static let runStatuses: Set<String> = ["running", "waiting", "completed", "closed", "ineligible", "failed"]
+    static let nonCanonicalLocaleLanguages: Set<String> = ["aam", "aar", "abk", "adp", "afr", "agp", "ais", "ajp", "ajt", "aju", "aka", "alb", "als", "amh", "ara", "arb", "arg", "arm", "asd", "asm", "aue", "ava", "ave", "aym", "ayr", "ayx", "aze", "azj", "bak", "bam", "baq", "baz", "bcc", "bcl", "bel", "ben", "bgm", "bhk", "bic", "bih", "bis", "bjd", "bjq", "bkb", "blg", "bod", "bos", "bre", "btb", "bul", "bur", "bxk", "bxr", "cat", "ccq", "ces", "cha", "che", "chi", "chu", "chv", "cjr", "cka", "cld", "cls", "cmk", "cmn", "cnr", "cor", "cos", "coy", "cqu", "cre", "cwd", "cym", "cze", "daf", "dan", "dap", "deu", "dgo", "dhd", "dik", "diq", "dit", "div", "djl", "dkl", "drh", "drr", "drw", "dud", "duj", "dut", "dwl", "dzo", "ekk", "ell", "elp", "emk", "eng", "epo", "esk", "est", "eus", "ewe", "fao", "fas", "fat", "fij", "fin", "fra", "fre", "fry", "fuc", "ful", "gav", "gaz", "gbc", "gbo", "geo", "ger", "gfx", "ggn", "ggo", "ggr", "gio", "gla", "gle", "glg", "gli", "glv", "gno", "gom", "gre", "grn", "gti", "gug", "guj", "guv", "gya", "hat", "hau", "hbs", "hdn", "hea", "heb", "her", "him", "hin", "hmo", "hrr", "hrv", "hun", "hye", "ibi", "ibo", "ice", "ido", "iii", "ike", "iku", "ile", "ill", "ilw", "in", "ina", "ind", "ipk", "isl", "ita", "iw", "izi", "jar", "jav", "jaw", "jeg", "ji", "jpn", "jw", "kal", "kan", "kas", "kat", "kau", "kaz", "kdv", "kgc", "kgd", "kgh", "kgm", "khk", "khm", "kik", "kin", "kir", "kmr", "knc", "kng", "koj", "kom", "kon", "kor", "kpp", "kpv", "krm", "ktr", "kua", "kur", "kvs", "kwq", "kxe", "kxl", "kzh", "kzj", "kzt", "lak", "lao", "lat", "lav", "lbk", "leg", "lii", "lim", "lin", "lit", "llo", "lmm", "ltz", "lub", "lug", "lvs", "mac", "mah", "mal", "mao", "mar", "may", "meg", "mgx", "mhr", "mkd", "mlg", "mlt", "mnk", "mnt", "mo", "mof", "mol", "mon", "mri", "msa", "mst", "mup", "mwd", "mwj", "mya", "myd", "myt", "nad", "nau", "nav", "nbf", "nbl", "nbx", "ncp", "nde", "ndo", "nep", "nld", "nln", "nlr", "nno", "nns", "nnx", "nob", "nom", "noo", "nor", "npi", "nts", "nxu", "nya", "oci", "ojg", "oji", "ori", "orm", "ory", "oss", "oun", "pan", "pat", "pbu", "pcr", "per", "pes", "pli", "plt", "pmc", "pmk", "pmu", "pnb", "pol", "por", "ppa", "ppr", "prp", "prs", "pry", "pus", "puz", "que", "quz", "rmr", "rmy", "roh", "ron", "rum", "run", "rus", "sag", "san", "sap", "sca", "scc", "scr", "sgl", "sh", "sin", "skk", "slk", "slo", "slv", "smd", "sme", "smo", "sna", "snb", "snd", "som", "sot", "spa", "spy", "sqi", "src", "srd", "srp", "ssw", "sul", "sum", "sun", "swa", "swc", "swe", "swh", "szd", "tah", "tam", "tat", "tdu", "tel", "tgg", "tgk", "tgl", "tha", "thc", "thw", "thx", "tib", "tid", "tie", "tir", "tkk", "tl", "tlw", "tmk", "tmp", "tne", "tnf", "ton", "tpw", "tsf", "tsn", "tso", "ttq", "tuk", "tur", "twi", "uig", "ukr", "umu", "unp", "uok", "urd", "uzb", "uzn", "ven", "vie", "vol", "wel", "wgw", "wit", "wiw", "wln", "wol", "xba", "xho", "xia", "xkh", "xpe", "xrq", "xsj", "xsl", "xss", "ybd", "ydd", "yen", "yid", "yiy", "yma", "ymt", "yor", "yos", "yuu", "zai", "zha", "zho", "zir", "zkb", "zsm", "zul", "zyb"]
+    static let nonCanonicalLocaleScripts: Set<String> = ["Qaai"]
+    static let nonCanonicalLocaleRegions: Set<String> = ["AN", "BU", "CS", "CT", "DD", "DY", "FQ", "FX", "HV", "JT", "MI", "NH", "NQ", "NT", "PC", "PU", "PZ", "QU", "RH", "SU", "TP", "UK", "VD", "WK", "YD", "YU", "ZR", "004", "008", "010", "012", "016", "020", "024", "028", "031", "032", "036", "040", "044", "048", "050", "051", "052", "056", "060", "062", "064", "068", "070", "072", "074", "076", "084", "086", "090", "092", "096", "100", "104", "108", "112", "116", "120", "124", "132", "136", "140", "144", "148", "152", "156", "158", "162", "166", "170", "172", "174", "175", "178", "180", "184", "188", "191", "192", "196", "200", "203", "204", "208", "212", "214", "218", "222", "226", "230", "231", "232", "233", "234", "238", "239", "242", "246", "248", "249", "250", "254", "258", "260", "262", "266", "268", "270", "275", "276", "278", "280", "288", "292", "296", "300", "304", "308", "312", "316", "320", "324", "328", "332", "334", "336", "340", "344", "348", "352", "356", "360", "364", "368", "372", "376", "380", "384", "388", "392", "398", "400", "404", "408", "410", "414", "417", "418", "422", "426", "428", "430", "434", "438", "440", "442", "446", "450", "454", "458", "462", "466", "470", "474", "478", "480", "484", "492", "496", "498", "499", "500", "504", "508", "512", "516", "520", "524", "528", "530", "531", "532", "533", "534", "535", "536", "540", "548", "554", "558", "562", "566", "570", "574", "578", "580", "581", "582", "583", "584", "585", "586", "591", "598", "600", "604", "608", "612", "616", "620", "624", "626", "630", "634", "638", "642", "643", "646", "652", "654", "659", "660", "662", "663", "666", "670", "674", "678", "682", "686", "688", "690", "694", "702", "703", "704", "705", "706", "710", "716", "720", "724", "728", "729", "732", "736", "740", "744", "748", "752", "756", "760", "762", "764", "768", "772", "776", "780", "784", "788", "792", "795", "796", "798", "800", "804", "807", "810", "818", "826", "830", "831", "832", "833", "834", "840", "850", "854", "858", "860", "862", "876", "882", "886", "887", "890", "891", "894", "958", "959", "960", "962", "963", "964", "965", "966", "967", "968", "969", "970", "971", "972", "973", "974", "975", "976", "977", "978", "979", "980", "981", "982", "983", "984", "985", "986", "987", "988", "989", "990", "991", "992", "993", "994", "995", "996", "997", "998", "999"]
+}

package/native-sdk/ios/HTTPTransport.swift

@@ -0,0 +1,74 @@
+import Foundation
+
+public struct IndianaConfiguration: Sendable {
+    public let baseURL: URL
+    internal var apiOrigin: String {
+        var parts = URLComponents(url: baseURL, resolvingAgainstBaseURL: true)!
+        parts.path = ""; parts.query = nil; parts.fragment = nil
+        parts.host = parts.host?.lowercased(); if parts.port == 443 { parts.port = nil }
+        return parts.string!
+    }
+    public let scope: IndianaScope
+    public let timeout: TimeInterval
+    /// Override baseURL explicitly for test services; Sandbox is a business scope, not a deployment selector.
+    public init(baseURL: URL = URL(string: "https://api.tinker.cash")!, scope: IndianaScope, timeout: TimeInterval = 15) throws {
+        guard baseURL.scheme == "https", baseURL.host != nil, baseURL.user == nil, baseURL.password == nil,
+              baseURL.query == nil, baseURL.fragment == nil, timeout > 0, timeout <= 120 else { throw IndianaClientError.invalidConfiguration }
+        self.baseURL = baseURL; self.scope = scope; self.timeout = timeout
+    }
+}
+protocol IndianaHTTP: Sendable {
+    func send(path: String, method: String, authorization: String, body: Data?) async throws -> Data
+}
+final class IndianaURLTransport: IndianaHTTP, Sendable {
+    static func requireCurrentProtocol(_ value: String?) throws {
+        guard value == IndianaProtocol.wireProtocol else { throw IndianaClientError.invalidResponse }
+    }
+    private let configuration: IndianaConfiguration
+    private let requestOrigin: URL
+    private let session: URLSession
+    // Internal test seam: the public configuration remains HTTPS-only. A wire fixture
+    // may use only a loopback HTTP origin; no public SDK caller can select it.
+    init(configuration: IndianaConfiguration, sessionConfiguration: URLSessionConfiguration = .ephemeral, loopbackFixtureOrigin: URL? = nil) {
+        self.configuration = configuration
+        if let origin = loopbackFixtureOrigin {
+            precondition(origin.scheme == "http" && origin.host == "127.0.0.1" && (origin.port ?? 0) > 1024 && origin.user == nil && origin.password == nil && origin.query == nil && origin.fragment == nil && origin.path.isEmpty)
+        }
+        self.requestOrigin = loopbackFixtureOrigin ?? configuration.baseURL
+        let config = sessionConfiguration.copy() as! URLSessionConfiguration
+        config.urlCache = nil; config.httpCookieStorage = nil; config.httpShouldSetCookies = false; config.urlCredentialStorage = nil; config.requestCachePolicy = .reloadIgnoringLocalCacheData
+        let ownedHeaders = Set(["authorization", "cookie", "x-indiana-project", "x-indiana-environment", "x-indiana-protocol", "x-indiana-sdk-version"])
+        config.httpAdditionalHeaders = config.httpAdditionalHeaders?.filter { !ownedHeaders.contains(String(describing: $0.key).lowercased()) }
+        config.timeoutIntervalForRequest = configuration.timeout; config.timeoutIntervalForResource = configuration.timeout
+        self.session = URLSession(configuration: config, delegate: NoRedirect(), delegateQueue: nil)
+    }
+    func send(path: String, method: String, authorization: String, body: Data?) async throws -> Data {
+        guard !path.contains(".."), !path.contains("?"), !path.contains("#"), !path.hasPrefix("/") else { throw IndianaClientError.invalidConfiguration }
+        var request = URLRequest(url: requestOrigin.appendingPathComponent("api/v1").appendingPathComponent(path))
+        request.httpMethod = method; request.httpBody = body
+        request.setValue("application/json", forHTTPHeaderField: "Content-Type")
+        if !authorization.isEmpty { request.setValue("Bearer \(authorization)", forHTTPHeaderField: "Authorization") }
+        request.setValue(configuration.scope.projectId.uuidString.lowercased(), forHTTPHeaderField: "X-Indiana-Project")
+        request.setValue(configuration.scope.environment.rawValue, forHTTPHeaderField: "X-Indiana-Environment")
+        request.setValue(IndianaProtocol.wireProtocol, forHTTPHeaderField: "X-Indiana-Protocol")
+        request.setValue(IndianaSDK.version, forHTTPHeaderField: "X-Indiana-SDK-Version")
+        do {
+            let (bytes, response) = try await session.bytes(for: request)
+            guard let http = response as? HTTPURLResponse, (200..<300).contains(http.statusCode) else {
+                throw IndianaClientError.requestFailed((response as? HTTPURLResponse)?.statusCode ?? 0)
+            }
+            try Self.requireCurrentProtocol(http.value(forHTTPHeaderField: "X-Indiana-Protocol"))
+            if response.expectedContentLength > 2_097_152 { throw IndianaClientError.invalidResponse }
+            var data = Data()
+            for try await byte in bytes {
+                guard data.count < 2_097_152 else { throw IndianaClientError.invalidResponse }
+                data.append(byte)
+            }
+            return data
+        } catch let error as IndianaClientError { throw error }
+        catch { throw IndianaClientError.temporaryUnavailable }
+    }
+    private final class NoRedirect: NSObject, URLSessionTaskDelegate, Sendable {
+        func urlSession(_ session: URLSession, task: URLSessionTask, willPerformHTTPRedirection response: HTTPURLResponse, newRequest request: URLRequest, completionHandler: @escaping (URLRequest?) -> Void) { completionHandler(nil) }
+    }
+}