kizlo 0.9.0 → 0.10.0

package/dist/kizlo.d.ts

@@ -14,16 +14,16 @@ import { ResultClient } from "./shared/result.js";
 type AnyKizloConfig = KizloConfig<any>;
 /**
  * Which credential set to read from the environment. Independent of `environment`
- * (which carries logging semantics off `NODE_ENV`): `"dev"` reads the `KIZLO_DEV_WORDPRESS_*`
- * / `KIZLO_DEV_SITE_SECRET` keys the local stack manages, `"production"` reads `KIZLO_WORDPRESS_*` / `KIZLO_SITE_SECRET`.
+ * (which carries logging semantics off `NODE_ENV`): `"local"` reads the `KIZLO_LOCAL_WP_*`
+ * / `KIZLO_LOCAL_WP_SECRET` keys local WordPress manages, `"remote"` reads `KIZLO_WP_*` / `KIZLO_WP_SECRET`.
  */
-type KizloTarget = "dev" | "production";
+type KizloConnect = "local" | "remote";
 interface KizloConfig<TExts extends readonly AnyExtension[]> {
   baseUrl: string;
   siteSecret: string;
   extensions?: TExts;
   environment: Environment;
-  target: KizloTarget;
+  connect: KizloConnect;
   adapters?: ServiceAdapters;
   credentials: WordPressCredentials;
 }
