@qafka/react-native 2.4.0 → 2.4.1

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.ht
 
 ## [Unreleased]
 
+## [2.4.1] — 2026-06-21
+
+### Fixed
+
+- Development experience: when a development (test) API key has been rotated and the app is still running the old key, chat no longer fails silently. In development builds the SDK now logs an actionable warning and shows an in-chat message telling the developer to run `qafka refresh` and restart Metro with `--clear`. This guidance is stripped from release builds (`__DEV__`-gated) and only triggers for development keys, so it can never appear in production.
+
 ## [2.4.0] — 2026-06-21
 
 ### Added

package/dist/components/Qafka.js

@@ -311,6 +311,20 @@ exports.Qafka = (0, react_1.forwardRef)(function Qafka({ style, apiUrl: apiUrlPr
                         setIsInitialMessageLoading(false);
                         if (__DEV__) {
                             console.warn('[Qafka] Initial message error:', err.message);
+                            // Dev-only: a stale rotated test key would otherwise fail silently.
+                            // Surface the actionable hint in the transcript so it is visible.
+                            const devErr = err;
+                            if (devErr.code === 'DEV_KEY_INVALID') {
+                                const devErrMsg = {
+                                    id: `dev-key-error-${Date.now()}`,
+                                    role: 'assistant',
+                                    text: err.message,
+                                    content: err.message,
+                                    timestamp: new Date(),
+                                    metadata: { isInitialMessage: true },
+                                };
+                                setMessages((prev) => [...prev, devErrMsg]);
+                            }
                         }
                     }, currentContext, contextDescription, undefined, // onToolSuggestions
                     true);

package/dist/services/BackendService.js

@@ -601,12 +601,27 @@ class BackendService {
                     });
                 }
                 else {
+                    let serverMessage;
                     try {
-                        const errorData = JSON.parse(xhr.responseText);
-                        onError(new Error(errorData.message || `HTTP Error: ${xhr.status}`));
+                        serverMessage = JSON.parse(xhr.responseText)?.message;
                     }
                     catch {
-                        onError(new Error(`HTTP Error: ${xhr.status}`));
+                        // non-JSON error body; fall through to a status-based message
+                    }
+                    // In dev, a 401 with a test key almost always means the rotated dev
+                    // key is stale. Surface an actionable hint instead of a bare HTTP error.
+                    if (__DEV__ && xhr.status === 401 && this.apiKey?.startsWith('qafka_test_')) {
+                        const hint = 'Qafka dev key is invalid or was rotated. Run `qafka refresh`, then restart Metro with --clear.';
+                        console.warn(`[Qafka] ${hint}`);
+                        const devErr = new Error(hint);
+                        devErr.code = 'DEV_KEY_INVALID';
+                        devErr.status = xhr.status;
+                        onError(devErr);
+                    }
+                    else {
+                        const httpErr = new Error(serverMessage || `HTTP Error: ${xhr.status}`);
+                        httpErr.status = xhr.status;
+                        onError(httpErr);
                     }
                 }
             };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qafka/react-native",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "Drop-in AI assistant for React Native: chat, voice, and tool execution with screen-aware navigation.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",