kizlo 0.1.0 → 0.1.1

package/dist/cli/wp/docker.js

@@ -1,14 +1,17 @@
-import { COMPOSE } from "./constants.js";
 import { spawn } from "node:child_process";
+import { createReadStream } from "node:fs";
 
 //#region src/cli/wp/docker.ts
-function run(cmd, args, opts) {
+function run(cmd, args, env, opts) {
 	return new Promise((resolvePromise, reject) => {
-		const child = spawn(cmd, args, { stdio: [
-			"pipe",
-			"pipe",
-			"pipe"
-		] });
+		const child = spawn(cmd, args, {
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			],
+			env
+		});
 		let stdout = "";
 		let stderr = "";
 		child.stdout.on("data", (d) => {
@@ -23,47 +26,83 @@ function run(cmd, args, opts) {
 			stdout,
 			stderr
 		}));
-		if (opts?.input !== void 0) child.stdin.end(opts.input);
+		if (opts?.inputFile !== void 0) createReadStream(opts.inputFile).on("error", reject).pipe(child.stdin);
+		else if (opts?.input !== void 0) child.stdin.end(opts.input);
 		else child.stdin.end();
 	});
 }
-/** `docker compose <args>` against the harness compose file. */
-async function compose(args, opts) {
-	return run("docker", [...COMPOSE, ...args], opts);
-}
-/** Bring services up detached and wait for health checks. */
-async function composeUp() {
-	const res = await compose([
-		"up",
-		"-d",
-		"--wait"
-	]);
-	if (res.code !== 0) throw new Error(`docker compose up failed:\n${res.stderr}`);
-}
-/** Tear everything down, optionally removing volumes. */
-async function composeDown(opts) {
-	const args = ["down"];
-	if (opts?.volumes) args.push("-v");
-	await compose(args);
-}
-/** `docker compose stop` — halt containers but keep volumes (DB intact). */
-async function composeStop() {
-	await compose(["stop"]);
+function bind(stack) {
+	const base = [
+		"compose",
+		"-p",
+		stack.project,
+		...stack.composeFiles.flatMap((file) => ["-f", file])
+	];
+	const env = {
+		...process.env,
+		WP_PORT: String(stack.port)
+	};
+	const compose$1 = (args, opts) => run("docker", [...base, ...args], env, opts);
+	const composeUp$1 = async () => {
+		const res = await compose$1([
+			"up",
+			"-d",
+			"--wait"
+		]);
+		if (res.code !== 0) throw new Error(`docker compose up failed:\n${res.stderr}`);
+	};
+	const composeDown$1 = async (opts) => {
+		const args = ["down"];
+		if (opts?.volumes) args.push("-v");
+		await compose$1(args);
+	};
+	const composeStop$1 = async () => {
+		await compose$1(["stop"]);
+	};
+	const wpCli$1 = async (args) => {
+		const res = await compose$1([
+			"exec",
+			"-T",
+			"wp-cli",
+			"wp",
+			...args
+		]);
+		if (res.code !== 0) throw new Error(`wp ${args.join(" ")} failed:\n${res.stderr || res.stdout}`);
+		return res.stdout.replace(/\r/g, "").trim();
+	};
+	return {
+		compose: compose$1,
+		composeUp: composeUp$1,
+		composeStop: composeStop$1,
+		composeDown: composeDown$1,
+		wpCli: wpCli$1
+	};
 }
 /**
-* Run a wp-cli command against the warm `wp-cli` container and return trimmed stdout.
+* The stack the module-level helpers target. `createStack` sets it so fixtures —
+* which call the public `wpCli`/`compose` with no stack — hit whatever stack the
+* running command activated (the test stack during seeding).
 */
-async function wpCli(args) {
-	const res = await compose([
-		"exec",
-		"-T",
-		"wp-cli",
-		"wp",
-		...args
-	]);
-	if (res.code !== 0) throw new Error(`wp ${args.join(" ")} failed:\n${res.stderr || res.stdout}`);
-	return res.stdout.replace(/\r/g, "").trim();
+let active = null;
+/** Build a stack-bound docker helper and mark it active for the bare helpers below. */
+function createStack(stack) {
+	active = stack;
+	return bind(stack);
+}
+function activeStack() {
+	if (!active) throw new Error("No active kizlo stack — createStack() must run first.");
+	return bind(active);
 }
+/** `docker compose <args>` against the active stack. */
+const compose = (args, opts) => activeStack().compose(args, opts);
+/** Bring the active stack's services up detached and wait for health checks. */
+const composeUp = () => activeStack().composeUp();
+/** Tear the active stack down, optionally removing volumes. */
+const composeDown = (opts) => activeStack().composeDown(opts);
+/** `docker compose stop` — halt the active stack's containers but keep volumes. */
+const composeStop = () => activeStack().composeStop();
+/** Run a wp-cli command against the active stack's warm `wp-cli` container. */
+const wpCli = (args) => activeStack().wpCli(args);
 
 //#endregion
-export { compose, composeDown, composeStop, composeUp, wpCli };
+export { compose, composeDown, composeStop, composeUp, createStack, wpCli };

package/dist/cli/wp/setup.js

@@ -1,8 +1,8 @@
 import { WordPressService } from "../../wordpress/service.js";
 import { credentialsPath } from "./utils.js";
 import { bootstrapWp } from "./bootstrap.js";
-import { dirname } from "node:path";
 import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
 
 //#region src/cli/wp/setup.ts
 /**

package/dist/cli/wp/stack.js

@@ -0,0 +1,58 @@
+import { isLocalPlugin } from "./types.js";
+import { COMPOSE_FILE } from "./constants.js";
+import { writeDevOverride, writeTestOverride } from "./compose/override.js";
+
+//#region src/cli/wp/stack.ts
+/** The local-plugin dirs to bind-mount, gathered from every fixture's `plugins`. */
+function localMounts(fixtures) {
+	return fixtures.flatMap((fixture) => fixture.plugins ?? []).filter(isLocalPlugin).map((plugin) => plugin.path);
+}
+/**
+* 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.
+*/
+function testStack(cfg) {
+	const mounts = localMounts(cfg.fixtures);
+	const composeFiles = mounts.length ? [COMPOSE_FILE, writeTestOverride(cfg.configDir, mounts)] : [COMPOSE_FILE];
+	return {
+		project: cfg.project,
+		port: cfg.port,
+		composeFiles
+	};
+}
+/**
+* The host user to run the dev container as, so bind-mounted files come out owned
+* by you. Only on native Linux, where Docker doesn't remap ownership; `undefined`
+* (a no-op) on macOS/Windows, and when running as root (no benefit).
+*/
+function detectHostUser() {
+	if (process.platform !== "linux" || typeof process.getuid !== "function") return void 0;
+	const uid = process.getuid();
+	if (uid === 0) return void 0;
+	return {
+		uid,
+		gid: typeof process.getgid === "function" ? process.getgid() : uid
+	};
+}
+/**
+* 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.
+*/
+function devStack(cfg) {
+	const override = writeDevOverride(cfg.configDir, {
+		wordpressDir: cfg.wordpressDir,
+		mounts: localMounts(cfg.fixtures),
+		hostUser: detectHostUser(),
+		dbPort: cfg.dbPort
+	});
+	return {
+		project: cfg.project,
+		port: cfg.port,
+		composeFiles: [COMPOSE_FILE, override]
+	};
+}
+
+//#endregion
+export { devStack, testStack };

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

@@ -55,12 +55,31 @@ type PluginSource = string | {
   name: string;
   source: string;
 };
+/**
+ * A local plugin directory to bind-mount into the dev stack (`kizlo dev`) instead
+ * of installing it. The container gets the live files at
+ * `wp-content/plugins/<basename(path)>`, so edits show up without a reinstall, and
+ * the plugin is activated by that basename. `path` is relative to the config dir.
+ */
+type LocalPlugin = {
+  path: string;
+};
+/** A `kizlo dev` plugin entry: an installable {@link PluginSource} or a {@link LocalPlugin} to mount. */
+type DevPluginSource = PluginSource | LocalPlugin;
+/** True when a dev plugin entry is a local directory to bind-mount, not something to install. */
+declare function isLocalPlugin(plugin: DevPluginSource): plugin is LocalPlugin;
 /** The serializable test layer an extension ships alongside its live extension. */
 interface Fixture {
   /** Namespace key under `TestCredentials.fixtures`. */
   name: string;
-  /** Plugins to install + activate via wp-cli during bootstrap, in order (deps first). */
-  plugins?: PluginSource[];
+  /**
+   * Plugins this fixture needs active, in order (deps first). Each entry is either
+   * an installable {@link PluginSource} (wp.org slug / zip source) or a
+   * {@link LocalPlugin} (`{ path }`) bind-mounted live from your repo — the same
+   * shape `kizlo dev` mounts, so a fixture can carry your plugin's local source
+   * and it behaves identically in the dev and test stacks (no build/zip step).
+   */
+  plugins?: DevPluginSource[];
   /** Build this extension's world once during seeding; return created handles. */
   seed?: (ctx: SeedContext) => Promise<Record<string, JsonValue>>;
   /** Revert per-test mutations (teardown); does NOT uninstall plugins or seeded data. */
@@ -69,4 +88,4 @@ interface Fixture {
 /** Identity helper for authoring a `Fixture` with full inference and autocomplete. */
 declare function defineFixture(fixture: Fixture): Fixture;
 //#endregion
-export { Fixture, JsonValue, PluginSource, SeedContext, TestAdminUser, TestCredentials, TestUser, defineFixture };
+export { DevPluginSource, Fixture, JsonValue, LocalPlugin, PluginSource, SeedContext, TestAdminUser, TestCredentials, TestUser, defineFixture, isLocalPlugin };

package/dist/cli/wp/types.js

@@ -1,8 +1,12 @@
 //#region src/cli/wp/types.ts
+/** True when a dev plugin entry is a local directory to bind-mount, not something to install. */
+function isLocalPlugin(plugin) {
+	return typeof plugin === "object" && "path" in plugin;
+}
 /** Identity helper for authoring a `Fixture` with full inference and autocomplete. */
 function defineFixture(fixture) {
 	return fixture;
 }
 
 //#endregion
-export { defineFixture };
+export { defineFixture, isLocalPlugin };

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

@@ -1,4 +1,4 @@
-import { PluginSource, TestCredentials } from "./types.js";
+import { DevPluginSource, PluginSource, TestCredentials } from "./types.js";
 
 //#region src/cli/wp/utils.d.ts
 
@@ -16,6 +16,12 @@ import { PluginSource, TestCredentials } from "./types.js";
 declare function isSeeded(): Promise<boolean>;
 /** Build a GitHub release-zip URL for `PluginSource.source` (asset named `<tag>.zip`). */
 declare function githubRelease(repo: string, tag: string): string;
+/**
+ * Download URL for a Kizlo plugin's latest release, served by kizlo.io (it 302s to
+ * the current GitHub release asset). Always tracks the newest published version —
+ * use {@link githubRelease} instead to pin a specific tag.
+ */
+declare function kizloRelease(slug: string): string;
 /** Resolve a `PluginSource` to the `(name, source)` pair `ensurePlugin` needs. */
 declare function resolvePluginSource(plugin: PluginSource): [name: string, source: string];
 /**
@@ -25,6 +31,21 @@ declare function resolvePluginSource(plugin: PluginSource): [name: string, sourc
  * are absent (i.e. after `wp reset` wipes the volume).
  */
 declare function ensurePlugin(name: string, source: string): Promise<void>;
+/**
+ * Activate a bind-mounted local plugin by its directory basename (the slug the
+ * mount lands at under `wp-content/plugins`). Idempotent: the files arrive via the
+ * compose bind, so there's nothing to install — just activate if it isn't already.
+ */
+declare function activateLocalPlugin(pluginPath: string): Promise<void>;
+/**
+ * Ensure every plugin is active. Installable sources go first so a bind-mounted
+ * local plugin that depends on one (e.g. a WooCommerce extension) finds it already
+ * present; then each {@link LocalPlugin} is activated by basename. A local plugin
+ * whose slug matches an installable (e.g. mounting `kizlo` over the released
+ * `kizlo`) is seen as already installed, so `ensurePlugin` activates the live
+ * files instead of downloading over them.
+ */
+declare function ensurePlugins(plugins: DevPluginSource[]): Promise<void>;
 /**
  * The directory holding `kizlo.config.*`, found by walking up from `cwd` (falling
  * back to `cwd` when none is found). Anchoring the credentials artifact here —
@@ -36,4 +57,4 @@ declare function findConfigDir(cwd?: string): string;
 declare function credentialsPath(cwd?: string): string;
 declare function getTestCredentials(): TestCredentials;
 //#endregion
-export { credentialsPath, ensurePlugin, findConfigDir, getTestCredentials, githubRelease, isSeeded, resolvePluginSource };
+export { activateLocalPlugin, credentialsPath, ensurePlugin, ensurePlugins, findConfigDir, getTestCredentials, githubRelease, isSeeded, kizloRelease, resolvePluginSource };

package/dist/cli/wp/utils.js

@@ -1,7 +1,8 @@
-import { CONFIG_FILES, CREDENTIALS_REL, SEED_MARKER_OPTION, SEED_VERSION } from "./constants.js";
+import { isLocalPlugin } from "./types.js";
 import { compose, wpCli } from "./docker.js";
-import { dirname, resolve } from "node:path";
+import { CONFIG_FILES, CREDENTIALS_REL, SEED_MARKER_OPTION, SEED_VERSION } from "./constants.js";
 import { existsSync, readFileSync } from "node:fs";
+import { basename, dirname, resolve } from "node:path";
 
 //#region src/cli/wp/utils.ts
 /**
@@ -32,6 +33,14 @@ async function isSeeded() {
 function githubRelease(repo, tag) {
 	return `https://github.com/${repo}/releases/download/${tag}/${tag}.zip`;
 }
+/**
+* Download URL for a Kizlo plugin's latest release, served by kizlo.io (it 302s to
+* the current GitHub release asset). Always tracks the newest published version —
+* use {@link githubRelease} instead to pin a specific tag.
+*/
+function kizloRelease(slug) {
+	return `https://kizlo.io/plugins/${slug}/download`;
+}
 /** Resolve a `PluginSource` to the `(name, source)` pair `ensurePlugin` needs. */
 function resolvePluginSource(plugin) {
 	return typeof plugin === "string" ? [plugin, plugin] : [plugin.name, plugin.source];
@@ -76,6 +85,39 @@ async function ensurePlugin(name, source) {
 	]);
 }
 /**
+* Activate a bind-mounted local plugin by its directory basename (the slug the
+* mount lands at under `wp-content/plugins`). Idempotent: the files arrive via the
+* compose bind, so there's nothing to install — just activate if it isn't already.
+*/
+async function activateLocalPlugin(pluginPath) {
+	const slug = basename(pluginPath);
+	if ((await compose([
+		"exec",
+		"-T",
+		"wp-cli",
+		"wp",
+		"plugin",
+		"is-active",
+		slug
+	])).code !== 0) await wpCli([
+		"plugin",
+		"activate",
+		slug
+	]);
+}
+/**
+* Ensure every plugin is active. Installable sources go first so a bind-mounted
+* local plugin that depends on one (e.g. a WooCommerce extension) finds it already
+* present; then each {@link LocalPlugin} is activated by basename. A local plugin
+* whose slug matches an installable (e.g. mounting `kizlo` over the released
+* `kizlo`) is seen as already installed, so `ensurePlugin` activates the live
+* files instead of downloading over them.
+*/
+async function ensurePlugins(plugins) {
+	for (const plugin of plugins) if (!isLocalPlugin(plugin)) await ensurePlugin(...resolvePluginSource(plugin));
+	for (const plugin of plugins) if (isLocalPlugin(plugin)) await activateLocalPlugin(plugin.path);
+}
+/**
 * The directory holding `kizlo.config.*`, found by walking up from `cwd` (falling
 * back to `cwd` when none is found). Anchoring the credentials artifact here —
 * rather than each process's cwd — is what lets the CLI writer and the test reader
@@ -102,4 +144,4 @@ function getTestCredentials() {
 }
 
 //#endregion
-export { credentialsPath, ensurePlugin, findConfigDir, getTestCredentials, githubRelease, isSeeded, resolvePluginSource };
+export { activateLocalPlugin, credentialsPath, ensurePlugin, ensurePlugins, findConfigDir, getTestCredentials, githubRelease, isSeeded, kizloRelease, resolvePluginSource };

package/dist/config.d.ts

@@ -2,9 +2,48 @@ import { Fixture } from "./cli/wp/types.js";
 import "./test.js";
 
 //#region src/config.d.ts
-interface KizloTestConfig {
+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.
+   */
+  path: string;
   /** 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
+   * 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
+   * 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
+   * 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
+   * `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).
+   */
+  fixtures?: Fixture[];
+}
+interface KizloTestConfig {
+  /** Published WP port (default 8889). */
+  port?: number;
   /** Extension fixtures to install + seed. */
   fixtures?: Fixture[];
   /**
@@ -31,9 +70,16 @@ interface KizloGlobalConfig {
    * tsconfig at init; omit (or empty) to use relative imports.
    */
   alias?: string;
-  /** WordPress test environment used by `kizlo wp` and `kizlo test`. */
+  /**
+   * Base name for the local Docker stacks (`<name>-dev`, `<name>-test`). Defaults
+   * to the sanitized `package.json` name, falling back to the config dir basename.
+   */
+  name?: string;
+  /** Local WordPress dev stack used by `kizlo dev`. */
+  dev?: KizloDevConfig;
+  /** WordPress test environment used by `kizlo test`. */
   test?: KizloTestConfig;
 }
 declare function defineConfig(config: KizloGlobalConfig): KizloGlobalConfig;
 //#endregion
-export { KizloGlobalConfig, KizloTestConfig, defineConfig };
+export { KizloDevConfig, KizloGlobalConfig, KizloTestConfig, defineConfig };

package/dist/index.d.ts

@@ -14,6 +14,7 @@ import { CommentService } from "./wordpress/comment/service.js";
 import { CART_HASH_HEADER_KEY, SAFE_REQUEST_TIMEOUT, UNEXPECTED_BODY_SNIPPET_LENGTH, WC_CORE_BASE, WC_STORE_BASE, WP_AUTH_HEADER_KEY, WP_AUTH_TYPE, WP_CORE_BASE, WP_KIZLO_BASE } from "./wordpress/constants.js";
 import { isWordPressResourceError } from "./wordpress/utils.js";
 import "./wordpress/index.js";
+import { DevPluginSource, Fixture, JsonValue, LocalPlugin, PluginSource, SeedContext, TestAdminUser, TestCredentials, TestUser, defineFixture, isLocalPlugin } from "./cli/wp/types.js";
 import { AuthAdapter, AuthUser, authMock } from "./adapters/auth.js";
 import { CaptchaAdapter, altcha, arkose, friendlyCaptcha, hcaptcha, recaptcha, turnstile } from "./adapters/captcha.js";
 import { ConnInfo, GeoAdapter, geoMock } from "./adapters/geo.js";
@@ -36,4 +37,4 @@ import { 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, AnyExtension, AnyKizloConfig, AnyMiddleware, AnyNestedClient, AnyProcedure, AnyProcedureRouter, AnyWebhookEventSchema, AnyWebhookEvents, AuthAdapter, AuthUser, AuthUserFn, CART_HASH_HEADER_KEY, COMMON_ERRORS, CONTENT_TYPES, CaptchaAdapter, CommentService, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, ConnInfo, ConnInfoFn, ConsoleLogAdapterOptions, ContentType, Context, ContextConfig, Contract, ContractProcedure, CookiesAdapter, CreateKizloOptions, CurrencyFormat, DefinedErrorLike, DefinedErrorMapLike, Environment, EventHandler, Extension, ExtensionInitFn, ExtensionInitOptions, ExtensionInitResult, ExtractExtensionRouter, ExtractMiddlewareContextOutput, ExtractParams, ExtractProcedureByScope, GeoAdapter, HTTPMethod, Identifier, IdentifierInput, InferExtensionRouter, InferWebhookEventUnion, InvocationScope, Kizlo, KizloClient, KizloClientConfig, KizloConfig, KizloError, KizloErrorOptions, LIST_ORDER, List, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, LogLevel, LogPayload, Logger, LoggerAdapter, MaybeOptionalOptions, Media, MenuItemService, MenuService, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, OpenapiPart, PostService, PreviewTokenData, PreviewTokenPayload, Procedure, ProcedureContext, ProcedureHandler, ProcedureOptions, RedirectInput, RedirectStatus, ResolveParamsPart, ResolvedSchemaInput, ResolvedSchemaOutput, Robots, RobotsRule, RootRouter, RouterDepthTuple, S2SClient, SAFE_REQUEST_TIMEOUT, SchemaIO, Seo, SeoHead, SeoSchema, ServerContext, Service, ServiceAdapters, ServiceConfig, Sitemap, SitemapList, SitemapUrl, SitemapUrlImage, SitemapUrlList, ThrowableErrorFn, ThrowableErrorMap, UNEXPECTED_BODY_SNIPPET_LENGTH, UserService, VerifyCaptchaFn, VerifyPreviewTokenFn, WC_CORE_BASE, WC_STORE_BASE, WPK_ListSitemapUrlInput, WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapContentType, WPK_SitemapUrl, WPK_SitemapUrlImage, WP_AUTH_HEADER_KEY, WP_AUTH_TYPE, WP_CORE_BASE, 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, 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_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_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, WebhookHandlerFn, WebhookOptions, WithCommonErrorMap, WordPressCredentials, WordPressService, altcha, arkose, authMock, buildProcedure, combineDetailed, compare, consoleLog, createEventHandler, createExtension, createKizlo, createKizloClient, createMiddleware, createOrpcRouter, createProcedure, createThrowableErrorMap, createWebhookRouter, defineErrorMap, deserializeCurrencyFormat, deserializeListMetadata, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, isContractProcedure, isKizloError, isWordPressResourceError, noopAdapter, parseIdentifier, recaptcha, resolveKizloConfig, restoreContract, schemaType, serializeCurrencyFormat, toKizloError, turnstile };
+export { AnyContext, AnyExtension, AnyKizloConfig, AnyMiddleware, AnyNestedClient, AnyProcedure, AnyProcedureRouter, AnyWebhookEventSchema, AnyWebhookEvents, AuthAdapter, AuthUser, AuthUserFn, CART_HASH_HEADER_KEY, COMMON_ERRORS, CONTENT_TYPES, CaptchaAdapter, CommentService, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, ConnInfo, ConnInfoFn, ConsoleLogAdapterOptions, ContentType, Context, ContextConfig, Contract, ContractProcedure, CookiesAdapter, CreateKizloOptions, CurrencyFormat, DefinedErrorLike, DefinedErrorMapLike, DevPluginSource, Environment, EventHandler, Extension, ExtensionInitFn, ExtensionInitOptions, ExtensionInitResult, ExtractExtensionRouter, ExtractMiddlewareContextOutput, ExtractParams, ExtractProcedureByScope, Fixture, GeoAdapter, HTTPMethod, Identifier, IdentifierInput, InferExtensionRouter, InferWebhookEventUnion, InvocationScope, JsonValue, Kizlo, KizloClient, KizloClientConfig, KizloConfig, KizloError, KizloErrorOptions, LIST_ORDER, List, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, LocalPlugin, LogLevel, LogPayload, Logger, LoggerAdapter, MaybeOptionalOptions, Media, MenuItemService, MenuService, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, OpenapiPart, PluginSource, PostService, PreviewTokenData, PreviewTokenPayload, Procedure, ProcedureContext, ProcedureHandler, ProcedureOptions, RedirectInput, RedirectStatus, ResolveParamsPart, ResolvedSchemaInput, ResolvedSchemaOutput, Robots, RobotsRule, RootRouter, RouterDepthTuple, S2SClient, SAFE_REQUEST_TIMEOUT, SchemaIO, SeedContext, Seo, SeoHead, SeoSchema, ServerContext, Service, ServiceAdapters, ServiceConfig, Sitemap, SitemapList, SitemapUrl, SitemapUrlImage, SitemapUrlList, TestAdminUser, TestCredentials, TestUser, ThrowableErrorFn, ThrowableErrorMap, UNEXPECTED_BODY_SNIPPET_LENGTH, UserService, VerifyCaptchaFn, VerifyPreviewTokenFn, WC_CORE_BASE, WC_STORE_BASE, WPK_ListSitemapUrlInput, WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapContentType, WPK_SitemapUrl, WPK_SitemapUrlImage, WP_AUTH_HEADER_KEY, WP_AUTH_TYPE, WP_CORE_BASE, 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, 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_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_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, WebhookHandlerFn, WebhookOptions, WithCommonErrorMap, WordPressCredentials, WordPressService, altcha, arkose, authMock, buildProcedure, combineDetailed, compare, consoleLog, createEventHandler, createExtension, createKizlo, createKizloClient, createMiddleware, createOrpcRouter, createProcedure, createThrowableErrorMap, createWebhookRouter, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, noopAdapter, parseIdentifier, recaptcha, resolveKizloConfig, restoreContract, schemaType, serializeCurrencyFormat, toKizloError, turnstile };

package/dist/index.js

@@ -3,6 +3,7 @@ import { altcha, arkose, friendlyCaptcha, hcaptcha, recaptcha, turnstile } from
 import { geoMock } from "./adapters/geo.js";
 import { geoVercelNext } from "./adapters/geo.vercel.js";
 import { consoleLog, noopAdapter } from "./adapters/logger.js";
+import { defineFixture, isLocalPlugin } from "./cli/wp/types.js";
 import { COMMON_ERRORS, KizloError, createThrowableErrorMap, defineErrorMap, isKizloError, toKizloError } from "./shared/error.js";
 import { buildProcedure, combineDetailed, createMiddleware, createProcedure, handleUnexpectedError, schemaType } from "./shared/procedure.js";
 import { createOrpcRouter } from "./shared/router.js";
@@ -28,4 +29,4 @@ import { createEventHandler, createWebhookRouter } from "./webhook/index.js";
 import { Kizlo, createKizlo, resolveKizloConfig } from "./kizlo.js";
 import { createExtension } from "./shared/extension.js";
 
-export { CART_HASH_HEADER_KEY, COMMON_ERRORS, CONTENT_TYPES, CommentService, ContentType, Context, CurrencyFormat, IdentifierInput, Kizlo, KizloClient, KizloError, LIST_ORDER, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, Media, MenuItemService, MenuService, PostService, PreviewTokenData, PreviewTokenPayload, Robots, RobotsRule, SAFE_REQUEST_TIMEOUT, Seo, SeoHead, SeoSchema, Service, Sitemap, SitemapList, SitemapUrl, SitemapUrlImage, SitemapUrlList, UNEXPECTED_BODY_SNIPPET_LENGTH, UserService, WC_CORE_BASE, WC_STORE_BASE, WP_AUTH_HEADER_KEY, WP_AUTH_TYPE, WP_CORE_BASE, WP_Error, WP_KIZLO_BASE, WordPressService, altcha, arkose, authMock, buildProcedure, combineDetailed, compare, consoleLog, createEventHandler, createExtension, createKizlo, createKizloClient, createMiddleware, createOrpcRouter, createProcedure, createThrowableErrorMap, createWebhookRouter, defineErrorMap, deserializeCurrencyFormat, deserializeListMetadata, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, isContractProcedure, isKizloError, isWordPressResourceError, noopAdapter, parseIdentifier, recaptcha, resolveKizloConfig, restoreContract, schemaType, serializeCurrencyFormat, toKizloError, turnstile };
+export { CART_HASH_HEADER_KEY, COMMON_ERRORS, CONTENT_TYPES, CommentService, ContentType, Context, CurrencyFormat, IdentifierInput, Kizlo, KizloClient, KizloError, LIST_ORDER, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, Media, MenuItemService, MenuService, PostService, PreviewTokenData, PreviewTokenPayload, Robots, RobotsRule, SAFE_REQUEST_TIMEOUT, Seo, SeoHead, SeoSchema, Service, Sitemap, SitemapList, SitemapUrl, SitemapUrlImage, SitemapUrlList, UNEXPECTED_BODY_SNIPPET_LENGTH, UserService, WC_CORE_BASE, WC_STORE_BASE, WP_AUTH_HEADER_KEY, WP_AUTH_TYPE, WP_CORE_BASE, WP_Error, WP_KIZLO_BASE, WordPressService, altcha, arkose, authMock, buildProcedure, combineDetailed, compare, consoleLog, createEventHandler, createExtension, createKizlo, createKizloClient, createMiddleware, createOrpcRouter, createProcedure, createThrowableErrorMap, createWebhookRouter, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, noopAdapter, parseIdentifier, recaptcha, resolveKizloConfig, restoreContract, schemaType, serializeCurrencyFormat, toKizloError, turnstile };

package/dist/menu/fixture.d.ts

@@ -1,5 +1,5 @@
 import { Fixture } from "../cli/wp/types.js";
-import "../test.js";
+import "../index.js";
 
 //#region src/menu/fixture.d.ts
 /** Core menu fixture: seeds a `primary` nav menu + items so the menu suite has content to read. */

package/dist/package.js

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

package/dist/post/fixture.d.ts

@@ -1,5 +1,5 @@
 import { Fixture } from "../cli/wp/types.js";
-import "../test.js";
+import "../index.js";
 
 //#region src/post/fixture.d.ts
 /** Core post fixture: seeds sample posts + comments so the post/comment suites have content to read. */

package/dist/test.d.ts

@@ -1,6 +1,6 @@
-import { compose, composeDown, composeStop, composeUp, wpCli } from "./cli/wp/docker.js";
-import { Fixture, JsonValue, PluginSource, SeedContext, TestAdminUser, TestCredentials, TestUser, defineFixture } from "./cli/wp/types.js";
-import { credentialsPath, ensurePlugin, findConfigDir, getTestCredentials, githubRelease, isSeeded, resolvePluginSource } from "./cli/wp/utils.js";
+import { DockerStack, RunResult, Stack, compose, composeDown, composeStop, composeUp, createStack, wpCli } from "./cli/wp/docker.js";
+import { DevPluginSource, Fixture, JsonValue, LocalPlugin, PluginSource, SeedContext, TestAdminUser, TestCredentials, TestUser, defineFixture, isLocalPlugin } from "./cli/wp/types.js";
+import { activateLocalPlugin, credentialsPath, ensurePlugin, ensurePlugins, findConfigDir, getTestCredentials, githubRelease, isSeeded, kizloRelease, resolvePluginSource } from "./cli/wp/utils.js";
 import { TestAuthAdapterUser, toTestUser } from "./test/users.js";
 import { testAuthAdapter } from "./test/auth.js";
 import { CAPTCHA_TEST_TOKEN_PASS, captchaMock } from "./test/captcha.js";
@@ -9,4 +9,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, Fixture, JsonValue, KizloClientTestInstance, KizloTestInstance, PluginSource, SeedContext, TestAdminUser, TestAuthAdapterUser, TestCredentials, TestUser, captchaMock, compose, composeDown, composeStop, composeUp, coreFixtures, credentialsPath, defineFixture, ensurePlugin, findConfigDir, getKizloClientTestInstance, getKizloTestInstance, getTestCredentials, githubRelease, isSeeded, menuFixture, postFixture, resolvePluginSource, testAuthAdapter, toTestUser, wpCli };
+export { CAPTCHA_TEST_TOKEN_PASS, DevPluginSource, DockerStack, Fixture, JsonValue, KizloClientTestInstance, KizloTestInstance, LocalPlugin, PluginSource, RunResult, SeedContext, Stack, TestAdminUser, TestAuthAdapterUser, TestCredentials, TestUser, activateLocalPlugin, captchaMock, compose, composeDown, composeStop, composeUp, coreFixtures, createStack, credentialsPath, defineFixture, ensurePlugin, ensurePlugins, findConfigDir, getKizloClientTestInstance, getKizloTestInstance, getTestCredentials, githubRelease, isLocalPlugin, isSeeded, kizloRelease, menuFixture, postFixture, resolvePluginSource, testAuthAdapter, toTestUser, wpCli };

package/dist/test.js

@@ -1,6 +1,6 @@
-import { credentialsPath, ensurePlugin, findConfigDir, getTestCredentials, githubRelease, isSeeded, resolvePluginSource } from "./cli/wp/utils.js";
-import { compose, composeDown, composeStop, composeUp, wpCli } from "./cli/wp/docker.js";
-import { defineFixture } from "./cli/wp/types.js";
+import { defineFixture, isLocalPlugin } from "./cli/wp/types.js";
+import { compose, composeDown, composeStop, composeUp, createStack, wpCli } from "./cli/wp/docker.js";
+import { activateLocalPlugin, credentialsPath, ensurePlugin, ensurePlugins, findConfigDir, getTestCredentials, githubRelease, isSeeded, kizloRelease, resolvePluginSource } from "./cli/wp/utils.js";
 import { testAuthAdapter } from "./test/auth.js";
 import { CAPTCHA_TEST_TOKEN_PASS, captchaMock } from "./test/captcha.js";
 import { getKizloClientTestInstance } from "./test/client.js";
@@ -10,4 +10,4 @@ import { coreFixtures } from "./test/fixtures.js";
 import { toTestUser } from "./test/users.js";
 import { getKizloTestInstance } from "./test/server.js";
 
-export { CAPTCHA_TEST_TOKEN_PASS, captchaMock, compose, composeDown, composeStop, composeUp, coreFixtures, credentialsPath, defineFixture, ensurePlugin, findConfigDir, getKizloClientTestInstance, getKizloTestInstance, getTestCredentials, githubRelease, isSeeded, menuFixture, postFixture, resolvePluginSource, testAuthAdapter, toTestUser, wpCli };
+export { CAPTCHA_TEST_TOKEN_PASS, activateLocalPlugin, captchaMock, compose, composeDown, composeStop, composeUp, coreFixtures, createStack, credentialsPath, defineFixture, ensurePlugin, ensurePlugins, findConfigDir, getKizloClientTestInstance, getKizloTestInstance, getTestCredentials, githubRelease, isLocalPlugin, isSeeded, kizloRelease, menuFixture, postFixture, resolvePluginSource, testAuthAdapter, toTestUser, wpCli };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kizlo",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "A headless WordPress toolkit for TypeScript.",
   "keywords": [
@@ -76,7 +76,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.5.1",
-    "@kizlo/shared": "0.1.0",
+    "@kizlo/shared": "0.1.1",
     "@orpc/client": "^1.14.3",
     "@orpc/contract": "^1.14.3",
     "@orpc/openapi": "^1.14.3",