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

package/__cjs/link/client-awareness/ClientAwarenessLink.d.cts

@@ -1,5 +1,24 @@
 import { ApolloLink } from "@apollo/client/link";
 export declare namespace ClientAwarenessLink {
+    /**
+     * Options passed to `ClientAwarenessLink` 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 `ClientAwarenessLink` for each operation.
+     *
+     * > [!NOTE]
+     * > Some of these values can also be provided to the `ClientAwarenessLink`
+     * > constructor. If a value is provided to both, the value in `context` takes
+     * > precedence.
+     */
+    interface ContextOptions {
+        /**
+        * Configures the "client awareness" feature.
+        * This feature allows you to identify distinct applications in Apollo Studio
+        * and Apollo Server logs (and other monitoring or analytics tools) by adding
+        * information about the your application to outgoing requests.
+        */
+        clientAwareness?: ClientAwarenessLink.ClientAwarenessOptions;
+    }
     interface ClientAwarenessOptions {
         /**
          * A custom name (e.g., `iOS`) that identifies this particular client among your set of clients. Apollo Server and Apollo Studio use this property as part of the [client awareness](https://www.apollographql.com/docs/apollo-server/monitoring/metrics#identifying-distinct-clients) feature.
@@ -21,8 +40,8 @@ export declare namespace ClientAwarenessLink {
          * If `name` and `version` are not provided, this option will be ignored.
          * (These options can either be set as part of the Apollo Client constructor call or when manually constructing a `HttpLink`, `BatchHttpLink` or `ClientAwarenessLink`.)
          *
-         * * If set to `"headers"`, `name` and `version` will be sent in the request headers as `apollographql-client-name` and `apollographql-client-version`, respectively.
-         * * If set to `false`, `name` and `version` will not be included in outgoing requests.
+         * - If set to `"headers"`, `name` and `version` will be sent in the request headers as `apollographql-client-name` and `apollographql-client-version`, respectively.
+         * - If set to `false`, `name` and `version` will not be included in outgoing requests.
          *
          * @defaultValue "headers"
          */
@@ -32,8 +51,8 @@ export declare namespace ClientAwarenessLink {
         /**
          * Determines how the the version information of Apollo Client is sent in outgoing requests.
          *
-         * * If set to `"extensions"`, library `name` and `version` will be sent in an object in the request extensions as `clientLibrary`.
-         * * If set to `false`, library name and version will not be included in outgoing requests.
+         * - If set to `"extensions"`, library `name` and `version` will be sent in an object in the request extensions as `clientLibrary`.
+         * - If set to `false`, library name and version will not be included in outgoing requests.
          *
          * @defaultValue "extensions"
          */
@@ -46,17 +65,50 @@ export declare namespace ClientAwarenessLink {
          * and Apollo Server logs (and other monitoring or analytics tools) by adding
          * information about the your application to outgoing requests.
          */
-        clientAwareness?: ClientAwarenessOptions;
+        clientAwareness?: ClientAwarenessLink.ClientAwarenessOptions;
         /**
          * Configures the "enhanced client awareness" feature.
          * This feature allows you to identify the version of the Apollo Client library
          * used in your application in Apollo Studio (and other monitoring or analytics tools)
          * by adding information about the Apollo Client library to outgoing requests.
          */
-        enhancedClientAwareness?: EnhancedClientAwarenessOptions;
+        enhancedClientAwareness?: ClientAwarenessLink.EnhancedClientAwarenessOptions;
     }
 }
+/**
+ * `ClientAwarenessLink` provides support for providing client awareness
+ * features.
+ *
+ * @remarks
+ *
+ * Client awareness adds identifying information about the client to HTTP
+ * requests for use with metrics reporting tools, such as [Apollo GraphOS](https://apollographql.com/docs/graphos/platform).
+ * It is included in the functionality of [`HttpLink`](https://apollographql.com/docs/react/api/link/apollo-link-http) by default.
+ *
+ * Client awareness distinguishes between user-provided client awareness
+ * (provided by the `clientAwareness` option) and enhanced client awareness
+ * (provided by the `enhancedClientAwareness` option). User-provided client
+ * awareness enables you to set a customized client name and version for
+ * identification in metrics reporting tools. Enhanced client awareness enables
+ * the identification of the Apollo Client package name and version.
+ *
+ * @example
+ *
+ * ```ts
+ * import { ClientAwarenessLink } from "@apollo/client/link/client-awareness";
+ *
+ * const link = new ClientAwarenessLink({
+ *   clientAwareness: {
+ *     name: "My Client",
+ *     version: "1",
+ *   },
+ *   enhancedClientAwareness: {
+ *     transport: "extensions",
+ *   },
+ * });
+ * ```
+ */
 export declare class ClientAwarenessLink extends ApolloLink {
-    constructor(constructorOptions?: ClientAwarenessLink.Options);
+    constructor(options?: ClientAwarenessLink.Options);
 }
 //# sourceMappingURL=ClientAwarenessLink.d.cts.map

package/__cjs/link/client-awareness/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../../src/link/client-awareness/index.ts"],"sourcesContent":["export { ClientAwarenessLink } from \"./ClientAwarenessLink.js\";\n"],"names":[],"mappings":";;;AAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAAS,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAS,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAA4B,EAA5B,EAAA,CAAA,CAAA;"}
+{"version":3,"file":"index.cjs","sources":["../../../../src/link/client-awareness/index.ts"],"sourcesContent":["export { ClientAwarenessLink } from \"./ClientAwarenessLink.js\";\n"],"names":[],"mappings":";;;AAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,4BAAA,CAAA;AAAS,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAS,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAA4B,EAA5B,EAAA,CAAA,CAAA;"}

