@contractspec/lib.contracts 1.56.1 → 1.58.0

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

@@ -0,0 +1,209 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/jsonschema.ts
+import z from "zod";
+function jsonSchemaForSpec(spec) {
+  return {
+    input: spec.io.input ? z.toJSONSchema(spec.io.input.getZod()) : null,
+    output: spec.io.output ? z.toJSONSchema(spec.io.output.getZod()) : null,
+    meta: {
+      name: spec.meta.key,
+      version: spec.meta.version,
+      kind: spec.meta.kind,
+      description: spec.meta.description,
+      tags: spec.meta.tags ?? [],
+      stability: spec.meta.stability ?? "stable"
+    }
+  };
+}
+function defaultRestPath(name, version) {
+  return `/${name.replace(/\./g, "/")}/v${version}`;
+}
+function sanitizeMcpName(name) {
+  const sanitized = name.replace(/\./g, "_");
+  return sanitized.slice(0, 64);
+}
+function defaultMcpTool(name, version) {
+  const safeName = name.replace(/\./g, "_");
+  const safeVersion = version.replace(/\./g, "_");
+  return `${safeName}-v${safeVersion}`;
+}
+function defaultMcpPrompt(key) {
+  return sanitizeMcpName(key);
+}
+function defaultGqlField(name, version) {
+  return `${name.replace(/\./g, "_")}_v${version}`;
+}
+
+// src/server/rest-generic.ts
+function corsHeaders(opt) {
+  const h = {};
+  const origin = typeof opt === "object" ? opt.origin ?? "*" : "*";
+  h["access-control-allow-origin"] = 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) {
+  const left = (a ?? "").replace(/\/+$/g, "");
+  const right = b.replace(/^\/+/g, "");
+  return `${left}/${right}`.replace(/\/{2,}/g, "/");
+}
+function createFetchHandler(reg, ctxFactory, options) {
+  const opts = {
+    basePath: options?.basePath ?? "",
+    cors: options?.cors ?? false,
+    prettyJson: options?.prettyJson ?? false,
+    onError: options?.onError
+  };
+  const routes = reg.list().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 = 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 headers2 = {};
+        if (opts.cors)
+          Object.assign(headers2, corsHeaders(opts.cors === true ? {} : opts.cors));
+        return makeJson(mapped.status, mapped.body, headers2);
+      }
+      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);
+    }
+  };
+}
+
+// src/server/rest-elysia.ts
+function elysiaPlugin(app, reg, ctxFactory, options) {
+  const handler = createFetchHandler(reg, (req) => ctxFactory({
+    request: req,
+    store: app.store
+  }), options);
+  for (const spec of reg.list()) {
+    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;
+}
+export {
+  elysiaPlugin
+};

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

@@ -0,0 +1,224 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/jsonschema.ts
+import z from "zod";
+function jsonSchemaForSpec(spec) {
+  return {
+    input: spec.io.input ? z.toJSONSchema(spec.io.input.getZod()) : null,
+    output: spec.io.output ? z.toJSONSchema(spec.io.output.getZod()) : null,
+    meta: {
+      name: spec.meta.key,
+      version: spec.meta.version,
+      kind: spec.meta.kind,
+      description: spec.meta.description,
+      tags: spec.meta.tags ?? [],
+      stability: spec.meta.stability ?? "stable"
+    }
+  };
+}
+function defaultRestPath(name, version) {
+  return `/${name.replace(/\./g, "/")}/v${version}`;
+}
+function sanitizeMcpName(name) {
+  const sanitized = name.replace(/\./g, "_");
+  return sanitized.slice(0, 64);
+}
+function defaultMcpTool(name, version) {
+  const safeName = name.replace(/\./g, "_");
+  const safeVersion = version.replace(/\./g, "_");
+  return `${safeName}-v${safeVersion}`;
+}
+function defaultMcpPrompt(key) {
+  return sanitizeMcpName(key);
+}
+function defaultGqlField(name, version) {
+  return `${name.replace(/\./g, "_")}_v${version}`;
+}
+
+// src/server/rest-generic.ts
+function corsHeaders(opt) {
+  const h = {};
+  const origin = typeof opt === "object" ? opt.origin ?? "*" : "*";
+  h["access-control-allow-origin"] = 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) {
+  const left = (a ?? "").replace(/\/+$/g, "");
+  const right = b.replace(/^\/+/g, "");
+  return `${left}/${right}`.replace(/\/{2,}/g, "/");
+}
+function createFetchHandler(reg, ctxFactory, options) {
+  const opts = {
+    basePath: options?.basePath ?? "",
+    cors: options?.cors ?? false,
+    prettyJson: options?.prettyJson ?? false,
+    onError: options?.onError
+  };
+  const routes = reg.list().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 = 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 headers2 = {};
+        if (opts.cors)
+          Object.assign(headers2, corsHeaders(opts.cors === true ? {} : opts.cors));
+        return makeJson(mapped.status, mapped.body, headers2);
+      }
+      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);
+    }
+  };
+}
+
+// src/server/rest-express.ts
+function expressRouter(express, reg, ctxFactory, options) {
+  const router = express.Router();
+  for (const spec of reg.list()) {
+    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 ?? {}) : undefined
+      });
+      const handler = createFetchHandler(reg, () => ctxFactory(req), options);
+      const response = await handler(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;
+      const resp = new Response(null, { status: 204 });
+      resp.headers.forEach((v, k) => h.set(k, v));
+      res.status(204).send();
+    });
+  }
+  return router;
+}
+export {
+  expressRouter
+};

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

