@apollo/client 4.0.11 → 4.0.12-beta.0

package/incremental/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/incremental/index.ts"],"sourcesContent":["export type { Incremental } from \"./types.js\";\nexport { NotImplementedHandler } from \"./handlers/notImplemented.js\";\nexport {\n  Defer20220824Handler,\n  Defer20220824Handler as GraphQL17Alpha2Handler,\n} from \"./handlers/defer20220824.js\";\n"],"names":[],"mappings":"AACA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAO,EAAE,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,EAAsC,CAAtC,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,CAAoE;SAElE,CADF,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAEE,CAFF,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,EAE0B,CAF1B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,SAGO,CAHP,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;"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/incremental/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,IAAI,sBAAsB,GAC/C,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC","sourcesContent":["export type { Incremental } from \"./types.js\";\nexport { NotImplementedHandler } from \"./handlers/notImplemented.js\";\nexport {\n  Defer20220824Handler,\n  Defer20220824Handler as GraphQL17Alpha2Handler,\n} from \"./handlers/defer20220824.js\";\nexport { GraphQL17Alpha9Handler } from \"./handlers/graphql17Alpha9.js\";\n"]}

package/incremental/types.d.ts

@@ -20,5 +20,14 @@ export declare namespace Incremental {
         hasNext: boolean;
         handle: (cacheData: TData | DeepPartial<TData> | undefined | null, chunk: Chunk) => FormattedExecutionResult<TData>;
     }
+    /**
+    * @internal
+    * 
+    * @deprecated This is an internal API and should not be used directly. This can be removed or changed at any time.
+    */
+    interface StreamFieldInfo {
+        isFirstChunk: boolean;
+        isLastChunk: boolean;
+    }
 }
 //# sourceMappingURL=types.d.ts.map

package/incremental/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/incremental/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  DocumentNode,\n  FormattedExecutionResult,\n  GraphQLFormattedError,\n} from \"graphql\";\n\nimport type { ApolloLink } from \"@apollo/client/link\";\nimport type { DeepPartial } from \"@apollo/client/utilities\";\n\nexport declare namespace Incremental {\n  export type Path = ReadonlyArray<string | number>;\n\n  /** @internal */\n  export interface Handler<\n    Chunk extends Record<string, unknown> = Record<string, unknown>,\n  > {\n    isIncrementalResult: (result: ApolloLink.Result<any>) => result is Chunk;\n    prepareRequest: (request: ApolloLink.Request) => ApolloLink.Request;\n    extractErrors: (\n      result: ApolloLink.Result<any>\n    ) => readonly GraphQLFormattedError[] | undefined | void;\n    startRequest: <TData extends Record<string, unknown>>(request: {\n      query: DocumentNode;\n    }) => IncrementalRequest<Chunk, TData>;\n  }\n\n  export interface IncrementalRequest<\n    Chunk extends Record<string, unknown>,\n    TData,\n  > {\n    hasNext: boolean;\n    handle: (\n      cacheData: TData | DeepPartial<TData> | undefined | null,\n      chunk: Chunk\n    ) => FormattedExecutionResult<TData>;\n  }\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/incremental/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  DocumentNode,\n  FormattedExecutionResult,\n  GraphQLFormattedError,\n} from \"graphql\";\n\nimport type { ApolloLink } from \"@apollo/client/link\";\nimport type { DeepPartial } from \"@apollo/client/utilities\";\n\nexport declare namespace Incremental {\n  export type Path = ReadonlyArray<string | number>;\n\n  /** @internal */\n  export interface Handler<\n    Chunk extends Record<string, unknown> = Record<string, unknown>,\n  > {\n    isIncrementalResult: (result: ApolloLink.Result<any>) => result is Chunk;\n    prepareRequest: (request: ApolloLink.Request) => ApolloLink.Request;\n    extractErrors: (\n      result: ApolloLink.Result<any>\n    ) => readonly GraphQLFormattedError[] | undefined | void;\n    startRequest: <TData extends Record<string, unknown>>(request: {\n      query: DocumentNode;\n    }) => IncrementalRequest<Chunk, TData>;\n  }\n\n  export interface IncrementalRequest<\n    Chunk extends Record<string, unknown>,\n    TData,\n  > {\n    hasNext: boolean;\n    handle: (\n      cacheData: TData | DeepPartial<TData> | undefined | null,\n      chunk: Chunk\n    ) => FormattedExecutionResult<TData>;\n  }\n\n  /** @internal */\n  export interface StreamFieldInfo {\n    isFirstChunk: boolean;\n    isLastChunk: boolean;\n  }\n}\n"]}

