kizlo 0.15.2 → 0.16.0

package/dist/config.d.ts

@@ -28,16 +28,16 @@ interface KizloDevConfig {
    * Host port the local WordPress MySQL is published on (default 3307), bound to `127.0.0.1` so
    * you can point a SQL client (TablePlus, DBeaver, `mysql`) at the database to
    * inspect or edit tables directly. Connect with db `wordpress`, user `wordpress`,
-   * password `wppass`. Pick a port that's free — change it if you run multiple projects
+   * password `wppass`. Pick a port that's free; change it if you run multiple projects
    * or already have MySQL on the default.
    */
   dbPort?: number;
   /**
-   * Code-defined seed data for a **fresh** local WordPress — the same {@link Fixture}s the
+   * Code-defined seed data for a **fresh** local WordPress. These are the same {@link Fixture}s the
    * test environment uses, so you can populate your local site from versioned code instead of a
-   * blank install. Each fixture also declares the plugins it needs — wp.org slugs / zip
+   * blank install. Each fixture also declares the plugins it needs as wp.org slugs or zip
    * sources to install, or `{ path }` local directories bind-mounted live so your edits
-   * show up without a reinstall — which `kizlo dev` ensures every run. Each fixture's
+   * show up without a reinstall, which `kizlo dev` ensures every run. Each fixture's
    * `seed` runs once over REST (and may drop to wp-cli) on the first `kizlo dev` and
    * after `kizlo dev reset`; an existing install is left alone.
    */
@@ -65,7 +65,7 @@ interface KizloTestConfig {
    * takes effect on the next `kizlo test reset` and Kizlo says so when the two disagree.
    */
   version?: string;
-  /** Extension fixtures to install + seed. */
+  /** Integration fixtures to install + seed. */
   fixtures?: Fixture[];
   /**
    * Package manager used to launch the test script (default: auto-detected from
@@ -74,14 +74,14 @@ interface KizloTestConfig {
   packageManager?: "npm" | "pnpm" | "yarn" | "bun";
   /**
    * Override the test command entirely. Default: `<packageManager> test` (the
-   * project's own `test` script — never hardcoded to vitest).
+   * project's own `test` script, never hardcoded to Vitest).
    */
   command?: string;
 }
 interface KizloGlobalConfig {
   /**
    * Kizlo's home directory. Kizlo owns the layout inside it: your server
-   * (`server/`, whose `index.ts` exports `router` plus your extensions), the
+   * (`server/`, whose `index.ts` exports `procedures` plus your integrations), the
    * browser `client.ts`, and the generated contract.
    * @default 'src/lib/kizlo' (or 'lib/kizlo' without a src dir)
    */
@@ -111,7 +111,7 @@ interface KizloGlobalConfig {
   worktrees?: boolean;
   /**
    * Directory to write the WordPress client into, as `<wordpressClientDir>/wordpress.ts`. For a package or
-   * workspace that ships procedures but no Kizlo server: there is no router to build a contract from,
+   * workspace that ships procedures but no Kizlo server: there is no procedure tree to build a contract from,
    * yet those procedures still call the generated tree, so they need the client on its own.
    *
    * Independent of `dir`. An app leaves this unset and gets its client inside `dir` alongside the

package/dist/context.d.ts

@@ -5,11 +5,11 @@ import { AuthUser } from "./adapters/auth.js";
 import { PreviewTokenPayload } from "./shared/schema.js";
 import { ConnInfo } from "./adapters/geo.js";
 import { Logger } from "./adapters/logger.js";
+import { ServiceAdapters } from "./adapters/types.js";
 import { CookiesStorage } from "./cookie.js";
 import { EmailService } from "./email/service.js";
 import { SettingsService } from "./settings/service.js";
-import { ServiceAdapters } from "./kizlo.js";
-import { ExtensionPluginRequirement } from "@kizlo/shared";
+import { IntegrationPluginRequirement } from "@kizlo/shared";
 
 //#region src/context.d.ts
 interface ContextConfig {
@@ -17,15 +17,15 @@ interface ContextConfig {
   adapters?: ServiceAdapters;
   credentials: WordPressCredentials;
   wordpressEndpoints?: object;
-  /** WordPress plugins the registered extensions need, checked against what each response reports. */
-  extensionPlugins?: ExtensionPluginRequirement[];
+  /** WordPress plugins the registered integrations need, checked against what each response reports. */
+  integrationPlugins?: IntegrationPluginRequirement[];
 }
 type AuthUserFn = () => Promise<AuthUser | null>;
 type ConnInfoFn = () => Promise<ConnInfo | null>;
 type VerifyCaptchaFn = (token: string) => Promise<boolean>;
 type VerifyPreviewTokenFn = (token: string) => Promise<PreviewTokenPayload | null>;
 /**
- * The context every procedure, middleware, event, and webhook handler receives — the fixed base
+ * The context every procedure, middleware, event, and webhook handler receives. The fixed base
  * the server builds. A procedure's handler receives this base plus whatever its middleware injected
  * via `next({ context })`.
  */

package/dist/context.js

@@ -6,7 +6,7 @@ import { EmailService } from "./email/service.js";
 import { SettingsService } from "./settings/service.js";
 import { createWordPressClient } from "./wordpress/endpoint.js";
 import { WordPressTransport } from "./wordpress/transport.js";
-import { EXTENSION_VERSIONS_HEADER, PLUGIN_VERSION_HEADER, base64Decode, extensionUpdateMessage, isPluginVersionSupported, parseExtensionVersions, pluginUpdateMessage, satisfiesVersion, tryCatchSync } from "@kizlo/shared";
+import { INTEGRATION_VERSIONS_HEADER, PLUGIN_VERSION_HEADER, base64Decode, integrationUpdateMessage, isPluginVersionSupported, parseIntegrationVersions, pluginUpdateMessage, satisfiesVersion, tryCatchSync } from "@kizlo/shared";
 import { parseCookie, stringifySetCookie } from "cookie";
 
 //#region src/context.ts
@@ -75,12 +75,12 @@ var Context = class {
 			return;
 		}
 		if (!isPluginVersionSupported(installed)) this.warn(pluginUpdateMessage(installed));
-		const plugins = this.config.extensionPlugins;
+		const plugins = this.config.integrationPlugins;
 		if (!plugins?.length) return;
-		const active = parseExtensionVersions(result.headers.get(EXTENSION_VERSIONS_HEADER));
+		const active = parseIntegrationVersions(result.headers.get(INTEGRATION_VERSIONS_HEADER));
 		for (const plugin of plugins) {
-			if (satisfiesVersion(active[plugin.slug], plugin.version)) continue;
-			this.warn(extensionUpdateMessage(plugin, active[plugin.slug]));
+			if (satisfiesVersion(active[plugin.name], plugin.version)) continue;
+			this.warn(integrationUpdateMessage(plugin, active[plugin.name]));
 		}
 	}
 	/** Bold yellow, boxed in dashes so it stands out in a busy dev console. */

package/dist/index.d.ts

@@ -12,19 +12,20 @@ import { AnyContext, AnyNestedClient, CookiesAdapter, CookiesDeleteAll, CookiesG
 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 { ConsoleLogAdapterOptions, LogLevel, LogPayload, Logger, LoggerAdapter, consoleLog, createLoggerAdapter, noopAdapter } from "./adapters/logger.js";
+import { ServiceAdapters, mergeServiceAdapters } from "./adapters/types.js";
 import { AuthorsSettings, AuthorsSettingsInput, BrandSettings, BrandSettingsInput, CrawlingSettings, CrawlingSettingsInput, HeadlessSettings, HeadlessSettingsInput, IdentitySettings, IdentitySettingsInput, OrganizationFounder, OrganizationSettings, OrganizationSettingsInput, PersonSettings, PersonSettingsInput, PostStatusDefinition, PostTypeSettings, PostTypeSettingsInput, Settings, SiteSettings, SiteSettingsInput, SocialProfile, TaxonomySettings, TaxonomySettingsInput, UploadsSettings, UploadsSettingsInput, WebhookSettings, WebhookSettingsInput } from "./settings/service.interface.js";
 import { IconDescriptor, ManifestIcon, ResolvedIcons, resolveIcons } from "./brand/icons.js";
 import { CookiesStorage } from "./cookie.js";
 import { SettingsService } from "./settings/service.js";
 import { AuthUserFn, ConnInfoFn, Context, ContextConfig, ProcedureContext, VerifyCaptchaFn, VerifyPreviewTokenFn } from "./context.js";
-import { ROUTER_MAP, RouterMap } from "./router.js";
+import { CORE_PROCEDURES, CoreProcedures } from "./procedures.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, InferMiddlewares, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, createMiddleware } from "./shared/middleware.js";
-import { AnyProcedure, AnyProcedureRouter, BaseHandlerOptions, ExtractParams, ExtractProcedureByScope, InvocationScope, OpenapiPart, Procedure, ProcedureErrors, ProcedureHandler, ProcedureOptions, ResolveParamsPart, ResolvedSchemaInput, ResolvedSchemaOutput, RouterDepthTuple, SchemaIO, buildProcedure, combineDetailed, createProcedure, handleUnexpectedError, schemaType } from "./shared/procedure.js";
-import { AnyExtension, Extension, ExtensionInitFn, ExtensionInitOptions, ExtensionInitResult, ExtensionRequirements, ExtractExtensionRouter, InferExtensionRouter, assertExtensionEndpoints, createExtension, missingEndpoints } from "./shared/extension.js";
-import { AnyKizloConfig, CreateKizloOptions, EnvReader, Kizlo, KizloConfig, KizloConnect, RootRouter, S2SClient, ServiceAdapters, createKizlo, resolveKizloConfig, resolveWordPressConnection } from "./kizlo.js";
+import { AnyProcedure, AnyProcedureTree, BaseHandlerOptions, ExtractParams, ExtractProcedureByScope, InvocationScope, OpenapiPart, Procedure, ProcedureErrors, ProcedureHandler, ProcedureOptions, ProcedureTreeDepthTuple, ResolveParamsPart, ResolvedSchemaInput, ResolvedSchemaOutput, SchemaIO, buildProcedure, combineDetailed, createProcedure, handleUnexpectedError, schemaType } from "./shared/procedure.js";
+import { AnyIntegration, EnvReader, EnvRecord, EnvSource, ExtractIntegrationProcedures, InferIntegrationProcedures, Integration, IntegrationRequirements, KizloEnv, WordPressEnv, assertIntegrationEndpoints, assertIntegrationEnv, createIntegration, missingEndpoints, missingEnv, readEnv } from "./shared/integration.js";
+import { AnyKizloConfig, CreateKizloOptions, Kizlo, KizloConfig, RootProcedures, S2SClient, createKizlo, integrationEnv, resolveKizloConfig, resolveWordPressConnection } 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";
@@ -37,4 +38,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 { ActiveWordPressClient, AnyContext, AnyEventSchema, AnyEvents, AnyExtension, AnyKizloConfig, AnyMiddleware, AnyNestedClient, AnyProcedure, AnyProcedureRouter, AuthAdapter, AuthGetUser, AuthUser, AuthUserFn, AuthorsSettings, AuthorsSettingsInput, BaseHandlerOptions, BrandSettings, BrandSettingsInput, COMMON_ERRORS, CONTENT_TYPES, CaptchaAdapter, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, ConnInfo, ConnInfoFn, ConsoleLogAdapterOptions, ContentType, Context, ContextConfig, Contract, ContractProcedure, CookiesAdapter, CookiesDeleteAll, CookiesGetAll, CookiesSetAll, CookiesStorage, CrawlingSettings, CrawlingSettingsInput, CreateKizloOptions, CreateSitemapRouteOptions, CurrencyFormat, DefinedErrorMapLike, DevPluginSource, EnvReader, Environment, ErrorDefinition, EventHandler, EventHandlerFn, Extension, ExtensionInitFn, ExtensionInitOptions, ExtensionInitResult, ExtensionRequirements, ExtractExtensionRouter, ExtractMiddlewareContextOutput, ExtractParams, ExtractProcedureByScope, Fixture, FixtureCleanupFn, FixtureSeedFn, FixtureSettleFn, GeoAdapter, GeoGetConnInfo, HTTPMethod, HeadlessSettings, HeadlessSettingsInput, IconDescriptor, Identifier, IdentifierInput, IdentitySettings, IdentitySettingsInput, InferEventUnion, InferExtensionRouter, InferMiddlewares, InvocationScope, JsonValue, Kizlo, KizloClient, KizloClientConfig, KizloConfig, KizloConnect, KizloError, KizloErrorOptions, LIST_ORDER, List, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, LocalPlugin, LogLevel, LogPayload, Logger, LoggerAdapter, ManifestIcon, MaybeOptionalOptions, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, OpenapiPart, OrganizationFounder, OrganizationSettings, OrganizationSettingsInput, PersonSettings, PersonSettingsInput, PluginSource, PostStatusDefinition, PostTypeSettings, PostTypeSettingsInput, PreviewTokenData, PreviewTokenPayload, Procedure, ProcedureContext, ProcedureErrors, ProcedureHandler, ProcedureOptions, ROUTER_MAP, RedirectInput, RedirectStatus, ResolveParamsPart, ResolvedIcons, ResolvedSchemaInput, ResolvedSchemaOutput, Robots, RobotsRule, RootRouter, RouterDepthTuple, RouterMap, S2SClient, SITEMAP_BASE, SITEMAP_INDEX_SLUG, SchemaIO, SeedContext, Seo, SeoHead, SeoSchema, ServiceAdapters, Settings, SettingsService, SettleContext, ShaAlgorithm, SiteSettings, SiteSettingsInput, Sitemap, SitemapIndex, SitemapIndexEntry, SitemapList, SitemapRouteExtra, SitemapUrl, SitemapUrlImage, SitemapUrlList, SocialProfile, TaxonomySettings, TaxonomySettingsInput, TestAdminUser, TestCredentials, TestUser, ThrowableErrorFn, ThrowableErrorMap, UploadsSettings, UploadsSettingsInput, VerifyCaptchaFn, VerifyPreviewTokenFn, WEB_MANIFEST_ROUTE, WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapUrl, WPK_SitemapUrlImage, WP_CallOptions, WP_Client, WP_CommonErrorCode, WP_CurrencyFormat, WP_Endpoint, WP_EndpointData, WP_EndpointDefinition, WP_EndpointInput, WP_EndpointResult, WP_Error, WP_ErrorData, WP_Failure, WP_List, WP_ListMetadata, WP_RequestBuild, WP_RequestContentType, WP_RequestInput, WP_RequestMethod, WP_ResponseContentType, WP_Result, WP_Success, WP_TransportFailure, WP_TypedHeaders, WebManifest, WebhookOptions, WebhookSettings, WebhookSettingsInput, WithCommonErrorMap, WordPressClientRegistry, WordPressCredentials, WordPressTransport, WordPressTransportOptions, WordPressTransportResult, altcha, arkose, assertExtensionEndpoints, authMock, buildProcedure, buildWebManifest, buildWordPressRequest, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createExtension, createGeoAdapter, createKizlo, createKizloClient, createLoggerAdapter, createManifestRoute, createMiddleware, createOrpcRouter, createProcedure, createSitemapRedirectRoute, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, createWordPressClient, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, deserializeSeo, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, missingEndpoints, noopAdapter, parseIdentifier, parseSitemapSlug, recaptcha, renderJsonLd, renderSitemapIndex, renderUrlSet, resolveIcons, resolveKizloConfig, resolveWordPressConnection, restoreContract, schemaType, serializeCurrencyFormat, sitemapEntryPath, toKizloError, turnstile, wpEndpoint, xmlResponse };
+export { ActiveWordPressClient, AnyContext, AnyEventSchema, AnyEvents, AnyIntegration, AnyKizloConfig, AnyMiddleware, AnyNestedClient, AnyProcedure, AnyProcedureTree, AuthAdapter, AuthGetUser, AuthUser, AuthUserFn, AuthorsSettings, AuthorsSettingsInput, BaseHandlerOptions, BrandSettings, BrandSettingsInput, COMMON_ERRORS, CONTENT_TYPES, CORE_PROCEDURES, CaptchaAdapter, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, ConnInfo, ConnInfoFn, ConsoleLogAdapterOptions, ContentType, Context, ContextConfig, Contract, ContractProcedure, CookiesAdapter, CookiesDeleteAll, CookiesGetAll, CookiesSetAll, CookiesStorage, CoreProcedures, CrawlingSettings, CrawlingSettingsInput, CreateKizloOptions, CreateSitemapRouteOptions, CurrencyFormat, DefinedErrorMapLike, DevPluginSource, EnvReader, EnvRecord, EnvSource, ErrorDefinition, EventHandler, EventHandlerFn, ExtractIntegrationProcedures, ExtractMiddlewareContextOutput, ExtractParams, ExtractProcedureByScope, Fixture, FixtureCleanupFn, FixtureSeedFn, FixtureSettleFn, GeoAdapter, GeoGetConnInfo, HTTPMethod, HeadlessSettings, HeadlessSettingsInput, IconDescriptor, Identifier, IdentifierInput, IdentitySettings, IdentitySettingsInput, InferEventUnion, InferIntegrationProcedures, InferMiddlewares, Integration, IntegrationRequirements, InvocationScope, JsonValue, Kizlo, KizloClient, KizloClientConfig, KizloConfig, KizloEnv, KizloError, KizloErrorOptions, LIST_ORDER, List, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, LocalPlugin, LogLevel, LogPayload, Logger, LoggerAdapter, ManifestIcon, MaybeOptionalOptions, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, OpenapiPart, OrganizationFounder, OrganizationSettings, OrganizationSettingsInput, PersonSettings, PersonSettingsInput, PluginSource, PostStatusDefinition, PostTypeSettings, PostTypeSettingsInput, PreviewTokenData, PreviewTokenPayload, Procedure, ProcedureContext, ProcedureErrors, ProcedureHandler, ProcedureOptions, ProcedureTreeDepthTuple, RedirectInput, RedirectStatus, ResolveParamsPart, ResolvedIcons, ResolvedSchemaInput, ResolvedSchemaOutput, Robots, RobotsRule, RootProcedures, S2SClient, SITEMAP_BASE, SITEMAP_INDEX_SLUG, SchemaIO, SeedContext, Seo, SeoHead, SeoSchema, ServiceAdapters, Settings, SettingsService, SettleContext, ShaAlgorithm, SiteSettings, SiteSettingsInput, Sitemap, SitemapIndex, SitemapIndexEntry, SitemapList, SitemapRouteExtra, SitemapUrl, SitemapUrlImage, SitemapUrlList, SocialProfile, TaxonomySettings, TaxonomySettingsInput, TestAdminUser, TestCredentials, TestUser, ThrowableErrorFn, ThrowableErrorMap, UploadsSettings, UploadsSettingsInput, VerifyCaptchaFn, VerifyPreviewTokenFn, WEB_MANIFEST_ROUTE, WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapUrl, WPK_SitemapUrlImage, WP_CallOptions, WP_Client, WP_CommonErrorCode, WP_CurrencyFormat, WP_Endpoint, WP_EndpointData, WP_EndpointDefinition, WP_EndpointInput, WP_EndpointResult, WP_Error, WP_ErrorData, WP_Failure, WP_List, WP_ListMetadata, WP_RequestBuild, WP_RequestContentType, WP_RequestInput, WP_RequestMethod, WP_ResponseContentType, WP_Result, WP_Success, WP_TransportFailure, WP_TypedHeaders, WebManifest, WebhookOptions, WebhookSettings, WebhookSettingsInput, WithCommonErrorMap, WordPressClientRegistry, WordPressCredentials, WordPressEnv, WordPressTransport, WordPressTransportOptions, WordPressTransportResult, altcha, arkose, assertIntegrationEndpoints, assertIntegrationEnv, authMock, buildProcedure, buildWebManifest, buildWordPressRequest, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createGeoAdapter, createIntegration, createKizlo, createKizloClient, createLoggerAdapter, createManifestRoute, createMiddleware, createOrpcRouter, createProcedure, createSitemapRedirectRoute, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, createWordPressClient, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, deserializeSeo, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, integrationEnv, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, mergeServiceAdapters, missingEndpoints, missingEnv, noopAdapter, parseIdentifier, parseSitemapSlug, readEnv, recaptcha, renderJsonLd, renderSitemapIndex, renderUrlSet, resolveIcons, resolveKizloConfig, resolveWordPressConnection, restoreContract, schemaType, serializeCurrencyFormat, sitemapEntryPath, toKizloError, turnstile, wpEndpoint, xmlResponse };

package/dist/index.js

@@ -5,6 +5,7 @@ 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 { mergeServiceAdapters } from "./adapters/types.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";
@@ -25,11 +26,11 @@ import { parseIdentifier } from "./shared/identifier.js";
 import { deserializeCurrencyFormat, deserializeListMetadata, emptyList, serializeCurrencyFormat } from "./shared/serialize.js";
 import { CONTENT_TYPES, ContentType, ListSitemapUrlInput, ListSitemapUrlInputBase, Robots, RobotsRule, Seo, SeoHead, SeoSchema, Sitemap, SitemapIndex, SitemapList, SitemapUrl, SitemapUrlImage, SitemapUrlList } from "./seo/schema.js";
 import { deserializeSeo, parseSitemapSlug, renderJsonLd, renderSitemapIndex, renderUrlSet, sitemapEntryPath, xmlResponse } from "./seo/utils.js";
-import { ROUTER_MAP } from "./router.js";
-import { assertExtensionEndpoints, createExtension, missingEndpoints } from "./shared/extension.js";
+import { CORE_PROCEDURES } from "./procedures.js";
+import { assertIntegrationEndpoints, assertIntegrationEnv, createIntegration, missingEndpoints, missingEnv, readEnv } from "./shared/integration.js";
 import { createEventHandler, createWebhookRouter } from "./webhook/index.js";
-import { Kizlo, createKizlo, resolveKizloConfig, resolveWordPressConnection } from "./kizlo.js";
+import { Kizlo, createKizlo, integrationEnv, resolveKizloConfig, resolveWordPressConnection } from "./kizlo.js";
 import { SITEMAP_BASE, SITEMAP_INDEX_SLUG, createSitemapRedirectRoute, createSitemapRoute } from "./seo/sitemap.js";
 import { createMiddleware } from "./shared/middleware.js";
 
-export { COMMON_ERRORS, CONTENT_TYPES, ContentType, Context, CookiesStorage, CurrencyFormat, IdentifierInput, Kizlo, KizloClient, KizloError, LIST_ORDER, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, PreviewTokenData, PreviewTokenPayload, ROUTER_MAP, Robots, RobotsRule, SITEMAP_BASE, SITEMAP_INDEX_SLUG, Seo, SeoHead, SeoSchema, SettingsService, Sitemap, SitemapIndex, SitemapList, SitemapUrl, SitemapUrlImage, SitemapUrlList, WEB_MANIFEST_ROUTE, WP_Error, WordPressTransport, altcha, arkose, assertExtensionEndpoints, authMock, buildProcedure, buildWebManifest, buildWordPressRequest, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createExtension, createGeoAdapter, createKizlo, createKizloClient, createLoggerAdapter, createManifestRoute, createMiddleware, createOrpcRouter, createProcedure, createSitemapRedirectRoute, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, createWordPressClient, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, deserializeSeo, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, missingEndpoints, noopAdapter, parseIdentifier, parseSitemapSlug, recaptcha, renderJsonLd, renderSitemapIndex, renderUrlSet, resolveIcons, resolveKizloConfig, resolveWordPressConnection, restoreContract, schemaType, serializeCurrencyFormat, sitemapEntryPath, toKizloError, turnstile, wpEndpoint, xmlResponse };
+export { COMMON_ERRORS, CONTENT_TYPES, CORE_PROCEDURES, ContentType, Context, CookiesStorage, CurrencyFormat, IdentifierInput, Kizlo, KizloClient, KizloError, LIST_ORDER, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, PreviewTokenData, PreviewTokenPayload, Robots, RobotsRule, SITEMAP_BASE, SITEMAP_INDEX_SLUG, Seo, SeoHead, SeoSchema, SettingsService, Sitemap, SitemapIndex, SitemapList, SitemapUrl, SitemapUrlImage, SitemapUrlList, WEB_MANIFEST_ROUTE, WP_Error, WordPressTransport, altcha, arkose, assertIntegrationEndpoints, assertIntegrationEnv, authMock, buildProcedure, buildWebManifest, buildWordPressRequest, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createGeoAdapter, createIntegration, createKizlo, createKizloClient, createLoggerAdapter, createManifestRoute, createMiddleware, createOrpcRouter, createProcedure, createSitemapRedirectRoute, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, createWordPressClient, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, deserializeSeo, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, integrationEnv, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, mergeServiceAdapters, missingEndpoints, missingEnv, noopAdapter, parseIdentifier, parseSitemapSlug, readEnv, recaptcha, renderJsonLd, renderSitemapIndex, renderUrlSet, resolveIcons, resolveKizloConfig, resolveWordPressConnection, restoreContract, schemaType, serializeCurrencyFormat, sitemapEntryPath, toKizloError, turnstile, wpEndpoint, xmlResponse };

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

@@ -0,0 +1,12 @@
+import { EnvSource, Integration } from "../../shared/integration.js";
+import "../../index.js";
+
+//#region src/integrations/astro/integration.d.ts
+interface AstroOptions {
+  /** Astro's server environment reader, usually `getSecret` from `astro:env/server`. */
+  env: EnvSource;
+}
+/** Integrate Kizlo with Astro's server environment. */
+declare function astro(options: AstroOptions): Integration<"astro", Record<never, never>>;
+//#endregion
+export { AstroOptions, astro };

package/dist/integrations/astro/integration.js

@@ -0,0 +1,14 @@
+import { createIntegration } from "../../shared/integration.js";
+import { runtimeEnv } from "../runtime-env.js";
+
+//#region src/integrations/astro/integration.ts
+/** Integrate Kizlo with Astro's server environment. */
+function astro(options) {
+	return createIntegration({
+		id: "astro",
+		env: runtimeEnv(options.env, "PUBLIC_KIZLO_BASE_URL")
+	});
+}
+
+//#endregion
+export { astro };

package/dist/integrations/astro/kizlo.client.d.ts

@@ -1,15 +1,15 @@
-import { AnyProcedureRouter } from "../../shared/procedure.js";
+import { AnyProcedureTree } from "../../shared/procedure.js";
 import { KizloClient } from "../../client.js";
 
 //#region src/integrations/astro/kizlo.client.d.ts
 interface KizloClientOptions {
   /**
-   * Backend URL. In the browser, pass `import.meta.env.PUBLIC_KIZLO_API_URL` at the call site so Vite
+   * Backend URL. In the browser, pass `import.meta.env.PUBLIC_KIZLO_BASE_URL` at the call site so Vite
    * inlines it into the client bundle (see the template's `client.ts`); when omitted it falls back to
-   * `PUBLIC_KIZLO_API_URL` from `process.env`.
+   * `PUBLIC_KIZLO_BASE_URL` from `process.env`.
    */
   url?: string;
 }
-declare function createKizloClient<T extends AnyProcedureRouter>(contract: T, options?: KizloClientOptions): KizloClient<T>;
+declare function createKizloClient<T extends AnyProcedureTree>(contract: T, options?: KizloClientOptions): KizloClient<T>;
 //#endregion
 export { KizloClientOptions, createKizloClient };

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

@@ -1,6 +1,6 @@
 //#region src/integrations/astro/utils.d.ts
 /**
- * Minimal shape of Astro's `APIContext` this integration needs — just the standard web `Request`.
+ * 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 {
@@ -9,10 +9,9 @@ interface AstroRouteContext {
 /** 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.
+ * The public Kizlo API base URL, read from `process.env` as a last-resort fallback when this client
+ * factory runs on the server without an explicit `url`. Browser code passes
+ * `import.meta.env.PUBLIC_KIZLO_BASE_URL` at the call site so Vite can inline it.
  */
 declare function getServerBaseUrl(): string;
 //#endregion

package/dist/integrations/astro/utils.js

@@ -2,14 +2,13 @@ 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.
+* The public Kizlo API base URL, read from `process.env` as a last-resort fallback when this client
+* factory runs on the server without an explicit `url`. Browser code passes
+* `import.meta.env.PUBLIC_KIZLO_BASE_URL` at the call site so Vite can inline it.
 */
 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." });
+	const baseUrl = process.env.PUBLIC_KIZLO_BASE_URL?.trim();
+	if (!baseUrl) throw new KizloError("MISSING_ENV_VARIABLE", { message: "Please define PUBLIC_KIZLO_BASE_URL in your .env file." });
 	return baseUrl;
 }
 

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

@@ -0,0 +1,15 @@
+import { EnvSource, Integration } from "../../shared/integration.js";
+import "../../index.js";
+import { NextRevalidateOptions } from "./revalidate.js";
+
+//#region src/integrations/nextjs/integration.d.ts
+interface NextjsOptions {
+  /** Environment source. Defaults to `process.env`. */
+  env?: EnvSource;
+  /** Configure automatic cache revalidation, or disable it with `false`. */
+  revalidate?: boolean | NextRevalidateOptions;
+}
+/** Integrate Kizlo with the Next.js server runtime. */
+declare function nextjs(options?: NextjsOptions): Integration<"nextjs", Record<never, never>>;
+//#endregion
+export { NextjsOptions, nextjs };

package/dist/integrations/nextjs/integration.js

@@ -0,0 +1,18 @@
+import { createIntegration } from "../../shared/integration.js";
+import { runtimeEnv } from "../runtime-env.js";
+import { nextRevalidation } from "./revalidate.js";
+
+//#region src/integrations/nextjs/integration.ts
+/** Integrate Kizlo with the Next.js server runtime. */
+function nextjs(options = {}) {
+	const source = options.env ?? process.env;
+	const revalidation = options.revalidate;
+	return createIntegration({
+		id: "nextjs",
+		env: runtimeEnv(source, "NEXT_PUBLIC_KIZLO_BASE_URL"),
+		events: revalidation === false ? void 0 : nextRevalidation(typeof revalidation === "object" ? revalidation : void 0).events
+	});
+}
+
+//#endregion
+export { nextjs };

package/dist/integrations/nextjs/kizlo.client.d.ts

@@ -1,10 +1,10 @@
-import { AnyProcedureRouter } from "../../shared/procedure.js";
+import { AnyProcedureTree } from "../../shared/procedure.js";
 import { KizloClient } from "../../client.js";
 
 //#region src/integrations/nextjs/kizlo.client.d.ts
 interface KizloClientOptions {
   url?: string;
 }
-declare function createKizloClient<T extends AnyProcedureRouter>(contract: T, options?: KizloClientOptions): KizloClient<T>;
+declare function createKizloClient<T extends AnyProcedureTree>(contract: T, options?: KizloClientOptions): KizloClient<T>;
 //#endregion
 export { KizloClientOptions, createKizloClient };

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

@@ -1,6 +1,5 @@
 import { KizloEvent } from "../../webhook/schema.js";
-import { AnyProcedureRouter } from "../../shared/procedure.js";
-import { Extension } from "../../shared/extension.js";
+import { Integration } from "../../shared/integration.js";
 import "../../index.js";
 import { Pathname } from "@kizlo/shared";
 
@@ -26,6 +25,6 @@ interface NextRevalidateOptions {
    */
   sitemap?: false | RevalidateTarget | RevalidateTarget[];
 }
-declare function nextRevalidation(options?: NextRevalidateOptions): Extension<"nextjs-revalidation", AnyProcedureRouter>;
+declare function nextRevalidation(options?: NextRevalidateOptions): Integration<"nextjs-revalidation", Record<never, never>>;
 //#endregion
 export { NextRevalidateOptions, RevalidatePathFn, RevalidateTagFn, RevalidateTarget, nextRevalidation };

package/dist/integrations/nextjs/revalidate.js

@@ -1,4 +1,4 @@
-import { createExtension } from "../../shared/extension.js";
+import { createIntegration } from "../../shared/integration.js";
 import { POST_EVENT_TYPES, SETTINGS_EVENT_TYPES, TERM_EVENT_TYPES } from "../../webhook/schema.js";
 import { createEventHandler } from "../../webhook/index.js";
 import { ROBOTS_CACHE_TAG } from "./robots.js";
@@ -13,9 +13,9 @@ const CONTENT_EVENT_TYPES = new Set([...POST_EVENT_TYPES, ...TERM_EVENT_TYPES]);
 const NON_FRONTEND_SETTINGS_EVENT_TYPES = new Set(["settings.crawling.updated", "settings.integration.updated"]);
 const FRONTEND_SETTINGS_EVENT_TYPES = new Set(SETTINGS_EVENT_TYPES.filter((type) => !NON_FRONTEND_SETTINGS_EVENT_TYPES.has(type)));
 function nextRevalidation(options) {
-	return createExtension({
+	return createIntegration({
 		id: "nextjs-revalidation",
-		init: () => ({ events: [createEventHandler(async (event) => {
+		events: [createEventHandler(async (event) => {
 			if (!event) return;
 			const revalidatePath = options?.revalidatePath ?? (await import("next/cache")).revalidatePath;
 			const revalidateTag = options?.revalidateTag ?? (await import("next/cache")).revalidateTag;
@@ -32,7 +32,7 @@ function nextRevalidation(options) {
 				revalidateTag(SITEMAP_CACHE_TAG, { expire: 0 });
 				for (const target of resolveSitemapTargets(options?.sitemap)) revalidatePath(normalizePath(target.path), target.type);
 			}
-		})] })
+		})]
 	});
 }
 function resolveSitemapTargets(option) {

package/dist/integrations/nextjs/utils.js

@@ -42,8 +42,8 @@ function createCachedTextRoute(handler, cacheTag, contentType) {
 	};
 }
 function getServerBaseUrl() {
-	const baseUrl = process.env.NEXT_PUBLIC_KIZLO_API_URL;
-	if (!baseUrl) throw new KizloError("MISSING_ENV_VARIABLE", { message: "Please define NEXT_PUBLIC_KIZLO_API_URL in your .env file." });
+	const baseUrl = process.env.NEXT_PUBLIC_KIZLO_BASE_URL;
+	if (!baseUrl) throw new KizloError("MISSING_ENV_VARIABLE", { message: "Please define NEXT_PUBLIC_KIZLO_BASE_URL in your .env file." });
 	return baseUrl;
 }
 

package/dist/integrations/node/integration.d.ts

@@ -0,0 +1,12 @@
+import { EnvSource, Integration } from "../../shared/integration.js";
+import "../../index.js";
+
+//#region src/integrations/node/integration.d.ts
+interface NodeOptions {
+  /** Node environment source. Defaults to `process.env`. */
+  env?: EnvSource;
+}
+/** Integrate Kizlo with the Node.js runtime environment. */
+declare function node(options?: NodeOptions): Integration<"node", Record<never, never>>;
+//#endregion
+export { NodeOptions, node };

package/dist/integrations/node/integration.js

@@ -0,0 +1,14 @@
+import { createIntegration } from "../../shared/integration.js";
+import { runtimeEnv } from "../runtime-env.js";
+
+//#region src/integrations/node/integration.ts
+/** Integrate Kizlo with the Node.js runtime environment. */
+function node(options = {}) {
+	return createIntegration({
+		id: "node",
+		env: runtimeEnv(options.env ?? process.env, "KIZLO_BASE_URL")
+	});
+}
+
+//#endregion
+export { node };

package/dist/integrations/runtime-env.js

@@ -0,0 +1,25 @@
+import { readEnv } from "../shared/integration.js";
+
+//#region src/integrations/runtime-env.ts
+/** Map a runtime's environment names onto the values Kizlo consumes. */
+function runtimeEnv(source, baseUrlKey) {
+	return {
+		baseUrl: readEnv(source, baseUrlKey),
+		mode: readEnv(source, "KIZLO_MODE"),
+		remote: {
+			siteSecret: readEnv(source, "KIZLO_WP_SECRET"),
+			wordpressUrl: readEnv(source, "KIZLO_WP_URL"),
+			wordpressUsername: readEnv(source, "KIZLO_WP_USERNAME"),
+			wordpressPassword: readEnv(source, "KIZLO_WP_APP_PASSWORD")
+		},
+		local: {
+			siteSecret: readEnv(source, "KIZLO_LOCAL_WP_SECRET"),
+			wordpressUrl: readEnv(source, "KIZLO_LOCAL_WP_URL"),
+			wordpressUsername: readEnv(source, "KIZLO_LOCAL_WP_USERNAME"),
+			wordpressPassword: readEnv(source, "KIZLO_LOCAL_WP_APP_PASSWORD")
+		}
+	};
+}
+
+//#endregion
+export { runtimeEnv };

package/dist/integrations/tanstack-start/api.d.ts

@@ -1,7 +1,7 @@
 import { ServerRoute } from "./utils.js";
 
 //#region src/integrations/tanstack-start/api.d.ts
-/** The Kizlo request handler a server entry exports (`createKizlo().handler`): a web `Request` in, `Response` out. */
+/** The Kizlo request handler a server entry exports (`createKizlo(...).handler`): a web `Request` in, `Response` out. */
 type KizloHandler = (request: Request) => Promise<Response> | Response;
 /** Every HTTP method TanStack Start registers per server route, each mapped to the same handler. */
 type ApiHandlers = Record<"GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD", ServerRoute>;

package/dist/integrations/tanstack-start/integration.d.ts

@@ -0,0 +1,12 @@
+import { EnvSource, Integration } from "../../shared/integration.js";
+import "../../index.js";
+
+//#region src/integrations/tanstack-start/integration.d.ts
+interface TanstackStartOptions {
+  /** Environment source. Defaults to `process.env`. */
+  env?: EnvSource;
+}
+/** Integrate Kizlo with the TanStack Start server runtime. */
+declare function tanstackStart(options?: TanstackStartOptions): Integration<"tanstack-start", Record<never, never>>;
+//#endregion
+export { TanstackStartOptions, tanstackStart };

package/dist/integrations/tanstack-start/integration.js

@@ -0,0 +1,14 @@
+import { createIntegration } from "../../shared/integration.js";
+import { runtimeEnv } from "../runtime-env.js";
+
+//#region src/integrations/tanstack-start/integration.ts
+/** Integrate Kizlo with the TanStack Start server runtime. */
+function tanstackStart(options = {}) {
+	return createIntegration({
+		id: "tanstack-start",
+		env: runtimeEnv(options.env ?? process.env, "VITE_KIZLO_BASE_URL")
+	});
+}
+
+//#endregion
+export { tanstackStart };

package/dist/integrations/tanstack-start/kizlo.client.d.ts

@@ -1,12 +1,12 @@
-import { AnyProcedureRouter } from "../../shared/procedure.js";
+import { AnyProcedureTree } from "../../shared/procedure.js";
 import { KizloClient } from "../../client.js";
 
 //#region src/integrations/tanstack-start/kizlo.client.d.ts
 interface KizloClientOptions {
   /**
-   * Backend URL. Pass `import.meta.env.VITE_KIZLO_API_URL` at the call site (see the template's
+   * Backend URL. Pass `import.meta.env.VITE_KIZLO_BASE_URL` at the call site (see the template's
    * `client.ts`) so Vite inlines it into the browser bundle; when omitted it falls back to
-   * `VITE_KIZLO_API_URL` from `process.env`.
+   * `VITE_KIZLO_BASE_URL` from `process.env`.
    */
   url?: string;
 }
@@ -15,6 +15,6 @@ interface KizloClientOptions {
  * over HTTP, so it runs the same in the browser and during SSR. Server routes and server functions use
  * the server-to-server client from {@link createKizlo} instead.
  */
-declare function createKizloClient<T extends AnyProcedureRouter>(contract: T, options?: KizloClientOptions): KizloClient<T>;
+declare function createKizloClient<T extends AnyProcedureTree>(contract: T, options?: KizloClientOptions): KizloClient<T>;
 //#endregion
 export { KizloClientOptions, createKizloClient };

package/dist/integrations/tanstack-start/utils.d.ts

@@ -11,7 +11,7 @@ interface ServerRouteContext {
 type ServerRoute = (context: ServerRouteContext) => 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`. Client-side code passes `import.meta.env.VITE_KIZLO_API_URL` at the call
+ * without an explicit `url`. Client-side code passes `import.meta.env.VITE_KIZLO_BASE_URL` at the call
  * site (see the template's `client.ts`) so Vite inlines it into the browser bundle; this fallback only
  * matters when neither is supplied.
  */

package/dist/integrations/tanstack-start/utils.js

@@ -3,13 +3,13 @@ import { KizloError } from "../../shared/error.js";
 //#region src/integrations/tanstack-start/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`. Client-side code passes `import.meta.env.VITE_KIZLO_API_URL` at the call
+* without an explicit `url`. Client-side code passes `import.meta.env.VITE_KIZLO_BASE_URL` at the call
 * site (see the template's `client.ts`) so Vite inlines it into the browser bundle; this fallback only
 * matters when neither is supplied.
 */
 function getServerBaseUrl() {
-	const baseUrl = process.env.VITE_KIZLO_API_URL?.trim();
-	if (!baseUrl) throw new KizloError("MISSING_ENV_VARIABLE", { message: "Please define VITE_KIZLO_API_URL in your .env file." });
+	const baseUrl = process.env.VITE_KIZLO_BASE_URL?.trim();
+	if (!baseUrl) throw new KizloError("MISSING_ENV_VARIABLE", { message: "Please define VITE_KIZLO_BASE_URL in your .env file." });
 	return baseUrl;
 }