@lssm/lib.contracts 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217072406

package/dist/server/index.js

@@ -1 +1,10 @@
-import{registerContractsOnBuilder as e}from"./graphql-pothos.js";import{createMcpServer as t}from"./mcp/createMcpServer.js";import"./provider-mcp.js";import{createFetchHandler as n}from"./rest-generic.js";import{elysiaPlugin as r}from"./rest-elysia.js";import{expressRouter as i}from"./rest-express.js";import{makeNextAppHandler as a}from"./rest-next-app.js";import{makeNextPagesHandler as o}from"./rest-next-pages.js";export{n as createFetchHandler,t as createMcpServer,r as elysiaPlugin,i as expressRouter,a as makeNextAppHandler,o as makeNextPagesHandler,e as registerContractsOnBuilder};
+import { registerContractsOnBuilder } from "./graphql-pothos.js";
+import { createMcpServer } from "./mcp/createMcpServer.js";
+import "./provider-mcp.js";
+import { createFetchHandler } from "./rest-generic.js";
+import { elysiaPlugin } from "./rest-elysia.js";
+import { expressRouter } from "./rest-express.js";
+import { makeNextAppHandler } from "./rest-next-app.js";
+import { makeNextPagesHandler } from "./rest-next-pages.js";
+
+export { createFetchHandler, createMcpServer, elysiaPlugin, expressRouter, makeNextAppHandler, makeNextPagesHandler, registerContractsOnBuilder };

package/dist/server/mcp/createMcpServer.js

@@ -1 +1,28 @@
-import{registerMcpTools as e}from"./registerTools.js";import{registerMcpResources as t}from"./registerResources.js";import{registerMcpPrompts as n}from"./registerPrompts.js";import{registerMcpPresentations as r}from"./registerPresentations.js";function i(i,a,o,s,c){return c.logger.info(`Creating MCP server`),e(i,a,{toolCtx:c.toolCtx}),t(i,o,{logger:c.logger,resourceCtx:c.resourceCtx}),r(i,{logger:c.logger,presentations:c.presentations,presentationsV2:c.presentationsV2}),n(i,s,{promptCtx:c.promptCtx}),i}export{i as createMcpServer};
+import { registerMcpTools } from "./registerTools.js";
+import { registerMcpResources } from "./registerResources.js";
+import { registerMcpPrompts } from "./registerPrompts.js";
+import { registerMcpPresentations } from "./registerPresentations.js";
+
+//#region src/server/mcp/createMcpServer.ts
+/**
+* Creates a unified Model Context Protocol (MCP) server exposing operations, resources, prompts,
+* and (optionally) presentations.\n+ *
+* ContractSpec exposes:\n+ * - Tools: `command` operations from `SpecRegistry`.\n+ * - Resources: templates from `ResourceRegistry`.\n+ * - Prompts: templates from `PromptRegistry`.\n+ * - Presentations: V1 registry and/or V2 descriptors as read-only resources.\n+ */
+function createMcpServer(server, ops, resources, prompts, ctxFactories) {
+	ctxFactories.logger.info("Creating MCP server");
+	registerMcpTools(server, ops, { toolCtx: ctxFactories.toolCtx });
+	registerMcpResources(server, resources, {
+		logger: ctxFactories.logger,
+		resourceCtx: ctxFactories.resourceCtx
+	});
+	registerMcpPresentations(server, {
+		logger: ctxFactories.logger,
+		presentations: ctxFactories.presentations,
+		presentationsV2: ctxFactories.presentationsV2
+	});
+	registerMcpPrompts(server, prompts, { promptCtx: ctxFactories.promptCtx });
+	return server;
+}
+
+//#endregion
+export { createMcpServer };

package/dist/server/mcp/registerPresentations.js

