@depup/apollo__client 4.1.6-depup.0

package/link/batch-http/batchHttpLink.d.ts

@@ -0,0 +1,49 @@
+import { ApolloLink } from "@apollo/client/link";
+import { ClientAwarenessLink } from "@apollo/client/link/client-awareness";
+import { BaseBatchHttpLink } from "./BaseBatchHttpLink.js";
+export declare namespace BatchHttpLink {
+    /**
+     * Options provided to the `BatchHttpLink` constructor.
+     */
+    interface Options extends BaseBatchHttpLink.Options, ClientAwarenessLink.Options {
+    }
+    /**
+     * Options passed to `BatchHttpLink` 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 `BatchHttpLink` for each operation.
+     *
+     * > [!NOTE]
+     * > Some of these values can also be provided to the `BatchHttpLink` constructor.
+     * > If a value is provided to both, the value in `context` takes precedence.
+     */
+    interface ContextOptions extends BaseBatchHttpLink.ContextOptions, ClientAwarenessLink.ContextOptions {
+    }
+}
+/**
+ * `BatchHttpLink` is a terminating link that batches array of individual
+ * GraphQL operations into a single HTTP request that's sent to a single GraphQL
+ * endpoint. It combines the functionality of `BaseBatchHttpLink` and
+ * `ClientAwarenessLink` into a single link.
+ *
+ * @remarks
+ *
+ * If you use `BatchHttpLink` instead of `HttpLink` as your terminating link,
+ * Apollo Client automatically batches executed GraphQL operations and transmits
+ * them to your server according to the batching options you provide.
+ *
+ * @example
+ *
+ * ```ts
+ * import { BatchHttpLink } from "@apollo/client/link/batch-http";
+ *
+ * const link = new BatchHttpLink({
+ *   uri: "http://localhost:4000/graphql",
+ *   batchMax: 5, // No more than 5 operations per batch
+ *   batchInterval: 20, // Wait no more than 20ms after first batched operation
+ * });
+ * ```
+ */
+export declare class BatchHttpLink extends ApolloLink {
+    constructor(options?: BatchHttpLink.Options);
+}
+//# sourceMappingURL=batchHttpLink.d.ts.map

package/link/batch-http/batchHttpLink.js

@@ -0,0 +1,38 @@
+import { ApolloLink } from "@apollo/client/link";
+import { ClientAwarenessLink } from "@apollo/client/link/client-awareness";
+import { BaseBatchHttpLink } from "./BaseBatchHttpLink.js";
+/**
+ * `BatchHttpLink` is a terminating link that batches array of individual
+ * GraphQL operations into a single HTTP request that's sent to a single GraphQL
+ * endpoint. It combines the functionality of `BaseBatchHttpLink` and
+ * `ClientAwarenessLink` into a single link.
+ *
+ * @remarks
+ *
+ * If you use `BatchHttpLink` instead of `HttpLink` as your terminating link,
+ * Apollo Client automatically batches executed GraphQL operations and transmits
+ * them to your server according to the batching options you provide.
+ *
+ * @example
+ *
+ * ```ts
+ * import { BatchHttpLink } from "@apollo/client/link/batch-http";
+ *
+ * const link = new BatchHttpLink({
+ *   uri: "http://localhost:4000/graphql",
+ *   batchMax: 5, // No more than 5 operations per batch
+ *   batchInterval: 20, // Wait no more than 20ms after first batched operation
+ * });
+ * ```
+ */
+export class BatchHttpLink extends ApolloLink {
+    constructor(options = {}) {
+        const { left, right, request } = ApolloLink.from([
+            new ClientAwarenessLink(options),
+            new BaseBatchHttpLink(options),
+        ]);
+        super(request);
+        Object.assign(this, { left, right });
+    }
+}
+//# sourceMappingURL=batchHttpLink.js.map

