convex-zen 0.0.1

package/dist/client/tanstack-start-client.js

@@ -0,0 +1,130 @@
+function normalizeBasePath(path) {
+    const normalized = path.trim();
+    if (normalized === "") {
+        return "/api/auth";
+    }
+    const withLeadingSlash = normalized.startsWith("/")
+        ? normalized
+        : `/${normalized}`;
+    if (withLeadingSlash.length > 1 && withLeadingSlash.endsWith("/")) {
+        return withLeadingSlash.slice(0, -1);
+    }
+    return withLeadingSlash;
+}
+async function readJson(response) {
+    try {
+        return await response.json();
+    }
+    catch {
+        return null;
+    }
+}
+function errorMessage(response, payload, fallback) {
+    if (payload &&
+        typeof payload === "object" &&
+        "error" in payload &&
+        typeof payload.error === "string") {
+        return payload.error;
+    }
+    return `${fallback} (${response.status})`;
+}
+function toSignInBody(input) {
+    const body = {
+        email: input.email,
+        password: input.password,
+    };
+    if (input.ipAddress) {
+        body.ipAddress = input.ipAddress;
+    }
+    if (input.userAgent) {
+        body.userAgent = input.userAgent;
+    }
+    return body;
+}
+/**
+ * Build a ConvexZen React auth client from TanStack Start server functions.
+ */
+export function createTanStackStartReactAuthClient(serverFns) {
+    return {
+        getSession: async () => {
+            return await serverFns.getSession();
+        },
+    };
+}
+/**
+ * Build a browser auth client targeting TanStack Start auth API routes.
+ *
+ * Defaults to:
+ * - basePath: `/api/auth`
+ * - credentials: `same-origin`
+ */
+export function createTanStackStartAuthApiClient(options = {}) {
+    const basePath = normalizeBasePath(options.basePath ?? "/api/auth");
+    const credentials = options.credentials ?? "same-origin";
+    const fetchImpl = options.fetch ?? fetch;
+    const plugins = options.plugins ?? [];
+    const request = async (path, init, failure) => {
+        const response = await fetchImpl(`${basePath}/${path}`, {
+            ...init,
+            credentials,
+        });
+        if (!response.ok) {
+            const payload = await readJson(response);
+            throw new Error(errorMessage(response, payload, failure.fallback));
+        }
+        return response;
+    };
+    const requestJson = async (path, init, failure) => {
+        const response = await request(path, init, failure);
+        const payload = await readJson(response);
+        return payload;
+    };
+    const requestVoid = async (path, init, failure) => {
+        await request(path, init, failure);
+    };
+    const getSession = async () => {
+        const payload = await requestJson("session", {
+            method: "GET",
+        }, { fallback: "Could not load session" });
+        return payload?.session ?? null;
+    };
+    const signInWithEmail = async (input) => {
+        const payload = await requestJson("sign-in-with-email", {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(toSignInBody(input)),
+        }, { fallback: "Sign in failed" });
+        if (!payload?.session) {
+            throw new Error("Sign in succeeded but no session was returned");
+        }
+        return payload.session;
+    };
+    const signOut = async () => {
+        await requestVoid("sign-out", {
+            method: "POST",
+        }, { fallback: "Sign out failed" });
+    };
+    const baseClient = {
+        getSession,
+        signInWithEmail,
+        signOut,
+        signIn: {
+            email: signInWithEmail,
+        },
+    };
+    const pluginContext = {
+        basePath,
+        credentials,
+        requestJson,
+        requestVoid,
+    };
+    const pluginExtensions = {};
+    for (const plugin of plugins) {
+        Object.assign(pluginExtensions, plugin.create(pluginContext));
+    }
+    return {
+        ...baseClient,
+        ...pluginExtensions,
+    };
+}
+//# sourceMappingURL=tanstack-start-client.js.map

package/dist/client/tanstack-start-client.js.map

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

package/dist/client/tanstack-start-plugins.d.ts

