kizlo 0.10.0 → 0.12.0

package/dist/integrations/astro/metadata.d.ts

@@ -0,0 +1,64 @@
+import { IconDescriptor } from "../../brand/icons.js";
+import { S2SClient } from "../../kizlo.js";
+import { SeoHead } from "../../seo/schema.js";
+import { renderJsonLd } from "../../seo/utils.js";
+
+//#region src/integrations/astro/metadata.d.ts
+/** A `<meta name="theme-color">` entry, optionally scoped to a `prefers-color-scheme` media query. */
+interface ThemeColor {
+  media?: string;
+  color: string;
+}
+/**
+ * Brand + site data for the document `<head>`, resolved from WordPress settings. The `.astro`
+ * head component maps this to `<title>`/`<link>`/`<meta>` tags (Astro has no `generateMetadata`,
+ * and this package can't compile `.astro`, so the rendering lives in the template).
+ */
+interface RootHead {
+  /** Web manifest route to link with `rel="manifest"`. */
+  manifest: string;
+  icons: {
+    icon: IconDescriptor[];
+    appleTouch: IconDescriptor[];
+  };
+  /** Site origin used to resolve relative URLs, when set in WordPress. */
+  metadataBase?: string;
+  /** Browser-chrome theme color(s); a light/dark pair carries `prefers-color-scheme` media queries. */
+  themeColor: ThemeColor[];
+}
+/** Per-page SEO tags, mapped from a post's SEO head. Consumed by the template's head component. */
+interface PageHead {
+  title: string;
+  description?: string;
+  canonical: string;
+  robots: string;
+  og: {
+    type: string;
+    title: string;
+    description?: string;
+    url: string;
+    siteName: string;
+    locale: string;
+    image?: {
+      url: string;
+      width?: number;
+      height?: number;
+      alt?: string;
+    };
+  };
+  twitter: {
+    card: string;
+    title: string;
+    description?: string;
+    site?: string;
+    creator?: string;
+    image?: string;
+    imageAlt?: string;
+  };
+}
+/** Resolve the root brand/site head from WordPress settings (icons, manifest, theme color, base URL). */
+declare function resolveRootHead(client: S2SClient<[]>): Promise<RootHead>;
+/** Map a post's SEO head to the flat descriptors the template's head component renders. */
+declare function resolvePageHead(head: SeoHead): PageHead;
+//#endregion
+export { PageHead, RootHead, ThemeColor, resolvePageHead, resolveRootHead };

package/dist/integrations/astro/metadata.js

@@ -0,0 +1,71 @@
+import { resolveIcons } from "../../brand/icons.js";
+import { WEB_MANIFEST_ROUTE } from "../../brand/manifest.js";
+import { renderJsonLd } from "../../seo/utils.js";
+
+//#region src/integrations/astro/metadata.ts
+/** Resolve the root brand/site head from WordPress settings (icons, manifest, theme color, base URL). */
+async function resolveRootHead(client) {
+	const settings = await client.settings.get.call();
+	const { icon, appleTouch } = resolveIcons(settings.brand);
+	const light = settings.brand.theme_color;
+	const dark = settings.brand.theme_color_dark;
+	const themeColor = [];
+	if (light) themeColor.push(dark ? {
+		media: "(prefers-color-scheme: light)",
+		color: light
+	} : { color: light });
+	if (dark) themeColor.push({
+		media: "(prefers-color-scheme: dark)",
+		color: dark
+	});
+	return {
+		manifest: WEB_MANIFEST_ROUTE,
+		icons: {
+			icon,
+			appleTouch
+		},
+		metadataBase: settings.site.url || void 0,
+		themeColor
+	};
+}
+/** Map a post's SEO head to the flat descriptors the template's head component renders. */
+function resolvePageHead(head) {
+	return {
+		title: head.title,
+		description: head.og.description || void 0,
+		canonical: head.canonical,
+		robots: [
+			head.robots.index,
+			head.robots.follow,
+			head.robots.maxSnippet,
+			head.robots.maxImagePreview,
+			head.robots.maxVideoPreview
+		].join(", "),
+		og: {
+			type: head.og.type,
+			title: head.og.title,
+			description: head.og.description || void 0,
+			url: head.og.url,
+			siteName: head.og.siteName,
+			locale: head.og.locale,
+			image: head.og.image ? {
+				url: head.og.image.url,
+				width: head.og.image.width ?? void 0,
+				height: head.og.image.height ?? void 0,
+				alt: head.og.image.alt ?? void 0
+			} : void 0
+		},
+		twitter: {
+			card: head.twitter.card,
+			title: head.twitter.title,
+			description: head.twitter.description || void 0,
+			site: head.twitter.site ?? void 0,
+			creator: head.twitter.creator ?? void 0,
+			image: head.twitter.image ?? void 0,
+			imageAlt: head.twitter.imageAlt ?? void 0
+		}
+	};
+}
+
+//#endregion
+export { resolvePageHead, resolveRootHead };

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