package/link/batch-http/batchHttpLink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batchHttpLink.js","sourceRoot":"","sources":["../../../src/link/batch-http/batchHttpLink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAG3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAwB3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,UAAiC,EAAE;QAC7C,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC;YAC/C,IAAI,mBAAmB,CAAC,OAAO,CAAC;YAChC,IAAI,iBAAiB,CAAC,OAAO,CAAC;SAC/B,CAAC,CAAC;QACH,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACvC,CAAC;CACF","sourcesContent":["import { ApolloLink } from \"@apollo/client/link\";\nimport { ClientAwarenessLink } from \"@apollo/client/link/client-awareness\";\nimport { __DEV__ } from \"@apollo/client/utilities/environment\";\n\nimport { BaseBatchHttpLink } from \"./BaseBatchHttpLink.js\";\n\nexport declare namespace BatchHttpLink {\n  /**\n   * Options provided to the `BatchHttpLink` constructor.\n   */\n  export interface Options\n    extends BaseBatchHttpLink.Options,\n      ClientAwarenessLink.Options {}\n\n  /**\n   * Options passed to `BatchHttpLink` through [request context](https://apollographql.com/docs/react/api/link/introduction#managing-context). Previous\n   * non-terminating links in the link chain also can set these values to\n   * customize the behavior of `BatchHttpLink` for each operation.\n   *\n   * > [!NOTE]\n   * > Some of these values can also be provided to the `BatchHttpLink` constructor.\n   * > If a value is provided to both, the value in `context` takes precedence.\n   */\n  export interface ContextOptions\n    extends BaseBatchHttpLink.ContextOptions,\n      ClientAwarenessLink.ContextOptions {}\n}\n\n/**\n * `BatchHttpLink` is a terminating link that batches array of individual\n * GraphQL operations into a single HTTP request that's sent to a single GraphQL\n * endpoint. It combines the functionality of `BaseBatchHttpLink` and\n * `ClientAwarenessLink` into a single link.\n *\n * @remarks\n *\n * If you use `BatchHttpLink` instead of `HttpLink` as your terminating link,\n * Apollo Client automatically batches executed GraphQL operations and transmits\n * them to your server according to the batching options you provide.\n *\n * @example\n *\n * ```ts\n * import { BatchHttpLink } from \"@apollo/client/link/batch-http\";\n *\n * const link = new BatchHttpLink({\n *   uri: \"http://localhost:4000/graphql\",\n *   batchMax: 5, // No more than 5 operations per batch\n *   batchInterval: 20, // Wait no more than 20ms after first batched operation\n * });\n * ```\n */\nexport class BatchHttpLink extends ApolloLink {\n  constructor(options: BatchHttpLink.Options = {}) {\n    const { left, right, request } = ApolloLink.from([\n      new ClientAwarenessLink(options),\n      new BaseBatchHttpLink(options),\n    ]);\n    super(request);\n    Object.assign(this, { left, right });\n  }\n}\n"]}

package/link/batch-http/index.d.ts

@@ -0,0 +1,3 @@
+export { BaseBatchHttpLink } from "./BaseBatchHttpLink.js";
+export { BatchHttpLink } from "./batchHttpLink.js";
+//# sourceMappingURL=index.d.ts.map

package/link/batch-http/index.js

@@ -0,0 +1,3 @@
+export { BaseBatchHttpLink } from "./BaseBatchHttpLink.js";
+export { BatchHttpLink } from "./batchHttpLink.js";
+//# sourceMappingURL=index.js.map

package/link/batch-http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/link/batch-http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["export { BaseBatchHttpLink } from \"./BaseBatchHttpLink.js\";\nexport { BatchHttpLink } from \"./batchHttpLink.js\";\n"]}

package/link/client-awareness/ClientAwarenessLink.d.ts