@@ -0,0 +1,27 @@
+import type { FunctionReference } from "convex/server";
+import type { TanStackStartAuthApiPluginFactory } from "./tanstack-start";
+type ActionRef = FunctionReference<"action", "public">;
+export interface TanStackStartAdminApiPluginActions {
+    listUsers: ActionRef;
+    banUser: ActionRef;
+    setRole: ActionRef;
+    unbanUser?: ActionRef;
+    deleteUser?: ActionRef;
+}
+export interface TanStackStartAdminApiPluginOptions {
+    actions: TanStackStartAdminApiPluginActions;
+    routePrefix?: string;
+}
+/**
+ * Add admin auth API routes to TanStack Start handler.
+ *
+ * Endpoints:
+ * - POST `/api/auth/admin/list-users`
+ * - POST `/api/auth/admin/ban-user`
+ * - POST `/api/auth/admin/set-role`
+ * - POST `/api/auth/admin/unban-user` (optional)
+ * - POST `/api/auth/admin/delete-user` (optional)
+ */
+export declare function adminApiPlugin(options: TanStackStartAdminApiPluginOptions): TanStackStartAuthApiPluginFactory;
+export {};
+//# sourceMappingURL=tanstack-start-plugins.d.ts.map

package/dist/client/tanstack-start-plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack-start-plugins.d.ts","sourceRoot":"","sources":["../../src/client/tanstack-start-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,kBAAkB,CAAC;AAE1E,KAAK,SAAS,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAGvD,MAAM,WAAW,kCAAkC;IACjD,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,kCAAkC,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAoFD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,kCAAkC,GAC1C,iCAAiC,CAyFnC"}

package/dist/client/tanstack-start-plugins.js

