@soda-gql/tools 0.13.0

package/dist/formatter.cjs

@@ -0,0 +1,509 @@
+const require_chunk = require('./chunk-BrXtsOCC.cjs');
+let neverthrow = require("neverthrow");
+let node_crypto = require("node:crypto");
+let node_module = require("node:module");
+let __soda_gql_common_template_extraction = require("@soda-gql/common/template-extraction");
+let __soda_gql_common_utils = require("@soda-gql/common/utils");
+let __swc_core = require("@swc/core");
+
+//#region packages/tools/src/formatter/detection.ts
+/**
+* Check if an expression is a reference to gql
+* Handles: gql, namespace.gql
+*/
+const isGqlReference = (node, gqlIdentifiers) => {
+	const unwrapped = node.type === "TsNonNullExpression" ? node.expression : node;
+	if (unwrapped.type === "Identifier") {
+		return gqlIdentifiers.has(unwrapped.value);
+	}
+	if (unwrapped.type === "MemberExpression" && unwrapped.property.type === "Identifier" && unwrapped.property.value === "gql") {
+		return true;
+	}
+	return false;
+};
+/**
+* Check if a call expression is a gql definition call
+* Handles: gql.default(...), gql.model(...), gql.schemaName(...) (multi-schema)
+*/
+const isGqlDefinitionCall = (node, gqlIdentifiers) => {
+	if (node.callee.type !== "MemberExpression") return false;
+	const { object } = node.callee;
+	if (!isGqlReference(object, gqlIdentifiers)) return false;
+	const firstArg = node.arguments[0];
+	if (!firstArg || firstArg.expression.type !== "ArrowFunctionExpression" && firstArg.expression.type !== "FunctionExpression") return false;
+	return true;
+};
+/**
+* Check if an object expression is a field selection object
+* Field selection objects are returned from arrow functions with ({ f }) or ({ f, $ }) parameter
+*/
+const isFieldSelectionObject = (object, parent) => {
+	let bodyObject = null;
+	if (parent.body.type === "ObjectExpression") {
+		bodyObject = parent.body;
+	} else if (parent.body.type === "ParenthesisExpression") {
+		const inner = parent.body.expression;
+		if (inner.type === "ObjectExpression") {
+			bodyObject = inner;
+		}
+	}
+	if (!bodyObject) return false;
+	if (bodyObject.span.start !== object.span.start) return false;
+	const param = parent.params[0];
+	if (!param || param.type !== "ObjectPattern") return false;
+	return param.properties.some((p) => {
+		if (p.type === "KeyValuePatternProperty" && p.key.type === "Identifier") {
+			return p.key.value === "f";
+		}
+		if (p.type === "AssignmentPatternProperty" && p.key.type === "Identifier") {
+			return p.key.value === "f";
+		}
+		return false;
+	});
+};
+/**
+* Collect gql identifiers from import declarations
+*/
+const collectGqlIdentifiers = (module$1) => {
+	const gqlIdentifiers = new Set();
+	for (const item of module$1.body) {
+		if (item.type !== "ImportDeclaration") continue;
+		for (const specifier of item.specifiers) {
+			if (specifier.type === "ImportSpecifier") {
+				const imported = specifier.imported?.value ?? specifier.local.value;
+				if (imported === "gql") {
+					gqlIdentifiers.add(specifier.local.value);
+				}
+			}
+			if (specifier.type === "ImportDefaultSpecifier") {
+				if (specifier.local.value === "gql") {
+					gqlIdentifiers.add(specifier.local.value);
+				}
+			}
+			if (specifier.type === "ImportNamespaceSpecifier") {}
+		}
+	}
+	return gqlIdentifiers;
+};
+/**
+* Check if a call expression is a fragment definition call.
+* Pattern: fragment.TypeName({ ... }) where `fragment` comes from gql factory destructuring.
+*/
+const isFragmentDefinitionCall = (node, fragmentIdentifiers) => {
+	if (node.callee.type !== "MemberExpression") return false;
+	const { object } = node.callee;
+	if (object.type !== "Identifier") return false;
+	if (!fragmentIdentifiers.has(object.value)) return false;
+	const firstArg = node.arguments[0];
+	if (!firstArg || firstArg.expression.type !== "ObjectExpression") return false;
+	return true;
+};
+/**
+* Check if an object expression already has a `key` property.
+*/
+const hasKeyProperty = (obj) => {
+	return obj.properties.some((prop) => {
+		if (prop.type === "KeyValueProperty" && prop.key.type === "Identifier") {
+			return prop.key.value === "key";
+		}
+		return false;
+	});
+};
+/**
+* Collect fragment identifiers from gql factory arrow function parameter.
+* Looks for patterns like: ({ fragment }) => ... or ({ fragment: f }) => ...
+*/
+const collectFragmentIdentifiers = (arrowFunction) => {
+	const fragmentIdentifiers = new Set();
+	const param = arrowFunction.params[0];
+	if (param?.type !== "ObjectPattern") return fragmentIdentifiers;
+	for (const p of param.properties) {
+		if (p.type === "KeyValuePatternProperty" && p.key.type === "Identifier" && p.key.value === "fragment") {
+			const localName = extractIdentifierName(p.value);
+			if (localName) fragmentIdentifiers.add(localName);
+		}
+		if (p.type === "AssignmentPatternProperty" && p.key.type === "Identifier" && p.key.value === "fragment") {
+			fragmentIdentifiers.add(p.key.value);
+		}
+	}
+	return fragmentIdentifiers;
+};
+/**
+* Extract identifier name from a pattern node.
+*/
+const extractIdentifierName = (pattern) => {
+	if (pattern.type === "Identifier") return pattern.value;
+	if (pattern.type === "BindingIdentifier") return pattern.value;
+	return null;
+};
+
+//#endregion
+//#region packages/tools/src/formatter/insertion.ts
+/**
+* The newline string to insert after object opening brace
+*/
+const NEWLINE_INSERTION = "\n";
+/**
+* Generate a random 8-character hex key for fragment identification.
+* Uses Node.js crypto for cryptographically secure random bytes.
+*/
+const generateFragmentKey = () => {
+	return (0, node_crypto.randomBytes)(4).toString("hex");
+};
+/**
+* Create the key property insertion string.
+*
+* For single-line objects: returns ` key: "xxxxxxxx",\n`
+* For multi-line objects (with indentation): returns `{indentation}key: "xxxxxxxx",\n`
+* (the existing indentation before the next property is preserved)
+*
+* @param key - The hex key string
+* @param indentation - Optional indentation string for multi-line objects
+*/
+const createKeyInsertion = (key, indentation) => {
+	if (indentation !== undefined) {
+		return `${indentation}key: "${key}",\n`;
+	}
+	return ` key: "${key}",\n`;
+};
+/**
+* Check if there's already a newline after the opening brace.
+* Uses string inspection rather than AST.
+*
+* @param source - The source code string
+* @param objectStartPos - The position of the `{` character in the source
+*/
+const hasExistingNewline = (source, objectStartPos) => {
+	const pos = objectStartPos + 1;
+	const nextChar = source[pos];
+	return nextChar === "\n" || nextChar === "\r";
+};
+/**
+* Detect the indentation used after an opening brace.
+* Returns the whitespace string after the newline, or null if no newline.
+*
+* @param source - The source code string
+* @param objectStartPos - The position of the `{` character
+*/
+const detectIndentationAfterBrace = (source, objectStartPos) => {
+	const afterBrace = objectStartPos + 1;
+	const char = source[afterBrace];
+	if (char !== "\n" && char !== "\r") {
+		return null;
+	}
+	let pos = afterBrace + 1;
+	if (char === "\r" && source[pos] === "\n") {
+		pos++;
+	}
+	let indentation = "";
+	while (pos < source.length) {
+		const c = source[pos];
+		if (c === " " || c === "	") {
+			indentation += c;
+			pos++;
+		} else {
+			break;
+		}
+	}
+	return indentation;
+};
+
+//#endregion
+//#region packages/tools/src/formatter/format.ts
+const require$1 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
+let _graphqlModule;
+let _graphqlModuleError;
+const getGraphqlModule = () => {
+	if (_graphqlModuleError) {
+		return (0, neverthrow.err)({
+			type: "FormatError",
+			code: "MISSING_DEPENDENCY",
+			message: "The \"graphql\" package is required for soda-gql formatter. Install it with: bun add graphql"
+		});
+	}
+	if (!_graphqlModule) {
+		try {
+			_graphqlModule = require$1("graphql");
+		} catch (cause) {
+			_graphqlModuleError = cause instanceof Error ? cause : new Error(String(cause));
+			return (0, neverthrow.err)({
+				type: "FormatError",
+				code: "MISSING_DEPENDENCY",
+				message: "The \"graphql\" package is required for soda-gql formatter. Install it with: bun add graphql",
+				cause
+			});
+		}
+	}
+	return (0, neverthrow.ok)(_graphqlModule);
+};
+/**
+* Simple recursive AST traversal
+*/
+const traverseNode = (node, context, gqlIdentifiers, onObjectExpression) => {
+	if (node.type === "CallExpression" && isGqlDefinitionCall(node, gqlIdentifiers)) {
+		const call = node;
+		const firstArg = call.arguments[0];
+		if (firstArg?.expression.type === "ArrowFunctionExpression") {
+			const arrow = firstArg.expression;
+			const fragmentIds = collectFragmentIdentifiers(arrow);
+			context = {
+				...context,
+				insideGqlDefinition: true,
+				fragmentIdentifiers: new Set([...context.fragmentIdentifiers, ...fragmentIds])
+			};
+		} else {
+			context = {
+				...context,
+				insideGqlDefinition: true
+			};
+		}
+	}
+	if (node.type === "CallExpression" && context.insideGqlDefinition && isFragmentDefinitionCall(node, context.fragmentIdentifiers)) {
+		const call = node;
+		const firstArg = call.arguments[0];
+		if (firstArg?.expression.type === "ObjectExpression" && context.currentArrowFunction) {
+			onObjectExpression(firstArg.expression, context.currentArrowFunction, { isFragmentConfig: true });
+		}
+	}
+	if (node.type === "ObjectExpression" && context.insideGqlDefinition && context.currentArrowFunction && isFieldSelectionObject(node, context.currentArrowFunction)) {
+		onObjectExpression(node, context.currentArrowFunction, { isFragmentConfig: false });
+	}
+	if (node.type === "CallExpression") {
+		const call = node;
+		traverseNode(call.callee, context, gqlIdentifiers, onObjectExpression);
+		for (const arg of call.arguments) {
+			traverseNode(arg.expression, context, gqlIdentifiers, onObjectExpression);
+		}
+	} else if (node.type === "ArrowFunctionExpression") {
+		const arrow = node;
+		const childContext = {
+			...context,
+			currentArrowFunction: arrow
+		};
+		if (arrow.body.type !== "BlockStatement") {
+			traverseNode(arrow.body, childContext, gqlIdentifiers, onObjectExpression);
+		}
+	} else if (node.type === "ParenthesisExpression") {
+		const paren = node;
+		if (paren.expression) {
+			traverseNode(paren.expression, context, gqlIdentifiers, onObjectExpression);
+		}
+	} else if (node.type === "MemberExpression") {
+		const member = node;
+		traverseNode(member.object, context, gqlIdentifiers, onObjectExpression);
+	} else if (node.type === "ObjectExpression") {
+		const obj = node;
+		for (const prop of obj.properties) {
+			if (prop.type === "SpreadElement") {
+				traverseNode(prop.arguments, context, gqlIdentifiers, onObjectExpression);
+			} else if (prop.type === "KeyValueProperty") {
+				traverseNode(prop.value, context, gqlIdentifiers, onObjectExpression);
+			}
+		}
+	} else {
+		for (const value of Object.values(node)) {
+			if (Array.isArray(value)) {
+				for (const child of value) {
+					if (child && typeof child === "object" && "type" in child) {
+						traverseNode(child, context, gqlIdentifiers, onObjectExpression);
+					}
+				}
+			} else if (value && typeof value === "object" && "type" in value) {
+				traverseNode(value, context, gqlIdentifiers, onObjectExpression);
+			}
+		}
+	}
+};
+const traverse = (module$1, gqlIdentifiers, onObjectExpression) => {
+	const initialContext = {
+		insideGqlDefinition: false,
+		currentArrowFunction: null,
+		fragmentIdentifiers: new Set()
+	};
+	for (const statement of module$1.body) {
+		traverseNode(statement, initialContext, gqlIdentifiers, onObjectExpression);
+	}
+};
+/**
+* Format soda-gql field selection objects by inserting newlines.
+* Optionally injects fragment keys for anonymous fragments.
+*/
+const format = (options) => {
+	const { sourceCode, filePath, injectFragmentKeys = false } = options;
+	let module$1;
+	try {
+		const program = (0, __swc_core.parseSync)(sourceCode, {
+			syntax: "typescript",
+			tsx: filePath?.endsWith(".tsx") ?? true,
+			target: "es2022",
+			decorators: false,
+			dynamicImport: true
+		});
+		if (program.type !== "Module") {
+			return (0, neverthrow.err)({
+				type: "FormatError",
+				code: "PARSE_ERROR",
+				message: `Not a module${filePath ? ` (${filePath})` : ""}`
+			});
+		}
+		module$1 = program;
+	} catch (cause) {
+		return (0, neverthrow.err)({
+			type: "FormatError",
+			code: "PARSE_ERROR",
+			message: `Failed to parse source code${filePath ? ` (${filePath})` : ""}`,
+			cause
+		});
+	}
+	const spanOffset = module$1.span.start;
+	const converter = (0, __soda_gql_common_utils.createSwcSpanConverter)(sourceCode);
+	const gqlIdentifiers = collectGqlIdentifiers(module$1);
+	if (gqlIdentifiers.size === 0) {
+		return (0, neverthrow.ok)({
+			modified: false,
+			sourceCode
+		});
+	}
+	const insertionPoints = [];
+	traverse(module$1, gqlIdentifiers, (object, _parent, callbackContext) => {
+		const objectStart = converter.byteOffsetToCharIndex(object.span.start - spanOffset);
+		if (callbackContext.isFragmentConfig && injectFragmentKeys && !hasKeyProperty(object)) {
+			const key = generateFragmentKey();
+			if (hasExistingNewline(sourceCode, objectStart)) {
+				const indentation = detectIndentationAfterBrace(sourceCode, objectStart) ?? "";
+				let insertPos = objectStart + 2;
+				if (sourceCode[objectStart + 1] === "\r") insertPos++;
+				insertionPoints.push({
+					position: insertPos,
+					content: createKeyInsertion(key, indentation)
+				});
+			} else {
+				insertionPoints.push({
+					position: objectStart + 1,
+					content: createKeyInsertion(key)
+				});
+			}
+		}
+		if (!callbackContext.isFragmentConfig && !hasExistingNewline(sourceCode, objectStart)) {
+			insertionPoints.push({
+				position: objectStart + 1,
+				content: NEWLINE_INSERTION
+			});
+		}
+	});
+	const graphqlResult = getGraphqlModule();
+	if (graphqlResult.isErr()) {
+		return (0, neverthrow.err)(graphqlResult.error);
+	}
+	const { parse: parseGraphql, print: printGraphql } = graphqlResult.value;
+	const positionCtx = {
+		spanOffset,
+		converter
+	};
+	const templates = (0, __soda_gql_common_template_extraction.walkAndExtract)(module$1, gqlIdentifiers, positionCtx);
+	if (templates.length > 0) {
+		const defaultFormat = (source) => {
+			const ast = parseGraphql(source, { noLocation: false });
+			return printGraphql(ast);
+		};
+		const templateEdits = (0, __soda_gql_common_template_extraction.formatTemplatesInSource)(templates, sourceCode, defaultFormat);
+		for (const edit of templateEdits) {
+			insertionPoints.push({
+				position: edit.start,
+				content: edit.newText,
+				endPosition: edit.end
+			});
+		}
+	}
+	if (insertionPoints.length === 0) {
+		return (0, neverthrow.ok)({
+			modified: false,
+			sourceCode
+		});
+	}
+	const sortedPoints = [...insertionPoints].sort((a, b) => b.position - a.position);
+	let result = sourceCode;
+	for (const point of sortedPoints) {
+		const end = point.endPosition ?? point.position;
+		result = result.slice(0, point.position) + point.content + result.slice(end);
+	}
+	return (0, neverthrow.ok)({
+		modified: true,
+		sourceCode: result
+	});
+};
+/**
+* Check if a file needs formatting (has unformatted field selections).
+* Useful for pre-commit hooks or CI checks.
+*/
+const needsFormat = (options) => {
+	const { sourceCode, filePath } = options;
+	let module$1;
+	try {
+		const program = (0, __swc_core.parseSync)(sourceCode, {
+			syntax: "typescript",
+			tsx: filePath?.endsWith(".tsx") ?? true,
+			target: "es2022",
+			decorators: false,
+			dynamicImport: true
+		});
+		if (program.type !== "Module") {
+			return (0, neverthrow.err)({
+				type: "FormatError",
+				code: "PARSE_ERROR",
+				message: `Not a module${filePath ? ` (${filePath})` : ""}`
+			});
+		}
+		module$1 = program;
+	} catch (cause) {
+		return (0, neverthrow.err)({
+			type: "FormatError",
+			code: "PARSE_ERROR",
+			message: `Failed to parse source code${filePath ? ` (${filePath})` : ""}`,
+			cause
+		});
+	}
+	const spanOffset = module$1.span.start;
+	const converter = (0, __soda_gql_common_utils.createSwcSpanConverter)(sourceCode);
+	const gqlIdentifiers = collectGqlIdentifiers(module$1);
+	if (gqlIdentifiers.size === 0) {
+		return (0, neverthrow.ok)(false);
+	}
+	let needsFormatting = false;
+	traverse(module$1, gqlIdentifiers, (object, _parent, callbackContext) => {
+		if (needsFormatting) return;
+		if (callbackContext.isFragmentConfig) return;
+		const objectStart = converter.byteOffsetToCharIndex(object.span.start - spanOffset);
+		if (!hasExistingNewline(sourceCode, objectStart)) {
+			needsFormatting = true;
+		}
+	});
+	if (!needsFormatting) {
+		const graphqlResult = getGraphqlModule();
+		if (graphqlResult.isErr()) {
+			return (0, neverthrow.err)(graphqlResult.error);
+		}
+		const { parse: parseGraphql, print: printGraphql } = graphqlResult.value;
+		const positionCtx = {
+			spanOffset,
+			converter
+		};
+		const templates = (0, __soda_gql_common_template_extraction.walkAndExtract)(module$1, gqlIdentifiers, positionCtx);
+		if (templates.length > 0) {
+			const defaultFormat = (source) => {
+				const ast = parseGraphql(source, { noLocation: false });
+				return printGraphql(ast);
+			};
+			const templateEdits = (0, __soda_gql_common_template_extraction.formatTemplatesInSource)(templates, sourceCode, defaultFormat);
+			if (templateEdits.length > 0) {
+				needsFormatting = true;
+			}
+		}
+	}
+	return (0, neverthrow.ok)(needsFormatting);
+};
+
+//#endregion
+exports.format = format;
+exports.needsFormat = needsFormat;
+//# sourceMappingURL=formatter.cjs.map

