nuxt-convex-module 0.0.1 → 0.9.0

package/dist/runtime/vue/hydration.d.ts

@@ -14,10 +14,10 @@ export type Preloaded<Query extends FunctionReference<'query'>> = {
 };
 /**
  * Load a reactive query within a Vue component using a `Preloaded` payload
- * from the server returned by {@link preloadQuery}.
+ * from the server returned by {@link server!preloadQuery | preloadQuery}.
  *
- * This Vue composable contains internal state that will cause a rerender
- * whenever the query result changes.
+ * This Vue composable returns a computed that updates whenever the query
+ * result changes.
  *
  * Throws an error if no Convex client has been provided (see {@link useConvex}).
  *
@@ -43,24 +43,3 @@ export type Preloaded<Query extends FunctionReference<'query'>> = {
  * @public
  */
 export declare function usePreloadedQuery<Query extends FunctionReference<'query'>>(preloadedQuery: MaybeRefOrGetter<Preloaded<Query>>): ComputedRef<Query['_returnType']>;
-/**
- * Derive the query reference and reactive args/fallback from a (possibly
- * reactive) `Preloaded` payload. All three are reactive: swapping in a payload
- * for a different query re-derives the reference, matching upstream's
- * `usePreloadedQuery`, which recomputes `makeFunctionReference(_name)` on
- * every render.
- *
- * @internal
- */
-export declare function usePreloadedPayload<Query extends FunctionReference<'query'>>(preloadedQuery: MaybeRefOrGetter<Preloaded<Query>>): {
-    query: ComputedRef<Query>;
-    args: ComputedRef<Query['_args']>;
-    preloadedResult: ComputedRef<Query['_returnType']>;
-};
-/**
- * A `useQuery` variant whose query *reference* is reactive alongside its args.
- * Pass `'skip'` args to pause the subscription.
- *
- * @internal
- */
-export declare function useReactiveQuery<Query extends FunctionReference<'query'>>(query: ComputedRef<Query>, args: ComputedRef<Query['_args'] | 'skip'>): ComputedRef<Query['_returnType'] | undefined>;

package/dist/runtime/vue/index.d.ts

@@ -69,7 +69,6 @@ export type { AuthTokenFetcher } from 'convex/browser';
 export * from './auth/helpers.js';
 export * from './auth/index.js';
 export { usePreloadedQuery, type Preloaded } from './hydration.js';
-export { useSubscription } from './composables/use-subscription.js';
 export { type VueMutation } from './composables/use-mutation.js';
 export { type VueAction } from './composables/use-action.js';
 export { type Watch, type WatchQueryOptions, type MutationOptions, type ConvexVueClientOptions, } from './client.js';
@@ -89,6 +88,7 @@ export type { ConnectionState, OptimisticUpdate, QueryJournal, } from 'convex/br
 export type { FunctionReference, FunctionArgs, FunctionReturnType, OptionalRestArgs, ArgsAndOptions, } from 'convex/server';
 export type { Value } from 'convex/values';
 export { useUpload, useConvexUpload, uploadFile, type VueUpload, type UseUploadOptions, type UploadFileOptions, type GenerateUploadUrl, type StorageId, } from './composables/use-upload.js';
-export { useUploadQueue, useConvexUploadQueue, type VueUploadQueue, type UseUploadQueueOptions, type UploadQueueItem, type UploadItemStatus, } from './composables/use-upload-queue.js';
+export { useUploadQueue, useConvexUploadQueue, type VueUploadQueue, type UseUploadQueueOptions, type UploadQueueItem, type UploadItemStatus, type EnqueueInput, } from './composables/use-upload-queue.js';
 export { useStorageUrl, useConvexStorageUrl, type GetStorageUrl, } from './composables/use-storage-url.js';
+export { ConvexImage } from './components/convex-image.js';
 export { provideConvexApi, useConvexApi, useConvexNamespace, ConvexApiKey, type ConvexApi, } from './provide.js';

package/dist/runtime/vue/index.js

