@lssm/lib.contracts 1.41.0 → 1.42.1

package/dist/schema-to-markdown.js

@@ -1,10 +1,214 @@
-function e(e,i,a={}){let{format:o=`auto`,title:s,description:c,maxDepth:l=2}=a,u=[];s&&u.push(`# ${s}`,``),c&&u.push(`> ${c}`,``);let d=o===`auto`?Array.isArray(i)?`table`:`detail`:o;return d===`table`&&Array.isArray(i)?u.push(t(e,i,a)):d===`list`&&Array.isArray(i)?u.push(n(e,i,a)):!Array.isArray(i)&&typeof i==`object`&&i?u.push(r(e,i,{...a,maxDepth:l})):u.push(`**Data:** ${String(i)}`,``),u.join(`
-`)}function t(e,t,n={}){let{maxItems:r=100,includeFields:i,excludeFields:c=[]}=n,l=a(e,i,c);if(l.length===0||t.length===0)return`_No data available_
-`;let u=t.slice(0,r),d=[],f=l.map(e=>e.label);d.push(`| ${f.join(` | `)} |`),d.push(`| ${f.map(()=>`---`).join(` | `)} |`);for(let e of u){let t=l.map(t=>s(o(e,t.name)));d.push(`| ${t.join(` | `)} |`)}return t.length>r&&d.push(``,`_Showing ${r} of ${t.length} items_`),d.push(``),d.join(`
-`)}function n(e,t,n={}){let{maxItems:r=50,summaryFields:i,includeFields:c,excludeFields:l=[]}=n,u=a(e,c,l),d=i?u.filter(e=>i.includes(e.name)):u.slice(0,3);if(d.length===0||t.length===0)return`_No data available_
-`;let f=t.slice(0,r),p=[];for(let e of f){let t=s(o(e,d[0]?.name??`id`)),n=d.slice(1).map(t=>`${t.label}: ${s(o(e,t.name))}`).join(` · `),r=n?`- **${t}** (${n})`:`- **${t}**`;p.push(r)}return t.length>r&&p.push(``,`_Showing ${r} of ${t.length} items_`),p.push(``),p.join(`
-`)}function r(e,t,n={}){let{includeFields:r,excludeFields:i=[],maxDepth:s=2}=n;if(typeof t!=`object`||!t)return`_No data available_
-`;let l=a(e,r,i);if(l.length===0)return`_No fields to display_
-`;let u=[];for(let e of l){let n=c(o(t,e.name),s,0);u.push(`**${e.label}:** ${n}`)}return u.push(``),u.join(`
-`)}function i(e,t,n={}){let{numericFields:r=[],countByField:i}=n,a=[];a.push(`**Total Items:** ${t.length}`);for(let e of r){let n=t.map(t=>o(t,e)).filter(e=>typeof e==`number`);if(n.length>0){let t=n.reduce((e,t)=>e+t,0),r=t/n.length,i=Math.min(...n),o=Math.max(...n);a.push(`**${l(e)}:** Sum: ${u(t)}, Avg: ${u(r)}, Min: ${u(i)}, Max: ${u(o)}`)}}if(i){let e={};for(let n of t){let t=String(o(n,i)??`Unknown`);e[t]=(e[t]??0)+1}a.push(``,`**By ${l(i)}:**`);for(let[t,n]of Object.entries(e))a.push(`- ${t}: ${n}`)}return a.push(``),a.join(`
-`)}function a(e,t,n=[]){let r=e.config.fields;return Object.keys(r).filter(e=>!(n.includes(e)||t&&!t.includes(e))).map(e=>{let t=r[e],n=!!(t?.type&&typeof t.type==`object`&&`config`in t.type&&typeof t.type.config?.fields==`object`);return{name:e,label:l(e),isOptional:t?.isOptional??!1,isArray:t?.isArray===!0,isNested:n}})}function o(e,t){if(typeof e!=`object`||!e)return;let n=e;if(t.includes(`.`)){let e=t.split(`.`),r=n;for(let t of e){if(typeof r!=`object`||!r)return;r=r[t]}return r}return n[t]}function s(e){if(e==null)return`-`;if(typeof e==`boolean`)return e?`✓`:`✗`;if(typeof e==`number`)return u(e);if(e instanceof Date)return d(e);if(typeof e==`string`&&f(e))return d(new Date(e));if(Array.isArray(e))return`[${e.length} items]`;if(typeof e==`object`)return`[Object]`;let t=String(e);return t.length>50?`${t.slice(0,47)}...`:t.replace(/\|/g,`\\|`)}function c(e,t,n){return e==null?`_none_`:typeof e==`boolean`?e?`Yes`:`No`:typeof e==`number`?u(e):e instanceof Date?d(e):typeof e==`string`&&f(e)?d(new Date(e)):Array.isArray(e)?e.length===0?`_empty list_`:n>=t?`[${e.length} items]`:e.length<=5&&e.every(e=>typeof e!=`object`)?e.map(e=>s(e)).join(`, `):`[${e.length} items]`:typeof e==`object`?n>=t?`[Object]`:`{${Object.keys(e).length} fields}`:String(e)}function l(e){return e.replace(/([a-z])([A-Z])/g,`$1 $2`).replace(/_/g,` `).replace(/^\w/,e=>e.toUpperCase())}function u(e){return Math.abs(e)>=1e3?new Intl.NumberFormat(`en-US`,{maximumFractionDigits:2}).format(e):Number.isInteger(e)?String(e):e.toFixed(2)}function d(e){return e.toLocaleDateString(`en-US`,{year:`numeric`,month:`short`,day:`numeric`})}function f(e){if(!/^\d{4}-\d{2}-\d{2}/.test(e))return!1;let t=new Date(e);return!isNaN(t.getTime())}export{e as schemaToMarkdown,r as schemaToMarkdownDetail,n as schemaToMarkdownList,i as schemaToMarkdownSummary,t as schemaToMarkdownTable};
+//#region src/schema-to-markdown.ts
+/**
+* Generate markdown from a SchemaModel and data.
+* Automatically detects array vs object data and formats accordingly.
+*/
+function schemaToMarkdown(schema, data, options = {}) {
+	const { format = "auto", title, description, maxDepth = 2 } = options;
+	const lines = [];
+	if (title) lines.push(`# ${title}`, "");
+	if (description) lines.push(`> ${description}`, "");
+	const effectiveFormat = format === "auto" ? Array.isArray(data) ? "table" : "detail" : format;
+	if (effectiveFormat === "table" && Array.isArray(data)) lines.push(schemaToMarkdownTable(schema, data, options));
+	else if (effectiveFormat === "list" && Array.isArray(data)) lines.push(schemaToMarkdownList(schema, data, options));
+	else if (!Array.isArray(data) && data !== null && typeof data === "object") lines.push(schemaToMarkdownDetail(schema, data, {
+		...options,
+		maxDepth
+	}));
+	else lines.push(`**Data:** ${String(data)}`, "");
+	return lines.join("\n");
+}
+/**
+* Generate a markdown table from array data using schema fields as columns.
+*/
+function schemaToMarkdownTable(schema, items, options = {}) {
+	const { maxItems = 100, includeFields, excludeFields = [] } = options;
+	const fields = getFieldMeta(schema, includeFields, excludeFields);
+	if (fields.length === 0 || items.length === 0) return "_No data available_\n";
+	const limitedItems = items.slice(0, maxItems);
+	const lines = [];
+	const headers = fields.map((f) => f.label);
+	lines.push(`| ${headers.join(" | ")} |`);
+	lines.push(`| ${headers.map(() => "---").join(" | ")} |`);
+	for (const item of limitedItems) {
+		const row = fields.map((f) => formatCellValue(getFieldValue(item, f.name)));
+		lines.push(`| ${row.join(" | ")} |`);
+	}
+	if (items.length > maxItems) lines.push("", `_Showing ${maxItems} of ${items.length} items_`);
+	lines.push("");
+	return lines.join("\n");
+}
+/**
+* Generate a markdown list from array data.
+* Uses summaryFields to create concise list items.
+*/
+function schemaToMarkdownList(schema, items, options = {}) {
+	const { maxItems = 50, summaryFields, includeFields, excludeFields = [] } = options;
+	const fields = getFieldMeta(schema, includeFields, excludeFields);
+	const displayFields = summaryFields ? fields.filter((f) => summaryFields.includes(f.name)) : fields.slice(0, 3);
+	if (displayFields.length === 0 || items.length === 0) return "_No data available_\n";
+	const limitedItems = items.slice(0, maxItems);
+	const lines = [];
+	for (const item of limitedItems) {
+		const primaryValue = formatCellValue(getFieldValue(item, displayFields[0]?.name ?? "id"));
+		const secondaryValues = displayFields.slice(1).map((f) => `${f.label}: ${formatCellValue(getFieldValue(item, f.name))}`).join(" · ");
+		const itemLine = secondaryValues ? `- **${primaryValue}** (${secondaryValues})` : `- **${primaryValue}**`;
+		lines.push(itemLine);
+	}
+	if (items.length > maxItems) lines.push("", `_Showing ${maxItems} of ${items.length} items_`);
+	lines.push("");
+	return lines.join("\n");
+}
+/**
+* Generate a markdown detail view (key-value pairs) from object data.
+*/
+function schemaToMarkdownDetail(schema, item, options = {}) {
+	const { includeFields, excludeFields = [], maxDepth = 2 } = options;
+	if (item === null || typeof item !== "object") return "_No data available_\n";
+	const fields = getFieldMeta(schema, includeFields, excludeFields);
+	if (fields.length === 0) return "_No fields to display_\n";
+	const lines = [];
+	for (const field of fields) {
+		const formattedValue = formatDetailValue(getFieldValue(item, field.name), maxDepth, 0);
+		lines.push(`**${field.label}:** ${formattedValue}`);
+	}
+	lines.push("");
+	return lines.join("\n");
+}
+/**
+* Generate markdown summary statistics for numeric fields in array data.
+*/
+function schemaToMarkdownSummary(items, options = {}) {
+	const { numericFields = [], countByField } = options;
+	const lines = [];
+	lines.push(`**Total Items:** ${items.length}`);
+	for (const fieldName of numericFields) {
+		const values = items.map((item) => getFieldValue(item, fieldName)).filter((v) => typeof v === "number");
+		if (values.length > 0) {
+			const sum = values.reduce((a, b) => a + b, 0);
+			const avg = sum / values.length;
+			const min = Math.min(...values);
+			const max = Math.max(...values);
+			lines.push(`**${formatFieldName(fieldName)}:** Sum: ${formatNumber(sum)}, Avg: ${formatNumber(avg)}, Min: ${formatNumber(min)}, Max: ${formatNumber(max)}`);
+		}
+	}
+	if (countByField) {
+		const counts = {};
+		for (const item of items) {
+			const value = String(getFieldValue(item, countByField) ?? "Unknown");
+			counts[value] = (counts[value] ?? 0) + 1;
+		}
+		lines.push("", `**By ${formatFieldName(countByField)}:**`);
+		for (const [value, count] of Object.entries(counts)) lines.push(`- ${value}: ${count}`);
+	}
+	lines.push("");
+	return lines.join("\n");
+}
+/**
+* Get field metadata from schema, applying include/exclude filters
+*/
+function getFieldMeta(schema, includeFields, excludeFields = []) {
+	const schemaFields = schema.config.fields;
+	return Object.keys(schemaFields).filter((name) => {
+		if (excludeFields.includes(name)) return false;
+		if (includeFields && !includeFields.includes(name)) return false;
+		return true;
+	}).map((name) => {
+		const fieldConfig = schemaFields[name];
+		const isNested = Boolean(fieldConfig?.type && typeof fieldConfig.type === "object" && "config" in fieldConfig.type && typeof fieldConfig.type.config?.fields === "object");
+		return {
+			name,
+			label: formatFieldName(name),
+			isOptional: fieldConfig?.isOptional ?? false,
+			isArray: fieldConfig?.isArray === true,
+			isNested
+		};
+	});
+}
+/**
+* Get value from object by field name (supports nested paths)
+*/
+function getFieldValue(item, fieldName) {
+	if (item === null || typeof item !== "object") return void 0;
+	const obj = item;
+	if (fieldName.includes(".")) {
+		const parts = fieldName.split(".");
+		let current = obj;
+		for (const part of parts) {
+			if (current === null || typeof current !== "object") return void 0;
+			current = current[part];
+		}
+		return current;
+	}
+	return obj[fieldName];
+}
+/**
+* Format a value for table cell display
+*/
+function formatCellValue(value) {
+	if (value === null || value === void 0) return "-";
+	if (typeof value === "boolean") return value ? "✓" : "✗";
+	if (typeof value === "number") return formatNumber(value);
+	if (value instanceof Date) return formatDate(value);
+	if (typeof value === "string" && isISODate(value)) return formatDate(new Date(value));
+	if (Array.isArray(value)) return `[${value.length} items]`;
+	if (typeof value === "object") return "[Object]";
+	const str = String(value);
+	return str.length > 50 ? `${str.slice(0, 47)}...` : str.replace(/\|/g, "\\|");
+}
+/**
+* Format a value for detail view (allows more space)
+*/
+function formatDetailValue(value, maxDepth, currentDepth) {
+	if (value === null || value === void 0) return "_none_";
+	if (typeof value === "boolean") return value ? "Yes" : "No";
+	if (typeof value === "number") return formatNumber(value);
+	if (value instanceof Date) return formatDate(value);
+	if (typeof value === "string" && isISODate(value)) return formatDate(new Date(value));
+	if (Array.isArray(value)) {
+		if (value.length === 0) return "_empty list_";
+		if (currentDepth >= maxDepth) return `[${value.length} items]`;
+		if (value.length <= 5 && value.every((v) => typeof v !== "object")) return value.map((v) => formatCellValue(v)).join(", ");
+		return `[${value.length} items]`;
+	}
+	if (typeof value === "object") {
+		if (currentDepth >= maxDepth) return "[Object]";
+		return `{${Object.keys(value).length} fields}`;
+	}
+	return String(value);
+}
+/**
+* Format field name to human-readable label
+*/
+function formatFieldName(name) {
+	return name.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/_/g, " ").replace(/^\w/, (c) => c.toUpperCase());
+}
+/**
+* Format number with locale-aware formatting
+*/
+function formatNumber(value) {
+	if (Math.abs(value) >= 1e3) return new Intl.NumberFormat("en-US", { maximumFractionDigits: 2 }).format(value);
+	if (Number.isInteger(value)) return String(value);
+	return value.toFixed(2);
+}
+/**
+* Format date to readable string
+*/
+function formatDate(date) {
+	return date.toLocaleDateString("en-US", {
+		year: "numeric",
+		month: "short",
+		day: "numeric"
+	});
+}
+/**
+* Check if string is ISO date format
+*/
+function isISODate(str) {
+	if (!/^\d{4}-\d{2}-\d{2}/.test(str)) return false;
+	const date = new Date(str);
+	return !isNaN(date.getTime());
+}
+
+//#endregion
+export { schemaToMarkdown, schemaToMarkdownDetail, schemaToMarkdownList, schemaToMarkdownSummary, schemaToMarkdownTable };