package/__cjs/link/context/index.cjs

@@ -6,36 +6,59 @@ const rxjs_1 = require("rxjs");
 const link_1 = require("@apollo/client/link");
 /**
  * @deprecated
- * Use `SetContextLink` from `@apollo/client/link/context` instead.
+ * Use `SetContextLink` from `@apollo/client/link/context` instead. Note you
+ * will need to flip the arguments when using `SetContextLink` as `prevContext`
+ * is the first argument.
+ *
+ * ```ts
+ * new SetContextLink((prevContext, operation) => {
+ *   // ...
+ * });
+ * ```
  */
 function setContext(setter) {
-    return new SetContextLink(setter);
+    return new SetContextLink((prevContext, operation) => setter(operation, prevContext));
 }
+/**
+ * `SetContextLink` is a non-terminating link that allows you to modify the
+ * context of GraphQL operations before they're passed to the next link in the
+ * chain. This is commonly used for authentication, adding headers, and other
+ * request-time configuration.
+ *
+ * @example
+ *
+ * ```ts
+ * import { SetContextLink } from "@apollo/client/link/context";
+ *
+ * const link = new SetContextLink((prevContext, operation) => {
+ *   return {
+ *     credentials: "include",
+ *     // ...
+ *   };
+ * });
+ * ```
+ */
 class SetContextLink extends link_1.ApolloLink {
     constructor(setter) {
         super((operation, forward) => {
             const { ...request } = operation;
+            Object.defineProperty(request, "client", {
+                enumerable: false,
+                value: operation.client,
+            });
             return new rxjs_1.Observable((observer) => {
-                let handle;
                 let closed = false;
                 Promise.resolve(request)
-                    .then((req) => setter(req, operation.getContext()))
+                    .then((req) => setter(operation.getContext(), req))
                     .then(operation.setContext)
                     .then(() => {
-                    // if the observer is already closed, no need to subscribe.
-                    if (closed)
-                        return;
-                    handle = forward(operation).subscribe({
-                        next: observer.next.bind(observer),
-                        error: observer.error.bind(observer),
-                        complete: observer.complete.bind(observer),
-                    });
+                    if (!closed) {
+                        forward(operation).subscribe(observer);
+                    }
                 })
                     .catch(observer.error.bind(observer));
                 return () => {
                     closed = true;
-                    if (handle)
-                        handle.unsubscribe();
                 };
             });
         });

package/__cjs/link/context/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../../src/link/context/index.ts"],"sourcesContent":["import type { Subscription } from \"rxjs\";\nimport { Observable } from \"rxjs\";\n\nimport type { GraphQLRequest, OperationContext } from \"@apollo/client/link\";\nimport { ApolloLink } from \"@apollo/client/link\";\n\nexport type ContextSetter = (\n  operation: GraphQLRequest,\n  prevContext: OperationContext\n) => Promise<Partial<OperationContext>> | Partial<OperationContext>;\n\n/**\n * @deprecated\n * Use `SetContextLink` from `@apollo/client/link/context` instead.\n */\nexport function setContext(setter: ContextSetter) {\n  return new SetContextLink(setter);\n}\nexport class SetContextLink extends ApolloLink {\n  constructor(setter: ContextSetter) {\n    super((operation, forward) => {\n      const { ...request } = operation;\n\n      return new Observable((observer) => {\n        let handle: Subscription;\n        let closed = false;\n        Promise.resolve(request)\n          .then((req) => setter(req, operation.getContext()))\n          .then(operation.setContext)\n          .then(() => {\n            // if the observer is already closed, no need to subscribe.\n            if (closed) return;\n            handle = forward(operation).subscribe({\n              next: observer.next.bind(observer),\n              error: observer.error.bind(observer),\n              complete: observer.complete.bind(observer),\n            });\n          })\n          .catch(observer.error.bind(observer));\n\n        return () => {\n          closed = true;\n          if (handle) handle.unsubscribe();\n        };\n      });\n    });\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../../../../src/link/context/index.ts"],"sourcesContent":["import { Observable } from \"rxjs\";\n\nimport { ApolloLink } from \"@apollo/client/link\";\n\nexport declare namespace SetContextLink {\n  namespace SetContextLinkDocumentationTypes {\n    /**\n     * A function that returns an updated context object for an Apollo Link\n     * operation.\n     *\n     * The context setter function is called for each operation and allows you to\n     * modify the operation's context before it's passed to the next link in the\n     * chain. The returned context object is shallowly merged with the previous\n     * context object.\n     *\n     * @param prevContext - The previous context of the operation (e.g. the value\n     * of `operation.getContext()`)\n     * @param operation - The GraphQL operation being executed, without the\n     * `getContext` and `setContext` methods\n     * @returns A partial context object or a promise that resolves to a partial context object\n     */\n    export function ContextSetter(\n      prevContext: Readonly<ApolloLink.OperationContext>,\n      operation: SetContextLink.SetContextOperation\n    ):\n      | Promise<Partial<ApolloLink.OperationContext>>\n      | Partial<ApolloLink.OperationContext>;\n  }\n\n  /** {@inheritDoc @apollo/client/link/context!SetContextLink.SetContextLinkDocumentationTypes.ContextSetter:function(1)} */\n  export type ContextSetter = (\n    prevContext: Readonly<ApolloLink.OperationContext>,\n    operation: SetContextLink.SetContextOperation\n  ) =>\n    | Promise<Partial<ApolloLink.OperationContext>>\n    | Partial<ApolloLink.OperationContext>;\n\n  /**\n   * @deprecated\n   * Use `ContextSetter` instead. This type is used by the deprecated\n   * `setContext` function.\n   */\n  export type LegacyContextSetter = (\n    operation: SetContextLink.SetContextOperation,\n    prevContext: Readonly<ApolloLink.OperationContext>\n  ) =>\n    | Promise<Partial<ApolloLink.OperationContext>>\n    | Partial<ApolloLink.OperationContext>;\n\n  /**\n   * An `ApolloLink.Operation` object without the `getContext` and `setContext`\n   * methods. This prevents context setters from directly manipulating the\n   * context during the setter function execution.\n   */\n  export type SetContextOperation = Omit<\n    ApolloLink.Operation,\n    \"getContext\" | \"setContext\"\n  >;\n}\n\n/**\n * @deprecated\n * Use `SetContextLink` from `@apollo/client/link/context` instead. Note you\n * will need to flip the arguments when using `SetContextLink` as `prevContext`\n * is the first argument.\n *\n * ```ts\n * new SetContextLink((prevContext, operation) => {\n *   // ...\n * });\n * ```\n */\nexport function setContext(setter: SetContextLink.LegacyContextSetter) {\n  return new SetContextLink((prevContext, operation) =>\n    setter(operation, prevContext)\n  );\n}\n/**\n * `SetContextLink` is a non-terminating link that allows you to modify the\n * context of GraphQL operations before they're passed to the next link in the\n * chain. This is commonly used for authentication, adding headers, and other\n * request-time configuration.\n *\n * @example\n *\n * ```ts\n * import { SetContextLink } from \"@apollo/client/link/context\";\n *\n * const link = new SetContextLink((prevContext, operation) => {\n *   return {\n *     credentials: \"include\",\n *     // ...\n *   };\n * });\n * ```\n */\nexport class SetContextLink extends ApolloLink {\n  constructor(setter: SetContextLink.ContextSetter) {\n    super((operation, forward) => {\n      const { ...request } = operation as SetContextLink.SetContextOperation;\n\n      Object.defineProperty(request, \"client\", {\n        enumerable: false,\n        value: operation.client,\n      });\n\n      return new Observable((observer) => {\n        let closed = false;\n        Promise.resolve(request)\n          .then((req) => setter(operation.getContext(), req))\n          .then(operation.setContext)\n          .then(() => {\n            if (!closed) {\n              forward(operation).subscribe(observer);\n            }\n          })\n          .catch(observer.error.bind(observer));\n\n        return () => {\n          closed = true;\n        };\n      });\n    });\n  }\n}\n"],"names":[],"mappings":"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"}

