@stonecrop/schema 0.31.0 → 0.32.0

package/README.md

@@ -17,10 +17,10 @@ This package is schema-only and has no UI dependencies - it can be used in both
 ## Installation
 
 ```bash
-# From the monorepo root
-rush update
+# From the monorepo root, which links the workspace copy
+pnpm install
 
-# Or with pnpm
+# Or, in a consuming project
 pnpm add @stonecrop/schema
 ```
 
@@ -437,20 +437,20 @@ This package provides the type system used throughout Stonecrop:
 ## Development
 
 ```bash
-# Install dependencies
-rush update
+# Install dependencies (from the repo root)
+pnpm install
 
-# Build
-rushx build
+# Build (a Vite+ task, so `pnpm run build` does not resolve it)
+pnpm exec vp run build
 
 # Run tests
-rushx test
+pnpm run test
 
 # Watch mode
-rushx test:watch
+pnpm run test:watch
 
 # Generate API documentation
-rushx docs
+pnpm run docs
 ```
 
 ## TypeScript Support

package/dist/cli.js

@@ -1,124 +1,194 @@
 #!/usr/bin/env node
-import { readFileSync as i, existsSync as y, mkdirSync as E, writeFileSync as C } from "node:fs";
-import { resolve as u, join as A } from "node:path";
-import { parseArgs as J } from "node:util";
-import { getIntrospectionQuery as R } from "graphql";
-import { c as F, a as G, p as L, m as q, f as D, s as T, v as U } from "./validation-C9P__pRF.js";
-async function Q(e, w) {
-  const o = await fetch(e, {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      ...w
-    },
-    body: JSON.stringify({
-      query: R()
-    })
-  });
-  if (!o.ok)
-    throw new Error(`Failed to fetch introspection: ${o.status} ${o.statusText}`);
-  const l = await o.json();
-  if (l.errors?.length)
-    throw new Error(`GraphQL errors: ${l.errors.map((r) => r.message).join(", ")}`);
-  if (!l.data)
-    throw new Error("No data in introspection response");
-  return l.data;
+import { G as stripFieldKind, _ as validateDoctype, i as authoredPrimaryKey, n as formatDoctypeDrift, r as mergeIntrospectedDoctype, s as planGeneration, t as convertGraphQLSchema } from "./converter-CLwduvT_.js";
+import { getIntrospectionQuery } from "graphql";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { parseArgs } from "node:util";
+//#region src/cli.ts
+/**
+* Stonecrop Schema CLI
+*
+* Converts GraphQL introspection results to Stonecrop doctype JSON schemas.
+*
+* Usage:
+*   stonecrop-schema generate --endpoint <url> --output <dir>
+*   stonecrop-schema generate --introspection <file.json> --output <dir>
+*   stonecrop-schema generate --sdl <file.graphql> --output <dir>
+*
+* @packageDocumentation
+*/
+/**
+* Fetch an introspection result from a live GraphQL endpoint.
+*
+* @param endpoint - The GraphQL endpoint URL
+* @param headers - Optional HTTP headers
+* @returns The introspection query result
+*/
+async function fetchIntrospection(endpoint, headers) {
+	const response = await fetch(endpoint, {
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			...headers
+		},
+		body: JSON.stringify({ query: getIntrospectionQuery() })
+	});
+	if (!response.ok) throw new Error(`Failed to fetch introspection: ${response.status} ${response.statusText}`);
+	const json = await response.json();
+	if (json.errors?.length) throw new Error(`GraphQL errors: ${json.errors.map((e) => e.message).join(", ")}`);
+	if (!json.data) throw new Error("No data in introspection response");
+	return json.data;
 }
