@tanstack/ai-svelte 0.13.15 → 0.14.0

package/dist/create-audio-recorder.svelte.d.ts

@@ -0,0 +1,37 @@
+import type { AudioRecorderOptions, AudioRecording, InferAudioRecordingOutput } from '@tanstack/ai-client';
+export type CreateAudioRecorderOptions<TOnComplete> = AudioRecorderOptions & {
+    /**
+     * Optional transform applied to the recording when `stop()` resolves. Its
+     * (awaited) return value becomes `recording` and the resolved value of
+     * `stop()`. Return nothing to keep the raw `AudioRecording`.
+     */
+    onComplete?: TOnComplete;
+};
+export interface CreateAudioRecorderReturn<TOutput> {
+    /** Reactive: latest recording (transformed if `onComplete` provided), or null. */
+    readonly recording: TOutput | null;
+    /** Reactive: true while actively capturing audio. */
+    readonly isRecording: boolean;
+    /** Whether the browser supports recording. */
+    readonly isSupported: boolean;
+    start: () => Promise<void>;
+    /** Stop and resolve with the completed recording (transformed if `onComplete` provided). */
+    stop: () => Promise<TOutput>;
+    /**
+     * Discard the in-progress recording and release the mic. Svelte 5 runes
+     * can't register automatic teardown here (matching `createChat`), so call
+     * this from your component's cleanup if a recording may still be active.
+     */
+    cancel: () => void;
+}
+/**
+ * Svelte 5 factory for recording an audio message. The resolved recording
+ * carries `.part` (for `createChat.sendMessage`) and `.base64` (for the
+ * generation factories).
+ *
+ * Errors are delivered via `onError`. `start()` and `stop()` also reject on
+ * failure (and `stop()` rejects with `Recording cancelled` if `cancel()` runs
+ * while a stop is in flight) — handle one channel, not both.
+ */
+export declare function createAudioRecorder<TOnComplete extends (recording: AudioRecording) => unknown>(options: CreateAudioRecorderOptions<TOnComplete>): CreateAudioRecorderReturn<InferAudioRecordingOutput<TOnComplete>>;
+export declare function createAudioRecorder(options?: CreateAudioRecorderOptions<undefined>): CreateAudioRecorderReturn<AudioRecording>;

package/dist/create-audio-recorder.svelte.js

@@ -0,0 +1,36 @@
+import { AudioRecorder } from '@tanstack/ai-client';
+export function createAudioRecorder(options = {}) {
+    const recorder = new AudioRecorder({
+        ...(options.audio !== undefined && { audio: options.audio }),
+        ...(options.mimeType !== undefined && { mimeType: options.mimeType }),
+        ...(options.onError !== undefined && { onError: options.onError }),
+    });
+    let isRecording = $state(false);
+    let recording = $state(null);
+    recorder.subscribe((state) => {
+        isRecording = state === 'recording';
+    });
+    const stop = async () => {
+        const rawRecording = await recorder.stop();
+        const transformed = await options.onComplete?.(rawRecording);
+        // Only `undefined` (returning nothing) keeps the raw recording; a returned
+        // null is a real value, matching the inferred output type.
+        const output = transformed === undefined ? rawRecording : transformed;
+        recording = output;
+        return output;
+    };
+    return {
+        get recording() {
+            return recording;
+        },
+        get isRecording() {
+            return isRecording;
+        },
+        get isSupported() {
+            return AudioRecorder.isSupported();
+        },
+        start: () => recorder.start(),
+        stop,
+        cancel: () => recorder.cancel(),
+    };
+}

package/dist/create-generate-audio.svelte.d.ts

@@ -1,5 +1,5 @@
 import type { AudioGenerationResult, StreamChunk } from '@tanstack/ai';
-import type { AIDevtoolsDisplayOptions, AudioGenerateInput, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutput } from '@tanstack/ai-client';
+import type { AIDevtoolsDisplayOptions, AudioGenerateInput, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutputFromReturn } from '@tanstack/ai-client';
 /**
  * Options for the createGenerateAudio function.
  *
@@ -80,6 +80,6 @@ export interface CreateGenerateAudioReturn<TOutput = AudioGenerationResult> {
  * </div>
  * ```
  */
