@apollo/client 4.0.0-rc.0 → 4.0.0-rc.10

package/link/error/index.d.ts

@@ -1,30 +1,104 @@
 import { Observable } from "rxjs";
 import type { ErrorLike } from "@apollo/client";
-import type { FetchResult, NextLink, Operation } from "@apollo/client/link";
 import { ApolloLink } from "@apollo/client/link";
 export declare namespace ErrorLink {
+    namespace ErrorLinkDocumentationTypes {
+        /**
+         * Callback that is called by `ErrorLink` when an error occurs from a
+         * downstream link in link chain.
+         *
+         * @param options - The options object provided by `ErrorLink` to the error
+         * handler when an error occurs.
+         */
+        function ErrorHandler(options: ErrorHandlerOptions): Observable<ApolloLink.Result> | void;
+    }
     /**
-     * Callback to be triggered when an error occurs within the link stack.
-     */
+    * Callback that is called by `ErrorLink` when an error occurs from a
+    * downstream link in link chain.
+    * 
+    * @param options - The options object provided by `ErrorLink` to the error
+    * handler when an error occurs.
+    */
     interface ErrorHandler {
-        (options: ErrorHandlerOptions): Observable<FetchResult> | void;
+        (options: ErrorHandlerOptions): Observable<ApolloLink.Result> | void;
     }
+    /**
+     * The object provided to the `ErrorHandler` callback function.
+     */
     interface ErrorHandlerOptions {
         /**
-         * Error that caused the callback to be triggered.
+         * The error that occurred during the operation execution. This can be a
+         * `CombinedGraphQLErrors` instance (for GraphQL errors) or another error
+         * type (for network errors).
+         *
+         * Use `CombinedGraphQLErrors.is(error)` to check if it's a GraphQL error with an `errors` array.
          */
         error: ErrorLike;
-        result?: FetchResult;
-        operation: Operation;
-        forward: NextLink;
+        /**
+         * The raw GraphQL result from the server (if available), which may include
+         * partial data alongside errors.
+         */
+        result?: ApolloLink.Result;
+        /** The details of the GraphQL operation that produced an error. */
+        operation: ApolloLink.Operation;
+        /**
+         * A function that calls the next link in the link chain. Calling
+         * `return forward(operation)` in your `ErrorLink` callback
+         * [retries the operation](../../data/error-handling#retrying-operations), returning a new observable for the
+         * upstream link to subscribe to.
+         */
+        forward: ApolloLink.ForwardFunction;
     }
 }
-export import ErrorHandler = ErrorLink.ErrorHandler;
 /**
  * @deprecated
  * Use `ErrorLink` from `@apollo/client/link/error` instead.
  */
-export declare function onError(errorHandler: ErrorHandler): ErrorLink;
+export declare function onError(errorHandler: ErrorLink.ErrorHandler): ErrorLink;
+/**
+ * Use the `ErrorLink` to perform custom logic when a [GraphQL or network error](https://apollographql.com/docs/react/data/error-handling)
+ * occurs.
+ *
+ * @remarks
+ *
+ * This link is used after the GraphQL operation completes and execution is
+ * moving back up your [link chain](https://apollographql.com/docs/react/introduction#handling-a-response). The `errorHandler` function should
+ * not return a value unless you want to [retry the operation](https://apollographql.com/docs/react/data/error-handling#retrying-operations).
+ *
+ * For more information on the types of errors that might be encountered, see
+ * the guide on [error handling](https://apollographql.com/docs/react/data/error-handling).
+ *
+ * @example
+ *
+ * ```ts
+ * import { ErrorLink } from "@apollo/client/link/error";
+ * import {
+ *   CombinedGraphQLErrors,
+ *   CombinedProtocolErrors,
+ * } from "@apollo/client/errors";
+ *
+ * // Log any GraphQL errors, protocol errors, or network error that occurred
+ * const errorLink = new ErrorLink(({ error, operation }) => {
+ *   if (CombinedGraphQLErrors.is(error)) {
+ *     error.errors.forEach(({ message, locations, path }) =>
+ *       console.log(
+ *         `[GraphQL error]: Message: ${message}, Location: ${locations}, Path: ${path}`
+ *       )
+ *     );
+ *   } else if (CombinedProtocolErrors.is(error)) {
+ *     error.errors.forEach(({ message, extensions }) =>
+ *       console.log(
+ *         `[Protocol error]: Message: ${message}, Extensions: ${JSON.stringify(
+ *           extensions
+ *         )}`
+ *       )
+ *     );
+ *   } else {
+ *     console.error(`[Network error]: ${error}`);
+ *   }
+ * });
+ * ```
+ */
 export declare class ErrorLink extends ApolloLink {
     constructor(errorHandler: ErrorLink.ErrorHandler);
 }

