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

package/dist/schema/dist/ScalarTypeEnum.js

@@ -1 +1,236 @@
-import{t as e}from"./FieldType.js";import*as t from"zod";import{Kind as n}from"graphql";const r=/^[A-Za-z]{2}(?:-[A-Za-z0-9]{2,8})*$/,i=/^(?:UTC|[A-Za-z_]+\/[A-Za-z_]+)$/,a=/^[+]?\d[\d\s().-]{3,}$/,o=/^[A-Z]{3}$/,s=/^[A-Z]{2}$/,c=-180,l={String_unsecure:()=>new e({name:`String_unsecure`,description:`Unvalidated string scalar`,zod:t.string(),parseValue:e=>t.string().parse(e),serialize:e=>String(e),parseLiteral:e=>{if(e.kind!==n.STRING)throw TypeError(`Invalid literal`);return e.value},jsonSchema:{type:`string`}}),Int_unsecure:()=>new e({name:`Int_unsecure`,description:`Unvalidated integer scalar`,zod:t.number().int(),parseValue:e=>{let n=typeof e==`number`?e:Number(e);return t.number().int().parse(n)},serialize:e=>Math.trunc(typeof e==`number`?e:Number(e)),parseLiteral:e=>{if(e.kind!==n.INT)throw TypeError(`Invalid literal`);return Number(e.value)},jsonSchema:{type:`integer`}}),Float_unsecure:()=>new e({name:`Float_unsecure`,description:`Unvalidated float scalar`,zod:t.number(),parseValue:e=>{let n=typeof e==`number`?e:Number(e);return t.number().parse(n)},serialize:e=>Number(e),parseLiteral:e=>{if(e.kind!==n.FLOAT&&e.kind!==n.INT)throw TypeError(`Invalid literal`);return Number(e.value)},jsonSchema:{type:`number`}}),Boolean:()=>new e({name:`Boolean`,description:`Unvalidated boolean scalar`,zod:t.boolean(),parseValue:e=>t.coerce.boolean().parse(e),serialize:e=>!!e,parseLiteral:e=>{if(e.kind!==n.BOOLEAN)throw TypeError(`Invalid literal`);return e.value},jsonSchema:{type:`boolean`}}),ID:()=>new e({name:`ID`,description:`Unvalidated id scalar`,zod:t.string(),parseValue:e=>t.string().parse(e),serialize:e=>String(e),parseLiteral:e=>{if(e.kind!==n.STRING)throw TypeError(`Invalid literal`);return e.value},jsonSchema:{type:`string`}}),JSON:()=>new e({name:`JSON`,zod:t.any(),parseValue:e=>e,serialize:e=>e,jsonSchema:{}}),JSONObject:()=>new e({name:`JSONObject`,zod:t.record(t.string(),t.any()),parseValue:e=>t.record(t.string(),t.any()).parse(e),serialize:e=>e??{},jsonSchema:{type:`object`}}),Date:()=>new e({name:`Date`,zod:t.date(),parseValue:e=>e instanceof Date?e:new Date(String(e)),serialize:e=>e instanceof Date?e.toISOString().split(`T`)[0]:String(e),jsonSchema:{type:`string`,format:`date`}}),DateTime:()=>new e({name:`DateTime`,zod:t.date(),parseValue:e=>e instanceof Date?e:new Date(String(e)),serialize:e=>e instanceof Date?e.toISOString():String(e),jsonSchema:{type:`string`,format:`date-time`}}),Time:()=>new e({name:`Time`,zod:t.string().regex(/^\d{2}:\d{2}(:\d{2})?$/),parseValue:e=>t.string().regex(/^\d{2}:\d{2}(:\d{2})?$/).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:`^\\d{2}:\\d{2}(:\\d{2})?$`}}),EmailAddress:()=>new e({name:`EmailAddress`,zod:t.string().email(),parseValue:e=>t.string().email().parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,format:`email`}}),URL:()=>new e({name:`URL`,zod:t.string().url(),parseValue:e=>t.string().url().parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,format:`uri`}}),PhoneNumber:()=>new e({name:`PhoneNumber`,zod:t.string().regex(a),parseValue:e=>t.string().regex(a).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:a.source}}),NonEmptyString:()=>new e({name:`NonEmptyString`,zod:t.string().min(1),parseValue:e=>t.string().min(1).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,minLength:1}}),Locale:()=>new e({name:`Locale`,zod:t.string().regex(r),parseValue:e=>t.string().regex(r).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:r.source}}),TimeZone:()=>new e({name:`TimeZone`,zod:t.string().regex(i),parseValue:e=>t.string().regex(i).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:i.source}}),Latitude:()=>new e({name:`Latitude`,zod:t.number().min(-90).max(90),parseValue:e=>t.coerce.number().min(-90).max(90).parse(e),serialize:e=>Number(e),jsonSchema:{type:`number`,minimum:-90,maximum:90}}),Longitude:()=>new e({name:`Longitude`,zod:t.number().min(c).max(180),parseValue:e=>t.coerce.number().min(c).max(180).parse(e),serialize:e=>Number(e),jsonSchema:{type:`number`,minimum:c,maximum:180}}),Currency:()=>new e({name:`Currency`,zod:t.string().regex(o),parseValue:e=>t.string().regex(o).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:o.source}}),CountryCode:()=>new e({name:`CountryCode`,zod:t.string().regex(s),parseValue:e=>t.string().regex(s).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:s.source}})};export{l};
+import { FieldType } from "./FieldType.js";
+import * as z$1 from "zod";
+import { Kind } from "graphql";
+
+//#region ../schema/dist/ScalarTypeEnum.js
+const localeRegex = /^[A-Za-z]{2}(?:-[A-Za-z0-9]{2,8})*$/;
+const timezoneRegex = /^(?:UTC|[A-Za-z_]+\/[A-Za-z_]+)$/;
+const phoneRegex = /^[+]?\d[\d\s().-]{3,}$/;
+const currencyRegex = /^[A-Z]{3}$/;
+const countryRegex = /^[A-Z]{2}$/;
+const latMin = -90;
+const latMax = 90;
+const lonMin = -180;
+const lonMax = 180;
+/**
+* Factory functions for common scalar FieldTypes with zod/GraphQL/JSON Schema.
+*/
+const ScalarTypeEnum = {
+	String_unsecure: () => new FieldType({
+		name: "String_unsecure",
+		description: "Unvalidated string scalar",
+		zod: z$1.string(),
+		parseValue: (v) => z$1.string().parse(v),
+		serialize: (v) => String(v),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.STRING) throw new TypeError("Invalid literal");
+			return ast.value;
+		},
+		jsonSchema: { type: "string" }
+	}),
+	Int_unsecure: () => new FieldType({
+		name: "Int_unsecure",
+		description: "Unvalidated integer scalar",
+		zod: z$1.number().int(),
+		parseValue: (v) => {
+			const num = typeof v === "number" ? v : Number(v);
+			return z$1.number().int().parse(num);
+		},
+		serialize: (v) => Math.trunc(typeof v === "number" ? v : Number(v)),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.INT) throw new TypeError("Invalid literal");
+			return Number(ast.value);
+		},
+		jsonSchema: { type: "integer" }
+	}),
+	Float_unsecure: () => new FieldType({
+		name: "Float_unsecure",
+		description: "Unvalidated float scalar",
+		zod: z$1.number(),
+		parseValue: (v) => {
+			const num = typeof v === "number" ? v : Number(v);
+			return z$1.number().parse(num);
+		},
+		serialize: (v) => Number(v),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.FLOAT && ast.kind !== Kind.INT) throw new TypeError("Invalid literal");
+			return Number(ast.value);
+		},
+		jsonSchema: { type: "number" }
+	}),
+	Boolean: () => new FieldType({
+		name: "Boolean",
+		description: "Unvalidated boolean scalar",
+		zod: z$1.boolean(),
+		parseValue: (v) => z$1.coerce.boolean().parse(v),
+		serialize: (v) => Boolean(v),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.BOOLEAN) throw new TypeError("Invalid literal");
+			return ast.value;
+		},
+		jsonSchema: { type: "boolean" }
+	}),
+	ID: () => new FieldType({
+		name: "ID",
+		description: "Unvalidated id scalar",
+		zod: z$1.string(),
+		parseValue: (v) => z$1.string().parse(v),
+		serialize: (v) => String(v),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.STRING) throw new TypeError("Invalid literal");
+			return ast.value;
+		},
+		jsonSchema: { type: "string" }
+	}),
+	JSON: () => new FieldType({
+		name: "JSON",
+		zod: z$1.any(),
+		parseValue: (v) => v,
+		serialize: (v) => v,
+		jsonSchema: {}
+	}),
+	JSONObject: () => new FieldType({
+		name: "JSONObject",
+		zod: z$1.record(z$1.string(), z$1.any()),
+		parseValue: (v) => z$1.record(z$1.string(), z$1.any()).parse(v),
+		serialize: (v) => v ?? {},
+		jsonSchema: { type: "object" }
+	}),
+	Date: () => new FieldType({
+		name: "Date",
+		zod: z$1.date(),
+		parseValue: (v) => v instanceof Date ? v : new Date(String(v)),
+		serialize: (v) => v instanceof Date ? v.toISOString().split("T")[0] : String(v),
+		jsonSchema: {
+			type: "string",
+			format: "date"
+		}
+	}),
+	DateTime: () => new FieldType({
+		name: "DateTime",
+		zod: z$1.date(),
+		parseValue: (v) => v instanceof Date ? v : new Date(String(v)),
+		serialize: (v) => {
+			return v instanceof Date ? v.toISOString() : String(v);
+		},
+		jsonSchema: {
+			type: "string",
+			format: "date-time"
+		}
+	}),
+	Time: () => new FieldType({
+		name: "Time",
+		zod: z$1.string().regex(/^\d{2}:\d{2}(:\d{2})?$/),
+		parseValue: (v) => z$1.string().regex(/^\d{2}:\d{2}(:\d{2})?$/).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: "^\\d{2}:\\d{2}(:\\d{2})?$"
+		}
+	}),
+	EmailAddress: () => new FieldType({
+		name: "EmailAddress",
+		zod: z$1.string().email(),
+		parseValue: (v) => z$1.string().email().parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			format: "email"
+		}
+	}),
+	URL: () => new FieldType({
+		name: "URL",
+		zod: z$1.string().url(),
+		parseValue: (v) => z$1.string().url().parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			format: "uri"
+		}
+	}),
+	PhoneNumber: () => new FieldType({
+		name: "PhoneNumber",
+		zod: z$1.string().regex(phoneRegex),
+		parseValue: (v) => z$1.string().regex(phoneRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: phoneRegex.source
+		}
+	}),
+	NonEmptyString: () => new FieldType({
+		name: "NonEmptyString",
+		zod: z$1.string().min(1),
+		parseValue: (v) => z$1.string().min(1).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			minLength: 1
+		}
+	}),
+	Locale: () => new FieldType({
+		name: "Locale",
+		zod: z$1.string().regex(localeRegex),
+		parseValue: (v) => z$1.string().regex(localeRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: localeRegex.source
+		}
+	}),
+	TimeZone: () => new FieldType({
+		name: "TimeZone",
+		zod: z$1.string().regex(timezoneRegex),
+		parseValue: (v) => z$1.string().regex(timezoneRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: timezoneRegex.source
+		}
+	}),
+	Latitude: () => new FieldType({
+		name: "Latitude",
+		zod: z$1.number().min(latMin).max(latMax),
+		parseValue: (v) => z$1.coerce.number().min(latMin).max(latMax).parse(v),
+		serialize: (v) => Number(v),
+		jsonSchema: {
+			type: "number",
+			minimum: latMin,
+			maximum: latMax
+		}
+	}),
+	Longitude: () => new FieldType({
+		name: "Longitude",
+		zod: z$1.number().min(lonMin).max(lonMax),
+		parseValue: (v) => z$1.coerce.number().min(lonMin).max(lonMax).parse(v),
+		serialize: (v) => Number(v),
+		jsonSchema: {
+			type: "number",
+			minimum: lonMin,
+			maximum: lonMax
+		}
+	}),
+	Currency: () => new FieldType({
+		name: "Currency",
+		zod: z$1.string().regex(currencyRegex),
+		parseValue: (v) => z$1.string().regex(currencyRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: currencyRegex.source
+		}
+	}),
+	CountryCode: () => new FieldType({
+		name: "CountryCode",
+		zod: z$1.string().regex(countryRegex),
+		parseValue: (v) => z$1.string().regex(countryRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: countryRegex.source
+		}
+	})
+};
+
+//#endregion
+export { ScalarTypeEnum };

