kizlo 0.3.0 → 0.3.2

package/README.md

@@ -1,27 +1,5 @@
-<br>
-
-<p align="center">
-  <a name="readme-top"></a>
-  <a href="https://kizlo.io">
-    <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://cdn.kizlo.io/logo/icon-light.svg">
-      <source media="(prefers-color-scheme: light)" srcset="https://cdn.kizlo.io/logo/icon-dark.svg">
-      <img alt="Kizlo" src="https://cdn.kizlo.io/logo/icon-dark.svg" height="100">
-    </picture>
-  </a>
-</p>
-
-<h3 align="center">Headless WordPress Toolkit for TypeScript</h3>
-
-<p align="center">
-  Develop, test, and ship from your machine with a fully typed RPC layer and WordPress API client.
-</p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/kizlo"><img src="https://img.shields.io/npm/v/kizlo?style=flat-square&color=333" alt="npm version"></a>
-  <a href="./LICENSE"><img src="https://img.shields.io/github/license/kizlo-io/kizlo?style=flat-square&color=333" alt="License"></a>
-  <a href="https://www.npmjs.com/package/kizlo"><img src="https://img.shields.io/npm/dt/kizlo?style=flat-square&color=333" alt="npm downloads"></a>
-</p>
+<a href="https://www.kizlo.io"><img width="100%" src="https://cdn.kizlo.io/images/github-kizlo-banner.png" alt="Kizlo headless CMS Admin panel built with React" /></a>
+<br />
 
 <p align="center">
   <a href="https://kizlo.io"><strong>Website</strong></a> ·
@@ -30,11 +8,16 @@
   <a href="https://x.com/kizlo_io"><strong>Twitter</strong></a>
 </p>
 
----
+<p align="center">
+  <a href="https://www.npmjs.com/package/kizlo"><img src="https://img.shields.io/npm/v/kizlo?style=flat-square" alt="npm version"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/github/license/kizlo-io/kizlo?style=flat-square" alt="License"></a>
+  <a href="https://www.npmjs.com/package/kizlo"><img src="https://img.shields.io/npm/dt/kizlo?style=flat-square" alt="npm downloads"></a>
+  <a href="https://twitter.com/kizlo_io"><img src="https://img.shields.io/badge/follow-kizlo-1DA1F2?logo=twitter&style=flat-square" alt="Kizlo Twitter" /></a>
+</p>
 
-## What is Kizlo?
+---
 
-Kizlo is an open-source, typesafe toolkit for headless WordPress, built to sit behind any JavaScript framework as your backend or CMS. Its CLI spins up a local, Docker-based environment scoped to your project, giving you a fully typed RPC layer and WordPress API client to develop, test, and ship from your machine.
+Kizlo is an open-source framework for building content-driven applications with WordPress as a headless CMS. Fully typed end-to-end, built for the AI era.
 
 > Kizlo extends through integrations, whether that's a WordPress plugin like WooCommerce or an external service for auth, analytics, and more. Browse all available [integrations](https://kizlo.io/integrations).
 
@@ -46,7 +29,7 @@ Set up Kizlo in your project:
 npx kizlo@latest init
 ```
 
-Start the local WordPress stack and regenerate the contract as you work:
+Start the local WordPress stack:
 
 ```bash
 npx kizlo dev

package/dist/cli/presets/nextjs.js

@@ -71,9 +71,17 @@ export const GET = createRobotsRoute(client)
 				contents: `import { createSitemapRoute } from "kizlo/nextjs/server"
 import { client } from "${ctx.serverImport(sitemapDir)}"
 
-// Unlike robots.txt, Vercel revalidates this route on demand, so it can stay static. It's
-// served from the CDN at no per-request cost and still refreshes when content changes.
-export const dynamic = "force-static"
+// Run on the edge: cheaper and faster than Node for a response this small.
+export const runtime = "edge"
+
+// Like robots.txt, Vercel bakes sitemap routes into immutable Edge CDN assets at build time,
+// bypassing ISR and on-demand revalidatePath. The index gets frozen with whatever WordPress
+// returned at build (often nothing, since the self-referential backend isn't reachable yet),
+// and revalidation can't purge that CDN copy.
+//
+// force-dynamic opts out of that static treatment. createSitemapRoute caches the WordPress calls
+// per sitemap and refreshes them on content changes (via revalidateTag), so requests stay cheap.
+export const dynamic = "force-dynamic"
 
 export const GET = createSitemapRoute(client)
 `