package/link/error/index.js

@@ -8,6 +8,50 @@ import { ApolloLink } from "@apollo/client/link";
 export function onError(errorHandler) {
     return new ErrorLink(errorHandler);
 }
+/**
+ * Use the `ErrorLink` to perform custom logic when a [GraphQL or network error](https://apollographql.com/docs/react/data/error-handling)
+ * occurs.
+ *
+ * @remarks
+ *
+ * This link is used after the GraphQL operation completes and execution is
+ * moving back up your [link chain](https://apollographql.com/docs/react/introduction#handling-a-response). The `errorHandler` function should
+ * not return a value unless you want to [retry the operation](https://apollographql.com/docs/react/data/error-handling#retrying-operations).
+ *
+ * For more information on the types of errors that might be encountered, see
+ * the guide on [error handling](https://apollographql.com/docs/react/data/error-handling).
+ *
+ * @example
+ *
+ * ```ts
+ * import { ErrorLink } from "@apollo/client/link/error";
+ * import {
+ *   CombinedGraphQLErrors,
+ *   CombinedProtocolErrors,
+ * } from "@apollo/client/errors";
+ *
+ * // Log any GraphQL errors, protocol errors, or network error that occurred
+ * const errorLink = new ErrorLink(({ error, operation }) => {
+ *   if (CombinedGraphQLErrors.is(error)) {
+ *     error.errors.forEach(({ message, locations, path }) =>
+ *       console.log(
+ *         `[GraphQL error]: Message: ${message}, Location: ${locations}, Path: ${path}`
+ *       )
+ *     );
+ *   } else if (CombinedProtocolErrors.is(error)) {
+ *     error.errors.forEach(({ message, extensions }) =>
+ *       console.log(
+ *         `[Protocol error]: Message: ${message}, Extensions: ${JSON.stringify(
+ *           extensions
+ *         )}`
+ *       )
+ *     );
+ *   } else {
+ *     console.error(`[Network error]: ${error}`);
+ *   }
+ * });
+ * ```
+ */
 export class ErrorLink extends ApolloLink {
     constructor(errorHandler) {
         super((operation, forward) => {
@@ -77,4 +121,4 @@ export class ErrorLink extends ApolloLink {
         });
     }
 }
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/link/error/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/link/error/index.ts"],"sourcesContent":["import type { Subscription } from \"rxjs\";\nimport { Observable } from \"rxjs\";\n\nimport type { ErrorLike } from \"@apollo/client\";\nimport {\n  CombinedGraphQLErrors,\n  graphQLResultHasProtocolErrors,\n  PROTOCOL_ERRORS_SYMBOL,\n  toErrorLike,\n} from \"@apollo/client/errors\";\nimport type { FetchResult, NextLink, Operation } from \"@apollo/client/link\";\nimport { ApolloLink } from \"@apollo/client/link\";\n\nexport namespace ErrorLink {\n  /**\n   * Callback to be triggered when an error occurs within the link stack.\n   */\n  export interface ErrorHandler {\n    (options: ErrorHandlerOptions): Observable<FetchResult> | void;\n  }\n\n  export interface ErrorHandlerOptions {\n    /**\n     * Error that caused the callback to be triggered.\n     */\n    error: ErrorLike;\n    result?: FetchResult;\n    operation: Operation;\n    forward: NextLink;\n  }\n}\n\n// For backwards compatibility.\nexport import ErrorHandler = ErrorLink.ErrorHandler;\n\n/**\n * @deprecated\n * Use `ErrorLink` from `@apollo/client/link/error` instead.\n */\nexport function onError(errorHandler: ErrorHandler) {\n  return new ErrorLink(errorHandler);\n}\n\nexport class ErrorLink extends ApolloLink {\n  constructor(errorHandler: ErrorLink.ErrorHandler) {\n    super((operation, forward) => {\n      return new Observable((observer) => {\n        let sub: Subscription | undefined;\n        let retriedSub: Subscription | undefined;\n        let retriedResult: ReturnType<ErrorHandler>;\n\n        try {\n          sub = forward(operation).subscribe({\n            next: (result) => {\n              const handler =\n                operation.client[\"queryManager\"].incrementalHandler;\n              const errors =\n                handler.isIncrementalResult(result) ?\n                  handler.extractErrors(result)\n                : result.errors;\n              if (errors) {\n                retriedResult = errorHandler({\n                  error: new CombinedGraphQLErrors(result, errors),\n                  result,\n                  operation,\n                  forward,\n                });\n              } else if (graphQLResultHasProtocolErrors(result)) {\n                retriedResult = errorHandler({\n                  error: result.extensions[PROTOCOL_ERRORS_SYMBOL],\n                  result,\n                  operation,\n                  forward,\n                });\n              }\n\n              retriedSub = retriedResult?.subscribe(observer);\n\n              if (!retriedSub) {\n                observer.next(result);\n              }\n            },\n            error: (error) => {\n              retriedResult = errorHandler({\n                operation,\n                error: toErrorLike(error),\n                forward,\n              });\n              retriedSub = retriedResult?.subscribe(observer);\n\n              if (!retriedSub) {\n                observer.error(error);\n              }\n            },\n            complete: () => {\n              // disable the previous sub from calling complete on observable\n              // if retry is in flight.\n              if (!retriedResult) {\n                observer.complete();\n              }\n            },\n          });\n        } catch (e) {\n          errorHandler({ error: toErrorLike(e), operation, forward });\n          observer.error(e);\n        }\n\n        return () => {\n          if (sub) sub.unsubscribe();\n          if (retriedSub) retriedSub.unsubscribe();\n        };\n      });\n    });\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/link/error/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Subscription } from \"rxjs\";\nimport { Observable } from \"rxjs\";\n\nimport type { ErrorLike } from \"@apollo/client\";\nimport {\n  CombinedGraphQLErrors,\n  graphQLResultHasProtocolErrors,\n  PROTOCOL_ERRORS_SYMBOL,\n  toErrorLike,\n} from \"@apollo/client/errors\";\nimport { ApolloLink } from \"@apollo/client/link\";\n\nexport declare namespace ErrorLink {\n  // Using a different namespace name to avoid clash with\n  // `ApolloLink.DocumentationTypes`\n  export namespace ErrorLinkDocumentationTypes {\n    /**\n     * Callback that is called by `ErrorLink` when an error occurs from a\n     * downstream link in link chain.\n     *\n     * @param options - The options object provided by `ErrorLink` to the error\n     * handler when an error occurs.\n     */\n    export function ErrorHandler(\n      options: ErrorHandlerOptions\n    ): Observable<ApolloLink.Result> | void;\n  }\n\n  /** {@inheritDoc @apollo/client/link/error!ErrorLink.ErrorLinkDocumentationTypes.ErrorHandler:function(1)} */\n  export interface ErrorHandler {\n    (options: ErrorHandlerOptions): Observable<ApolloLink.Result> | void;\n  }\n\n  /**\n   * The object provided to the `ErrorHandler` callback function.\n   */\n  export interface ErrorHandlerOptions {\n    /**\n     * The error that occurred during the operation execution. This can be a\n     * `CombinedGraphQLErrors` instance (for GraphQL errors) or another error\n     * type (for network errors).\n     *\n     * Use `CombinedGraphQLErrors.is(error)` to check if it's a GraphQL error with an `errors` array.\n     */\n    error: ErrorLike;\n    /**\n     * The raw GraphQL result from the server (if available), which may include\n     * partial data alongside errors.\n     */\n    result?: ApolloLink.Result;\n\n    /** The details of the GraphQL operation that produced an error. */\n    operation: ApolloLink.Operation;\n\n    /**\n     * A function that calls the next link in the link chain. Calling\n     * `return forward(operation)` in your `ErrorLink` callback\n     * [retries the operation](../../data/error-handling#retrying-operations), returning a new observable for the\n     * upstream link to subscribe to.\n     */\n    forward: ApolloLink.ForwardFunction;\n  }\n}\n\n/**\n * @deprecated\n * Use `ErrorLink` from `@apollo/client/link/error` instead.\n */\nexport function onError(errorHandler: ErrorLink.ErrorHandler) {\n  return new ErrorLink(errorHandler);\n}\n\n/**\n * Use the `ErrorLink` to perform custom logic when a [GraphQL or network error](https://apollographql.com/docs/react/data/error-handling)\n * occurs.\n *\n * @remarks\n *\n * This link is used after the GraphQL operation completes and execution is\n * moving back up your [link chain](https://apollographql.com/docs/react/introduction#handling-a-response). The `errorHandler` function should\n * not return a value unless you want to [retry the operation](https://apollographql.com/docs/react/data/error-handling#retrying-operations).\n *\n * For more information on the types of errors that might be encountered, see\n * the guide on [error handling](https://apollographql.com/docs/react/data/error-handling).\n *\n * @example\n *\n * ```ts\n * import { ErrorLink } from \"@apollo/client/link/error\";\n * import {\n *   CombinedGraphQLErrors,\n *   CombinedProtocolErrors,\n * } from \"@apollo/client/errors\";\n *\n * // Log any GraphQL errors, protocol errors, or network error that occurred\n * const errorLink = new ErrorLink(({ error, operation }) => {\n *   if (CombinedGraphQLErrors.is(error)) {\n *     error.errors.forEach(({ message, locations, path }) =>\n *       console.log(\n *         `[GraphQL error]: Message: ${message}, Location: ${locations}, Path: ${path}`\n *       )\n *     );\n *   } else if (CombinedProtocolErrors.is(error)) {\n *     error.errors.forEach(({ message, extensions }) =>\n *       console.log(\n *         `[Protocol error]: Message: ${message}, Extensions: ${JSON.stringify(\n *           extensions\n *         )}`\n *       )\n *     );\n *   } else {\n *     console.error(`[Network error]: ${error}`);\n *   }\n * });\n * ```\n */\nexport class ErrorLink extends ApolloLink {\n  constructor(errorHandler: ErrorLink.ErrorHandler) {\n    super((operation, forward) => {\n      return new Observable((observer) => {\n        let sub: Subscription | undefined;\n        let retriedSub: Subscription | undefined;\n        let retriedResult: ReturnType<ErrorLink.ErrorHandler>;\n\n        try {\n          sub = forward(operation).subscribe({\n            next: (result) => {\n              const handler =\n                operation.client[\"queryManager\"].incrementalHandler;\n              const errors =\n                handler.isIncrementalResult(result) ?\n                  handler.extractErrors(result)\n                : result.errors;\n              if (errors) {\n                retriedResult = errorHandler({\n                  error: new CombinedGraphQLErrors(result, errors),\n                  result,\n                  operation,\n                  forward,\n                });\n              } else if (graphQLResultHasProtocolErrors(result)) {\n                retriedResult = errorHandler({\n                  error: result.extensions[PROTOCOL_ERRORS_SYMBOL],\n                  result,\n                  operation,\n                  forward,\n                });\n              }\n\n              retriedSub = retriedResult?.subscribe(observer);\n\n              if (!retriedSub) {\n                observer.next(result);\n              }\n            },\n            error: (error) => {\n              retriedResult = errorHandler({\n                operation,\n                error: toErrorLike(error),\n                forward,\n              });\n              retriedSub = retriedResult?.subscribe(observer);\n\n              if (!retriedSub) {\n                observer.error(error);\n              }\n            },\n            complete: () => {\n              // disable the previous sub from calling complete on observable\n              // if retry is in flight.\n              if (!retriedResult) {\n                observer.complete();\n              }\n            },\n          });\n        } catch (e) {\n          errorHandler({ error: toErrorLike(e), operation, forward });\n          observer.error(e);\n        }\n\n        return () => {\n          if (sub) sub.unsubscribe();\n          if (retriedSub) retriedSub.unsubscribe();\n        };\n      });\n    });\n  }\n}\n"]}

