@soda-gql/core 0.13.1 → 0.13.2

package/dist/index.cjs

@@ -2403,220 +2403,6 @@ const createVarAssignments = (definitions, providedValues) => {
 */
 const createVarRefs = (definitions) => mapValues(definitions, (_, name) => createVarRefFromVariable(name));
 
-//#endregion
-//#region packages/core/src/composer/operation-core.ts
-/**
-* Core operation building logic shared by operation and extend composers.
-* @module
-* @internal
-*/
-/**
-* Builds an operation artifact from the provided parameters.
-*
-* This function contains the core logic for:
-* - Creating variable refs and field factories
-* - Evaluating fields with fragment usage tracking
-* - Building the document
-* - Handling metadata (sync and async)
-* - Applying document transformations
-*
-* @param params - Operation building parameters
-* @returns Operation artifact or Promise of artifact (if async metadata)
-*
-* @internal Used by operation.ts, extend.ts, and operation-tagged-template.ts
-*/
-const buildOperationArtifact = (params) => {
-	const { schema, operationType, operationTypeName, operationName, variables, adapter, metadata: metadataBuilder, transformDocument: operationTransformDocument, adapterTransformDocument } = params;
-	const $ = createVarRefs(variables);
-	let document;
-	let variableNames;
-	let fields;
-	let fragmentUsages;
-	if (params.mode === "prebuilt") {
-		document = params.prebuiltDocument;
-		variableNames = params.prebuiltVariableNames ?? Object.keys(variables);
-		fields = {};
-		fragmentUsages = [];
-	} else {
-		const { fieldsFactory } = params;
-		const f = createFieldFactories(schema, operationTypeName);
-		const collected = withFragmentUsageCollection(() => fieldsFactory({
-			f,
-			$
-		}));
-		fields = collected.result;
-		fragmentUsages = collected.usages;
-		document = buildDocument({
-			operationName,
-			operationType,
-			operationTypeName,
-			variables,
-			fields,
-			schema
-		});
-		variableNames = Object.keys(variables);
-	}
-	if (!fragmentUsages.some((u) => u.metadataBuilder) && !metadataBuilder && !adapterTransformDocument && !operationTransformDocument) return {
-		operationType,
-		operationName,
-		schemaLabel: schema.label,
-		variableNames,
-		documentSource: () => fields,
-		document,
-		metadata: void 0
-	};
-	const aggregateFragmentMetadata = (resolvedFragmentMetadata) => {
-		const fragmentMetaInfos = fragmentUsages.map((usage, index) => ({
-			metadata: resolvedFragmentMetadata[index],
-			fieldPath: usage.path
-		}));
-		return adapter.aggregateFragmentMetadata(fragmentMetaInfos);
-	};
-	const fragmentMetadataResults = fragmentUsages.map((usage) => usage.metadataBuilder ? usage.metadataBuilder() : void 0);
-	const hasAsyncFragmentMetadata = fragmentMetadataResults.some((r) => isPromiseLike(r));
-	const buildOperationMetadata = (aggregatedFragmentMetadata) => {
-		const schemaLevel = adapter.schemaLevel;
-		return metadataBuilder?.({
-			$,
-			document,
-			fragmentMetadata: aggregatedFragmentMetadata,
-			schemaLevel
-		});
-	};
-	const makeCreateArtifact = (aggregated$1) => {
-		return ({ metadata }) => {
-			let finalDocument = operationTransformDocument ? operationTransformDocument({
-				document,
-				metadata
-			}) : document;
-			if (adapterTransformDocument) finalDocument = adapterTransformDocument({
-				document: finalDocument,
-				operationName,
-				operationType,
-				variableNames,
-				schemaLevel: adapter.schemaLevel,
-				fragmentMetadata: aggregated$1
-			});
-			return {
-				operationType,
-				operationName,
-				schemaLabel: schema.label,
-				variableNames,
-				documentSource: () => fields,
-				document: finalDocument,
-				metadata
-			};
-		};
-	};
-	if (hasAsyncFragmentMetadata) return Promise.all(fragmentMetadataResults).then(async (resolvedFragmentMetadata) => {
-		const aggregated$1 = aggregateFragmentMetadata(resolvedFragmentMetadata);
-		const operationMetadata = await buildOperationMetadata(aggregated$1);
-		return makeCreateArtifact(aggregated$1)({ metadata: operationMetadata });
-	});
-	const aggregated = aggregateFragmentMetadata(fragmentMetadataResults);
-	const createArtifact = makeCreateArtifact(aggregated);
-	const operationMetadataResult = buildOperationMetadata(aggregated);
-	if (isPromiseLike(operationMetadataResult)) return operationMetadataResult.then((metadata) => createArtifact({ metadata }));
-	return createArtifact({ metadata: operationMetadataResult });
-};
-/**
-* Wraps a buildOperationArtifact call into an Operation.create() invocation,
-* handling both sync and async artifact results.
-*
-* @param artifactFactory - Factory that produces the artifact (may return Promise for async metadata)
-* @param overrideDocumentSource - When true, overrides documentSource to return empty object.
-*   Required for pre-built document mode where fields = {} and the real documentSource is meaningless.
-*   Must be false for fieldsFactory mode to preserve real field selections.
-*
-* @internal Used by extend.ts and operation-tagged-template.ts
-*/
-const wrapArtifactAsOperation = (artifactFactory, overrideDocumentSource) => {
-	return Operation.create((() => {
-		const artifact = artifactFactory();
-		if (overrideDocumentSource) {
-			if (isPromiseLike(artifact)) return artifact.then((a) => ({
-				...a,
-				documentSource: () => ({})
-			}));
-			return {
-				...artifact,
-				documentSource: () => ({})
-			};
-		}
-		if (isPromiseLike(artifact)) return artifact;
-		return artifact;
-	}));
-};
-
-//#endregion
-//#region packages/core/src/composer/extend.ts
-/**
-* Extend composer factory for creating Operations from compat specs.
-* @module
-*/
-/**
-* Creates a factory for extending compat specs into full operations.
-*
-* The extend function takes a compat spec (created by `query.compat()`) and
-* optional metadata/transformDocument options, then creates a full Operation.
-*
-* @param schema - The GraphQL schema definition
-* @param adapter - Optional metadata adapter for custom metadata handling
-* @param transformDocument - Optional document transformer
-* @returns Extend composer function
-*
-* @internal Used by `createGqlElementComposer`
-*/
-const createExtendComposer = (schema, adapter, transformDocument) => {
-	const resolvedAdapter = adapter ?? defaultMetadataAdapter;
-	return (compat, options) => {
-		const spec = compat.value;
-		if (isTemplateCompatSpec(spec)) return buildOperationFromTemplateSpec(schema, spec, resolvedAdapter, options, transformDocument);
-		const { operationType, operationName, variables, fieldsBuilder } = spec;
-		const operationTypeName = schema.operations[operationType];
-		return Operation.create((() => buildOperationArtifact({
-			mode: "fieldsFactory",
-			schema,
-			operationType,
-			operationTypeName,
-			operationName,
-			variables,
-			fieldsFactory: fieldsBuilder,
-			adapter: resolvedAdapter,
-			metadata: options?.metadata,
-			transformDocument: options?.transformDocument,
-			adapterTransformDocument: transformDocument
-		})));
-	};
-};
-/**
-* Builds an Operation from a TemplateCompatSpec by parsing the raw GraphQL source.
-* Delegates to buildOperationArtifact with pre-built document mode.
-*/
-const buildOperationFromTemplateSpec = (schema, spec, adapter, options, adapterTransformDocument) => {
-	const { operationType, operationName, graphqlSource } = spec;
-	const document = (0, graphql.parse)(graphqlSource);
-	const opDef = document.definitions.find((d) => d.kind === graphql.Kind.OPERATION_DEFINITION);
-	if (!opDef) throw new Error("No operation definition found in compat template spec");
-	const schemaIndex = createSchemaIndexFromSchema(spec.schema);
-	const varSpecifiers = buildVarSpecifiers(opDef.variableDefinitions ?? [], schemaIndex);
-	const operationTypeName = schema.operations[operationType];
-	return wrapArtifactAsOperation(() => buildOperationArtifact({
-		mode: "prebuilt",
-		schema,
-		operationType,
-		operationTypeName,
-		operationName,
-		variables: varSpecifiers,
-		prebuiltDocument: document,
-		prebuiltVariableNames: Object.keys(varSpecifiers),
-		adapter,
-		metadata: options?.metadata,
-		transformDocument: options?.transformDocument,
-		adapterTransformDocument
-	}), true);
-};
-
 //#endregion
 //#region packages/core/src/composer/merge-variable-definitions.ts
 /**
@@ -2680,6 +2466,30 @@ function extractFragmentVariables(rawSource, schemaIndex) {
 	return buildVarSpecifiers(opDef.variableDefinitions ?? [], schemaIndex);
 }
 /**
+* Filters out named fragment spreads that cannot be resolved without an interpolation map.
+* Used when building fields from compat templates or zero-interpolation tagged templates
+* that may contain standard GraphQL `...FragmentName` spreads.
+*/
+function filterUnresolvedFragmentSpreads(selectionSet, interpolationMap) {
+	return {
+		...selectionSet,
+		selections: selectionSet.selections.filter((sel) => {
+			if (sel.kind !== graphql.Kind.FRAGMENT_SPREAD) return true;
+			return interpolationMap?.has(sel.name.value) ?? false;
+		}).map((sel) => {
+			if (sel.kind === graphql.Kind.FIELD && sel.selectionSet) return {
+				...sel,
+				selectionSet: filterUnresolvedFragmentSpreads(sel.selectionSet, interpolationMap)
+			};
+			if (sel.kind === graphql.Kind.INLINE_FRAGMENT && sel.selectionSet) return {
+				...sel,
+				selectionSet: filterUnresolvedFragmentSpreads(sel.selectionSet, interpolationMap)
+			};
+			return sel;
+		})
+	};
+}
+/**
 * Builds field selections from a GraphQL AST SelectionSet by driving field factories.
 * Converts parsed AST selections into the AnyFieldsExtended format that the document builder expects.
 * Also used by typegen for static field extraction from tagged templates.
@@ -2882,6 +2692,191 @@ function createFragmentTaggedTemplate(schema) {
 	};
 }
 
+//#endregion
+//#region packages/core/src/composer/operation-core.ts
+/**
+* Core operation building logic shared by operation and extend composers.
+* @module
+* @internal
+*/
+/**
+* Builds an operation artifact from the provided parameters.
+*
+* This function contains the core logic for:
+* - Creating variable refs and field factories
+* - Evaluating fields with fragment usage tracking
+* - Building the document
+* - Handling metadata (sync and async)
+* - Applying document transformations
+*
+* @param params - Operation building parameters
+* @returns Operation artifact or Promise of artifact (if async metadata)
+*
+* @internal Used by operation.ts, extend.ts, and operation-tagged-template.ts
+*/
+const buildOperationArtifact = (params) => {
+	const { schema, operationType, operationTypeName, operationName, variables, adapter, metadata: metadataBuilder, transformDocument: operationTransformDocument, adapterTransformDocument } = params;
+	const $ = createVarRefs(variables);
+	const { fieldsFactory } = params;
+	const f = createFieldFactories(schema, operationTypeName);
+	const collected = withFragmentUsageCollection(() => fieldsFactory({
+		f,
+		$
+	}));
+	const fields = collected.result;
+	const fragmentUsages = collected.usages;
+	const document = buildDocument({
+		operationName,
+		operationType,
+		operationTypeName,
+		variables,
+		fields,
+		schema
+	});
+	const variableNames = Object.keys(variables);
+	if (!fragmentUsages.some((u) => u.metadataBuilder) && !metadataBuilder && !adapterTransformDocument && !operationTransformDocument) return {
+		operationType,
+		operationName,
+		schemaLabel: schema.label,
+		variableNames,
+		documentSource: () => fields,
+		document,
+		metadata: void 0
+	};
+	const aggregateFragmentMetadata = (resolvedFragmentMetadata) => {
+		const fragmentMetaInfos = fragmentUsages.map((usage, index) => ({
+			metadata: resolvedFragmentMetadata[index],
+			fieldPath: usage.path
+		}));
+		return adapter.aggregateFragmentMetadata(fragmentMetaInfos);
+	};
+	const fragmentMetadataResults = fragmentUsages.map((usage) => usage.metadataBuilder ? usage.metadataBuilder() : void 0);
+	const hasAsyncFragmentMetadata = fragmentMetadataResults.some((r) => isPromiseLike(r));
+	const buildOperationMetadata = (aggregatedFragmentMetadata) => {
+		const schemaLevel = adapter.schemaLevel;
+		return metadataBuilder?.({
+			$,
+			document,
+			fragmentMetadata: aggregatedFragmentMetadata,
+			schemaLevel
+		});
+	};
+	const makeCreateArtifact = (aggregated$1) => {
+		return ({ metadata }) => {
+			let finalDocument = operationTransformDocument ? operationTransformDocument({
+				document,
+				metadata
+			}) : document;
+			if (adapterTransformDocument) finalDocument = adapterTransformDocument({
+				document: finalDocument,
+				operationName,
+				operationType,
+				variableNames,
+				schemaLevel: adapter.schemaLevel,
+				fragmentMetadata: aggregated$1
+			});
+			return {
+				operationType,
+				operationName,
+				schemaLabel: schema.label,
+				variableNames,
+				documentSource: () => fields,
+				document: finalDocument,
+				metadata
+			};
+		};
+	};
+	if (hasAsyncFragmentMetadata) return Promise.all(fragmentMetadataResults).then(async (resolvedFragmentMetadata) => {
+		const aggregated$1 = aggregateFragmentMetadata(resolvedFragmentMetadata);
+		const operationMetadata = await buildOperationMetadata(aggregated$1);
+		return makeCreateArtifact(aggregated$1)({ metadata: operationMetadata });
+	});
+	const aggregated = aggregateFragmentMetadata(fragmentMetadataResults);
+	const createArtifact = makeCreateArtifact(aggregated);
+	const operationMetadataResult = buildOperationMetadata(aggregated);
+	if (isPromiseLike(operationMetadataResult)) return operationMetadataResult.then((metadata) => createArtifact({ metadata }));
+	return createArtifact({ metadata: operationMetadataResult });
+};
+/**
+* Wraps a buildOperationArtifact call into an Operation.create() invocation,
+* handling both sync and async artifact results.
+*
+* @param artifactFactory - Factory that produces the artifact (may return Promise for async metadata)
+*
+* @internal Used by extend.ts and operation-tagged-template.ts
+*/
+const wrapArtifactAsOperation = (artifactFactory) => {
+	return Operation.create(artifactFactory);
+};
+
+//#endregion
+//#region packages/core/src/composer/extend.ts
+/**
+* Extend composer factory for creating Operations from compat specs.
+* @module
+*/
+/**
+* Creates a factory for extending compat specs into full operations.
+*
+* The extend function takes a compat spec (created by `query.compat()`) and
+* optional metadata/transformDocument options, then creates a full Operation.
+*
+* @param schema - The GraphQL schema definition
+* @param adapter - Optional metadata adapter for custom metadata handling
+* @param transformDocument - Optional document transformer
+* @returns Extend composer function
+*
+* @internal Used by `createGqlElementComposer`
+*/
+const createExtendComposer = (schema, adapter, transformDocument) => {
+	const resolvedAdapter = adapter ?? defaultMetadataAdapter;
+	return (compat, options) => {
+		const spec = compat.value;
+		if (isTemplateCompatSpec(spec)) return buildOperationFromTemplateSpec(schema, spec, resolvedAdapter, options, transformDocument);
+		const { operationType, operationName, variables, fieldsBuilder } = spec;
+		const operationTypeName = schema.operations[operationType];
+		return Operation.create((() => buildOperationArtifact({
+			schema,
+			operationType,
+			operationTypeName,
+			operationName,
+			variables,
+			fieldsFactory: fieldsBuilder,
+			adapter: resolvedAdapter,
+			metadata: options?.metadata,
+			transformDocument: options?.transformDocument,
+			adapterTransformDocument: transformDocument
+		})));
+	};
+};
+/**
+* Builds an Operation from a TemplateCompatSpec by parsing the raw GraphQL source.
+* Evaluates fields via buildFieldsFromSelectionSet for correct typegen output.
+*/
+const buildOperationFromTemplateSpec = (schema, spec, adapter, options, adapterTransformDocument) => {
+	const { operationType, operationName, graphqlSource } = spec;
+	const opDef = (0, graphql.parse)(graphqlSource).definitions.find((d) => d.kind === graphql.Kind.OPERATION_DEFINITION);
+	if (!opDef) throw new Error("No operation definition found in compat template spec");
+	const schemaIndex = createSchemaIndexFromSchema(spec.schema);
+	const varSpecifiers = buildVarSpecifiers(opDef.variableDefinitions ?? [], schemaIndex);
+	const operationTypeName = schema.operations[operationType];
+	const filteredSelectionSet = filterUnresolvedFragmentSpreads(opDef.selectionSet);
+	return wrapArtifactAsOperation(() => buildOperationArtifact({
+		schema,
+		operationType,
+		operationTypeName,
+		operationName,
+		variables: varSpecifiers,
+		fieldsFactory: ({ $ }) => {
+			return buildFieldsFromSelectionSet(filteredSelectionSet, schema, operationTypeName, $);
+		},
+		adapter,
+		metadata: options?.metadata,
+		transformDocument: options?.transformDocument,
+		adapterTransformDocument
+	}));
+};
+
 //#endregion
 //#region packages/core/src/composer/operation.ts
 /**
@@ -2911,7 +2906,6 @@ const createOperationComposerFactory = (schema, adapter, transformDocument) => {
 		if (operationTypeName === null) throw new Error(`Operation type ${operationType} is not defined in schema roots`);
 		return (options) => {
 			return Operation.create((() => buildOperationArtifact({
-				mode: "fieldsFactory",
 				schema,
 				operationType,
 				operationTypeName,
@@ -2996,33 +2990,19 @@ const createOperationTaggedTemplate = (schema, operationType, metadataAdapter, a
 			const resolvedAdapter = metadataAdapter ?? defaultMetadataAdapter;
 			return (options) => {
 				const resolvedMetadata = resolveMetadataOption(options?.metadata);
-				if (interpolationMap.size === 0) return wrapArtifactAsOperation(() => buildOperationArtifact({
-					mode: "prebuilt",
-					schema,
-					operationType,
-					operationTypeName,
-					operationName,
-					variables: varSpecifiers,
-					prebuiltDocument: document,
-					prebuiltVariableNames: Object.keys(varSpecifiers),
-					adapter: resolvedAdapter,
-					metadata: resolvedMetadata,
-					adapterTransformDocument
-				}), true);
 				return wrapArtifactAsOperation(() => buildOperationArtifact({
-					mode: "fieldsFactory",
 					schema,
 					operationType,
 					operationTypeName,
 					operationName,
 					variables: varSpecifiers,
 					fieldsFactory: ({ $ }) => {
-						return buildFieldsFromSelectionSet(opNode.selectionSet, schema, operationTypeName, $, interpolationMap);
+						return buildFieldsFromSelectionSet(filterUnresolvedFragmentSpreads(opNode.selectionSet, interpolationMap), schema, operationTypeName, $, interpolationMap);
 					},
 					adapter: resolvedAdapter,
 					metadata: resolvedMetadata,
 					adapterTransformDocument
-				}), false);
+				}));
 			};
 		};
 	};
@@ -3668,6 +3648,7 @@ exports.defineOperationRoots = require_schema_builder.defineOperationRoots;
 exports.defineScalar = require_schema_builder.defineScalar;
 exports.err = err;
 exports.extractFragmentVariables = extractFragmentVariables;
+exports.filterUnresolvedFragmentSpreads = filterUnresolvedFragmentSpreads;
 exports.generateInputObjectType = generateInputObjectType;
 exports.generateInputType = generateInputType;
 exports.generateInputTypeFromSpecifiers = generateInputTypeFromSpecifiers;