@lssm/lib.contracts 0.0.0-canary-20251120170226

package/dist/server/provider-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-mcp.js","names":["z"],"sources":["../../src/server/provider-mcp.ts"],"sourcesContent":["import {\n  McpServer,\n  ResourceTemplate,\n} from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { SpecRegistry } from '../registry';\nimport type { ResourceRegistry } from '../resources';\nimport type { AnySchemaModel } from '@lssm/lib.schema';\nimport type { ContractSpec } from '../spec';\nimport type { PresentationRegistry } from '../presentations';\nimport { jsonSchemaForPresentation } from '../presentations';\nimport {\n  createDefaultTransformEngine,\n  type PresentationDescriptorV2,\n  registerBasicValidation,\n  registerDefaultReactRenderer,\n} from '../presentations.v2';\nimport type { PromptRegistry } from '../promptRegistry';\nimport type { HandlerCtx } from '../types';\nimport { defaultMcpTool, jsonSchemaForSpec } from '../jsonschema';\nimport type {\n  CallToolResult,\n  GetPromptResult,\n} from '@modelcontextprotocol/sdk/types.js';\nimport { zodToJsonSchema } from 'zod-to-json-schema';\nimport z from 'zod';\n\n/**\n * Creates a unified Model Context Protocol (MCP) server exposing operations, resources, and prompts.\n *\n * This function takes registries for operations, resources, and prompts, and exposes them as\n * MCP Tools, Resources, and Prompts respectively. It enables AI agents to discover and interact\n * with the application's capabilities.\n *\n * Features:\n * - **Tools**: Exposes `command` operations as executable tools.\n * - **Resources**: Exposes `ResourceRegistry` entries and `PresentationSpec`s (Markdown/JSON) as read-only resources.\n * - **Prompts**: Exposes `PromptRegistry` entries as templated prompts.\n *\n * @param server - The `McpServer` instance to populate.\n * @param ops - Registry containing operations (tools).\n * @param resources - Registry containing data resources.\n * @param prompts - Registry containing prompt templates.\n * @param ctxFactories - Factories to create context for tools, resources, and prompts execution.\n * @returns The populated `McpServer` instance.\n */\nexport function createMcpServer(\n  server: McpServer,\n  ops: SpecRegistry,\n  resources: ResourceRegistry,\n  prompts: PromptRegistry,\n  ctxFactories: {\n    /** Factory for tool execution context (e.g., system actor) */\n    toolCtx: () => HandlerCtx;\n    /** Factory for prompt rendering context */\n    promptCtx: () => {\n      userId?: string | null;\n      orgId?: string | null;\n      locale?: string;\n    };\n    /** Factory for resource resolution context */\n    resourceCtx: () => {\n      userId?: string | null;\n      orgId?: string | null;\n      locale?: string;\n    };\n    /** Optional registry for V1 presentations */\n    presentations?: PresentationRegistry;\n    /** Optional list of V2 presentation descriptors */\n    presentationsV2?: PresentationDescriptorV2[];\n  }\n) {\n  /* ---------- Tools (commands) ---------- */\n  for (const spec of ops.listSpecs()) {\n    if (spec.meta.kind !== 'command') continue; // expose only commands as tools\n    const { input } = jsonSchemaForSpec(\n      spec as unknown as ContractSpec<AnySchemaModel, AnySchemaModel>\n    );\n    const toolName =\n      spec.transport?.mcp?.toolName ??\n      defaultMcpTool(spec.meta.name, spec.meta.version);\n\n    server.registerTool(\n      toolName,\n      {\n        // name: toolName,\n        description: spec.meta.description,\n        inputSchema: input as any,\n      },\n      async (args: any, _req: any): Promise<CallToolResult> => {\n        const result = await ops.execute(\n          spec.meta.name,\n          spec.meta.version,\n          args ?? {},\n          ctxFactories.toolCtx()\n        );\n        // return { content: [{ type: 'json', json: result }] };\n        return {\n          content: [{ type: 'text', text: JSON.stringify(result, null, 4) }],\n        };\n      }\n    );\n  }\n\n  /* ---------- Resources (queries/views) ---------- */\n  for (const resource of resources.listTemplates()) {\n    // server.registerPrompt(\n    //   'review-code',\n    //   {\n    //     title: 'Code Review',\n    //     description: 'Review code for best practices and potential issues',\n    //     argsSchema: { code: z.string() as any },\n    //   },\n    //   ({ code }: { code?: string }) => ({\n    //     messages: [\n    //       {\n    //         role: 'user',\n    //         content: {\n    //           type: 'text',\n    //           text: `Please review this code:\\n\\n${code}`,\n    //         },\n    //       },\n    //     ],\n    //   })\n    // );\n\n    (server as any).registerResource(\n      resource.meta.uriTemplate.split(':')[0]!,\n      new ResourceTemplate(resource.meta.uriTemplate, {} as any),\n      {\n        // name: resource.meta.title,\n        description: resource.meta.description,\n        inputSchema: zodToJsonSchema(resource.input, {\n          // metadata: `${op.meta.name}.input.v${op.meta.version}`,\n        }),\n      },\n      async (_uri: any, args: any, _req: any) => {\n        const ctx = ctxFactories.resourceCtx();\n        const out = await resource.resolve(args, ctx);\n        if (typeof out.data === 'string') {\n          return {\n            contents: [\n              {\n                uri: out.uri,\n                mimeType: out.mimeType ?? resource.meta.mimeType,\n                text: out.data,\n              },\n            ],\n          };\n        }\n        return {\n          contents: [\n            {\n              uri: out.uri,\n              mimeType: out.mimeType ?? resource.meta.mimeType,\n              blob: out.data.toString(),\n            },\n          ],\n        };\n      }\n    );\n  }\n\n  /* ---------- Presentations as resources (markdown/data) with content negotiation ---------- */\n  const __presentations = ctxFactories.presentations;\n  const __presentationsV2 = ctxFactories.presentationsV2;\n  if (__presentations) {\n    const engine = registerBasicValidation(\n      registerDefaultReactRenderer(createDefaultTransformEngine())\n    );\n    for (const p of __presentations.list()) {\n      const baseKey = `presentation.${p.meta.name.replace(/\\./g, '_')}.v${p.meta.version}`;\n      const baseUri = `presentation://${p.meta.name}/v${p.meta.version}`;\n\n      // Generic metadata\n      (server as any).registerResource(\n        baseKey,\n        new ResourceTemplate(baseUri, {} as any),\n        {\n          description: p.meta.description ?? 'Presentation',\n          inputSchema: z.toJSONSchema(z.object({})),\n        },\n        async (_uri: any, _args: any, _req: any) => {\n          if (p.content.kind === 'markdown') {\n            const text = p.content.content\n              ? p.content.content\n              : `See resource: ${p.content.resourceUri ?? ''}`;\n            return {\n              contents: [\n                {\n                  uri: baseUri,\n                  mimeType: 'text/markdown',\n                  text,\n                },\n              ],\n            };\n          }\n          if (p.content.kind === 'data') {\n            const schema = jsonSchemaForPresentation(p);\n            return {\n              contents: [\n                {\n                  uri: baseUri,\n                  mimeType: 'application/json',\n                  text: JSON.stringify(schema, null, 2),\n                },\n              ],\n            };\n          }\n          // web_component: metadata only for now\n          const metaOnly = {\n            name: p.meta.name,\n            version: p.meta.version,\n            kind: p.content.kind,\n            description: p.meta.description ?? '',\n          };\n          return {\n            contents: [\n              {\n                uri: baseUri,\n                mimeType: 'application/json',\n                text: JSON.stringify(metaOnly, null, 2),\n              },\n            ],\n          };\n        }\n      );\n\n      // Negotiated variants\n      const variants: {\n        ext: string;\n        target: 'markdown' | 'application/json' | 'application/xml';\n      }[] = [\n        { ext: '.md', target: 'markdown' },\n        { ext: '.json', target: 'application/json' },\n        { ext: '.xml', target: 'application/xml' },\n      ];\n      for (const v of variants) {\n        const key = `${baseKey}${v.ext}`;\n        const uri = `${baseUri}${v.ext}`;\n        (server as any).registerResource(\n          key,\n          new ResourceTemplate(uri, {} as any),\n          {\n            description: `${p.meta.description ?? 'Presentation'} (${v.ext})`,\n            inputSchema: z.toJSONSchema(z.object({})),\n          },\n          async () => {\n            // Use V2 engine to render a normalized JSON snapshot; if p is V1, fallback to jsonSchemaForPresentation\n            if (p.content.kind === 'markdown' && v.target === 'markdown') {\n              const text =\n                p.content.content ??\n                `See resource: ${p.content.resourceUri ?? ''}`;\n              return { contents: [{ uri, mimeType: 'text/markdown', text }] };\n            }\n            if (p.content.kind === 'data' && v.target === 'application/json') {\n              return {\n                contents: [\n                  {\n                    uri,\n                    mimeType: 'application/json',\n                    text: JSON.stringify(jsonSchemaForPresentation(p), null, 2),\n                  },\n                ],\n              };\n            }\n            // Default: represent as JSON snapshot\n            const jsonText = JSON.stringify(\n              { meta: p.meta, content: p.content },\n              null,\n              2\n            );\n            if (v.target === 'application/json') {\n              return {\n                contents: [\n                  { uri, mimeType: 'application/json', text: jsonText },\n                ],\n              };\n            }\n            if (v.target === 'application/xml') {\n              const xml = `<presentation name=\"${p.meta.name}\" version=\"${p.meta.version}\"><json>${encodeURIComponent(jsonText)}</json></presentation>`;\n              return {\n                contents: [{ uri, mimeType: 'application/xml', text: xml }],\n              };\n            }\n            // markdown fallback\n            return {\n              contents: [\n                {\n                  uri,\n                  mimeType: 'text/markdown',\n                  text: 'Unsupported presentation for markdown',\n                },\n              ],\n            };\n          }\n        );\n      }\n    }\n  }\n\n  // V2: register descriptors using transform engine (same scheme/negotiation)\n  if (__presentationsV2 && __presentationsV2.length) {\n    const engine = registerBasicValidation(\n      registerDefaultReactRenderer(createDefaultTransformEngine())\n    );\n    for (const d of __presentationsV2) {\n      const baseKey = `presentation.${d.meta.name.replace(/\\./g, '_')}.v${d.meta.version}`;\n      const baseUri = `presentation://${d.meta.name}/v${d.meta.version}`;\n\n      (server as any).registerResource(\n        baseKey,\n        new ResourceTemplate(baseUri, {} as any),\n        {\n          description: d.meta.description ?? 'Presentation',\n          inputSchema: z.toJSONSchema(z.object({})),\n        },\n        async () => {\n          const jsonText = JSON.stringify(\n            { meta: d.meta, source: d.source, targets: d.targets },\n            null,\n            2\n          );\n          return {\n            contents: [\n              { uri: baseUri, mimeType: 'application/json', text: jsonText },\n            ],\n          };\n        }\n      );\n\n      const variants: {\n        ext: string;\n        target: 'markdown' | 'application/json' | 'application/xml';\n      }[] = [\n        { ext: '.md', target: 'markdown' },\n        { ext: '.json', target: 'application/json' },\n        { ext: '.xml', target: 'application/xml' },\n      ];\n      for (const v of variants) {\n        const key = `${baseKey}${v.ext}`;\n        const uri = `${baseUri}${v.ext}`;\n        (server as any).registerResource(\n          key,\n          new ResourceTemplate(uri, {} as any),\n          {\n            description: `${d.meta.description ?? 'Presentation'} (${v.ext})`,\n            inputSchema: z.toJSONSchema(z.object({})),\n          },\n          async () => {\n            const out = await engine.render(v.target, d);\n            return {\n              contents: [\n                {\n                  uri,\n                  mimeType:\n                    (out as any).mimeType ??\n                    (v.target === 'markdown' ? 'text/markdown' : v.target),\n                  text: (out as any).body ?? String(out),\n                },\n              ],\n            };\n          }\n        );\n      }\n    }\n  }\n\n  /* ---------- Prompts ---------- */\n  // for (const prompt of prompts.list()) {\n  for (const prompt of prompts.list()) {\n    server.registerPrompt(\n      prompt.meta.name,\n      {\n        title: prompt.meta.title,\n        description: prompt.meta.title,\n        argsSchema: zodToJsonSchema(prompt.input) as any,\n      },\n      async (args: any, _extra: any): Promise<GetPromptResult> => {\n        const link = (tpl: string, vars: Record<string, string | number>) => {\n          let out = tpl;\n          for (const [k, v] of Object.entries(vars))\n            out = out.replace(\n              new RegExp(`\\\\{${k}\\\\}`, 'g'),\n              encodeURIComponent(String(v))\n            );\n          return out;\n        };\n\n        const parts = await prompt.render(prompt.input.parse(args), {\n          ...ctxFactories.promptCtx(),\n          link,\n        });\n\n        // MCP prompt shape: messages[{role, content[]}]; we return a single \"system\" text chunk + referenced resources\n        const contents: GetPromptResult['messages'][number]['content'][] =\n          parts.map(\n            (p) =>\n              p.type === 'text'\n                ? { type: 'text', text: p.text }\n                : {\n                    type: 'text',\n                    text: `See resource: ${p.title ?? p.uri}\\nURI: ${p.uri}`,\n                  } // simple way to reference; clients may fetch resources directly\n          );\n\n        return {\n          messages: [{ role: 'assistant', content: contents[0]! }],\n          description: prompt.meta.description,\n        };\n      }\n    );\n  }\n\n  return server;\n}\n"],"mappings":"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"}

package/dist/server/rest-elysia.d.ts

@@ -0,0 +1,41 @@
+import { HandlerCtx } from "../types.js";
+import { SpecRegistry } from "../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: SpecRegistry, ctxFactory: (c: {
+  request: Request;
+  store: any;
+}) => 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 };
+//# sourceMappingURL=rest-elysia.d.ts.map

