feat: Adds OTel-standard GraphQL span

See https://opentelemetry.io/docs/specs/semconv/graphql/graphql-spans/

Author: NeedleInAJayStack

Benchmarks/Package.resolved

@@ -8,13 +8,18 @@ let package = Package(
         .library(name: "GraphQL", targets: ["GraphQL"])
     ],
     dependencies: [
-        .package(url: "https://github.com/apple/swift-collections", .upToNextMajor(from: "1.0.0"))
+        .package(url: "https://github.com/apple/swift-collections", .upToNextMajor(from: "1.0.0")),
+        .package(
+            url: "https://github.com/apple/swift-distributed-tracing",
+            .upToNextMajor(from: "1.0.0")
+        ),
     ],
     targets: [
         .target(
             name: "GraphQL",
             dependencies: [
-                .product(name: "OrderedCollections", package: "swift-collections")
+                .product(name: "OrderedCollections", package: "swift-collections"),
+                .product(name: "Tracing", package: "swift-distributed-tracing"),
             ]
         ),
         .testTarget(

Package.resolved

@@ -1,3 +1,5 @@
+import Tracing
+
 public struct GraphQLResult: Equatable, Codable, Sendable, CustomStringConvertible {
     public var data: Map?
     public var errors: [GraphQLError]
@@ -97,25 +99,37 @@ public func graphql(
     let source = Source(body: request, name: "GraphQL request")
     let documentAST = try parse(source: source)
 
-    // Validate
-    let validationErrors = validate(
-        schema: schema,
-        ast: documentAST,
-        rules: validationRules
-    )
-    guard validationErrors.isEmpty else {
-        return GraphQLResult(errors: validationErrors)
-    }
+    let operation =
+        documentAST.definitions.first {
+            $0 is OperationDefinition
+        } as! OperationDefinition?
 
-    // Execute
-    return try await execute(
-        schema: schema,
-        documentAST: documentAST,
-        rootValue: rootValue,
-        context: context,
-        variableValues: variableValues,
-        operationName: operationName
-    )
+    // See https://opentelemetry.io/docs/specs/semconv/graphql/graphql-spans/
+    return try await withSpan(operation?.operation.rawValue ?? "GraphQL Operation") { span in
+        // `graphql.document` was omitted due to the possibility of very large sizes.
+        span.attributes["graphql.operation.name"] = operation?.name?.value
+        span.attributes["graphql.operation.type"] = operation?.operation.rawValue
+
+        // Validate
+        let validationErrors = validate(
+            schema: schema,
+            ast: documentAST,
+            rules: validationRules
+        )
+        guard validationErrors.isEmpty else {
+            return GraphQLResult(errors: validationErrors)
+        }
+
+        // Execute
+        return try await execute(
+            schema: schema,
+            documentAST: documentAST,
+            rootValue: rootValue,
+            context: context,
+            variableValues: variableValues,
+            operationName: operationName
+        )
+    }
 }
 
 /// This is the primary entry point function for fulfilling GraphQL operations