kizlo 0.29.0 → 0.31.0

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_start_client_core0 from "@tanstack/start-client-core";
+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_start_client_core0.RequestMiddlewareAfterServer<{}, readonly [Middleware], undefined>, "options" | "~types">;
+//#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/request-context.d.ts

@@ -0,0 +1,8 @@
+//#region src/integrations/tanstack-start/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/request-context.js

@@ -0,0 +1,24 @@
+import { getGlobalStartContext } from "@tanstack/start-client-core";
+import { getRequest } from "@tanstack/start-server-core/request-response";
+
+//#region src/integrations/tanstack-start/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.31.0";
 
 //#endregion
 export { version };

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

@@ -0,0 +1,28 @@
+import { GeoAdapter } from "../adapters/geo.js";
+import { Integration } from "../shared/integration.js";
+import "../index.js";
+import { CdnHeadersOptions, CloudflareCacheBinding, CloudflareCacheResult, createCdnHeaders, purgeCache, revalidateTag, revalidateUrl } from "../integrations/tanstack-start/cloudflare/cache.js";
+import { RevalidationPostData, RevalidationPostRule, RevalidationSettingsEvent, RevalidationTaxonomyRule, RevalidationTermData, RevalidatorOptions, revalidator } from "../integrations/tanstack-start/cloudflare/revalidator.js";
+
+//#region src/integrations/tanstack-start/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, type RevalidationPostData, type RevalidationPostRule, type RevalidationSettingsEvent, type RevalidationTaxonomyRule, type RevalidationTermData, type RevalidatorOptions, cloudflare, createCdnHeaders, geoCloudflare, purgeCache, revalidateTag, revalidateUrl, revalidator, withCloudflare };

package/dist/tanstack-start/cloudflare.js

@@ -0,0 +1,34 @@
+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/request-context.js";
+import { applyCloudflareHeaders, createCdnHeaders, purgeCache, revalidateTag, revalidateUrl } from "../integrations/tanstack-start/cloudflare/cache.js";
+import { revalidator } from "../integrations/tanstack-start/cloudflare/revalidator.js";
+
+//#region src/integrations/tanstack-start/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, purgeCache, revalidateTag, revalidateUrl, revalidator, 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/dist/webhook/index.d.ts

@@ -22,6 +22,8 @@ interface WebhookOptions {
   events?: EventHandler[];
 }
 interface EventHandler {
+  /** Required handlers fail acknowledgement so the sender can retry. Defaults to log-only. */
+  failureMode?: "log" | "retry";
   events?: AnyEvents;
   handler: EventHandlerFn<AnyEvents>;
 }

package/dist/webhook/index.js

@@ -31,12 +31,19 @@ function createWebhookRouter(options) {
 			headers
 		}));
 		if (err) throw new KizloError("FORBIDDEN", { message: "Signature verification failed." });
-		const results = await Promise.allSettled((options?.events ?? []).map(async ({ events, handler }) => {
-			const event = await validateEvent(events, input.body);
+		const results = await Promise.allSettled((options?.events ?? []).map(async ({ events, handler, failureMode }) => {
+			const event = await validateEvent(events, input.body, failureMode);
 			if (!event) return;
 			await handler(event, context);
 		}));
 		for (const result of results) if (result.status === "rejected") context.logger.error("Webhook handler failed", result.reason);
+		const required = results.find((result, index) => result.status === "rejected" && options?.events?.[index]?.failureMode === "retry");
+		if (required?.status === "rejected") {
+			if (required.reason instanceof KizloError && required.reason.status === 422) throw required.reason;
+			const limited = required.reason instanceof KizloError && required.reason.status === 429;
+			if (limited) context.headers?.set("Retry-After", "60");
+			throw new KizloError(limited ? "TOO_MANY_REQUESTS" : "SERVICE_UNAVAILABLE", { message: "Required webhook work failed. Retry delivery." });
+		}
 	}) };
 }
 

package/dist/webhook/schema.d.ts

@@ -2,6 +2,38 @@ import z from "zod/v4";
 
 //#region src/webhook/schema.d.ts
 
