react-native-usesense 2.1.1 → 2.3.0

package/README.md

@@ -1,9 +1,9 @@
-# UseSense React Native
+# Sense React Native
 
 React Native plugin for human presence verification. Wraps the native
-UseSense iOS and Android SDKs into a single cross-platform package.
+Sense iOS and Android SDKs into a single cross-platform package.
 
-UseSense verifies that a real human — not a bot, deepfake, or replay
+Sense verifies that a real human — not a bot, deepfake, or replay
 attack — is behind the camera during identity verification sessions.
 Three independent pillars run in parallel on every session:
 
@@ -47,22 +47,22 @@ yarn add react-native-usesense
 cd ios && pod install
 ```
 
-The native UseSense iOS SDK is installed automatically as a CocoaPod
+The native Sense iOS SDK is installed automatically as a CocoaPod
 dependency from the public CocoaPods trunk (`UseSenseSDK`, pinned to
 `~> 4.2`). Add required permissions to your `Info.plist`:
 
 ```xml
 <key>NSCameraUsageDescription</key>
-<string>UseSense needs camera access to verify your identity.</string>
+<string>Sense needs camera access to verify your identity.</string>
 
 <!-- Only if your verification flow includes audio challenges -->
 <key>NSMicrophoneUsageDescription</key>
-<string>UseSense needs microphone access for voice verification.</string>
+<string>Sense needs microphone access for voice verification.</string>
 ```
 
 ### Android setup
 
-The native UseSense Android SDK is pulled automatically from Maven
+The native Sense Android SDK is pulled automatically from Maven
 Central (`ai.usesense:sdk:4.2.1`). `mavenCentral()` is in every
 Android project by default, so no custom repository declaration is
 needed.
@@ -120,6 +120,37 @@ try {
 //    That's where you read pillar scores and make access decisions.
 ```
 