-export declare function createGenerateAudio<TOnResult extends ((result: AudioGenerationResult) => any) | undefined = undefined>(options: Omit<CreateGenerateAudioOptions, 'onResult'> & {
-    onResult?: TOnResult;
-}): CreateGenerateAudioReturn<InferGenerationOutput<AudioGenerationResult, TOnResult>>;
+export declare function createGenerateAudio<TTransformed = void>(options: Omit<CreateGenerateAudioOptions, 'onResult'> & {
+    onResult?: (result: AudioGenerationResult) => TTransformed;
+}): CreateGenerateAudioReturn<InferGenerationOutputFromReturn<AudioGenerationResult, TTransformed>>;

package/dist/create-generate-image.svelte.d.ts

@@ -1,5 +1,5 @@
 import type { ImageGenerationResult, StreamChunk } from '@tanstack/ai';
-import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, ImageGenerateInput, InferGenerationOutput } from '@tanstack/ai-client';
+import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, ImageGenerateInput, InferGenerationOutputFromReturn } from '@tanstack/ai-client';
 /**
  * Options for the createGenerateImage function.
  *
@@ -89,6 +89,6 @@ export interface CreateGenerateImageReturn<TOutput = ImageGenerationResult> {
  * </div>
  * ```
  */
-export declare function createGenerateImage<TOnResult extends ((result: ImageGenerationResult) => any) | undefined = undefined>(options: Omit<CreateGenerateImageOptions, 'onResult'> & {
-    onResult?: TOnResult;
-}): CreateGenerateImageReturn<InferGenerationOutput<ImageGenerationResult, TOnResult>>;
+export declare function createGenerateImage<TTransformed = void>(options: Omit<CreateGenerateImageOptions, 'onResult'> & {
+    onResult?: (result: ImageGenerationResult) => TTransformed;
+}): CreateGenerateImageReturn<InferGenerationOutputFromReturn<ImageGenerationResult, TTransformed>>;

package/dist/create-generate-speech.svelte.d.ts

@@ -1,5 +1,5 @@
 import type { StreamChunk, TTSResult } from '@tanstack/ai';
-import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutput, SpeechGenerateInput } from '@tanstack/ai-client';
+import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutputFromReturn, SpeechGenerateInput } from '@tanstack/ai-client';
 /**
  * Options for the createGenerateSpeech function.
  *
@@ -80,6 +80,6 @@ export interface CreateGenerateSpeechReturn<TOutput = TTSResult> {
  * </div>
  * ```
  */
-export declare function createGenerateSpeech<TOnResult extends ((result: TTSResult) => any) | undefined = undefined>(options: Omit<CreateGenerateSpeechOptions, 'onResult'> & {
-    onResult?: TOnResult;
-}): CreateGenerateSpeechReturn<InferGenerationOutput<TTSResult, TOnResult>>;
+export declare function createGenerateSpeech<TTransformed = void>(options: Omit<CreateGenerateSpeechOptions, 'onResult'> & {
+    onResult?: (result: TTSResult) => TTransformed;
+}): CreateGenerateSpeechReturn<InferGenerationOutputFromReturn<TTSResult, TTransformed>>;

package/dist/create-generate-video.svelte.d.ts

@@ -1,5 +1,5 @@
 import type { StreamChunk } from '@tanstack/ai';
-import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutput, VideoGenerateInput, VideoGenerateResult, VideoStatusInfo } from '@tanstack/ai-client';
+import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutputFromReturn, VideoGenerateInput, VideoGenerateResult, VideoStatusInfo } from '@tanstack/ai-client';
 /**
  * Options for the createGenerateVideo function.
  *
@@ -94,6 +94,6 @@ export interface CreateGenerateVideoReturn<TOutput = VideoGenerateResult> {
  * </div>
  * ```
  */
-export declare function createGenerateVideo<TOnResult extends ((result: VideoGenerateResult) => any) | undefined = undefined>(options: Omit<CreateGenerateVideoOptions, 'onResult'> & {
-    onResult?: TOnResult;
-}): CreateGenerateVideoReturn<InferGenerationOutput<VideoGenerateResult, TOnResult>>;
+export declare function createGenerateVideo<TTransformed = void>(options: Omit<CreateGenerateVideoOptions, 'onResult'> & {
+    onResult?: (result: VideoGenerateResult) => TTransformed;
+}): CreateGenerateVideoReturn<InferGenerationOutputFromReturn<VideoGenerateResult, TTransformed>>;