@@ -1 +1,151 @@
-import{createDefaultTransformEngine as e,registerBasicValidation as t,registerDefaultReactRenderer as n}from"../../presentations.v2.js";import{jsonSchemaForPresentation as r}from"../../presentations.js";function i(e){return!e||typeof e!=`object`?!1:`body`in e&&typeof e.body==`string`}function a(a,o){let s=o.presentations,c=o.presentationsV2;if(s)for(let e of s.list()){let t=`presentation.${e.meta.name.replace(/\./g,`_`)}.v${e.meta.version}`,n=`presentation://${e.meta.name}/v${e.meta.version}`;a.registerResource(t,n,{title:`${e.meta.name} v${e.meta.version}`,description:e.meta.description??`Presentation`},async()=>{if(e.content.kind===`markdown`)return{contents:[{uri:n,mimeType:`text/markdown`,text:e.content.content?e.content.content:`See resource: ${e.content.resourceUri??``}`}]};if(e.content.kind===`data`){let t=r(e);return{contents:[{uri:n,mimeType:`application/json`,text:JSON.stringify(t,null,2)}]}}let t={name:e.meta.name,version:e.meta.version,kind:e.content.kind,description:e.meta.description??``};return{contents:[{uri:n,mimeType:`application/json`,text:JSON.stringify(t,null,2)}]}});for(let i of[{ext:`.md`,target:`markdown`},{ext:`.json`,target:`application/json`},{ext:`.xml`,target:`application/xml`}]){let s=`${t}${i.ext}`,c=`${n}${i.ext}`;o.logger.info(`Registering presentation resource ${c} for ${s}`),a.registerResource(s,c,{title:`${e.meta.name} v${e.meta.version} (${i.ext})`,description:`${e.meta.description??`Presentation`} (${i.ext})`},async()=>{if(e.content.kind===`markdown`&&i.target===`markdown`)return{contents:[{uri:c,mimeType:`text/markdown`,text:e.content.content??`See resource: ${e.content.resourceUri??``}`}]};if(e.content.kind===`data`&&i.target===`application/json`)return{contents:[{uri:c,mimeType:`application/json`,text:JSON.stringify(r(e),null,2)}]};let t=JSON.stringify({meta:e.meta,content:e.content},null,2);return i.target===`application/json`?{contents:[{uri:c,mimeType:`application/json`,text:t}]}:i.target===`application/xml`?{contents:[{uri:c,mimeType:`application/xml`,text:`<presentation name="${e.meta.name}" version="${e.meta.version}"><json>${encodeURIComponent(t)}</json></presentation>`}]}:{contents:[{uri:c,mimeType:`text/markdown`,text:`Unsupported presentation for markdown`}]}})}}if(c&&c.length){let r=t(n(e()));for(let e of c){let t=`presentation.${e.meta.name.replace(/\./g,`_`)}.v${e.meta.version}`,n=`presentation://${e.meta.name}/v${e.meta.version}`;o.logger.info(`Registering presentation descriptor ${n} for ${t}`),a.registerResource(t,n,{title:`${e.meta.name} v${e.meta.version}`,description:e.meta.description??`Presentation`,mimeType:`application/json`},async()=>({contents:[{uri:n,mimeType:`application/json`,text:JSON.stringify({meta:e.meta,source:e.source,targets:e.targets},null,2)}]}));for(let o of[{ext:`.md`,target:`markdown`},{ext:`.json`,target:`application/json`},{ext:`.xml`,target:`application/xml`}]){let s=`${t}${o.ext}`,c=`${n}${o.ext}`;a.registerResource(s,c,{title:`${e.meta.name} v${e.meta.version} (${o.ext})`,description:`${e.meta.description??`Presentation`} (${o.ext})`},async()=>{let t=await r.render(o.target,e);return{contents:[{uri:c,mimeType:i(t)&&t.mimeType?t.mimeType:o.target===`markdown`?`text/markdown`:o.target,text:i(t)&&typeof t.body==`string`?t.body:String(t)}]}})}}}}export{a as registerMcpPresentations};
+import { createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer } from "../../presentations.v2.js";
+import { jsonSchemaForPresentation } from "../../presentations.js";
+
+//#region src/server/mcp/registerPresentations.ts
+function isEngineRenderOutput(x) {
+	if (!x || typeof x !== "object") return false;
+	return "body" in x && typeof x.body === "string";
+}
+function registerMcpPresentations(server, ctx) {
+	const __presentations = ctx.presentations;
+	const __presentationsV2 = ctx.presentationsV2;
+	if (__presentations) for (const p of __presentations.list()) {
+		const baseKey = `presentation.${p.meta.name.replace(/\./g, "_")}.v${p.meta.version}`;
+		const baseUri = `presentation://${p.meta.name}/v${p.meta.version}`;
+		server.registerResource(baseKey, baseUri, {
+			title: `${p.meta.name} v${p.meta.version}`,
+			description: p.meta.description ?? "Presentation"
+		}, async () => {
+			if (p.content.kind === "markdown") return { contents: [{
+				uri: baseUri,
+				mimeType: "text/markdown",
+				text: p.content.content ? p.content.content : `See resource: ${p.content.resourceUri ?? ""}`
+			}] };
+			if (p.content.kind === "data") {
+				const schema = jsonSchemaForPresentation(p);
+				return { contents: [{
+					uri: baseUri,
+					mimeType: "application/json",
+					text: JSON.stringify(schema, null, 2)
+				}] };
+			}
+			const metaOnly = {
+				name: p.meta.name,
+				version: p.meta.version,
+				kind: p.content.kind,
+				description: p.meta.description ?? ""
+			};
+			return { contents: [{
+				uri: baseUri,
+				mimeType: "application/json",
+				text: JSON.stringify(metaOnly, null, 2)
+			}] };
+		});
+		for (const v of [
+			{
+				ext: ".md",
+				target: "markdown"
+			},
+			{
+				ext: ".json",
+				target: "application/json"
+			},
+			{
+				ext: ".xml",
+				target: "application/xml"
+			}
+		]) {
+			const key = `${baseKey}${v.ext}`;
+			const uri = `${baseUri}${v.ext}`;
+			ctx.logger.info(`Registering presentation resource ${uri} for ${key}`);
+			server.registerResource(key, uri, {
+				title: `${p.meta.name} v${p.meta.version} (${v.ext})`,
+				description: `${p.meta.description ?? "Presentation"} (${v.ext})`
+			}, async () => {
+				if (p.content.kind === "markdown" && v.target === "markdown") return { contents: [{
+					uri,
+					mimeType: "text/markdown",
+					text: p.content.content ?? `See resource: ${p.content.resourceUri ?? ""}`
+				}] };
+				if (p.content.kind === "data" && v.target === "application/json") return { contents: [{
+					uri,
+					mimeType: "application/json",
+					text: JSON.stringify(jsonSchemaForPresentation(p), null, 2)
+				}] };
+				const jsonText = JSON.stringify({
+					meta: p.meta,
+					content: p.content
+				}, null, 2);
+				if (v.target === "application/json") return { contents: [{
+					uri,
+					mimeType: "application/json",
+					text: jsonText
+				}] };
+				if (v.target === "application/xml") return { contents: [{
+					uri,
+					mimeType: "application/xml",
+					text: `<presentation name="${p.meta.name}" version="${p.meta.version}"><json>${encodeURIComponent(jsonText)}</json></presentation>`
+				}] };
+				return { contents: [{
+					uri,
+					mimeType: "text/markdown",
+					text: "Unsupported presentation for markdown"
+				}] };
+			});
+		}
+	}
+	if (__presentationsV2 && __presentationsV2.length) {
+		const engine = registerBasicValidation(registerDefaultReactRenderer(createDefaultTransformEngine()));
+		for (const d of __presentationsV2) {
+			const baseKey = `presentation.${d.meta.name.replace(/\./g, "_")}.v${d.meta.version}`;
+			const baseUri = `presentation://${d.meta.name}/v${d.meta.version}`;
+			ctx.logger.info(`Registering presentation descriptor ${baseUri} for ${baseKey}`);
+			server.registerResource(baseKey, baseUri, {
+				title: `${d.meta.name} v${d.meta.version}`,
+				description: d.meta.description ?? "Presentation",
+				mimeType: "application/json"
+			}, async () => {
+				return { contents: [{
+					uri: baseUri,
+					mimeType: "application/json",
+					text: JSON.stringify({
+						meta: d.meta,
+						source: d.source,
+						targets: d.targets
+					}, null, 2)
+				}] };
+			});
+			for (const v of [
+				{
+					ext: ".md",
+					target: "markdown"
+				},
+				{
+					ext: ".json",
+					target: "application/json"
+				},
+				{
+					ext: ".xml",
+					target: "application/xml"
+				}
+			]) {
+				const key = `${baseKey}${v.ext}`;
+				const uri = `${baseUri}${v.ext}`;
+				server.registerResource(key, uri, {
+					title: `${d.meta.name} v${d.meta.version} (${v.ext})`,
+					description: `${d.meta.description ?? "Presentation"} (${v.ext})`
+				}, async () => {
+					const out = await engine.render(v.target, d);
+					return { contents: [{
+						uri,
+						mimeType: isEngineRenderOutput(out) && out.mimeType ? out.mimeType : v.target === "markdown" ? "text/markdown" : v.target,
+						text: isEngineRenderOutput(out) && typeof out.body === "string" ? out.body : String(out)
+					}] };
+				});
+			}
+		}
+	}
+}
+
+//#endregion
+export { registerMcpPresentations };