package/dist/server/contracts-adapter-hydration.d.ts

@@ -0,0 +1,15 @@
+import { ResourceRegistry } from "../resources.js";
+
+//#region src/server/contracts-adapter-hydration.d.ts
+interface ReturnsDecl {
+  isList: boolean;
+  inner: string;
+}
+declare function parseReturns(returnsLike: string): ReturnsDecl;
+declare function hydrateResourceIfNeeded(resources: ResourceRegistry | undefined, result: unknown, opts: {
+  template?: string;
+  varName?: string;
+  returns: ReturnsDecl;
+}): Promise<unknown>;
+//#endregion
+export { ReturnsDecl, hydrateResourceIfNeeded, parseReturns };

package/dist/server/contracts-adapter-hydration.js

@@ -0,0 +1,41 @@
+//#region src/server/contracts-adapter-hydration.ts
+function parseReturns(returnsLike) {
+	if (!returnsLike) return {
+		isList: false,
+		inner: "JSON"
+	};
+	const trimmed = String(returnsLike).trim();
+	if (trimmed.startsWith("[") && trimmed.endsWith("]")) return {
+		isList: true,
+		inner: trimmed.slice(1, -1).trim()
+	};
+	return {
+		isList: false,
+		inner: trimmed
+	};
+}
+async function hydrateResourceIfNeeded(resources, result, opts) {
+	if (!resources || !opts.template) return result;
+	const varName = opts.varName ?? "id";
+	const hydrateOne = async (item) => {
+		if (item && typeof item === "object" && varName in item) {
+			const key = String(item[varName]);
+			const uri = (opts.template ?? "").replace("{id}", key);
+			const match = resources.match(uri);
+			if (match) {
+				const resolved = await match.tmpl.resolve(match.params, {});
+				try {
+					return JSON.parse(String(resolved.data || "null"));
+				} catch {
+					return resolved.data;
+				}
+			}
+		}
+		return item;
+	};
+	if (opts.returns.isList && Array.isArray(result)) return await Promise.all(result.map((x) => hydrateOne(x)));
+	return await hydrateOne(result);
+}
+
+//#endregion
+export { hydrateResourceIfNeeded, parseReturns };

