kizlo 0.18.0 → 0.20.0

package/dist/config.d.ts

@@ -2,14 +2,28 @@ import { Fixture } from "./cli/wp/types.js";
 import "./test.js";
 
 //#region src/config.d.ts
+
+/**
+ * Where Kizlo generates, and what it watches. A string is the home directory Kizlo owns the layout
+ * under: sources in `<dir>/server`, and the generated files (`contract.json`, the barrel, and
+ * `introspection.ts`) under `<dir>/server/generated`. The object form sets each path on its own. Omit
+ * `server` and there are no sources to watch and no contract is built, so only the introspection is
+ * generated (the shape a package that ships procedures but no server takes).
+ */
+type KizloDir = string | {
+  /** Server sources (extensions and procedures). Watched by `kizlo dev`; its presence is what builds a contract. */
+  server?: string;
+  /** Where `contract.json` and the generated barrel are written. Defaults to `generated/` under `server`. */
+  contract?: string;
+  /** Where the generated `introspection.ts` is written. Defaults to `generated/` under `server`. */
+  introspection?: string;
+};
 interface KizloDevConfig {
   /**
-   * Run local WordPress under `kizlo dev`. When `true`, `kizlo dev` boots a Docker WordPress in
-   * `.kizlo/local` alongside the contract watcher; when unset or `false`, it runs the watcher alone
-   * (for a project pointing at your own WordPress). Set for you by `kizlo create` / `kizlo init`
-   * when you choose local WordPress.
+   * Run the dev stack. On by default when local WordPress is enabled; set `false` to keep local
+   * WordPress on for `kizlo test` while `kizlo dev` runs the contract watcher alone.
    */
-  local?: boolean;
+  enable?: boolean;
   /** Published WP port (default 8080). */
   port?: number;
   /**
@@ -17,8 +31,8 @@ interface KizloDevConfig {
    * Hub: a bare version (`"7.1.0"`), or a full tag (`"7.1.0-php8.3-apache"`) when you need
    * a specific PHP. Defaults to `latest`, so an unconfigured project gets current WordPress.
    *
-   * Worth setting once you commit a generated WordPress client, which is derived from
-   * whatever the stack serves: on `latest` that client goes stale the day WordPress ships.
+   * Worth setting once you commit a generated introspection, which is derived from
+   * whatever the stack serves: on `latest` that introspection goes stale the day WordPress ships.
    *
    * An existing install keeps the core files it was provisioned with, so changing this
    * takes effect on the next `kizlo dev reset` and Kizlo says so when the two disagree.
@@ -45,27 +59,24 @@ interface KizloDevConfig {
 }
 interface KizloTestConfig {
   /**
-   * Run local WordPress under `kizlo test`. When `true`, `kizlo test` boots a disposable Docker
-   * WordPress, seeds it, and runs your suite against it; when unset or `false`, `kizlo test` just
-   * runs your project's test script. Set for you by `kizlo create` / `kizlo init` when you choose
-   * local WordPress.
+   * Run the test stack. On by default when local WordPress is enabled; set `false` to keep local
+   * WordPress on for `kizlo dev` while `kizlo test` just runs the project's own test script.
+   */
+  enable?: boolean;
+  /**
+   * Fall back to the dev stack's `version` and `fixtures` when this stack leaves them unset (default
+   * `true`), so the two stacks a local-WordPress project always wants together are declared once.
+   * Set `false` to configure the test stack independently, taking Kizlo's defaults where it is silent.
    */
-  local?: boolean;
+  inherit?: boolean;
   /** Published WP port (default 8889). */
   port?: number;
   /**
    * WordPress version the local stack boots, given as the tag after `wordpress:` on Docker
-   * Hub: a bare version (`"7.1.0"`), or a full tag (`"7.1.0-php8.3-apache"`) when you need
-   * a specific PHP. Defaults to `latest`, so an unconfigured project gets current WordPress.
-   *
-   * Worth setting once you commit a generated WordPress client, which is derived from
-   * whatever the stack serves: on `latest` that client goes stale the day WordPress ships.
-   *
-   * An existing install keeps the core files it was provisioned with, so changing this
-   * takes effect on the next `kizlo test reset` and Kizlo says so when the two disagree.
+   * Hub. Falls back to the dev stack's `version` unless `inherit` is `false`; defaults to `latest`.
    */
   version?: string;
-  /** Integration fixtures to install + seed. */
+  /** Integration fixtures to install + seed. Falls back to the dev stack's `fixtures` unless `inherit` is `false`. */
   fixtures?: Fixture[];
   /**
    * Package manager used to launch the test script (default: auto-detected from
@@ -78,20 +89,12 @@ interface KizloTestConfig {
    */
   command?: string;
 }