package/dist/create-generate-video.svelte.js

@@ -30,6 +30,9 @@ import { createVideoDevtoolsBridge } from '@tanstack/ai-client/devtools';
  * </div>
  * ```
  */
+// `TTransformed` infers from the `onResult` return position so the callback
+// parameter is typed as `VideoGenerateResult` and `result` narrows to the
+// transform's return. See issue #848.
 export function createGenerateVideo(options) {
     const clientId = options.id ||
         `video-${Date.now()}-${Math.random().toString(36).substring(7)}`;
@@ -54,7 +57,10 @@ export function createGenerateVideo(options) {
             hookName: 'createGenerateVideo',
             outputKind: 'video',
         },
-        onResult: (r) => options.onResult?.(r),
+        // The transform's raw return type (`TTransformed`) and the stored output
+        // (`TOutput`, with null/void/undefined stripped) are identical at runtime;
+        // the cast bridges the relationship that the conditional type hides.
+        onResult: ((r) => options.onResult?.(r)),
         onError: (e) => options.onError?.(e),
         onProgress: (p, m) => options.onProgress?.(p, m),
         onChunk: (c) => options.onChunk?.(c),

package/dist/create-generation.svelte.d.ts

@@ -1,5 +1,5 @@
 import type { StreamChunk } from '@tanstack/ai';
-import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutput } from '@tanstack/ai-client';
+import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutputFromReturn } from '@tanstack/ai-client';
 /**
  * Options for the createGeneration function.
  *
@@ -91,6 +91,6 @@ export interface CreateGenerationReturn<TOutput> {
  * </div>
  * ```
  */
-export declare function createGeneration<TInput extends Record<string, any>, TResult, TOnResult extends ((result: TResult) => any) | undefined = undefined>(options: Omit<CreateGenerationOptions<TInput, TResult>, 'onResult'> & {
-    onResult?: TOnResult;
-}): CreateGenerationReturn<InferGenerationOutput<TResult, TOnResult>>;
+export declare function createGeneration<TInput extends Record<string, any>, TResult, TTransformed = void>(options: Omit<CreateGenerationOptions<TInput, TResult>, 'onResult'> & {
+    onResult?: (result: TResult) => TTransformed;
+}): CreateGenerationReturn<InferGenerationOutputFromReturn<TResult, TTransformed>>;

package/dist/create-generation.svelte.js

@@ -31,6 +31,12 @@ import { createGenerationDevtoolsBridge } from '@tanstack/ai-client/devtools';
  * </div>
  * ```
  */
+// `TTransformed` infers from the `onResult` return position (a covariant
+// inference site that works even for an optional nested property), which types
+// the callback parameter as `TResult` and narrows `result`. Inferring the
+// whole callback as a defaulted type parameter instead collapses to the
+// default, leaving the parameter `any` — a hard error under `strict`. See
+// issue #848.
 export function createGeneration(options) {
     const clientId = options.id || `gen-${Date.now()}-${Math.random().toString(36).substring(7)}`;
     // Create reactive state using Svelte 5 runes
@@ -52,7 +58,10 @@ export function createGeneration(options) {
             framework: 'svelte',
             hookName: 'createGeneration',
         },
-        onResult: (r) => options.onResult?.(r),
+        // The transform's raw return type (`TTransformed`) and the stored output
+        // (`TOutput`, with null/void/undefined stripped) are identical at runtime;
+        // the cast bridges the relationship that the conditional type hides.
+        onResult: ((r) => options.onResult?.(r)),
         onError: (e) => options.onError?.(e),
         onProgress: (p, m) => options.onProgress?.(p, m),
         onChunk: (c) => options.onChunk?.(c),

package/dist/create-summarize.svelte.d.ts

@@ -1,5 +1,5 @@
 import type { StreamChunk, SummarizationResult } from '@tanstack/ai';
-import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutput, SummarizeGenerateInput } from '@tanstack/ai-client';
+import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutputFromReturn, SummarizeGenerateInput } from '@tanstack/ai-client';
 /**
  * Options for the createSummarize function.
  *
@@ -84,6 +84,6 @@ export interface CreateSummarizeReturn<TOutput = SummarizationResult> {
  * </div>
  * ```
  */