package/dist/formatter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.cjs","names":["bodyObject: ObjectExpression | null","module","require","_graphqlModule: GraphqlModule | undefined","_graphqlModuleError: Error | undefined","initialContext: TraversalContext","module","module: Module","insertionPoints: InsertionPoint[]","positionCtx: PositionTrackingContext","defaultFormat: FormatGraphqlFn"],"sources":["../src/formatter/detection.ts","../src/formatter/insertion.ts","../src/formatter/format.ts"],"sourcesContent":["import type {\n  ArrowFunctionExpression,\n  CallExpression,\n  Expression,\n  Module,\n  ObjectExpression,\n  ObjectPatternProperty,\n  Pattern,\n} from \"@swc/types\";\n\n/**\n * Check if an expression is a reference to gql\n * Handles: gql, namespace.gql\n */\nexport const isGqlReference = (node: Expression, gqlIdentifiers: ReadonlySet<string>): boolean => {\n  // Unwrap TsNonNullExpression: gql! -> gql\n  const unwrapped = node.type === \"TsNonNullExpression\" ? (node as { type: string; expression: Expression }).expression : node;\n  if (unwrapped.type === \"Identifier\") {\n    return gqlIdentifiers.has(unwrapped.value);\n  }\n  if (unwrapped.type === \"MemberExpression\" && unwrapped.property.type === \"Identifier\" && unwrapped.property.value === \"gql\") {\n    return true;\n  }\n  return false;\n};\n\n/**\n * Check if a call expression is a gql definition call\n * Handles: gql.default(...), gql.model(...), gql.schemaName(...) (multi-schema)\n */\nexport const isGqlDefinitionCall = (node: CallExpression, gqlIdentifiers: ReadonlySet<string>): boolean => {\n  if (node.callee.type !== \"MemberExpression\") return false;\n  const { object } = node.callee;\n\n  // Check object is a gql reference first\n  if (!isGqlReference(object, gqlIdentifiers)) return false;\n\n  // Verify first argument is an arrow function (factory pattern)\n  // SWC's arguments are ExprOrSpread[], so access via .expression\n  const firstArg = node.arguments[0];\n  if (!firstArg || (firstArg.expression.type !== \"ArrowFunctionExpression\" && firstArg.expression.type !== \"FunctionExpression\"))\n    return false;\n\n  return true;\n};\n\n/**\n * Check if an object expression is a field selection object\n * Field selection objects are returned from arrow functions with ({ f }) or ({ f, $ }) parameter\n */\nexport const isFieldSelectionObject = (object: ObjectExpression, parent: ArrowFunctionExpression): boolean => {\n  // The object must be the body of the arrow function\n  // Handle both direct ObjectExpression and parenthesized ObjectExpression: `({ ... })`\n  let bodyObject: ObjectExpression | null = null;\n\n  if (parent.body.type === \"ObjectExpression\") {\n    bodyObject = parent.body;\n  } else if (parent.body.type === \"ParenthesisExpression\") {\n    // Handle `({ f }) => ({ ...f.id() })` pattern where body is parenthesized\n    const inner = parent.body.expression;\n    if (inner.type === \"ObjectExpression\") {\n      bodyObject = inner;\n    }\n  }\n\n  if (!bodyObject) return false;\n  if (bodyObject.span.start !== object.span.start) return false;\n\n  // Check if first parameter has 'f' destructured\n  const param = parent.params[0];\n  if (!param || param.type !== \"ObjectPattern\") return false;\n\n  return param.properties.some((p: ObjectPatternProperty) => {\n    if (p.type === \"KeyValuePatternProperty\" && p.key.type === \"Identifier\") {\n      return p.key.value === \"f\";\n    }\n    if (p.type === \"AssignmentPatternProperty\" && p.key.type === \"Identifier\") {\n      return p.key.value === \"f\";\n    }\n    return false;\n  });\n};\n\n/**\n * Collect gql identifiers from import declarations\n */\nexport const collectGqlIdentifiers = (module: Module): Set<string> => {\n  const gqlIdentifiers = new Set<string>();\n\n  for (const item of module.body) {\n    if (item.type !== \"ImportDeclaration\") continue;\n\n    for (const specifier of item.specifiers) {\n      if (specifier.type === \"ImportSpecifier\") {\n        const imported = specifier.imported?.value ?? specifier.local.value;\n        if (imported === \"gql\") {\n          gqlIdentifiers.add(specifier.local.value);\n        }\n      }\n      if (specifier.type === \"ImportDefaultSpecifier\") {\n        // Check if default import might be gql\n        if (specifier.local.value === \"gql\") {\n          gqlIdentifiers.add(specifier.local.value);\n        }\n      }\n      if (specifier.type === \"ImportNamespaceSpecifier\") {\n        // namespace import: import * as ns from \"...\"\n        // Would need ns.gql pattern - handled by isGqlReference\n      }\n    }\n  }\n\n  return gqlIdentifiers;\n};\n\n/**\n * Check if a call expression is a fragment definition call.\n * Pattern: fragment.TypeName({ ... }) where `fragment` comes from gql factory destructuring.\n */\nexport const isFragmentDefinitionCall = (node: CallExpression, fragmentIdentifiers: ReadonlySet<string>): boolean => {\n  if (node.callee.type !== \"MemberExpression\") return false;\n\n  const { object } = node.callee;\n\n  if (object.type !== \"Identifier\") return false;\n  if (!fragmentIdentifiers.has(object.value)) return false;\n\n  const firstArg = node.arguments[0];\n  if (!firstArg || firstArg.expression.type !== \"ObjectExpression\") return false;\n\n  return true;\n};\n\n/**\n * Check if an object expression already has a `key` property.\n */\nexport const hasKeyProperty = (obj: ObjectExpression): boolean => {\n  return obj.properties.some((prop) => {\n    if (prop.type === \"KeyValueProperty\" && prop.key.type === \"Identifier\") {\n      return prop.key.value === \"key\";\n    }\n    return false;\n  });\n};\n\n/**\n * Collect fragment identifiers from gql factory arrow function parameter.\n * Looks for patterns like: ({ fragment }) => ... or ({ fragment: f }) => ...\n */\nexport const collectFragmentIdentifiers = (arrowFunction: ArrowFunctionExpression): Set<string> => {\n  const fragmentIdentifiers = new Set<string>();\n\n  const param = arrowFunction.params[0];\n  if (param?.type !== \"ObjectPattern\") return fragmentIdentifiers;\n\n  for (const p of param.properties as ObjectPatternProperty[]) {\n    if (p.type === \"KeyValuePatternProperty\" && p.key.type === \"Identifier\" && p.key.value === \"fragment\") {\n      const localName = extractIdentifierName(p.value);\n      if (localName) fragmentIdentifiers.add(localName);\n    }\n    if (p.type === \"AssignmentPatternProperty\" && p.key.type === \"Identifier\" && p.key.value === \"fragment\") {\n      fragmentIdentifiers.add(p.key.value);\n    }\n  }\n\n  return fragmentIdentifiers;\n};\n\n/**\n * Extract identifier name from a pattern node.\n */\nconst extractIdentifierName = (pattern: Pattern): string | null => {\n  if (pattern.type === \"Identifier\") return pattern.value;\n  // biome-ignore lint/suspicious/noExplicitAny: SWC types\n  if ((pattern as any).type === \"BindingIdentifier\") return (pattern as any).value;\n  return null;\n};\n","import { randomBytes } from \"node:crypto\";\n\n/**\n * The newline string to insert after object opening brace\n */\nexport const NEWLINE_INSERTION = \"\\n\";\n\n/**\n * Generate a random 8-character hex key for fragment identification.\n * Uses Node.js crypto for cryptographically secure random bytes.\n */\nexport const generateFragmentKey = (): string => {\n  return randomBytes(4).toString(\"hex\");\n};\n\n/**\n * Create the key property insertion string.\n *\n * For single-line objects: returns ` key: \"xxxxxxxx\",\\n`\n * For multi-line objects (with indentation): returns `{indentation}key: \"xxxxxxxx\",\\n`\n * (the existing indentation before the next property is preserved)\n *\n * @param key - The hex key string\n * @param indentation - Optional indentation string for multi-line objects\n */\nexport const createKeyInsertion = (key: string, indentation?: string): string => {\n  if (indentation !== undefined) {\n    // Multi-line: key goes on its own line with indentation\n    // The next property's indentation is already in the source, so don't duplicate it\n    return `${indentation}key: \"${key}\",\\n`;\n  }\n  // Single-line: space before key, newline after\n  return ` key: \"${key}\",\\n`;\n};\n\n/**\n * Check if there's already a newline after the opening brace.\n * Uses string inspection rather than AST.\n *\n * @param source - The source code string\n * @param objectStartPos - The position of the `{` character in the source\n */\nexport const hasExistingNewline = (source: string, objectStartPos: number): boolean => {\n  // Skip the `{` character\n  const pos = objectStartPos + 1;\n\n  // Check if next character is a newline\n  const nextChar = source[pos];\n  return nextChar === \"\\n\" || nextChar === \"\\r\";\n};\n\n/**\n * Detect the indentation used after an opening brace.\n * Returns the whitespace string after the newline, or null if no newline.\n *\n * @param source - The source code string\n * @param objectStartPos - The position of the `{` character\n */\nexport const detectIndentationAfterBrace = (source: string, objectStartPos: number): string | null => {\n  const afterBrace = objectStartPos + 1;\n  const char = source[afterBrace];\n\n  // Check for newline (handles both \\n and \\r\\n)\n  if (char !== \"\\n\" && char !== \"\\r\") {\n    return null;\n  }\n\n  // Skip past the newline character(s)\n  let pos = afterBrace + 1;\n  if (char === \"\\r\" && source[pos] === \"\\n\") {\n    pos++;\n  }\n\n  // Collect whitespace (indentation)\n  let indentation = \"\";\n  while (pos < source.length) {\n    const c = source[pos];\n    if (c === \" \" || c === \"\\t\") {\n      indentation += c;\n      pos++;\n    } else {\n      break;\n    }\n  }\n\n  return indentation;\n};\n","import { createRequire } from \"node:module\";\nimport {\n  type FormatGraphqlFn,\n  formatTemplatesInSource,\n  type PositionTrackingContext,\n  walkAndExtract,\n} from \"@soda-gql/common/template-extraction\";\nimport { createSwcSpanConverter } from \"@soda-gql/common/utils\";\nimport { parseSync } from \"@swc/core\";\nimport type { ArrowFunctionExpression, CallExpression, Module, Node, ObjectExpression } from \"@swc/types\";\nimport { err, ok, type Result } from \"neverthrow\";\n\nconst require = createRequire(import.meta.url);\n\ntype GraphqlModule = {\n  parse: (source: string, options?: { noLocation?: boolean }) => unknown;\n  print: (ast: unknown) => string;\n};\n\nlet _graphqlModule: GraphqlModule | undefined;\nlet _graphqlModuleError: Error | undefined;\n\nconst getGraphqlModule = (): Result<GraphqlModule, FormatError> => {\n  if (_graphqlModuleError) {\n    return err({\n      type: \"FormatError\",\n      code: \"MISSING_DEPENDENCY\",\n      message: 'The \"graphql\" package is required for soda-gql formatter. Install it with: bun add graphql',\n    });\n  }\n  if (!_graphqlModule) {\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-require-imports\n      _graphqlModule = require(\"graphql\") as GraphqlModule;\n    } catch (cause) {\n      _graphqlModuleError = cause instanceof Error ? cause : new Error(String(cause));\n      return err({\n        type: \"FormatError\",\n        code: \"MISSING_DEPENDENCY\",\n        message: 'The \"graphql\" package is required for soda-gql formatter. Install it with: bun add graphql',\n        cause,\n      });\n    }\n  }\n  return ok(_graphqlModule);\n};\n\nimport {\n  collectFragmentIdentifiers,\n  collectGqlIdentifiers,\n  hasKeyProperty,\n  isFieldSelectionObject,\n  isFragmentDefinitionCall,\n  isGqlDefinitionCall,\n} from \"./detection\";\nimport {\n  createKeyInsertion,\n  detectIndentationAfterBrace,\n  generateFragmentKey,\n  hasExistingNewline,\n  NEWLINE_INSERTION,\n} from \"./insertion\";\nimport type { FormatError, FormatOptions, FormatResult } from \"./types\";\n\ntype InsertionPoint = {\n  readonly position: number;\n  readonly content: string;\n  readonly endPosition?: number;\n};\n\ntype TraversalContext = {\n  insideGqlDefinition: boolean;\n  currentArrowFunction: ArrowFunctionExpression | null;\n  fragmentIdentifiers: ReadonlySet<string>;\n};\n\ntype TraversalCallbackContext = {\n  readonly isFragmentConfig: boolean;\n};\n\ntype TraversalCallback = (\n  object: ObjectExpression,\n  parent: ArrowFunctionExpression,\n  callbackContext: TraversalCallbackContext,\n) => void;\n\n/**\n * Simple recursive AST traversal\n */\nconst traverseNode = (\n  node: Node,\n  context: TraversalContext,\n  gqlIdentifiers: ReadonlySet<string>,\n  onObjectExpression: TraversalCallback,\n): void => {\n  // Check for gql definition call entry and collect fragment identifiers\n  if (node.type === \"CallExpression\" && isGqlDefinitionCall(node as CallExpression, gqlIdentifiers)) {\n    const call = node as CallExpression;\n    const firstArg = call.arguments[0];\n    if (firstArg?.expression.type === \"ArrowFunctionExpression\") {\n      const arrow = firstArg.expression as ArrowFunctionExpression;\n      const fragmentIds = collectFragmentIdentifiers(arrow);\n      context = {\n        ...context,\n        insideGqlDefinition: true,\n        fragmentIdentifiers: new Set([...context.fragmentIdentifiers, ...fragmentIds]),\n      };\n    } else {\n      context = { ...context, insideGqlDefinition: true };\n    }\n  }\n\n  // Check for fragment definition call: fragment.TypeName({ ... })\n  if (\n    node.type === \"CallExpression\" &&\n    context.insideGqlDefinition &&\n    isFragmentDefinitionCall(node as CallExpression, context.fragmentIdentifiers)\n  ) {\n    const call = node as CallExpression;\n    const firstArg = call.arguments[0];\n    if (firstArg?.expression.type === \"ObjectExpression\" && context.currentArrowFunction) {\n      onObjectExpression(firstArg.expression as ObjectExpression, context.currentArrowFunction, {\n        isFragmentConfig: true,\n      });\n    }\n  }\n\n  // Handle object expressions - check if it's the body of the current arrow function\n  if (\n    node.type === \"ObjectExpression\" &&\n    context.insideGqlDefinition &&\n    context.currentArrowFunction &&\n    isFieldSelectionObject(node as ObjectExpression, context.currentArrowFunction)\n  ) {\n    onObjectExpression(node as ObjectExpression, context.currentArrowFunction, { isFragmentConfig: false });\n  }\n\n  // Recursively visit children\n  if (node.type === \"CallExpression\") {\n    const call = node as CallExpression;\n    traverseNode(call.callee as Node, context, gqlIdentifiers, onObjectExpression);\n    for (const arg of call.arguments) {\n      traverseNode(arg.expression as Node, context, gqlIdentifiers, onObjectExpression);\n    }\n  } else if (node.type === \"ArrowFunctionExpression\") {\n    const arrow = node as ArrowFunctionExpression;\n    // Update context with the new arrow function\n    const childContext = { ...context, currentArrowFunction: arrow };\n    if (arrow.body.type !== \"BlockStatement\") {\n      traverseNode(arrow.body as Node, childContext, gqlIdentifiers, onObjectExpression);\n    }\n  } else if (node.type === \"ParenthesisExpression\") {\n    // Handle parenthesized expressions like `({ ...f.id() })`\n    // biome-ignore lint/suspicious/noExplicitAny: SWC types\n    const paren = node as any;\n    if (paren.expression) {\n      traverseNode(paren.expression as Node, context, gqlIdentifiers, onObjectExpression);\n    }\n  } else if (node.type === \"MemberExpression\") {\n    // biome-ignore lint/suspicious/noExplicitAny: SWC types\n    const member = node as any;\n    traverseNode(member.object as Node, context, gqlIdentifiers, onObjectExpression);\n  } else if (node.type === \"ObjectExpression\") {\n    const obj = node as ObjectExpression;\n    for (const prop of obj.properties) {\n      if (prop.type === \"SpreadElement\") {\n        traverseNode(prop.arguments as Node, context, gqlIdentifiers, onObjectExpression);\n      } else if (prop.type === \"KeyValueProperty\") {\n        traverseNode(prop.value as Node, context, gqlIdentifiers, onObjectExpression);\n      }\n    }\n  } else {\n    // Generic traversal for other node types\n    for (const value of Object.values(node)) {\n      if (Array.isArray(value)) {\n        for (const child of value) {\n          if (child && typeof child === \"object\" && \"type\" in child) {\n            traverseNode(child as Node, context, gqlIdentifiers, onObjectExpression);\n          }\n        }\n      } else if (value && typeof value === \"object\" && \"type\" in value) {\n        traverseNode(value as Node, context, gqlIdentifiers, onObjectExpression);\n      }\n    }\n  }\n};\n\nconst traverse = (module: Module, gqlIdentifiers: ReadonlySet<string>, onObjectExpression: TraversalCallback): void => {\n  const initialContext: TraversalContext = {\n    insideGqlDefinition: false,\n    currentArrowFunction: null,\n    fragmentIdentifiers: new Set(),\n  };\n  for (const statement of module.body) {\n    traverseNode(statement, initialContext, gqlIdentifiers, onObjectExpression);\n  }\n};\n\n/**\n * Format soda-gql field selection objects by inserting newlines.\n * Optionally injects fragment keys for anonymous fragments.\n */\nexport const format = (options: FormatOptions): Result<FormatResult, FormatError> => {\n  const { sourceCode, filePath, injectFragmentKeys = false } = options;\n\n  // Parse source code with SWC\n  let module: Module;\n  try {\n    const program = parseSync(sourceCode, {\n      syntax: \"typescript\",\n      tsx: filePath?.endsWith(\".tsx\") ?? true,\n      target: \"es2022\",\n      decorators: false,\n      dynamicImport: true,\n    });\n\n    if (program.type !== \"Module\") {\n      return err({\n        type: \"FormatError\",\n        code: \"PARSE_ERROR\",\n        message: `Not a module${filePath ? ` (${filePath})` : \"\"}`,\n      });\n    }\n    module = program;\n  } catch (cause) {\n    return err({\n      type: \"FormatError\",\n      code: \"PARSE_ERROR\",\n      message: `Failed to parse source code${filePath ? ` (${filePath})` : \"\"}`,\n      cause,\n    });\n  }\n\n  // Calculate span offset for position normalization\n  // SWC's BytePos counter accumulates across parseSync calls within the same process\n  // Using module.span.start ensures correct position calculation regardless of accumulation\n  const spanOffset = module.span.start;\n\n  // SWC returns UTF-8 byte offsets; JS strings use UTF-16 code units.\n  // The converter handles this mapping (fast path for ASCII-only sources).\n  const converter = createSwcSpanConverter(sourceCode);\n\n  // Collect gql identifiers from imports\n  const gqlIdentifiers = collectGqlIdentifiers(module);\n  if (gqlIdentifiers.size === 0) {\n    return ok({ modified: false, sourceCode });\n  }\n\n  // Collect insertion points\n  const insertionPoints: InsertionPoint[] = [];\n\n  traverse(module, gqlIdentifiers, (object, _parent, callbackContext) => {\n    // Calculate actual position in source (byte offset → char index)\n    const objectStart = converter.byteOffsetToCharIndex(object.span.start - spanOffset);\n\n    // For fragment config objects, inject key if enabled and not present\n    if (callbackContext.isFragmentConfig && injectFragmentKeys && !hasKeyProperty(object)) {\n      const key = generateFragmentKey();\n\n      if (hasExistingNewline(sourceCode, objectStart)) {\n        // Multi-line: insert after newline, preserving indentation\n        const indentation = detectIndentationAfterBrace(sourceCode, objectStart) ?? \"\";\n        let insertPos = objectStart + 2; // Skip { and \\n\n        if (sourceCode[objectStart + 1] === \"\\r\") insertPos++;\n\n        insertionPoints.push({\n          position: insertPos,\n          content: createKeyInsertion(key, indentation),\n        });\n      } else {\n        // Single-line: insert right after {\n        insertionPoints.push({\n          position: objectStart + 1,\n          content: createKeyInsertion(key),\n        });\n      }\n    }\n\n    // For field selection objects, insert newline if not present\n    if (!callbackContext.isFragmentConfig && !hasExistingNewline(sourceCode, objectStart)) {\n      insertionPoints.push({\n        position: objectStart + 1,\n        content: NEWLINE_INSERTION,\n      });\n    }\n  });\n\n  // Tagged template formatting\n  const graphqlResult = getGraphqlModule();\n  if (graphqlResult.isErr()) {\n    return err(graphqlResult.error);\n  }\n  const { parse: parseGraphql, print: printGraphql } = graphqlResult.value;\n\n  const positionCtx: PositionTrackingContext = { spanOffset, converter };\n  const templates = walkAndExtract(module as unknown as Node, gqlIdentifiers, positionCtx);\n\n  if (templates.length > 0) {\n    const defaultFormat: FormatGraphqlFn = (source) => {\n      const ast = parseGraphql(source, { noLocation: false });\n      return printGraphql(ast);\n    };\n\n    const templateEdits = formatTemplatesInSource(templates, sourceCode, defaultFormat);\n\n    for (const edit of templateEdits) {\n      insertionPoints.push({\n        position: edit.start,\n        content: edit.newText,\n        endPosition: edit.end,\n      });\n    }\n  }\n\n  // Apply insertions\n  if (insertionPoints.length === 0) {\n    return ok({ modified: false, sourceCode });\n  }\n\n  // Sort in descending order to insert from end to beginning\n  // This preserves earlier positions while modifying later parts\n  const sortedPoints = [...insertionPoints].sort((a, b) => b.position - a.position);\n\n  let result = sourceCode;\n  for (const point of sortedPoints) {\n    const end = point.endPosition ?? point.position;\n    result = result.slice(0, point.position) + point.content + result.slice(end);\n  }\n\n  return ok({ modified: true, sourceCode: result });\n};\n\n/**\n * Check if a file needs formatting (has unformatted field selections).\n * Useful for pre-commit hooks or CI checks.\n */\nexport const needsFormat = (options: FormatOptions): Result<boolean, FormatError> => {\n  const { sourceCode, filePath } = options;\n\n  // Parse source code with SWC\n  let module: Module;\n  try {\n    const program = parseSync(sourceCode, {\n      syntax: \"typescript\",\n      tsx: filePath?.endsWith(\".tsx\") ?? true,\n      target: \"es2022\",\n      decorators: false,\n      dynamicImport: true,\n    });\n\n    if (program.type !== \"Module\") {\n      return err({\n        type: \"FormatError\",\n        code: \"PARSE_ERROR\",\n        message: `Not a module${filePath ? ` (${filePath})` : \"\"}`,\n      });\n    }\n    module = program;\n  } catch (cause) {\n    return err({\n      type: \"FormatError\",\n      code: \"PARSE_ERROR\",\n      message: `Failed to parse source code${filePath ? ` (${filePath})` : \"\"}`,\n      cause,\n    });\n  }\n\n  const spanOffset = module.span.start;\n  const converter = createSwcSpanConverter(sourceCode);\n  const gqlIdentifiers = collectGqlIdentifiers(module);\n\n  if (gqlIdentifiers.size === 0) {\n    return ok(false);\n  }\n\n  let needsFormatting = false;\n\n  traverse(module, gqlIdentifiers, (object, _parent, callbackContext) => {\n    if (needsFormatting) return; // Early exit\n\n    // Skip fragment config objects for needsFormat check (key injection is optional)\n    if (callbackContext.isFragmentConfig) return;\n\n    const objectStart = converter.byteOffsetToCharIndex(object.span.start - spanOffset);\n    if (!hasExistingNewline(sourceCode, objectStart)) {\n      needsFormatting = true;\n    }\n  });\n\n  // Check tagged templates\n  if (!needsFormatting) {\n    const graphqlResult = getGraphqlModule();\n    if (graphqlResult.isErr()) {\n      return err(graphqlResult.error);\n    }\n    const { parse: parseGraphql, print: printGraphql } = graphqlResult.value;\n\n    const positionCtx: PositionTrackingContext = { spanOffset, converter };\n    const templates = walkAndExtract(module as unknown as Node, gqlIdentifiers, positionCtx);\n\n    if (templates.length > 0) {\n      const defaultFormat: FormatGraphqlFn = (source) => {\n        const ast = parseGraphql(source, { noLocation: false });\n        return printGraphql(ast);\n      };\n\n      const templateEdits = formatTemplatesInSource(templates, sourceCode, defaultFormat);\n      if (templateEdits.length > 0) {\n        needsFormatting = true;\n      }\n    }\n  }\n\n  return ok(needsFormatting);\n};\n"],"mappings":"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"}

