@gqlkit-ts/cli 0.2.0 → 0.3.0

package/dist/auto-type-generator/typename-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typename-types.d.ts","sourceRoot":"","sources":["../../src/auto-type-generator/typename-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,sCAAuC,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAC;AAElE;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAC3C,oBAAoB,CAEtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,EAC5B,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,GACxB;IAAE,QAAQ,EAAE,CAAC,CAAC;IAAC,SAAS,EAAE,iBAAiB,CAAA;CAAE,GAAG,IAAI,CActD"}

package/dist/auto-type-generator/typename-types.js

@@ -0,0 +1,37 @@
+/**
+ * Common types for typename-related functionality.
+ * These types are shared across typename-extractor, typename-validator,
+ * typename-resolve-type-generator, and inline-union-validator.
+ */
+/**
+ * All recognized field names for type discrimination.
+ * - "__typename" is the standard GraphQL introspection field
+ * - "$typeName" is a gqlkit-specific alternative that won't appear in the schema
+ *
+ * To add a new typename field:
+ * 1. Add the field name to this array
+ * 2. Update findTypenameProperty priority if needed
+ */
+export const TYPENAME_FIELD_NAMES = ["__typename", "$typeName"];
+/**
+ * Create a TypenameFieldNameSet from field names.
+ */
+export function createFieldNameSet(fieldNames) {
+    return new Set(fieldNames);
+}
+/**
+ * Find __typename or $typeName property from a list of properties.
+ * __typename takes priority over $typeName.
+ */
+export function findTypenameProperty(properties, getName) {
+    const typenameProperty = properties.find((p) => getName(p) === "__typename");
+    if (typenameProperty) {
+        return { property: typenameProperty, fieldName: "__typename" };
+    }
+    const dollarTypenameProperty = properties.find((p) => getName(p) === "$typeName");
+    if (dollarTypenameProperty) {
+        return { property: dollarTypenameProperty, fieldName: "$typeName" };
+    }
+    return null;
+}
+//# sourceMappingURL=typename-types.js.map

package/dist/auto-type-generator/typename-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typename-types.js","sourceRoot":"","sources":["../../src/auto-type-generator/typename-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,YAAY,EAAE,WAAW,CAAU,CAAC;AAYzE;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAA4C;IAE5C,OAAO,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;AAC7B,CAAC;AAUD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAA4B,EAC5B,OAAyB;IAEzB,MAAM,gBAAgB,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC;IAC7E,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;IACjE,CAAC;IAED,MAAM,sBAAsB,GAAG,UAAU,CAAC,IAAI,CAC5C,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,WAAW,CAClC,CAAC;IACF,IAAI,sBAAsB,EAAE,CAAC;QAC3B,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;IACtE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/auto-type-generator/typename-validator.d.ts

@@ -0,0 +1,37 @@
+import type { Diagnostic, ExtractedTypeInfo, InlineObjectMember, SourceLocation } from "../type-extractor/types/index.js";
+import type { TypenameExtractionResult } from "./typename-extractor.js";
+export interface ValidateTypenamesParams {
+    readonly extractionResult: TypenameExtractionResult;
+    readonly sourceLocation: SourceLocation;
+    readonly inlineObjectMembers: ReadonlyArray<InlineObjectMember> | null;
+}
+export interface ValidateTypenamesResult {
+    readonly valid: boolean;
+    readonly diagnostics: ReadonlyArray<Diagnostic>;
+}
+export interface ValidateSchemaTypenamesParams {
+    readonly objectTypes: ReadonlyArray<ExtractedTypeInfo>;
+    readonly typeMap: ReadonlyMap<string, ExtractedTypeInfo>;
+}
+export interface ValidateSchemaTypenamesResult {
+    readonly valid: boolean;
+    readonly diagnostics: ReadonlyArray<Diagnostic>;
+}
+/**
+ * Validates typename fields within an abstract type.
+ * Reports errors for:
+ * - DUPLICATE_TYPENAME_VALUE: Multiple members have the same typename value
+ * - MISSING_TYPENAME_PROPERTY: Inline objects without typename (when union has inline objects)
+ * - INVALID_TYPENAME_TYPE: Typename is not a string literal type
+ * - NULLABLE_TYPENAME_PROPERTY: Typename is nullable
+ */
+export declare function validateTypenames(params: ValidateTypenamesParams): ValidateTypenamesResult;
+/**
+ * Validates that there are no duplicate typename values across the entire schema.
+ * Reports DUPLICATE_TYPENAME_VALUE error when:
+ * - Different object types have the same __typename value (Requirement 4.7)
+ * - Different object types have the same $typeName value (Requirement 4.8)
+ * - An object's __typename equals another object's $typeName (Requirement 4.9)
+ */
+export declare function validateSchemaTypenames(params: ValidateSchemaTypenamesParams): ValidateSchemaTypenamesResult;
+//# sourceMappingURL=typename-validator.d.ts.map