package/dist/integrations/nextjs/revalidate.js

@@ -2,7 +2,7 @@ import { POST_EVENT_TYPES, TERM_EVENT_TYPES } from "../../webhook/schema.js";
 import { createEventHandler } from "../../webhook/index.js";
 import { createExtension } from "../../shared/extension.js";
 import { ROBOTS_CACHE_TAG } from "./robots.js";
-import { SITEMAP_ROUTE } from "./sitemap.js";
+import { SITEMAP_CACHE_TAG, SITEMAP_ROUTE } from "./sitemap.js";
 
 //#region src/integrations/nextjs/revalidate.ts
 const DEFAULT_SITEMAP_TARGET = {
@@ -24,7 +24,10 @@ function nextRevalidation(options) {
 			];
 			for (const path of normalizePaths(paths)) revalidatePath(path);
 			if (event.type === "settings.saved") revalidateTag(ROBOTS_CACHE_TAG, { expire: 0 });
-			if (CONTENT_EVENT_TYPES.has(event.type)) for (const target of resolveSitemapTargets(options?.sitemap)) revalidatePath(normalizePath(target.path), target.type);
+			if (CONTENT_EVENT_TYPES.has(event.type)) {
+				revalidateTag(SITEMAP_CACHE_TAG, { expire: 0 });
+				for (const target of resolveSitemapTargets(options?.sitemap)) revalidatePath(normalizePath(target.path), target.type);
+			}
 		})] })
 	});
 }

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

@@ -1,7 +1,6 @@
 import { S2SClient } from "../../kizlo.js";
 
 //#region src/integrations/nextjs/robots.d.ts
-
 declare function createRobotsRoute(client: S2SClient<[]>): (request: Request) => Promise<Response>;
 //#endregion
 export { createRobotsRoute };

package/dist/integrations/nextjs/robots.js

@@ -1,11 +1,6 @@
 import { createRobotsRoute } from "../../seo/robots.js";
 
 //#region src/integrations/nextjs/robots.ts