package/dist/server/mcp/registerPrompts.js

@@ -1,3 +1,37 @@
-import e from"zod";function t(e){let t={};for(let n of e)t[n.name]=n.schema;return t}function n(e,n,r){for(let i of n.list())e.registerPrompt(i.meta.name,{title:i.meta.title,description:i.meta.description,argsSchema:t(i.args)},async e=>{let t=(e,t)=>{let n=e;for(let[e,r]of Object.entries(t))n=n.replace(RegExp(`\\{${e}\\}`,`g`),encodeURIComponent(String(r)));return n};return{messages:[{role:`assistant`,content:{type:`text`,text:(await i.render(i.input.parse(e),{...r.promptCtx(),link:t})).map(e=>e.type===`text`?e.text:`See resource: ${e.title??e.uri}\nURI: ${e.uri}`).join(`
+import z from "zod";
 
-`)}}],description:i.meta.description}})}export{n as registerMcpPrompts};
+//#region src/server/mcp/registerPrompts.ts
+function promptArgsSchemaFromPromptArgs(args) {
+	const shape = {};
+	for (const a of args) shape[a.name] = a.schema;
+	return shape;
+}
+function registerMcpPrompts(server, prompts, ctx) {
+	for (const prompt of prompts.list()) server.registerPrompt(prompt.meta.name, {
+		title: prompt.meta.title,
+		description: prompt.meta.description,
+		argsSchema: promptArgsSchemaFromPromptArgs(prompt.args)
+	}, async (args) => {
+		const link = (tpl, vars) => {
+			let out = tpl;
+			for (const [k, v] of Object.entries(vars)) out = out.replace(new RegExp(`\\{${k}\\}`, "g"), encodeURIComponent(String(v)));
+			return out;
+		};
+		return {
+			messages: [{
+				role: "assistant",
+				content: {
+					type: "text",
+					text: (await prompt.render(prompt.input.parse(args), {
+						...ctx.promptCtx(),
+						link
+					})).map((p) => p.type === "text" ? p.text : `See resource: ${p.title ?? p.uri}\nURI: ${p.uri}`).join("\n\n")
+				}
+			}],
+			description: prompt.meta.description
+		};
+	});
+}
+
+//#endregion
+export { registerMcpPrompts };

package/dist/server/mcp/registerResources.js