package/dist/formatter.d.cts

@@ -0,0 +1,33 @@
+import { Result } from "neverthrow";
+
+//#region packages/tools/src/formatter/types.d.ts
+type FormatOptions = {
+  readonly sourceCode: string;
+  readonly filePath?: string;
+  readonly injectFragmentKeys?: boolean;
+};
+type FormatResult = {
+  readonly modified: boolean;
+  readonly sourceCode: string;
+};
+type FormatError = {
+  readonly type: "FormatError";
+  readonly code: "PARSE_ERROR" | "TRANSFORM_ERROR" | "MISSING_DEPENDENCY";
+  readonly message: string;
+  readonly cause?: unknown;
+};
+//#endregion
+//#region packages/tools/src/formatter/format.d.ts
+/**
+ * Format soda-gql field selection objects by inserting newlines.
+ * Optionally injects fragment keys for anonymous fragments.
+ */
+declare const format: (options: FormatOptions) => Result<FormatResult, FormatError>;
+/**
+ * Check if a file needs formatting (has unformatted field selections).
+ * Useful for pre-commit hooks or CI checks.
+ */
+declare const needsFormat: (options: FormatOptions) => Result<boolean, FormatError>;
+//#endregion
+export { type FormatError, type FormatOptions, type FormatResult, format, needsFormat };
+//# sourceMappingURL=formatter.d.cts.map