+## White-labeling (Appearance & Copy)
+
+The verification flow UI is fully customizable through two optional inputs you pass
+on a flow run: `appearance` (`FlowAppearance`) and `copy` (`FlowCopy`). Values are
+merged **SDK-init > dashboard (org settings) > built-in default**. Every field is
+optional; anything you omit keeps the Sense default.
+
+You can set this two ways: in code (below), or no-code via the dashboard's
+**Flows → Appearance** tab (saved on your org, delivered to every SDK and the hosted
+pages, no redeploy).
+
+Customizable surfaces: colors (plus dark-mode overrides), typography, shape and
+button style, logo, background, icons/illustrations, the loader, and every
+subject-facing string plus privacy copy.
+
+```typescript
+import { UseSenseFlows, FlowAppearance, FlowCopy } from 'react-native-usesense';
+
+const appearance: FlowAppearance = {
+  colors: { primary: '#E4002B' },
+  shape:  { buttonStyle: 'outline' },
+};
+const copy: FlowCopy = {
+  result: { successTitle: "You're verified" },
+};
+
+await UseSenseFlows.runFlow({ flowRunId, sdkToken, appearance, copy });
+```
+
+Full reference: [`docs/WHITE_LABEL.md` in the web SDK](https://github.com/qudusadeyemi/usesense-web-sdk/blob/main/docs/WHITE_LABEL.md).
+
 ## Configuration
 
 ```typescript

package/android/build.gradle

@@ -41,7 +41,7 @@ dependencies {
     // the iOS SDK 4.3.0 the plugin's podspec depends on). mavenCentral()
     // is already in the `repositories` block above, so no custom
     // repository declaration is needed.
-    implementation "ai.usesense:sdk:4.4.0"
+    implementation "ai.usesense:sdk:4.5.0"
 
     implementation "org.jetbrains.kotlin:kotlin-stdlib:${safeExtGet('kotlinVersion', '2.0.0')}"
 }

package/android/src/main/java/com/usesense/reactnative/UseSenseFlowsModule.kt

@@ -5,12 +5,16 @@ import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReactContextBaseJavaModule
 import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.ReadableMap
+import com.usesense.sdk.flows.FlowAppearance
+import com.usesense.sdk.flows.FlowCopy
 import com.usesense.sdk.flows.FlowError
 import com.usesense.sdk.flows.FlowOutcome
 import com.usesense.sdk.flows.FlowRunResult
 import com.usesense.sdk.flows.FlowRunState
 import com.usesense.sdk.flows.FlowsCallback
 import com.usesense.sdk.flows.UseSenseFlows
+import org.json.JSONObject
 
 /**
  * React Native bridge for the UseSense Android Flows runner.
@@ -30,7 +34,14 @@ class UseSenseFlowsModule(private val reactContext: ReactApplicationContext) :
     override fun getName(): String = "UseSenseFlowsModule"
 
     @ReactMethod
-    fun runFlow(flowRunId: String?, sdkToken: String?, apiBaseUrl: String?, promise: Promise) {
+    fun runFlow(
+        flowRunId: String?,
+        sdkToken: String?,
+        apiBaseUrl: String?,
+        appearance: ReadableMap?,
+        copy: ReadableMap?,
+        promise: Promise,
+    ) {
         if (flowRunId.isNullOrEmpty() || sdkToken.isNullOrEmpty()) {
             promise.reject("unknown", "flowRunId and sdkToken are required")
             return
@@ -41,6 +52,12 @@ class UseSenseFlowsModule(private val reactContext: ReactApplicationContext) :
         }
         val baseUrl = apiBaseUrl ?: "https://api.usesense.ai"
 
+        // White-label maps are forwarded raw from JS (camelCase, matching the
+        // web contract). Decode them via the SDK; a malformed payload degrades
+        // to null (built-in tokens) rather than failing the run.
+        val resolvedAppearance = appearance?.let { runCatching { FlowAppearance.decode(it.toJSONObject()) }.getOrNull() }
+        val resolvedCopy = copy?.let { runCatching { FlowCopy.decode(it.toJSONObject()) }.getOrNull() }
+
         val callback = object : FlowsCallback {
             override fun onResult(result: FlowRunResult) {
                 val map = Arguments.createMap().apply {
@@ -64,9 +81,18 @@ class UseSenseFlowsModule(private val reactContext: ReactApplicationContext) :
             sdkToken = sdkToken,
             callback = callback,
             apiBaseUrl = baseUrl,
+            appearance = resolvedAppearance,
+            copy = resolvedCopy,
         )
     }
 
     private fun stateWire(state: FlowRunState): String = state.wire
     private fun outcomeWire(outcome: FlowOutcome): String = outcome.wire
+
+    /**
+     * Convert a React Native [ReadableMap] to an [org.json.JSONObject] so the
+     * SDK's `decode(JSONObject)` can read it. `toHashMap()` yields nested
+     * HashMap / ArrayList values, which `JSONObject(Map)` walks recursively.
+     */
+    private fun ReadableMap.toJSONObject(): JSONObject = JSONObject(this.toHashMap() as Map<*, *>)
 }

package/ios/UseSenseFlowsModule.m

@@ -1,14 +1,18 @@
 #import <React/RCTBridgeModule.h>
 
 // Bridging header for the Flows runner module. Single JS-callable method:
-// runFlow(flowRunId, sdkToken, apiBaseUrl?). The apiBaseUrl parameter is
-// nullable from JS — pass `null` (or omit, since the JS wrapper supplies a
-// default) and the native side falls back to https://api.usesense.ai.
+// runFlow(flowRunId, sdkToken, apiBaseUrl?, appearance?, copy?). The apiBaseUrl
+// parameter is nullable from JS — pass `null` (or omit, since the JS wrapper
+// supplies a default) and the native side falls back to https://api.usesense.ai.
+// `appearance` / `copy` are nullable JS objects (the white-label contract);
+// when non-null they're decoded by FlowAppearance/FlowCopy.decodeFromJSONObject.
 @interface RCT_EXTERN_MODULE(UseSenseFlowsModule, NSObject)
 
 RCT_EXTERN_METHOD(runFlow:(NSString *)flowRunId
                   sdkToken:(NSString *)sdkToken
                   apiBaseUrl:(NSString * _Nullable)apiBaseUrl
+                  appearance:(NSDictionary * _Nullable)appearance
+                  copy:(NSDictionary * _Nullable)copy
                   resolver:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
 

package/ios/UseSenseFlowsModule.swift

@@ -23,13 +23,20 @@ class UseSenseFlowsModule: NSObject {
         return false
     }
 
-    /// `runFlow(flowRunId, sdkToken, apiBaseUrl?, resolve, reject)` — Promise.
-    /// The SDK takes care of presentation; we just resolve when the run
-    /// reaches a terminal state.
+    /// `runFlow(flowRunId, sdkToken, apiBaseUrl?, appearance?, copy?, resolve,
+    /// reject)` — Promise. The SDK takes care of presentation; we just resolve
+    /// when the run reaches a terminal state.
+    ///
+    /// `appearance` / `copy` are the optional white-label maps forwarded raw
+    /// from JS (camelCase, matching the web contract). We decode them via the
+    /// SDK's `decodeFromJSONObject`, which degrades a malformed payload to nil
+    /// (built-in tokens) rather than failing the run.
     @objc
     func runFlow(_ flowRunId: String,
                  sdkToken: String,
                  apiBaseUrl: String?,
+                 appearance: NSDictionary?,
+                 copy: NSDictionary?,
                  resolver resolve: @escaping RCTPromiseResolveBlock,
                  rejecter reject: @escaping RCTPromiseRejectBlock) {
         let baseString = apiBaseUrl ?? "https://api.usesense.ai"
@@ -37,6 +44,8 @@ class UseSenseFlowsModule: NSObject {
             reject("unknown", "Invalid apiBaseUrl: \(baseString)", nil)
             return
         }
+        let resolvedAppearance = (appearance as? [String: Any]).flatMap(FlowAppearance.decodeFromJSONObject)
+        let resolvedCopy = (copy as? [String: Any]).flatMap(FlowCopy.decodeFromJSONObject)
         DispatchQueue.main.async {
             guard let presenter = Self.topViewController() else {
                 reject("unknown", "No view controller to present from", nil)
@@ -46,6 +55,8 @@ class UseSenseFlowsModule: NSObject {
                 flowRunId: flowRunId,
                 sdkToken: sdkToken,
                 apiBaseURL: baseURL,
+                appearance: resolvedAppearance,
+                copy: resolvedCopy,
                 from: presenter
             ) { runResult in
                 switch runResult {

package/lib/commonjs/flows.js

@@ -72,6 +72,34 @@ class FlowError extends Error {
   }
 }
 
+// ─── White-label contract (mirrors the web SDK) ───────────────────────────
+//
+// FlowAppearance + FlowCopy are the shared customization schemas (Phase 1 +
+// Phase 2 of the white-label initiative). They mirror the web SDK contract
+// (packages/sdk/src/flows/theme.ts + copy.ts) one-to-one with camelCase keys.
+// The RN bridge forwards the raw object across to the native iOS/Android
+// runner, which decodes it (FlowAppearance/FlowCopy.decodeFromJSONObject).
+// Everything is optional; an omitted key falls back to the hosted-page tokens.
+
+/** A palette layer. `dark` overrides apply only in dark mode. */
+
+/** Custom illustration/icon overrides (image URLs replacing built-in glyphs). */
+
+/** Loading animation: a built-in preset or a custom asset. */
+
+/**
+ * White-label appearance overrides for the Flow runner. Supplied at SDK init
+ * (this option) and merged over the operator's server-delivered branding by
+ * the native runner. Mirrors `FlowAppearance` in the web SDK.
+ */
+
+/**
+ * White-label copy overrides for the Flow runner. Every subject-facing string
+ * can be overridden; an omitted key keeps the built-in copy. Supplied at SDK
+ * init and merged over the operator's server-delivered copy by the native
+ * runner. Mirrors `FlowCopy` in the web SDK.
+ */
+
 /** Options for `UseSenseFlows.runFlow`. */
 exports.FlowError = FlowError;
 /**
@@ -87,7 +115,7 @@ const UseSenseFlows = exports.UseSenseFlows = {
    */
   async runFlow(options) {
     try {
-      const native = await nativeModule().runFlow(options.flowRunId, options.sdkToken, options.apiBaseUrl ?? null);
+      const native = await nativeModule().runFlow(options.flowRunId, options.sdkToken, options.apiBaseUrl ?? null, options.appearance ?? null, options.copy ?? null);
       return {
         flowRunId: native.flowRunId,
         state: native.state,

package/lib/commonjs/flows.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","LINKING_ERROR","Platform","select","ios","android","default","nativeModule","m","NativeModules","UseSenseFlowsModule","Error","FLOW_ERROR_CODES","normaliseCode","code","includes","FlowError","constructor","message","name","exports","UseSenseFlows","runFlow","options","native","flowRunId","sdkToken","apiBaseUrl","state","outcome","e"],"sourceRoot":"../../src","sources":["flows.ts"],"mappings":";;;;;;AAqBA,IAAAA,YAAA,GAAAC,OAAA;AArBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,MAAMC,aAAa,GACjB,0EAA0E,GAC1EC,qBAAQ,CAACC,MAAM,CAAC;EACdC,GAAG,EAAE,yDAAyD;EAC9DC,OAAO,EAAE,wDAAwD;EACjEC,OAAO,EAAE;AACX,CAAC,CAAC;;AAEJ;AACA;AACA,SAASC,YAAYA,CAAA,EAAG;EACtB,MAAMC,CAAC,GAAGC,0BAAa,CAACC,mBAAmB;EAC3C,IAAI,CAACF,CAAC,EAAE,MAAM,IAAIG,KAAK,CAACV,aAAa,CAAC;EACtC,OAAOO,CAAC;AACV;;AAEA;AACA;AACA;AACA;;AAWA;;AAGA;AACA;AACA;AACA;;AAeA,MAAMI,gBAA0C,GAAG,CACjD,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,SAAS,CACD;AAEV,SAASC,aAAaA,CAACC,IAAa,EAAiB;EACnD,OAAO,OAAOA,IAAI,KAAK,QAAQ,IAAKF,gBAAgB,CAAuBG,QAAQ,CAACD,IAAI,CAAC,GACpFA,IAAI,GACL,SAAS;AACf;;AAEA;;AAaA;AACA;AACA;AACA;AACA;AACO,MAAME,SAAS,SAASL,KAAK,CAAC;EAEnCM,WAAWA,CAACH,IAAmB,EAAEI,OAAe,EAAE;IAChD,KAAK,CAACA,OAAO,CAAC;IACd,IAAI,CAACC,IAAI,GAAG,WAAW;IACvB,IAAI,CAACL,IAAI,GAAGA,IAAI;EAClB;AACF;;AAEA;AAAAM,OAAA,CAAAJ,SAAA,GAAAA,SAAA;AAQA;AACA;AACA;AACA;AACO,MAAMK,aAAa,GAAAD,OAAA,CAAAC,aAAA,GAAG;EAC3B;AACF;AACA;AACA;AACA;AACA;EACE,MAAMC,OAAOA,CAACC,OAAuB,EAA0B;IAC7D,IAAI;MACF,MAAMC,MAAM,GAAG,MAAMjB,YAAY,CAAC,CAAC,CAACe,OAAO,CACzCC,OAAO,CAACE,SAAS,EACjBF,OAAO,CAACG,QAAQ,EAChBH,OAAO,CAACI,UAAU,IAAI,IACxB,CAAC;MACD,OAAO;QACLF,SAAS,EAAED,MAAM,CAACC,SAAS;QAC3BG,KAAK,EAAEJ,MAAM,CAACI,KAAK;QACnBC,OAAO,EAAEL,MAAM,CAACK;MAClB,CAAC;IACH,CAAC,CAAC,OAAOC,CAAC,EAAE;MACV;MACA;MACA,MAAMhB,IAAI,GAAGD,aAAa,CAAEiB,CAAC,CAAuBhB,IAAI,CAAC;MACzD,MAAMI,OAAO,GAAIY,CAAC,CAA0BZ,OAAO,IAAI,aAAa;MACpE,MAAM,IAAIF,SAAS,CAACF,IAAI,EAAEI,OAAO,CAAC;IACpC;EACF;AACF,CAAC","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","LINKING_ERROR","Platform","select","ios","android","default","nativeModule","m","NativeModules","UseSenseFlowsModule","Error","FLOW_ERROR_CODES","normaliseCode","code","includes","FlowError","constructor","message","name","exports","UseSenseFlows","runFlow","options","native","flowRunId","sdkToken","apiBaseUrl","appearance","copy","state","outcome","e"],"sourceRoot":"../../src","sources":["flows.ts"],"mappings":";;;;;;AAqBA,IAAAA,YAAA,GAAAC,OAAA;AArBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,MAAMC,aAAa,GACjB,0EAA0E,GAC1EC,qBAAQ,CAACC,MAAM,CAAC;EACdC,GAAG,EAAE,yDAAyD;EAC9DC,OAAO,EAAE,wDAAwD;EACjEC,OAAO,EAAE;AACX,CAAC,CAAC;;AAEJ;AACA;AACA,SAASC,YAAYA,CAAA,EAAG;EACtB,MAAMC,CAAC,GAAGC,0BAAa,CAACC,mBAAmB;EAC3C,IAAI,CAACF,CAAC,EAAE,MAAM,IAAIG,KAAK,CAACV,aAAa,CAAC;EACtC,OAAOO,CAAC;AASV;;AAEA;AACA;AACA;AACA;;AAWA;;AAGA;AACA;AACA;AACA;;AAeA,MAAMI,gBAA0C,GAAG,CACjD,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,SAAS,CACD;AAEV,SAASC,aAAaA,CAACC,IAAa,EAAiB;EACnD,OAAO,OAAOA,IAAI,KAAK,QAAQ,IAAKF,gBAAgB,CAAuBG,QAAQ,CAACD,IAAI,CAAC,GACpFA,IAAI,GACL,SAAS;AACf;;AAEA;;AAaA;AACA;AACA;AACA;AACA;AACO,MAAME,SAAS,SAASL,KAAK,CAAC;EAEnCM,WAAWA,CAACH,IAAmB,EAAEI,OAAe,EAAE;IAChD,KAAK,CAACA,OAAO,CAAC;IACd,IAAI,CAACC,IAAI,GAAG,WAAW;IACvB,IAAI,CAACL,IAAI,GAAGA,IAAI;EAClB;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAkCA;;AASA;;AAQA;AACA;AACA;AACA;AACA;;AAeA;AACA;AACA;AACA;AACA;AACA;;AA8CA;AAAAM,OAAA,CAAAJ,SAAA,GAAAA,SAAA;AAoBA;AACA;AACA;AACA;AACO,MAAMK,aAAa,GAAAD,OAAA,CAAAC,aAAA,GAAG;EAC3B;AACF;AACA;AACA;AACA;AACA;EACE,MAAMC,OAAOA,CAACC,OAAuB,EAA0B;IAC7D,IAAI;MACF,MAAMC,MAAM,GAAG,MAAMjB,YAAY,CAAC,CAAC,CAACe,OAAO,CACzCC,OAAO,CAACE,SAAS,EACjBF,OAAO,CAACG,QAAQ,EAChBH,OAAO,CAACI,UAAU,IAAI,IAAI,EAC1BJ,OAAO,CAACK,UAAU,IAAI,IAAI,EAC1BL,OAAO,CAACM,IAAI,IAAI,IAClB,CAAC;MACD,OAAO;QACLJ,SAAS,EAAED,MAAM,CAACC,SAAS;QAC3BK,KAAK,EAAEN,MAAM,CAACM,KAAK;QACnBC,OAAO,EAAEP,MAAM,CAACO;MAClB,CAAC;IACH,CAAC,CAAC,OAAOC,CAAC,EAAE;MACV;MACA;MACA,MAAMlB,IAAI,GAAGD,aAAa,CAAEmB,CAAC,CAAuBlB,IAAI,CAAC;MACzD,MAAMI,OAAO,GAAIc,CAAC,CAA0Bd,OAAO,IAAI,aAAa;MACpE,MAAM,IAAIF,SAAS,CAACF,IAAI,EAAEI,OAAO,CAAC;IACpC;EACF;AACF,CAAC","ignoreList":[]}

package/lib/module/flows.js

@@ -66,6 +66,34 @@ export class FlowError extends Error {
   }
 }
 
+// ─── White-label contract (mirrors the web SDK) ───────────────────────────
+//
+// FlowAppearance + FlowCopy are the shared customization schemas (Phase 1 +
+// Phase 2 of the white-label initiative). They mirror the web SDK contract
+// (packages/sdk/src/flows/theme.ts + copy.ts) one-to-one with camelCase keys.
+// The RN bridge forwards the raw object across to the native iOS/Android
+// runner, which decodes it (FlowAppearance/FlowCopy.decodeFromJSONObject).
+// Everything is optional; an omitted key falls back to the hosted-page tokens.
+
+/** A palette layer. `dark` overrides apply only in dark mode. */
+
+/** Custom illustration/icon overrides (image URLs replacing built-in glyphs). */
+
+/** Loading animation: a built-in preset or a custom asset. */
+
+/**
+ * White-label appearance overrides for the Flow runner. Supplied at SDK init
+ * (this option) and merged over the operator's server-delivered branding by
+ * the native runner. Mirrors `FlowAppearance` in the web SDK.
+ */
+
+/**
+ * White-label copy overrides for the Flow runner. Every subject-facing string
+ * can be overridden; an omitted key keeps the built-in copy. Supplied at SDK
+ * init and merged over the operator's server-delivered copy by the native
+ * runner. Mirrors `FlowCopy` in the web SDK.
+ */
+
 /** Options for `UseSenseFlows.runFlow`. */
 
 /**
@@ -81,7 +109,7 @@ export const UseSenseFlows = {
    */
   async runFlow(options) {
     try {
-      const native = await nativeModule().runFlow(options.flowRunId, options.sdkToken, options.apiBaseUrl ?? null);
+      const native = await nativeModule().runFlow(options.flowRunId, options.sdkToken, options.apiBaseUrl ?? null, options.appearance ?? null, options.copy ?? null);
       return {
         flowRunId: native.flowRunId,
         state: native.state,

package/lib/module/flows.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeModules","Platform","LINKING_ERROR","select","ios","android","default","nativeModule","m","UseSenseFlowsModule","Error","FLOW_ERROR_CODES","normaliseCode","code","includes","FlowError","constructor","message","name","UseSenseFlows","runFlow","options","native","flowRunId","sdkToken","apiBaseUrl","state","outcome","e"],"sourceRoot":"../../src","sources":["flows.ts"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,aAAa,EAAEC,QAAQ,QAAQ,cAAc;AAEtD,MAAMC,aAAa,GACjB,0EAA0E,GAC1ED,QAAQ,CAACE,MAAM,CAAC;EACdC,GAAG,EAAE,yDAAyD;EAC9DC,OAAO,EAAE,wDAAwD;EACjEC,OAAO,EAAE;AACX,CAAC,CAAC;;AAEJ;AACA;AACA,SAASC,YAAYA,CAAA,EAAG;EACtB,MAAMC,CAAC,GAAGR,aAAa,CAACS,mBAAmB;EAC3C,IAAI,CAACD,CAAC,EAAE,MAAM,IAAIE,KAAK,CAACR,aAAa,CAAC;EACtC,OAAOM,CAAC;AACV;;AAEA;AACA;AACA;AACA;;AAWA;;AAGA;AACA;AACA;AACA;;AAeA,MAAMG,gBAA0C,GAAG,CACjD,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,SAAS,CACD;AAEV,SAASC,aAAaA,CAACC,IAAa,EAAiB;EACnD,OAAO,OAAOA,IAAI,KAAK,QAAQ,IAAKF,gBAAgB,CAAuBG,QAAQ,CAACD,IAAI,CAAC,GACpFA,IAAI,GACL,SAAS;AACf;;AAEA;;AAaA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,SAAS,SAASL,KAAK,CAAC;EAEnCM,WAAWA,CAACH,IAAmB,EAAEI,OAAe,EAAE;IAChD,KAAK,CAACA,OAAO,CAAC;IACd,IAAI,CAACC,IAAI,GAAG,WAAW;IACvB,IAAI,CAACL,IAAI,GAAGA,IAAI;EAClB;AACF;;AAEA;;AAQA;AACA;AACA;AACA;AACA,OAAO,MAAMM,aAAa,GAAG;EAC3B;AACF;AACA;AACA;AACA;AACA;EACE,MAAMC,OAAOA,CAACC,OAAuB,EAA0B;IAC7D,IAAI;MACF,MAAMC,MAAM,GAAG,MAAMf,YAAY,CAAC,CAAC,CAACa,OAAO,CACzCC,OAAO,CAACE,SAAS,EACjBF,OAAO,CAACG,QAAQ,EAChBH,OAAO,CAACI,UAAU,IAAI,IACxB,CAAC;MACD,OAAO;QACLF,SAAS,EAAED,MAAM,CAACC,SAAS;QAC3BG,KAAK,EAAEJ,MAAM,CAACI,KAAK;QACnBC,OAAO,EAAEL,MAAM,CAACK;MAClB,CAAC;IACH,CAAC,CAAC,OAAOC,CAAC,EAAE;MACV;MACA;MACA,MAAMf,IAAI,GAAGD,aAAa,CAAEgB,CAAC,CAAuBf,IAAI,CAAC;MACzD,MAAMI,OAAO,GAAIW,CAAC,CAA0BX,OAAO,IAAI,aAAa;MACpE,MAAM,IAAIF,SAAS,CAACF,IAAI,EAAEI,OAAO,CAAC;IACpC;EACF;AACF,CAAC","ignoreList":[]}
+{"version":3,"names":["NativeModules","Platform","LINKING_ERROR","select","ios","android","default","nativeModule","m","UseSenseFlowsModule","Error","FLOW_ERROR_CODES","normaliseCode","code","includes","FlowError","constructor","message","name","UseSenseFlows","runFlow","options","native","flowRunId","sdkToken","apiBaseUrl","appearance","copy","state","outcome","e"],"sourceRoot":"../../src","sources":["flows.ts"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,aAAa,EAAEC,QAAQ,QAAQ,cAAc;AAEtD,MAAMC,aAAa,GACjB,0EAA0E,GAC1ED,QAAQ,CAACE,MAAM,CAAC;EACdC,GAAG,EAAE,yDAAyD;EAC9DC,OAAO,EAAE,wDAAwD;EACjEC,OAAO,EAAE;AACX,CAAC,CAAC;;AAEJ;AACA;AACA,SAASC,YAAYA,CAAA,EAAG;EACtB,MAAMC,CAAC,GAAGR,aAAa,CAACS,mBAAmB;EAC3C,IAAI,CAACD,CAAC,EAAE,MAAM,IAAIE,KAAK,CAACR,aAAa,CAAC;EACtC,OAAOM,CAAC;AASV;;AAEA;AACA;AACA;AACA;;AAWA;;AAGA;AACA;AACA;AACA;;AAeA,MAAMG,gBAA0C,GAAG,CACjD,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,SAAS,CACD;AAEV,SAASC,aAAaA,CAACC,IAAa,EAAiB;EACnD,OAAO,OAAOA,IAAI,KAAK,QAAQ,IAAKF,gBAAgB,CAAuBG,QAAQ,CAACD,IAAI,CAAC,GACpFA,IAAI,GACL,SAAS;AACf;;AAEA;;AAaA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,SAAS,SAASL,KAAK,CAAC;EAEnCM,WAAWA,CAACH,IAAmB,EAAEI,OAAe,EAAE;IAChD,KAAK,CAACA,OAAO,CAAC;IACd,IAAI,CAACC,IAAI,GAAG,WAAW;IACvB,IAAI,CAACL,IAAI,GAAGA,IAAI;EAClB;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAkCA;;AASA;;AAQA;AACA;AACA;AACA;AACA;;AAeA;AACA;AACA;AACA;AACA;AACA;;AA8CA;;AAoBA;AACA;AACA;AACA;AACA,OAAO,MAAMM,aAAa,GAAG;EAC3B;AACF;AACA;AACA;AACA;AACA;EACE,MAAMC,OAAOA,CAACC,OAAuB,EAA0B;IAC7D,IAAI;MACF,MAAMC,MAAM,GAAG,MAAMf,YAAY,CAAC,CAAC,CAACa,OAAO,CACzCC,OAAO,CAACE,SAAS,EACjBF,OAAO,CAACG,QAAQ,EAChBH,OAAO,CAACI,UAAU,IAAI,IAAI,EAC1BJ,OAAO,CAACK,UAAU,IAAI,IAAI,EAC1BL,OAAO,CAACM,IAAI,IAAI,IAClB,CAAC;MACD,OAAO;QACLJ,SAAS,EAAED,MAAM,CAACC,SAAS;QAC3BK,KAAK,EAAEN,MAAM,CAACM,KAAK;QACnBC,OAAO,EAAEP,MAAM,CAACO;MAClB,CAAC;IACH,CAAC,CAAC,OAAOC,CAAC,EAAE;MACV;MACA;MACA,MAAMjB,IAAI,GAAGD,aAAa,CAAEkB,CAAC,CAAuBjB,IAAI,CAAC;MACzD,MAAMI,OAAO,GAAIa,CAAC,CAA0Bb,OAAO,IAAI,aAAa;MACpE,MAAM,IAAIF,SAAS,CAACF,IAAI,EAAEI,OAAO,CAAC;IACpC;EACF;AACF,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -231,5 +231,9 @@ export default UseSense;
 
 // Slice 5d: Flows. A parallel surface to Sessions — host apps choose one
 // per call. See guides/flows/sessions-vs-flows in the API docs.
-export { UseSenseFlows, FlowError } from './flows';
+export { UseSenseFlows, FlowError
+
+// White-label contract (Phase 1 appearance + Phase 2 copy). Forwarded to the
+// native runner via the bridge.
+} from './flows';
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeModules","NativeEventEmitter","Platform","LINKING_ERROR","select","ios","android","default","UseSenseModule","Error","eventEmitter","UseSense","initialize","config","apiKey","err","code","message","isRetryable","environment","apiEndpoint","branding","antispoofOnDeviceEnabled","liveSenseV4Enabled","startVerification","request","sessionType","externalUserId","identityId","metadata","addListener","callback","subscription","raw","remove","reset","isInitialized","startV4Verification","sessionId","sessionToken","nonce","apiBaseUrl","displayName","brandPrimaryColor","UseSenseFlows","FlowError"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["NativeModules","NativeEventEmitter","Platform","LINKING_ERROR","select","ios","android","default","UseSenseModule","Error","eventEmitter","UseSense","initialize","config","apiKey","err","code","message","isRetryable","environment","apiEndpoint","branding","antispoofOnDeviceEnabled","liveSenseV4Enabled","startVerification","request","sessionType","externalUserId","identityId","metadata","addListener","callback","subscription","raw","remove","reset","isInitialized","startV4Verification","sessionId","sessionToken","nonce","apiBaseUrl","displayName","brandPrimaryColor","UseSenseFlows","FlowError"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/src/flows.d.ts

@@ -49,12 +49,178 @@ export declare class FlowError extends Error {
     readonly code: FlowErrorCode;
     constructor(code: FlowErrorCode, message: string);
 }
+/** A palette layer. `dark` overrides apply only in dark mode. */
+export interface AppearanceColors {
+    primary?: string;
+    primaryForeground?: string;
+    background?: string;
+    surface?: string;
+    foreground?: string;
+    muted?: string;
+    border?: string;
+    success?: string;
+    error?: string;
+    warning?: string;
+    /** Overrides applied on top of the dark base (e.g. a darker background). */
+    dark?: Omit<AppearanceColors, 'dark'>;
+}
+export interface AppearanceTypography {
+    /** Body font-family name (e.g. "DM Sans"). */
+    fontFamily?: string;
+    /** Heading/display font-family; defaults to fontFamily when omitted. */
+    displayFamily?: string;
+    /** A stylesheet URL or @font-face block to load custom fonts (web only;
+     *  ignored by the native runners, which load fonts from app resources). */
+    fontCss?: string;
+}
+export interface AppearanceShape {
+    /** Base corner radius (cards, inputs). */
+    radius?: number;
+    /** Button corner radius; defaults to radius. */
+    buttonRadius?: number;
+    buttonStyle?: 'filled' | 'outline';
+}
+/** Custom illustration/icon overrides (image URLs replacing built-in glyphs). */
+export interface AppearanceIcons {
+    /** Success result screen. */ success?: string;
+    /** Under-review result screen. */ review?: string;
+    /** Not-verified result screen. */ notVerified?: string;
+    /** Any other named slot by URL. */
+    [slot: string]: string | undefined;
+}
+/** Loading animation: a built-in preset or a custom asset. */
+export interface AppearanceLoader {
+    /** Built-in preset. Default 'spinner'. */
+    style?: 'spinner' | 'dots' | 'bar';
+    /** Custom loader asset URL; overrides style. */
+    imageUrl?: string;
+}
+/**
+ * White-label appearance overrides for the Flow runner. Supplied at SDK init
+ * (this option) and merged over the operator's server-delivered branding by
+ * the native runner. Mirrors `FlowAppearance` in the web SDK.
+ */
+export interface FlowAppearance {
+    colors?: AppearanceColors;
+    typography?: AppearanceTypography;
+    shape?: AppearanceShape;
+    logo?: {
+        url?: string;
+        placement?: 'header' | 'center' | 'none';
+        height?: number;
+    };
+    background?: {
+        color?: string;
+        imageUrl?: string;
+    };
+    /** Custom illustrations for result screens / icon slots. */
+    icons?: AppearanceIcons;
+    /** Loading-animation preset or custom asset. */
+    loader?: AppearanceLoader;
+    /** Force a palette or follow the OS (default 'auto'). */
+    mode?: 'light' | 'dark' | 'auto';
+}
+/**
+ * White-label copy overrides for the Flow runner. Every subject-facing string
+ * can be overridden; an omitted key keeps the built-in copy. Supplied at SDK
+ * init and merged over the operator's server-delivered copy by the native
+ * runner. Mirrors `FlowCopy` in the web SDK.
+ */
+export interface FlowCopy {
+    /** Optional welcome/intro shown before the first step (when set). */
+    welcome?: {
+        title?: string;
+        body?: string;
+    };
+    /** Shared button labels. */
+    buttons?: {
+        continue?: string;
+        cancel?: string;
+        tryAgain?: string;
+        retake?: string;
+        useThisPhoto?: string;
+        uploadInstead?: string;
+        scan?: string;
+        upload?: string;
+        submitting?: string;
+    };
+    /** Titles shown under the loader for each transient state. */
+    loading?: {
+        default?: string;
+        verifying?: string;
+        submittingDocument?: string;
+        checkingQuality?: string;
+    };
+    /** Face capture primer. */
+    face?: {
+        title?: string;
+        body?: string;
+        start?: string;
+    };
+    /** Document capture surfaces. */
+    document?: {
+        selectTitle?: string;
+        selectBody?: string;
+        primerTitle?: string;
+        primerBody?: string;
+        uploadTitle?: string;
+        uploadBody?: string;
+        scanTitle?: string;
+        scanBody?: string;
+        confirmTitle?: string;
+        confirmBody?: string;
+    };
+    /** Form + ID-number surfaces. */
+    form?: {
+        title?: string;
+    };
+    idNumber?: {
+        title?: string;
+        body?: string;
+    };
+    /** Terminal result screens. */
+    result?: {
+        successTitle?: string;
+        successBody?: string;
+        reviewTitle?: string;
+        reviewBody?: string;
+        notVerifiedTitle?: string;
+        notVerifiedBody?: string;
+        cancelledTitle?: string;
+    };
+    /** Error copy (provider failure vs unreadable capture vs generic). */
+    errors?: {
+        generic?: string;
+        providerUnavailable?: string;
+        documentUnreadable?: string;
+    };
+    /** Privacy / consent disclosures shown to the subject. */
+    privacy?: {
+        disclosure?: string;
+        consentTitle?: string;
+        consentBody?: string;
+    };
+    /** Free-form help text / tooltips keyed by an SDK-defined slot id. */
+    help?: Record<string, string>;
+}
 /** Options for `UseSenseFlows.runFlow`. */
 export interface RunFlowOptions {
     flowRunId: string;
     sdkToken: string;
     /** Defaults to `https://api.usesense.ai`. */
     apiBaseUrl?: string;
+    /**
+     * SDK-init white-label appearance. Forwarded to the native runner, which
+     * decodes it and merges it over the operator's server-delivered branding
+     * (SDK-init takes precedence). Omit to use the hosted-page tokens.
+     */
+    appearance?: FlowAppearance;
+    /**
+     * SDK-init white-label copy. Forwarded to the native runner, which decodes
+     * it and merges it over the operator's server-delivered copy (SDK-init takes
+     * precedence). Omit to keep the built-in subject-facing strings.
+     */
+    copy?: FlowCopy;
 }
 /**
  * Public entry point for the Flows runner. Sessions APIs are untouched;

package/lib/typescript/src/flows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../../../src/flows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAoBH;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,aAAa,GACb,SAAS,GACT,iBAAiB,GACjB,WAAW,GACX,SAAS,GACT,WAAW,GACX,WAAW,CAAC;AAEhB,sCAAsC;AACtC,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,eAAe,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB,eAAe,GACf,eAAe,GACf,qBAAqB,GACrB,mBAAmB,GACnB,sBAAsB,GACtB,WAAW,GACX,oBAAoB;AACtB;;4EAE4E;GAC1E,eAAe,GACf,SAAS,CAAC;AAoBd,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AAQD;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;gBACjB,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM;CAKjD;AAED,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa;IACxB;;;;;OAKG;qBACoB,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAoB/D,CAAC"}
+{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../../../src/flows.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/index.d.ts

@@ -264,5 +264,5 @@ export interface V4Verdict {
     timestamp: string;
 }
 export default UseSense;
-export { UseSenseFlows, FlowError, type FlowErrorCode, type FlowOutcome, type FlowRunResult, type FlowRunState, type RunFlowOptions, } from './flows';
+export { UseSenseFlows, FlowError, type FlowErrorCode, type FlowOutcome, type FlowRunResult, type FlowRunState, type RunFlowOptions, type FlowAppearance, type FlowCopy, type AppearanceColors, type AppearanceTypography, type AppearanceShape, type AppearanceIcons, type AppearanceLoader, } from './flows';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-usesense",
-  "version": "2.1.1",
+  "version": "2.3.0",
   "description": "React Native plugin for human presence verification. Wraps the native UseSense iOS and Android SDKs.",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",

package/react-native-usesense.podspec

@@ -26,5 +26,5 @@ Pod::Spec.new do |s|
   # redaction result type with a completely different UseSenseConfig
   # init signature. See CHANGELOG [2.0.0] for the full rewrite
   # rationale.
-  s.dependency "UseSenseSDK", "~> 4.4"
+  s.dependency "UseSenseSDK", "~> 4.5"
 end

package/src/flows.ts

@@ -34,7 +34,15 @@ const LINKING_ERROR =
 function nativeModule() {
   const m = NativeModules.UseSenseFlowsModule;
   if (!m) throw new Error(LINKING_ERROR);
-  return m as { runFlow: (flowRunId: string, sdkToken: string, apiBaseUrl: string | null) => Promise<NativeFlowRunResult> };
+  return m as {
+    runFlow: (
+      flowRunId: string,
+      sdkToken: string,
+      apiBaseUrl: string | null,
+      appearance: FlowAppearance | null,
+      copy: FlowCopy | null,
+    ) => Promise<NativeFlowRunResult>;
+  };
 }
 
 /**
@@ -117,12 +125,154 @@ export class FlowError extends Error {
   }
 }
 
+// ─── White-label contract (mirrors the web SDK) ───────────────────────────
+//
+// FlowAppearance + FlowCopy are the shared customization schemas (Phase 1 +
+// Phase 2 of the white-label initiative). They mirror the web SDK contract
+// (packages/sdk/src/flows/theme.ts + copy.ts) one-to-one with camelCase keys.
+// The RN bridge forwards the raw object across to the native iOS/Android
+// runner, which decodes it (FlowAppearance/FlowCopy.decodeFromJSONObject).
+// Everything is optional; an omitted key falls back to the hosted-page tokens.
+
+/** A palette layer. `dark` overrides apply only in dark mode. */
+export interface AppearanceColors {
+  primary?: string;
+  primaryForeground?: string;
+  background?: string;
+  surface?: string;
+  foreground?: string;
+  muted?: string;
+  border?: string;
+  success?: string;
+  error?: string;
+  warning?: string;
+  /** Overrides applied on top of the dark base (e.g. a darker background). */
+  dark?: Omit<AppearanceColors, 'dark'>;
+}
+
+export interface AppearanceTypography {
+  /** Body font-family name (e.g. "DM Sans"). */
+  fontFamily?: string;
+  /** Heading/display font-family; defaults to fontFamily when omitted. */
+  displayFamily?: string;
+  /** A stylesheet URL or @font-face block to load custom fonts (web only;
+   *  ignored by the native runners, which load fonts from app resources). */
+  fontCss?: string;
+}
+
+export interface AppearanceShape {
+  /** Base corner radius (cards, inputs). */
+  radius?: number;
+  /** Button corner radius; defaults to radius. */
+  buttonRadius?: number;
+  buttonStyle?: 'filled' | 'outline';
+}
+
+/** Custom illustration/icon overrides (image URLs replacing built-in glyphs). */
+export interface AppearanceIcons {
+  /** Success result screen. */ success?: string;
+  /** Under-review result screen. */ review?: string;
+  /** Not-verified result screen. */ notVerified?: string;
+  /** Any other named slot by URL. */
+  [slot: string]: string | undefined;
+}
+
+/** Loading animation: a built-in preset or a custom asset. */
+export interface AppearanceLoader {
+  /** Built-in preset. Default 'spinner'. */
+  style?: 'spinner' | 'dots' | 'bar';
+  /** Custom loader asset URL; overrides style. */
+  imageUrl?: string;
+}
+
+/**
+ * White-label appearance overrides for the Flow runner. Supplied at SDK init
+ * (this option) and merged over the operator's server-delivered branding by
+ * the native runner. Mirrors `FlowAppearance` in the web SDK.
+ */
+export interface FlowAppearance {
+  colors?: AppearanceColors;
+  typography?: AppearanceTypography;
+  shape?: AppearanceShape;
+  logo?: { url?: string; placement?: 'header' | 'center' | 'none'; height?: number };
+  background?: { color?: string; imageUrl?: string };
+  /** Custom illustrations for result screens / icon slots. */
+  icons?: AppearanceIcons;
+  /** Loading-animation preset or custom asset. */
+  loader?: AppearanceLoader;
+  /** Force a palette or follow the OS (default 'auto'). */
+  mode?: 'light' | 'dark' | 'auto';
+}
+
+/**
+ * White-label copy overrides for the Flow runner. Every subject-facing string
+ * can be overridden; an omitted key keeps the built-in copy. Supplied at SDK
+ * init and merged over the operator's server-delivered copy by the native
+ * runner. Mirrors `FlowCopy` in the web SDK.
+ */
+export interface FlowCopy {
+  /** Optional welcome/intro shown before the first step (when set). */
+  welcome?: { title?: string; body?: string };
+  /** Shared button labels. */
+  buttons?: {
+    continue?: string;
+    cancel?: string;
+    tryAgain?: string;
+    retake?: string;
+    useThisPhoto?: string;
+    uploadInstead?: string;
+    scan?: string;
+    upload?: string;
+    submitting?: string;
+  };
+  /** Titles shown under the loader for each transient state. */
+  loading?: { default?: string; verifying?: string; submittingDocument?: string; checkingQuality?: string };
+  /** Face capture primer. */
+  face?: { title?: string; body?: string; start?: string };
+  /** Document capture surfaces. */
+  document?: {
+    selectTitle?: string; selectBody?: string;
+    primerTitle?: string; primerBody?: string;
+    uploadTitle?: string; uploadBody?: string;
+    scanTitle?: string; scanBody?: string;
+    confirmTitle?: string; confirmBody?: string;
+  };
+  /** Form + ID-number surfaces. */
+  form?: { title?: string };
+  idNumber?: { title?: string; body?: string };
+  /** Terminal result screens. */
+  result?: {
+    successTitle?: string; successBody?: string;
+    reviewTitle?: string; reviewBody?: string;
+    notVerifiedTitle?: string; notVerifiedBody?: string;
+    cancelledTitle?: string;
+  };
+  /** Error copy (provider failure vs unreadable capture vs generic). */
+  errors?: { generic?: string; providerUnavailable?: string; documentUnreadable?: string };
+  /** Privacy / consent disclosures shown to the subject. */
+  privacy?: { disclosure?: string; consentTitle?: string; consentBody?: string };
+  /** Free-form help text / tooltips keyed by an SDK-defined slot id. */
+  help?: Record<string, string>;
+}
+
 /** Options for `UseSenseFlows.runFlow`. */
 export interface RunFlowOptions {
   flowRunId: string;
   sdkToken: string;
   /** Defaults to `https://api.usesense.ai`. */
   apiBaseUrl?: string;
+  /**
+   * SDK-init white-label appearance. Forwarded to the native runner, which
+   * decodes it and merges it over the operator's server-delivered branding
+   * (SDK-init takes precedence). Omit to use the hosted-page tokens.
+   */
+  appearance?: FlowAppearance;
+  /**
+   * SDK-init white-label copy. Forwarded to the native runner, which decodes
+   * it and merges it over the operator's server-delivered copy (SDK-init takes
+   * precedence). Omit to keep the built-in subject-facing strings.
+   */
+  copy?: FlowCopy;
 }
 
 /**
@@ -142,6 +292,8 @@ export const UseSenseFlows = {
         options.flowRunId,
         options.sdkToken,
         options.apiBaseUrl ?? null,
+        options.appearance ?? null,
+        options.copy ?? null,
       );
       return {
         flowRunId: native.flowRunId,

package/src/index.ts

@@ -402,4 +402,13 @@ export {
   type FlowRunResult,
   type FlowRunState,
   type RunFlowOptions,
+  // White-label contract (Phase 1 appearance + Phase 2 copy). Forwarded to the
+  // native runner via the bridge.
+  type FlowAppearance,
+  type FlowCopy,
+  type AppearanceColors,
+  type AppearanceTypography,
+  type AppearanceShape,
+  type AppearanceIcons,
+  type AppearanceLoader,
 } from './flows';