kizlo 0.3.2 → 0.5.0

package/dist/brand/icons.d.ts

@@ -0,0 +1,42 @@
+import { BrandSettings } from "../settings/service.interface.js";
+
+//#region src/brand/icons.d.ts
+interface IconDescriptor {
+  url: string;
+  /** The attachment's mime, e.g. `image/svg+xml`, mapped to the `type` attribute. */
+  type: string;
+  /** `"any"` for scalable/single sources; omitted for `.ico`. */
+  sizes?: string;
+  /** Media query for scheme-specific variants, e.g. `(prefers-color-scheme: dark)`. */
+  media?: string;
+}
+interface ManifestIcon {
+  src: string;
+  type: string;
+  sizes: string;
+  /**
+   * `"maskable"` marks art with a safe zone the launcher may crop to any
+   * adaptive shape; omitted (default `"any"`) sources render uncropped.
+   */
+  purpose?: "any" | "maskable";
+}
+interface ResolvedIcons {
+  /** `rel="icon"` candidates: the light source plus an optional dark variant. */
+  icon: IconDescriptor[];
+  /** `rel="apple-touch-icon"` candidate (raster-guarded), or empty. */
+  appleTouch: IconDescriptor[];
+  /**
+   * Web-manifest icon entries (raster or SVG): the square brand icon as the
+   * default `"any"` source — expanded to one entry per real square rendition —
+   * plus the dedicated Android icon as `"maskable"` when provided. Either may
+   * be absent.
+   */
+  manifestIcons: ManifestIcon[];
+}
+/**
+ * Resolve the brand settings into a normalized icon set. Slots that resolve to
+ * nothing are simply left out; the consumer only emits what is present.
+ */
+declare function resolveIcons(brand: BrandSettings): ResolvedIcons;
+//#endregion
+export { IconDescriptor, ManifestIcon, ResolvedIcons, resolveIcons };

package/dist/brand/icons.js

@@ -0,0 +1,108 @@
+//#region src/brand/icons.ts
+/** Raster mimes: the only sources iOS home-screen icons can render. */
+const RASTER_MIMES = new Set(["image/png", "image/jpeg"]);
+/** Scalable icon mime, valid in `rel=icon` and modern web manifests. */
+const SVG_MIME = "image/svg+xml";
+/** Mimes a web manifest can use: raster plus scalable SVG. `.ico` is excluded. */
+const MANIFEST_MIMES = new Set([...RASTER_MIMES, SVG_MIME]);
+/**
+* Smallest square rendition worth advertising as a manifest icon. 192px is
+* Chrome's minimum installable icon size, so smaller generated copies add no
+* install value; a source below it still falls through to its original.
+*/
+const MANIFEST_ICON_FLOOR = 192;
+/** `.ico` self-describes its bundled sizes, so it takes no `sizes` hint. */
+const ICO_MIMES = new Set(["image/x-icon", "image/vnd.microsoft.icon"]);
+function isRaster(media) {
+	return media != null && media.mime !== void 0 && RASTER_MIMES.has(media.mime);
+}
+/** Return the media only when it is a raster the target can render; otherwise null. */
+function raster(media) {
+	return isRaster(media) ? media : null;
+}
+/** Return the media only when a web manifest can render it (raster or SVG). */
+function manifestSource(media) {
+	return media?.mime && MANIFEST_MIMES.has(media.mime) ? media : null;
+}
+/**
+* A raster source carries real pixel dimensions; use them verbatim so a
+* descriptor never claims a size the image cannot satisfy. Falls back to `"any"`
+* on scalable sources (e.g. SVG) that have no fixed size.
+*/
+function pixelSize(media) {
+	return media.width && media.height ? `${media.width}x${media.height}` : "any";
+}
+function toDescriptor(media, extra) {
+	return {
+		url: media.src,
+		type: media.mime ?? "",
+		sizes: media.mime && ICO_MIMES.has(media.mime) ? void 0 : pixelSize(media),
+		...extra
+	};
+}
+/**
+* Manifest icon entries for a source. A scalable SVG yields a single `"any"`
+* entry (it covers every size). A raster source expands into its real renditions
+* — the original plus WordPress's generated resizes — keeping only square ones at
+* or above the floor so browsers get genuine 192/512-ish icons; if none qualify
+* (e.g. a non-square upload) the original is used as-is.
+*/
+function toManifestIcons(media, purpose) {
+	const type = media.mime ?? "";
+	const withPurpose = purpose ? { purpose } : {};
+	if (media.mime === SVG_MIME) return [{
+		src: media.src,
+		type,
+		sizes: "any",
+		...withPurpose
+	}];
+	const square = [{
+		src: media.src,
+		width: media.width,
+		height: media.height
+	}, ...media.variants ?? []].filter((r) => r.width && r.height && r.width === r.height && r.width >= MANIFEST_ICON_FLOOR);
+	const chosen = square.length ? square : [{
+		src: media.src,
+		width: media.width,
+		height: media.height
+	}];
+	const seen = /* @__PURE__ */ new Set();
+	const icons = [];
+	for (const r of chosen) {
+		const sizes = r.width && r.height ? `${r.width}x${r.height}` : "any";
+		if (seen.has(sizes)) continue;
+		seen.add(sizes);
+		icons.push({
+			src: r.src,
+			type,
+			sizes,
+			...withPurpose
+		});
+	}
+	return icons;
+}
+/**
+* Resolve the brand settings into a normalized icon set. Slots that resolve to
+* nothing are simply left out; the consumer only emits what is present.
+*/
+function resolveIcons(brand) {
+	const icon = [];
+	const light = brand.favicon ?? brand.logo_icon;
+	if (light) icon.push(toDescriptor(light));
+	if (brand.favicon_dark) icon.push(toDescriptor(brand.favicon_dark, { media: "(prefers-color-scheme: dark)" }));
+	const apple = raster(brand.ios_app_icon) ?? raster(brand.favicon);
+	const appleTouch = apple ? [toDescriptor(apple)] : [];
+	const manifestIcons = [];
+	const anySource = manifestSource(brand.logo_icon) ?? manifestSource(brand.favicon);
+	if (anySource) manifestIcons.push(...toManifestIcons(anySource));
+	const maskable = manifestSource(brand.android_app_icon);
+	if (maskable) manifestIcons.push(...toManifestIcons(maskable, "maskable"));
+	return {
+		icon,
+		appleTouch,
+		manifestIcons
+	};
+}
+
+//#endregion
+export { resolveIcons };

