kitcn 0.15.6 → 0.15.8

package/dist/aggregate/index.d.ts

@@ -1,4 +1,4 @@
-import { C as ConvexNumberBuilderInitial, E as ConvexIdBuilderInitial, N as ConvexCustomBuilderInitial, dn as ConvexTableWithColumns, tr as ConvexTextBuilderInitial } from "../where-clause-compiler-DcEhkJ12.js";
+import { C as ConvexNumberBuilderInitial, E as ConvexIdBuilderInitial, N as ConvexCustomBuilderInitial, dn as ConvexTableWithColumns, tr as ConvexTextBuilderInitial } from "../where-clause-compiler-CgQj3ZHP.js";
 import * as convex_values0 from "convex/values";
 import { GenericId, Infer, Value } from "convex/values";
 import { DocumentByName, GenericDataModel, GenericDatabaseReader, GenericDatabaseWriter, TableNamesInDataModel } from "convex/server";

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-DcEhkJ12.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-CgQj3ZHP.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/orm/index.js

@@ -584,6 +584,71 @@ const deserializeFilterExpression = (expression) => {
 	if (!nested) throw new Error("Serialized unary operand is missing.");
 	return createUnaryExpression(unary.operator, nested);
 };
+const PRIMARY_ID_LOOKUP_CURSOR_PREFIX = "kitcn:primary-id:";
+const dedupePrimaryIds = (values) => Array.from(new Map(values.map((value) => [String(value), value])).values());
+const parsePrimaryIdLookupCursor = (cursor) => {
+	if (cursor === null) return 0;
+	if (!cursor.startsWith(PRIMARY_ID_LOOKUP_CURSOR_PREFIX)) throw new Error("Invalid primary id mutation cursor.");
+	const offset = Number(cursor.slice(17));
+	if (!Number.isInteger(offset) || offset < 0) throw new Error("Invalid primary id mutation cursor.");
+	return offset;
+};
+const canUsePrimaryIdLookupCursor = (cursor) => cursor === null || cursor === void 0 || cursor.startsWith(PRIMARY_ID_LOOKUP_CURSOR_PREFIX);
+const extractPrimaryIdLookup = (expression) => {
+	if (!expression || expression.type !== "binary") return null;
+	const binary = expression;
+	const [left, right] = binary.operands;
+	if (binary.operator === "eq") {
+		if (isFieldReference(left) && left.fieldName === "_id") {
+			if (isFieldReference(right)) return null;
+			return {
+				kind: "eq",
+				values: [right]
+			};
+		}
+		if (isFieldReference(right) && right.fieldName === "_id") {
+			if (isFieldReference(left)) return null;
+			return {
+				kind: "eq",
+				values: [left]
+			};
+		}
+	}
+	if (binary.operator === "inArray" && isFieldReference(left) && left.fieldName === "_id" && Array.isArray(right)) return {
+		kind: "in",
+		values: dedupePrimaryIds(right)
+	};
+	return null;
+};
+const windowPrimaryIdLookup = (lookup, pagination) => {
+	if (!pagination) return {
+		continueCursor: null,
+		isDone: true,
+		values: lookup.values
+	};
+	const offset = parsePrimaryIdLookupCursor(pagination.cursor);
+	const nextOffset = offset + pagination.limit;
+	const values = lookup.values.slice(offset, nextOffset);
+	const isDone = nextOffset >= lookup.values.length;
+	return {
+		continueCursor: isDone ? null : `${PRIMARY_ID_LOOKUP_CURSOR_PREFIX}${nextOffset}`,
+		isDone,
+		values
+	};
+};
+const collectPrimaryIdLookupRows = async (db, tableName, lookup, options) => {
+	if (!options.pagination && lookup.values.length > options.maxRows) throw new Error(`${options.operation} exceeded mutationMaxRows (${options.maxRows}) on "${tableName}". Narrow the filter or increase defineSchema(..., { defaults: { mutationMaxRows } }).`);
+	if (!options.pagination && lookup.values.length > options.batchSize) throw new Error(`${options.operation} matched more than mutationBatchSize (${options.batchSize}) primary ids on "${tableName}". Use executeAsync({ batchSize }) or paginate() to split the mutation.`);
+	const primaryIdWindow = windowPrimaryIdLookup(lookup, options.pagination);
+	if (primaryIdWindow.values.length > options.maxRows) throw new Error(`${options.operation} exceeded mutationMaxRows (${options.maxRows}) on "${tableName}". Narrow the filter or increase defineSchema(..., { defaults: { mutationMaxRows } }).`);
+	const normalizedIds = primaryIdWindow.values.filter((value) => value !== null && value !== void 0).map((value) => db.normalizeId(tableName, value)).filter((value) => value !== null);
+	const fetchedRows = await Promise.all(normalizedIds.map((value) => db.get(value)));
+	return {
+		continueCursor: primaryIdWindow.continueCursor,
+		isDone: primaryIdWindow.isDone,
+		rows: fetchedRows.filter((row) => !!row)
+	};
+};
 const DEFAULT_MUTATION_BATCH_SIZE = 400;
 const DEFAULT_MUTATION_LEAF_BATCH_SIZE = 1600;
 const DEFAULT_MUTATION_MAX_ROWS = 1e4;