package/dist/server/contracts-adapter-input.d.ts

@@ -0,0 +1,9 @@
+import { AnySchemaModel } from "@lssm/lib.schema";
+import { SchemaTypes } from "@pothos/core";
+
+//#region src/server/contracts-adapter-input.d.ts
+declare function createInputTypeBuilder<T extends SchemaTypes>(builder: PothosSchemaTypes.SchemaBuilder<T>): {
+  buildInputFieldArgs: (model: AnySchemaModel | null) => null;
+};
+//#endregion
+export { createInputTypeBuilder };

package/dist/server/contracts-adapter-input.js

@@ -0,0 +1,77 @@
+//#region src/server/contracts-adapter-input.ts
+function isSchemaModel(x) {
+	return typeof x?.getPothosInput === "function" && typeof x?.getZod === "function";
+}
+function isFieldType(x) {
+	return typeof x?.getPothos === "function";
+}
+function isEnumType(x) {
+	return typeof x?.getEnumValues === "function" && typeof x?.getPothos === "function";
+}
+function mapScalarName(name) {
+	if (name === "Boolean_unsecure") return "Boolean";
+	if (name === "ID_unsecure") return "ID";
+	if (name === "String_unsecure") return "String";
+	if (name === "Int_unsecure") return "Int";
+	if (name === "Float_unsecure") return "Float";
+	return name;
+}
+function createInputTypeBuilder(builder) {
+	const inputTypeCache = /* @__PURE__ */ new Map();
+	const enumTypeCache = /* @__PURE__ */ new Set();
+	function registerEnumsForModel(model) {
+		const entries = Object.entries(model.config.fields);
+		for (const [, field] of entries) if (isSchemaModel(field.type)) registerEnumsForModel(field.type);
+		else if (isEnumType(field.type)) {
+			const enumObj = field.type;
+			const name = enumObj.getName?.() ?? enumObj.getPothos().name;
+			if (!enumTypeCache.has(name)) {
+				builder.enumType(name, { values: enumObj.getEnumValues() });
+				enumTypeCache.add(name);
+			}
+		}
+	}
+	function ensureInputTypeForModel(model) {
+		const typeName = String(model.config?.name ?? "Input");
+		const cached = inputTypeCache.get(typeName);
+		if (cached) return cached;
+		registerEnumsForModel(model);
+		const created = builder.inputType(model.getPothosInput(), { fields: (t) => {
+			const entries = Object.entries(model.config.fields);
+			const acc = {};
+			for (const [key, field] of entries) if (isSchemaModel(field.type)) {
+				const nested = ensureInputTypeForModel(field.type);
+				const typeRef = field.isArray ? [nested] : nested;
+				acc[key] = t.field({
+					type: typeRef,
+					required: !field.isOptional
+				});
+			} else if (isFieldType(field.type)) {
+				const typeName$1 = mapScalarName(String(field.type.getPothos().name));
+				const typeRef = field.isArray ? [typeName$1] : typeName$1;
+				acc[key] = t.field({
+					type: typeRef,
+					required: !field.isOptional
+				});
+			} else {
+				const typeRef = field.isArray ? ["JSON"] : "JSON";
+				acc[key] = t.field({
+					type: typeRef,
+					required: !field.isOptional
+				});
+			}
+			return acc;
+		} });
+		inputTypeCache.set(typeName, created);
+		return created;
+	}
+	function buildInputFieldArgs(model) {
+		if (!model) return null;
+		if (!model.config?.fields || Object.keys(model.config.fields).length === 0) return null;
+		return ensureInputTypeForModel(model);
+	}
+	return { buildInputFieldArgs };
+}
+
+//#endregion
+export { createInputTypeBuilder };