@@ -0,0 +1,8 @@
+import { S2SClient } from "../../kizlo.js";
+import { AstroRoute } from "./utils.js";
+
+//#region src/integrations/astro/robots.d.ts
+/** Astro endpoint for `src/pages/robots.txt.ts`. SSR refetches live on each request. */
+declare function createRobotsRoute(client: S2SClient<[]>): AstroRoute;
+//#endregion
+export { createRobotsRoute };

package/dist/integrations/astro/robots.js

@@ -0,0 +1,11 @@
+import { createRobotsRoute } from "../../seo/robots.js";
+
+//#region src/integrations/astro/robots.ts
+/** Astro endpoint for `src/pages/robots.txt.ts`. SSR refetches live on each request. */
+function createRobotsRoute$1(client) {
+	const handler = createRobotsRoute(client);
+	return (context) => handler(context.request);
+}
+
+//#endregion
+export { createRobotsRoute$1 as createRobotsRoute };

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

@@ -0,0 +1,16 @@
+import { S2SClient } from "../../kizlo.js";
+import { CreateSitemapRouteOptions } from "../../seo/sitemap.js";
+import { AstroRoute } from "./utils.js";
+
+//#region src/integrations/astro/sitemap.d.ts
+
+/**
+ * Astro endpoint for `src/pages/sitemaps/[sitemap].xml.ts`. The core handler reads the slug from the
+ * request URL's last segment (`/sitemaps/posts.xml` → `posts.xml`), so forwarding `context.request`
+ * needs no `params` plumbing.
+ */
+declare function createSitemapRoute(client: S2SClient<[]>, options?: CreateSitemapRouteOptions): AstroRoute;
+/** Astro endpoint for `src/pages/sitemap.xml.ts`: 308-redirects the well-known path to the index. */
+declare function createSitemapRedirectRoute(): AstroRoute;
+//#endregion
+export { createSitemapRedirectRoute, createSitemapRoute };

package/dist/integrations/astro/sitemap.js

@@ -0,0 +1,20 @@
+import { createSitemapRedirectRoute, createSitemapRoute } from "../../seo/sitemap.js";
+
+//#region src/integrations/astro/sitemap.ts
+/**
+* Astro endpoint for `src/pages/sitemaps/[sitemap].xml.ts`. The core handler reads the slug from the
+* request URL's last segment (`/sitemaps/posts.xml` → `posts.xml`), so forwarding `context.request`
+* needs no `params` plumbing.
+*/
+function createSitemapRoute$1(client, options) {
+	const handler = createSitemapRoute(client, options);
+	return (context) => handler(context.request);
+}
+/** Astro endpoint for `src/pages/sitemap.xml.ts`: 308-redirects the well-known path to the index. */
+function createSitemapRedirectRoute$1() {
+	const handler = createSitemapRedirectRoute();
+	return (context) => handler(context.request);
+}
+
+//#endregion
+export { createSitemapRedirectRoute$1 as createSitemapRedirectRoute, createSitemapRoute$1 as createSitemapRoute };

