@lssm/lib.contracts 1.41.0 → 1.42.1

package/dist/server/mcp/registerPresentations.js

@@ -1 +1,112 @@
-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/transform-engine.js";
+import "../../presentations/index.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;
+	const engine = registerBasicValidation(registerDefaultReactRenderer(createDefaultTransformEngine()));
+	if (__presentations) for (const p of __presentations.list()) {
+		const baseKey = `presentation.${p.meta.key.replace(/\./g, "_")}.v${p.meta.version}`;
+		const baseUri = `presentation://${p.meta.key}/v${p.meta.version}`;
+		ctx.logger.info(`Registering presentation ${baseUri} for ${baseKey}`);
+		server.registerResource(baseKey, baseUri, {
+			title: `${p.meta.key} v${p.meta.version}`,
+			description: p.meta.description ?? "Presentation",
+			mimeType: "application/json"
+		}, async () => {
+			return { contents: [{
+				uri: baseUri,
+				mimeType: "application/json",
+				text: JSON.stringify({
+					meta: p.meta,
+					source: p.source,
+					targets: p.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: `${p.meta.key} v${p.meta.version} (${v.ext})`,
+				description: `${p.meta.description ?? "Presentation"} (${v.ext})`
+			}, async () => {
+				const out = await engine.render(v.target, p);
+				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)
+				}] };
+			});
+		}
+	}
+	if (__presentationsV2 && __presentationsV2.length) for (const d of __presentationsV2) {
+		const baseKey = `presentation.${d.meta.key.replace(/\./g, "_")}.v${d.meta.version}`;
+		const baseUri = `presentation://${d.meta.key}/v${d.meta.version}`;
+		ctx.logger.info(`Registering presentation descriptor ${baseUri} for ${baseKey}`);
+		server.registerResource(baseKey, baseUri, {
+			title: `${d.meta.key} 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.key} 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.d.ts

@@ -0,0 +1,8 @@
+import { PromptRegistry } from "../../promptRegistry.js";
+import { McpCtxFactories } from "./mcpTypes.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/server/mcp/registerPrompts.d.ts
+declare function registerMcpPrompts(server: McpServer, prompts: PromptRegistry, ctx: Pick<McpCtxFactories, 'promptCtx'>): void;
+//#endregion
+export { registerMcpPrompts };

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.key, {
+		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.d.ts

@@ -0,0 +1,8 @@
+import { ResourceRegistry } from "../../resources.js";
+import { McpCtxFactories } from "./mcpTypes.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/server/mcp/registerResources.d.ts
+declare function registerMcpResources(server: McpServer, resources: ResourceRegistry, ctx: Pick<McpCtxFactories, 'logger' | 'resourceCtx'>): void;
+//#endregion
+export { registerMcpResources };

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.d.ts

@@ -0,0 +1,8 @@
+import { OperationSpecRegistry } from "../../operations/registry.js";
+import { McpCtxFactories } from "./mcpTypes.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/server/mcp/registerTools.d.ts
+declare function registerMcpTools(server: McpServer, ops: OperationSpecRegistry, ctx: Pick<McpCtxFactories, 'toolCtx'>): void;
+//#endregion
+export { registerMcpTools };

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.key, spec.meta.version);
+		server.registerTool(toolName, {
+			description: spec.meta.description,
+			inputSchema: spec.io.input?.getZod()
+		}, async (args) => {
+			const result = await ops.execute(spec.meta.key, spec.meta.version, args ?? {}, ctx.toolCtx());
+			return { content: [{
+				type: "text",
+				text: JSON.stringify(result, null, 4)
+			}] };
+		});
+	}
+}
+
+//#endregion
+export { registerMcpTools };

package/dist/server/provider-mcp.d.ts

@@ -0,0 +1,2 @@
+import { createMcpServer } from "./mcp/createMcpServer.js";
+export { createMcpServer };

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.d.ts

@@ -0,0 +1,40 @@
+import { HandlerCtx } from "../types.js";
+import { OperationSpecRegistry } from "../operations/registry.js";
+import { RestOptions } from "./rest-generic.js";
+import { Elysia } from "elysia";
+
+//#region src/server/rest-elysia.d.ts
+/** Mount routes on an Elysia instance */
+declare function elysiaPlugin(app: Elysia, reg: OperationSpecRegistry, ctxFactory: (c: {
+  request: Request;
+  store: unknown;
+}) => HandlerCtx, options?: RestOptions): Elysia<"", {
+  decorator: {};
+  store: {};
+  derive: {};
+  resolve: {};
+}, {
+  typebox: {};
+  error: {};
+}, {
+  schema: {};
+  standaloneSchema: {};
+  macro: {};
+  macroFn: {};
+  parser: {};
+  response: {};
+}, {}, {
+  derive: {};
+  resolve: {};
+  schema: {};
+  standaloneSchema: {};
+  response: {};
+}, {
+  derive: {};
+  resolve: {};
+  schema: {};
+  standaloneSchema: {};
+  response: {};
+}>;
+//#endregion
+export { elysiaPlugin };

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.key.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.d.ts

@@ -0,0 +1,16 @@
+import { HandlerCtx } from "../types.js";
+import { OperationSpecRegistry } from "../operations/registry.js";
+import { RestOptions } from "./rest-generic.js";
+import { Request, Router } from "express";
+
+//#region src/server/rest-express.d.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.
+ */
+declare function expressRouter(express: {
+  Router: () => Router;
+}, reg: OperationSpecRegistry, ctxFactory: (req: Request) => HandlerCtx, options?: RestOptions): Router;
+//#endregion
+export { expressRouter };

package/dist/server/rest-express.js

@@ -1 +1,36 @@
-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();
+	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.key.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.d.ts

@@ -0,0 +1,32 @@
+import { HandlerCtx } from "../types.js";
+import { OperationSpecRegistry } from "../operations/registry.js";
+
+//#region src/server/rest-generic.d.ts
+interface RestOptions {
+  /** Prefix all routes, e.g. "/api" */
+  basePath?: string;
+  /** If true, handle OPTIONS and set CORS headers */
+  cors?: boolean | {
+    origin?: string | '*';
+    methods?: string[];
+    headers?: string[];
+    credentials?: boolean;
+    maxAge?: number;
+  };
+  /** JSON spacing in responses (dev only ideally) */
+  prettyJson?: number | false;
+  /** Map thrown errors to {status, body} */
+  onError?: (err: unknown) => {
+    status: number;
+    body: unknown;
+  };
+}
+/**
+ * Build a single Fetch-style handler: (req) => Response
+ * - Discovers routes from OperationSpecRegistry
+ * - Validates with zod via registry.execute()
+ * - Handles CORS (optional)
+ */
+declare function createFetchHandler(reg: OperationSpecRegistry, ctxFactory: (req: Request) => HandlerCtx, options?: RestOptions): (req: Request) => Promise<Response>;
+//#endregion
+export { RestOptions, createFetchHandler };

package/dist/server/rest-generic.js

@@ -1 +1,124 @@
-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 OperationSpecRegistry
+* - 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.key, spec.meta.version)),
+		name: spec.meta.key,
+		version: spec.meta.version
+	}));
+	const routeTable = /* @__PURE__ */ new Map();
+	for (const r of routes) routeTable.set(`${r.method} ${r.path}`, r);
+	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.d.ts

@@ -0,0 +1,35 @@
+import { HandlerCtx } from "../types.js";
+import { OperationSpecRegistry } from "../operations/registry.js";
+import { RestOptions } from "./rest-generic.js";
+
+//#region src/server/rest-next-app.d.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 `OperationSpecRegistry`.
+ * - Response formatting (JSON success/error).
+ *
+ * @param reg - The OperationSpecRegistry 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 };
+ * ```
+ */
+declare function makeNextAppHandler(reg: OperationSpecRegistry, ctxFactory: (req: Request) => HandlerCtx, options?: RestOptions): (req: Request) => Promise<Response>;
+//#endregion
+export { makeNextAppHandler };

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 `OperationSpecRegistry`.
+* - Response formatting (JSON success/error).
+*
+* @param reg - The OperationSpecRegistry 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.d.ts

@@ -0,0 +1,11 @@
+import { HandlerCtx } from "../types.js";
+import { OperationSpecRegistry } from "../operations/registry.js";
+
+//#region src/server/rest-next-mcp.d.ts
+declare function makeNextMcpServerFromRegistry(reg: OperationSpecRegistry, ctxFactory: () => HandlerCtx): {
+  GET: (request: Request) => Promise<Response>;
+  POST: (request: Request) => Promise<Response>;
+  DELETE: (request: Request) => Promise<Response>;
+};
+//#endregion
+export { makeNextMcpServerFromRegistry };