@qafka/react-native 2.0.0

package/dist/types/external-navigation.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * External Navigation — SDK types.
+ *
+ * Describes external destinations (WhatsApp, phone, map, app store, etc.)
+ * that buttons under chat messages can redirect to outside the host app.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Type exports for QafkaSDK
+ * Self-contained types (no external dependencies)
+ */
+export * from './navigation';
+export * from './chat';
+export * from './sdk';
+export * from './components';
+export * from './external-navigation';

package/dist/types/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Type exports for QafkaSDK
+ * Self-contained types (no external dependencies)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./navigation"), exports);
+__exportStar(require("./chat"), exports);
+__exportStar(require("./sdk"), exports);
+__exportStar(require("./components"), exports);
+__exportStar(require("./external-navigation"), exports);

package/dist/types/navigation.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Navigation-related types for React Navigation analysis and mapping
+ */
+/**
+ * Supported navigation library types
+ */
+export type NavigationType = 'react-navigation' | 'expo-router' | 'react-router-native' | 'mixed';
+/**
+ * Navigator types
+ */
+export type NavigatorType = 'Stack' | 'Tab' | 'Drawer' | 'BottomTab' | 'MaterialTopTab';
+/**
+ * Screen parameter type definition
+ */
+export interface ScreenParam {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    required: boolean;
+    description?: string;
+}
+/**
+ * Screen definition in navigation structure
+ */
+export interface Screen {
+    name: string;
+    component: string;
+    path: string;
+    params: ScreenParam[];
+    deeplink?: string;
+    description?: string;
+    options?: Record<string, any>;
+}
+/**
+ * Navigator (Stack, Tab, Drawer) definition
+ */
+export interface Navigator {
+    name: string;
+    type: NavigatorType;
+    screens: Screen[];
+    initialRouteName?: string;
+}
+/**
+ * Complete navigation structure
+ */
+export interface Navigation {
+    type: NavigationType;
+    stacks: Navigator[];
+    tabs?: Navigator[];
+    drawers?: Navigator[];
+}
+/**
+ * Full navigation schema with metadata
+ */
+export interface NavigationSchema {
+    version: string;
+    projectId: string;
+    navigation: Navigation;
+    analyzedAt: string;
+    metadata?: {
+        totalScreens: number;
+        totalRoutes: number;
+        hasDeepLinks: boolean;
+        libraryVersion?: string;
+    };
+}
+/**
+ * Navigation suggestion returned by the backend.
+ */
+export interface NavigationSuggestion {
+    screenName: string;
+    route: string;
+    deeplink?: string | null;
+    params?: Record<string, any>;
+    confirmed?: boolean;
+    message?: string;
+    reasoning?: string;
+}
+/**
+ * Route matching result
+ */
+export interface RouteMatch {
+    screen: Screen;
+    navigator: Navigator;
+    score: number;
+    path: string[];
+}

package/dist/types/navigation.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Navigation-related types for React Navigation analysis and mapping
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/sdk.d.ts