package/dist/auto-type-generator/typename-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typename-validator.d.ts","sourceRoot":"","sources":["../../src/auto-type-generator/typename-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACf,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAMxE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,gBAAgB,EAAE,wBAAwB,CAAC;IACpD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,mBAAmB,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;CACxE;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACjD;AA8GD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,uBAAuB,GAC9B,uBAAuB,CAkEzB;AAqCD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,6BAA6B,GACpC,6BAA6B,CA8D/B"}

package/dist/auto-type-generator/typename-validator.js

@@ -0,0 +1,206 @@
+import { findTypenameProperty, } from "./typename-types.js";
+function getAbstractTypeLabel(kind) {
+    return kind === "union" ? "Union" : "Interface";
+}
+function getMemberLabel(kind) {
+    return kind === "union" ? "members" : "implementers";
+}
+function analyzeInlineObjectTypename(inlineObjectMember) {
+    const found = findTypenameProperty(inlineObjectMember.properties, (p) => p.propertyName);
+    if (!found) {
+        return {
+            exists: false,
+            fieldName: null,
+            isStringLiteral: false,
+            isNullable: false,
+        };
+    }
+    const { property, fieldName } = found;
+    const { propertyType: tsType } = property;
+    return {
+        exists: true,
+        fieldName,
+        isStringLiteral: tsType.kind === "literal" && tsType.name !== null,
+        isNullable: tsType.nullable,
+    };
+}
+function validateInlineObjectsTypenames(extractionResult, inlineObjectMembers, sourceLocation) {
+    if (!extractionResult.hasInlineObjects) {
+        return [];
+    }
+    if (extractionResult.abstractTypeName.endsWith("Input")) {
+        return [];
+    }
+    const diagnostics = [];
+    const abstractTypeName = extractionResult.abstractTypeName;
+    const abstractTypeLabel = getAbstractTypeLabel(extractionResult.abstractTypeKind);
+    const namedMemberCount = extractionResult.members.filter((m) => !m.isInlineObject).length;
+    for (const member of extractionResult.members) {
+        if (member.isInlineObject) {
+            const inlineIndex = member.memberIndex - namedMemberCount;
+            const inlineObjectMember = inlineObjectMembers[inlineIndex];
+            if (inlineObjectMember) {
+                const analysis = analyzeInlineObjectTypename(inlineObjectMember);
+                if (!analysis.exists) {
+                    diagnostics.push({
+                        code: "MISSING_TYPENAME_PROPERTY",
+                        message: `${abstractTypeLabel} '${abstractTypeName}' member at index ${member.memberIndex} is missing '__typename' or '$typeName' property. When a union contains inline objects, all members must have a typename property.`,
+                        severity: "error",
+                        location: sourceLocation,
+                    });
+                }
+                else if (!analysis.isStringLiteral) {
+                    diagnostics.push({
+                        code: "INVALID_TYPENAME_TYPE",
+                        message: `${abstractTypeLabel} '${abstractTypeName}' member at index ${member.memberIndex} has '${analysis.fieldName}' that is not a string literal type. Expected a string literal like '__typename: "TypeName"'.`,
+                        severity: "error",
+                        location: sourceLocation,
+                    });
+                }
+                else if (analysis.isNullable) {
+                    diagnostics.push({
+                        code: "NULLABLE_TYPENAME_PROPERTY",
+                        message: `${abstractTypeLabel} '${abstractTypeName}' member at index ${member.memberIndex} has nullable '${analysis.fieldName}' property. The typename property must not be nullable.`,
+                        severity: "error",
+                        location: sourceLocation,
+                    });
+                }
+            }
+        }
+    }
+    return diagnostics;
+}
+/**
+ * Validates typename fields within an abstract type.
+ * Reports errors for:
+ * - DUPLICATE_TYPENAME_VALUE: Multiple members have the same typename value
+ * - MISSING_TYPENAME_PROPERTY: Inline objects without typename (when union has inline objects)
+ * - INVALID_TYPENAME_TYPE: Typename is not a string literal type
+ * - NULLABLE_TYPENAME_PROPERTY: Typename is nullable
+ */
+export function validateTypenames(params) {
+    const { extractionResult, sourceLocation, inlineObjectMembers } = params;
+    const diagnostics = [];
+    if (inlineObjectMembers) {
+        const inlineValidationDiagnostics = validateInlineObjectsTypenames(extractionResult, inlineObjectMembers, sourceLocation);
+        diagnostics.push(...inlineValidationDiagnostics);
+    }
+    const typenameValueToMembers = new Map();
+    for (const member of extractionResult.members) {
+        if (member.typenameInfo === null) {
+            continue;
+        }
+        const { typeName, fieldName } = member.typenameInfo;
+        const memberTypeName = member.memberTypeName ?? `member${member.memberIndex}`;
+        const existing = typenameValueToMembers.get(typeName) ?? [];
+        existing.push({ memberTypeName, fieldName });
+        typenameValueToMembers.set(typeName, existing);
+    }
+    const abstractTypeLabel = getAbstractTypeLabel(extractionResult.abstractTypeKind);
+    const memberLabel = getMemberLabel(extractionResult.abstractTypeKind);
+    for (const [typenameValue, members] of typenameValueToMembers) {
+        if (members.length > 1) {
+            const allSameFieldName = members.every((m) => m.fieldName === members[0].fieldName);
+            let message;
+            if (allSameFieldName) {
+                const memberNames = members
+                    .map((m) => `'${m.memberTypeName}'`)
+                    .join(" and ");
+                message = `Duplicate typename value '${typenameValue}' in ${abstractTypeLabel} '${extractionResult.abstractTypeName}': used by ${memberLabel} ${memberNames}.`;
+            }
+            else {
+                const memberDescriptions = members
+                    .map((m) => `member '${m.memberTypeName}' (${m.fieldName})`)
+                    .join(" and ");
+                message = `Duplicate typename value '${typenameValue}' in ${abstractTypeLabel} '${extractionResult.abstractTypeName}': ${memberDescriptions} have the same value.`;
+            }
+            diagnostics.push({
+                code: "DUPLICATE_TYPENAME_VALUE",
+                message,
+                severity: "error",
+                location: sourceLocation,
+            });
+        }
+    }
+    return {
+        valid: diagnostics.length === 0,
+        diagnostics,
+    };
+}
+function extractTypenameFromObjectType(typeInfo) {
+    const found = findTypenameProperty(typeInfo.fields, (f) => f.name);
+    if (!found) {
+        return null;
+    }
+    const { property: field, fieldName } = found;
+    const { tsType } = field;
+    if (field.optional ||
+        tsType.nullable ||
+        tsType.kind !== "literal" ||
+        tsType.name === null) {
+        return null;
+    }
+    return {
+        typeName: typeInfo.metadata.name,
+        typenameValue: tsType.name,
+        fieldName,
+        sourceLocation: typeInfo.metadata.sourceLocation,
+    };
+}
+/**
+ * Validates that there are no duplicate typename values across the entire schema.
+ * Reports DUPLICATE_TYPENAME_VALUE error when:
+ * - Different object types have the same __typename value (Requirement 4.7)
+ * - Different object types have the same $typeName value (Requirement 4.8)
+ * - An object's __typename equals another object's $typeName (Requirement 4.9)
+ */
+export function validateSchemaTypenames(params) {
+    const { objectTypes } = params;
+    const diagnostics = [];
+    const typenameValueToTypes = new Map();
+    for (const typeInfo of objectTypes) {
+        if (typeInfo.metadata.kind !== "object" &&
+            typeInfo.metadata.kind !== "interface" &&
+            typeInfo.metadata.kind !== "graphqlInterface") {
+            continue;
+        }
+        const typenameInfo = extractTypenameFromObjectType(typeInfo);
+        if (typenameInfo === null) {
+            continue;
+        }
+        const existing = typenameValueToTypes.get(typenameInfo.typenameValue) ?? [];
+        existing.push(typenameInfo);
+        typenameValueToTypes.set(typenameInfo.typenameValue, existing);
+    }
+    for (const [typenameValue, types] of typenameValueToTypes) {
+        if (types.length > 1) {
+            const allSameFieldName = types.every((t) => t.fieldName === types[0].fieldName);
+            const sortedTypes = [...types].sort((a, b) => a.typeName.localeCompare(b.typeName));
+            let message;
+            if (allSameFieldName) {
+                const typeNames = sortedTypes
+                    .map((t) => `'${t.typeName}'`)
+                    .join(" and ");
+                message = `Duplicate typename value '${typenameValue}' in schema: types ${typeNames} have the same ${sortedTypes[0].fieldName} value.`;
+            }
+            else {
+                const typeDescriptions = sortedTypes
+                    .map((t) => `'${t.typeName}' (${t.fieldName})`)
+                    .join(" and ");
+                message = `Duplicate typename value '${typenameValue}' in schema: types ${typeDescriptions} have the same value.`;
+            }
+            const firstType = sortedTypes[1];
+            diagnostics.push({
+                code: "DUPLICATE_TYPENAME_VALUE",
+                message,
+                severity: "error",
+                location: firstType.sourceLocation,
+            });
+        }
+    }
+    return {
+        valid: diagnostics.length === 0,
+        diagnostics,
+    };
+}
+//# sourceMappingURL=typename-validator.js.map