package/dist/server/rest-elysia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-elysia.d.ts","names":[],"sources":["../../src/server/rest-elysia.ts"],"sourcesContent":[],"mappings":";;;;;;;iBAMgB,YAAA,MACT,aACA;EAFS,OAAA,EAGa,OAHD;EACrB,KAAA,EAAA,GAAA;CACA,EAAA,GACgD,UADhD,EAAA,OAAA,CAAA,EAEK,WAFL,CAAA,EAEgB,MAFhB,CAAA,EAAA,EAAA;EACsB,SAAA,EAAA,CAAA,CAAA;EAA0B,KAAA,EAAA,CAAA,CAAA;EAC3C,MAAA,EAAA,CAAA,CAAA;EAAW,OAAA,EAAA,CAAA,CAAA;CAAA,EAAA"}

package/dist/server/rest-elysia.js

@@ -0,0 +1,2 @@
+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};
+//# sourceMappingURL=rest-elysia.js.map

package/dist/server/rest-elysia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-elysia.js","names":[],"sources":["../../src/server/rest-elysia.ts"],"sourcesContent":["import type { Elysia } from 'elysia';\nimport { createFetchHandler, type RestOptions } from './rest-generic';\nimport type { SpecRegistry } from '../registry';\nimport type { HandlerCtx } from '../types';\n\n/** Mount routes on an Elysia instance */\nexport function elysiaPlugin(\n  app: Elysia,\n  reg: SpecRegistry,\n  ctxFactory: (c: { request: Request; store: any }) => HandlerCtx,\n  options?: RestOptions\n) {\n  const handler = createFetchHandler(\n    reg,\n    (req) => ctxFactory({ request: req, store: (app as any).store }),\n    options\n  );\n\n  for (const spec of reg.listSpecs()) {\n    const method =\n      spec.transport?.rest?.method ??\n      (spec.meta.kind === 'query' ? 'GET' : 'POST');\n    const path =\n      (options?.basePath ?? '') +\n      (spec.transport?.rest?.path ??\n        `/${spec.meta.name.replace(/\\./g, '/')}/v${spec.meta.version}`);\n    app[method.toLowerCase() as 'get' | 'post'](path, ({ request }: any) =>\n      handler(request)\n    );\n  }\n\n  if (options?.cors) {\n    app.options('*', ({ request }: any) => handler(request));\n  }\n\n  return app;\n}\n"],"mappings":"uDAMA,SAAgB,EACd,EACA,EACA,EACA,EACA,CACA,IAAM,EAAU,EACd,EACC,GAAQ,EAAW,CAAE,QAAS,EAAK,MAAQ,EAAY,MAAO,CAAC,CAChE,EACD,CAED,IAAK,IAAM,KAAQ,EAAI,WAAW,CAAE,CAClC,IAAM,EACJ,EAAK,WAAW,MAAM,SACrB,EAAK,KAAK,OAAS,QAAU,MAAQ,QAClC,GACH,GAAS,UAAY,KACrB,EAAK,WAAW,MAAM,MACrB,IAAI,EAAK,KAAK,KAAK,QAAQ,MAAO,IAAI,CAAC,IAAI,EAAK,KAAK,WACzD,EAAI,EAAO,aAAa,EAAoB,GAAO,CAAE,aACnD,EAAQ,EAAQ,CACjB,CAOH,OAJI,GAAS,MACX,EAAI,QAAQ,KAAM,CAAE,aAAmB,EAAQ,EAAQ,CAAC,CAGnD"}

package/dist/server/rest-express.d.ts

@@ -0,0 +1,17 @@
+import { HandlerCtx } from "../types.js";
+import { SpecRegistry } from "../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: SpecRegistry, ctxFactory: (req: Request) => HandlerCtx, options?: RestOptions): Router;
+//#endregion
+export { expressRouter };
+//# sourceMappingURL=rest-express.d.ts.map

package/dist/server/rest-express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-express.d.ts","names":[],"sources":["../../src/server/rest-express.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAaA;;AAEO,iBAFS,aAAA,CAET,OAAA,EAAA;EACa,MAAA,EAAA,GAAA,GAFO,MAEP;CAAe,EAAA,GAAA,EAD5B,YAC4B,EAAA,UAAA,EAAA,CAAA,GAAA,EAAf,OAAe,EAAA,GAAA,UAAA,EAAA,OAAA,CAAA,EACvB,WADuB,CAAA,EAEhC,MAFgC"}

package/dist/server/rest-express.js

@@ -0,0 +1,2 @@
+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};
+//# sourceMappingURL=rest-express.js.map

