kitcn 0.12.20 → 0.12.22

package/dist/auth/nextjs/index.js

@@ -8,13 +8,16 @@ import { getToken } from "@convex-dev/better-auth/utils";
 * Next.js + Better Auth wrapper for Convex caller factory.
 * Uses @convex-dev/better-auth for token management.
 */
-const handler = (request, siteUrl) => {
+const handler = async (request, siteUrl) => {
 	const requestUrl = new URL(request.url);
 	const nextUrl = `${siteUrl}${requestUrl.pathname}${requestUrl.search}`;
-	const newRequest = new Request(nextUrl, request);
-	newRequest.headers.set("accept-encoding", "application/json");
-	newRequest.headers.set("host", new URL(siteUrl).host);
-	return fetch(newRequest, {
+	const headers = new Headers(request.headers);
+	headers.set("accept-encoding", "application/json");
+	headers.set("host", new URL(siteUrl).host);
+	const body = request.method !== "GET" && request.method !== "HEAD" ? await request.arrayBuffer() : void 0;
+	return fetch(nextUrl, {
+		body,
+		headers,
 		method: request.method,
 		redirect: "manual"
 	});

package/dist/{backend-core-C0uwGXLx.mjs → backend-core-DBBEoGeA.mjs}

@@ -14353,6 +14353,9 @@ function buildCodegenBootstrapArgs(targetArgs) {
 function didConvexInitCreateConfiguration(output) {
 	return CONVEX_INIT_CREATED_CONFIG_RE.test(output);
 }
+function isLocalBackendUpgradePrompt(output) {
+	return output.includes("This deployment is using an older version of the Convex backend. Upgrade now?");
+}
 async function runConvexInitIfNeeded(params) {
 	if (params.backendAdapter.publicName !== "convex") return {
 		created: false,
@@ -14360,12 +14363,9 @@ async function runConvexInitIfNeeded(params) {
 		stdout: "",
 		stderr: ""
 	};
-	const agentModeOverride = params.yes && getAggregateBackfillDeploymentKey(params.targetArgs ?? [], process.cwd(), params.env) === "local" ? "anonymous" : params.env?.CONVEX_AGENT_MODE;
-	const result = normalizeConvexCommandResult(await params.execaFn(params.backendAdapter.command, [
-		...params.backendAdapter.argsPrefix,
-		"init",
-		...params.targetArgs ?? []
-	], {
+	const shouldUseLocalDevPreflight = getAggregateBackfillDeploymentKey(params.targetArgs ?? [], process.cwd(), params.env) === "local";
+	const agentModeOverride = params.yes && shouldUseLocalDevPreflight ? "anonymous" : params.env?.CONVEX_AGENT_MODE;
+	const runCommand = async (commandArgs) => normalizeConvexCommandResult(await params.execaFn(params.backendAdapter.command, commandArgs, {
 		cwd: process.cwd(),
 		env: createBackendCommandEnv({
 			...params.env,
@@ -14374,6 +14374,24 @@ async function runConvexInitIfNeeded(params) {
 		reject: false,
 		stdio: "pipe"
 	}));
+	let result = await runCommand([
+		...params.backendAdapter.argsPrefix,
+		"init",
+		...params.targetArgs ?? []
+	]);
+	if (shouldUseLocalDevPreflight && result.exitCode !== 0 && isLocalBackendUpgradePrompt(`${result.stdout}\n${result.stderr}`)) result = await runCommand([
+		...params.backendAdapter.argsPrefix,
+		"dev",
+		"--local",
+		"--once",
+		"--skip-push",
+		"--local-force-upgrade",
+		"--typecheck",
+		"disable",
+		"--codegen",
+		"disable",
+		...params.targetArgs ?? []
+	]);
 	if (params.echoOutput !== false || result.exitCode !== 0) writeConvexCommandOutput(result);
 	return {
 		created: didConvexInitCreateConfiguration(`${result.stdout}\n${result.stderr}`),

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { $ as resolveAddTemplateDefaults, A as resolveConfiguredBackend, B as runConvexInitIfNeeded, C as isInitialized, D as readPackageVersions, E as parseInitCommandArgs, Et as highlighter, F as runAfterScaffoldScript, G as trackProcess, H as runInitCommandFlow, I as runAggregateBackfillFlow, J as createSpinner, K as withLocalCodegenEnv, L as runAggregatePruneFlow, M as resolveInitProjectDir, N as resolveMigrationConfig, O as resolveBackfillConfig, P as resolveRunDeps, Q as promptForScaffoldTemplateSelection, R as runBackendFunction, S as isEntryPoint, St as stripConvexCommandNoise, T as parseBackendRunJson, Tt as logger, U as runMigrationCreate, V as runDevSchemaBackfillIfNeeded, W as runMigrationFlow, X as filterScaffoldTemplatePathMap, Y as collectPluginScaffoldTemplates, Z as promptForPluginSelection, _ as formatInfoOutput, _t as applyPluginDependencyInstall, a as cleanup, at as getSupportedPluginKeys, b as hasRemoteConvexDeploymentEnv, bt as resolveAuthEnvState, c as createCommandEnv, ct as resolvePluginScaffoldRoots, d as extractBackfillCliOptions, dt as getPluginLockfilePath, et as resolvePluginPreset, f as extractConcaveRunTargetArgs, ft as getSchemaFilePath, g as formatDocsOutput, gt as applyPlanningDependencyInstall, h as extractResetCliOptions, ht as applyDependencyHintsInstall, i as buildInitializationPlan, it as getPluginCatalogEntry, j as resolveDocTopic, k as resolveCodegenTrimSegments, l as ensureConvexGitignoreEntry, lt as assertSchemaFileExists, m as extractMigrationDownOptions, mt as resolveSchemaInstalledPlugins, n as applyPluginInstallPlanFiles, nt as resolveTemplateSelectionSource, o as createBackendAdapter, ot as isSupportedPluginKey, p as extractMigrationCliOptions, pt as readPluginLockfile, q as withWorkingDirectory, r as assertNoRemovedDevPreRunFlag, rt as resolveTemplatesByIdOrThrow, s as createBackendCommandEnv, st as buildPluginInstallPlan, t as applyDependencyInstallPlan, tt as resolvePresetScaffoldTemplates, u as extractBackendRunTargetArgs, ut as collectInstalledPluginKeys, v as getAggregateBackfillDeploymentKey, vt as inspectPluginDependencyInstall, w as parseArgs, x as isConvexDevPreRunConflictFlag, xt as serializeEnvValue, y as getDevAggregateBackfillStatePath, yt as resolveProjectScaffoldContext, z as runConfiguredCodegen } from "./backend-core-C0uwGXLx.mjs";
+import { $ as resolveAddTemplateDefaults, A as resolveConfiguredBackend, B as runConvexInitIfNeeded, C as isInitialized, D as readPackageVersions, E as parseInitCommandArgs, Et as highlighter, F as runAfterScaffoldScript, G as trackProcess, H as runInitCommandFlow, I as runAggregateBackfillFlow, J as createSpinner, K as withLocalCodegenEnv, L as runAggregatePruneFlow, M as resolveInitProjectDir, N as resolveMigrationConfig, O as resolveBackfillConfig, P as resolveRunDeps, Q as promptForScaffoldTemplateSelection, R as runBackendFunction, S as isEntryPoint, St as stripConvexCommandNoise, T as parseBackendRunJson, Tt as logger, U as runMigrationCreate, V as runDevSchemaBackfillIfNeeded, W as runMigrationFlow, X as filterScaffoldTemplatePathMap, Y as collectPluginScaffoldTemplates, Z as promptForPluginSelection, _ as formatInfoOutput, _t as applyPluginDependencyInstall, a as cleanup, at as getSupportedPluginKeys, b as hasRemoteConvexDeploymentEnv, bt as resolveAuthEnvState, c as createCommandEnv, ct as resolvePluginScaffoldRoots, d as extractBackfillCliOptions, dt as getPluginLockfilePath, et as resolvePluginPreset, f as extractConcaveRunTargetArgs, ft as getSchemaFilePath, g as formatDocsOutput, gt as applyPlanningDependencyInstall, h as extractResetCliOptions, ht as applyDependencyHintsInstall, i as buildInitializationPlan, it as getPluginCatalogEntry, j as resolveDocTopic, k as resolveCodegenTrimSegments, l as ensureConvexGitignoreEntry, lt as assertSchemaFileExists, m as extractMigrationDownOptions, mt as resolveSchemaInstalledPlugins, n as applyPluginInstallPlanFiles, nt as resolveTemplateSelectionSource, o as createBackendAdapter, ot as isSupportedPluginKey, p as extractMigrationCliOptions, pt as readPluginLockfile, q as withWorkingDirectory, r as assertNoRemovedDevPreRunFlag, rt as resolveTemplatesByIdOrThrow, s as createBackendCommandEnv, st as buildPluginInstallPlan, t as applyDependencyInstallPlan, tt as resolvePresetScaffoldTemplates, u as extractBackendRunTargetArgs, ut as collectInstalledPluginKeys, v as getAggregateBackfillDeploymentKey, vt as inspectPluginDependencyInstall, w as parseArgs, x as isConvexDevPreRunConflictFlag, xt as serializeEnvValue, y as getDevAggregateBackfillStatePath, yt as resolveProjectScaffoldContext, z as runConfiguredCodegen } from "./backend-core-DBBEoGeA.mjs";
 import fs, { existsSync, readFileSync } from "node:fs";
 import path, { delimiter, dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";

package/dist/watcher.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { A as resolveConfiguredBackend, Ct as generateMeta, K as withLocalCodegenEnv, P as resolveRunDeps, Tt as logger, wt as getConvexConfig } from "./backend-core-C0uwGXLx.mjs";
+import { A as resolveConfiguredBackend, Ct as generateMeta, K as withLocalCodegenEnv, P as resolveRunDeps, Tt as logger, wt as getConvexConfig } from "./backend-core-DBBEoGeA.mjs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 

package/package.json

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

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

@@ -203,13 +203,16 @@ Local Convex:
 2. While `kitcn dev` is running on backend `convex`, later edits to `convex/.env` auto-sync.
 3. For the normal local path, `SITE_URL` should stay on `http://localhost:3000`.
 
-Remote / repair:
+Convex remote / repair:
 1. Use `npx kitcn env push` when the target deployment is already active.
 2. Use `npx kitcn env push --prod` for production sync.
-3. Use `npx kitcn auth jwks` when you need a manual static `JWKS` payload, including backend `concave`.
+3. Use `npx kitcn env push --rotate` when you want fresh keys plus fresh `JWKS`.
+4. `kitcn env push` writes deployment env for you. No manual copy step.
 
-Key rotation: `npx kitcn env push --rotate` (invalidates all tokens).
-Manual rotation/export: `npx kitcn auth jwks --rotate`.
+Concave manual lane:
+1. Use `npx kitcn --backend concave auth jwks` when you need a manual static `JWKS` payload.
+2. Use `npx kitcn --backend concave auth jwks --rotate` when you need rotation plus export.
+3. `kitcn auth jwks` only prints `JWKS=...`. Save that value into env yourself.
 
 ---
 

package/skills/convex/references/setup/auth.md

@@ -256,6 +256,8 @@ GOOGLE_CLIENT_ID=...
 GOOGLE_CLIENT_SECRET=...
 ```
 
+### Convex lane
+
 Local Convex:
 
 ```bash
@@ -277,25 +279,33 @@ Use this to sync static `JWKS` onto the target deployment too.
 ```bash
 bunx kitcn env push --prod
 bunx kitcn env push --rotate
-
-# Manual static JWKS payload, including backend concave
-bunx kitcn auth jwks
-bunx kitcn auth jwks --rotate
 ```
 
 Use `--prod` for production and `--rotate` when you want fresh keys plus fresh
-`JWKS`. `kitcn auth jwks` prints a manual `JWKS=...` line when you need to set
-the env value yourself instead of using `env push`. See `/docs/cli/backend#env`
-and `/docs/cli/backend#auth` for the full command surface.
+`JWKS`.
+
+`kitcn env push` writes the target deployment env for you. No manual copy step.
+
+### Concave lane
 
-Rotate later:
+Concave has no `kitcn env` wrapper. Export a manual `JWKS=...` line from the
+target backend, then set that env manually:
 
 ```bash
-bunx kitcn env push --rotate
+bunx kitcn --backend concave auth jwks --url http://localhost:3210
+bunx kitcn --backend concave auth jwks --rotate --url http://localhost:3210
 ```
 
+Use `--url`, `--port`, or `--component` to target the right Concave runtime.
+See `/docs/cli/backend#env` and `/docs/cli/backend#auth` for the full command
+surface.
+
+`kitcn auth jwks` only prints `JWKS=...`. Save that value into env yourself.
+
 ### 6.7 Production bootstrap notes
 
+#### Convex lane
+
 First prod deploy requires JWKS initialization:
 
 ```bash
@@ -303,6 +313,17 @@ bunx convex deploy --prod
 bunx kitcn env push --prod
 ```
 
+#### Concave lane
+
+Concave has no `kitcn env push --prod` flow. Export a static JWKS payload from
+the deployed backend, then set the printed `JWKS=...` line manually:
+
+```bash
+bunx kitcn --backend concave auth jwks --url https://your-concave-backend.example.com
+```
+
+Again: printed payload only. You still need to set the env manually.
+
 ### 6.9 Upgrade `convex/lib/crpc.ts` to auth-aware builders (only after Section 11.2 passes)
 
 After non-auth baseline is green, replace `convex/lib/crpc.ts` with this auth-aware variant:

package/skills/convex/references/setup/index.md

@@ -602,6 +602,8 @@ app owns an `init.ts` preflight.
 
 CLI commands:
 
+Convex lane:
+
 ```bash
 bunx kitcn dev
 # deterministic one-shot local runtime proof:
@@ -623,11 +625,19 @@ bunx kitcn aggregate backfill --prod
 bunx kitcn analyze
 ```
 
+Concave lane:
+
+```bash
+bunx kitcn --backend concave auth jwks --url http://localhost:3210
+bunx kitcn --backend concave auth jwks --rotate --url http://localhost:3210
+```
+
 On backend `convex`, `kitcn dev` watches `convex/.env` during a local
 dev session and auto-pushes later edits. Keep `env push` for `--prod`,
-`--rotate`, or explicit repair against an already active deployment. Use
-`auth jwks` when you need a manual static `JWKS` payload, especially on backend
-`concave`.
+`--rotate`, or explicit repair against an already active deployment.
+
+On backend `concave`, `kitcn env` is not the right seam. Use `auth jwks`
+for manual static `JWKS` export instead.
 
 ### 11.2 Phase A gate: non-auth baseline (required before auth work)
 

package/skills/convex/references/setup/start.md

@@ -3,6 +3,10 @@
 CLI-first flow: scaffold the app, run `kitcn add auth --yes`, then treat the
 files below as the generated reference output. They are not a separate manual
 install path.
+
+After changing plugins or auth fields in `<functionsDir>/auth.ts`, refresh
+auth-owned schema blocks with `bunx kitcn add auth --schema --yes`. Keep
+`bunx kitcn dev` running as the local Convex + codegen loop.
 ### 8.B.1 Auth client + auth server helpers
 
 **Create:** `src/lib/convex/auth-client.ts`