package/dist/formatter.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.cts","names":[],"sources":["../src/formatter/types.ts","../src/formatter/format.ts"],"sourcesContent":[],"mappings":";;;KAAY,aAAA;;;EAAA,SAAA,kBAAa,CAAA,EAAA,OAAA;AAMzB,CAAA;AAKY,KALA,YAAA,GAKW;;;;AC+LV,KD/LD,WAAA,GC+TX;EAhI+B,SAAA,IAAA,EAAA,aAAA;EAAuB,SAAA,IAAA,EAAA,aAAA,GAAA,iBAAA,GAAA,oBAAA;EAAc,SAAA,OAAA,EAAA,MAAA;EAArB,SAAA,KAAA,CAAA,EAAA,OAAA;CAAM;;;;AD1MtD;AAMA;AAKA;cC+La,kBAAmB,kBAAgB,OAAO,cAAc;;;AAArE;;AAAuD,cAsI1C,WAtI0C,EAAA,CAAA,OAAA,EAsIlB,aAtIkB,EAAA,GAsIF,MAtIE,CAAA,OAAA,EAsIc,WAtId,CAAA"}

package/dist/formatter.d.mts

@@ -0,0 +1,33 @@
+import { Result } from "neverthrow";
+
+//#region packages/tools/src/formatter/types.d.ts
+type FormatOptions = {
+  readonly sourceCode: string;
+  readonly filePath?: string;
+  readonly injectFragmentKeys?: boolean;
+};
+type FormatResult = {
+  readonly modified: boolean;
+  readonly sourceCode: string;
+};
+type FormatError = {
+  readonly type: "FormatError";
+  readonly code: "PARSE_ERROR" | "TRANSFORM_ERROR" | "MISSING_DEPENDENCY";
+  readonly message: string;
+  readonly cause?: unknown;
+};
+//#endregion
+//#region packages/tools/src/formatter/format.d.ts
+/**
+ * Format soda-gql field selection objects by inserting newlines.
+ * Optionally injects fragment keys for anonymous fragments.
+ */
+declare const format: (options: FormatOptions) => Result<FormatResult, FormatError>;
+/**
+ * Check if a file needs formatting (has unformatted field selections).
+ * Useful for pre-commit hooks or CI checks.
+ */
+declare const needsFormat: (options: FormatOptions) => Result<boolean, FormatError>;
+//#endregion
+export { type FormatError, type FormatOptions, type FormatResult, format, needsFormat };
+//# sourceMappingURL=formatter.d.mts.map

package/dist/formatter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.mts","names":[],"sources":["../src/formatter/types.ts","../src/formatter/format.ts"],"sourcesContent":[],"mappings":";;;KAAY,aAAA;;;EAAA,SAAA,kBAAa,CAAA,EAAA,OAAA;AAMzB,CAAA;AAKY,KALA,YAAA,GAKW;;;;AC+LV,KD/LD,WAAA,GC+TX;EAhI+B,SAAA,IAAA,EAAA,aAAA;EAAuB,SAAA,IAAA,EAAA,aAAA,GAAA,iBAAA,GAAA,oBAAA;EAAc,SAAA,OAAA,EAAA,MAAA;EAArB,SAAA,KAAA,CAAA,EAAA,OAAA;CAAM;;;;AD1MtD;AAMA;AAKA;cC+La,kBAAmB,kBAAgB,OAAO,cAAc;;;AAArE;;AAAuD,cAsI1C,WAtI0C,EAAA,CAAA,OAAA,EAsIlB,aAtIkB,EAAA,GAsIF,MAtIE,CAAA,OAAA,EAsIc,WAtId,CAAA"}