package/dist/server/rest-express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-express.js","names":[],"sources":["../../src/server/rest-express.ts"],"sourcesContent":["import type {\n  Request as ExpressReq,\n  Response as ExpressRes,\n  Router,\n} from 'express';\nimport { createFetchHandler, type RestOptions } from './rest-generic';\nimport type { SpecRegistry } from '../registry';\nimport type { HandlerCtx } from '../types';\n\n/**\n * Build an Express Router that proxies to the Fetch-style handler.\n * You can mount it at any base path; pass the same basePath in options.\n */\nexport function expressRouter(\n  express: { Router: () => Router },\n  reg: SpecRegistry,\n  ctxFactory: (req: ExpressReq) => HandlerCtx,\n  options?: RestOptions\n): Router {\n  const router = express.Router();\n  const fetchHandler = createFetchHandler(\n    reg,\n    (_r) => {\n      // Convert Fetch Request headers -> Express req is provided below\n      // We pass the Express req directly via closure\n      throw new Error('ctxFactory must be called from route'); // placeholder\n    },\n    options\n  );\n\n  // For each spec, create a concrete route so Express can match quickly\n  for (const spec of reg.listSpecs()) {\n    const method =\n      spec.transport?.rest?.method ??\n      (spec.meta.kind === 'query' ? 'GET' : 'POST');\n    const path =\n      (options?.basePath ?? '') +\n      (spec.transport?.rest?.path ??\n        `/${spec.meta.name.replace(/\\./g, '/')}/v${spec.meta.version}`);\n\n    router[method.toLowerCase() as 'get' | 'post'](\n      path,\n      async (req: ExpressReq, res: ExpressRes) => {\n        const url = new URL(\n          `${req.protocol}://${req.get('host')}${req.originalUrl}`\n        );\n        const request = new Request(url.toString(), {\n          method,\n          headers: Object.fromEntries(\n            Object.entries(req.headers).map(([k, v]) => [k, String(v)])\n          ),\n          body: method === 'POST' ? JSON.stringify(req.body ?? {}) : undefined,\n        });\n\n        const handler = createFetchHandler(reg, () => ctxFactory(req), options);\n        const response = await handler(request);\n\n        res.status(response.status);\n        response.headers.forEach((v, k) => res.setHeader(k, v));\n        const text = await response.text();\n        res.send(text);\n      }\n    );\n  }\n\n  // Generic OPTIONS for CORS (if enabled)\n  if (options?.cors) {\n    router.options('*', (_req, res) => {\n      const h = new Headers();\n      const resp = new Response(null, { status: 204 });\n      resp.headers.forEach((v, k) => h.set(k, v));\n      res.status(204).send();\n    });\n  }\n\n  return router;\n}\n"],"mappings":"uDAaA,SAAgB,EACd,EACA,EACA,EACA,EACQ,CACR,IAAM,EAAS,EAAQ,QAAQ,CACV,EACnB,EACC,GAAO,CAGN,MAAU,MAAM,uCAAuC,EAEzD,EACD,CAGD,IAAK,IAAM,KAAQ,EAAI,WAAW,CAAE,CAClC,IAAM,EACJ,EAAK,WAAW,MAAM,SACrB,EAAK,KAAK,OAAS,QAAU,MAAQ,QAClC,GACH,GAAS,UAAY,KACrB,EAAK,WAAW,MAAM,MACrB,IAAI,EAAK,KAAK,KAAK,QAAQ,MAAO,IAAI,CAAC,IAAI,EAAK,KAAK,WAEzD,EAAO,EAAO,aAAa,EACzB,EACA,MAAO,EAAiB,IAAoB,CAC1C,IAAM,EAAM,IAAI,IACd,GAAG,EAAI,SAAS,KAAK,EAAI,IAAI,OAAO,GAAG,EAAI,cAC5C,CACK,EAAU,IAAI,QAAQ,EAAI,UAAU,CAAE,CAC1C,SACA,QAAS,OAAO,YACd,OAAO,QAAQ,EAAI,QAAQ,CAAC,KAAK,CAAC,EAAG,KAAO,CAAC,EAAG,OAAO,EAAE,CAAC,CAAC,CAC5D,CACD,KAAM,IAAW,OAAS,KAAK,UAAU,EAAI,MAAQ,EAAE,CAAC,CAAG,IAAA,GAC5D,CAAC,CAGI,EAAW,MADD,EAAmB,MAAW,EAAW,EAAI,CAAE,EAAQ,CACxC,EAAQ,CAEvC,EAAI,OAAO,EAAS,OAAO,CAC3B,EAAS,QAAQ,SAAS,EAAG,IAAM,EAAI,UAAU,EAAG,EAAE,CAAC,CACvD,IAAM,EAAO,MAAM,EAAS,MAAM,CAClC,EAAI,KAAK,EAAK,EAEjB,CAaH,OATI,GAAS,MACX,EAAO,QAAQ,KAAM,EAAM,IAAQ,CACjC,IAAM,EAAI,IAAI,QACD,IAAI,SAAS,KAAM,CAAE,OAAQ,IAAK,CAAC,CAC3C,QAAQ,SAAS,EAAG,IAAM,EAAE,IAAI,EAAG,EAAE,CAAC,CAC3C,EAAI,OAAO,IAAI,CAAC,MAAM,EACtB,CAGG"}

package/dist/server/rest-generic.d.ts

@@ -0,0 +1,33 @@
+import { HandlerCtx } from "../types.js";
+import { SpecRegistry } from "../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: any;
+  };
+}
+/**
+ * Build a single Fetch-style handler: (req) => Response
+ * - Discovers routes from SpecRegistry
+ * - Validates with zod via registry.execute()
+ * - Handles CORS (optional)
+ */
+declare function createFetchHandler(reg: SpecRegistry, ctxFactory: (req: Request) => HandlerCtx, options?: RestOptions): (req: Request) => Promise<Response>;
+//#endregion
+export { RestOptions, createFetchHandler };
+//# sourceMappingURL=rest-generic.d.ts.map

package/dist/server/rest-generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-generic.d.ts","names":[],"sources":["../../src/server/rest-generic.ts"],"sourcesContent":[],"mappings":";;;;UAIiB,WAAA;;EAAA,QAAA,CAAA,EAAA,MAAW;EAsDZ;EACT,IAAA,CAAA,EAAA,OAAA,GAAA;IACa,MAAA,CAAA,EAAA,MAAA,GAAA,GAAA;IAAY,OAAA,CAAA,EAAA,MAAA,EAAA;IACpB,OAAA,CAAA,EAAA,MAAA,EAAA;IAiDwB,WAAA,CAAA,EAAA,OAAA;IAAkB,MAAA,CAAA,EAAA,MAAA;EAAR,CAAA;EAAO;;;;;;;;;;;;;;iBApDrC,kBAAA,MACT,gCACa,YAAY,sBACpB,oBAiDwB,YAAU,QAAQ"}

package/dist/server/rest-generic.js

@@ -0,0 +1,2 @@
+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};
+//# sourceMappingURL=rest-generic.js.map