package/dist/auto-type-generator/typename-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typename-validator.js","sourceRoot":"","sources":["../../src/auto-type-generator/typename-validator.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,oBAAoB,GAErB,MAAM,qBAAqB,CAAC;AA4B7B,SAAS,oBAAoB,CAAC,IAA2B;IACvD,OAAO,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;AAClD,CAAC;AAED,SAAS,cAAc,CAAC,IAA2B;IACjD,OAAO,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC;AACvD,CAAC;AASD,SAAS,2BAA2B,CAClC,kBAAsC;IAEtC,MAAM,KAAK,GAAG,oBAAoB,CAChC,kBAAkB,CAAC,UAAU,EAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CACtB,CAAC;IAEF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,MAAM,EAAE,KAAK;YACb,SAAS,EAAE,IAAI;YACf,eAAe,EAAE,KAAK;YACtB,UAAU,EAAE,KAAK;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IACtC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;IAE1C,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,SAAS;QACT,eAAe,EAAE,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;QAClE,UAAU,EAAE,MAAM,CAAC,QAAQ;KAC5B,CAAC;AACJ,CAAC;AAED,SAAS,8BAA8B,CACrC,gBAA0C,EAC1C,mBAAsD,EACtD,cAA8B;IAE9B,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,CAAC;QACvC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,gBAAgB,CAAC;IAC3D,MAAM,iBAAiB,GAAG,oBAAoB,CAC5C,gBAAgB,CAAC,gBAAgB,CAClC,CAAC;IAEF,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,OAAO,CAAC,MAAM,CACtD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,cAAc,CACzB,CAAC,MAAM,CAAC;IAET,KAAK,MAAM,MAAM,IAAI,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAC9C,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAC1B,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,GAAG,gBAAgB,CAAC;YAC1D,MAAM,kBAAkB,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;YAE5D,IAAI,kBAAkB,EAAE,CAAC;gBACvB,MAAM,QAAQ,GAAG,2BAA2B,CAAC,kBAAkB,CAAC,CAAC;gBAEjE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;oBACrB,WAAW,CAAC,IAAI,CAAC;wBACf,IAAI,EAAE,2BAA2B;wBACjC,OAAO,EAAE,GAAG,iBAAiB,KAAK,gBAAgB,qBAAqB,MAAM,CAAC,WAAW,oIAAoI;wBAC7N,QAAQ,EAAE,OAAO;wBACjB,QAAQ,EAAE,cAAc;qBACzB,CAAC,CAAC;gBACL,CAAC;qBAAM,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;oBACrC,WAAW,CAAC,IAAI,CAAC;wBACf,IAAI,EAAE,uBAAuB;wBAC7B,OAAO,EAAE,GAAG,iBAAiB,KAAK,gBAAgB,qBAAqB,MAAM,CAAC,WAAW,SAAS,QAAQ,CAAC,SAAS,+FAA+F;wBACnN,QAAQ,EAAE,OAAO;wBACjB,QAAQ,EAAE,cAAc;qBACzB,CAAC,CAAC;gBACL,CAAC;qBAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;oBAC/B,WAAW,CAAC,IAAI,CAAC;wBACf,IAAI,EAAE,4BAA4B;wBAClC,OAAO,EAAE,GAAG,iBAAiB,KAAK,gBAAgB,qBAAqB,MAAM,CAAC,WAAW,kBAAkB,QAAQ,CAAC,SAAS,yDAAyD;wBACtL,QAAQ,EAAE,OAAO;wBACjB,QAAQ,EAAE,cAAc;qBACzB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAA+B;IAE/B,MAAM,EAAE,gBAAgB,EAAE,cAAc,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAAC;IACzE,MAAM,WAAW,GAAiB,EAAE,CAAC;IAErC,IAAI,mBAAmB,EAAE,CAAC;QACxB,MAAM,2BAA2B,GAAG,8BAA8B,CAChE,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,CACf,CAAC;QACF,WAAW,CAAC,IAAI,CAAC,GAAG,2BAA2B,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEtE,KAAK,MAAM,MAAM,IAAI,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAC9C,IAAI,MAAM,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC;QACpD,MAAM,cAAc,GAClB,MAAM,CAAC,cAAc,IAAI,SAAS,MAAM,CAAC,WAAW,EAAE,CAAC;QAEzD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7C,sBAAsB,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,iBAAiB,GAAG,oBAAoB,CAC5C,gBAAgB,CAAC,gBAAgB,CAClC,CAAC;IACF,MAAM,WAAW,GAAG,cAAc,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;IAEtE,KAAK,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,sBAAsB,EAAE,CAAC;QAC9D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAE,CAAC,SAAS,CAC7C,CAAC;YAEF,IAAI,OAAe,CAAC;YACpB,IAAI,gBAAgB,EAAE,CAAC;gBACrB,MAAM,WAAW,GAAG,OAAO;qBACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,cAAc,GAAG,CAAC;qBACnC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACjB,OAAO,GAAG,6BAA6B,aAAa,QAAQ,iBAAiB,KAAK,gBAAgB,CAAC,gBAAgB,cAAc,WAAW,IAAI,WAAW,GAAG,CAAC;YACjK,CAAC;iBAAM,CAAC;gBACN,MAAM,kBAAkB,GAAG,OAAO;qBAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,cAAc,MAAM,CAAC,CAAC,SAAS,GAAG,CAAC;qBAC3D,IAAI,CAAC,OAAO,CAAC,CAAC;gBACjB,OAAO,GAAG,6BAA6B,aAAa,QAAQ,iBAAiB,KAAK,gBAAgB,CAAC,gBAAgB,MAAM,kBAAkB,uBAAuB,CAAC;YACrK,CAAC;YAED,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,0BAA0B;gBAChC,OAAO;gBACP,QAAQ,EAAE,OAAO;gBACjB,QAAQ,EAAE,cAAc;aACzB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,WAAW,CAAC,MAAM,KAAK,CAAC;QAC/B,WAAW;KACZ,CAAC;AACJ,CAAC;AASD,SAAS,6BAA6B,CACpC,QAA2B;IAE3B,MAAM,KAAK,GAAG,oBAAoB,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACnE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAC7C,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAEzB,IACE,KAAK,CAAC,QAAQ;QACd,MAAM,CAAC,QAAQ;QACf,MAAM,CAAC,IAAI,KAAK,SAAS;QACzB,MAAM,CAAC,IAAI,KAAK,IAAI,EACpB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI;QAChC,aAAa,EAAE,MAAM,CAAC,IAAI;QAC1B,SAAS;QACT,cAAc,EAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc;KACjD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAqC;IAErC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAC/B,MAAM,WAAW,GAAiB,EAAE,CAAC;IAErC,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAoC,CAAC;IAEzE,KAAK,MAAM,QAAQ,IAAI,WAAW,EAAE,CAAC;QACnC,IACE,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ;YACnC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,WAAW;YACtC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,kBAAkB,EAC7C,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,6BAA6B,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,oBAAoB,CAAC,GAAG,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QAC5E,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC5B,oBAAoB,CAAC,GAAG,CAAC,YAAY,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,oBAAoB,EAAE,CAAC;QAC1D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,gBAAgB,GAAG,KAAK,CAAC,KAAK,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAE,CAAC,SAAS,CAC3C,CAAC;YAEF,MAAM,WAAW,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC3C,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CACrC,CAAC;YAEF,IAAI,OAAe,CAAC;YACpB,IAAI,gBAAgB,EAAE,CAAC;gBACrB,MAAM,SAAS,GAAG,WAAW;qBAC1B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC;qBAC7B,IAAI,CAAC,OAAO,CAAC,CAAC;gBACjB,OAAO,GAAG,6BAA6B,aAAa,sBAAsB,SAAS,kBAAkB,WAAW,CAAC,CAAC,CAAE,CAAC,SAAS,SAAS,CAAC;YAC1I,CAAC;iBAAM,CAAC;gBACN,MAAM,gBAAgB,GAAG,WAAW;qBACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,SAAS,GAAG,CAAC;qBAC9C,IAAI,CAAC,OAAO,CAAC,CAAC;gBACjB,OAAO,GAAG,6BAA6B,aAAa,sBAAsB,gBAAgB,uBAAuB,CAAC;YACpH,CAAC;YAED,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAE,CAAC;YAClC,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,0BAA0B;gBAChC,OAAO;gBACP,QAAQ,EAAE,OAAO;gBACjB,QAAQ,EAAE,SAAS,CAAC,cAAc;aACnC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,WAAW,CAAC,MAAM,KAAK,CAAC;QAC/B,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/cli.js