@@ -7431,27 +7496,6 @@ var ConvexDeleteBuilder = class extends QueryPromise {
 		this.allowFullScanFlag = true;
 		return this;
 	}
-	getIdEquality() {
-		const expression = this.whereExpression;
-		if (!expression || expression.type !== "binary") return { matched: false };
-		if (expression.operator !== "eq") return { matched: false };
-		const [left, right] = expression.operands;
-		if (isFieldReference(left) && left.fieldName === "_id") {
-			if (isFieldReference(right)) return { matched: false };
-			return {
-				matched: true,
-				value: right
-			};
-		}
-		if (isFieldReference(right) && right.fieldName === "_id") {
-			if (isFieldReference(left)) return { matched: false };
-			return {
-				matched: true,
-				value: left
-			};
-		}
-		return { matched: false };
-	}
 	soft() {
 		this.deleteModeOverride = "soft";
 		this.scheduledDelayMs = void 0;
@@ -7547,15 +7591,17 @@ var ConvexDeleteBuilder = class extends QueryPromise {
 		let rows;
 		let continueCursor = null;
 		let isDone = true;
-		const idEquality = this.getIdEquality();
-		if (idEquality.matched) {
-			const idValue = idEquality.value;
-			if (isPaginated && pagination.cursor !== null) rows = [];
-			else if (idValue === null || idValue === void 0) rows = [];
-			else {
-				const row = await this.db.get(idValue);
-				rows = row ? [row] : [];
-			}
+		const primaryIdLookup = canUsePrimaryIdLookupCursor(pagination?.cursor) ? extractPrimaryIdLookup(this.whereExpression) : null;
+		if (primaryIdLookup) {
+			const primaryIdRows = await collectPrimaryIdLookupRows(this.db, tableName, primaryIdLookup, {
+				operation: "delete",
+				pagination,
+				batchSize,
+				maxRows
+			});
+			continueCursor = primaryIdRows.continueCursor;
+			isDone = primaryIdRows.isDone;
+			rows = primaryIdRows.rows;
 		} else if (this.whereExpression) {
 			const compiled = new WhereClauseCompiler(tableName, getIndexes(this.table).map((index) => ({
 				indexName: index.name,
@@ -8598,27 +8644,6 @@ var ConvexUpdateBuilder = class extends QueryPromise {
 		this.allowFullScanFlag = true;
 		return this;
 	}
-	getIdEquality() {
-		const expression = this.whereExpression;
-		if (!expression || expression.type !== "binary") return { matched: false };
-		if (expression.operator !== "eq") return { matched: false };
-		const [left, right] = expression.operands;
-		if (isFieldReference(left) && left.fieldName === "_id") {
-			if (isFieldReference(right)) return { matched: false };
-			return {
-				matched: true,
-				value: right
-			};
-		}
-		if (isFieldReference(right) && right.fieldName === "_id") {
-			if (isFieldReference(left)) return { matched: false };
-			return {
-				matched: true,
-				value: left
-			};
-		}
-		return { matched: false };
-	}
 	async executeAsync(...args) {
 		const config = args[0];
 		return this.execute({
@@ -8709,15 +8734,17 @@ var ConvexUpdateBuilder = class extends QueryPromise {
 		let rows;
 		let continueCursor = null;
 		let isDone = true;
-		const idEquality = this.getIdEquality();
-		if (idEquality.matched) {
-			const idValue = idEquality.value;
-			if (isPaginated && pagination.cursor !== null) rows = [];
-			else if (idValue === null || idValue === void 0) rows = [];
-			else {
-				const row = await this.db.get(idValue);
-				rows = row ? [row] : [];
-			}
+		const primaryIdLookup = canUsePrimaryIdLookupCursor(pagination?.cursor) ? extractPrimaryIdLookup(this.whereExpression) : null;
+		if (primaryIdLookup) {
+			const primaryIdRows = await collectPrimaryIdLookupRows(this.db, tableName, primaryIdLookup, {
+				operation: "update",
+				pagination,
+				batchSize,
+				maxRows
+			});
+			continueCursor = primaryIdRows.continueCursor;
+			isDone = primaryIdRows.isDone;
+			rows = primaryIdRows.rows;
 		} else if (this.whereExpression) {
 			const compiled = new WhereClauseCompiler(tableName, getIndexes(this.table).map((index) => ({
 				indexName: index.name,

package/dist/react/index.d.ts

@@ -39,6 +39,9 @@ declare function isAuthMutationError(error: unknown): error is AuthMutationError
 //#endregion
 //#region src/react/auth-mutations.d.ts
 type MutationOptionsHook<TData, TVariables = void> = (options?: Omit<UseMutationOptions<TData, DefaultError, TVariables>, 'mutationFn'>) => UseMutationOptions<TData, DefaultError, TVariables>;
+type SignInMutationOptionsHook<TData, TVariables = void> = (options?: Omit<UseMutationOptions<TData, DefaultError, TVariables>, 'mutationFn'> & {
+  signInMethod?: string;
+}) => UseMutationOptions<TData, DefaultError, TVariables>;
 type AnyAuthFn = (...args: never[]) => unknown;
 type MutationArgsWithFetchOptions = {
   fetchOptions?: Record<string, unknown>;
@@ -72,8 +75,9 @@ type AuthClient = {
   signOut?: AnyAuthFn;
   signIn?: {
     anonymous?: AnyAuthFn;
-    social?: AnyAuthFn;
     email?: AnyAuthFn;
+    social?: AnyAuthFn;
+    [method: string]: AnyAuthFn | undefined;
   };
   signUp?: {
     email?: AnyAuthFn;
@@ -105,7 +109,7 @@ type AuthClient = {
 type AuthMutationsResult = {
   useSignOutMutationOptions: MutationOptionsHook<unknown, MutationArgsWithFetchOptions | void>;
   useSignInSocialMutationOptions: MutationOptionsHook<unknown, unknown>;
-  useSignInMutationOptions: MutationOptionsHook<unknown, unknown>;
+  useSignInMutationOptions: SignInMutationOptionsHook<unknown, unknown>;
   useSignUpMutationOptions: MutationOptionsHook<unknown, unknown>;
 };
 declare function createAuthMutations(authClient: AuthClient): AuthMutationsResult;

package/dist/react/index.js

@@ -1574,12 +1574,13 @@ function createAuthMutations(authClient) {
 	const useSignInMutationOptions = ((options) => {
 		const authStoreApi = useAuthStore();
 		const convexQueryClient = useConvexQueryClient();
+		const { signInMethod = "email", ...mutationOptions } = options ?? {};
 		return {
-			...options,
+			...mutationOptions,
 			mutationFn: async (args) => {
-				const signInEmail = authClient.signIn?.email;
-				if (typeof signInEmail !== "function") throw new Error("Auth client does not expose signIn.email");
-				const res = await callAuthMethod(signInEmail, withDisabledSessionSignal(args));
+				const signIn = authClient.signIn?.[signInMethod];
+				if (typeof signIn !== "function") throw new Error(`Auth client does not expose signIn.${signInMethod}`);
+				const res = await callAuthMethod(signIn, withDisabledSessionSignal(args));
 				if (res?.error) throw toAuthMutationError(res.error);
 				seedReturnedToken(authStoreApi, res);
 				await hydrateReturnedSession(authClient, res);

package/dist/solid/index.d.ts

@@ -148,12 +148,23 @@ declare function isAuthMutationError(error: unknown): error is AuthMutationError
 //#endregion
 //#region src/solid/auth-mutations.d.ts
 type MutationOptionsHook<TData, TVariables = void> = (options?: Omit<SolidMutationOptions<TData, DefaultError, TVariables>, 'mutationFn'>) => SolidMutationOptions<TData, DefaultError, TVariables>;
+type SignInMethod<T extends AuthClient> = Extract<keyof T['signIn'], string>;
+type EmailSignInMutationOptions<T extends AuthClient> = Omit<SolidMutationOptions<Awaited<ReturnType<T['signIn']['email']>>, DefaultError, Parameters<T['signIn']['email']>[0]>, 'mutationFn'> & {
+  signInMethod?: 'email';
+};
+type CustomSignInMutationOptions<T extends AuthClient, TMethod extends SignInMethod<T>> = Omit<SolidMutationOptions<Awaited<ReturnType<T['signIn'][TMethod]>>, DefaultError, Parameters<T['signIn'][TMethod]>[0]>, 'mutationFn'> & {
+  signInMethod: TMethod;
+};
+type SignInMutationOptionsHook<T extends AuthClient> = {
+  (options?: EmailSignInMutationOptions<T>): SolidMutationOptions<Awaited<ReturnType<T['signIn']['email']>>, DefaultError, Parameters<T['signIn']['email']>[0]>;
+  <TMethod extends Exclude<SignInMethod<T>, 'email'>>(options: CustomSignInMutationOptions<T, TMethod>): SolidMutationOptions<Awaited<ReturnType<T['signIn'][TMethod]>>, DefaultError, Parameters<T['signIn'][TMethod]>[0]>;
+};
 type AnyFn = (...args: any[]) => Promise<any>;
 type AuthClient = {
   signOut: AnyFn;
-  signIn: {
-    social: AnyFn;
+  signIn: Record<string, AnyFn> & {
     email: AnyFn;
+    social: AnyFn;
   };
   signUp: {
     email: AnyFn;
@@ -162,7 +173,7 @@ type AuthClient = {
 type AuthMutationsResult<T extends AuthClient> = {
   useSignOutMutationOptions: MutationOptionsHook<Awaited<ReturnType<T['signOut']>>, Parameters<T['signOut']>[0] | void>;
   useSignInSocialMutationOptions: MutationOptionsHook<Awaited<ReturnType<T['signIn']['social']>>, Parameters<T['signIn']['social']>[0]>;
-  useSignInMutationOptions: MutationOptionsHook<Awaited<ReturnType<T['signIn']['email']>>, Parameters<T['signIn']['email']>[0]>;
+  useSignInMutationOptions: SignInMutationOptionsHook<T>;
   useSignUpMutationOptions: MutationOptionsHook<Awaited<ReturnType<T['signUp']['email']>>, Parameters<T['signUp']['email']>[0]>;
 };
 /**

package/dist/solid/index.js

@@ -1728,10 +1728,13 @@ function createAuthMutations(authClient) {
 	});
 	const useSignInMutationOptions = ((options) => {
 		const authStoreApi = useAuthStore();
+		const { signInMethod = "email", ...mutationOptions } = options ?? {};
 		return {
-			...options,
+			...mutationOptions,
 			mutationFn: async (args) => {
-				const res = await authClient.signIn.email(args);
+				const signIn = authClient.signIn[signInMethod];
+				if (typeof signIn !== "function") throw new Error(`Auth client does not expose signIn.${signInMethod}`);
+				const res = await signIn(args);
 				if (res?.error) throw new AuthMutationError(res.error);
 				seedReturnedToken(authStoreApi, res);
 				await ensureAuth(authStoreApi);

package/dist/{where-clause-compiler-DcEhkJ12.d.ts → where-clause-compiler-CgQj3ZHP.d.ts}

@@ -2284,7 +2284,6 @@ declare class ConvexDeleteBuilder<TTable extends ConvexTable<any>, TReturning ex
   returning<TSelection extends ReturningSelection<TTable>>(fields: TSelection): ConvexDeleteWithout<ConvexDeleteBuilder<TTable, TSelection, TMode, THasWhereOrAllowFullScan>, 'returning'>;
   paginate(config: MutationPaginateConfig): ConvexDeleteWithout<ConvexDeleteBuilder<TTable, TReturning, 'paged', THasWhereOrAllowFullScan>, 'paginate'>;
   allowFullScan(): ConvexDeleteBuilder<TTable, TReturning, TMode, true>;
-  private getIdEquality;
   soft(): this;
   hard(): this;
   scheduled(config: {
@@ -2892,7 +2891,6 @@ declare class ConvexUpdateBuilder<TTable extends ConvexTable<any>, TReturning ex
   returning<TSelection extends ReturningSelection<TTable>>(fields: TSelection): ConvexUpdateWithout<ConvexUpdateBuilder<TTable, TSelection, TMode, THasWhereOrAllowFullScan>, 'returning'>;
   paginate(config: MutationPaginateConfig): ConvexUpdateWithout<ConvexUpdateBuilder<TTable, TReturning, 'paged', THasWhereOrAllowFullScan>, 'paginate'>;
   allowFullScan(): ConvexUpdateBuilder<TTable, TReturning, TMode, true>;
-  private getIdEquality;
   executeAsync(this: ConvexUpdateExecutableThis<TTable, TReturning, TMode>, ...args: TMode extends 'single' ? [config?: Omit<MutationExecuteConfig, 'mode'>] : [config: never]): Promise<TMode extends 'single' ? MutationExecuteResult<TTable, TReturning, 'single'> : never>;
   execute(this: ConvexUpdateExecutableThis<TTable, TReturning, TMode>, ...args: TMode extends 'single' ? [config?: MutationExecuteConfig] : [config?: never]): Promise<MutationExecuteResult<TTable, TReturning, TMode>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kitcn",
-  "version": "0.15.6",
+  "version": "0.15.8",
   "description": "kitcn - React Query integration and CLI tools for Convex",
   "keywords": [
     "convex",

package/skills/kitcn/references/features/auth.md

@@ -326,6 +326,15 @@ const signUp = useMutation(useSignUpMutationOptions({ onSuccess: () => router.pu
 signUp.mutate({ callbackURL: window.location.origin, email, name, password });
 ```
 
+**Plugin sign-in methods** (requires the matching Better Auth client plugin):
+```ts
+const signIn = useMutation(useSignInMutationOptions({
+  signInMethod: 'username',
+  onSuccess: () => router.push('/'),
+}));
+signIn.mutate({ callbackURL: window.location.origin, password, username });
+```
+
 ### Sign Out
 
 ```ts