kizlo 0.9.0 → 0.10.0

package/dist/cli/utils.js

@@ -229,37 +229,59 @@ function envKeysPresent(contents, keys) {
 	return keys.filter((key) => new RegExp(`^\\s*${key}\\s*=`, "m").test(contents));
 }
 /**
+* The built-in key names, used by the generic `base` preset (no template, no separately-pinned
+* runtime) and as the fallback when a template's manifest declares no `env` section (in-repo before the
+* first stamped release). Real templates carry their own `env`, so this is the standard `KIZLO_*` set.
+*/
+const DEFAULT_ENV_KEYS = {
+	baseUrl: "KIZLO_API_URL",
+	remote: {
+		siteSecret: "KIZLO_WP_SECRET",
+		wpUrl: "KIZLO_WP_URL",
+		wpUsername: "KIZLO_WP_USERNAME",
+		wpPassword: "KIZLO_WP_APP_PASSWORD"
+	},
+	local: {
+		connect: "KIZLO_CONNECT",
+		siteSecret: "KIZLO_LOCAL_WP_SECRET",
+		wpUrl: "KIZLO_LOCAL_WP_URL",
+		wpUsername: "KIZLO_LOCAL_WP_USERNAME",
+		wpPassword: "KIZLO_LOCAL_WP_APP_PASSWORD"
+	}
+};
+/**
 * The grouped `.env` layout shared by `init` and `dev`, so both write the same sectioned file:
-* a target switch, the backend URL, then the production and dev connection blocks. `baseUrlEnvKey`
-* varies per preset (e.g. `NEXT_PUBLIC_KIZLO_BACKEND_URL`), so it's threaded in. Only sections whose
-* keys are actually being appended get a header, so a remote/prod run skips the dev block and vice versa.
+* a connect switch, the API URL, then the remote and local connection blocks. The key names come from
+* the resolved {@link EnvKeys} (the template's `env` contract), so the sections stay labelled correctly
+* whatever a template calls them. Only sections whose keys are actually being appended get a header, so
+* a remote run skips the local block and vice versa.
 */