-interface KizloGlobalConfig {
-  /**
-   * Kizlo's home directory. Kizlo owns the layout inside it: your server
-   * (`server/`, whose `index.ts` exports `procedures` plus your integrations), the
-   * browser `client.ts`, and the generated contract.
-   * @default 'src/lib/kizlo' (or 'lib/kizlo' without a src dir)
-   */
-  dir?: string;
+interface KizloLocalConfig {
   /**
-   * Import alias prefix for generated imports (e.g. `@`). Recorded by `kizlo init`
-   * from your `--alias` flag or its prompt, so later runs reuse it instead of asking
-   * again; an empty string (`""`) is the recorded choice to use relative imports.
+   * Enable local Docker WordPress (default `true` in this object form). Set `false` to keep the
+   * stacks configured but off, the same as omitting `local` entirely.
    */
-  alias?: string;
+  enable?: boolean;
   /**
    * Base name for the local Docker stacks (`kizlo-<name>-dev`, `kizlo-<name>-test`). Defaults
    * to the sanitized `package.json` name, falling back to the config dir basename.
@@ -99,8 +102,8 @@ interface KizloGlobalConfig {
   name?: string;
   /**
    * Give each branch its own local Docker stacks, by appending the checked-out branch to
-   * {@link name} (`kizlo-<name>-<branch>-dev`). Off unless set, since the stacks it isolates
-   * are the ones an existing project is already using.
+   * {@link KizloLocalConfig.name} (`kizlo-<name>-<branch>-dev`). Off unless set, since the stacks it
+   * isolates are the ones an existing project is already using.
    *
    * Turn it on when you work in several checkouts at once, typically git worktrees: without it
    * every checkout of a project resolves to one stack, so parallel `kizlo dev` and `kizlo test`
@@ -109,20 +112,31 @@ interface KizloGlobalConfig {
    * A detached `HEAD` names no branch and keeps the unsuffixed stack.
    */
   worktrees?: boolean;
-  /**
-   * Directory to write the WordPress client into, as `<wordpressClientDir>/wordpress.ts`. For a package or
-   * workspace that ships procedures but no Kizlo server: there is no procedure tree to build a contract from,
-   * yet those procedures still call the generated tree, so they need the client on its own.
-   *
-   * Independent of `dir`. An app leaves this unset and gets its client inside `dir` alongside the
-   * contract; set both only if a project is somehow each of those things at once.
-   */
-  wordpressClientDir?: string;
-  /** Local WordPress and contract watcher run by `kizlo dev`. */
+  /** The dev stack run by `kizlo dev`. */
   dev?: KizloDevConfig;
-  /** WordPress test environment run by `kizlo test`. */
+  /** The test stack run by `kizlo test`. Inherits `version` and `fixtures` from {@link KizloLocalConfig.dev}. */
   test?: KizloTestConfig;
 }
+interface KizloGlobalConfig {
+  /**
+   * Where Kizlo generates, and what it watches. A string names the home directory Kizlo owns the
+   * layout under; the object form sets the server, contract, and introspection paths independently.
+   * @default 'src/lib/kizlo' (or 'lib/kizlo' without a src dir)
+   */
+  dir?: KizloDir;
+  /**
+   * Import alias prefix for generated imports (e.g. `@`). Recorded by `kizlo init`
+   * from your `--alias` flag or its prompt, so later runs reuse it instead of asking
+   * again; an empty string (`""`) is the recorded choice to use relative imports.
+   */
+  alias?: string;
+  /**
+   * Local Docker WordPress, off unless set. `true` enables both the dev and test stacks with
+   * defaults; the object form enables and configures them, and is where the stack name, the
+   * per-branch `worktrees` toggle, and the two stacks live.
+   */
+  local?: boolean | KizloLocalConfig;
+}
 declare function defineConfig(config: KizloGlobalConfig): KizloGlobalConfig;
 //#endregion
-export { KizloDevConfig, KizloGlobalConfig, KizloTestConfig, defineConfig };
+export { KizloDevConfig, KizloDir, KizloGlobalConfig, KizloLocalConfig, KizloTestConfig, defineConfig };

package/dist/context.d.ts

@@ -16,11 +16,11 @@ 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[];
 }
