@ai-sdk/vue 4.0.107 → 4.0.108

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @ai-sdk/vue
 
+## 4.0.108
+
+### Patch Changes
+
+- 73ec701: feat(vue): add configurable useChat message update throttling
+- Updated dependencies [3f6852a]
+- Updated dependencies [6317504]
+- Updated dependencies [3cb2dcd]
+- Updated dependencies [ccf98e7]
+  - ai@7.0.108
+
 ## 4.0.107
 
 ### Patch Changes

package/dist/index.d.ts

@@ -108,6 +108,14 @@ interface UseChatHelpers<UI_MESSAGE extends UIMessage> extends Pick<AbstractChat
      */
     messages: ShallowRef<UI_MESSAGE[]>;
 }
+type UseChatOptions<UI_MESSAGE extends UIMessage> = ChatInit<UI_MESSAGE> & {
+    /**
+     * Custom throttle wait time in milliseconds for reactive message updates.
+     * Positive values enable throttling. Defaults to undefined, which disables
+     * throttling.
+     */
+    throttle?: number;
+};
 /**
  * Composable to access messages, status, and other chat properties and
  * methods. Accepts an optional reactive initial configuration object
@@ -124,7 +132,7 @@ interface UseChatHelpers<UI_MESSAGE extends UIMessage> extends Pick<AbstractChat
  *
  * @see BaseChatInit
  */
-declare function useChat<UI_MESSAGE extends UIMessage = UIMessage>(init?: MaybeRefOrGetter<ChatInit<UI_MESSAGE>>): UseChatHelpers<UI_MESSAGE>;
+declare function useChat<UI_MESSAGE extends UIMessage = UIMessage>(init?: MaybeRefOrGetter<UseChatOptions<UI_MESSAGE>>): UseChatHelpers<UI_MESSAGE>;
 
 /**
  * @deprecated Use `useObject` instead.
@@ -139,4 +147,4 @@ type Experimental_UseObjectOptions<SCHEMA extends FlexibleSchema$1, RESULT> = Us
  */
 type Experimental_UseObjectHelpers<RESULT, INPUT> = UseObjectHelpers<RESULT, INPUT>;
 
-export { Chat, Experimental_UseObjectHelpers, Experimental_UseObjectOptions, UseChatHelpers, UseCompletionHelpers, UseObjectHelpers, UseObjectOptions, experimental_useObject, useChat, useCompletion, useObject };
+export { Chat, Experimental_UseObjectHelpers, Experimental_UseObjectOptions, UseChatHelpers, UseChatOptions, UseCompletionHelpers, UseObjectHelpers, UseObjectOptions, experimental_useObject, useChat, useCompletion, useObject };

package/dist/index.js

@@ -294,11 +294,178 @@ import {
 } from "ai";
 import {
   computed,
+  getCurrentScope,
+  onScopeDispose,
   shallowRef,
   toValue,
-  triggerRef,
   watch
 } from "vue";