package/dist/schema/dist/SchemaModel.js

@@ -1 +1,39 @@
-import"./EnumType.js";import"./FieldType.js";import*as e from"zod";var t=class{constructor(e){this.config=e}getZod(){let t=Object.entries(this.config.fields).reduce((t,[n,r])=>{let i=r.type.getZod(),a=r.isArray?e.array(i):i;return t[n]=r.isOptional?a.optional():a,t},{});return e.object(t)}getPothosInput(){return this.config.name}};const n=e=>new t(e);export{n,t};
+import "./EnumType.js";
+import "./FieldType.js";
+import * as z$1 from "zod";
+
+//#region ../schema/dist/SchemaModel.js
+/**
+* Named object model built from FieldType/EnumType/SchemaModel fields.
+* Provides zod and GraphQL input helpers, and supports arrays/optional fields.
+*/
+var SchemaModel = class {
+	constructor(config) {
+		this.config = config;
+	}
+	/**
+	* Build a typed ZodObject from the model fields, preserving each field's
+	* Zod schema and optionality at the type level when possible.
+	*/
+	getZod() {
+		const shape = Object.entries(this.config.fields).reduce((acc, [key, def]) => {
+			const base = def.type.getZod();
+			const withArray = def.isArray ? z$1.array(base) : base;
+			acc[key] = def.isOptional ? withArray.optional() : withArray;
+			return acc;
+		}, {});
+		return z$1.object(shape);
+	}
+	/** Input object name for GraphQL builder adapters. */
+	getPothosInput() {
+		return this.config.name;
+	}
+};
+/**
+* Helper to define a SchemaModel with type inference.
+* Equivalent to `new SchemaModel(config)` but with better ergonomics.
+*/
+const defineSchemaModel = (config) => new SchemaModel(config);
+
+//#endregion
+export { SchemaModel, defineSchemaModel };

