@qafka/react-native 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.ht
 
 ## [Unreleased]
 
+## [2.1.1] — 2026-06-03
+
+### Fixed
+
+- Chat surface could get stuck on the loading indicator (greeting + typing dots, no input) after navigating away from the chat screen and returning to it. Re-entering an already-initialized SDK now reports the ready state to the new mount, and tearing down a superseded instance no longer clears a newer live one.
+
 ## [2.0.0] — 2026-05-17
 
 Initial public release. See [README.md](./README.md) for the full feature list and installation instructions.

package/dist/QafkaSDK.js

@@ -47,6 +47,14 @@ class QafkaSDK {
             if (currentApiKey === newApiKey &&
                 currentSubProjectId === newSubProjectId &&
                 currentProjectId === newProjectId) {
+                // Already initialized with an identical config. A second component
+                // mount shares this singleton — the host can re-enter or re-push the
+                // chat screen via forward navigation before the previous instance has
+                // finished tearing down. Re-running init is unnecessary, but we MUST
+                // still notify this caller's status listener; otherwise its local
+                // `sdkReady` never flips true and the UI stalls on the loading gate
+                // with the input hidden.
+                config.onStatusChange?.('ready');
                 return;
             }
             await this.destroy();
@@ -457,7 +465,12 @@ class QafkaSDK {
         this.config = null;
         this.themePrefetchPromise = null;
         this.status = 'uninitialized';
-        QafkaSDK.instance = null;
+        // Only clear the shared singleton slot when WE are still the current
+        // instance. An outgoing component unmounting must not null a newer
+        // instance that a freshly mounted component already created/initialized.
+        if (QafkaSDK.instance === this) {
+            QafkaSDK.instance = null;
+        }
     }
 }
 exports.QafkaSDK = QafkaSDK;

package/dist/components/Qafka.js