package/__cjs/link/context/index.d.cts

@@ -1,12 +1,85 @@
-import type { GraphQLRequest, OperationContext } from "@apollo/client/link";
 import { ApolloLink } from "@apollo/client/link";
-export type ContextSetter = (operation: GraphQLRequest, prevContext: OperationContext) => Promise<Partial<OperationContext>> | Partial<OperationContext>;
+export declare namespace SetContextLink {
+    namespace SetContextLinkDocumentationTypes {
+        /**
+         * A function that returns an updated context object for an Apollo Link
+         * operation.
+         *
+         * The context setter function is called for each operation and allows you to
+         * modify the operation's context before it's passed to the next link in the
+         * chain. The returned context object is shallowly merged with the previous
+         * context object.
+         *
+         * @param prevContext - The previous context of the operation (e.g. the value
+         * of `operation.getContext()`)
+         * @param operation - The GraphQL operation being executed, without the
+         * `getContext` and `setContext` methods
+         * @returns A partial context object or a promise that resolves to a partial context object
+         */
+        function ContextSetter(prevContext: Readonly<ApolloLink.OperationContext>, operation: SetContextLink.SetContextOperation): Promise<Partial<ApolloLink.OperationContext>> | Partial<ApolloLink.OperationContext>;
+    }
+    /**
+    * A function that returns an updated context object for an Apollo Link
+    * operation.
+    * 
+    * The context setter function is called for each operation and allows you to
+    * modify the operation's context before it's passed to the next link in the
+    * chain. The returned context object is shallowly merged with the previous
+    * context object.
+    * 
+    * @param prevContext - The previous context of the operation (e.g. the value
+    * of `operation.getContext()`)
+    * @param operation - The GraphQL operation being executed, without the
+    * `getContext` and `setContext` methods
+    * @returns A partial context object or a promise that resolves to a partial context object
+    */
+    type ContextSetter = (prevContext: Readonly<ApolloLink.OperationContext>, operation: SetContextLink.SetContextOperation) => Promise<Partial<ApolloLink.OperationContext>> | Partial<ApolloLink.OperationContext>;
+    /**
+     * @deprecated
+     * Use `ContextSetter` instead. This type is used by the deprecated
+     * `setContext` function.
+     */
+    type LegacyContextSetter = (operation: SetContextLink.SetContextOperation, prevContext: Readonly<ApolloLink.OperationContext>) => Promise<Partial<ApolloLink.OperationContext>> | Partial<ApolloLink.OperationContext>;
+    /**
+     * An `ApolloLink.Operation` object without the `getContext` and `setContext`
+     * methods. This prevents context setters from directly manipulating the
+     * context during the setter function execution.
+     */
+    type SetContextOperation = Omit<ApolloLink.Operation, "getContext" | "setContext">;
+}
 /**
  * @deprecated
- * Use `SetContextLink` from `@apollo/client/link/context` instead.
+ * Use `SetContextLink` from `@apollo/client/link/context` instead. Note you
+ * will need to flip the arguments when using `SetContextLink` as `prevContext`
+ * is the first argument.
+ *
+ * ```ts
+ * new SetContextLink((prevContext, operation) => {
+ *   // ...
+ * });
+ * ```
+ */
+export declare function setContext(setter: SetContextLink.LegacyContextSetter): SetContextLink;
+/**
+ * `SetContextLink` is a non-terminating link that allows you to modify the
+ * context of GraphQL operations before they're passed to the next link in the
+ * chain. This is commonly used for authentication, adding headers, and other
+ * request-time configuration.
+ *
+ * @example
+ *
+ * ```ts
+ * import { SetContextLink } from "@apollo/client/link/context";
+ *
+ * const link = new SetContextLink((prevContext, operation) => {
+ *   return {
+ *     credentials: "include",
+ *     // ...
+ *   };
+ * });
+ * ```
  */