@@ -0,0 +1,114 @@
+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.
+         *
+         * This option can either be set as part of the Apollo Client constructor call or when manually constructing a `HttpLink`, `BatchHttpLink` or `ClientAwarenessLink`.
+         */
+        name?: string;
+        /**
+         * A custom version that identifies the current version of this particular client (e.g., `1.2`). 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.
+         *
+         * This is **not** the version of Apollo Client that you are using, but rather any version string that helps you differentiate between versions of your client.
+         *
+         * This option can either be set as part of the Apollo Client constructor call or when manually constructing a `HttpLink`, `BatchHttpLink` or `ClientAwarenessLink`.
+         */
+        version?: string;
+        /**
+         * Determines how `name` and `version` are sent in outgoing requests.
+         *
+         * 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.
+         *
+         * @defaultValue "headers"
+         */
+        transport?: "headers" | false;
+    }
+    interface EnhancedClientAwarenessOptions {
+        /**
+         * 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.
+         *
+         * @defaultValue "extensions"
+         */
+        transport?: "headers" | "extensions" | false;
+    }
+    interface Options {
+        /**
+         * 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;
+        /**
+         * 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?: 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(options?: ClientAwarenessLink.Options);
+}
+//# sourceMappingURL=ClientAwarenessLink.d.ts.map

package/link/client-awareness/ClientAwarenessLink.js

@@ -0,0 +1,86 @@
+import { ApolloLink } from "@apollo/client/link";
+import { compact } from "@apollo/client/utilities/internal";
+/**
+ * `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 class ClientAwarenessLink extends ApolloLink {
+    constructor(options = {}) {
+        super((operation, forward) => {
+            const client = operation.client;
+            const clientOptions = client["queryManager"].clientOptions;
+            const context = operation.getContext();
+            {
+                const { name, version, transport = "headers", } = compact({}, clientOptions.clientAwareness, options.clientAwareness, context.clientAwareness);
+                if (transport === "headers") {
+                    operation.setContext(({ headers }) => {
+                        return {
+                            headers: compact(
+                            // setting these first so that they can be overridden by user-provided headers
+                            {
+                                "apollographql-client-name": name,
+                                "apollographql-client-version": version,
+                            }, headers),
+                        };
+                    });
+                }
+            }
+            {
+                const { transport = "extensions" } = compact({}, clientOptions.enhancedClientAwareness, options.enhancedClientAwareness);
+                if (transport === "extensions") {
+                    operation.extensions = compact(
+                    // setting these first so that it can be overridden by user-provided extensions
+                    {
+                        clientLibrary: {
+                            name: "@apollo/client",
+                            version: client.version,
+                        },
+                    }, operation.extensions);
+                }
+                if (transport === "headers") {
+                    operation.setContext(({ headers }) => {
+                        return {
+                            headers: compact(
+                            // setting these first so that they can be overridden by user-provided headers
+                            {
+                                "apollographql-library-name": "@apollo/client",
+                                "apollographql-library-version": client.version,
+                            }, headers),
+                        };
+                    });
+                }
+            }
+            return forward(operation);
+        });
+    }
+}
+//# sourceMappingURL=ClientAwarenessLink.js.map

package/link/client-awareness/ClientAwarenessLink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientAwarenessLink.js","sourceRoot":"","sources":["../../../src/link/client-awareness/ClientAwarenessLink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AA4E5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACjD,YAAY,UAAuC,EAAE;QACnD,KAAK,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE;YAC3B,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;YAEhC,MAAM,aAAa,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,aAAa,CAAC;YAC3D,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC;YACvC,CAAC;gBACC,MAAM,EACJ,IAAI,EACJ,OAAO,EACP,SAAS,GAAG,SAAS,GACtB,GAAG,OAAO,CACT,EAAE,EACF,aAAa,CAAC,eAAe,EAC7B,OAAO,CAAC,eAAe,EACvB,OAAO,CAAC,eAAe,CACxB,CAAC;gBAEF,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;oBAC5B,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;wBACnC,OAAO;4BACL,OAAO,EAAE,OAAO;4BACd,8EAA8E;4BAC9E;gCACE,2BAA2B,EAAE,IAAI;gCACjC,8BAA8B,EAAE,OAAO;6BACxC,EACD,OAAO,CACR;yBACF,CAAC;oBACJ,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YACD,CAAC;gBACC,MAAM,EAAE,SAAS,GAAG,YAAY,EAAE,GAAG,OAAO,CAC1C,EAAE,EACF,aAAa,CAAC,uBAAuB,EACrC,OAAO,CAAC,uBAAuB,CAChC,CAAC;gBACF,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;oBAC/B,SAAS,CAAC,UAAU,GAAG,OAAO;oBAC5B,+EAA+E;oBAC/E;wBACE,aAAa,EAAE;4BACb,IAAI,EAAE,gBAAgB;4BACtB,OAAO,EAAE,MAAM,CAAC,OAAO;yBACxB;qBACF,EACD,SAAS,CAAC,UAAU,CACrB,CAAC;gBACJ,CAAC;gBAED,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;oBAC5B,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;wBACnC,OAAO;4BACL,OAAO,EAAE,OAAO;4BACd,8EAA8E;4BAC9E;gCACE,4BAA4B,EAAE,gBAAgB;gCAC9C,+BAA+B,EAAE,MAAM,CAAC,OAAO;6BAChD,EACD,OAAO,CACR;yBACF,CAAC;oBACJ,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { ApolloLink } from \"@apollo/client/link\";\nimport { compact } from \"@apollo/client/utilities/internal\";\n\nexport declare namespace ClientAwarenessLink {\n  /**\n   * Options passed to `ClientAwarenessLink` through [request context](https://apollographql.com/docs/react/api/link/introduction#managing-context). Previous\n   * non-terminating links in the link chain also can set these values to\n   * customize the behavior of `ClientAwarenessLink` for each operation.\n   *\n   * > [!NOTE]\n   * > Some of these values can also be provided to the `ClientAwarenessLink`\n   * > constructor. If a value is provided to both, the value in `context` takes\n   * > precedence.\n   */\n  export interface ContextOptions {\n    /** {@inheritDoc @apollo/client/link/client-awareness!ClientAwarenessLink.Options#clientAwareness:member} */\n    clientAwareness?: ClientAwarenessLink.ClientAwarenessOptions;\n  }\n\n  export interface ClientAwarenessOptions {\n    /**\n     * 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.\n     *\n     * This option can either be set as part of the Apollo Client constructor call or when manually constructing a `HttpLink`, `BatchHttpLink` or `ClientAwarenessLink`.\n     */\n    name?: string;\n    /**\n     * A custom version that identifies the current version of this particular client (e.g., `1.2`). 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.\n     *\n     * This is **not** the version of Apollo Client that you are using, but rather any version string that helps you differentiate between versions of your client.\n     *\n     * This option can either be set as part of the Apollo Client constructor call or when manually constructing a `HttpLink`, `BatchHttpLink` or `ClientAwarenessLink`.\n     */\n    version?: string;\n    /**\n     * Determines how `name` and `version` are sent in outgoing requests.\n     *\n     * If `name` and `version` are not provided, this option will be ignored.\n     * (These options can either be set as part of the Apollo Client constructor call or when manually constructing a `HttpLink`, `BatchHttpLink` or `ClientAwarenessLink`.)\n     *\n     * - If set to `\"headers\"`, `name` and `version` will be sent in the request headers as `apollographql-client-name` and `apollographql-client-version`, respectively.\n     * - If set to `false`, `name` and `version` will not be included in outgoing requests.\n     *\n     * @defaultValue \"headers\"\n     */\n    transport?: \"headers\" | false;\n  }\n  export interface EnhancedClientAwarenessOptions {\n    /**\n     * Determines how the the version information of Apollo Client is sent in outgoing requests.\n     *\n     * - If set to `\"extensions\"`, library `name` and `version` will be sent in an object in the request extensions as `clientLibrary`.\n     * - If set to `false`, library name and version will not be included in outgoing requests.\n     *\n     * @defaultValue \"extensions\"\n     */\n    transport?: \"headers\" | \"extensions\" | false;\n  }\n\n  export interface Options {\n    /**\n     * Configures the \"client awareness\" feature.\n     * This feature allows you to identify distinct applications in Apollo Studio\n     * and Apollo Server logs (and other monitoring or analytics tools) by adding\n     * information about the your application to outgoing requests.\n     */\n    clientAwareness?: ClientAwarenessLink.ClientAwarenessOptions;\n    /**\n     * Configures the \"enhanced client awareness\" feature.\n     * This feature allows you to identify the version of the Apollo Client library\n     * used in your application in Apollo Studio (and other monitoring or analytics tools)\n     * by adding information about the Apollo Client library to outgoing requests.\n     */\n    enhancedClientAwareness?: ClientAwarenessLink.EnhancedClientAwarenessOptions;\n  }\n}\n\n/**\n * `ClientAwarenessLink` provides support for providing client awareness\n * features.\n *\n * @remarks\n *\n * Client awareness adds identifying information about the client to HTTP\n * requests for use with metrics reporting tools, such as [Apollo GraphOS](https://apollographql.com/docs/graphos/platform).\n * It is included in the functionality of [`HttpLink`](https://apollographql.com/docs/react/api/link/apollo-link-http) by default.\n *\n * Client awareness distinguishes between user-provided client awareness\n * (provided by the `clientAwareness` option) and enhanced client awareness\n * (provided by the `enhancedClientAwareness` option). User-provided client\n * awareness enables you to set a customized client name and version for\n * identification in metrics reporting tools. Enhanced client awareness enables\n * the identification of the Apollo Client package name and version.\n *\n * @example\n *\n * ```ts\n * import { ClientAwarenessLink } from \"@apollo/client/link/client-awareness\";\n *\n * const link = new ClientAwarenessLink({\n *   clientAwareness: {\n *     name: \"My Client\",\n *     version: \"1\",\n *   },\n *   enhancedClientAwareness: {\n *     transport: \"extensions\",\n *   },\n * });\n * ```\n */\nexport class ClientAwarenessLink extends ApolloLink {\n  constructor(options: ClientAwarenessLink.Options = {}) {\n    super((operation, forward) => {\n      const client = operation.client;\n\n      const clientOptions = client[\"queryManager\"].clientOptions;\n      const context = operation.getContext();\n      {\n        const {\n          name,\n          version,\n          transport = \"headers\",\n        } = compact(\n          {},\n          clientOptions.clientAwareness,\n          options.clientAwareness,\n          context.clientAwareness\n        );\n\n        if (transport === \"headers\") {\n          operation.setContext(({ headers }) => {\n            return {\n              headers: compact(\n                // setting these first so that they can be overridden by user-provided headers\n                {\n                  \"apollographql-client-name\": name,\n                  \"apollographql-client-version\": version,\n                },\n                headers\n              ),\n            };\n          });\n        }\n      }\n      {\n        const { transport = \"extensions\" } = compact(\n          {},\n          clientOptions.enhancedClientAwareness,\n          options.enhancedClientAwareness\n        );\n        if (transport === \"extensions\") {\n          operation.extensions = compact(\n            // setting these first so that it can be overridden by user-provided extensions\n            {\n              clientLibrary: {\n                name: \"@apollo/client\",\n                version: client.version,\n              },\n            },\n            operation.extensions\n          );\n        }\n\n        if (transport === \"headers\") {\n          operation.setContext(({ headers }) => {\n            return {\n              headers: compact(\n                // setting these first so that they can be overridden by user-provided headers\n                {\n                  \"apollographql-library-name\": \"@apollo/client\",\n                  \"apollographql-library-version\": client.version,\n                },\n                headers\n              ),\n            };\n          });\n        }\n      }\n\n      return forward(operation);\n    });\n  }\n}\n"]}