@@ -1 +1,35 @@
-import{ResourceTemplate as e}from"@modelcontextprotocol/sdk/server/mcp.js";import{Buffer as t}from"node:buffer";function n(e){return{title:e.meta.title,description:e.meta.description,mimeType:e.meta.mimeType,_meta:{tags:e.meta.tags??[]}}}function r(r,i,a){for(let o of i.listTemplates())a.logger.info(`Registering resource: `+o.meta.uriTemplate),r.registerResource(o.meta.uriTemplate,new e(o.meta.uriTemplate,{list:void 0}),n(o),async(e,n)=>{let r=o.input.parse(n),i=await o.resolve(r,a.resourceCtx());return typeof i.data==`string`?{contents:[{uri:i.uri,mimeType:i.mimeType??o.meta.mimeType,text:i.data}]}:{contents:[{uri:i.uri,mimeType:i.mimeType??o.meta.mimeType,blob:t.from(i.data).toString(`base64`)}]}}),a.logger.info(`Registered resource: `+o.meta.uriTemplate)}export{r as registerMcpResources};
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Buffer } from "node:buffer";
+
+//#region src/server/mcp/registerResources.ts
+function mcpResourceMeta(resource) {
+	return {
+		title: resource.meta.title,
+		description: resource.meta.description,
+		mimeType: resource.meta.mimeType,
+		_meta: { tags: resource.meta.tags ?? [] }
+	};
+}
+function registerMcpResources(server, resources, ctx) {
+	for (const resource of resources.listTemplates()) {
+		ctx.logger.info("Registering resource: " + resource.meta.uriTemplate);
+		server.registerResource(resource.meta.uriTemplate, new ResourceTemplate(resource.meta.uriTemplate, { list: void 0 }), mcpResourceMeta(resource), async (_uri, variables) => {
+			const parsedArgs = resource.input.parse(variables);
+			const out = await resource.resolve(parsedArgs, ctx.resourceCtx());
+			if (typeof out.data === "string") return { contents: [{
+				uri: out.uri,
+				mimeType: out.mimeType ?? resource.meta.mimeType,
+				text: out.data
+			}] };
+			return { contents: [{
+				uri: out.uri,
+				mimeType: out.mimeType ?? resource.meta.mimeType,
+				blob: Buffer.from(out.data).toString("base64")
+			}] };
+		});
+		ctx.logger.info("Registered resource: " + resource.meta.uriTemplate);
+	}
+}
+
+//#endregion
+export { registerMcpResources };

package/dist/server/mcp/registerTools.js

@@ -1 +1,22 @@
-import{defaultMcpTool as e}from"../../jsonschema.js";function t(t,n,r){for(let i of n.listSpecs()){if(i.meta.kind!==`command`)continue;let a=i.transport?.mcp?.toolName??e(i.meta.name,i.meta.version);t.registerTool(a,{description:i.meta.description,inputSchema:i.io.input?.getZod()},async e=>{let t=await n.execute(i.meta.name,i.meta.version,e??{},r.toolCtx());return{content:[{type:`text`,text:JSON.stringify(t,null,4)}]}})}}export{t as registerMcpTools};
+import { defaultMcpTool } from "../../jsonschema.js";
+
+//#region src/server/mcp/registerTools.ts
+function registerMcpTools(server, ops, ctx) {
+	for (const spec of ops.listSpecs()) {
+		if (spec.meta.kind !== "command") continue;
+		const toolName = spec.transport?.mcp?.toolName ?? defaultMcpTool(spec.meta.name, spec.meta.version);
+		server.registerTool(toolName, {
+			description: spec.meta.description,
+			inputSchema: spec.io.input?.getZod()
+		}, async (args) => {
+			const result = await ops.execute(spec.meta.name, spec.meta.version, args ?? {}, ctx.toolCtx());
+			return { content: [{
+				type: "text",
+				text: JSON.stringify(result, null, 4)
+			}] };
+		});
+	}
+}
+
+//#endregion
+export { registerMcpTools };

package/dist/server/provider-mcp.js

@@ -1 +1,3 @@
-import{createMcpServer as e}from"./mcp/createMcpServer.js";export{e as createMcpServer};
+import { createMcpServer } from "./mcp/createMcpServer.js";
+
+export { createMcpServer };

package/dist/server/rest-elysia.js

@@ -1 +1,20 @@
-import{createFetchHandler as e}from"./rest-generic.js";function t(t,n,r,i){let a=e(n,e=>r({request:e,store:t.store}),i);for(let e of n.listSpecs()){let n=e.transport?.rest?.method??(e.meta.kind===`query`?`GET`:`POST`),r=(i?.basePath??``)+(e.transport?.rest?.path??`/${e.meta.name.replace(/\./g,`/`)}/v${e.meta.version}`);t[n.toLowerCase()](r,({request:e})=>a(e))}return i?.cors&&t.options(`*`,({request:e})=>a(e)),t}export{t as elysiaPlugin};
+import { createFetchHandler } from "./rest-generic.js";
+
+//#region src/server/rest-elysia.ts
+/** Mount routes on an Elysia instance */
+function elysiaPlugin(app, reg, ctxFactory, options) {
+	const handler = createFetchHandler(reg, (req) => ctxFactory({
+		request: req,
+		store: app.store
+	}), options);
+	for (const spec of reg.listSpecs()) {
+		const method = spec.transport?.rest?.method ?? (spec.meta.kind === "query" ? "GET" : "POST");
+		const path = (options?.basePath ?? "") + (spec.transport?.rest?.path ?? `/${spec.meta.name.replace(/\./g, "/")}/v${spec.meta.version}`);
+		app[method.toLowerCase()](path, ({ request }) => handler(request));
+	}
+	if (options?.cors) app.options("*", ({ request }) => handler(request));
+	return app;
+}
+
+//#endregion
+export { elysiaPlugin };

