kizlo 0.27.1 → 0.28.0

package/dist/adapters/cloudflare-connection.js

@@ -0,0 +1,16 @@
+//#region src/adapters/cloudflare-connection.ts
+function cloudflareConnInfo(headers) {
+	const country = headers?.get("cf-ipcountry") || null;
+	return {
+		ip: headers?.get("cf-connecting-ip") || null,
+		country: country === "XX" || country === "T1" ? null : country,
+		city: null,
+		state: null,
+		postcode: null,
+		timezone: null,
+		userAgent: headers?.get("user-agent") || null
+	};
+}
+
+//#endregion
+export { cloudflareConnInfo };

package/dist/adapters/geo.cloudflare.js

@@ -1,3 +1,5 @@
+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. */
 function geoCloudflareNext() {
@@ -6,16 +8,7 @@ function geoCloudflareNext() {
 		if (!headers) try {
 			headers = await (await import("next/headers")).headers();
 		} catch {}
-		const country = headers?.get("cf-ipcountry") || null;
-		return {
-			ip: headers?.get("cf-connecting-ip") || null,
-			country: country === "XX" || country === "T1" ? null : country,
-			city: null,
-			state: null,
-			postcode: null,
-			timezone: null,
-			userAgent: headers?.get("user-agent") || null
-		};
+		return cloudflareConnInfo(headers);
 	} };
 }
 

package/dist/cloudflare/vinext.d.ts

@@ -0,0 +1,7 @@
+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

@@ -0,0 +1,44 @@
+//#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

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

package/dist/cloudflare.js

@@ -0,0 +1,4 @@
+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

@@ -0,0 +1,8 @@
+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

@@ -0,0 +1,16 @@
+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

@@ -0,0 +1,9 @@
+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

@@ -0,0 +1,58 @@
+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 };

package/dist/package.js

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

package/dist/page/schema.d.ts

@@ -1,6 +1,6 @@
 import { WP_CustomFields } from "../wordpress/types.js";
 import "../wordpress/index.js";
-import * as _kizlo_shared3 from "@kizlo/shared";
+import * as _kizlo_shared7 from "@kizlo/shared";
 import z from "zod/v4";
 
 //#region src/page/schema.d.ts