package/dist/server/rest-generic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-generic.js","names":["h: Record<string, string>","opts: Required<Omit<RestOptions, 'onError'>> &\n    Pick<RestOptions, 'onError'>","routes: Route[]","base: HeadersInit","headers: HeadersInit","input: any","obj: Record<string, any>","err: any","headers"],"sources":["../../src/server/rest-generic.ts"],"sourcesContent":["import { defaultRestPath } from '../jsonschema';\nimport type { SpecRegistry } from '../registry';\nimport type { HandlerCtx } from '../types';\n\nexport interface RestOptions {\n  /** Prefix all routes, e.g. \"/api\" */\n  basePath?: string;\n  /** If true, handle OPTIONS and set CORS headers */\n  cors?:\n    | boolean\n    | {\n        origin?: string | '*';\n        methods?: string[];\n        headers?: string[];\n        credentials?: boolean;\n        maxAge?: number;\n      };\n  /** JSON spacing in responses (dev only ideally) */\n  prettyJson?: number | false;\n  /** Map thrown errors to {status, body} */\n  onError?: (err: unknown) => { status: number; body: any };\n}\n\n/** Minimal WHATWG Response polyfill util for Node < 18 (if needed) */\n// export const toResponse = (status: number, data: any, headers?: HeadersInit) =>\n//   new Response(JSON.stringify(data), { status, headers: { \"content-type\": \"application/json; charset=utf-8\", ...(headers || {}) } });\n\nfunction corsHeaders(opt: NonNullable<RestOptions['cors']>) {\n  const h: Record<string, string> = {};\n  const origin = typeof opt === 'object' ? (opt.origin ?? '*') : '*';\n  h['access-control-allow-origin'] = origin as string;\n  h['vary'] = 'Origin';\n  if (typeof opt === 'object') {\n    if (opt.methods) h['access-control-allow-methods'] = opt.methods.join(', ');\n    if (opt.headers) h['access-control-allow-headers'] = opt.headers.join(', ');\n    if (opt.credentials) h['access-control-allow-credentials'] = 'true';\n    if (typeof opt.maxAge === 'number')\n      h['access-control-max-age'] = String(opt.maxAge);\n  } else {\n    h['access-control-allow-methods'] = 'GET,POST,OPTIONS';\n    h['access-control-allow-headers'] =\n      'content-type,x-idempotency-key,x-trace-id';\n  }\n  return h;\n}\n\nfunction joinPath(a: string | undefined, b: string) {\n  const left = (a ?? '').replace(/\\/+$/g, '');\n  const right = b.replace(/^\\/+/g, '');\n  return `${left}/${right}`.replace(/\\/{2,}/g, '/');\n}\n\n/**\n * Build a single Fetch-style handler: (req) => Response\n * - Discovers routes from SpecRegistry\n * - Validates with zod via registry.execute()\n * - Handles CORS (optional)\n */\nexport function createFetchHandler(\n  reg: SpecRegistry,\n  ctxFactory: (req: Request) => HandlerCtx,\n  options?: RestOptions\n) {\n  const opts: Required<Omit<RestOptions, 'onError'>> &\n    Pick<RestOptions, 'onError'> = {\n    basePath: options?.basePath ?? '',\n    cors: options?.cors ?? false,\n    prettyJson: options?.prettyJson ?? false,\n    onError: options?.onError,\n  };\n\n  interface Route {\n    method: 'GET' | 'POST';\n    path: string; // absolute path including basePath\n    name: string;\n    version: number;\n  }\n\n  const routes: Route[] = reg.listSpecs().map((spec) => ({\n    method: (spec.transport?.rest?.method ??\n      (spec.meta.kind === 'query' ? 'GET' : 'POST')) as 'GET' | 'POST',\n    path: joinPath(\n      opts.basePath,\n      spec.transport?.rest?.path ??\n        defaultRestPath(spec.meta.name, spec.meta.version)\n    ),\n    name: spec.meta.name,\n    version: spec.meta.version,\n  }));\n\n  const routeTable = new Map<string, Route>(); // KEY: METHOD + \" \" + PATH\n  for (const r of routes) routeTable.set(`${r.method} ${r.path}`, r);\n\n  const allowHeader = Array.from(new Set(routes.map((r) => r.method))).join(\n    ', '\n  );\n\n  const makeJson = (status: number, data: any, extraHeaders?: HeadersInit) => {\n    const body = opts.prettyJson\n      ? JSON.stringify(data, null, opts.prettyJson)\n      : JSON.stringify(data);\n    const base: HeadersInit = {\n      'content-type': 'application/json; charset=utf-8',\n    };\n    return new Response(body, {\n      status,\n      headers: extraHeaders ? { ...base, ...extraHeaders } : base,\n    });\n  };\n\n  return async function handle(req: Request): Promise<Response> {\n    const url = new URL(req.url);\n    const key = `${req.method.toUpperCase()} ${url.pathname}`;\n\n    // CORS preflight\n    if (opts.cors && req.method.toUpperCase() === 'OPTIONS') {\n      const h = corsHeaders(opts.cors === true ? {} : opts.cors);\n      return new Response(null, {\n        status: 204,\n        headers: { ...h, 'content-length': '0' },\n      });\n    }\n\n    const route = routeTable.get(key);\n    if (!route) {\n      const headers: HeadersInit = {};\n      if (opts.cors)\n        Object.assign(\n          headers,\n          corsHeaders(opts.cors === true ? {} : opts.cors)\n        );\n      return makeJson(404, { error: 'NotFound', path: url.pathname }, headers);\n    }\n\n    try {\n      let input: any = {};\n      if (route.method === 'GET') {\n        // Support either flattened query (?a=1&b=x) or ?input=<json>\n        if (url.searchParams.has('input')) {\n          const raw = url.searchParams.get('input')!;\n          input = raw ? JSON.parse(raw) : {};\n        } else {\n          const obj: Record<string, any> = {};\n          for (const [k, v] of url.searchParams.entries()) obj[k] = v;\n          input = obj;\n        }\n      } else {\n        const contentType = req.headers.get('content-type') || '';\n        if (contentType.includes('application/json')) {\n          input = await req.json();\n        } else if (contentType.includes('application/x-www-form-urlencoded')) {\n          const form = (await req.formData()) as never as FormData;\n          input = Object.fromEntries(form.entries());\n        } else if (!contentType) {\n          input = {};\n        } else {\n          return makeJson(415, { error: 'UnsupportedMediaType', contentType });\n        }\n      }\n\n      const ctx = ctxFactory(req);\n      const result = await reg.execute(route.name, route.version, input, ctx);\n\n      const headers: HeadersInit = {};\n      if (opts.cors)\n        Object.assign(\n          headers,\n          corsHeaders(opts.cors === true ? {} : opts.cors)\n        );\n      return makeJson(200, result, headers);\n    } catch (err: any) {\n      if (opts.onError) {\n        const mapped = opts.onError(err);\n        const headers: HeadersInit = {};\n        if (opts.cors)\n          Object.assign(\n            headers,\n            corsHeaders(opts.cors === true ? {} : opts.cors)\n          );\n        return makeJson(mapped.status, mapped.body, headers);\n      }\n      const headers: HeadersInit = {};\n      if (opts.cors)\n        Object.assign(\n          headers,\n          corsHeaders(opts.cors === true ? {} : opts.cors)\n        );\n      // Basic zod hint\n      if (err?.issues)\n        return makeJson(\n          400,\n          { error: 'ValidationError', issues: err.issues },\n          headers\n        );\n      if (\n        typeof err?.message === 'string' &&\n        err.message.startsWith('PolicyDenied')\n      ) {\n        return makeJson(403, { error: 'PolicyDenied' }, headers);\n      }\n      return makeJson(500, { error: 'InternalError' }, headers);\n    }\n  };\n}\n"],"mappings":"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"}

package/dist/server/rest-next-app.d.ts

@@ -0,0 +1,36 @@
+import { HandlerCtx } from "../types.js";
+import { SpecRegistry } from "../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 `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 };
+ * ```
+ */
+declare function makeNextAppHandler(reg: SpecRegistry, ctxFactory: (req: Request) => HandlerCtx, options?: RestOptions): (req: Request) => Promise<Response>;
+//#endregion
+export { makeNextAppHandler };
+//# sourceMappingURL=rest-next-app.d.ts.map

package/dist/server/rest-next-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-next-app.d.ts","names":[],"sources":["../../src/server/rest-next-app.ts"],"sourcesContent":[],"mappings":";;;;;;;;AA8BA;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,kBAAA,MACT,gCACa,YAAY,sBACpB,oBAGgC,YAAO,QAAA"}

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

@@ -0,0 +1,2 @@
+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};
+//# sourceMappingURL=rest-next-app.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rest-next-app.js","names":[],"sources":["../../src/server/rest-next-app.ts"],"sourcesContent":["import { createFetchHandler, type RestOptions } from './rest-generic';\nimport type { SpecRegistry } from '../registry';\nimport type { HandlerCtx } from '../types';\n\n/**\n * Creates a Next.js App Router route handler for ContractSpec operations.\n *\n * This function returns a handler suitable for `export const { GET, POST }` in a `route.ts` file.\n * It handles:\n * - Path parsing to determine the operation name and version.\n * - Body parsing (JSON).\n * - Context creation via `ctxFactory`.\n * - Execution via `SpecRegistry`.\n * - Response formatting (JSON success/error).\n *\n * @param reg - The SpecRegistry containing the operations.\n * @param ctxFactory - A factory function to build the `HandlerCtx` (e.g., auth, tenant) from the request.\n * @param options - Optional configuration for the REST handler.\n * @returns A function `(req: Request) => Promise<Response>`.\n *\n * @example\n * ```ts\n * // app/api/[...route]/route.ts\n * import { makeNextAppHandler } from '@lssm/lib.contracts/server/rest-next-app';\n * import { registry } from '@/lib/registry';\n *\n * const handler = makeNextAppHandler(registry, (req) => ({ actor: 'anonymous' }));\n * export { handler as GET, handler as POST };\n * ```\n */\nexport function makeNextAppHandler(\n  reg: SpecRegistry,\n  ctxFactory: (req: Request) => HandlerCtx,\n  options?: RestOptions\n) {\n  const handler = createFetchHandler(reg, ctxFactory, options);\n  return async function requestHandler(req: Request) {\n    return handler(req);\n  };\n}\n"],"mappings":"uDA8BA,SAAgB,EACd,EACA,EACA,EACA,CACA,IAAM,EAAU,EAAmB,EAAK,EAAY,EAAQ,CAC5D,OAAO,eAA8B,EAAc,CACjD,OAAO,EAAQ,EAAI"}

package/dist/server/rest-next-mcp.d.ts

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

package/dist/server/rest-next-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-next-mcp.d.ts","names":[],"sources":["../../src/server/rest-next-mcp.ts"],"sourcesContent":[],"mappings":";;;;iBAYgB,6BAAA,MACT,gCACa;;EAFJ,IAAA,EAAA,CAAA,OAAA,SAAA,EAAA,UAA6B,SAAA,CAAA;EACtC,MAAA,EAAA,CAAA,OAAA,SAAA,EAAA,UAAA,SAAA,CAAA;CACa"}

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