package/dist/server/rest-express.js

@@ -1 +1,39 @@
-import{createFetchHandler as e}from"./rest-generic.js";function t(t,n,r,i){let a=t.Router();e(n,e=>{throw Error(`ctxFactory must be called from route`)},i);for(let t of n.listSpecs()){let o=t.transport?.rest?.method??(t.meta.kind===`query`?`GET`:`POST`),s=(i?.basePath??``)+(t.transport?.rest?.path??`/${t.meta.name.replace(/\./g,`/`)}/v${t.meta.version}`);a[o.toLowerCase()](s,async(t,a)=>{let s=new URL(`${t.protocol}://${t.get(`host`)}${t.originalUrl}`),c=new Request(s.toString(),{method:o,headers:Object.fromEntries(Object.entries(t.headers).map(([e,t])=>[e,String(t)])),body:o===`POST`?JSON.stringify(t.body??{}):void 0}),l=await e(n,()=>r(t),i)(c);a.status(l.status),l.headers.forEach((e,t)=>a.setHeader(t,e));let u=await l.text();a.send(u)})}return i?.cors&&a.options(`*`,(e,t)=>{let n=new Headers;new Response(null,{status:204}).headers.forEach((e,t)=>n.set(t,e)),t.status(204).send()}),a}export{t as expressRouter};
+import { createFetchHandler } from "./rest-generic.js";
+
+//#region src/server/rest-express.ts
+/**
+* Build an Express Router that proxies to the Fetch-style handler.
+* You can mount it at any base path; pass the same basePath in options.
+*/
+function expressRouter(express, reg, ctxFactory, options) {
+	const router = express.Router();
+	createFetchHandler(reg, (_r) => {
+		throw new Error("ctxFactory must be called from route");
+	}, options);
+	for (const spec of reg.listSpecs()) {
+		const method = spec.transport?.rest?.method ?? (spec.meta.kind === "query" ? "GET" : "POST");
+		const path = (options?.basePath ?? "") + (spec.transport?.rest?.path ?? `/${spec.meta.name.replace(/\./g, "/")}/v${spec.meta.version}`);
+		router[method.toLowerCase()](path, async (req, res) => {
+			const url = new URL(`${req.protocol}://${req.get("host")}${req.originalUrl}`);
+			const request = new Request(url.toString(), {
+				method,
+				headers: Object.fromEntries(Object.entries(req.headers).map(([k, v]) => [k, String(v)])),
+				body: method === "POST" ? JSON.stringify(req.body ?? {}) : void 0
+			});
+			const response = await createFetchHandler(reg, () => ctxFactory(req), options)(request);
+			res.status(response.status);
+			response.headers.forEach((v, k) => res.setHeader(k, v));
+			const text = await response.text();
+			res.send(text);
+		});
+	}
+	if (options?.cors) router.options("*", (_req, res) => {
+		const h = new Headers();
+		new Response(null, { status: 204 }).headers.forEach((v, k) => h.set(k, v));
+		res.status(204).send();
+	});
+	return router;
+}
+
+//#endregion
+export { expressRouter };

package/dist/server/rest-generic.js