package/link/http/BaseHttpLink.d.ts

@@ -1,6 +1,260 @@
+import type { ASTNode, print } from "graphql";
 import { ApolloLink } from "@apollo/client/link";
-import type { HttpLink } from "./HttpLink.js";
+export declare namespace BaseHttpLink {
+    /**
+     * Options passed to `BaseHttpLink` through [request context](https://apollographql.com/docs/react/api/link/introduction#managing-context). Previous
+     * non-terminating links in the link chain also can set these values to
+     * customize the behavior of `BaseHttpLink` for each operation.
+     *
+     * > [!NOTE]
+     * > Some of these values can also be provided to the `HttpLink` constructor.
+     * > If a value is provided to both, the value in `context` takes precedence.
+     */
+    interface ContextOptions {
+        /**
+        * The URL of the GraphQL endpoint to send requests to. Can also be a
+        * function that accepts an `ApolloLink.Operation` object and returns the
+        * string URL to use for that operation.
+        * 
+        * @defaultValue "/graphql"
+        */
+        uri?: string | BaseHttpLink.UriFunction;
+        /**
+        * An object representing headers to include in every HTTP request.
+        * 
+        * @example
+        * 
+        * ```json
+        * {
+        *   "Authorization": "Bearer 1234"
+        * }
+        * ```
+        */
+        headers?: Record<string, string>;
+        /**
+        * The credentials policy to use for each `fetch` call.
+        */
+        credentials?: RequestCredentials;
+        /**
+        * Any overrides of the fetch options argument to pass to the fetch call.
+        * 
+        * An object containing options to use for each call to `fetch`. If a
+        * particular option is not included in this object, the default value of
+        * that option is used.
+        * 
+        * > [!NOTE]
+        * > If you set `fetchOptions.method` to `GET`, `HttpLink` follows [standard
+        * > GraphQL HTTP GET encoding](http://graphql.org/learn/serving-over-http/#get-request).
+        * 
+        * See [available options](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/fetch#Parameters)
+        */
+        fetchOptions?: RequestInit;
+        /**
+         * An object that configures advanced functionality, such as support for
+         * persisted queries.
+         */
+        http?: BaseHttpLink.HttpOptions;
+    }
+    /**
+     * Options passed to `BaseHttpLink` through the `http` property of a request
+     * context.
+     */
+    interface HttpOptions {
+        /**
+        * If `true`, includes the `extensions` field in operations sent to your
+        * GraphQL endpoint.
+        * 
+        * @defaultValue true
+        */
+        includeExtensions?: boolean;
+        /**
+         * If `false`, the GraphQL query string is not included in the request. Set
+         * this option if you're sending a request that uses a [persisted query](https://www.apollographql.com/docs/react/api/link/persisted-queries/).
+         *
+         * @defaultValue `true`
+         */
+        includeQuery?: boolean;
+        /**
+        * If `true`, header names won't be automatically normalized to lowercase.
+        * This allows for non-http-spec-compliant servers that might expect
+        * capitalized header names.
+        * 
+        * @defaultValue false
+        */
+        preserveHeaderCase?: boolean;
+        /**
+         * A list of additional `accept` headers to include in the request,
+         * as defined in https://datatracker.ietf.org/doc/html/rfc7231#section-5.3.2
+         *
+         * @example
+         *
+         * ```json
+         * ["application/custom+json;q=1.0"]
+         * ```
+         */
+        accept?: string[];
+    }
+    namespace Shared {
+        /** These options are shared between `BaseHttpLink` and `BaseBatchHttpLink` */
+        interface Options {
+            /**
+             * The URL of the GraphQL endpoint to send requests to. Can also be a
+             * function that accepts an `ApolloLink.Operation` object and returns the
+             * string URL to use for that operation.
+             *
+             * @defaultValue "/graphql"
+             */
+            uri?: string | BaseHttpLink.UriFunction;
+            /**
+             * If `true`, includes the `extensions` field in operations sent to your
+             * GraphQL endpoint.
+             *
+             * @defaultValue true
+             */
+            includeExtensions?: boolean;
+            /**
+             * A function to use instead of calling the [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch) directly
+             * when sending HTTP requests to your GraphQL endpoint. The function must
+             * conform to the signature of `fetch`.
+             *
+             * By default, the Fetch API is used unless it isn't available in your
+             * runtime environment.
+             *
+             * See [Customizing `fetch`](https://apollographql.com/docs/react/api/link/introduction#customizing-fetch).
+             */
+            fetch?: typeof fetch;
+            /**
+             * An object representing headers to include in every HTTP request.
+             *
+             * @example
+             *
+             * ```json
+             * {
+             *   "Authorization": "Bearer 1234"
+             * }
+             * ```
+             */
+            headers?: Record<string, string>;
+            /**
+             * If `true`, header names won't be automatically normalized to lowercase.
+             * This allows for non-http-spec-compliant servers that might expect
+             * capitalized header names.
+             *
+             * @defaultValue false
+             */
+            preserveHeaderCase?: boolean;
+            /**
+             * The credentials policy to use for each `fetch` call.
+             */
+            credentials?: RequestCredentials;
+            /**
+             * Any overrides of the fetch options argument to pass to the fetch call.
+             *
+             * An object containing options to use for each call to `fetch`. If a
+             * particular option is not included in this object, the default value of
+             * that option is used.
+             *
+             * > [!NOTE]
+             * > If you set `fetchOptions.method` to `GET`, `HttpLink` follows [standard
+             * > GraphQL HTTP GET encoding](http://graphql.org/learn/serving-over-http/#get-request).
+             *
+             * See [available options](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/fetch#Parameters)
+             */
+            fetchOptions?: RequestInit;
+            /**
+             * If `true`, unused variables from the operation will not be stripped from
+             * the request and will instead be sent to the GraphQL endpoint.
+             *
+             * @remarks
+             * Unused variables are likely to trigger server-side validation errors,
+             * per https://spec.graphql.org/draft/#sec-All-Variables-Used.
+             * `includeUnusedVariables` can be useful if your server deviates
+             * from the GraphQL specification by not strictly enforcing that rule.
+             *
+             * @defaultValue false
+             */
+            includeUnusedVariables?: boolean;
+            /**
+             * A function to use when transforming a GraphQL document into a string. It
+             * accepts an `ASTNode` (typically a `DocumentNode`) and the original `print`
+             * function as arguments, and is expected to return a string. This option
+             * enables you to, for example, use `stripIgnoredCharacters` to remove
+             * whitespace from queries.
+             *
+             * By default the [GraphQL `print` function](https://graphql.org/graphql-js/language/#print) is used.
+             *
+             * @example
+             *
+             * ```ts
+             * import { stripIgnoredCharacters } from "graphql";
+             *
+             * const httpLink = new HttpLink({
+             *   uri: "/graphql",
+             *   print: (ast, originalPrint) => stripIgnoredCharacters(originalPrint(ast)),
+             * });
+             * ```
+             */
+            print?: BaseHttpLink.Printer;
+        }
+    }
+    /**
+     * Options provided to the `BaseHttpLink` constructor.
+     *
+     * > [!NOTE]
+     * > Some of these options are also available to override in [request context](https://apollographql.com/docs/react/api/link/introduction#managing-context).
+     * > Context options override the options passed to the constructor. Treat
+     * > these options as default values that are used when the request context
+     * > does not override the value.
+     */
+    interface Options extends Shared.Options {
+        /**
+         * If `true`, the link uses an HTTP `GET` request when sending query
+         * operations to your GraphQL endpoint. Mutation operations continue to use
+         * `POST` requests. If you want all operations to use `GET` requests,
+         * set `fetchOptions.method` instead.
+         *
+         * @defaultValue false
+         */
+        useGETForQueries?: boolean;
+    }
+    interface Body {
+        query?: string;
+        operationName?: string;
+        variables?: Record<string, any>;
+        extensions?: Record<string, any>;
+    }
+    type Printer = (node: ASTNode, originalPrint: typeof print) => string;
+    type UriFunction = (operation: ApolloLink.Operation) => string;
+}
+/**
+ * `BaseHttpLink` is a terminating link that sends a GraphQL operation to a
+ * remote endpoint over HTTP. It serves as a base link to `HttpLink`.
+ *
+ * @remarks
+ *
+ * `BaseHttpLink` supports both POST and GET requests, and you can configure
+ * HTTP options on a per-operation basis. You can use these options for
+ * authentication, persisted queries, dynamic URIs, and other granular updates.
+ *
+ * > [!NOTE]
+ * > Prefer using `HttpLink` over `BaseHttpLink`. Use `BaseHttpLink` when you
+ * > need to disable client awareness features and would like to tree-shake
+ * > the implementation of `ClientAwarenessLink` out of your app bundle.
+ *
+ * @example
+ *
+ * ```ts
+ * import { BaseHttpLink } from "@apollo/client/link/http";
+ *
+ * const link = new BaseHttpLink({
+ *   uri: "http://localhost:4000/graphql",
+ *   headers: {
+ *     authorization: `Bearer ${token}`,
+ *   },
+ * });
+ * ```
+ */
 export declare class BaseHttpLink extends ApolloLink {
-    constructor(linkOptions?: HttpLink.Options);
+    constructor(options?: BaseHttpLink.Options);
 }
 //# sourceMappingURL=BaseHttpLink.d.ts.map