+declare const SETTINGS_INDEXED_EVENT_TYPES: readonly ["settings.post_type.updated", "settings.taxonomy.updated"];
+declare const SettingsEventType: z.ZodEnum<{
+  "settings.site.updated": "settings.site.updated";
+  "settings.brand.updated": "settings.brand.updated";
+  "settings.identity.updated": "settings.identity.updated";
+  "settings.authors.updated": "settings.authors.updated";
+  "settings.crawling.updated": "settings.crawling.updated";
+  "settings.headless.updated": "settings.headless.updated";
+  "settings.integration.updated": "settings.integration.updated";
+  "settings.woocommerce.updated": "settings.woocommerce.updated";
+  "settings.post_type.updated": "settings.post_type.updated";
+  "settings.taxonomy.updated": "settings.taxonomy.updated";
+}>;
+type SettingsEventType = z.infer<typeof SettingsEventType>;
+declare const TermDependencies: z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodArray<z.ZodNumber>, z.ZodTransform<number[], number[]>>>;
+type TermDependencies = z.infer<typeof TermDependencies>;
+declare const PostEventData: z.ZodObject<{
+  post_id: z.ZodNumber;
+  affected_terms: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodArray<z.ZodNumber>, z.ZodTransform<number[], number[]>>>>>;
+  post_type: z.ZodString;
+  url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type PostEventData = z.infer<typeof PostEventData>;
+declare const TermEventData: z.ZodObject<{
+  term_id: z.ZodNumber;
+  affected_terms: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodArray<z.ZodNumber>, z.ZodTransform<number[], number[]>>>>>;
+  taxonomy: z.ZodString;
+  post_types: z.ZodArray<z.ZodString>;
+  count: z.ZodNumber;
+  url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type TermEventData = z.infer<typeof TermEventData>;
 declare const KizloEvent: z.ZodUnion<readonly [z.ZodObject<{
   type: z.ZodEnum<{
     "post.created": "post.created";
@@ -11,6 +43,7 @@ declare const KizloEvent: z.ZodUnion<readonly [z.ZodObject<{
   }>;
   data: z.ZodObject<{
     post_id: z.ZodNumber;
+    affected_terms: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodArray<z.ZodNumber>, z.ZodTransform<number[], number[]>>>>>;
     post_type: z.ZodString;
     url: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>;
@@ -22,6 +55,7 @@ declare const KizloEvent: z.ZodUnion<readonly [z.ZodObject<{
   }>;
   data: z.ZodObject<{
     term_id: z.ZodNumber;
+    affected_terms: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodArray<z.ZodNumber>, z.ZodTransform<number[], number[]>>>>>;
     taxonomy: z.ZodString;
     post_types: z.ZodArray<z.ZodString>;
     count: z.ZodNumber;
@@ -34,6 +68,7 @@ declare const KizloEvent: z.ZodUnion<readonly [z.ZodObject<{
     "settings.identity.updated": "settings.identity.updated";
     "settings.authors.updated": "settings.authors.updated";
     "settings.crawling.updated": "settings.crawling.updated";
+    "settings.headless.updated": "settings.headless.updated";
     "settings.integration.updated": "settings.integration.updated";
     "settings.woocommerce.updated": "settings.woocommerce.updated";
   }>;
@@ -49,4 +84,4 @@ declare const KizloEvent: z.ZodUnion<readonly [z.ZodObject<{
 }, z.core.$strip>]>;
 type KizloEvent = z.infer<typeof KizloEvent>;
 //#endregion
-export { KizloEvent };
+export { KizloEvent, PostEventData, SETTINGS_INDEXED_EVENT_TYPES, SettingsEventType, TermDependencies, TermEventData };

package/dist/webhook/schema.js

@@ -20,6 +20,7 @@ const SETTINGS_SIMPLE_EVENT_TYPES = [
 	"settings.identity.updated",
 	"settings.authors.updated",
 	"settings.crawling.updated",
+	"settings.headless.updated",
 	"settings.integration.updated",
 	"settings.woocommerce.updated"
 ];
@@ -34,8 +35,10 @@ const EVENT_TYPES = [
 	...SETTINGS_EVENT_TYPES
 ];
 const EventType = z.enum(EVENT_TYPES);
+const TermDependencies = z.record(z.string().min(1), z.array(z.number().int().positive().max(Number.MAX_SAFE_INTEGER)).transform((ids) => [...new Set(ids)]));
 const PostEventData = z.object({
-	post_id: z.number(),
+	post_id: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
+	affected_terms: TermDependencies.nullable().optional(),
 	post_type: z.string(),
 	url: z.string().optional()
 });
@@ -44,7 +47,8 @@ const PostEvent = z.object({
 	data: PostEventData
 });
 const TermEventData = z.object({
-	term_id: z.number(),
+	term_id: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
+	affected_terms: TermDependencies.nullable().optional(),
 	taxonomy: z.string(),
 	post_types: z.array(z.string()),
 	count: z.number().nonnegative(),
@@ -77,4 +81,4 @@ const AnyEvent = z.object({
 });
 
 //#endregion
-export { AnyEvent, KizloEvent, POST_EVENT_TYPES, SETTINGS_EVENT_TYPES, TERM_EVENT_TYPES };
+export { AnyEvent, KizloEvent, POST_EVENT_TYPES, PostEventData, SETTINGS_EVENT_TYPES, SETTINGS_INDEXED_EVENT_TYPES, SettingsIndexedEventData, SettingsSimpleEventData, TERM_EVENT_TYPES, TermDependencies, TermEventData };

package/dist/webhook/utils.js

@@ -1,8 +1,18 @@
+import { KizloError } from "../shared/error.js";
 import { KizloEvent } from "./schema.js";
 import { safeValidateSchema } from "@kizlo/shared";
 
 //#region src/webhook/utils.ts
-async function validateEvent(events, data) {
+async function validateEvent(events, data, failureMode = "log") {
+	const explicit = events?.find((entry) => entry.types.includes(data.type))?.data;
+	if (failureMode === "retry" && explicit) {
+		const result = await safeValidateSchema(explicit, data.data);
+		if (!result.success) throw new KizloError("UNPROCESSABLE_CONTENT", { message: "Invalid webhook dependencies. Update the event-producing plugin and check affected_terms." });
+		return {
+			type: data.type,
+			data: result.value
+		};
+	}
 	const internal = await safeValidateSchema(KizloEvent, data);
 	if (internal.success) return internal.value;
 	const external = events?.find((a) => a.types.includes(data.type))?.data;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kizlo",
-  "version": "0.29.0",
+  "version": "0.31.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/cloudflare": {
+      "import": {
+        "types": "./dist/tanstack-start/cloudflare.d.ts",
+        "default": "./dist/tanstack-start/cloudflare.js"
+      }
     }
   },
   "files": [
@@ -145,14 +145,15 @@
     "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",
+    "@tanstack/start-client-core": "^1.170.34",
+    "@tanstack/start-server-core": "^1.169.39",
     "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": {
@@ -161,6 +162,12 @@
     "@tanstack/react-start": {
       "optional": true
     },
+    "@tanstack/start-client-core": {
+      "optional": true
+    },
+    "@tanstack/start-server-core": {
+      "optional": true
+    },
     "astro": {
       "optional": true
     },
@@ -175,9 +182,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 };