-type AuthUserFn = () => Promise<AuthUser | null>;
+type SessionFn = () => Promise<AuthUser | null>;
 type ConnInfoFn = () => Promise<ConnInfo | null>;
 type VerifyCaptchaFn = (token: string) => Promise<boolean>;
 type VerifyPreviewTokenFn = (token: string) => Promise<PreviewTokenPayload | null>;
@@ -46,8 +46,8 @@ interface ProcedureContext {
   config: ContextConfig;
   /** Resolve the caller's connection info (IP, geo) via the geo adapter, or `null`. */
   getConnInfo: ConnInfoFn;
-  /** Resolve the authenticated user via the auth adapter, or `null`. */
-  getAuthUser: AuthUserFn;
+  /** Resolve the authenticated session via the auth adapter, or `null`. */
+  getSession: SessionFn;
   /** Read and write cookies through the cookies adapter. */
   cookies: CookiesStorage;
   /** Verify a CAPTCHA token via the captcha adapter. */
@@ -84,7 +84,7 @@ declare class Context {
     email: EmailService;
     getConnInfo: ConnInfoFn;
     verifyCaptcha: VerifyCaptchaFn;
-    getAuthUser: AuthUserFn;
+    getSession: SessionFn;
     verifyPreviewToken: VerifyPreviewTokenFn;
     cookies: CookiesStorage;
     invokedBy: "client";
@@ -98,7 +98,7 @@ declare class Context {
     wordpress: WordPressTransport;
     settings: SettingsService;
     email: EmailService;
-    getAuthUser: AuthUserFn;
+    getSession: SessionFn;
     getConnInfo: ConnInfoFn;
     verifyCaptcha: VerifyCaptchaFn;
     verifyPreviewToken: VerifyPreviewTokenFn;
@@ -107,9 +107,9 @@ declare class Context {
   private createRestCookieStorage;
   private createVerifyCaptchaFn;
   private createConnInfoFn;
-  private createGetUserFn;
+  private createGetSessionFn;
   private createVerifyPreviewTokenFn;
   private createLogger;
 }
 //#endregion
-export { AuthUserFn, ConnInfoFn, Context, ContextConfig, ProcedureContext, VerifyCaptchaFn, VerifyPreviewTokenFn };
+export { ConnInfoFn, Context, ContextConfig, ProcedureContext, SessionFn, VerifyCaptchaFn, VerifyPreviewTokenFn };

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();
@@ -102,7 +102,7 @@ var Context = class {
 			email: this.email,
 			getConnInfo: this.createConnInfoFn(request),
 			verifyCaptcha: this.createVerifyCaptchaFn(request),
-			getAuthUser: this.createGetUserFn(request),
+			getSession: this.createGetSessionFn(request),
 			verifyPreviewToken: this.createVerifyPreviewTokenFn(),
 			cookies: this.createRestCookieStorage(request, headers),
 			invokedBy: "client"
@@ -118,7 +118,7 @@ var Context = class {
 			wordpress: this.wordpress,
 			settings: this.settings,
 			email: this.email,
-			getAuthUser: this.createGetUserFn(null),
+			getSession: this.createGetSessionFn(null),
 			getConnInfo: this.createConnInfoFn(null),
 			verifyCaptcha: this.createVerifyCaptchaFn(null),
 			verifyPreviewToken: this.createVerifyPreviewTokenFn(),
@@ -176,9 +176,9 @@ var Context = class {
 			return await this.config.adapters?.geo?.getConnInfo?.(request) ?? null;
 		};
 	}
-	createGetUserFn(request) {
+	createGetSessionFn(request) {
 		return async () => {
-			return await Promise.resolve(this.config.adapters?.auth?.getUser?.(request)) ?? null;
+			return await Promise.resolve(this.config.adapters?.auth?.getSession?.(request)) ?? null;
 		};
 	}
 	createVerifyPreviewTokenFn() {

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import { buildWordPressRequest, createWordPressClient, wpEndpoint } from "./word
 import { isWordPressResourceError } from "./wordpress/utils.js";
 import "./wordpress/index.js";
 import { DevPluginSource, Fixture, FixtureCleanupFn, FixtureSeedFn, FixtureSettleFn, JsonValue, LocalPlugin, PluginSource, SeedContext, SettleContext, TestAdminUser, TestCredentials, TestUser, defineFixture, isLocalPlugin } from "./cli/wp/types.js";
-import { AuthAdapter, AuthGetUser, AuthUser, authMock, createAuthAdapter } from "./adapters/auth.js";
+import { AuthAdapter, AuthGetSession, AuthUser, authMock, createAuthAdapter } from "./adapters/auth.js";
 import { CaptchaAdapter, altcha, arkose, createCaptchaAdapter, friendlyCaptcha, hcaptcha, recaptcha, turnstile } from "./adapters/captcha.js";
 import { CurrencyFormat, IdentifierInput, LIST_ORDER, ListMetadata, ListOrder, PreviewTokenData, PreviewTokenPayload, customFieldsSchema } from "./shared/schema.js";
 import { AnyContext, AnyNestedClient, CookiesAdapter, CookiesDeleteAll, CookiesGetAll, CookiesSetAll, HTTPMethod, List, MaybeOptionalOptions, RedirectInput, RedirectStatus } from "./shared/types.js";
@@ -18,7 +18,7 @@ import { AuthorsSettings, AuthorsSettingsInput, BrandSettings, BrandSettingsInpu
 import { IconDescriptor, ManifestIcon, ResolvedIcons, resolveIcons } from "./brand/icons.js";
 import { CookiesStorage } from "./cookie.js";
 import { SettingsService } from "./settings/service.js";
-import { AuthUserFn, ConnInfoFn, Context, ContextConfig, ProcedureContext, VerifyCaptchaFn, VerifyPreviewTokenFn } from "./context.js";
+import { ConnInfoFn, Context, ContextConfig, ProcedureContext, SessionFn, VerifyCaptchaFn, VerifyPreviewTokenFn } from "./context.js";
 import { Post, PostCustomFields, PostCustomFieldsSchema } from "./post/schema.js";
 import { Page, PageCustomFields, PageCustomFieldsSchema } from "./page/schema.js";
 import { Category, CategoryCustomFields, CategoryCustomFieldsSchema } from "./category/schema.js";
@@ -43,4 +43,4 @@ import { ShaAlgorithm, compare, hash, hmac } from "./shared/crypto.js";
 import { Identifier, parseIdentifier } from "./shared/identifier.js";
 import { createOrpcRouter } from "./shared/router.js";
 import { deserializeCurrencyFormat, deserializeListMetadata, emptyList, serializeCurrencyFormat } from "./shared/serialize.js";
-export { ActiveWordPressClient, AnyContext, AnyEventSchema, AnyEvents, AnyIntegration, AnyKizloConfig, AnyMiddleware, AnyNestedClient, AnyProcedure, AnyProcedureTree, AuthAdapter, AuthGetUser, AuthUser, AuthUserFn, AuthorsSettings, AuthorsSettingsInput, BaseHandlerOptions, BrandSettings, BrandSettingsInput, COMMON_ERRORS, CONTENT_TYPES, CORE_PROCEDURES, CaptchaAdapter, type Category, type CategoryCustomFields, CategoryCustomFieldsSchema, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, ConnInfo, ConnInfoFn, ConsoleLogAdapterOptions, ContentType, Context, ContextConfig, Contract, ContractProcedure, CookiesAdapter, CookiesDeleteAll, CookiesGetAll, CookiesSetAll, CookiesStorage, CoreProcedures, CrawlingSettings, CrawlingSettingsInput, CreateKizloOptions, CreateSitemapRouteOptions, CurrencyFormat, DefinedErrorMapLike, DevPluginSource, EnvReader, EnvRecord, EnvSource, ErrorDefinition, EventHandler, EventHandlerFn, ExtractIntegrationProcedures, ExtractMiddlewareContextOutput, ExtractParams, ExtractProcedureByScope, Fixture, FixtureCleanupFn, FixtureSeedFn, FixtureSettleFn, GeoAdapter, GeoGetConnInfo, HTTPMethod, HeadlessSettings, HeadlessSettingsInput, IconDescriptor, Identifier, IdentifierInput, IdentitySettings, IdentitySettingsInput, InferEventUnion, InferIntegrationProcedures, InferMiddlewares, InferProcedureData, InferProcedureError, InferProcedureInput, InferProcedureResult, Integration, IntegrationRequirements, InvocationScope, JsonValue, Kizlo, KizloClient, KizloClientConfig, KizloConfig, KizloEnv, KizloError, KizloErrorOptions, KizloErrorUnion, KizloResult, LIST_ORDER, List, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, LocalPlugin, LogLevel, LogPayload, Logger, LoggerAdapter, ManifestIcon, MaybeCallerOptions, MaybeOptionalOptions, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, OpenapiPart, OrganizationFounder, OrganizationSettings, OrganizationSettingsInput, type Page, type PageCustomFields, PageCustomFieldsSchema, PersonSettings, PersonSettingsInput, PluginSource, type Post, type PostCustomFields, PostCustomFieldsSchema, PostStatusDefinition, PostTypeSettings, PostTypeSettingsInput, PreviewTokenData, PreviewTokenPayload, Procedure, ProcedureContext, ProcedureErrors, ProcedureHandler, ProcedureMethod, ProcedureOptions, ProcedureTreeDepthTuple, RedirectInput, RedirectStatus, ResolveParamsPart, ResolvedIcons, ResolvedSchemaInput, ResolvedSchemaOutput, ResultClient, Robots, RobotsRule, RootProcedures, S2SClient, SITEMAP_BASE, SITEMAP_INDEX_SLUG, SchemaIO, SeedContext, Seo, SeoHead, SeoSchema, ServiceAdapters, Settings, SettingsService, SettleContext, ShaAlgorithm, SiteSettings, SiteSettingsInput, Sitemap, SitemapIndex, SitemapIndexEntry, SitemapList, SitemapRouteExtra, SitemapUrl, SitemapUrlImage, SitemapUrlList, SocialProfile, type Tag, type TagCustomFields, TagCustomFieldsSchema, TaxonomySettings, TaxonomySettingsInput, TestAdminUser, TestCredentials, TestUser, ThrowableErrorFn, ThrowableErrorMap, UploadsSettings, UploadsSettingsInput, VerifyCaptchaFn, VerifyPreviewTokenFn, WEB_MANIFEST_ROUTE, WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapUrl, WPK_SitemapUrlImage, WP_CallOptions, WP_Client, WP_CommonErrorCode, WP_CurrencyFormat, WP_CustomFields, WP_CustomFieldsPath, WP_Endpoint, WP_EndpointData, WP_EndpointDefinition, WP_EndpointError, WP_EndpointInput, WP_EndpointPath, WP_EndpointResult, WP_Error, WP_ErrorData, WP_Failure, WP_List, WP_ListMetadata, WP_RequestBuild, WP_RequestContentType, WP_RequestInput, WP_RequestMethod, WP_ResponseContentType, WP_Result, WP_Success, WP_TransportFailure, WP_TypedHeaders, WebManifest, WebhookOptions, WebhookSettings, WebhookSettingsInput, WithCommonErrorMap, WordPressClientRegistry, WordPressCredentials, WordPressCustomFieldsRegistry, WordPressEndpointRegistry, WordPressEnv, WordPressTransport, WordPressTransportOptions, WordPressTransportResult, altcha, arkose, assertIntegrationEndpoints, assertIntegrationEnv, authMock, buildProcedure, buildWebManifest, buildWordPressRequest, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createGeoAdapter, createIntegration, createKizlo, createKizloClient, createLoggerAdapter, createManifestRoute, createMiddleware, createOrpcRouter, createProcedure, createResultClient, createSitemapRedirectRoute, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, createWordPressClient, customFieldsSchema, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, deserializeSeo, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, integrationEnv, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, mergeServiceAdapters, missingEndpoints, missingEnv, noopAdapter, parseIdentifier, parseSitemapSlug, readEnv, recaptcha, renderJsonLd, renderSitemapIndex, renderUrlSet, resolveIcons, resolveKizloConfig, resolveWordPressConnection, restoreContract, schemaType, serializeCurrencyFormat, sitemapEntryPath, toKizloError, turnstile, wpEndpoint, xmlResponse };
+export { ActiveWordPressClient, AnyContext, AnyEventSchema, AnyEvents, AnyIntegration, AnyKizloConfig, AnyMiddleware, AnyNestedClient, AnyProcedure, AnyProcedureTree, AuthAdapter, AuthGetSession, AuthUser, AuthorsSettings, AuthorsSettingsInput, BaseHandlerOptions, BrandSettings, BrandSettingsInput, COMMON_ERRORS, CONTENT_TYPES, CORE_PROCEDURES, CaptchaAdapter, type Category, type CategoryCustomFields, CategoryCustomFieldsSchema, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, ConnInfo, ConnInfoFn, ConsoleLogAdapterOptions, ContentType, Context, ContextConfig, Contract, ContractProcedure, CookiesAdapter, CookiesDeleteAll, CookiesGetAll, CookiesSetAll, CookiesStorage, CoreProcedures, CrawlingSettings, CrawlingSettingsInput, CreateKizloOptions, CreateSitemapRouteOptions, CurrencyFormat, DefinedErrorMapLike, DevPluginSource, EnvReader, EnvRecord, EnvSource, ErrorDefinition, EventHandler, EventHandlerFn, ExtractIntegrationProcedures, ExtractMiddlewareContextOutput, ExtractParams, ExtractProcedureByScope, Fixture, FixtureCleanupFn, FixtureSeedFn, FixtureSettleFn, GeoAdapter, GeoGetConnInfo, HTTPMethod, HeadlessSettings, HeadlessSettingsInput, IconDescriptor, Identifier, IdentifierInput, IdentitySettings, IdentitySettingsInput, InferEventUnion, InferIntegrationProcedures, InferMiddlewares, InferProcedureData, InferProcedureError, InferProcedureInput, InferProcedureResult, Integration, IntegrationRequirements, InvocationScope, JsonValue, Kizlo, KizloClient, KizloClientConfig, KizloConfig, KizloEnv, KizloError, KizloErrorOptions, KizloErrorUnion, KizloResult, LIST_ORDER, List, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, LocalPlugin, LogLevel, LogPayload, Logger, LoggerAdapter, ManifestIcon, MaybeCallerOptions, MaybeOptionalOptions, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, OpenapiPart, OrganizationFounder, OrganizationSettings, OrganizationSettingsInput, type Page, type PageCustomFields, PageCustomFieldsSchema, PersonSettings, PersonSettingsInput, PluginSource, type Post, type PostCustomFields, PostCustomFieldsSchema, PostStatusDefinition, PostTypeSettings, PostTypeSettingsInput, PreviewTokenData, PreviewTokenPayload, Procedure, ProcedureContext, ProcedureErrors, ProcedureHandler, ProcedureMethod, ProcedureOptions, ProcedureTreeDepthTuple, RedirectInput, RedirectStatus, ResolveParamsPart, ResolvedIcons, ResolvedSchemaInput, ResolvedSchemaOutput, ResultClient, Robots, RobotsRule, RootProcedures, S2SClient, SITEMAP_BASE, SITEMAP_INDEX_SLUG, SchemaIO, SeedContext, Seo, SeoHead, SeoSchema, ServiceAdapters, SessionFn, Settings, SettingsService, SettleContext, ShaAlgorithm, SiteSettings, SiteSettingsInput, Sitemap, SitemapIndex, SitemapIndexEntry, SitemapList, SitemapRouteExtra, SitemapUrl, SitemapUrlImage, SitemapUrlList, SocialProfile, type Tag, type TagCustomFields, TagCustomFieldsSchema, TaxonomySettings, TaxonomySettingsInput, TestAdminUser, TestCredentials, TestUser, ThrowableErrorFn, ThrowableErrorMap, UploadsSettings, UploadsSettingsInput, VerifyCaptchaFn, VerifyPreviewTokenFn, WEB_MANIFEST_ROUTE, WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapUrl, WPK_SitemapUrlImage, WP_CallOptions, WP_Client, WP_CommonErrorCode, WP_CurrencyFormat, WP_CustomFields, WP_CustomFieldsPath, WP_Endpoint, WP_EndpointData, WP_EndpointDefinition, WP_EndpointError, WP_EndpointInput, WP_EndpointPath, WP_EndpointResult, WP_Error, WP_ErrorData, WP_Failure, WP_List, WP_ListMetadata, WP_RequestBuild, WP_RequestContentType, WP_RequestInput, WP_RequestMethod, WP_ResponseContentType, WP_Result, WP_Success, WP_TransportFailure, WP_TypedHeaders, WebManifest, WebhookOptions, WebhookSettings, WebhookSettingsInput, WithCommonErrorMap, WordPressClientRegistry, WordPressCredentials, WordPressCustomFieldsRegistry, WordPressEndpointRegistry, WordPressEnv, WordPressTransport, WordPressTransportOptions, WordPressTransportResult, altcha, arkose, assertIntegrationEndpoints, assertIntegrationEnv, authMock, buildProcedure, buildWebManifest, buildWordPressRequest, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createGeoAdapter, createIntegration, createKizlo, createKizloClient, createLoggerAdapter, createManifestRoute, createMiddleware, createOrpcRouter, createProcedure, createResultClient, createSitemapRedirectRoute, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, createWordPressClient, customFieldsSchema, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, deserializeSeo, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, integrationEnv, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, mergeServiceAdapters, missingEndpoints, missingEnv, noopAdapter, parseIdentifier, parseSitemapSlug, readEnv, recaptcha, renderJsonLd, renderSitemapIndex, renderUrlSet, resolveIcons, resolveKizloConfig, resolveWordPressConnection, restoreContract, schemaType, serializeCurrencyFormat, sitemapEntryPath, toKizloError, turnstile, wpEndpoint, xmlResponse };

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.18.0";
+var version = "0.20.0";
 
 //#endregion
 export { version };

package/dist/procedures.d.ts

@@ -611,7 +611,6 @@ declare const CORE_PROCEDURES: {
       postedAt: number;
       isApproved: boolean;
     }, {
-      readonly COMMENT_USER_NOT_FOUND: {};
       readonly COMMENT_ID_NOT_FOUND: {};
       readonly COMMENT_CLOSED: {};
       readonly COMMENT_LOGIN_REQUIRED: {};

package/dist/test/auth.js

@@ -1,10 +1,9 @@
 //#region src/test/auth.ts
 function testAuthAdapter(user) {
-	return { getUser() {
+	return { getSession() {
 		return {
-			id: user.wpUserId,
+			id: user.id,
 			email: user.email,
-			phone: user.phone,
 			firstName: user.firstName,
 			lastName: user.lastName
 		};

package/dist/test/users.d.ts

@@ -2,12 +2,10 @@ import { TestCredentials } from "../cli/wp/types.js";
 
 //#region src/test/users.d.ts
 interface TestAuthAdapterUser {
-  wpUserId: number;
-  username: string;
+  id: string;
+  email: string;
   firstName: string;
   lastName: string;
-  email: string;
-  phone: string;
 }
 declare function toTestUser(user: TestCredentials["users"]["user"]): TestAuthAdapterUser;
 //#endregion

package/dist/test/users.js

@@ -1,15 +1,10 @@
 //#region src/test/users.ts
-const STATIC_FIELDS = {
-	firstName: "Test",
-	lastName: "Customer",
-	email: "customer@example.com",
-	phone: "+10000000002"
-};
 function toTestUser(user) {
 	return {
-		wpUserId: user.id,
-		username: user.username,
-		...STATIC_FIELDS
+		id: String(user.id),
+		email: user.email,
+		firstName: "Test",
+		lastName: "Customer"
 	};
 }
 

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, LOCAL_DIR_REL, OPCACHE_INI, REMAP_ENTRYPOINT, SEED_MARKER_OPTION, SEED_VERSION, TEST_ADMIN, TEST_USER, WORDPRESS_CLIENT_META_REL, WORDPRESS_META_REL, githubRelease, kizloRelease } from "./cli/wp/constants.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 { 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, 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, WORDPRESS_CLIENT_META_REL, WORDPRESS_META_REL, 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 { 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 };

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, LOCAL_DIR_REL, OPCACHE_INI, REMAP_ENTRYPOINT, SEED_MARKER_OPTION, SEED_VERSION, TEST_ADMIN, TEST_USER, WORDPRESS_CLIENT_META_REL, WORDPRESS_META_REL, githubRelease, kizloRelease } from "./cli/wp/constants.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 { 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, LOCAL_DIR_REL, OPCACHE_INI, REMAP_ENTRYPOINT, SEED_MARKER_OPTION, SEED_VERSION, TEST_ADMIN, TEST_USER, WORDPRESS_CLIENT_META_REL, WORDPRESS_META_REL, 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 { 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 };

package/dist/wordpress/endpoint.js

@@ -66,7 +66,8 @@ function buildWordPressRequest(definition, input) {
 				body: rest,
 				requestContentType: definition.requestContentType
 			} : { searchParams: rest },
-			responseContentTypes: definition.responseContentTypes
+			responseContentTypes: definition.responseContentTypes,
+			dataResponseStatuses: definition.dataResponseStatuses
 		},
 		error: null
 	};

package/dist/wordpress/error.d.ts

@@ -3,6 +3,7 @@ import { WP_CommonErrorCode, WP_ErrorData } from "./types.js";
 //#region src/wordpress/error.d.ts
 declare class WP_Error<TCode extends string = string> extends Error {
   code: TCode | WP_CommonErrorCode;
+  readonly data: unknown;
   constructor(error: WP_ErrorData<TCode>);
 }
 //#endregion

package/dist/wordpress/error.js

@@ -1,10 +1,12 @@
 //#region src/wordpress/error.ts
 var WP_Error = class extends Error {
 	code;
+	data;
 	constructor(error) {
 		super(error.message ?? "Internal server error, please try again.");
 		this.name = "WordPress Error";
 		this.code = error.code;
+		this.data = error.data ?? null;
 	}
 };
 

package/dist/wordpress/fetch-introspection.js

@@ -6,7 +6,7 @@ import { PLUGIN_VERSION_HEADER } from "@kizlo/shared";
 * WordPress could not be asked, or did not answer with a contract: a transport failure, a non-2xx
 * status, a body that is not JSON. A document that parsed is never one of these, however much of it
 * WordPress had to exclude, because what to do about an exclusion is the generator's policy and not
-* this function's. It reports; {@link generateWordPressOnce} decides.
+* this function's. It reports; {@link generateIntrospectionOnce} decides.
 */
 var IntrospectionFetchError = class extends Error {
 	/**

package/dist/wordpress/generate.js

@@ -182,6 +182,9 @@ function responseStatus(status) {
 function isSuccessStatus(status) {
 	return /^2\d\d$/.test(status);
 }
+function isWordPressErrorResponse(response) {
+	return response.body?.$ref === "kizlo.error";
+}
 /**
 * Every failing status of an endpoint carries the same error union, so spelling one member per
 * status would repeat it four or five times for no discrimination anyone can act on. They collapse
@@ -193,10 +196,10 @@ function renderResult(apiId, operationId, operation, context) {
 	const name = endpointName(apiId, operationId, "EndpointResult");
 	const errors = operation.errors.map(literal).join(" | ") || "never";
 	const responses = sortedEntries(operation.responses);
-	const failures = responses.filter(([status]) => !isSuccessStatus(status));
+	const failures = responses.filter(([, response]) => isWordPressErrorResponse(response));
 	const headerNames = [...new Set(responses.flatMap(([, response]) => responseHeaderNames(response, context)))].sort((left, right) => left.localeCompare(right)).map(literal).join(" | ");
 	const sharedHeaderNames = headerNames ? `, ${headerNames}` : "";
-	const variants = responses.filter(([status]) => isSuccessStatus(status)).map(([status, response]) => `WP_Success<${responseBody(response, context)}, ${status}, ${responseHeaders(response, context)}${sharedHeaderNames}>`);
+	const variants = responses.filter(([, response]) => !isWordPressErrorResponse(response)).map(([status, response]) => `WP_Success<${responseBody(response, context)}, ${status}, ${responseHeaders(response, context)}${sharedHeaderNames}>`);
 	if (new Set([NO_HEADERS, ...failures.map(([, response]) => responseHeaders(response, context))]).size === 1) variants.push(`WP_Failure<${errors}, number, ${NO_HEADERS}${sharedHeaderNames}>`);
 	else {
 		for (const [status, response] of failures) variants.push(`WP_Failure<${errors}, ${responseStatus(status)}, ${responseHeaders(response, context)}${sharedHeaderNames}>`);
@@ -257,13 +260,15 @@ function sortedEndpoints(node) {
 function endpointDefinition(entry) {
 	const pathParameters = sortedEntries(entry.operation.input.properties ?? {}).filter(([, schema]) => schema.in === "path").map(([name]) => name);
 	const responseContentTypes = Object.fromEntries(sortedEntries(entry.operation.responses).map(([status, response]) => [status, response.content_type]));
+	const dataResponseStatuses = sortedEntries(entry.operation.responses).filter(([status, response]) => !isSuccessStatus(status) && !isWordPressErrorResponse(response)).map(([status]) => status);
 	return {
 		namespace: entry.namespace,
 		path: entry.path,
 		method: entry.operation.method,
 		pathParameters,
 		...entry.operation.input.content_type ? { requestContentType: entry.operation.input.content_type } : {},
-		responseContentTypes
+		responseContentTypes,
+		...dataResponseStatuses.length > 0 ? { dataResponseStatuses } : {}
 	};
 }
 function renderRecord(value) {
@@ -279,7 +284,8 @@ function renderDefinition(definition) {
 		`method: ${literal(definition.method)}`,
 		`pathParameters: [${definition.pathParameters.map(literal).join(", ")}]`,
 		...definition.requestContentType ? [`requestContentType: ${literal(definition.requestContentType)}`] : [],
-		`responseContentTypes: ${renderRecord(definition.responseContentTypes)}`
+		`responseContentTypes: ${renderRecord(definition.responseContentTypes)}`,
+		...definition.dataResponseStatuses?.length ? [`dataResponseStatuses: [${definition.dataResponseStatuses.map(literal).join(", ")}]`] : []
 	].join(", ")} }`;
 }
 /**
@@ -377,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,
@@ -425,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"`;