package/dist/server/graphql-pothos.d.ts

@@ -0,0 +1,31 @@
+import { ResourceRegistry } from "../resources.js";
+import { OperationSpecRegistry } from "../operations/registry.js";
+import "@pothos/plugin-prisma";
+import "@pothos/plugin-complexity";
+import "@pothos/plugin-relay";
+import "@pothos/plugin-dataloader";
+import "@pothos/plugin-tracing";
+import { SchemaTypes } from "@pothos/core";
+
+//#region src/server/graphql-pothos.d.ts
+
+/**
+ * Registers all ContractSpecs from a OperationSpecRegistry onto a Pothos SchemaBuilder.
+ *
+ * This adapter:
+ * 1. Discovers output types from specs and registers them as Pothos object types.
+ * 2. Maps `ContractSpec` (OperationSpec) inputs to Pothos input types.
+ * 3. Mounts `query` specs as `Query` fields and `command` specs as `Mutation` fields.
+ * 4. Wraps the resolver to:
+ *    - Enforce auth policies (basic check).
+ *    - Build a `HandlerCtx`.
+ *    - Execute via `OperationSpecRegistry`.
+ *    - Hydrate resource references if applicable.
+ *
+ * @param builder - The Pothos SchemaBuilder instance.
+ * @param reg - The OperationSpecRegistry containing operations.
+ * @param resources - (Optional) ResourceRegistry for hydrating resource references.
+ */
+declare function registerContractsOnBuilder<T extends SchemaTypes>(builder: PothosSchemaTypes.SchemaBuilder<T>, reg: OperationSpecRegistry, resources?: ResourceRegistry): void;
+//#endregion
+export { registerContractsOnBuilder };