@@ -0,0 +1,192 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/jsonschema.ts
+import z from "zod";
+function jsonSchemaForSpec(spec) {
+  return {
+    input: spec.io.input ? z.toJSONSchema(spec.io.input.getZod()) : null,
+    output: spec.io.output ? z.toJSONSchema(spec.io.output.getZod()) : null,
+    meta: {
+      name: spec.meta.key,
+      version: spec.meta.version,
+      kind: spec.meta.kind,
+      description: spec.meta.description,
+      tags: spec.meta.tags ?? [],
+      stability: spec.meta.stability ?? "stable"
+    }
+  };
+}
+function defaultRestPath(name, version) {
+  return `/${name.replace(/\./g, "/")}/v${version}`;
+}
+function sanitizeMcpName(name) {
+  const sanitized = name.replace(/\./g, "_");
+  return sanitized.slice(0, 64);
+}
+function defaultMcpTool(name, version) {
+  const safeName = name.replace(/\./g, "_");
+  const safeVersion = version.replace(/\./g, "_");
+  return `${safeName}-v${safeVersion}`;
+}
+function defaultMcpPrompt(key) {
+  return sanitizeMcpName(key);
+}
+function defaultGqlField(name, version) {
+  return `${name.replace(/\./g, "_")}_v${version}`;
+}
+
+// src/server/rest-generic.ts
+function corsHeaders(opt) {
+  const h = {};
+  const origin = typeof opt === "object" ? opt.origin ?? "*" : "*";
+  h["access-control-allow-origin"] = 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) {
+  const left = (a ?? "").replace(/\/+$/g, "");
+  const right = b.replace(/^\/+/g, "");
+  return `${left}/${right}`.replace(/\/{2,}/g, "/");
+}
+function createFetchHandler(reg, ctxFactory, options) {
+  const opts = {
+    basePath: options?.basePath ?? "",
+    cors: options?.cors ?? false,
+    prettyJson: options?.prettyJson ?? false,
+    onError: options?.onError
+  };
+  const routes = reg.list().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 = 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 headers2 = {};
+        if (opts.cors)
+          Object.assign(headers2, corsHeaders(opts.cors === true ? {} : opts.cors));
+        return makeJson(mapped.status, mapped.body, headers2);
+      }
+      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);
+    }
+  };
+}
+export {
+  createFetchHandler
+};