package/invariantErrorCodes.js

@@ -272,24 +272,24 @@ you have an infinite render loop in your application.`
     message: "No fragment named %s"
   },
 
-  53: {
+  55: {
     file: "@apollo/client/local-state/LocalState.js",
     message: "Could not resolve __typename on object %o returned from resolver '%s'. '__typename' needs to be returned to properly resolve child fields."
   },
 
-  54: {
+  56: {
     file: "@apollo/client/local-state/LocalState.js",
     condition: "fragment",
     message: `No fragment named %s`
   },
 
-  55: {
+  57: {
     file: "@apollo/client/local-state/LocalState.js",
     condition: "cache.fragmentMatches",
     message: "The configured cache does not support fragment matching which will lead to incorrect results when executing local resolvers. Please use a cache that implements `fragmetMatches`."
   },
 
-  57: {
+  59: {
     file: "@apollo/client/link/persisted-queries/index.js",
     condition: "options &&\n    (typeof options.sha256 === \"function\" ||\n        typeof options.generateHash === \"function\")",
 
@@ -298,13 +298,13 @@ you have an infinite render loop in your application.`
         "parameter."
   },
 
-  58: {
+  60: {
     file: "@apollo/client/link/persisted-queries/index.js",
     condition: "forward",
     message: "PersistedQueryLink cannot be the last link in the chain."
   },
 
-  59: {
+  61: {
     file: "@apollo/client/link/http/checkFetcher.js",
     condition: "fetcher || typeof fetch !== \"undefined\"",
 
@@ -322,24 +322,30 @@ const client = new ApolloClient({
     `
   },
 
-  60: {
+  62: {
     file: "@apollo/client/link/http/parseAndCheckHttpResponse.js",
     condition: "response.body && typeof response.body.getReader === \"function\"",
     message: "Unknown type for `response.body`. Please use a `fetch` implementation that is WhatWG-compliant and that uses WhatWG ReadableStreams for `body`."
   },
 
-  63: {
+  65: {
     file: "@apollo/client/link/core/ApolloLink.js",
     message: "request is not implemented"
   },
 
-  64: {
+  66: {
+    file: "@apollo/client/incremental/handlers/graphql17Alpha9.js",
+    condition: "pending",
+    message: "Could not find pending chunk for incremental value. Please file an issue for the Apollo Client team to investigate."
+  },
+
+  67: {
     file: "@apollo/client/incremental/handlers/notImplemented.js",
-    condition: "!hasDirectives([\"defer\"], request.query)",
-    message: "`@defer` is not supported without specifying an incremental handler. Please pass a handler as the `incrementalHandler` option to the `ApolloClient` constructor."
+    condition: "!hasDirectives([\"defer\", \"stream\"], request.query)",
+    message: "`@defer` and `@stream` are not supported without specifying an incremental handler. Please pass a handler as the `incrementalHandler` option to the `ApolloClient` constructor."
   },
 
-  65: {
+  68: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.cache",
 
@@ -348,7 +354,7 @@ const client = new ApolloClient({
         "For more information, please visit: https://go.apollo.dev/c/docs"
   },
 
-  66: {
+  69: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.link",
 
@@ -357,7 +363,7 @@ const client = new ApolloClient({
         "For more information, please visit: https://go.apollo.dev/c/docs"
   },
 
-  67: {
+  70: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.fetchPolicy !== \"cache-and-network\"",
 
@@ -367,7 +373,7 @@ const client = new ApolloClient({
         "using a different fetchPolicy, such as cache-first or network-only."
   },
 
-  68: {
+  71: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.fetchPolicy !== \"standby\"",
 
@@ -376,7 +382,7 @@ const client = new ApolloClient({
         "as cache-first or network-only."
   },
 
-  69: {
+  72: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.query",
 
@@ -384,164 +390,164 @@ const client = new ApolloClient({
         "in the query option."
   },
 
-  70: {
+  73: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "options.query.kind === \"Document\"",
     message: 'You must wrap the query string in a "gql" tag.'
   },
 
-  71: {
+  74: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "!options.returnPartialData",
     message: "returnPartialData option only supported on watchQuery."
   },
 
-  72: {
+  75: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "!options.pollInterval",
     message: "pollInterval option only supported on watchQuery."
   },
 
-  73: {
+  76: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "!options.notifyOnNetworkStatusChange",
     message: "notifyOnNetworkStatusChange option only supported on watchQuery."
   },
 
-  74: {
+  77: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "optionsWithDefaults.mutation",
     message: "The `mutation` option is required. Please provide a GraphQL document in the `mutation` option."
   },
 
-  75: {
+  78: {
     file: "@apollo/client/core/ApolloClient.js",
     condition: "optionsWithDefaults.fetchPolicy === \"network-only\" ||\n    optionsWithDefaults.fetchPolicy === \"no-cache\"",
     message: "Mutations only support 'network-only' or 'no-cache' fetch policies. The default 'network-only' behavior automatically writes mutation results to the cache. Passing 'no-cache' skips the cache write."
   },
 
-  77: {
+  80: {
     file: "@apollo/client/core/ObservableQuery.js",
     condition: "fetchPolicy === \"standby\"",
     message: "The `variablesUnknown` option can only be used together with a `standby` fetch policy."
   },
 
-  79: {
+  82: {
     file: "@apollo/client/core/ObservableQuery.js",
     condition: "this.options.fetchPolicy !== \"cache-only\"",
     message: "Cannot execute `fetchMore` for 'cache-only' query '%s'. Please use a different fetch policy."
   },
 
-  80: {
+  83: {
     file: "@apollo/client/core/ObservableQuery.js",
     condition: "updateQuery",
     message: "You must provide an `updateQuery` function when using `fetchMore` with a `no-cache` fetch policy."
   },
 
-  84: {
+  87: {
     file: "@apollo/client/core/QueryManager.js",
     message: "QueryManager stopped while query was in flight"
   },
 
-  85: {
+  88: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "this.localState",
     message: "Mutation '%s' contains `@client` fields with variables provided by `@export` but local state has not been configured."
   },
 
-  86: {
+  89: {
     file: "@apollo/client/core/QueryManager.js",
     message: "Store reset while query was in flight (not completed in link chain)"
   },
 
-  89: {
+  92: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "!this.getDocumentInfo(query).hasClientExports || this.localState",
     message: "Subscription '%s' contains `@client` fields with variables provided by `@export` but local state has not been configured."
   },
 
-  90: {
+  93: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "this.localState",
     message: "%s '%s' contains `@client` fields but local state has not been configured."
   },
 
-  91: {
+  94: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "!hasIncrementalDirective",
     message: "%s '%s' contains `@client` and `@defer` directives. These cannot be used together."
   },
 
-  92: {
+  95: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "this.localState",
     message: "Query '%s' contains `@client` fields with variables provided by `@export` but local state has not been configured."
   },
 
-  94: {
+  97: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "this.localState",
     message: "Query '%s' contains `@client` fields but local state has not been configured."
   },
 
-  95: {
+  98: {
     file: "@apollo/client/core/QueryManager.js",
     condition: "didEmitValue",
     message: "The link chain completed without emitting a value. This is likely unintentional and should be updated to emit a value before completing."
   },
 
-  96: {
+  99: {
     file: "@apollo/client/cache/inmemory/entityStore.js",
     condition: "typeof dataId === \"string\"",
     message: "store.merge expects a string ID"
   },
 
-  99: {
+  102: {
     file: "@apollo/client/cache/inmemory/key-extractor.js",
     condition: "extracted !== void 0",
     message: `Missing field '%s' while extracting keyFields from %s`
   },
 
-  100: {
+  103: {
     file: "@apollo/client/cache/inmemory/policies.js",
     condition: "!old || old === which",
     message: `Cannot change root %s __typename more than once`
   },
 
-  103: {
+  106: {
     file: "@apollo/client/cache/inmemory/policies.js",
     message: "Cannot automatically merge arrays"
   },
 
-  104: {
+  107: {
     file: "@apollo/client/cache/inmemory/readFromStore.js",
     message: `No fragment named %s`
   },
 
-  105: {
+  108: {
     file: "@apollo/client/cache/inmemory/readFromStore.js",
     condition: "!isReference(value)",
     message: `Missing selection set for object of type %s returned for query field %s`
   },
 
-  106: {
+  109: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
     message: `Could not identify object %s`
   },
 
-  108: {
+  111: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
     message: `No fragment named %s`
   }
 };
 
 export const devDebug = {
-  76: {
+  79: {
     file: "@apollo/client/core/ApolloClient.js",
     message: `In client.refetchQueries, Promise.all promise rejected with error %o`
   },
 
-  83: {
+  86: {
     file: "@apollo/client/core/ObservableQuery.js",
     message: `Missing cache result fields: %o`
   }
@@ -577,30 +583,40 @@ export const devWarn = {
 
   50: {
     file: "@apollo/client/local-state/LocalState.js",
-    message: "The '%s' resolver returned `undefined` instead of a value. This is likely a bug in the resolver. If you didn't mean to return a value, return `null` instead."
+    message: "The '%s' field resolves the value from the cache, for example from a 'read' function, but a 'no-cache' fetch policy was used. The field value has been set to `null`. Either define a local resolver or use a fetch policy that uses the cache to ensure the field is resolved correctly."
   },
 
   51: {
     file: "@apollo/client/local-state/LocalState.js",
-    message: "The '%s' field had no cached value and only forced resolvers were run. The value was set to `null`."
+    message: "Could not find a resolver for the '%s' field nor does the cache resolve the field. The field value has been set to `null`. Either define a resolver for the field or ensure the cache can resolve the value, for example, by adding a 'read' function to a field policy in 'InMemoryCache'."
   },
 
   52: {
+    file: "@apollo/client/local-state/LocalState.js",
+    message: "The '%s' resolver returned `undefined` instead of a value. This is likely a bug in the resolver. If you didn't mean to return a value, return `null` instead."
+  },
+
+  53: {
+    file: "@apollo/client/local-state/LocalState.js",
+    message: "The '%s' field had no cached value and only forced resolvers were run. The value was set to `null`."
+  },
+
+  54: {
     file: "@apollo/client/local-state/LocalState.js",
     message: "The '%s' field on object %o returned `undefined` instead of a value. The parent resolver did not include the property in the returned value and there was no resolver defined for the field."
   },
 
-  56: {
+  58: {
     file: "@apollo/client/link/ws/index.js",
     message: "`WebSocketLink` uses the deprecated and unmaintained `subscriptions-transport-ws` library. This link is no longer maintained and will be removed in a future major version of Apollo Client. We recommend switching to `GraphQLWsLink` which uses the `graphql-ws` library to send GraphQL operations through WebSocket connections (https://the-guild.dev/graphql/ws)."
   },
 
-  61: {
+  63: {
     file: "@apollo/client/link/core/ApolloLink.js",
     message: "[ApolloLink.split]: The test function returned a non-boolean value which could result in subtle bugs (e.g. such as using an `async` function which always returns a truthy value). Got `%o`."
   },
 
-  62: {
+  64: {
     file: "@apollo/client/link/core/ApolloLink.js",
 
     message: "The terminating link provided to `ApolloLink.execute` called `forward` instead of handling the request. " +
@@ -609,34 +625,34 @@ export const devWarn = {
         "If you are using a split link, ensure each branch contains a terminating link that handles the request."
   },
 
-  78: {
+  81: {
     file: "@apollo/client/core/ObservableQuery.js",
 
     message: `Called refetch(%o) for query %o, which does not declare a $variables variable.
 Did you mean to call refetch(variables) instead of refetch({ variables })?`
   },
 
-  82: {
+  85: {
     file: "@apollo/client/core/ObservableQuery.js",
     message: "Cannot poll on 'cache-only' query '%s' and as such, polling is disabled. Please use a different fetch policy."
   },
 
-  87: {
+  90: {
     file: "@apollo/client/core/QueryManager.js",
     message: `Unknown query named "%s" requested in refetchQueries options.include array`
   },
 
-  88: {
+  91: {
     file: "@apollo/client/core/QueryManager.js",
     message: `Unknown anonymous query requested in refetchQueries options.include array`
   },
 
-  93: {
+  96: {
     file: "@apollo/client/core/QueryManager.js",
     message: '[%s]: Fragments masked by data masking are inaccessible when using fetch policy "no-cache". Please add `@unmask` to each fragment spread to access the data.'
   },
 
-  97: {
+  100: {
     file: "@apollo/client/cache/inmemory/entityStore.js",
 
     message: "cache.modify: You are trying to write a Reference that is not part of the store: %o\n" +
@@ -644,24 +660,24 @@ Did you mean to call refetch(variables) instead of refetch({ variables })?`
         "`toReference(object, true)`"
   },
 
-  98: {
+  101: {
     file: "@apollo/client/cache/inmemory/entityStore.js",
 
     message: "cache.modify: Writing an array with a mix of both References and Objects will not result in the Objects being normalized correctly.\n" +
         "Please convert the object instance %o to a Reference before writing it to the cache by calling `toReference(object, true)`."
   },
 
-  101: {
+  104: {
     file: "@apollo/client/cache/inmemory/policies.js",
     message: `Inferring subtype %s of supertype %s`
   },
 
-  102: {
+  105: {
     file: "@apollo/client/cache/inmemory/policies.js",
     message: `Undefined 'from' passed to readField with arguments %s`
   },
 
-  109: {
+  112: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
 
     message: `Cache data may be lost when replacing the %s field of a %s object.
@@ -680,7 +696,7 @@ For more information about these options, please refer to the documentation:
 `
   },
 
-  110: {
+  113: {
     file: "@apollo/client/cache/core/cache.js",
     message: "Could not identify object passed to `from` for '%s' fragment, either because the object is non-normalized or the key fields are missing. If you are masking this object, please ensure the key fields are requested by the parent object."
   }
@@ -697,12 +713,12 @@ export const devError = {
     message: "The result of getSnapshot should be cached to avoid an infinite loop"
   },
 
-  81: {
+  84: {
     file: "@apollo/client/core/ObservableQuery.js",
     message: "Unhandled GraphQL subscription error"
   },
 
-  107: {
+  110: {
     file: "@apollo/client/cache/inmemory/writeToStore.js",
     message: `Missing field '%s' while writing result %o`
   }

package/legacyEntryPoints/utilities/internal/ponyfills/index.d.ts

@@ -0,0 +1 @@
+export * from "@apollo/client/utilities/internal/ponyfills";

package/legacyEntryPoints/utilities/internal/ponyfills/index.js

@@ -0,0 +1 @@
+export * from "@apollo/client/utilities/internal/ponyfills";

package/legacyEntryPoints/utilities/internal/ponyfills/ponyfills.cjs

@@ -0,0 +1 @@
+module.exports = require("@apollo/client/utilities/internal/ponyfills");

package/legacyEntryPoints/utilities/internal/ponyfills/ponyfills.d.cts

@@ -0,0 +1 @@
+export * from "@apollo/client/utilities/internal/ponyfills";

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

@@ -56,7 +56,7 @@ export declare namespace ClientAwarenessLink {
          *
          * @defaultValue "extensions"
          */
-        transport?: "extensions" | false;
+        transport?: "headers" | "extensions" | false;
     }
     interface Options {
         /**

package/link/client-awareness/ClientAwarenessLink.js

@@ -42,7 +42,7 @@ export class ClientAwarenessLink extends ApolloLink {
             {
                 const { name, version, transport = "headers", } = compact({}, clientOptions.clientAwareness, options.clientAwareness, context.clientAwareness);
                 if (transport === "headers") {
-                    operation.setContext(({ headers, extensions }) => {
+                    operation.setContext(({ headers }) => {
                         return {
                             headers: compact(
                             // setting these first so that they can be overridden by user-provided headers
@@ -66,6 +66,18 @@ export class ClientAwarenessLink extends ApolloLink {
                         },
                     }, 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);
         });

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

@@ -1 +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,UAAU,EAAE,EAAE,EAAE;wBAC/C,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;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?: \"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, extensions }) => {\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\n      return forward(operation);\n    });\n  }\n}\n"]}
+{"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/core/ApolloLink.js

@@ -100,7 +100,7 @@ export class ApolloLink {
             const result = test(operation);
             if (__DEV__) {
                 if (typeof result !== "boolean") {
-                    __DEV__ && invariant.warn(61, result);
+                    __DEV__ && invariant.warn(63, result);
                 }
             }
             return result ?
@@ -142,7 +142,7 @@ export class ApolloLink {
     static execute(link, request, context) {
         return link.request(createOperation(request, context), () => {
             if (__DEV__) {
-                __DEV__ && invariant.warn(62);
+                __DEV__ && invariant.warn(64);
             }
             return EMPTY;
         });
@@ -246,7 +246,7 @@ export class ApolloLink {
      * > request instead.
      */
     request(operation, forward) {
-        throw newInvariantError(63);
+        throw newInvariantError(65);
     }
     /**
     * @internal

package/link/error/index.d.ts

@@ -62,7 +62,7 @@ export declare function onError(errorHandler: ErrorLink.ErrorHandler): ErrorLink
  * @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
+ * moving back up your [link chain](https://apollographql.com/docs/react/api/link/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

package/link/error/index.js

@@ -15,7 +15,7 @@ export function onError(errorHandler) {
  * @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
+ * moving back up your [link chain](https://apollographql.com/docs/react/api/link/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