kizlo 0.18.0 → 0.19.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

@@ -20,7 +20,7 @@ interface ContextConfig {
   /** 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

@@ -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/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.18.0";
+var version = "0.19.0";
 
 //#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?: "date" | "id" | "slug" | "parent" | "title" | "author" | "include" | "modified" | "relevance" | "include_slugs" | undefined;
+        orderby?: "id" | "date" | "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?: "date" | "id" | "slug" | "parent" | "title" | "author" | "include" | "modified" | "relevance" | "include_slugs" | "menu_order" | undefined;
+        orderby?: "id" | "date" | "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?: "count" | "id" | "slug" | "name" | "description" | "include" | "include_slugs" | "term_group" | undefined;
+        orderBy?: "id" | "count" | "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?: "count" | "id" | "slug" | "name" | "description" | "include" | "include_slugs" | "term_group" | undefined;
+        orderBy?: "id" | "count" | "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?: "date" | "id" | "slug" | "parent" | "title" | "author" | "include" | "relevance" | "include_slugs" | "menu_order" | undefined;
+          orderby?: "id" | "date" | "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?: "date" | "id" | "slug" | "parent" | "title" | "author" | "include" | "relevance" | "include_slugs" | "menu_order" | undefined;
+          orderby?: "id" | "date" | "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?: "date" | "id" | "parent" | "include" | "post" | undefined;
+        orderby?: "id" | "date" | "parent" | "include" | "post" | undefined;
         parent?: string | number | (string | number)[] | undefined;
         parentExclude?: string | number | (string | number)[] | undefined;
         post?: string | number | (string | number)[] | undefined;
@@ -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(", ")} }`;
 }
 /**

package/dist/wordpress/transport.js

@@ -112,6 +112,7 @@ var WordPressTransport = class {
 			headers: response.headers
 		});
 		const expectedContentType = input.responseContentTypes?.[String(response.status)] ?? input.responseContentTypes?.default;
+		const acceptsData = response.ok || input.dataResponseStatuses?.includes(String(response.status)) === true || input.dataResponseStatuses?.includes("default") === true;
 		const contentType = response.headers.get("content-type")?.split(";", 1)[0]?.trim().toLowerCase() || expectedContentType || "application/json";
 		let body;
 		try {
@@ -127,7 +128,7 @@ var WordPressTransport = class {
 				})
 			};
 		}
-		if (response.ok && typeof body === "string" && body.trim() === "") return {
+		if (acceptsData && typeof body === "string" && body.trim() === "") return {
 			data: null,
 			status: response.status,
 			headers: response.headers,
@@ -147,10 +148,11 @@ var WordPressTransport = class {
 				headers: response.headers,
 				error: new WP_Error({
 					code: data.code,
-					message: data.message
+					message: data.message,
+					data: data.data
 				})
 			};
-			return {
+			if (!acceptsData) return {
 				data: null,
 				status: response.status,
 				headers: response.headers,

package/dist/wordpress/types.d.ts

@@ -113,6 +113,7 @@ type WP_CommonErrorCode = "rest_no_route" | "rest_cookie_invalid_nonce" | "inval
 interface WP_ErrorData<T extends string> {
   code: T | WP_CommonErrorCode;
   message: string;
+  data?: unknown;
 }
 interface WP_ListMetadata {
   page: number;
@@ -145,6 +146,7 @@ interface WP_RequestInput {
   method: WP_RequestMethod;
   requestContentType?: WP_RequestContentType;
   responseContentTypes?: Record<string, WP_ResponseContentType | undefined>;
+  dataResponseStatuses?: string[];
   signal?: AbortSignal;
   timeout?: Duration;
 }
@@ -170,6 +172,8 @@ interface WP_EndpointDefinition {
   pathParameters: string[];
   requestContentType?: WP_RequestContentType;
   responseContentTypes: Record<string, WP_ResponseContentType | undefined>;
+  /** Non-2xx statuses whose declared body is data rather than a WordPress error envelope. */
+  dataResponseStatuses?: string[];
 }
 interface WordPressCredentials {
   url: string;

package/dist/wordpress/utils.d.ts

@@ -2,6 +2,7 @@
 declare function isWordPressResourceError<TCode extends string>(data: unknown): data is {
   code: TCode;
   message: string;
+  data?: unknown;
 };
 //#endregion
 export { isWordPressResourceError };

package/package.json

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