@@ -1 +1,125 @@
-import{defaultRestPath as e}from"../jsonschema.js";function t(e){let t={};return t[`access-control-allow-origin`]=typeof e==`object`?e.origin??`*`:`*`,t.vary=`Origin`,typeof e==`object`?(e.methods&&(t[`access-control-allow-methods`]=e.methods.join(`, `)),e.headers&&(t[`access-control-allow-headers`]=e.headers.join(`, `)),e.credentials&&(t[`access-control-allow-credentials`]=`true`),typeof e.maxAge==`number`&&(t[`access-control-max-age`]=String(e.maxAge))):(t[`access-control-allow-methods`]=`GET,POST,OPTIONS`,t[`access-control-allow-headers`]=`content-type,x-idempotency-key,x-trace-id`),t}function n(e,t){return`${(e??``).replace(/\/+$/g,``)}/${t.replace(/^\/+/g,``)}`.replace(/\/{2,}/g,`/`)}function r(r,i,a){let o={basePath:a?.basePath??``,cors:a?.cors??!1,prettyJson:a?.prettyJson??!1,onError:a?.onError},s=r.listSpecs().map(t=>({method:t.transport?.rest?.method??(t.meta.kind===`query`?`GET`:`POST`),path:n(o.basePath,t.transport?.rest?.path??e(t.meta.name,t.meta.version)),name:t.meta.name,version:t.meta.version})),c=new Map;for(let e of s)c.set(`${e.method} ${e.path}`,e);Array.from(new Set(s.map(e=>e.method))).join(`, `);let l=(e,t,n)=>{let r=o.prettyJson?JSON.stringify(t,null,o.prettyJson):JSON.stringify(t),i={"content-type":`application/json; charset=utf-8`};return new Response(r,{status:e,headers:n?{...i,...n}:i})};return async function(e){let n=new URL(e.url),a=`${e.method.toUpperCase()} ${n.pathname}`;if(o.cors&&e.method.toUpperCase()===`OPTIONS`){let e=t(o.cors===!0?{}:o.cors);return new Response(null,{status:204,headers:{...e,"content-length":`0`}})}let s=c.get(a);if(!s){let e={};return o.cors&&Object.assign(e,t(o.cors===!0?{}:o.cors)),l(404,{error:`NotFound`,path:n.pathname},e)}try{let a={};if(s.method===`GET`)if(n.searchParams.has(`input`)){let e=n.searchParams.get(`input`);a=e?JSON.parse(e):{}}else{let e={};for(let[t,r]of n.searchParams.entries())e[t]=r;a=e}else{let t=e.headers.get(`content-type`)||``;if(t.includes(`application/json`))a=await e.json();else if(t.includes(`application/x-www-form-urlencoded`)){let t=await e.formData();a=Object.fromEntries(t.entries())}else if(!t)a={};else return l(415,{error:`UnsupportedMediaType`,contentType:t})}let c=i(e),u=await r.execute(s.name,s.version,a,c),d={};return o.cors&&Object.assign(d,t(o.cors===!0?{}:o.cors)),l(200,u,d)}catch(e){if(o.onError){let n=o.onError(e),r={};return o.cors&&Object.assign(r,t(o.cors===!0?{}:o.cors)),l(n.status,n.body,r)}let n={};return o.cors&&Object.assign(n,t(o.cors===!0?{}:o.cors)),e?.issues?l(400,{error:`ValidationError`,issues:e.issues},n):typeof e?.message==`string`&&e.message.startsWith(`PolicyDenied`)?l(403,{error:`PolicyDenied`},n):l(500,{error:`InternalError`},n)}}}export{r as createFetchHandler};
+import { defaultRestPath } from "../jsonschema.js";
+
+//#region src/server/rest-generic.ts
+/** Minimal WHATWG Response polyfill util for Node < 18 (if needed) */
+function corsHeaders(opt) {
+	const h = {};
+	h["access-control-allow-origin"] = typeof opt === "object" ? opt.origin ?? "*" : "*";
+	h["vary"] = "Origin";
+	if (typeof opt === "object") {
+		if (opt.methods) h["access-control-allow-methods"] = opt.methods.join(", ");
+		if (opt.headers) h["access-control-allow-headers"] = opt.headers.join(", ");
+		if (opt.credentials) h["access-control-allow-credentials"] = "true";
+		if (typeof opt.maxAge === "number") h["access-control-max-age"] = String(opt.maxAge);
+	} else {
+		h["access-control-allow-methods"] = "GET,POST,OPTIONS";
+		h["access-control-allow-headers"] = "content-type,x-idempotency-key,x-trace-id";
+	}
+	return h;
+}
+function joinPath(a, b) {
+	return `${(a ?? "").replace(/\/+$/g, "")}/${b.replace(/^\/+/g, "")}`.replace(/\/{2,}/g, "/");
+}
+/**
+* Build a single Fetch-style handler: (req) => Response
+* - Discovers routes from SpecRegistry
+* - Validates with zod via registry.execute()
+* - Handles CORS (optional)
+*/
+function createFetchHandler(reg, ctxFactory, options) {
+	const opts = {
+		basePath: options?.basePath ?? "",
+		cors: options?.cors ?? false,
+		prettyJson: options?.prettyJson ?? false,
+		onError: options?.onError
+	};
+	const routes = reg.listSpecs().map((spec) => ({
+		method: spec.transport?.rest?.method ?? (spec.meta.kind === "query" ? "GET" : "POST"),
+		path: joinPath(opts.basePath, spec.transport?.rest?.path ?? defaultRestPath(spec.meta.name, spec.meta.version)),
+		name: spec.meta.name,
+		version: spec.meta.version
+	}));
+	const routeTable = /* @__PURE__ */ new Map();
+	for (const r of routes) routeTable.set(`${r.method} ${r.path}`, r);
+	Array.from(new Set(routes.map((r) => r.method))).join(", ");
+	const makeJson = (status, data, extraHeaders) => {
+		const body = opts.prettyJson ? JSON.stringify(data, null, opts.prettyJson) : JSON.stringify(data);
+		const base = { "content-type": "application/json; charset=utf-8" };
+		return new Response(body, {
+			status,
+			headers: extraHeaders ? {
+				...base,
+				...extraHeaders
+			} : base
+		});
+	};
+	return async function handle(req) {
+		const url = new URL(req.url);
+		const key = `${req.method.toUpperCase()} ${url.pathname}`;
+		if (opts.cors && req.method.toUpperCase() === "OPTIONS") {
+			const h = corsHeaders(opts.cors === true ? {} : opts.cors);
+			return new Response(null, {
+				status: 204,
+				headers: {
+					...h,
+					"content-length": "0"
+				}
+			});
+		}
+		const route = routeTable.get(key);
+		if (!route) {
+			const headers = {};
+			if (opts.cors) Object.assign(headers, corsHeaders(opts.cors === true ? {} : opts.cors));
+			return makeJson(404, {
+				error: "NotFound",
+				path: url.pathname
+			}, headers);
+		}
+		try {
+			let input = {};
+			if (route.method === "GET") if (url.searchParams.has("input")) {
+				const raw = url.searchParams.get("input");
+				input = raw ? JSON.parse(raw) : {};
+			} else {
+				const obj = {};
+				for (const [k, v] of url.searchParams.entries()) obj[k] = v;
+				input = obj;
+			}
+			else {
+				const contentType = req.headers.get("content-type") || "";
+				if (contentType.includes("application/json")) input = await req.json();
+				else if (contentType.includes("application/x-www-form-urlencoded")) {
+					const form = await req.formData();
+					input = Object.fromEntries(form.entries());
+				} else if (!contentType) input = {};
+				else return makeJson(415, {
+					error: "UnsupportedMediaType",
+					contentType
+				});
+			}
+			const ctx = ctxFactory(req);
+			const result = await reg.execute(route.name, route.version, input, ctx);
+			const headers = {};
+			if (opts.cors) Object.assign(headers, corsHeaders(opts.cors === true ? {} : opts.cors));
+			return makeJson(200, result, headers);
+		} catch (err) {
+			if (opts.onError) {
+				const mapped = opts.onError(err);
+				const headers$1 = {};
+				if (opts.cors) Object.assign(headers$1, corsHeaders(opts.cors === true ? {} : opts.cors));
+				return makeJson(mapped.status, mapped.body, headers$1);
+			}
+			const headers = {};
+			if (opts.cors) Object.assign(headers, corsHeaders(opts.cors === true ? {} : opts.cors));
+			if (err?.issues) return makeJson(400, {
+				error: "ValidationError",
+				issues: err.issues
+			}, headers);
+			if (typeof err?.message === "string" && err.message.startsWith("PolicyDenied")) return makeJson(403, { error: "PolicyDenied" }, headers);
+			return makeJson(500, { error: "InternalError" }, headers);
+		}
+	};
+}
+
+//#endregion
+export { createFetchHandler };

