fix(documents): do not order mutations

.changeset/tough-flowers-listen.md

@@ -0,0 +1,5 @@
+---
+'@graphql-tools/documents': patch
+---
+
+Do not sort mutations when using `printExecutableGraphQLDocument`

packages/documents/src/sort-executable-document.ts

@@ -1,4 +1,4 @@
-import { visit, type DocumentNode } from 'graphql';
+import { OperationTypeNode, visit, type DocumentNode } from 'graphql';
 import { sortExecutableNodes } from './sort-executable-nodes.js';
 
 /**
@@ -13,6 +13,10 @@ export function sortExecutableDocument(document: DocumentNode): DocumentNode {
       };
     },
     OperationDefinition(node) {
+      if (node.operation === ('mutation' as OperationTypeNode)) {
+        return false;
+      }
+
       return {
         ...node,
         variableDefinitions: sortExecutableNodes(node.variableDefinitions),

packages/documents/tests/print-executable-graphql-document.spec.ts

@@ -83,4 +83,20 @@ describe('printExecutableGraphQLDocument', () => {
       `"fragment B on Query { c } query A { ... on Query { a { a ...B } } ... on Query { a { b ...B } } }"`,
     );
   });
+
+  test('should not sort a mutation as mutations run in series and order matters', () => {
+    const inputDocument = parse(/* GraphQL */ `
+      mutation A {
+        c {
+          f
+          e
+          d
+        }
+        b
+        a
+      }
+    `);
+    const outputStr = printExecutableGraphQLDocument(inputDocument);
+    expect(outputStr).toMatchInlineSnapshot(`"mutation A { c { f e d } b a }"`);
+  });
 });