/**
 * Base GraphQL response type that matches the GraphQL specification.
 * Note that pagination styles are server-specific and should be defined by each connector.
 */

/**
 * This represents an error from the GraphQL server, described here: https://spec.graphql.org/draft/#sec-Errors
 */
export interface GraphQLServerError {
  /** A description of the error */
  message: string;
  /** Locations in the query where the error occurred */
  locations?: { line: number; column: number }[];
  /** Path to the field that caused the error */
  path?: (string | number)[];
  /** Additional error information */
  extensions?: Record<string, unknown>;
}

/**
 * The standard GraphQL response format as per the GraphQL spec: https://spec.graphql.org/draft/#sec-Response-Format
 */
export interface GraphQLResponse<T> {
  /** The actual response data, or null if there were errors */
  data: T | null;
  /** Array of errors if any occurred */
  errors?: GraphQLServerError[];
  /** Optional extensions to the response */
  extensions?: Record<string, unknown>;
}