kizlo 0.15.2 → 0.17.0

package/dist/{router.d.ts → procedures.d.ts}

@@ -4,8 +4,8 @@ import { Procedure } from "./shared/procedure.js";
 import "./index.js";
 import * as _kizlo_shared0 from "@kizlo/shared";
 
-//#region src/router.d.ts
-declare const ROUTER_MAP: {
+//#region src/procedures.d.ts
+declare const CORE_PROCEDURES: {
   posts: {
     get: Procedure<"api", {
       params: {
@@ -33,27 +33,14 @@ declare const ROUTER_MAP: {
         id: number;
         name: string;
         slug: string;
-        avatar: {
-          id: number;
-          name: string;
-          alt: string;
-          src: string;
-          mime?: string | undefined;
-          width?: number | undefined;
-          height?: number | undefined;
-          variants?: {
-            src: string;
-            width: number;
-            height: number;
-          }[] | undefined;
-          srcset?: string | undefined;
-        } | null;
+        avatarUrl: string | null;
       } | null;
       featuredMedia: {
         id: number;
         name: string;
-        alt: string;
         src: string;
+        type: "image";
+        alt: string;
         mime?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
@@ -125,6 +112,7 @@ declare const ROUTER_MAP: {
           }[];
         };
       } | null;
+      custom: never;
       createdAt: number;
       updatedAt: number;
       meta: {
@@ -179,7 +167,7 @@ declare const ROUTER_MAP: {
         include?: string | number | (string | number)[] | undefined;
         offset?: string | number | undefined;
         order?: "asc" | "desc" | undefined;
-        orderby?: "id" | "date" | "slug" | "parent" | "title" | "author" | "include" | "modified" | "relevance" | "include_slugs" | undefined;
+        orderby?: "date" | "id" | "slug" | "parent" | "title" | "author" | "include" | "modified" | "relevance" | "include_slugs" | undefined;
         searchColumns?: ("post_title" | "post_content" | "post_excerpt")[] | undefined;
         slug?: string | string[] | undefined;
         taxRelation?: "AND" | "OR" | undefined;
@@ -208,27 +196,14 @@ declare const ROUTER_MAP: {
           id: number;
           name: string;
           slug: string;
-          avatar: {
-            id: number;
-            name: string;
-            alt: string;
-            src: string;
-            mime?: string | undefined;
-            width?: number | undefined;
-            height?: number | undefined;
-            variants?: {
-              src: string;
-              width: number;
-              height: number;
-            }[] | undefined;
-            srcset?: string | undefined;
-          } | null;
+          avatarUrl: string | null;
         } | null;
         featuredMedia: {
           id: number;
           name: string;
-          alt: string;
           src: string;
+          type: "image";
+          alt: string;
           mime?: string | undefined;
           width?: number | undefined;
           height?: number | undefined;
@@ -300,6 +275,7 @@ declare const ROUTER_MAP: {
             }[];
           };
         } | null;
+        custom: never;
         createdAt: number;
         updatedAt: number;
         meta: {
@@ -375,27 +351,14 @@ declare const ROUTER_MAP: {
         id: number;
         name: string;
         slug: string;
-        avatar: {
-          id: number;
-          name: string;
-          alt: string;
-          src: string;
-          mime?: string | undefined;
-          width?: number | undefined;
-          height?: number | undefined;
-          variants?: {
-            src: string;
-            width: number;
-            height: number;
-          }[] | undefined;
-          srcset?: string | undefined;
-        } | null;
+        avatarUrl: string | null;
       } | null;
       featuredMedia: {
         id: number;
         name: string;
-        alt: string;
         src: string;
+        type: "image";
+        alt: string;
         mime?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
@@ -457,6 +420,7 @@ declare const ROUTER_MAP: {
           }[];
         };
       } | null;
+      custom: never;
       createdAt: number;
       updatedAt: number;
       meta: {
@@ -511,7 +475,7 @@ declare const ROUTER_MAP: {
         include?: string | number | (string | number)[] | undefined;
         offset?: string | number | undefined;
         order?: "asc" | "desc" | undefined;
-        orderby?: "id" | "date" | "slug" | "parent" | "title" | "author" | "include" | "modified" | "relevance" | "include_slugs" | "menu_order" | undefined;
+        orderby?: "date" | "id" | "slug" | "parent" | "title" | "author" | "include" | "modified" | "relevance" | "include_slugs" | "menu_order" | undefined;
         searchColumns?: ("post_title" | "post_content" | "post_excerpt")[] | undefined;
         slug?: string | string[] | undefined;
         parent?: string | number | (string | number)[] | undefined;
@@ -537,27 +501,14 @@ declare const ROUTER_MAP: {
           id: number;
           name: string;
           slug: string;
-          avatar: {
-            id: number;
-            name: string;
-            alt: string;
-            src: string;
-            mime?: string | undefined;
-            width?: number | undefined;
-            height?: number | undefined;
-            variants?: {
-              src: string;
-              width: number;
-              height: number;
-            }[] | undefined;
-            srcset?: string | undefined;
-          } | null;
+          avatarUrl: string | null;
         } | null;
         featuredMedia: {
           id: number;
           name: string;
-          alt: string;
           src: string;
+          type: "image";
+          alt: string;
           mime?: string | undefined;
           width?: number | undefined;
           height?: number | undefined;
@@ -619,6 +570,7 @@ declare const ROUTER_MAP: {
             }[];
           };
         } | null;
+        custom: never;
         createdAt: number;
         updatedAt: number;
         meta: {
@@ -731,6 +683,7 @@ declare const ROUTER_MAP: {
           }[];
         };
       } | null;
+      custom: never;
       meta: {
         [x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/any | {
           [x: string]: string | number | boolean | /*elided*/any | /*elided*/any | null;
@@ -772,7 +725,7 @@ declare const ROUTER_MAP: {
         exclude?: string | number | (string | number)[] | undefined;
         include?: string | number | (string | number)[] | undefined;
         order?: "asc" | "desc" | undefined;
-        orderBy?: "id" | "count" | "slug" | "name" | "description" | "include" | "include_slugs" | "term_group" | undefined;
+        orderBy?: "id" | "slug" | "name" | "description" | "include" | "include_slugs" | "term_group" | "count" | undefined;
         hideEmpty?: string | boolean | undefined;
         parent?: string | number | undefined;
         post?: string | number | undefined;
@@ -838,6 +791,7 @@ declare const ROUTER_MAP: {
             }[];
           };
         } | null;
+        custom: never;
         meta: {
           [x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/any | {
             [x: string]: string | number | boolean | /*elided*/any | /*elided*/any | null;
@@ -947,6 +901,7 @@ declare const ROUTER_MAP: {
           }[];
         };
       } | null;
+      custom: never;
       meta: {
         [x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/any | {
           [x: string]: string | number | boolean | /*elided*/any | /*elided*/any | null;
@@ -988,7 +943,7 @@ declare const ROUTER_MAP: {
         exclude?: string | number | (string | number)[] | undefined;
         include?: string | number | (string | number)[] | undefined;
         order?: "asc" | "desc" | undefined;
-        orderBy?: "id" | "count" | "slug" | "name" | "description" | "include" | "include_slugs" | "term_group" | undefined;
+        orderBy?: "id" | "slug" | "name" | "description" | "include" | "include_slugs" | "term_group" | "count" | undefined;
         hideEmpty?: string | boolean | undefined;
         post?: string | number | undefined;
         slug?: string | string[] | undefined;
@@ -1052,6 +1007,7 @@ declare const ROUTER_MAP: {
             }[];
           };
         } | null;
+        custom: never;
         meta: {
           [x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/any | {
             [x: string]: string | number | boolean | /*elided*/any | /*elided*/any | null;
@@ -1151,7 +1107,7 @@ declare const ROUTER_MAP: {
     sitemaps: {
       list: Procedure<"internal", {}, {
         key: string;
-        type: "post_type" | "taxonomy" | "author";
+        type: "author" | "post_type" | "taxonomy";
         pages: number;
         lastmod: string;
       }[], DefinedErrorMapLike>;
@@ -1159,7 +1115,7 @@ declare const ROUTER_MAP: {
         origin: string;
         sitemaps: {
           key: string;
-          type: "post_type" | "taxonomy" | "author";
+          type: "author" | "post_type" | "taxonomy";
           pages: number;
           lastmod: string;
         }[];
@@ -1202,7 +1158,7 @@ declare const ROUTER_MAP: {
           include?: string | number | (string | number)[] | undefined;
           offset?: string | number | undefined;
           order?: "asc" | "desc" | undefined;
-          orderby?: "id" | "date" | "slug" | "parent" | "title" | "author" | "include" | "relevance" | "include_slugs" | "menu_order" | undefined;
+          orderby?: "date" | "id" | "slug" | "parent" | "title" | "author" | "include" | "relevance" | "include_slugs" | "menu_order" | undefined;
           searchColumns?: ("post_title" | "post_content" | "post_excerpt")[] | undefined;
           slug?: string | string[] | undefined;
           taxRelation?: "AND" | "OR" | undefined;
@@ -1281,7 +1237,7 @@ declare const ROUTER_MAP: {
           include?: string | number | (string | number)[] | undefined;
           offset?: string | number | undefined;
           order?: "asc" | "desc" | undefined;
-          orderby?: "id" | "date" | "slug" | "parent" | "title" | "author" | "include" | "relevance" | "include_slugs" | "menu_order" | undefined;
+          orderby?: "date" | "id" | "slug" | "parent" | "title" | "author" | "include" | "relevance" | "include_slugs" | "menu_order" | undefined;
           searchColumns?: ("post_title" | "post_content" | "post_excerpt")[] | undefined;
           slug?: string | string[] | undefined;
           taxRelation?: "AND" | "OR" | undefined;
@@ -1367,21 +1323,7 @@ declare const ROUTER_MAP: {
       author: {
         id: number;
         name: string;
-        avatar: {
-          id: number;
-          name: string;
-          alt: string;
-          src: string;
-          mime?: string | undefined;
-          width?: number | undefined;
-          height?: number | undefined;
-          variants?: {
-            src: string;
-            width: number;
-            height: number;
-          }[] | undefined;
-          srcset?: string | undefined;
-        } | null;
+        avatarUrl: string | null;
       } | null;
       content: string;
       post: {
@@ -1391,8 +1333,9 @@ declare const ROUTER_MAP: {
         image: {
           id: number;
           name: string;
-          alt: string;
           src: string;
+          type: "image";
+          alt: string;
           mime?: string | undefined;
           width?: number | undefined;
           height?: number | undefined;
@@ -1430,7 +1373,7 @@ declare const ROUTER_MAP: {
         include?: string | number | (string | number)[] | undefined;
         offset?: string | number | undefined;
         order?: "asc" | "desc" | undefined;
-        orderby?: "id" | "date" | "parent" | "post" | "include" | undefined;
+        orderby?: "date" | "id" | "parent" | "post" | "include" | undefined;
         parent?: string | number | (string | number)[] | undefined;
         parentExclude?: string | number | (string | number)[] | undefined;
         post?: string | number | (string | number)[] | undefined;
@@ -1443,21 +1386,7 @@ declare const ROUTER_MAP: {
         author: {
           id: number;
           name: string;
-          avatar: {
-            id: number;
-            name: string;
-            alt: string;
-            src: string;
-            mime?: string | undefined;
-            width?: number | undefined;
-            height?: number | undefined;
-            variants?: {
-              src: string;
-              width: number;
-              height: number;
-            }[] | undefined;
-            srcset?: string | undefined;
-          } | null;
+          avatarUrl: string | null;
         } | null;
         content: string;
         post: {
@@ -1467,8 +1396,9 @@ declare const ROUTER_MAP: {
           image: {
             id: number;
             name: string;
-            alt: string;
             src: string;
+            type: "image";
+            alt: string;
             mime?: string | undefined;
             width?: number | undefined;
             height?: number | undefined;
@@ -1519,21 +1449,7 @@ declare const ROUTER_MAP: {
       author: {
         id: number;
         name: string;
-        avatar: {
-          id: number;
-          name: string;
-          alt: string;
-          src: string;
-          mime?: string | undefined;
-          width?: number | undefined;
-          height?: number | undefined;
-          variants?: {
-            src: string;
-            width: number;
-            height: number;
-          }[] | undefined;
-          srcset?: string | undefined;
-        } | null;
+        avatarUrl: string | null;
       } | null;
       content: string;
       post: {
@@ -1543,8 +1459,9 @@ declare const ROUTER_MAP: {
         image: {
           id: number;
           name: string;
-          alt: string;
           src: string;
+          type: "image";
+          alt: string;
           mime?: string | undefined;
           width?: number | undefined;
           height?: number | undefined;
@@ -1690,6 +1607,6 @@ declare const ROUTER_MAP: {
     };
   };
 };
-type RouterMap = typeof ROUTER_MAP;
+type CoreProcedures = typeof CORE_PROCEDURES;
 //#endregion
-export { ROUTER_MAP, RouterMap };
+export { CORE_PROCEDURES, CoreProcedures };

package/dist/procedures.js

@@ -0,0 +1,23 @@
+import { CATEGORY_PROCEDURES } from "./category/index.js";
+import { COMMENT_PROCEDURES } from "./comment/index.js";
+import { MENU_PROCEDURES } from "./menu/index.js";
+import { PAGE_PROCEDURES } from "./page/index.js";
+import { POST_PROCEDURES } from "./post/index.js";
+import { SEO_PROCEDURES } from "./seo/index.js";
+import { SETTINGS_PROCEDURES } from "./settings/index.js";
+import { TAG_PROCEDURES } from "./tag/index.js";
+
+//#region src/procedures.ts
+const CORE_PROCEDURES = {
+	posts: POST_PROCEDURES,
+	pages: PAGE_PROCEDURES,
+	categories: CATEGORY_PROCEDURES,
+	tags: TAG_PROCEDURES,
+	seo: SEO_PROCEDURES,
+	menus: MENU_PROCEDURES,
+	comments: COMMENT_PROCEDURES,
+	settings: SETTINGS_PROCEDURES
+};
+
+//#endregion
+export { CORE_PROCEDURES };

package/dist/seo/index.js

@@ -23,7 +23,7 @@ function deserializeSitemapUrls(urls) {
 		}))
 	}));
 }
-const SEO_ROUTER_MAP = {
+const SEO_PROCEDURES = {
 	homepage: createProcedure({
 		scope: "internal",
 		output: Seo
@@ -111,4 +111,4 @@ const SEO_ROUTER_MAP = {
 };
 
 //#endregion
-export { SEO_ROUTER_MAP };
+export { SEO_PROCEDURES };

package/dist/seo/schema.d.ts

@@ -108,17 +108,17 @@ declare const Seo: z.ZodObject<{
 type Seo = z.infer<typeof Seo>;
 declare const CONTENT_TYPES: readonly ["post_type", "taxonomy", "author"];
 declare const ContentType: z.ZodEnum<{
+  author: "author";
   post_type: "post_type";
   taxonomy: "taxonomy";
-  author: "author";
 }>;
 type ContentType = z.infer<typeof ContentType>;
 declare const Sitemap: z.ZodObject<{
   key: z.ZodString;
   type: z.ZodEnum<{
+    author: "author";
     post_type: "post_type";
     taxonomy: "taxonomy";
-    author: "author";
   }>;
   pages: z.ZodNumber;
   lastmod: z.ZodString;
@@ -127,9 +127,9 @@ type Sitemap = z.infer<typeof Sitemap>;
 declare const SitemapList: z.ZodArray<z.ZodObject<{
   key: z.ZodString;
   type: z.ZodEnum<{
+    author: "author";
     post_type: "post_type";
     taxonomy: "taxonomy";
-    author: "author";
   }>;
   pages: z.ZodNumber;
   lastmod: z.ZodString;
@@ -140,9 +140,9 @@ declare const SitemapIndex: z.ZodObject<{
   sitemaps: z.ZodArray<z.ZodObject<{
     key: z.ZodString;
     type: z.ZodEnum<{
+      author: "author";
       post_type: "post_type";
       taxonomy: "taxonomy";
-      author: "author";
     }>;
     pages: z.ZodNumber;
     lastmod: z.ZodString;
@@ -174,9 +174,9 @@ declare const SitemapUrlList: z.ZodArray<z.ZodObject<{
 type SitemapUrlList = z.infer<typeof SitemapUrlList>;
 declare const ListSitemapUrlInputBase: z.ZodObject<{
   type: z.ZodEnum<{
+    author: "author";
     post_type: "post_type";
     taxonomy: "taxonomy";
-    author: "author";
   }>;
   page: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodCoercedNumber<string | number>>>;
 }, z.core.$strip>;

package/dist/settings/index.js

@@ -12,7 +12,7 @@ function resolveUpdate(response, context, errors, label) {
 	}
 	return response.data;
 }
-const SETTINGS_ROUTER_MAP = {
+const SETTINGS_PROCEDURES = {
 	get: createProcedure({
 		scope: "internal",
 		output: schemaType()
@@ -73,4 +73,4 @@ const SETTINGS_ROUTER_MAP = {
 };
 
 //#endregion
-export { SETTINGS_ROUTER_MAP };
+export { SETTINGS_PROCEDURES };

package/dist/shared/constants.js

@@ -5,14 +5,6 @@ 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 { CONTRACT_GENERATION_ENV, RPC_PROTOCOL_HEADER };
+export { RPC_PROTOCOL_HEADER };

package/dist/shared/contract-generation.js

@@ -0,0 +1,14 @@
+//#region src/shared/contract-generation.ts
+const CONTRACT_GENERATION = Symbol.for("kizlo.contract-generation");
+function state() {
+	return globalThis;
+}
+function isContractGeneration() {
+	return state()[CONTRACT_GENERATION] === true;
+}
+function setContractGeneration(value) {
+	state()[CONTRACT_GENERATION] = value;
+}
+
+//#endregion
+export { isContractGeneration, setContractGeneration };

package/dist/shared/contract.d.ts

@@ -1,5 +1,5 @@
 import { HTTPMethod } from "./types.js";
-import { AnyProcedureRouter, InvocationScope } from "./procedure.js";
+import { AnyProcedureTree, InvocationScope } from "./procedure.js";
 import { AnyContractRouter } from "@orpc/contract";
 import { Pathname } from "@kizlo/shared";
 
@@ -15,7 +15,7 @@ type ContractProcedure = {
   };
 };
 declare function isContractProcedure$1(node: unknown): node is ContractProcedure;
-declare function generateContract<TRouter extends AnyProcedureRouter>(router: TRouter): Promise<Contract>;
+declare function generateContract<TProcedures extends AnyProcedureTree>(procedures: TProcedures): Promise<Contract>;
 declare function restoreContract(contract: Contract): AnyContractRouter;
 //#endregion
 export { Contract, ContractProcedure, generateContract, isContractProcedure$1 as isContractProcedure, restoreContract };

package/dist/shared/contract.js

@@ -6,8 +6,8 @@ function isContractProcedure$1(node) {
 	if (!node || typeof node !== "object") return false;
 	return "route" in node || "meta" in node;
 }
-async function generateContract(router) {
-	const contract = minifyContractRouter(createOrpcRouter(router));
+async function generateContract(procedures) {
+	const contract = minifyContractRouter(createOrpcRouter(procedures));
 	const walk = (node) => {
 		const out = {};
 		for (const [key, value] of Object.entries(node)) if (isContractProcedure(value)) {

package/dist/shared/integration.d.ts

@@ -0,0 +1,91 @@
+import { ServiceAdapters } from "../adapters/types.js";
+import { EventHandler } from "../webhook/index.js";
+import { AnyProcedureTree } from "./procedure.js";
+import { IntegrationPluginRequirement, UnionToIntersection } from "@kizlo/shared";
+
+//#region src/shared/integration.d.ts
+
+/**
+ * What an integration needs to work at all.
+ *
+ * An integration can ship in two halves that update separately: this package, and the WordPress plugin
+ * that serves the endpoints it calls. Environment values and endpoints are checked when the server starts.
+ * Plugin versions are checked from the headers WordPress returns.
+ */
+interface IntegrationRequirements {
+  /** WordPress plugins serving this integration's endpoints, checked against what the site reports. */
+  plugins?: IntegrationPluginRequirement[];
+  /** Resolved environment values this integration needs, checked after every integration's `env` contribution is composed. */
+  env?: readonly string[];
+  /**
+   * Endpoint subtrees this integration calls, dotted from the root of the generated tree, e.g.
+   * `"woocommerce.store.cart"`. Naming the subtree rather than every leaf keeps this a statement about
+   * which contract has to be present, not a second copy of the call sites.
+   */
+  endpoints?: string[];
+}
+/** Reads a scalar environment value by name. */
+type EnvReader = (name: string) => string | undefined;
+/** A nested environment record. Leaf values are strings supplied by the owning runtime. */
+interface EnvRecord {
+  readonly [name: string]: string | EnvRecord | undefined;
+}
+/** One WordPress connection profile contributed by a runtime integration. */
+interface WordPressEnv extends EnvRecord {
+  readonly siteSecret?: string;
+  readonly wordpressUrl?: string;
+  readonly wordpressUsername?: string;
+  readonly wordpressPassword?: string;
+}
+/**
+ * Runtime-neutral values Kizlo consumes. Runtime integrations map their environment system onto
+ * these camel-case keys. The open string index also lets integrations contribute provider values.
+ */
+interface KizloEnv extends EnvRecord {
+  /** Public URL of the mounted Kizlo handler. */
+  readonly baseUrl?: string;
+  /** WordPress profile to use. Defaults to `remote`. */
+  readonly mode?: string;
+  /** Values used when `mode` is absent or `remote`. */
+  readonly remote?: WordPressEnv;
+  /** Values used when `mode` is `local`. */
+  readonly local?: WordPressEnv;
+}
+/** Environment values an integration contributes, either as a typed record or a lazy reader. */
+type EnvSource = KizloEnv | EnvReader;
+/** Read one scalar value by dotted path from an environment record or reader. */
+declare function readEnv(source: EnvSource, name: string): string | undefined;
+/** Required environment values the composed source does not provide. */
+declare function missingEnv(source: EnvSource, required: readonly string[]): string[];
+interface Integration<TId extends string, TProcedures extends AnyProcedureTree = Record<never, never>> {
+  id: TId;
+  /** Procedures the integration exposes. Each entry or nested group becomes a client method under its `id`. */
+  procedures?: TProcedures;
+  /** Webhook event handlers, built with `createEventHandler`, run when WordPress emits a matching event. */
+  events?: EventHandler[];
+  /** Auth, captcha, geo, logger, or cookies adapters the integration supplies. */
+  adapters?: ServiceAdapters;
+  /** Runtime-neutral environment values the integration contributes. Later concrete values replace earlier ones. */
+  env?: EnvSource;
+  /** Environment, endpoint, and WordPress plugin requirements checked at their documented lifecycle points. */
+  requires?: IntegrationRequirements;
+}
+type AnyIntegration = Integration<any, AnyProcedureTree>;
+type ExtractIntegrationProcedures<TIntegration extends AnyIntegration> = TIntegration extends Integration<infer Name, infer Procedures> ? [keyof Procedures] extends [never] ? never : string extends keyof Procedures ? never : Record<Name, Procedures> : never;
+type InferIntegrationProcedures<TIntegrations extends readonly AnyIntegration[]> = TIntegrations extends readonly [] ? Record<never, never> : ExtractIntegrationProcedures<TIntegrations[number]> extends infer R ? [R] extends [never] ? Record<never, never> : UnionToIntersection<R> : never;
+declare function createIntegration<TId extends string, TProcedures extends AnyProcedureTree = Record<never, never>>(integration: Integration<TId, TProcedures>): Integration<TId, TProcedures>;
+/** The declared subtrees the generated tree does not have. */
+declare function missingEndpoints(endpoints: object, required: readonly string[]): string[];
+/**
+ * Fail at startup when an integration's endpoints are not in the generated tree, naming the plugins that
+ * would have put them there.
+ *
+ * Absent endpoints mean the WordPress half is missing, too old to describe its routes, or the tree was
+ * generated against a different WordPress. Left alone it surfaces as a property access on `undefined`
+ * inside whichever procedure ran first, which says nothing about any of that.
+ */
+declare function assertIntegrationEndpoints(integration: AnyIntegration, endpoints: object): void;
+/** Fail at startup when an integration's required environment values are absent. */
+declare function assertIntegrationEnv(integration: AnyIntegration, env: EnvSource): void;
+//#endregion
+export { AnyIntegration, EnvReader, EnvRecord, EnvSource, ExtractIntegrationProcedures, InferIntegrationProcedures, Integration, IntegrationRequirements, KizloEnv, WordPressEnv, assertIntegrationEndpoints, assertIntegrationEnv, createIntegration, missingEndpoints, missingEnv, readEnv };