@@ -0,0 +1,2 @@
+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};
+//# sourceMappingURL=rest-next-mcp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rest-next-mcp.js","names":[],"sources":["../../src/server/rest-next-mcp.ts"],"sourcesContent":["import type { SpecRegistry } from '../registry';\nimport type { AnySchemaModel } from '@lssm/lib.schema';\nimport type { ContractSpec } from '../spec';\nimport type { HandlerCtx } from '../types';\nimport { createMcpHandler } from 'mcp-handler';\nimport type {\n  ReadResourceTemplateCallback,\n  ToolCallback,\n} from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { defaultMcpTool, jsonSchemaForSpec } from '../jsonschema';\n\nexport function makeNextMcpServerFromRegistry(\n  reg: SpecRegistry,\n  ctxFactory: () => HandlerCtx\n) {\n  const handler = createMcpHandler(\n    (server) => {\n      for (const spec of reg.listSpecs()) {\n        const { input, output, meta } = jsonSchemaForSpec(\n          spec as unknown as ContractSpec<AnySchemaModel, AnySchemaModel>\n        );\n\n        if (meta.kind === 'query') {\n          const resourceName =\n            spec.transport?.mcp?.toolName ??\n            defaultMcpTool(spec.meta.name, spec.meta.version);\n\n          (server as any).registerResource(\n            resourceName,\n            new ResourceTemplate('users://{userId}/profile', {\n              list: undefined,\n            }),\n            {\n              // name: resourceName,\n              description: spec.meta.description,\n              inputSchema: input,\n            },\n            (async (uri: URL, args, _req) => {\n              const result = await reg.execute(\n                spec.meta.name,\n                spec.meta.version,\n                args ?? {},\n                ctxFactory()\n              );\n              // return { content: [{ type: 'json', json: result }] };\n              return { contents: [{ uri: uri.href, text: String(result) }] };\n            }) as ReadResourceTemplateCallback\n          );\n        } else if (meta.kind === 'command') {\n          const toolName =\n            spec.transport?.mcp?.toolName ??\n            defaultMcpTool(spec.meta.name, spec.meta.version);\n\n          server.registerTool(\n            toolName,\n            {\n              // name: toolName,\n              description: spec.meta.description,\n              inputSchema: input as any,\n            },\n            (async (args: any, _req: any) => {\n              const result = await reg.execute(\n                spec.meta.name,\n                spec.meta.version,\n                args ?? {},\n                ctxFactory()\n              );\n              // return { content: [{ type: 'json', json: result }] };\n              return { content: [{ type: 'text', text: String(result) }] };\n            }) as ToolCallback\n          );\n        } else {\n          throw new Error(`Unsupported kind: ${meta.kind}`);\n        }\n      }\n    },\n    {},\n    { basePath: '/api' }\n  );\n\n  return { GET: handler, POST: handler, DELETE: handler };\n}\n"],"mappings":"mMAYA,SAAgB,EACd,EACA,EACA,CACA,IAAM,EAAU,EACb,GAAW,CACV,IAAK,IAAM,KAAQ,EAAI,WAAW,CAAE,CAClC,GAAM,CAAE,QAAO,SAAQ,QAAS,EAC9B,EACD,CAED,GAAI,EAAK,OAAS,QAAS,CACzB,IAAM,EACJ,EAAK,WAAW,KAAK,UACrB,EAAe,EAAK,KAAK,KAAM,EAAK,KAAK,QAAQ,CAElD,EAAe,iBACd,EACA,IAAI,EAAiB,2BAA4B,CAC/C,KAAM,IAAA,GACP,CAAC,CACF,CAEE,YAAa,EAAK,KAAK,YACvB,YAAa,EACd,EACA,MAAO,EAAU,EAAM,IAAS,CAC/B,IAAM,EAAS,MAAM,EAAI,QACvB,EAAK,KAAK,KACV,EAAK,KAAK,QACV,GAAQ,EAAE,CACV,GAAY,CACb,CAED,MAAO,CAAE,SAAU,CAAC,CAAE,IAAK,EAAI,KAAM,KAAM,OAAO,EAAO,CAAE,CAAC,CAAE,GAEjE,SACQ,EAAK,OAAS,UAAW,CAClC,IAAM,EACJ,EAAK,WAAW,KAAK,UACrB,EAAe,EAAK,KAAK,KAAM,EAAK,KAAK,QAAQ,CAEnD,EAAO,aACL,EACA,CAEE,YAAa,EAAK,KAAK,YACvB,YAAa,EACd,EACA,MAAO,EAAW,IAAc,CAC/B,IAAM,EAAS,MAAM,EAAI,QACvB,EAAK,KAAK,KACV,EAAK,KAAK,QACV,GAAQ,EAAE,CACV,GAAY,CACb,CAED,MAAO,CAAE,QAAS,CAAC,CAAE,KAAM,OAAQ,KAAM,OAAO,EAAO,CAAE,CAAC,CAAE,GAE/D,MAED,MAAU,MAAM,qBAAqB,EAAK,OAAO,GAIvD,EAAE,CACF,CAAE,SAAU,OAAQ,CACrB,CAED,MAAO,CAAE,IAAK,EAAS,KAAM,EAAS,OAAQ,EAAS"}

package/dist/server/rest-next-pages.d.ts

@@ -0,0 +1,10 @@
+import { HandlerCtx } from "../types.js";
+import { SpecRegistry } from "../registry.js";
+import { RestOptions } from "./rest-generic.js";
+import { NextApiRequest, NextApiResponse } from "next";
+
+//#region src/server/rest-next-pages.d.ts
+declare function makeNextPagesHandler(reg: SpecRegistry, ctxFactory: (req: NextApiRequest) => HandlerCtx, options?: RestOptions): (req: NextApiRequest, res: NextApiResponse) => Promise<void>;
+//#endregion
+export { makeNextPagesHandler };
+//# sourceMappingURL=rest-next-pages.d.ts.map

package/dist/server/rest-next-pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-next-pages.d.ts","names":[],"sources":["../../src/server/rest-next-pages.ts"],"sourcesContent":[],"mappings":";;;;;;iBAKgB,oBAAA,MACT,gCACa,mBAAmB,sBAC3B,oBAUyB,qBAAqB,oBAAe"}

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

@@ -0,0 +1,2 @@
+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};
+//# sourceMappingURL=rest-next-pages.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rest-next-pages.js","names":[],"sources":["../../src/server/rest-next-pages.ts"],"sourcesContent":["import type { NextApiRequest, NextApiResponse } from 'next';\nimport { createFetchHandler, type RestOptions } from './rest-generic';\nimport type { SpecRegistry } from '../registry';\nimport type { HandlerCtx } from '../types';\n\nexport function makeNextPagesHandler(\n  reg: SpecRegistry,\n  ctxFactory: (req: NextApiRequest) => HandlerCtx,\n  options?: RestOptions\n) {\n  const fetchHandler = createFetchHandler(\n    reg,\n    (_req: Request) => {\n      throw new Error('Use per-request wrapper'); // we wrap below\n    },\n    options\n  );\n\n  return async function handler(req: NextApiRequest, res: NextApiResponse) {\n    const url = `${req.headers['x-forwarded-proto'] ?? 'http'}://${req.headers.host}${req.url}`;\n    const method = req.method?.toUpperCase() || 'GET';\n\n    const request = new Request(url, {\n      method,\n      headers: Object.fromEntries(\n        Object.entries(req.headers).map(([k, v]) => [k, String(v)])\n      ),\n      body: method === 'POST' ? JSON.stringify(req.body ?? {}) : undefined,\n    });\n\n    const perReqHandler = createFetchHandler(\n      reg,\n      () => ctxFactory(req),\n      options\n    );\n    const response = await perReqHandler(request);\n\n    res.status(response.status);\n    response.headers.forEach((v, k) => res.setHeader(k, v));\n    const text = await response.text();\n    res.send(text);\n  };\n}\n"],"mappings":"uDAKA,SAAgB,EACd,EACA,EACA,EACA,CASA,OARqB,EACnB,EACC,GAAkB,CACjB,MAAU,MAAM,0BAA0B,EAE5C,EACD,CAEM,eAAuB,EAAqB,EAAsB,CACvE,IAAM,EAAM,GAAG,EAAI,QAAQ,sBAAwB,OAAO,KAAK,EAAI,QAAQ,OAAO,EAAI,MAChF,EAAS,EAAI,QAAQ,aAAa,EAAI,MAEtC,EAAU,IAAI,QAAQ,EAAK,CAC/B,SACA,QAAS,OAAO,YACd,OAAO,QAAQ,EAAI,QAAQ,CAAC,KAAK,CAAC,EAAG,KAAO,CAAC,EAAG,OAAO,EAAE,CAAC,CAAC,CAC5D,CACD,KAAM,IAAW,OAAS,KAAK,UAAU,EAAI,MAAQ,EAAE,CAAC,CAAG,IAAA,GAC5D,CAAC,CAOI,EAAW,MALK,EACpB,MACM,EAAW,EAAI,CACrB,EACD,CACoC,EAAQ,CAE7C,EAAI,OAAO,EAAS,OAAO,CAC3B,EAAS,QAAQ,SAAS,EAAG,IAAM,EAAI,UAAU,EAAG,EAAE,CAAC,CACvD,IAAM,EAAO,MAAM,EAAS,MAAM,CAClC,EAAI,KAAK,EAAK"}

package/dist/spec.d.ts