package/dist/server/rest-next-app.js

@@ -1 +1,38 @@
-import{createFetchHandler as e}from"./rest-generic.js";function t(t,n,r){let i=e(t,n,r);return async function(e){return i(e)}}export{t as makeNextAppHandler};
+import { createFetchHandler } from "./rest-generic.js";
+
+//#region src/server/rest-next-app.ts
+/**
+* Creates a Next.js App Router route handler for ContractSpec operations.
+*
+* This function returns a handler suitable for `export const { GET, POST }` in a `route.ts` file.
+* It handles:
+* - Path parsing to determine the operation name and version.
+* - Body parsing (JSON).
+* - Context creation via `ctxFactory`.
+* - Execution via `SpecRegistry`.
+* - Response formatting (JSON success/error).
+*
+* @param reg - The SpecRegistry containing the operations.
+* @param ctxFactory - A factory function to build the `HandlerCtx` (e.g., auth, tenant) from the request.
+* @param options - Optional configuration for the REST handler.
+* @returns A function `(req: Request) => Promise<Response>`.
+*
+* @example
+* ```ts
+* // app/api/[...route]/route.ts
+* import { makeNextAppHandler } from '@lssm/lib.contracts/server/rest-next-app';
+* import { registry } from '@/lib/registry';
+*
+* const handler = makeNextAppHandler(registry, (req) => ({ actor: 'anonymous' }));
+* export { handler as GET, handler as POST };
+* ```
+*/
+function makeNextAppHandler(reg, ctxFactory, options) {
+	const handler = createFetchHandler(reg, ctxFactory, options);
+	return async function requestHandler(req) {
+		return handler(req);
+	};
+}
+
+//#endregion
+export { makeNextAppHandler };

package/dist/server/rest-next-mcp.js