-function envGroups(baseUrlEnvKey) {
+function envGroups(envKeys) {
 	return [
 		{
-			comment: "Kizlo Target (dev | prod)",
-			keys: ["KIZLO_TARGET"]
+			comment: "Kizlo Connect (local | remote)",
+			keys: [envKeys.local.connect]
 		},
 		{
-			comment: "Kizlo Backend URL",
-			keys: [baseUrlEnvKey]
+			comment: "Kizlo API URL",
+			keys: [envKeys.baseUrl]
 		},
 		{
-			comment: "Kizlo Production Env",
+			comment: "Kizlo Remote",
 			keys: [
-				"KIZLO_SITE_SECRET",
-				"KIZLO_WORDPRESS_URL",
-				"KIZLO_WORDPRESS_USERNAME",
-				"KIZLO_WORDPRESS_APPLICATION_PASSWORD"
+				envKeys.remote.siteSecret,
+				envKeys.remote.wpUrl,
+				envKeys.remote.wpUsername,
+				envKeys.remote.wpPassword
 			]
 		},
 		{
-			comment: "Kizlo Development Env",
+			comment: "Kizlo Local",
 			keys: [
-				"KIZLO_DEV_SITE_SECRET",
-				"KIZLO_DEV_WORDPRESS_URL",
-				"KIZLO_DEV_WORDPRESS_USERNAME",
-				"KIZLO_DEV_WORDPRESS_APPLICATION_PASSWORD"
+				envKeys.local.siteSecret,
+				envKeys.local.wpUrl,
+				envKeys.local.wpUsername,
+				envKeys.local.wpPassword
 			]
 		}
 	];
@@ -354,4 +376,4 @@ function groupDefault(subCommandNames, run) {
 }
 
 //#endregion
-export { addDependencyArgs, availablePackageManagers, detectImportAlias, detectInvokingPackageManager, detectPackageManager, ensureGitignored, envGroups, envKeysPresent, frameworkCreateArgs, getVersion, groupDefault, installArgs, loadEnvFiles, mergeEnv, pickStackPort, resolveModuleImport, runCommandAsync, runCommandCaptured, withSpinner, writeFileIfAbsent };
+export { DEFAULT_ENV_KEYS, addDependencyArgs, availablePackageManagers, detectImportAlias, detectInvokingPackageManager, detectPackageManager, ensureGitignored, envGroups, envKeysPresent, frameworkCreateArgs, getVersion, groupDefault, installArgs, loadEnvFiles, mergeEnv, pickStackPort, resolveModuleImport, runCommandAsync, runCommandCaptured, withSpinner, writeFileIfAbsent };

package/dist/cli/wp/compose/override.js

@@ -3,10 +3,10 @@ import { basename, dirname, isAbsolute, resolve } from "node:path";
 import { mkdirSync, writeFileSync } from "node:fs";
 
 //#region src/cli/wp/compose/override.ts
-/** Generated dev override location, relative to the config root. */
-const OVERRIDE_REL = ".kizlo/docker-compose.dev.override.yml";
+/** Generated local WordPress override location, relative to the config root. */
+const OVERRIDE_REL = ".kizlo/compose.local.yml";
 /** Generated test override location (plugin mounts only), relative to the config root. */
-const TEST_OVERRIDE_REL = ".kizlo/docker-compose.test.override.yml";
+const TEST_OVERRIDE_REL = ".kizlo/compose.test.yml";
 const WP_ROOT = "/var/www/html";
 const PLUGINS_DIR = `${WP_ROOT}/wp-content/plugins`;
 /** Where the dev OPcache config is dropped so the container's PHP picks it up. */

package/dist/cli/wp/compose/override.test.ts

@@ -20,7 +20,7 @@ describe("writeDevOverride", () => {
 
 	test("bind-mounts the whole install on both services and creates the host dir", () => {
 		const file = writeDevOverride(dir, { wordpressDir, mounts: [] })
-		expect(file).toBe(path.join(dir, ".kizlo", "docker-compose.dev.override.yml"))
+		expect(file).toBe(path.join(dir, ".kizlo", "compose.local.yml"))
 		expect(fs.existsSync(wordpressDir)).toBe(true)
 
 		const body = fs.readFileSync(file, "utf8")
@@ -89,7 +89,7 @@ describe("writeTestOverride", () => {
 
 	test("mounts local plugin dirs by basename on both services", () => {
 		const file = writeTestOverride(dir, ["plugins/kizlo-woocommerce"])
-		expect(file).toBe(path.join(dir, ".kizlo", "docker-compose.test.override.yml"))
+		expect(file).toBe(path.join(dir, ".kizlo", "compose.test.yml"))
 
 		const body = fs.readFileSync(file, "utf8")
 		const pluginBind = `- "${path.join(dir, "plugins/kizlo-woocommerce")}:/var/www/html/wp-content/plugins/kizlo-woocommerce"`

package/dist/cli/wp/compose/override.ts

@@ -2,10 +2,10 @@ import { mkdirSync, writeFileSync } from "node:fs"
 import { basename, dirname, isAbsolute, resolve } from "node:path"
 import { OPCACHE_INI, REMAP_ENTRYPOINT } from "../constants"
 
-/** Generated dev override location, relative to the config root. */
-const OVERRIDE_REL = ".kizlo/docker-compose.dev.override.yml"
+/** Generated local WordPress override location, relative to the config root. */
+const OVERRIDE_REL = ".kizlo/compose.local.yml"
 /** Generated test override location (plugin mounts only), relative to the config root. */
-const TEST_OVERRIDE_REL = ".kizlo/docker-compose.test.override.yml"
+const TEST_OVERRIDE_REL = ".kizlo/compose.test.yml"
 
 const WP_ROOT = "/var/www/html"
 const PLUGINS_DIR = `${WP_ROOT}/wp-content/plugins`

package/dist/cli/wp/constants.d.ts

@@ -12,13 +12,19 @@ declare function githubRelease(repo: string, tag: string): string;
 declare function kizloRelease(slug: string): string;
 /** The docker-compose file shipped alongside this module (in both `src/` and `dist/`). */
 declare const COMPOSE_FILE: string;
-/** Dev PHP OPcache config, shipped alongside this module and bind-mounted into the dev stack. */
+/** PHP OPcache config, shipped alongside this module and bind-mounted into the local WordPress. */
 declare const OPCACHE_INI: string;
 /** Linux-only entrypoint that retags www-data to the host user (see the script for why). */
 declare const REMAP_ENTRYPOINT: string;
 declare const CONFIG_FILES: string[];
-/** Credentials artifact location, relative to the config root. */
-declare const CREDENTIALS_REL = ".kizlo/test-credentials.json";
+/** Test connection artifact location, relative to the config root. */
+declare const CREDENTIALS_REL = ".kizlo/test.json";
+/**
+ * Fixed folder the local WordPress install lives in, relative to the config root. The whole install
+ * (core, themes, uploads, plugins) is bind-mounted here; `kizlo dev reset` wipes it. It sits under
+ * `.kizlo/` — the single gitignored working dir — so there's no folder to choose or configure.
+ */
+declare const LOCAL_DIR_REL = ".kizlo/local";
 /**
  * DB-side marker written as the final bootstrap step and checked by `isSeeded`.
  * It records that this database holds a completed bootstrap — independent of any
@@ -32,4 +38,4 @@ declare const DEFAULT_PLUGINS: PluginSource[];
 declare const TEST_ADMIN: Omit<TestAdminUser, "id" | "applicationPassword">;
 declare const TEST_USER: Omit<TestUser, "id">;
 //#endregion
-export { COMPOSE_FILE, CONFIG_FILES, CREDENTIALS_REL, DEFAULT_PLUGINS, DEFAULT_PORT, OPCACHE_INI, REMAP_ENTRYPOINT, SEED_MARKER_OPTION, SEED_VERSION, TEST_ADMIN, TEST_USER, githubRelease, kizloRelease };
+export { COMPOSE_FILE, CONFIG_FILES, CREDENTIALS_REL, DEFAULT_PLUGINS, DEFAULT_PORT, LOCAL_DIR_REL, OPCACHE_INI, REMAP_ENTRYPOINT, SEED_MARKER_OPTION, SEED_VERSION, TEST_ADMIN, TEST_USER, githubRelease, kizloRelease };

package/dist/cli/wp/constants.js

@@ -18,7 +18,7 @@ function kizloRelease(slug) {
 const HERE = dirname(fileURLToPath(import.meta.url));
 /** The docker-compose file shipped alongside this module (in both `src/` and `dist/`). */
 const COMPOSE_FILE = resolve(HERE, "compose/docker-compose.yml");
-/** Dev PHP OPcache config, shipped alongside this module and bind-mounted into the dev stack. */
+/** PHP OPcache config, shipped alongside this module and bind-mounted into the local WordPress. */
 const OPCACHE_INI = resolve(HERE, "compose/opcache.ini");
 /** Linux-only entrypoint that retags www-data to the host user (see the script for why). */
 const REMAP_ENTRYPOINT = resolve(HERE, "compose/remap-entrypoint.sh");
@@ -27,8 +27,14 @@ const CONFIG_FILES = [
 	"kizlo.config.js",
 	"kizlo.config.mjs"
 ];
-/** Credentials artifact location, relative to the config root. */
-const CREDENTIALS_REL = ".kizlo/test-credentials.json";
+/** Test connection artifact location, relative to the config root. */
+const CREDENTIALS_REL = ".kizlo/test.json";
+/**
+* Fixed folder the local WordPress install lives in, relative to the config root. The whole install
+* (core, themes, uploads, plugins) is bind-mounted here; `kizlo dev reset` wipes it. It sits under
+* `.kizlo/` — the single gitignored working dir — so there's no folder to choose or configure.
+*/
+const LOCAL_DIR_REL = ".kizlo/local";
 /**
 * DB-side marker written as the final bootstrap step and checked by `isSeeded`.
 * It records that this database holds a completed bootstrap — independent of any
@@ -59,4 +65,4 @@ const TEST_USER = {
 };
 
 //#endregion
-export { COMPOSE_FILE, CONFIG_FILES, CREDENTIALS_REL, DEFAULT_PLUGINS, DEFAULT_PORT, OPCACHE_INI, REMAP_ENTRYPOINT, SEED_MARKER_OPTION, SEED_VERSION, TEST_ADMIN, TEST_USER, githubRelease, kizloRelease };
+export { COMPOSE_FILE, CONFIG_FILES, CREDENTIALS_REL, DEFAULT_PLUGINS, DEFAULT_PORT, LOCAL_DIR_REL, OPCACHE_INI, REMAP_ENTRYPOINT, SEED_MARKER_OPTION, SEED_VERSION, TEST_ADMIN, TEST_USER, githubRelease, kizloRelease };

package/dist/cli/wp/dev.js

@@ -3,9 +3,8 @@ import { DEFAULT_PLUGINS, TEST_ADMIN } from "./constants.js";
 import { compose, composePull, composeUp, wpCli } from "./docker.js";
 import { ensurePlugins } from "./utils.js";
 import { createAdminAppPassword, seedUsers } from "./bootstrap.js";
-import { prepareByo } from "./byo.js";
 import { join } from "node:path";
-import { existsSync, rmSync } from "node:fs";
+import { existsSync } from "node:fs";
 import { networkInterfaces } from "node:os";
 import { randomBytes } from "node:crypto";
 
@@ -19,7 +18,7 @@ function lanAddress() {
 	for (const ifaces of Object.values(networkInterfaces())) for (const iface of ifaces ?? []) if (iface.family === "IPv4" && !iface.internal) return iface.address;
 }
 /**
-* The URL the dev stack is provisioned at. We prefer the router-assigned LAN address over `localhost`
+* The URL local WordPress is provisioned at. We prefer the router-assigned LAN address over `localhost`
 * so it's reachable from off the host (the app in a container or on another device). Serving WordPress
 * under the request host is already handled by the container's `WORDPRESS_CONFIG_EXTRA` (it derives
 * `WP_HOME`/`WP_SITEURL` from `HTTP_HOST` per request), so this is only the address we write into `.env`
@@ -29,7 +28,7 @@ function devUrl(port) {
 	return `http://${lanAddress() ?? "localhost"}:${port}`;
 }
 /**
-* Seed `dev.fixtures` into a freshly installed dev stack, reusing the test seeding
+* Seed `dev.fixtures` into freshly installed local WordPress, reusing the test seeding
 * primitives: seed the default subscriber so `ctx.userId` exists, then run each `seed`
 * over REST. Plugins are already active (`bootstrapDev` ensures them before seeding).
 * The application password is minted only to drive seeding here — it's never printed
@@ -61,22 +60,18 @@ async function seedDevFixtures(cfg, url) {
 	return seeded;
 }
 /**
-* Boot the dev stack via docker + wp-cli. A fresh stack is provisioned one of two ways:
-* a default `wp core install`, or — when `dev.byo` points at an archive — hydrated from
-* that existing site (files + database). Either way it then sets permalinks and ensures
-* the `dev.fixtures` plugins (installed sources + bind-mounted locals). An already-provisioned
-* stack is left untouched (idempotent reruns).
+* Boot local WordPress via docker + wp-cli. A fresh install is provisioned with a default
+* `wp core install`, then sets permalinks and ensures the `dev.fixtures` plugins (installed
+* sources + bind-mounted locals). An already-provisioned install is left untouched
+* (idempotent reruns).
 *
-* Credentials are an output, not a stored file: a default fresh install mints a random
-* admin password and returns it once (to log into wp-admin); a BYO install uses the
-* imported site's own users. No application password is minted — that's a test-stack
-* concern.
+* Credentials are an output, not a stored file: a fresh install mints a random admin
+* password and returns it once (to log into wp-admin). No application password is minted —
+* that's a test concern.
 */
 async function bootstrapDev(cfg) {
 	const url = devUrl(cfg.port);
-	const fresh = !existsSync(join(cfg.wordpressDir, "wp-includes", "version.php"));
-	const byo = fresh && cfg.byo ? await prepareByo(cfg.byo, cfg.wordpressDir, cfg.configDir) : void 0;
-	if (fresh && !byo) await composePull(["wordpress", "wp-cli"]).catch(() => void 0);
+	if (!existsSync(join(cfg.wordpressDir, "wp-includes", "version.php"))) await composePull(["wordpress", "wp-cli"]).catch(() => void 0);
 	await composeUp();
 	const installed = (await compose([
 		"exec",
@@ -87,46 +82,7 @@ async function bootstrapDev(cfg) {
 		"is-installed"
 	])).code === 0;
 	let password;
-	let imported = false;
-	if (!installed && byo) {
-		imported = true;
-		if (byo.prefix !== "wp_") await wpCli([
-			"config",
-			"set",
-			"table_prefix",
-			byo.prefix,
-			"--type=variable"
-		]);
-		const imp = await compose([
-			"exec",
-			"-T",
-			"mysql",
-			"mysql",
-			"-uwordpress",
-			"-pwppass",
-			"wordpress"
-		], { inputFile: byo.sqlPath });
-		if (imp.code !== 0) throw new Error(`importing dev.byo database failed:\n${imp.stderr || imp.stdout}`);
-		rmSync(byo.sqlPath, { force: true });
-		const oldUrl = await wpCli([
-			"option",
-			"get",
-			"siteurl"
-		]).catch(() => "");
-		if (oldUrl && oldUrl !== url) await wpCli([
-			"search-replace",
-			oldUrl,
-			url,
-			"--all-tables",
-			"--skip-columns=guid",
-			"--report-changed-only"
-		]);
-		await wpCli([
-			"rewrite",
-			"flush",
-			"--hard"
-		]);
-	} else if (!installed) {
+	if (!installed) {
 		password = generatePassword();
 		await wpCli([
 			"core",
@@ -146,13 +102,12 @@ async function bootstrapDev(cfg) {
 		]);
 	}
 	await ensurePlugins([...DEFAULT_PLUGINS, ...cfg.fixtures.flatMap((fixture) => fixture.plugins ?? [])]);
-	const seeded = !installed && !byo && cfg.fixtures.length ? await seedDevFixtures(cfg, url) : 0;
+	const seeded = !installed && cfg.fixtures.length ? await seedDevFixtures(cfg, url) : 0;
 	const appPassword = password ? await createAdminAppPassword("kizlo-dev") : void 0;
 	return {
 		url,
 		username: TEST_ADMIN.username,
 		dbPort: cfg.dbPort,
-		imported,
 		seeded,
 		appPassword,
 		secrets: password ? { password } : void 0

package/dist/cli/wp/docker.d.ts

@@ -41,10 +41,22 @@ interface RunResult {
   stderr: string;
 }
 /**
- * Whether the Docker daemon is reachable. `docker version` contacts the server (not just
- * the client), so a non-zero exit means the daemon is down or Docker isn't installed —
- * the early check before a command that needs a stack (e.g. `init`'s local setup).
+ * Docker's readiness in three states, so callers can tell "not installed" from "installed but not
+ * running" and say the right thing:
+ * - `missing` — the `docker` binary isn't on PATH (`docker --version` errors).
+ * - `stopped` — the client is installed but the daemon is unreachable (`docker version` fails).
+ * - `running` — the daemon answered, so a stack can boot.
  */
+type DockerStatus = "missing" | "stopped" | "running";
+/**
+ * Probe Docker in two steps: `docker --version` only touches the client (is it installed?), then
+ * `docker version` contacts the server (is the daemon up?). Used before any command that needs local
+ * WordPress, so the caller can distinguish an install problem from a "start Docker" problem.
+ */
+declare function dockerStatus(): Promise<DockerStatus>;
+/** The one-line fix to print when Docker isn't ready — install it, or start the daemon. */
+declare function dockerHint(status: "missing" | "stopped"): string;
+/** Whether the Docker daemon is reachable — the early check before a command that needs a stack. */
 declare function dockerAvailable(): Promise<boolean>;
 /** Build a stack-bound docker helper and mark it active for the bare helpers below. */
 declare function createStack(stack: Stack): DockerStack;
@@ -65,4 +77,4 @@ declare const composeStop: (opts?: {
 /** Run a wp-cli command against the active stack's warm `wp-cli` container. */
 declare const wpCli: (args: string[]) => Promise<string>;
 //#endregion
-export { DockerStack, RunResult, Stack, compose, composeDown, composePull, composeStop, composeUp, createStack, dockerAvailable, wpCli };
+export { DockerStack, DockerStatus, RunResult, Stack, compose, composeDown, composePull, composeStop, composeUp, createStack, dockerAvailable, dockerHint, dockerStatus, wpCli };

package/dist/cli/wp/docker.js

@@ -33,17 +33,30 @@ function run(cmd, args, env, opts) {
 	});
 }
 /**
-* Whether the Docker daemon is reachable. `docker version` contacts the server (not just
-* the client), so a non-zero exit means the daemon is down or Docker isn't installed —
-* the early check before a command that needs a stack (e.g. `init`'s local setup).
+* Probe Docker in two steps: `docker --version` only touches the client (is it installed?), then
+* `docker version` contacts the server (is the daemon up?). Used before any command that needs local
+* WordPress, so the caller can distinguish an install problem from a "start Docker" problem.
 */
-async function dockerAvailable() {
+async function dockerStatus() {
+	try {
+		if ((await run("docker", ["--version"], process.env)).code !== 0) return "missing";
+	} catch {
+		return "missing";
+	}
 	try {
-		return (await run("docker", ["version"], process.env)).code === 0;
+		return (await run("docker", ["version"], process.env)).code === 0 ? "running" : "stopped";
 	} catch {
-		return false;
+		return "stopped";
 	}
 }
+/** The one-line fix to print when Docker isn't ready — install it, or start the daemon. */
+function dockerHint(status) {
+	return status === "missing" ? "Docker isn't installed. Install it from https://docs.docker.com/get-docker/, then re-run." : "Docker is installed but not running. Start Docker (Docker Desktop, or `sudo systemctl start docker`) and re-run.";
+}
+/** Whether the Docker daemon is reachable — the early check before a command that needs a stack. */
+async function dockerAvailable() {
+	return await dockerStatus() === "running";
+}
 function bind(stack) {
 	const base = [
 		"compose",
@@ -131,4 +144,4 @@ const composeStop = (opts) => activeStack().composeStop(opts);
 const wpCli = (args) => activeStack().wpCli(args);
 
 //#endregion
-export { compose, composeDown, composePull, composeStop, composeUp, createStack, dockerAvailable, wpCli };
+export { compose, composeDown, composePull, composeStop, composeUp, createStack, dockerAvailable, dockerHint, dockerStatus, wpCli };

package/dist/cli/wp/settings.js

@@ -18,7 +18,7 @@ function originOf(url) {
 	}
 }
 /**
-* Rewrite a loopback host to `host.docker.internal` so the dockerized WordPress dev stack can reach a
+* Rewrite a loopback host to `host.docker.internal` so the dockerized local WordPress can reach a
 * Kizlo server on the host (the container's own `localhost` is not the host). Non-loopback hosts (real
 * deployments) and unparseable URLs are returned unchanged.
 */

package/dist/cli/wp/setup.js

@@ -8,7 +8,7 @@ import { mkdirSync, writeFileSync } from "node:fs";
 /**
 * Phase 2 — after bootstrap, build a `SeedContext` and run each `Fixture.seed`
 * over REST, collecting namespaced fixtures, then write the credentials artifact
-* at `<config-dir>/.kizlo/test-credentials.json`. Returns a teardown that runs
+* at `<config-dir>/.kizlo/test.json`. Returns a teardown that runs
 * each fixture's `cleanup`.
 */
 async function runSeeds(config) {

package/dist/cli/wp/stack.js

@@ -10,7 +10,7 @@ function localMounts(fixtures) {
 /**
 * The test stack: the base compose file under a `<name>-test` project, plus a generated
 * mount override when any fixture carries a local (`{ path }`) plugin — so the same
-* fixtures bind-mount their live plugin source here exactly as in the dev stack.
+* fixtures bind-mount their live plugin source here exactly as in local WordPress.
 */
 function testStack(cfg) {
 	const mounts = localMounts(cfg.fixtures);
@@ -36,9 +36,9 @@ function detectHostUser() {
 	};
 }
 /**
-* The dev stack: the base compose file plus the generated mount override, under a
-* `<name>-dev` project. Building the stack (re)writes the override so it always
-* matches the current `dev.path` and the `dev.fixtures` local plugins.
+* Local WordPress: the base compose file plus the generated mount override, under a
+* `<name>-dev` project. Building it (re)writes the override so it always matches the
+* install folder (`.kizlo/local`) and the `dev.fixtures` local plugins.
 */
 function devStack(cfg) {
 	const override = writeDevOverride(cfg.configDir, {

package/dist/config.d.ts

@@ -4,44 +4,41 @@ import "./test.js";
 //#region src/config.d.ts
 interface KizloDevConfig {
   /**
-   * Folder where your local WordPress install lives, relative to the config dir.
-   * The entire install (core, themes, uploads, plugins) is bind-mounted here, so
-   * you browse and edit every file from your file manager and your changes are
-   * live. This is your persistent dev site — pick a real, visible folder (e.g.
-   * `"wordpress"`), not a hidden one, and don't delete it. `reset` wipes it.
+   * Run local WordPress under `kizlo dev`. When `true`, `kizlo dev` boots a Docker WordPress in
+   * `.kizlo/local` alongside the contract watcher; when unset or `false`, it runs the watcher alone
+   * (for a project pointing at your own WordPress). Set for you by `kizlo create` / `kizlo init`
+   * when you choose local WordPress.
    */
-  path: string;
+  local?: boolean;
   /** Published WP port (default 8080). */
   port?: number;
   /**
-   * Adopt an existing WordPress site instead of provisioning a blank one. Points at a
-   * `.tar.gz` archive (path relative to the config dir) whose root holds a `wordpress/`
-   * directory (the install) and a single `.sql` dump (the database). Applied when the
-   * stack is fresh — the first `kizlo dev`, or after a `kizlo dev reset` — and ignored
-   * once the stack is provisioned. Keep the archive outside `path` (reset wipes that).
-   */
-  byo?: string;
-  /**
-   * Host port the dev MySQL is published on (default 3307), bound to `127.0.0.1` so
+   * Host port the local WordPress MySQL is published on (default 3307), bound to `127.0.0.1` so
    * you can point a SQL client (TablePlus, DBeaver, `mysql`) at the database to
    * inspect or edit tables directly. Connect with db `wordpress`, user `wordpress`,
-   * password `wppass`. Pick a port that's free — change it if you run multiple stacks
+   * password `wppass`. Pick a port that's free — change it if you run multiple projects
    * or already have MySQL on the default.
    */
   dbPort?: number;
   /**
-   * Code-defined seed data for a **fresh** dev stack — the same {@link Fixture}s the
-   * test stack uses, so you can populate your dev site from versioned code instead of a
+   * Code-defined seed data for a **fresh** local WordPress — the same {@link Fixture}s the
+   * test environment uses, so you can populate your local site from versioned code instead of a
    * blank install. Each fixture also declares the plugins it needs — wp.org slugs / zip
    * sources to install, or `{ path }` local directories bind-mounted live so your edits
-   * show up without a reinstall — which the dev stack ensures every run. Each fixture's
+   * show up without a reinstall — which `kizlo dev` ensures every run. Each fixture's
    * `seed` runs once over REST (and may drop to wp-cli) on the first `kizlo dev` and
-   * after `kizlo dev reset`; existing stacks are left alone. Mutually exclusive with
-   * {@link byo} (which brings its own data).
+   * after `kizlo dev reset`; an existing install is left alone.
    */
   fixtures?: Fixture[];
 }
 interface KizloTestConfig {
+  /**
+   * Run local WordPress under `kizlo test`. When `true`, `kizlo test` boots a disposable Docker
+   * WordPress, seeds it, and runs your suite against it; when unset or `false`, `kizlo test` just
+   * runs your project's test script. Set for you by `kizlo create` / `kizlo init` when you choose
+   * local WordPress.
+   */
+  local?: boolean;
   /** Published WP port (default 8889). */
   port?: number;
   /** Extension fixtures to install + seed. */
@@ -75,9 +72,9 @@ interface KizloGlobalConfig {
    * to the sanitized `package.json` name, falling back to the config dir basename.
    */
   name?: string;
-  /** Local WordPress dev stack used by `kizlo dev`. */
+  /** Local WordPress and contract watcher run by `kizlo dev`. */
   dev?: KizloDevConfig;
-  /** WordPress test environment used by `kizlo test`. */
+  /** WordPress test environment run by `kizlo test`. */
   test?: KizloTestConfig;
 }
 declare function defineConfig(config: KizloGlobalConfig): KizloGlobalConfig;

package/dist/index.d.ts

@@ -39,7 +39,7 @@ import { COMMON_ERRORS, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, Def
 import { AnyMiddleware, ExtractMiddlewareContextOutput, InferMiddlewares, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, createMiddleware } from "./shared/middleware.js";
 import { AnyProcedure, AnyProcedureRouter, BaseHandlerOptions, ExtractParams, ExtractProcedureByScope, InvocationScope, OpenapiPart, Procedure, ProcedureErrors, ProcedureHandler, ProcedureOptions, ResolveParamsPart, ResolvedSchemaInput, ResolvedSchemaOutput, RouterDepthTuple, SchemaIO, buildProcedure, combineDetailed, createProcedure, handleUnexpectedError, schemaType } from "./shared/procedure.js";
 import { AnyExtension, Extension, ExtensionInitFn, ExtensionInitOptions, ExtensionInitResult, ExtractExtensionRouter, InferExtensionRouter, createExtension } from "./shared/extension.js";
-import { AnyKizloConfig, CreateKizloOptions, Kizlo, KizloConfig, KizloTarget, RootRouter, S2SClient, ServiceAdapters, createKizlo, resolveKizloConfig } from "./kizlo.js";
+import { AnyKizloConfig, CreateKizloOptions, Kizlo, KizloConfig, KizloConnect, RootRouter, S2SClient, ServiceAdapters, createKizlo, resolveKizloConfig } from "./kizlo.js";
 import { WEB_MANIFEST_ROUTE, WebManifest, buildWebManifest, createManifestRoute } from "./brand/manifest.js";
 import "./brand/index.js";
 import { KizloClient, KizloClientConfig, createKizloClient } from "./client.js";
@@ -52,4 +52,4 @@ import { ShaAlgorithm, compare, hash, hmac } from "./shared/crypto.js";
 import { Identifier, parseIdentifier } from "./shared/identifier.js";
 import { createOrpcRouter } from "./shared/router.js";
 import { deserializeCurrencyFormat, deserializeListMetadata, emptyList, serializeCurrencyFormat } from "./shared/serialize.js";
-export { AnyContext, AnyEventSchema, AnyEvents, AnyExtension, AnyKizloConfig, AnyMiddleware, AnyNestedClient, AnyProcedure, AnyProcedureRouter, AuthAdapter, AuthGetUser, AuthUser, AuthUserFn, AuthorsSettings, AuthorsSettingsInput, BaseHandlerOptions, BrandSettings, BrandSettingsInput, CART_HASH_HEADER_KEY, COMMON_ERRORS, CONTENT_TYPES, CaptchaAdapter, CategoryService, CommentService, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, ConnInfo, ConnInfoFn, ConsoleLogAdapterOptions, ContentType, Context, ContextConfig, Contract, ContractProcedure, CookiesAdapter, CookiesDeleteAll, CookiesGetAll, CookiesSetAll, CookiesStorage, CrawlingSettings, CrawlingSettingsInput, CreateKizloOptions, CreateSitemapRouteOptions, CurrencyFormat, DefinedErrorMapLike, DevPluginSource, Environment, ErrorDefinition, EventHandler, EventHandlerFn, Extension, ExtensionInitFn, ExtensionInitOptions, ExtensionInitResult, ExtractExtensionRouter, ExtractMiddlewareContextOutput, ExtractParams, ExtractProcedureByScope, Fixture, FixtureCleanupFn, FixtureSeedFn, GeoAdapter, GeoGetConnInfo, HTTPMethod, IconDescriptor, Identifier, IdentifierInput, IdentitySettings, IdentitySettingsInput, InferEventUnion, InferExtensionRouter, InferMiddlewares, InvocationScope, JsonValue, Kizlo, KizloClient, KizloClientConfig, KizloConfig, KizloError, KizloErrorOptions, KizloTarget, LIST_ORDER, List, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, LocalPlugin, LogLevel, LogPayload, Logger, LoggerAdapter, ManifestIcon, MaybeOptionalOptions, Media, MenuItemService, MenuService, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, OpenapiPart, OrganizationFounder, OrganizationSettings, OrganizationSettingsInput, PageService, PersonSettings, PersonSettingsInput, PluginSource, PostService, PostStatusDefinition, PostTypeSettings, PostTypeSettingsInput, PreviewTokenData, PreviewTokenPayload, Procedure, ProcedureContext, ProcedureErrors, ProcedureHandler, ProcedureOptions, ROUTER_MAP, RedirectInput, RedirectStatus, ResolveParamsPart, ResolvedIcons, ResolvedSchemaInput, ResolvedSchemaOutput, Robots, RobotsRule, RootRouter, RouterDepthTuple, RouterMap, S2SClient, SAFE_REQUEST_TIMEOUT, SITEMAP_BASE, SITEMAP_INDEX_SLUG, SchemaIO, SeedContext, Seo, SeoHead, SeoSchema, ServiceAdapters, Settings, SettingsService, ShaAlgorithm, SiteSettings, SiteSettingsInput, Sitemap, SitemapIndex, SitemapIndexEntry, SitemapList, SitemapRouteExtra, SitemapUrl, SitemapUrlImage, SitemapUrlList, SocialProfile, TaxonomySettings, TaxonomySettingsInput, TestAdminUser, TestCredentials, TestUser, ThrowableErrorFn, ThrowableErrorMap, UNEXPECTED_BODY_SNIPPET_LENGTH, UploadsSettings, UploadsSettingsInput, UserService, VerifyCaptchaFn, VerifyPreviewTokenFn, WC_CORE_BASE, WC_STORE_BASE, WEB_MANIFEST_ROUTE, WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapContentType, WPK_SitemapIndex, WPK_SitemapUrl, WPK_SitemapUrlImage, WP_AUTH_HEADER_KEY, WP_AUTH_TYPE, WP_CATEGORY_ORDER_BYS, WP_CORE_BASE, WP_Category, WP_CategoryCreateErrorCode, WP_CategoryCreateInput, WP_CategoryDeleteErrorCode, WP_CategoryDeleteInput, WP_CategoryDeleteResponse, WP_CategoryLinks, WP_CategoryListErrorCode, WP_CategoryListInput, WP_CategoryOrderBy, WP_CategoryRetrieveErrorCode, WP_CategoryRetrieveInput, WP_CategoryTaxonomy, WP_CategoryUpdateErrorCode, WP_CategoryUpdateInput, WP_Comment, WP_CommentAvatarUrls, WP_CommentContent, WP_CommentContentInput, WP_CommentCreateErrorCode, WP_CommentCreateInput, WP_CommentDeleteErrorCode, WP_CommentDeleteInput, WP_CommentDeleteResponse, WP_CommentLinks, WP_CommentListErrorCode, WP_CommentListInput, WP_CommentOrderBy, WP_CommentRetrieveErrorCode, WP_CommentRetrieveInput, WP_CommentStatus, WP_CommentStatusFilter, WP_CommentStatusInput, WP_CommentType, WP_CommentUpdateErrorCode, WP_CommentUpdateInput, WP_CommonErrorCode, WP_Context, WP_CurrencyFormat, WP_Error, WP_ErrorData, WP_KIZLO_BASE, WP_Link, WP_List, WP_ListMetadata, WP_ListOrder, WP_MENU_ITEM_ORDER_BYES, WP_MENU_ITEM_TARGETS, WP_MENU_ITEM_TAX_RELATIONS, WP_Menu, WP_MenuCreateErrorCode, WP_MenuCreateInput, WP_MenuDeleteErrorCode, WP_MenuDeleteInput, WP_MenuDeleteResponse, WP_MenuItem, WP_MenuItemCreateErrorCode, WP_MenuItemCreateInput, WP_MenuItemDeleteErrorCode, WP_MenuItemDeleteInput, WP_MenuItemDeleteResponse, WP_MenuItemLinks, WP_MenuItemListErrorCode, WP_MenuItemListInput, WP_MenuItemOrderBy, WP_MenuItemRetrieveErrorCode, WP_MenuItemRetrieveInput, WP_MenuItemStatus, WP_MenuItemStatusFilter, WP_MenuItemTarget, WP_MenuItemTaxRelation, WP_MenuItemTitle, WP_MenuItemTitleInput, WP_MenuItemType, WP_MenuItemUpdateErrorCode, WP_MenuItemUpdateInput, WP_MenuLinks, WP_MenuListErrorCode, WP_MenuListInput, WP_MenuOrderBy, WP_MenuRetrieveErrorCode, WP_MenuRetrieveInput, WP_MenuUpdateErrorCode, WP_MenuUpdateInput, WP_PAGE_ORDER_BYES, WP_PAGE_STATUSES, WP_POST_FORMATS, WP_POST_ORDER_BYES, WP_POST_STATUSES, WP_POST_TAX_RELATIONS, WP_Page, WP_PageCommentStatus, WP_PageContent, WP_PageContentInput, WP_PageCreateErrorCode, WP_PageCreateInput, WP_PageDeleteErrorCode, WP_PageDeleteInput, WP_PageDeleteResponse, WP_PageExcerpt, WP_PageExcerptInput, WP_PageGuid, WP_PageLinks, WP_PageListErrorCode, WP_PageListInput, WP_PageOrderBy, WP_PageRetrieveErrorCode, WP_PageRetrieveInput, WP_PageStatus, WP_PageStatusFilter, WP_PageTitle, WP_PageTitleInput, WP_PageUpdateErrorCode, WP_PageUpdateInput, WP_Post, WP_PostCommentStatus, WP_PostContent, WP_PostContentInput, WP_PostCreateErrorCode, WP_PostCreateInput, WP_PostDeleteErrorCode, WP_PostDeleteInput, WP_PostDeleteResponse, WP_PostExcerpt, WP_PostExcerptInput, WP_PostFormat, WP_PostGuid, WP_PostLinks, WP_PostListErrorCode, WP_PostListInput, WP_PostOrderBy, WP_PostRetrieveErrorCode, WP_PostRetrieveInput, WP_PostStatus, WP_PostStatusFilter, WP_PostTaxRelation, WP_PostTitle, WP_PostTitleInput, WP_PostUpdateErrorCode, WP_PostUpdateInput, WP_RequestInput, WP_Result, WP_TAG_ORDER_BYS, WP_Tag, WP_TagCreateErrorCode, WP_TagCreateInput, WP_TagDeleteErrorCode, WP_TagDeleteInput, WP_TagDeleteResponse, WP_TagLinks, WP_TagListErrorCode, WP_TagListInput, WP_TagOrderBy, WP_TagRetrieveErrorCode, WP_TagRetrieveInput, WP_TagTaxonomy, WP_TagUpdateErrorCode, WP_TagUpdateInput, WP_User, WP_UserAvatarUrls, WP_UserCapabilities, WP_UserCreateErrorCode, WP_UserCreateInput, WP_UserDeleteErrorCode, WP_UserDeleteInput, WP_UserDeleteMeErrorCode, WP_UserDeleteMeInput, WP_UserDeleteMeResponse, WP_UserDeleteResponse, WP_UserLinks, WP_UserListErrorCode, WP_UserListInput, WP_UserOrderBy, WP_UserRetrieveErrorCode, WP_UserRetrieveInput, WP_UserRetrieveMeErrorCode, WP_UserRetrieveMeInput, WP_UserUpdateErrorCode, WP_UserUpdateInput, WP_UserUpdateMeErrorCode, WP_UserUpdateMeInput, WP_UserWho, WebManifest, WebhookOptions, WebhookSettings, WebhookSettingsInput, WithCommonErrorMap, WordPressCredentials, WordPressService, altcha, arkose, authMock, buildProcedure, buildWebManifest, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createExtension, createGeoAdapter, createKizlo, createKizloClient, createLoggerAdapter, createManifestRoute, createMiddleware, createOrpcRouter, createProcedure, createSitemapRedirectRoute, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, deserializeSeo, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, noopAdapter, parseIdentifier, parseSitemapSlug, recaptcha, renderSitemapIndex, renderUrlSet, resolveIcons, resolveKizloConfig, restoreContract, schemaType, serializeCurrencyFormat, sitemapEntryPath, toKizloError, turnstile, xmlResponse };
+export { AnyContext, AnyEventSchema, AnyEvents, AnyExtension, AnyKizloConfig, AnyMiddleware, AnyNestedClient, AnyProcedure, AnyProcedureRouter, AuthAdapter, AuthGetUser, AuthUser, AuthUserFn, AuthorsSettings, AuthorsSettingsInput, BaseHandlerOptions, BrandSettings, BrandSettingsInput, CART_HASH_HEADER_KEY, COMMON_ERRORS, CONTENT_TYPES, CaptchaAdapter, CategoryService, CommentService, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, ConnInfo, ConnInfoFn, ConsoleLogAdapterOptions, ContentType, Context, ContextConfig, Contract, ContractProcedure, CookiesAdapter, CookiesDeleteAll, CookiesGetAll, CookiesSetAll, CookiesStorage, CrawlingSettings, CrawlingSettingsInput, CreateKizloOptions, CreateSitemapRouteOptions, CurrencyFormat, DefinedErrorMapLike, DevPluginSource, Environment, ErrorDefinition, EventHandler, EventHandlerFn, Extension, ExtensionInitFn, ExtensionInitOptions, ExtensionInitResult, ExtractExtensionRouter, ExtractMiddlewareContextOutput, ExtractParams, ExtractProcedureByScope, Fixture, FixtureCleanupFn, FixtureSeedFn, GeoAdapter, GeoGetConnInfo, HTTPMethod, IconDescriptor, Identifier, IdentifierInput, IdentitySettings, IdentitySettingsInput, InferEventUnion, InferExtensionRouter, InferMiddlewares, InvocationScope, JsonValue, Kizlo, KizloClient, KizloClientConfig, KizloConfig, KizloConnect, KizloError, KizloErrorOptions, LIST_ORDER, List, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, LocalPlugin, LogLevel, LogPayload, Logger, LoggerAdapter, ManifestIcon, MaybeOptionalOptions, Media, MenuItemService, MenuService, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, OpenapiPart, OrganizationFounder, OrganizationSettings, OrganizationSettingsInput, PageService, PersonSettings, PersonSettingsInput, PluginSource, PostService, PostStatusDefinition, PostTypeSettings, PostTypeSettingsInput, PreviewTokenData, PreviewTokenPayload, Procedure, ProcedureContext, ProcedureErrors, ProcedureHandler, ProcedureOptions, ROUTER_MAP, RedirectInput, RedirectStatus, ResolveParamsPart, ResolvedIcons, ResolvedSchemaInput, ResolvedSchemaOutput, Robots, RobotsRule, RootRouter, RouterDepthTuple, RouterMap, S2SClient, SAFE_REQUEST_TIMEOUT, SITEMAP_BASE, SITEMAP_INDEX_SLUG, SchemaIO, SeedContext, Seo, SeoHead, SeoSchema, ServiceAdapters, Settings, SettingsService, ShaAlgorithm, SiteSettings, SiteSettingsInput, Sitemap, SitemapIndex, SitemapIndexEntry, SitemapList, SitemapRouteExtra, SitemapUrl, SitemapUrlImage, SitemapUrlList, SocialProfile, TaxonomySettings, TaxonomySettingsInput, TestAdminUser, TestCredentials, TestUser, ThrowableErrorFn, ThrowableErrorMap, UNEXPECTED_BODY_SNIPPET_LENGTH, UploadsSettings, UploadsSettingsInput, UserService, VerifyCaptchaFn, VerifyPreviewTokenFn, WC_CORE_BASE, WC_STORE_BASE, WEB_MANIFEST_ROUTE, WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapContentType, WPK_SitemapIndex, WPK_SitemapUrl, WPK_SitemapUrlImage, WP_AUTH_HEADER_KEY, WP_AUTH_TYPE, WP_CATEGORY_ORDER_BYS, WP_CORE_BASE, WP_Category, WP_CategoryCreateErrorCode, WP_CategoryCreateInput, WP_CategoryDeleteErrorCode, WP_CategoryDeleteInput, WP_CategoryDeleteResponse, WP_CategoryLinks, WP_CategoryListErrorCode, WP_CategoryListInput, WP_CategoryOrderBy, WP_CategoryRetrieveErrorCode, WP_CategoryRetrieveInput, WP_CategoryTaxonomy, WP_CategoryUpdateErrorCode, WP_CategoryUpdateInput, WP_Comment, WP_CommentAvatarUrls, WP_CommentContent, WP_CommentContentInput, WP_CommentCreateErrorCode, WP_CommentCreateInput, WP_CommentDeleteErrorCode, WP_CommentDeleteInput, WP_CommentDeleteResponse, WP_CommentLinks, WP_CommentListErrorCode, WP_CommentListInput, WP_CommentOrderBy, WP_CommentRetrieveErrorCode, WP_CommentRetrieveInput, WP_CommentStatus, WP_CommentStatusFilter, WP_CommentStatusInput, WP_CommentType, WP_CommentUpdateErrorCode, WP_CommentUpdateInput, WP_CommonErrorCode, WP_Context, WP_CurrencyFormat, WP_Error, WP_ErrorData, WP_KIZLO_BASE, WP_Link, WP_List, WP_ListMetadata, WP_ListOrder, WP_MENU_ITEM_ORDER_BYES, WP_MENU_ITEM_TARGETS, WP_MENU_ITEM_TAX_RELATIONS, WP_Menu, WP_MenuCreateErrorCode, WP_MenuCreateInput, WP_MenuDeleteErrorCode, WP_MenuDeleteInput, WP_MenuDeleteResponse, WP_MenuItem, WP_MenuItemCreateErrorCode, WP_MenuItemCreateInput, WP_MenuItemDeleteErrorCode, WP_MenuItemDeleteInput, WP_MenuItemDeleteResponse, WP_MenuItemLinks, WP_MenuItemListErrorCode, WP_MenuItemListInput, WP_MenuItemOrderBy, WP_MenuItemRetrieveErrorCode, WP_MenuItemRetrieveInput, WP_MenuItemStatus, WP_MenuItemStatusFilter, WP_MenuItemTarget, WP_MenuItemTaxRelation, WP_MenuItemTitle, WP_MenuItemTitleInput, WP_MenuItemType, WP_MenuItemUpdateErrorCode, WP_MenuItemUpdateInput, WP_MenuLinks, WP_MenuListErrorCode, WP_MenuListInput, WP_MenuOrderBy, WP_MenuRetrieveErrorCode, WP_MenuRetrieveInput, WP_MenuUpdateErrorCode, WP_MenuUpdateInput, WP_PAGE_ORDER_BYES, WP_PAGE_STATUSES, WP_POST_FORMATS, WP_POST_ORDER_BYES, WP_POST_STATUSES, WP_POST_TAX_RELATIONS, WP_Page, WP_PageCommentStatus, WP_PageContent, WP_PageContentInput, WP_PageCreateErrorCode, WP_PageCreateInput, WP_PageDeleteErrorCode, WP_PageDeleteInput, WP_PageDeleteResponse, WP_PageExcerpt, WP_PageExcerptInput, WP_PageGuid, WP_PageLinks, WP_PageListErrorCode, WP_PageListInput, WP_PageOrderBy, WP_PageRetrieveErrorCode, WP_PageRetrieveInput, WP_PageStatus, WP_PageStatusFilter, WP_PageTitle, WP_PageTitleInput, WP_PageUpdateErrorCode, WP_PageUpdateInput, WP_Post, WP_PostCommentStatus, WP_PostContent, WP_PostContentInput, WP_PostCreateErrorCode, WP_PostCreateInput, WP_PostDeleteErrorCode, WP_PostDeleteInput, WP_PostDeleteResponse, WP_PostExcerpt, WP_PostExcerptInput, WP_PostFormat, WP_PostGuid, WP_PostLinks, WP_PostListErrorCode, WP_PostListInput, WP_PostOrderBy, WP_PostRetrieveErrorCode, WP_PostRetrieveInput, WP_PostStatus, WP_PostStatusFilter, WP_PostTaxRelation, WP_PostTitle, WP_PostTitleInput, WP_PostUpdateErrorCode, WP_PostUpdateInput, WP_RequestInput, WP_Result, WP_TAG_ORDER_BYS, WP_Tag, WP_TagCreateErrorCode, WP_TagCreateInput, WP_TagDeleteErrorCode, WP_TagDeleteInput, WP_TagDeleteResponse, WP_TagLinks, WP_TagListErrorCode, WP_TagListInput, WP_TagOrderBy, WP_TagRetrieveErrorCode, WP_TagRetrieveInput, WP_TagTaxonomy, WP_TagUpdateErrorCode, WP_TagUpdateInput, WP_User, WP_UserAvatarUrls, WP_UserCapabilities, WP_UserCreateErrorCode, WP_UserCreateInput, WP_UserDeleteErrorCode, WP_UserDeleteInput, WP_UserDeleteMeErrorCode, WP_UserDeleteMeInput, WP_UserDeleteMeResponse, WP_UserDeleteResponse, WP_UserLinks, WP_UserListErrorCode, WP_UserListInput, WP_UserOrderBy, WP_UserRetrieveErrorCode, WP_UserRetrieveInput, WP_UserRetrieveMeErrorCode, WP_UserRetrieveMeInput, WP_UserUpdateErrorCode, WP_UserUpdateInput, WP_UserUpdateMeErrorCode, WP_UserUpdateMeInput, WP_UserWho, WebManifest, WebhookOptions, WebhookSettings, WebhookSettingsInput, WithCommonErrorMap, WordPressCredentials, WordPressService, altcha, arkose, authMock, buildProcedure, buildWebManifest, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createExtension, createGeoAdapter, createKizlo, createKizloClient, createLoggerAdapter, createManifestRoute, createMiddleware, createOrpcRouter, createProcedure, createSitemapRedirectRoute, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, deserializeSeo, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, noopAdapter, parseIdentifier, parseSitemapSlug, recaptcha, renderSitemapIndex, renderUrlSet, resolveIcons, resolveKizloConfig, restoreContract, schemaType, serializeCurrencyFormat, sitemapEntryPath, toKizloError, turnstile, xmlResponse };

package/dist/integrations/nextjs/kizlo.server.js

@@ -8,7 +8,7 @@ function createKizlo(options) {
 	return new Kizlo(resolveKizloConfig({
 		...options,
 		extensions
-	}, { baseUrlEnvKey: "NEXT_PUBLIC_KIZLO_BACKEND_URL" }));
+	}, { baseUrlEnvKey: "NEXT_PUBLIC_KIZLO_API_URL" }));
 }
 
 //#endregion

package/dist/integrations/nextjs/utils.js

@@ -39,8 +39,8 @@ function createCachedTextRoute(handler, cacheTag, contentType) {
 	};
 }
 function getServerBaseUrl() {
-	const baseUrl = process.env.NEXT_PUBLIC_KIZLO_BACKEND_URL;
-	if (!baseUrl) throw new KizloError("MISSING_ENV_VARIABLE", { message: "Please define NEXT_PUBLIC_KIZLO_BACKEND_URL in your .env file." });
+	const baseUrl = process.env.NEXT_PUBLIC_KIZLO_API_URL;
+	if (!baseUrl) throw new KizloError("MISSING_ENV_VARIABLE", { message: "Please define NEXT_PUBLIC_KIZLO_API_URL in your .env file." });
 	return baseUrl;
 }