@@ -50,26 +50,26 @@ declare class Kizlo<TExts extends readonly AnyExtension[] = []> {
   private registerExtensions;
 }
 interface CreateKizloOptions<TExts extends readonly AnyExtension[] = []> {
-  /** Public base URL of your Kizlo server, used to route requests. Falls back to the `KIZLO_BACKEND_URL` env var. */
+  /** Public base URL of your Kizlo server, used to route requests. Falls back to the `KIZLO_API_URL` env var. */
   baseUrl?: string;
-  /** Secret shared with the WordPress plugin to sign and verify webhooks. Falls back to the `KIZLO_SITE_SECRET` env var (target-selected). */
+  /** Secret shared with the WordPress plugin to sign and verify webhooks. Falls back to the `KIZLO_WP_SECRET` env var (connect-selected). */
   siteSecret?: string;
   /** Extensions to register, built with `createExtension` — mounts their namespaces on the client and their routes and event handlers on the handler. */
   extensions?: TExts;
   /** Runtime environment. Falls back to `NODE_ENV`, then `"development"`. */
   environment?: Environment;
   /**
-   * Which credential set to use. Falls back to the `KIZLO_TARGET` env var, then `"production"`.
-   * Independent of `environment`: `"dev"` reads `KIZLO_DEV_WORDPRESS_*` / `KIZLO_DEV_SITE_SECRET` (the keys the
-   * local dev stack manages), `"production"` reads `KIZLO_WORDPRESS_*` / `KIZLO_SITE_SECRET`.
+   * Which credential set to use. Falls back to the `KIZLO_CONNECT` env var, then `"remote"`.
+   * Independent of `environment`: `"local"` reads `KIZLO_LOCAL_WP_*` / `KIZLO_LOCAL_WP_SECRET` (the keys
+   * local WordPress manages), `"remote"` reads `KIZLO_WP_*` / `KIZLO_WP_SECRET`.
    */
-  target?: KizloTarget;
+  connect?: KizloConnect;
   /** Service adapters: auth, captcha, geo, logger, and cookies. */
   adapters?: ServiceAdapters;
   /**
-   * WordPress connection. Each credential falls back to a target-selected env var: with the default
-   * `"production"` target to `KIZLO_WORDPRESS_URL` / `KIZLO_WORDPRESS_USERNAME` / `KIZLO_WORDPRESS_APPLICATION_PASSWORD`,
-   * and with the `"dev"` target to their `KIZLO_DEV_WORDPRESS_*` counterparts.
+   * WordPress connection. Each credential falls back to a connect-selected env var: with the default
+   * `"remote"` connect to `KIZLO_WP_URL` / `KIZLO_WP_USERNAME` / `KIZLO_WP_APP_PASSWORD`,
+   * and with the `"local"` connect to their `KIZLO_LOCAL_WP_*` counterparts.
    */
   wordpress?: {
     credentials?: Partial<WordPressCredentials>;
@@ -85,10 +85,10 @@ declare function resolveKizloConfig<TExts extends readonly AnyExtension[]>(optio
   adapters?: ServiceAdapters;
 }): KizloConfig<TExts>;
 /**
- * Creates a Kizlo server from the environment (`KIZLO_BACKEND_URL`, `KIZLO_SITE_SECRET`,
- * `KIZLO_WORDPRESS_*`), with options taking precedence. Framework packages wrap this
+ * Creates a Kizlo server from the environment (`KIZLO_API_URL`, `KIZLO_WP_SECRET`,
+ * `KIZLO_WP_*`), with options taking precedence. Framework packages wrap this
  * with their own URL convention and adapters.
  */
 declare function createKizlo<TExts extends readonly AnyExtension[] = []>(options?: CreateKizloOptions<TExts>): Kizlo<TExts>;
 //#endregion
-export { AnyKizloConfig, CreateKizloOptions, Kizlo, KizloConfig, KizloTarget, RootRouter, S2SClient, ServiceAdapters, createKizlo, resolveKizloConfig };
+export { AnyKizloConfig, CreateKizloOptions, Kizlo, KizloConfig, KizloConnect, RootRouter, S2SClient, ServiceAdapters, createKizlo, resolveKizloConfig };

package/dist/kizlo.js

@@ -105,17 +105,21 @@ function requireEnv(name) {
 	if (!value) throw new KizloError("MISSING_ENV_VARIABLE", { message: `Please define ${name} in your .env file.` });
 	return value;
 }
-function resolveTarget(option) {
-	return option ?? (process.env.KIZLO_TARGET === "dev" ? "dev" : "production");
+function resolveConnect(option) {
+	if (option) return option;
+	const value = process.env.KIZLO_CONNECT?.trim();
+	if (!value) return "remote";
+	if (value !== "local" && value !== "remote") throw new KizloError("INVALID_ENV_VARIABLE", { message: `KIZLO_CONNECT must be "local" or "remote", got "${value}".` });
+	return value;
 }
-/** Env var names for a credential set: `KIZLO_DEV_WORDPRESS_URL` / `KIZLO_DEV_SITE_SECRET` for dev, `KIZLO_WORDPRESS_URL` / `KIZLO_SITE_SECRET` for production. */
-function targetEnvKeys(target) {
-	const prefix = target === "dev" ? "KIZLO_DEV_" : "KIZLO_";
+/** Env var names for a credential set: `KIZLO_LOCAL_WP_URL` / `KIZLO_LOCAL_WP_SECRET` for local, `KIZLO_WP_URL` / `KIZLO_WP_SECRET` for remote. */
+function connectEnvKeys(connect) {
+	const prefix = connect === "local" ? "KIZLO_LOCAL_" : "KIZLO_";
 	return {
-		siteSecret: `${prefix}SITE_SECRET`,
-		url: `${prefix}WORDPRESS_URL`,
-		username: `${prefix}WORDPRESS_USERNAME`,
-		password: `${prefix}WORDPRESS_APPLICATION_PASSWORD`
+		siteSecret: `${prefix}WP_SECRET`,
+		url: `${prefix}WP_URL`,
+		username: `${prefix}WP_USERNAME`,
+		password: `${prefix}WP_APP_PASSWORD`
 	};
 }
 /**
@@ -125,13 +129,13 @@ function targetEnvKeys(target) {
 */
 function resolveKizloConfig(options, defaults) {
 	const credentials = options?.wordpress?.credentials;
-	const target = resolveTarget(options?.target);
-	const keys = targetEnvKeys(target);
+	const connect = resolveConnect(options?.connect);
+	const keys = connectEnvKeys(connect);
 	return {
 		baseUrl: options?.baseUrl ?? requireEnv(defaults.baseUrlEnvKey),
 		siteSecret: options?.siteSecret ?? requireEnv(keys.siteSecret),
 		environment: options?.environment ?? process.env.NODE_ENV ?? "development",
-		target,
+		connect,
 		extensions: options?.extensions,
 		adapters: {
 			...defaults.adapters,
@@ -145,12 +149,12 @@ function resolveKizloConfig(options, defaults) {
 	};
 }
 /**
-* Creates a Kizlo server from the environment (`KIZLO_BACKEND_URL`, `KIZLO_SITE_SECRET`,
-* `KIZLO_WORDPRESS_*`), with options taking precedence. Framework packages wrap this
+* Creates a Kizlo server from the environment (`KIZLO_API_URL`, `KIZLO_WP_SECRET`,
+* `KIZLO_WP_*`), with options taking precedence. Framework packages wrap this
 * with their own URL convention and adapters.
 */
 function createKizlo(options) {
-	return new Kizlo(resolveKizloConfig(options, { baseUrlEnvKey: "KIZLO_BACKEND_URL" }));
+	return new Kizlo(resolveKizloConfig(options, { baseUrlEnvKey: "KIZLO_API_URL" }));
 }
 
 //#endregion

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.9.0";
+var version = "0.10.0";
 
 //#endregion
 export { version };

package/dist/router.d.ts

@@ -179,7 +179,7 @@ declare const ROUTER_MAP: {
         include?: string | number | (string | number)[] | undefined;
         offset?: string | number | undefined;
         order?: "asc" | "desc" | undefined;
-        orderby?: "id" | "date" | "slug" | "parent" | "title" | "author" | "include" | "modified" | "relevance" | "include_slugs" | undefined;
+        orderby?: "date" | "id" | "slug" | "parent" | "title" | "author" | "include" | "modified" | "relevance" | "include_slugs" | undefined;
         searchColumns?: ("post_title" | "post_content" | "post_excerpt")[] | undefined;
         slug?: string | string[] | undefined;
         taxRelation?: "AND" | "OR" | undefined;
@@ -507,7 +507,7 @@ declare const ROUTER_MAP: {
         include?: string | number | (string | number)[] | undefined;
         offset?: string | number | undefined;
         order?: "asc" | "desc" | undefined;
-        orderby?: "id" | "date" | "slug" | "parent" | "title" | "author" | "include" | "modified" | "relevance" | "include_slugs" | "menu_order" | undefined;
+        orderby?: "date" | "id" | "slug" | "parent" | "title" | "author" | "include" | "modified" | "relevance" | "include_slugs" | "menu_order" | undefined;
         searchColumns?: ("post_title" | "post_content" | "post_excerpt")[] | undefined;
         slug?: string | string[] | undefined;
         parent?: string | number | (string | number)[] | undefined;
@@ -1186,7 +1186,7 @@ declare const ROUTER_MAP: {
           include?: string | number | (string | number)[] | undefined;
           offset?: string | number | undefined;
           order?: "asc" | "desc" | undefined;
-          orderby?: "id" | "date" | "slug" | "parent" | "title" | "author" | "include" | "relevance" | "include_slugs" | "menu_order" | undefined;
+          orderby?: "date" | "id" | "slug" | "parent" | "title" | "author" | "include" | "relevance" | "include_slugs" | "menu_order" | undefined;
           searchColumns?: ("post_title" | "post_content" | "post_excerpt")[] | undefined;
           slug?: string | string[] | undefined;
           taxRelation?: "AND" | "OR" | undefined;
@@ -1265,7 +1265,7 @@ declare const ROUTER_MAP: {
           include?: string | number | (string | number)[] | undefined;
           offset?: string | number | undefined;
           order?: "asc" | "desc" | undefined;
-          orderby?: "id" | "date" | "slug" | "parent" | "title" | "author" | "include" | "relevance" | "include_slugs" | "menu_order" | undefined;
+          orderby?: "date" | "id" | "slug" | "parent" | "title" | "author" | "include" | "relevance" | "include_slugs" | "menu_order" | undefined;
           searchColumns?: ("post_title" | "post_content" | "post_excerpt")[] | undefined;
           slug?: string | string[] | undefined;
           taxRelation?: "AND" | "OR" | undefined;
@@ -1414,7 +1414,7 @@ declare const ROUTER_MAP: {
         include?: string | number | (string | number)[] | undefined;
         offset?: string | number | undefined;
         order?: "asc" | "desc" | undefined;
-        orderby?: "id" | "date" | "parent" | "post" | "include" | undefined;
+        orderby?: "date" | "id" | "parent" | "post" | "include" | undefined;
         parent?: string | number | (string | number)[] | undefined;
         parentExclude?: string | number | (string | number)[] | undefined;
         post?: string | number | (string | number)[] | undefined;

package/dist/test/server.js

@@ -18,7 +18,7 @@ function getKizloTestInstance(options) {
 		baseUrl: "http://test.local",
 		siteSecret: "test-secret",
 		environment: "test",
-		target: "production",
+		connect: "remote",
 		credentials: {
 			url: creds.url,
 			username: creds.users.admin.username,

package/dist/test.d.ts

@@ -1,6 +1,6 @@
 import { DevPluginSource, Fixture, FixtureCleanupFn, FixtureSeedFn, JsonValue, LocalPlugin, PluginSource, SeedContext, TestAdminUser, TestCredentials, TestUser, defineFixture, isLocalPlugin } from "./cli/wp/types.js";
-import { 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 } from "./cli/wp/constants.js";
-import { DockerStack, RunResult, Stack, compose, composeDown, composePull, composeStop, composeUp, createStack, dockerAvailable, wpCli } from "./cli/wp/docker.js";
+import { 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 } from "./cli/wp/constants.js";
+import { DockerStack, DockerStatus, RunResult, Stack, compose, composeDown, composePull, composeStop, composeUp, createStack, dockerAvailable, dockerHint, dockerStatus, wpCli } from "./cli/wp/docker.js";
 import { activateLocalPlugin, credentialsPath, ensurePlugin, ensurePlugins, findConfigDir, getTestCredentials, isSeeded, recordedPort, resolvePluginSource } from "./cli/wp/utils.js";
 import { TestAuthAdapterUser, toTestUser } from "./test/users.js";
 import { testAuthAdapter } from "./test/auth.js";
@@ -10,4 +10,4 @@ import { KizloClientTestInstance, getKizloClientTestInstance } from "./test/clie
 import { menuFixture } from "./menu/fixture.js";
 import { postFixture } from "./post/fixture.js";
 import { coreFixtures } from "./test/fixtures.js";
-export { CAPTCHA_TEST_TOKEN_PASS, COMPOSE_FILE, CONFIG_FILES, CREDENTIALS_REL, DEFAULT_PLUGINS, DEFAULT_PORT, DevPluginSource, DockerStack, Fixture, FixtureCleanupFn, FixtureSeedFn, JsonValue, KizloClientTestInstance, KizloTestInstance, LocalPlugin, OPCACHE_INI, PluginSource, REMAP_ENTRYPOINT, RunResult, SEED_MARKER_OPTION, SEED_VERSION, SeedContext, Stack, TEST_ADMIN, TEST_USER, TestAdminUser, TestAuthAdapterUser, TestCredentials, TestUser, activateLocalPlugin, captchaMock, compose, composeDown, composePull, composeStop, composeUp, coreFixtures, createStack, credentialsPath, defineFixture, dockerAvailable, ensurePlugin, ensurePlugins, findConfigDir, getKizloClientTestInstance, getKizloTestInstance, getTestCredentials, githubRelease, isLocalPlugin, isSeeded, kizloRelease, menuFixture, postFixture, recordedPort, resolvePluginSource, testAuthAdapter, toTestUser, wpCli };
+export { CAPTCHA_TEST_TOKEN_PASS, COMPOSE_FILE, CONFIG_FILES, CREDENTIALS_REL, DEFAULT_PLUGINS, DEFAULT_PORT, DevPluginSource, DockerStack, DockerStatus, Fixture, FixtureCleanupFn, FixtureSeedFn, JsonValue, KizloClientTestInstance, KizloTestInstance, LOCAL_DIR_REL, LocalPlugin, OPCACHE_INI, PluginSource, REMAP_ENTRYPOINT, RunResult, SEED_MARKER_OPTION, SEED_VERSION, SeedContext, Stack, TEST_ADMIN, TEST_USER, TestAdminUser, TestAuthAdapterUser, TestCredentials, TestUser, activateLocalPlugin, captchaMock, compose, composeDown, composePull, composeStop, composeUp, coreFixtures, createStack, credentialsPath, defineFixture, dockerAvailable, dockerHint, dockerStatus, ensurePlugin, ensurePlugins, findConfigDir, getKizloClientTestInstance, getKizloTestInstance, getTestCredentials, githubRelease, isLocalPlugin, isSeeded, kizloRelease, menuFixture, postFixture, recordedPort, resolvePluginSource, testAuthAdapter, toTestUser, wpCli };

package/dist/test.js

@@ -1,6 +1,6 @@
 import { defineFixture, isLocalPlugin } from "./cli/wp/types.js";
-import { 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 } from "./cli/wp/constants.js";
-import { compose, composeDown, composePull, composeStop, composeUp, createStack, dockerAvailable, wpCli } from "./cli/wp/docker.js";
+import { 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 } from "./cli/wp/constants.js";
+import { compose, composeDown, composePull, composeStop, composeUp, createStack, dockerAvailable, dockerHint, dockerStatus, wpCli } from "./cli/wp/docker.js";
 import { activateLocalPlugin, credentialsPath, ensurePlugin, ensurePlugins, findConfigDir, getTestCredentials, isSeeded, recordedPort, resolvePluginSource } from "./cli/wp/utils.js";
 import { testAuthAdapter } from "./test/auth.js";
 import { CAPTCHA_TEST_TOKEN_PASS, captchaMock } from "./test/captcha.js";
@@ -11,4 +11,4 @@ import { coreFixtures } from "./test/fixtures.js";
 import { toTestUser } from "./test/users.js";
 import { getKizloTestInstance } from "./test/server.js";
 
-export { CAPTCHA_TEST_TOKEN_PASS, COMPOSE_FILE, CONFIG_FILES, CREDENTIALS_REL, DEFAULT_PLUGINS, DEFAULT_PORT, OPCACHE_INI, REMAP_ENTRYPOINT, SEED_MARKER_OPTION, SEED_VERSION, TEST_ADMIN, TEST_USER, activateLocalPlugin, captchaMock, compose, composeDown, composePull, composeStop, composeUp, coreFixtures, createStack, credentialsPath, defineFixture, dockerAvailable, ensurePlugin, ensurePlugins, findConfigDir, getKizloClientTestInstance, getKizloTestInstance, getTestCredentials, githubRelease, isLocalPlugin, isSeeded, kizloRelease, menuFixture, postFixture, recordedPort, resolvePluginSource, testAuthAdapter, toTestUser, wpCli };
+export { CAPTCHA_TEST_TOKEN_PASS, 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, activateLocalPlugin, captchaMock, compose, composeDown, composePull, composeStop, composeUp, coreFixtures, createStack, credentialsPath, defineFixture, dockerAvailable, dockerHint, dockerStatus, ensurePlugin, ensurePlugins, findConfigDir, getKizloClientTestInstance, getKizloTestInstance, getTestCredentials, githubRelease, isLocalPlugin, isSeeded, kizloRelease, menuFixture, postFixture, recordedPort, resolvePluginSource, testAuthAdapter, toTestUser, wpCli };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kizlo",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "type": "module",
   "description": "A headless WordPress framework for TypeScript.",
   "keywords": [
@@ -14,7 +14,7 @@
     "nextjs",
     "sdk"
   ],
-  "license": "MIT",
+  "license": "Apache-2.0",
   "author": "Kizlo",
   "homepage": "https://github.com/kizlo-io/kizlo/tree/main/packages/kizlo#readme",
   "bugs": "https://github.com/kizlo-io/kizlo/issues",
@@ -76,7 +76,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.5.1",
-    "@kizlo/shared": "0.5.0",
+    "@kizlo/shared": "0.5.1",
     "@orpc/client": "^1.14.3",
     "@orpc/contract": "^1.14.3",
     "@orpc/openapi": "^1.14.3",

package/dist/cli/wp/byo.js

@@ -1,113 +0,0 @@
-import { join, resolve, sep } from "node:path";
-import { execFileSync } from "node:child_process";
-import { cpSync, createReadStream, existsSync, mkdirSync, readdirSync, renameSync, rmSync } from "node:fs";
-import { createInterface } from "node:readline";
-
-//#region src/cli/wp/byo.ts
-/** Path under the config's `.kizlo/` dir where the dump is staged for import, then deleted. */
-const SQL_STAGE_REL = ".kizlo/byo-import.sql";
-function tar(args) {
-	try {
-		return execFileSync("tar", args, {
-			encoding: "utf8",
-			maxBuffer: 64 * 1024 * 1024
-		});
-	} catch (error) {
-		const e = error;
-		throw new Error(`tar ${args.join(" ")} failed:\n${e.stderr || e.message}`);
-	}
-}
-/** Drop a leading `./` that some tar archives prefix entries with. */
-function norm(entry) {
-	return entry.replace(/^\.\//, "");
-}
-/** Move `src` to `dest`, falling back to copy+remove across filesystems (rename's EXDEV). */
-function moveInto(src, dest) {
-	try {
-		renameSync(src, dest);
-	} catch (error) {
-		if (error.code !== "EXDEV") throw error;
-		cpSync(src, dest, { recursive: true });
-		rmSync(src, {
-			recursive: true,
-			force: true
-		});
-	}
-}
-/**
-* Validate a BYO archive and return the name of its single root-level `.sql` dump. The
-* archive must be a `.tar.gz` holding a top-level `wordpress/` directory and exactly one
-* root-level `*.sql`, and must live outside `wordpressDir` (else `reset`, which wipes
-* that folder, would delete the archive before it could be re-read).
-*/
-function validateByoArchive(archivePath, wordpressDir) {
-	if (!existsSync(archivePath)) throw new Error(`dev.byo archive not found: ${archivePath}`);
-	if (!/\.tar(\.(gz|xz|bz2|zst))?$|\.(tgz|txz|tbz2?|tzst)$/i.test(archivePath)) throw new Error(`dev.byo must be a tar archive (.tar.gz, .tar.xz, .tar.bz2, .tar.zst, .tar): ${archivePath}`);
-	if (resolve(archivePath).startsWith(resolve(wordpressDir) + sep)) throw new Error(`dev.byo archive must live outside dev.path — reset would delete it: ${archivePath}`);
-	const entries = tar(["-tf", archivePath]).split("\n").map(norm).filter(Boolean);
-	if (!entries.some((e) => e === "wordpress/" || e.startsWith("wordpress/"))) throw new Error("dev.byo archive must contain a top-level `wordpress/` directory");
-	const sqls = entries.filter((e) => /^[^/]+\.sql$/.test(e));
-	if (sqls.length !== 1) throw new Error(`dev.byo archive must contain exactly one root-level .sql file (found ${sqls.length})`);
-	return sqls[0];
-}
-/**
-* Detect the dump's table prefix from its `{prefix}options` table — the one table every
-* WordPress install has exactly one of. Streams the file and stops at the first match;
-* falls back to `wp_` when none is found (so a standard dump still imports).
-*/
-async function detectTablePrefix(sqlPath) {
-	const rl = createInterface({
-		input: createReadStream(sqlPath),
-		crlfDelay: Number.POSITIVE_INFINITY
-	});
-	try {
-		for await (const line of rl) {
-			const match = line.match(/(?:CREATE TABLE(?:\s+IF NOT EXISTS)?|INSERT INTO)\s+`?([0-9a-zA-Z$_]+?)options`?\b/i);
-			if (match) return match[1];
-		}
-	} finally {
-		rl.close();
-	}
-	return "wp_";
-}
-/**
-* Lay a BYO install onto disk before the containers boot: extract the archive, move its
-* `wordpress/` files into `wordpressDir` (dropping the bundled `wp-config.php` — the image
-* regenerates one with the compose DB credentials), stage the dump under `.kizlo/`, and
-* read its table prefix. Returns the prefix (to match the regenerated config) and the host
-* path of the staged dump (the caller pipes it into the `mysql` container, then deletes it).
-*/
-async function prepareByo(archivePath, wordpressDir, configDir) {
-	const sqlName = validateByoArchive(archivePath, wordpressDir);
-	const tmp = join(configDir, ".kizlo", "byo-extract");
-	rmSync(tmp, {
-		recursive: true,
-		force: true
-	});
-	mkdirSync(tmp, { recursive: true });
-	try {
-		tar([
-			"-xf",
-			archivePath,
-			"-C",
-			tmp
-		]);
-		mkdirSync(wordpressDir, { recursive: true });
-		for (const entry of readdirSync(join(tmp, "wordpress"))) moveInto(join(tmp, "wordpress", entry), join(wordpressDir, entry));
-		rmSync(join(wordpressDir, "wp-config.php"), { force: true });
-		const sqlPath = join(configDir, SQL_STAGE_REL);
-		moveInto(join(tmp, sqlName), sqlPath);
-		return {
-			prefix: await detectTablePrefix(sqlPath),
-			sqlPath
-		};
-	} finally {
-		rmSync(tmp, {
-			recursive: true,
-			force: true
-		});
-	}
-}
-
-//#endregion
-export { prepareByo };