@@ -34,6 +34,7 @@ export {
   useStorageUrl,
   useConvexStorageUrl
 } from "./composables/use-storage-url.js";
+export { ConvexImage } from "./components/convex-image.js";
 export {
   provideConvexApi,
   useConvexApi,

package/dist/runtime/vue/plugin.js

@@ -6,7 +6,7 @@ export default defineNuxtPlugin({
     const url = useRuntimeConfig().public.convex.url;
     if (!url) {
       if (import.meta.client) {
-        console.warn("[nuxt-convex-module] No Convex URL configured; client not created.");
+        console.warn("[nuxt-convex-module] No Convex deployment URL configured \u2014 client not created. Set NUXT_PUBLIC_CONVEX_URL or `convex.url` in nuxt.config.");
       }
       return;
     }

package/dist/runtime/vue/provide.d.ts

@@ -9,8 +9,8 @@ export type ConvexApi = Record<string, Record<string, unknown>>;
 export declare const ConvexApiKey: InjectionKey<ConvexApi>;
 /**
  * Make the generated Convex `api` available to every `nuxt-convex-module` composable
- * and component, so `useBilling()`, `<CheckoutLink>`, `useEmailStatus()`, … work
- * with zero arguments.
+ * and component, so `<CheckoutLink>`, `<CustomerPortalLink>`, `useConvexNamespace()`,
+ * … work with zero arguments.
  *
  * The packaged Nuxt plugin calls this automatically with `#convex/api`. Call it
  * yourself (e.g. with a custom `api`) only to override that default — pass the
@@ -30,9 +30,9 @@ export declare function provideConvexApi(api: ConvexApi, app?: App): void;
  */
 export declare function useConvexApi(): ConvexApi | undefined;
 /**
- * The named function group from the generated `api` (e.g. `'billing'`,
- * `'email'`), or `undefined` when billing/email isn't scaffolded — letting the
- * feature degrade to a graceful no-op rather than throwing.
+ * The named function group from the generated `api` (e.g. `'polar'`), or
+ * `undefined` when that group isn't scaffolded — letting the feature degrade
+ * to a graceful no-op rather than throwing.
  *
  * @typeParam T - The expected shape of the namespace's function references.
  */

package/dist/types.d.mts

@@ -1,3 +1,3 @@
-export { type convexTypeFallbackContents, default, type formatStartupSummary, type getConvexAliases, type resolveDeploymentUrls, type resolveIntegrationState, type validateModuleOptions } from './module.mjs'
+export { default } from './module.mjs'
 
-export { type BetterAuthModuleOptions, type IntegrationFlags, type ModuleOptionDiagnostics, type ModuleOptions } from './module.mjs'
+export { type BetterAuthModuleOptions, type ModuleOptions } from './module.mjs'

package/package.json

@@ -1,15 +1,15 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "nuxt-convex-module",
-  "version": "0.0.1",
-  "description": "The Convex module for Nuxt — reactive live queries, mutations, actions, cursor pagination, file storage, connection state and SSR, on a complete Vue client that also runs without Nuxt, with opt-in Better Auth and Polar",
+  "version": "0.9.0",
+  "description": "Connects a Nuxt app to a Convex backend: live queries, mutations, actions, pagination, file storage and SSR, auto-imported and typed against your deployment. The same Vue client runs without Nuxt; Better Auth, Clerk, Auth0 and Polar are opt-in.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/qruto/nuxt-convex-module.git"
   },
   "license": "MIT",
   "author": "Slava Razum <razum@qruto.to>",
-  "homepage": "https://github.com/qruto/nuxt-convex-module#readme",
+  "homepage": "https://nuxt-convex-module.dev",
   "bugs": {
     "url": "https://github.com/qruto/nuxt-convex-module/issues"
   },
@@ -19,13 +19,22 @@
   },
   "keywords": [
     "nuxt",
+    "convex",
     "nuxt-module",
     "vue",
-    "convex",
+    "realtime",
+    "live-queries",
+    "backend",
+    "database",
+    "ssr",
+    "file-storage",
+    "auth",
+    "authentication",
     "better-auth",
+    "clerk",
+    "auth0",
     "polar",
-    "realtime",
-    "ssr"
+    "billing"
   ],
   "type": "module",
   "exports": {
@@ -46,10 +55,18 @@
       "types": "./dist/runtime/nuxt/index.d.ts",
       "import": "./dist/runtime/nuxt/index.js"
     },
+    "./app": {
+      "types": "./dist/runtime/nuxt/app.d.ts",
+      "import": "./dist/runtime/nuxt/app.js"
+    },
     "./better-auth/client": {
       "types": "./dist/runtime/better-auth/vue/index.d.ts",
       "import": "./dist/runtime/better-auth/vue/index.js"
     },
+    "./better-auth/vue": {
+      "types": "./dist/runtime/better-auth/vue/index.d.ts",
+      "import": "./dist/runtime/better-auth/vue/index.js"
+    },
     "./better-auth/server": {
       "types": "./dist/runtime/better-auth/nuxt/server.d.ts",
       "import": "./dist/runtime/better-auth/nuxt/server.js"
@@ -94,9 +111,15 @@
       "server": [
         "./dist/runtime/nuxt/index.d.ts"
       ],
+      "app": [
+        "./dist/runtime/nuxt/app.d.ts"
+      ],
       "better-auth/client": [
         "./dist/runtime/better-auth/vue/index.d.ts"
       ],
+      "better-auth/vue": [
+        "./dist/runtime/better-auth/vue/index.d.ts"
+      ],
       "better-auth/server": [
         "./dist/runtime/better-auth/nuxt/server.d.ts"
       ],
@@ -124,8 +147,7 @@
     "dist"
   ],
   "engines": {
-    "node": ">=24.11.0",
-    "pnpm": ">=11.6.0"
+    "node": ">=24.11.0"
   },
   "dependencies": {
     "@nuxt/devtools-kit": "^3.4.2",
@@ -136,8 +158,8 @@
   "peerDependencies": {
     "@auth0/auth0-vue": ">=2.0.0",
     "@clerk/vue": ">=2.0.0",
-    "@convex-dev/better-auth": ">=0.12.0",
-    "@convex-dev/polar": ">=0.9.0",
+    "@convex-dev/better-auth": ">=0.12.0 <0.13.0",
+    "@convex-dev/polar": ">=0.9.0 <0.10.0",
     "@polar-sh/checkout": ">=0.4.0",
     "better-auth": "~1.6.11",
     "convex": "^1.40.0",
@@ -170,7 +192,7 @@
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
     "@auth0/auth0-vue": "^2.9.0",
-    "@clerk/vue": "2.5.0",
+    "@clerk/vue": "2.5.1",
     "@commitlint/cli": "^21.2.2",
     "@commitlint/config-conventional": "^21.2.2",
     "@convex-dev/better-auth": "^0.12.5",
@@ -182,21 +204,22 @@
     "@nuxt/schema": "^4.5.2",
     "@nuxt/test-utils": "^4.3.2",
     "@polar-sh/checkout": "^0.4.1",
-    "@types/node": "^26.5.0",
+    "@types/node": "^26.5.1",
     "@types/ws": "^8.18.1",
     "@unhead/vue": "^3.4.0",
     "@vitest/coverage-v8": "^5.0.0",
     "@vue/test-utils": "^2.5.0",
-    "better-auth": "~1.6.30",
+    "better-auth": "~1.6.31",
     "changelogen": "^0.6.2",
     "convex": "^1.45.0",
     "eslint": "^10.10.0",
-    "fallow": "3.23.0",
-    "happy-dom": "^20.14.0",
+    "fallow": "3.25.0",
+    "happy-dom": "^20.14.5",
     "installed-check": "^11.0.0",
     "nuxt": "^4.5.2",
     "nuxt-security": "^2.6.0",
     "pkg-pr-new": "^0.0.88",
+    "playwright-core": "^1.63.0",
     "portless": "0.15.6",
     "publint": "^0.3.24",
     "taze": "^21.1.0",
@@ -211,6 +234,17 @@
   "publishConfig": {
     "access": "public"
   },
+  "changelog": {
+    "scopeMap": {
+      "better-auth": "Better Auth",
+      "ci": "CI",
+      "deps": "Dependencies",
+      "deps-dev": "Dev dependencies",
+      "devtools": "DevTools",
+      "dx": "DX",
+      "github": "GitHub"
+    }
+  },
   "scripts": {
     "build": "nuxt-module-build build && pnpm run build:devtools-client",
     "build:devtools-client": "nuxt generate devtools-client-app",
@@ -230,8 +264,10 @@
     "test:types:lib": "pnpm run dev:prepare:lib && pnpm run typecheck",
     "test:unit": "vitest --project unit --run",
     "test:nuxt": "vitest --project nuxt --run",
+    "test:module": "vitest --project module --run",
+    "test:docs": "vitest --project docs --run",
     "test:e2e": "vitest --run --project e2e",
-    "test:quality": "fallow",
+    "test:quality": "fallow --fail-on-issues",
     "test:security": "fallow security --fail-on-issues",
     "docs:api": "typedoc && node scripts/typedoc-postprocess.mjs",
     "docs:api:check": "pnpm run docs:api && git diff --exit-code -- website/content/4.api-reference",

package/dist/devtools-client/_nuxt/builds/meta/23303226-2230-4d14-87ce-87b0f562de6c.json

@@ -1 +0,0 @@
-{"id":"23303226-2230-4d14-87ce-87b0f562de6c","timestamp":1789163683324,"prerendered":[]}

package/dist/devtools-client/_nuxt/error-404.BpRUKU69.css

@@ -1 +0,0 @@
-.grid[data-v-bc32d885]{display:grid}.mb-2[data-v-bc32d885]{margin-bottom:.5rem}.mb-4[data-v-bc32d885]{margin-bottom:1rem}.max-w-520px[data-v-bc32d885]{max-width:520px}.min-h-screen[data-v-bc32d885]{min-height:100vh}.w-full[data-v-bc32d885]{width:100%}.flex[data-v-bc32d885]{display:flex}.place-content-center[data-v-bc32d885]{place-content:center}.items-center[data-v-bc32d885]{align-items:center}.justify-center[data-v-bc32d885]{justify-content:center}.overflow-hidden[data-v-bc32d885]{overflow:hidden}.bg-white[data-v-bc32d885]{--un-bg-opacity:1;background-color:rgb(255 255 255/var(--un-bg-opacity))}.px-2[data-v-bc32d885]{padding-left:.5rem;padding-right:.5rem}.text-center[data-v-bc32d885]{text-align:center}.text-\[80px\][data-v-bc32d885]{font-size:80px}.text-2xl[data-v-bc32d885]{font-size:1.5rem;line-height:2rem}.text-sm[data-v-bc32d885]{font-size:.875rem;line-height:1.25rem}.text-\[\#020420\][data-v-bc32d885]{--un-text-opacity:1;color:rgb(2 4 32/var(--un-text-opacity))}.text-\[\#64748B\][data-v-bc32d885]{--un-text-opacity:1;color:rgb(100 116 139/var(--un-text-opacity))}.hover\:text-\[\#00DC82\][data-v-bc32d885]:hover{--un-text-opacity:1;color:rgb(0 220 130/var(--un-text-opacity))}.font-medium[data-v-bc32d885]{font-weight:500}.font-semibold[data-v-bc32d885]{font-weight:600}.leading-none[data-v-bc32d885]{line-height:1}.tracking-wide[data-v-bc32d885]{letter-spacing:.025em}.font-sans[data-v-bc32d885]{font-family:ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,Noto Sans,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji}.tabular-nums[data-v-bc32d885]{--un-numeric-spacing:tabular-nums;font-variant-numeric:var(--un-ordinal) var(--un-slashed-zero) var(--un-numeric-figure) var(--un-numeric-spacing) var(--un-numeric-fraction)}.underline[data-v-bc32d885]{text-decoration-line:underline}.underline-offset-3[data-v-bc32d885]{text-underline-offset:3px}.antialiased[data-v-bc32d885]{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}@media (prefers-color-scheme:dark){.dark\:bg-\[\#020420\][data-v-bc32d885]{--un-bg-opacity:1;background-color:rgb(2 4 32/var(--un-bg-opacity))}.dark\:text-white[data-v-bc32d885]{--un-text-opacity:1;color:rgb(255 255 255/var(--un-text-opacity))}}@media (width>=640px){.sm\:text-\[110px\][data-v-bc32d885]{font-size:110px}.sm\:text-3xl[data-v-bc32d885]{font-size:1.875rem;line-height:2.25rem}}

package/dist/devtools-client/_nuxt/error-500.DuDYJ5TI.css

@@ -1 +0,0 @@
-.grid[data-v-512e66c2]{display:grid}.mb-2[data-v-512e66c2]{margin-bottom:.5rem}.mb-4[data-v-512e66c2]{margin-bottom:1rem}.max-w-520px[data-v-512e66c2]{max-width:520px}.min-h-screen[data-v-512e66c2]{min-height:100vh}.place-content-center[data-v-512e66c2]{place-content:center}.overflow-hidden[data-v-512e66c2]{overflow:hidden}.bg-white[data-v-512e66c2]{--un-bg-opacity:1;background-color:rgb(255 255 255/var(--un-bg-opacity))}.px-2[data-v-512e66c2]{padding-left:.5rem;padding-right:.5rem}.text-center[data-v-512e66c2]{text-align:center}.text-\[80px\][data-v-512e66c2]{font-size:80px}.text-2xl[data-v-512e66c2]{font-size:1.5rem;line-height:2rem}.text-\[\#020420\][data-v-512e66c2]{--un-text-opacity:1;color:rgb(2 4 32/var(--un-text-opacity))}.text-\[\#64748B\][data-v-512e66c2]{--un-text-opacity:1;color:rgb(100 116 139/var(--un-text-opacity))}.font-semibold[data-v-512e66c2]{font-weight:600}.leading-none[data-v-512e66c2]{line-height:1}.tracking-wide[data-v-512e66c2]{letter-spacing:.025em}.font-sans[data-v-512e66c2]{font-family:ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,Noto Sans,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji}.tabular-nums[data-v-512e66c2]{--un-numeric-spacing:tabular-nums;font-variant-numeric:var(--un-ordinal) var(--un-slashed-zero) var(--un-numeric-figure) var(--un-numeric-spacing) var(--un-numeric-fraction)}.antialiased[data-v-512e66c2]{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}@media (prefers-color-scheme:dark){.dark\:bg-\[\#020420\][data-v-512e66c2]{--un-bg-opacity:1;background-color:rgb(2 4 32/var(--un-bg-opacity))}.dark\:text-white[data-v-512e66c2]{--un-text-opacity:1;color:rgb(255 255 255/var(--un-text-opacity))}}@media (width>=640px){.sm\:text-\[110px\][data-v-512e66c2]{font-size:110px}.sm\:text-3xl[data-v-512e66c2]{font-size:1.875rem;line-height:2.25rem}}

package/dist/devtools-client/_nuxt/queries.BmISPDaV.css

@@ -1 +0,0 @@
-.n-code-block-lines code{counter-increment:step calc(var(--start,1) - 1);counter-reset:step}.n-code-block-lines code .line:before{content:counter(step);counter-increment:step;text-align:right;color:#a3a3a380;width:2.5rem;margin-right:.5rem;padding-right:.5rem;display:inline-block}details[data-v-c64ba2dc],summary[data-v-c64ba2dc]{border-style:none}summary[data-v-c64ba2dc]{list-style:none}details[open] summary[data-v-c64ba2dc]{border-style:none}details summary[data-v-c64ba2dc]::-webkit-details-marker{display:none}details[open] .chevron[data-v-c64ba2dc]{opacity:.75;transform:rotate(180deg)}