@@ -0,0 +1,36 @@
+/**
+ * SDK configuration types
+ */
+/**
+ * SDK configuration passed to QafkaSDK.initialize().
+ */
+export interface SDKConfig {
+    /**
+     * Development API key. Present in dev builds (loaded from qafka.config.js);
+     * null/undefined in production builds, which authenticate without it.
+     */
+    apiKey?: string | null;
+    /** Sub-project identifier (same apiKey, different sub-project). */
+    subProjectId?: string;
+    /** Advanced — leave unset for production. */
+    apiUrl?: string;
+    /** React Navigation ref, used when the SDK navigates on your behalf. */
+    navigationRef?: any;
+    /** Enable verbose dev logging. */
+    debug?: boolean;
+    /** Request timeout in ms. */
+    timeout?: number;
+    /**
+    * BCP 47 locale (e.g. "tr", "en", "tr-TR"). When set, the SDK
+    * forwards it as `sdkContext.locale` on every chat request and uses it
+    * for UI strings.
+    */
+    locale?: string;
+    onStatusChange?: (status: SDKStatusType) => void;
+    onNavigationSuggest?: (suggestion: any) => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * SDK status type
+ */
+export type SDKStatusType = 'uninitialized' | 'initializing' | 'ready' | 'error';

package/dist/types/sdk.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * SDK configuration types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/deepMerge.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Deep merge utility for theme objects
+ * Allows partial theme overrides while preserving default values
+ */
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+/**
+ * Deep merge two objects
+ * Source properties override target properties
+ * Nested objects are merged recursively
+ */
+export declare function deepMerge<T extends Record<string, any>>(target: T, source: DeepPartial<T> | undefined | null): T;
+/**
+ * Example usage:
+ *
+ * const defaultTheme = {
+ * colors: {
+ * primary: '#007AFF',
+ * background: '#FFFFFF',
+ * },
+ * spacing: {
+ * sm: 8,
+ * md: 16,
+ * },
+ * };
+ *
+ * const customTheme = {
+ * colors: {
+ * background: '#F5F5F5', // Override only background
+ * },
+ * };
+ *
+ * const mergedTheme = deepMerge(defaultTheme, customTheme);
+ * // Result:
+ * // {
+ * // colors: {
+ * // primary: '#007AFF', // Kept from default
+ * // background: '#F5F5F5', // Overridden
+ * // },
+ * // spacing: {
+ * // sm: 8, // Kept from default
+ * // md: 16, // Kept from default
+ * // },
+ * // }
+ */

package/dist/utils/deepMerge.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Deep merge utility for theme objects
+ * Allows partial theme overrides while preserving default values
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepMerge = deepMerge;
+/**
+ * Deep merge two objects
+ * Source properties override target properties
+ * Nested objects are merged recursively
+ */
+function deepMerge(target, source) {
+    if (!source)
+        return target;
+    const result = { ...target };
+    for (const key in source) {
+        if (source.hasOwnProperty(key)) {
+            const targetValue = target[key];
+            const sourceValue = source[key];
+            if (sourceValue &&
+                typeof sourceValue === 'object' &&
+                !Array.isArray(sourceValue) &&
+                targetValue &&
+                typeof targetValue === 'object' &&
+                !Array.isArray(targetValue)) {
+                // Recursively merge nested objects
+                result[key] = deepMerge(targetValue, sourceValue);
+            }
+            else {
+                // Direct assignment for primitives and arrays
+                result[key] = sourceValue;
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Example usage:
+ *
+ * const defaultTheme = {
+ * colors: {
+ * primary: '#007AFF',
+ * background: '#FFFFFF',
+ * },
+ * spacing: {
+ * sm: 8,
+ * md: 16,
+ * },
+ * };
+ *
+ * const customTheme = {
+ * colors: {
+ * background: '#F5F5F5', // Override only background
+ * },
+ * };
+ *
+ * const mergedTheme = deepMerge(defaultTheme, customTheme);
+ * // Result:
+ * // {
+ * // colors: {
+ * // primary: '#007AFF', // Kept from default
+ * // background: '#F5F5F5', // Overridden
+ * // },
+ * // spacing: {
+ * // sm: 8, // Kept from default
+ * // md: 16, // Kept from default
+ * // },
+ * // }
+ */

package/dist/utils/fontUtils.d.ts

@@ -0,0 +1,8 @@
+import { Theme } from '../themes/types';
+/**
+ * Helper to resolve the correct font family from the theme based on weight/style.
+ * Priority:
+ * 1. theme.typography.fonts[style] (if available)
+ * 2. theme.typography.fontFamily (fallback)
+ */
+export declare const getFontFamily: (theme: Theme, variant?: "regular" | "medium" | "semibold" | "bold" | "italic" | "light" | "code") => string | undefined;

package/dist/utils/fontUtils.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFontFamily = void 0;
+/**
+ * Helper to resolve the correct font family from the theme based on weight/style.
+ * Priority:
+ * 1. theme.typography.fonts[style] (if available)
+ * 2. theme.typography.fontFamily (fallback)
+ */
+const getFontFamily = (theme, variant = 'regular') => {
+    if (theme.typography.fonts && theme.typography.fonts[variant]) {
+        return theme.typography.fonts[variant];
+    }
+    return theme.typography.fontFamily;
+};
+exports.getFontFamily = getFontFamily;

package/dist/validate-end-user.d.ts

@@ -0,0 +1,18 @@
+/**
+ * End-user prop validation.
+ *
+ * Runs at SDK mount and again on every chat request so a stale closure or
+ * a runtime mutation of the prop is caught at the boundary instead of
+ * silently dropping the tracking lane. Failures throw so the host app's
+ * red-screen catches them in development; production builds surface them
+ * via the same `componentDidCatch` boundaries hosting code already uses.
+ *
+ * The size cap for `endUserData` does NOT throw — over-limit profiles are
+ * dropped from the outgoing payload after a `console.error`. Chat still
+ * works, the operator dashboard just shows nothing in the End User card
+ * for that request. The asymmetry is intentional: `endUserId` is the
+ * tracking anchor (a hard contract failure), while `endUserData` is
+ * supplemental detail (degrade gracefully).
+ */
+export declare function validateEndUserId(raw: unknown): string;
+export declare function validateEndUserData(raw: unknown): Record<string, unknown> | undefined;

package/dist/validate-end-user.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * End-user prop validation.
+ *
+ * Runs at SDK mount and again on every chat request so a stale closure or
+ * a runtime mutation of the prop is caught at the boundary instead of
+ * silently dropping the tracking lane. Failures throw so the host app's
+ * red-screen catches them in development; production builds surface them
+ * via the same `componentDidCatch` boundaries hosting code already uses.
+ *
+ * The size cap for `endUserData` does NOT throw — over-limit profiles are
+ * dropped from the outgoing payload after a `console.error`. Chat still
+ * works, the operator dashboard just shows nothing in the End User card
+ * for that request. The asymmetry is intentional: `endUserId` is the
+ * tracking anchor (a hard contract failure), while `endUserData` is
+ * supplemental detail (degrade gracefully).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateEndUserId = validateEndUserId;
+exports.validateEndUserData = validateEndUserData;
+const MAX_END_USER_ID_LENGTH = 256;
+const MAX_END_USER_DATA_BYTES = 8 * 1024;
+function validateEndUserId(raw) {
+    if (raw === undefined || raw === null) {
+        throw new Error('Qafka: endUserId is required. Pass the signed-in user id, or a stable placeholder like "anonymous" or `anon-${deviceId}` before login.');
+    }
+    let coerced;
+    if (typeof raw === 'number') {
+        if (!Number.isFinite(raw)) {
+            throw new Error('Qafka: endUserId must be a finite number when passed as number');
+        }
+        coerced = String(raw);
+    }
+    else if (typeof raw === 'string') {
+        coerced = raw;
+    }
+    else {
+        throw new Error('Qafka: endUserId must be a string or number');
+    }
+    const trimmed = coerced.trim();
+    if (trimmed.length === 0) {
+        throw new Error('Qafka: endUserId cannot be empty or whitespace. Use a stable placeholder like "anonymous" for pre-login state.');
+    }
+    if (trimmed.length > MAX_END_USER_ID_LENGTH) {
+        throw new Error(`Qafka: endUserId exceeds ${MAX_END_USER_ID_LENGTH} character limit (got ${trimmed.length}).`);
+    }
+    return trimmed;
+}
+function validateEndUserData(raw) {
+    if (raw === undefined || raw === null)
+        return undefined;
+    if (typeof raw !== 'object' || Array.isArray(raw)) {
+        // Wrong shape → drop. Throwing would prevent chat from working on a
+        // pure UI mistake, which is too aggressive for a supplemental field.
+        // eslint-disable-next-line no-console
+        console.error('Qafka: endUserData must be a plain object — dropped from request.');
+        return undefined;
+    }
+    let serialized;
+    try {
+        serialized = JSON.stringify(raw);
+    }
+    catch {
+        // eslint-disable-next-line no-console
+        console.error('Qafka: endUserData contains circular references or non-serializable values — dropped from request.');
+        return undefined;
+    }
+    if (serialized.length > MAX_END_USER_DATA_BYTES) {
+        // eslint-disable-next-line no-console
+        console.error(`Qafka: endUserData exceeds ${MAX_END_USER_DATA_BYTES}B serialized limit (got ${serialized.length}B) — dropped from request. Trim the object or move bulky fields to a separate endpoint.`);
+        return undefined;
+    }
+    return raw;
+}

package/expo-plugin/withQafkaAttestation.js

@@ -0,0 +1,57 @@
+const { withEntitlementsPlist, withAppBuildGradle, withInfoPlist, withAndroidManifest } = require('expo/config-plugins');
+
+const withQafkaAttestationIOS = (config, { appleEnvironment = 'production' } = {}) => {
+  return withEntitlementsPlist(config, (config) => {
+    config.modResults['com.apple.developer.devicecheck.appattest-environment'] =
+      appleEnvironment;
+    return config;
+  });
+};
+
+const withQafkaAttestationAndroid = (config) => {
+  return withAppBuildGradle(config, (config) => {
+    const contents = config.modResults.contents;
+    const dependency = "    implementation 'com.google.android.play:integrity:1.4.0'";
+
+    if (!contents.includes('play:integrity')) {
+      config.modResults.contents = contents.replace(
+        /dependencies\s*\{/,
+        `dependencies {\n${dependency}`,
+      );
+    }
+
+    return config;
+  });
+};
+
+const withQafkaMicPermissionIOS = (config, { microphoneUsageDescription = 'Voice chat requires microphone access' } = {}) => {
+  return withInfoPlist(config, (config) => {
+    config.modResults.NSMicrophoneUsageDescription = microphoneUsageDescription;
+    return config;
+  });
+};
+
+const withQafkaMicPermissionAndroid = (config) => {
+  return withAndroidManifest(config, (config) => {
+    const manifest = config.modResults.manifest;
+    const permissions = manifest['uses-permission'] || [];
+    const hasMicPermission = permissions.some(
+      (p) => p.$['android:name'] === 'android.permission.RECORD_AUDIO'
+    );
+    if (!hasMicPermission) {
+      permissions.push({ $: { 'android:name': 'android.permission.RECORD_AUDIO' } });
+    }
+    manifest['uses-permission'] = permissions;
+    return config;
+  });
+};
+
+const withQafkaAttestation = (config, props = {}) => {
+  config = withQafkaAttestationIOS(config, props || {});
+  config = withQafkaAttestationAndroid(config);
+  config = withQafkaMicPermissionIOS(config, props || {});
+  config = withQafkaMicPermissionAndroid(config);
+  return config;
+};
+
+module.exports = withQafkaAttestation;

package/ios/QafkaAttestation.m

@@ -0,0 +1,25 @@
+#import <React/RCTBridgeModule.h>
+
+@interface RCT_EXTERN_MODULE(QafkaAttestation, NSObject)
+
+RCT_EXTERN_METHOD(isSupported:
+                  (RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(generateKey:
+                  (RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(attestKey:
+                  (NSString *)keyId
+                  challengeBase64:(NSString *)challengeBase64
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(generateAssertion:
+                  (NSString *)keyId
+                  clientDataBase64:(NSString *)clientDataBase64
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+@end

package/ios/QafkaAttestation.swift

@@ -0,0 +1,128 @@
+import Foundation
+import DeviceCheck
+import CryptoKit
+import UIKit
+
+@objc(QafkaAttestation)
+class QafkaAttestation: NSObject {
+
+  @objc static func requiresMainQueueSetup() -> Bool {
+    return true
+  }
+
+  @objc func constantsToExport() -> [AnyHashable: Any]! {
+    let bundle = Bundle.main
+    let bundleId = bundle.bundleIdentifier ?? ""
+    let appVersion = bundle.infoDictionary?["CFBundleShortVersionString"] as? String ?? ""
+    let deviceModel = UIDevice.current.model
+    return [
+      "bundleId": bundleId,
+      "appVersion": appVersion,
+      "deviceModel": deviceModel,
+    ]
+  }
+
+  @objc func isSupported(
+    _ resolve: @escaping RCTPromiseResolveBlock,
+    rejecter reject: @escaping RCTPromiseRejectBlock
+  ) {
+    if #available(iOS 14.0, *) {
+      resolve(DCAppAttestService.shared.isSupported)
+    } else {
+      resolve(false)
+    }
+  }
+
+  @objc func generateKey(
+    _ resolve: @escaping RCTPromiseResolveBlock,
+    rejecter reject: @escaping RCTPromiseRejectBlock
+  ) {
+    guard #available(iOS 14.0, *) else {
+      reject("UNSUPPORTED", "App Attest requires iOS 14+", nil)
+      return
+    }
+    let service = DCAppAttestService.shared
+    guard service.isSupported else {
+      reject("UNSUPPORTED", "App Attest not supported on this device", nil)
+      return
+    }
+
+    service.generateKey { keyId, error in
+      if let error = error {
+        reject("KEY_GEN_FAILED", error.localizedDescription, error)
+      } else if let keyId = keyId {
+        resolve(keyId)
+      } else {
+        reject("KEY_GEN_FAILED", "Unknown error generating key", nil)
+      }
+    }
+  }
+
+  @objc func attestKey(
+    _ keyId: String,
+    challengeBase64: String,
+    resolver resolve: @escaping RCTPromiseResolveBlock,
+    rejecter reject: @escaping RCTPromiseRejectBlock
+  ) {
+    guard #available(iOS 14.0, *) else {
+      reject("UNSUPPORTED", "App Attest requires iOS 14+", nil)
+      return
+    }
+
+    guard let challengeData = Data(base64Encoded: challengeBase64) else {
+      reject("INVALID_INPUT", "Invalid base64 challenge", nil)
+      return
+    }
+
+    let hash = Data(SHA256.hash(data: challengeData))
+
+    DCAppAttestService.shared.attestKey(keyId, clientDataHash: hash) { attestation, error in
+      if let error = error {
+        let code: String
+        if let dcError = error as? DCError {
+          switch dcError.code {
+          case .invalidKey: code = "INVALID_KEY"
+          case .serverUnavailable: code = "SERVER_UNAVAILABLE"
+          default: code = "ATTEST_FAILED"
+          }
+        } else {
+          code = "ATTEST_FAILED"
+        }
+        reject(code, error.localizedDescription, error)
+      } else if let attestation = attestation {
+        resolve(attestation.base64EncodedString())
+      } else {
+        reject("ATTEST_FAILED", "Unknown error during attestation", nil)
+      }
+    }
+  }
+
+  @objc func generateAssertion(
+    _ keyId: String,
+    clientDataBase64: String,
+    resolver resolve: @escaping RCTPromiseResolveBlock,
+    rejecter reject: @escaping RCTPromiseRejectBlock
+  ) {
+    guard #available(iOS 14.0, *) else {
+      reject("UNSUPPORTED", "App Attest requires iOS 14+", nil)
+      return
+    }
+
+    guard let clientData = Data(base64Encoded: clientDataBase64) else {
+      reject("INVALID_INPUT", "Invalid base64 client data", nil)
+      return
+    }
+
+    let hash = Data(SHA256.hash(data: clientData))
+
+    DCAppAttestService.shared.generateAssertion(keyId, clientDataHash: hash) { assertion, error in
+      if let error = error {
+        reject("ASSERTION_FAILED", error.localizedDescription, error)
+      } else if let assertion = assertion {
+        resolve(assertion.base64EncodedString())
+      } else {
+        reject("ASSERTION_FAILED", "Unknown error generating assertion", nil)
+      }
+    }
+  }
+}

package/ios/QafkaAudio.m

@@ -0,0 +1,23 @@
+#import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
+
+@interface RCT_EXTERN_MODULE(QafkaAudio, RCTEventEmitter)
+
+RCT_EXTERN_METHOD(startCapture:
+                  (RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(stopCapture:
+                  (RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(playAudioChunk:
+                  (NSString *)base64Data
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(stopPlayback:
+                  (RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+@end