@@ -104,7 +104,7 @@ declare const Page: z.ZodObject<{
   custom: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
   createdAt: z.ZodNumber;
   updatedAt: z.ZodNumber;
-  meta: z.ZodRecord<z.ZodString, z.ZodType<_kizlo_shared3.JSONValue, unknown, z.core.$ZodTypeInternals<_kizlo_shared3.JSONValue, unknown>>>;
+  meta: z.ZodRecord<z.ZodString, z.ZodType<_kizlo_shared7.JSONValue, unknown, z.core.$ZodTypeInternals<_kizlo_shared7.JSONValue, unknown>>>;
 }, z.core.$strip>;
 type Page = Omit<z.output<typeof Page>, "custom"> & {
   custom: PageCustomFields;
@@ -207,7 +207,7 @@ declare const PageList: z.ZodObject<{
     custom: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
     createdAt: z.ZodNumber;
     updatedAt: z.ZodNumber;
-    meta: z.ZodRecord<z.ZodString, z.ZodType<_kizlo_shared3.JSONValue, unknown, z.core.$ZodTypeInternals<_kizlo_shared3.JSONValue, unknown>>>;
+    meta: z.ZodRecord<z.ZodString, z.ZodType<_kizlo_shared7.JSONValue, unknown, z.core.$ZodTypeInternals<_kizlo_shared7.JSONValue, unknown>>>;
   }, z.core.$strip>>;
   meta: z.ZodObject<{
     page: z.ZodNumber;

package/dist/post/schema.d.ts

@@ -1,6 +1,6 @@
 import { WP_CustomFields } from "../wordpress/types.js";
 import "../wordpress/index.js";
-import * as _kizlo_shared7 from "@kizlo/shared";
+import * as _kizlo_shared3 from "@kizlo/shared";
 import z from "zod/v4";
 
 //#region src/post/schema.d.ts
@@ -26,14 +26,14 @@ declare const Post: z.ZodObject<{
     private: "private";
   }>;
   format: z.ZodEnum<{
-    status: "status";
+    image: "image";
+    link: "link";
     standard: "standard";
     aside: "aside";
     chat: "chat";
     gallery: "gallery";
-    link: "link";
-    image: "image";
     quote: "quote";
+    status: "status";
     video: "video";
     audio: "audio";
   }>;
@@ -125,7 +125,7 @@ declare const Post: z.ZodObject<{
   custom: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
   createdAt: z.ZodNumber;
   updatedAt: z.ZodNumber;
-  meta: z.ZodRecord<z.ZodString, z.ZodType<_kizlo_shared7.JSONValue, unknown, z.core.$ZodTypeInternals<_kizlo_shared7.JSONValue, unknown>>>;
+  meta: z.ZodRecord<z.ZodString, z.ZodType<_kizlo_shared3.JSONValue, unknown, z.core.$ZodTypeInternals<_kizlo_shared3.JSONValue, unknown>>>;
 }, z.core.$strip>;
 type Post = Omit<z.output<typeof Post>, "custom"> & {
   custom: PostCustomFields;
@@ -150,14 +150,14 @@ declare const PostList: z.ZodObject<{
       private: "private";
     }>;
     format: z.ZodEnum<{
-      status: "status";
+      image: "image";
+      link: "link";
       standard: "standard";
       aside: "aside";
       chat: "chat";
       gallery: "gallery";
-      link: "link";
-      image: "image";
       quote: "quote";
+      status: "status";
       video: "video";
       audio: "audio";
     }>;
@@ -249,7 +249,7 @@ declare const PostList: z.ZodObject<{
     custom: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
     createdAt: z.ZodNumber;
     updatedAt: z.ZodNumber;
-    meta: z.ZodRecord<z.ZodString, z.ZodType<_kizlo_shared7.JSONValue, unknown, z.core.$ZodTypeInternals<_kizlo_shared7.JSONValue, unknown>>>;
+    meta: z.ZodRecord<z.ZodString, z.ZodType<_kizlo_shared3.JSONValue, unknown, z.core.$ZodTypeInternals<_kizlo_shared3.JSONValue, unknown>>>;
   }, z.core.$strip>>;
   meta: z.ZodObject<{
     page: z.ZodNumber;

package/dist/procedures.d.ts

@@ -44,7 +44,7 @@ declare const CORE_PROCEDURES: {
         include?: string | number | (string | number)[] | undefined;
         offset?: string | number | undefined;
         order?: "asc" | "desc" | undefined;
-        orderby?: "date" | "id" | "slug" | "parent" | "title" | "author" | "include" | "modified" | "relevance" | "include_slugs" | undefined;
+        orderby?: "title" | "author" | "date" | "id" | "slug" | "parent" | "include" | "include_slugs" | "modified" | "relevance" | undefined;
         searchColumns?: ("post_title" | "post_content" | "post_excerpt")[] | undefined;
         slug?: string | string[] | undefined;
         taxRelation?: "AND" | "OR" | undefined;
@@ -99,7 +99,7 @@ declare const CORE_PROCEDURES: {
         include?: string | number | (string | number)[] | undefined;
         offset?: string | number | undefined;
         order?: "asc" | "desc" | undefined;
-        orderby?: "date" | "id" | "slug" | "parent" | "title" | "author" | "include" | "modified" | "relevance" | "include_slugs" | "menu_order" | undefined;
+        orderby?: "title" | "author" | "date" | "id" | "slug" | "parent" | "include" | "include_slugs" | "modified" | "relevance" | "menu_order" | undefined;
         searchColumns?: ("post_title" | "post_content" | "post_excerpt")[] | undefined;
         slug?: string | string[] | undefined;
         parent?: string | number | (string | number)[] | undefined;
@@ -136,7 +136,7 @@ declare const CORE_PROCEDURES: {
         exclude?: string | number | (string | number)[] | undefined;
         include?: string | number | (string | number)[] | undefined;
         order?: "asc" | "desc" | undefined;
-        orderBy?: "count" | "id" | "slug" | "name" | "description" | "include" | "include_slugs" | "term_group" | undefined;
+        orderBy?: "description" | "id" | "name" | "slug" | "include" | "include_slugs" | "term_group" | "count" | undefined;
         hideEmpty?: string | boolean | undefined;
         parent?: string | number | undefined;
         post?: string | number | undefined;
@@ -172,7 +172,7 @@ declare const CORE_PROCEDURES: {
         exclude?: string | number | (string | number)[] | undefined;
         include?: string | number | (string | number)[] | undefined;
         order?: "asc" | "desc" | undefined;
-        orderBy?: "count" | "id" | "slug" | "name" | "description" | "include" | "include_slugs" | "term_group" | undefined;
+        orderBy?: "description" | "id" | "name" | "slug" | "include" | "include_slugs" | "term_group" | "count" | 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: "post_type" | "taxonomy" | "author";
+        type: "author" | "post_type" | "taxonomy";
         pages: number;
         lastmod: string;
       }[], DefinedErrorMapLike>;
@@ -249,7 +249,7 @@ declare const CORE_PROCEDURES: {
         origin: string;
         sitemaps: {
           key: string;
-          type: "post_type" | "taxonomy" | "author";
+          type: "author" | "post_type" | "taxonomy";
           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?: "date" | "id" | "slug" | "parent" | "title" | "author" | "include" | "relevance" | "include_slugs" | "menu_order" | undefined;
+          orderby?: "title" | "author" | "date" | "id" | "slug" | "parent" | "include" | "include_slugs" | "relevance" | "menu_order" | undefined;
           searchColumns?: ("post_title" | "post_content" | "post_excerpt")[] | undefined;
           slug?: string | string[] | undefined;
           taxRelation?: "AND" | "OR" | undefined;
@@ -371,7 +371,7 @@ declare const CORE_PROCEDURES: {
           include?: string | number | (string | number)[] | undefined;
           offset?: string | number | undefined;
           order?: "asc" | "desc" | undefined;
-          orderby?: "date" | "id" | "slug" | "parent" | "title" | "author" | "include" | "relevance" | "include_slugs" | "menu_order" | undefined;
+          orderby?: "title" | "author" | "date" | "id" | "slug" | "parent" | "include" | "include_slugs" | "relevance" | "menu_order" | undefined;
           searchColumns?: ("post_title" | "post_content" | "post_excerpt")[] | undefined;
           slug?: string | string[] | undefined;
           taxRelation?: "AND" | "OR" | 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kizlo",
-  "version": "0.27.1",
+  "version": "0.28.0",
   "type": "module",
   "description": "A headless WordPress framework for TypeScript.",
   "keywords": [
@@ -58,6 +58,18 @@
         "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",
@@ -139,7 +151,8 @@
     "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"
+    "typescript": "^5.0.0",
+    "vite": "^8.0.0"
   },
   "peerDependenciesMeta": {
     "@tanstack/react-router": {
@@ -162,6 +175,9 @@
     },
     "typescript": {
       "optional": true
+    },
+    "vite": {
+      "optional": true
     }
   }
 }