@scribeup/react-native-scribeup 0.6.0 → 0.6.2

package/README.md

@@ -15,11 +15,13 @@ The package is a thin wrapper around the native [iOS](https://github.com/ScribeU
    1. [ScribeUp (Full Screen)](#scribeup-full-screen)
    2. [ScribeUpWidget (Embeddable)](#scribeupwidget-embeddable)
 4. [API Reference](#api-reference)
-5. [Example Projects](#example-projects)
-6. [Troubleshooting](#troubleshooting)
-7. [Author](#author)
-8. [License](#license)
+5. [Migration Note (0.3.x → 0.6.0)](#migration-note-03x--060)
+6. [Example Projects](#example-projects)
+7. [Troubleshooting](#troubleshooting)
+8. [Author](#author)
+9. [License](#license)
 
+---
 
 ## Installation
 
@@ -56,11 +58,15 @@ export default function App() {
 
   const authenticatedUrl = "https://example.com/subscriptions?token=YOUR_JWT"; // Obtain from your backend (see docs)
 
-  const handleExit = (data?: { message?: string; code?: number }) => {
-    console.log("ScribeUp finished", data);
+  const handleExit = (error: { code?: number; message?: string } | null, data: Record<string, any> | null) => {
+    console.log("ScribeUp exited", { error, data });
     setVisible(false);
   };
 
+  const handleEvent = (data: Record<string, any>) => {
+    console.log("ScribeUp event", data);
+  };
+
   return (
     <SafeAreaView style={{ flex: 1, justifyContent: "center", alignItems: "center" }}>
       <Button title="Manage my subscriptions" onPress={() => setVisible(true)} />
@@ -71,6 +77,7 @@ export default function App() {
           url={authenticatedUrl}
           productName="Subscription Manager" // optional text in the nav-bar
           onExit={handleExit} // called on success or error
+          onEvent={handleEvent}
         />
       )}
     </SafeAreaView>
@@ -130,14 +137,25 @@ export default function MyComponent() {
 
 ### ScribeUp (Full Screen)
 
-```
+```tsx
 <ScribeUp
-  url: string;              // required – authenticated manage-subscriptions URL
-  productName?: string;     // optional – title shown in the navigation bar
-  onExit?: (data?) => void; // optional – called when the user exits, with optional error
-/>
+  url: string;                              // required – authenticated manage-subscriptions URL
+  productName?: string;                     // optional – title in navigation bar
+  onExit?: (error: ExitError|null, data: object|null) => void;
+  onEvent?: (data: object) => void;
+>
 ```
 
+**`onExit`**
+Called when the user exits the flow.
+Receives two arguments:
+- `error`: `{ code: number; message?: string }` or `null` on success
+- `data`: structured object with optional payload
+
+**`onEvent`**
+Emitted zero or more times during the session to notify about intermediate states or actions (e.g., UI transitions, user actions).
+
+
 ### ScribeUpWidget (Embeddable)
 
 ```
@@ -152,14 +170,12 @@ export default function MyComponent() {
 - `reload()` – reloads the current page
 - `loadURL(url: string)` – loads a new URL
 
-### Exit Callback
-
-`onExit` receives an object with two optional fields:
+---
 
-* `message` – descriptive error or informational message.
-* `code` – numeric error code (0 on success, -1 on unknown error).
+## Migration Note (0.3.x → 0.6.0)
 
-If both fields are undefined, the flow completed without errors.
+- `onExit` now receives **two parameters**: `(error, data)` instead of a single `data` object.
+- New `onEvent(data)` listener added for real-time progress updates.
 
 ---
 

package/android/src/main/java/com/rnscribeupsdk/ScribeupModule.kt

@@ -41,7 +41,7 @@ class ScribeupModule(reactContext: ReactApplicationContext) :
         if (error != null) {
           val params = Arguments.createMap()
           params.putString("message", error.message)
-          params.putString("code", error.code.toString())
+          params.putInt("code", error.code)
           currentPromise?.resolve(params)
         } else {
           currentPromise?.resolve(null)
@@ -50,8 +50,8 @@ class ScribeupModule(reactContext: ReactApplicationContext) :
       }
     } catch (e: Exception) {
       val params = Arguments.createMap()
-      params.putString("message", e.message ?: "Unknown error")
-      params.putString("code", "-1")
+      params.putString("message", e.message ?: "Unexpected Error")
+      params.putInt("code", 1000)
       promise.resolve(params)
       currentPromise = null
     }

package/android/src/main/java/com/rnscribeupsdk/ScribeupModuleImpl.kt

@@ -16,12 +16,12 @@ import java.net.URL
 
 // Error codes shared between iOS and Android
 object ErrorCodes {
-  const val UNKNOWN = -1
+  const val UNKNOWN = 1000
   const val INVALID_URL = 1001
-  const val ACTIVITY_NULL = 1002
-  const val INVALID_ACTIVITY_TYPE = 1003
-  const val NO_ROOT_VIEW_CONTROLLER = 1004
-  const val SDK_ERROR = 2001
+  const val INVALID_ENV = 1002
+  const val ACTIVITY_NULL = 1003
+  const val INVALID_ACTIVITY_TYPE = 1004
+  const val NO_ROOT_VIEW_CONTROLLER = 1005
 }
 
 class ScribeupModuleImpl(private val reactContext: ReactApplicationContext) {
@@ -110,7 +110,7 @@ class ScribeupModuleImpl(private val reactContext: ReactApplicationContext) {
       )
     } catch (e: Exception) {
       Log.e("Scribeup", "Error presenting subscription manager: ${e.message}")
-      val error = SubscriptionManagerError(message = e.message ?: "Unknown error", code = ErrorCodes.UNKNOWN)
+      val error = SubscriptionManagerError(message = e.message ?: "Unexpected Error", code = ErrorCodes.UNKNOWN)
       val params = Arguments.createMap().apply {
         putMap("error", Arguments.createMap().apply {
           putInt("code", error.code)

package/ios/ScribeupModule.swift

@@ -4,12 +4,12 @@ import React
 
 // MARK: - Error Codes (shared between iOS and Android)
 fileprivate enum ErrorCodes {
-  static let unknown = -1
-  static let invalidUrl = 1001
-  static let activityNull = 1002
-  static let invalidActivityType = 1003
-  static let noRootViewController = 1004
-  static let sdkError = 2001
+  static let UNKNOWN = 1000
+  static let INVALID_URL = 1001
+  static let INVALID_ENV = 1002
+  static let ACTIVITY_NULL = 1003
+  static let INVALID_ACTIVITY_TYPE = 1004
+  static let NO_ROOT_VIEW_CONTROLLER = 1005
 }
 
 @objc(Scribeup)
@@ -46,7 +46,7 @@ class Scribeup: RCTEventEmitter {
 
     DispatchQueue.main.async {
       guard let rootVC = UIApplication.shared.delegate?.window??.rootViewController else {
-        self.rejecter?(String(ErrorCodes.noRootViewController), "Cannot find root view controller", nil)
+        self.rejecter?(String(ErrorCodes.NO_ROOT_VIEW_CONTROLLER), "Cannot find root view controller", nil)
         return
       }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scribeup/react-native-scribeup",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -52,8 +52,8 @@
   },
   "config": {
     "nativeSDKVersions": {
-      "android": "0.8.2",
-      "ios": "0.8.3"
+      "android": "0.8.5",
+      "ios": "0.8.92"
     }
   }
 }

package/src/ScribeUp.tsx

@@ -54,7 +54,7 @@ type EventPayload = { data?: JsonObject };
  */
 export interface ScribeUpProps {
   url: string;
-  productName: string;
+  productName?: string;
   onExit?: (error: ExitError | null, data: JsonObject | null) => void;
   onEvent?: (data: JsonObject) => void;
 }
@@ -72,7 +72,7 @@ class ScribeUp extends React.Component<ScribeUpProps> {
   private didExit = false;
 
   componentDidMount() {
-    const { url, productName } = this.props;
+    const { url, productName = "" } = this.props;
 
     // Use module-backed emitter only if it implements the listener API.
     const canAttach =
@@ -90,7 +90,7 @@ class ScribeUp extends React.Component<ScribeUpProps> {
         this.didExit = true;
 
         const error: ExitError | null = payload?.error
-          ? { code: Number(payload.error.code ?? -1), message: payload.error.message }
+          ? { code: Number(payload.error.code ?? 1000), message: payload.error.message }
           : null;
 
         const data: JsonObject | null =
@@ -145,7 +145,7 @@ class ScribeUp extends React.Component<ScribeUpProps> {
             this.didExit = true;
 
             const error: ExitError | null = result?.error
-              ? { code: Number(result.error.code ?? -1), message: result.error.message }
+              ? { code: Number(result.error.code ?? 1000), message: result.error.message }
               : null;
 
             const data: JsonObject | null =
@@ -159,7 +159,7 @@ class ScribeUp extends React.Component<ScribeUpProps> {
             if (this.didExit) return;
             this.didExit = true;
             this.props.onExit?.(
-              { code: Number(err?.code ?? -1), message: err?.message || "Unknown error" },
+              { code: Number(err?.code ?? 1000), message: err?.message || "Unexpected Error" },
               null,
             );
           });
@@ -168,7 +168,7 @@ class ScribeUp extends React.Component<ScribeUpProps> {
       if (this.didExit) return;
       this.didExit = true;
       this.props.onExit?.(
-        { code: Number(err?.code ?? -1), message: err?.message || "Unknown error" },
+        { code: Number(err?.code ?? 1000), message: err?.message || "Unexpected Error" },
         null,
       );
     }