+function cloneMetadata(metadata) {
+  if (Array.isArray(metadata)) {
+    return [...metadata];
+  }
+  if (metadata != null && typeof metadata === "object" && (Object.getPrototypeOf(metadata) === Object.prototype || Object.getPrototypeOf(metadata) === null)) {
+    return { ...metadata };
+  }
+  return metadata;
+}
+function snapshotValue(value) {
+  if (value == null || typeof value !== "object" || !("parts" in value) || !Array.isArray(value.parts)) {
+    return value;
+  }
+  const message = value;
+  const snapshot = {
+    ...message,
+    parts: message.parts.map((part) => ({ ...part }))
+  };
+  if ("metadata" in message) {
+    snapshot.metadata = cloneMetadata(message.metadata);
+  }
+  return snapshot;
+}
+var VueChatState2 = class {
+  constructor({
+    initialMessages,
+    messagesRef,
+    statusRef,
+    errorRef,
+    throttleWaitMs
+  }) {
+    this.publishedMessages = [];
+    this.publishedMessageSources = [];
+    this.dirtyMessageIndices = /* @__PURE__ */ new Set();
+    this.statusValue = "ready";
+    this.hasPendingPublication = false;
+    this.isActive = true;
+    this.isPublishing = false;
+    this.pushMessage = (message) => {
+      this.messagesValue.push(message);
+      this.dirtyMessageIndices.add(this.messagesValue.length - 1);
+      this.schedulePublication();
+    };
+    this.popMessage = () => {
+      this.messagesValue.pop();
+      this.schedulePublication();
+    };
+    this.replaceMessage = (index, message) => {
+      this.messagesValue[index] = message;
+      this.dirtyMessageIndices.add(index);
+      this.schedulePublication();
+    };
+    this.snapshot = snapshotValue;
+    this.handleIntervalEnd = () => {
+      this.timeout = void 0;
+      if (!this.isActive || !this.hasPendingPublication) {
+        return;
+      }
+      this.hasPendingPublication = false;
+      this.publishMessages();
+      this.timeout = setTimeout(this.handleIntervalEnd, this.throttleWaitMs);
+    };
+    this.messagesValue = initialMessages;
+    this.messagesRef = messagesRef;
+    this.statusRef = statusRef;
+    this.errorRef = errorRef;
+    this.throttleWaitMs = throttleWaitMs != null && Number.isFinite(throttleWaitMs) && throttleWaitMs > 0 ? throttleWaitMs : void 0;
+  }
+  get messages() {
+    return this.messagesValue;
+  }
+  set messages(messages) {
+    const previousMessages = this.messagesValue;
+    this.messagesValue = messages;
+    for (let index = 0; index < messages.length; index++) {
+      if (messages[index] !== previousMessages[index]) {
+        this.dirtyMessageIndices.add(index);
+      }
+    }
+    this.schedulePublication();
+  }
+  get status() {
+    return this.statusValue;
+  }
+  set status(status) {
+    this.statusValue = status;
+    if (!this.isActive) {
+      return;
+    }
+    if (status === "ready" || status === "error") {
+      this.flushPublication();
+    }
+    this.statusRef.value = status;
+  }
+  get error() {
+    return this.errorValue;
+  }
+  set error(error) {
+    this.errorValue = error;
+    if (this.isActive) {
+      this.errorRef.value = error;
+    }
+  }
+  publishInitialState() {
+    this.publishMessages();
+    this.statusRef.value = this.statusValue;
+    this.errorRef.value = this.errorValue;
+  }
+  setMessagesFromConsumer(messages) {
+    this.messagesValue = messages;
+    this.publishedMessages = messages;
+    this.publishedMessageSources = messages;
+    this.dirtyMessageIndices.clear();
+  }
+  dispose() {
+    this.isActive = false;
+    this.hasPendingPublication = false;
+    this.dirtyMessageIndices.clear();
+    this.publishedMessages = [];
+    this.publishedMessageSources = [];
+    if (this.timeout != null) {
+      clearTimeout(this.timeout);
+      this.timeout = void 0;
+    }
+  }
+  schedulePublication() {
+    if (!this.isActive) {
+      return;
+    }
+    if (this.throttleWaitMs == null) {
+      this.publishMessages();
+      return;
+    }
+    if (this.timeout == null) {
+      this.publishMessages();
+      this.timeout = setTimeout(this.handleIntervalEnd, this.throttleWaitMs);
+    } else {
+      this.hasPendingPublication = true;
+    }
+  }
+  flushPublication() {
+    if (this.timeout != null) {
+      clearTimeout(this.timeout);
+      this.timeout = void 0;
+    }
+    this.hasPendingPublication = false;
+    this.publishMessages();
+  }
+  publishMessages() {
+    if (!this.isActive) {
+      return;
+    }
+    const publishedMessages = this.messagesValue.map(
+      (message, index) => this.dirtyMessageIndices.has(index) || this.publishedMessageSources[index] !== message ? snapshotValue(message) : this.publishedMessages[index]
+    );
+    this.publishedMessages = publishedMessages;
+    this.publishedMessageSources = [...this.messagesValue];
+    this.dirtyMessageIndices.clear();
+    this.isPublishing = true;
+    try {
+      this.messagesRef.value = publishedMessages;
+    } finally {
+      this.isPublishing = false;
+    }
+  }
+};
 var VueChat = class extends AbstractChat2 {
   constructor({
     state,
@@ -314,54 +481,44 @@ function useChat(init) {
   const messages = shallowRef([]);
   const status = shallowRef("ready");
   const error = shallowRef();
-  const chatStateWrapper = {
-    get messages() {
-      return messages.value;
-    },
-    set messages(messageList) {
-      messages.value = messageList;
-    },
-    get status() {
-      return status.value;
-    },
-    set status(statusValue) {
-      status.value = statusValue;
-    },
-    get error() {
-      return error.value;
-    },
-    set error(errorValue) {
-      error.value = errorValue;
-    },
-    pushMessage(message) {
-      messages.value.push(message);
-      triggerRef(messages);
-    },
-    popMessage() {
-      messages.value.pop();
-      triggerRef(messages);
-    },
-    replaceMessage(index, message) {
-      messages.value[index] = { ...message };
-      triggerRef(messages);
-    },
-    snapshot: (value) => value
-  };
   const chatInstance = shallowRef();
+  let chatState;
+  watch(
+    messages,
+    (messageList) => {
+      if (chatState != null && !chatState.isPublishing) {
+        chatState.setMessagesFromConsumer(messageList);
+      }
+    },
+    { flush: "sync" }
+  );
   watch(
     () => toValue(init),
     (opts) => {
       var _a;
-      messages.value = (_a = opts == null ? void 0 : opts.messages) != null ? _a : [];
-      status.value = "ready";
-      error.value = void 0;
+      chatState == null ? void 0 : chatState.dispose();
+      const { throttle, ...chatInit } = opts != null ? opts : {};
+      const nextChatState = new VueChatState2({
+        initialMessages: (_a = chatInit.messages) != null ? _a : [],
+        messagesRef: messages,
+        statusRef: status,
+        errorRef: error,
+        throttleWaitMs: throttle
+      });
+      chatState = nextChatState;
+      nextChatState.publishInitialState();
       chatInstance.value = new VueChat({
-        ...opts,
-        state: chatStateWrapper
+        ...chatInit,
+        state: nextChatState
       });
     },
     { immediate: true }
   );
+  if (getCurrentScope() != null) {
+    onScopeDispose(() => {
+      chatState == null ? void 0 : chatState.dispose();
+    });
+  }
   return {
     id: computed(() => chatInstance.value.id),
     status,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/use-object.ts","../src/use-completion.ts","../src/chat.vue.ts","../src/use-chat.ts","../src/index.ts"],"sourcesContent":["import {\n  isAbortError,\n  safeValidateTypes,\n  type FetchFunction,\n} from '@ai-sdk/provider-utils';\nimport {\n  asSchema,\n  isDeepEqualData,\n  parsePartialJson,\n  type DeepPartial,\n  type FlexibleSchema,\n  type InferSchema,\n} from 'ai';\nimport type * as SwrvModule from 'swrv';\nimport swrv from 'swrv';\nimport { ref, type Ref } from 'vue';\n// use function to allow for mocking in tests\nconst getOriginalFetch = () => fetch;\n\nexport type UseObjectOptions<SCHEMA extends FlexibleSchema, RESULT> = {\n  /** API endpoint that streams JSON chunks matching the schema */\n  api: string;\n\n  /** Schema that defines the final object shape */\n  schema: SCHEMA;\n\n  /** Shared state key. If omitted a random one is generated */\n  id?: string;\n\n  /** Initial partial value */\n  initialValue?: DeepPartial<RESULT>;\n\n  /** Optional custom fetch implementation */\n  fetch?: FetchFunction;\n\n  /** Called when stream ends */\n  onFinish?: (event: {\n    object: RESULT | undefined;\n    error: Error | undefined;\n  }) => Promise<void> | void;\n\n  /** Called on error */\n  onError?: (error: Error) => void;\n\n  /** Extra request headers */\n  headers?: Record<string, string> | Headers;\n\n  /** Request credentials mode. Defaults to 'same-origin' if omitted */\n  credentials?: RequestCredentials;\n};\n\nexport type UseObjectHelpers<RESULT, INPUT> = {\n  /** POST the input and start streaming */\n  submit: (input: INPUT) => void;\n\n  /** Current partial object, updated as chunks arrive */\n  object: Ref<DeepPartial<RESULT> | undefined>;\n\n  /** Latest error if any */\n  error: Ref<Error | undefined>;\n\n  /** Loading flag for the in-flight request */\n  isLoading: Ref<boolean | undefined>;\n\n  /** Abort the current request. Keeps current partial object. */\n  stop: () => void;\n\n  /** Abort and clear all state */\n  clear: () => void;\n};\n\nlet uniqueId = 0;\n\n// @ts-expect-error - some issues with the default export of useSWRV\nconst useSWRV = (swrv.default as (typeof SwrvModule)['default']) || swrv;\nconst store: Record<string, any> = {};\n\nexport function useObject<\n  SCHEMA extends FlexibleSchema,\n  RESULT = InferSchema<SCHEMA>,\n  INPUT = any,\n>({\n  api,\n  id,\n  schema,\n  initialValue,\n  fetch,\n  onError,\n  onFinish,\n  headers,\n  credentials,\n}: UseObjectOptions<SCHEMA, RESULT>): UseObjectHelpers<RESULT, INPUT> {\n  // Generate an unique id for the object if not provided.\n  const completionId = id || `completion-${uniqueId++}`;\n\n  const key = `${api}|${completionId}`;\n  const { data, mutate: originalMutate } = useSWRV<\n    DeepPartial<RESULT> | undefined\n  >(key, () => (key in store ? store[key] : initialValue));\n\n  const { data: isLoading, mutate: mutateLoading } = useSWRV<boolean>(\n    `${completionId}-loading`,\n    null,\n  );\n\n  isLoading.value ??= false;\n  data.value ||= initialValue as DeepPartial<RESULT> | undefined;\n\n  const mutateObject = (value: DeepPartial<RESULT> | undefined) => {\n    store[key] = value;\n    return originalMutate();\n  };\n\n  const error = ref<Error | undefined>(undefined);\n  let abortController: AbortController | null = null;\n\n  const stop = async () => {\n    if (abortController) {\n      try {\n        abortController.abort();\n      } catch {\n        // ignore\n      } finally {\n        abortController = null;\n      }\n    }\n    await mutateLoading(() => false);\n  };\n\n  const clearObject = async () => {\n    error.value = undefined;\n    await mutateLoading(() => false);\n    await mutateObject(undefined);\n    // Need to explicitly set the value to undefined to trigger a re-render\n    data.value = undefined;\n  };\n\n  const clear = async () => {\n    await stop();\n    await clearObject();\n  };\n\n  const submit = async (input: INPUT) => {\n    try {\n      await clearObject();\n      await mutateLoading(() => true);\n\n      abortController = new AbortController();\n\n      const actualFetch = fetch ?? getOriginalFetch();\n      const response = await actualFetch(api, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          ...(headers as any),\n        },\n        credentials: credentials ?? 'same-origin',\n        signal: abortController.signal,\n        body: JSON.stringify(input),\n      });\n\n      if (!response.ok) {\n        throw new Error(\n          (await response.text()) || 'Failed to fetch the response.',\n        );\n      }\n\n      if (!response.body) {\n        throw new Error('The response body is empty.');\n      }\n\n      let accumulatedText = '';\n      let latestObject: DeepPartial<RESULT> | undefined = undefined;\n\n      await response.body.pipeThrough(new TextDecoderStream()).pipeTo(\n        new WritableStream<string>({\n          async write(chunk) {\n            accumulatedText += chunk;\n            const { value } = await parsePartialJson(accumulatedText);\n            const currentObject = value as DeepPartial<RESULT>;\n            if (!isDeepEqualData(latestObject, currentObject)) {\n              latestObject = currentObject;\n              await mutateObject(currentObject);\n            }\n          },\n          async close() {\n            await mutateLoading(() => false);\n            abortController = null;\n\n            if (onFinish) {\n              const validationResult = await safeValidateTypes({\n                value: latestObject,\n                schema: asSchema(schema),\n              });\n\n              onFinish(\n                validationResult.success\n                  ? {\n                      object: validationResult.value as RESULT,\n                      error: undefined,\n                    }\n                  : { object: undefined, error: validationResult.error },\n              );\n            }\n          },\n        }),\n      );\n    } catch (err: unknown) {\n      if (isAbortError(err)) return;\n\n      if (onError && err instanceof Error) onError(err);\n\n      await mutateLoading(() => false);\n      error.value = err instanceof Error ? err : new Error(String(err));\n    }\n  };\n\n  return {\n    submit,\n    object: data,\n    error,\n    isLoading,\n    stop,\n    clear,\n  };\n}\n","import {\n  callCompletionApi,\n  type CompletionRequestOptions,\n  type UseCompletionOptions,\n} from 'ai';\nimport type * as SwrvModule from 'swrv';\nimport swrv from 'swrv';\nimport { ref, unref, type Ref } from 'vue';\nexport type { UseCompletionOptions };\n\nexport type UseCompletionHelpers<BODY extends object = object> = {\n  /** The current completion result */\n  completion: Ref<string>;\n  /** The error object of the API request */\n  error: Ref<undefined | Error>;\n  /**\n   * Send a new prompt to the API endpoint and update the completion state.\n   */\n  complete: (\n    prompt: string,\n    options?: CompletionRequestOptions<BODY>,\n  ) => Promise<string | null | undefined>;\n  /**\n   * Abort the current API request but keep the generated tokens.\n   */\n  stop: () => void;\n  /**\n   * Update the `completion` state locally.\n   */\n  setCompletion: (completion: string) => void;\n  /** The current value of the input */\n  input: Ref<string>;\n  /**\n   * Form submission handler to automatically reset input and append a user message\n   * @example\n   * ```jsx\n   * <form @submit=\"handleSubmit\">\n   *  <input @change=\"handleInputChange\" v-model=\"input\" />\n   * </form>\n   * ```\n   */\n  handleSubmit: (event?: { preventDefault?: () => void }) => void;\n  /** Whether the API request is in progress */\n  isLoading: Ref<boolean | undefined>;\n};\n\nlet uniqueId = 0;\n\n// @ts-expect-error - some issues with the default export of useSWRV\nconst useSWRV = (swrv.default as (typeof SwrvModule)['default']) || swrv;\nconst store: Record<string, any> = {};\n\nexport function useCompletion<BODY extends object = object>({\n  api = '/api/completion',\n  id,\n  initialCompletion = '',\n  initialInput = '',\n  credentials,\n  headers,\n  body,\n  streamProtocol,\n  onFinish,\n  onError,\n  fetch,\n}: UseCompletionOptions<NoInfer<BODY>> = {}): UseCompletionHelpers<BODY> {\n  // Generate an unique id for the completion if not provided.\n  const completionId = id || `completion-${uniqueId++}`;\n\n  const key = `${api}|${completionId}`;\n  const { data, mutate: originalMutate } = useSWRV<string>(\n    key,\n    () => store[key] ?? initialCompletion,\n  );\n\n  const { data: isLoading, mutate: mutateLoading } = useSWRV<boolean>(\n    `${completionId}-loading`,\n    null,\n  );\n\n  isLoading.value ??= false;\n\n  // Force the `data` to be `initialCompletion` if it's `undefined`.\n  data.value ??= initialCompletion;\n\n  const mutate = (data: string) => {\n    store[key] = data;\n    return originalMutate();\n  };\n\n  // Because of the `initialData` option, the `data` will never be `undefined`.\n  const completion = data as Ref<string>;\n\n  const error = ref<undefined | Error>(undefined);\n\n  let abortController: AbortController | null = null;\n\n  async function triggerRequest(\n    prompt: string,\n    options?: CompletionRequestOptions<BODY>,\n  ) {\n    return callCompletionApi({\n      api,\n      prompt,\n      credentials,\n      headers: {\n        ...headers,\n        ...options?.headers,\n      },\n      body: {\n        ...unref(body),\n        ...options?.body,\n      },\n      streamProtocol,\n      setCompletion: mutate,\n      setLoading: loading => mutateLoading(() => loading),\n      setError: err => {\n        error.value = err;\n      },\n      setAbortController: controller => {\n        abortController = controller;\n      },\n      onFinish,\n      onError,\n      fetch,\n    });\n  }\n\n  const complete: UseCompletionHelpers<BODY>['complete'] = async (\n    prompt,\n    options,\n  ) => {\n    return triggerRequest(prompt, options);\n  };\n\n  const stop = () => {\n    if (abortController) {\n      abortController.abort();\n      abortController = null;\n    }\n  };\n\n  const setCompletion = (completion: string) => {\n    mutate(completion);\n  };\n\n  const input = ref(initialInput);\n\n  const handleSubmit = (event?: { preventDefault?: () => void }) => {\n    event?.preventDefault?.();\n    const inputValue = input.value;\n    return inputValue ? complete(inputValue) : undefined;\n  };\n\n  return {\n    completion,\n    complete,\n    error,\n    stop,\n    setCompletion,\n    input,\n    handleSubmit,\n    isLoading,\n  };\n}\n","import {\n  AbstractChat,\n  type ChatInit,\n  type ChatState,\n  type ChatStatus,\n  type UIMessage,\n} from 'ai';\nimport { ref, type Ref } from 'vue';\nclass VueChatState<\n  UI_MESSAGE extends UIMessage,\n> implements ChatState<UI_MESSAGE> {\n  private messagesRef: Ref<UI_MESSAGE[]>;\n  private statusRef = ref<ChatStatus>('ready');\n  private errorRef = ref<Error | undefined>(undefined);\n\n  constructor(messages?: UI_MESSAGE[]) {\n    this.messagesRef = ref(messages ?? []) as Ref<UI_MESSAGE[]>;\n  }\n\n  get messages(): UI_MESSAGE[] {\n    return this.messagesRef.value;\n  }\n\n  set messages(messages: UI_MESSAGE[]) {\n    this.messagesRef.value = messages;\n  }\n\n  get status(): ChatStatus {\n    return this.statusRef.value;\n  }\n\n  set status(status: ChatStatus) {\n    this.statusRef.value = status;\n  }\n\n  get error(): Error | undefined {\n    return this.errorRef.value;\n  }\n\n  set error(error: Error | undefined) {\n    this.errorRef.value = error;\n  }\n\n  pushMessage = (message: UI_MESSAGE) => {\n    this.messagesRef.value = [...this.messagesRef.value, message];\n  };\n\n  popMessage = () => {\n    this.messagesRef.value = this.messagesRef.value.slice(0, -1);\n  };\n\n  replaceMessage = (index: number, message: UI_MESSAGE) => {\n    // message is cloned here because vue's deep reactivity shows unexpected behavior, particularly when updating tool invocation parts\n    this.messagesRef.value[index] = { ...message };\n  };\n\n  snapshot = <T>(value: T): T => value;\n}\n\n/**\n * @deprecated Use the {@link useChat} composable instead. It exposes reactive\n * refs and automatically recreates the chat when its init object changes.\n */\nexport class Chat<\n  UI_MESSAGE extends UIMessage,\n> extends AbstractChat<UI_MESSAGE> {\n  constructor({ messages, ...init }: ChatInit<UI_MESSAGE>) {\n    super({\n      ...init,\n      state: new VueChatState(messages),\n    });\n  }\n}\n","import {\n  AbstractChat,\n  type ChatInit as BaseChatInit,\n  type ChatInit,\n  type ChatState,\n  type ChatStatus,\n  type UIMessage,\n} from 'ai';\nimport {\n  computed,\n  shallowRef,\n  toValue,\n  triggerRef,\n  watch,\n  type ComputedRef,\n  type MaybeRefOrGetter,\n  type ShallowRef,\n} from 'vue';\n\n/**\n * @internal\n */\nexport class VueChat<\n  UI_MESSAGE extends UIMessage,\n> extends AbstractChat<UI_MESSAGE> {\n  constructor({\n    state,\n    ...init\n  }: Omit<ChatInit<UI_MESSAGE>, 'messages'> & {\n    state: ChatState<UI_MESSAGE>;\n  }) {\n    super({\n      ...init,\n      state,\n    });\n  }\n}\n\n/**\n * Return type of the {@link useChat} composable, which includes the chat\n * instance methods and reactive properties for messages, status, and error.\n */\nexport interface UseChatHelpers<UI_MESSAGE extends UIMessage> extends Pick<\n  AbstractChat<UI_MESSAGE>,\n  | 'sendMessage'\n  | 'regenerate'\n  | 'stop'\n  | 'resumeStream'\n  | 'addToolOutput'\n  | 'addToolApprovalResponse'\n  | 'clearError'\n> {\n  /**\n   * The id of the chat.\n   */\n  id: ComputedRef<string>;\n\n  /**\n   * The current error state of the chat, if any.\n   */\n  error: ShallowRef<Error | undefined>;\n\n  /**\n   * The current status of the chat, which can be 'ready', 'generating', 'streaming', or 'error'.\n   */\n  status: ShallowRef<ChatStatus>;\n\n  /**\n   * The list of messages in the chat, which can be updated by the chat instance methods or directly by setting this property.\n   */\n  messages: ShallowRef<UI_MESSAGE[]>;\n}\n\n/**\n * Composable to access messages, status, and other chat properties and\n * methods. Accepts an optional reactive initial configuration object\n *\n * @example\n *\n * ```ts\n * // passing a getter if any reactive properties are used within\n * // the init object\n * const { messages, sendMessage } = useChat(() => ({\n *   // ...\n * })\n * ```\n *\n * @see BaseChatInit\n */\nexport function useChat<UI_MESSAGE extends UIMessage = UIMessage>(\n  init?: MaybeRefOrGetter<BaseChatInit<UI_MESSAGE>>,\n): UseChatHelpers<UI_MESSAGE> {\n  const messages = shallowRef<UI_MESSAGE[]>([]);\n  const status = shallowRef<ChatStatus>('ready');\n  const error = shallowRef<Error | undefined>();\n\n  // this wrapper doesn't need to be reactive and can be reused across chat\n  // instance changes, because the inner refs are reactive and the wrapper\n  // methods trigger updates when needed\n  const chatStateWrapper = {\n    get messages(): UI_MESSAGE[] {\n      return messages.value;\n    },\n\n    set messages(messageList: UI_MESSAGE[]) {\n      messages.value = messageList;\n    },\n\n    get status(): ChatStatus {\n      return status.value;\n    },\n\n    set status(statusValue: ChatStatus) {\n      status.value = statusValue;\n    },\n\n    get error(): Error | undefined {\n      return error.value;\n    },\n\n    set error(errorValue: Error | undefined) {\n      error.value = errorValue;\n    },\n\n    pushMessage(message: UI_MESSAGE) {\n      messages.value.push(message);\n      // needed because messagesRef is a shallowRef\n      triggerRef(messages);\n    },\n\n    popMessage() {\n      messages.value.pop();\n      triggerRef(messages);\n    },\n\n    replaceMessage(index: number, message: UI_MESSAGE) {\n      // message is cloned here because vue's deep reactivity shows unexpected behavior, particularly when updating tool invocation parts\n      messages.value[index] = { ...message };\n      triggerRef(messages);\n    },\n\n    snapshot: <T>(value: T): T => value,\n  } satisfies ChatState<UI_MESSAGE>;\n\n  // the instance is created right away thanks to immediate: true. We do it this\n  // way instead of a computed to ensure all changes to reactive state happen\n  // in the same tick\n  const chatInstance = shallowRef<VueChat<UI_MESSAGE>>() as ShallowRef<\n    VueChat<UI_MESSAGE>\n  >;\n\n  watch(\n    () => toValue(init),\n    opts => {\n      // reset the initial state\n      messages.value = opts?.messages ?? [];\n      status.value = 'ready';\n      error.value = undefined;\n\n      chatInstance.value = new VueChat<UI_MESSAGE>({\n        ...opts,\n        state: chatStateWrapper,\n      });\n    },\n    { immediate: true },\n  );\n\n  return {\n    id: computed(() => chatInstance.value.id),\n    status,\n    messages,\n    error,\n    addToolApprovalResponse: opts =>\n      chatInstance.value.addToolApprovalResponse(opts),\n    addToolOutput: opts => chatInstance.value.addToolOutput(opts),\n    clearError: () => chatInstance.value.clearError(),\n    regenerate: opts => chatInstance.value.regenerate(opts),\n    sendMessage: (...args) => chatInstance.value.sendMessage(...args),\n    stop: () => chatInstance.value.stop(),\n    resumeStream: opts => chatInstance.value.resumeStream(opts),\n  };\n}\n","import type { FlexibleSchema } from '@ai-sdk/provider-utils';\nimport {\n  useObject,\n  type UseObjectHelpers,\n  type UseObjectOptions,\n} from './use-object';\n\nexport * from './use-completion';\nexport { Chat } from './chat.vue';\nexport { useChat, type UseChatHelpers } from './use-chat';\nexport * from './use-object';\n\n// deprecated aliases\n// note: declared here (instead of export aliases) so that the `@deprecated`\n// tags are preserved in the bundled type declarations\n\n/**\n * @deprecated Use `useObject` instead.\n */\nexport const experimental_useObject = useObject;\n\n/**\n * @deprecated Use `UseObjectOptions` instead.\n */\nexport type Experimental_UseObjectOptions<\n  SCHEMA extends FlexibleSchema,\n  RESULT,\n> = UseObjectOptions<SCHEMA, RESULT>;\n\n/**\n * @deprecated Use `UseObjectHelpers` instead.\n */\nexport type Experimental_UseObjectHelpers<RESULT, INPUT> = UseObjectHelpers<\n  RESULT,\n  INPUT\n>;\n"],"mappings":"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","names":["fetch","swrv","ref","uniqueId","useSWRV","store","fetch","_a","data","completion","ref","AbstractChat"]}
+{"version":3,"sources":["../src/use-object.ts","../src/use-completion.ts","../src/chat.vue.ts","../src/use-chat.ts","../src/index.ts"],"sourcesContent":["import {\n  isAbortError,\n  safeValidateTypes,\n  type FetchFunction,\n} from '@ai-sdk/provider-utils';\nimport {\n  asSchema,\n  isDeepEqualData,\n  parsePartialJson,\n  type DeepPartial,\n  type FlexibleSchema,\n  type InferSchema,\n} from 'ai';\nimport type * as SwrvModule from 'swrv';\nimport swrv from 'swrv';\nimport { ref, type Ref } from 'vue';\n// use function to allow for mocking in tests\nconst getOriginalFetch = () => fetch;\n\nexport type UseObjectOptions<SCHEMA extends FlexibleSchema, RESULT> = {\n  /** API endpoint that streams JSON chunks matching the schema */\n  api: string;\n\n  /** Schema that defines the final object shape */\n  schema: SCHEMA;\n\n  /** Shared state key. If omitted a random one is generated */\n  id?: string;\n\n  /** Initial partial value */\n  initialValue?: DeepPartial<RESULT>;\n\n  /** Optional custom fetch implementation */\n  fetch?: FetchFunction;\n\n  /** Called when stream ends */\n  onFinish?: (event: {\n    object: RESULT | undefined;\n    error: Error | undefined;\n  }) => Promise<void> | void;\n\n  /** Called on error */\n  onError?: (error: Error) => void;\n\n  /** Extra request headers */\n  headers?: Record<string, string> | Headers;\n\n  /** Request credentials mode. Defaults to 'same-origin' if omitted */\n  credentials?: RequestCredentials;\n};\n\nexport type UseObjectHelpers<RESULT, INPUT> = {\n  /** POST the input and start streaming */\n  submit: (input: INPUT) => void;\n\n  /** Current partial object, updated as chunks arrive */\n  object: Ref<DeepPartial<RESULT> | undefined>;\n\n  /** Latest error if any */\n  error: Ref<Error | undefined>;\n\n  /** Loading flag for the in-flight request */\n  isLoading: Ref<boolean | undefined>;\n\n  /** Abort the current request. Keeps current partial object. */\n  stop: () => void;\n\n  /** Abort and clear all state */\n  clear: () => void;\n};\n\nlet uniqueId = 0;\n\n// @ts-expect-error - some issues with the default export of useSWRV\nconst useSWRV = (swrv.default as (typeof SwrvModule)['default']) || swrv;\nconst store: Record<string, any> = {};\n\nexport function useObject<\n  SCHEMA extends FlexibleSchema,\n  RESULT = InferSchema<SCHEMA>,\n  INPUT = any,\n>({\n  api,\n  id,\n  schema,\n  initialValue,\n  fetch,\n  onError,\n  onFinish,\n  headers,\n  credentials,\n}: UseObjectOptions<SCHEMA, RESULT>): UseObjectHelpers<RESULT, INPUT> {\n  // Generate an unique id for the object if not provided.\n  const completionId = id || `completion-${uniqueId++}`;\n\n  const key = `${api}|${completionId}`;\n  const { data, mutate: originalMutate } = useSWRV<\n    DeepPartial<RESULT> | undefined\n  >(key, () => (key in store ? store[key] : initialValue));\n\n  const { data: isLoading, mutate: mutateLoading } = useSWRV<boolean>(\n    `${completionId}-loading`,\n    null,\n  );\n\n  isLoading.value ??= false;\n  data.value ||= initialValue as DeepPartial<RESULT> | undefined;\n\n  const mutateObject = (value: DeepPartial<RESULT> | undefined) => {\n    store[key] = value;\n    return originalMutate();\n  };\n\n  const error = ref<Error | undefined>(undefined);\n  let abortController: AbortController | null = null;\n\n  const stop = async () => {\n    if (abortController) {\n      try {\n        abortController.abort();\n      } catch {\n        // ignore\n      } finally {\n        abortController = null;\n      }\n    }\n    await mutateLoading(() => false);\n  };\n\n  const clearObject = async () => {\n    error.value = undefined;\n    await mutateLoading(() => false);\n    await mutateObject(undefined);\n    // Need to explicitly set the value to undefined to trigger a re-render\n    data.value = undefined;\n  };\n\n  const clear = async () => {\n    await stop();\n    await clearObject();\n  };\n\n  const submit = async (input: INPUT) => {\n    try {\n      await clearObject();\n      await mutateLoading(() => true);\n\n      abortController = new AbortController();\n\n      const actualFetch = fetch ?? getOriginalFetch();\n      const response = await actualFetch(api, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          ...(headers as any),\n        },\n        credentials: credentials ?? 'same-origin',\n        signal: abortController.signal,\n        body: JSON.stringify(input),\n      });\n\n      if (!response.ok) {\n        throw new Error(\n          (await response.text()) || 'Failed to fetch the response.',\n        );\n      }\n\n      if (!response.body) {\n        throw new Error('The response body is empty.');\n      }\n\n      let accumulatedText = '';\n      let latestObject: DeepPartial<RESULT> | undefined = undefined;\n\n      await response.body.pipeThrough(new TextDecoderStream()).pipeTo(\n        new WritableStream<string>({\n          async write(chunk) {\n            accumulatedText += chunk;\n            const { value } = await parsePartialJson(accumulatedText);\n            const currentObject = value as DeepPartial<RESULT>;\n            if (!isDeepEqualData(latestObject, currentObject)) {\n              latestObject = currentObject;\n              await mutateObject(currentObject);\n            }\n          },\n          async close() {\n            await mutateLoading(() => false);\n            abortController = null;\n\n            if (onFinish) {\n              const validationResult = await safeValidateTypes({\n                value: latestObject,\n                schema: asSchema(schema),\n              });\n\n              onFinish(\n                validationResult.success\n                  ? {\n                      object: validationResult.value as RESULT,\n                      error: undefined,\n                    }\n                  : { object: undefined, error: validationResult.error },\n              );\n            }\n          },\n        }),\n      );\n    } catch (err: unknown) {\n      if (isAbortError(err)) return;\n\n      if (onError && err instanceof Error) onError(err);\n\n      await mutateLoading(() => false);\n      error.value = err instanceof Error ? err : new Error(String(err));\n    }\n  };\n\n  return {\n    submit,\n    object: data,\n    error,\n    isLoading,\n    stop,\n    clear,\n  };\n}\n","import {\n  callCompletionApi,\n  type CompletionRequestOptions,\n  type UseCompletionOptions,\n} from 'ai';\nimport type * as SwrvModule from 'swrv';\nimport swrv from 'swrv';\nimport { ref, unref, type Ref } from 'vue';\nexport type { UseCompletionOptions };\n\nexport type UseCompletionHelpers<BODY extends object = object> = {\n  /** The current completion result */\n  completion: Ref<string>;\n  /** The error object of the API request */\n  error: Ref<undefined | Error>;\n  /**\n   * Send a new prompt to the API endpoint and update the completion state.\n   */\n  complete: (\n    prompt: string,\n    options?: CompletionRequestOptions<BODY>,\n  ) => Promise<string | null | undefined>;\n  /**\n   * Abort the current API request but keep the generated tokens.\n   */\n  stop: () => void;\n  /**\n   * Update the `completion` state locally.\n   */\n  setCompletion: (completion: string) => void;\n  /** The current value of the input */\n  input: Ref<string>;\n  /**\n   * Form submission handler to automatically reset input and append a user message\n   * @example\n   * ```jsx\n   * <form @submit=\"handleSubmit\">\n   *  <input @change=\"handleInputChange\" v-model=\"input\" />\n   * </form>\n   * ```\n   */\n  handleSubmit: (event?: { preventDefault?: () => void }) => void;\n  /** Whether the API request is in progress */\n  isLoading: Ref<boolean | undefined>;\n};\n\nlet uniqueId = 0;\n\n// @ts-expect-error - some issues with the default export of useSWRV\nconst useSWRV = (swrv.default as (typeof SwrvModule)['default']) || swrv;\nconst store: Record<string, any> = {};\n\nexport function useCompletion<BODY extends object = object>({\n  api = '/api/completion',\n  id,\n  initialCompletion = '',\n  initialInput = '',\n  credentials,\n  headers,\n  body,\n  streamProtocol,\n  onFinish,\n  onError,\n  fetch,\n}: UseCompletionOptions<NoInfer<BODY>> = {}): UseCompletionHelpers<BODY> {\n  // Generate an unique id for the completion if not provided.\n  const completionId = id || `completion-${uniqueId++}`;\n\n  const key = `${api}|${completionId}`;\n  const { data, mutate: originalMutate } = useSWRV<string>(\n    key,\n    () => store[key] ?? initialCompletion,\n  );\n\n  const { data: isLoading, mutate: mutateLoading } = useSWRV<boolean>(\n    `${completionId}-loading`,\n    null,\n  );\n\n  isLoading.value ??= false;\n\n  // Force the `data` to be `initialCompletion` if it's `undefined`.\n  data.value ??= initialCompletion;\n\n  const mutate = (data: string) => {\n    store[key] = data;\n    return originalMutate();\n  };\n\n  // Because of the `initialData` option, the `data` will never be `undefined`.\n  const completion = data as Ref<string>;\n\n  const error = ref<undefined | Error>(undefined);\n\n  let abortController: AbortController | null = null;\n\n  async function triggerRequest(\n    prompt: string,\n    options?: CompletionRequestOptions<BODY>,\n  ) {\n    return callCompletionApi({\n      api,\n      prompt,\n      credentials,\n      headers: {\n        ...headers,\n        ...options?.headers,\n      },\n      body: {\n        ...unref(body),\n        ...options?.body,\n      },\n      streamProtocol,\n      setCompletion: mutate,\n      setLoading: loading => mutateLoading(() => loading),\n      setError: err => {\n        error.value = err;\n      },\n      setAbortController: controller => {\n        abortController = controller;\n      },\n      onFinish,\n      onError,\n      fetch,\n    });\n  }\n\n  const complete: UseCompletionHelpers<BODY>['complete'] = async (\n    prompt,\n    options,\n  ) => {\n    return triggerRequest(prompt, options);\n  };\n\n  const stop = () => {\n    if (abortController) {\n      abortController.abort();\n      abortController = null;\n    }\n  };\n\n  const setCompletion = (completion: string) => {\n    mutate(completion);\n  };\n\n  const input = ref(initialInput);\n\n  const handleSubmit = (event?: { preventDefault?: () => void }) => {\n    event?.preventDefault?.();\n    const inputValue = input.value;\n    return inputValue ? complete(inputValue) : undefined;\n  };\n\n  return {\n    completion,\n    complete,\n    error,\n    stop,\n    setCompletion,\n    input,\n    handleSubmit,\n    isLoading,\n  };\n}\n","import {\n  AbstractChat,\n  type ChatInit,\n  type ChatState,\n  type ChatStatus,\n  type UIMessage,\n} from 'ai';\nimport { ref, type Ref } from 'vue';\nclass VueChatState<\n  UI_MESSAGE extends UIMessage,\n> implements ChatState<UI_MESSAGE> {\n  private messagesRef: Ref<UI_MESSAGE[]>;\n  private statusRef = ref<ChatStatus>('ready');\n  private errorRef = ref<Error | undefined>(undefined);\n\n  constructor(messages?: UI_MESSAGE[]) {\n    this.messagesRef = ref(messages ?? []) as Ref<UI_MESSAGE[]>;\n  }\n\n  get messages(): UI_MESSAGE[] {\n    return this.messagesRef.value;\n  }\n\n  set messages(messages: UI_MESSAGE[]) {\n    this.messagesRef.value = messages;\n  }\n\n  get status(): ChatStatus {\n    return this.statusRef.value;\n  }\n\n  set status(status: ChatStatus) {\n    this.statusRef.value = status;\n  }\n\n  get error(): Error | undefined {\n    return this.errorRef.value;\n  }\n\n  set error(error: Error | undefined) {\n    this.errorRef.value = error;\n  }\n\n  pushMessage = (message: UI_MESSAGE) => {\n    this.messagesRef.value = [...this.messagesRef.value, message];\n  };\n\n  popMessage = () => {\n    this.messagesRef.value = this.messagesRef.value.slice(0, -1);\n  };\n\n  replaceMessage = (index: number, message: UI_MESSAGE) => {\n    // message is cloned here because vue's deep reactivity shows unexpected behavior, particularly when updating tool invocation parts\n    this.messagesRef.value[index] = { ...message };\n  };\n\n  snapshot = <T>(value: T): T => value;\n}\n\n/**\n * @deprecated Use the {@link useChat} composable instead. It exposes reactive\n * refs and automatically recreates the chat when its init object changes.\n */\nexport class Chat<\n  UI_MESSAGE extends UIMessage,\n> extends AbstractChat<UI_MESSAGE> {\n  constructor({ messages, ...init }: ChatInit<UI_MESSAGE>) {\n    super({\n      ...init,\n      state: new VueChatState(messages),\n    });\n  }\n}\n","import {\n  AbstractChat,\n  type ChatInit as BaseChatInit,\n  type ChatInit,\n  type ChatState,\n  type ChatStatus,\n  type UIMessage,\n} from 'ai';\nimport {\n  computed,\n  getCurrentScope,\n  onScopeDispose,\n  shallowRef,\n  toValue,\n  watch,\n  type ComputedRef,\n  type MaybeRefOrGetter,\n  type ShallowRef,\n} from 'vue';\n\nfunction cloneMetadata<METADATA>(metadata: METADATA): METADATA {\n  if (Array.isArray(metadata)) {\n    return [...metadata] as METADATA;\n  }\n\n  if (\n    metadata != null &&\n    typeof metadata === 'object' &&\n    (Object.getPrototypeOf(metadata) === Object.prototype ||\n      Object.getPrototypeOf(metadata) === null)\n  ) {\n    return { ...metadata } as METADATA;\n  }\n\n  return metadata;\n}\n\nfunction snapshotValue<T>(value: T): T {\n  if (\n    value == null ||\n    typeof value !== 'object' ||\n    !('parts' in value) ||\n    !Array.isArray(value.parts)\n  ) {\n    return value;\n  }\n\n  const message = value as unknown as UIMessage;\n  const snapshot = {\n    ...message,\n    parts: message.parts.map(part => ({ ...part })),\n  };\n\n  if ('metadata' in message) {\n    snapshot.metadata = cloneMetadata(message.metadata);\n  }\n\n  return snapshot as T;\n}\n\nclass VueChatState<\n  UI_MESSAGE extends UIMessage,\n> implements ChatState<UI_MESSAGE> {\n  private messagesValue: UI_MESSAGE[];\n  private publishedMessages: UI_MESSAGE[] = [];\n  private publishedMessageSources: UI_MESSAGE[] = [];\n  private readonly dirtyMessageIndices = new Set<number>();\n  private statusValue: ChatStatus = 'ready';\n  private errorValue: Error | undefined;\n  private readonly throttleWaitMs: number | undefined;\n  private timeout: ReturnType<typeof setTimeout> | undefined;\n  private hasPendingPublication = false;\n  private isActive = true;\n\n  isPublishing = false;\n\n  constructor({\n    initialMessages,\n    messagesRef,\n    statusRef,\n    errorRef,\n    throttleWaitMs,\n  }: {\n    initialMessages: UI_MESSAGE[];\n    messagesRef: ShallowRef<UI_MESSAGE[]>;\n    statusRef: ShallowRef<ChatStatus>;\n    errorRef: ShallowRef<Error | undefined>;\n    throttleWaitMs?: number;\n  }) {\n    this.messagesValue = initialMessages;\n    this.messagesRef = messagesRef;\n    this.statusRef = statusRef;\n    this.errorRef = errorRef;\n    this.throttleWaitMs =\n      throttleWaitMs != null &&\n      Number.isFinite(throttleWaitMs) &&\n      throttleWaitMs > 0\n        ? throttleWaitMs\n        : undefined;\n  }\n\n  private readonly messagesRef: ShallowRef<UI_MESSAGE[]>;\n  private readonly statusRef: ShallowRef<ChatStatus>;\n  private readonly errorRef: ShallowRef<Error | undefined>;\n\n  get messages(): UI_MESSAGE[] {\n    return this.messagesValue;\n  }\n\n  set messages(messages: UI_MESSAGE[]) {\n    const previousMessages = this.messagesValue;\n    this.messagesValue = messages;\n\n    for (let index = 0; index < messages.length; index++) {\n      if (messages[index] !== previousMessages[index]) {\n        this.dirtyMessageIndices.add(index);\n      }\n    }\n\n    this.schedulePublication();\n  }\n\n  get status(): ChatStatus {\n    return this.statusValue;\n  }\n\n  set status(status: ChatStatus) {\n    this.statusValue = status;\n\n    if (!this.isActive) {\n      return;\n    }\n\n    if (status === 'ready' || status === 'error') {\n      // Terminal states must never become observable before the final message.\n      this.flushPublication();\n    }\n\n    this.statusRef.value = status;\n  }\n\n  get error(): Error | undefined {\n    return this.errorValue;\n  }\n\n  set error(error: Error | undefined) {\n    this.errorValue = error;\n\n    if (this.isActive) {\n      this.errorRef.value = error;\n    }\n  }\n\n  pushMessage = (message: UI_MESSAGE) => {\n    this.messagesValue.push(message);\n    this.dirtyMessageIndices.add(this.messagesValue.length - 1);\n    this.schedulePublication();\n  };\n\n  popMessage = () => {\n    this.messagesValue.pop();\n    this.schedulePublication();\n  };\n\n  replaceMessage = (index: number, message: UI_MESSAGE) => {\n    this.messagesValue[index] = message;\n    this.dirtyMessageIndices.add(index);\n    this.schedulePublication();\n  };\n\n  snapshot = snapshotValue;\n\n  publishInitialState() {\n    this.publishMessages();\n    this.statusRef.value = this.statusValue;\n    this.errorRef.value = this.errorValue;\n  }\n\n  setMessagesFromConsumer(messages: UI_MESSAGE[]) {\n    this.messagesValue = messages;\n    this.publishedMessages = messages;\n    this.publishedMessageSources = messages;\n    this.dirtyMessageIndices.clear();\n  }\n\n  dispose() {\n    this.isActive = false;\n    this.hasPendingPublication = false;\n    this.dirtyMessageIndices.clear();\n    this.publishedMessages = [];\n    this.publishedMessageSources = [];\n\n    if (this.timeout != null) {\n      clearTimeout(this.timeout);\n      this.timeout = undefined;\n    }\n  }\n\n  private schedulePublication() {\n    if (!this.isActive) {\n      return;\n    }\n\n    if (this.throttleWaitMs == null) {\n      this.publishMessages();\n      return;\n    }\n\n    if (this.timeout == null) {\n      // Publish the leading update immediately, then coalesce updates until\n      // the next interval boundary.\n      this.publishMessages();\n      this.timeout = setTimeout(this.handleIntervalEnd, this.throttleWaitMs);\n    } else {\n      this.hasPendingPublication = true;\n    }\n  }\n\n  private readonly handleIntervalEnd = () => {\n    this.timeout = undefined;\n\n    if (!this.isActive || !this.hasPendingPublication) {\n      return;\n    }\n\n    this.hasPendingPublication = false;\n    this.publishMessages();\n    this.timeout = setTimeout(this.handleIntervalEnd, this.throttleWaitMs);\n  };\n\n  private flushPublication() {\n    if (this.timeout != null) {\n      clearTimeout(this.timeout);\n      this.timeout = undefined;\n    }\n\n    this.hasPendingPublication = false;\n    this.publishMessages();\n  }\n\n  private publishMessages() {\n    if (!this.isActive) {\n      return;\n    }\n\n    const publishedMessages = this.messagesValue.map((message, index) =>\n      this.dirtyMessageIndices.has(index) ||\n      this.publishedMessageSources[index] !== message\n        ? snapshotValue(message)\n        : this.publishedMessages[index],\n    );\n\n    this.publishedMessages = publishedMessages;\n    this.publishedMessageSources = [...this.messagesValue];\n    this.dirtyMessageIndices.clear();\n\n    this.isPublishing = true;\n    try {\n      this.messagesRef.value = publishedMessages;\n    } finally {\n      this.isPublishing = false;\n    }\n  }\n}\n\n/**\n * @internal\n */\nexport class VueChat<\n  UI_MESSAGE extends UIMessage,\n> extends AbstractChat<UI_MESSAGE> {\n  constructor({\n    state,\n    ...init\n  }: Omit<ChatInit<UI_MESSAGE>, 'messages'> & {\n    state: ChatState<UI_MESSAGE>;\n  }) {\n    super({\n      ...init,\n      state,\n    });\n  }\n}\n\n/**\n * Return type of the {@link useChat} composable, which includes the chat\n * instance methods and reactive properties for messages, status, and error.\n */\nexport interface UseChatHelpers<UI_MESSAGE extends UIMessage> extends Pick<\n  AbstractChat<UI_MESSAGE>,\n  | 'sendMessage'\n  | 'regenerate'\n  | 'stop'\n  | 'resumeStream'\n  | 'addToolOutput'\n  | 'addToolApprovalResponse'\n  | 'clearError'\n> {\n  /**\n   * The id of the chat.\n   */\n  id: ComputedRef<string>;\n\n  /**\n   * The current error state of the chat, if any.\n   */\n  error: ShallowRef<Error | undefined>;\n\n  /**\n   * The current status of the chat, which can be 'ready', 'generating', 'streaming', or 'error'.\n   */\n  status: ShallowRef<ChatStatus>;\n\n  /**\n   * The list of messages in the chat, which can be updated by the chat instance methods or directly by setting this property.\n   */\n  messages: ShallowRef<UI_MESSAGE[]>;\n}\n\nexport type UseChatOptions<UI_MESSAGE extends UIMessage> =\n  BaseChatInit<UI_MESSAGE> & {\n    /**\n     * Custom throttle wait time in milliseconds for reactive message updates.\n     * Positive values enable throttling. Defaults to undefined, which disables\n     * throttling.\n     */\n    throttle?: number;\n  };\n\n/**\n * Composable to access messages, status, and other chat properties and\n * methods. Accepts an optional reactive initial configuration object\n *\n * @example\n *\n * ```ts\n * // passing a getter if any reactive properties are used within\n * // the init object\n * const { messages, sendMessage } = useChat(() => ({\n *   // ...\n * })\n * ```\n *\n * @see BaseChatInit\n */\nexport function useChat<UI_MESSAGE extends UIMessage = UIMessage>(\n  init?: MaybeRefOrGetter<UseChatOptions<UI_MESSAGE>>,\n): UseChatHelpers<UI_MESSAGE> {\n  const messages = shallowRef<UI_MESSAGE[]>([]);\n  const status = shallowRef<ChatStatus>('ready');\n  const error = shallowRef<Error | undefined>();\n\n  // the instance is created right away thanks to immediate: true. We do it this\n  // way instead of a computed to ensure all changes to reactive state happen\n  // in the same tick\n  const chatInstance = shallowRef<VueChat<UI_MESSAGE>>() as ShallowRef<\n    VueChat<UI_MESSAGE>\n  >;\n  let chatState: VueChatState<UI_MESSAGE> | undefined;\n\n  watch(\n    messages,\n    messageList => {\n      if (chatState != null && !chatState.isPublishing) {\n        chatState.setMessagesFromConsumer(messageList);\n      }\n    },\n    { flush: 'sync' },\n  );\n\n  watch(\n    () => toValue(init),\n    opts => {\n      chatState?.dispose();\n\n      const { throttle, ...chatInit } = opts ?? {};\n      const nextChatState = new VueChatState<UI_MESSAGE>({\n        initialMessages: chatInit.messages ?? [],\n        messagesRef: messages,\n        statusRef: status,\n        errorRef: error,\n        throttleWaitMs: throttle,\n      });\n\n      chatState = nextChatState;\n      nextChatState.publishInitialState();\n\n      chatInstance.value = new VueChat<UI_MESSAGE>({\n        ...chatInit,\n        state: nextChatState,\n      });\n    },\n    { immediate: true },\n  );\n\n  if (getCurrentScope() != null) {\n    onScopeDispose(() => {\n      chatState?.dispose();\n    });\n  }\n\n  return {\n    id: computed(() => chatInstance.value.id),\n    status,\n    messages,\n    error,\n    addToolApprovalResponse: opts =>\n      chatInstance.value.addToolApprovalResponse(opts),\n    addToolOutput: opts => chatInstance.value.addToolOutput(opts),\n    clearError: () => chatInstance.value.clearError(),\n    regenerate: opts => chatInstance.value.regenerate(opts),\n    sendMessage: (...args) => chatInstance.value.sendMessage(...args),\n    stop: () => chatInstance.value.stop(),\n    resumeStream: opts => chatInstance.value.resumeStream(opts),\n  };\n}\n","import type { FlexibleSchema } from '@ai-sdk/provider-utils';\nimport {\n  useObject,\n  type UseObjectHelpers,\n  type UseObjectOptions,\n} from './use-object';\n\nexport * from './use-completion';\nexport { Chat } from './chat.vue';\nexport { useChat, type UseChatHelpers, type UseChatOptions } from './use-chat';\nexport * from './use-object';\n\n// deprecated aliases\n// note: declared here (instead of export aliases) so that the `@deprecated`\n// tags are preserved in the bundled type declarations\n\n/**\n * @deprecated Use `useObject` instead.\n */\nexport const experimental_useObject = useObject;\n\n/**\n * @deprecated Use `UseObjectOptions` instead.\n */\nexport type Experimental_UseObjectOptions<\n  SCHEMA extends FlexibleSchema,\n  RESULT,\n> = UseObjectOptions<SCHEMA, RESULT>;\n\n/**\n * @deprecated Use `UseObjectHelpers` instead.\n */\nexport type Experimental_UseObjectHelpers<RESULT, INPUT> = UseObjectHelpers<\n  RESULT,\n  INPUT\n>;\n"],"mappings":"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","names":["fetch","swrv","ref","uniqueId","useSWRV","store","fetch","_a","data","completion","ref","AbstractChat","VueChatState"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/vue",
-  "version": "4.0.107",
+  "version": "4.0.108",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -27,7 +27,7 @@
   ],
   "dependencies": {
     "@ai-sdk/provider-utils": "5.0.45",
-    "ai": "7.0.107",
+    "ai": "7.0.108",
     "swrv": "^1.2.0"
   },
   "devDependencies": {

package/src/index.ts

@@ -7,7 +7,7 @@ import {
 
 export * from './use-completion';
 export { Chat } from './chat.vue';
-export { useChat, type UseChatHelpers } from './use-chat';
+export { useChat, type UseChatHelpers, type UseChatOptions } from './use-chat';
 export * from './use-object';
 
 // deprecated aliases

package/src/use-chat.ts

@@ -8,15 +8,261 @@ import {
 } from 'ai';
 import {
   computed,
+  getCurrentScope,
+  onScopeDispose,
   shallowRef,
   toValue,
-  triggerRef,
   watch,
   type ComputedRef,
   type MaybeRefOrGetter,
   type ShallowRef,
 } from 'vue';
 
+function cloneMetadata<METADATA>(metadata: METADATA): METADATA {
+  if (Array.isArray(metadata)) {
+    return [...metadata] as METADATA;
+  }
+
+  if (
+    metadata != null &&
+    typeof metadata === 'object' &&
+    (Object.getPrototypeOf(metadata) === Object.prototype ||
+      Object.getPrototypeOf(metadata) === null)
+  ) {
+    return { ...metadata } as METADATA;
+  }
+
+  return metadata;
+}
+
+function snapshotValue<T>(value: T): T {
+  if (
+    value == null ||
+    typeof value !== 'object' ||
+    !('parts' in value) ||
+    !Array.isArray(value.parts)
+  ) {
+    return value;
+  }
+
+  const message = value as unknown as UIMessage;
+  const snapshot = {
+    ...message,
+    parts: message.parts.map(part => ({ ...part })),
+  };
+
+  if ('metadata' in message) {
+    snapshot.metadata = cloneMetadata(message.metadata);
+  }
+
+  return snapshot as T;
+}
+
+class VueChatState<
+  UI_MESSAGE extends UIMessage,
+> implements ChatState<UI_MESSAGE> {
+  private messagesValue: UI_MESSAGE[];
+  private publishedMessages: UI_MESSAGE[] = [];
+  private publishedMessageSources: UI_MESSAGE[] = [];
+  private readonly dirtyMessageIndices = new Set<number>();
+  private statusValue: ChatStatus = 'ready';
+  private errorValue: Error | undefined;
+  private readonly throttleWaitMs: number | undefined;
+  private timeout: ReturnType<typeof setTimeout> | undefined;
+  private hasPendingPublication = false;
+  private isActive = true;
+
+  isPublishing = false;
+
+  constructor({
+    initialMessages,
+    messagesRef,
+    statusRef,
+    errorRef,
+    throttleWaitMs,
+  }: {
+    initialMessages: UI_MESSAGE[];
+    messagesRef: ShallowRef<UI_MESSAGE[]>;
+    statusRef: ShallowRef<ChatStatus>;
+    errorRef: ShallowRef<Error | undefined>;
+    throttleWaitMs?: number;
+  }) {
+    this.messagesValue = initialMessages;
+    this.messagesRef = messagesRef;
+    this.statusRef = statusRef;
+    this.errorRef = errorRef;
+    this.throttleWaitMs =
+      throttleWaitMs != null &&
+      Number.isFinite(throttleWaitMs) &&
+      throttleWaitMs > 0
+        ? throttleWaitMs
+        : undefined;
+  }
+
+  private readonly messagesRef: ShallowRef<UI_MESSAGE[]>;
+  private readonly statusRef: ShallowRef<ChatStatus>;
+  private readonly errorRef: ShallowRef<Error | undefined>;
+
+  get messages(): UI_MESSAGE[] {
+    return this.messagesValue;
+  }
+
+  set messages(messages: UI_MESSAGE[]) {
+    const previousMessages = this.messagesValue;
+    this.messagesValue = messages;
+
+    for (let index = 0; index < messages.length; index++) {
+      if (messages[index] !== previousMessages[index]) {
+        this.dirtyMessageIndices.add(index);
+      }
+    }
+
+    this.schedulePublication();
+  }
+
+  get status(): ChatStatus {
+    return this.statusValue;
+  }
+
+  set status(status: ChatStatus) {
+    this.statusValue = status;
+
+    if (!this.isActive) {
+      return;
+    }
+
+    if (status === 'ready' || status === 'error') {
+      // Terminal states must never become observable before the final message.
+      this.flushPublication();
+    }
+
+    this.statusRef.value = status;
+  }
+
+  get error(): Error | undefined {
+    return this.errorValue;
+  }
+
+  set error(error: Error | undefined) {
+    this.errorValue = error;
+
+    if (this.isActive) {
+      this.errorRef.value = error;
+    }
+  }
+
+  pushMessage = (message: UI_MESSAGE) => {
+    this.messagesValue.push(message);
+    this.dirtyMessageIndices.add(this.messagesValue.length - 1);
+    this.schedulePublication();
+  };
+
+  popMessage = () => {
+    this.messagesValue.pop();
+    this.schedulePublication();
+  };
+
+  replaceMessage = (index: number, message: UI_MESSAGE) => {
+    this.messagesValue[index] = message;
+    this.dirtyMessageIndices.add(index);
+    this.schedulePublication();
+  };
+
+  snapshot = snapshotValue;
+
+  publishInitialState() {
+    this.publishMessages();
+    this.statusRef.value = this.statusValue;
+    this.errorRef.value = this.errorValue;
+  }
+
+  setMessagesFromConsumer(messages: UI_MESSAGE[]) {
+    this.messagesValue = messages;
+    this.publishedMessages = messages;
+    this.publishedMessageSources = messages;
+    this.dirtyMessageIndices.clear();
+  }
+
+  dispose() {
+    this.isActive = false;
+    this.hasPendingPublication = false;
+    this.dirtyMessageIndices.clear();
+    this.publishedMessages = [];
+    this.publishedMessageSources = [];
+
+    if (this.timeout != null) {
+      clearTimeout(this.timeout);
+      this.timeout = undefined;
+    }
+  }
+
+  private schedulePublication() {
+    if (!this.isActive) {
+      return;
+    }
+
+    if (this.throttleWaitMs == null) {
+      this.publishMessages();
+      return;
+    }
+
+    if (this.timeout == null) {
+      // Publish the leading update immediately, then coalesce updates until
+      // the next interval boundary.
+      this.publishMessages();
+      this.timeout = setTimeout(this.handleIntervalEnd, this.throttleWaitMs);
+    } else {
+      this.hasPendingPublication = true;
+    }
+  }
+
+  private readonly handleIntervalEnd = () => {
+    this.timeout = undefined;
+
+    if (!this.isActive || !this.hasPendingPublication) {
+      return;
+    }
+
+    this.hasPendingPublication = false;
+    this.publishMessages();
+    this.timeout = setTimeout(this.handleIntervalEnd, this.throttleWaitMs);
+  };
+
+  private flushPublication() {
+    if (this.timeout != null) {
+      clearTimeout(this.timeout);
+      this.timeout = undefined;
+    }
+
+    this.hasPendingPublication = false;
+    this.publishMessages();
+  }
+
+  private publishMessages() {
+    if (!this.isActive) {
+      return;
+    }
+
+    const publishedMessages = this.messagesValue.map((message, index) =>
+      this.dirtyMessageIndices.has(index) ||
+      this.publishedMessageSources[index] !== message
+        ? snapshotValue(message)
+        : this.publishedMessages[index],
+    );
+
+    this.publishedMessages = publishedMessages;
+    this.publishedMessageSources = [...this.messagesValue];
+    this.dirtyMessageIndices.clear();
+
+    this.isPublishing = true;
+    try {
+      this.messagesRef.value = publishedMessages;
+    } finally {
+      this.isPublishing = false;
+    }
+  }
+}
+
 /**
  * @internal
  */
@@ -71,6 +317,16 @@ export interface UseChatHelpers<UI_MESSAGE extends UIMessage> extends Pick<
   messages: ShallowRef<UI_MESSAGE[]>;
 }
 
+export type UseChatOptions<UI_MESSAGE extends UIMessage> =
+  BaseChatInit<UI_MESSAGE> & {
+    /**
+     * Custom throttle wait time in milliseconds for reactive message updates.
+     * Positive values enable throttling. Defaults to undefined, which disables
+     * throttling.
+     */
+    throttle?: number;
+  };
+
 /**
  * Composable to access messages, status, and other chat properties and
  * methods. Accepts an optional reactive initial configuration object
@@ -88,83 +344,61 @@ export interface UseChatHelpers<UI_MESSAGE extends UIMessage> extends Pick<
  * @see BaseChatInit
  */
 export function useChat<UI_MESSAGE extends UIMessage = UIMessage>(
-  init?: MaybeRefOrGetter<BaseChatInit<UI_MESSAGE>>,
+  init?: MaybeRefOrGetter<UseChatOptions<UI_MESSAGE>>,
 ): UseChatHelpers<UI_MESSAGE> {
   const messages = shallowRef<UI_MESSAGE[]>([]);
   const status = shallowRef<ChatStatus>('ready');
   const error = shallowRef<Error | undefined>();
 
-  // this wrapper doesn't need to be reactive and can be reused across chat
-  // instance changes, because the inner refs are reactive and the wrapper
-  // methods trigger updates when needed
-  const chatStateWrapper = {
-    get messages(): UI_MESSAGE[] {
-      return messages.value;
-    },
-
-    set messages(messageList: UI_MESSAGE[]) {
-      messages.value = messageList;
-    },
-
-    get status(): ChatStatus {
-      return status.value;
-    },
-
-    set status(statusValue: ChatStatus) {
-      status.value = statusValue;
-    },
-
-    get error(): Error | undefined {
-      return error.value;
-    },
-
-    set error(errorValue: Error | undefined) {
-      error.value = errorValue;
-    },
-
-    pushMessage(message: UI_MESSAGE) {
-      messages.value.push(message);
-      // needed because messagesRef is a shallowRef
-      triggerRef(messages);
-    },
-
-    popMessage() {
-      messages.value.pop();
-      triggerRef(messages);
-    },
-
-    replaceMessage(index: number, message: UI_MESSAGE) {
-      // message is cloned here because vue's deep reactivity shows unexpected behavior, particularly when updating tool invocation parts
-      messages.value[index] = { ...message };
-      triggerRef(messages);
-    },
-
-    snapshot: <T>(value: T): T => value,
-  } satisfies ChatState<UI_MESSAGE>;
-
   // the instance is created right away thanks to immediate: true. We do it this
   // way instead of a computed to ensure all changes to reactive state happen
   // in the same tick
   const chatInstance = shallowRef<VueChat<UI_MESSAGE>>() as ShallowRef<
     VueChat<UI_MESSAGE>
   >;
+  let chatState: VueChatState<UI_MESSAGE> | undefined;
+
+  watch(
+    messages,
+    messageList => {
+      if (chatState != null && !chatState.isPublishing) {
+        chatState.setMessagesFromConsumer(messageList);
+      }
+    },
+    { flush: 'sync' },
+  );
 
   watch(
     () => toValue(init),
     opts => {
-      // reset the initial state
-      messages.value = opts?.messages ?? [];
-      status.value = 'ready';
-      error.value = undefined;
+      chatState?.dispose();
+
+      const { throttle, ...chatInit } = opts ?? {};
+      const nextChatState = new VueChatState<UI_MESSAGE>({
+        initialMessages: chatInit.messages ?? [],
+        messagesRef: messages,
+        statusRef: status,
+        errorRef: error,
+        throttleWaitMs: throttle,
+      });
+
+      chatState = nextChatState;
+      nextChatState.publishInitialState();
 
       chatInstance.value = new VueChat<UI_MESSAGE>({
-        ...opts,
-        state: chatStateWrapper,
+        ...chatInit,
+        state: nextChatState,
       });
     },
     { immediate: true },
   );
 
+  if (getCurrentScope() != null) {
+    onScopeDispose(() => {
+      chatState?.dispose();
+    });
+  }
+
   return {
     id: computed(() => chatInstance.value.id),
     status,