package/dist/brand/index.d.ts

@@ -0,0 +1,2 @@
+import { IconDescriptor, ManifestIcon, ResolvedIcons, resolveIcons } from "./icons.js";
+import { WEB_MANIFEST_ROUTE, WebManifest, buildWebManifest, createManifestRoute } from "./manifest.js";

package/dist/brand/manifest.d.ts

@@ -0,0 +1,21 @@
+import { Settings } from "../settings/service.interface.js";
+import { ManifestIcon } from "./icons.js";
+import { S2SClient } from "../kizlo.js";
+
+//#region src/brand/manifest.d.ts
+declare const WEB_MANIFEST_ROUTE: "/site.webmanifest";
+interface WebManifest {
+  id: string;
+  name: string;
+  short_name: string;
+  start_url: string;
+  scope: string;
+  display: "standalone" | "fullscreen" | "minimal-ui" | "browser";
+  background_color?: string;
+  theme_color?: string;
+  icons: ManifestIcon[];
+}
+declare function buildWebManifest(settings: Settings): WebManifest;
+declare function createManifestRoute(client: S2SClient<[]>): (_request: Request) => Promise<Response>;
+//#endregion
+export { WEB_MANIFEST_ROUTE, WebManifest, buildWebManifest, createManifestRoute };

package/dist/brand/manifest.js

@@ -0,0 +1,28 @@
+import { resolveIcons } from "./icons.js";
+
+//#region src/brand/manifest.ts
+const WEB_MANIFEST_ROUTE = "/site.webmanifest";
+function buildWebManifest(settings) {
+	const org = settings.identity.type === "organization" ? settings.identity.organization : null;
+	const manifest = {
+		id: "/",
+		name: settings.site.name ?? org?.name ?? "",
+		short_name: settings.site.alternate_name ?? org?.name ?? settings.site.name ?? "",
+		start_url: "/",
+		scope: "/",
+		display: "standalone",
+		icons: resolveIcons(settings.brand).manifestIcons
+	};
+	if (settings.brand.theme_color) manifest.theme_color = settings.brand.theme_color;
+	if (settings.brand.background_color) manifest.background_color = settings.brand.background_color;
+	return manifest;
+}
+function createManifestRoute(client) {
+	return async function GET(_request) {
+		const settings = await client.settings.get.call();
+		return new Response(JSON.stringify(buildWebManifest(settings)), { headers: { "Content-Type": "application/manifest+json" } });
+	};
+}
+
+//#endregion
+export { WEB_MANIFEST_ROUTE, buildWebManifest, createManifestRoute };

package/dist/cli/presets/nextjs.js

