@soda-gql/codegen 0.11.11 → 0.11.12

package/dist/index.cjs

@@ -1,11 +1,675 @@
 const require_generator = require('./generator-DvfP6gTY.cjs');
+let neverthrow = require("neverthrow");
+let graphql = require("graphql");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
-let neverthrow = require("neverthrow");
 let esbuild = require("esbuild");
-let graphql = require("graphql");
 let node_crypto = require("node:crypto");
 
+//#region packages/codegen/src/graphql-compat/emitter.ts
+/**
+* Emit TypeScript code for an operation.
+*/
+const emitOperation = (operation, options) => {
+	const lines = [];
+	const schema = options.schemaDocument ? require_generator.createSchemaIndex(options.schemaDocument) : null;
+	lines.push(`import { gql } from "${options.graphqlSystemPath}";`);
+	if (operation.fragmentDependencies.length > 0 && options.fragmentImports) {
+		for (const fragName of operation.fragmentDependencies) {
+			const importPath = options.fragmentImports.get(fragName);
+			if (importPath) {
+				lines.push(`import { ${fragName}Fragment } from "${importPath}";`);
+			}
+		}
+	}
+	lines.push("");
+	const exportName = `${operation.name}Compat`;
+	const operationType = operation.kind;
+	lines.push(`export const ${exportName} = gql.${options.schemaName}(({ ${operationType}, $var }) =>`);
+	lines.push(`  ${operationType}.compat({`);
+	lines.push(`    name: ${JSON.stringify(operation.name)},`);
+	if (operation.variables.length > 0) {
+		lines.push(`    variables: { ${emitVariables(operation.variables)} },`);
+	}
+	lines.push(`    fields: ({ f, $ }) => ({`);
+	const fieldLinesResult = emitSelections(operation.selections, 3, operation.variables, schema);
+	if (fieldLinesResult.isErr()) {
+		return (0, neverthrow.err)(fieldLinesResult.error);
+	}
+	lines.push(fieldLinesResult.value);
+	lines.push(`    }),`);
+	lines.push(`  }),`);
+	lines.push(`);`);
+	return (0, neverthrow.ok)(lines.join("\n"));
+};
+/**
+* Emit TypeScript code for a fragment.
+*/
+const emitFragment = (fragment, options) => {
+	const lines = [];
+	const schema = options.schemaDocument ? require_generator.createSchemaIndex(options.schemaDocument) : null;
+	lines.push(`import { gql } from "${options.graphqlSystemPath}";`);
+	if (fragment.fragmentDependencies.length > 0 && options.fragmentImports) {
+		for (const fragName of fragment.fragmentDependencies) {
+			const importPath = options.fragmentImports.get(fragName);
+			if (importPath) {
+				lines.push(`import { ${fragName}Fragment } from "${importPath}";`);
+			}
+		}
+	}
+	lines.push("");
+	const exportName = `${fragment.name}Fragment`;
+	lines.push(`export const ${exportName} = gql.${options.schemaName}(({ fragment }) =>`);
+	lines.push(`  fragment.${fragment.onType}({`);
+	lines.push(`    fields: ({ f }) => ({`);
+	const fieldLinesResult = emitSelections(fragment.selections, 3, [], schema);
+	if (fieldLinesResult.isErr()) {
+		return (0, neverthrow.err)(fieldLinesResult.error);
+	}
+	lines.push(fieldLinesResult.value);
+	lines.push(`    }),`);
+	lines.push(`  }),`);
+	lines.push(`);`);
+	return (0, neverthrow.ok)(lines.join("\n"));
+};
+/**
+* Emit variable definitions.
+*/
+const emitVariables = (variables) => {
+	return variables.map((v) => `...$var(${JSON.stringify(v.name)}).${v.typeName}(${JSON.stringify(v.modifier)})`).join(", ");
+};
+/**
+* Emit field selections (public API).
+* Converts EnrichedVariable[] to Set<string> and delegates to internal implementation.
+*/
+const emitSelections = (selections, indent, variables, schema) => {
+	const variableNames = new Set(variables.map((v) => v.name));
+	return emitSelectionsInternal(selections, indent, variableNames, schema);
+};
+/**
+* Internal implementation for emitting field selections.
+* Takes variableNames as Set<string> for recursive calls.
+*/
+const emitSelectionsInternal = (selections, indent, variableNames, schema) => {
+	const lines = [];
+	const inlineFragments = [];
+	const otherSelections = [];
+	for (const sel of selections) {
+		if (sel.kind === "inlineFragment") {
+			inlineFragments.push(sel);
+		} else {
+			otherSelections.push(sel);
+		}
+	}
+	for (const sel of otherSelections) {
+		const result = emitSingleSelection(sel, indent, variableNames, schema);
+		if (result.isErr()) {
+			return (0, neverthrow.err)(result.error);
+		}
+		lines.push(result.value);
+	}
+	if (inlineFragments.length > 0) {
+		const unionResult = emitInlineFragmentsAsUnion(inlineFragments, indent, variableNames, schema);
+		if (unionResult.isErr()) {
+			return (0, neverthrow.err)(unionResult.error);
+		}
+		lines.push(unionResult.value);
+	}
+	return (0, neverthrow.ok)(lines.join("\n"));
+};
+/**
+* Emit a single selection (field or fragment spread).
+*/
+const emitSingleSelection = (sel, indent, variableNames, schema) => {
+	const padding = "  ".repeat(indent);
+	switch (sel.kind) {
+		case "field": return emitFieldSelection(sel, indent, variableNames, schema);
+		case "fragmentSpread": return (0, neverthrow.ok)(`${padding}...${sel.name}Fragment.spread(),`);
+		case "inlineFragment": return (0, neverthrow.ok)("");
+	}
+};
+/**
+* Emit inline fragments grouped as a union selection.
+* Format: { TypeA: ({ f }) => ({ ...fields }), TypeB: ({ f }) => ({ ...fields }) }
+*/
+const emitInlineFragmentsAsUnion = (inlineFragments, indent, variableNames, schema) => {
+	const padding = "  ".repeat(indent);
+	for (const frag of inlineFragments) {
+		if (frag.onType === "") {
+			return (0, neverthrow.err)({
+				code: "GRAPHQL_INLINE_FRAGMENT_WITHOUT_TYPE",
+				message: "Inline fragments without type condition are not supported. Use `... on TypeName { }` syntax."
+			});
+		}
+	}
+	for (const frag of inlineFragments) {
+		if (schema && !schema.objects.has(frag.onType)) {
+			let isUnionMember = false;
+			for (const [, unionDef] of schema.unions) {
+				if (unionDef.members.has(frag.onType)) {
+					isUnionMember = true;
+					break;
+				}
+			}
+			if (!isUnionMember) {
+				return (0, neverthrow.err)({
+					code: "GRAPHQL_INLINE_FRAGMENT_ON_INTERFACE",
+					message: `Inline fragments on interface type "${frag.onType}" are not supported. Use union types instead.`,
+					onType: frag.onType
+				});
+			}
+		}
+	}
+	const entries = [];
+	for (const frag of inlineFragments) {
+		const innerPadding = "  ".repeat(indent + 1);
+		const fieldsResult = emitSelectionsInternal(frag.selections, indent + 2, variableNames, schema);
+		if (fieldsResult.isErr()) {
+			return (0, neverthrow.err)(fieldsResult.error);
+		}
+		entries.push(`${innerPadding}${frag.onType}: ({ f }) => ({
+${fieldsResult.value}
+${innerPadding}}),`);
+	}
+	return (0, neverthrow.ok)(`${padding}...({
+${entries.join("\n")}
+${padding}}),`);
+};
+/**
+* Emit a single field selection.
+*/
+const emitFieldSelection = (field, indent, variableNames, schema) => {
+	const padding = "  ".repeat(indent);
+	const args = field.arguments;
+	const selections = field.selections;
+	const hasArgs = args && args.length > 0;
+	const hasSelections = selections && selections.length > 0;
+	let line = `${padding}...f.${field.name}(`;
+	if (hasArgs) {
+		const argsResult = emitArguments(args, variableNames);
+		if (argsResult.isErr()) {
+			return (0, neverthrow.err)(argsResult.error);
+		}
+		line += argsResult.value;
+	}
+	line += ")";
+	if (hasSelections) {
+		const hasInlineFragments = selections.some((s) => s.kind === "inlineFragment");
+		if (hasInlineFragments) {
+			const nestedResult = emitSelectionsInternal(selections, indent + 1, variableNames, schema);
+			if (nestedResult.isErr()) {
+				return (0, neverthrow.err)(nestedResult.error);
+			}
+			line += "({\n";
+			line += `${nestedResult.value}\n`;
+			line += `${padding}})`;
+		} else {
+			line += "(({ f }) => ({\n";
+			const nestedResult = emitSelectionsInternal(selections, indent + 1, variableNames, schema);
+			if (nestedResult.isErr()) {
+				return (0, neverthrow.err)(nestedResult.error);
+			}
+			line += `${nestedResult.value}\n`;
+			line += `${padding}}))`;
+		}
+	}
+	line += ",";
+	return (0, neverthrow.ok)(line);
+};
+/**
+* Emit field arguments.
+*/
+const emitArguments = (args, variableNames) => {
+	if (args.length === 0) {
+		return (0, neverthrow.ok)("");
+	}
+	const argEntries = [];
+	for (const arg of args) {
+		const result = emitValue(arg.value, variableNames);
+		if (result.isErr()) {
+			return (0, neverthrow.err)(result.error);
+		}
+		argEntries.push(`${arg.name}: ${result.value}`);
+	}
+	return (0, neverthrow.ok)(`{ ${argEntries.join(", ")} }`);
+};
+/**
+* Emit a value (literal or variable reference).
+*/
+const emitValue = (value, variableNames) => {
+	switch (value.kind) {
+		case "variable":
+			if (variableNames.has(value.name)) {
+				return (0, neverthrow.ok)(`$.${value.name}`);
+			}
+			return (0, neverthrow.err)({
+				code: "GRAPHQL_UNDECLARED_VARIABLE",
+				message: `Variable "$${value.name}" is not declared in the operation`,
+				variableName: value.name
+			});
+		case "int":
+		case "float": return (0, neverthrow.ok)(value.value);
+		case "string": return (0, neverthrow.ok)(JSON.stringify(value.value));
+		case "boolean": return (0, neverthrow.ok)(value.value ? "true" : "false");
+		case "null": return (0, neverthrow.ok)("null");
+		case "enum": return (0, neverthrow.ok)(JSON.stringify(value.value));
+		case "list": {
+			const values = [];
+			for (const v of value.values) {
+				const result = emitValue(v, variableNames);
+				if (result.isErr()) {
+					return (0, neverthrow.err)(result.error);
+				}
+				values.push(result.value);
+			}
+			return (0, neverthrow.ok)(`[${values.join(", ")}]`);
+		}
+		case "object": {
+			if (value.fields.length === 0) {
+				return (0, neverthrow.ok)("{}");
+			}
+			const entries = [];
+			for (const f of value.fields) {
+				const result = emitValue(f.value, variableNames);
+				if (result.isErr()) {
+					return (0, neverthrow.err)(result.error);
+				}
+				entries.push(`${f.name}: ${result.value}`);
+			}
+			return (0, neverthrow.ok)(`{ ${entries.join(", ")} }`);
+		}
+	}
+};
+
+//#endregion
+//#region packages/codegen/src/graphql-compat/parser.ts
+/**
+* Parser for .graphql operation files.
+* Extracts operations and fragments from GraphQL documents.
+* @module
+*/
+/**
+* Parse a single .graphql file and extract operations and fragments.
+*/
+const parseGraphqlFile = (filePath) => {
+	const resolvedPath = (0, node_path.resolve)(filePath);
+	if (!(0, node_fs.existsSync)(resolvedPath)) {
+		return (0, neverthrow.err)({
+			code: "GRAPHQL_FILE_NOT_FOUND",
+			message: `GraphQL file not found at ${resolvedPath}`,
+			filePath: resolvedPath
+		});
+	}
+	try {
+		const source = (0, node_fs.readFileSync)(resolvedPath, "utf8");
+		const document = (0, graphql.parse)(source);
+		return (0, neverthrow.ok)(extractFromDocument(document, resolvedPath));
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		return (0, neverthrow.err)({
+			code: "GRAPHQL_PARSE_ERROR",
+			message: `GraphQL parse error: ${message}`,
+			filePath: resolvedPath
+		});
+	}
+};
+/**
+* Parse GraphQL source string directly.
+*/
+const parseGraphqlSource = (source, sourceFile) => {
+	try {
+		const document = (0, graphql.parse)(source);
+		return (0, neverthrow.ok)(extractFromDocument(document, sourceFile));
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		return (0, neverthrow.err)({
+			code: "GRAPHQL_PARSE_ERROR",
+			message: `GraphQL parse error: ${message}`,
+			filePath: sourceFile
+		});
+	}
+};
+/**
+* Extract operations and fragments from a parsed GraphQL document.
+*/
+const extractFromDocument = (document, sourceFile) => {
+	const operations = [];
+	const fragments = [];
+	for (const definition of document.definitions) {
+		if (definition.kind === graphql.Kind.OPERATION_DEFINITION) {
+			const operation = extractOperation(definition, sourceFile);
+			if (operation) {
+				operations.push(operation);
+			}
+		} else if (definition.kind === graphql.Kind.FRAGMENT_DEFINITION) {
+			fragments.push(extractFragment(definition, sourceFile));
+		}
+	}
+	return {
+		operations,
+		fragments
+	};
+};
+/**
+* Extract a single operation from an OperationDefinitionNode.
+*/
+const extractOperation = (node, sourceFile) => {
+	if (!node.name) {
+		return null;
+	}
+	const variables = (node.variableDefinitions ?? []).map(extractVariable);
+	const selections = extractSelections(node.selectionSet.selections);
+	return {
+		kind: node.operation,
+		name: node.name.value,
+		variables,
+		selections,
+		sourceFile
+	};
+};
+/**
+* Extract a fragment from a FragmentDefinitionNode.
+*/
+const extractFragment = (node, sourceFile) => {
+	const selections = extractSelections(node.selectionSet.selections);
+	return {
+		name: node.name.value,
+		onType: node.typeCondition.name.value,
+		selections,
+		sourceFile
+	};
+};
+/**
+* Extract a variable definition.
+*/
+const extractVariable = (node) => {
+	const { typeName, modifier } = parseTypeNode(node.type);
+	const defaultValue = node.defaultValue ? extractValue(node.defaultValue) : undefined;
+	return {
+		name: node.variable.name.value,
+		typeName,
+		modifier,
+		typeKind: "scalar",
+		defaultValue
+	};
+};
+/**
+* Parse a GraphQL TypeNode into type name and modifier.
+*
+* Format: inner nullability + list modifiers
+* - Inner: `!` (non-null) or `?` (nullable)
+* - List: `[]!` (non-null list) or `[]?` (nullable list)
+*/
+const parseTypeNode = (node) => {
+	const levels = [];
+	const collect = (n, nonNull) => {
+		if (n.kind === graphql.Kind.NON_NULL_TYPE) {
+			return collect(n.type, true);
+		}
+		if (n.kind === graphql.Kind.LIST_TYPE) {
+			levels.push({
+				kind: "list",
+				nonNull
+			});
+			return collect(n.type, false);
+		}
+		levels.push({
+			kind: "named",
+			nonNull
+		});
+		return n.name.value;
+	};
+	const typeName = collect(node, false);
+	let modifier = "?";
+	for (const level of levels.slice().reverse()) {
+		if (level.kind === "named") {
+			modifier = level.nonNull ? "!" : "?";
+			continue;
+		}
+		const listSuffix = level.nonNull ? "[]!" : "[]?";
+		modifier = `${modifier}${listSuffix}`;
+	}
+	return {
+		typeName,
+		modifier
+	};
+};
+/**
+* Extract selections from a SelectionSet.
+*/
+const extractSelections = (selections) => {
+	return selections.map(extractSelection);
+};
+/**
+* Extract a single selection.
+*/
+const extractSelection = (node) => {
+	switch (node.kind) {
+		case graphql.Kind.FIELD: return extractFieldSelection(node);
+		case graphql.Kind.FRAGMENT_SPREAD: return extractFragmentSpread(node);
+		case graphql.Kind.INLINE_FRAGMENT: return extractInlineFragment(node);
+	}
+};
+/**
+* Extract a field selection.
+*/
+const extractFieldSelection = (node) => {
+	const args = node.arguments?.length ? node.arguments.map(extractArgument) : undefined;
+	const selections = node.selectionSet ? extractSelections(node.selectionSet.selections) : undefined;
+	return {
+		kind: "field",
+		name: node.name.value,
+		alias: node.alias?.value,
+		arguments: args,
+		selections
+	};
+};
+/**
+* Extract a fragment spread.
+*/
+const extractFragmentSpread = (node) => {
+	return {
+		kind: "fragmentSpread",
+		name: node.name.value
+	};
+};
+/**
+* Extract an inline fragment.
+*/
+const extractInlineFragment = (node) => {
+	return {
+		kind: "inlineFragment",
+		onType: node.typeCondition?.name.value ?? "",
+		selections: extractSelections(node.selectionSet.selections)
+	};
+};
+/**
+* Extract an argument.
+*/
+const extractArgument = (node) => {
+	return {
+		name: node.name.value,
+		value: extractValue(node.value)
+	};
+};
+/**
+* Assert unreachable code path (for exhaustiveness checks).
+*/
+const assertUnreachable = (value) => {
+	throw new Error(`Unexpected value: ${JSON.stringify(value)}`);
+};
+/**
+* Extract a value (literal or variable reference).
+*/
+const extractValue = (node) => {
+	switch (node.kind) {
+		case graphql.Kind.VARIABLE: return {
+			kind: "variable",
+			name: node.name.value
+		};
+		case graphql.Kind.INT: return {
+			kind: "int",
+			value: node.value
+		};
+		case graphql.Kind.FLOAT: return {
+			kind: "float",
+			value: node.value
+		};
+		case graphql.Kind.STRING: return {
+			kind: "string",
+			value: node.value
+		};
+		case graphql.Kind.BOOLEAN: return {
+			kind: "boolean",
+			value: node.value
+		};
+		case graphql.Kind.NULL: return { kind: "null" };
+		case graphql.Kind.ENUM: return {
+			kind: "enum",
+			value: node.value
+		};
+		case graphql.Kind.LIST: return {
+			kind: "list",
+			values: node.values.map(extractValue)
+		};
+		case graphql.Kind.OBJECT: return {
+			kind: "object",
+			fields: node.fields.map((field) => ({
+				name: field.name.value,
+				value: extractValue(field.value)
+			}))
+		};
+		default: return assertUnreachable(node);
+	}
+};
+
+//#endregion
+//#region packages/codegen/src/graphql-compat/transformer.ts
+/**
+* Built-in GraphQL scalar types.
+*/
+const builtinScalarTypes = new Set([
+	"ID",
+	"String",
+	"Int",
+	"Float",
+	"Boolean"
+]);
+/**
+* Check if a type name is a scalar type.
+*/
+const isScalarName = (schema, name) => builtinScalarTypes.has(name) || schema.scalars.has(name);
+/**
+* Check if a type name is an enum type.
+*/
+const isEnumName = (schema, name) => schema.enums.has(name);
+/**
+* Transform parsed operations/fragments by enriching them with schema information.
+*
+* This resolves variable type kinds (scalar, enum, input) and collects
+* fragment dependencies.
+*/
+const transformParsedGraphql = (parsed, options) => {
+	const schema = require_generator.createSchemaIndex(options.schemaDocument);
+	const operations = [];
+	for (const op of parsed.operations) {
+		const result = transformOperation(op, schema);
+		if (result.isErr()) {
+			return (0, neverthrow.err)(result.error);
+		}
+		operations.push(result.value);
+	}
+	const fragments = [];
+	for (const frag of parsed.fragments) {
+		const result = transformFragment(frag, schema);
+		if (result.isErr()) {
+			return (0, neverthrow.err)(result.error);
+		}
+		fragments.push(result.value);
+	}
+	return (0, neverthrow.ok)({
+		operations,
+		fragments
+	});
+};
+/**
+* Transform a single operation.
+*/
+const transformOperation = (op, schema) => {
+	const variables = [];
+	for (const v of op.variables) {
+		const typeKind = resolveTypeKind(schema, v.typeName);
+		if (typeKind === null) {
+			return (0, neverthrow.err)({
+				code: "GRAPHQL_UNKNOWN_TYPE",
+				message: `Unknown type "${v.typeName}" in variable "${v.name}"`,
+				typeName: v.typeName
+			});
+		}
+		variables.push({
+			...v,
+			typeKind
+		});
+	}
+	const fragmentDependencies = collectFragmentDependencies(op.selections);
+	return (0, neverthrow.ok)({
+		...op,
+		variables,
+		fragmentDependencies
+	});
+};
+/**
+* Transform a single fragment.
+*/
+const transformFragment = (frag, _schema) => {
+	const fragmentDependencies = collectFragmentDependencies(frag.selections);
+	return (0, neverthrow.ok)({
+		...frag,
+		fragmentDependencies
+	});
+};
+/**
+* Resolve the type kind for a type name.
+*/
+const resolveTypeKind = (schema, typeName) => {
+	if (isScalarName(schema, typeName)) {
+		return "scalar";
+	}
+	if (isEnumName(schema, typeName)) {
+		return "enum";
+	}
+	if (schema.inputs.has(typeName)) {
+		return "input";
+	}
+	return null;
+};
+/**
+* Collect fragment names used in selections (recursively).
+*/
+const collectFragmentDependencies = (selections) => {
+	const fragments = new Set();
+	const collect = (sels) => {
+		for (const sel of sels) {
+			switch (sel.kind) {
+				case "fragmentSpread":
+					fragments.add(sel.name);
+					break;
+				case "field":
+					if (sel.selections) {
+						collect(sel.selections);
+					}
+					break;
+				case "inlineFragment":
+					collect(sel.selections);
+					break;
+			}
+		}
+	};
+	collect(selections);
+	return [...fragments];
+};
+
+//#endregion
 //#region packages/codegen/src/inject-template.ts
 const templateContents = `\
 import { defineScalar } from "@soda-gql/core";
@@ -478,8 +1142,14 @@ export * from "./_internal";
 };
 
 //#endregion
+exports.emitFragment = emitFragment;
+exports.emitOperation = emitOperation;
 exports.hashSchema = hashSchema;
 exports.loadSchema = loadSchema;
+exports.parseGraphqlFile = parseGraphqlFile;
+exports.parseGraphqlSource = parseGraphqlSource;
+exports.parseTypeNode = parseTypeNode;
 exports.runCodegen = runCodegen;
+exports.transformParsedGraphql = transformParsedGraphql;
 exports.writeInjectTemplate = writeInjectTemplate;
 //# sourceMappingURL=index.cjs.map