-export declare function setContext(setter: ContextSetter): SetContextLink;
 export declare class SetContextLink extends ApolloLink {
-    constructor(setter: ContextSetter);
+    constructor(setter: SetContextLink.ContextSetter);
 }
 //# sourceMappingURL=index.d.cts.map

package/__cjs/link/core/ApolloLink.cjs

@@ -7,81 +7,253 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApolloLink = void 0;
 const rxjs_1 = require("rxjs");
 const utils_1 = require("@apollo/client/link/utils");
+const environment_1 = require("@apollo/client/utilities/environment");
 const invariant_1 = require("@apollo/client/utilities/invariant");
-function passthrough(op, forward) {
-    return (forward ? forward(op) : rxjs_1.EMPTY);
-}
-function toLink(handler) {
-    return typeof handler === "function" ? new ApolloLink(handler) : handler;
-}
-function isTerminating(link) {
-    return link.request.length <= 1;
-}
+/**
+ * The base class for all links in Apollo Client. A link represents either a
+ * self-contained modification to a GraphQL operation or a side effect (such as
+ * logging).
+ *
+ * @remarks
+ *
+ * Links enable you to customize Apollo Client's request flow by composing
+ * together different pieces of functionality into a chain of links. Each
+ * link represents a specific capability, such as adding authentication headers,
+ * retrying failed requests, batching operations, or sending requests to a
+ * GraphQL server.
+ *
+ * Every link must define a request handler via its constructor or by extending
+ * this class and implementing the `request` method.
+ *
+ * @example
+ *
+ * ```ts
+ * import { ApolloLink } from "@apollo/client";
+ *
+ * const link = new ApolloLink((operation, forward) => {
+ *   console.log("Operation:", operation.operationName);
+ *   return forward(operation);
+ * });
+ * ```
+ */
 class ApolloLink {
+    /**
+     * Creates a link that completes immediately and does not emit a result.
+     *
+     * @example
+     *
+     * ```ts
+     * const link = ApolloLink.empty();
+     * ```
+     */
     static empty() {
         return new ApolloLink(() => rxjs_1.EMPTY);
     }
+    /**
+     * Composes multiple links into a single composed link that executes each
+     * provided link in serial order.
+     *
+     * @example
+     *
+     * ```ts
+     * import { from, HttpLink, ApolloLink } from "@apollo/client";
+     * import { RetryLink } from "@apollo/client/link/retry";
+     * import MyAuthLink from "../auth";
+     *
+     * const link = ApolloLink.from([
+     *   new RetryLink(),
+     *   new MyAuthLink(),
+     *   new HttpLink({ uri: "http://localhost:4000/graphql" }),
+     * ]);
+     * ```
+     *
+     * @param links - An array of `ApolloLink` instances or request handlers that
+     * are executed in serial order.
+     */
     static from(links) {
         if (links.length === 0)
             return ApolloLink.empty();
-        return links.map(toLink).reduce((x, y) => x.concat(y));
+        const [first, ...rest] = links;
+        return first.concat(...rest);
     }
-    static split(test, left, right) {
-        const leftLink = toLink(left);
-        const rightLink = toLink(right || new ApolloLink(passthrough));
-        let ret;
-        if (isTerminating(leftLink) && isTerminating(rightLink)) {
-            ret = new ApolloLink((operation) => {
-                return test(operation) ?
-                    leftLink.request(operation) || rxjs_1.EMPTY
-                    : rightLink.request(operation) || rxjs_1.EMPTY;
-            });
-        }
-        else {
-            ret = new ApolloLink((operation, forward) => {
-                return test(operation) ?
-                    leftLink.request(operation, forward) || rxjs_1.EMPTY
-                    : rightLink.request(operation, forward) || rxjs_1.EMPTY;
-            });
-        }
-        return Object.assign(ret, { left: leftLink, right: rightLink });
+    /**
+     * Creates a link that conditionally routes a request to different links.
+     *
+     * @example
+     *
+     * ```ts
+     * import { ApolloLink, HttpLink } from "@apollo/client";
+     *
+     * const link = ApolloLink.split(
+     *   (operation) => operation.getContext().version === 1,
+     *   new HttpLink({ uri: "http://localhost:4000/v1/graphql" }),
+     *   new HttpLink({ uri: "http://localhost:4000/v2/graphql" })
+     * );
+     * ```
+     *
+     * @param test - A predicate function that receives the current `operation`
+     * and returns a boolean indicating which link to execute. Returning `true`
+     * executes the `left` link. Returning `false` executes the `right` link.
+     *
+     * @param left - The link that executes when the `test` function returns
+     * `true`.
+     *
+     * @param right - The link that executes when the `test` function returns
+     * `false`. If the `right` link is not provided, the request is forwarded to
+     * the next link in the chain.
+     */
+    static split(test, left, right = new ApolloLink((op, forward) => forward(op))) {
+        const link = new ApolloLink((operation, forward) => {
+            const result = test(operation);
+            if (environment_1.__DEV__) {
+                if (typeof result !== "boolean") {
+                    __DEV__ && invariant_1.invariant.warn(61, result);
+                }
+            }
+            return result ?
+                left.request(operation, forward)
+                : right.request(operation, forward);
+        });
+        return Object.assign(link, { left, right });
     }
-    static execute(link, operation, context) {
-        return (link.request((0, utils_1.createOperation)(operation.context, (0, utils_1.transformOperation)((0, utils_1.validateOperation)(operation)), context)) || rxjs_1.EMPTY);
+    /**
+     * Executes a GraphQL request against a link. The `execute` function begins
+     * the request by calling the request handler of the link.
+     *
+     * @example
+     *
+     * ```ts
+     * const observable = ApolloLink.execute(link, { query, variables }, { client });
+     *
+     * observable.subscribe({
+     *   next(value) {
+     *     console.log("Received", value);
+     *   },
+     *   error(error) {
+     *     console.error("Oops got error", error);
+     *   },
+     *   complete() {
+     *     console.log("Request complete");
+     *   },
+     * });
+     * ```
+     *
+     * @param link - The `ApolloLink` instance to execute the request.
+     *
+     * @param request - The GraphQL request details, such as the `query` and
+     * `variables`.
+     *
+     * @param context - The execution context for the request, such as the
+     * `client` making the request.
+     */
+    static execute(link, request, context) {
+        return link.request((0, utils_1.createOperation)(request, context), () => {
+            if (environment_1.__DEV__) {
+                __DEV__ && invariant_1.invariant.warn(62);
+            }
+            return rxjs_1.EMPTY;
+        });
     }
-    static concat(first, second) {
-        const firstLink = toLink(first);
-        if (isTerminating(firstLink)) {
-            __DEV__ && invariant_1.invariant.warn(64, firstLink);
-            return firstLink;
-        }
-        const nextLink = toLink(second);
-        let ret;
-        if (isTerminating(nextLink)) {
-            ret = new ApolloLink((operation) => firstLink.request(operation, (op) => nextLink.request(op) || rxjs_1.EMPTY) ||
-                rxjs_1.EMPTY);
-        }
-        else {
-            ret = new ApolloLink((operation, forward) => {
-                return (firstLink.request(operation, (op) => {
-                    return nextLink.request(op, forward) || rxjs_1.EMPTY;
-                }) || rxjs_1.EMPTY);
-            });
-        }
-        return Object.assign(ret, { left: firstLink, right: nextLink });
+    /**
+     * Combines multiple links into a single composed link.
+     *
+     * @example
+     *
+     * ```ts
+     * const link = ApolloLink.concat(firstLink, secondLink, thirdLink);
+     * ```
+     *
+     * @param links - The links to concatenate into a single link. Each link will
+     * execute in serial order.
+     *
+     * @deprecated Use `ApolloLink.from` instead. `ApolloLink.concat` will be
+     * removed in a future major version.
+     */
+    static concat(...links) {
+        return ApolloLink.from(links);
     }
     constructor(request) {
         if (request)
             this.request = request;
     }
+    /**
+     * Concatenates a link that conditionally routes a request to different links.
+     *
+     * @example
+     *
+     * ```ts
+     * import { ApolloLink, HttpLink } from "@apollo/client";
+     *
+     * const previousLink = new ApolloLink((operation, forward) => {
+     *   // Handle the request
+     *
+     *   return forward(operation);
+     * });
+     *
+     * const link = previousLink.split(
+     *   (operation) => operation.getContext().version === 1,
+     *   new HttpLink({ uri: "http://localhost:4000/v1/graphql" }),
+     *   new HttpLink({ uri: "http://localhost:4000/v2/graphql" })
+     * );
+     * ```
+     *
+     * @param test - A predicate function that receives the current `operation`
+     * and returns a boolean indicating which link to execute. Returning `true`
+     * executes the `left` link. Returning `false` executes the `right` link.
+     *
+     * @param left - The link that executes when the `test` function returns
+     * `true`.
+     *
+     * @param right - The link that executes when the `test` function returns
+     * `false`. If the `right` link is not provided, the request is forwarded to
+     * the next link in the chain.
+     */
     split(test, left, right) {
-        return this.concat(ApolloLink.split(test, left, right || new ApolloLink(passthrough)));
+        return this.concat(ApolloLink.split(test, left, right));
     }
-    concat(next) {
-        return ApolloLink.concat(this, next);
+    /**
+     * Combines the link with other links into a single composed link.
+     *
+     * @example
+     *
+     * ```ts
+     * import { ApolloLink, HttpLink } from "@apollo/client";
+     *
+     * const previousLink = new ApolloLink((operation, forward) => {
+     *   // Handle the request
+     *
+     *   return forward(operation);
+     * });
+     *
+     * const link = previousLink.concat(
+     *   link1,
+     *   link2,
+     *   new HttpLink({ uri: "http://localhost:4000/graphql" })
+     * );
+     * ```
+     */
+    concat(...links) {
+        if (links.length === 0) {
+            return this;
+        }
+        return links.reduce(this.combine.bind(this), this);
     }
+    combine(left, right) {
+        const link = new ApolloLink((operation, forward) => {
+            return left.request(operation, (op) => right.request(op, forward));
+        });
+        return Object.assign(link, { left, right });
+    }
+    /**
+     * Runs the request handler for the provided operation.
+     *
+     * > [!NOTE]
+     * > This is called by the `ApolloLink.execute` function for you and should
+     * > not be called directly. Prefer using `ApolloLink.execute` to make the
+     * > request instead.
+     */
     request(operation, forward) {
-        throw (0, invariant_1.newInvariantError)(65);
+        throw (0, invariant_1.newInvariantError)(63);
     }
     /**
     * @internal