package/dist/server/graphql-pothos.js

@@ -1 +1,127 @@
-import{hydrateResourceIfNeeded as e,parseReturns as t}from"../contracts-adapter-hydration.js";import{createInputTypeBuilder as n}from"../contracts-adapter-input.js";import{defaultGqlField as r}from"../jsonschema.js";import"../node_modules/@pothos/plugin-prisma/esm/index.js";import"../node_modules/@pothos/plugin-complexity/esm/index.js";import"../node_modules/@pothos/plugin-dataloader/esm/index.js";import"../node_modules/@pothos/plugin-tracing/esm/index.js";import"@pothos/plugin-relay";function i(i,a,o){let{buildInputFieldArgs:s}=n(i),c=new Map;for(let e of a.listSpecs()){let t=e.io.output;if(t&&`getZod`in t&&typeof t.getZod==`function`){let e=t,n=e.config?.name??`UnknownOutput`;c.has(n)||c.set(n,e)}}for(let[e,t]of c.entries())i.objectType(e,{fields:e=>{let n=Object.entries(t.config.fields),r={};for(let[t,i]of n){let n=i.type,a=`JSON`;n&&typeof n.getPothos==`function`&&(a=n.getPothos().name||`JSON`,a===`String_unsecure`&&(a=`String`),a===`Int_unsecure`&&(a=`Int`),a===`Float_unsecure`&&(a=`Float`),a===`Boolean_unsecure`&&(a=`Boolean`),a===`ID_unsecure`&&(a=`ID`));let o=i.isArray?[a]:a;r[t]=e.field({type:o,nullable:i.isOptional,resolve:e=>e[t]})}return r}});function l(e){let t=e.transport?.gql?.returns;if(t)return t;let n=e.io.output??{};if(n&&`kind`in n&&n.kind===`resource_ref`&&`graphQLType`in n&&n.graphQLType)return String(n.graphQLType);if(n&&`getZod`in n&&typeof n.getZod==`function`){let e=n.config?.name;if(e&&c.has(e))return e}return`JSON`}for(let n of a.listSpecs()){let c=n.transport?.gql?.field??r(n.meta.name,n.meta.version);n.transport?.gql?.returns;let u=n.transport?.gql?.byIdField??`id`,d=n.transport?.gql?.resource,f=n.meta.kind===`query`,p=l(n),m=n.transport?.gql?.returns,h=t(m??p),g=async(t,r,i)=>{if(n.policy.auth!==`anonymous`&&!i.user)throw Error(`Unauthorized`);let s={traceId:i.logger?.getTraceId?.()??void 0,userId:i.user?.id??null,organizationId:i.session?.activeOrganizationId??null,actor:i.user?`user`:`anonymous`,channel:`web`,eventPublisher:i.eventPublisher},c=n.io.input?.getZod().parse(r.input??{}),l=await a.execute(n.meta.name,n.meta.version,c,s),f=n.io.output;if(o&&(d||f?.kind===`resource_ref`)){let t=u??f?.varName??`id`,n=await e(o,l,{template:d??f?.uriTemplate,varName:t,returns:h});if(n!==l)return n}return p?h.inner===`Boolean`&&!h.isList?!!(l?.ok??l):l:n.io.output.getZod().parse(l)},_=e=>{let t=s(n.io.input);return e.field({type:h.isList?[h.inner]:h.inner,complexity:()=>10,resolve:g,args:t?{input:e.arg({type:t,required:!0})}:void 0})};f?i.queryField(c,_):i.mutationField(c,_)}}export{i as registerContractsOnBuilder};
+import { defaultGqlField } from "../jsonschema.js";
+import { createInputTypeBuilder } from "./contracts-adapter-input.js";
+import { hydrateResourceIfNeeded, parseReturns } from "./contracts-adapter-hydration.js";
+import "@pothos/plugin-prisma";
+import "@pothos/plugin-complexity";
+import "@pothos/plugin-relay";
+import "@pothos/plugin-dataloader";
+import "@pothos/plugin-tracing";
+
+//#region src/server/graphql-pothos.ts
+/**
+* Registers all ContractSpecs from a OperationSpecRegistry onto a Pothos SchemaBuilder.
+*
+* This adapter:
+* 1. Discovers output types from specs and registers them as Pothos object types.
+* 2. Maps `ContractSpec` (OperationSpec) inputs to Pothos input types.
+* 3. Mounts `query` specs as `Query` fields and `command` specs as `Mutation` fields.
+* 4. Wraps the resolver to:
+*    - Enforce auth policies (basic check).
+*    - Build a `HandlerCtx`.
+*    - Execute via `OperationSpecRegistry`.
+*    - Hydrate resource references if applicable.
+*
+* @param builder - The Pothos SchemaBuilder instance.
+* @param reg - The OperationSpecRegistry containing operations.
+* @param resources - (Optional) ResourceRegistry for hydrating resource references.
+*/
+function registerContractsOnBuilder(builder, reg, resources) {
+	const { buildInputFieldArgs } = createInputTypeBuilder(builder);
+	const outputTypeCache = /* @__PURE__ */ new Map();
+	for (const spec of reg.listSpecs()) {
+		const out = spec.io.output;
+		if (out && "getZod" in out && typeof out.getZod === "function") {
+			const model = out;
+			const typeName = model.config?.name ?? "UnknownOutput";
+			if (!outputTypeCache.has(typeName)) outputTypeCache.set(typeName, model);
+		}
+	}
+	for (const [typeName, model] of outputTypeCache.entries()) builder.objectType(typeName, { fields: (t) => {
+		const entries = Object.entries(model.config.fields);
+		const acc = {};
+		for (const [key, field] of entries) {
+			const fieldType = field.type;
+			let gqlType = "JSON";
+			if (fieldType && typeof fieldType.getPothos === "function") {
+				gqlType = fieldType.getPothos().name || "JSON";
+				if (gqlType === "String_unsecure") gqlType = "String";
+				if (gqlType === "Int_unsecure") gqlType = "Int";
+				if (gqlType === "Float_unsecure") gqlType = "Float";
+				if (gqlType === "Boolean_unsecure") gqlType = "Boolean";
+				if (gqlType === "ID_unsecure") gqlType = "ID";
+			}
+			const typeRef = field.isArray ? [gqlType] : gqlType;
+			acc[key] = t.field({
+				type: typeRef,
+				nullable: field.isOptional,
+				resolve: (parent) => parent[key]
+			});
+		}
+		return acc;
+	} });
+	function resolveGraphQLTypeName(contractSpec) {
+		const returnsName = contractSpec.transport?.gql?.returns;
+		if (returnsName) return returnsName;
+		const out = contractSpec.io.output ?? {};
+		if (out && "kind" in out && out.kind === "resource_ref" && "graphQLType" in out && out.graphQLType) return String(out.graphQLType);
+		if (out && "getZod" in out && typeof out.getZod === "function") {
+			const typeName = out.config?.name;
+			if (typeName && outputTypeCache.has(typeName)) return typeName;
+		}
+		return "JSON";
+	}
+	for (const spec of reg.listSpecs()) {
+		const fieldName = spec.transport?.gql?.field ?? defaultGqlField(spec.meta.key, spec.meta.version);
+		const byIdField = spec.transport?.gql?.byIdField ?? "id";
+		const returnsResource = spec.transport?.gql?.resource;
+		const isQuery = spec.meta.kind === "query";
+		const graphQLTypeName = resolveGraphQLTypeName(spec);
+		const returnsDecl = spec.transport?.gql?.returns;
+		const parsed = parseReturns(returnsDecl ?? graphQLTypeName);
+		const resolveFieldFn = async (_root, args, ctx) => {
+			if (spec.policy.auth !== "anonymous" && !ctx.user) throw new Error("Unauthorized");
+			const handlerCtx = {
+				traceId: ctx.logger?.getTraceId?.() ?? void 0,
+				userId: ctx.user?.id ?? null,
+				organizationId: ctx.session?.activeOrganizationId ?? null,
+				actor: ctx.user ? "user" : "anonymous",
+				channel: "web",
+				eventPublisher: ctx.eventPublisher
+			};
+			const parsedInput = spec.io.input?.getZod().parse(args.input ?? {});
+			const result = await reg.execute(spec.meta.key, spec.meta.version, parsedInput, handlerCtx);
+			const out = spec.io.output;
+			if (resources && (returnsResource || out?.kind === "resource_ref")) {
+				const varName = byIdField ?? out?.varName ?? "id";
+				const hydrated = await hydrateResourceIfNeeded(resources, result, {
+					template: returnsResource ?? out?.uriTemplate,
+					varName,
+					returns: parsed
+				});
+				if (hydrated !== result) return hydrated;
+			}
+			if (graphQLTypeName) {
+				if (parsed.inner === "Boolean" && !parsed.isList) return Boolean(result?.ok ?? result);
+				return result;
+			}
+			return spec.io.output.getZod().parse(result);
+		};
+		const fieldSettingsFn = (t) => {
+			const inputType = buildInputFieldArgs(spec.io.input);
+			return t.field({
+				type: parsed.isList ? [parsed.inner] : parsed.inner,
+				complexity: () => 10,
+				resolve: resolveFieldFn,
+				args: inputType ? { input: t.arg({
+					type: inputType,
+					required: true
+				}) } : void 0
+			});
+		};
+		if (isQuery) builder.queryField(fieldName, fieldSettingsFn);
+		else builder.mutationField(fieldName, fieldSettingsFn);
+	}
+}
+
+//#endregion
+export { registerContractsOnBuilder };

