@graineai/inapp-react-native 0.16.0 → 0.18.0

package/INTEGRATION.md

@@ -652,11 +652,37 @@ agent not enabled for apps — leaves the launcher rendering nothing, silently.
 Pass it before you debug anything else.
 
 **On `rtc`: every call reports a fallback to `ws`.**
-`onTransport` gives a `reason`. `unreachable` means WebRTC could not be reached
-at all — usually no SIP realm on the org, or the SBC is not reachable from the
-customer's network. `screen_channel` means the audio connected but the control
-socket did not join, so the call was restarted on the WebSocket rather than run
-blind. Both are org configuration, not integration code.
+`onTransport` gives a `reason`, and `message` carries the server's own sentence.
+
+| `reason` | Means | Retry helps? |
+|---|---|---|
+| `not_configured` | A setting is wrong — see below. Also raised through `onError`. | Never |
+| `unreachable` | No SIP realm on the org, or the SBC is not reachable from this network. | Sometimes |
+| `screen_channel` | Audio connected, the screen channel did not, so the call restarted rather than run blind. | Sometimes |
+
+**`not_configured`: which setting?** The call still works — it is carried on the
+WebSocket — so nothing is on fire, but WebRTC will never be used until this is
+fixed. Ask the mint endpoint directly, without rebuilding anything:
+
+```bash
+curl -i -X POST https://www.graine.ai/api/embed/rtc-session \
+  -H 'Content-Type: application/json' \
+  -d '{"publishableKey":"pk_live_YOUR_KEY"}'
+```
+
+| Response | `code` | Fix |
+|---|---|---|
+| 401 | `key_missing` | No key reached the endpoint. Update the SDK — before 0.17.0 it did not put `pk` in the page URL. |
+| 401 | `key_malformed` | Not a publishable key. It starts with `pk_live_`, from Agent → Embed & Widgets. |
+| 401 | `key_unknown` | No agent registered to that key. |
+| 403 | `no_origin` | **The common one for apps.** A native app sends no `Origin`, so add the literal entry `app://` to that agent's Allowed domains. |
+| 403 | `no_domains_configured` | The allowlist is empty, which denies everything. |
+| 403 | `origin_not_allowed` | Add your site to Allowed domains. |
+| 503 | `not_configured` | WebRTC is not enabled on that deployment. Not fixable from the app. |
+| 200 | — | The mint works; look at `onTransport` for `unreachable` instead. |
+
+That curl sends **no** `Origin` header, exactly as a native app does — so a 403
+from it is precisely the 403 your app is getting.
 
 **On `rtc`: the greeting plays twice, occasionally.**
 That is the `screen_channel` fallback restarting the call. It only happens when

package/dist/react-native/voice-launcher.d.ts

@@ -4,6 +4,8 @@ export interface GraineVoiceLauncherProps {
     onTransport?: (info: {
         transport: "ws" | "rtc";
         requested: "ws" | "rtc";
+        reason?: "not_configured" | "unreachable" | "screen_channel";
+        message?: string;
     }) => void;
     webView: React.ComponentType<any>;
     autoStart?: boolean;
@@ -25,6 +27,7 @@ export interface GraineVoiceApi {
     connected: boolean;
     connecting: boolean;
     muted: boolean;
+    ready: boolean;
     start: () => void;
     end: () => void;
     setMuted: (m: boolean) => void;

package/dist/react-native/voice-launcher.js

@@ -106,12 +106,18 @@ export function GraineVoiceLauncher({ webView: WebView, autoStart = false, trans
                 onTransport?.({
                     transport: msg.transport === "rtc" ? "rtc" : "ws",
                     requested: msg.requested === "rtc" ? "rtc" : "ws",
+                    reason: msg.reason,
+                    message: msg.message,
                 });
+                if (msg.reason === "not_configured" && msg.message) {
+                    onError?.(String(msg.message));
+                }
                 return;
             case "graine:ready":
                 setReady(true);
                 pushContext();
-                if (autoStart && !startedRef.current) {
+                if ((autoStart || pendingStartRef.current) && !startedRef.current) {
+                    pendingStartRef.current = false;
                     startedRef.current = true;
                     void beginCall();
                 }
@@ -150,15 +156,21 @@ export function GraineVoiceLauncher({ webView: WebView, autoStart = false, trans
                 return;
             }
         }
-    }, [autoStart, beginCall, client, onCaption, onCallState, onMicDenied, onTransport, onEnded, post, pushContext]);
+    }, [autoStart, beginCall, client, onCaption, onCallState, onMicDenied, onTransport, onError, onEnded, post, pushContext]);
+    const pendingStartRef = useRef(false);
     const api = {
         connected,
         connecting,
         muted,
+        ready: !!voiceAgentId && ready,
         start: useCallback(() => {
             setConnecting(true);
+            if (!ready) {
+                pendingStartRef.current = true;
+                return;
+            }
             void beginCall();
-        }, [beginCall]),
+        }, [beginCall, ready]),
         end: useCallback(() => post({ type: "graine:end-call" }), [post]),
         setMuted: useCallback((m) => {
             setMutedState(m);
@@ -196,6 +208,7 @@ export function GraineVoiceLauncher({ webView: WebView, autoStart = false, trans
     const effectiveTransport = transport ?? (appearance?.audioTransport === "rtc" ? "rtc" : "ws");
     const src = `${client.opts.baseUrl.replace(/\/$/, "")}/embed/${voiceAgentId}` +
         `?mode=voice&branding=0&embed=1&transport=${effectiveTransport}` +
+        `&pk=${encodeURIComponent(client.opts.publishableKey)}` +
         (appearance?.accent ? `&accent=${encodeURIComponent(String(appearance.accent).replace("#", ""))}` : "");
     return (_jsxs(_Fragment, { children: [_jsx(View, { style: { position: "absolute", width: 1, height: 1, opacity: 0, bottom: 0, left: 0 }, pointerEvents: "none", children: _jsx(WebView, { ref: ref, source: { uri: src }, originWhitelist: ["*"], javaScriptEnabled: true, domStorageEnabled: true, allowsInlineMediaPlayback: true, mediaPlaybackRequiresUserAction: false, mediaCapturePermissionGrantType: "grant", onMessage: onMessage, style: { width: 1, height: 1, backgroundColor: "transparent" } }) }), children?.(api)] }));
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@graineai/inapp-react-native",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "type": "module",
-  "description": "Graine in-app agent for React Native — an agent that sees the screen your customer is on and can act on it.",
+  "description": "Graine in-app agent for React Native \u2014 an agent that sees the screen your customer is on and can act on it.",
   "license": "MIT",
   "private": false,
   "main": "dist/index.js",