better-convex-nuxt 0.2.11 → 0.2.12

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": ">=3.0.0"
   },
-  "version": "0.2.11",
+  "version": "0.2.12",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/runtime/composables/useConvexAuth.d.ts

@@ -1,4 +1,30 @@
+import type { ConvexUser } from '../utils/types.js';
+import type { createAuthClient } from 'better-auth/vue';
+import type { ComputedRef, Ref } from 'vue';
 export type { ConvexUser } from '../utils/types.js';
+type AuthClient = ReturnType<typeof createAuthClient>;
+export interface UseConvexAuthReturn {
+    /** The JWT token for Convex authentication (readonly) */
+    token: Readonly<Ref<string | null>>;
+    /** The authenticated user data (readonly) */
+    user: Readonly<Ref<ConvexUser | null>>;
+    /** Whether the user is authenticated */
+    isAuthenticated: ComputedRef<boolean>;
+    /** Whether an auth operation is pending */
+    isPending: Readonly<Ref<boolean>>;
+    /** Auth error message if authentication failed (e.g., 401/403) */
+    authError: Readonly<Ref<string | null>>;
+    /**
+     * Signs out the user from both Better Auth and Convex.
+     * Clears local state immediately and calls Better Auth's signOut().
+     */
+    signOut: () => Promise<ReturnType<AuthClient['signOut']> extends Promise<infer T> ? T | null : null>;
+    /**
+     * Force refresh Convex auth state after login.
+     * Triggers fresh token fetch and updates reactive state.
+     */
+    refreshAuth: () => Promise<void>;
+}
 /**
  * Composable for accessing Convex authentication state.
  *
@@ -30,54 +56,4 @@ export type { ConvexUser } from '../utils/types.js';
  * </template>
  * ```
  */
-export declare function useConvexAuth(): {
-    /** The JWT token for Convex authentication (readonly) */
-    token: Readonly<import("vue").Ref<string | null, string | null>>;
-    /** The authenticated user data (readonly) */
-    user: Readonly<import("vue").Ref<{
-        readonly id: string;
-        readonly name: string;
-        readonly email: string;
-        readonly emailVerified?: boolean | undefined;
-        readonly image?: string | undefined;
-        readonly createdAt?: string | undefined;
-        readonly updatedAt?: string | undefined;
-    } | null, {
-        readonly id: string;
-        readonly name: string;
-        readonly email: string;
-        readonly emailVerified?: boolean | undefined;
-        readonly image?: string | undefined;
-        readonly createdAt?: string | undefined;
-        readonly updatedAt?: string | undefined;
-    } | null>>;
-    /** Whether the user is authenticated */
-    isAuthenticated: import("vue").ComputedRef<boolean>;
-    /** Whether an auth operation is pending */
-    isPending: Readonly<import("vue").Ref<boolean, boolean>>;
-    /** Auth error message if authentication failed (e.g., 401/403) */
-    authError: Readonly<import("vue").Ref<string | null, string | null>>;
-    /**
-     * Signs out the user from both Better Auth and Convex.
-     * Clears local state immediately and calls Better Auth's signOut().
-     */
-    signOut: () => Promise<{
-        data: {
-            success: boolean;
-        };
-        error: null;
-    } | {
-        data: null;
-        error: {
-            code?: string | undefined | undefined;
-            message?: string | undefined | undefined;
-            status: number;
-            statusText: string;
-        };
-    } | null>;
-    /**
-     * Force refresh Convex auth state after login.
-     * Triggers fresh token fetch and updates reactive state.
-     */
-    refreshAuth: () => Promise<void>;
-};
+export declare function useConvexAuth(): UseConvexAuthReturn;

package/dist/runtime/composables/useConvexAuth.js