@@ -86,11 +86,12 @@ const { width: SCREEN_WIDTH } = react_native_1.Dimensions.get('window');
  * />
  * ```
  */
-exports.Qafka = (0, react_1.forwardRef)(function Qafka({ style, apiUrl: apiUrlProp, subProjectId, projectId, locale, mode = 'fullscreen', theme: themeName = 'light', customTheme, themeOverride, isAuthenticated, endUserId, endUserData, enableStreaming = true, voiceEnabled: voiceEnabledProp = true, context: userContext, contextDescription, components: customComponents, showTimestamps = true, placeholder = 'Type a message...', maxMessageLength = 500, greetingMessage, onReady, onMessageSent, onResponseReceived, onError, onNavigationSuggest, onNavigationAction, onExternalSuggestion, onCardDeepLink, onCardSuggestMessage, onCardExternalNavigation, onCardShare, onCardCopy, onCardToolTrigger, onCardCTAClick, onToolSuggested, onToolDataRequested, onActionResult, onStepCompleted, onFileUploadRequest, onExtractionResult, onClose, onBack, CloseComponent, BackComponent, navigationLabelFormat, NavigationButtonComponent, voiceComponents, voiceTranscript = 'centered', toolRenderMode, }, ref) {
+exports.Qafka = (0, react_1.forwardRef)(function Qafka({ style, apiUrl: apiUrlProp, devConfig, subProjectId, projectId, locale, mode = 'fullscreen', theme: themeName = 'light', customTheme, themeOverride, isAuthenticated, endUserId, endUserData, enableStreaming = true, voiceEnabled: voiceEnabledProp = true, context: userContext, contextDescription, components: customComponents, showTimestamps = true, placeholder = 'Type a message...', maxMessageLength = 500, greetingMessage, onReady, onMessageSent, onResponseReceived, onError, onNavigationSuggest, onNavigationAction, onExternalSuggestion, onCardDeepLink, onCardSuggestMessage, onCardExternalNavigation, onCardShare, onCardCopy, onCardToolTrigger, onCardCTAClick, onToolSuggested, onToolDataRequested, onActionResult, onStepCompleted, onFileUploadRequest, onExtractionResult, onClose, onBack, CloseComponent, BackComponent, navigationLabelFormat, NavigationButtonComponent, voiceComponents, voiceTranscript = 'centered', toolRenderMode, }, ref) {
     // === ALL HOOKS FIRST (Rules of Hooks compliance) ===
     const insets = (0, react_native_safe_area_context_1.useSafeAreaInsets)();
     const { sdkReady, error: sdkError, resolvedApiKey, resolvedApiUrl } = (0, useSDK_1.useSDK)({
         apiUrl: apiUrlProp,
+        devConfig,
         subProjectId,
         projectId,
         locale,

package/dist/components/Qafka.types.d.ts

@@ -4,6 +4,7 @@ import { ComponentRegistry } from '../types/components';
 import { ExternalSuggestion } from '../types/external-navigation';
 import { NavigationSuggestion } from '../types/navigation';
 import { VoiceChatState } from './VoicePage';
+import type { RuntimeConfig } from '../runtime-config-loader';
 /**
  * Augmentation hook for consumer-side projectId literal types.
  *
@@ -256,6 +257,16 @@ export interface QafkaProps {
     * Backend API URL (OPTIONAL — advanced, leave unset for production).
     */
     apiUrl?: string;
+    /**
+     * Dev-only runtime config the SDK reads for the simulator/emulator
+     * `__DEV__` auth path. Pass the CLI-managed file:
+     *   `devConfig={__DEV__ ? require('../.qafka/qafka-runtime') : undefined}`
+     * Omit on real devices / production — attestation handles auth there, and
+     * `require` under `__DEV__` is dead-code-eliminated from release bundles so
+     * no key reaches the prod build. When omitted, the SDK falls back to the
+     * legacy `node_modules` config (backward compatible).
+     */
+    devConfig?: RuntimeConfig | null;
     /**
     * Sub-Project Identifier (OPTIONAL)
     *

package/dist/components/VoicePage.js

@@ -569,7 +569,9 @@ function VoicePage({ state, transcript, userTranscript, transcriptHistory, trans
 
  {showMute && !hasToolUI ? (<react_native_1.View style={{
                 position: 'absolute',
-                top: 12,
+                // Absolute children aren't pushed by the parent's safe-area paddingTop,
+                // so add the inset here to keep the button clear of the status bar / notch.
+                top: insets.top + 12,
                 right: 16,
             }}>
  <MuteButton isMuted={isMuted} onToggle={onToggleMute} theme={theme} state={state}/>

package/dist/hooks/useSDK.d.ts

@@ -10,12 +10,15 @@ export interface UseSDKOptions {
     locale?: string;
     onReady?: () => void;
     onError?: (error: Error) => void;
+    devConfig?: unknown;
 }
 export interface UseSDKResult {
     sdkReady: boolean;
     error: string | null;
     /**
-     * Dev-only: the resolved developmentKey from `qafka.config.js`. Null in
+     * Dev-only: the resolved developmentKey from the consumer dev config — the
+     * `devConfig` prop (`.qafka/qafka-runtime.js`) or the legacy node_modules
+     * fallback. Null in
      * production builds (Metro dead-code-eliminates the dev config branch).
      * Used by `useVoiceChat` whose WebSocket auth still relies on apiKey.
      */
@@ -28,4 +31,4 @@ export interface UseSDKResult {
 /**
  * Custom hook for managing SDK initialization and lifecycle
  */
-export declare const useSDK: ({ apiUrl, subProjectId, projectId, locale, onReady, onError, }: UseSDKOptions) => UseSDKResult;
+export declare const useSDK: ({ apiUrl, subProjectId, projectId, locale, onReady, onError, devConfig, }: UseSDKOptions) => UseSDKResult;

package/dist/hooks/useSDK.js

@@ -5,10 +5,11 @@ const react_1 = require("react");
 const QafkaSDK_1 = require("../QafkaSDK");
 const runtime_config_loader_1 = require("../runtime-config-loader");
 const resolve_project_config_1 = require("../resolve-project-config");
+const resolve_runtime_config_source_1 = require("../resolve-runtime-config-source");
 /**
  * Custom hook for managing SDK initialization and lifecycle
  */
-const useSDK = ({ apiUrl, subProjectId, projectId, locale, onReady, onError, }) => {
+const useSDK = ({ apiUrl, subProjectId, projectId, locale, onReady, onError, devConfig, }) => {
     const [sdkReady, setSdkReady] = (0, react_1.useState)(false);
     const [error, setError] = (0, react_1.useState)(null);
     const [resolvedApiKey, setResolvedApiKey] = (0, react_1.useState)(null);
@@ -27,18 +28,16 @@ const useSDK = ({ apiUrl, subProjectId, projectId, locale, onReady, onError, })
         let apiKey = null;
         let resolvedUrl = apiUrl;
         if (__DEV__) {
-            // Dev path: load qafka.config.js, pick developmentKey for the current project.
-            // Metro dead-code elimination removes this branch entirely in production
-            // builds, so qafka.config.js never lands in the prod bundle.
+            // Dev path: prefer the consumer-supplied .qafka/ config, else the legacy
+            // node_modules config. Metro dead-code elimination removes this whole
+            // branch (and both requires) from production builds.
             try {
-                const cfg = (0, resolve_project_config_1.resolveProjectConfig)({ apiUrl, projectId }, (0, runtime_config_loader_1.loadRuntimeConfig)());
+                const cfg = (0, resolve_project_config_1.resolveProjectConfig)({ apiUrl, projectId }, (0, resolve_runtime_config_source_1.resolveRuntimeConfigSource)(devConfig, (0, runtime_config_loader_1.loadRuntimeConfig)()));
                 apiKey = cfg.apiKey;
                 resolvedUrl = cfg.apiUrl;
             }
             catch (err) {
-                if (__DEV__) {
-                    console.warn('[Qafka] Dev config missing or invalid:', err instanceof Error ? err.message : err);
-                }
+                console.warn('[Qafka] Dev config missing or invalid:', err instanceof Error ? err.message : err);
             }
         }
         // Expose resolved values so `useVoiceChat` (WebSocket auth still

package/dist/resolve-runtime-config-source.d.ts

@@ -0,0 +1,9 @@
+import { type RuntimeConfig } from './runtime-config-loader';
+/**
+ * Pick the runtime config the SDK should use in dev builds.
+ *
+ * Precedence: a valid `devConfig` (the consumer's `require('../.qafka/qafka-runtime')`,
+ * shape-validated) wins; otherwise the value loaded from the SDK package
+ * (`loadRuntimeConfig()`). Returns null when neither yields a usable config.
+ */
+export declare function resolveRuntimeConfigSource(devConfig: unknown, loaded: RuntimeConfig | null): RuntimeConfig | null;

package/dist/resolve-runtime-config-source.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRuntimeConfigSource = resolveRuntimeConfigSource;
+const runtime_config_loader_1 = require("./runtime-config-loader");
+/**
+ * Pick the runtime config the SDK should use in dev builds.
+ *
+ * Precedence: a valid `devConfig` (the consumer's `require('../.qafka/qafka-runtime')`,
+ * shape-validated) wins; otherwise the value loaded from the SDK package
+ * (`loadRuntimeConfig()`). Returns null when neither yields a usable config.
+ */
+function resolveRuntimeConfigSource(devConfig, loaded) {
+    const provided = devConfig != null ? (0, runtime_config_loader_1.normalizeRuntimeConfig)(devConfig) : null;
+    return provided ?? loaded;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qafka/react-native",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "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",