package/dist/integrations/astro/utils.d.ts

@@ -0,0 +1,19 @@
+//#region src/integrations/astro/utils.d.ts
+/**
+ * Minimal shape of Astro's `APIContext` this integration needs — just the standard web `Request`.
+ * Typed structurally so the package never has to depend on `astro` (which stays an optional peer).
+ */
+interface AstroRouteContext {
+  request: Request;
+}
+/** An Astro endpoint handler (`export const GET = …`): takes the route context, returns a `Response`. */
+type AstroRoute = (context: AstroRouteContext) => Promise<Response> | Response;
+/**
+ * The public Kizlo API base URL, read from `process.env` as a last-resort fallback for a client built
+ * without an explicit `url`. The server factory (`createKizlo`) reads env the Astro-native way through
+ * `astro:env/server`, and client-side code passes `import.meta.env.PUBLIC_KIZLO_API_URL` at the call
+ * site (see the template's `client.ts`); this fallback only matters if neither is supplied.
+ */
+declare function getServerBaseUrl(): string;
+//#endregion
+export { AstroRoute, AstroRouteContext, getServerBaseUrl };

package/dist/integrations/astro/utils.js

@@ -0,0 +1,17 @@
+import { KizloError } from "../../shared/error.js";
+
+//#region src/integrations/astro/utils.ts
+/**
+* The public Kizlo API base URL, read from `process.env` as a last-resort fallback for a client built
+* without an explicit `url`. The server factory (`createKizlo`) reads env the Astro-native way through
+* `astro:env/server`, and client-side code passes `import.meta.env.PUBLIC_KIZLO_API_URL` at the call
+* site (see the template's `client.ts`); this fallback only matters if neither is supplied.
+*/
+function getServerBaseUrl() {
+	const baseUrl = process.env.PUBLIC_KIZLO_API_URL?.trim();
+	if (!baseUrl) throw new KizloError("MISSING_ENV_VARIABLE", { message: "Please define PUBLIC_KIZLO_API_URL in your .env file." });
+	return baseUrl;
+}
+
+//#endregion
+export { getServerBaseUrl };

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

@@ -1,5 +1,6 @@
 import { S2SClient } from "../../kizlo.js";
 import { SeoHead } from "../../seo/schema.js";
+import { renderJsonLd } from "../../seo/utils.js";
 import { Metadata, Viewport } from "next";
 
 //#region src/integrations/nextjs/metadata.d.ts

package/dist/integrations/nextjs/metadata.js

@@ -1,5 +1,6 @@
 import { resolveIcons } from "../../brand/icons.js";
 import { WEB_MANIFEST_ROUTE } from "../../brand/manifest.js";
+import { renderJsonLd } from "../../seo/utils.js";
 
 //#region src/integrations/nextjs/metadata.ts
 function createRootMetadata(client) {

package/dist/kizlo.d.ts

@@ -75,6 +75,12 @@ interface CreateKizloOptions<TExts extends readonly AnyExtension[] = []> {
     credentials?: Partial<WordPressCredentials>;
   };
 }
+/**
+ * Reads a single environment variable by name. Defaults to `process.env`, but framework factories can
+ * pass their own source: the Astro factory hands in `getSecret` from `astro:env/server`, so `.env` is
+ * resolved the Astro-native way (through the dev server / adapter) rather than through `process.env`.
+ */
+type EnvReader = (name: string) => string | undefined;
 /**
  * Resolves a full `KizloConfig` from options and the environment. Shared by the
  * base `createKizlo` and each framework factory — the single place env values
@@ -83,6 +89,7 @@ interface CreateKizloOptions<TExts extends readonly AnyExtension[] = []> {
 declare function resolveKizloConfig<TExts extends readonly AnyExtension[]>(options: CreateKizloOptions<TExts> | undefined, defaults: {
   baseUrlEnvKey: string;
   adapters?: ServiceAdapters;
+  env?: EnvReader;
 }): KizloConfig<TExts>;
 /**
  * Creates a Kizlo server from the environment (`KIZLO_API_URL`, `KIZLO_WP_SECRET`,
@@ -91,4 +98,4 @@ declare function resolveKizloConfig<TExts extends readonly AnyExtension[]>(optio
  */
 declare function createKizlo<TExts extends readonly AnyExtension[] = []>(options?: CreateKizloOptions<TExts>): Kizlo<TExts>;
 //#endregion