@@ -3,7 +3,7 @@ export function useConvexAuth() {
   const nuxtApp = useNuxtApp();
   const token = useState("convex:token", () => null);
   const user = useState("convex:user", () => null);
-  const pending = useState("convex:pending", () => true);
+  const pending = useState("convex:pending", () => import.meta.client);
   const authError = useState("convex:authError", () => null);
   const isAuthenticated = computed(() => !!token.value && !!user.value);
   const signOut = async () => {

package/dist/runtime/composables/useConvexQuery.js

@@ -1,5 +1,5 @@
 import { useNuxtApp, useRuntimeConfig, useRequestEvent, useAsyncData, useState } from "#imports";
-import { computed, watch, triggerRef, onUnmounted, toValue, isRef, isReactive } from "vue";
+import { computed, watch, triggerRef, onScopeDispose, getCurrentScope, toValue, isRef, isReactive } from "vue";
 import {
   getFunctionName,
   hashArgs,
@@ -7,9 +7,11 @@ import {
   parseConvexResponse,
   computeQueryStatus,
   fetchAuthToken,
+  createQueryBridge,
   registerSubscription,
   getSubscription,
-  releaseSubscription
+  releaseSubscription,
+  ensureQueryBridge
 } from "../utils/convex-cache.js";
 import { createLogger, getLogLevel } from "../utils/logger.js";
 let devToolsRegistry = null;
@@ -137,7 +139,57 @@ export function useConvexQuery(query, args, options) {
     );
   });
   let registeredCacheKey = null;
-  if (import.meta.client && subscribe) {
+  const cleanupScope = import.meta.client && subscribe ? getCurrentScope() : void 0;
+  let stopSharedDataWatch = null;
+  let stopSharedErrorWatch = null;
+  const cleanupSharedBridgeWatchers = () => {
+    if (stopSharedDataWatch) {
+      stopSharedDataWatch();
+      stopSharedDataWatch = null;
+    }
+    if (stopSharedErrorWatch) {
+      stopSharedErrorWatch();
+      stopSharedErrorWatch = null;
+    }
+  };
+  const attachSharedBridge = (entry) => {
+    cleanupSharedBridgeWatchers();
+    const bridge = ensureQueryBridge(entry);
+    const syncDataFromBridge = () => {
+      if (!bridge.hasRawData) return;
+      const transformedResult = applyTransform(bridge.rawData);
+      asyncData.data.value = transformedResult;
+      if (asyncData.error.value !== null) {
+        ;
+        asyncData.error.value = null;
+      }
+      triggerRef(asyncData.data);
+    };
+    const syncErrorFromBridge = () => {
+      const err = bridge.error;
+      if (!err) return;
+      const hasData = asyncData.data.value !== null && asyncData.data.value !== void 0;
+      if (!hasData) {
+        ;
+        asyncData.error.value = err;
+      }
+    };
+    stopSharedDataWatch = watch(
+      () => bridge.dataVersion.value,
+      () => {
+        syncDataFromBridge();
+      }
+    );
+    stopSharedErrorWatch = watch(
+      () => bridge.errorVersion.value,
+      () => {
+        syncErrorFromBridge();
+      }
+    );
+    syncDataFromBridge();
+    syncErrorFromBridge();
+  };
+  if (import.meta.client && subscribe && cleanupScope) {
     const setupSubscription = () => {
       const currentArgs = getArgs();
       if (currentArgs === "skip") {
@@ -152,21 +204,20 @@ export function useConvexQuery(query, args, options) {
       if (existingEntry) {
         existingEntry.refCount++;
         registeredCacheKey = currentCacheKey;
+        attachSharedBridge(existingEntry);
         logger.query({ name: fnName, event: "share", refCount: existingEntry.refCount, args: currentArgs });
         return;
       }
       try {
+        const localBridge = createQueryBridge();
         const unsubscribeFn = convex.onUpdate(
           query,
           currentArgs,
           (result) => {
-            const transformedResult = applyTransform(result);
-            asyncData.data.value = transformedResult;
-            if (asyncData.error.value !== null) {
-              ;
-              asyncData.error.value = null;
-            }
-            triggerRef(asyncData.data);
+            localBridge.rawData = result;
+            localBridge.hasRawData = true;
+            localBridge.error = null;
+            localBridge.dataVersion.value += 1;
             logger.query({
               name: fnName,
               event: "update",
@@ -177,18 +228,15 @@ export function useConvexQuery(query, args, options) {
             if (import.meta.dev && devToolsRegistry) {
               devToolsRegistry.updateQueryStatus(currentCacheKey, {
                 status: "success",
-                data: transformedResult,
+                data: result,
                 dataSource: "websocket"
               });
             }
           },
           (err) => {
+            localBridge.error = err;
+            localBridge.errorVersion.value += 1;
             logger.query({ name: fnName, event: "error", error: err });
-            const hasData = asyncData.data.value !== null && asyncData.data.value !== void 0;
-            if (!hasData) {
-              ;
-              asyncData.error.value = err;
-            }
             if (import.meta.dev && devToolsRegistry) {
               devToolsRegistry.updateQueryStatus(currentCacheKey, {
                 status: "error",
@@ -198,7 +246,13 @@ export function useConvexQuery(query, args, options) {
           }
         );
         registerSubscription(nuxtApp, currentCacheKey, unsubscribeFn);
+        const registeredEntry = getSubscription(nuxtApp, currentCacheKey);
+        if (!registeredEntry) {
+          throw new Error("[useConvexQuery] Failed to register subscription entry");
+        }
+        registeredEntry.queryBridge = localBridge;
         registeredCacheKey = currentCacheKey;
+        attachSharedBridge(registeredEntry);
         logger.query({ name: fnName, event: "subscribe", args: currentArgs });
         if (import.meta.dev && devToolsRegistry) {
           devToolsRegistry.registerQuery({
@@ -229,6 +283,7 @@ export function useConvexQuery(query, args, options) {
         (newArgs, oldArgs) => {
           if (hashArgs(newArgs) !== hashArgs(oldArgs)) {
             if (oldArgs !== "skip" && registeredCacheKey) {
+              cleanupSharedBridgeWatchers();
               const wasUnsubscribed = releaseSubscription(nuxtApp, registeredCacheKey);
               if (wasUnsubscribed) {
                 logger.query({ name: fnName, event: "unsubscribe" });
@@ -246,8 +301,9 @@ export function useConvexQuery(query, args, options) {
         { deep: true }
       );
     }
-    onUnmounted(() => {
+    onScopeDispose(() => {
       if (registeredCacheKey) {
+        cleanupSharedBridgeWatchers();
         const wasUnsubscribed = releaseSubscription(nuxtApp, registeredCacheKey);
         if (wasUnsubscribed) {
           logger.query({ name: fnName, event: "unsubscribe" });
@@ -256,8 +312,14 @@ export function useConvexQuery(query, args, options) {
           }
         }
         registeredCacheKey = null;
+      } else {
+        cleanupSharedBridgeWatchers();
       }
     });
+  } else if (import.meta.client && subscribe && import.meta.dev) {
+    console.warn(
+      `[useConvexQuery] Real-time subscriptions require a Vue component/effect scope for cleanup. Detected usage outside a component (e.g. route middleware/plugin). Falling back to one-shot query only. Pass { subscribe: false } to silence this warning.`
+    );
   }
   let resolvePromise;
   if (isSkipped.value) {

package/dist/runtime/devtools/ui/dist/200.html

@@ -1 +1 @@
-<!DOCTYPE html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Convex DevTools</title><link rel="stylesheet" href="/__convex_devtools__/_nuxt/entry.BiOLMZBG.css" crossorigin><link rel="modulepreload" as="script" crossorigin href="/__convex_devtools__/_nuxt/BhO0ov6K.js"><script type="module" src="/__convex_devtools__/_nuxt/BhO0ov6K.js" crossorigin></script><script id="unhead:payload" type="application/json">{"title":"Convex DevTools"}</script></head><body><div id="__nuxt"></div><div id="teleports"></div><script>window.__NUXT__={};window.__NUXT__.config={public:{},app:{baseURL:"/__convex_devtools__",buildId:"4441cf51-019c-4d8d-b387-2c168e8d08e3",buildAssetsDir:"/_nuxt/",cdnURL:""}}</script><script type="application/json" data-nuxt-data="nuxt-app" data-ssr="false" id="__NUXT_DATA__">[{"prerenderedAt":1,"serverRendered":2},1772107968698,false]</script></body></html>
+<!DOCTYPE html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Convex DevTools</title><link rel="stylesheet" href="/__convex_devtools__/_nuxt/entry.BiOLMZBG.css" crossorigin><link rel="modulepreload" as="script" crossorigin href="/__convex_devtools__/_nuxt/BhO0ov6K.js"><script type="module" src="/__convex_devtools__/_nuxt/BhO0ov6K.js" crossorigin></script><script id="unhead:payload" type="application/json">{"title":"Convex DevTools"}</script></head><body><div id="__nuxt"></div><div id="teleports"></div><script>window.__NUXT__={};window.__NUXT__.config={public:{},app:{baseURL:"/__convex_devtools__",buildId:"a5e03a13-122d-4d8e-b569-24b5d8908506",buildAssetsDir:"/_nuxt/",cdnURL:""}}</script><script type="application/json" data-nuxt-data="nuxt-app" data-ssr="false" id="__NUXT_DATA__">[{"prerenderedAt":1,"serverRendered":2},1772128215997,false]</script></body></html>

package/dist/runtime/devtools/ui/dist/404.html

@@ -1 +1 @@
-<!DOCTYPE html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Convex DevTools</title><link rel="stylesheet" href="/__convex_devtools__/_nuxt/entry.BiOLMZBG.css" crossorigin><link rel="modulepreload" as="script" crossorigin href="/__convex_devtools__/_nuxt/BhO0ov6K.js"><script type="module" src="/__convex_devtools__/_nuxt/BhO0ov6K.js" crossorigin></script><script id="unhead:payload" type="application/json">{"title":"Convex DevTools"}</script></head><body><div id="__nuxt"></div><div id="teleports"></div><script>window.__NUXT__={};window.__NUXT__.config={public:{},app:{baseURL:"/__convex_devtools__",buildId:"4441cf51-019c-4d8d-b387-2c168e8d08e3",buildAssetsDir:"/_nuxt/",cdnURL:""}}</script><script type="application/json" data-nuxt-data="nuxt-app" data-ssr="false" id="__NUXT_DATA__">[{"prerenderedAt":1,"serverRendered":2},1772107968699,false]</script></body></html>
+<!DOCTYPE html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Convex DevTools</title><link rel="stylesheet" href="/__convex_devtools__/_nuxt/entry.BiOLMZBG.css" crossorigin><link rel="modulepreload" as="script" crossorigin href="/__convex_devtools__/_nuxt/BhO0ov6K.js"><script type="module" src="/__convex_devtools__/_nuxt/BhO0ov6K.js" crossorigin></script><script id="unhead:payload" type="application/json">{"title":"Convex DevTools"}</script></head><body><div id="__nuxt"></div><div id="teleports"></div><script>window.__NUXT__={};window.__NUXT__.config={public:{},app:{baseURL:"/__convex_devtools__",buildId:"a5e03a13-122d-4d8e-b569-24b5d8908506",buildAssetsDir:"/_nuxt/",cdnURL:""}}</script><script type="application/json" data-nuxt-data="nuxt-app" data-ssr="false" id="__NUXT_DATA__">[{"prerenderedAt":1,"serverRendered":2},1772128215997,false]</script></body></html>

package/dist/runtime/devtools/ui/dist/_nuxt/builds/latest.json

@@ -1 +1 @@
-{"id":"4441cf51-019c-4d8d-b387-2c168e8d08e3","timestamp":1772107966161}
+{"id":"a5e03a13-122d-4d8e-b569-24b5d8908506","timestamp":1772128213809}

package/dist/runtime/devtools/ui/dist/_nuxt/builds/meta/a5e03a13-122d-4d8e-b569-24b5d8908506.json

@@ -0,0 +1 @@
+{"id":"a5e03a13-122d-4d8e-b569-24b5d8908506","timestamp":1772128213809,"matcher":{"static":{},"wildcard":{},"dynamic":{}},"prerendered":[]}

package/dist/runtime/devtools/ui/dist/index.html

@@ -1 +1 @@
-<!DOCTYPE html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Convex DevTools</title><link rel="stylesheet" href="/__convex_devtools__/_nuxt/entry.BiOLMZBG.css" crossorigin><link rel="modulepreload" as="script" crossorigin href="/__convex_devtools__/_nuxt/BhO0ov6K.js"><script type="module" src="/__convex_devtools__/_nuxt/BhO0ov6K.js" crossorigin></script><script id="unhead:payload" type="application/json">{"title":"Convex DevTools"}</script></head><body><div id="__nuxt"></div><div id="teleports"></div><script>window.__NUXT__={};window.__NUXT__.config={public:{},app:{baseURL:"/__convex_devtools__",buildId:"4441cf51-019c-4d8d-b387-2c168e8d08e3",buildAssetsDir:"/_nuxt/",cdnURL:""}}</script><script type="application/json" data-nuxt-data="nuxt-app" data-ssr="false" id="__NUXT_DATA__">[{"prerenderedAt":1,"serverRendered":2},1772107968699,false]</script></body></html>
+<!DOCTYPE html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Convex DevTools</title><link rel="stylesheet" href="/__convex_devtools__/_nuxt/entry.BiOLMZBG.css" crossorigin><link rel="modulepreload" as="script" crossorigin href="/__convex_devtools__/_nuxt/BhO0ov6K.js"><script type="module" src="/__convex_devtools__/_nuxt/BhO0ov6K.js" crossorigin></script><script id="unhead:payload" type="application/json">{"title":"Convex DevTools"}</script></head><body><div id="__nuxt"></div><div id="teleports"></div><script>window.__NUXT__={};window.__NUXT__.config={public:{},app:{baseURL:"/__convex_devtools__",buildId:"a5e03a13-122d-4d8e-b569-24b5d8908506",buildAssetsDir:"/_nuxt/",cdnURL:""}}</script><script type="application/json" data-nuxt-data="nuxt-app" data-ssr="false" id="__NUXT_DATA__">[{"prerenderedAt":1,"serverRendered":2},1772128215997,false]</script></body></html>

package/dist/runtime/utils/convex-cache.d.ts

@@ -1,4 +1,5 @@
 import type { useNuxtApp } from '#app';
+import { type ShallowRef } from 'vue';
 export { type QueryStatus, parseConvexResponse, computeQueryStatus, getFunctionName, hashArgs, getQueryKey, } from './convex-shared.js';
 type NuxtApp = ReturnType<typeof useNuxtApp>;
 /**
@@ -8,11 +9,30 @@ type NuxtApp = ReturnType<typeof useNuxtApp>;
 export interface SubscriptionEntry {
     unsubscribe: () => void;
     refCount: number;
+    queryBridge?: QuerySubscriptionBridge;
+}
+/**
+ * Shared query state for deduplicated useConvexQuery subscribers.
+ * Stores raw subscription data and reactive version counters so each subscriber
+ * can sync into its own local asyncData refs with its own transform().
+ */
+export interface QuerySubscriptionBridge {
+    rawData: unknown;
+    hasRawData: boolean;
+    dataVersion: ShallowRef<number>;
+    error: Error | null;
+    errorVersion: ShallowRef<number>;
 }
 /**
  * Subscription cache stored on NuxtApp
  */
 export type SubscriptionCache = Record<string, SubscriptionEntry | undefined>;
+export declare function createQueryBridge(): QuerySubscriptionBridge;
+/**
+ * Ensure a deduplicated query subscription has a shared bridge payload.
+ * Used by useConvexQuery to fan out subscription updates to all subscribers.
+ */
+export declare function ensureQueryBridge(entry: SubscriptionEntry): QuerySubscriptionBridge;
 export interface FetchAuthTokenOptions {
     /** Whether this is a public query (skip auth) */
     isPublic: boolean;

package/dist/runtime/utils/convex-cache.js

@@ -1,3 +1,4 @@
+import { shallowRef } from "vue";
 export {
   parseConvexResponse,
   computeQueryStatus,
@@ -6,6 +7,21 @@ export {
   getQueryKey
 } from "./convex-shared.js";
 const subscriptionRegistry = /* @__PURE__ */ new WeakMap();
+export function createQueryBridge() {
+  return {
+    rawData: void 0,
+    hasRawData: false,
+    dataVersion: shallowRef(0),
+    error: null,
+    errorVersion: shallowRef(0)
+  };
+}
+export function ensureQueryBridge(entry) {
+  if (!entry.queryBridge) {
+    entry.queryBridge = createQueryBridge();
+  }
+  return entry.queryBridge;
+}
 export async function fetchAuthToken(options) {
   const { isPublic, cookieHeader, siteUrl, cachedToken } = options;
   if (isPublic) {

package/dist/runtime/utils/convex-shared.js

@@ -34,13 +34,21 @@ export function decodeUserFromJwt(token) {
   if (!payload.sub && !payload.userId && !payload.email) {
     return null;
   }
-  return {
+  const user = {
     id: String(payload.sub || payload.userId || ""),
     name: String(payload.name || ""),
     email: String(payload.email || ""),
     emailVerified: typeof payload.emailVerified === "boolean" ? payload.emailVerified : void 0,
     image: typeof payload.image === "string" ? payload.image : void 0
   };
+  for (const [key, value] of Object.entries(payload)) {
+    if (key === "sub" || key === "userId" || key === "name" || key === "email" || key === "emailVerified" || key === "image" || key === "iss" || key === "aud" || key === "exp" || key === "nbf" || key === "iat" || key === "jti") {
+      continue;
+    }
+    ;
+    user[key] = value;
+  }
+  return user;
 }
 export function parseConvexResponse(response) {
   if (response && typeof response === "object") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "better-convex-nuxt",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "description": "Full-featured Convex integration for Nuxt with SSR, real-time subscriptions, authentication, and permissions",
   "keywords": [
     "authentication",

package/dist/runtime/devtools/ui/dist/_nuxt/builds/meta/4441cf51-019c-4d8d-b387-2c168e8d08e3.json

@@ -1 +0,0 @@
-{"id":"4441cf51-019c-4d8d-b387-2c168e8d08e3","timestamp":1772107966161,"matcher":{"static":{},"wildcard":{},"dynamic":{}},"prerendered":[]}