-export declare function createSummarize<TOnResult extends ((result: SummarizationResult) => any) | undefined = undefined>(options: Omit<CreateSummarizeOptions, 'onResult'> & {
-    onResult?: TOnResult;
-}): CreateSummarizeReturn<InferGenerationOutput<SummarizationResult, TOnResult>>;
+export declare function createSummarize<TTransformed = void>(options: Omit<CreateSummarizeOptions, 'onResult'> & {
+    onResult?: (result: SummarizationResult) => TTransformed;
+}): CreateSummarizeReturn<InferGenerationOutputFromReturn<SummarizationResult, TTransformed>>;

package/dist/create-transcription.svelte.d.ts

@@ -1,5 +1,5 @@
 import type { StreamChunk, TranscriptionResult } from '@tanstack/ai';
-import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutput, TranscriptionGenerateInput } from '@tanstack/ai-client';
+import type { AIDevtoolsDisplayOptions, ConnectConnectionAdapter, GenerationClientState, GenerationFetcher, InferGenerationOutputFromReturn, TranscriptionGenerateInput } from '@tanstack/ai-client';
 /**
  * Options for the createTranscription function.
  *
@@ -89,6 +89,6 @@ export interface CreateTranscriptionReturn<TOutput = TranscriptionResult> {
  * </div>
  * ```
  */
-export declare function createTranscription<TOnResult extends ((result: TranscriptionResult) => any) | undefined = undefined>(options: Omit<CreateTranscriptionOptions, 'onResult'> & {
-    onResult?: TOnResult;
-}): CreateTranscriptionReturn<InferGenerationOutput<TranscriptionResult, TOnResult>>;
+export declare function createTranscription<TTransformed = void>(options: Omit<CreateTranscriptionOptions, 'onResult'> & {
+    onResult?: (result: TranscriptionResult) => TTransformed;
+}): CreateTranscriptionReturn<InferGenerationOutputFromReturn<TranscriptionResult, TTransformed>>;

package/dist/index.d.ts

@@ -14,4 +14,6 @@ export { createSummarize } from './create-summarize.svelte';
 export type { CreateSummarizeOptions, CreateSummarizeReturn, } from './create-summarize.svelte';
 export { createGenerateVideo } from './create-generate-video.svelte';
 export type { CreateGenerateVideoOptions, CreateGenerateVideoReturn, } from './create-generate-video.svelte';
+export { createAudioRecorder } from './create-audio-recorder.svelte';
+export type { CreateAudioRecorderOptions, CreateAudioRecorderReturn, } from './create-audio-recorder.svelte';
 export { fetchServerSentEvents, fetchHttpStream, xhrServerSentEvents, xhrHttpStream, stream, rpcStream, createChatClientOptions, clientTools, type ConnectionAdapter, type ConnectConnectionAdapter, type SubscribeConnectionAdapter, type RunAgentInputContext, type FetchConnectionOptions, type XhrConnectionOptions, type InferChatMessages, type GenerationClientState, type ImageGenerateInput, type AudioGenerateInput, type SpeechGenerateInput, type TranscriptionGenerateInput, type SummarizeGenerateInput, type VideoGenerateInput, type VideoGenerateResult, type VideoStatusInfo, } from '@tanstack/ai-client';

package/dist/index.js

@@ -7,5 +7,6 @@ export { createGenerateSpeech } from './create-generate-speech.svelte';
 export { createTranscription } from './create-transcription.svelte';
 export { createSummarize } from './create-summarize.svelte';
 export { createGenerateVideo } from './create-generate-video.svelte';
+export { createAudioRecorder } from './create-audio-recorder.svelte';
 // Re-export from ai-client for convenience
 export { fetchServerSentEvents, fetchHttpStream, xhrServerSentEvents, xhrHttpStream, stream, rpcStream, createChatClientOptions, clientTools, } from '@tanstack/ai-client';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-svelte",
