better-convex 0.0.5 → 0.2.0

package/dist/auth-client/index.d.ts

@@ -25,6 +25,9 @@ type ConvexAuthProviderProps = {
 /**
  * Unified auth provider for Convex + Better Auth.
  * Handles token sync, HMR persistence, and auth callbacks.
+ *
+ * Structure: AuthProvider wraps ConvexAuthProviderInner so that
+ * useAuthStore() is available when creating fetchAccessToken.
  */
 declare function ConvexAuthProvider({
   children,

package/dist/auth-client/index.js

@@ -1,9 +1,9 @@
 'use client';
-import { _ as defaultIsUnauthorized, c as persistToken, f as useAuthStore, g as CRPCClientError, p as useAuthValue, s as getPersistedToken, t as AuthProvider } from "../auth-store-DANFmEdk.js";
+import { _ as defaultIsUnauthorized, d as useAuthStore, f as useAuthValue, g as CRPCClientError, r as FetchAccessTokenContext, s as decodeJwtExp, t as AuthProvider } from "../auth-store-BMSJFMtR.js";
 import { c } from "react/compiler-runtime";
-import { ConvexProviderWithAuth } from "convex/react";
+import { ConvexProviderWithAuth, useConvexAuth } from "convex/react";
 import { useCallback, useEffect, useMemo } from "react";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { jsx } from "react/jsx-runtime";
 
 //#region src/auth-client/convex-auth-provider.tsx
 /**
@@ -18,122 +18,171 @@ const defaultMutationHandler = () => {
 /**
 * Unified auth provider for Convex + Better Auth.
 * Handles token sync, HMR persistence, and auth callbacks.
+*
+* Structure: AuthProvider wraps ConvexAuthProviderInner so that
+* useAuthStore() is available when creating fetchAccessToken.
 */
 function ConvexAuthProvider(t0) {
-	const $ = c(17);
+	const $ = c(15);
 	const { children, client, authClient, initialToken, onMutationUnauthorized, onQueryUnauthorized, isUnauthorized } = t0;
+	useOTTHandler(authClient);
 	let t1;
 	if ($[0] !== initialToken) {
-		t1 = initialToken ?? getPersistedToken();
+		t1 = initialToken ? decodeJwtExp(initialToken) : null;
 		$[0] = initialToken;
 		$[1] = t1;
 	} else t1 = $[1];
-	const effectiveToken = t1;
-	if (effectiveToken) persistToken(effectiveToken);
-	const useAuth = useCreateConvexAuth(authClient);
-	useOTTHandler(authClient);
-	const t2 = client;
-	const t3 = effectiveToken ?? null;
-	let t4;
-	if ($[2] !== t3) {
-		t4 = {
-			isLoading: true,
-			token: t3
+	const t2 = initialToken ?? null;
+	let t3;
+	if ($[2] !== t1 || $[3] !== t2) {
+		t3 = {
+			expiresAt: t1,
+			token: t2
 		};
-		$[2] = t3;
-		$[3] = t4;
-	} else t4 = $[3];
-	const t5 = isUnauthorized ?? defaultIsUnauthorized;
-	const t6 = onMutationUnauthorized ?? defaultMutationHandler;
-	const t7 = onQueryUnauthorized ?? _temp;
-	let t8;
-	if ($[4] !== authClient) {
-		t8 = /* @__PURE__ */ jsx(AuthSyncEffect, { authClient });
-		$[4] = authClient;
-		$[5] = t8;
-	} else t8 = $[5];
-	let t9;
-	if ($[6] !== children || $[7] !== t4 || $[8] !== t5 || $[9] !== t6 || $[10] !== t7 || $[11] !== t8) {
-		t9 = /* @__PURE__ */ jsxs(AuthProvider, {
-			initialValues: t4,
-			isUnauthorized: t5,
-			onMutationUnauthorized: t6,
-			onQueryUnauthorized: t7,
-			children: [t8, children]
+		$[2] = t1;
+		$[3] = t2;
+		$[4] = t3;
+	} else t3 = $[4];
+	const tokenValues = t3;
+	const t4 = isUnauthorized ?? defaultIsUnauthorized;
+	const t5 = onMutationUnauthorized ?? defaultMutationHandler;
+	const t6 = onQueryUnauthorized ?? _temp;
+	let t7;
+	if ($[5] !== authClient || $[6] !== children || $[7] !== client) {
+		t7 = /* @__PURE__ */ jsx(ConvexAuthProviderInner, {
+			authClient,
+			client,
+			children
 		});
+		$[5] = authClient;
 		$[6] = children;
-		$[7] = t4;
-		$[8] = t5;
-		$[9] = t6;
-		$[10] = t7;
-		$[11] = t8;
-		$[12] = t9;
-	} else t9 = $[12];
-	let t10;
-	if ($[13] !== t2 || $[14] !== t9 || $[15] !== useAuth) {
-		t10 = /* @__PURE__ */ jsx(ConvexProviderWithAuth, {
-			client: t2,
-			useAuth,
-			children: t9
+		$[7] = client;
+		$[8] = t7;
+	} else t7 = $[8];
+	let t8;
+	if ($[9] !== t4 || $[10] !== t5 || $[11] !== t6 || $[12] !== t7 || $[13] !== tokenValues) {
+		t8 = /* @__PURE__ */ jsx(AuthProvider, {
+			initialValues: tokenValues,
+			isUnauthorized: t4,
+			onMutationUnauthorized: t5,
+			onQueryUnauthorized: t6,
+			children: t7
 		});
-		$[13] = t2;
-		$[14] = t9;
-		$[15] = useAuth;
-		$[16] = t10;
-	} else t10 = $[16];
-	return t10;
+		$[9] = t4;
+		$[10] = t5;
+		$[11] = t6;
+		$[12] = t7;
+		$[13] = tokenValues;
+		$[14] = t8;
+	} else t8 = $[14];
+	return t8;
 }
 /**
-* Syncs Better Auth session to auth-store.
-* Automatically handles login/logout token updates.
+* Inner provider that has access to AuthStore via useAuthStore().
+* Creates fetchAccessToken and passes it through context (no race condition).
 */
 function _temp() {}
-function AuthSyncEffect({ authClient }) {
-	const session = authClient.useSession();
+function ConvexAuthProviderInner({ children, client, authClient }) {
 	const authStore = useAuthStore();
-	useEffect(() => {
-		if (!session.isPending) {
-			const token = session.data?.session.token ?? null;
-			if (token !== authStore.get("token")) {
-				authStore.set("token", token);
-				persistToken(token);
+	const { data: session, isPending } = authClient.useSession();
+	const fetchAccessToken = useCallback(async ({ forceRefreshToken = false } = {}) => {
+		if (!session) {
+			if (!isPending) {
+				authStore.set("token", null);
+				authStore.set("expiresAt", null);
 			}
+			return authStore.get("token");
+		}
+		const cachedToken = authStore.get("token");
+		const expiresAt = authStore.get("expiresAt");
+		const timeRemaining = expiresAt ? expiresAt - Date.now() : 0;
+		if (!forceRefreshToken && cachedToken && expiresAt && timeRemaining >= 6e4) return cachedToken;
+		try {
+			const { data } = await authClient.convex.token();
+			const jwt = data?.token || null;
+			if (jwt) {
+				const exp = decodeJwtExp(jwt);
+				authStore.set("token", jwt);
+				authStore.set("expiresAt", exp);
+			}
+			return jwt;
+		} catch {
+			return null;
 		}
 	}, [
-		session.data,
-		session.isPending,
-		authStore
+		session,
+		isPending,
+		authStore,
+		authClient
 	]);
-	return null;
-}
-/**
-* Creates useAuth hook for ConvexProviderWithAuth.
-* Uses auth-store token as single source of truth.
-*/
-function useCreateConvexAuth(authClient) {
-	return useMemo(() => function useConvexAuth$1() {
-		const { data: session, isPending: isSessionPending } = authClient.useSession();
-		const token = useAuthValue("token");
-		const sessionId = session?.session?.id;
-		const fetchAccessToken = useCallback(async ({ forceRefreshToken = false } = {}) => {
-			if (token && !forceRefreshToken) return token;
-			try {
-				const { data } = await authClient.convex.token();
-				return data?.token || null;
-			} catch {
-				return null;
-			}
-		}, [sessionId, token]);
+	const useAuth = useMemo(() => function useConvexAuthHook() {
 		return useMemo(() => ({
-			isLoading: isSessionPending,
+			isLoading: isPending,
 			isAuthenticated: session !== null,
 			fetchAccessToken
 		}), [
-			isSessionPending,
-			sessionId,
+			isPending,
+			session,
 			fetchAccessToken
 		]);
-	}, [authClient]);
+	}, [
+		isPending,
+		session,
+		fetchAccessToken
+	]);
+	return /* @__PURE__ */ jsx(FetchAccessTokenContext.Provider, {
+		value: fetchAccessToken,
+		children: /* @__PURE__ */ jsx(ConvexProviderWithAuth, {
+			client,
+			useAuth,
+			children: /* @__PURE__ */ jsx(AuthStateSync, { children })
+		})
+	});
+}
+/**
+* Syncs auth state from useConvexAuth() to the auth store.
+* MUST be inside ConvexProviderWithAuth to access useConvexAuth().
+*
+* Defensive isLoading computation handles SSR hydration race:
+* 1. SSR sets token from cookie
+* 2. Client hydrates
+* 3. Better Auth's useSession() briefly returns null before loading cookie
+* 4. Convex sets isConvexAuthenticated = false (no auth to wait for)
+* 5. Without defensive check, we'd sync { isLoading: false, isAuthenticated: false }
+* 6. Queries would throw UNAUTHORIZED before token is validated
+*/
+function AuthStateSync(t0) {
+	const $ = c(6);
+	const { children } = t0;
+	const { isLoading: convexIsLoading, isAuthenticated } = useConvexAuth();
+	const authStore = useAuthStore();
+	const token = useAuthValue("token");
+	let t1;
+	let t2;
+	if ($[0] !== authStore || $[1] !== convexIsLoading || $[2] !== isAuthenticated || $[3] !== token) {
+		t1 = () => {
+			const isLoading = convexIsLoading || !!token && !isAuthenticated;
+			authStore.set("isLoading", isLoading);
+			authStore.set("isAuthenticated", isAuthenticated);
+		};
+		t2 = [
+			convexIsLoading,
+			isAuthenticated,
+			token,
+			authStore
+		];
+		$[0] = authStore;
+		$[1] = convexIsLoading;
+		$[2] = isAuthenticated;
+		$[3] = token;
+		$[4] = t1;
+		$[5] = t2;
+	} else {
+		t1 = $[4];
+		t2 = $[5];
+	}
+	useEffect(t1, t2);
+	return children;
 }
 /**
 * Handles cross-domain one-time token (OTT) verification.

package/dist/auth-nextjs/index.d.ts

@@ -1,3 +1,4 @@
+import "../http-types-BwEQgYV1.js";
 import { CallerMeta, ConvexContext, LazyCaller } from "../server/index.js";
 import { GetTokenOptions } from "@convex-dev/better-auth/utils";
 

package/dist/{auth-store-DANFmEdk.js → auth-store-BMSJFMtR.js}

@@ -1,7 +1,7 @@
 'use client';
 import { c } from "react/compiler-runtime";
 import { useConvexAuth } from "convex/react";
-import React from "react";
+import { createContext, useContext } from "react";
 import { createAtomStore } from "jotai-x";
 
 //#region src/crpc/error.ts
@@ -40,59 +40,21 @@ const defaultIsUnauthorized = (error) => {
 * Provides token storage and auth callback configuration.
 * App configures handlers, lib hooks consume state.
 */
-const globalStore = globalThis;
-const AUTH_TOKEN_KEY = Symbol.for("convex.authToken");
-/** Get persisted token from globalThis (survives HMR) */
-const getPersistedToken = () => {
-	if (typeof window === "undefined") return null;
-	return globalStore[AUTH_TOKEN_KEY] ?? null;
+const FetchAccessTokenContext = createContext(null);
+/** Get fetchAccessToken from context (available immediately, no race condition) */
+const useFetchAccessToken = () => {
+	return useContext(FetchAccessTokenContext);
 };
-/** Persist token to globalThis (survives HMR) */
-const persistToken = (token) => {
-	if (typeof window !== "undefined") globalStore[AUTH_TOKEN_KEY] = token;
-};
-function AuthEffect() {
-	const $ = c(7);
-	const authStore$1 = useAuthStore();
-	const { isAuthenticated, isLoading } = useConvexAuth();
-	const token = useAuthValue("token");
-	const onMutationUnauthorized = useAuthValue("onMutationUnauthorized");
-	let t0;
-	let t1;
-	if ($[0] !== authStore$1 || $[1] !== isAuthenticated || $[2] !== isLoading || $[3] !== onMutationUnauthorized || $[4] !== token) {
-		t0 = () => {
-			authStore$1.set("isLoading", isLoading);
-			authStore$1.set("isAuthenticated", isAuthenticated && !!token);
-			authStore$1.set("guard", (callback) => {
-				if (!token) {
-					onMutationUnauthorized();
-					return true;
-				}
-				return callback ? void callback() : false;
-			});
-		};
-		t1 = [
-			isLoading,
-			isAuthenticated,
-			token,
-			onMutationUnauthorized,
-			authStore$1
-		];
-		$[0] = authStore$1;
-		$[1] = isAuthenticated;
-		$[2] = isLoading;
-		$[3] = onMutationUnauthorized;
-		$[4] = token;
-		$[5] = t0;
-		$[6] = t1;
-	} else {
-		t0 = $[5];
-		t1 = $[6];
+/** Decode JWT expiration (ms timestamp) from token */
+function decodeJwtExp(token) {
+	try {
+		const payload = JSON.parse(atob(token.split(".")[1]));
+		return payload.exp ? payload.exp * 1e3 : null;
+	} catch {
+		return null;
 	}
-	React.useEffect(t0, t1);
-	return null;
 }
-const { authStore, AuthProvider, useAuthStore, useAuthState, useAuthValue } = createAtomStore({
+const { AuthProvider, useAuthStore, useAuthState, useAuthValue } = createAtomStore({
 	onMutationUnauthorized: () => {
 		throw new CRPCClientError({
 			code: "UNAUTHORIZED",
@@ -101,33 +63,30 @@ const { authStore, AuthProvider, useAuthStore, useAuthState, useAuthValue } = cr
 	},
 	onQueryUnauthorized: () => {},
 	isUnauthorized: defaultIsUnauthorized,
-	token: getPersistedToken(),
-	enabled: false,
-	isLoading: false,
-	isAuthenticated: false,
-	guard: () => false
+	token: null,
+	expiresAt: null,
+	isLoading: true,
+	isAuthenticated: false
 }, {
-	effect: AuthEffect,
 	name: "auth",
 	suppressWarnings: true
 });
 const useAuth = () => {
-	const authStore$1 = useAuthStore();
-	if (!authStore$1.store) return {
+	const authStore = useAuthStore();
+	if (!authStore.store) return {
 		hasSession: false,
 		isAuthenticated: false,
 		isLoading: false
 	};
 	if (typeof window === "undefined") return {
-		hasSession: !!authStore$1.get("token"),
+		hasSession: !!authStore.get("token"),
 		isAuthenticated: false,
 		isLoading: true
 	};
-	const { isAuthenticated, isLoading } = useConvexAuth();
-	const token = useAuthValue("token");
+	const { isLoading, isAuthenticated } = useConvexAuth();
 	return {
-		hasSession: !!token,
-		isAuthenticated: isAuthenticated && !!token,
+		hasSession: !!useAuthValue("token"),
+		isAuthenticated,
 		isLoading
 	};
 };
@@ -143,18 +102,18 @@ const useIsAuth = () => {
 };
 const useAuthGuard = () => {
 	const $ = c(3);
-	const isAuth = useIsAuth();
+	const { isAuthenticated } = useConvexAuth();
 	const onMutationUnauthorized = useAuthValue("onMutationUnauthorized");
 	let t0;
-	if ($[0] !== isAuth || $[1] !== onMutationUnauthorized) {
+	if ($[0] !== isAuthenticated || $[1] !== onMutationUnauthorized) {
 		t0 = (callback) => {
-			if (!isAuth) {
+			if (!isAuthenticated) {
 				onMutationUnauthorized();
 				return true;
 			}
 			return callback ? void callback() : false;
 		};
-		$[0] = isAuth;
+		$[0] = isAuthenticated;
 		$[1] = onMutationUnauthorized;
 		$[2] = t0;
 	} else t0 = $[2];
@@ -183,4 +142,4 @@ function Unauthenticated(t0) {
 }
 
 //#endregion
-export { defaultIsUnauthorized as _, Unauthenticated as a, persistToken as c, useAuthState as d, useAuthStore as f, CRPCClientError as g, useMaybeAuth as h, MaybeUnauthenticated as i, useAuth as l, useIsAuth as m, Authenticated as n, authStore as o, useAuthValue as p, MaybeAuthenticated as r, getPersistedToken as s, AuthProvider as t, useAuthGuard as u, isCRPCClientError as v };
+export { defaultIsUnauthorized as _, MaybeUnauthenticated as a, useAuth as c, useAuthStore as d, useAuthValue as f, CRPCClientError as g, useMaybeAuth as h, MaybeAuthenticated as i, useAuthGuard as l, useIsAuth as m, Authenticated as n, Unauthenticated as o, useFetchAccessToken as p, FetchAccessTokenContext as r, decodeJwtExp as s, AuthProvider as t, useAuthState as u, isCRPCClientError as v };

package/dist/cli.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_codegen = require('./codegen-DN-vbQih.cjs');
+const require_codegen = require('./codegen-Cca0gj6d.cjs');
 let node_module = require("node:module");
 let node_path = require("node:path");
 node_path = require_codegen.__toESM(node_path);

package/dist/{codegen-DN-vbQih.cjs → codegen-Cca0gj6d.cjs}

@@ -33,6 +33,8 @@ node_fs = __toESM(node_fs);
 let jiti = require("jiti");
 
 //#region src/cli/codegen.ts
+/** Valid JS identifier pattern for object keys */
+const VALID_IDENTIFIER_RE = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;
 function getConvexConfig(outputDir) {
 	const convexConfigPath = node_path.default.join(process.cwd(), "convex.json");
 	const functionsDir = (node_fs.default.existsSync(convexConfigPath) ? JSON.parse(node_fs.default.readFileSync(convexConfigPath, "utf-8")) : {}).functions || "convex";
@@ -42,12 +44,22 @@ function getConvexConfig(outputDir) {
 	};
 }
 /**
+* Check if a value is a CRPCHttpRouter (has _def.router === true)
+*/
+function isCRPCHttpRouter(value) {
+	return typeof value === "object" && value !== null && "_def" in value && value._def?.router === true;
+}
+/**
 * Import a module using jiti and extract CRPC metadata from exports
 */
 async function parseModuleRuntime(filePath, jiti$1) {
 	const result = {};
+	const httpRoutes = {};
 	const module$1 = await jiti$1.import(filePath);
-	if (!module$1 || typeof module$1 !== "object") return null;
+	if (!module$1 || typeof module$1 !== "object") return {
+		meta: null,
+		httpRoutes: {}
+	};
 	for (const [name, value] of Object.entries(module$1)) {
 		if (name.startsWith("_")) continue;
 		const meta = value?._crpcMeta;
@@ -58,8 +70,23 @@ async function parseModuleRuntime(filePath, jiti$1) {
 			for (const [key, val] of Object.entries(meta)) if (key !== "type" && key !== "internal" && val !== void 0) fnMeta[key] = val;
 			result[name] = fnMeta;
 		}
+		const httpRoute = value?._crpcHttpRoute;
+		if (httpRoute?.path && httpRoute?.method) httpRoutes[name] = {
+			path: httpRoute.path,
+			method: httpRoute.method
+		};
+		if (isCRPCHttpRouter(value)) for (const [procPath, procedure] of Object.entries(value._def.procedures)) {
+			const route = procedure._crpcHttpRoute;
+			if (route?.path && route?.method) httpRoutes[procPath] = {
+				path: route.path,
+				method: route.method
+			};
+		}
 	}
-	return Object.keys(result).length > 0 ? result : null;
+	return {
+		meta: Object.keys(result).length > 0 ? result : null,
+		httpRoutes
+	};
 }
 async function generateMeta(outputDir, options) {
 	const startTime = Date.now();
@@ -72,24 +99,25 @@ async function generateMeta(outputDir, options) {
 		moduleCache: false
 	});
 	const meta = {};
+	const allHttpRoutes = {};
 	let totalFunctions = 0;
 	const files = node_fs.default.readdirSync(functionsDir).filter((file) => file.endsWith(".ts") && !file.startsWith("_") && ![
 		"schema.ts",
 		"convex.config.ts",
-		"auth.config.ts",
-		"http.ts"
+		"auth.config.ts"
 	].includes(file));
 	for (const file of files) {
 		const filePath = node_path.default.join(functionsDir, file);
 		const moduleName = file.replace(".ts", "");
 		try {
-			const moduleMeta = await parseModuleRuntime(filePath, jiti$1);
+			const { meta: moduleMeta, httpRoutes } = await parseModuleRuntime(filePath, jiti$1);
 			if (moduleMeta) {
 				meta[moduleName] = moduleMeta;
 				const fnCount = Object.keys(moduleMeta).length;
 				totalFunctions += fnCount;
 				if (debug) console.info(`  ✓ ${moduleName}: ${fnCount} functions`);
 			}
+			Object.assign(allHttpRoutes, httpRoutes);
 		} catch (error) {
 			if (debug) console.error(`  ⚠ Failed to parse ${file}:`, error);
 		}
@@ -106,11 +134,30 @@ async function generateMeta(outputDir, options) {
 			return `    ${fn}: ${`{ ${metaProps.join(", ")} }`}`;
 		}).join(",\n")},\n  }`;
 	}).join(",\n");
+	const metaContent = metaEntries ? `\n${metaEntries},\n` : "";
+	const routesByPath = /* @__PURE__ */ new Map();
+	for (const [key, route] of Object.entries(allHttpRoutes)) {
+		const pathKey = `${route.path}:${route.method}`;
+		const existing = routesByPath.get(pathKey) || [];
+		existing.push({
+			key,
+			route
+		});
+		routesByPath.set(pathKey, existing);
+	}
+	const dedupedRoutes = {};
+	for (const entries of routesByPath.values()) {
+		const best = entries.reduce((a, b) => a.key.length >= b.key.length ? a : b);
+		dedupedRoutes[best.key] = best.route;
+	}
+	const formatKey = (key) => VALID_IDENTIFIER_RE.test(key) ? key : `'${key}'`;
+	const httpEntries = Object.entries(dedupedRoutes).sort(([a], [b]) => a.localeCompare(b)).map(([name, route]) => `    ${formatKey(name)}: { path: '${route.path}', method: '${route.method}' }`).join(",\n");
+	const httpContent = httpEntries ? `\n${httpEntries},\n  ` : "";
 	const output = `// biome-ignore-all format: generated
 // This file is auto-generated by better-convex
 // Do not edit manually. Run \`better-convex codegen\` to regenerate.
 
-export const meta = {${metaEntries ? `\n${metaEntries},\n` : ""}} as const;
+export const meta = {${metaContent ? `${metaContent}  _http: {${httpContent}},\n` : `\n  _http: {${httpContent}},\n`}} as const;
 
 export type Meta = typeof meta;
 `;

package/dist/crpc/index.d.ts

@@ -1,4 +1,5 @@
-import { C as PaginatedFnMeta, S as Meta, _ as ExtractPaginatedItem, a as ConvexInfiniteQueryMeta, b as InfiniteQueryInput, c as ConvexMutationKey, d as ConvexQueryMeta, f as ConvexQueryOptions, g as DecorateQuery, h as DecorateMutation, i as ConvexActionOptions, l as ConvexQueryHookOptions, m as DecorateInfiniteQuery, n as CRPCClient, o as ConvexInfiniteQueryOptions, p as DecorateAction, r as ConvexActionKey, s as ConvexInfiniteQueryOptionsWithRef, t as AuthType, u as ConvexQueryKey, v as FUNC_REF_SYMBOL, w as PaginationOpts, x as InfiniteQueryOptsParam, y as FnMeta } from "../types-CotWvon8.js";
+import { _ as HttpRouterRecord, a as HttpErrorCode, c as HttpRouteMap, d as isHttpClientError, h as CRPCHttpRouter, i as HttpClientOptions, l as InferHttpInput, n as HttpClientError, o as HttpProcedureCall, r as HttpClientFromRouter, s as HttpRouteInfo, t as HttpClient, u as InferHttpOutput } from "../http-types-BwEQgYV1.js";
+import { C as PaginatedFnMeta, S as Meta, _ as ExtractPaginatedItem, a as ConvexInfiniteQueryMeta, b as InfiniteQueryInput, c as ConvexMutationKey, d as ConvexQueryMeta, f as ConvexQueryOptions, g as DecorateQuery, h as DecorateMutation, i as ConvexActionOptions, l as ConvexQueryHookOptions, m as DecorateInfiniteQuery, n as CRPCClient, o as ConvexInfiniteQueryOptions, p as DecorateAction, r as ConvexActionKey, s as ConvexInfiniteQueryOptionsWithRef, t as AuthType, u as ConvexQueryKey, v as FUNC_REF_SYMBOL, w as PaginationOpts, x as InfiniteQueryOptsParam, y as FnMeta } from "../types-DLVNrXKq.js";
 import { FunctionArgs, FunctionReference } from "convex/server";
 
 //#region src/crpc/error.d.ts
@@ -27,6 +28,44 @@ declare const isCRPCErrorCode: (error: unknown, code: ClientErrorCode) => error
 /** Default unauthorized detection - checks UNAUTHORIZED code */
 declare const defaultIsUnauthorized: (error: unknown) => boolean;
 //#endregion
+//#region src/crpc/http-client.d.ts
+
+/**
+ * Create a typed HTTP client for cRPC HTTP routers
+ *
+ * Supports nested router access like tRPC:
+ * - `http.todos.get({ id })` for nested routers
+ * - `http.health()` for flat procedures
+ *
+ * For React apps, prefer using `createCRPCContext` with HTTP options
+ * which provides TanStack Query integration (queryOptions, mutationOptions).
+ *
+ * @example
+ * ```ts
+ * import { createHttpClient } from 'better-convex/crpc';
+ * import { meta } from '../convex/shared/meta';
+ * import type { AppRouter } from '../convex/functions/http';
+ *
+ * const http = createHttpClient<AppRouter>({
+ *   convexSiteUrl: process.env.NEXT_PUBLIC_CONVEX_SITE_URL!,
+ *   routes: meta._http!, // HTTP routes are in meta._http
+ * });
+ *
+ * // Nested access
+ * const todo = await http.todos.get({ id: 'abc123' });
+ *
+ * // Flat access
+ * const health = await http.health();
+ * ```
+ */
+declare function createHttpClient<TRouter extends CRPCHttpRouter<any>, TRoutes extends HttpRouteMap = HttpRouteMap>(opts: HttpClientOptions<TRoutes>): HttpClientFromRouter<TRouter>;
+/**
+ * Create a typed HTTP client for flat HTTP router record
+ *
+ * @deprecated Prefer passing a CRPCHttpRouter type for nested access
+ */
+declare function createHttpClient<TRouter extends HttpRouterRecord, TRoutes extends HttpRouteMap = HttpRouteMap>(opts: HttpClientOptions<TRoutes>): HttpClient<TRouter>;
+//#endregion
 //#region src/crpc/query-options.d.ts
 /**
  * Query options factory for Convex query function subscriptions.
@@ -67,4 +106,4 @@ declare function convexAction<T extends FunctionReference<'action'>>(funcRef: T,
  */
 declare function convexInfiniteQueryOptions<T extends FunctionReference<'query'>>(funcRef: T, args: Record<string, unknown> | 'skip', opts?: InfiniteQueryOptsParam<T>, meta?: Meta): ConvexInfiniteQueryOptions<T>;
 //#endregion
-export { AuthType, CRPCClient, CRPCClientError, ConvexActionKey, ConvexActionOptions, ConvexInfiniteQueryMeta, ConvexInfiniteQueryOptions, ConvexInfiniteQueryOptionsWithRef, ConvexMutationKey, ConvexQueryHookOptions, ConvexQueryKey, ConvexQueryMeta, ConvexQueryOptions, DecorateAction, DecorateInfiniteQuery, DecorateMutation, DecorateQuery, ExtractPaginatedItem, FUNC_REF_SYMBOL, FnMeta, InfiniteQueryInput, InfiniteQueryOptsParam, Meta, PaginatedFnMeta, PaginationOpts, convexAction, convexInfiniteQueryOptions, convexQuery, defaultIsUnauthorized, isCRPCClientError, isCRPCErrorCode };
+export { AuthType, CRPCClient, CRPCClientError, ConvexActionKey, ConvexActionOptions, ConvexInfiniteQueryMeta, ConvexInfiniteQueryOptions, ConvexInfiniteQueryOptionsWithRef, ConvexMutationKey, ConvexQueryHookOptions, ConvexQueryKey, ConvexQueryMeta, ConvexQueryOptions, DecorateAction, DecorateInfiniteQuery, DecorateMutation, DecorateQuery, ExtractPaginatedItem, FUNC_REF_SYMBOL, FnMeta, HttpClient, HttpClientError, HttpClientFromRouter, HttpClientOptions, HttpErrorCode, HttpProcedureCall, HttpRouteInfo, HttpRouteMap, InferHttpInput, InferHttpOutput, InfiniteQueryInput, InfiniteQueryOptsParam, Meta, PaginatedFnMeta, PaginationOpts, convexAction, convexInfiniteQueryOptions, convexQuery, createHttpClient, defaultIsUnauthorized, isCRPCClientError, isCRPCErrorCode, isHttpClientError };