package/dist/schema/dist/entity/defineEntity.js

@@ -1 +1 @@
-import"zod";
+import "zod";

package/dist/schema/dist/entity/index.js

@@ -1 +1,2 @@
-import"./defineEntity.js";import"./types.js";
+import "./defineEntity.js";
+import "./types.js";

package/dist/schema/dist/entity/types.js

@@ -1 +1 @@
-import"zod";
+import "zod";

package/dist/schema/dist/index.js

@@ -1 +1,6 @@
-import"./EnumType.js";import{t as e}from"./FieldType.js";import{l as t}from"./ScalarTypeEnum.js";import{n,t as r}from"./SchemaModel.js";import"./entity/defineEntity.js";import"./entity/index.js";
+import "./EnumType.js";
+import { FieldType } from "./FieldType.js";
+import { ScalarTypeEnum } from "./ScalarTypeEnum.js";
+import { SchemaModel, defineSchemaModel } from "./SchemaModel.js";
+import "./entity/defineEntity.js";
+import "./entity/index.js";

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(schema, 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/graphql-pothos.js

@@ -1 +1,128 @@
-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"@pothos/plugin-prisma";import"@pothos/plugin-complexity";import"@pothos/plugin-relay";import"@pothos/plugin-dataloader";import"@pothos/plugin-tracing";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 { hydrateResourceIfNeeded, parseReturns } from "../contracts-adapter-hydration.js";
+import { createInputTypeBuilder } from "../contracts-adapter-input.js";
+import { defaultGqlField } from "../jsonschema.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 SpecRegistry onto a Pothos SchemaBuilder.
+*
+* This adapter:
+* 1. Discovers output types from specs and registers them as Pothos object types.
+* 2. Maps `ContractSpec` 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 `SpecRegistry`.
+*    - Hydrate resource references if applicable.
+*
+* @param builder - The Pothos SchemaBuilder instance.
+* @param reg - The SpecRegistry 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.name, spec.meta.version);
+		spec.transport?.gql?.returns;
+		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.name, 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 };