-  "version": "0.13.15",
+  "version": "0.14.0",
   "description": "Svelte 5 bindings for TanStack AI streaming chat, structured outputs, and media generation.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -46,11 +46,11 @@
     "media-generation"
   ],
   "dependencies": {
-    "@tanstack/ai-client": "0.18.6"
+    "@tanstack/ai-client": "0.19.0"
   },
   "peerDependencies": {
     "svelte": "^5.0.0",
-    "@tanstack/ai": "^0.37.0"
+    "@tanstack/ai": "^0.38.0"
   },
   "devDependencies": {
     "@standard-schema/spec": "^1.1.0",
@@ -63,7 +63,7 @@
     "svelte-check": "^4.2.0",
     "typescript": "5.9.3",
     "vite": "^7.3.3",
-    "@tanstack/ai": "0.37.0"
+    "@tanstack/ai": "0.38.0"
   },
   "scripts": {
     "clean": "rm -rf ./dist",

package/src/create-audio-recorder.svelte.ts

@@ -0,0 +1,93 @@
+import { AudioRecorder } from '@tanstack/ai-client'
+import type {
+  AudioRecorderOptions,
+  AudioRecording,
+  InferAudioRecordingOutput,
+} from '@tanstack/ai-client'
+
+export type CreateAudioRecorderOptions<TOnComplete> = AudioRecorderOptions & {
+  /**
+   * Optional transform applied to the recording when `stop()` resolves. Its
+   * (awaited) return value becomes `recording` and the resolved value of
+   * `stop()`. Return nothing to keep the raw `AudioRecording`.
+   */
+  onComplete?: TOnComplete
+}
+
+export interface CreateAudioRecorderReturn<TOutput> {
+  /** Reactive: latest recording (transformed if `onComplete` provided), or null. */
+  readonly recording: TOutput | null
+  /** Reactive: true while actively capturing audio. */
+  readonly isRecording: boolean
+  /** Whether the browser supports recording. */
+  readonly isSupported: boolean
+  start: () => Promise<void>
+  /** Stop and resolve with the completed recording (transformed if `onComplete` provided). */
+  stop: () => Promise<TOutput>
+  /**
+   * Discard the in-progress recording and release the mic. Svelte 5 runes
+   * can't register automatic teardown here (matching `createChat`), so call
+   * this from your component's cleanup if a recording may still be active.
+   */
+  cancel: () => void
+}
+
+/**
+ * Svelte 5 factory for recording an audio message. The resolved recording
+ * carries `.part` (for `createChat.sendMessage`) and `.base64` (for the
+ * generation factories).
+ *
+ * Errors are delivered via `onError`. `start()` and `stop()` also reject on
+ * failure (and `stop()` rejects with `Recording cancelled` if `cancel()` runs
+ * while a stop is in flight) — handle one channel, not both.
+ */
+export function createAudioRecorder<
+  TOnComplete extends (recording: AudioRecording) => unknown,
+>(
+  options: CreateAudioRecorderOptions<TOnComplete>,
+): CreateAudioRecorderReturn<InferAudioRecordingOutput<TOnComplete>>
+export function createAudioRecorder(
+  options?: CreateAudioRecorderOptions<undefined>,
+): CreateAudioRecorderReturn<AudioRecording>
+export function createAudioRecorder(
+  options: CreateAudioRecorderOptions<
+    (recording: AudioRecording) => unknown
+  > = {},
+): CreateAudioRecorderReturn<unknown> {
+  const recorder = new AudioRecorder({
+    ...(options.audio !== undefined && { audio: options.audio }),
+    ...(options.mimeType !== undefined && { mimeType: options.mimeType }),
+    ...(options.onError !== undefined && { onError: options.onError }),
+  })
+  let isRecording = $state(false)
+  let recording = $state<unknown>(null)
+
+  recorder.subscribe((state) => {
+    isRecording = state === 'recording'
+  })
+
+  const stop = async (): Promise<unknown> => {
+    const rawRecording = await recorder.stop()
+    const transformed = await options.onComplete?.(rawRecording)
+    // Only `undefined` (returning nothing) keeps the raw recording; a returned
+    // null is a real value, matching the inferred output type.
+    const output = transformed === undefined ? rawRecording : transformed
+    recording = output
+    return output
+  }
+
+  return {
+    get recording() {
+      return recording
+    },
+    get isRecording() {
+      return isRecording
+    },
+    get isSupported() {
+      return AudioRecorder.isSupported()
+    },
+    start: () => recorder.start(),
+    stop,
+    cancel: () => recorder.cancel(),
+  }
+}

package/src/create-generate-audio.svelte.ts

@@ -6,7 +6,7 @@ import type {
   ConnectConnectionAdapter,
   GenerationClientState,
   GenerationFetcher,
-  InferGenerationOutput,
+  InferGenerationOutputFromReturn,
 } from '@tanstack/ai-client'
 
 /**
@@ -91,15 +91,12 @@ export interface CreateGenerateAudioReturn<TOutput = AudioGenerationResult> {
  * </div>
  * ```
  */
-export function createGenerateAudio<
-  TOnResult extends ((result: AudioGenerationResult) => any) | undefined =
-    undefined,
->(
+export function createGenerateAudio<TTransformed = void>(
   options: Omit<CreateGenerateAudioOptions, 'onResult'> & {
-    onResult?: TOnResult
+    onResult?: (result: AudioGenerationResult) => TTransformed
   },
 ): CreateGenerateAudioReturn<
-  InferGenerationOutput<AudioGenerationResult, TOnResult>
+  InferGenerationOutputFromReturn<AudioGenerationResult, TTransformed>
 > {
   const devtools = {
     ...options.devtools,
@@ -110,7 +107,7 @@ export function createGenerateAudio<
   const gen = createGeneration<
     AudioGenerateInput,
     AudioGenerationResult,
-    TOnResult
+    TTransformed
   >({
     ...options,
     devtools,

package/src/create-generate-image.svelte.ts

@@ -6,7 +6,7 @@ import type {
   GenerationClientState,
   GenerationFetcher,
   ImageGenerateInput,
-  InferGenerationOutput,
+  InferGenerationOutputFromReturn,
 } from '@tanstack/ai-client'
 
 /**
@@ -100,15 +100,12 @@ export interface CreateGenerateImageReturn<TOutput = ImageGenerationResult> {
  * </div>
  * ```
  */
-export function createGenerateImage<
-  TOnResult extends ((result: ImageGenerationResult) => any) | undefined =
-    undefined,
->(
+export function createGenerateImage<TTransformed = void>(
   options: Omit<CreateGenerateImageOptions, 'onResult'> & {
-    onResult?: TOnResult
+    onResult?: (result: ImageGenerationResult) => TTransformed
   },
 ): CreateGenerateImageReturn<
-  InferGenerationOutput<ImageGenerationResult, TOnResult>
+  InferGenerationOutputFromReturn<ImageGenerationResult, TTransformed>
 > {
   const devtools = {
     ...options.devtools,
@@ -119,7 +116,7 @@ export function createGenerateImage<
   const gen = createGeneration<
     ImageGenerateInput,
     ImageGenerationResult,
-    TOnResult
+    TTransformed
   >({
     ...options,
     devtools,

package/src/create-generate-speech.svelte.ts

@@ -5,7 +5,7 @@ import type {
   ConnectConnectionAdapter,
   GenerationClientState,
   GenerationFetcher,
-  InferGenerationOutput,
+  InferGenerationOutputFromReturn,
   SpeechGenerateInput,
 } from '@tanstack/ai-client'
 
@@ -91,20 +91,20 @@ export interface CreateGenerateSpeechReturn<TOutput = TTSResult> {
  * </div>
  * ```
  */
-export function createGenerateSpeech<
-  TOnResult extends ((result: TTSResult) => any) | undefined = undefined,
->(
+export function createGenerateSpeech<TTransformed = void>(
   options: Omit<CreateGenerateSpeechOptions, 'onResult'> & {
-    onResult?: TOnResult
+    onResult?: (result: TTSResult) => TTransformed
   },
-): CreateGenerateSpeechReturn<InferGenerationOutput<TTSResult, TOnResult>> {
+): CreateGenerateSpeechReturn<
+  InferGenerationOutputFromReturn<TTSResult, TTransformed>
+> {
   const devtools = {
     ...options.devtools,
     framework: 'svelte',
     hookName: 'createGenerateSpeech',
     outputKind: 'audio' as const,
   }
-  const gen = createGeneration<SpeechGenerateInput, TTSResult, TOnResult>({
+  const gen = createGeneration<SpeechGenerateInput, TTSResult, TTransformed>({
     ...options,
     devtools,
   })

package/src/create-generate-video.svelte.ts

@@ -6,7 +6,7 @@ import type {
   ConnectConnectionAdapter,
   GenerationClientState,
   GenerationFetcher,
-  InferGenerationOutput,
+  InferGenerationOutputFromReturn,
   VideoGenerateInput,
   VideoGenerateResult,
   VideoStatusInfo,
@@ -108,17 +108,20 @@ export interface CreateGenerateVideoReturn<TOutput = VideoGenerateResult> {
  * </div>
  * ```
  */
-export function createGenerateVideo<
-  TOnResult extends ((result: VideoGenerateResult) => any) | undefined =
-    undefined,
->(
+// `TTransformed` infers from the `onResult` return position so the callback
+// parameter is typed as `VideoGenerateResult` and `result` narrows to the
+// transform's return. See issue #848.
+export function createGenerateVideo<TTransformed = void>(
   options: Omit<CreateGenerateVideoOptions, 'onResult'> & {
-    onResult?: TOnResult
+    onResult?: (result: VideoGenerateResult) => TTransformed
   },
 ): CreateGenerateVideoReturn<
-  InferGenerationOutput<VideoGenerateResult, TOnResult>
+  InferGenerationOutputFromReturn<VideoGenerateResult, TTransformed>
 > {
-  type TOutput = InferGenerationOutput<VideoGenerateResult, TOnResult>
+  type TOutput = InferGenerationOutputFromReturn<
+    VideoGenerateResult,
+    TTransformed
+  >
   const clientId =
     options.id ||
     `video-${Date.now()}-${Math.random().toString(36).substring(7)}`
@@ -145,7 +148,12 @@ export function createGenerateVideo<
       hookName: 'createGenerateVideo',
       outputKind: 'video' as const,
     },
-    onResult: (r: VideoGenerateResult) => options.onResult?.(r),
+    // The transform's raw return type (`TTransformed`) and the stored output
+    // (`TOutput`, with null/void/undefined stripped) are identical at runtime;
+    // the cast bridges the relationship that the conditional type hides.
+    onResult: ((r: VideoGenerateResult) => options.onResult?.(r)) as (
+      result: VideoGenerateResult,
+    ) => TOutput | null | void,
     onError: (e: Error) => options.onError?.(e),
     onProgress: (p: number, m?: string) => options.onProgress?.(p, m),
     onChunk: (c: StreamChunk) => options.onChunk?.(c),

package/src/create-generation.svelte.ts

@@ -7,7 +7,7 @@ import type {
   GenerationClientOptions,
   GenerationClientState,
   GenerationFetcher,
-  InferGenerationOutput,
+  InferGenerationOutputFromReturn,
 } from '@tanstack/ai-client'
 
 /**
@@ -103,16 +103,24 @@ export interface CreateGenerationReturn<TOutput> {
  * </div>
  * ```
  */
+// `TTransformed` infers from the `onResult` return position (a covariant
+// inference site that works even for an optional nested property), which types
+// the callback parameter as `TResult` and narrows `result`. Inferring the
+// whole callback as a defaulted type parameter instead collapses to the
+// default, leaving the parameter `any` — a hard error under `strict`. See
+// issue #848.
 export function createGeneration<
   TInput extends Record<string, any>,
   TResult,
-  TOnResult extends ((result: TResult) => any) | undefined = undefined,
+  TTransformed = void,
 >(
   options: Omit<CreateGenerationOptions<TInput, TResult>, 'onResult'> & {
-    onResult?: TOnResult
+    onResult?: (result: TResult) => TTransformed
   },
-): CreateGenerationReturn<InferGenerationOutput<TResult, TOnResult>> {
-  type TOutput = InferGenerationOutput<TResult, TOnResult>
+): CreateGenerationReturn<
+  InferGenerationOutputFromReturn<TResult, TTransformed>
+> {
+  type TOutput = InferGenerationOutputFromReturn<TResult, TTransformed>
   const clientId =
     options.id || `gen-${Date.now()}-${Math.random().toString(36).substring(7)}`
 
@@ -136,7 +144,12 @@ export function createGeneration<
       framework: 'svelte',
       hookName: 'createGeneration',
     },
-    onResult: (r: TResult) => options.onResult?.(r),
+    // The transform's raw return type (`TTransformed`) and the stored output
+    // (`TOutput`, with null/void/undefined stripped) are identical at runtime;
+    // the cast bridges the relationship that the conditional type hides.
+    onResult: ((r: TResult) => options.onResult?.(r)) as (
+      result: TResult,
+    ) => TOutput | null | void,
     onError: (e: Error) => options.onError?.(e),
     onProgress: (p: number, m?: string) => options.onProgress?.(p, m),
     onChunk: (c: StreamChunk) => options.onChunk?.(c),

package/src/create-summarize.svelte.ts

@@ -5,7 +5,7 @@ import type {
   ConnectConnectionAdapter,
   GenerationClientState,
   GenerationFetcher,
-  InferGenerationOutput,
+  InferGenerationOutputFromReturn,
   SummarizeGenerateInput,
 } from '@tanstack/ai-client'
 
@@ -95,15 +95,12 @@ export interface CreateSummarizeReturn<TOutput = SummarizationResult> {
  * </div>
  * ```
  */
-export function createSummarize<
-  TOnResult extends ((result: SummarizationResult) => any) | undefined =
-    undefined,
->(
+export function createSummarize<TTransformed = void>(
   options: Omit<CreateSummarizeOptions, 'onResult'> & {
-    onResult?: TOnResult
+    onResult?: (result: SummarizationResult) => TTransformed
   },
 ): CreateSummarizeReturn<
-  InferGenerationOutput<SummarizationResult, TOnResult>
+  InferGenerationOutputFromReturn<SummarizationResult, TTransformed>
 > {
   const devtools = {
     ...options.devtools,
@@ -114,7 +111,7 @@ export function createSummarize<
   const gen = createGeneration<
     SummarizeGenerateInput,
     SummarizationResult,
-    TOnResult
+    TTransformed
   >({
     ...options,
     devtools,

package/src/create-transcription.svelte.ts

@@ -5,7 +5,7 @@ import type {
   ConnectConnectionAdapter,
   GenerationClientState,
   GenerationFetcher,
-  InferGenerationOutput,
+  InferGenerationOutputFromReturn,
   TranscriptionGenerateInput,
 } from '@tanstack/ai-client'
 
@@ -100,15 +100,12 @@ export interface CreateTranscriptionReturn<TOutput = TranscriptionResult> {
  * </div>
  * ```
  */
-export function createTranscription<
-  TOnResult extends ((result: TranscriptionResult) => any) | undefined =
-    undefined,
->(
+export function createTranscription<TTransformed = void>(
   options: Omit<CreateTranscriptionOptions, 'onResult'> & {
-    onResult?: TOnResult
+    onResult?: (result: TranscriptionResult) => TTransformed
   },
 ): CreateTranscriptionReturn<
-  InferGenerationOutput<TranscriptionResult, TOnResult>
+  InferGenerationOutputFromReturn<TranscriptionResult, TTransformed>
 > {
   const devtools = {
     ...options.devtools,
@@ -119,7 +116,7 @@ export function createTranscription<
   const gen = createGeneration<
     TranscriptionGenerateInput,
     TranscriptionResult,
-    TOnResult
+    TTransformed
   >({
     ...options,
     devtools,

package/src/index.ts

@@ -50,6 +50,12 @@ export type {
   CreateGenerateVideoReturn,
 } from './create-generate-video.svelte'
 
+export { createAudioRecorder } from './create-audio-recorder.svelte'
+export type {
+  CreateAudioRecorderOptions,
+  CreateAudioRecorderReturn,
+} from './create-audio-recorder.svelte'
+
 // Re-export from ai-client for convenience
 export {
   fetchServerSentEvents,