@fiction/sdk 1.0.39 → 1.0.41

package/dist/sdkClient.d.ts

@@ -221,6 +221,7 @@ export declare class FictionSDK extends SettingsObject<FictionSDKSettings> {
             gender?: string | null | undefined;
             birthdayAt?: string | null | undefined;
             businessTemplate?: string | null | undefined;
+            onboardedAt?: string | null | undefined;
             enrichment?: Record<string, any> | null | undefined;
             onboarding?: Record<string, any> | null | undefined;
             org?: {
@@ -451,6 +452,7 @@ export declare class FictionSDK extends SettingsObject<FictionSDKSettings> {
             gender?: string | null | undefined;
             birthdayAt?: string | null | undefined;
             businessTemplate?: string | null | undefined;
+            onboardedAt?: string | null | undefined;
             enrichment?: Record<string, any> | null | undefined;
             onboarding?: Record<string, any> | null | undefined;
             org?: {
@@ -572,6 +574,7 @@ export declare class FictionSDK extends SettingsObject<FictionSDKSettings> {
         gender?: string | null | undefined;
         birthdayAt?: string | null | undefined;
         businessTemplate?: string | null | undefined;
+        onboardedAt?: string | null | undefined;
         enrichment?: Record<string, any> | null | undefined;
         onboarding?: Record<string, any> | null | undefined;
         org?: {

package/dist/self/ClientAudio.d.ts

@@ -4,6 +4,7 @@ export type AudioPermissionOptions = {
     noiseSuppression?: boolean;
     echoCancellation?: boolean;
     autoGainControl?: boolean;
+    voiceIsolation?: boolean;
 };
 type ClientAudioSettings = {
     [key: string]: unknown;
@@ -15,6 +16,10 @@ export declare class ClientAudio extends SettingsObject<ClientAudioSettings> {
     private audioLevelInterval?;
     private stream?;
     private visibilityChangeHandler?;
+    private vadTimeout?;
+    private lastSpeechTime;
+    private readonly VAD_SILENCE_THRESHOLD;
+    private readonly VAD_SILENCE_DURATION;
     audioLevels: import('vue').Ref<{
         inputLevel: number;
         outputLevel: number;
@@ -28,25 +33,43 @@ export declare class ClientAudio extends SettingsObject<ClientAudioSettings> {
      */
     private setupVisibilityHandler;
     /**
-     * Handle app going to background (iOS microphone indicator fix)
+     * Handle app going to background (Privacy & Security Best Practice)
+     * CRITICAL: Must stop microphone tracks to remove indicator on mobile/browser
      */
     private handleAppBackground;
     /**
      * Handle app returning to foreground
+     * SECURITY: Do NOT auto-restart microphone - requires user gesture (browser security model)
      */
     private handleAppForeground;
     /**
-     * Request microphone permission and setup audio analysis
+     * Request microphone permission with voice isolation and setup audio analysis
+     * Returns the MediaStream for ElevenLabs to reuse (prevents dual stream conflicts)
      */
     requestMicrophonePermission(options?: AudioPermissionOptions): Promise<boolean>;
+    /**
+     * Get the microphone stream for ElevenLabs to reuse
+     * CRITICAL: This prevents dual stream conflicts that break the analyser
+     */
+    getMicrophoneStream(): MediaStream | undefined;
     /**
      * Setup audio analysis for level monitoring
      */
     private setupAudioAnalysis;
     /**
-     * Start monitoring audio levels
+     * Detect voice activity (returns true if user is speaking)
+     * Used for client-side VAD to prevent background noise issues
+     */
+    private detectVoiceActivity;
+    /**
+     * Check if user has stopped speaking (silence detected)
+     * Returns true if VAD_SILENCE_DURATION has passed since last speech
+     */
+    hasUserStoppedSpeaking(): boolean;
+    /**
+     * Start monitoring audio levels with VAD detection
      */
-    startAudioLevelMonitoring(isConnected?: () => boolean): void;
+    startAudioLevelMonitoring(isConnected?: () => boolean, onSilenceDetected?: () => void): void;
     /**
      * Stop monitoring audio levels
      */

package/dist/self/SelfController.d.ts

@@ -27,6 +27,8 @@ export declare class SelfController extends SettingsObject<SelfControllerSetting
     private clientAudio;
     private unwatchAudio?;
     private isConnecting;
+    private lastUserSpeechTime;
+    private lastUserMessageTime;
     private sessionId?;
     private conversationStartTime?;
     private chatCharacterCount;
@@ -45,7 +47,17 @@ export declare class SelfController extends SettingsObject<SelfControllerSetting
         outputLevel: number;
     }>;
     getClientAudio(): ClientAudio;
+    /**
+     * Get output (agent speaking) frequency data from ElevenLabs
+     * Used by visualizer during 'speaking' mode
+     */
     getOutputFrequencyData(): Uint8Array | null;
+    /**
+     * Get input (user speaking) frequency data from ElevenLabs
+     * Used by visualizer during 'listening' mode
+     * Fallback: Uses ClientAudio analyser if ElevenLabs data unavailable
+     */
+    getInputFrequencyData(): Uint8Array | null;
     private isDuplicateMessage;
     private addMessage;
     private getDynamicSettings;

package/dist/self/schema.d.ts

@@ -10,6 +10,7 @@ export interface VoiceConnectionState {
     isConnected: boolean;
     isSpeaking: boolean;
     isListening: boolean;
+    isProcessing: boolean;
     transcript?: string;
     connectionStatus: 'connecting' | 'connected' | 'disconnected' | 'error';
     error?: string;

package/dist/self/test/SelfController.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/self/test/utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/self/ui/ElSelfAudioVisualizer.vue.d.ts

@@ -0,0 +1,10 @@
+import { SelfController } from '../SelfController';
+type __VLS_Props = {
+    selfController?: SelfController;
+    size?: 'sm' | 'md' | 'lg';
+    color?: 'blue' | 'green' | 'gray' | 'auto';
+    enableWaveMotion?: boolean;
+    enableGlow?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/self/ui/SelfWrap.vue.d.ts

@@ -47,6 +47,7 @@ declare function __VLS_template(): {
                 gender?: string | null | undefined;
                 birthdayAt?: string | null | undefined;
                 businessTemplate?: string | null | undefined;
+                onboardedAt?: string | null | undefined;
                 enrichment?: Record<string, any> | null | undefined;
                 onboarding?: Record<string, any> | null | undefined;
                 org?: {

package/dist/self.js

@@ -1,10 +1,10 @@
 var E = Object.defineProperty;
 var d = (e, l) => E(e, "name", { value: l, configurable: !0 });
-import { a as A, g as C, c as I, b as M } from "./SelfWrap.vue_vue_type_script_setup_true_lang-BM-kzpfo.js";
-import { h as q, A as J, e as K, d as X, C as Y, V as ee, f as te, k as se, i as ae, j as oe, p as ie } from "./SelfWrap.vue_vue_type_script_setup_true_lang-BM-kzpfo.js";
+import { a as A, g as C, c as I, b as M } from "./SelfWrap.vue_vue_type_script_setup_true_lang-Bh_btZUV.js";
+import { h as q, A as J, e as K, d as X, C as Y, V as ee, f as te, k as se, i as ae, j as oe, p as ie } from "./SelfWrap.vue_vue_type_script_setup_true_lang-Bh_btZUV.js";
 import { defineComponent as b, createBlock as u, openBlock as c, withCtx as k, createElementVNode as o, createVNode as O, ref as v, watch as U, nextTick as V, createElementBlock as h, createCommentVNode as f, normalizeClass as p, normalizeStyle as _, unref as x } from "vue";
-import { _ as $ } from "./FModal.vue_vue_type_script_setup_true_lang-B9Vpr1MV.js";
-import { _ as N } from "./SelfProvider.vue_vue_type_script_setup_true_lang-B-VYDrTJ.js";
+import { _ as $ } from "./FModal.vue_vue_type_script_setup_true_lang-BkRDQLfP.js";
+import { _ as N } from "./SelfProvider.vue_vue_type_script_setup_true_lang-BCjvISK2.js";
 const z = { class: "relative w-full h-[80vh] md:h-[600px]" }, P = /* @__PURE__ */ b({
   name: "SelfModal",
   __name: "SelfModal",

package/dist/widget/composables/useFictionWidget.d.ts

@@ -0,0 +1,57 @@
+import { MaybeRef } from 'vue';
+import { Self } from '@fiction/types';
+import { WidgetConfig, WidgetUpdate, FictionWidget } from '../FictionWidget';
+export interface UseFictionWidgetConfig {
+    mode: WidgetConfig['mode'];
+    handle?: MaybeRef<string | undefined>;
+    self?: MaybeRef<Self | null | undefined>;
+    context?: MaybeRef<string | undefined>;
+    firstMessage?: MaybeRef<string | undefined>;
+    apiBase?: string;
+    onClose?: () => void;
+}
+/**
+ * Composable for managing FictionWidget lifecycle with automatic initialization,
+ * reactive updates, and cleanup.
+ *
+ * Benefits:
+ * - Eliminates manual DOM timing coordination (watch + nextTick)
+ * - Automatic cleanup on unmount
+ * - Reactive prop updates via widget.update()
+ * - Prevents double initialization
+ * - Clear loading/error states
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * const selfRef = ref<Self | null>(null)
+ * const { containerRef, loading, error } = useFictionWidget({
+ *   mode: 'inline',
+ *   self: selfRef,
+ *   context: 'welcome'
+ * })
+ * </script>
+ *
+ * <template>
+ *   <div ref="containerRef" class="w-full h-full" />
+ * </template>
+ * ```
+ */
+export declare function useFictionWidget(config: UseFictionWidgetConfig): {
+    containerRef: import('vue').Ref<HTMLElement | null, HTMLElement | null>;
+    widget: import('vue').Ref<{
+        update: (updates: WidgetUpdate) => void;
+        toggle: () => void;
+        open: () => void;
+        close: () => void;
+        destroy: () => void;
+    } | null, FictionWidget | {
+        update: (updates: WidgetUpdate) => void;
+        toggle: () => void;
+        open: () => void;
+        close: () => void;
+        destroy: () => void;
+    } | null>;
+    loading: import('vue').Ref<boolean, boolean>;
+    error: import('vue').Ref<string | null, string | null>;
+};

package/dist/widget/index.d.ts

@@ -1,2 +1,4 @@
 export { FictionWidget } from './FictionWidget';
 export type { WidgetConfig, WidgetUpdate } from './FictionWidget';
+export { useFictionWidget } from './composables/useFictionWidget';
+export type { UseFictionWidgetConfig } from './composables/useFictionWidget';