kitcn 0.20.0 → 0.22.0

package/dist/{convex-plugin-BHVCqWTH.js → convex-plugin-D8B0oCFq.js}

@@ -28,16 +28,26 @@ const parseAuthConfig = (authConfig, opts) => {
 	if (!isDataUriJwks && opts.jwks) console.warn("Static JWKS provided to Convex plugin, but not to auth config. This adds an unnecessary network request for token verification.");
 	return providerConfig;
 };
-const convex = (opts) => {
-	const jwtExpirationSeconds = opts.jwt?.expirationSeconds ?? opts.jwtExpirationSeconds ?? 900;
+const oidcProviderCache = /* @__PURE__ */ new Map();
+const getOidcProvider = (basePath) => {
+	const siteUrl = `${process.env.CONVEX_SITE_URL}`;
+	const key = `${siteUrl}|${basePath}`;
+	const cached = oidcProviderCache.get(key);
+	if (cached) return cached;
 	const oidcProvider$1 = oidcProvider({
 		loginPage: "/not-used",
 		metadata: {
-			issuer: `${process.env.CONVEX_SITE_URL}`,
-			jwks_uri: `${process.env.CONVEX_SITE_URL}${opts.options?.basePath ?? "/api/auth"}/convex/jwks`
+			issuer: siteUrl,
+			jwks_uri: `${siteUrl}${basePath}/convex/jwks`
 		},
 		__skipDeprecationWarning: true
 	});
+	oidcProviderCache.set(key, oidcProvider$1);
+	return oidcProvider$1;
+};
+const convex = (opts) => {
+	const jwtExpirationSeconds = opts.jwt?.expirationSeconds ?? opts.jwtExpirationSeconds ?? 900;
+	const oidcProvider = getOidcProvider(opts.options?.basePath ?? "/api/auth");
 	const providerConfig = parseAuthConfig(opts.authConfig, opts);
 	const jwtOptions = {
 		jwt: {
@@ -128,7 +138,7 @@ const convex = (opts) => {
 				})
 			}],
 			after: [
-				...normalizeAfterHooks(oidcProvider$1.hooks.after),
+				...normalizeAfterHooks(oidcProvider.hooks.after),
 				{
 					matcher: (ctx) => {
 						return Boolean(ctx.path?.startsWith("/sign-in") || ctx.path?.startsWith("/sign-up") || ctx.path?.startsWith("/callback") || ctx.path?.startsWith("/oauth2/callback") || ctx.path?.startsWith("/magic-link/verify") || ctx.path?.startsWith("/email-otp/verify-email") || ctx.path?.startsWith("/phone-number/verify") || ctx.path?.startsWith("/siwe/verify") || ctx.path?.startsWith("/update-session") || ctx.path?.startsWith("/get-session") && ctx.context.session);
@@ -167,7 +177,7 @@ const convex = (opts) => {
 				method: "GET",
 				metadata: { isAction: false }
 			}, async (ctx) => {
-				return await oidcProvider$1.endpoints.getOpenIdConfig({
+				return await oidcProvider.endpoints.getOpenIdConfig({
 					...ctx,
 					asResponse: false,
 					returnHeaders: false,

package/dist/{generated-contract-disabled-BbPCefQM.d.ts → generated-contract-disabled-B-nmd7Ne.d.ts}

@@ -1,9 +1,11 @@
 import { t as GetAuth } from "./types-BCl8gfGy.js";
 import { t as GenericCtx } from "./context-utils-BBUtBqjN.js";
 import * as convex_server0 from "convex/server";
-import { DocumentByName, FunctionReference, GenericDataModel, GenericMutationCtx, GenericSchema, SchemaDefinition, TableNamesInDataModel, internalMutationGeneric } from "convex/server";
+import { DocumentByName, FunctionReference, GenericDataModel, GenericMutationCtx, GenericSchema, PaginationResult, SchemaDefinition, TableNamesInDataModel, internalMutationGeneric } from "convex/server";
 import * as better_auth_adapters0 from "better-auth/adapters";
+import { BetterAuthDBSchema, getAuthTables } from "better-auth/db";
 import { BetterAuthOptions } from "better-auth/minimal";
+import * as better_auth0 from "better-auth";
 import { Auth } from "better-auth";
 
 //#region src/auth/define-auth.d.ts
@@ -101,7 +103,7 @@ declare const findManyHandler: (ctx: any, args: {
     field: string;
   };
   where?: any[];
-}, schema: Schema, betterAuthSchema: any) => Promise<convex_server0.PaginationResult<convex_server0.GenericDocument>>;
+}, schema: Schema, betterAuthSchema: any) => Promise<PaginationResult<convex_server0.GenericDocument>>;
 declare const updateOneHandler: (ctx: any, args: {
   input: {
     model: string;
@@ -155,6 +157,12 @@ declare const deleteManyHandler: (ctx: any, args: {
 declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel extends GenericDataModel = GenericDataModel, Ctx = unknown, TriggerCtx = Ctx, Auth = unknown>(schema: Schema, getAuth: GetAuth<Ctx, Auth>, options?: {
   internalMutation?: typeof internalMutationGeneric;
   context?: (ctx: any) => TriggerCtx | Promise<TriggerCtx>;
+  /**
+   * Ctx-free Better Auth table schema, memoized by the caller. Supplying it
+   * lets the runtime share one derivation with the db adapter instead of
+   * building a throwaway auth instance just to read `.options`.
+   */
+  getBetterAuthSchema?: () => ReturnType<typeof getAuthTables>;
   triggers?: GenericAuthTriggers<DataModel, Schema, TriggerCtx> | ((ctx: TriggerCtx) => GenericAuthTriggers<DataModel, Schema, TriggerCtx> | undefined); /** Validate input validators against auth table schemas. Defaults to false for smaller generated types. */
   validateInput?: boolean;
 }) => {
@@ -177,8 +185,8 @@ declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel e
       where?: {
         connector?: "AND" | "OR" | undefined;
         operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
-        field: string;
         value: string | number | boolean | string[] | number[] | null;
+        field: string;
       }[] | undefined;
       model: string;
     } | {
@@ -206,8 +214,8 @@ declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel e
       where?: {
         connector?: "AND" | "OR" | undefined;
         operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
-        field: string;
         value: string | number | boolean | string[] | number[] | null;
+        field: string;
       }[] | undefined;
       model: string;
     } | {
@@ -216,20 +224,20 @@ declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel e
     };
   }, Promise<Record<string, unknown> | undefined>>;
   findMany: convex_server0.RegisteredQuery<"internal", {
-    limit?: number | undefined;
     join?: any;
-    offset?: number | undefined;
-    sortBy?: {
-      field: string;
-      direction: "asc" | "desc";
-    } | undefined;
     where?: {
       mode?: "sensitive" | "insensitive" | undefined;
       connector?: "AND" | "OR" | undefined;
       operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
-      field: string;
       value: string | number | boolean | string[] | number[] | null;
+      field: string;
     }[] | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    sortBy?: {
+      field: string;
+      direction: "asc" | "desc";
+    } | undefined;
     model: string;
     paginationOpts: {
       id?: number;
@@ -239,7 +247,7 @@ declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel e
       numItems: number;
       cursor: string | null;
     };
-  }, Promise<convex_server0.PaginationResult<convex_server0.GenericDocument>>>;
+  }, Promise<PaginationResult<convex_server0.GenericDocument>>>;
   findOne: convex_server0.RegisteredQuery<"internal", {
     join?: any;
     select?: string[] | undefined;
@@ -247,8 +255,8 @@ declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel e
       mode?: "sensitive" | "insensitive" | undefined;
       connector?: "AND" | "OR" | undefined;
       operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
-      field: string;
       value: string | number | boolean | string[] | number[] | null;
+      field: string;
     }[] | undefined;
     model: string;
   }, Promise<convex_server0.GenericDocument | null>>;
@@ -259,8 +267,8 @@ declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel e
       where?: {
         connector?: "AND" | "OR" | undefined;
         operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
-        field: string;
         value: string | number | boolean | string[] | number[] | null;
+        field: string;
       }[] | undefined;
       model: string;
       update: {
@@ -294,8 +302,8 @@ declare const createApi: <Schema extends SchemaDefinition<any, any>, DataModel e
       where?: {
         connector?: "AND" | "OR" | undefined;
         operator?: "lt" | "lte" | "gt" | "gte" | "eq" | "in" | "not_in" | "ne" | "contains" | "starts_with" | "ends_with" | undefined;
-        field: string;
         value: string | number | boolean | string[] | number[] | null;
+        field: string;
       }[] | undefined;
       model: string;
       update: {
@@ -325,13 +333,18 @@ type Triggers<DataModel extends GenericDataModel, Schema extends SchemaDefinitio
 type TriggerResolver<DataModel extends GenericDataModel, Schema extends SchemaDefinition<any, any>, TriggerCtx extends GenericMutationCtx<DataModel> = GenericMutationCtx<DataModel>> = Triggers<DataModel, Schema, TriggerCtx> | ((ctx: TriggerCtx) => Triggers<DataModel, Schema, TriggerCtx> | undefined);
 declare const createClient: <DataModel extends GenericDataModel, Schema extends SchemaDefinition<GenericSchema, true>, TriggerCtx extends GenericMutationCtx<DataModel> = GenericMutationCtx<DataModel>>(config: {
   authFunctions: AuthFunctions;
+  /**
+   * Ctx-free Better Auth table schema, memoized by the caller. Resolved lazily
+   * on the first db-adapter construction, never at module scope.
+   */
+  getBetterAuthSchema: () => BetterAuthDBSchema;
   schema: Schema;
   context?: (ctx: GenericMutationCtx<DataModel>) => TriggerCtx | Promise<TriggerCtx>;
   triggers?: TriggerResolver<DataModel, Schema, TriggerCtx>;
 }) => {
   authFunctions: AuthFunctions;
   triggers: TriggerResolver<DataModel, Schema, TriggerCtx> | undefined;
-  adapter: (ctx: GenericCtx<DataModel>, getAuthOptions: (ctx: any) => BetterAuthOptions) => better_auth_adapters0.AdapterFactory<BetterAuthOptions>;
+  adapter: (ctx: GenericCtx<DataModel>) => better_auth_adapters0.AdapterFactory<better_auth0.BetterAuthOptions>;
 };
 //#endregion
 //#region src/auth/generated-contract-disabled.d.ts

package/dist/orm/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as GenericOrmCtx$1, $n as unique, $r as endsWith, $t as ManyConfig, A as ConvexDateMode, An as ConvexRankIndexBuilder, Ar as ReturningResult, At as MigrationManifestEntry, B as ConvexBytesBuilderInitial, Bn as rankIndex, Br as OrmSchemaRelations, Bt as defineMigration, C as ConvexNumberBuilderInitial, Ci as ColumnBuilderWithTableName, Cn as RlsRole, Cr as MutationReturning, Ct as MigrationStatusArgs, D as id, Di as IsPrimaryKey, Dn as ConvexAggregateIndexBuilderOn, Dr as PaginatedResult, Dt as MigrationDoc, E as ConvexIdBuilderInitial, Ei as HasDefault, En as ConvexAggregateIndexBuilder, Er as OrderDirection, Et as MigrationDirection, F as custom, Fn as ConvexVectorIndexBuilder, Fr as unsetToken, Ft as MigrationStateMap, G as ConvexBigIntBuilder, Gn as ConvexCheckConfig, Gr as ExpressionVisitor, Gt as OrmReader$1, H as ConvexBooleanBuilder, Hn as uniqueIndex, Hr as TableName, Ht as detectMigrationDrift, I as json, In as ConvexVectorIndexBuilderOn, Ir as Brand, It as MigrationStep, J as CountBackfillChunkArgs, Jn as ConvexUniqueConstraintBuilder, Jr as LogicalExpression, Jt as RlsMode, K as ConvexBigIntBuilderInitial, Kn as ConvexForeignKeyBuilder, Kr as FieldReference, Kt as OrmWriter$1, L as objectOf, Ln as ConvexVectorIndexConfig, Lr as Columns, Lt as MigrationTableName, M as ConvexCustomBuilder, Mn as ConvexSearchIndexBuilder, Mr as UpdateSet, Mt as MigrationPlan, N as ConvexCustomBuilderInitial, Nn as ConvexSearchIndexBuilderOn, Nr as VectorQueryConfig, Nt as MigrationRunStatus, O as ConvexDateBuilder, Oi as IsUnique, On as ConvexIndexBuilder, Or as PredicateWhereIndexConfig, Ot as MigrationDocContext, P as arrayOf, Pn as ConvexSearchIndexConfig, Pr as VectorSearchProvider, Pt as MigrationSet, Q as GenericOrm$1, Qn as foreignKey, Qr as contains, Qt as ExtractTablesWithRelations, R as unionOf, Rn as aggregateIndex, Rr as OrmSchemaExtensionTables, Rt as MigrationWriteMode, S as ConvexNumberBuilder, Si as ColumnBuilderTypeConfig, Sn as rlsPolicy, Sr as MutationResult, St as MigrationRunChunkArgs, T as ConvexIdBuilder, Ti as DrizzleEntity, Tn as rlsRole, Tr as OrderByClause, Tt as MigrationDefinition, U as ConvexBooleanBuilderInitial, Un as vectorIndex, Ur as SystemFields, Ut as DatabaseWithMutations, V as bytes, Vn as searchIndex, Vr as OrmSchemaTriggers, Vt as defineMigrationSet, W as boolean, Wn as ConvexCheckBuilder, Wr as BinaryExpression, Wt as DatabaseWithQuery, X as CountBackfillStatusArgs, Xn as ConvexUniqueConstraintConfig, Xr as and, Xt as extractRelationsConfig, Y as CountBackfillKickoffArgs, Yn as ConvexUniqueConstraintBuilderOn, Yr as UnaryExpression, Yt as EdgeMetadata, Z as CreateOrmOptions, Zn as check, Zr as between, Zt as ExtractTablesFromSchema, _ as ConvexTimestampMode, _i as startsWith, _n as deletion, _r as MutationExecuteConfig, _t as OrmTriggerContext, a as requireSchemaRelations, ai as inArray, an as TablesRelationalConfig, ar as AggregateResult, at as OrmWriterCtx, b as ConvexTextEnumBuilderInitial, bi as ColumnBuilderBaseConfig, bn as RlsPolicyConfig, br as MutationPaginateConfig, bt as MigrationCancelArgs, c as TableConfigResult, ci as isNull, cn as ConvexDeletionBuilder, cr as CountConfig, ct as ScheduledMutationBatchArgs, d as OrmNotFoundError, di as lte, dn as ConvexTableWithColumns, dr as FilterOperators, dt as scheduledDeleteFactory, ei as eq, en as OneConfig, er as ConvexTextBuilder, et as OrmApiResult, f as ConvexVectorBuilder, fi as ne, fn as DiscriminatorBuilderConfig, fr as GetColumnData, ft as SchemaExtension, g as ConvexTimestampBuilderInitial, gi as or, gn as convexTable, gr as InsertValue, gt as OrmTriggerChange, h as ConvexTimestampBuilder, hi as notInArray, hn as TableConfig, hr as InferSelectModel, ht as OrmTableTriggers, i as getSchemaTriggers, ii as ilike, in as TableRelationalConfig, ir as AggregateFieldValue, it as OrmReaderCtx, j as date, jn as ConvexRankIndexBuilderOn, jr as ReturningSelection, jt as MigrationMigrateOne, k as ConvexDateBuilderInitial, ki as NotNull, kn as ConvexIndexBuilderOn, kr as ReturningAll, kt as MigrationDriftIssue, l as getTableColumns, li as like, ln as ConvexDeletionConfig, lr as CountResult, lt as scheduledMutationBatchFactory, m as vector, mi as notBetween, mn as OrmLifecycleOperation, mr as InferModelFromColumns, mt as OrmBeforeResult, n as defineSchema, ni as gt, nn as RelationsBuilderColumnBase, nr as text, nt as OrmClientWithApi$1, o as asc, oi as isFieldReference, on as defineRelations, or as BuildQueryResult, ot as ResolveOrmSchema, p as ConvexVectorBuilderInitial, pi as not, pn as OrmLifecycleChange, pr as InferInsertModel, pt as defineSchemaExtension, q as bigint, qn as ConvexForeignKeyConfig, qr as FilterExpression, qt as RlsContext, r as getSchemaRelations, ri as gte, rn as RelationsBuilderColumnConfig, rr as AggregateConfig, rt as OrmFunctions, s as desc, si as isNotNull, sn as defineRelationsPart, sr as BuildRelationResult, st as createOrm, t as WhereClauseResult, ti as fieldRef, tn as RelationsBuilder, tr as ConvexTextBuilderInitial, tt as OrmClientBase$1, u as getTableConfig, ui as lt, un as ConvexTable, ur as DBQueryConfig, ut as ScheduledDeleteArgs, v as timestamp, vi as AnyColumn, vn as discriminator, vr as MutationExecuteResult, vt as OrmTriggers, w as integer, wi as ColumnDataType, wn as RlsRoleConfig, wr as MutationRunMode, wt as MigrationAppliedState, x as textEnum, xi as ColumnBuilderRuntimeConfig, xn as RlsPolicyToOption, xr as MutationPaginatedResult, xt as MigrationRunArgs, y as ConvexTextEnumBuilder, yi as ColumnBuilder, yn as RlsPolicy, yr as MutationExecutionMode, yt as defineTriggers, z as ConvexBytesBuilder, zn as index, zr as OrmSchemaExtensions, zt as buildMigrationPlan } from "../where-clause-compiler-BGBNBNit.js";
+import { $ as GenericOrmCtx$1, $n as unique, $r as endsWith, $t as ManyConfig, A as ConvexDateMode, An as ConvexRankIndexBuilder, Ar as ReturningResult, At as MigrationManifestEntry, B as ConvexBytesBuilderInitial, Bn as rankIndex, Br as OrmSchemaRelations, Bt as defineMigration, C as ConvexNumberBuilderInitial, Ci as ColumnBuilderWithTableName, Cn as RlsRole, Cr as MutationReturning, Ct as MigrationStatusArgs, D as id, Di as IsPrimaryKey, Dn as ConvexAggregateIndexBuilderOn, Dr as PaginatedResult, Dt as MigrationDoc, E as ConvexIdBuilderInitial, Ei as HasDefault, En as ConvexAggregateIndexBuilder, Er as OrderDirection, Et as MigrationDirection, F as custom, Fn as ConvexVectorIndexBuilder, Fr as unsetToken, Ft as MigrationStateMap, G as ConvexBigIntBuilder, Gn as ConvexCheckConfig, Gr as ExpressionVisitor, Gt as OrmReader$1, H as ConvexBooleanBuilder, Hn as uniqueIndex, Hr as TableName, Ht as detectMigrationDrift, I as json, In as ConvexVectorIndexBuilderOn, Ir as Brand, It as MigrationStep, J as CountBackfillChunkArgs, Jn as ConvexUniqueConstraintBuilder, Jr as LogicalExpression, Jt as RlsMode, K as ConvexBigIntBuilderInitial, Kn as ConvexForeignKeyBuilder, Kr as FieldReference, Kt as OrmWriter$1, L as objectOf, Ln as ConvexVectorIndexConfig, Lr as Columns, Lt as MigrationTableName, M as ConvexCustomBuilder, Mn as ConvexSearchIndexBuilder, Mr as UpdateSet, Mt as MigrationPlan, N as ConvexCustomBuilderInitial, Nn as ConvexSearchIndexBuilderOn, Nr as VectorQueryConfig, Nt as MigrationRunStatus, O as ConvexDateBuilder, Oi as IsUnique, On as ConvexIndexBuilder, Or as PredicateWhereIndexConfig, Ot as MigrationDocContext, P as arrayOf, Pn as ConvexSearchIndexConfig, Pr as VectorSearchProvider, Pt as MigrationSet, Q as GenericOrm$1, Qn as foreignKey, Qr as contains, Qt as ExtractTablesWithRelations, R as unionOf, Rn as aggregateIndex, Rr as OrmSchemaExtensionTables, Rt as MigrationWriteMode, S as ConvexNumberBuilder, Si as ColumnBuilderTypeConfig, Sn as rlsPolicy, Sr as MutationResult, St as MigrationRunChunkArgs, T as ConvexIdBuilder, Ti as DrizzleEntity, Tn as rlsRole, Tr as OrderByClause, Tt as MigrationDefinition, U as ConvexBooleanBuilderInitial, Un as vectorIndex, Ur as SystemFields, Ut as DatabaseWithMutations, V as bytes, Vn as searchIndex, Vr as OrmSchemaTriggers, Vt as defineMigrationSet, W as boolean, Wn as ConvexCheckBuilder, Wr as BinaryExpression, Wt as DatabaseWithQuery, X as CountBackfillStatusArgs, Xn as ConvexUniqueConstraintConfig, Xr as and, Xt as extractRelationsConfig, Y as CountBackfillKickoffArgs, Yn as ConvexUniqueConstraintBuilderOn, Yr as UnaryExpression, Yt as EdgeMetadata, Z as CreateOrmOptions, Zn as check, Zr as between, Zt as ExtractTablesFromSchema, _ as ConvexTimestampMode, _i as startsWith, _n as deletion, _r as MutationExecuteConfig, _t as OrmTriggerContext, a as requireSchemaRelations, ai as inArray, an as TablesRelationalConfig, ar as AggregateResult, at as OrmWriterCtx, b as ConvexTextEnumBuilderInitial, bi as ColumnBuilderBaseConfig, bn as RlsPolicyConfig, br as MutationPaginateConfig, bt as MigrationCancelArgs, c as TableConfigResult, ci as isNull, cn as ConvexDeletionBuilder, cr as CountConfig, ct as ScheduledMutationBatchArgs, d as OrmNotFoundError, di as lte, dn as ConvexTableWithColumns, dr as FilterOperators, dt as scheduledDeleteFactory, ei as eq, en as OneConfig, er as ConvexTextBuilder, et as OrmApiResult, f as ConvexVectorBuilder, fi as ne, fn as DiscriminatorBuilderConfig, fr as GetColumnData, ft as SchemaExtension, g as ConvexTimestampBuilderInitial, gi as or, gn as convexTable, gr as InsertValue, gt as OrmTriggerChange, h as ConvexTimestampBuilder, hi as notInArray, hn as TableConfig, hr as InferSelectModel, ht as OrmTableTriggers, i as getSchemaTriggers, ii as ilike, in as TableRelationalConfig, ir as AggregateFieldValue, it as OrmReaderCtx, j as date, jn as ConvexRankIndexBuilderOn, jr as ReturningSelection, jt as MigrationMigrateOne, k as ConvexDateBuilderInitial, ki as NotNull, kn as ConvexIndexBuilderOn, kr as ReturningAll, kt as MigrationDriftIssue, l as getTableColumns, li as like, ln as ConvexDeletionConfig, lr as CountResult, lt as scheduledMutationBatchFactory, m as vector, mi as notBetween, mn as OrmLifecycleOperation, mr as InferModelFromColumns, mt as OrmBeforeResult, n as defineSchema, ni as gt, nn as RelationsBuilderColumnBase, nr as text, nt as OrmClientWithApi$1, o as asc, oi as isFieldReference, on as defineRelations, or as BuildQueryResult, ot as ResolveOrmSchema, p as ConvexVectorBuilderInitial, pi as not, pn as OrmLifecycleChange, pr as InferInsertModel, pt as defineSchemaExtension, q as bigint, qn as ConvexForeignKeyConfig, qr as FilterExpression, qt as RlsContext, r as getSchemaRelations, ri as gte, rn as RelationsBuilderColumnConfig, rr as AggregateConfig, rt as OrmFunctions, s as desc, si as isNotNull, sn as defineRelationsPart, sr as BuildRelationResult, st as createOrm, t as WhereClauseResult, ti as fieldRef, tn as RelationsBuilder, tr as ConvexTextBuilderInitial, tt as OrmClientBase$1, u as getTableConfig, ui as lt, un as ConvexTable, ur as DBQueryConfig, ut as ScheduledDeleteArgs, v as timestamp, vi as AnyColumn, vn as discriminator, vr as MutationExecuteResult, vt as OrmTriggers, w as integer, wi as ColumnDataType, wn as RlsRoleConfig, wr as MutationRunMode, wt as MigrationAppliedState, x as textEnum, xi as ColumnBuilderRuntimeConfig, xn as RlsPolicyToOption, xr as MutationPaginatedResult, xt as MigrationRunArgs, y as ConvexTextEnumBuilder, yi as ColumnBuilder, yn as RlsPolicy, yr as MutationExecutionMode, yt as defineTriggers, z as ConvexBytesBuilder, zn as index, zr as OrmSchemaExtensions, zt as buildMigrationPlan } from "../where-clause-compiler-B_H3oio5.js";
 import { i as pretendRequired, n as deprecated, r as pretend } from "../validators-BhsByJeg.js";
 import { a as QueryCtxWithPreferredOrmQueryTable, i as QueryCtxWithOrmQueryTable, n as LookupByIdResultByCtx, o as getByIdWithOrmQueryFallback, r as QueryCtxWithOptionalOrmQueryTable, t as DocByCtx } from "../query-context-CNo9ffvI.js";
 import { DefineSchemaOptions, GenericDatabaseReader, GenericDatabaseWriter, GenericSchema, SchemaDefinition } from "convex/server";

package/dist/react/index.d.ts

@@ -1,5 +1,5 @@
 'use client';
-import { A as decodeJwtExp, C as useAuthValue, D as useIsAuth, E as useFetchAccessToken, O as useMaybeAuth, S as useAuthStore, T as useConvexAuthRecovery, _ as Unauthenticated, a as Authenticated, b as useAuthGuard, c as ConvexAuthRecoveryError, d as ConvexAuthRecoveryStatus, f as ConvexProviderWithAuth, g as MaybeUnauthenticated, h as MaybeAuthenticated, i as AuthStoreState, k as useSafeConvexAuth, l as ConvexAuthRecoveryErrorCode, m as FetchAccessTokenFn, n as AuthProvider, o as ConvexAuthBridge, p as FetchAccessTokenContext, r as AuthStore, s as ConvexAuthRecovery, t as AUTH_SESSION_SYNC_GRACE_MS, u as ConvexAuthRecoveryOptions, v as isSessionSyncGraceActive, w as useConvexAuthBridge, x as useAuthState, y as useAuth } from "../auth-store-47WTg13B.js";
+import { A as decodeJwtExp, C as useAuthValue, D as useIsAuth, E as useFetchAccessToken, O as useMaybeAuth, S as useAuthStore, T as useConvexAuthRecovery, _ as Unauthenticated, a as Authenticated, b as useAuthGuard, c as ConvexAuthRecoveryError, d as ConvexAuthRecoveryStatus, f as ConvexProviderWithAuth, g as MaybeUnauthenticated, h as MaybeAuthenticated, i as AuthStoreState, k as useSafeConvexAuth, l as ConvexAuthRecoveryErrorCode, m as FetchAccessTokenFn, n as AuthProvider, o as ConvexAuthBridge, p as FetchAccessTokenContext, r as AuthStore, s as ConvexAuthRecovery, t as AUTH_SESSION_SYNC_GRACE_MS, u as ConvexAuthRecoveryOptions, v as isSessionSyncGraceActive, w as useConvexAuthBridge, x as useAuthState, y as useAuth } from "../auth-store-DHEk0ARa.js";
 import { ConvexProvider, ConvexReactClient, ConvexReactClient as ConvexReactClient$1, ConvexReactClientOptions, Watch, WatchQueryOptions, useConvex } from "convex/react";
 import { ReactNode } from "react";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
@@ -235,7 +235,6 @@ declare class ConvexQueryClient {
   private cancelPendingUnsubscribe;
   /** Unsubscribe a live Convex watch (if present) and remove it from the subscription map. */
   private unsubscribeQueryByHash;
-  private isAuthBoundQuery;
   private subscribeQuery;
   /** Update auth store (for HMR where jotai store may reset) */
   updateAuthStore(authStore?: AuthStore): void;
@@ -271,6 +270,12 @@ declare class ConvexQueryClient {
    * Call before logout to prevent UNAUTHORIZED errors during session invalidation.
    */
   unsubscribeAuthQueries(): void;
+  /**
+   * Advance the account generation published by the auth store.
+   * Client state that only makes sense inside one account's result set —
+   * paginated cursor chains — keys on it, so it is rebuilt instead of reused.
+   */
+  private bumpAuthEpoch;
   resetAuthQueries(): Promise<void>;
   /**
    * Batch update all subscriptions.

package/dist/react/index.js

@@ -1,5 +1,5 @@
 'use client';
-import { A as CRPCClientError, C as decodeJwtExp, M as isCRPCClientError, O as writeAuthSessionFallbackData, S as useSafeConvexAuth, T as clearAuthSessionFallback, _ as useConvexAuthBridge, a as ConvexAuthRecoveryError, b as useIsAuth, c as MaybeAuthenticated, d as isSessionSyncGraceActive, f as useAuth, g as useAuthValue, h as useAuthStore, i as ConvexAuthBridge, j as defaultIsUnauthorized, k as writeAuthSessionFallbackToken, l as MaybeUnauthenticated, m as useAuthState, n as AuthProvider, o as ConvexProviderWithAuth, p as useAuthGuard, r as Authenticated, s as FetchAccessTokenContext, t as AUTH_SESSION_SYNC_GRACE_MS, u as Unauthenticated, v as useConvexAuthRecovery, w as decodeJwtIdentity, x as useMaybeAuth, y as useFetchAccessToken } from "../auth-store-BHk8eMnX.js";
+import { A as CRPCClientError, C as decodeJwtExp, M as isCRPCClientError, O as writeAuthSessionFallbackData, S as useSafeConvexAuth, T as clearAuthSessionFallback, _ as useConvexAuthBridge, a as ConvexAuthRecoveryError, b as useIsAuth, c as MaybeAuthenticated, d as isSessionSyncGraceActive, f as useAuth, g as useAuthValue, h as useAuthStore, i as ConvexAuthBridge, j as defaultIsUnauthorized, k as writeAuthSessionFallbackToken, l as MaybeUnauthenticated, m as useAuthState, n as AuthProvider, o as ConvexProviderWithAuth, p as useAuthGuard, r as Authenticated, s as FetchAccessTokenContext, t as AUTH_SESSION_SYNC_GRACE_MS, u as Unauthenticated, v as useConvexAuthRecovery, w as decodeJwtIdentity, x as useMaybeAuth, y as useFetchAccessToken } from "../auth-store-BnsWs1xd.js";
 import { ConvexProvider, ConvexReactClient, ConvexReactClient as ConvexReactClient$1, useAction, useConvex, useMutation } from "convex/react";
 import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
 import { jsx } from "react/jsx-runtime";
@@ -1647,7 +1647,6 @@ function createAuthMutations(authClient) {
 	});
 	const useSignInSocialMutationOptions = ((options) => {
 		const authStoreApi = useAuthStore();
-		const convexQueryClient = useConvexQueryClient();
 		return {
 			...options,
 			mutationFn: async (args) => {
@@ -1659,14 +1658,12 @@ function createAuthMutations(authClient) {
 				await hydrateReturnedSession(authClient, res);
 				await ensureAuth(authStoreApi);
 				authStoreApi.set("isAuthenticated", true);
-				await convexQueryClient?.resetAuthQueries();
 				return res;
 			}
 		};
 	});
 	const useSignInMutationOptions = ((options) => {
 		const authStoreApi = useAuthStore();
-		const convexQueryClient = useConvexQueryClient();
 		const { signInMethod = "email", ...mutationOptions } = options ?? {};
 		return {
 			...mutationOptions,
@@ -1679,14 +1676,12 @@ function createAuthMutations(authClient) {
 				await hydrateReturnedSession(authClient, res);
 				await ensureAuth(authStoreApi);
 				authStoreApi.set("isAuthenticated", true);
-				await convexQueryClient?.resetAuthQueries();
 				return res;
 			}
 		};
 	});
 	const useSignUpMutationOptions = ((options) => {
 		const authStoreApi = useAuthStore();
-		const convexQueryClient = useConvexQueryClient();
 		return {
 			...options,
 			mutationFn: async (args) => {
@@ -1698,7 +1693,6 @@ function createAuthMutations(authClient) {
 				await hydrateReturnedSession(authClient, res);
 				await ensureAuth(authStoreApi);
 				authStoreApi.set("isAuthenticated", true);
-				await convexQueryClient?.resetAuthQueries();
 				return res;
 			}
 		};
@@ -1711,6 +1705,81 @@ function createAuthMutations(authClient) {
 	};
 }
 
+//#endregion
+//#region src/internal/auth-reset.ts
+/**
+* Erase the cached result of every auth-bound query.
+*
+* `queryClient.resetQueries()` is not enough. It restores each query's
+* `initialState`, and query-core derives that from `initialData` when the query
+* is built, never re-deriving it once real data lands. An auth-bound entry
+* therefore comes back holding the previous account's rows marked `success`,
+* and nothing corrects it: Convex query options set `staleTime: Infinity` with
+* every refetch trigger off, and `resetQueries` only refetches entries that are
+* currently active.
+*
+* Every entry is removed so query-core forgets both its current state and its
+* private `initialState`. Mounted observers are rebound with `initialData`
+* removed, creating a pristine replacement query that future public resets
+* cannot use to resurrect the previous account's rows.
+*/
+async function clearAuthBoundQueries(cache, isAuthBound) {
+	const authQueries = cache.getAll().filter((query) => isAuthBound(query));
+	const restoreObservers = [];
+	await Promise.all(authQueries.map((query) => query.cancel({ silent: true })));
+	for (const query of authQueries) {
+		const observers = [...query.observers];
+		cache.remove(query);
+		for (const observer of observers) {
+			const previousOptions = observer.options;
+			observer.setOptions({
+				...observer.options,
+				enabled: false,
+				initialData: void 0,
+				placeholderData: void 0
+			});
+			const suspendedOptions = observer.options;
+			restoreObservers.push(() => {
+				const currentOptions = observer.options;
+				observer.setOptions({
+					...currentOptions,
+					enabled: observer.options === suspendedOptions ? previousOptions.enabled : currentOptions.enabled,
+					initialData: void 0,
+					placeholderData: void 0
+				});
+			});
+		}
+	}
+	return () => {
+		for (const restoreObserver of restoreObservers) restoreObserver();
+	};
+}
+
+//#endregion
+//#region src/internal/subscription-gate.ts
+/** Read kitcn's meta off a TanStack query. */
+function readConvexQueryMeta(query) {
+	return query.meta;
+}
+/**
+* Auth-bound queries are cleared and resubscribed on an identity transition so
+* one account never renders another account's cached rows.
+*/
+function isAuthBoundQuery(query) {
+	const authType = readConvexQueryMeta(query)?.authType;
+	return authType === "required" || authType === "optional";
+}
+/** Whether a Convex subscription may be opened for this query. */
+function canSubscribeQuery(query, opts) {
+	if (opts.isSubscribed) return false;
+	const meta = readConvexQueryMeta(query);
+	if (meta?.subscribe === false) return false;
+	if (query.getObserversCount() === 0) return false;
+	if (query.isDisabled()) return false;
+	if (opts.shouldSkipSubscription(meta?.authType)) return false;
+	return true;
+}
+
 //#endregion
 //#region src/react/client.ts
 /**
@@ -1882,17 +1951,11 @@ var ConvexQueryClient = class {
 		sub.unsubscribe();
 		delete this.subscriptions[queryHash];
 	}
-	isAuthBoundQuery(query) {
-		const meta = query.meta;
-		return meta?.authType === "required" || meta?.authType === "optional";
-	}
 	subscribeQuery(query) {
-		if (this.subscriptions[query.queryHash]) return;
-		const meta = query.meta;
-		if (meta?.subscribe === false) return;
-		if (query.getObserversCount() === 0) return;
-		if (query.isDisabled()) return;
-		if (this.shouldSkipSubscription(meta?.authType)) return;
+		if (!canSubscribeQuery(query, {
+			isSubscribed: !!this.subscriptions[query.queryHash],
+			shouldSkipSubscription: (authType) => this.shouldSkipSubscription(authType)
+		})) return;
 		const [, funcName, args] = query.queryKey;
 		const watch = this.convexClient.watchQuery(funcName, this.transformer.input.serialize(args));
 		const unsubscribe = watch.onUpdate(() => {
@@ -1986,14 +2049,29 @@ var ConvexQueryClient = class {
 			this.unsubscribeQueryByHash(queryHash);
 		}
 	}
+	/**
+	* Advance the account generation published by the auth store.
+	* Client state that only makes sense inside one account's result set —
+	* paginated cursor chains — keys on it, so it is rebuilt instead of reused.
+	*/
+	bumpAuthEpoch() {
+		if (!this.authStore) return;
+		this.authStore.set("authEpoch", this.authStore.get("authEpoch") + 1);
+	}
 	async resetAuthQueries() {
-		const authQueries = this.queryClient.getQueryCache().getAll().filter((query) => this.isAuthBoundQuery(query));
-		for (const query of authQueries) {
+		const queryCache = this.queryClient.getQueryCache();
+		for (const query of queryCache.getAll()) {
+			if (!isAuthBoundQuery(query)) continue;
 			this.cancelPendingUnsubscribe(query.queryHash);
 			this.unsubscribeQueryByHash(query.queryHash);
 		}
-		await this.queryClient.resetQueries({ predicate: (query) => this.isAuthBoundQuery(query) });
-		for (const query of this.queryClient.getQueryCache().getAll()) if (this.isAuthBoundQuery(query)) this.subscribeQuery(query);
+		this.bumpAuthEpoch();
+		(await clearAuthBoundQueries(queryCache, (query) => isAuthBoundQuery(query)))();
+		await this.queryClient.refetchQueries({
+			predicate: (query) => isAuthBoundQuery(query),
+			type: "active"
+		});
+		for (const query of queryCache.getAll()) if (isAuthBoundQuery(query)) this.subscribeQuery(query);
 	}
 	/**
 	* Batch update all subscriptions.
@@ -2270,15 +2348,8 @@ const shouldSplitPaginationPage = (page, initialNumItems) => Boolean(page.splitC
 //#region src/react/use-infinite-query.ts
 /** biome-ignore-all lint/suspicious/noExplicitAny: Convex query/mutation type compatibility */
 const PAGINATION_KEY_PREFIX = "__pagination__";
-const paginationIdStore = /* @__PURE__ */ new Map();
 let paginationIdCounter = 0;
-const getOrCreatePaginationId = (storeKey) => {
-	const existing = paginationIdStore.get(storeKey);
-	if (existing !== void 0) return existing;
-	const newId = ++paginationIdCounter;
-	paginationIdStore.set(storeKey, newId);
-	return newId;
-};
+const createPaginationId = () => ++paginationIdCounter;
 /** Build a unique key for recovery attempt detection */
 const buildRecoveryKey = (pageKeys, page0Cursor, page0UpdatedAt) => JSON.stringify({
 	pageKeys,
@@ -2360,12 +2431,13 @@ const useStaleCursorRecovery = ({ argsObject, combined, limit, setState, state }
 * Use `useInfiniteQuery` for the public API with auth handling.
 */
 const useInfiniteQueryInternal = (query, args, options) => {
-	const { limit, enabled, placeholderData, ...forwardedOptions } = options;
+	const { limit, authType, enabled, placeholderData, ...forwardedOptions } = options;
 	const queryOptions = useStableIdentity(forwardedOptions);
 	const { isLoading: isAuthLoading } = useSafeConvexAuth();
 	const meta = useMeta();
 	const queryClient = useQueryClient();
-	const prefetchedFirstPage = useMemo(() => {
+	const authEpoch = useAuthValue("authEpoch");
+	const skip = !useMemo(() => {
 		const serverQueryKey = [
 			"convexQuery",
 			getFunctionName(query),
@@ -2381,8 +2453,7 @@ const useInfiniteQueryInternal = (query, args, options) => {
 		JSON.stringify(args),
 		limit,
 		queryClient
-	]);
-	const skip = !prefetchedFirstPage && (isAuthLoading || enabled === false);
+	]) && (isAuthLoading || enabled === false);
 	const getPaginationState = useCallback((key) => {
 		const queryKey = [PAGINATION_KEY_PREFIX, key];
 		return queryClient.getQueryData(queryKey);
@@ -2394,10 +2465,16 @@ const useInfiniteQueryInternal = (query, args, options) => {
 	const argsObject = useMemo(() => skip ? {} : args, [skip, JSON.stringify(args)]);
 	const storeKey = useMemo(() => JSON.stringify({
 		query: getFunctionName(query),
-		args: argsObject
-	}), [query, argsObject]);
+		args: argsObject,
+		...authType ? { authEpoch } : {}
+	}), [
+		query,
+		argsObject,
+		authType,
+		authEpoch
+	]);
 	const createInitialState = useCallback(() => {
-		const id = getOrCreatePaginationId(storeKey);
+		const id = createPaginationId();
 		return {
 			id,
 			nextPageKey: 1,
@@ -2411,7 +2488,6 @@ const useInfiniteQueryInternal = (query, args, options) => {
 			version: 0
 		};
 	}, [
-		storeKey,
 		skip,
 		argsObject,
 		limit
@@ -2484,10 +2560,9 @@ const useInfiniteQueryInternal = (query, args, options) => {
 			const pageArgs = state.queries[key]?.args;
 			return {
 				...convexQuery(query, pageArgs ? (({ __paginationId, ...rest }) => rest)(pageArgs) : "skip", meta),
-				enabled: resolveEnabled(!skip && !!state.queries[key], enabled),
+				enabled: resolveEnabled(!skip && !!state.queries[key] && (!authType || !isAuthLoading), enabled),
 				structuralSharing: false,
 				...queryOptions ?? {},
-				...index === 0 && prefetchedFirstPage ? { initialData: prefetchedFirstPage } : {},
 				...index === 0 && placeholderData ? { placeholderData: {
 					page: placeholderData,
 					isDone: false,
@@ -2502,7 +2577,6 @@ const useInfiniteQueryInternal = (query, args, options) => {
 			enabled,
 			meta,
 			queryOptions,
-			prefetchedFirstPage,
 			placeholderData
 		]),
 		combine: useCallback((results) => {
@@ -2689,6 +2763,7 @@ function useInfiniteQuery(infiniteOptions) {
 	]);
 	const enabled = useMemo(() => resolveEnabled(!shouldSkip, factoryEnabled), [shouldSkip, factoryEnabled]);
 	const result = useInfiniteQueryInternal(query, args, {
+		authType,
 		limit,
 		...queryOptions,
 		enabled

package/dist/solid/index.d.ts

@@ -210,11 +210,15 @@ declare const FetchAccessTokenContext: solid_js0.Context<FetchAccessTokenFn | nu
 /** Get fetchAccessToken from context (available immediately, no race condition) */
 declare const useFetchAccessToken: () => FetchAccessTokenFn | null;
 type ConvexAuthResult = {
+  identity: unknown;
   isAuthenticated: boolean;
   isLoading: boolean;
 };
+type ConvexAuthBridgeResult = ConvexAuthResult & {
+  authEpoch: number;
+};
 /** Get auth from bridge context (null if no bridge configured) */
-declare const useConvexAuthBridge: () => ConvexAuthResult | null;
+declare const useConvexAuthBridge: () => ConvexAuthBridgeResult | null;
 type AuthStoreState = {
   /** Callback when mutation/action called while unauthorized. Throws by default. */onMutationUnauthorized: () => void; /** Callback when query called while unauthorized. Noop by default. */
   onQueryUnauthorized: (info: {
@@ -225,6 +229,12 @@ type AuthStoreState = {
   expiresAt: number | null; /** Auth loading state (synced from useConvexAuth for class methods) */
   isLoading: boolean; /** Auth state (synced from useConvexAuth for class methods) */
   isAuthenticated: boolean;
+  /**
+   * Account generation, advanced on every identity transition. Client state
+   * that only makes sense inside one account's result set — paginated cursor
+   * chains — keys on it so it is rebuilt instead of reused across accounts.
+   */
+  authEpoch: number;
 };
 /** Decode JWT expiration (ms timestamp) from token */
 declare function decodeJwtExp(token: string): number | null;
@@ -258,6 +268,8 @@ declare function useSafeConvexAuth(): ConvexAuthResult;
  * @internal
  */
 declare function ConvexAuthBridge(props: ParentProps<{
+  authEpoch?: number;
+  identity?: unknown;
   isLoading: boolean;
   isAuthenticated: boolean;
 }>): JSX.Element;
@@ -369,6 +381,12 @@ declare class ConvexQueryClient {
   ssrQueryMode: 'consistent' | 'inconsistent';
   /** Auth store for checking auth state */
   private authStore?;
+  /** In-flight clear shared by overlapping account identity transitions. */
+  private authBarrierClear?;
+  /** Blocks auth-bound work created while Convex is changing identity. */
+  private authSettlementBarrier?;
+  /** Latest account transition allowed to restore and refetch observers. */
+  private authResetGeneration;
   /** Delay before unsubscribing when query has no observers */
   private unsubscribeDelay;
   /** Payload transformer used across request/response boundaries. */
@@ -381,6 +399,11 @@ declare class ConvexQueryClient {
   private cancelPendingUnsubscribe;
   /** Unsubscribe a live Convex subscription (if present) and remove it from the subscription map. */
   private unsubscribeQueryByHash;
+  /**
+   * Open a Convex subscription for a query, if the shared gate allows it.
+   * Single owner of the subscribe preconditions for every cache-event branch.
+   */
+  private subscribeQuery;
   /** Update auth store (for HMR where store may reset) */
   updateAuthStore(authStore?: AuthStore): void;
   /** Get current auth state from store */
@@ -390,6 +413,10 @@ declare class ConvexQueryClient {
    * Needed for useSuspenseQuery which ignores enabled: false.
    */
   private shouldSkipSubscription;
+  /** Hold new auth-bound requests until the latest Convex identity settles. */
+  private beginAuthSettlementBarrier;
+  /** Wait through overlapping barriers and stop canceled requests. */
+  private waitForAuthSettlement;
   /** Get QueryClient, throwing if not connected */
   get queryClient(): QueryClient;
   /**
@@ -414,6 +441,25 @@ declare class ConvexQueryClient {
    * Call before logout to prevent UNAUTHORIZED errors during session invalidation.
    */
   unsubscribeAuthQueries(): void;
+  /**
+   * Advance the account generation published by the auth store.
+   * Client state that only makes sense inside one account's result set —
+   * paginated cursor chains — keys on it, so it is rebuilt instead of reused.
+   */
+  private bumpAuthEpoch;
+  /** Drop auth-bound data without fetching while Convex changes identity. */
+  private clearAuthQueries;
+  /** Refetch and resubscribe auth-bound queries after Convex settles. */
+  private refetchAuthQueries;
+  /**
+   * Drop every auth-bound cache entry and resubscribe.
+   * Call after an identity transition when no separate settlement barrier owns
+   * the clear/refetch phases.
+   */
+  resetAuthQueries(options?: {
+    generation?: number;
+    refetch?: boolean;
+  }): Promise<number>;
   /**
    * Batch update all subscriptions.
    * Called internally when Convex client reconnects.
@@ -1271,6 +1317,7 @@ declare function ConvexProvider(props: ParentProps<{
 declare function ConvexProviderWithAuth(props: ParentProps<{
   client: ConvexClient;
   useAuth: () => {
+    /** Stable account/session identity. Token refreshes must keep this value. */identity?: string | null;
     isLoading: boolean;
     isAuthenticated: boolean;
     fetchAccessToken: AuthTokenFetcher;
@@ -1477,7 +1524,9 @@ declare function useConvexInfiniteQueryOptions<T extends FunctionReference<'quer
  */
 declare function useConvexActionQueryOptions<Action extends FunctionReference<'action'>>(action: Action, args: FunctionArgs<Action> | SkipToken, options?: {
   skipUnauth?: boolean;
-} & DistributiveOmit<SolidQueryOptions<FunctionReturnType<Action>, DefaultError>, ReservedQueryOptions>): ConvexActionOptions<Action>;
+} & DistributiveOmit<SolidQueryOptions<FunctionReturnType<Action>, DefaultError>, ReservedQueryOptions>): ConvexActionOptions<Action> & {
+  meta: ConvexQueryMeta;
+};
 /**
  * Hook that returns mutation options for use with useMutation.
  * Wraps the Convex mutation with auth guard logic.