@@ -1 +1,45 @@
-import{defaultMcpTool as e,jsonSchemaForSpec as t}from"../jsonschema.js";import{ResourceTemplate as n}from"@modelcontextprotocol/sdk/server/mcp.js";import{createMcpHandler as r}from"mcp-handler";function i(i,a){let o=r(r=>{for(let o of i.listSpecs()){let{input:s,output:c,meta:l}=t(o);if(l.kind===`query`){let t=o.transport?.mcp?.toolName??e(o.meta.name,o.meta.version);r.registerResource(t,new n(`users://{userId}/profile`,{list:void 0}),{description:o.meta.description,inputSchema:s},(async(e,t,n)=>{let r=await i.execute(o.meta.name,o.meta.version,t??{},a());return{contents:[{uri:e.href,text:String(r)}]}}))}else if(l.kind===`command`){let t=o.transport?.mcp?.toolName??e(o.meta.name,o.meta.version);r.registerTool(t,{description:o.meta.description,inputSchema:s},(async(e,t)=>{let n=await i.execute(o.meta.name,o.meta.version,e??{},a());return{content:[{type:`text`,text:String(n)}]}}))}else throw Error(`Unsupported kind: ${l.kind}`)}},{},{basePath:`/api`});return{GET:o,POST:o,DELETE:o}}export{i as makeNextMcpServerFromRegistry};
+import { defaultMcpTool, jsonSchemaForSpec } from "../jsonschema.js";
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { createMcpHandler } from "mcp-handler";
+
+//#region src/server/rest-next-mcp.ts
+function makeNextMcpServerFromRegistry(reg, ctxFactory) {
+	const handler = createMcpHandler((server) => {
+		for (const spec of reg.listSpecs()) {
+			const { input, output, meta } = jsonSchemaForSpec(spec);
+			if (meta.kind === "query") {
+				const resourceName = spec.transport?.mcp?.toolName ?? defaultMcpTool(spec.meta.name, spec.meta.version);
+				server.registerResource(resourceName, new ResourceTemplate("users://{userId}/profile", { list: void 0 }), {
+					description: spec.meta.description,
+					inputSchema: input
+				}, (async (uri, args, _req) => {
+					const result = await reg.execute(spec.meta.name, spec.meta.version, args ?? {}, ctxFactory());
+					return { contents: [{
+						uri: uri.href,
+						text: String(result)
+					}] };
+				}));
+			} else if (meta.kind === "command") {
+				const toolName = spec.transport?.mcp?.toolName ?? defaultMcpTool(spec.meta.name, spec.meta.version);
+				server.registerTool(toolName, {
+					description: spec.meta.description,
+					inputSchema: input
+				}, (async (args, _req) => {
+					const result = await reg.execute(spec.meta.name, spec.meta.version, args ?? {}, ctxFactory());
+					return { content: [{
+						type: "text",
+						text: String(result)
+					}] };
+				}));
+			} else throw new Error(`Unsupported kind: ${meta.kind}`);
+		}
+	}, {}, { basePath: "/api" });
+	return {
+		GET: handler,
+		POST: handler,
+		DELETE: handler
+	};
+}
+
+//#endregion
+export { makeNextMcpServerFromRegistry };

package/dist/server/rest-next-pages.js

@@ -1 +1,25 @@
-import{createFetchHandler as e}from"./rest-generic.js";function t(t,n,r){return e(t,e=>{throw Error(`Use per-request wrapper`)},r),async function(i,a){let o=`${i.headers[`x-forwarded-proto`]??`http`}://${i.headers.host}${i.url}`,s=i.method?.toUpperCase()||`GET`,c=new Request(o,{method:s,headers:Object.fromEntries(Object.entries(i.headers).map(([e,t])=>[e,String(t)])),body:s===`POST`?JSON.stringify(i.body??{}):void 0}),l=await e(t,()=>n(i),r)(c);a.status(l.status),l.headers.forEach((e,t)=>a.setHeader(t,e));let u=await l.text();a.send(u)}}export{t as makeNextPagesHandler};
+import { createFetchHandler } from "./rest-generic.js";
+
+//#region src/server/rest-next-pages.ts
+function makeNextPagesHandler(reg, ctxFactory, options) {
+	createFetchHandler(reg, (_req) => {
+		throw new Error("Use per-request wrapper");
+	}, options);
+	return async function handler(req, res) {
+		const url = `${req.headers["x-forwarded-proto"] ?? "http"}://${req.headers.host}${req.url}`;
+		const method = req.method?.toUpperCase() || "GET";
+		const request = new Request(url, {
+			method,
+			headers: Object.fromEntries(Object.entries(req.headers).map(([k, v]) => [k, String(v)])),
+			body: method === "POST" ? JSON.stringify(req.body ?? {}) : void 0
+		});
+		const response = await createFetchHandler(reg, () => ctxFactory(req), options)(request);
+		res.status(response.status);
+		response.headers.forEach((v, k) => res.setHeader(k, v));
+		const text = await response.text();
+		res.send(text);
+	};
+}
+
+//#endregion
+export { makeNextPagesHandler };

package/dist/spec.js

@@ -1 +1,35 @@
-const e=e=>`ref`in e,t=e=>({...e,meta:{...e.meta,kind:`command`},policy:{...e.policy,idempotent:e.policy?.policy?.idempotent??!1}}),n=e=>({...e,meta:{...e.meta,kind:`query`},policy:{...e.policy,idempotent:!0}});export{t as defineCommand,n as defineQuery,e as isEmitDeclRef};
+//#region src/spec.ts
+const isEmitDeclRef = (e) => "ref" in e;
+/**
+* Helper to define a Command (write operation).
+* Sets `kind: 'command'` and defaults `idempotent: false`.
+*/
+const defineCommand = (spec) => ({
+	...spec,
+	meta: {
+		...spec.meta,
+		kind: "command"
+	},
+	policy: {
+		...spec.policy,
+		idempotent: spec.policy?.["policy"]?.idempotent ?? false
+	}
+});
+/**
+* Helper to define a Query (read-only operation).
+* Sets `kind: 'query'` and forces `idempotent: true`.
+*/
+const defineQuery = (spec) => ({
+	...spec,
+	meta: {
+		...spec.meta,
+		kind: "query"
+	},
+	policy: {
+		...spec.policy,
+		idempotent: true
+	}
+});
+
+//#endregion
+export { defineCommand, defineQuery, isEmitDeclRef };