package/link/client-awareness/index.d.ts

@@ -0,0 +1,2 @@
+export { ClientAwarenessLink } from "./ClientAwarenessLink.js";
+//# sourceMappingURL=index.d.ts.map

package/link/client-awareness/index.js

@@ -0,0 +1,2 @@
+export { ClientAwarenessLink } from "./ClientAwarenessLink.js";
+//# sourceMappingURL=index.js.map

package/link/client-awareness/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/link/client-awareness/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["export { ClientAwarenessLink } from \"./ClientAwarenessLink.js\";\n"]}

package/link/context/index.d.ts

@@ -0,0 +1,85 @@
+import { ApolloLink } from "@apollo/client/link";
+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. 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 class SetContextLink extends ApolloLink {
+    constructor(setter: SetContextLink.ContextSetter);
+}
+//# sourceMappingURL=index.d.ts.map

package/link/context/index.js

@@ -0,0 +1,63 @@
+import { Observable } from "rxjs";
+import { ApolloLink } from "@apollo/client/link";
+/**
+ * @deprecated
+ * 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 function setContext(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",
+ *     // ...
+ *   };
+ * });
+ * ```
+ */
+export class SetContextLink extends ApolloLink {
+    constructor(setter) {
+        super((operation, forward) => {
+            const { ...request } = operation;
+            Object.defineProperty(request, "client", {
+                enumerable: false,
+                value: operation.client,
+            });
+            return new Observable((observer) => {
+                let closed = false;
+                Promise.resolve(request)
+                    .then((req) => setter(operation.getContext(), req))
+                    .then(operation.setContext)
+                    .then(() => {
+                    if (!closed) {
+                        forward(operation).subscribe(observer);
+                    }
+                })
+                    .catch(observer.error.bind(observer));
+                return () => {
+                    closed = true;
+                };
+            });
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/link/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/link/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AA0DjD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,MAA0C;IACnE,OAAO,IAAI,cAAc,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE,CACnD,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAC/B,CAAC;AACJ,CAAC;AACD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C,YAAY,MAAoC;QAC9C,KAAK,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE;YAC3B,MAAM,EAAE,GAAG,OAAO,EAAE,GAAG,SAA+C,CAAC;YAEvE,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE;gBACvC,UAAU,EAAE,KAAK;gBACjB,KAAK,EAAE,SAAS,CAAC,MAAM;aACxB,CAAC,CAAC;YAEH,OAAO,IAAI,UAAU,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACjC,IAAI,MAAM,GAAG,KAAK,CAAC;gBACnB,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;qBACrB,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,GAAG,CAAC,CAAC;qBAClD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;qBAC1B,IAAI,CAAC,GAAG,EAAE;oBACT,IAAI,CAAC,MAAM,EAAE,CAAC;wBACZ,OAAO,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;oBACzC,CAAC;gBACH,CAAC,CAAC;qBACD,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAExC,OAAO,GAAG,EAAE;oBACV,MAAM,GAAG,IAAI,CAAC;gBAChB,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF","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"]}