@@ -1,10 +1,12 @@
 import { cli } from "gunshi";
+import { docsCommand } from "./commands/docs.js";
 import { genCommand } from "./commands/gen.js";
 import { mainCommand } from "./commands/main.js";
 await cli(process.argv.slice(2), mainCommand, {
     name: "gqlkit",
     version: "0.0.0",
     subCommands: {
+        docs: docsCommand,
         gen: genCommand,
     },
 });

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE;IAC5C,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE;QACX,GAAG,EAAE,UAAU;KAChB;CACF,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE;IAC5C,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE;QACX,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,UAAU;KAChB;CACF,CAAC,CAAC"}

package/dist/commands/docs.d.ts

@@ -0,0 +1,51 @@
+export interface RunDocsCommandOptions {
+    readonly output: string;
+    readonly claude: boolean;
+    readonly codex: boolean;
+}
+export interface RunDocsCommandResult {
+    readonly exitCode: number;
+    readonly filesWritten: string[];
+}
+export declare function runDocsCommand(options: RunDocsCommandOptions): Promise<RunDocsCommandResult>;
+export declare const docsCommand: {
+    name: string;
+    args: {
+        output: {
+            type: "string";
+            description: string;
+        };
+        claude: {
+            type: "boolean";
+            description: string;
+        };
+        codex: {
+            type: "boolean";
+            description: string;
+        };
+    };
+    run: (ctx: Readonly<import("gunshi").CommandContext<{
+        args: {
+            output: {
+                type: "string";
+                description: string;
+            };
+            claude: {
+                type: "boolean";
+                description: string;
+            };
+            codex: {
+                type: "boolean";
+                description: string;
+            };
+        };
+        extensions: {};
+    }>>) => Promise<void>;
+    description?: string;
+    examples?: string | import("gunshi").CommandExamplesFetcher<import("gunshi").DefaultGunshiParams>;
+    toKebab?: boolean;
+    internal?: boolean;
+    entry?: boolean;
+    rendering?: import("gunshi").RenderingOptions<import("gunshi").DefaultGunshiParams>;
+};
+//# sourceMappingURL=docs.d.ts.map