@@ -0,0 +1,172 @@
+import { Owner, Stability, Tag } from "./ownership.js";
+import { EventSpec } from "./events.js";
+import { ResourceRefDescriptor } from "./resources.js";
+import { PolicyRef } from "./policy/spec.js";
+import { TestSpecRef } from "./tests/spec.js";
+import { AnySchemaModel } from "@lssm/lib.schema";
+
+//#region src/spec.d.ts
+
+/**
+ * Distinguishes between state-changing operations (command) and read-only operations (query).
+ */
+type OpKind = 'command' | 'query';
+interface EmitDeclRef {
+  ref: EventSpec<AnySchemaModel>;
+  when: string;
+}
+interface EmitDeclInline {
+  name: string;
+  version: number;
+  when: string;
+  payload: AnySchemaModel;
+}
+/**
+ * Declaration of an event that an operation may emit.
+ * Can be a reference to an `EventSpec` or an inline definition.
+ */
+type EmitDecl = EmitDeclRef | EmitDeclInline;
+declare const isEmitDeclRef: (e: EmitDecl) => e is EmitDeclRef;
+interface TelemetryTrigger {
+  event: {
+    name: string;
+    version?: number;
+  };
+  properties?: (args: {
+    input: unknown;
+    output?: unknown;
+    error?: unknown;
+  }) => Record<string, unknown>;
+}
+/**
+ * The core specification interface for any operation (Command or Query).
+ *
+ * @template Input - The Zod-backed schema model for the input payload.
+ * @template Output - The Zod-backed schema model for the output payload, or a resource reference.
+ * @template Events - Tuple of events that this operation may emit.
+ */
+interface ContractSpec<Input extends AnySchemaModel, Output extends AnySchemaModel | ResourceRefDescriptor<boolean>, Events extends readonly EmitDecl[] | undefined = readonly EmitDecl[] | undefined> {
+  meta: {
+    /** Fully-qualified op name (e.g., "sigil.beginSignup") */
+    name: string;
+    /** Breaking changes => bump version */
+    version: number;
+    /** "command" changes state; "query" is read-only/idempotent */
+    kind: OpKind;
+    /** Lifecycle marker for comms & tooling */
+    stability: Stability;
+    /** Owners for CODEOWNERS / on-call / approvals */
+    owners: Owner[];
+    /** Search tags, grouping, docs navigation */
+    tags: Tag[];
+    /** Short human-friendly summary */
+    description: string;
+    /** Business goal: why this exists */
+    goal: string;
+    /** Background, constraints, scope edges (feeds docs & LLM context) */
+    context: string;
+  };
+  io: {
+    /** Zod schema for input payload */
+    input: Input | null;
+    /** Zod schema for output payload */
+    output: Output;
+    /** Named, typed errors this op may throw (optional) */
+    errors?: Record<string, {
+      description: string;
+      http?: number;
+      gqlCode?: string;
+      when: string;
+    }>;
+  };
+  policy: {
+    /** Minimal auth category allowed to call this op */
+    auth: 'anonymous' | 'user' | 'admin';
+    /** Idempotency hint. Queries default true; commands default false. */
+    idempotent?: boolean;
+    /** Soft rate limit suggestion; adapter enforces via limiter */
+    rateLimit?: {
+      rpm: number;
+      key: 'user' | 'org' | 'global';
+    };
+    /** Feature flags that must be ON for this op to run */
+    flags?: string[];
+    /** Whether a human must approve before action (e.g., risky commands) */
+    escalate?: 'human_review' | null;
+    /** JSONPath-like pointers to redact from logs/prompts */
+    pii?: string[];
+    /** Referenced policy specs governing access */
+    policies?: PolicyRef[];
+    /** Field-level overrides referencing policy specs */
+    fieldPolicies?: {
+      field: string;
+      actions: ('read' | 'write')[];
+      policy?: PolicyRef;
+    }[];
+  };
+  sideEffects?: {
+    /** Declared events this op may emit; runtime will guard against others */
+    emits?: Events;
+    /** Analytics intents (names); the service decides the sink */
+    analytics?: string[];
+    /** Audit intents (labels); the service decides storage */
+    audit?: string[];
+  };
+  telemetry?: {
+    success?: TelemetryTrigger;
+    failure?: TelemetryTrigger;
+  };
+  tests?: TestSpecRef[];
+  transport?: {
+    rest?: {
+      /** Override HTTP method (default: POST for commands, GET for queries) */
+      method?: 'GET' | 'POST';
+      /** Override path (default derived from meta.name/version) */
+      path?: string;
+    };
+    gql?: {
+      /** Override field name (default: dots→underscores + _vN) */
+      field?: string;
+      returns?: string;
+    };
+    mcp?: {
+      /** Override tool identifier (default: "<name>.v<version>") */
+      toolName?: string;
+    };
+  };
+  acceptance?: {
+    /** Gherkin-lite scenarios for docs & auto tests */
+    scenarios?: {
+      name: string;
+      given: string[];
+      when: string[];
+      then: string[];
+    }[];
+    /** Request/response examples (used for docs & snapshot tests) */
+    examples?: {
+      name: string;
+      input: unknown;
+      output: unknown;
+    }[];
+  };
+}
+type AnyContractSpec = ContractSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>;
+/**
+ * Helper to define a Command (write operation).
+ * Sets `kind: 'command'` and defaults `idempotent: false`.
+ */
+declare const defineCommand: <I extends AnySchemaModel, O extends AnySchemaModel | ResourceRefDescriptor<boolean>, E extends readonly EmitDecl[] | undefined = undefined>(spec: Omit<ContractSpec<I, O, E>, "meta" | "policy"> & {
+  meta: Omit<ContractSpec<I, O, E>["meta"], "kind">;
+  policy: Omit<ContractSpec<I, O, E>["policy"], "idempotent">;
+}) => ContractSpec<I, O, E>;
+/**
+ * Helper to define a Query (read-only operation).
+ * Sets `kind: 'query'` and forces `idempotent: true`.
+ */
+declare const defineQuery: <I extends AnySchemaModel, O extends AnySchemaModel | ResourceRefDescriptor<boolean>, E extends readonly EmitDecl[] | undefined = undefined>(spec: Omit<ContractSpec<I, O, E>, "meta" | "policy"> & {
+  meta: Omit<ContractSpec<I, O, E>["meta"], "kind">;
+  policy: Omit<ContractSpec<I, O, E>["policy"], "idempotent">;
+}) => ContractSpec<I, O, E>;
+//#endregion
+export { AnyContractSpec, ContractSpec, EmitDecl, EmitDeclInline, EmitDeclRef, OpKind, TelemetryTrigger, defineCommand, defineQuery, isEmitDeclRef };
+//# sourceMappingURL=spec.d.ts.map

package/dist/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../src/spec.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAsBA;AAUA;AACA;AAEiB,KArBL,MAAA,GAqBK,SAAgB,GAAA,OAMzB;AAUS,UAlCA,WAAA,CAkCY;EACb,GAAA,EAlCT,SAkCS,CAlCC,cAkCD,CAAA;EACC,IAAA,EAAA,MAAA;;AACS,UAhCT,cAAA,CAgCS;EACX,IAAA,EAAA,MAAA;EASL,OAAA,EAAA,MAAA;EAEK,IAAA,EAAA,MAAA;EAEH,OAAA,EA1CD,cA0CC;;;;;;AA+CG,KAnFH,QAAA,GAAW,WAmFR,GAnFsB,cAmFtB;AAMH,cAxFC,aAwFD,EAAA,CAAA,CAAA,EAxFqB,QAwFrB,EAAA,GAAA,CAAA,IAxFqC,WAwFrC;AAQE,UA9FG,gBAAA,CA8FH;EACA,KAAA,EAAA;IAGJ,IAAA,EAAA,MAAA;IAAW,OAAA,CAAA,EAAA,MAAA;EAmCT,CAAA;EACV,UAAA,CAAA,EAAA,CAAA,IAAA,EAAA;IACA,KAAA,EAAA,OAAA;IAAiB,MAAA,CAAA,EAAA,OAAA;IAFW,KAAA,CAAA,EAAA,OAAA;EAAY,CAAA,EAAA,GA/HlC,MA+HkC,CAAA,MAAA,EAAA,OAAA,CAAA;AAS1C;;;;;;;;AAKa,UAnII,YAmIJ,CAAA,cAlIG,cAkIH,EAAA,eAjII,cAiIJ,GAjIqB,qBAiIrB,CAAA,OAAA,CAAA,EAAA,eAAA,SAhIa,QAgIb,EAAA,GAAA,SAAA,GAAA,SA/HE,QA+HF,EAAA,GAAA,SAAA,CAAA,CAAA;EAAL,IAAA,EAAA;IACoB;IAAG,IAAA,EAAA,MAAA;IAAG;IAAnB,OAAA,EAAA,MAAA;IAAL;IACoB,IAAA,EAxHpB,MAwHoB;IAAG;IAAG,SAAA,EAtHrB,SAsHqB;IAAnB;IAAL,MAAA,EApHA,KAoHA,EAAA;IAEI;IAAG,IAAA,EApHT,GAoHS,EAAA;IAAG;IAAnB,WAAA,EAAA,MAAA;IAAY;IAeF,IAAA,EAAA,MAaX;IAZU;IACA,OAAA,EAAA,MAAA;EAAiB,CAAA;EACR,EAAA,EAAA;IAEK;IAAG,KAAA,EA7HlB,KA6HkB,GAAA,IAAA;IAAG;IAAnB,MAAA,EA3HD,MA2HC;IAAL;IACoB,MAAA,CAAA,EA1Hf,MA0He,CAAA,MAAA,EAAA;MAAG,WAAA,EAAA,MAAA;MAAG,IAAA,CAAA,EAAA,MAAA;MAAnB,OAAA,CAAA,EAAA,MAAA;MAAL,IAAA,EAAA,MAAA;IACoB,CAAA,CAAA;EAAG,CAAA;EAAG,MAAA,EAAA;IAAnB;IAAL,IAAA,EAAA,WAAA,GAAA,MAAA,GAAA,OAAA;IAEI;IAAG,UAAA,CAAA,EAAA,OAAA;IAAG;IAAnB,SAAA,CAAA,EAAA;MAAY,GAAA,EAAA,MAAA;;;;;;;;;;eApGA;;;;;eAKA;;;;;YAMH;;;;;;;cAQE;cACA;;UAGJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmCE,eAAA,GAAkB,aAC5B,gBACA,iBAAiB;;;;;cAON,0BACD,0BACA,iBAAiB,mDACR,0CAEb,KAAK,aAAa,GAAG,GAAG;QACtB,KAAK,aAAa,GAAG,GAAG;UACtB,KAAK,aAAa,GAAG,GAAG;MAEjC,aAAa,GAAG,GAAG;;;;;cAeT,wBACD,0BACA,iBAAiB,mDACR,0CAEb,KAAK,aAAa,GAAG,GAAG;QACtB,KAAK,aAAa,GAAG,GAAG;UACtB,KAAK,aAAa,GAAG,GAAG;MAEjC,aAAa,GAAG,GAAG"}

