kizlo 0.29.0 → 0.30.0

package/dist/adapters/geo.cloudflare.d.ts

@@ -1,7 +1,7 @@
 import { GeoAdapter } from "./geo.js";
 
 //#region src/adapters/geo.cloudflare.d.ts
-/** Read trusted Cloudflare connection headers in Next.js/vinext. Only use behind Cloudflare ingress. */
+/** Read trusted Cloudflare connection headers in Next.js. Only use behind Cloudflare ingress. */
 declare function geoCloudflareNext(): GeoAdapter;
 //#endregion
 export { geoCloudflareNext };

package/dist/adapters/geo.cloudflare.js

@@ -1,7 +1,7 @@
 import { cloudflareConnInfo } from "./cloudflare-connection.js";
 
 //#region src/adapters/geo.cloudflare.ts
-/** Read trusted Cloudflare connection headers in Next.js/vinext. Only use behind Cloudflare ingress. */
+/** Read trusted Cloudflare connection headers in Next.js. Only use behind Cloudflare ingress. */
 function geoCloudflareNext() {
 	return { getConnInfo: async (request) => {
 		let headers = request?.headers;

package/dist/adapters/request-context.d.ts

@@ -0,0 +1,12 @@
+//#region src/adapters/request-context.d.ts
+/** Request-local values supplied by a runtime integration, never by global core state. */
+interface RequestContextAdapter {
+  get(): {
+    request: Request;
+    values: object;
+  } | undefined;
+  /** Optional when the framework already owns request scoping. */
+  run?(request: Request, values: object | undefined, handle: () => Promise<Response>): Promise<Response>;
+}
+//#endregion
+export { RequestContextAdapter };

package/dist/adapters/types.d.ts

@@ -3,6 +3,7 @@ import { CaptchaAdapter } from "./captcha.js";
 import { CookiesAdapter } from "../shared/types.js";
 import { GeoAdapter } from "./geo.js";
 import { LoggerAdapter } from "./logger.js";
+import { RequestContextAdapter } from "./request-context.js";
 
 //#region src/adapters/types.d.ts
 /** The service contracts Kizlo integrations can provide at runtime. */
@@ -12,6 +13,7 @@ interface ServiceAdapters {
   geo?: GeoAdapter;
   logger?: LoggerAdapter;
   cookies?: CookiesAdapter;
+  requestContext?: RequestContextAdapter;
 }
 /** Merge adapter contributions in order without letting `undefined` erase an earlier value. */
 declare function mergeServiceAdapters(...contributions: (ServiceAdapters | undefined)[]): ServiceAdapters;

package/dist/adapters/types.js

@@ -9,6 +9,7 @@ function mergeServiceAdapters(...contributions) {
 		if (contribution.geo !== void 0) adapters.geo = contribution.geo;
 		if (contribution.logger !== void 0) adapters.logger = contribution.logger;
 		if (contribution.cookies !== void 0) adapters.cookies = contribution.cookies;
+		if (contribution.requestContext !== void 0) adapters.requestContext = contribution.requestContext;
 	}
 	return adapters;
 }

package/dist/context.d.ts

@@ -1,5 +1,4 @@
 import { ActiveWordPressClient, WordPressCredentials } from "./wordpress/types.js";
-import { WordPressTransport } from "./wordpress/transport.js";
 import "./wordpress/index.js";
 import { AuthUser } from "./adapters/auth.js";
 import { PreviewTokenPayload } from "./shared/schema.js";
@@ -31,8 +30,8 @@ type VerifyPreviewTokenFn = (token: string) => Promise<PreviewTokenPayload | nul
  * the server builds. A procedure's handler receives this base plus whatever its middleware injected
  * via `next({ context })`.
  */
-interface ProcedureContext {
-  /** The incoming HTTP `Request`, or `null` for server-side (non-HTTP) invocations. */
+interface BuiltinProcedureContext {
+  /** The active HTTP `Request`, or `null` outside a request scope. */
   request: Request | null;
   /** Response headers to be sent (e.g. `Set-Cookie`), or `null` server-side. */
   headers: Headers | null;
@@ -59,6 +58,10 @@ interface ProcedureContext {
   /** How the procedure was called: `"client"` (over HTTP) or `"server"` (direct server invocation). */
   invokedBy: "client" | "server";
 }
+/** Augment in the application to add typed, server-supplied request fields. */
+interface ProcedureContext extends BuiltinProcedureContext {}
+/** The application fields accepted by handler(request, values), excluding Kizlo-owned fields. */
+type PlatformRequestCtx = Omit<ProcedureContext, keyof BuiltinProcedureContext> & object;
 declare class Context {
   private readonly config;
   private readonly logger;
@@ -77,35 +80,15 @@ declare class Context {
   private warnIfOutdated;
   /** Bold yellow, boxed in dashes so it stands out in a busy dev console. */
   private warn;
-  createRestContext(request: Request): {
-    getConnInfo: ConnInfoFn;
-    verifyCaptcha: VerifyCaptchaFn;
-    getSession: SessionFn;
-    verifyPreviewToken: VerifyPreviewTokenFn;
-    cookies: CookiesStorage;
-    invokedBy: "client";
-    wordpress: WordPressTransport;
-    settings: SettingsService;
-    email: EmailService;
-    headers: Headers;
+  withRequestContext(request: Request, values: PlatformRequestCtx | undefined, handle: () => Promise<Response>): Promise<Response>;
+  createRestContext(request: Request, values?: PlatformRequestCtx): ProcedureContext & {
     request: Request;
-    config: ContextConfig;
-    logger: Logger;
+    headers: Headers;
+    invokedBy: "client";
   };
-  createServerContext(): {
-    getSession: SessionFn;
-    getConnInfo: ConnInfoFn;
-    verifyCaptcha: VerifyCaptchaFn;
-    verifyPreviewToken: VerifyPreviewTokenFn;
-    invokedBy: "server";
-    wordpress: WordPressTransport;
-    settings: SettingsService;
-    email: EmailService;
-    cookies: CookiesStorage;
+  createServerContext(): ProcedureContext & {
     headers: null;
-    request: null;
-    config: ContextConfig;
-    logger: Logger;
+    invokedBy: "server";
   };
   private createRestCookieStorage;
   private createVerifyCaptchaFn;
@@ -115,4 +98,4 @@ declare class Context {
   private createLogger;
 }
 //#endregion
-export { ConnInfoFn, Context, ContextConfig, ProcedureContext, SessionFn, VerifyCaptchaFn, VerifyPreviewTokenFn };
+export { ConnInfoFn, Context, ContextConfig, PlatformRequestCtx, ProcedureContext, SessionFn, VerifyCaptchaFn, VerifyPreviewTokenFn };

package/dist/context.js

@@ -102,9 +102,15 @@ var Context = class {
 		const border = "-".repeat(inner.length + 2);
 		console.warn(`\n\x1b[1m\x1b[33m${border}\n|${inner}|\n${border}\x1b[0m\n`);
 	}
-	createRestContext(request) {
+	withRequestContext(request, values, handle) {
+		if (values !== void 0 && (values === null || typeof values !== "object" || Array.isArray(values))) throw new TypeError("Request context must be an object.");
+		return this.config.adapters?.requestContext?.run?.(request, values, handle) ?? handle();
+	}
+	createRestContext(request, values) {
 		const headers = new Headers();
 		return {
+			...this.config.adapters?.requestContext?.get()?.values,
+			...values,
 			headers,
 			request: request.clone(),
 			config: this.config,
@@ -123,21 +129,24 @@ var Context = class {
 		};
 	}
 	createServerContext() {
+		const scope = this.config.adapters?.requestContext?.get();
+		const request = scope?.request ?? null;
 		const cookies = new CookiesStorage(this.config.adapters?.cookies);
 		return {
+			...scope?.values,
 			cookies,
 			headers: null,
-			request: null,
+			request,
 			config: this.config,
 			logger: this.logger,
-			...this.config.adapters?.geo ? this.createServices(null) : {
+			...this.config.adapters?.geo ? this.createServices(request) : {
 				wordpress: this.wordpress,
 				settings: this.settings,
 				email: this.email
 			},
-			getSession: this.createGetSessionFn(null, cookies),
-			getConnInfo: this.createConnInfoFn(null),
-			verifyCaptcha: this.createVerifyCaptchaFn(null),
+			getSession: this.createGetSessionFn(request, cookies),
+			getConnInfo: this.createConnInfoFn(request),
+			verifyCaptcha: this.createVerifyCaptchaFn(request),
 			verifyPreviewToken: this.createVerifyPreviewTokenFn(),
 			invokedBy: "server"
 		};

package/dist/index.d.ts

@@ -17,14 +17,14 @@ import { ConsoleLogAdapterOptions, LogLevel, LogPayload, Logger, LoggerAdapter,
 import { ServiceAdapters, mergeServiceAdapters } from "./adapters/types.js";
 import { AuthorsSettings, AuthorsSettingsInput, BrandSettings, BrandSettingsInput, CrawlingSettings, CrawlingSettingsInput, HeadlessSettings, HeadlessSettingsInput, IdentitySettings, IdentitySettingsInput, OrganizationFounder, OrganizationSettings, OrganizationSettingsInput, PersonSettings, PersonSettingsInput, PostStatusDefinition, PostTypeSettings, PostTypeSettingsInput, Settings, SiteSettings, SiteSettingsInput, SocialProfile, TaxonomySettings, TaxonomySettingsInput, UploadsSettings, UploadsSettingsInput, WebhookSettings, WebhookSettingsInput } from "./settings/service.interface.js";
 import { IconDescriptor, ManifestIcon, ResolvedIcons, resolveIcons } from "./brand/icons.js";
+import { CookiesStorage } from "./cookie.js";
+import { SettingsService } from "./settings/service.js";
+import { ConnInfoFn, Context, ContextConfig, PlatformRequestCtx, 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";
 import { Tag, TagCustomFields, TagCustomFieldsSchema } from "./tag/schema.js";
 import { CORE_PROCEDURES, CoreProcedures } from "./procedures.js";
-import { CookiesStorage } from "./cookie.js";
-import { SettingsService } from "./settings/service.js";
-import { ConnInfoFn, Context, ContextConfig, ProcedureContext, SessionFn, VerifyCaptchaFn, VerifyPreviewTokenFn } from "./context.js";
 import { AnyEventSchema, AnyEvents, EventHandler, EventHandlerFn, InferEventUnion, WebhookOptions, createEventHandler, createWebhookRouter } from "./webhook/index.js";
 import { COMMON_ERRORS, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, DefinedErrorMapLike, ErrorDefinition, KizloError, KizloErrorOptions, ThrowableErrorFn, ThrowableErrorMap, WithCommonErrorMap, createThrowableErrorMap, defineErrorMap, isKizloError, toKizloError } from "./shared/error.js";
 import { AnyMiddleware, ExtractMiddlewareContextOutput, InferMiddlewares, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, createMiddleware } from "./shared/middleware.js";
@@ -44,4 +44,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 { ActiveKizloClient, 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, InferClientData, InferClientError, InferClientInput, InferClientResult, InferEventUnion, InferIntegrationProcedures, InferMiddlewares, InferProcedureData, InferProcedureError, InferProcedureInput, InferProcedureResult, Integration, IntegrationRequirements, InvocationScope, JsonValue, Kizlo, KizloBrowserClient, KizloClient, KizloClientConfig, KizloConfig, KizloEnv, KizloError, KizloErrorOptions, KizloErrorUnion, KizloProcedureRegistry, 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_RequestParts, WP_ResponseContentType, WP_Result, WP_Schema, WP_Success, WP_TransportFailure, WP_TypedHeaders, WebManifest, WebhookOptions, WebhookSettings, WebhookSettingsInput, WithCommonErrorMap, WordPressClientRegistry, WordPressCredentials, WordPressCustomFieldsRegistry, WordPressEndpointRegistry, WordPressEnv, WordPressSchemaRegistry, 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, customFieldsSchema, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, deserializeSeo, emptyList, friendlyCaptcha, generateContract, geoCloudflareNext, 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, sortIntegrations, toKizloError, turnstile, wordPressConnectionComplete, wpEndpoint, xmlResponse };
+export { ActiveKizloClient, 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, InferClientData, InferClientError, InferClientInput, InferClientResult, InferEventUnion, InferIntegrationProcedures, InferMiddlewares, InferProcedureData, InferProcedureError, InferProcedureInput, InferProcedureResult, Integration, IntegrationRequirements, InvocationScope, JsonValue, Kizlo, KizloBrowserClient, KizloClient, KizloClientConfig, KizloConfig, KizloEnv, KizloError, KizloErrorOptions, KizloErrorUnion, KizloProcedureRegistry, 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, PlatformRequestCtx, 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_RequestParts, WP_ResponseContentType, WP_Result, WP_Schema, WP_Success, WP_TransportFailure, WP_TypedHeaders, WebManifest, WebhookOptions, WebhookSettings, WebhookSettingsInput, WithCommonErrorMap, WordPressClientRegistry, WordPressCredentials, WordPressCustomFieldsRegistry, WordPressEndpointRegistry, WordPressEnv, WordPressSchemaRegistry, 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, customFieldsSchema, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, deserializeSeo, emptyList, friendlyCaptcha, generateContract, geoCloudflareNext, 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, sortIntegrations, toKizloError, turnstile, wordPressConnectionComplete, wpEndpoint, xmlResponse };

package/dist/integrations/nextjs/api.d.ts

@@ -0,0 +1,13 @@
+//#region src/integrations/nextjs/api.d.ts
+/** Map framework route methods to Kizlo without passing Next.js params as platform context. */
+declare function toNextJsHandler(handler: (request: Request) => Response | Promise<Response>): {
+  GET: (request: Request) => Response | Promise<Response>;
+  POST: (request: Request) => Response | Promise<Response>;
+  PUT: (request: Request) => Response | Promise<Response>;
+  PATCH: (request: Request) => Response | Promise<Response>;
+  DELETE: (request: Request) => Response | Promise<Response>;
+  OPTIONS: (request: Request) => Response | Promise<Response>;
+  HEAD: (request: Request) => Response | Promise<Response>;
+};
+//#endregion
+export { toNextJsHandler };

package/dist/integrations/nextjs/api.js

@@ -0,0 +1,17 @@
+//#region src/integrations/nextjs/api.ts
+/** Map framework route methods to Kizlo without passing Next.js params as platform context. */
+function toNextJsHandler(handler) {
+	const route = (request) => handler(request);
+	return {
+		GET: route,
+		POST: route,
+		PUT: route,
+		PATCH: route,
+		DELETE: route,
+		OPTIONS: route,
+		HEAD: route
+	};
+}
+
+//#endregion
+export { toNextJsHandler };

package/dist/integrations/tanstack-start/react/cloudflare/cache-policy.js

@@ -0,0 +1,15 @@
+//#region src/integrations/tanstack-start/react/cloudflare/cache-policy.ts
+const EDGE_HEADERS = [
+	"Cloudflare-CDN-Cache-Control",
+	"CDN-Cache-Control",
+	"Cache-Control"
+];
+function validateTags(tags) {
+	if (!Array.isArray(tags)) throw new TypeError("CDN tags must be an array of strings.");
+	if (tags.length > 1e3) throw new RangeError("At most 1000 explicit CDN tags are supported per response.");
+	for (const tag of tags) if (typeof tag !== "string" || !tag.length || tag.length > 1024 || /[^\x21-\x2b\x2d-\x7e]/.test(tag)) throw new TypeError("CDN tags must contain 1-1024 printable ASCII characters without spaces or commas.");
+	return [...new Set(tags)];
+}
+
+//#endregion
+export { EDGE_HEADERS, validateTags };

package/dist/integrations/tanstack-start/react/cloudflare/cache.d.ts

@@ -0,0 +1,34 @@
+import { Duration } from "@kizlo/shared";
+
+//#region src/integrations/tanstack-start/react/cloudflare/cache.d.ts
+interface CloudflareCacheResult {
+  success: boolean;
+  errors?: {
+    code: number;
+    message: string;
+  }[];
+}
+/** Native Workers Cache control surface, not the separate caches.default API. */
+interface CloudflareCacheBinding {
+  invalidate?(options: {
+    tags?: string[];
+    pathPrefixes?: string[];
+  }): Promise<CloudflareCacheResult>;
+}
+interface CdnHeadersOptions {
+  /** Freshness in seconds at the edge. Browser reuse requires revalidation. */
+  maxAge: Duration;
+  staleWhileRevalidate?: Duration;
+  /** Defaults to zero so a failing origin cannot keep stale pages indefinitely. */
+  staleIfError?: Duration;
+  tags?: readonly string[];
+  /** Request headers that select separate cached responses. No variance is added automatically. */
+  vary?: readonly string[];
+}
+declare function createCdnHeaders(options: CdnHeadersOptions): Record<string, string>;
+/** Mark the native pathname prefix stale, including its query variants and longer paths. */
+declare function revalidateUrl(url: string | URL): Promise<void>;
+/** Mark responses carrying this host-scoped tag stale under their stored cache policy. */
+declare function revalidateTag(tag: string): Promise<void>;
+//#endregion
+export { CdnHeadersOptions, CloudflareCacheBinding, CloudflareCacheResult, createCdnHeaders, revalidateTag, revalidateUrl };

package/dist/integrations/tanstack-start/react/cloudflare/cache.js

@@ -0,0 +1,82 @@
+import { getStartRequestContext } from "../request-context.js";
+import { EDGE_HEADERS, validateTags } from "./cache-policy.js";
+import { seconds } from "@kizlo/shared";
+import { createHash } from "node:crypto";
+
+//#region src/integrations/tanstack-start/react/cloudflare/cache.ts
+function getCacheContext() {
+	const context = getStartRequestContext();
+	const cache = (context?.values)?.executionCtx?.cache;
+	if (!context || !cache) throw new Error("CDN revalidation requires a TanStack Start request with executionCtx.cache. Use withCloudflare at the Worker entrypoint.");
+	return {
+		url: new URL(context.request.url),
+		cache
+	};
+}
+const MAX_TAG_HEADER_BYTES = 16384;
+const digest = (value) => createHash("sha256").update(value).digest("hex");
+const resourceTag = (url, tag) => `kizlo:t:${digest(`${url.host}\0${tag}`)}`;
+function seconds$1(value, name) {
+	value = typeof value === "number" ? value : seconds(value);
+	if (!Number.isSafeInteger(value) || value < 0) throw new RangeError(`${name} must be a nonnegative integer number of seconds.`);
+	return value;
+}
+function createCdnHeaders(options) {
+	const directives = [`public`, `max-age=${seconds$1(options.maxAge, "maxAge")}`];
+	if (options.staleWhileRevalidate !== void 0) directives.push(`stale-while-revalidate=${seconds$1(options.staleWhileRevalidate, "staleWhileRevalidate")}`);
+	directives.push(`stale-if-error=${seconds$1(options.staleIfError ?? 0, "staleIfError")}`);
+	const tags = validateTags(options.tags ?? []).join(",");
+	const vary = options.vary ?? [];
+	if (!Array.isArray(vary) || vary.some((name) => typeof name !== "string" || !name.length || /[^!#$%&'*+.^_`|~0-9a-z-]/i.test(name))) throw new TypeError("Vary must be an array of HTTP header names.");
+	const names = [...new Map(vary.map((name) => [name.toLowerCase(), name])).values()];
+	return {
+		"Cache-Control": "no-cache",
+		"Cloudflare-CDN-Cache-Control": directives.join(", "),
+		...tags ? { "Cache-Tag": tags } : {},
+		...names.length ? { Vary: names.includes("*") ? "*" : names.join(", ") } : {}
+	};
+}
+/** Mark the native pathname prefix stale, including its query variants and longer paths. */
+async function revalidateUrl(url) {
+	const state = getCacheContext();
+	const value = url instanceof URL ? url.href : url;
+	if (typeof value !== "string" || !/^(?:\/(?!\/)|https?:\/\/)/i.test(value) || /[\s\p{Cc}\\]/u.test(value)) throw new TypeError("CDN URLs must be absolute pathnames or same-origin HTTP(S) URLs without whitespace or backslashes.");
+	const target = new URL(value, state.url);
+	if (target.origin !== state.url.origin || target.username || target.password) throw new TypeError("CDN URLs must belong to the current origin and cannot contain credentials.");
+	await invalidate(state.cache, { pathPrefixes: [target.pathname] });
+}
+/** Mark responses carrying this host-scoped tag stale under their stored cache policy. */
+async function revalidateTag(tag) {
+	const state = getCacheContext();
+	validateTags([tag]);
+	await invalidate(state.cache, { tags: [resourceTag(state.url, tag)] });
+}
+async function invalidate(cache, targets) {
+	if (typeof cache.invalidate !== "function") throw new Error("The Worker runtime does not support cache.invalidate().");
+	const result = await cache.invalidate(targets);
+	if (result?.success !== true) {
+		const detail = result?.errors?.map(({ code, message }) => `${code}: ${message}`).join("; ");
+		throw new Error(`Cloudflare CDN revalidation failed${detail ? `: ${detail}` : "."}`);
+	}
+}
+/** Default to no caching and encode only authored resource tags. */
+function applyCloudflareHeaders(request, response) {
+	if (response.status === 101) return response;
+	const result = new Headers(response.headers);
+	if (!EDGE_HEADERS.some((name) => result.has(name))) result.set("Cache-Control", "no-store");
+	const authoredTags = result.get("Cache-Tag");
+	if (authoredTags !== null) {
+		const url = new URL(request.url);
+		const tagHeader = validateTags(authoredTags.split(",").map((tag) => tag.trim())).map((tag) => resourceTag(url, tag)).join(",");
+		if (tagHeader.length > MAX_TAG_HEADER_BYTES) throw new RangeError("Encoded CDN tags exceed Cloudflare's 16 KB header limit.");
+		result.set("Cache-Tag", tagHeader);
+	}
+	return new Response(response.body, {
+		status: response.status,
+		statusText: response.statusText,
+		headers: result
+	});
+}
+
+//#endregion
+export { applyCloudflareHeaders, createCdnHeaders, revalidateTag, revalidateUrl };

package/dist/integrations/tanstack-start/react/cookies.js

@@ -0,0 +1,20 @@
+import { deleteCookie, getCookies, setCookie } from "@tanstack/react-start/server";
+
+//#region src/integrations/tanstack-start/react/cookies.ts
+function startCookies() {
+	return {
+		getAll: () => Object.entries(getCookies()).flatMap(([name, value]) => value === void 0 ? [] : [{
+			name,
+			value
+		}]),
+		setAll: (cookies) => {
+			for (const { name, value, options } of cookies) setCookie(name, value, options);
+		},
+		deleteAll: (cookies) => {
+			for (const { name, options } of cookies) deleteCookie(name, options);
+		}
+	};
+}
+
+//#endregion
+export { startCookies };

package/dist/integrations/tanstack-start/react/integration.d.ts

@@ -0,0 +1,25 @@
+import { CookiesAdapter } from "../../../shared/types.js";
+import { EventHandler } from "../../../webhook/index.js";
+import { EnvSource, IntegrationRequirements } from "../../../shared/integration.js";
+import "../../../index.js";
+import { TanstackStartOptions } from "../integration.js";
+import { getStartRequestContext } from "./request-context.js";
+
+//#region src/integrations/tanstack-start/react/integration.d.ts
+/** Add React Start's native request context and cookies to the shared environment mapping. */
+declare function tanstackStart(options?: TanstackStartOptions): {
+  adapters: {
+    cookies: CookiesAdapter;
+    requestContext: {
+      get: typeof getStartRequestContext;
+    };
+  };
+  id: "tanstack-start";
+  procedures?: Record<never, never> | undefined;
+  events?: EventHandler[];
+  env?: EnvSource;
+  requires?: IntegrationRequirements;
+  order?: number;
+};
+//#endregion
+export { tanstackStart };

package/dist/integrations/tanstack-start/react/integration.js

@@ -0,0 +1,18 @@
+import { tanstackStart } from "../integration.js";
+import { startCookies } from "./cookies.js";
+import { getStartRequestContext } from "./request-context.js";
+
+//#region src/integrations/tanstack-start/react/integration.ts
+/** Add React Start's native request context and cookies to the shared environment mapping. */
+function tanstackStart$1(options = {}) {
+	return {
+		...tanstackStart(options),
+		adapters: {
+			cookies: startCookies(),
+			requestContext: { get: getStartRequestContext }
+		}
+	};
+}
+
+//#endregion
+export { tanstackStart$1 as tanstackStart };

package/dist/integrations/tanstack-start/react/middleware.d.ts

@@ -0,0 +1,9 @@
+import * as _tanstack_react_start0 from "@tanstack/react-start";
+import { AnyRequestMiddleware } from "@tanstack/react-start";
+
+//#region src/integrations/tanstack-start/react/middleware.d.ts
+type MiddlewareMatcher = string | readonly string[] | ((request: Request) => boolean);
+/** Wrap native request middleware with a path-to-regexp pattern or synchronous request predicate. */
+declare function matchMiddleware<Middleware extends AnyRequestMiddleware>(middleware: Middleware, matcher: MiddlewareMatcher): Pick<_tanstack_react_start0.RequestMiddlewareAfterServer<{}, readonly [Middleware], undefined>, "~types" | "options">;
+//#endregion
+export { MiddlewareMatcher, matchMiddleware };

package/dist/integrations/tanstack-start/react/middleware.js

@@ -0,0 +1,32 @@
+import { createPathMatcher } from "@kizlo/shared";
+import { getRequest } from "@tanstack/react-start/server";
+import { createIsomorphicFn, createMiddleware } from "@tanstack/react-start";
+
+//#region src/integrations/tanstack-start/react/middleware.ts
+const currentRequest = createIsomorphicFn().client(() => void 0).server(() => getRequest());
+/** Wrap native request middleware with a path-to-regexp pattern or synchronous request predicate. */
+function matchMiddleware(middleware, matcher) {
+	const patterns = typeof matcher === "function" ? [] : typeof matcher === "string" ? [matcher] : matcher;
+	if (patterns.some((pattern) => !pattern.startsWith("/"))) throw new TypeError("Middleware patterns must start with /.");
+	const [first, ...rest] = patterns;
+	const matches = typeof matcher === "function" ? matcher : first === void 0 ? () => false : createPathMatcher([first, ...rest]);
+	const wrapped = createMiddleware().middleware([middleware]).server(({ next }) => next());
+	const options = wrapped.options;
+	const skipped = { server: options.server };
+	const decisions = /* @__PURE__ */ new WeakMap();
+	Object.defineProperty(wrapped, "options", { get() {
+		const request = currentRequest();
+		if (!request) return {};
+		let selected = decisions.get(request);
+		if (selected === void 0) {
+			selected = matches(request);
+			if (typeof selected !== "boolean") throw new TypeError("Middleware predicates must return a boolean synchronously.");
+			decisions.set(request, selected);
+		}
+		return selected ? options : skipped;
+	} });
+	return wrapped;
+}
+
+//#endregion
+export { matchMiddleware };

package/dist/integrations/tanstack-start/react/request-context.d.ts

@@ -0,0 +1,8 @@
+//#region src/integrations/tanstack-start/react/request-context.d.ts
+/** Read Start's native request scope; no application-owned async storage is needed. */
+declare function getStartRequestContext(): {
+  request: Request;
+  values: object;
+} | undefined;
+//#endregion
+export { getStartRequestContext };

package/dist/integrations/tanstack-start/react/request-context.js

@@ -0,0 +1,24 @@
+import { getRequest } from "@tanstack/react-start/server";
+import { getGlobalStartContext } from "@tanstack/react-start";
+
+//#region src/integrations/tanstack-start/react/request-context.ts
+/** Read Start's native request scope; no application-owned async storage is needed. */
+function getStartRequestContext() {
+	let request;
+	try {
+		request = getRequest();
+	} catch {
+		return;
+	}
+	let values = {};
+	try {
+		values = getGlobalStartContext() ?? {};
+	} catch {}
+	return {
+		request,
+		values
+	};
+}
+
+//#endregion
+export { getStartRequestContext };

package/dist/kizlo.d.ts

@@ -1,6 +1,7 @@
 import { ActiveWordPressClient, WordPressCredentials } from "./wordpress/types.js";
 import "./wordpress/index.js";
 import { LogLevel } from "./adapters/logger.js";
+import { PlatformRequestCtx } from "./context.js";
 import { CoreProcedures } from "./procedures.js";
 import { AnyIntegration, EnvReader, InferIntegrationProcedures } from "./shared/integration.js";
 import { ResultClient } from "./shared/result.js";
@@ -26,7 +27,7 @@ declare class Kizlo<TIntegrations extends readonly AnyIntegration[] = []> {
   private readonly config;
   constructor(config: KizloConfig<TIntegrations>);
   get wordpress(): ActiveWordPressClient;
-  handler(request: Request): Promise<Response>;
+  handler(request: Request, values?: PlatformRequestCtx): Promise<Response>;
   private errorInterceptor;
   private checkInvocationScope;
   private registerIntegrations;

package/dist/kizlo.js

@@ -61,23 +61,31 @@ var Kizlo = class {
 	get wordpress() {
 		return this.context.createServerContext().wordpress;
 	}
-	async handler(request) {
-		const serverUrl = new URL(this.config.baseUrl);
-		const context = this.context.createRestContext(request);
-		const result = !(request.headers.get(RPC_PROTOCOL_HEADER) !== null) ? await this.openapiHandler.handle(request, {
-			context,
-			prefix: serverUrl.pathname
-		}) : await this.remoteHandler.handle(request, {
-			context,
-			prefix: serverUrl.pathname
+	async handler(request, values) {
+		return this.context.withRequestContext(request, values, async () => {
+			const serverUrl = new URL(this.config.baseUrl);
+			const context = this.context.createRestContext(request, values);
+			const result = !(request.headers.get(RPC_PROTOCOL_HEADER) !== null) ? await this.openapiHandler.handle(request, {
+				context,
+				prefix: serverUrl.pathname
+			}) : await this.remoteHandler.handle(request, {
+				context,
+				prefix: serverUrl.pathname
+			});
+			const response = result.matched ? result.response : new Response("Not Found", { status: 404 });
+			for (const [key, value] of context.headers.entries()) {
+				if (key.toLowerCase() === "set-cookie") continue;
+				response.headers.set(key, value);
+			}
+			for (const cookie of context.headers.getSetCookie()) response.headers.append("Set-Cookie", cookie);
+			response.headers.set("Cache-Control", "private, no-store");
+			for (const name of [
+				"Cloudflare-CDN-Cache-Control",
+				"CDN-Cache-Control",
+				"Cache-Tag"
+			]) response.headers.delete(name);
+			return response;
 		});
-		if (!result.matched) return new Response("Not Found", { status: 404 });
-		for (const [key, value] of context.headers.entries()) {
-			if (key.toLowerCase() === "set-cookie") continue;
-			result.response.headers.set(key, value);
-		}
-		for (const cookie of context.headers.getSetCookie()) result.response.headers.append("Set-Cookie", cookie);
-		return result.response;
 	}
 	errorInterceptor() {
 		return async ({ context, next }) => {

package/dist/nextjs/server.d.ts

@@ -1,6 +1,7 @@
 import { WEB_MANIFEST_ROUTE } from "../brand/manifest.js";
 import { renderJsonLd } from "../seo/utils.js";
 import { createSitemapRedirectRoute } from "../seo/sitemap.js";
+import { toNextJsHandler } from "../integrations/nextjs/api.js";
 import { NextRevalidateOptions, RevalidatePathFn, RevalidateTagFn, RevalidateTarget, nextRevalidation } from "../integrations/nextjs/revalidate.js";
 import { NextjsOptions, nextjs } from "../integrations/nextjs/integration.js";
 import { MANIFEST_CACHE_TAG, createManifestRoute } from "../integrations/nextjs/manifest.js";
@@ -8,4 +9,4 @@ import { createHomeMetadata, createPageMetadata, createRootMetadata, createRootV
 import { ROBOTS_CACHE_TAG, createRobotsRoute } from "../integrations/nextjs/robots.js";
 import { SITEMAP_CACHE_TAG, SITEMAP_ROUTE, createSitemapRoute } from "../integrations/nextjs/sitemap.js";
 import { createCachedTextRoute, createNextCookiesInterface, getServerBaseUrl } from "../integrations/nextjs/utils.js";
-export { MANIFEST_CACHE_TAG, NextRevalidateOptions, NextjsOptions, ROBOTS_CACHE_TAG, RevalidatePathFn, RevalidateTagFn, RevalidateTarget, SITEMAP_CACHE_TAG, SITEMAP_ROUTE, WEB_MANIFEST_ROUTE, createCachedTextRoute, createHomeMetadata, createManifestRoute, createNextCookiesInterface, createPageMetadata, createRobotsRoute, createRootMetadata, createRootViewport, createSitemapRedirectRoute, createSitemapRoute, getServerBaseUrl, nextRevalidation, nextjs, renderJsonLd };
+export { MANIFEST_CACHE_TAG, NextRevalidateOptions, NextjsOptions, ROBOTS_CACHE_TAG, RevalidatePathFn, RevalidateTagFn, RevalidateTarget, SITEMAP_CACHE_TAG, SITEMAP_ROUTE, WEB_MANIFEST_ROUTE, createCachedTextRoute, createHomeMetadata, createManifestRoute, createNextCookiesInterface, createPageMetadata, createRobotsRoute, createRootMetadata, createRootViewport, createSitemapRedirectRoute, createSitemapRoute, getServerBaseUrl, nextRevalidation, nextjs, renderJsonLd, toNextJsHandler };

package/dist/nextjs/server.js

@@ -2,6 +2,7 @@ import { WEB_MANIFEST_ROUTE } from "../brand/manifest.js";
 import { renderJsonLd } from "../seo/utils.js";
 import { createSitemapRedirectRoute } from "../seo/sitemap.js";
 import { createCachedTextRoute, createNextCookiesInterface, getServerBaseUrl } from "../integrations/nextjs/utils.js";
+import { toNextJsHandler } from "../integrations/nextjs/api.js";
 import { ROBOTS_CACHE_TAG, createRobotsRoute } from "../integrations/nextjs/robots.js";
 import { SITEMAP_CACHE_TAG, SITEMAP_ROUTE, createSitemapRoute } from "../integrations/nextjs/sitemap.js";
 import { nextRevalidation } from "../integrations/nextjs/revalidate.js";
@@ -9,4 +10,4 @@ import { nextjs } from "../integrations/nextjs/integration.js";
 import { MANIFEST_CACHE_TAG, createManifestRoute } from "../integrations/nextjs/manifest.js";
 import { createHomeMetadata, createPageMetadata, createRootMetadata, createRootViewport } from "../integrations/nextjs/metadata.js";
 
-export { MANIFEST_CACHE_TAG, ROBOTS_CACHE_TAG, SITEMAP_CACHE_TAG, SITEMAP_ROUTE, WEB_MANIFEST_ROUTE, createCachedTextRoute, createHomeMetadata, createManifestRoute, createNextCookiesInterface, createPageMetadata, createRobotsRoute, createRootMetadata, createRootViewport, createSitemapRedirectRoute, createSitemapRoute, getServerBaseUrl, nextRevalidation, nextjs, renderJsonLd };
+export { MANIFEST_CACHE_TAG, ROBOTS_CACHE_TAG, SITEMAP_CACHE_TAG, SITEMAP_ROUTE, WEB_MANIFEST_ROUTE, createCachedTextRoute, createHomeMetadata, createManifestRoute, createNextCookiesInterface, createPageMetadata, createRobotsRoute, createRootMetadata, createRootViewport, createSitemapRedirectRoute, createSitemapRoute, getServerBaseUrl, nextRevalidation, nextjs, renderJsonLd, toNextJsHandler };

package/dist/package.js

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

package/dist/post/schema.d.ts

@@ -26,13 +26,13 @@ declare const Post: z.ZodObject<{
     private: "private";
   }>;
   format: z.ZodEnum<{
-    image: "image";
     link: "link";
     status: "status";
     standard: "standard";
     aside: "aside";
     chat: "chat";
     gallery: "gallery";
+    image: "image";
     quote: "quote";
     video: "video";
     audio: "audio";
@@ -150,13 +150,13 @@ declare const PostList: z.ZodObject<{
       private: "private";
     }>;
     format: z.ZodEnum<{
-      image: "image";
       link: "link";
       status: "status";
       standard: "standard";
       aside: "aside";
       chat: "chat";
       gallery: "gallery";
+      image: "image";
       quote: "quote";
       video: "video";
       audio: "audio";

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" | "slug" | "parent" | "title" | "author" | "date" | "include" | "include_slugs" | "modified" | "relevance" | 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" | "slug" | "parent" | "title" | "author" | "date" | "include" | "include_slugs" | "modified" | "relevance" | "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" | "name" | "slug" | "description" | "include" | "include_slugs" | "term_group" | "count" | undefined;
+        orderBy?: "description" | "count" | "id" | "slug" | "name" | "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" | "name" | "slug" | "description" | "include" | "include_slugs" | "term_group" | "count" | undefined;
+        orderBy?: "description" | "count" | "id" | "slug" | "name" | "include" | "include_slugs" | "term_group" | undefined;
         hideEmpty?: string | boolean | undefined;
         post?: string | number | undefined;
         slug?: string | string[] | undefined;
@@ -241,7 +241,7 @@ declare const CORE_PROCEDURES: {
     sitemaps: {
       list: Procedure<"internal", {}, {
         key: string;
-        type: "author" | "post_type" | "taxonomy";
+        type: "post_type" | "taxonomy" | "author";
         pages: number;
         lastmod: string;
       }[], DefinedErrorMapLike>;
@@ -249,7 +249,7 @@ declare const CORE_PROCEDURES: {
         origin: string;
         sitemaps: {
           key: string;
-          type: "author" | "post_type" | "taxonomy";
+          type: "post_type" | "taxonomy" | "author";
           pages: number;
           lastmod: string;
         }[];
@@ -292,7 +292,7 @@ declare const CORE_PROCEDURES: {
           include?: string | number | (string | number)[] | undefined;
           offset?: string | number | undefined;
           order?: "asc" | "desc" | undefined;
-          orderby?: "id" | "slug" | "parent" | "title" | "author" | "date" | "include" | "include_slugs" | "relevance" | "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" | "slug" | "parent" | "title" | "author" | "date" | "include" | "include_slugs" | "relevance" | "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" | "parent" | "date" | "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;
@@ -635,8 +635,8 @@ declare const CORE_PROCEDURES: {
     get: Procedure<"internal", {}, _kizlo_shared11.Settings, DefinedErrorMapLike>;
     site: {
       update: Procedure<"internal", {
-        name?: string | null | undefined;
         url?: string | null | undefined;
+        name?: string | null | undefined;
         backend_url?: string | null | undefined;
         secret?: string | null | undefined;
         alternate_name?: string | null | undefined;

package/dist/seo/schema.d.ts

@@ -108,17 +108,17 @@ declare const Seo: z.ZodObject<{
 type Seo = z.infer<typeof Seo>;
 declare const CONTENT_TYPES: readonly ["post_type", "taxonomy", "author"];
 declare const ContentType: z.ZodEnum<{
-  author: "author";
   post_type: "post_type";
   taxonomy: "taxonomy";
+  author: "author";
 }>;
 type ContentType = z.infer<typeof ContentType>;
 declare const Sitemap: z.ZodObject<{
   key: z.ZodString;
   type: z.ZodEnum<{
-    author: "author";
     post_type: "post_type";
     taxonomy: "taxonomy";
+    author: "author";
   }>;
   pages: z.ZodNumber;
   lastmod: z.ZodString;
@@ -127,9 +127,9 @@ type Sitemap = z.infer<typeof Sitemap>;
 declare const SitemapList: z.ZodArray<z.ZodObject<{
   key: z.ZodString;
   type: z.ZodEnum<{
-    author: "author";
     post_type: "post_type";
     taxonomy: "taxonomy";
+    author: "author";
   }>;
   pages: z.ZodNumber;
   lastmod: z.ZodString;
@@ -140,9 +140,9 @@ declare const SitemapIndex: z.ZodObject<{
   sitemaps: z.ZodArray<z.ZodObject<{
     key: z.ZodString;
     type: z.ZodEnum<{
-      author: "author";
       post_type: "post_type";
       taxonomy: "taxonomy";
+      author: "author";
     }>;
     pages: z.ZodNumber;
     lastmod: z.ZodString;
@@ -174,9 +174,9 @@ declare const SitemapUrlList: z.ZodArray<z.ZodObject<{
 type SitemapUrlList = z.infer<typeof SitemapUrlList>;
 declare const ListSitemapUrlInputBase: z.ZodObject<{
   type: z.ZodEnum<{
-    author: "author";
     post_type: "post_type";
     taxonomy: "taxonomy";
+    author: "author";
   }>;
   page: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodCoercedNumber<string | number>>>;
 }, z.core.$strip>;

package/dist/tanstack-start/react/cloudflare.d.ts

@@ -0,0 +1,27 @@
+import { GeoAdapter } from "../../adapters/geo.js";
+import { Integration } from "../../shared/integration.js";
+import "../../index.js";
+import { CdnHeadersOptions, CloudflareCacheBinding, CloudflareCacheResult, createCdnHeaders, revalidateTag, revalidateUrl } from "../../integrations/tanstack-start/react/cloudflare/cache.js";
+
+//#region src/integrations/tanstack-start/react/cloudflare.d.ts
+interface ExecutionContext {
+  cache?: CloudflareCacheBinding;
+  waitUntil(promise: Promise<unknown>): void;
+}
+/** Cloudflare connection metadata, using TanStack Start's existing request scope. */
+declare function geoCloudflare(): GeoAdapter;
+/** Add Cloudflare connection metadata; caching remains an explicit response policy. */
+declare function cloudflare(): Integration<"cloudflare", Record<never, never>>;
+/** Forward native Worker values to Start, default to no caching and encode explicit cache tags. */
+declare function withCloudflare<Env, Context extends ExecutionContext = ExecutionContext>(handler: {
+  fetch(request: Request, options: {
+    context: {
+      env: Env;
+      executionCtx: Context;
+    };
+  }): Response | Promise<Response>;
+}): {
+  fetch(request: Request, env: Env, executionCtx: Context): Promise<Response>;
+};
+//#endregion
+export { type CdnHeadersOptions, type CloudflareCacheBinding, type CloudflareCacheResult, cloudflare, createCdnHeaders, geoCloudflare, revalidateTag, revalidateUrl, withCloudflare };

package/dist/tanstack-start/react/cloudflare.js

@@ -0,0 +1,33 @@
+import { cloudflareConnInfo } from "../../adapters/cloudflare-connection.js";
+import { FRAMEWORK_INTEGRATION_ORDER } from "../../shared/constants.js";
+import { createIntegration } from "../../shared/integration.js";
+import { getStartRequestContext } from "../../integrations/tanstack-start/react/request-context.js";
+import { applyCloudflareHeaders, createCdnHeaders, revalidateTag, revalidateUrl } from "../../integrations/tanstack-start/react/cloudflare/cache.js";
+
+//#region src/integrations/tanstack-start/react/cloudflare.ts
+/** Cloudflare connection metadata, using TanStack Start's existing request scope. */
+function geoCloudflare() {
+	return { getConnInfo(request) {
+		return cloudflareConnInfo((request ?? getStartRequestContext()?.request)?.headers);
+	} };
+}
+/** Add Cloudflare connection metadata; caching remains an explicit response policy. */
+function cloudflare() {
+	return createIntegration({
+		id: "cloudflare",
+		order: FRAMEWORK_INTEGRATION_ORDER,
+		adapters: { geo: geoCloudflare() }
+	});
+}
+/** Forward native Worker values to Start, default to no caching and encode explicit cache tags. */
+function withCloudflare(handler) {
+	return { async fetch(request, env, executionCtx) {
+		return applyCloudflareHeaders(request, await handler.fetch(request, { context: {
+			env,
+			executionCtx
+		} }));
+	} };
+}
+
+//#endregion
+export { cloudflare, createCdnHeaders, geoCloudflare, revalidateTag, revalidateUrl, withCloudflare };

package/dist/tanstack-start/react/server.d.ts

@@ -0,0 +1,14 @@
+import { WEB_MANIFEST_ROUTE } from "../../brand/manifest.js";
+import { renderJsonLd } from "../../seo/utils.js";
+import { LinkDescriptor, MetaDescriptor, RouteHead, ScriptDescriptor, resolvePageHead } from "../../integrations/tanstack-start/metadata.js";
+import { ServerRoute, ServerRouteContext, getServerBaseUrl } from "../../integrations/tanstack-start/utils.js";
+import { ApiHandlers, KizloHandler, createApiHandlers } from "../../integrations/tanstack-start/api.js";
+import { TanstackStartOptions } from "../../integrations/tanstack-start/integration.js";
+import { createManifestRoute } from "../../integrations/tanstack-start/manifest.js";
+import { createRobotsRoute } from "../../integrations/tanstack-start/robots.js";
+import { resolveRootHead } from "../../integrations/tanstack-start/root-head.js";
+import { createSitemapRedirectRoute, createSitemapRoute } from "../../integrations/tanstack-start/sitemap.js";
+import "../server.js";
+import { tanstackStart } from "../../integrations/tanstack-start/react/integration.js";
+import { MiddlewareMatcher, matchMiddleware } from "../../integrations/tanstack-start/react/middleware.js";
+export { ApiHandlers, KizloHandler, LinkDescriptor, MetaDescriptor, MiddlewareMatcher, RouteHead, ScriptDescriptor, ServerRoute, ServerRouteContext, TanstackStartOptions, WEB_MANIFEST_ROUTE, createApiHandlers, createManifestRoute, createRobotsRoute, createSitemapRedirectRoute, createSitemapRoute, getServerBaseUrl, matchMiddleware, renderJsonLd, resolvePageHead, resolveRootHead, tanstackStart };

package/dist/tanstack-start/react/server.js

@@ -0,0 +1,13 @@
+import { WEB_MANIFEST_ROUTE } from "../../brand/manifest.js";
+import { renderJsonLd } from "../../seo/utils.js";
+import { getServerBaseUrl } from "../../integrations/tanstack-start/utils.js";
+import { resolvePageHead } from "../../integrations/tanstack-start/metadata.js";
+import { createApiHandlers } from "../../integrations/tanstack-start/api.js";
+import { createManifestRoute } from "../../integrations/tanstack-start/manifest.js";
+import { createRobotsRoute } from "../../integrations/tanstack-start/robots.js";
+import { resolveRootHead } from "../../integrations/tanstack-start/root-head.js";
+import { createSitemapRedirectRoute, createSitemapRoute } from "../../integrations/tanstack-start/sitemap.js";
+import { tanstackStart } from "../../integrations/tanstack-start/react/integration.js";
+import { matchMiddleware } from "../../integrations/tanstack-start/react/middleware.js";
+
+export { WEB_MANIFEST_ROUTE, createApiHandlers, createManifestRoute, createRobotsRoute, createSitemapRedirectRoute, createSitemapRoute, getServerBaseUrl, matchMiddleware, renderJsonLd, resolvePageHead, resolveRootHead, tanstackStart };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kizlo",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "type": "module",
   "description": "A headless WordPress framework for TypeScript.",
   "keywords": [
@@ -58,18 +58,6 @@
         "default": "./dist/test.js"
       }
     },
-    "./cloudflare": {
-      "import": {
-        "types": "./dist/cloudflare.d.ts",
-        "default": "./dist/cloudflare.js"
-      }
-    },
-    "./cloudflare/vinext": {
-      "import": {
-        "types": "./dist/cloudflare/vinext.d.ts",
-        "default": "./dist/cloudflare/vinext.js"
-      }
-    },
     "./node": {
       "import": {
         "types": "./dist/node.d.ts",
@@ -111,6 +99,18 @@
         "types": "./dist/tanstack-start/server.d.ts",
         "default": "./dist/tanstack-start/server.js"
       }
+    },
+    "./tanstack-start/react/server": {
+      "import": {
+        "types": "./dist/tanstack-start/react/server.d.ts",
+        "default": "./dist/tanstack-start/react/server.js"
+      }
+    },
+    "./tanstack-start/react/cloudflare": {
+      "import": {
+        "types": "./dist/tanstack-start/react/cloudflare.d.ts",
+        "default": "./dist/tanstack-start/react/cloudflare.js"
+      }
     }
   },
   "files": [
@@ -145,14 +145,13 @@
     "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "@tanstack/react-router": "^1.130.0",
-    "@tanstack/react-start": "^1.130.0",
+    "@tanstack/react-router": "^1.170.41",
+    "@tanstack/react-start": "^1.168.60",
     "astro": "^7.0.0",
     "next": "^14.0.0 || ^15.0.0 || ^16.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
-    "typescript": "^5.0.0",
-    "vite": "^8.0.0"
+    "typescript": "^5.0.0"
   },
   "peerDependenciesMeta": {
     "@tanstack/react-router": {
@@ -175,9 +174,6 @@
     },
     "typescript": {
       "optional": true
-    },
-    "vite": {
-      "optional": true
     }
   }
 }

package/dist/cloudflare/vinext.d.ts

@@ -1,7 +0,0 @@
-import { Plugin } from "vite";
-
-//#region src/integrations/cloudflare/vinext.d.ts
-/** Capture Cloudflare context inside each Vinext stage, including cache misses and regeneration. */
-declare function cloudflareVinext(): Plugin;
-//#endregion
-export { cloudflareVinext };

package/dist/cloudflare/vinext.js

@@ -1,44 +0,0 @@
-//#region src/integrations/cloudflare/vinext.ts
-const stages = new Map([["vinext/server/request-stage", ["loadVinextRequestStage", "handleRequestStage"]], ["vinext/server/response-stage", ["loadVinextResponseStage", "handleResponseStage"]]]);
-/** Capture Cloudflare context inside each Vinext stage, including cache misses and regeneration. */
-function cloudflareVinext() {
-	const modules = /* @__PURE__ */ new Map();
-	return {
-		name: "kizlo:cloudflare-vinext",
-		enforce: "pre",
-		async resolveId(source, importer) {
-			const stage = stages.get(source);
-			if (!stage) return null;
-			const resolved = await this.resolve(source, importer, { skipSelf: true });
-			if (!resolved) return this.error(`Cannot resolve ${source}. Use a Vinext release exposing the public stage loaders.`);
-			const id = `\0kizlo:cloudflare:${resolved.id}`;
-			modules.set(id, {
-				original: resolved.id,
-				loader: stage[0],
-				handler: stage[1]
-			});
-			return id;
-		},
-		load(id) {
-			const stage = modules.get(id);
-			if (!stage) return null;
-			return `
-import { withCloudflareRequest } from "kizlo/cloudflare";
-import { ${stage.loader} as loadStage } from ${JSON.stringify(stage.original)};
-export * from ${JSON.stringify(stage.original)};
-export async function ${stage.loader}(...args) {
-	const stage = await loadStage(...args);
-	return {
-		...stage,
-		${stage.handler}(request, ...args) {
-			return withCloudflareRequest(request, () => stage.${stage.handler}(request, ...args));
-		}
-	};
-}
-`;
-		}
-	};
-}
-
-//#endregion
-export { cloudflareVinext };

package/dist/cloudflare.d.ts

@@ -1,3 +0,0 @@
-import { cloudflare } from "./integrations/cloudflare/integration.js";
-import { geoCloudflare, withCloudflareRequest } from "./integrations/cloudflare/request-context.js";
-export { cloudflare, geoCloudflare, withCloudflareRequest };

package/dist/cloudflare.js

@@ -1,4 +0,0 @@
-import { geoCloudflare, withCloudflareRequest } from "./integrations/cloudflare/request-context.js";
-import { cloudflare } from "./integrations/cloudflare/integration.js";
-
-export { cloudflare, geoCloudflare, withCloudflareRequest };

package/dist/integrations/cloudflare/integration.d.ts

@@ -1,8 +0,0 @@
-import { Integration } from "../../shared/integration.js";
-import "../../index.js";
-
-//#region src/integrations/cloudflare/integration.d.ts
-/** Supply Cloudflare connection info independently of the frontend framework or WordPress host. */
-declare function cloudflare(): Integration<"cloudflare", Record<never, never>>;
-//#endregion
-export { cloudflare };

package/dist/integrations/cloudflare/integration.js

@@ -1,16 +0,0 @@
-import { FRAMEWORK_INTEGRATION_ORDER } from "../../shared/constants.js";
-import { createIntegration } from "../../shared/integration.js";
-import { geoCloudflare } from "./request-context.js";
-
-//#region src/integrations/cloudflare/integration.ts
-/** Supply Cloudflare connection info independently of the frontend framework or WordPress host. */
-function cloudflare() {
-	return createIntegration({
-		id: "cloudflare",
-		order: FRAMEWORK_INTEGRATION_ORDER,
-		adapters: { geo: geoCloudflare() }
-	});
-}
-
-//#endregion
-export { cloudflare };

package/dist/integrations/cloudflare/request-context.d.ts

@@ -1,9 +0,0 @@
-import { GeoAdapter } from "../../adapters/geo.js";
-
-//#region src/integrations/cloudflare/request-context.d.ts
-/** Read an explicit Cloudflare request or the active Worker entry context, without framework headers. */
-declare function geoCloudflare(): GeoAdapter;
-/** Wrap the complete Worker fetch handler, including SSR and streamed response production. */
-declare function withCloudflareRequest(request: Request, handle: () => Response | Promise<Response>): Promise<Response>;
-//#endregion
-export { geoCloudflare, withCloudflareRequest };

package/dist/integrations/cloudflare/request-context.js

@@ -1,58 +0,0 @@
-import { cloudflareConnInfo } from "../../adapters/cloudflare-connection.js";
-import { AsyncLocalStorage } from "node:async_hooks";
-
-//#region src/integrations/cloudflare/request-context.ts
-const requests = new AsyncLocalStorage();
-/** Read an explicit Cloudflare request or the active Worker entry context, without framework headers. */
-function geoCloudflare() {
-	return { getConnInfo: (request) => request ? cloudflareConnInfo(request.headers) : { ...requests.getStore()?.connection ?? cloudflareConnInfo() } };
-}
-/** Wrap the complete Worker fetch handler, including SSR and streamed response production. */
-function withCloudflareRequest(request, handle) {
-	const store = { connection: cloudflareConnInfo(request.headers) };
-	return requests.run(store, async () => {
-		try {
-			const response = await handle();
-			if (!response.body || response.status === 101) {
-				store.connection = null;
-				return response;
-			}
-			const reader = response.body.getReader();
-			const body = new ReadableStream({
-				pull(controller) {
-					return requests.run(store, async () => {
-						try {
-							const { value, done } = await reader.read();
-							if (done) {
-								store.connection = null;
-								reader.releaseLock();
-								controller.close();
-							} else controller.enqueue(value);
-						} catch (error) {
-							store.connection = null;
-							reader.releaseLock();
-							controller.error(error);
-						}
-					});
-				},
-				cancel(reason) {
-					return requests.run(store, async () => {
-						try {
-							await reader.cancel(reason);
-						} finally {
-							store.connection = null;
-							reader.releaseLock();
-						}
-					});
-				}
-			}, { highWaterMark: 0 });
-			return new Response(body, response);
-		} catch (error) {
-			store.connection = null;
-			throw error;
-		}
-	});
-}
-
-//#endregion
-export { geoCloudflare, withCloudflareRequest };