package/dist/commands/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;CACjC;AAsHD,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA0C/B;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BtB,CAAC"}

package/dist/commands/docs.js

@@ -0,0 +1,154 @@
+import { access, mkdir, readFile, symlink, writeFile } from "node:fs/promises";
+import { dirname, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import { define } from "gunshi";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const CLI_DOCS_DIR = join(__dirname, "../../docs");
+const SKILL_NAME = "gqlkit-guide";
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function detectClaudeEnvironment(dir) {
+    const claudeMdExists = await exists(join(dir, "CLAUDE.md"));
+    const claudeDirExists = await exists(join(dir, ".claude"));
+    return claudeMdExists || claudeDirExists;
+}
+async function detectCodexEnvironment(dir) {
+    const agentsMdExists = await exists(join(dir, "AGENTS.md"));
+    const codexDirExists = await exists(join(dir, ".codex"));
+    return agentsMdExists || codexDirExists;
+}
+function generateSkillMd() {
+    return `---
+name: ${SKILL_NAME}
+description: Use when the user asks about "gqlkit", "gqlkit usage", "gqlkit schema definition", "gqlkit configuration", "gqlkit resolvers", "GraphQL code generation with gqlkit", or needs guidance on gqlkit conventions, type definitions, or integration with GraphQL servers or ORMs.
+---
+
+# gqlkit Guide
+
+gqlkit generates GraphQL schema and resolver maps from TypeScript types and functions.
+
+## How it works
+
+1. Write TypeScript types in \`src/gqlkit/schema/\` → become GraphQL types
+2. Write resolver functions using \`defineQuery\`, \`defineMutation\`, \`defineField\` → become GraphQL resolvers
+3. Run \`gqlkit gen\` → outputs \`typeDefs\` and \`resolvers\` to \`src/gqlkit/__generated__/\`
+
+## Design principles
+
+- **Implement first**: Write types and resolvers, generate schema when ready. No edit-regenerate-implement loops.
+- **Just types and functions**: Plain TypeScript with a thin API. No decorators, no complex generics.
+- **Type-safe**: TypeScript types become GraphQL types. Resolver signatures checked at compile time.
+
+## How to Use This Skill
+
+Read [references/index.md](references/index.md) first. It contains the complete documentation index with all available topics.
+
+Navigate to specific documentation files based on user needs as indicated in the index.
+`;
+}
+function generateRules() {
+    return `## gqlkit
+
+When working with GraphQL schema, types, or resolvers using gqlkit, use the \`${SKILL_NAME}\` skill.
+`;
+}
+async function createSymlinkIfNotExists(linkPath, target) {
+    try {
+        await symlink(target, linkPath, "dir");
+    }
+    catch (error) {
+        if (error.code !== "EEXIST") {
+            throw error;
+        }
+    }
+}
+async function appendOrCreateFile(filePath, content) {
+    try {
+        const existing = await readFile(filePath, "utf-8");
+        if (!existing.includes("## gqlkit")) {
+            await writeFile(filePath, `${existing}\n${content}`);
+        }
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            await writeFile(filePath, content);
+        }
+        else {
+            throw error;
+        }
+    }
+}
+async function generateToolFiles(outputDir, config, filesWritten) {
+    const skillDir = join(outputDir, `${config.configDir}/skills/${SKILL_NAME}`);
+    await mkdir(skillDir, { recursive: true });
+    const skillMdPath = join(skillDir, "SKILL.md");
+    await writeFile(skillMdPath, generateSkillMd());
+    filesWritten.push(skillMdPath);
+    const referencesPath = join(skillDir, "references");
+    const relativePath = relative(skillDir, CLI_DOCS_DIR);
+    await createSymlinkIfNotExists(referencesPath, relativePath);
+    filesWritten.push(referencesPath);
+    const rulesPath = join(outputDir, config.rulesFile);
+    await appendOrCreateFile(rulesPath, generateRules());
+    filesWritten.push(rulesPath);
+}
+export async function runDocsCommand(options) {
+    if (!(await exists(CLI_DOCS_DIR))) {
+        console.error(`Documentation directory not found: ${CLI_DOCS_DIR}\nRun "pnpm build" to generate documentation files.`);
+        return { exitCode: 1, filesWritten: [] };
+    }
+    const filesWritten = [];
+    const autoDetect = !options.claude && !options.codex;
+    const generateClaude = options.claude ||
+        (autoDetect && (await detectClaudeEnvironment(options.output)));
+    const generateCodex = options.codex ||
+        (autoDetect && (await detectCodexEnvironment(options.output)));
+    if (!generateClaude && !generateCodex) {
+        console.log("No AI tool environment detected. Use --claude or --codex to generate explicitly.");
+        return { exitCode: 0, filesWritten: [] };
+    }
+    if (generateClaude) {
+        await generateToolFiles(options.output, { configDir: ".claude", rulesFile: "CLAUDE.md" }, filesWritten);
+    }
+    if (generateCodex) {
+        await generateToolFiles(options.output, { configDir: ".codex", rulesFile: "AGENTS.md" }, filesWritten);
+    }
+    return { exitCode: 0, filesWritten };
+}
+export const docsCommand = define({
+    name: "docs",
+    args: {
+        output: {
+            type: "string",
+            description: "Output directory for generated files",
+        },
+        claude: {
+            type: "boolean",
+            description: `Generate Claude Code files (.claude/skills/${SKILL_NAME}/, CLAUDE.md)`,
+        },
+        codex: {
+            type: "boolean",
+            description: `Generate Codex files (.codex/skills/${SKILL_NAME}/, AGENTS.md)`,
+        },
+    },
+    run: async (ctx) => {
+        const output = ctx.values.output ?? process.cwd();
+        const claude = ctx.values.claude ?? false;
+        const codex = ctx.values.codex ?? false;
+        const result = await runDocsCommand({ output, claude, codex });
+        for (const file of result.filesWritten) {
+            console.log(`Generated: ${file}`);
+        }
+        if (result.exitCode !== 0) {
+            process.exitCode = result.exitCode;
+        }
+    },
+});
+//# sourceMappingURL=docs.js.map