package/dist/spec.js

@@ -0,0 +1,2 @@
+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};
+//# sourceMappingURL=spec.js.map

package/dist/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","names":[],"sources":["../src/spec.ts"],"sourcesContent":["/**\n * ContractSpec: a single source of truth describing one operation (command/query).\n * It carries narrative context for humans/agents AND machine-typed input/output/policy.\n */\nimport type { EventSpec } from './events';\nimport type { AnySchemaModel } from '@lssm/lib.schema';\nimport type { ResourceRefDescriptor } from './resources';\nimport type { Owner, Stability, Tag } from './ownership';\nimport type { PolicyRef } from './policy/spec';\nimport type { TestSpecRef } from './tests/spec';\n\n/**\n * Distinguishes between state-changing operations (command) and read-only operations (query).\n */\nexport type OpKind = 'command' | 'query';\n\n// preferred: reference a declared event\nexport interface EmitDeclRef {\n  ref: EventSpec<AnySchemaModel>;\n  when: string;\n}\n// inline (fallback)\nexport interface EmitDeclInline {\n  name: string;\n  version: number;\n  when: string;\n  payload: AnySchemaModel;\n}\n/**\n * Declaration of an event that an operation may emit.\n * Can be a reference to an `EventSpec` or an inline definition.\n */\nexport type EmitDecl = EmitDeclRef | EmitDeclInline;\nexport const isEmitDeclRef = (e: EmitDecl): e is EmitDeclRef => 'ref' in e;\n\nexport interface TelemetryTrigger {\n  event: { name: string; version?: number };\n  properties?: (args: {\n    input: unknown;\n    output?: unknown;\n    error?: unknown;\n  }) => Record<string, unknown>;\n}\n\n/**\n * The core specification interface for any operation (Command or Query).\n *\n * @template Input - The Zod-backed schema model for the input payload.\n * @template Output - The Zod-backed schema model for the output payload, or a resource reference.\n * @template Events - Tuple of events that this operation may emit.\n */\nexport interface ContractSpec<\n  Input extends AnySchemaModel,\n  Output extends AnySchemaModel | ResourceRefDescriptor<boolean>,\n  Events extends readonly EmitDecl[] | undefined =\n    | readonly EmitDecl[]\n    | undefined,\n> {\n  meta: {\n    /** Fully-qualified op name (e.g., \"sigil.beginSignup\") */\n    name: string;\n    /** Breaking changes => bump version */\n    version: number;\n    /** \"command\" changes state; \"query\" is read-only/idempotent */\n    kind: OpKind;\n    /** Lifecycle marker for comms & tooling */\n    stability: Stability;\n    /** Owners for CODEOWNERS / on-call / approvals */\n    owners: Owner[];\n    /** Search tags, grouping, docs navigation */\n    tags: Tag[];\n    /** Short human-friendly summary */\n    description: string;\n    /** Business goal: why this exists */\n    goal: string;\n    /** Background, constraints, scope edges (feeds docs & LLM context) */\n    context: string;\n  };\n\n  io: {\n    /** Zod schema for input payload */\n    input: Input | null;\n    /** Zod schema for output payload */\n    output: Output;\n    /** Named, typed errors this op may throw (optional) */\n    errors?: Record<\n      string,\n      {\n        description: string;\n        http?: number; // suggested HTTP status if surfaced over REST\n        gqlCode?: string; // suggested GraphQL error code\n        when: string; // human-readable condition\n      }\n    >;\n  };\n\n  policy: {\n    /** Minimal auth category allowed to call this op */\n    auth: 'anonymous' | 'user' | 'admin';\n    /** Idempotency hint. Queries default true; commands default false. */\n    idempotent?: boolean;\n    /** Soft rate limit suggestion; adapter enforces via limiter */\n    rateLimit?: { rpm: number; key: 'user' | 'org' | 'global' };\n    /** Feature flags that must be ON for this op to run */\n    flags?: string[];\n    /** Whether a human must approve before action (e.g., risky commands) */\n    escalate?: 'human_review' | null;\n    /** JSONPath-like pointers to redact from logs/prompts */\n    pii?: string[];\n    /** Referenced policy specs governing access */\n    policies?: PolicyRef[];\n    /** Field-level overrides referencing policy specs */\n    fieldPolicies?: {\n      field: string;\n      actions: ('read' | 'write')[];\n      policy?: PolicyRef;\n    }[];\n  };\n\n  sideEffects?: {\n    /** Declared events this op may emit; runtime will guard against others */\n    emits?: Events;\n    /** Analytics intents (names); the service decides the sink */\n    analytics?: string[];\n    /** Audit intents (labels); the service decides storage */\n    audit?: string[];\n  };\n\n  telemetry?: {\n    success?: TelemetryTrigger;\n    failure?: TelemetryTrigger;\n  };\n\n  tests?: TestSpecRef[];\n\n  transport?: {\n    rest?: {\n      /** Override HTTP method (default: POST for commands, GET for queries) */\n      method?: 'GET' | 'POST';\n      /** Override path (default derived from meta.name/version) */\n      path?: string;\n    };\n    gql?: {\n      /** Override field name (default: dots→underscores + _vN) */\n      field?: string;\n      returns?: string;\n      // byIdField?: string;\n      // resource?: string;\n    };\n    mcp?: {\n      /** Override tool identifier (default: \"<name>.v<version>\") */\n      toolName?: string;\n    };\n  };\n\n  acceptance?: {\n    /** Gherkin-lite scenarios for docs & auto tests */\n    scenarios?: {\n      name: string;\n      given: string[];\n      when: string[];\n      then: string[];\n    }[];\n    /** Request/response examples (used for docs & snapshot tests) */\n    examples?: { name: string; input: unknown; output: unknown }[];\n  };\n}\n\nexport type AnyContractSpec = ContractSpec<\n  AnySchemaModel,\n  AnySchemaModel | ResourceRefDescriptor<boolean>\n>;\n\n/**\n * Helper to define a Command (write operation).\n * Sets `kind: 'command'` and defaults `idempotent: false`.\n */\nexport const defineCommand = <\n  I extends AnySchemaModel,\n  O extends AnySchemaModel | ResourceRefDescriptor<boolean>,\n  E extends readonly EmitDecl[] | undefined = undefined,\n>(\n  spec: Omit<ContractSpec<I, O, E>, 'meta' | 'policy'> & {\n    meta: Omit<ContractSpec<I, O, E>['meta'], 'kind'>;\n    policy: Omit<ContractSpec<I, O, E>['policy'], 'idempotent'>;\n  }\n): ContractSpec<I, O, E> => ({\n  ...spec,\n  meta: { ...spec.meta, kind: 'command' as const },\n  policy: {\n    ...spec.policy,\n    idempotent:\n      (spec.policy as never as ContractSpec<never, never, never>)?.['policy']\n        ?.idempotent ?? false,\n  },\n});\n\n/**\n * Helper to define a Query (read-only operation).\n * Sets `kind: 'query'` and forces `idempotent: true`.\n */\nexport const defineQuery = <\n  I extends AnySchemaModel,\n  O extends AnySchemaModel | ResourceRefDescriptor<boolean>,\n  E extends readonly EmitDecl[] | undefined = undefined,\n>(\n  spec: Omit<ContractSpec<I, O, E>, 'meta' | 'policy'> & {\n    meta: Omit<ContractSpec<I, O, E>['meta'], 'kind'>;\n    policy: Omit<ContractSpec<I, O, E>['policy'], 'idempotent'>;\n  }\n): ContractSpec<I, O, E> => ({\n  ...spec,\n  meta: { ...spec.meta, kind: 'query' as const },\n  policy: { ...spec.policy, idempotent: true },\n});\n"],"mappings":"AAiCA,MAAa,EAAiB,GAAkC,QAAS,EAgJ5D,EAKX,IAI2B,CAC3B,GAAG,EACH,KAAM,CAAE,GAAG,EAAK,KAAM,KAAM,UAAoB,CAChD,OAAQ,CACN,GAAG,EAAK,OACR,WACG,EAAK,QAAwD,QAC1D,YAAc,GACrB,CACF,EAMY,EAKX,IAI2B,CAC3B,GAAG,EACH,KAAM,CAAE,GAAG,EAAK,KAAM,KAAM,QAAkB,CAC9C,OAAQ,CAAE,GAAG,EAAK,OAAQ,WAAY,GAAM,CAC7C"}

package/dist/telemetry/anomaly.d.ts