package/dist/server/index.d.ts

@@ -0,0 +1,9 @@
+import { registerContractsOnBuilder } from "./graphql-pothos.js";
+import { createMcpServer } from "./mcp/createMcpServer.js";
+import "./provider-mcp.js";
+import { RestOptions, createFetchHandler } from "./rest-generic.js";
+import { elysiaPlugin } from "./rest-elysia.js";
+import { expressRouter } from "./rest-express.js";
+import { makeNextAppHandler } from "./rest-next-app.js";
+import { makeNextPagesHandler } from "./rest-next-pages.js";
+export { RestOptions, createFetchHandler, createMcpServer, elysiaPlugin, expressRouter, makeNextAppHandler, makeNextPagesHandler, registerContractsOnBuilder };

package/dist/server/index.js

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

package/dist/server/mcp/createMcpServer.d.ts

@@ -0,0 +1,15 @@
+import { ResourceRegistry } from "../../resources.js";
+import { OperationSpecRegistry } from "../../operations/registry.js";
+import { PromptRegistry } from "../../promptRegistry.js";
+import { McpCtxFactories } from "./mcpTypes.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/server/mcp/createMcpServer.d.ts
+
+/**
+ * Creates a unified Model Context Protocol (MCP) server exposing operations, resources, prompts,
+ * and (optionally) presentations.\n+ *
+ * ContractSpec exposes:\n+ * - Tools: `command` operations from `OperationSpecRegistry`.\n+ * - Resources: templates from `ResourceRegistry`.\n+ * - Prompts: templates from `PromptRegistry`.\n+ * - Presentations: V1 registry and/or V2 descriptors as read-only resources.\n+ */
+declare function createMcpServer(server: McpServer, ops: OperationSpecRegistry, resources: ResourceRegistry, prompts: PromptRegistry, ctxFactories: McpCtxFactories): McpServer;
+//#endregion
+export { createMcpServer };

