kizlo 0.19.0 → 0.20.1

package/dist/cli/daemon/generate.js

@@ -14,16 +14,16 @@ import fs from "node:fs";
 
 //#region src/cli/daemon/generate.ts
 /**
-* The generated barrel is also written as a stub by `kizlo init`. It re-exports `endpoints` rather
-* than pre-wrapping it: a server entry passes `wordpress: { endpoints }` itself, so the rest of the
-* WordPress options stay visible at the call site instead of hiding inside a generated object.
+* The generated barrel is also written as a stub by `kizlo init`. It re-exports `introspection`
+* rather than pre-wrapping it: a server entry passes `createKizlo({ introspection })` itself, so the
+* rest of the options stay visible at the call site instead of hiding inside a generated object.
 */
 const CONTRACT_BARREL = [
 	`import type { procedures } from ".."`,
 	`import contractJson from "./contract.json"`,
 	``,
 	`export const contract = contractJson as unknown as typeof procedures`,
-	`export { endpoints, type WordPressClient } from "./introspection"`,
+	`export { introspection, type WordPressClient } from "./introspection"`,
 	``
 ].join("\n");
 var LegacyRouterExportError = class extends Error {
@@ -42,13 +42,13 @@ var LegacyRouterExportError = class extends Error {
 const INTROSPECTION_STUB = [
 	`import type { WP_Client } from "kizlo"`,
 	``,
-	`export const endpoints = {} as any`,
+	`export const introspection = {} as any`,
 	``,
-	`export type WordPressClient = WP_Client<typeof endpoints>`,
+	`export type WordPressClient = WP_Client<typeof introspection>`,
 	``,
 	`declare module "kizlo" {`,
 	`\tinterface WordPressClientRegistry {`,
-	`\t\tendpoints: typeof endpoints`,
+	`\t\tintrospection: typeof introspection`,
 	`\t}`,
 	`\tinterface WordPressEndpointRegistry {`,
 	`\t\t[path: string]: any`,
@@ -177,7 +177,7 @@ function reportPluginVersion(installed) {
 /** Fetch `/introspect`, reporting its diagnostics in the CLI's voice. Returns undefined on a 304. */
 async function fetchDocument(cwd, options, etag) {
 	loadEnvFiles(cwd);
-	const result = await fetchIntrospection(options.credentials ?? resolveWordPressConnection(void 0, integrationEnv([node()])).credentials, {
+	const result = await fetchIntrospection(options.credentials ?? resolveWordPressConnection(integrationEnv([node()])).credentials, {
 		etag: options.strict ? void 0 : etag,
 		fetch: options.fetch
 	});

package/dist/cli/daemon/watch.js

@@ -140,7 +140,7 @@ async function startWatcher(cwd, opts) {
 			return;
 		}
 		loadEnvFiles(cwd);
-		const { credentials } = resolveWordPressConnection(void 0, integrationEnv([node()]));
+		const { credentials } = resolveWordPressConnection(integrationEnv([node()]));
 		try {
 			const result = await generateOnce(cfg, { credentials });
 			if (result.contract === "built") log.success("Contract generated");

package/dist/cli/wp/compose/apache-listen.conf

@@ -0,0 +1,15 @@
+# Kizlo local WordPress — make same-site server requests reach Apache.
+#
+# WordPress builds internal, server-side requests (e.g. a plugin calling its own
+# admin_url()) against the browser-facing URL, which carries the *published* host
+# port — say http://localhost:8890. Inside the container that request loops back to
+# localhost:8890, but Apache only listens on 80 (Docker maps the host port to 80),
+# so the call fails with cURL error 7 and the plugin stalls.
+#
+# Listening on the published port as well makes localhost:<port> resolve inside the
+# container exactly as it does from the browser. Apache keeps its port-80 listener
+# for Docker's port mapping and the health check; this only adds a second one.
+#
+# WP_PORT is passed into the wordpress service by the CLI (and defaulted in the base
+# Compose file), so Apache expands ${WP_PORT} from the container environment.
+Listen ${WP_PORT}

package/dist/cli/wp/compose/docker-compose.test.ts

@@ -0,0 +1,66 @@
+import fs from "node:fs"
+import { describe, expect, test } from "vitest"
+import { parse } from "yaml"
+import { APACHE_LISTEN_CONF, COMPOSE_FILE, UPLOADS_INI } from "../constants"
+
+interface Service {
+	environment?: Record<string, string>
+	ports?: string[]
+	volumes?: string[]
+}
+
+const wordpress = (): Service => parse(fs.readFileSync(COMPOSE_FILE, "utf8")).services.wordpress
+
+/** Parse a `key=value` INI (comments/blank lines dropped) into a lookup. */
+function ini(file: string): Record<string, string> {
+	const out: Record<string, string> = {}
+	for (const line of fs.readFileSync(file, "utf8").split("\n")) {
+		const trimmed = line.trim()
+		if (!trimmed || trimmed.startsWith(";")) continue
+		const eq = trimmed.indexOf("=")
+		if (eq !== -1) out[trimmed.slice(0, eq).trim()] = trimmed.slice(eq + 1).trim()
+	}
+	return out
+}
+
+/** PHP size shorthand (`2G`, `2100M`, `512K`) to bytes. */
+function bytes(size: string): number {
+	const match = /^(\d+)([KMG]?)$/i.exec(size)
+	if (!match) throw new Error(`not a PHP size: ${size}`)
+	const scale = { "": 1, K: 1024, M: 1024 ** 2, G: 1024 ** 3 }[match[2]?.toUpperCase() ?? ""] ?? 1
+	return Number(match[1]) * scale
+}
+
+describe("base compose wordpress service", () => {
+	test("receives the published port so Apache can listen on it", () => {
+		// Defaulted to the same value as the port mapping so a standalone `up` still parses.
+		// The `${...}` here are literal Compose interpolation tokens, not JS templates.
+		// biome-ignore lint/suspicious/noTemplateCurlyInString: literal Compose interpolation
+		expect(wordpress().environment?.WP_PORT).toBe("${WP_PORT:-8080}")
+		// biome-ignore lint/suspicious/noTemplateCurlyInString: literal Compose interpolation
+		expect(wordpress().ports).toContain("${WP_PORT:-8080}:80")
+	})
+
+	test("mounts both local-only config assets read-only", () => {
+		const volumes = wordpress().volumes ?? []
+		expect(volumes).toContain("./uploads.ini:/usr/local/etc/php/conf.d/zz-kizlo-uploads.ini:ro")
+		expect(volumes).toContain("./apache-listen.conf:/etc/apache2/conf-enabled/zz-kizlo-listen.conf:ro")
+	})
+})
+
+describe("uploads.ini", () => {
+	test("raises the upload ceiling to 2 GB", () => {
+		expect(ini(UPLOADS_INI).upload_max_filesize).toBe("2G")
+	})
+
+	test("allows POST overhead above the file limit for the multipart envelope", () => {
+		const values = ini(UPLOADS_INI)
+		expect(bytes(values.post_max_size ?? "")).toBeGreaterThan(bytes(values.upload_max_filesize ?? ""))
+	})
+})
+
+describe("apache-listen.conf", () => {
+	test("listens on the injected published port", () => {
+		expect(fs.readFileSync(APACHE_LISTEN_CONF, "utf8")).toMatch(/^\s*Listen\s+\$\{WP_PORT\}\s*$/m)
+	})
+})

package/dist/cli/wp/compose/docker-compose.yml

@@ -40,6 +40,11 @@ services:
       WORDPRESS_DB_NAME: ${MYSQL_DATABASE:-wordpress}
       WORDPRESS_DB_USER: ${MYSQL_USER:-wordpress}
       WORDPRESS_DB_PASSWORD: ${MYSQL_PASSWORD:-wppass}
+      # Published host port, handed to Apache so `apache-listen.conf` can add a
+      # second listener on it (see that file). Defaulted here to match the port
+      # mapping above so a standalone `docker compose up` still parses the config;
+      # every path through the CLI supplies the resolved port as WP_PORT.
+      WP_PORT: ${WP_PORT:-8080}
       # The wordpress image eval()s WORDPRESS_CONFIG_EXTRA at runtime, and Compose
       # interpolates `$` in this file first — so every PHP variable below is written
       # `$$` to survive Compose and reach PHP as a literal `$`.
@@ -56,6 +61,11 @@ services:
         }
     volumes:
       - wp_data:/var/www/html
+      # Real PHP upload limits and the extra Apache listener, both shipped next to
+      # this file (relative binds resolve against the compose file's directory) and
+      # mounted read-only. In the base compose so dev and test stacks both get them.
+      - ./uploads.ini:/usr/local/etc/php/conf.d/zz-kizlo-uploads.ini:ro
+      - ./apache-listen.conf:/etc/apache2/conf-enabled/zz-kizlo-listen.conf:ro
     healthcheck:
       # wp-login.php always returns 200 unauthenticated; /wp-json can be gated to 401
       # by plugins, so it's not a reliable liveness probe.

package/dist/cli/wp/compose/uploads.ini

@@ -0,0 +1,12 @@
+; Kizlo local WordPress — raise PHP's upload ceiling for large imports.
+;
+; PHP rejects an oversized request before WordPress (or an upload plugin) ever
+; sees it, so a WordPress hook that only changes the *displayed* limit is not
+; enough. These are the real server limits the local stacks enforce.
+;
+; post_max_size is deliberately larger than upload_max_filesize: a file upload
+; arrives as a multipart POST, so the whole request is a little bigger than the
+; file itself. 2100M leaves headroom above the 2G (2048M) file limit for that
+; envelope. Nothing else (memory_limit, execution time) is touched.
+upload_max_filesize=2G
+post_max_size=2100M

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

@@ -24,6 +24,10 @@ declare function kizloRelease(slug: string): string;
 declare const COMPOSE_FILE: string;
 /** PHP OPcache config, shipped alongside this module and bind-mounted into the local WordPress. */
 declare const OPCACHE_INI: string;
+/** PHP upload-limit config, shipped alongside this module and bind-mounted into the local WordPress. */
+declare const UPLOADS_INI: string;
+/** Apache extra-listener config, shipped alongside this module and bind-mounted into the local WordPress. */
+declare const APACHE_LISTEN_CONF: 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[];
@@ -54,4 +58,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, DEFAULT_WORDPRESS_TAG, INTROSPECTION_META_REL, LOCAL_DIR_REL, OPCACHE_INI, REMAP_ENTRYPOINT, SEED_MARKER_OPTION, SEED_VERSION, TEST_ADMIN, TEST_USER, githubRelease, kizloRelease };
+export { APACHE_LISTEN_CONF, COMPOSE_FILE, CONFIG_FILES, CREDENTIALS_REL, DEFAULT_PLUGINS, DEFAULT_PORT, DEFAULT_WORDPRESS_TAG, INTROSPECTION_META_REL, LOCAL_DIR_REL, OPCACHE_INI, REMAP_ENTRYPOINT, SEED_MARKER_OPTION, SEED_VERSION, TEST_ADMIN, TEST_USER, UPLOADS_INI, githubRelease, kizloRelease };

package/dist/cli/wp/constants.js

@@ -30,6 +30,10 @@ const HERE = dirname(fileURLToPath(import.meta.url));
 const COMPOSE_FILE = resolve(HERE, "compose/docker-compose.yml");
 /** PHP OPcache config, shipped alongside this module and bind-mounted into the local WordPress. */
 const OPCACHE_INI = resolve(HERE, "compose/opcache.ini");
+/** PHP upload-limit config, shipped alongside this module and bind-mounted into the local WordPress. */
+const UPLOADS_INI = resolve(HERE, "compose/uploads.ini");
+/** Apache extra-listener config, shipped alongside this module and bind-mounted into the local WordPress. */
+const APACHE_LISTEN_CONF = resolve(HERE, "compose/apache-listen.conf");
 /** 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");
 const CONFIG_FILES = [
@@ -81,4 +85,4 @@ const TEST_USER = {
 };
 
 //#endregion
-export { COMPOSE_FILE, CONFIG_FILES, CREDENTIALS_REL, DEFAULT_PLUGINS, DEFAULT_PORT, DEFAULT_WORDPRESS_TAG, INTROSPECTION_META_REL, LOCAL_DIR_REL, OPCACHE_INI, REMAP_ENTRYPOINT, SEED_MARKER_OPTION, SEED_VERSION, TEST_ADMIN, TEST_USER, githubRelease, kizloRelease };
+export { APACHE_LISTEN_CONF, COMPOSE_FILE, CONFIG_FILES, CREDENTIALS_REL, DEFAULT_PLUGINS, DEFAULT_PORT, DEFAULT_WORDPRESS_TAG, INTROSPECTION_META_REL, LOCAL_DIR_REL, OPCACHE_INI, REMAP_ENTRYPOINT, SEED_MARKER_OPTION, SEED_VERSION, TEST_ADMIN, TEST_USER, UPLOADS_INI, githubRelease, kizloRelease };

package/dist/context.d.ts

@@ -16,7 +16,7 @@ interface ContextConfig {
   siteSecret: string;
   adapters?: ServiceAdapters;
   credentials: WordPressCredentials;
-  wordpressEndpoints?: object;
+  introspection?: object;
   /** WordPress plugins the registered integrations need, checked against what each response reports. */
   integrationPlugins?: IntegrationPluginRequirement[];
 }

package/dist/context.js

@@ -55,7 +55,7 @@ var Context = class {
 		this.wordpress = createWordPressClient(new WordPressTransport({
 			credentials: config.credentials,
 			onResult: (result) => this.warnIfOutdated(result)
-		}), config.wordpressEndpoints ?? {});
+		}), config.introspection ?? {});
 		this.settings = new SettingsService(this.wordpress);
 		this.email = new EmailService(this.wordpress);
 		this.logger = this.createLogger();

package/dist/kizlo.d.ts

@@ -14,7 +14,7 @@ interface KizloConfig<TIntegrations extends readonly AnyIntegration[]> {
   integrations?: TIntegrations;
   logging?: false | LogLevel;
   credentials: WordPressCredentials;
-  wordpressEndpoints?: object;
+  introspection?: object;
 }
 type RootProcedures<TIntegrations extends readonly AnyIntegration[]> = InferIntegrationProcedures<TIntegrations> & CoreProcedures;
 type S2SClient<TIntegrations extends readonly AnyIntegration[]> = ResultClient<RootProcedures<TIntegrations>>;
@@ -41,21 +41,18 @@ interface CreateKizloOptions<TIntegrations extends readonly AnyIntegration[] = [
   /** Enable Kizlo's built-in console logger at this level. */
   logging?: false | LogLevel;
   /**
-   * The generated endpoints to run against WordPress, plus optional explicit credentials. Pass the
-   * `endpoints` export of your generated barrel. Missing credentials fall back to the `wordpressUrl`,
-   * `wordpressUsername`, and `wordpressPassword` values contributed by integrations.
+   * The generated WordPress introspection tree to run the typed client against. Pass the
+   * `introspection` export of your generated barrel. WordPress credentials resolve from the
+   * `wordpressUrl`, `wordpressUsername`, and `wordpressPassword` values contributed by integrations.
    */
-  wordpress?: {
-    endpoints?: object;
-    credentials?: Partial<WordPressCredentials>;
-  };
+  introspection?: object;
 }
 /**
  * Compose environment sources without letting `undefined` erase an earlier value, then resolve
  * Kizlo's active WordPress connection from the canonical `mode` value.
  */
 declare function integrationEnv(integrations: readonly AnyIntegration[]): EnvReader;
-declare function resolveWordPressConnection(options: Pick<CreateKizloOptions, "wordpress"> | undefined, env: EnvReader): {
+declare function resolveWordPressConnection(env: EnvReader): {
   credentials: WordPressCredentials;
 };
 /**

package/dist/kizlo.js

@@ -30,7 +30,7 @@ var Kizlo = class {
 			adapters: integrations.adapters,
 			siteSecret: config.siteSecret,
 			credentials: config.credentials,
-			wordpressEndpoints: config.wordpressEndpoints,
+			introspection: config.introspection,
 			integrationPlugins: integrations.plugins
 		});
 		this.procedures = Object.assign(Object.assign({}, {
@@ -105,7 +105,7 @@ var Kizlo = class {
 			if (reservedIds.has(integration.id)) throw new KizloError("INTEGRATION_ID_CONFLICT", { message: `The integration id "${integration.id}" is reserved by Kizlo. Choose a different integration id.` });
 			if (integrationIds.has(integration.id)) throw new KizloError("INTEGRATION_ID_CONFLICT", { message: `The integration id "${integration.id}" is registered more than once. Give every integration a unique id.` });
 			integrationIds.add(integration.id);
-			if (!generating) assertIntegrationEndpoints(integration, this.config.wordpressEndpoints ?? {});
+			if (!generating) assertIntegrationEndpoints(integration, this.config.introspection ?? {});
 			plugins.push(...integration.requires?.plugins ?? []);
 			if (integration.procedures && Object.keys(integration.procedures).length > 0) procedures[integration.id] = integration.procedures;
 			for (const handler of integration.events ?? []) events.push(handler);
@@ -161,12 +161,11 @@ function requireEnvValue(name, env) {
 	if (isContractGeneration()) return "";
 	throw new KizloError("MISSING_ENV_VALUE", { message: `Kizlo requires the "${name}" environment value. Provide it through an integration or an explicit createKizlo option.` });
 }
-function resolveWordPressConnection(options, env) {
-	const credentials = options?.wordpress?.credentials;
+function resolveWordPressConnection(env) {
 	return { credentials: {
-		url: credentials?.url ?? requireEnvValue("wordpressUrl", env),
-		username: credentials?.username ?? requireEnvValue("wordpressUsername", env),
-		password: credentials?.password ?? requireEnvValue("wordpressPassword", env)
+		url: requireEnvValue("wordpressUrl", env),
+		username: requireEnvValue("wordpressUsername", env),
+		password: requireEnvValue("wordpressPassword", env)
 	} };
 }
 /**
@@ -176,14 +175,14 @@ function resolveKizloConfig(options) {
 	const integrations = options?.integrations ?? [];
 	const env = integrationEnv(integrations);
 	if (!isContractGeneration()) for (const integration of integrations) assertIntegrationEnv(integration, env);
-	const { credentials } = resolveWordPressConnection(options, env);
+	const { credentials } = resolveWordPressConnection(env);
 	return {
 		baseUrl: options?.baseUrl ?? requireEnvValue("baseUrl", env),
 		siteSecret: options?.siteSecret ?? requireEnvValue("siteSecret", env),
 		integrations,
 		logging: options?.logging,
 		credentials,
-		wordpressEndpoints: options?.wordpress?.endpoints
+		introspection: options?.introspection
 	};
 }
 /**

package/dist/package.js

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

package/dist/procedures.d.ts

@@ -44,7 +44,7 @@ declare const CORE_PROCEDURES: {
         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;
@@ -99,7 +99,7 @@ declare const CORE_PROCEDURES: {
         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;
@@ -136,7 +136,7 @@ declare const CORE_PROCEDURES: {
         exclude?: string | number | (string | number)[] | undefined;
         include?: string | number | (string | number)[] | undefined;
         order?: "asc" | "desc" | undefined;
-        orderBy?: "id" | "count" | "slug" | "name" | "description" | "include" | "include_slugs" | "term_group" | undefined;
+        orderBy?: "count" | "id" | "slug" | "name" | "description" | "include" | "include_slugs" | "term_group" | undefined;
         hideEmpty?: string | boolean | undefined;
         parent?: string | number | undefined;
         post?: string | number | undefined;
@@ -172,7 +172,7 @@ declare const CORE_PROCEDURES: {
         exclude?: string | number | (string | number)[] | undefined;
         include?: string | number | (string | number)[] | undefined;
         order?: "asc" | "desc" | undefined;
-        orderBy?: "id" | "count" | "slug" | "name" | "description" | "include" | "include_slugs" | "term_group" | undefined;
+        orderBy?: "count" | "id" | "slug" | "name" | "description" | "include" | "include_slugs" | "term_group" | undefined;
         hideEmpty?: string | boolean | undefined;
         post?: string | number | undefined;
         slug?: string | string[] | undefined;
@@ -292,7 +292,7 @@ declare const CORE_PROCEDURES: {
           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;
@@ -371,7 +371,7 @@ declare const CORE_PROCEDURES: {
           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;
@@ -507,7 +507,7 @@ declare const CORE_PROCEDURES: {
         include?: string | number | (string | number)[] | undefined;
         offset?: string | number | undefined;
         order?: "asc" | "desc" | undefined;
-        orderby?: "id" | "date" | "parent" | "include" | "post" | undefined;
+        orderby?: "date" | "id" | "parent" | "include" | "post" | undefined;
         parent?: string | number | (string | number)[] | undefined;
         parentExclude?: string | number | (string | number)[] | undefined;
         post?: string | number | (string | number)[] | undefined;

package/dist/test.d.ts

@@ -1,5 +1,5 @@
 import { DevPluginSource, Fixture, FixtureCleanupFn, FixtureSeedFn, FixtureSettleFn, JsonValue, LocalPlugin, PluginSource, SeedContext, SettleContext, TestAdminUser, TestCredentials, TestUser, defineFixture, isLocalPlugin } from "./cli/wp/types.js";
-import { COMPOSE_FILE, CONFIG_FILES, CREDENTIALS_REL, DEFAULT_PLUGINS, DEFAULT_PORT, DEFAULT_WORDPRESS_TAG, INTROSPECTION_META_REL, LOCAL_DIR_REL, OPCACHE_INI, REMAP_ENTRYPOINT, SEED_MARKER_OPTION, SEED_VERSION, TEST_ADMIN, TEST_USER, githubRelease, kizloRelease } from "./cli/wp/constants.js";
+import { APACHE_LISTEN_CONF, COMPOSE_FILE, CONFIG_FILES, CREDENTIALS_REL, DEFAULT_PLUGINS, DEFAULT_PORT, DEFAULT_WORDPRESS_TAG, INTROSPECTION_META_REL, LOCAL_DIR_REL, OPCACHE_INI, REMAP_ENTRYPOINT, SEED_MARKER_OPTION, SEED_VERSION, TEST_ADMIN, TEST_USER, UPLOADS_INI, githubRelease, kizloRelease } from "./cli/wp/constants.js";
 import { DockerStack, DockerStatus, RunResult, Stack, StackStatus, compose, composeDown, composePull, composeStop, composeUp, createStack, dockerAvailable, dockerHint, dockerStatus, runningProjectContainers, stackStatus, stopProjectContainers, wpCli, wpEval } from "./cli/wp/docker.js";
 import { activateLocalPlugin, credentialsPath, ensurePlugin, ensurePlugins, findConfigDir, getTestCredentials, isSeeded, recordedPort, resolvePluginSource, settleFixtures } from "./cli/wp/utils.js";
 import { TestAuthAdapterUser, toTestUser } from "./test/users.js";
@@ -8,4 +8,4 @@ import { CAPTCHA_TEST_TOKEN_PASS, captchaMock } from "./test/captcha.js";
 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, DEFAULT_WORDPRESS_TAG, DevPluginSource, DockerStack, DockerStatus, Fixture, FixtureCleanupFn, FixtureSeedFn, FixtureSettleFn, INTROSPECTION_META_REL, JsonValue, LOCAL_DIR_REL, LocalPlugin, OPCACHE_INI, PluginSource, REMAP_ENTRYPOINT, RunResult, SEED_MARKER_OPTION, SEED_VERSION, SeedContext, SettleContext, Stack, StackStatus, 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, getTestCredentials, githubRelease, isLocalPlugin, isSeeded, kizloRelease, menuFixture, postFixture, recordedPort, resolvePluginSource, runningProjectContainers, settleFixtures, stackStatus, stopProjectContainers, testAuthAdapter, toTestUser, wpCli, wpEval };
+export { APACHE_LISTEN_CONF, CAPTCHA_TEST_TOKEN_PASS, COMPOSE_FILE, CONFIG_FILES, CREDENTIALS_REL, DEFAULT_PLUGINS, DEFAULT_PORT, DEFAULT_WORDPRESS_TAG, DevPluginSource, DockerStack, DockerStatus, Fixture, FixtureCleanupFn, FixtureSeedFn, FixtureSettleFn, INTROSPECTION_META_REL, JsonValue, LOCAL_DIR_REL, LocalPlugin, OPCACHE_INI, PluginSource, REMAP_ENTRYPOINT, RunResult, SEED_MARKER_OPTION, SEED_VERSION, SeedContext, SettleContext, Stack, StackStatus, TEST_ADMIN, TEST_USER, TestAdminUser, TestAuthAdapterUser, TestCredentials, TestUser, UPLOADS_INI, activateLocalPlugin, captchaMock, compose, composeDown, composePull, composeStop, composeUp, coreFixtures, createStack, credentialsPath, defineFixture, dockerAvailable, dockerHint, dockerStatus, ensurePlugin, ensurePlugins, findConfigDir, getTestCredentials, githubRelease, isLocalPlugin, isSeeded, kizloRelease, menuFixture, postFixture, recordedPort, resolvePluginSource, runningProjectContainers, settleFixtures, stackStatus, stopProjectContainers, testAuthAdapter, toTestUser, wpCli, wpEval };

package/dist/test.js

@@ -1,5 +1,5 @@
 import { defineFixture, isLocalPlugin } from "./cli/wp/types.js";
-import { COMPOSE_FILE, CONFIG_FILES, CREDENTIALS_REL, DEFAULT_PLUGINS, DEFAULT_PORT, DEFAULT_WORDPRESS_TAG, INTROSPECTION_META_REL, LOCAL_DIR_REL, OPCACHE_INI, REMAP_ENTRYPOINT, SEED_MARKER_OPTION, SEED_VERSION, TEST_ADMIN, TEST_USER, githubRelease, kizloRelease } from "./cli/wp/constants.js";
+import { APACHE_LISTEN_CONF, COMPOSE_FILE, CONFIG_FILES, CREDENTIALS_REL, DEFAULT_PLUGINS, DEFAULT_PORT, DEFAULT_WORDPRESS_TAG, INTROSPECTION_META_REL, LOCAL_DIR_REL, OPCACHE_INI, REMAP_ENTRYPOINT, SEED_MARKER_OPTION, SEED_VERSION, TEST_ADMIN, TEST_USER, UPLOADS_INI, githubRelease, kizloRelease } from "./cli/wp/constants.js";
 import { compose, composeDown, composePull, composeStop, composeUp, createStack, dockerAvailable, dockerHint, dockerStatus, runningProjectContainers, stackStatus, stopProjectContainers, wpCli, wpEval } from "./cli/wp/docker.js";
 import { activateLocalPlugin, credentialsPath, ensurePlugin, ensurePlugins, findConfigDir, getTestCredentials, isSeeded, recordedPort, resolvePluginSource, settleFixtures } from "./cli/wp/utils.js";
 import { testAuthAdapter } from "./test/auth.js";
@@ -9,4 +9,4 @@ import { postFixture } from "./post/fixture.js";
 import { coreFixtures } from "./test/fixtures.js";
 import { toTestUser } from "./test/users.js";
 
-export { CAPTCHA_TEST_TOKEN_PASS, COMPOSE_FILE, CONFIG_FILES, CREDENTIALS_REL, DEFAULT_PLUGINS, DEFAULT_PORT, DEFAULT_WORDPRESS_TAG, INTROSPECTION_META_REL, 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, getTestCredentials, githubRelease, isLocalPlugin, isSeeded, kizloRelease, menuFixture, postFixture, recordedPort, resolvePluginSource, runningProjectContainers, settleFixtures, stackStatus, stopProjectContainers, testAuthAdapter, toTestUser, wpCli, wpEval };
+export { APACHE_LISTEN_CONF, CAPTCHA_TEST_TOKEN_PASS, COMPOSE_FILE, CONFIG_FILES, CREDENTIALS_REL, DEFAULT_PLUGINS, DEFAULT_PORT, DEFAULT_WORDPRESS_TAG, INTROSPECTION_META_REL, LOCAL_DIR_REL, OPCACHE_INI, REMAP_ENTRYPOINT, SEED_MARKER_OPTION, SEED_VERSION, TEST_ADMIN, TEST_USER, UPLOADS_INI, activateLocalPlugin, captchaMock, compose, composeDown, composePull, composeStop, composeUp, coreFixtures, createStack, credentialsPath, defineFixture, dockerAvailable, dockerHint, dockerStatus, ensurePlugin, ensurePlugins, findConfigDir, getTestCredentials, githubRelease, isLocalPlugin, isSeeded, kizloRelease, menuFixture, postFixture, recordedPort, resolvePluginSource, runningProjectContainers, settleFixtures, stackStatus, stopProjectContainers, testAuthAdapter, toTestUser, wpCli, wpEval };

package/dist/wordpress/generate.js

@@ -383,7 +383,7 @@ function renderRegistries(tree, document) {
 	return [
 		`declare module "kizlo" {`,
 		`\tinterface WordPressClientRegistry {`,
-		`\t\tendpoints: typeof endpoints`,
+		`\t\tintrospection: typeof introspection`,
 		`\t}`,
 		`\tinterface WordPressEndpointRegistry {`,
 		...endpoints,
@@ -431,8 +431,8 @@ function generateWordPressModule(document) {
 	const endpointBody = renderEndpointNode(tree, "	");
 	const moduleBody = [
 		body,
-		`export const endpoints = ${endpointBody}`,
-		`export type WordPressClient = WP_Client<typeof endpoints>`,
+		`export const introspection = ${endpointBody}`,
+		`export type WordPressClient = WP_Client<typeof introspection>`,
 		renderRegistries(tree, document)
 	].join(DECLARATION_SEPARATOR);
 	const imports = `import { ${kizloImports(moduleBody, endpointBody !== "{}")} } from "kizlo"`;

package/dist/wordpress/types.d.ts

@@ -48,7 +48,7 @@ interface WordPressCustomFieldsRegistry {}
  * so a freshly scaffolded project compiles against endpoints it has not described yet.
  */
 type ActiveWordPressClient = WordPressClientRegistry extends {
-  endpoints: infer TEndpoints extends object;
+  introspection: infer TEndpoints extends object;
 } ? WP_Client<TEndpoints> & WordPressTransport : WordPressTransport;
 /** Every raw WordPress operation path generated for the active project. */
 type WP_EndpointPath = keyof WordPressEndpointRegistry extends never ? string : Extract<keyof WordPressEndpointRegistry, string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kizlo",
-  "version": "0.19.0",
+  "version": "0.20.1",
   "type": "module",
   "description": "A headless WordPress framework for TypeScript.",
   "keywords": [