@@ -0,0 +1,28 @@
+import { TelemetryAnomalyDetectionConfig } from "./spec.js";
+import { TelemetryDispatch } from "./tracker.js";
+
+//#region src/telemetry/anomaly.d.ts
+interface TelemetryAnomalyEvent {
+  dispatch: TelemetryDispatch;
+  threshold: TelemetryAnomalyDetectionConfig;
+  metric: string;
+  value: number | undefined;
+  type: 'min' | 'max';
+}
+interface TelemetryAnomalyMonitorOptions {
+  onAnomaly?: (event: TelemetryAnomalyEvent) => void;
+  now?: () => Date;
+}
+declare class TelemetryAnomalyMonitor {
+  private readonly onAnomaly?;
+  private readonly now;
+  private readonly samples;
+  constructor(options?: TelemetryAnomalyMonitorOptions);
+  observe(dispatch: TelemetryDispatch): void;
+  private extractMetric;
+  private emit;
+  reset(): void;
+}
+//#endregion
+export { TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions };
+//# sourceMappingURL=anomaly.d.ts.map

package/dist/telemetry/anomaly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anomaly.d.ts","names":[],"sources":["../../src/telemetry/anomaly.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,qBAAA;YACL;EADK,SAAA,EAEJ,+BADD;EAOK,MAAA,EAAA,MAAA;EAKJ,KAAA,EAAA,MAAA,GAAA,SAAA;;;UALI,8BAAA;sBACK;cACR;;cAGD,uBAAA;;;;wBAKU;oBAKH"}

package/dist/telemetry/anomaly.js

@@ -0,0 +1,2 @@
+var e=class{onAnomaly;now;samples=new Map;constructor(e={}){this.onAnomaly=e.onAnomaly,this.now=e.now??(()=>new Date)}observe(e){let t=e.definition.anomalyDetection;if(!t?.enabled||!t.thresholds?.length)return;let n=`${e.name}.v${e.version}`,r=(this.samples.get(n)??0)+1;if(this.samples.set(n,r),!(typeof t.minimumSample==`number`&&r<t.minimumSample))for(let n of t.thresholds){let r=this.extractMetric(e,n.metric);typeof r==`number`&&(typeof n.min==`number`&&r<n.min&&this.emit(e,t,n.metric,r,`min`),typeof n.max==`number`&&r>n.max&&this.emit(e,t,n.metric,r,`max`))}}extractMetric(e,t){let n=e.properties[t];if(typeof n==`number`)return n;if(typeof n==`object`&&n&&`value`in n){let e=n.value;return typeof e==`number`?e:void 0}}emit(e,t,n,r,i){this.onAnomaly?.({dispatch:e,threshold:t,metric:n,value:r,type:i})}reset(){this.samples.clear()}};export{e as TelemetryAnomalyMonitor};
+//# sourceMappingURL=anomaly.js.map

package/dist/telemetry/anomaly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anomaly.js","names":[],"sources":["../../src/telemetry/anomaly.ts"],"sourcesContent":["import type { TelemetryDispatch } from './tracker';\nimport type { TelemetryAnomalyDetectionConfig } from './spec';\n\nexport interface TelemetryAnomalyEvent {\n  dispatch: TelemetryDispatch;\n  threshold: TelemetryAnomalyDetectionConfig;\n  metric: string;\n  value: number | undefined;\n  type: 'min' | 'max';\n}\n\nexport interface TelemetryAnomalyMonitorOptions {\n  onAnomaly?: (event: TelemetryAnomalyEvent) => void;\n  now?: () => Date;\n}\n\nexport class TelemetryAnomalyMonitor {\n  private readonly onAnomaly?: (event: TelemetryAnomalyEvent) => void;\n  private readonly now: () => Date;\n  private readonly samples = new Map<string, number>();\n\n  constructor(options: TelemetryAnomalyMonitorOptions = {}) {\n    this.onAnomaly = options.onAnomaly;\n    this.now = options.now ?? (() => new Date());\n  }\n\n  observe(dispatch: TelemetryDispatch) {\n    const anomalyConfig = dispatch.definition.anomalyDetection;\n    if (!anomalyConfig?.enabled) return;\n    if (!anomalyConfig.thresholds?.length) return;\n\n    const eventKey = `${dispatch.name}.v${dispatch.version}`;\n    const count = this.samples.get(eventKey) ?? 0;\n    const newCount = count + 1;\n    this.samples.set(eventKey, newCount);\n\n    if (\n      typeof anomalyConfig.minimumSample === 'number' &&\n      newCount < anomalyConfig.minimumSample\n    ) {\n      return;\n    }\n\n    for (const threshold of anomalyConfig.thresholds) {\n      const value = this.extractMetric(dispatch, threshold.metric);\n      if (typeof value !== 'number') continue;\n      if (typeof threshold.min === 'number' && value < threshold.min) {\n        this.emit(dispatch, anomalyConfig, threshold.metric, value, 'min');\n      }\n      if (typeof threshold.max === 'number' && value > threshold.max) {\n        this.emit(dispatch, anomalyConfig, threshold.metric, value, 'max');\n      }\n    }\n  }\n\n  private extractMetric(dispatch: TelemetryDispatch, metric: string) {\n    const value = dispatch.properties[metric];\n    if (typeof value === 'number') return value;\n    if (typeof value === 'object' && value !== null && 'value' in value) {\n      const maybeNumber = (value as Record<string, unknown>).value;\n      return typeof maybeNumber === 'number' ? maybeNumber : undefined;\n    }\n    return undefined;\n  }\n\n  private emit(\n    dispatch: TelemetryDispatch,\n    threshold: TelemetryAnomalyDetectionConfig,\n    metric: string,\n    value: number,\n    type: 'min' | 'max'\n  ) {\n    this.onAnomaly?.({\n      dispatch,\n      threshold,\n      metric,\n      value,\n      type,\n    });\n  }\n\n  reset() {\n    this.samples.clear();\n  }\n}\n\n"],"mappings":"AAgBA,IAAa,EAAb,KAAqC,CACnC,UACA,IACA,QAA2B,IAAI,IAE/B,YAAY,EAA0C,EAAE,CAAE,CACxD,KAAK,UAAY,EAAQ,UACzB,KAAK,IAAM,EAAQ,UAAc,IAAI,MAGvC,QAAQ,EAA6B,CACnC,IAAM,EAAgB,EAAS,WAAW,iBAE1C,GADI,CAAC,GAAe,SAChB,CAAC,EAAc,YAAY,OAAQ,OAEvC,IAAM,EAAW,GAAG,EAAS,KAAK,IAAI,EAAS,UAEzC,GADQ,KAAK,QAAQ,IAAI,EAAS,EAAI,GACnB,EACzB,QAAK,QAAQ,IAAI,EAAU,EAAS,CAGlC,SAAO,EAAc,eAAkB,UACvC,EAAW,EAAc,eAK3B,IAAK,IAAM,KAAa,EAAc,WAAY,CAChD,IAAM,EAAQ,KAAK,cAAc,EAAU,EAAU,OAAO,CACxD,OAAO,GAAU,WACjB,OAAO,EAAU,KAAQ,UAAY,EAAQ,EAAU,KACzD,KAAK,KAAK,EAAU,EAAe,EAAU,OAAQ,EAAO,MAAM,CAEhE,OAAO,EAAU,KAAQ,UAAY,EAAQ,EAAU,KACzD,KAAK,KAAK,EAAU,EAAe,EAAU,OAAQ,EAAO,MAAM,GAKxE,cAAsB,EAA6B,EAAgB,CACjE,IAAM,EAAQ,EAAS,WAAW,GAClC,GAAI,OAAO,GAAU,SAAU,OAAO,EACtC,GAAI,OAAO,GAAU,UAAY,GAAkB,UAAW,EAAO,CACnE,IAAM,EAAe,EAAkC,MACvD,OAAO,OAAO,GAAgB,SAAW,EAAc,IAAA,IAK3D,KACE,EACA,EACA,EACA,EACA,EACA,CACA,KAAK,YAAY,CACf,WACA,YACA,SACA,QACA,OACD,CAAC,CAGJ,OAAQ,CACN,KAAK,QAAQ,OAAO"}

package/dist/telemetry/index.d.ts

@@ -0,0 +1,4 @@
+import { TelemetryAnomalyAction, TelemetryAnomalyDetectionConfig, TelemetryAnomalyThreshold, TelemetryConfig, TelemetryEventDef, TelemetryMeta, TelemetryPrivacyLevel, TelemetryPropertyDef, TelemetryProviderConfig, TelemetryRegistry, TelemetryRetentionConfig, TelemetrySamplingConfig, TelemetrySpec, makeTelemetryKey } from "./spec.js";
+import { TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions } from "./anomaly.js";
+import { RuntimeTelemetryProvider, TelemetryDispatch, TelemetryEventContext, TelemetryTracker, TelemetryTrackerOptions } from "./tracker.js";
+export { RuntimeTelemetryProvider, TelemetryAnomalyAction, TelemetryAnomalyDetectionConfig, TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions, TelemetryAnomalyThreshold, TelemetryConfig, TelemetryDispatch, TelemetryEventContext, TelemetryEventDef, TelemetryMeta, TelemetryPrivacyLevel, TelemetryPropertyDef, TelemetryProviderConfig, TelemetryRegistry, TelemetryRetentionConfig, TelemetrySamplingConfig, TelemetrySpec, TelemetryTracker, TelemetryTrackerOptions, makeTelemetryKey };

package/dist/telemetry/index.js

@@ -0,0 +1 @@
+import{TelemetryRegistry as e,makeTelemetryKey as t}from"./spec.js";import{TelemetryTracker as n}from"./tracker.js";import{TelemetryAnomalyMonitor as r}from"./anomaly.js";export{r as TelemetryAnomalyMonitor,e as TelemetryRegistry,n as TelemetryTracker,t as makeTelemetryKey};