@@ -0,0 +1,145 @@
+function normalizeRoutePrefix(prefix) {
+    const trimmed = prefix.trim().replace(/^\/+|\/+$/g, "");
+    return trimmed.length > 0 ? trimmed : "admin";
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function parseListUsersArgs(value) {
+    if (value === null || value === undefined) {
+        return {};
+    }
+    if (!isRecord(value)) {
+        return null;
+    }
+    const args = {};
+    if (value.limit !== undefined) {
+        if (typeof value.limit !== "number") {
+            return null;
+        }
+        args.limit = value.limit;
+    }
+    if (value.cursor !== undefined) {
+        if (typeof value.cursor !== "string") {
+            return null;
+        }
+        args.cursor = value.cursor;
+    }
+    return args;
+}
+function parseBanUserArgs(value) {
+    if (!isRecord(value) || typeof value.userId !== "string") {
+        return null;
+    }
+    const args = {
+        userId: value.userId,
+    };
+    if (value.reason !== undefined) {
+        if (typeof value.reason !== "string") {
+            return null;
+        }
+        args.reason = value.reason;
+    }
+    if (value.expiresAt !== undefined) {
+        if (typeof value.expiresAt !== "number") {
+            return null;
+        }
+        args.expiresAt = value.expiresAt;
+    }
+    return args;
+}
+function parseSetRoleArgs(value) {
+    if (!isRecord(value) ||
+        typeof value.userId !== "string" ||
+        typeof value.role !== "string") {
+        return null;
+    }
+    return {
+        userId: value.userId,
+        role: value.role,
+    };
+}
+function parseSingleUserIdArgs(value) {
+    if (!isRecord(value) || typeof value.userId !== "string") {
+        return null;
+    }
+    return { userId: value.userId };
+}
+/**
+ * Add admin auth API routes to TanStack Start handler.
+ *
+ * Endpoints:
+ * - POST `/api/auth/admin/list-users`
+ * - POST `/api/auth/admin/ban-user`
+ * - POST `/api/auth/admin/set-role`
+ * - POST `/api/auth/admin/unban-user` (optional)
+ * - POST `/api/auth/admin/delete-user` (optional)
+ */
+export function adminApiPlugin(options) {
+    const routePrefix = normalizeRoutePrefix(options.routePrefix ?? "admin");
+    return {
+        id: "admin",
+        create: ({ fetchers }) => ({
+            id: "admin",
+            handle: async (context) => {
+                const actionPrefix = `${routePrefix}/`;
+                if (!context.action.startsWith(actionPrefix)) {
+                    return null;
+                }
+                if (context.method !== "POST") {
+                    return context.json({ error: "Method not allowed" }, 405);
+                }
+                const adminAction = context.action.slice(actionPrefix.length);
+                const payload = await context.readJson();
+                if (adminAction === "list-users") {
+                    const args = parseListUsersArgs(payload);
+                    if (!args) {
+                        return context.json({ error: "Invalid request body" }, 400);
+                    }
+                    const result = await fetchers.fetchAuthAction(options.actions.listUsers, args);
+                    return context.json(result);
+                }
+                if (adminAction === "ban-user") {
+                    const args = parseBanUserArgs(payload);
+                    if (!args) {
+                        return context.json({ error: "Invalid request body" }, 400);
+                    }
+                    const result = await fetchers.fetchAuthAction(options.actions.banUser, args);
+                    return context.json(result);
+                }
+                if (adminAction === "set-role") {
+                    const args = parseSetRoleArgs(payload);
+                    if (!args) {
+                        return context.json({ error: "Invalid request body" }, 400);
+                    }
+                    const result = await fetchers.fetchAuthAction(options.actions.setRole, args);
+                    return context.json(result);
+                }
+                if (adminAction === "unban-user") {
+                    if (!options.actions.unbanUser) {
+                        return context.json({ error: "Not found" }, 404);
+                    }
+                    const args = parseSingleUserIdArgs(payload);
+                    if (!args) {
+                        return context.json({ error: "Invalid request body" }, 400);
+                    }
+                    const result = await fetchers.fetchAuthAction(options.actions.unbanUser, args);
+                    return context.json(result);
+                }
+                if (adminAction === "delete-user") {
+                    if (!options.actions.deleteUser) {
+                        return context.json({ error: "Not found" }, 404);
+                    }
+                    const args = parseSingleUserIdArgs(payload);
+                    if (!args) {
+                        return context.json({ error: "Invalid request body" }, 400);
+                    }
+                    const result = await fetchers.fetchAuthAction(options.actions.deleteUser, args);
+                    return context.json(result);
+                }
+                return null;
+            },
+        }),
+    };
+}
+//# sourceMappingURL=tanstack-start-plugins.js.map

package/dist/client/tanstack-start-plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack-start-plugins.js","sourceRoot":"","sources":["../../src/client/tanstack-start-plugins.ts"],"names":[],"mappings":"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"}

package/dist/client/tanstack-start.d.ts

@@ -0,0 +1,130 @@
+import type { FunctionArgs, FunctionReference, FunctionReturnType } from "convex/server";
+import type { setCookie as setCookieFn } from "@tanstack/react-start/server";
+import { type SessionInfo, type SessionPrimitives, type SignInInput } from "./primitives";
+type SetCookieOptions = Exclude<Parameters<typeof setCookieFn>[2], undefined>;
+export interface TanStackStartAuthOptions {
+    primitives: SessionPrimitives;
+    cookieName?: string;
+    cookieOptions?: Partial<SetCookieOptions>;
+}
+export interface TanStackStartConvexActions {
+    /** Email/password sign-in action. */
+    signInWithEmail: FunctionReference<"action", "public">;
+    validateSession: FunctionReference<"action", "public">;
+    signOut: FunctionReference<"action", "public">;
+}
+export interface TanStackStartConvexAuthOptions {
+    convexUrl: string;
+    actions: TanStackStartConvexActions;
+    cookieName?: string;
+    cookieOptions?: Partial<SetCookieOptions>;
+}
+export interface TanStackStartConvexReactStartOptions extends TanStackStartConvexAuthOptions {
+    authApiBasePath?: string;
+    plugins?: readonly TanStackStartAuthApiPluginFactory[];
+}
+export interface AuthenticatedSession {
+    token: string;
+    session: SessionInfo;
+}
+export interface TanStackStartAuth {
+    getSession: () => Promise<SessionInfo | null>;
+    getToken: () => Promise<string | null>;
+    signIn: (input: SignInInput) => Promise<SessionInfo>;
+    signOut: () => Promise<void>;
+    requireSession: () => Promise<AuthenticatedSession>;
+    withSession: <T>(handler: (auth: AuthenticatedSession) => Promise<T>) => Promise<T>;
+}
+export interface TanStackStartSessionHandlers {
+    getSession: () => Promise<SessionInfo | null>;
+    getToken: () => Promise<string | null>;
+    requireSession: () => Promise<AuthenticatedSession>;
+    withSession: <T>(handler: (auth: AuthenticatedSession) => Promise<T>) => Promise<T>;
+}
+export interface TanStackStartAuthHandlers {
+    signInWithEmail: (input: SignInInput) => Promise<SessionInfo>;
+    signOut: () => Promise<void>;
+}
+export interface TanStackStartAuthApiHandlerOptions {
+    tanstackAuth: Pick<TanStackStartAuth, "getSession" | "signIn" | "signOut">;
+    basePath?: string;
+    plugins?: readonly TanStackStartAuthApiPlugin[];
+}
+export interface TanStackStartAuthApiPluginContext {
+    request: Request;
+    method: string;
+    action: string;
+    readJson: () => Promise<unknown>;
+    json: (data: unknown, status?: number) => Response;
+}
+export interface TanStackStartAuthApiPlugin {
+    id: string;
+    handle: (context: TanStackStartAuthApiPluginContext) => Promise<Response | null> | Response | null;
+}
+export interface TanStackStartAuthApiPluginFactoryContext {
+    tanstackAuth: TanStackAuthForPluginFactory;
+    fetchers: TanStackStartConvexFetchers;
+}
+type TanStackAuthForPluginFactory = Pick<TanStackStartAuth, "getSession" | "getToken" | "signIn" | "signOut" | "requireSession" | "withSession">;
+export interface TanStackStartAuthApiPluginFactory {
+    id: string;
+    create: (context: TanStackStartAuthApiPluginFactoryContext) => TanStackStartAuthApiPlugin;
+}
+export interface TanStackStartConvexFetchers {
+    fetchAuthQuery: <Query extends FunctionReference<"query", "public">>(fn: Query, args: FunctionArgs<Query>) => Promise<FunctionReturnType<Query>>;
+    fetchAuthMutation: <Mutation extends FunctionReference<"mutation", "public">>(fn: Mutation, args: FunctionArgs<Mutation>) => Promise<FunctionReturnType<Mutation>>;
+    fetchAuthAction: <Action extends FunctionReference<"action", "public">>(fn: Action, args: FunctionArgs<Action>) => Promise<FunctionReturnType<Action>>;
+}
+export interface TanStackStartConvexFetchersOptions {
+    tanstackAuth: Pick<TanStackStartAuth, "requireSession">;
+    convexUrl: string;
+}
+export interface TanStackStartConvexReactStart extends TanStackStartAuth, TanStackStartConvexFetchers {
+    handler: (request: Request) => Promise<Response>;
+}
+/**
+ * TanStack Start adapter.
+ *
+ * Exposes server-side auth handlers that read/write an HttpOnly session cookie
+ * and delegate auth logic to framework-agnostic SessionPrimitives.
+ *
+ * These handlers are meant to be wrapped by route-local `createServerFn(...)`
+ * so TanStack's server function transform runs in application code.
+ */
+export declare function createTanStackStartAuth(options: TanStackStartAuthOptions): TanStackStartAuth;
+/** Build route-friendly session handlers from a TanStack auth instance. */
+export declare function createTanStackStartSessionHandlers(tanstackAuth: TanStackStartAuth): TanStackStartSessionHandlers;
+/** Build route-friendly auth mutation handlers from a TanStack auth instance. */
+export declare function createTanStackStartAuthHandlers(tanstackAuth: TanStackStartAuth): TanStackStartAuthHandlers;
+/**
+ * Build a Request handler for `/api/auth/*` routes in TanStack Start.
+ *
+ * Supported actions:
+ * - `GET /api/auth/session`
+ * - `POST /api/auth/sign-in-with-email`
+ * - `POST /api/auth/sign-out`
+ */
+export declare function createTanStackStartAuthApiHandler(options: TanStackStartAuthApiHandlerOptions): (request: Request) => Promise<Response>;
+/**
+ * Build authenticated Convex fetch helpers for TanStack Start server functions.
+ * Each call resolves auth from cookies via `requireSession`.
+ */
+export declare function createTanStackStartConvexFetchers(options: TanStackStartConvexFetchersOptions): TanStackStartConvexFetchers;
+/**
+ * Build TanStack Start auth handlers directly from Convex public action refs.
+ *
+ * This removes transport boilerplate in app code while keeping session logic
+ * fully based on Convex functions.
+ */
+export declare function createTanStackStartConvexAuth(options: TanStackStartConvexAuthOptions): TanStackStartAuth;
+/**
+ * Better-auth-style TanStack Start helper for convex-zen.
+ *
+ * Returns a single object containing:
+ * - auth route `handler` (`/api/auth/*`)
+ * - token/session helpers (`getSession`, `getToken`, ...)
+ * - authenticated Convex fetchers (`fetchAuthQuery`, `fetchAuthMutation`, `fetchAuthAction`)
+ */
+export declare function convexZenReactStart(options: TanStackStartConvexReactStartOptions): TanStackStartConvexReactStart;
+export {};
+//# sourceMappingURL=tanstack-start.d.ts.map

package/dist/client/tanstack-start.d.ts.map

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