@soda-gql/formatter 0.10.2 → 0.11.1

package/dist/index.cjs

@@ -1,5 +1,6 @@
 let __swc_core = require("@swc/core");
 let neverthrow = require("neverthrow");
+let node_crypto = require("node:crypto");
 
 //#region packages/formatter/src/detection.ts
 /**
@@ -63,6 +64,53 @@ const collectGqlIdentifiers = (module$1) => {
 	}
 	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 = /* @__PURE__ */ 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/formatter/src/insertion.ts
@@ -71,6 +119,27 @@ const collectGqlIdentifiers = (module$1) => {
 */
 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 !== void 0) 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.
 *
@@ -81,6 +150,29 @@ const hasExistingNewline = (source, objectStartPos) => {
 	const nextChar = source[objectStartPos + 1];
 	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/formatter/src/format.ts
@@ -88,11 +180,26 @@ const hasExistingNewline = (source, objectStartPos) => {
 * Simple recursive AST traversal
 */
 const traverseNode = (node, context, gqlIdentifiers, onObjectExpression) => {
-	if (node.type === "CallExpression" && isGqlDefinitionCall(node, gqlIdentifiers)) context = {
-		...context,
-		insideGqlDefinition: true
-	};
-	if (node.type === "ObjectExpression" && context.insideGqlDefinition && context.currentArrowFunction && isFieldSelectionObject(node, context.currentArrowFunction)) onObjectExpression(node, context.currentArrowFunction);
+	if (node.type === "CallExpression" && isGqlDefinitionCall(node, gqlIdentifiers)) {
+		const firstArg = node.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 firstArg = node.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);
@@ -117,17 +224,19 @@ const traverseNode = (node, context, gqlIdentifiers, onObjectExpression) => {
 	} else if (value && typeof value === "object" && "type" in value) traverseNode(value, context, gqlIdentifiers, onObjectExpression);
 };
 const traverse = (module$1, gqlIdentifiers, onObjectExpression) => {
-	for (const statement of module$1.body) traverseNode(statement, {
+	const initialContext = {
 		insideGqlDefinition: false,
-		currentArrowFunction: null
-	}, gqlIdentifiers, onObjectExpression);
+		currentArrowFunction: null,
+		fragmentIdentifiers: /* @__PURE__ */ new Set()
+	};
+	for (const statement of module$1.body) traverseNode(statement, initialContext, gqlIdentifiers, onObjectExpression);
 };
 /**
 * Format soda-gql field selection objects by inserting newlines.
-* This preserves multi-line formatting when using Biome/Prettier.
+* Optionally injects fragment keys for anonymous fragments.
 */
 const format = (options) => {
-	const { sourceCode, filePath } = options;
+	const { sourceCode, filePath, injectFragmentKeys = false } = options;
 	let module$1;
 	try {
 		const program = (0, __swc_core.parseSync)(sourceCode, {
@@ -151,25 +260,42 @@ const format = (options) => {
 			cause
 		});
 	}
-	const spanOffset = module$1.span.end - sourceCode.length + 1;
+	const spanOffset = module$1.span.start;
 	const gqlIdentifiers = collectGqlIdentifiers(module$1);
 	if (gqlIdentifiers.size === 0) return (0, neverthrow.ok)({
 		modified: false,
 		sourceCode
 	});
 	const insertionPoints = [];
-	traverse(module$1, gqlIdentifiers, (object, _parent) => {
+	traverse(module$1, gqlIdentifiers, (object, _parent, callbackContext) => {
 		const objectStart = object.span.start - spanOffset;
-		if (hasExistingNewline(sourceCode, objectStart)) return;
-		insertionPoints.push(objectStart + 1);
+		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
+		});
 	});
 	if (insertionPoints.length === 0) return (0, neverthrow.ok)({
 		modified: false,
 		sourceCode
 	});
-	const sortedPoints = [...insertionPoints].sort((a, b) => b - a);
+	const sortedPoints = [...insertionPoints].sort((a, b) => b.position - a.position);
 	let result = sourceCode;
-	for (const pos of sortedPoints) result = result.slice(0, pos) + NEWLINE_INSERTION + result.slice(pos);
+	for (const point of sortedPoints) result = result.slice(0, point.position) + point.content + result.slice(point.position);
 	return (0, neverthrow.ok)({
 		modified: true,
 		sourceCode: result
@@ -204,12 +330,13 @@ const needsFormat = (options) => {
 			cause
 		});
 	}
-	const spanOffset = module$1.span.end - sourceCode.length + 1;
+	const spanOffset = module$1.span.start;
 	const gqlIdentifiers = collectGqlIdentifiers(module$1);
 	if (gqlIdentifiers.size === 0) return (0, neverthrow.ok)(false);
 	let needsFormatting = false;
-	traverse(module$1, gqlIdentifiers, (object, _parent) => {
+	traverse(module$1, gqlIdentifiers, (object, _parent, callbackContext) => {
 		if (needsFormatting) return;
+		if (callbackContext.isFragmentConfig) return;
 		if (!hasExistingNewline(sourceCode, object.span.start - spanOffset)) needsFormatting = true;
 	});
 	return (0, neverthrow.ok)(needsFormatting);

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["bodyObject: ObjectExpression | null","module","module","module: Module","insertionPoints: number[]"],"sources":["../src/detection.ts","../src/insertion.ts","../src/format.ts"],"sourcesContent":["import type {\n  ArrowFunctionExpression,\n  CallExpression,\n  Expression,\n  Module,\n  ObjectExpression,\n  ObjectPatternProperty,\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  if (node.type === \"Identifier\") {\n    return gqlIdentifiers.has(node.value);\n  }\n  if (node.type === \"MemberExpression\" && node.property.type === \"Identifier\" && node.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\") 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 * The newline string to insert after object opening brace\n */\nexport const NEWLINE_INSERTION = \"\\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","import { parseSync } from \"@swc/core\";\nimport type { ArrowFunctionExpression, CallExpression, Module, Node, ObjectExpression } from \"@swc/types\";\nimport { err, ok, type Result } from \"neverthrow\";\nimport { collectGqlIdentifiers, isFieldSelectionObject, isGqlDefinitionCall } from \"./detection\";\nimport { hasExistingNewline, NEWLINE_INSERTION } from \"./insertion\";\nimport type { FormatError, FormatOptions, FormatResult } from \"./types\";\n\ntype TraversalContext = {\n  insideGqlDefinition: boolean;\n  currentArrowFunction: ArrowFunctionExpression | null;\n};\n\n/**\n * Simple recursive AST traversal\n */\nconst traverseNode = (\n  node: Node,\n  context: TraversalContext,\n  gqlIdentifiers: ReadonlySet<string>,\n  onObjectExpression: (object: ObjectExpression, parent: ArrowFunctionExpression) => void,\n): void => {\n  // Check for gql definition call entry\n  if (node.type === \"CallExpression\" && isGqlDefinitionCall(node as CallExpression, gqlIdentifiers)) {\n    context = { ...context, insideGqlDefinition: true };\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);\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 = (\n  module: Module,\n  gqlIdentifiers: ReadonlySet<string>,\n  onObjectExpression: (object: ObjectExpression, parent: ArrowFunctionExpression) => void,\n): void => {\n  for (const statement of module.body) {\n    traverseNode(statement, { insideGqlDefinition: false, currentArrowFunction: null }, gqlIdentifiers, onObjectExpression);\n  }\n};\n\n/**\n * Format soda-gql field selection objects by inserting newlines.\n * This preserves multi-line formatting when using Biome/Prettier.\n */\nexport const format = (options: FormatOptions): Result<FormatResult, 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  // Calculate span offset for position normalization\n  // SWC's BytePos counter accumulates across parseSync calls within the same process\n  const spanOffset = module.span.end - sourceCode.length + 1;\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: number[] = [];\n\n  traverse(module, gqlIdentifiers, (object, _parent) => {\n    // Calculate actual position in source\n    const objectStart = object.span.start - spanOffset;\n\n    // Check if already has newline\n    if (hasExistingNewline(sourceCode, objectStart)) return;\n\n    // Record insertion point (position after `{`)\n    insertionPoints.push(objectStart + 1);\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 - a);\n\n  let result = sourceCode;\n  for (const pos of sortedPoints) {\n    result = result.slice(0, pos) + NEWLINE_INSERTION + result.slice(pos);\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.end - sourceCode.length + 1;\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) => {\n    if (needsFormatting) return; // Early exit\n\n    const objectStart = object.span.start - spanOffset;\n    if (!hasExistingNewline(sourceCode, objectStart)) {\n      needsFormatting = true;\n    }\n  });\n\n  return ok(needsFormatting);\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["bodyObject: ObjectExpression | null","module","initialContext: TraversalContext","module","module: Module","insertionPoints: InsertionPoint[]"],"sources":["../src/detection.ts","../src/insertion.ts","../src/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  if (node.type === \"Identifier\") {\n    return gqlIdentifiers.has(node.value);\n  }\n  if (node.type === \"MemberExpression\" && node.property.type === \"Identifier\" && node.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\") 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 { parseSync } from \"@swc/core\";\nimport type { ArrowFunctionExpression, CallExpression, Module, Node, ObjectExpression } from \"@swc/types\";\nimport { err, ok, type Result } from \"neverthrow\";\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};\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  // 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\n    const objectStart = 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  // 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    result = result.slice(0, point.position) + point.content + result.slice(point.position);\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 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 = object.span.start - spanOffset;\n    if (!hasExistingNewline(sourceCode, objectStart)) {\n      needsFormatting = true;\n    }\n  });\n\n  return ok(needsFormatting);\n};\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -4,6 +4,7 @@ import { Result } from "neverthrow";
 type FormatOptions = {
   readonly sourceCode: string;
   readonly filePath?: string;
+  readonly injectFragmentKeys?: boolean;
 };
 type FormatResult = {
   readonly modified: boolean;
@@ -19,7 +20,7 @@ type FormatError = {
 //#region packages/formatter/src/format.d.ts
 /**
  * Format soda-gql field selection objects by inserting newlines.
- * This preserves multi-line formatting when using Biome/Prettier.
+ * Optionally injects fragment keys for anonymous fragments.
  */
 declare const format: (options: FormatOptions) => Result<FormatResult, FormatError>;
 /**

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/format.ts"],"sourcesContent":[],"mappings":";;;KAAY,aAAA;;;AAAZ,CAAA;AAKY,KAAA,YAAA,GAAY;EAKZ,SAAA,QAAW,EAAA,OAAA;;;KAAX,WAAA;EC0FC,SAsEZ,IAAA,EAAA,aAAA;EAtE+B,SAAA,IAAA,EAAA,aAAA,GAAA,iBAAA;EAAuB,SAAA,OAAA,EAAA,MAAA;EAAc,SAAA,KAAA,CAAA,EAAA,OAAA;CAArB;;;;ADpGhD;AAKA;AAKA;cC0Fa,kBAAmB,kBAAgB,OAAO,cAAc;;;AAArE;;AAAuD,cA4E1C,WA5E0C,EAAA,CAAA,OAAA,EA4ElB,aA5EkB,EAAA,GA4EF,MA5EE,CAAA,OAAA,EA4Ec,WA5Ed,CAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/format.ts"],"sourcesContent":[],"mappings":";;;KAAY,aAAA;;;EAAA,SAAA,kBAAa,CAAA,EAAA,OAAA;AAMzB,CAAA;AAKY,KALA,YAAA,GAKW;;;;ACkJV,KDlJD,WAAA,GCkPX;EAhG+B,SAAA,IAAA,EAAA,aAAA;EAAuB,SAAA,IAAA,EAAA,aAAA,GAAA,iBAAA;EAAc,SAAA,OAAA,EAAA,MAAA;EAArB,SAAA,KAAA,CAAA,EAAA,OAAA;CAAM;;;;AD7JtD;AAMA;AAKA;cCkJa,kBAAmB,kBAAgB,OAAO,cAAc;;;AAArE;;AAAuD,cAsG1C,WAtG0C,EAAA,CAAA,OAAA,EAsGlB,aAtGkB,EAAA,GAsGF,MAtGE,CAAA,OAAA,EAsGc,WAtGd,CAAA"}

package/dist/index.d.mts

@@ -4,6 +4,7 @@ import { Result } from "neverthrow";
 type FormatOptions = {
   readonly sourceCode: string;
   readonly filePath?: string;
+  readonly injectFragmentKeys?: boolean;
 };
 type FormatResult = {
   readonly modified: boolean;
@@ -19,7 +20,7 @@ type FormatError = {
 //#region packages/formatter/src/format.d.ts
 /**
  * Format soda-gql field selection objects by inserting newlines.
- * This preserves multi-line formatting when using Biome/Prettier.
+ * Optionally injects fragment keys for anonymous fragments.
  */
 declare const format: (options: FormatOptions) => Result<FormatResult, FormatError>;
 /**

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/format.ts"],"sourcesContent":[],"mappings":";;;KAAY,aAAA;;;AAAZ,CAAA;AAKY,KAAA,YAAA,GAAY;EAKZ,SAAA,QAAW,EAAA,OAAA;;;KAAX,WAAA;EC0FC,SAsEZ,IAAA,EAAA,aAAA;EAtE+B,SAAA,IAAA,EAAA,aAAA,GAAA,iBAAA;EAAuB,SAAA,OAAA,EAAA,MAAA;EAAc,SAAA,KAAA,CAAA,EAAA,OAAA;CAArB;;;;ADpGhD;AAKA;AAKA;cC0Fa,kBAAmB,kBAAgB,OAAO,cAAc;;;AAArE;;AAAuD,cA4E1C,WA5E0C,EAAA,CAAA,OAAA,EA4ElB,aA5EkB,EAAA,GA4EF,MA5EE,CAAA,OAAA,EA4Ec,WA5Ed,CAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/format.ts"],"sourcesContent":[],"mappings":";;;KAAY,aAAA;;;EAAA,SAAA,kBAAa,CAAA,EAAA,OAAA;AAMzB,CAAA;AAKY,KALA,YAAA,GAKW;;;;ACkJV,KDlJD,WAAA,GCkPX;EAhG+B,SAAA,IAAA,EAAA,aAAA;EAAuB,SAAA,IAAA,EAAA,aAAA,GAAA,iBAAA;EAAc,SAAA,OAAA,EAAA,MAAA;EAArB,SAAA,KAAA,CAAA,EAAA,OAAA;CAAM;;;;AD7JtD;AAMA;AAKA;cCkJa,kBAAmB,kBAAgB,OAAO,cAAc;;;AAArE;;AAAuD,cAsG1C,WAtG0C,EAAA,CAAA,OAAA,EAsGlB,aAtGkB,EAAA,GAsGF,MAtGE,CAAA,OAAA,EAsGc,WAtGd,CAAA"}

package/dist/index.mjs

@@ -1,5 +1,6 @@
 import { parseSync } from "@swc/core";
 import { err, ok } from "neverthrow";
+import { randomBytes } from "node:crypto";
 
 //#region packages/formatter/src/detection.ts
 /**
@@ -63,6 +64,53 @@ const collectGqlIdentifiers = (module) => {
 	}
 	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 = /* @__PURE__ */ 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/formatter/src/insertion.ts
@@ -71,6 +119,27 @@ const collectGqlIdentifiers = (module) => {
 */
 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 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 !== void 0) 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.
 *
@@ -81,6 +150,29 @@ const hasExistingNewline = (source, objectStartPos) => {
 	const nextChar = source[objectStartPos + 1];
 	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/formatter/src/format.ts
@@ -88,11 +180,26 @@ const hasExistingNewline = (source, objectStartPos) => {
 * Simple recursive AST traversal
 */
 const traverseNode = (node, context, gqlIdentifiers, onObjectExpression) => {
-	if (node.type === "CallExpression" && isGqlDefinitionCall(node, gqlIdentifiers)) context = {
-		...context,
-		insideGqlDefinition: true
-	};
-	if (node.type === "ObjectExpression" && context.insideGqlDefinition && context.currentArrowFunction && isFieldSelectionObject(node, context.currentArrowFunction)) onObjectExpression(node, context.currentArrowFunction);
+	if (node.type === "CallExpression" && isGqlDefinitionCall(node, gqlIdentifiers)) {
+		const firstArg = node.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 firstArg = node.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);
@@ -117,17 +224,19 @@ const traverseNode = (node, context, gqlIdentifiers, onObjectExpression) => {
 	} else if (value && typeof value === "object" && "type" in value) traverseNode(value, context, gqlIdentifiers, onObjectExpression);
 };
 const traverse = (module, gqlIdentifiers, onObjectExpression) => {
-	for (const statement of module.body) traverseNode(statement, {
+	const initialContext = {
 		insideGqlDefinition: false,
-		currentArrowFunction: null
-	}, gqlIdentifiers, onObjectExpression);
+		currentArrowFunction: null,
+		fragmentIdentifiers: /* @__PURE__ */ new Set()
+	};
+	for (const statement of module.body) traverseNode(statement, initialContext, gqlIdentifiers, onObjectExpression);
 };
 /**
 * Format soda-gql field selection objects by inserting newlines.
-* This preserves multi-line formatting when using Biome/Prettier.
+* Optionally injects fragment keys for anonymous fragments.
 */
 const format = (options) => {
-	const { sourceCode, filePath } = options;
+	const { sourceCode, filePath, injectFragmentKeys = false } = options;
 	let module;
 	try {
 		const program = parseSync(sourceCode, {
@@ -151,25 +260,42 @@ const format = (options) => {
 			cause
 		});
 	}
-	const spanOffset = module.span.end - sourceCode.length + 1;
+	const spanOffset = module.span.start;
 	const gqlIdentifiers = collectGqlIdentifiers(module);
 	if (gqlIdentifiers.size === 0) return ok({
 		modified: false,
 		sourceCode
 	});
 	const insertionPoints = [];
-	traverse(module, gqlIdentifiers, (object, _parent) => {
+	traverse(module, gqlIdentifiers, (object, _parent, callbackContext) => {
 		const objectStart = object.span.start - spanOffset;
-		if (hasExistingNewline(sourceCode, objectStart)) return;
-		insertionPoints.push(objectStart + 1);
+		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
+		});
 	});
 	if (insertionPoints.length === 0) return ok({
 		modified: false,
 		sourceCode
 	});
-	const sortedPoints = [...insertionPoints].sort((a, b) => b - a);
+	const sortedPoints = [...insertionPoints].sort((a, b) => b.position - a.position);
 	let result = sourceCode;
-	for (const pos of sortedPoints) result = result.slice(0, pos) + NEWLINE_INSERTION + result.slice(pos);
+	for (const point of sortedPoints) result = result.slice(0, point.position) + point.content + result.slice(point.position);
 	return ok({
 		modified: true,
 		sourceCode: result
@@ -204,12 +330,13 @@ const needsFormat = (options) => {
 			cause
 		});
 	}
-	const spanOffset = module.span.end - sourceCode.length + 1;
+	const spanOffset = module.span.start;
 	const gqlIdentifiers = collectGqlIdentifiers(module);
 	if (gqlIdentifiers.size === 0) return ok(false);
 	let needsFormatting = false;
-	traverse(module, gqlIdentifiers, (object, _parent) => {
+	traverse(module, gqlIdentifiers, (object, _parent, callbackContext) => {
 		if (needsFormatting) return;
+		if (callbackContext.isFragmentConfig) return;
 		if (!hasExistingNewline(sourceCode, object.span.start - spanOffset)) needsFormatting = true;
 	});
 	return ok(needsFormatting);

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["bodyObject: ObjectExpression | null","module: Module","insertionPoints: number[]"],"sources":["../src/detection.ts","../src/insertion.ts","../src/format.ts"],"sourcesContent":["import type {\n  ArrowFunctionExpression,\n  CallExpression,\n  Expression,\n  Module,\n  ObjectExpression,\n  ObjectPatternProperty,\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  if (node.type === \"Identifier\") {\n    return gqlIdentifiers.has(node.value);\n  }\n  if (node.type === \"MemberExpression\" && node.property.type === \"Identifier\" && node.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\") 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 * The newline string to insert after object opening brace\n */\nexport const NEWLINE_INSERTION = \"\\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","import { parseSync } from \"@swc/core\";\nimport type { ArrowFunctionExpression, CallExpression, Module, Node, ObjectExpression } from \"@swc/types\";\nimport { err, ok, type Result } from \"neverthrow\";\nimport { collectGqlIdentifiers, isFieldSelectionObject, isGqlDefinitionCall } from \"./detection\";\nimport { hasExistingNewline, NEWLINE_INSERTION } from \"./insertion\";\nimport type { FormatError, FormatOptions, FormatResult } from \"./types\";\n\ntype TraversalContext = {\n  insideGqlDefinition: boolean;\n  currentArrowFunction: ArrowFunctionExpression | null;\n};\n\n/**\n * Simple recursive AST traversal\n */\nconst traverseNode = (\n  node: Node,\n  context: TraversalContext,\n  gqlIdentifiers: ReadonlySet<string>,\n  onObjectExpression: (object: ObjectExpression, parent: ArrowFunctionExpression) => void,\n): void => {\n  // Check for gql definition call entry\n  if (node.type === \"CallExpression\" && isGqlDefinitionCall(node as CallExpression, gqlIdentifiers)) {\n    context = { ...context, insideGqlDefinition: true };\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);\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 = (\n  module: Module,\n  gqlIdentifiers: ReadonlySet<string>,\n  onObjectExpression: (object: ObjectExpression, parent: ArrowFunctionExpression) => void,\n): void => {\n  for (const statement of module.body) {\n    traverseNode(statement, { insideGqlDefinition: false, currentArrowFunction: null }, gqlIdentifiers, onObjectExpression);\n  }\n};\n\n/**\n * Format soda-gql field selection objects by inserting newlines.\n * This preserves multi-line formatting when using Biome/Prettier.\n */\nexport const format = (options: FormatOptions): Result<FormatResult, 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  // Calculate span offset for position normalization\n  // SWC's BytePos counter accumulates across parseSync calls within the same process\n  const spanOffset = module.span.end - sourceCode.length + 1;\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: number[] = [];\n\n  traverse(module, gqlIdentifiers, (object, _parent) => {\n    // Calculate actual position in source\n    const objectStart = object.span.start - spanOffset;\n\n    // Check if already has newline\n    if (hasExistingNewline(sourceCode, objectStart)) return;\n\n    // Record insertion point (position after `{`)\n    insertionPoints.push(objectStart + 1);\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 - a);\n\n  let result = sourceCode;\n  for (const pos of sortedPoints) {\n    result = result.slice(0, pos) + NEWLINE_INSERTION + result.slice(pos);\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.end - sourceCode.length + 1;\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) => {\n    if (needsFormatting) return; // Early exit\n\n    const objectStart = object.span.start - spanOffset;\n    if (!hasExistingNewline(sourceCode, objectStart)) {\n      needsFormatting = true;\n    }\n  });\n\n  return ok(needsFormatting);\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["bodyObject: ObjectExpression | null","initialContext: TraversalContext","module: Module","insertionPoints: InsertionPoint[]"],"sources":["../src/detection.ts","../src/insertion.ts","../src/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  if (node.type === \"Identifier\") {\n    return gqlIdentifiers.has(node.value);\n  }\n  if (node.type === \"MemberExpression\" && node.property.type === \"Identifier\" && node.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\") 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 { parseSync } from \"@swc/core\";\nimport type { ArrowFunctionExpression, CallExpression, Module, Node, ObjectExpression } from \"@swc/types\";\nimport { err, ok, type Result } from \"neverthrow\";\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};\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  // 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\n    const objectStart = 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  // 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    result = result.slice(0, point.position) + point.content + result.slice(point.position);\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 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 = object.span.start - spanOffset;\n    if (!hasExistingNewline(sourceCode, objectStart)) {\n      needsFormatting = true;\n    }\n  });\n\n  return ok(needsFormatting);\n};\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soda-gql/formatter",
-  "version": "0.10.2",
+  "version": "0.11.1",
   "description": "GraphQL document formatter for soda-gql",
   "type": "module",
   "private": false,