@stonecrop/schema 0.10.16 → 0.11.0

package/README.md

@@ -86,7 +86,7 @@ const decimalField: FieldMeta = {
 
 ### Doctype Metadata
 
-`DoctypeMeta` defines a complete doctype with fields, workflow, and inheritance:
+`DoctypeMeta` defines a complete doctype with fields, links, workflow, and inheritance:
 
 ```typescript
 import { DoctypeMeta } from '@stonecrop/schema'
@@ -105,11 +105,19 @@ const doctype: DoctypeMeta = {
     },
     {
       fieldname: 'items',
-      fieldtype: 'Doctype',
-      label: 'Order Items',
-      options: 'sales-order-item', // Child doctype
+      fieldtype: 'Link',
+      label: 'Items',
+      options: 'sales-order-item',
     },
   ],
+  links: {
+    items: {
+      target: 'sales-order-item',
+      cardinality: 'noneOrMany',
+      backlink: 'sales_order',
+      fieldname: 'items',
+    },
+  },
   workflow: {
     states: ['Draft', 'Submitted', 'Cancelled'],
     actions: {
@@ -124,6 +132,35 @@ const doctype: DoctypeMeta = {
 }
 ```
 
+### Link Declarations
+
+`links` on `DoctypeMeta` declares relationships to other doctypes. Each link has a `target`, `cardinality`, and optional `backlink`:
+
+```typescript
+import { LinkDeclaration, Cardinality } from '@stonecrop/schema'
+
+// Cardinality values:
+// 'one'         — exactly 1 (required pointer)
+// 'atMostOne'   — 0 or 1 (optional pointer)
+// 'noneOrMany'  — 0 or more (optional collection)
+// 'atLeastOne'  — 1 or more (required collection)
+
+const links: Record<string, LinkDeclaration> = {
+  // 1:many — ancestor has descendants
+  tasks: {
+    target: 'recipe-task',
+    cardinality: 'noneOrMany',
+    backlink: 'recipe', // fieldname on recipe-task that points back
+  },
+  // Self-referential — version lineage
+  supersededBy: {
+    target: 'recipe',
+    cardinality: 'atMostOne',
+    backlink: 'supersededBy',
+  },
+}
+```
+
 ### Workflow and Actions
 
 Define state machines and actions for doctypes:
@@ -151,6 +188,36 @@ const workflow: WorkflowMeta = {
 }
 ```
 
+## Client Interfaces
+
+`DataClient` is the interface that any data transport must implement. `GetRecordOptions` and `GetRecordsOptions` are the option types:
+
+```typescript
+import type { DataClient, GetRecordOptions, GetRecordsOptions } from '@stonecrop/schema'
+
+// Fetch a record — with optional nested link sub-selections
+const record = await client.getRecord({ name: 'Recipe' }, 'r1', {
+  includeNested: true, // fetch all descendant links
+  maxDepth: 2, // limit recursion depth
+})
+
+// Fetch only specific links
+const record = await client.getRecord({ name: 'Recipe' }, 'r1', {
+  includeNested: ['tasks'], // fetch only the tasks link
+})
+
+// Fetch multiple records
+const records = await client.getRecords(
+  { name: 'Recipe' },
+  {
+    filters: { status: 'Active' },
+    orderBy: 'name',
+    limit: 20,
+    offset: 0,
+  }
+)
+```
+
 ## Validation
 
 Runtime validation with detailed error reporting:
@@ -237,18 +304,18 @@ then `--exclude` removes any remaining unwanted names.
 
 ### All options
 
-| Flag | Short | Description |
-|------|-------|-------------|
-| `--endpoint <url>` | `-e` | Fetch introspection from a live GraphQL endpoint |
-| `--introspection <file>` | `-i` | Read from a saved introspection JSON file |
-| `--sdl <file>` | `-s` | Read from a GraphQL SDL (`.graphql`) file |
-| `--output <dir>` | `-o` | Directory to write doctype JSON files (required) |
-| `--include <types>` | | Comma-separated allowlist of type names to generate |
-| `--exclude <types>` | | Comma-separated list of type names to skip |
-| `--overrides <file>` | | JSON file with per-type, per-field overrides |
-| `--custom-scalars <file>` | | JSON file mapping custom scalar names to field templates |
-| `--include-unmapped` | | Retain `_graphqlType` metadata on fields with no mapping |
-| `--help` | `-h` | Show help |
+| Flag                      | Short | Description                                              |
+| ------------------------- | ----- | -------------------------------------------------------- |
+| `--endpoint <url>`        | `-e`  | Fetch introspection from a live GraphQL endpoint         |
+| `--introspection <file>`  | `-i`  | Read from a saved introspection JSON file                |
+| `--sdl <file>`            | `-s`  | Read from a GraphQL SDL (`.graphql`) file                |
+| `--output <dir>`          | `-o`  | Directory to write doctype JSON files (required)         |
+| `--include <types>`       |       | Comma-separated allowlist of type names to generate      |
+| `--exclude <types>`       |       | Comma-separated list of type names to skip               |
+| `--overrides <file>`      |       | JSON file with per-type, per-field overrides             |
+| `--custom-scalars <file>` |       | JSON file mapping custom scalar names to field templates |
+| `--include-unmapped`      |       | Retain `_graphqlType` metadata on fields with no mapping |
+| `--help`                  | `-h`  | Show help                                                |
 
 ### Custom scalars
 
@@ -258,7 +325,7 @@ a JSON mapping file:
 ```json
 {
   "BigFloat": { "component": "ADecimalInput", "fieldtype": "Decimal" },
-  "Datetime":  { "component": "ADatetimeInput", "fieldtype": "Datetime" }
+  "Datetime": { "component": "ADatetimeInput", "fieldtype": "Datetime" }
 }
 ```
 
@@ -332,14 +399,7 @@ doctypes.forEach(doctype => {
 Convert between different naming conventions:
 
 ```typescript
-import {
-  snakeToCamel,
-  camelToSnake,
-  snakeToLabel,
-  camelToLabel,
-  toPascalCase,
-  toSlug,
-} from '@stonecrop/schema'
+import { snakeToCamel, camelToSnake, snakeToLabel, camelToLabel, toPascalCase, toSlug } from '@stonecrop/schema'
 
 snakeToCamel('customer_name') // 'customerName'
 camelToSnake('customerName') // 'customer_name'
@@ -367,7 +427,8 @@ console.log(TYPE_MAP['Link']) // { component: 'ALink', fieldtype: 'Link' }
 
 This package provides the type system used throughout Stonecrop:
 
-- **`@stonecrop/stonecrop`** - Registry uses `DoctypeMeta` for schema storage
+- **`@stonecrop/stonecrop`** - Registry uses `DoctypeMeta` for schema storage; `getDescendantLinks()` / `getAncestorLinks()` for relationship traversal
+- **`@stonecrop/graphql-client`** - `StonecropClient` implements `DataClient`; uses `GetRecordOptions` / `GetRecordsOptions` for fetch parameters
 - **`@stonecrop/aform`** - Renders fields based on `FieldMeta` definitions
 - **`@stonecrop/atable`** - Uses `FieldMeta` for column configuration
 - **Backend APIs** - Validates and stores doctypes using these schemas

package/dist/cli.cjs

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+"use strict";const r=require("node:fs"),c=require("node:path"),w=require("node:util"),x=require("graphql"),v=require("./index-aeXXzPET.cjs");async function O(e,h){const t=await fetch(e,{method:"POST",headers:{"Content-Type":"application/json",...h},body:JSON.stringify({query:x.getIntrospectionQuery()})});if(!t.ok)throw new Error(`Failed to fetch introspection: ${t.status} ${t.statusText}`);const a=await t.json();if(a.errors?.length)throw new Error(`GraphQL errors: ${a.errors.map(n=>n.message).join(", ")}`);if(!a.data)throw new Error("No data in introspection response");return a.data}async function $(){const{values:e,positionals:h}=w.parseArgs({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"},overrides:{type:"string"},"custom-scalars":{type:"string"},"include-unmapped":{type:"boolean",default:!1},help:{type:"boolean",short:"h"}}}),t=h[0];(e.help||!t)&&(q(),process.exit(t?0:1)),t!=="generate"&&(console.error(`Unknown command: ${t}`),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 n=c.resolve(e.output),l={includeUnmappedMeta:e["include-unmapped"]};if(e.include&&(l.include=e.include.split(",").map(o=>o.trim())),e.exclude&&(l.exclude=e.exclude.split(",").map(o=>o.trim())),e.overrides){const o=c.resolve(e.overrides),s=r.readFileSync(o,"utf-8");l.typeOverrides=JSON.parse(s)}if(e["custom-scalars"]){const o=c.resolve(e["custom-scalars"]),s=r.readFileSync(o,"utf-8");l.customScalars=JSON.parse(s)}let p;if(e.endpoint)console.log(`Fetching introspection from ${e.endpoint}...`),p=await O(e.endpoint);else if(e.introspection){const o=c.resolve(e.introspection),s=r.readFileSync(o,"utf-8"),u=JSON.parse(s);p=u.data??u}else{const o=c.resolve(e.sdl);p=r.readFileSync(o,"utf-8")}const m=v.convertGraphQLSchema(p,l);m.length===0&&(console.warn("No entity types found in the schema. Check your include/exclude filters."),process.exit(0)),r.existsSync(n)||r.mkdirSync(n,{recursive:!0});let f=0,d=0;for(const o of m){const s=`${o.slug}.json`,u=c.join(n,s),S=JSON.stringify(o,null,"	");r.writeFileSync(u,S+`
+`,"utf-8");const g=v.validateDoctype(o);if(g.success){const i=o.fields.filter(y=>y._unmapped);i.length>0&&(f++,console.warn(`  WARN: ${s} has ${i.length} unmapped field(s): ${i.map(y=>y.fieldname).join(", ")}`))}else{d++,console.error(`  ERROR: ${s} failed validation:`);for(const i of g.errors)console.error(`    ${i.path.join(".")}: ${i.message}`)}}console.log(`
+Generated ${m.length} doctype(s) in ${n}`+(f?` (${f} with warnings)`:"")+(d?` (${d} with errors)`:"")),d>0&&process.exit(1)}function q(){console.log(`
+stonecrop-schema - Convert GraphQL schemas to Stonecrop doctypes
+
+USAGE:
+  stonecrop-schema generate [options]
+
+SOURCE (exactly one required):
+  --endpoint, -e <url>         Fetch introspection from a live GraphQL endpoint
+  --introspection, -i <file>   Read from a saved introspection JSON file
+  --sdl, -s <file>             Read from a GraphQL SDL (.graphql) file
+
+OUTPUT:
+  --output, -o <dir>           Directory to write doctype JSON files (required)
+
+OPTIONS:
+  --include <types>            Comma-separated list of type names to include
+  --exclude <types>            Comma-separated list of type names to exclude
+  --overrides <file>           JSON file with per-type field overrides
+  --custom-scalars <file>      JSON file mapping custom scalar names to field templates
+  --include-unmapped           Include _graphqlType metadata on unmapped fields
+  --help, -h                   Show this help message
+
+EXAMPLES:
+  # From a live PostGraphile server
+  stonecrop-schema generate -e http://localhost:5000/graphql -o ./schemas
+
+  # From a saved introspection result
+  stonecrop-schema generate -i introspection.json -o ./schemas
+
+  # From an SDL file with custom scalars
+  stonecrop-schema generate -s schema.graphql -o ./schemas \\
+    --custom-scalars custom-scalars.json
+
+  # Only convert specific types
+  stonecrop-schema generate -e http://localhost:5000/graphql -o ./schemas \\
+    --include "User,Post,Comment"
+`)}$().catch(e=>{console.error("Error:",e.message),process.exit(1)});
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.cjs","sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\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 { convertGraphQLSchema } from './converter/index'\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 = (await response.json()) as {\n\t\tdata?: IntrospectionQuery\n\t\terrors?: Array<{ message: string }>\n\t}\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\toverrides: { type: 'string' },\n\t\t\t'custom-scalars': { type: 'string' },\n\t\t\t'include-unmapped': { 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.overrides) {\n\t\tconst overridesPath = resolve(values.overrides)\n\t\tconst overridesContent = readFileSync(overridesPath, 'utf-8')\n\t\toptions.typeOverrides = JSON.parse(overridesContent)\n\t}\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 doctypes = convertGraphQLSchema(source, options)\n\n\tif (doctypes.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// Write output\n\tif (!existsSync(outputDir)) {\n\t\tmkdirSync(outputDir, { recursive: true })\n\t}\n\n\tlet warnings = 0\n\tlet errors = 0\n\n\tfor (const doctype of doctypes) {\n\t\tconst fileName = `${doctype.slug}.json`\n\t\tconst filePath = join(outputDir, fileName)\n\t\tconst json = JSON.stringify(doctype, null, '\\t')\n\n\t\twriteFileSync(filePath, json + '\\n', 'utf-8')\n\n\t\t// Validate the output\n\t\tconst validation = validateDoctype(doctype)\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 = doctype.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\tconsole.log(\n\t\t`\\nGenerated ${doctypes.length} doctype(s) in ${outputDir}` +\n\t\t\t(warnings ? ` (${warnings} with warnings)` : '') +\n\t\t\t(errors ? ` (${errors} with errors)` : '')\n\t)\n\n\tif (errors > 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  --overrides <file>           JSON file with per-type field overrides\n  --custom-scalars <file>      JSON file mapping custom scalar names to field templates\n  --include-unmapped           Include _graphqlType metadata on unmapped fields\n  --help, -h                   Show this help message\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","overridesPath","overridesContent","readFileSync","scalarsPath","scalarsContent","source","filePath","content","parsed","doctypes","convertGraphQLSchema","existsSync","mkdirSync","warnings","errors","doctype","fileName","join","writeFileSync","validation","validateDoctype","unmappedFields","f","err"],"mappings":";6IA8BA,eAAeA,EAAmBC,EAAkBC,EAA+D,CAClH,MAAMC,EAAW,MAAM,MAAMF,EAAU,CACtC,OAAQ,OACR,QAAS,CACR,eAAgB,mBAChB,GAAGC,CAAA,EAEJ,KAAM,KAAK,UAAU,CACpB,MAAOE,EAAAA,sBAAA,CAAsB,CAC7B,CAAA,CACD,EAED,GAAI,CAACD,EAAS,GACb,MAAM,IAAI,MAAM,kCAAkCA,EAAS,MAAM,IAAIA,EAAS,UAAU,EAAE,EAG3F,MAAME,EAAQ,MAAMF,EAAS,KAAA,EAK7B,GAAIE,EAAK,QAAQ,OAChB,MAAM,IAAI,MAAM,mBAAmBA,EAAK,OAAO,IAAIC,GAAKA,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,EAAE,EAGhF,GAAI,CAACD,EAAK,KACT,MAAM,IAAI,MAAM,mCAAmC,EAGpD,OAAOA,EAAK,IACb,CAEA,eAAeE,GAAsB,CACpC,KAAM,CAAE,OAAAC,EAAQ,YAAAC,CAAA,EAAgBC,YAAU,CACzC,iBAAkB,GAClB,QAAS,CACR,SAAU,CAAE,KAAM,SAAU,MAAO,GAAA,EACnC,cAAe,CAAE,KAAM,SAAU,MAAO,GAAA,EACxC,IAAK,CAAE,KAAM,SAAU,MAAO,GAAA,EAC9B,OAAQ,CAAE,KAAM,SAAU,MAAO,GAAA,EACjC,QAAS,CAAE,KAAM,QAAA,EACjB,QAAS,CAAE,KAAM,QAAA,EACjB,UAAW,CAAE,KAAM,QAAA,EACnB,iBAAkB,CAAE,KAAM,QAAA,EAC1B,mBAAoB,CAAE,KAAM,UAAW,QAAS,EAAA,EAChD,KAAM,CAAE,KAAM,UAAW,MAAO,GAAA,CAAI,CACrC,CACA,EAEKC,EAAUF,EAAY,CAAC,GAEzBD,EAAO,MAAQ,CAACG,KACnBC,EAAA,EACA,QAAQ,KAAKD,EAAU,EAAI,CAAC,GAGzBA,IAAY,aACf,QAAQ,MAAM,oBAAoBA,CAAO,EAAE,EAC3C,QAAQ,MAAM,8BAA8B,EAC5C,QAAQ,KAAK,CAAC,GAIK,CAACH,EAAO,SAAUA,EAAO,cAAeA,EAAO,GAAG,EAAE,OAAO,OAAO,EAAE,SACpE,IACnB,QAAQ,MAAM,uEAAuE,EACrF,QAAQ,KAAK,CAAC,GAGVA,EAAO,SACX,QAAQ,MAAM,4BAA4B,EAC1C,QAAQ,KAAK,CAAC,GAGf,MAAMK,EAAYC,EAAAA,QAAQN,EAAO,MAAM,EAGjCO,EAAoC,CACzC,oBAAqBP,EAAO,kBAAkB,CAAA,EAW/C,GARIA,EAAO,UACVO,EAAQ,QAAUP,EAAO,QAAQ,MAAM,GAAG,EAAE,IAAIQ,GAAKA,EAAE,KAAA,CAAM,GAG1DR,EAAO,UACVO,EAAQ,QAAUP,EAAO,QAAQ,MAAM,GAAG,EAAE,IAAIQ,GAAKA,EAAE,KAAA,CAAM,GAG1DR,EAAO,UAAW,CACrB,MAAMS,EAAgBH,EAAAA,QAAQN,EAAO,SAAS,EACxCU,EAAmBC,EAAAA,aAAaF,EAAe,OAAO,EAC5DF,EAAQ,cAAgB,KAAK,MAAMG,CAAgB,CACpD,CAEA,GAAIV,EAAO,gBAAgB,EAAG,CAC7B,MAAMY,EAAcN,EAAAA,QAAQN,EAAO,gBAAgB,CAAC,EAC9Ca,EAAiBF,EAAAA,aAAaC,EAAa,OAAO,EACxDL,EAAQ,cAAgB,KAAK,MAAMM,CAAc,CAClD,CAGA,IAAIC,EAEJ,GAAId,EAAO,SACV,QAAQ,IAAI,+BAA+BA,EAAO,QAAQ,KAAK,EAC/Dc,EAAS,MAAMtB,EAAmBQ,EAAO,QAAQ,UACvCA,EAAO,cAAe,CAChC,MAAMe,EAAWT,EAAAA,QAAQN,EAAO,aAAa,EACvCgB,EAAUL,EAAAA,aAAaI,EAAU,OAAO,EACxCE,EAAS,KAAK,MAAMD,CAAO,EAEjCF,EAASG,EAAO,MAAQA,CACzB,KAAO,CACN,MAAMF,EAAWT,EAAAA,QAAQN,EAAO,GAAI,EACpCc,EAASH,EAAAA,aAAaI,EAAU,OAAO,CACxC,CAGA,MAAMG,EAAWC,EAAAA,qBAAqBL,EAAQP,CAAO,EAEjDW,EAAS,SAAW,IACvB,QAAQ,KAAK,0EAA0E,EACvF,QAAQ,KAAK,CAAC,GAIVE,EAAAA,WAAWf,CAAS,GACxBgB,EAAAA,UAAUhB,EAAW,CAAE,UAAW,EAAA,CAAM,EAGzC,IAAIiB,EAAW,EACXC,EAAS,EAEb,UAAWC,KAAWN,EAAU,CAC/B,MAAMO,EAAW,GAAGD,EAAQ,IAAI,QAC1BT,EAAWW,EAAAA,KAAKrB,EAAWoB,CAAQ,EACnC5B,EAAO,KAAK,UAAU2B,EAAS,KAAM,GAAI,EAE/CG,EAAAA,cAAcZ,EAAUlB,EAAO;AAAA,EAAM,OAAO,EAG5C,MAAM+B,EAAaC,EAAAA,gBAAgBL,CAAO,EAC1C,GAAKI,EAAW,QAMT,CAEN,MAAME,EAAiBN,EAAQ,OAAO,OAAQO,GAAWA,EAAE,SAAS,EAChED,EAAe,OAAS,IAC3BR,IACA,QAAQ,KACP,WAAWG,CAAQ,QAAQK,EAAe,MAAM,uBAAuBA,EACrE,IAAKC,GAAWA,EAAE,SAAS,EAC3B,KAAK,IAAI,CAAC,EAAA,EAGf,KAjByB,CACxBR,IACA,QAAQ,MAAM,YAAYE,CAAQ,qBAAqB,EACvD,UAAWO,KAAOJ,EAAW,OAC5B,QAAQ,MAAM,OAAOI,EAAI,KAAK,KAAK,GAAG,CAAC,KAAKA,EAAI,OAAO,EAAE,CAE3D,CAYD,CAEA,QAAQ,IACP;AAAA,YAAed,EAAS,MAAM,kBAAkBb,CAAS,IACvDiB,EAAW,KAAKA,CAAQ,kBAAoB,KAC5CC,EAAS,KAAKA,CAAM,gBAAkB,GAAA,EAGrCA,EAAS,GACZ,QAAQ,KAAK,CAAC,CAEhB,CAEA,SAASnB,GAAkB,CAC1B,QAAQ,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAoCZ,CACD,CAEAL,IAAO,MAAMiC,GAAO,CACnB,QAAQ,MAAM,SAAUA,EAAI,OAAO,EACnC,QAAQ,KAAK,CAAC,CACf,CAAC"}

package/dist/cli.js

@@ -3,7 +3,7 @@ import { readFileSync as u, existsSync as S, mkdirSync as w, writeFileSync as x
 import { resolve as c, join as O } from "node:path";
 import { parseArgs as $ } from "node:util";
 import { getIntrospectionQuery as N } from "graphql";
-import { h as P, v as j } from "./index-D6Up-BP5.js";
+import { e as P, v as j } from "./index-CLc5mUMQ.js";
 async function C(e, m) {
   const t = await fetch(e, {
     method: "POST",

package/dist/converter/heuristics.js

@@ -223,21 +223,23 @@ export function classifyFieldType(fieldName, field, entityTypes, options = {}) {
             base.options = toSlug(namedType.name);
             return base;
         }
-        // 4. Connection type → Doctype (child table)
+        // 4. Connection type → link (child table)
         const connectionNodeTypeName = getConnectionNodeType(namedType);
         if (connectionNodeTypeName && entityTypes.has(connectionNodeTypeName)) {
             base.component = 'ATable';
-            base.fieldtype = 'Doctype';
+            base._isLink = true;
             base.options = toSlug(connectionNodeTypeName);
-            base.cardinality = 'many';
+            base.cardinality = 'noneOrMany';
+            delete base.fieldtype;
             return base;
         }
-        // 5. List of entity type → Doctype
+        // 5. List of entity type → link
         if (isList && entityTypes.has(namedType.name)) {
             base.component = 'ATable';
-            base.fieldtype = 'Doctype';
+            base._isLink = true;
             base.options = toSlug(namedType.name);
-            base.cardinality = 'many';
+            base.cardinality = 'noneOrMany';
+            delete base.fieldtype;
             return base;
         }
         // Unknown object type — mark as unmapped

package/dist/converter/index.js

@@ -88,7 +88,7 @@ export function convertGraphQLSchema(source, options = {}) {
             continue;
         const fields = type.getFields();
         const typeOverrides = options.typeOverrides?.[typeName];
-        const convertedFields = Object.entries(fields)
+        const allClassifiedFields = Object.entries(fields)
             .filter(([fieldName, field]) => isEntityField(fieldName, field, type))
             .map(([fieldName, field]) => {
             // Check for full custom classification first
@@ -111,20 +111,37 @@ export function convertGraphQLSchema(source, options = {}) {
                 return { ...classified, ...typeOverrides[fieldName] };
             }
             return classified;
+        });
+        // Separate scalar fields from link fields
+        const links = {};
+        const convertedFields = allClassifiedFields
+            .filter(field => {
+            if (field._isLink && typeof field.options === 'string' && field.cardinality) {
+                links[field.fieldname] = {
+                    target: field.options,
+                    cardinality: field.cardinality,
+                };
+                return false;
+            }
+            return true;
         })
             // Clean up internal metadata unless requested
             .map(field => {
             if (!options.includeUnmappedMeta) {
-                const { _graphqlType, _unmapped, ...clean } = field;
+                const { _graphqlType, _unmapped, _isLink, ...clean } = field;
                 return clean;
             }
-            return field;
+            const { _isLink, ...rest } = field;
+            return rest;
         });
         const doctype = {
             name: typeName,
             slug: toSlug(typeName),
             fields: convertedFields,
         };
+        if (Object.keys(links).length > 0) {
+            doctype.links = links;
+        }
         const tableName = deriveTableName(typeName);
         if (tableName) {
             doctype.tableName = tableName;