package/dist/commands/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"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"}

package/dist/gen-orchestrator/orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/gen-orchestrator/orchestrator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,2BAA2B,CAAC;AAqCnC,OAAO,KAAK,EACV,UAAU,EAGX,MAAM,4BAA4B,CAAC;AAQpC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAAC;IACpE,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACjD;AAsoBD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAqC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAY3B"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/gen-orchestrator/orchestrator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,2BAA2B,CAAC;AAqCnC,OAAO,KAAK,EACV,UAAU,EAGX,MAAM,4BAA4B,CAAC;AAQpC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAAC;IACpE,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACjD;AAopBD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAqC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAY3B"}

package/dist/gen-orchestrator/orchestrator.js

@@ -118,6 +118,7 @@ function convertArgsToInputValues(args) {
         externalEnumSymbol: arg.tsType.externalEnumSymbol ?? null,
         externalEnumDescription: arg.tsType.externalEnumDescription ?? null,
         externalEnumDeprecated: arg.tsType.externalEnumDeprecated ?? null,
+        inlineUnionMembers: arg.tsType.kind === "union" ? (arg.tsType.members ?? null) : null,
     }));
 }
 function convertDefineApiToFields(resolvers) {
@@ -125,19 +126,24 @@ function convertDefineApiToFields(resolvers) {
     const mutationFields = [];
     const typeExtensionMap = new Map();
     for (const resolver of resolvers) {
+        const returnType = resolver.returnType;
         const fieldDef = {
             name: resolver.fieldName,
-            type: convertTsTypeToGraphQLType(resolver.returnType),
+            type: convertTsTypeToGraphQLType(returnType),
             args: resolver.args ? convertArgsToInputValues(resolver.args) : null,
-            sourceLocation: {
-                file: resolver.sourceFile,
-                line: 1,
-                column: 1,
-            },
+            sourceLocation: resolver.sourceLocation,
             resolverExportName: resolver.fieldName,
             description: resolver.description,
             deprecated: resolver.deprecated,
             directives: resolver.directives,
+            returnTypeInlineObjectProperties: returnType.inlineObjectProperties ?? null,
+            returnTypeInlineObjectDescription: returnType.inlineObjectDescription ?? null,
+            returnTypeInlineObjectDeprecated: returnType.inlineObjectDeprecated ?? null,
+            returnTypeInlineEnumMembers: returnType.inlineEnumMembers ?? null,
+            returnTypeInlineUnionMembers: returnType.kind === "union" ? (returnType.members ?? null) : null,
+            returnTypeExternalEnumSymbol: returnType.externalEnumSymbol ?? null,
+            returnTypeExternalEnumDescription: returnType.externalEnumDescription ?? null,
+            returnTypeExternalEnumDeprecated: returnType.externalEnumDeprecated ?? null,
         };
         if (resolver.resolverType === "query") {
             queryFields.push(fieldDef);
@@ -426,6 +432,7 @@ function generateSchemaStep(ctx) {
             : null,
         enablePruning: null,
         sourceRoot: ctx.config.cwd,
+        knownTypeNames: ctx.knownTypeNames,
     });
     const newDiagnostics = [...ctx.diagnostics, ...schemaResult.diagnostics];
     if (schemaResult.hasErrors) {