@graphql-tools/utils 11.0.0-alpha-20251112101412-7b3e869e04dc287cf268a3275335f28e3490d10a → 11.0.0-alpha-20251224084859-76041a3e34f4ada36bb2f3f1ab3bcd0956d5873f

package/cjs/errors.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isGraphQLErrorLike = isGraphQLErrorLike;
 exports.createGraphQLError = createGraphQLError;
+exports.getSchemaCoordinate = getSchemaCoordinate;
+exports.locatedError = locatedError;
 exports.relocatedError = relocatedError;
 const graphql_1 = require("graphql");
 const possibleGraphQLErrorProperties = [
@@ -14,6 +17,7 @@ const possibleGraphQLErrorProperties = [
     'name',
     'stack',
     'extensions',
+    'coordinate',
 ];
 function isGraphQLErrorLike(error) {
     return (error != null &&
@@ -26,12 +30,33 @@ function createGraphQLError(message, options) {
         isGraphQLErrorLike(options.originalError)) {
         options.originalError = createGraphQLError(options.originalError.message, options.originalError);
     }
-    if (graphql_1.versionInfo.major >= 17) {
-        return new graphql_1.GraphQLError(message, options);
+    // To avoid type error on graphql <16, we have to use an any type here
+    const Constructor = graphql_1.GraphQLError;
+    const error = graphql_1.versionInfo.major >= 16
+        ? new Constructor(message, options)
+        : new Constructor(message, options?.nodes, options?.source, options?.positions, options?.path, options?.originalError, options?.extensions);
+    if (options?.coordinate && error.coordinate == null) {
+        Object.defineProperties(error, {
+            coordinate: { value: options.coordinate, enumerable: true, configurable: true },
+        });
     }
-    return new graphql_1.GraphQLError(message, options?.nodes, options?.source, options?.positions, options?.path, options?.originalError, options?.extensions);
+    return error;
 }
-function relocatedError(originalError, path) {
+function getSchemaCoordinate(error) {
+    return error.coordinate;
+}
+function locatedError(rawError, nodes, path, info) {
+    const error = (0, graphql_1.locatedError)(rawError, nodes, path);
+    // `graphql` locatedError is only changing path and nodes if it is not already defined
+    if (!error.coordinate && info && error.coordinate == null) {
+        const coordinate = `${info.parentType.name}.${info.fieldName}`;
+        Object.defineProperties(error, {
+            coordinate: { value: coordinate, enumerable: true, configurable: true },
+        });
+    }
+    return error;
+}
+function relocatedError(originalError, path, info) {
     return createGraphQLError(originalError.message, {
         nodes: originalError.nodes,
         source: originalError.source,
@@ -39,5 +64,6 @@ function relocatedError(originalError, path) {
         path: path == null ? originalError.path : path,
         originalError,
         extensions: originalError.extensions,
+        coordinate: info ? `${info.parentType.name}.${info.fieldName}` : undefined,
     });
 }

package/esm/errors.js

@@ -1,4 +1,4 @@
-import { GraphQLError, versionInfo } from 'graphql';
+import { locatedError as _locatedError, GraphQLError, versionInfo } from 'graphql';
 const possibleGraphQLErrorProperties = [
     'message',
     'locations',
@@ -10,8 +10,9 @@ const possibleGraphQLErrorProperties = [
     'name',
     'stack',
     'extensions',
+    'coordinate',
 ];
-function isGraphQLErrorLike(error) {
+export function isGraphQLErrorLike(error) {
     return (error != null &&
         typeof error === 'object' &&
         Object.keys(error).every(key => possibleGraphQLErrorProperties.includes(key)));
@@ -22,12 +23,33 @@ export function createGraphQLError(message, options) {
         isGraphQLErrorLike(options.originalError)) {
         options.originalError = createGraphQLError(options.originalError.message, options.originalError);
     }
-    if (versionInfo.major >= 17) {
-        return new GraphQLError(message, options);
+    // To avoid type error on graphql <16, we have to use an any type here
+    const Constructor = GraphQLError;
+    const error = versionInfo.major >= 16
+        ? new Constructor(message, options)
+        : new Constructor(message, options?.nodes, options?.source, options?.positions, options?.path, options?.originalError, options?.extensions);
+    if (options?.coordinate && error.coordinate == null) {
+        Object.defineProperties(error, {
+            coordinate: { value: options.coordinate, enumerable: true, configurable: true },
+        });
     }
-    return new GraphQLError(message, options?.nodes, options?.source, options?.positions, options?.path, options?.originalError, options?.extensions);
+    return error;
 }
-export function relocatedError(originalError, path) {
+export function getSchemaCoordinate(error) {
+    return error.coordinate;
+}
+export function locatedError(rawError, nodes, path, info) {
+    const error = _locatedError(rawError, nodes, path);
+    // `graphql` locatedError is only changing path and nodes if it is not already defined
+    if (!error.coordinate && info && error.coordinate == null) {
+        const coordinate = `${info.parentType.name}.${info.fieldName}`;
+        Object.defineProperties(error, {
+            coordinate: { value: coordinate, enumerable: true, configurable: true },
+        });
+    }
+    return error;
+}
+export function relocatedError(originalError, path, info) {
     return createGraphQLError(originalError.message, {
         nodes: originalError.nodes,
         source: originalError.source,
@@ -35,5 +57,6 @@ export function relocatedError(originalError, path) {
         path: path == null ? originalError.path : path,
         originalError,
         extensions: originalError.extensions,
+        coordinate: info ? `${info.parentType.name}.${info.fieldName}` : undefined,
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graphql-tools/utils",
-  "version": "11.0.0-alpha-20251112101412-7b3e869e04dc287cf268a3275335f28e3490d10a",
+  "version": "11.0.0-alpha-20251224084859-76041a3e34f4ada36bb2f3f1ab3bcd0956d5873f",
   "description": "Common package containing utils and types for GraphQL tools",
   "sideEffects": false,
   "peerDependencies": {

package/typings/Interfaces.d.cts

@@ -32,6 +32,13 @@ export interface ExecutionRequest<TVariables extends Record<string, any> = any,
     subgraphName?: string;
     info?: GraphQLResolveInfo;
     signal?: AbortSignal;
+    /**
+     * Enable/Disable the addition of field schema coordinate in GraphQL Errors extension
+     *
+     * Note: Schema Coordinate are exposed using Symbol.for('schemaCoordinate') so that it's not
+     *       serialized. Exposing schema coordinate can ease the discovery of private schemas.
+     */
+    schemaCoordinateInErrors?: boolean;
 }
 export interface GraphQLParseOptions {
     noLocation?: boolean;

package/typings/Interfaces.d.ts

@@ -32,6 +32,13 @@ export interface ExecutionRequest<TVariables extends Record<string, any> = any,
     subgraphName?: string;
     info?: GraphQLResolveInfo;
     signal?: AbortSignal;
+    /**
+     * Enable/Disable the addition of field schema coordinate in GraphQL Errors extension
+     *
+     * Note: Schema Coordinate are exposed using Symbol.for('schemaCoordinate') so that it's not
+     *       serialized. Exposing schema coordinate can ease the discovery of private schemas.
+     */
+    schemaCoordinateInErrors?: boolean;
 }
 export interface GraphQLParseOptions {
     noLocation?: boolean;

package/typings/errors.d.cts

@@ -9,7 +9,25 @@ interface GraphQLErrorOptions {
         readonly extensions?: unknown;
     }>;
     extensions?: any;
+    coordinate?: string;
 }
+declare module 'graphql' {
+    interface GraphQLError {
+        /**
+         * An optional schema coordinate (e.g. "MyType.myField") associated with this error.
+         */
+        readonly coordinate?: string;
+    }
+}
+export declare function isGraphQLErrorLike(error: any): boolean;
 export declare function createGraphQLError(message: string, options?: GraphQLErrorOptions): GraphQLError;
-export declare function relocatedError(originalError: GraphQLError, path?: ReadonlyArray<string | number>): GraphQLError;
+type SchemaCoordinateInfo = {
+    fieldName: string;
+    parentType: {
+        name: string;
+    };
+};
+export declare function getSchemaCoordinate(error: GraphQLError): string | undefined;
+export declare function locatedError(rawError: unknown, nodes: ASTNode | ReadonlyArray<ASTNode> | undefined, path: Maybe<ReadonlyArray<string | number>>, info?: SchemaCoordinateInfo | false | null | undefined): GraphQLError;
+export declare function relocatedError(originalError: GraphQLError, path?: ReadonlyArray<string | number>, info?: SchemaCoordinateInfo | false | null | undefined): GraphQLError;
 export {};

package/typings/errors.d.ts

@@ -9,7 +9,25 @@ interface GraphQLErrorOptions {
         readonly extensions?: unknown;
     }>;
     extensions?: any;
+    coordinate?: string;
 }
+declare module 'graphql' {
+    interface GraphQLError {
+        /**
+         * An optional schema coordinate (e.g. "MyType.myField") associated with this error.
+         */
+        readonly coordinate?: string;
+    }
+}
+export declare function isGraphQLErrorLike(error: any): boolean;
 export declare function createGraphQLError(message: string, options?: GraphQLErrorOptions): GraphQLError;
-export declare function relocatedError(originalError: GraphQLError, path?: ReadonlyArray<string | number>): GraphQLError;
+type SchemaCoordinateInfo = {
+    fieldName: string;
+    parentType: {
+        name: string;
+    };
+};
+export declare function getSchemaCoordinate(error: GraphQLError): string | undefined;
+export declare function locatedError(rawError: unknown, nodes: ASTNode | ReadonlyArray<ASTNode> | undefined, path: Maybe<ReadonlyArray<string | number>>, info?: SchemaCoordinateInfo | false | null | undefined): GraphQLError;
+export declare function relocatedError(originalError: GraphQLError, path?: ReadonlyArray<string | number>, info?: SchemaCoordinateInfo | false | null | undefined): GraphQLError;
 export {};