-export { AnyKizloConfig, CreateKizloOptions, Kizlo, KizloConfig, KizloConnect, RootRouter, S2SClient, ServiceAdapters, createKizlo, resolveKizloConfig };
+export { AnyKizloConfig, CreateKizloOptions, EnvReader, Kizlo, KizloConfig, KizloConnect, RootRouter, S2SClient, ServiceAdapters, createKizlo, resolveKizloConfig };

package/dist/kizlo.js

@@ -1,4 +1,4 @@
-import { RPC_PROTOCOL_HEADER } from "./shared/constants.js";
+import { CONTRACT_GENERATION_ENV, RPC_PROTOCOL_HEADER } from "./shared/constants.js";
 import { KizloError } from "./shared/error.js";
 import { createOrpcRouter } from "./shared/router.js";
 import { createResultClient } from "./shared/result.js";
@@ -100,14 +100,16 @@ var Kizlo = class {
 		};
 	}
 };
-function requireEnv(name) {
-	const value = process.env[name]?.trim();
-	if (!value) throw new KizloError("MISSING_ENV_VARIABLE", { message: `Please define ${name} in your .env file.` });
-	return value;
+const processEnvReader = (name) => process.env[name];
+function requireEnv(name, env) {
+	const value = env(name)?.trim();
+	if (value) return value;
+	if (process.env[CONTRACT_GENERATION_ENV]) return `__kizlo_contract_generation__:${name}`;
+	throw new KizloError("MISSING_ENV_VARIABLE", { message: `Please define ${name} in your .env file.` });
 }
-function resolveConnect(option) {
+function resolveConnect(option, env) {
 	if (option) return option;
-	const value = process.env.KIZLO_CONNECT?.trim();
+	const value = env("KIZLO_CONNECT")?.trim();
 	if (!value) return "remote";
 	if (value !== "local" && value !== "remote") throw new KizloError("INVALID_ENV_VARIABLE", { message: `KIZLO_CONNECT must be "local" or "remote", got "${value}".` });
 	return value;
@@ -128,12 +130,13 @@ function connectEnvKeys(connect) {
 * and credentials are read. `baseUrlEnvKey` is the only framework-varying part.
 */
 function resolveKizloConfig(options, defaults) {
+	const env = defaults.env ?? processEnvReader;
 	const credentials = options?.wordpress?.credentials;
-	const connect = resolveConnect(options?.connect);
+	const connect = resolveConnect(options?.connect, env);
 	const keys = connectEnvKeys(connect);
 	return {
-		baseUrl: options?.baseUrl ?? requireEnv(defaults.baseUrlEnvKey),
-		siteSecret: options?.siteSecret ?? requireEnv(keys.siteSecret),
+		baseUrl: options?.baseUrl ?? requireEnv(defaults.baseUrlEnvKey, env),
+		siteSecret: options?.siteSecret ?? requireEnv(keys.siteSecret, env),
 		environment: options?.environment ?? process.env.NODE_ENV ?? "development",
 		connect,
 		extensions: options?.extensions,
@@ -142,9 +145,9 @@ function resolveKizloConfig(options, defaults) {
 			...options?.adapters
 		},
 		credentials: {
-			url: credentials?.url ?? requireEnv(keys.url),
-			username: credentials?.username ?? requireEnv(keys.username),
-			password: credentials?.password ?? requireEnv(keys.password)
+			url: credentials?.url ?? requireEnv(keys.url, env),
+			username: credentials?.username ?? requireEnv(keys.username, env),
+			password: credentials?.password ?? requireEnv(keys.password, env)
 		}
 	};
 }

package/dist/nextjs/server.d.ts

@@ -1,4 +1,5 @@
 import { WEB_MANIFEST_ROUTE } from "../brand/manifest.js";
+import { renderJsonLd } from "../seo/utils.js";
 import { createSitemapRedirectRoute } from "../seo/sitemap.js";
 import { NextRevalidateOptions, RevalidatePathFn, RevalidateTagFn, RevalidateTarget, nextRevalidation } from "../integrations/nextjs/revalidate.js";
 import { KizloServerOptions, createKizlo } from "../integrations/nextjs/kizlo.server.js";
@@ -7,4 +8,4 @@ import { createPageMetadata, createRootMetadata, createRootViewport } from "../i
 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 { KizloServerOptions, MANIFEST_CACHE_TAG, NextRevalidateOptions, ROBOTS_CACHE_TAG, RevalidatePathFn, RevalidateTagFn, RevalidateTarget, SITEMAP_CACHE_TAG, SITEMAP_ROUTE, WEB_MANIFEST_ROUTE, createCachedTextRoute, createKizlo, createManifestRoute, createNextCookiesInterface, createPageMetadata, createRobotsRoute, createRootMetadata, createRootViewport, createSitemapRedirectRoute, createSitemapRoute, getServerBaseUrl, nextRevalidation };
+export { KizloServerOptions, MANIFEST_CACHE_TAG, NextRevalidateOptions, ROBOTS_CACHE_TAG, RevalidatePathFn, RevalidateTagFn, RevalidateTarget, SITEMAP_CACHE_TAG, SITEMAP_ROUTE, WEB_MANIFEST_ROUTE, createCachedTextRoute, createKizlo, createManifestRoute, createNextCookiesInterface, createPageMetadata, createRobotsRoute, createRootMetadata, createRootViewport, createSitemapRedirectRoute, createSitemapRoute, getServerBaseUrl, nextRevalidation, renderJsonLd };

package/dist/nextjs/server.js

@@ -1,4 +1,5 @@
 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 { ROBOTS_CACHE_TAG, createRobotsRoute } from "../integrations/nextjs/robots.js";
@@ -8,4 +9,4 @@ import { createKizlo } from "../integrations/nextjs/kizlo.server.js";
 import { MANIFEST_CACHE_TAG, createManifestRoute } from "../integrations/nextjs/manifest.js";
 import { createPageMetadata, createRootMetadata, createRootViewport } from "../integrations/nextjs/metadata.js";
 
-export { MANIFEST_CACHE_TAG, ROBOTS_CACHE_TAG, SITEMAP_CACHE_TAG, SITEMAP_ROUTE, WEB_MANIFEST_ROUTE, createCachedTextRoute, createKizlo, createManifestRoute, createNextCookiesInterface, createPageMetadata, createRobotsRoute, createRootMetadata, createRootViewport, createSitemapRedirectRoute, createSitemapRoute, getServerBaseUrl, nextRevalidation };
+export { MANIFEST_CACHE_TAG, ROBOTS_CACHE_TAG, SITEMAP_CACHE_TAG, SITEMAP_ROUTE, WEB_MANIFEST_ROUTE, createCachedTextRoute, createKizlo, createManifestRoute, createNextCookiesInterface, createPageMetadata, createRobotsRoute, createRootMetadata, createRootViewport, createSitemapRedirectRoute, createSitemapRoute, getServerBaseUrl, nextRevalidation, renderJsonLd };

package/dist/package.js

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

package/dist/page/schema.js

@@ -1,7 +1,7 @@
-import { IdentifierInput, ListMetadata, ListOrder, Media } from "../shared/schema.js";
+import { IdentifierInput, ListMetadata, ListOrder } from "../shared/schema.js";
 import { WP_PAGE_ORDER_BYES, WP_PAGE_STATUSES } from "../wordpress/page/types.js";
 import { Seo } from "../seo/schema.js";
-import { Metadata, NumberLike, arrayable, lenient } from "@kizlo/shared";
+import { Media, Metadata, NumberLike, arrayable, lenient } from "@kizlo/shared";
 import z from "zod/v4";
 
 //#region src/page/schema.ts

package/dist/post/schema.js

@@ -1,7 +1,7 @@
-import { IdentifierInput, ListMetadata, ListOrder, Media } from "../shared/schema.js";
+import { IdentifierInput, ListMetadata, ListOrder } from "../shared/schema.js";
 import { WP_POST_FORMATS, WP_POST_ORDER_BYES, WP_POST_STATUSES, WP_POST_TAX_RELATIONS } from "../wordpress/post/types.js";
 import { Seo } from "../seo/schema.js";
-import { BooleanLike, Metadata, NumberLike, arrayable, lenient } from "@kizlo/shared";
+import { BooleanLike, Media, Metadata, NumberLike, arrayable, lenient } from "@kizlo/shared";
 import z from "zod/v4";
 
 //#region src/post/schema.ts

package/dist/seo/utils.d.ts

@@ -1,8 +1,14 @@
-import { Seo, Sitemap, SitemapUrl } from "./schema.js";
+import { Seo, SeoSchema, Sitemap, SitemapUrl } from "./schema.js";
 import { WPK_Seo } from "./types.js";
 
 //#region src/seo/utils.d.ts
 declare function deserializeSeo(data: WPK_Seo): Seo;
+/**
+ * Serialize a post's JSON-LD (`data.seo.schema`) for a `<script type="application/ld+json">` tag.
+ * Returns `null` when the `@graph` is empty so the template can skip the tag entirely. The result
+ * is JSON, safe to inject as script-element text content.
+ */
+declare function renderJsonLd(schema: SeoSchema): string | null;
 type SitemapIndexEntry = Pick<Sitemap, "key" | "pages" | "lastmod">;
 declare function sitemapEntryPath(key: string, page: number): string;
 declare function parseSitemapSlug(slug: string): {
@@ -13,4 +19,4 @@ declare function renderSitemapIndex(sitemaps: readonly SitemapIndexEntry[], orig
 declare function renderUrlSet(urls: SitemapUrl[]): string;
 declare function xmlResponse(body: string): Response;
 //#endregion
-export { SitemapIndexEntry, deserializeSeo, parseSitemapSlug, renderSitemapIndex, renderUrlSet, sitemapEntryPath, xmlResponse };
+export { SitemapIndexEntry, deserializeSeo, parseSitemapSlug, renderJsonLd, renderSitemapIndex, renderUrlSet, sitemapEntryPath, xmlResponse };

package/dist/seo/utils.js

@@ -41,6 +41,14 @@ function deserializeSeo(data) {
 		schema: data.schema
 	};
 }
+/**
+* Serialize a post's JSON-LD (`data.seo.schema`) for a `<script type="application/ld+json">` tag.
+* Returns `null` when the `@graph` is empty so the template can skip the tag entirely. The result
+* is JSON, safe to inject as script-element text content.
+*/
+function renderJsonLd(schema) {
+	return schema["@graph"].length ? JSON.stringify(schema) : null;
+}
 function sitemapEntryPath(key, page) {
 	return `/sitemaps/${key}${page > 1 ? `-${page}` : ""}.xml`;
 }
@@ -75,4 +83,4 @@ function xmlResponse(body) {
 }
 
 //#endregion
-export { deserializeSeo, parseSitemapSlug, renderSitemapIndex, renderUrlSet, sitemapEntryPath, xmlResponse };
+export { deserializeSeo, parseSitemapSlug, renderJsonLd, renderSitemapIndex, renderUrlSet, sitemapEntryPath, xmlResponse };

package/dist/shared/constants.js

@@ -5,6 +5,14 @@ import { milliseconds } from "@kizlo/shared";
 const VERSION = version;
 const RPC_PROTOCOL_HEADER = "x-rpc-protocol";
 const SESSION_EXPIRY_MARGIN_MS = milliseconds("5 minutes");
+/**
+* Set in `process.env` by the CLI daemon while it imports the server module solely to read the
+* router's *shape* for contract generation. No request is served in that mode, so `requireEnv`
+* returns a placeholder instead of aborting the import when connection env vars are absent — the
+* router shape doesn't depend on any env value, and framework virtual modules (e.g. Astro's
+* `getSecret`) are stubbed to `undefined` during the shape-only import anyway.
+*/
+const CONTRACT_GENERATION_ENV = "KIZLO_CONTRACT_GENERATION";
 
 //#endregion
-export { RPC_PROTOCOL_HEADER };
+export { CONTRACT_GENERATION_ENV, RPC_PROTOCOL_HEADER };

package/dist/shared/schema.d.ts

@@ -1,4 +1,3 @@
-import { Media } from "@kizlo/shared";
 import z from "zod/v4";
 
 //#region src/shared/schema.d.ts
@@ -46,4 +45,4 @@ declare const PreviewTokenData: z.ZodObject<{
 }, z.core.$strip>;
 type PreviewTokenData = z.infer<typeof PreviewTokenData>;
 //#endregion
-export { CurrencyFormat, IdentifierInput, LIST_ORDER, ListMetadata, ListOrder, Media, PreviewTokenData, PreviewTokenPayload };
+export { CurrencyFormat, IdentifierInput, LIST_ORDER, ListMetadata, ListOrder, PreviewTokenData, PreviewTokenPayload };

package/dist/shared/schema.js

@@ -1,4 +1,4 @@
-import { Media, NumberLike } from "@kizlo/shared";
+import { NumberLike } from "@kizlo/shared";
 import z from "zod/v4";
 
 //#region src/shared/schema.ts
@@ -34,4 +34,4 @@ const PreviewTokenData = z.object({
 });
 
 //#endregion
-export { CurrencyFormat, IdentifierInput, LIST_ORDER, ListMetadata, ListOrder, Media, PreviewTokenData, PreviewTokenPayload };
+export { CurrencyFormat, IdentifierInput, LIST_ORDER, ListMetadata, ListOrder, PreviewTokenData, PreviewTokenPayload };

package/dist/wordpress/service.d.ts

@@ -20,9 +20,13 @@ declare class WordPressService {
   private readonly siteBase;
   private readonly authHeader;
   private readonly defaultTimeout;
+  /** Called with the response headers of every non-transport-error response, so callers can observe
+   * per-response signals (e.g. the plugin version header) without threading them through every method. */
+  private readonly onResponse?;
   constructor(context: {
     credentials: WordPressCredentials;
     timeout?: Duration;
+    onResponse?: (headers: Headers) => void;
   });
   post<TData, TCode extends string = never>(path: string, input: {
     body?: unknown;

package/dist/wordpress/service.js

@@ -22,6 +22,9 @@ var WordPressService = class {
 	siteBase;
 	authHeader;
 	defaultTimeout;
+	/** Called with the response headers of every non-transport-error response, so callers can observe
+	* per-response signals (e.g. the plugin version header) without threading them through every method. */
+	onResponse;
 	constructor(context) {
 		const credentialBytes = new TextEncoder().encode(`${context.credentials.username}:${context.credentials.password}`);
 		let binary = "";
@@ -29,6 +32,7 @@ var WordPressService = class {
 		this.authHeader = `${WP_AUTH_TYPE} ${btoa(binary)}`;
 		this.siteBase = context.credentials.url.endsWith("/") ? context.credentials.url : `${context.credentials.url}/`;
 		this.defaultTimeout = context.timeout ?? SAFE_REQUEST_TIMEOUT;
+		this.onResponse = context.onResponse;
 	}
 	async post(path, input) {
 		return this.request({
@@ -103,6 +107,7 @@ var WordPressService = class {
 				message: transportErr.message
 			})
 		};
+		this.onResponse?.(response.headers);
 		const [readErr, text] = await tryCatch(response.text());
 		if (readErr) return {
 			data: null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kizlo",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "type": "module",
   "description": "A headless WordPress framework for TypeScript.",
   "keywords": [
@@ -63,6 +63,18 @@
         "types": "./dist/nextjs/server.d.ts",
         "default": "./dist/nextjs/server.js"
       }
+    },
+    "./astro": {
+      "import": {
+        "types": "./dist/astro.d.ts",
+        "default": "./dist/astro.js"
+      }
+    },
+    "./astro/server": {
+      "import": {
+        "types": "./dist/astro/server.d.ts",
+        "default": "./dist/astro/server.js"
+      }
     }
   },
   "files": [
@@ -76,7 +88,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.5.1",
-    "@kizlo/shared": "0.5.1",
+    "@kizlo/shared": "0.6.0",
     "@orpc/client": "^1.14.3",
     "@orpc/contract": "^1.14.3",
     "@orpc/openapi": "^1.14.3",
@@ -93,11 +105,15 @@
     "zod": "^4.3.6"
   },
   "peerDependencies": {
+    "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"
   },
   "peerDependenciesMeta": {
+    "astro": {
+      "optional": true
+    },
     "next": {
       "optional": true
     },

package/dist/cli/presets/base.js

@@ -1,40 +0,0 @@
-import { DEFAULT_ENV_KEYS } from "../utils.js";
-
-//#region src/cli/presets/base.ts
-const base = {
-	id: "base",
-	label: "Generic (no framework detected)",
-	detect: () => 1,
-	envKeys: DEFAULT_ENV_KEYS,
-	scaffolds(ctx) {
-		return [{
-			label: "Kizlo server instance",
-			relPath: ctx.serverEntryPath,
-			contents: `import { createKizlo } from "kizlo"
-
-export const { router, client, context, handler } = createKizlo()
-`
-		}, {
-			label: "Browser client",
-			relPath: ctx.clientPath,
-			contents: clientEntry(ctx)
-		}];
-	}
-};
-function clientEntry(ctx) {
-	if (ctx.clientUrl) return `import { createKizloClient } from "kizlo"
-import { contract } from "./${ctx.serverDirName}/generated"
-
-// Your Kizlo backend runs on a different origin than this app. Swap in your bundler's
-// public env var (e.g. import.meta.env.VITE_KIZLO_API_URL) to set it per environment.
-export const client = createKizloClient(contract, { url: "${ctx.clientUrl}" })
-`;
-	return `import { createKizloClient } from "kizlo"
-import { contract } from "./${ctx.serverDirName}/generated"
-
-export const client = createKizloClient(contract)
-`;
-}
-
-//#endregion
-export { base };

package/dist/cli/presets/index.js

@@ -1,16 +0,0 @@
-import { base } from "./base.js";
-import { nextjs } from "./nextjs.js";
-
-//#region src/cli/presets/index.ts
-/** Framework presets, in declaration order. `base` always matches last. */
-const PRESETS = [nextjs, base];
-function getPreset(id) {
-	return PRESETS.find((preset) => preset.id === id);
-}
-/** Highest-scoring preset for the project; falls back to `base`. */
-function detectPreset(ctx) {
-	return PRESETS.reduce((best, preset) => preset.detect(ctx) > best.detect(ctx) ? preset : best);
-}
-
-//#endregion
-export { PRESETS, detectPreset, getPreset };

package/dist/cli/presets/nextjs.js

@@ -1,16 +0,0 @@
-//#region src/cli/presets/nextjs.ts
-const nextjs = {
-	id: "nextjs",
-	label: "Next.js",
-	detect(ctx) {
-		return {
-			...ctx.pkg.dependencies,
-			...ctx.pkg.devDependencies
-		}.next ? 100 : 0;
-	},
-	apiPath: "/api/kizlo",
-	template: "nextjs"
-};
-
-//#endregion
-export { nextjs };