-/**
-* Cache tag for the cached robots.txt body. The Next revalidation extension calls
-* `revalidateTag(ROBOTS_CACHE_TAG)` on every webhook event so the route refreshes
-* on-demand instead of on every request.
-*/
 const ROBOTS_CACHE_TAG = "kizlo:robots";
 function createRobotsRoute$1(client) {
 	const handler = createRobotsRoute(client);

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

@@ -2,17 +2,8 @@ import { S2SClient } from "../../kizlo.js";
 import { CreateSitemapRouteOptions } from "../../seo/sitemap.js";
 
 //#region src/integrations/nextjs/sitemap.d.ts
-
-/**
- * The Next route the sitemap handler is mounted at: a single dynamic segment named
- * `[sitemap]`. It is fixed (not configurable) so that one `revalidatePath(SITEMAP_ROUTE,
- * "layout")` refreshes the index and every generated sitemap at once. A `layout`
- * revalidation (not `page`) is required because the route has no `generateStaticParams`,
- * so its slugs are generated on-demand and only a subtree invalidation reaches them.
- * `[sitemap]` is Next's file-routing convention, which is why it lives in this integration
- * and not in core.
- */
 declare const SITEMAP_ROUTE: "/sitemaps/[sitemap]";
+declare const SITEMAP_CACHE_TAG = "kizlo:sitemap";
 /** Next's dynamic-route context. `params` is a promise in the App Router. */
 interface NextRouteContext {
   params?: {
@@ -21,13 +12,6 @@ interface NextRouteContext {
     sitemap?: string;
   }>;
 }
-/**
- * Next wrapper around the framework-agnostic {@link createCoreSitemapRoute}. It serves the
- * same sitemap index and collection pages, and additionally asserts the route is mounted at
- * {@link SITEMAP_ROUTE}: if the dynamic segment is not named `[sitemap]`, `params.sitemap`
- * is missing and a wrong mount would silently break `revalidatePath(SITEMAP_ROUTE, "layout")`,
- * so it throws loudly on the first request instead.
- */
 declare function createSitemapRoute(client: S2SClient<[]>, options?: CreateSitemapRouteOptions): (request: Request, ctx?: NextRouteContext) => Promise<Response>;
 //#endregion
-export { SITEMAP_ROUTE, createSitemapRoute };
+export { SITEMAP_CACHE_TAG, SITEMAP_ROUTE, createSitemapRoute };

package/dist/integrations/nextjs/sitemap.js

@@ -1,31 +1,29 @@
+import { xmlResponse } from "../../seo/utils.js";
 import { SITEMAP_BASE, createSitemapRoute } from "../../seo/sitemap.js";
 
 //#region src/integrations/nextjs/sitemap.ts
-/**
-* The Next route the sitemap handler is mounted at: a single dynamic segment named
-* `[sitemap]`. It is fixed (not configurable) so that one `revalidatePath(SITEMAP_ROUTE,
-* "layout")` refreshes the index and every generated sitemap at once. A `layout`
-* revalidation (not `page`) is required because the route has no `generateStaticParams`,
-* so its slugs are generated on-demand and only a subtree invalidation reaches them.
-* `[sitemap]` is Next's file-routing convention, which is why it lives in this integration
-* and not in core.
-*/
 const SITEMAP_ROUTE = `${SITEMAP_BASE}/[sitemap]`;
-/**
-* Next wrapper around the framework-agnostic {@link createCoreSitemapRoute}. It serves the
-* same sitemap index and collection pages, and additionally asserts the route is mounted at
-* {@link SITEMAP_ROUTE}: if the dynamic segment is not named `[sitemap]`, `params.sitemap`
-* is missing and a wrong mount would silently break `revalidatePath(SITEMAP_ROUTE, "layout")`,
-* so it throws loudly on the first request instead.
-*/
+const SITEMAP_CACHE_TAG = "kizlo:sitemap";
 function createSitemapRoute$1(client, options) {
 	const handler = createSitemapRoute(client, options);
+	let getCached;
 	return async function GET(request, ctx) {
 		const params = ctx?.params ? await ctx.params : void 0;
 		if (params && params.sitemap === void 0) throw new Error(`createSitemapRoute must be mounted at "${SITEMAP_ROUTE}". The dynamic segment must be named [sitemap].`);
-		return handler(request);
+		if (!getCached) {
+			const { unstable_cache } = await import("next/cache");
+			getCached = unstable_cache(async (url) => {
+				const response = await handler(new Request(url));
+				return {
+					status: response.status,
+					body: await response.text()
+				};
+			}, [SITEMAP_CACHE_TAG], { tags: [SITEMAP_CACHE_TAG] });
+		}
+		const { status, body } = await getCached(request.url);
+		return status === 200 ? xmlResponse(body) : new Response(body, { status });
 	};
 }
 
 //#endregion
-export { SITEMAP_ROUTE, createSitemapRoute$1 as createSitemapRoute };
+export { SITEMAP_CACHE_TAG, SITEMAP_ROUTE, createSitemapRoute$1 as createSitemapRoute };

package/dist/nextjs/server.d.ts

@@ -1,4 +1,4 @@
 import { KizloServerOptions, createKizlo } from "../integrations/nextjs/kizlo.server.js";
 import { createRobotsRoute } from "../integrations/nextjs/robots.js";
-import { SITEMAP_ROUTE, createSitemapRoute } from "../integrations/nextjs/sitemap.js";
-export { KizloServerOptions, SITEMAP_ROUTE, createKizlo, createRobotsRoute, createSitemapRoute };
+import { SITEMAP_CACHE_TAG, SITEMAP_ROUTE, createSitemapRoute } from "../integrations/nextjs/sitemap.js";
+export { KizloServerOptions, SITEMAP_CACHE_TAG, SITEMAP_ROUTE, createKizlo, createRobotsRoute, createSitemapRoute };

package/dist/nextjs/server.js

@@ -1,5 +1,5 @@
 import { createRobotsRoute } from "../integrations/nextjs/robots.js";
-import { SITEMAP_ROUTE, createSitemapRoute } from "../integrations/nextjs/sitemap.js";
+import { SITEMAP_CACHE_TAG, SITEMAP_ROUTE, createSitemapRoute } from "../integrations/nextjs/sitemap.js";
 import { createKizlo } from "../integrations/nextjs/kizlo.server.js";
 
-export { SITEMAP_ROUTE, createKizlo, createRobotsRoute, createSitemapRoute };
+export { SITEMAP_CACHE_TAG, SITEMAP_ROUTE, createKizlo, createRobotsRoute, createSitemapRoute };

package/dist/package.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kizlo",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "description": "A headless WordPress toolkit for TypeScript.",
   "keywords": [