package/link/http/BaseHttpLink.js

@@ -10,13 +10,41 @@ import { parseAndCheckHttpResponse, readMultipartBody, } from "./parseAndCheckHt
 import { rewriteURIForGET } from "./rewriteURIForGET.js";
 import { defaultPrinter, fallbackHttpConfig, selectHttpOptionsAndBodyInternal, } from "./selectHttpOptionsAndBody.js";
 import { selectURI } from "./selectURI.js";
-import { serializeFetchParameter } from "./serializeFetchParameter.js";
 const backupFetch = maybe(() => fetch);
+function noop() { }
+/**
+ * `BaseHttpLink` is a terminating link that sends a GraphQL operation to a
+ * remote endpoint over HTTP. It serves as a base link to `HttpLink`.
+ *
+ * @remarks
+ *
+ * `BaseHttpLink` supports both POST and GET requests, and you can configure
+ * HTTP options on a per-operation basis. You can use these options for
+ * authentication, persisted queries, dynamic URIs, and other granular updates.
+ *
+ * > [!NOTE]
+ * > Prefer using `HttpLink` over `BaseHttpLink`. Use `BaseHttpLink` when you
+ * > need to disable client awareness features and would like to tree-shake
+ * > the implementation of `ClientAwarenessLink` out of your app bundle.
+ *
+ * @example
+ *
+ * ```ts
+ * import { BaseHttpLink } from "@apollo/client/link/http";
+ *
+ * const link = new BaseHttpLink({
+ *   uri: "http://localhost:4000/graphql",
+ *   headers: {
+ *     authorization: `Bearer ${token}`,
+ *   },
+ * });
+ * ```
+ */
 export class BaseHttpLink extends ApolloLink {
-    constructor(linkOptions = {}) {
+    constructor(options = {}) {
         let { uri = "/graphql", 
         // use default global fetch if nothing passed in
-        fetch: preferredFetch, print = defaultPrinter, includeExtensions, preserveHeaderCase, useGETForQueries, includeUnusedVariables = false, ...requestOptions } = linkOptions;
+        fetch: preferredFetch, print = defaultPrinter, includeExtensions, preserveHeaderCase, useGETForQueries, includeUnusedVariables = false, ...requestOptions } = options;
         if (__DEV__) {
             // Make sure at least one of preferredFetch, window.fetch, or backupFetch is
             // defined, so requests won't fail at runtime.
@@ -31,7 +59,7 @@ export class BaseHttpLink extends ApolloLink {
         super((operation) => {
             let chosenURI = selectURI(operation, uri);
             const context = operation.getContext();
-            const http = (context.http ??= {});
+            const http = { ...context.http };
             if (isSubscriptionOperation(operation.query)) {
                 http.accept = [
                     "multipart/mixed;boundary=graphql;subscriptionSpec=1.0",
@@ -39,7 +67,7 @@ export class BaseHttpLink extends ApolloLink {
                 ];
             }
             const contextConfig = {
-                http: context.http,
+                http,
                 options: context.fetchOptions,
                 credentials: context.credentials,
                 headers: context.headers,
@@ -49,11 +77,33 @@ export class BaseHttpLink extends ApolloLink {
             if (body.variables && !includeUnusedVariables) {
                 body.variables = filterOperationVariables(body.variables, operation.query);
             }
-            let controller;
-            if (!options.signal && typeof AbortController !== "undefined") {
-                controller = new AbortController();
-                options.signal = controller.signal;
+            let controller = new AbortController();
+            let cleanupController = () => {
+                controller = undefined;
+            };
+            if (options.signal) {
+                const externalSignal = options.signal;
+                // in an ideal world we could use `AbortSignal.any` here, but
+                // React Native uses https://github.com/mysticatea/abort-controller as
+                // a polyfill for `AbortController`, and it does not support `AbortSignal.any`.
+                const listener = () => {
+                    controller?.abort(externalSignal.reason);
+                };
+                externalSignal.addEventListener("abort", listener, { once: true });
+                cleanupController = () => {
+                    controller?.signal.removeEventListener("abort", cleanupController);
+                    controller = undefined;
+                    // on cleanup, we need to stop listening to `options.signal` to avoid memory leaks
+                    externalSignal.removeEventListener("abort", listener);
+                    cleanupController = noop;
+                };
+                // react native also does not support the addEventListener `signal` option
+                // so we have to simulate that ourself
+                controller.signal.addEventListener("abort", cleanupController, {
+                    once: true,
+                });
             }
+            options.signal = controller.signal;
             if (useGETForQueries && !isMutationOperation(operation.query)) {
                 options.method = "GET";
             }
@@ -66,7 +116,7 @@ export class BaseHttpLink extends ApolloLink {
                     chosenURI = newURI;
                 }
                 else {
-                    options.body = serializeFetchParameter(body, "Payload");
+                    options.body = JSON.stringify(body);
                 }
                 // Prefer linkOptions.fetch (preferredFetch) if provided, and otherwise
                 // fall back to the *current* global window.fetch function (see issue
@@ -87,11 +137,11 @@ export class BaseHttpLink extends ApolloLink {
                     }
                 })
                     .then(() => {
-                    controller = undefined;
+                    cleanupController();
                     observer.complete();
                 })
                     .catch((err) => {
-                    controller = undefined;
+                    cleanupController();
                     observer.error(err);
                 });
                 return () => {
@@ -104,4 +154,4 @@ export class BaseHttpLink extends ApolloLink {
         });
     }
 }
-//# sourceMappingURL=BaseHttpLink.js.map
+//# sourceMappingURL=BaseHttpLink.js.map