@meistrari/chat-nuxt 4.1.0-rc.2 → 4.1.0-rc.3

package/README.md

@@ -45,6 +45,8 @@ bunx --bun typedoc --entryPoints typedoc.ts --out /tmp/chat-nuxt-api --skipError
 
 The table below is a quick index for reading in-repo. **When you change a prop, update its JSDoc and this row together.**
 
+The embed automatically sets the browser tab title to the active conversation title and synchronizes its ID to `?conversationId=` using router replacement, preserving other query parameters and the URL fragment. Starting a new conversation removes the conversation parameter. Opening or reloading that URL restores the conversation; existing `?conversation=` links are also accepted and converted to `?conversationId=`. Explicit `conversationId` and `initialConversationId` props take precedence over the URL on mount. Without a conversation title, the host application controls the tab title.
+
 ### `<MeistrariChatEmbed>` props
 
 Declared in `src/runtime/embed/types.ts`; prop, feature-flag, and event payload types are importable from the package root or `@meistrari/chat-nuxt/types/embed`.

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@meistrari/chat-nuxt",
   "configKey": "chatNuxt",
-  "version": "4.1.0-rc.2",
+  "version": "4.1.0-rc.3",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "unknown"

package/dist/runtime/embed/components/chat-embed-inner.vue

@@ -13,7 +13,8 @@ import ChatMessageInput from "../../messages/components/chat-message-input.vue";
 import { normalizeConversationId } from "../../conversations/scope";
 import { resolveChatFeatures } from "../feature-config";
 import { resolveConversationCreator } from "../../conversations/creator";
-import { buildConversationShareUrl } from "../conversation-share-url";
+import { buildConversationShareUrl, getSharedConversationId } from "../conversation-share-url";
+import { useConversationBrowserState } from "../composables/conversation-browser-state";
 import {
   resolveTelaAgentInputs,
   useChat
@@ -133,7 +134,7 @@ const {
   closePreview
 } = useFilePreviewPanel();
 const { isOpen: isCitationPanelOpen } = useCitationPanel();
-const sharedConversationId = typeof route.query.conversation === "string" ? route.query.conversation : null;
+const sharedConversationId = getSharedConversationId(route.query);
 const activeConversationId = ref(
   normalizeConversationId(props.conversationId) ?? normalizeConversationId(props.initialConversationId) ?? normalizeConversationId(sharedConversationId)
 );
@@ -492,6 +493,11 @@ function dismissOutdatedBanner() {
   }
 }
 const optimisticTitle = ref(null);
+useConversationBrowserState(activeConversationId, computed(() => {
+  if (currentConversation.value?.id !== activeConversationId.value)
+    return null;
+  return optimisticTitle.value ?? currentConversation.value?.title ?? null;
+}));
 const displayTitle = computed(() => {
   if (optimisticTitle.value !== null)
     return optimisticTitle.value;

package/dist/runtime/embed/composables/conversation-browser-state.d.ts

@@ -0,0 +1,2 @@
+import type { Ref } from 'vue';
+export declare function useConversationBrowserState(conversationId: Ref<string | null>, title: Ref<string | null>): void;

package/dist/runtime/embed/composables/conversation-browser-state.js

@@ -0,0 +1,18 @@
+export function useConversationBrowserState(conversationId, title) {
+  const route = useRoute();
+  const router = useRouter();
+  useHead(computed(() => title.value ? { title: title.value } : {}));
+  onMounted(() => {
+    watch(conversationId, async (id) => {
+      if (route.query.conversationId === (id ?? void 0) && route.query.conversation === void 0)
+        return;
+      const query = { ...route.query };
+      delete query.conversation;
+      if (id)
+        query.conversationId = id;
+      else
+        delete query.conversationId;
+      await router.replace({ path: route.path, query, hash: route.hash });
+    }, { immediate: true });
+  });
+}

package/dist/runtime/embed/conversation-share-url.d.ts

@@ -1 +1,2 @@
+export declare function getSharedConversationId(query: Record<string, unknown>): string | null;
 export declare function buildConversationShareUrl(currentHref: string, conversationId: string): string;

package/dist/runtime/embed/conversation-share-url.js

@@ -1,5 +1,10 @@
+import { normalizeConversationId } from "../conversations/scope.js";
+export function getSharedConversationId(query) {
+  return normalizeConversationId(typeof query.conversationId === "string" ? query.conversationId : null) ?? normalizeConversationId(typeof query.conversation === "string" ? query.conversation : null);
+}
 export function buildConversationShareUrl(currentHref, conversationId) {
   const shareUrl = new URL(currentHref);
-  shareUrl.searchParams.set("conversation", conversationId);
+  shareUrl.searchParams.delete("conversation");
+  shareUrl.searchParams.set("conversationId", conversationId);
   return shareUrl.href;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meistrari/chat-nuxt",
-  "version": "4.1.0-rc.2",
+  "version": "4.1.0-rc.3",
   "type": "module",
   "exports": {
     ".": {