kizlo 0.20.2 → 0.21.0

package/dist/shared/integration.d.ts

@@ -69,11 +69,19 @@ interface Integration<TId extends string, TProcedures extends AnyProcedureTree =
   env?: EnvSource;
   /** Environment, endpoint, and WordPress plugin requirements checked at their documented lifecycle points. */
   requires?: IntegrationRequirements;
+  /**
+   * Mount position, ascending, defaulting to `0`. Mounting first means supplying the baseline a later
+   * integration overrides, so a framework integration declares a negative order to land ahead of app
+   * integrations however the `integrations` array is written.
+   */
+  order?: number;
 }
 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>;
+/** Integrations in mount order. `sort` is stable, so integrations sharing an `order` keep their declared order. */
+declare function sortIntegrations<TIntegration extends AnyIntegration>(integrations: readonly TIntegration[]): TIntegration[];
 /** The declared subtrees the generated tree does not have. */
 declare function missingEndpoints(endpoints: object, required: readonly string[]): string[];
 /**
@@ -88,4 +96,4 @@ declare function assertIntegrationEndpoints(integration: AnyIntegration, endpoin
 /** 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 };
+export { AnyIntegration, EnvReader, EnvRecord, EnvSource, ExtractIntegrationProcedures, InferIntegrationProcedures, Integration, IntegrationRequirements, KizloEnv, WordPressEnv, assertIntegrationEndpoints, assertIntegrationEnv, createIntegration, missingEndpoints, missingEnv, readEnv, sortIntegrations };

package/dist/shared/integration.js

@@ -18,6 +18,10 @@ function missingEnv(source, required) {
 function createIntegration(integration) {
 	return integration;
 }
+/** Integrations in mount order. `sort` is stable, so integrations sharing an `order` keep their declared order. */
+function sortIntegrations(integrations) {
+	return [...integrations].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
+}
 /** The declared subtrees the generated tree does not have. */
 function missingEndpoints(endpoints, required) {
 	return required.filter((path) => {
@@ -43,8 +47,7 @@ function assertIntegrationEndpoints(integration, endpoints) {
 	const missing = missingEndpoints(endpoints, required);
 	if (missing.length === 0) return;
 	const plugins = integration.requires?.plugins;
-	const remedy = plugins?.length ? `Install or update the required WordPress plugins (${plugins.map((plugin) => `${plugin.name} ${plugin.version}+`).join(", ")}), then run \`kizlo generate\`.` : "Run `kizlo generate` against a WordPress that serves them.";
-	throw new KizloError("MISSING_WORDPRESS_ENDPOINTS", { message: `The "${integration.id}" integration needs WordPress endpoints your generated client does not have: ${missing.join(", ")}. ${remedy}` });
+	throw new KizloError("MISSING_WORDPRESS_ENDPOINTS", { message: `${plugins?.length ? `The "${integration.id}" integration plugin is outdated. Update ${plugins.map((plugin) => `${plugin.name} to ${plugin.version} or newer`).join(" and ")}, then run \`kizlo generate\` to refresh introspection.ts.` : `The "${integration.id}" integration is missing routes in your introspection. Run \`kizlo generate\` against a WordPress that serves them to refresh introspection.ts.`}\n\nMissing routes:\n${missing.map((route) => `  - ${route}`).join("\n")}\n\n${`Download the latest version: https://kizlo.io/integrations/${integration.id}`}` });
 }
 /** Fail at startup when an integration's required environment values are absent. */
 function assertIntegrationEnv(integration, env) {
@@ -56,4 +59,4 @@ function assertIntegrationEnv(integration, env) {
 }
 
 //#endregion
-export { assertIntegrationEndpoints, assertIntegrationEnv, createIntegration, missingEndpoints, missingEnv, readEnv };
+export { assertIntegrationEndpoints, assertIntegrationEnv, createIntegration, missingEndpoints, missingEnv, readEnv, sortIntegrations };

package/dist/wordpress/generate.js

@@ -257,6 +257,11 @@ function sortedChildren(node) {
 function sortedEndpoints(node) {
 	return [...node.endpoints].sort((left, right) => left.member.localeCompare(right.member));
 }
+/**
+* The runtime descriptor for one operation: what the generated client emits, and what anything calling
+* a route straight off the introspection document needs to build its request. Exported because the
+* CLI's MCP server dispatches routes the client never generated a member for.
+*/
 function endpointDefinition(entry) {
 	const pathParameters = sortedEntries(entry.operation.input.properties ?? {}).filter(([, schema]) => schema.in === "path").map(([name]) => name);
 	const responseContentTypes = Object.fromEntries(sortedEntries(entry.operation.responses).map(([status, response]) => [status, response.content_type]));
@@ -454,4 +459,4 @@ function generateWordPressModule(document) {
 }
 
 //#endregion
-export { generateWordPressModule };
+export { camel, endpointDefinition, generateWordPressModule };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kizlo",
-  "version": "0.20.2",
+  "version": "0.21.0",
   "type": "module",
   "description": "A headless WordPress framework for TypeScript.",
   "keywords": [
@@ -107,6 +107,7 @@
   "dependencies": {
     "@clack/prompts": "^1.5.1",
     "@kizlo/shared": "0.9.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@orpc/client": "^1.14.3",
     "@orpc/contract": "^1.14.3",
     "@orpc/openapi": "^1.14.3",