package/dist/server/mcp/createMcpServer.js

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

package/dist/server/mcp/mcpTypes.d.ts

@@ -0,0 +1,30 @@
+import { PresentationSpec } from "../../presentations/presentations.js";
+import { HandlerCtx } from "../../types.js";
+import { PresentationRegistry } from "../../presentations/registry.js";
+import "../../presentations/index.js";
+import { Logger } from "@lssm/lib.logger";
+
+//#region src/server/mcp/mcpTypes.d.ts
+interface McpCtxFactories {
+  logger: Logger;
+  /** Factory for tool execution context (e.g., system actor) */
+  toolCtx: () => HandlerCtx;
+  /** Factory for prompt rendering context */
+  promptCtx: () => {
+    userId?: string | null;
+    orgId?: string | null;
+    locale?: string;
+  };
+  /** Factory for resource resolution context */
+  resourceCtx: () => {
+    userId?: string | null;
+    orgId?: string | null;
+    locale?: string;
+  };
+  /** Optional registry for presentations */
+  presentations?: PresentationRegistry;
+  /** Optional list of presentation specs */
+  presentationsV2?: PresentationSpec[];
+}
+//#endregion
+export { McpCtxFactories };

package/dist/server/mcp/registerPresentations.d.ts

@@ -0,0 +1,7 @@
+import { McpCtxFactories } from "./mcpTypes.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/server/mcp/registerPresentations.d.ts
+declare function registerMcpPresentations(server: McpServer, ctx: Pick<McpCtxFactories, 'logger' | 'presentations' | 'presentationsV2'>): void;
+//#endregion
+export { registerMcpPresentations };