-async function W() {
-  const { values: e, positionals: w } = J({
-    allowPositionals: !0,
-    options: {
-      endpoint: { type: "string", short: "e" },
-      introspection: { type: "string", short: "i" },
-      sdl: { type: "string", short: "s" },
-      output: { type: "string", short: "o" },
-      include: { type: "string" },
-      exclude: { type: "string" },
-      names: { type: "string" },
-      "custom-scalars": { type: "string" },
-      "include-unmapped": { type: "boolean", default: !1 },
-      "no-aggregates": { type: "boolean", default: !1 },
-      check: { type: "boolean", default: !1 },
-      help: { type: "boolean", short: "h" }
-    }
-  }), o = w[0];
-  (e.help || !o) && (I(), process.exit(o ? 0 : 1)), o !== "generate" && (console.error(`Unknown command: ${o}`), console.error("Available commands: generate"), process.exit(1)), [e.endpoint, e.introspection, e.sdl].filter(Boolean).length !== 1 && (console.error("Exactly one of --endpoint, --introspection, or --sdl must be provided"), process.exit(1)), e.output || (console.error("--output <dir> is required"), process.exit(1));
-  const r = u(e.output), c = {
-    includeUnmappedMeta: e["include-unmapped"]
-  };
-  if (e.include && (c.include = e.include.split(",").map((t) => t.trim())), e.exclude && (c.exclude = e.exclude.split(",").map((t) => t.trim())), e.names) {
-    const t = u(e.names);
-    c.doctypeNames = JSON.parse(i(t, "utf-8"));
-  }
-  if (c.onWarning = (t) => console.warn(`  WARN: ${t}`), e["custom-scalars"]) {
-    const t = u(e["custom-scalars"]), n = i(t, "utf-8");
-    c.customScalars = JSON.parse(n);
-  }
-  let h;
-  if (e.endpoint)
-    console.log(`Fetching introspection from ${e.endpoint}...`), h = await Q(e.endpoint);
-  else if (e.introspection) {
-    const t = u(e.introspection), n = i(t, "utf-8"), a = JSON.parse(n);
-    h = a.data ?? a;
-  } else {
-    const t = u(e.sdl);
-    h = i(t, "utf-8");
-  }
-  const v = F(h, c);
-  v.length === 0 && (console.warn("No entity types found in the schema. Check your include/exclude filters."), process.exit(0));
-  const O = {};
-  for (const t of v) {
-    const n = A(r, `${t.slug}.json`);
-    if (!y(n)) continue;
-    const a = G(JSON.parse(i(n, "utf-8")));
-    a !== void 0 && (O[t.name] = a);
-  }
-  const k = L(v, {
-    noAggregates: e["no-aggregates"],
-    identity: O,
-    onWarning: (t) => console.warn(`  WARN: ${t}`)
-  });
-  y(r) || E(r, { recursive: !0 });
-  let S = 0, f = 0, m = 0;
-  const $ = [];
-  for (const { generated: t, basis: n, subset: a } of k) {
-    const x = `${t.slug}.json`, p = A(r, x);
-    let N = t;
-    if (y(p)) {
-      const { doctype: s, drift: d } = q(JSON.parse(i(p, "utf-8")), n, {
-        subset: a
-      });
-      N = s, $.push(...D(d));
-    }
-    const g = { ...N };
-    Array.isArray(g.fields) && (g.fields = g.fields.map(T));
-    const b = JSON.stringify(g, null, "	") + `
-`, j = y(p) && i(p, "utf-8") === b;
-    j || m++, !e.check && !j && C(p, b, "utf-8");
-    const P = U(N);
-    if (P.success) {
-      const s = t.fields.filter((d) => d._unmapped);
-      s.length > 0 && (S++, console.warn(
-        `  WARN: ${x} has ${s.length} unmapped field(s): ${s.map((d) => d.fieldname).join(", ")}`
-      ));
-    } else {
-      f++, console.error(`  ERROR: ${x} failed validation:`);
-      for (const s of P.errors)
-        console.error(`    ${s.path.join(".")}: ${s.message}`);
-    }
-  }
-  if ($.length > 0) {
-    console.log(`
-Drift between the authored doctypes and the schema (reported, not applied):`);
-    for (const t of $) console.log(t);
-  }
-  console.log(
-    `
-${e.check ? "Checked" : "Generated"} ${k.length} doctype(s) in ${r}` + (m ? ` (${m} ${e.check ? "would change" : "written"})` : " (all up to date)") + (S ? ` (${S} with warnings)` : "") + (f ? ` (${f} with errors)` : "")
-  ), (f > 0 || e.check && m > 0) && process.exit(1);
+async function main() {
+	const { values, positionals } = parseArgs({
+		allowPositionals: true,
+		options: {
+			endpoint: {
+				type: "string",
+				short: "e"
+			},
+			introspection: {
+				type: "string",
+				short: "i"
+			},
+			sdl: {
+				type: "string",
+				short: "s"
+			},
+			output: {
+				type: "string",
+				short: "o"
+			},
+			include: { type: "string" },
+			exclude: { type: "string" },
+			names: { type: "string" },
+			"custom-scalars": { type: "string" },
+			"include-unmapped": {
+				type: "boolean",
+				default: false
+			},
+			"no-aggregates": {
+				type: "boolean",
+				default: false
+			},
+			check: {
+				type: "boolean",
+				default: false
+			},
+			help: {
+				type: "boolean",
+				short: "h"
+			}
+		}
+	});
+	const command = positionals[0];
+	if (values.help || !command) {
+		printHelp();
+		process.exit(command ? 0 : 1);
+	}
+	if (command !== "generate") {
+		console.error(`Unknown command: ${command}`);
+		console.error("Available commands: generate");
+		process.exit(1);
+	}
+	if ([
+		values.endpoint,
+		values.introspection,
+		values.sdl
+	].filter(Boolean).length !== 1) {
+		console.error("Exactly one of --endpoint, --introspection, or --sdl must be provided");
+		process.exit(1);
+	}
+	if (!values.output) {
+		console.error("--output <dir> is required");
+		process.exit(1);
+	}
+	const outputDir = resolve(values.output);
+	const options = { includeUnmappedMeta: values["include-unmapped"] };
+	if (values.include) options.include = values.include.split(",").map((s) => s.trim());
+	if (values.exclude) options.exclude = values.exclude.split(",").map((s) => s.trim());
+	if (values.names) {
+		const namesPath = resolve(values.names);
+		options.doctypeNames = JSON.parse(readFileSync(namesPath, "utf-8"));
+	}
+	options.onWarning = (message) => console.warn(`  WARN: ${message}`);
+	if (values["custom-scalars"]) {
+		const scalarsPath = resolve(values["custom-scalars"]);
+		const scalarsContent = readFileSync(scalarsPath, "utf-8");
+		options.customScalars = JSON.parse(scalarsContent);
+	}
+	let source;
+	if (values.endpoint) {
+		console.log(`Fetching introspection from ${values.endpoint}...`);
+		source = await fetchIntrospection(values.endpoint);
+	} else if (values.introspection) {
+		const filePath = resolve(values.introspection);
+		const content = readFileSync(filePath, "utf-8");
+		const parsed = JSON.parse(content);
+		source = parsed.data ?? parsed;
+	} else {
+		const filePath = resolve(values.sdl);
+		source = readFileSync(filePath, "utf-8");
+	}
+	const entities = convertGraphQLSchema(source, options);
+	if (entities.length === 0) {
+		console.warn("No entity types found in the schema. Check your include/exclude filters.");
+		process.exit(0);
+	}
+	const identity = {};
+	for (const entity of entities) {
+		const entityPath = join(outputDir, `${entity.slug}.json`);
+		if (!existsSync(entityPath)) continue;
+		const declared = authoredPrimaryKey(JSON.parse(readFileSync(entityPath, "utf-8")));
+		if (declared !== void 0) identity[entity.name] = declared;
+	}
+	const doctypes = planGeneration(entities, {
+		noAggregates: values["no-aggregates"],
+		identity,
+		onWarning: (message) => console.warn(`  WARN: ${message}`)
+	});
+	if (!existsSync(outputDir)) mkdirSync(outputDir, { recursive: true });
+	let warnings = 0;
+	let errors = 0;
+	let changed = 0;
+	const driftLines = [];
+	for (const { generated, basis, subset } of doctypes) {
+		const fileName = `${generated.slug}.json`;
+		const filePath = join(outputDir, fileName);
+		let output = generated;
+		if (existsSync(filePath)) {
+			const { doctype: merged, drift } = mergeIntrospectedDoctype(JSON.parse(readFileSync(filePath, "utf-8")), basis, { subset });
+			output = merged;
+			driftLines.push(...formatDoctypeDrift(drift));
+		}
+		const serializable = { ...output };
+		if (Array.isArray(serializable.fields)) serializable.fields = serializable.fields.map(stripFieldKind);
+		const json = JSON.stringify(serializable, null, "	") + "\n";
+		const unchanged = existsSync(filePath) && readFileSync(filePath, "utf-8") === json;
+		if (!unchanged) changed++;
+		if (!values.check && !unchanged) writeFileSync(filePath, json, "utf-8");
+		const validation = validateDoctype(output);
+		if (!validation.success) {
+			errors++;
+			console.error(`  ERROR: ${fileName} failed validation:`);
+			for (const err of validation.errors) console.error(`    ${err.path.join(".")}: ${err.message}`);
+		} else {
+			const unmappedFields = generated.fields.filter((f) => f._unmapped);
+			if (unmappedFields.length > 0) {
+				warnings++;
+				console.warn(`  WARN: ${fileName} has ${unmappedFields.length} unmapped field(s): ${unmappedFields.map((f) => f.fieldname).join(", ")}`);
+			}
+		}
+	}
+	if (driftLines.length > 0) {
+		console.log("\nDrift between the authored doctypes and the schema (reported, not applied):");
+		for (const line of driftLines) console.log(line);
+	}
+	console.log(`\n${values.check ? "Checked" : "Generated"} ${doctypes.length} doctype(s) in ${outputDir}` + (changed ? ` (${changed} ${values.check ? "would change" : "written"})` : " (all up to date)") + (warnings ? ` (${warnings} with warnings)` : "") + (errors ? ` (${errors} with errors)` : ""));
+	if (errors > 0 || values.check && changed > 0) process.exit(1);
 }
-function I() {
-  console.log(`
+function printHelp() {
+	console.log(`
 stonecrop-schema - Convert GraphQL schemas to Stonecrop doctypes
 
 USAGE:
@@ -172,7 +242,10 @@ EXAMPLES:
     --include "User,Post,Comment"
 `);
 }
-W().catch((e) => {
-  console.error("Error:", e.message), process.exit(1);
+main().catch((err) => {
+	console.error("Error:", err.message);
+	process.exit(1);
 });
-//# sourceMappingURL=cli.js.map
+//#endregion
+
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/* oxlint-disable no-console */\n\n/**\n * Stonecrop Schema CLI\n *\n * Converts GraphQL introspection results to Stonecrop doctype JSON schemas.\n *\n * Usage:\n *   stonecrop-schema generate --endpoint <url> --output <dir>\n *   stonecrop-schema generate --introspection <file.json> --output <dir>\n *   stonecrop-schema generate --sdl <file.graphql> --output <dir>\n *\n * @packageDocumentation\n */\n\nimport { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs'\nimport { resolve, join } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport { getIntrospectionQuery, type IntrospectionQuery } from 'graphql'\n\nimport { authoredPrimaryKey } from './converter/authored'\nimport { convertGraphQLSchema, formatDoctypeDrift, mergeIntrospectedDoctype, planGeneration } from './converter/index'\nimport { stripFieldKind } from './field'\nimport { validateDoctype } from './validation'\nimport type { GraphQLConversionOptions } from './converter/types'\n\n/**\n * Fetch an introspection result from a live GraphQL endpoint.\n *\n * @param endpoint - The GraphQL endpoint URL\n * @param headers - Optional HTTP headers\n * @returns The introspection query result\n */\nasync function fetchIntrospection(endpoint: string, headers?: Record<string, string>): Promise<IntrospectionQuery> {\n\tconst response = await fetch(endpoint, {\n\t\tmethod: 'POST',\n\t\theaders: {\n\t\t\t'Content-Type': 'application/json',\n\t\t\t...headers,\n\t\t},\n\t\tbody: JSON.stringify({\n\t\t\tquery: getIntrospectionQuery(),\n\t\t}),\n\t})\n\n\tif (!response.ok) {\n\t\tthrow new Error(`Failed to fetch introspection: ${response.status} ${response.statusText}`)\n\t}\n\n\tconst json: { data?: IntrospectionQuery; errors?: Array<{ message: string }> } = await response.json()\n\n\tif (json.errors?.length) {\n\t\tthrow new Error(`GraphQL errors: ${json.errors.map(e => e.message).join(', ')}`)\n\t}\n\n\tif (!json.data) {\n\t\tthrow new Error('No data in introspection response')\n\t}\n\n\treturn json.data\n}\n\nasync function main(): Promise<void> {\n\tconst { values, positionals } = parseArgs({\n\t\tallowPositionals: true,\n\t\toptions: {\n\t\t\tendpoint: { type: 'string', short: 'e' },\n\t\t\tintrospection: { type: 'string', short: 'i' },\n\t\t\tsdl: { type: 'string', short: 's' },\n\t\t\toutput: { type: 'string', short: 'o' },\n\t\t\tinclude: { type: 'string' },\n\t\t\texclude: { type: 'string' },\n\t\t\tnames: { type: 'string' },\n\t\t\t'custom-scalars': { type: 'string' },\n\t\t\t'include-unmapped': { type: 'boolean', default: false },\n\t\t\t'no-aggregates': { type: 'boolean', default: false },\n\t\t\tcheck: { type: 'boolean', default: false },\n\t\t\thelp: { type: 'boolean', short: 'h' },\n\t\t},\n\t})\n\n\tconst command = positionals[0]\n\n\tif (values.help || !command) {\n\t\tprintHelp()\n\t\tprocess.exit(command ? 0 : 1)\n\t}\n\n\tif (command !== 'generate') {\n\t\tconsole.error(`Unknown command: ${command}`)\n\t\tconsole.error('Available commands: generate')\n\t\tprocess.exit(1)\n\t}\n\n\t// Determine source\n\tconst sourceCount = [values.endpoint, values.introspection, values.sdl].filter(Boolean).length\n\tif (sourceCount !== 1) {\n\t\tconsole.error('Exactly one of --endpoint, --introspection, or --sdl must be provided')\n\t\tprocess.exit(1)\n\t}\n\n\tif (!values.output) {\n\t\tconsole.error('--output <dir> is required')\n\t\tprocess.exit(1)\n\t}\n\n\tconst outputDir = resolve(values.output)\n\n\t// Build conversion options\n\tconst options: GraphQLConversionOptions = {\n\t\tincludeUnmappedMeta: values['include-unmapped'],\n\t}\n\n\tif (values.include) {\n\t\toptions.include = values.include.split(',').map(s => s.trim())\n\t}\n\n\tif (values.exclude) {\n\t\toptions.exclude = values.exclude.split(',').map(s => s.trim())\n\t}\n\n\tif (values.names) {\n\t\tconst namesPath = resolve(values.names)\n\t\toptions.doctypeNames = JSON.parse(readFileSync(namesPath, 'utf-8'))\n\t}\n\n\toptions.onWarning = message => console.warn(`  WARN: ${message}`)\n\n\tif (values['custom-scalars']) {\n\t\tconst scalarsPath = resolve(values['custom-scalars'])\n\t\tconst scalarsContent = readFileSync(scalarsPath, 'utf-8')\n\t\toptions.customScalars = JSON.parse(scalarsContent)\n\t}\n\n\t// Resolve source\n\tlet source: IntrospectionQuery | string\n\n\tif (values.endpoint) {\n\t\tconsole.log(`Fetching introspection from ${values.endpoint}...`)\n\t\tsource = await fetchIntrospection(values.endpoint)\n\t} else if (values.introspection) {\n\t\tconst filePath = resolve(values.introspection)\n\t\tconst content = readFileSync(filePath, 'utf-8')\n\t\tconst parsed = JSON.parse(content)\n\t\t// Handle both { data: { __schema: ... } } and { __schema: ... } formats\n\t\tsource = parsed.data ?? parsed\n\t} else {\n\t\tconst filePath = resolve(values.sdl!)\n\t\tsource = readFileSync(filePath, 'utf-8')\n\t}\n\n\t// Convert\n\tconst entities = convertGraphQLSchema(source, options)\n\n\tif (entities.length === 0) {\n\t\tconsole.warn('No entity types found in the schema. Check your include/exclude filters.')\n\t\tprocess.exit(0)\n\t}\n\n\t// Read the identity each authored doctype declares, before planning rather than during the write\n\t// loop below. SDL cannot express which UNIQUE column is a table's key, so for a natural-key\n\t// doctype the declaration in the file is the only answer that exists — and planning is what\n\t// decides whether the aggregate can be built at all. Reading it 20 lines later, as the loop\n\t// does, made the \"declare a primaryKey and re-run\" warning a dead end: re-running after\n\t// declaring one changed nothing.\n\tconst identity: Record<string, string> = {}\n\tfor (const entity of entities) {\n\t\tconst entityPath = join(outputDir, `${entity.slug}.json`)\n\t\tif (!existsSync(entityPath)) continue\n\t\tconst declared = authoredPrimaryKey(JSON.parse(readFileSync(entityPath, 'utf-8')))\n\t\tif (declared !== undefined) identity[entity.name] = declared\n\t}\n\n\t// Each table yields two doctypes — the entity and its aggregate — written as peers, one file\n\t// each, along with what each is verified against. See `planGeneration`.\n\tconst doctypes = planGeneration(entities, {\n\t\tnoAggregates: values['no-aggregates'],\n\t\tidentity,\n\t\tonWarning: message => console.warn(`  WARN: ${message}`),\n\t})\n\n\t// Write output\n\tif (!existsSync(outputDir)) {\n\t\tmkdirSync(outputDir, { recursive: true })\n\t}\n\n\tlet warnings = 0\n\tlet errors = 0\n\tlet changed = 0\n\tconst driftLines: string[] = []\n\n\tfor (const { generated, basis, subset } of doctypes) {\n\t\tconst fileName = `${generated.slug}.json`\n\t\tconst filePath = join(outputDir, fileName)\n\n\t\t// When a doctype already exists it is the source of truth: generation confirms it and adds\n\t\t// provenance markers, and reports anything it disagrees with rather than applying it. A\n\t\t// doctype legitimately declares identity the schema cannot express — most often a natural\n\t\t// key that is a UNIQUE constraint, not the table's PRIMARY KEY — and overwriting that would\n\t\t// silently re-key the doctype on every run. A first generation has nothing to merge into,\n\t\t// so converter output is written verbatim.\n\t\tlet output: object = generated\n\t\tif (existsSync(filePath)) {\n\t\t\tconst { doctype: merged, drift } = mergeIntrospectedDoctype(JSON.parse(readFileSync(filePath, 'utf-8')), basis, {\n\t\t\t\tsubset,\n\t\t\t})\n\t\t\toutput = merged\n\t\t\tdriftLines.push(...formatDoctypeDrift(drift))\n\t\t}\n\n\t\t// Serialize the merged object directly. Never round-trip it through the Zod parser first:\n\t\t// that runs in strip mode and would silently drop every key this package does not model,\n\t\t// `handler` on an action being the one consumers actually rely on.\n\t\t//\n\t\t// `kind` is dropped on the way out because it is the discriminated-union tag the parser\n\t\t// synthesizes, not authored data — `injectKind` puts it back on every read. Writing it made\n\t\t// the generator and the docbuilder disagree with hand-authored files about what a doctype\n\t\t// looks like, and re-added the key on every regeneration.\n\t\tconst serializable: Record<string, unknown> = { ...output }\n\t\tif (Array.isArray(serializable.fields)) {\n\t\t\tserializable.fields = serializable.fields.map(stripFieldKind)\n\t\t}\n\t\tconst json = JSON.stringify(serializable, null, '\\t') + '\\n'\n\t\tconst unchanged = existsSync(filePath) && readFileSync(filePath, 'utf-8') === json\n\t\tif (!unchanged) changed++\n\n\t\tif (!values.check && !unchanged) {\n\t\t\twriteFileSync(filePath, json, 'utf-8')\n\t\t}\n\n\t\t// Validate the output\n\t\tconst validation = validateDoctype(output)\n\t\tif (!validation.success) {\n\t\t\terrors++\n\t\t\tconsole.error(`  ERROR: ${fileName} failed validation:`)\n\t\t\tfor (const err of validation.errors) {\n\t\t\t\tconsole.error(`    ${err.path.join('.')}: ${err.message}`)\n\t\t\t}\n\t\t} else {\n\t\t\t// Check for unmapped fields\n\t\t\tconst unmappedFields = generated.fields.filter((f: any) => f._unmapped)\n\t\t\tif (unmappedFields.length > 0) {\n\t\t\t\twarnings++\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`  WARN: ${fileName} has ${unmappedFields.length} unmapped field(s): ${unmappedFields\n\t\t\t\t\t\t.map((f: any) => f.fieldname)\n\t\t\t\t\t\t.join(', ')}`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t}\n\n\tif (driftLines.length > 0) {\n\t\tconsole.log('\\nDrift between the authored doctypes and the schema (reported, not applied):')\n\t\tfor (const line of driftLines) console.log(line)\n\t}\n\n\tconsole.log(\n\t\t`\\n${values.check ? 'Checked' : 'Generated'} ${doctypes.length} doctype(s) in ${outputDir}` +\n\t\t\t(changed ? ` (${changed} ${values.check ? 'would change' : 'written'})` : ' (all up to date)') +\n\t\t\t(warnings ? ` (${warnings} with warnings)` : '') +\n\t\t\t(errors ? ` (${errors} with errors)` : '')\n\t)\n\n\tif (errors > 0 || (values.check && changed > 0)) {\n\t\tprocess.exit(1)\n\t}\n}\n\nfunction printHelp(): void {\n\tconsole.log(`\nstonecrop-schema - Convert GraphQL schemas to Stonecrop doctypes\n\nUSAGE:\n  stonecrop-schema generate [options]\n\nSOURCE (exactly one required):\n  --endpoint, -e <url>         Fetch introspection from a live GraphQL endpoint\n  --introspection, -i <file>   Read from a saved introspection JSON file\n  --sdl, -s <file>             Read from a GraphQL SDL (.graphql) file\n\nOUTPUT:\n  --output, -o <dir>           Directory to write doctype JSON files (required)\n\nOPTIONS:\n  --include <types>            Comma-separated list of type names to include\n  --exclude <types>            Comma-separated list of type names to exclude\n  --names <file>               JSON file mapping GraphQL type name to doctype name\n  --custom-scalars <file>      JSON file mapping custom scalar names to field templates\n  --include-unmapped           Include _graphqlType metadata on unmapped fields\n  --no-aggregates              Emit only the entity doctype, not its aggregate\n  --check                      Report drift and exit non-zero if anything would change; write nothing\n  --help, -h                   Show this help message\n\nEach table generates TWO doctypes: the entity (every column, backs the record form) and its\naggregate (the collection view, identity column only by default), named as simple plurals —\n'task.json' and 'tasks.json'. Widen an aggregate by adding fields to it — curation survives\nregeneration. A doctype whose name is already plural gets no aggregate, because it would claim\nits own name and its own file; the run says so and still writes the entity.\n\nAn aggregate needs an identity column. A table keyed on 'id' gives one up; for a natural key,\ndeclare 'primaryKey' on the field in the entity's own file and re-run — the aggregate is keyed\non whatever that file declares.\n\nNOTE: an existing doctype file is the source of truth. Regeneration verifies it against the\nschema and adds 'source: introspected' markers; it reports disagreements rather than\noverwriting them, so hand-curation survives. Use --check in CI.\n\nEXAMPLES:\n  # From a live PostGraphile server\n  stonecrop-schema generate -e http://localhost:5000/graphql -o ./schemas\n\n  # From a saved introspection result\n  stonecrop-schema generate -i introspection.json -o ./schemas\n\n  # From an SDL file with custom scalars\n  stonecrop-schema generate -s schema.graphql -o ./schemas \\\\\n    --custom-scalars custom-scalars.json\n\n  # Only convert specific types\n  stonecrop-schema generate -e http://localhost:5000/graphql -o ./schemas \\\\\n    --include \"User,Post,Comment\"\n`)\n}\n\nmain().catch(err => {\n\tconsole.error('Error:', err.message)\n\tprocess.exit(1)\n})\n"],"names":["fetchIntrospection","endpoint","headers","response","getIntrospectionQuery","json","e","main","values","positionals","parseArgs","command","printHelp","outputDir","resolve","options","s","namesPath","readFileSync","message","scalarsPath","scalarsContent","source","filePath","content","parsed","entities","convertGraphQLSchema","identity","entity","entityPath","join","existsSync","declared","authoredPrimaryKey","doctypes","planGeneration","mkdirSync","warnings","errors","changed","driftLines","generated","basis","subset","fileName","output","merged","drift","mergeIntrospectedDoctype","formatDoctypeDrift","serializable","stripFieldKind","unchanged","writeFileSync","validation","validateDoctype","unmappedFields","f","err","line"],"mappings":"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"}
+{"version":3,"file":"cli.js","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/* oxlint-disable no-console */\n\n/**\n * Stonecrop Schema CLI\n *\n * Converts GraphQL introspection results to Stonecrop doctype JSON schemas.\n *\n * Usage:\n *   stonecrop-schema generate --endpoint <url> --output <dir>\n *   stonecrop-schema generate --introspection <file.json> --output <dir>\n *   stonecrop-schema generate --sdl <file.graphql> --output <dir>\n *\n * @packageDocumentation\n */\n\nimport { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs'\nimport { resolve, join } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport { getIntrospectionQuery, type IntrospectionQuery } from 'graphql'\n\nimport { authoredPrimaryKey } from './converter/authored'\nimport { convertGraphQLSchema, formatDoctypeDrift, mergeIntrospectedDoctype, planGeneration } from './converter/index'\nimport { stripFieldKind } from './field'\nimport { validateDoctype } from './validation'\nimport type { GraphQLConversionOptions } from './converter/types'\n\n/**\n * Fetch an introspection result from a live GraphQL endpoint.\n *\n * @param endpoint - The GraphQL endpoint URL\n * @param headers - Optional HTTP headers\n * @returns The introspection query result\n */\nasync function fetchIntrospection(endpoint: string, headers?: Record<string, string>): Promise<IntrospectionQuery> {\n\tconst response = await fetch(endpoint, {\n\t\tmethod: 'POST',\n\t\theaders: {\n\t\t\t'Content-Type': 'application/json',\n\t\t\t...headers,\n\t\t},\n\t\tbody: JSON.stringify({\n\t\t\tquery: getIntrospectionQuery(),\n\t\t}),\n\t})\n\n\tif (!response.ok) {\n\t\tthrow new Error(`Failed to fetch introspection: ${response.status} ${response.statusText}`)\n\t}\n\n\tconst json: { data?: IntrospectionQuery; errors?: Array<{ message: string }> } = await response.json()\n\n\tif (json.errors?.length) {\n\t\tthrow new Error(`GraphQL errors: ${json.errors.map(e => e.message).join(', ')}`)\n\t}\n\n\tif (!json.data) {\n\t\tthrow new Error('No data in introspection response')\n\t}\n\n\treturn json.data\n}\n\nasync function main(): Promise<void> {\n\tconst { values, positionals } = parseArgs({\n\t\tallowPositionals: true,\n\t\toptions: {\n\t\t\tendpoint: { type: 'string', short: 'e' },\n\t\t\tintrospection: { type: 'string', short: 'i' },\n\t\t\tsdl: { type: 'string', short: 's' },\n\t\t\toutput: { type: 'string', short: 'o' },\n\t\t\tinclude: { type: 'string' },\n\t\t\texclude: { type: 'string' },\n\t\t\tnames: { type: 'string' },\n\t\t\t'custom-scalars': { type: 'string' },\n\t\t\t'include-unmapped': { type: 'boolean', default: false },\n\t\t\t'no-aggregates': { type: 'boolean', default: false },\n\t\t\tcheck: { type: 'boolean', default: false },\n\t\t\thelp: { type: 'boolean', short: 'h' },\n\t\t},\n\t})\n\n\tconst command = positionals[0]\n\n\tif (values.help || !command) {\n\t\tprintHelp()\n\t\tprocess.exit(command ? 0 : 1)\n\t}\n\n\tif (command !== 'generate') {\n\t\tconsole.error(`Unknown command: ${command}`)\n\t\tconsole.error('Available commands: generate')\n\t\tprocess.exit(1)\n\t}\n\n\t// Determine source\n\tconst sourceCount = [values.endpoint, values.introspection, values.sdl].filter(Boolean).length\n\tif (sourceCount !== 1) {\n\t\tconsole.error('Exactly one of --endpoint, --introspection, or --sdl must be provided')\n\t\tprocess.exit(1)\n\t}\n\n\tif (!values.output) {\n\t\tconsole.error('--output <dir> is required')\n\t\tprocess.exit(1)\n\t}\n\n\tconst outputDir = resolve(values.output)\n\n\t// Build conversion options\n\tconst options: GraphQLConversionOptions = {\n\t\tincludeUnmappedMeta: values['include-unmapped'],\n\t}\n\n\tif (values.include) {\n\t\toptions.include = values.include.split(',').map(s => s.trim())\n\t}\n\n\tif (values.exclude) {\n\t\toptions.exclude = values.exclude.split(',').map(s => s.trim())\n\t}\n\n\tif (values.names) {\n\t\tconst namesPath = resolve(values.names)\n\t\toptions.doctypeNames = JSON.parse(readFileSync(namesPath, 'utf-8'))\n\t}\n\n\toptions.onWarning = message => console.warn(`  WARN: ${message}`)\n\n\tif (values['custom-scalars']) {\n\t\tconst scalarsPath = resolve(values['custom-scalars'])\n\t\tconst scalarsContent = readFileSync(scalarsPath, 'utf-8')\n\t\toptions.customScalars = JSON.parse(scalarsContent)\n\t}\n\n\t// Resolve source\n\tlet source: IntrospectionQuery | string\n\n\tif (values.endpoint) {\n\t\tconsole.log(`Fetching introspection from ${values.endpoint}...`)\n\t\tsource = await fetchIntrospection(values.endpoint)\n\t} else if (values.introspection) {\n\t\tconst filePath = resolve(values.introspection)\n\t\tconst content = readFileSync(filePath, 'utf-8')\n\t\tconst parsed = JSON.parse(content)\n\t\t// Handle both { data: { __schema: ... } } and { __schema: ... } formats\n\t\tsource = parsed.data ?? parsed\n\t} else {\n\t\tconst filePath = resolve(values.sdl!)\n\t\tsource = readFileSync(filePath, 'utf-8')\n\t}\n\n\t// Convert\n\tconst entities = convertGraphQLSchema(source, options)\n\n\tif (entities.length === 0) {\n\t\tconsole.warn('No entity types found in the schema. Check your include/exclude filters.')\n\t\tprocess.exit(0)\n\t}\n\n\t// Read the identity each authored doctype declares, before planning rather than during the write\n\t// loop below. SDL cannot express which UNIQUE column is a table's key, so for a natural-key\n\t// doctype the declaration in the file is the only answer that exists — and planning is what\n\t// decides whether the aggregate can be built at all. Reading it 20 lines later, as the loop\n\t// does, made the \"declare a primaryKey and re-run\" warning a dead end: re-running after\n\t// declaring one changed nothing.\n\tconst identity: Record<string, string> = {}\n\tfor (const entity of entities) {\n\t\tconst entityPath = join(outputDir, `${entity.slug}.json`)\n\t\tif (!existsSync(entityPath)) continue\n\t\tconst declared = authoredPrimaryKey(JSON.parse(readFileSync(entityPath, 'utf-8')))\n\t\tif (declared !== undefined) identity[entity.name] = declared\n\t}\n\n\t// Each table yields two doctypes — the entity and its aggregate — written as peers, one file\n\t// each, along with what each is verified against. See `planGeneration`.\n\tconst doctypes = planGeneration(entities, {\n\t\tnoAggregates: values['no-aggregates'],\n\t\tidentity,\n\t\tonWarning: message => console.warn(`  WARN: ${message}`),\n\t})\n\n\t// Write output\n\tif (!existsSync(outputDir)) {\n\t\tmkdirSync(outputDir, { recursive: true })\n\t}\n\n\tlet warnings = 0\n\tlet errors = 0\n\tlet changed = 0\n\tconst driftLines: string[] = []\n\n\tfor (const { generated, basis, subset } of doctypes) {\n\t\tconst fileName = `${generated.slug}.json`\n\t\tconst filePath = join(outputDir, fileName)\n\n\t\t// When a doctype already exists it is the source of truth: generation confirms it and adds\n\t\t// provenance markers, and reports anything it disagrees with rather than applying it. A\n\t\t// doctype legitimately declares identity the schema cannot express — most often a natural\n\t\t// key that is a UNIQUE constraint, not the table's PRIMARY KEY — and overwriting that would\n\t\t// silently re-key the doctype on every run. A first generation has nothing to merge into,\n\t\t// so converter output is written verbatim.\n\t\tlet output: object = generated\n\t\tif (existsSync(filePath)) {\n\t\t\tconst { doctype: merged, drift } = mergeIntrospectedDoctype(JSON.parse(readFileSync(filePath, 'utf-8')), basis, {\n\t\t\t\tsubset,\n\t\t\t})\n\t\t\toutput = merged\n\t\t\tdriftLines.push(...formatDoctypeDrift(drift))\n\t\t}\n\n\t\t// Serialize the merged object directly. Never round-trip it through the Zod parser first:\n\t\t// that runs in strip mode and would silently drop every key this package does not model,\n\t\t// `handler` on an action being the one consumers actually rely on.\n\t\t//\n\t\t// `kind` is dropped on the way out because it is the discriminated-union tag the parser\n\t\t// synthesizes, not authored data — `injectKind` puts it back on every read. Writing it made\n\t\t// the generator and the docbuilder disagree with hand-authored files about what a doctype\n\t\t// looks like, and re-added the key on every regeneration.\n\t\tconst serializable: Record<string, unknown> = { ...output }\n\t\tif (Array.isArray(serializable.fields)) {\n\t\t\tserializable.fields = serializable.fields.map(stripFieldKind)\n\t\t}\n\t\tconst json = JSON.stringify(serializable, null, '\\t') + '\\n'\n\t\tconst unchanged = existsSync(filePath) && readFileSync(filePath, 'utf-8') === json\n\t\tif (!unchanged) changed++\n\n\t\tif (!values.check && !unchanged) {\n\t\t\twriteFileSync(filePath, json, 'utf-8')\n\t\t}\n\n\t\t// Validate the output\n\t\tconst validation = validateDoctype(output)\n\t\tif (!validation.success) {\n\t\t\terrors++\n\t\t\tconsole.error(`  ERROR: ${fileName} failed validation:`)\n\t\t\tfor (const err of validation.errors) {\n\t\t\t\tconsole.error(`    ${err.path.join('.')}: ${err.message}`)\n\t\t\t}\n\t\t} else {\n\t\t\t// Check for unmapped fields\n\t\t\tconst unmappedFields = generated.fields.filter((f: any) => f._unmapped)\n\t\t\tif (unmappedFields.length > 0) {\n\t\t\t\twarnings++\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`  WARN: ${fileName} has ${unmappedFields.length} unmapped field(s): ${unmappedFields\n\t\t\t\t\t\t.map((f: any) => f.fieldname)\n\t\t\t\t\t\t.join(', ')}`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t}\n\n\tif (driftLines.length > 0) {\n\t\tconsole.log('\\nDrift between the authored doctypes and the schema (reported, not applied):')\n\t\tfor (const line of driftLines) console.log(line)\n\t}\n\n\tconsole.log(\n\t\t`\\n${values.check ? 'Checked' : 'Generated'} ${doctypes.length} doctype(s) in ${outputDir}` +\n\t\t\t(changed ? ` (${changed} ${values.check ? 'would change' : 'written'})` : ' (all up to date)') +\n\t\t\t(warnings ? ` (${warnings} with warnings)` : '') +\n\t\t\t(errors ? ` (${errors} with errors)` : '')\n\t)\n\n\tif (errors > 0 || (values.check && changed > 0)) {\n\t\tprocess.exit(1)\n\t}\n}\n\nfunction printHelp(): void {\n\tconsole.log(`\nstonecrop-schema - Convert GraphQL schemas to Stonecrop doctypes\n\nUSAGE:\n  stonecrop-schema generate [options]\n\nSOURCE (exactly one required):\n  --endpoint, -e <url>         Fetch introspection from a live GraphQL endpoint\n  --introspection, -i <file>   Read from a saved introspection JSON file\n  --sdl, -s <file>             Read from a GraphQL SDL (.graphql) file\n\nOUTPUT:\n  --output, -o <dir>           Directory to write doctype JSON files (required)\n\nOPTIONS:\n  --include <types>            Comma-separated list of type names to include\n  --exclude <types>            Comma-separated list of type names to exclude\n  --names <file>               JSON file mapping GraphQL type name to doctype name\n  --custom-scalars <file>      JSON file mapping custom scalar names to field templates\n  --include-unmapped           Include _graphqlType metadata on unmapped fields\n  --no-aggregates              Emit only the entity doctype, not its aggregate\n  --check                      Report drift and exit non-zero if anything would change; write nothing\n  --help, -h                   Show this help message\n\nEach table generates TWO doctypes: the entity (every column, backs the record form) and its\naggregate (the collection view, identity column only by default), named as simple plurals —\n'task.json' and 'tasks.json'. Widen an aggregate by adding fields to it — curation survives\nregeneration. A doctype whose name is already plural gets no aggregate, because it would claim\nits own name and its own file; the run says so and still writes the entity.\n\nAn aggregate needs an identity column. A table keyed on 'id' gives one up; for a natural key,\ndeclare 'primaryKey' on the field in the entity's own file and re-run — the aggregate is keyed\non whatever that file declares.\n\nNOTE: an existing doctype file is the source of truth. Regeneration verifies it against the\nschema and adds 'source: introspected' markers; it reports disagreements rather than\noverwriting them, so hand-curation survives. Use --check in CI.\n\nEXAMPLES:\n  # From a live PostGraphile server\n  stonecrop-schema generate -e http://localhost:5000/graphql -o ./schemas\n\n  # From a saved introspection result\n  stonecrop-schema generate -i introspection.json -o ./schemas\n\n  # From an SDL file with custom scalars\n  stonecrop-schema generate -s schema.graphql -o ./schemas \\\\\n    --custom-scalars custom-scalars.json\n\n  # Only convert specific types\n  stonecrop-schema generate -e http://localhost:5000/graphql -o ./schemas \\\\\n    --include \"User,Post,Comment\"\n`)\n}\n\nmain().catch(err => {\n\tconsole.error('Error:', err.message)\n\tprocess.exit(1)\n})\n"],"mappings":"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"}