@vexcms/better-auth 0.0.20 → 0.1.0-alpha.2

package/dist/convex/types.d.ts

@@ -0,0 +1,103 @@
+import type { MutationBuilder, QueryBuilder, GenericDataModel, FunctionReference, GenericActionCtx } from "convex/server";
+/**
+ * The DB operation function signatures — typed as `FunctionReference` to match
+ * `internal.auth.db.*` in the user's project. These are the "registered"
+ * mutation/query types that `ctx.runMutation` and `ctx.runQuery` accept.
+ *
+ * Follows the same pattern as `VexFindRef`, `VexCreateRef`, etc. in
+ * `@vexcms/core/src/convex/index.ts`.
+ */
+export type BetterAuthDbHandlers = {
+    dbCreate: FunctionReference<"mutation", "internal", {
+        betterAuthSchema: string;
+        data: unknown;
+        model: string;
+        select?: string[];
+    }, unknown>;
+    dbFindOne: FunctionReference<"query", "internal", {
+        betterAuthSchema: string;
+        model: string;
+        select?: string[];
+        where: unknown[];
+    }, unknown>;
+    dbFindMany: FunctionReference<"query", "internal", {
+        betterAuthSchema: string;
+        model: string;
+        limit?: number;
+        sortBy?: {
+            direction: "asc" | "desc";
+            field: string;
+        };
+        where?: unknown[];
+    }, unknown[]>;
+    dbCount: FunctionReference<"query", "internal", {
+        betterAuthSchema: string;
+        model: string;
+        where?: unknown[];
+    }, number>;
+    dbUpdate: FunctionReference<"mutation", "internal", {
+        betterAuthSchema: string;
+        model: string;
+        update: unknown;
+        where: unknown[];
+    }, unknown>;
+    dbUpdateMany: FunctionReference<"mutation", "internal", {
+        betterAuthSchema: string;
+        model: string;
+        update: unknown;
+        where: unknown[];
+    }, number>;
+    dbDelete: FunctionReference<"mutation", "internal", {
+        betterAuthSchema: string;
+        model: string;
+        where: unknown[];
+    }, void>;
+    dbDeleteMany: FunctionReference<"mutation", "internal", {
+        betterAuthSchema: string;
+        model: string;
+        where: unknown[];
+    }, number>;
+};
+/**
+ * Arguments to `createBetterAuthAdapter` — follows the same pattern as
+ * `queryApi` and `mutationApi` in `@vexcms/core/src/convex/server.ts`.
+ *
+ * The factory accepts the user's Convex `internalMutation`/`internalQuery`
+ * builders so this package can create the DB mutations/queries without
+ * hardcoding paths. Visibility is always `"internal"` for better-auth.
+ *
+ * @typeParam DataModel - The user's Convex DataModel (from `_generated/dataModel`).
+ */
+export type CreateBetterAuthAdapterArgs<DataModel extends GenericDataModel> = {
+    /** The user's `internalMutation` from `convex/_generated/server`. */
+    internalMutation: MutationBuilder<DataModel, "internal">;
+    /** The user's `internalQuery` from `convex/_generated/server`. */
+    internalQuery: QueryBuilder<DataModel, "internal">;
+};
+/**
+ * Return value from `createBetterAuthAdapter`.
+ *
+ * Export `db` so `ctx.runMutation(internal.auth.db.dbX, ...)` call sites
+ * continue to work — the adapter calls these via `ctx.runMutation` and
+ * `ctx.runQuery`.
+ */
+export type CreateBetterAuthAdapterResult = {
+    /** The Better Auth database adapter. Pass to `betterAuth({ database: adapter })`. */
+    adapter: any;
+    /** DB operations typed as `FunctionReference<"mutation" | "query", "internal">`. */
+    db: BetterAuthDbHandlers;
+};
+/**
+ * Factory function signature — follows the same pattern as `queryApi` in
+ * `@vexcms/core/src/convex/server.ts`.
+ *
+ * @typeParam DataModel - The user's Convex DataModel (from `_generated/dataModel`).
+ * @param ctx - The Convex action context.
+ * @param args.internalMutation - The user's `internalMutation` from `convex/_generated/server`.
+ * @param args.internalQuery - The user's `internalQuery` from `convex/_generated/server`.
+ * @returns `{ adapter, db }` — export `db` so internal.auth.db.* call sites work.
+ */
+export interface CreateBetterAuthAdapter {
+    <DataModel extends GenericDataModel>(ctx: GenericActionCtx<DataModel>, args: CreateBetterAuthAdapterArgs<DataModel>): CreateBetterAuthAdapterResult;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/convex/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/convex/types.ts"],"names":[],"mappings":"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"}

package/dist/convex/utils.d.ts

@@ -0,0 +1,51 @@
+import type { BetterAuthDBSchema } from "better-auth/db";
+import type { DocumentByName, GenericDataModel, GenericQueryCtx, PaginationOptions, PaginationResult, SchemaDefinition, TableNamesInDataModel } from "convex/server";
+export type QueryArgs = {
+    limit?: number;
+    model: string;
+    offset?: number;
+    select?: string[];
+    sortBy?: {
+        direction: "asc" | "desc";
+        field: string;
+    };
+    where?: WhereClause[];
+};
+export type WhereClause = {
+    connector?: "AND" | "OR";
+    field: string;
+    operator?: "contains" | "ends_with" | "eq" | "gt" | "gte" | "in" | "lt" | "lte" | "ne" | "not_in" | "starts_with";
+    value: boolean | null | number | number[] | string | string[];
+};
+export declare const isUniqueField: (betterAuthSchema: BetterAuthDBSchema, model: string, field: string) => boolean;
+export declare const hasUniqueFields: (betterAuthSchema: BetterAuthDBSchema, model: string, input: Record<string, any>) => boolean;
+export declare const findIndex: (schema: SchemaDefinition<any, any>, args: QueryArgs) => {
+    indexFields: (string | number | boolean | string[] | number[] | null)[];
+    boundField?: undefined;
+    index?: undefined;
+    sortField?: undefined;
+    values?: undefined;
+} | {
+    boundField: string;
+    index: {
+        fields: any[];
+        indexDescriptor: any;
+    };
+    sortField: string | undefined;
+    values: {
+        eq: (string | number | boolean | string[] | number[] | null)[];
+        gt: string | number | boolean | string[] | number[] | null | undefined;
+        gte: string | number | boolean | string[] | number[] | null | undefined;
+        lt: string | number | boolean | string[] | number[] | null | undefined;
+        lte: string | number | boolean | string[] | number[] | null | undefined;
+    };
+    indexFields?: undefined;
+} | undefined;
+export declare const checkUniqueFields: <Schema extends SchemaDefinition<any, any>>(ctx: GenericQueryCtx<GenericDataModel>, schema: Schema, betterAuthSchema: BetterAuthDBSchema, table: string, input: Record<string, any>, doc?: Record<string, any>) => Promise<void>;
+export declare const selectFields: <T extends TableNamesInDataModel<GenericDataModel>, D extends DocumentByName<GenericDataModel, T>>(doc: D | null, select?: string[]) => D | null;
+export declare const filterByWhere: <T extends TableNamesInDataModel<GenericDataModel>, D extends DocumentByName<GenericDataModel, T>>(doc: D | null, where?: WhereClause[], filterWhere?: (w: WhereClause) => any) => boolean;
+export declare const paginate: <Doc extends DocumentByName<GenericDataModel, T>, T extends TableNamesInDataModel<GenericDataModel>>(ctx: GenericQueryCtx<GenericDataModel>, schema: SchemaDefinition<any, any>, betterAuthSchema: BetterAuthDBSchema, args: QueryArgs & {
+    paginationOpts: PaginationOptions;
+}) => Promise<PaginationResult<Doc>>;
+export declare const listOne: <Doc extends DocumentByName<GenericDataModel, T>, T extends TableNamesInDataModel<GenericDataModel>>(ctx: GenericQueryCtx<GenericDataModel>, schema: SchemaDefinition<any, any>, betterAuthSchema: BetterAuthDBSchema, args: QueryArgs) => Promise<Doc | null>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/convex/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/convex/utils.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,51 +1,45 @@
-import { VexAuthAdapter } from '@vexcms/core';
-import { BetterAuthOptions } from 'better-auth';
-
-interface VexBetterAuthOptions {
-    config?: BetterAuthOptions;
-}
-type UserFields = "name" | "email" | "emailVerified" | "image" | "createdAt" | "updatedAt";
-type SessionFields = "expiresAt" | "token" | "createdAt" | "updatedAt" | "ipAddress" | "userAgent" | "userId";
-type AccountFields = "accountId" | "providerId" | "userId" | "accessToken" | "refreshToken" | "accessTokenExpiresAt" | "refreshTokenExpiresAt" | "scope" | "password" | "createdAt" | "updatedAt";
-type VerificationFields = "identifier" | "value" | "expiresAt" | "createdAt" | "updatedAt";
 /**
- * Type-level map from collection slug to field key union.
- * Base fields are always present; plugin-added fields work at runtime
- * but don't get autocomplete.
- */
-type BetterAuthFieldKeyMap = {
-    user: UserFields;
-    session: SessionFields;
-    account: AccountFields;
-    verification: VerificationFields;
-};
-/**
- * The typed adapter returned by `vexBetterAuth()`.
- * Base field keys are preserved as string literals
- * for autocomplete in `defineCollection`.
- */
-type BetterAuthAdapter = VexAuthAdapter<BetterAuthFieldKeyMap>;
-/**
- * Creates a VexAuthAdapter from a BetterAuthOptions config.
+ * @vexcms/better-auth package entry point.
  *
- * Accepts the same config object you pass to betterAuth() on the server.
- * Only reads schema-affecting properties (modelNames, additionalFields, plugins).
- * Runtime options (database, secret, baseURL, etc.) are ignored.
+ * Integrates [Better Auth](https://better-auth.com/) with VexCMS as the auth backend.
+ * Call `betterAuthAdapter()` in `vex.config.ts` to register Better Auth collections
+ * as VexCMS collections. Use `authDbApi()` and `createBetterAuthAdapter()` in your
+ * Convex schema to wire the DB adapter.
  *
  * @example
  * ```ts
- * import { vexBetterAuth } from "@vexcms/better-auth";
- * import { admin } from "better-auth/plugins";
+ * // vex.config.ts
+ * import { betterAuthAdapter } from "@vexcms/better-auth";
+ * import { authOptions } from "~/auth/options";
  *
  * export default defineConfig({
- *   auth: vexBetterAuth({
- *     user: { modelName: "users" },
- *     plugins: [admin()],
- *   }),
- *   // ...
+ *   auth: betterAuthAdapter({ config: authOptions }),
+ *   collections: [posts],
  * });
  * ```
+ *
+ * @example
+ * ```ts
+ * // convex/auth/db.ts — wire the DB adapter into Convex
+ * import { authDbApi } from "@vexcms/better-auth/convex";
+ * import { internalMutation, internalQuery } from "convex/_generated/server";
+ * import schema from "../schema";
+ *
+ * export const {
+ *   dbCreate,
+ *   dbFindOne,
+ *   dbFindMany,
+ *   dbCount,
+ *   dbUpdate,
+ *   dbUpdateMany,
+ *   dbDelete,
+ *   dbDeleteMany,
+ * } = authDbApi({ schema, internalQuery, internalMutation });
+ * ```
+ *
+ * @see {@link betterAuthAdapter} for the main Vex auth adapter function
+ * @see {@link authDbApi} for wiring the Convex DB operations
  */
-declare function vexBetterAuth(props?: VexBetterAuthOptions): BetterAuthAdapter;
-
-export { type BetterAuthAdapter, vexBetterAuth };
+export { betterAuthAdapter, type BetterAuthAdapterOptions } from "./adapter";
+export { authDbApi, createBetterAuthAdapter, convexAdapter, createGetAuth, type CreateBetterAuthAdapterArgs, type CreateBetterAuthAdapterResult, } from "./convex";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EACL,SAAS,EACT,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,GACnC,MAAM,UAAU,CAAC"}