@@ -14,6 +14,7 @@ const nextjs = {
 		const apiDir = `${ctx.appDir}/api/kizlo/[[...rest]]`;
 		const robotsDir = `${ctx.appDir}/robots.txt`;
 		const sitemapDir = `${ctx.appDir}/sitemaps/[sitemap]`;
+		const manifestDir = `${ctx.appDir}/site.webmanifest`;
 		return [
 			{
 				label: "Kizlo server instance",
@@ -84,6 +85,24 @@ export const runtime = "edge"
 export const dynamic = "force-dynamic"
 
 export const GET = createSitemapRoute(client)
+`
+			},
+			{
+				label: "web manifest route",
+				relPath: `${manifestDir}/route.ts`,
+				contents: `import { createManifestRoute } from "kizlo/nextjs/server"
+import { client } from "${ctx.serverImport(manifestDir)}"
+
+// Run on the edge: cheaper and faster than Node for a response this small.
+export const runtime = "edge"
+
+// Like robots.txt, Vercel bakes this route into an immutable Edge CDN asset at build time,
+// bypassing ISR and on-demand revalidatePath. force-dynamic opts out of that static treatment
+// so brand-settings edits show up; createManifestRoute caches the WordPress call, so requests
+// stay cheap.
+export const dynamic = "force-dynamic"
+
+export const GET = createManifestRoute(client)
 `
 			}
 		];

package/dist/client.d.ts

@@ -1,5 +1,5 @@
-import { ResultClient } from "./shared/result.js";
 import { AnyProcedureRouter, ExtractProcedureByScope } from "./shared/procedure.js";
+import { ResultClient } from "./shared/result.js";
 
 //#region src/client.d.ts
 interface KizloClientConfig<T extends AnyProcedureRouter> {

package/dist/context.d.ts

@@ -5,8 +5,8 @@ import { PreviewTokenPayload } from "./shared/schema.js";
 import { ConnInfo } from "./adapters/geo.js";
 import { Logger } from "./adapters/logger.js";
 import { CookiesStorage } from "./cookie.js";
-import { ServiceAdapters } from "./kizlo.js";
 import { Service } from "./service.js";
+import { ServiceAdapters } from "./kizlo.js";
 
 //#region src/context.d.ts
 interface ContextConfig {

package/dist/index.d.ts

@@ -26,16 +26,19 @@ import { createCookiesAdapter } from "./adapters/cookies.js";
 import { ConnInfo, GeoAdapter, GeoGetConnInfo, createGeoAdapter, geoMock } from "./adapters/geo.js";
 import { geoVercelNext } from "./adapters/geo.vercel.js";
 import { ConsoleLogAdapterOptions, Environment, LogLevel, LogPayload, Logger, LoggerAdapter, consoleLog, createLoggerAdapter, noopAdapter } from "./adapters/logger.js";
-import { AnyEventSchema, AnyEvents, EventHandler, EventHandlerFn, InferEventUnion, WebhookOptions, createEventHandler, createWebhookRouter } from "./webhook/index.js";
-import { AnyExtension, Extension, ExtensionInitFn, ExtensionInitOptions, ExtensionInitResult, ExtractExtensionRouter, InferExtensionRouter, createExtension } from "./shared/extension.js";
-import { COMMON_ERRORS, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, DefinedErrorMapLike, ErrorDefinition, KizloError, KizloErrorOptions, ThrowableErrorFn, ThrowableErrorMap, WithCommonErrorMap, createThrowableErrorMap, defineErrorMap, isKizloError, toKizloError } from "./shared/error.js";
-import { AnyKizloConfig, CreateKizloOptions, Kizlo, KizloConfig, KizloTarget, RootRouter, S2SClient, ServiceAdapters, createKizlo, resolveKizloConfig } from "./kizlo.js";
-import { KizloAuthorsSettings, KizloAuthorsSettingsInput, KizloCrawlingSettings, KizloCrawlingSettingsInput, KizloIdentitySettings, KizloIdentitySettingsInput, KizloMedia, KizloOrganizationFounder, KizloOrganizationSettings, KizloOrganizationSettingsInput, KizloPersonSettings, KizloPersonSettingsInput, KizloPostStatus, KizloPostTypeSettings, KizloPostTypeSettingsInput, KizloSettings, KizloSiteSettings, KizloSiteSettingsInput, KizloSocialProfile, KizloTaxonomySettings, KizloTaxonomySettingsInput, KizloWebhookSettings, KizloWebhookSettingsInput } from "./settings/service.interface.js";
-import { KizloSettingsService } from "./settings/service.js";
+import { AuthorsSettings, AuthorsSettingsInput, BrandSettings, BrandSettingsInput, CrawlingSettings, CrawlingSettingsInput, IdentitySettings, IdentitySettingsInput, OrganizationFounder, OrganizationSettings, OrganizationSettingsInput, PersonSettings, PersonSettingsInput, PostStatusDefinition, PostTypeSettings, PostTypeSettingsInput, Settings, SiteSettings, SiteSettingsInput, SocialProfile, TaxonomySettings, TaxonomySettingsInput, WebhookSettings, WebhookSettingsInput } from "./settings/service.interface.js";
+import { IconDescriptor, ManifestIcon, ResolvedIcons, resolveIcons } from "./brand/icons.js";
+import { SettingsService } from "./settings/service.js";
 import { Service, ServiceConfig } from "./service.js";
 import { AuthUserFn, ConnInfoFn, Context, ContextConfig, ServerContext, 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, InferUses, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, createMiddleware } from "./shared/middleware.js";
 import { AnyProcedure, AnyProcedureRouter, BaseHandlerOptions, ExtractParams, ExtractProcedureByScope, InvocationScope, OpenapiPart, Procedure, ProcedureContext, ProcedureErrors, ProcedureHandler, ProcedureOptions, ResolveParamsPart, ResolvedSchemaInput, ResolvedSchemaOutput, RouterDepthTuple, SchemaIO, buildProcedure, combineDetailed, createProcedure, handleUnexpectedError, schemaType } from "./shared/procedure.js";
+import { AnyExtension, Extension, ExtensionInitFn, ExtensionInitOptions, ExtensionInitResult, ExtractExtensionRouter, InferExtensionRouter, createExtension } from "./shared/extension.js";
+import { AnyKizloConfig, CreateKizloOptions, Kizlo, KizloConfig, KizloTarget, RootRouter, S2SClient, ServiceAdapters, createKizlo, resolveKizloConfig } from "./kizlo.js";
+import { WEB_MANIFEST_ROUTE, WebManifest, buildWebManifest, createManifestRoute } from "./brand/manifest.js";
+import "./brand/index.js";
 import { KizloClient, KizloClientConfig, createKizloClient } from "./client.js";
 import { CreateSitemapRouteOptions, SITEMAP_BASE, SITEMAP_INDEX_SLUG, SitemapRouteExtra, createSitemapRoute } from "./seo/sitemap.js";
 import { Contract, ContractProcedure, generateContract, isContractProcedure, restoreContract } from "./shared/contract.js";
@@ -43,4 +46,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 { AnyContext, AnyEventSchema, AnyEvents, AnyExtension, AnyKizloConfig, AnyMiddleware, AnyNestedClient, AnyProcedure, AnyProcedureRouter, AuthAdapter, AuthGetUser, AuthUser, AuthUserFn, BaseHandlerOptions, CART_HASH_HEADER_KEY, COMMON_ERRORS, CONTENT_TYPES, CaptchaAdapter, CommentService, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, ConnInfo, ConnInfoFn, ConsoleLogAdapterOptions, ContentType, Context, ContextConfig, Contract, ContractProcedure, CookiesAdapter, CookiesDeleteAll, CookiesGetAll, CookiesSetAll, CreateKizloOptions, CreateSitemapRouteOptions, CurrencyFormat, DefinedErrorMapLike, DevPluginSource, Environment, ErrorDefinition, EventHandler, EventHandlerFn, Extension, ExtensionInitFn, ExtensionInitOptions, ExtensionInitResult, ExtractExtensionRouter, ExtractMiddlewareContextOutput, ExtractParams, ExtractProcedureByScope, Fixture, FixtureCleanupFn, FixtureSeedFn, GeoAdapter, GeoGetConnInfo, HTTPMethod, Identifier, IdentifierInput, InferEventUnion, InferExtensionRouter, InferUses, InvocationScope, JsonValue, Kizlo, KizloAuthorsSettings, KizloAuthorsSettingsInput, KizloClient, KizloClientConfig, KizloConfig, KizloCrawlingSettings, KizloCrawlingSettingsInput, KizloError, KizloErrorOptions, KizloIdentitySettings, KizloIdentitySettingsInput, KizloMedia, KizloOrganizationFounder, KizloOrganizationSettings, KizloOrganizationSettingsInput, KizloPersonSettings, KizloPersonSettingsInput, KizloPostStatus, KizloPostTypeSettings, KizloPostTypeSettingsInput, KizloSettings, KizloSettingsService, KizloSiteSettings, KizloSiteSettingsInput, KizloSocialProfile, KizloTarget, KizloTaxonomySettings, KizloTaxonomySettingsInput, KizloWebhookSettings, KizloWebhookSettingsInput, LIST_ORDER, List, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, LocalPlugin, LogLevel, LogPayload, Logger, LoggerAdapter, MaybeOptionalOptions, Media, MenuItemService, MenuService, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, OpenapiPart, PluginSource, PostService, PreviewTokenData, PreviewTokenPayload, Procedure, ProcedureContext, ProcedureErrors, ProcedureHandler, ProcedureOptions, RedirectInput, RedirectStatus, ResolveParamsPart, ResolvedSchemaInput, ResolvedSchemaOutput, Robots, RobotsRule, RootRouter, RouterDepthTuple, S2SClient, SAFE_REQUEST_TIMEOUT, SITEMAP_BASE, SITEMAP_INDEX_SLUG, SchemaIO, SeedContext, Seo, SeoHead, SeoSchema, ServerContext, Service, ServiceAdapters, ServiceConfig, ShaAlgorithm, Sitemap, SitemapIndex, type SitemapIndexEntry, SitemapList, SitemapRouteExtra, SitemapUrl, SitemapUrlImage, SitemapUrlList, TestAdminUser, TestCredentials, TestUser, ThrowableErrorFn, ThrowableErrorMap, UNEXPECTED_BODY_SNIPPET_LENGTH, UserService, VerifyCaptchaFn, VerifyPreviewTokenFn, WC_CORE_BASE, WC_STORE_BASE, WPK_ListSitemapUrlInput, WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapContentType, WPK_SitemapIndex, WPK_SitemapUrl, WPK_SitemapUrlImage, WP_AUTH_HEADER_KEY, WP_AUTH_TYPE, WP_CORE_BASE, WP_Comment, WP_CommentAvatarUrls, WP_CommentContent, WP_CommentContentInput, WP_CommentCreateErrorCode, WP_CommentCreateInput, WP_CommentDeleteErrorCode, WP_CommentDeleteInput, WP_CommentDeleteResponse, WP_CommentLinks, WP_CommentListErrorCode, WP_CommentListInput, WP_CommentOrderBy, WP_CommentRetrieveErrorCode, WP_CommentRetrieveInput, WP_CommentStatus, WP_CommentStatusFilter, WP_CommentStatusInput, WP_CommentType, WP_CommentUpdateErrorCode, WP_CommentUpdateInput, WP_CommonErrorCode, WP_Context, WP_CurrencyFormat, WP_Error, WP_ErrorData, WP_KIZLO_BASE, WP_Link, WP_List, WP_ListMetadata, WP_ListOrder, WP_Menu, WP_MenuCreateErrorCode, WP_MenuCreateInput, WP_MenuDeleteErrorCode, WP_MenuDeleteInput, WP_MenuDeleteResponse, WP_MenuItem, WP_MenuItemCreateErrorCode, WP_MenuItemCreateInput, WP_MenuItemDeleteErrorCode, WP_MenuItemDeleteInput, WP_MenuItemDeleteResponse, WP_MenuItemLinks, WP_MenuItemListErrorCode, WP_MenuItemListInput, WP_MenuItemOrderBy, WP_MenuItemRetrieveErrorCode, WP_MenuItemRetrieveInput, WP_MenuItemStatus, WP_MenuItemStatusFilter, WP_MenuItemTarget, WP_MenuItemTaxRelation, WP_MenuItemTitle, WP_MenuItemTitleInput, WP_MenuItemType, WP_MenuItemUpdateErrorCode, WP_MenuItemUpdateInput, WP_MenuLinks, WP_MenuListErrorCode, WP_MenuListInput, WP_MenuOrderBy, WP_MenuRetrieveErrorCode, WP_MenuRetrieveInput, WP_MenuUpdateErrorCode, WP_MenuUpdateInput, WP_Post, WP_PostCommentStatus, WP_PostContent, WP_PostContentInput, WP_PostCreateErrorCode, WP_PostCreateInput, WP_PostDeleteErrorCode, WP_PostDeleteInput, WP_PostDeleteResponse, WP_PostExcerpt, WP_PostExcerptInput, WP_PostFormat, WP_PostGuid, WP_PostLinks, WP_PostListErrorCode, WP_PostListInput, WP_PostOrderBy, WP_PostRetrieveErrorCode, WP_PostRetrieveInput, WP_PostStatus, WP_PostStatusFilter, WP_PostTaxRelation, WP_PostTitle, WP_PostTitleInput, WP_PostUpdateErrorCode, WP_PostUpdateInput, WP_RequestInput, WP_Result, WP_User, WP_UserAvatarUrls, WP_UserCapabilities, WP_UserCreateErrorCode, WP_UserCreateInput, WP_UserDeleteErrorCode, WP_UserDeleteInput, WP_UserDeleteMeErrorCode, WP_UserDeleteMeInput, WP_UserDeleteMeResponse, WP_UserDeleteResponse, WP_UserLinks, WP_UserListErrorCode, WP_UserListInput, WP_UserOrderBy, WP_UserRetrieveErrorCode, WP_UserRetrieveInput, WP_UserRetrieveMeErrorCode, WP_UserRetrieveMeInput, WP_UserUpdateErrorCode, WP_UserUpdateInput, WP_UserUpdateMeErrorCode, WP_UserUpdateMeInput, WP_UserWho, WebhookOptions, WithCommonErrorMap, WordPressCredentials, WordPressService, altcha, arkose, authMock, buildProcedure, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createExtension, createGeoAdapter, createKizlo, createKizloClient, createLoggerAdapter, createMiddleware, createOrpcRouter, createProcedure, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, noopAdapter, parseIdentifier, recaptcha, resolveKizloConfig, restoreContract, schemaType, serializeCurrencyFormat, toKizloError, turnstile };
+export { AnyContext, AnyEventSchema, AnyEvents, AnyExtension, AnyKizloConfig, AnyMiddleware, AnyNestedClient, AnyProcedure, AnyProcedureRouter, AuthAdapter, AuthGetUser, AuthUser, AuthUserFn, AuthorsSettings, AuthorsSettingsInput, BaseHandlerOptions, BrandSettings, BrandSettingsInput, CART_HASH_HEADER_KEY, COMMON_ERRORS, CONTENT_TYPES, CaptchaAdapter, CommentService, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, ConnInfo, ConnInfoFn, ConsoleLogAdapterOptions, ContentType, Context, ContextConfig, Contract, ContractProcedure, CookiesAdapter, CookiesDeleteAll, CookiesGetAll, CookiesSetAll, CrawlingSettings, CrawlingSettingsInput, CreateKizloOptions, CreateSitemapRouteOptions, CurrencyFormat, DefinedErrorMapLike, DevPluginSource, Environment, ErrorDefinition, EventHandler, EventHandlerFn, Extension, ExtensionInitFn, ExtensionInitOptions, ExtensionInitResult, ExtractExtensionRouter, ExtractMiddlewareContextOutput, ExtractParams, ExtractProcedureByScope, Fixture, FixtureCleanupFn, FixtureSeedFn, GeoAdapter, GeoGetConnInfo, HTTPMethod, IconDescriptor, Identifier, IdentifierInput, IdentitySettings, IdentitySettingsInput, InferEventUnion, InferExtensionRouter, InferUses, InvocationScope, JsonValue, Kizlo, KizloClient, KizloClientConfig, KizloConfig, KizloError, KizloErrorOptions, KizloTarget, LIST_ORDER, List, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, LocalPlugin, LogLevel, LogPayload, Logger, LoggerAdapter, ManifestIcon, MaybeOptionalOptions, Media, MenuItemService, MenuService, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, OpenapiPart, OrganizationFounder, OrganizationSettings, OrganizationSettingsInput, PersonSettings, PersonSettingsInput, PluginSource, PostService, PostStatusDefinition, PostTypeSettings, PostTypeSettingsInput, PreviewTokenData, PreviewTokenPayload, Procedure, ProcedureContext, ProcedureErrors, ProcedureHandler, ProcedureOptions, RedirectInput, RedirectStatus, ResolveParamsPart, ResolvedIcons, ResolvedSchemaInput, ResolvedSchemaOutput, Robots, RobotsRule, RootRouter, RouterDepthTuple, S2SClient, SAFE_REQUEST_TIMEOUT, SITEMAP_BASE, SITEMAP_INDEX_SLUG, SchemaIO, SeedContext, Seo, SeoHead, SeoSchema, ServerContext, Service, ServiceAdapters, ServiceConfig, Settings, SettingsService, ShaAlgorithm, SiteSettings, SiteSettingsInput, Sitemap, SitemapIndex, type SitemapIndexEntry, SitemapList, SitemapRouteExtra, SitemapUrl, SitemapUrlImage, SitemapUrlList, SocialProfile, TaxonomySettings, TaxonomySettingsInput, TestAdminUser, TestCredentials, TestUser, ThrowableErrorFn, ThrowableErrorMap, UNEXPECTED_BODY_SNIPPET_LENGTH, UserService, VerifyCaptchaFn, VerifyPreviewTokenFn, WC_CORE_BASE, WC_STORE_BASE, WEB_MANIFEST_ROUTE, WPK_ListSitemapUrlInput, WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapContentType, WPK_SitemapIndex, WPK_SitemapUrl, WPK_SitemapUrlImage, WP_AUTH_HEADER_KEY, WP_AUTH_TYPE, WP_CORE_BASE, WP_Comment, WP_CommentAvatarUrls, WP_CommentContent, WP_CommentContentInput, WP_CommentCreateErrorCode, WP_CommentCreateInput, WP_CommentDeleteErrorCode, WP_CommentDeleteInput, WP_CommentDeleteResponse, WP_CommentLinks, WP_CommentListErrorCode, WP_CommentListInput, WP_CommentOrderBy, WP_CommentRetrieveErrorCode, WP_CommentRetrieveInput, WP_CommentStatus, WP_CommentStatusFilter, WP_CommentStatusInput, WP_CommentType, WP_CommentUpdateErrorCode, WP_CommentUpdateInput, WP_CommonErrorCode, WP_Context, WP_CurrencyFormat, WP_Error, WP_ErrorData, WP_KIZLO_BASE, WP_Link, WP_List, WP_ListMetadata, WP_ListOrder, WP_Menu, WP_MenuCreateErrorCode, WP_MenuCreateInput, WP_MenuDeleteErrorCode, WP_MenuDeleteInput, WP_MenuDeleteResponse, WP_MenuItem, WP_MenuItemCreateErrorCode, WP_MenuItemCreateInput, WP_MenuItemDeleteErrorCode, WP_MenuItemDeleteInput, WP_MenuItemDeleteResponse, WP_MenuItemLinks, WP_MenuItemListErrorCode, WP_MenuItemListInput, WP_MenuItemOrderBy, WP_MenuItemRetrieveErrorCode, WP_MenuItemRetrieveInput, WP_MenuItemStatus, WP_MenuItemStatusFilter, WP_MenuItemTarget, WP_MenuItemTaxRelation, WP_MenuItemTitle, WP_MenuItemTitleInput, WP_MenuItemType, WP_MenuItemUpdateErrorCode, WP_MenuItemUpdateInput, WP_MenuLinks, WP_MenuListErrorCode, WP_MenuListInput, WP_MenuOrderBy, WP_MenuRetrieveErrorCode, WP_MenuRetrieveInput, WP_MenuUpdateErrorCode, WP_MenuUpdateInput, WP_Post, WP_PostCommentStatus, WP_PostContent, WP_PostContentInput, WP_PostCreateErrorCode, WP_PostCreateInput, WP_PostDeleteErrorCode, WP_PostDeleteInput, WP_PostDeleteResponse, WP_PostExcerpt, WP_PostExcerptInput, WP_PostFormat, WP_PostGuid, WP_PostLinks, WP_PostListErrorCode, WP_PostListInput, WP_PostOrderBy, WP_PostRetrieveErrorCode, WP_PostRetrieveInput, WP_PostStatus, WP_PostStatusFilter, WP_PostTaxRelation, WP_PostTitle, WP_PostTitleInput, WP_PostUpdateErrorCode, WP_PostUpdateInput, WP_RequestInput, WP_Result, WP_User, WP_UserAvatarUrls, WP_UserCapabilities, WP_UserCreateErrorCode, WP_UserCreateInput, WP_UserDeleteErrorCode, WP_UserDeleteInput, WP_UserDeleteMeErrorCode, WP_UserDeleteMeInput, WP_UserDeleteMeResponse, WP_UserDeleteResponse, WP_UserLinks, WP_UserListErrorCode, WP_UserListInput, WP_UserOrderBy, WP_UserRetrieveErrorCode, WP_UserRetrieveInput, WP_UserRetrieveMeErrorCode, WP_UserRetrieveMeInput, WP_UserUpdateErrorCode, WP_UserUpdateInput, WP_UserUpdateMeErrorCode, WP_UserUpdateMeInput, WP_UserWho, WebManifest, WebhookOptions, WebhookSettings, WebhookSettingsInput, WithCommonErrorMap, WordPressCredentials, WordPressService, altcha, arkose, authMock, buildProcedure, buildWebManifest, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createExtension, createGeoAdapter, createKizlo, createKizloClient, createLoggerAdapter, createManifestRoute, createMiddleware, createOrpcRouter, createProcedure, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, noopAdapter, parseIdentifier, recaptcha, resolveIcons, resolveKizloConfig, restoreContract, schemaType, serializeCurrencyFormat, toKizloError, turnstile };

package/dist/index.js

@@ -5,6 +5,8 @@ import { createCookiesAdapter } from "./adapters/cookies.js";
 import { createGeoAdapter, geoMock } from "./adapters/geo.js";
 import { geoVercelNext } from "./adapters/geo.vercel.js";
 import { consoleLog, createLoggerAdapter, noopAdapter } from "./adapters/logger.js";
+import { resolveIcons } from "./brand/icons.js";
+import { WEB_MANIFEST_ROUTE, buildWebManifest, createManifestRoute } from "./brand/manifest.js";
 import { defineFixture, isLocalPlugin } from "./cli/wp/types.js";
 import { COMMON_ERRORS, KizloError, createThrowableErrorMap, defineErrorMap, isKizloError, toKizloError } from "./shared/error.js";
 import { buildProcedure, combineDetailed, createProcedure, handleUnexpectedError, schemaType } from "./shared/procedure.js";
@@ -21,7 +23,7 @@ import { PostService } from "./wordpress/post/service.js";
 import { UserService } from "./wordpress/user/service.js";
 import { isWordPressResourceError } from "./wordpress/utils.js";
 import { WordPressService } from "./wordpress/service.js";
-import { KizloSettingsService } from "./settings/service.js";
+import { SettingsService } from "./settings/service.js";
 import { Service } from "./service.js";
 import { Context } from "./context.js";
 import { deserializeCurrencyFormat, deserializeListMetadata, emptyList, serializeCurrencyFormat } from "./shared/serialize.js";
@@ -33,4 +35,4 @@ import { SITEMAP_BASE, SITEMAP_INDEX_SLUG, createSitemapRoute } from "./seo/site
 import { createExtension } from "./shared/extension.js";
 import { createMiddleware } from "./shared/middleware.js";
 
-export { CART_HASH_HEADER_KEY, COMMON_ERRORS, CONTENT_TYPES, CommentService, ContentType, Context, CurrencyFormat, IdentifierInput, Kizlo, KizloClient, KizloError, KizloSettingsService, LIST_ORDER, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, Media, MenuItemService, MenuService, PostService, PreviewTokenData, PreviewTokenPayload, Robots, RobotsRule, SAFE_REQUEST_TIMEOUT, SITEMAP_BASE, SITEMAP_INDEX_SLUG, Seo, SeoHead, SeoSchema, Service, Sitemap, SitemapIndex, SitemapList, SitemapUrl, SitemapUrlImage, SitemapUrlList, UNEXPECTED_BODY_SNIPPET_LENGTH, UserService, WC_CORE_BASE, WC_STORE_BASE, WP_AUTH_HEADER_KEY, WP_AUTH_TYPE, WP_CORE_BASE, WP_Error, WP_KIZLO_BASE, WordPressService, altcha, arkose, authMock, buildProcedure, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createExtension, createGeoAdapter, createKizlo, createKizloClient, createLoggerAdapter, createMiddleware, createOrpcRouter, createProcedure, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, noopAdapter, parseIdentifier, recaptcha, resolveKizloConfig, restoreContract, schemaType, serializeCurrencyFormat, toKizloError, turnstile };
+export { CART_HASH_HEADER_KEY, COMMON_ERRORS, CONTENT_TYPES, CommentService, ContentType, Context, CurrencyFormat, IdentifierInput, Kizlo, KizloClient, KizloError, LIST_ORDER, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, Media, MenuItemService, MenuService, PostService, PreviewTokenData, PreviewTokenPayload, Robots, RobotsRule, SAFE_REQUEST_TIMEOUT, SITEMAP_BASE, SITEMAP_INDEX_SLUG, Seo, SeoHead, SeoSchema, Service, SettingsService, Sitemap, SitemapIndex, SitemapList, SitemapUrl, SitemapUrlImage, SitemapUrlList, UNEXPECTED_BODY_SNIPPET_LENGTH, UserService, WC_CORE_BASE, WC_STORE_BASE, WEB_MANIFEST_ROUTE, WP_AUTH_HEADER_KEY, WP_AUTH_TYPE, WP_CORE_BASE, WP_Error, WP_KIZLO_BASE, WordPressService, altcha, arkose, authMock, buildProcedure, buildWebManifest, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createExtension, createGeoAdapter, createKizlo, createKizloClient, createLoggerAdapter, createManifestRoute, createMiddleware, createOrpcRouter, createProcedure, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, noopAdapter, parseIdentifier, recaptcha, resolveIcons, resolveKizloConfig, restoreContract, schemaType, serializeCurrencyFormat, toKizloError, turnstile };

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

@@ -0,0 +1,8 @@
+import { S2SClient } from "../../kizlo.js";
+import { WEB_MANIFEST_ROUTE } from "../../brand/manifest.js";
+
+//#region src/integrations/nextjs/manifest.d.ts
+declare const MANIFEST_CACHE_TAG = "kizlo:manifest";
+declare function createManifestRoute(client: S2SClient<[]>): (request: Request) => Promise<Response>;
+//#endregion
+export { MANIFEST_CACHE_TAG, createManifestRoute };

package/dist/integrations/nextjs/manifest.js

@@ -0,0 +1,18 @@
+import { WEB_MANIFEST_ROUTE, createManifestRoute } from "../../brand/manifest.js";
+
+//#region src/integrations/nextjs/manifest.ts
+const MANIFEST_CACHE_TAG = "kizlo:manifest";
+function createManifestRoute$1(client) {
+	const handler = createManifestRoute(client);
+	let getBody;
+	return async function GET(request) {
+		if (!getBody) {
+			const { unstable_cache } = await import("next/cache");
+			getBody = unstable_cache(async () => (await handler(request)).text(), [MANIFEST_CACHE_TAG], { tags: [MANIFEST_CACHE_TAG] });
+		}
+		return new Response(await getBody(), { headers: { "Content-Type": "application/manifest+json" } });
+	};
+}
+
+//#endregion
+export { MANIFEST_CACHE_TAG, createManifestRoute$1 as createManifestRoute };

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

@@ -0,0 +1,17 @@
+import { SeoHead } from "../../seo/schema.js";
+import { S2SClient } from "../../kizlo.js";
+import { Metadata, Viewport } from "next";
+
+//#region src/integrations/nextjs/metadata.d.ts
+declare function createRootMetadata(client: S2SClient<[]>): () => Promise<Metadata>;
+/**
+ * Root `generateViewport` for `app/layout.tsx`. Emits `<meta name="theme-color">`
+ * from the brand theme color so the mobile browser chrome (address bar/toolbar)
+ * is tinted for regular visitors — distinct from the manifest `theme_color`,
+ * which only applies once the site is installed as an app. When a dark variant
+ * is set, both are emitted with `prefers-color-scheme` media queries.
+ */
+declare function createRootViewport(client: S2SClient<[]>): () => Promise<Viewport>;
+declare function createPageMetadata(head: SeoHead): Metadata;
+//#endregion
+export { createPageMetadata, createRootMetadata, createRootViewport };

package/dist/integrations/nextjs/metadata.js

@@ -0,0 +1,90 @@
+import { resolveIcons } from "../../brand/icons.js";
+import { WEB_MANIFEST_ROUTE } from "../../brand/manifest.js";
+
+//#region src/integrations/nextjs/metadata.ts
+function createRootMetadata(client) {
+	return async function generateMetadata() {
+		const settings = await client.settings.get.call();
+		const { icon, appleTouch } = resolveIcons(settings.brand);
+		const metadata = {
+			manifest: WEB_MANIFEST_ROUTE,
+			icons: {
+				icon: icon.map(toNextIcon),
+				apple: appleTouch.map(toNextIcon)
+			}
+		};
+		if (settings.site.url) metadata.metadataBase = new URL(settings.site.url);
+		return metadata;
+	};
+}
+/**
+* Root `generateViewport` for `app/layout.tsx`. Emits `<meta name="theme-color">`
+* from the brand theme color so the mobile browser chrome (address bar/toolbar)
+* is tinted for regular visitors — distinct from the manifest `theme_color`,
+* which only applies once the site is installed as an app. When a dark variant
+* is set, both are emitted with `prefers-color-scheme` media queries.
+*/
+function createRootViewport(client) {
+	return async function generateViewport() {
+		const { brand } = await client.settings.get.call();
+		const light = brand.theme_color;
+		const dark = 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 themeColor.length ? { themeColor } : {};
+	};
+}
+function toNextIcon(icon) {
+	return {
+		url: icon.url,
+		type: icon.type,
+		sizes: icon.sizes,
+		media: icon.media
+	};
+}
+function createPageMetadata(head) {
+	return {
+		title: { absolute: head.title },
+		description: head.og.description || void 0,
+		alternates: { canonical: head.canonical },
+		robots: [
+			head.robots.index,
+			head.robots.follow,
+			head.robots.maxSnippet,
+			head.robots.maxImagePreview,
+			head.robots.maxVideoPreview
+		].join(", "),
+		openGraph: {
+			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,
+			images: head.og.image ? [{
+				url: head.og.image.url,
+				width: head.og.image.width,
+				height: head.og.image.height,
+				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,
+			images: head.twitter.image ? [head.twitter.image] : void 0
+		}
+	};
+}
+
+//#endregion
+export { createPageMetadata, createRootMetadata, createRootViewport };

package/dist/kizlo.d.ts

@@ -5,10 +5,10 @@ import { CaptchaAdapter } from "./adapters/captcha.js";
 import { CookiesAdapter } from "./shared/types.js";
 import { GeoAdapter } from "./adapters/geo.js";
 import { Environment, LoggerAdapter } from "./adapters/logger.js";
+import { Context } from "./context.js";
 import { RouterMap } from "./router.js";
 import { AnyExtension, InferExtensionRouter } from "./shared/extension.js";
 import { ResultClient } from "./shared/result.js";
-import { Context } from "./context.js";
 
 //#region src/kizlo.d.ts
 type AnyKizloConfig = KizloConfig<any>;

package/dist/nextjs/server.d.ts

@@ -1,4 +1,7 @@
+import { WEB_MANIFEST_ROUTE } from "../brand/manifest.js";
+import { createRootMetadata, createRootViewport } from "../integrations/nextjs/metadata.js";
 import { KizloServerOptions, createKizlo } from "../integrations/nextjs/kizlo.server.js";
+import { MANIFEST_CACHE_TAG, createManifestRoute } from "../integrations/nextjs/manifest.js";
 import { createRobotsRoute } from "../integrations/nextjs/robots.js";
 import { SITEMAP_CACHE_TAG, SITEMAP_ROUTE, createSitemapRoute } from "../integrations/nextjs/sitemap.js";
-export { KizloServerOptions, SITEMAP_CACHE_TAG, SITEMAP_ROUTE, createKizlo, createRobotsRoute, createSitemapRoute };
+export { KizloServerOptions, MANIFEST_CACHE_TAG, SITEMAP_CACHE_TAG, SITEMAP_ROUTE, WEB_MANIFEST_ROUTE, createKizlo, createManifestRoute, createRobotsRoute, createRootMetadata, createRootViewport, createSitemapRoute };

package/dist/nextjs/server.js

@@ -1,5 +1,8 @@
+import { WEB_MANIFEST_ROUTE } from "../brand/manifest.js";
+import { createRootMetadata, createRootViewport } from "../integrations/nextjs/metadata.js";
 import { createRobotsRoute } from "../integrations/nextjs/robots.js";
 import { SITEMAP_CACHE_TAG, SITEMAP_ROUTE, createSitemapRoute } from "../integrations/nextjs/sitemap.js";
 import { createKizlo } from "../integrations/nextjs/kizlo.server.js";
+import { MANIFEST_CACHE_TAG, createManifestRoute } from "../integrations/nextjs/manifest.js";
 
-export { SITEMAP_CACHE_TAG, SITEMAP_ROUTE, createKizlo, createRobotsRoute, createSitemapRoute };
+export { MANIFEST_CACHE_TAG, SITEMAP_CACHE_TAG, SITEMAP_ROUTE, WEB_MANIFEST_ROUTE, createKizlo, createManifestRoute, createRobotsRoute, createRootMetadata, createRootViewport, createSitemapRoute };

package/dist/nextjs.d.ts

@@ -1,3 +1,3 @@
 import { KizloClientOptions, createKizloClient } from "./integrations/nextjs/kizlo.client.js";
-import { toMetadata } from "./integrations/nextjs/seo.js";
-export { KizloClientOptions, createKizloClient, toMetadata };
+import { createPageMetadata } from "./integrations/nextjs/metadata.js";
+export { KizloClientOptions, createKizloClient, createPageMetadata };

package/dist/nextjs.js

@@ -1,4 +1,4 @@
 import { createKizloClient } from "./integrations/nextjs/kizlo.client.js";
-import { toMetadata } from "./integrations/nextjs/seo.js";
+import { createPageMetadata } from "./integrations/nextjs/metadata.js";
 
-export { createKizloClient, toMetadata };
+export { createKizloClient, createPageMetadata };

package/dist/package.js

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