@apollo/client 4.0.0-rc.8 → 4.0.0

package/link/retry/retryLink.js.map

@@ -1 +1 @@
-{"version":3,"file":"retryLink.js","sourceRoot":"","sources":["../../../src/link/retry/retryLink.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Subscription } from \"rxjs\";\nimport type { Observer } from \"rxjs\";\nimport { Observable } from \"rxjs\";\n\nimport type { ErrorLike } from \"@apollo/client\";\nimport {\n  graphQLResultHasProtocolErrors,\n  PROTOCOL_ERRORS_SYMBOL,\n  toErrorLike,\n} from \"@apollo/client/errors\";\nimport { ApolloLink } from \"@apollo/client/link\";\n\nimport { buildDelayFunction } from \"./delayFunction.js\";\nimport { buildRetryFunction } from \"./retryFunction.js\";\n\nexport declare namespace RetryLink {\n  export type DelayFunction = (\n    count: number,\n    operation: ApolloLink.Operation,\n    error: ErrorLike\n  ) => number;\n\n  export interface DelayOptions {\n    /**\n     * The number of milliseconds to wait before attempting the first retry.\n     *\n     * Delays will increase exponentially for each attempt. E.g. if this is\n     * set to 100, subsequent retries will be delayed by 200, 400, 800, etc,\n     * until they reach maxDelay.\n     *\n     * Note that if jittering is enabled, this is the _average_ delay.\n     *\n     * @defaultValue `300`\n     */\n    initial?: number;\n\n    /**\n     * The maximum number of milliseconds that the link should wait for any\n     * retry.\n     *\n     * @defaultValue `Infinity`\n     */\n    max?: number;\n\n    /**\n     * Whether delays between attempts should be randomized.\n     *\n     * This helps avoid thundering herd type situations by better distributing\n     * load during major outages.\n     *\n     * @defaultValue `true`\n     */\n    jitter?: boolean;\n  }\n\n  export type AttemptsFunction = (\n    count: number,\n    operation: ApolloLink.Operation,\n    error: ErrorLike\n  ) => boolean | Promise<boolean>;\n\n  export interface AttemptsOptions {\n    /**\n     * The max number of times to try a single operation before giving up. Pass\n     * `Infinity` for infinite retries.\n     *\n     * Note that this INCLUDES the initial request as part of the count.\n     * E.g. maxTries of 1 indicates no retrying should occur.\n     *\n     * @defaultValue `5`\n     */\n    max?: number;\n\n    /**\n     * Predicate function that determines whether a particular error should\n     * trigger a retry.\n     *\n     * For example, you may want to not retry 4xx class HTTP errors.\n     *\n     * @defaultValue `() => true`\n     */\n    retryIf?: (\n      error: ErrorLike,\n      operation: ApolloLink.Operation\n    ) => boolean | Promise<boolean>;\n  }\n\n  export interface Options {\n    /**\n     * Configuration for the delay strategy to use, or a custom delay strategy.\n     */\n    delay?: RetryLink.DelayOptions | RetryLink.DelayFunction;\n\n    /**\n     * Configuration for the retry strategy to use, or a custom retry strategy.\n     */\n    attempts?: RetryLink.AttemptsOptions | RetryLink.AttemptsFunction;\n  }\n}\n\n/**\n * Tracking and management of operations that may be (or currently are) retried.\n */\nclass RetryableOperation {\n  private retryCount: number = 0;\n  private currentSubscription: Subscription | null = null;\n  private timerId: ReturnType<typeof setTimeout> | undefined;\n\n  constructor(\n    private observer: Observer<ApolloLink.Result>,\n    private operation: ApolloLink.Operation,\n    private forward: ApolloLink.ForwardFunction,\n    private delayFor: RetryLink.DelayFunction,\n    private retryIf: RetryLink.AttemptsFunction\n  ) {\n    this.try();\n  }\n\n  /**\n   * Stop retrying for the operation, and cancel any in-progress requests.\n   */\n  public cancel() {\n    if (this.currentSubscription) {\n      this.currentSubscription.unsubscribe();\n    }\n    clearTimeout(this.timerId);\n    this.timerId = undefined;\n    this.currentSubscription = null;\n  }\n\n  private try() {\n    this.currentSubscription = this.forward(this.operation).subscribe({\n      next: (result) => {\n        if (graphQLResultHasProtocolErrors(result)) {\n          this.onError(result.extensions[PROTOCOL_ERRORS_SYMBOL], () =>\n            // Pretend like we never encountered this error and move the result\n            // along for Apollo Client core to handle this error.\n            this.observer.next(result)\n          );\n          // Unsubscribe from the current subscription to prevent the `complete`\n          // handler to be called as a result of the stream closing.\n          this.currentSubscription?.unsubscribe();\n          return;\n        }\n\n        this.observer.next(result);\n      },\n      error: (error) => this.onError(error, () => this.observer.error(error)),\n      complete: this.observer.complete.bind(this.observer),\n    });\n  }\n\n  private onError = async (error: unknown, onContinue: () => void) => {\n    this.retryCount += 1;\n    const errorLike = toErrorLike(error);\n\n    const shouldRetry = await this.retryIf(\n      this.retryCount,\n      this.operation,\n      errorLike\n    );\n    if (shouldRetry) {\n      this.scheduleRetry(\n        this.delayFor(this.retryCount, this.operation, errorLike)\n      );\n      return;\n    }\n\n    onContinue();\n  };\n\n  private scheduleRetry(delay: number) {\n    if (this.timerId) {\n      throw new Error(`RetryLink BUG! Encountered overlapping retries`);\n    }\n\n    this.timerId = setTimeout(() => {\n      this.timerId = undefined;\n      this.try();\n    }, delay);\n  }\n}\n\nexport class RetryLink extends ApolloLink {\n  private delayFor: RetryLink.DelayFunction;\n  private retryIf: RetryLink.AttemptsFunction;\n\n  constructor(options?: RetryLink.Options) {\n    super();\n    const { attempts, delay } = options || ({} as RetryLink.Options);\n    this.delayFor =\n      typeof delay === \"function\" ? delay : buildDelayFunction(delay);\n    this.retryIf =\n      typeof attempts === \"function\" ? attempts : buildRetryFunction(attempts);\n  }\n\n  public request(\n    operation: ApolloLink.Operation,\n    forward: ApolloLink.ForwardFunction\n  ): Observable<ApolloLink.Result> {\n    return new Observable((observer) => {\n      const retryable = new RetryableOperation(\n        observer,\n        operation,\n        forward,\n        this.delayFor,\n        this.retryIf\n      );\n      return () => {\n        retryable.cancel();\n      };\n    });\n  }\n}\n"]}
+{"version":3,"file":"retryLink.js","sourceRoot":"","sources":["../../../src/link/retry/retryLink.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Subscription } from \"rxjs\";\nimport type { Observer } from \"rxjs\";\nimport { Observable } from \"rxjs\";\n\nimport type { ErrorLike } from \"@apollo/client\";\nimport {\n  graphQLResultHasProtocolErrors,\n  PROTOCOL_ERRORS_SYMBOL,\n  toErrorLike,\n} from \"@apollo/client/errors\";\nimport { ApolloLink } from \"@apollo/client/link\";\n\nimport { buildDelayFunction } from \"./delayFunction.js\";\nimport { buildRetryFunction } from \"./retryFunction.js\";\n\nexport declare namespace RetryLink {\n  namespace RetryLinkDocumentationTypes {\n    /**\n     * A function used to determine whether to retry the current operation.\n     *\n     * @param attempt - The current attempt number\n     * @param operation - The current `ApolloLink.Operation` for the request\n     * @param error - The error that triggered the retry attempt\n     * @returns A boolean to indicate whether to retry the current operation\n     */\n    function AttemptsFunction(\n      attempt: number,\n      operation: ApolloLink.Operation,\n      error: ErrorLike\n    ): boolean | Promise<boolean>;\n\n    /**\n     * A function used to determine the delay for a retry attempt.\n     *\n     * @param attempt - The current attempt number\n     * @param operation - The current `ApolloLink.Operation` for the request\n     * @param error - The error that triggered the retry attempt\n     * @returns The delay in milliseconds before attempting the request again\n     */\n    function DelayFunction(\n      attempt: number,\n      operation: ApolloLink.Operation,\n      error: ErrorLike\n    ): number;\n  }\n\n  /** {@inheritDoc @apollo/client/link/retry!RetryLink.RetryLinkDocumentationTypes.DelayFunction:function(1)} */\n  export type DelayFunction = (\n    attempt: number,\n    operation: ApolloLink.Operation,\n    error: ErrorLike\n  ) => number;\n\n  /**\n   * Configuration options for the standard retry delay strategy.\n   */\n  export interface DelayOptions {\n    /**\n     * The number of milliseconds to wait before attempting the first retry.\n     *\n     * Delays will increase exponentially for each attempt. E.g. if this is\n     * set to 100, subsequent retries will be delayed by 200, 400, 800, etc,\n     * until they reach the maximum delay.\n     *\n     * Note that if jittering is enabled, this is the average delay.\n     *\n     * @defaultValue `300`\n     */\n    initial?: number;\n\n    /**\n     * The maximum number of milliseconds that the link should wait for any\n     * retry.\n     *\n     * @defaultValue `Infinity`\n     */\n    max?: number;\n\n    /**\n     * Whether delays between attempts should be randomized.\n     *\n     * This helps avoid [thundering herd](https://en.wikipedia.org/wiki/Thundering_herd_problem)\n     * type situations by better distributing load during major outages. Without\n     * these strategies, when your server comes back up it will be hit by all\n     * of your clients at once, possibly causing it to go down again.\n     *\n     * @defaultValue `true`\n     */\n    jitter?: boolean;\n  }\n\n  /** {@inheritDoc @apollo/client/link/retry!RetryLink.RetryLinkDocumentationTypes.AttemptsFunction:function(1)} */\n  export type AttemptsFunction = (\n    attempt: number,\n    operation: ApolloLink.Operation,\n    error: ErrorLike\n  ) => boolean | Promise<boolean>;\n\n  /**\n   * Configuration options for the standard retry attempt strategy.\n   */\n  export interface AttemptsOptions {\n    /**\n     * The max number of times to try a single operation before giving up.\n     *\n     * Note that this INCLUDES the initial request as part of the count.\n     * E.g. `max` of 1 indicates no retrying should occur.\n     *\n     * Pass `Infinity` for infinite retries.\n     *\n     * @defaultValue `5`\n     */\n    max?: number;\n\n    /**\n     * Predicate function that determines whether a particular error should\n     * trigger a retry.\n     *\n     * For example, you may want to not retry 4xx class HTTP errors.\n     *\n     * @defaultValue `() => true`\n     */\n    retryIf?: (\n      error: ErrorLike,\n      operation: ApolloLink.Operation\n    ) => boolean | Promise<boolean>;\n  }\n\n  /**\n   * Options provided to the `RetryLink` constructor.\n   */\n  export interface Options {\n    /**\n     * Configuration for the delay strategy to use, or a custom delay strategy.\n     */\n    delay?: RetryLink.DelayOptions | RetryLink.DelayFunction;\n\n    /**\n     * Configuration for the retry strategy to use, or a custom retry strategy.\n     */\n    attempts?: RetryLink.AttemptsOptions | RetryLink.AttemptsFunction;\n  }\n}\n\nclass RetryableOperation {\n  private retryCount: number = 0;\n  private currentSubscription: Subscription | null = null;\n  private timerId: ReturnType<typeof setTimeout> | undefined;\n\n  constructor(\n    private observer: Observer<ApolloLink.Result>,\n    private operation: ApolloLink.Operation,\n    private forward: ApolloLink.ForwardFunction,\n    private delayFor: RetryLink.DelayFunction,\n    private retryIf: RetryLink.AttemptsFunction\n  ) {\n    this.try();\n  }\n\n  /**\n   * Stop retrying for the operation, and cancel any in-progress requests.\n   */\n  public cancel() {\n    if (this.currentSubscription) {\n      this.currentSubscription.unsubscribe();\n    }\n    clearTimeout(this.timerId);\n    this.timerId = undefined;\n    this.currentSubscription = null;\n  }\n\n  private try() {\n    this.currentSubscription = this.forward(this.operation).subscribe({\n      next: (result) => {\n        if (graphQLResultHasProtocolErrors(result)) {\n          this.onError(result.extensions[PROTOCOL_ERRORS_SYMBOL], () =>\n            // Pretend like we never encountered this error and move the result\n            // along for Apollo Client core to handle this error.\n            this.observer.next(result)\n          );\n          // Unsubscribe from the current subscription to prevent the `complete`\n          // handler to be called as a result of the stream closing.\n          this.currentSubscription?.unsubscribe();\n          return;\n        }\n\n        this.observer.next(result);\n      },\n      error: (error) => this.onError(error, () => this.observer.error(error)),\n      complete: this.observer.complete.bind(this.observer),\n    });\n  }\n\n  private onError = async (error: unknown, onContinue: () => void) => {\n    this.retryCount += 1;\n    const errorLike = toErrorLike(error);\n\n    const shouldRetry = await this.retryIf(\n      this.retryCount,\n      this.operation,\n      errorLike\n    );\n    if (shouldRetry) {\n      this.scheduleRetry(\n        this.delayFor(this.retryCount, this.operation, errorLike)\n      );\n      return;\n    }\n\n    onContinue();\n  };\n\n  private scheduleRetry(delay: number) {\n    if (this.timerId) {\n      throw new Error(`RetryLink BUG! Encountered overlapping retries`);\n    }\n\n    this.timerId = setTimeout(() => {\n      this.timerId = undefined;\n      this.try();\n    }, delay);\n  }\n}\n\n/**\n * `RetryLink` is a non-terminating link that attempts to retry operations that\n * fail due to network errors. It enables resilient GraphQL operations by\n * automatically retrying failed requests with configurable delay and retry\n * strategies.\n *\n * @remarks\n *\n * `RetryLink` is particularly useful for handling unreliable network conditions\n * where you would rather wait longer than explicitly fail an operation. It\n * provides exponential backoff and jitters delays between attempts by default.\n *\n * > [!NOTE]\n * > This link does not handle retries for GraphQL errors in the response. Use\n * > `ErrorLink` to retry an operation after a GraphQL error. For more\n * > information, see the [Error handling documentation](https://apollographql.com/docs/react/data/error-handling#on-graphql-errors).\n *\n * @example\n *\n * ```ts\n * import { RetryLink } from \"@apollo/client/link/retry\";\n *\n * const link = new RetryLink();\n * ```\n */\nexport class RetryLink extends ApolloLink {\n  private delayFor: RetryLink.DelayFunction;\n  private retryIf: RetryLink.AttemptsFunction;\n\n  constructor(options?: RetryLink.Options) {\n    super();\n    const { attempts, delay } = options || ({} as RetryLink.Options);\n    this.delayFor =\n      typeof delay === \"function\" ? delay : buildDelayFunction(delay);\n    this.retryIf =\n      typeof attempts === \"function\" ? attempts : buildRetryFunction(attempts);\n  }\n\n  public request(\n    operation: ApolloLink.Operation,\n    forward: ApolloLink.ForwardFunction\n  ): Observable<ApolloLink.Result> {\n    return new Observable((observer) => {\n      const retryable = new RetryableOperation(\n        observer,\n        operation,\n        forward,\n        this.delayFor,\n        this.retryIf\n      );\n      return () => {\n        retryable.cancel();\n      };\n    });\n  }\n}\n"]}

package/link/schema/index.d.ts

@@ -2,28 +2,150 @@ import type { GraphQLSchema } from "graphql";
 import { Observable } from "rxjs";
 import { ApolloLink } from "@apollo/client/link";
 export declare namespace SchemaLink {
+    namespace SchemaLinkDocumentationTypes {
+        /**
+         * A function that returns the resolver context for a given operation.
+         *
+         * This function is called for each operation and allows you to create
+         * operation-specific context. This is useful when you need to include
+         * information from the operation (like headers, variables, etc.) in the
+         * resolver context.
+         *
+         * @param operation - The Apollo Link operation
+         * @returns The resolver context object or a promise that resolves to the context
+         *
+         * @example
+         *
+         * ```ts
+         * const link = new SchemaLink({
+         *   schema,
+         *   context: (operation) => {
+         *     return {
+         *       userId: operation.getContext().userId,
+         *       dataSources: {
+         *         userAPI: new UserAPI(),
+         *       },
+         *     };
+         *   },
+         * });
+         * ```
+         */
+        function ResolverContextFunction(operation: ApolloLink.Operation): SchemaLink.ResolverContext | PromiseLike<SchemaLink.ResolverContext>;
+    }
+    /**
+     * The resolver context object passed to GraphQL resolvers.
+     *
+     * This context object is passed as the third parameter to GraphQL resolvers
+     * and typically contains data-fetching connectors, authentication information,
+     * and other request-specific data.
+     */
     type ResolverContext = Record<string, any>;
-    type ResolverContextFunction = (operation: ApolloLink.Operation) => ResolverContext | PromiseLike<ResolverContext>;
+    /**
+    * A function that returns the resolver context for a given operation.
+    * 
+    * This function is called for each operation and allows you to create
+    * operation-specific context. This is useful when you need to include
+    * information from the operation (like headers, variables, etc.) in the
+    * resolver context.
+    * 
+    * @param operation - The Apollo Link operation
+    * @returns The resolver context object or a promise that resolves to the context
+    * 
+    * @example
+    * 
+    * ```ts
+    * const link = new SchemaLink({
+    *   schema,
+    *   context: (operation) => {
+    *     return {
+    *       userId: operation.getContext().userId,
+    *       dataSources: {
+    *         userAPI: new UserAPI(),
+    *       },
+    *     };
+    *   },
+    * });
+    * ```
+    */
+    type ResolverContextFunction = (operation: ApolloLink.Operation) => SchemaLink.ResolverContext | PromiseLike<SchemaLink.ResolverContext>;
+    /**
+     * Options for configuring the `SchemaLink`.
+     */
     interface Options {
         /**
-         * The schema to generate responses from.
+         * An executable GraphQL schema to use for operation execution.
+         *
+         * @remarks
+         *
+         * This should be a complete, executable GraphQL schema created using
+         * tools like `makeExecutableSchema` from `@graphql-tools/schema` or
+         * `buildSchema` from `graphql`.
+         *
+         * @example
+         *
+         * ```ts
+         * import { makeExecutableSchema } from "@graphql-tools/schema";
+         *
+         * const schema = makeExecutableSchema({
+         *   typeDefs,
+         *   resolvers,
+         * });
+         *
+         * const link = new SchemaLink({ schema });
+         * ```
          */
         schema: GraphQLSchema;
         /**
-         * The root value to use when generating responses.
+         * The root value passed to root-level resolvers. It's typically not used in
+         * most schemas but can be useful for certain advanced patterns.
          */
         rootValue?: any;
         /**
-         * A context to provide to resolvers declared within the schema.
+         * Context object or function that returns the context object to provide to
+         * resolvers. The context is passed as the third parameter to all GraphQL
+         * resolvers.
+         *
+         * - If a static object is provided, the same context will be used for all
+         *   operations
+         * - If a function is provided, the function is called for each operation to
+         *   generate operation-specific context
          */
         context?: SchemaLink.ResolverContext | SchemaLink.ResolverContextFunction;
         /**
-         * Validate incoming queries against the given schema, returning
-         * validation errors as a GraphQL server would.
+         * Whether to validate incoming queries against the schema before execution.
+         *
+         * When enabled, queries will be validated against the schema before execution,
+         * and validation errors will be returned in the result's `errors` array,
+         * just like a remote GraphQL server would.
+         *
+         * This is useful for testing and development to catch query errors early,
+         * but may add overhead in production environments.
+         *
+         * @defaultValue false
          */
         validate?: boolean;
     }
 }
+/**
+ * `SchemaLink` is a terminating link that executes GraphQL operations against
+ * a local GraphQL schema instead of making network requests. This is commonly
+ * used for server-side rendering (SSR) and mocking dataa.
+ *
+ * > [!NOTE]
+ * > While `SchemaLink` can provide GraphQL results on the client, the GraphQL
+ * > execution layer is [quite large](https://bundlephobia.com/result?p=graphql) for practical client-side use.
+ * > For client-side state management, consider Apollo Client's [local state management](https://apollographql.com/docs/react/local-state/local-state-management/)
+ * > functionality instead, which integrates with the Apollo Client cache.
+ *
+ * @example
+ *
+ * ```ts
+ * import { SchemaLink } from "@apollo/client/link/schema";
+ * import schema from "./path/to/your/schema";
+ *
+ * const link = new SchemaLink({ schema });
+ * ```
+ */
 export declare class SchemaLink extends ApolloLink {
     schema: SchemaLink.Options["schema"];
     rootValue: SchemaLink.Options["rootValue"];
@@ -32,4 +154,4 @@ export declare class SchemaLink extends ApolloLink {
     constructor(options: SchemaLink.Options);
     request(operation: ApolloLink.Operation): Observable<ApolloLink.Result>;
 }
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=index.d.ts.map

package/link/schema/index.js

@@ -1,6 +1,26 @@
 import { execute, validate } from "graphql";
 import { Observable } from "rxjs";
 import { ApolloLink } from "@apollo/client/link";
+/**
+ * `SchemaLink` is a terminating link that executes GraphQL operations against
+ * a local GraphQL schema instead of making network requests. This is commonly
+ * used for server-side rendering (SSR) and mocking dataa.
+ *
+ * > [!NOTE]
+ * > While `SchemaLink` can provide GraphQL results on the client, the GraphQL
+ * > execution layer is [quite large](https://bundlephobia.com/result?p=graphql) for practical client-side use.
+ * > For client-side state management, consider Apollo Client's [local state management](https://apollographql.com/docs/react/local-state/local-state-management/)
+ * > functionality instead, which integrates with the Apollo Client cache.
+ *
+ * @example
+ *
+ * ```ts
+ * import { SchemaLink } from "@apollo/client/link/schema";
+ * import schema from "./path/to/your/schema";
+ *
+ * const link = new SchemaLink({ schema });
+ * ```
+ */
 export class SchemaLink extends ApolloLink {
     schema;
     rootValue;

package/link/schema/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/link/schema/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAgCjD,MAAM,OAAO,UAAW,SAAQ,UAAU;IACjC,MAAM,CAA+B;IACrC,SAAS,CAAkC;IAC3C,OAAO,CAAgC;IACvC,QAAQ,CAAU;IAEzB,YAAY,OAA2B;QACrC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACrC,CAAC;IAEM,OAAO,CACZ,SAA+B;QAE/B,OAAO,IAAI,UAAU,CAAoB,CAAC,QAAQ,EAAE,EAAE;YACpD,IAAI,OAAO,CAA6B,CAAC,OAAO,EAAE,EAAE,CAClD,OAAO,CACL,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC;gBAClC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;gBACzB,CAAC,CAAC,IAAI,CAAC,OAAO,CACf,CACF;iBACE,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;gBAChB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAClB,MAAM,gBAAgB,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;oBAChE,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAChC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;oBACtC,CAAC;gBACH,CAAC;gBAED,OAAO,OAAO,CAAC;oBACb,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,QAAQ,EAAE,SAAS,CAAC,KAAK;oBACzB,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,YAAY,EAAE,OAAO;oBACrB,cAAc,EAAE,SAAS,CAAC,SAAS;oBACnC,aAAa,EAAE,SAAS,CAAC,aAAa;iBACvC,CAAC,CAAC;YACL,CAAC,CAAC;iBACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;gBACb,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;oBACrB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACpB,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACtB,CAAC;YACH,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACf,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;oBACrB,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import type { GraphQLSchema } from \"graphql\";\nimport { execute, validate } from \"graphql\";\nimport { Observable } from \"rxjs\";\n\nimport { ApolloLink } from \"@apollo/client/link\";\n\nexport declare namespace SchemaLink {\n  export type ResolverContext = Record<string, any>;\n  export type ResolverContextFunction = (\n    operation: ApolloLink.Operation\n  ) => ResolverContext | PromiseLike<ResolverContext>;\n\n  export interface Options {\n    /**\n     * The schema to generate responses from.\n     */\n    schema: GraphQLSchema;\n\n    /**\n     * The root value to use when generating responses.\n     */\n    rootValue?: any;\n\n    /**\n     * A context to provide to resolvers declared within the schema.\n     */\n    context?: SchemaLink.ResolverContext | SchemaLink.ResolverContextFunction;\n\n    /**\n     * Validate incoming queries against the given schema, returning\n     * validation errors as a GraphQL server would.\n     */\n    validate?: boolean;\n  }\n}\n\nexport class SchemaLink extends ApolloLink {\n  public schema: SchemaLink.Options[\"schema\"];\n  public rootValue: SchemaLink.Options[\"rootValue\"];\n  public context: SchemaLink.Options[\"context\"];\n  public validate: boolean;\n\n  constructor(options: SchemaLink.Options) {\n    super();\n    this.schema = options.schema;\n    this.rootValue = options.rootValue;\n    this.context = options.context;\n    this.validate = !!options.validate;\n  }\n\n  public request(\n    operation: ApolloLink.Operation\n  ): Observable<ApolloLink.Result> {\n    return new Observable<ApolloLink.Result>((observer) => {\n      new Promise<SchemaLink.ResolverContext>((resolve) =>\n        resolve(\n          typeof this.context === \"function\" ?\n            this.context(operation)\n          : this.context\n        )\n      )\n        .then((context) => {\n          if (this.validate) {\n            const validationErrors = validate(this.schema, operation.query);\n            if (validationErrors.length > 0) {\n              return { errors: validationErrors };\n            }\n          }\n\n          return execute({\n            schema: this.schema,\n            document: operation.query,\n            rootValue: this.rootValue,\n            contextValue: context,\n            variableValues: operation.variables,\n            operationName: operation.operationName,\n          });\n        })\n        .then((data) => {\n          if (!observer.closed) {\n            observer.next(data);\n            observer.complete();\n          }\n        })\n        .catch((error) => {\n          if (!observer.closed) {\n            observer.error(error);\n          }\n        });\n    });\n  }\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/link/schema/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AA+GjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,UAAW,SAAQ,UAAU;IACjC,MAAM,CAA+B;IACrC,SAAS,CAAkC;IAC3C,OAAO,CAAgC;IACvC,QAAQ,CAAU;IAEzB,YAAY,OAA2B;QACrC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACrC,CAAC;IAEM,OAAO,CACZ,SAA+B;QAE/B,OAAO,IAAI,UAAU,CAAoB,CAAC,QAAQ,EAAE,EAAE;YACpD,IAAI,OAAO,CAA6B,CAAC,OAAO,EAAE,EAAE,CAClD,OAAO,CACL,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC;gBAClC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;gBACzB,CAAC,CAAC,IAAI,CAAC,OAAO,CACf,CACF;iBACE,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;gBAChB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAClB,MAAM,gBAAgB,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;oBAChE,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAChC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;oBACtC,CAAC;gBACH,CAAC;gBAED,OAAO,OAAO,CAAC;oBACb,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,QAAQ,EAAE,SAAS,CAAC,KAAK;oBACzB,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,YAAY,EAAE,OAAO;oBACrB,cAAc,EAAE,SAAS,CAAC,SAAS;oBACnC,aAAa,EAAE,SAAS,CAAC,aAAa;iBACvC,CAAC,CAAC;YACL,CAAC,CAAC;iBACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;gBACb,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;oBACrB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACpB,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACtB,CAAC;YACH,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACf,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;oBACrB,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import type { GraphQLSchema } from \"graphql\";\nimport { execute, validate } from \"graphql\";\nimport { Observable } from \"rxjs\";\n\nimport { ApolloLink } from \"@apollo/client/link\";\n\nexport declare namespace SchemaLink {\n  export namespace SchemaLinkDocumentationTypes {\n    /**\n     * A function that returns the resolver context for a given operation.\n     *\n     * This function is called for each operation and allows you to create\n     * operation-specific context. This is useful when you need to include\n     * information from the operation (like headers, variables, etc.) in the\n     * resolver context.\n     *\n     * @param operation - The Apollo Link operation\n     * @returns The resolver context object or a promise that resolves to the context\n     *\n     * @example\n     *\n     * ```ts\n     * const link = new SchemaLink({\n     *   schema,\n     *   context: (operation) => {\n     *     return {\n     *       userId: operation.getContext().userId,\n     *       dataSources: {\n     *         userAPI: new UserAPI(),\n     *       },\n     *     };\n     *   },\n     * });\n     * ```\n     */\n    export function ResolverContextFunction(\n      operation: ApolloLink.Operation\n    ): SchemaLink.ResolverContext | PromiseLike<SchemaLink.ResolverContext>;\n  }\n  /**\n   * The resolver context object passed to GraphQL resolvers.\n   *\n   * This context object is passed as the third parameter to GraphQL resolvers\n   * and typically contains data-fetching connectors, authentication information,\n   * and other request-specific data.\n   */\n  export type ResolverContext = Record<string, any>;\n\n  /** {@inheritDoc @apollo/client/link/schema!SchemaLink.SchemaLinkDocumentationTypes.ResolverContextFunction:function(1)} */\n  export type ResolverContextFunction = (\n    operation: ApolloLink.Operation\n  ) => SchemaLink.ResolverContext | PromiseLike<SchemaLink.ResolverContext>;\n\n  /**\n   * Options for configuring the `SchemaLink`.\n   */\n  export interface Options {\n    /**\n     * An executable GraphQL schema to use for operation execution.\n     *\n     * @remarks\n     *\n     * This should be a complete, executable GraphQL schema created using\n     * tools like `makeExecutableSchema` from `@graphql-tools/schema` or\n     * `buildSchema` from `graphql`.\n     *\n     * @example\n     *\n     * ```ts\n     * import { makeExecutableSchema } from \"@graphql-tools/schema\";\n     *\n     * const schema = makeExecutableSchema({\n     *   typeDefs,\n     *   resolvers,\n     * });\n     *\n     * const link = new SchemaLink({ schema });\n     * ```\n     */\n    schema: GraphQLSchema;\n\n    /**\n     * The root value passed to root-level resolvers. It's typically not used in\n     * most schemas but can be useful for certain advanced patterns.\n     */\n    rootValue?: any;\n\n    /**\n     * Context object or function that returns the context object to provide to\n     * resolvers. The context is passed as the third parameter to all GraphQL\n     * resolvers.\n     *\n     * - If a static object is provided, the same context will be used for all\n     *   operations\n     * - If a function is provided, the function is called for each operation to\n     *   generate operation-specific context\n     */\n    context?: SchemaLink.ResolverContext | SchemaLink.ResolverContextFunction;\n\n    /**\n     * Whether to validate incoming queries against the schema before execution.\n     *\n     * When enabled, queries will be validated against the schema before execution,\n     * and validation errors will be returned in the result's `errors` array,\n     * just like a remote GraphQL server would.\n     *\n     * This is useful for testing and development to catch query errors early,\n     * but may add overhead in production environments.\n     *\n     * @defaultValue false\n     */\n    validate?: boolean;\n  }\n}\n\n/**\n * `SchemaLink` is a terminating link that executes GraphQL operations against\n * a local GraphQL schema instead of making network requests. This is commonly\n * used for server-side rendering (SSR) and mocking dataa.\n *\n * > [!NOTE]\n * > While `SchemaLink` can provide GraphQL results on the client, the GraphQL\n * > execution layer is [quite large](https://bundlephobia.com/result?p=graphql) for practical client-side use.\n * > For client-side state management, consider Apollo Client's [local state management](https://apollographql.com/docs/react/local-state/local-state-management/)\n * > functionality instead, which integrates with the Apollo Client cache.\n *\n * @example\n *\n * ```ts\n * import { SchemaLink } from \"@apollo/client/link/schema\";\n * import schema from \"./path/to/your/schema\";\n *\n * const link = new SchemaLink({ schema });\n * ```\n */\nexport class SchemaLink extends ApolloLink {\n  public schema: SchemaLink.Options[\"schema\"];\n  public rootValue: SchemaLink.Options[\"rootValue\"];\n  public context: SchemaLink.Options[\"context\"];\n  public validate: boolean;\n\n  constructor(options: SchemaLink.Options) {\n    super();\n    this.schema = options.schema;\n    this.rootValue = options.rootValue;\n    this.context = options.context;\n    this.validate = !!options.validate;\n  }\n\n  public request(\n    operation: ApolloLink.Operation\n  ): Observable<ApolloLink.Result> {\n    return new Observable<ApolloLink.Result>((observer) => {\n      new Promise<SchemaLink.ResolverContext>((resolve) =>\n        resolve(\n          typeof this.context === \"function\" ?\n            this.context(operation)\n          : this.context\n        )\n      )\n        .then((context) => {\n          if (this.validate) {\n            const validationErrors = validate(this.schema, operation.query);\n            if (validationErrors.length > 0) {\n              return { errors: validationErrors };\n            }\n          }\n\n          return execute({\n            schema: this.schema,\n            document: operation.query,\n            rootValue: this.rootValue,\n            contextValue: context,\n            variableValues: operation.variables,\n            operationName: operation.operationName,\n          });\n        })\n        .then((data) => {\n          if (!observer.closed) {\n            observer.next(data);\n            observer.complete();\n          }\n        })\n        .catch((error) => {\n          if (!observer.closed) {\n            observer.error(error);\n          }\n        });\n    });\n  }\n}\n"]}

package/link/ws/index.d.ts

@@ -4,25 +4,76 @@ import { SubscriptionClient } from "subscriptions-transport-ws";
 import { ApolloLink } from "@apollo/client/link";
 export declare namespace WebSocketLink {
     /**
-     * Configuration to use when constructing the subscription client (subscriptions-transport-ws).
+     * Configuration options for creating a `WebSocketLink` instance.
+     *
+     * @remarks
+     *
+     * These configuration options are used when creating a `WebSocketLink` without
+     * providing an existing `SubscriptionClient` instance. The options are passed
+     * directly to the `SubscriptionClient` constructor from the `subscriptions-transport-ws`
+     * library.
      */
     interface Configuration {
         /**
-         * The endpoint to connect to.
+         * The WebSocket endpoint URI to connect to.
+         *
+         * This should be a valid WebSocket URI (starting with `ws://` or `wss://`)
+         * that points to your GraphQL subscription endpoint.
+         *
+         * @example "ws://localhost:4000/subscriptions"
+         * @example "wss://api.example.com/graphql"
          */
         uri: string;
         /**
-         * Options to pass when constructing the subscription client.
+         * Configuration options passed to the underlying `SubscriptionClient`.
+         *
+         * These options configure the WebSocket connection behavior, including
+         * reconnection settings, connection parameters, and event handlers.
+         *
+         * For a complete list of available options, see the
+         * [supported `subscriptions-transport-ws` options](https://github.com/apollographql/subscriptions-transport-ws/blob/master/src/client.ts#L61-L71).
          */
         options?: ClientOptions;
         /**
-         * A custom WebSocket implementation to use.
+         * A custom WebSocket implementation to use for the connection.
+         *
+         * This is useful in environments that don't have native WebSocket support.
+         * You can provide a WebSocket polyfill or implementation that conforms to
+         * the W3C WebSocket API.
+         *
+         * @example
+         *
+         * ```ts
+         * import WebSocket from "ws";
+         *
+         * const wsLink = new WebSocketLink({
+         *   uri: "ws://localhost:4000/subscriptions",
+         *   webSocketImpl: WebSocket,
+         * });
+         * ```
          */
         webSocketImpl?: any;
     }
 }
-export import WebSocketParams = WebSocketLink.Configuration;
 /**
+ * `WebSocketLink` is a terminating link that executes GraphQL operations over
+ * WebSocket connections using the `subscriptions-transport-ws` library. It's
+ * primarily used for GraphQL subscriptions but can also handle queries and
+ * mutations.
+ *
+ * @example
+ *
+ * ```ts
+ * import { WebSocketLink } from "@apollo/client/link/ws";
+ * import { SubscriptionClient } from "subscriptions-transport-ws";
+ *
+ * const wsLink = new WebSocketLink(
+ *   new SubscriptionClient("ws://localhost:4000/subscriptions", {
+ *     reconnect: true,
+ *   })
+ * );
+ * ```
+ *
  * @deprecated `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

package/link/ws/index.js

@@ -3,6 +3,24 @@ import { ApolloLink } from "@apollo/client/link";
 import { __DEV__ } from "@apollo/client/utilities/environment";
 import { invariant } from "@apollo/client/utilities/invariant";
 /**
+ * `WebSocketLink` is a terminating link that executes GraphQL operations over
+ * WebSocket connections using the `subscriptions-transport-ws` library. It's
+ * primarily used for GraphQL subscriptions but can also handle queries and
+ * mutations.
+ *
+ * @example
+ *
+ * ```ts
+ * import { WebSocketLink } from "@apollo/client/link/ws";
+ * import { SubscriptionClient } from "subscriptions-transport-ws";
+ *
+ * const wsLink = new WebSocketLink(
+ *   new SubscriptionClient("ws://localhost:4000/subscriptions", {
+ *     reconnect: true,
+ *   })
+ * );
+ * ```
+ *
  * @deprecated `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

package/link/ws/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/link/ws/index.ts"],"sourcesContent":["import type { Observable } from \"rxjs\";\nimport type { ClientOptions } from \"subscriptions-transport-ws\";\nimport { SubscriptionClient } from \"subscriptions-transport-ws\";\n\nimport { ApolloLink } from \"@apollo/client/link\";\nimport { __DEV__ } from \"@apollo/client/utilities/environment\";\nimport { invariant } from \"@apollo/client/utilities/invariant\";\n\nexport declare namespace WebSocketLink {\n  /**\n   * Configuration to use when constructing the subscription client (subscriptions-transport-ws).\n   */\n  export interface Configuration {\n    /**\n     * The endpoint to connect to.\n     */\n    uri: string;\n\n    /**\n     * Options to pass when constructing the subscription client.\n     */\n    options?: ClientOptions;\n\n    /**\n     * A custom WebSocket implementation to use.\n     */\n    webSocketImpl?: any;\n  }\n}\n\n// For backwards compatibility.\nexport import WebSocketParams = WebSocketLink.Configuration;\n\n/**\n * @deprecated `WebSocketLink` uses the deprecated and unmaintained\n * `subscriptions-transport-ws` library. This link is no longer maintained and\n * will be removed in a future major version of Apollo Client. We recommend\n * switching to `GraphQLWsLink`, which uses the [`graphql-ws` library](https://the-guild.dev/graphql/ws) to\n * send GraphQL operations through WebSocket connections.\n */\nexport class WebSocketLink extends ApolloLink {\n  private subscriptionClient: SubscriptionClient;\n\n  constructor(\n    paramsOrClient: WebSocketLink.Configuration | SubscriptionClient\n  ) {\n    super();\n\n    if (__DEV__) {\n      invariant.warn(\n        \"`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).\"\n      );\n    }\n\n    if (paramsOrClient instanceof SubscriptionClient) {\n      this.subscriptionClient = paramsOrClient;\n    } else {\n      this.subscriptionClient = new SubscriptionClient(\n        paramsOrClient.uri,\n        paramsOrClient.options,\n        paramsOrClient.webSocketImpl\n      );\n    }\n  }\n\n  public request(\n    operation: ApolloLink.Operation\n  ): Observable<ApolloLink.Result> {\n    return this.subscriptionClient.request(\n      operation\n    ) as Observable<ApolloLink.Result>;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../src/link/ws/index.ts"],"sourcesContent":["import type { Observable } from \"rxjs\";\nimport type { ClientOptions } from \"subscriptions-transport-ws\";\nimport { SubscriptionClient } from \"subscriptions-transport-ws\";\n\nimport { ApolloLink } from \"@apollo/client/link\";\nimport { __DEV__ } from \"@apollo/client/utilities/environment\";\nimport { invariant } from \"@apollo/client/utilities/invariant\";\n\nexport declare namespace WebSocketLink {\n  /**\n   * Configuration options for creating a `WebSocketLink` instance.\n   *\n   * @remarks\n   *\n   * These configuration options are used when creating a `WebSocketLink` without\n   * providing an existing `SubscriptionClient` instance. The options are passed\n   * directly to the `SubscriptionClient` constructor from the `subscriptions-transport-ws`\n   * library.\n   */\n  export interface Configuration {\n    /**\n     * The WebSocket endpoint URI to connect to.\n     *\n     * This should be a valid WebSocket URI (starting with `ws://` or `wss://`)\n     * that points to your GraphQL subscription endpoint.\n     *\n     * @example \"ws://localhost:4000/subscriptions\"\n     * @example \"wss://api.example.com/graphql\"\n     */\n    uri: string;\n\n    /**\n     * Configuration options passed to the underlying `SubscriptionClient`.\n     *\n     * These options configure the WebSocket connection behavior, including\n     * reconnection settings, connection parameters, and event handlers.\n     *\n     * For a complete list of available options, see the\n     * [supported `subscriptions-transport-ws` options](https://github.com/apollographql/subscriptions-transport-ws/blob/master/src/client.ts#L61-L71).\n     */\n    options?: ClientOptions;\n\n    /**\n     * A custom WebSocket implementation to use for the connection.\n     *\n     * This is useful in environments that don't have native WebSocket support.\n     * You can provide a WebSocket polyfill or implementation that conforms to\n     * the W3C WebSocket API.\n     *\n     * @example\n     *\n     * ```ts\n     * import WebSocket from \"ws\";\n     *\n     * const wsLink = new WebSocketLink({\n     *   uri: \"ws://localhost:4000/subscriptions\",\n     *   webSocketImpl: WebSocket,\n     * });\n     * ```\n     */\n    webSocketImpl?: any;\n  }\n}\n\n/**\n * `WebSocketLink` is a terminating link that executes GraphQL operations over\n * WebSocket connections using the `subscriptions-transport-ws` library. It's\n * primarily used for GraphQL subscriptions but can also handle queries and\n * mutations.\n *\n * @example\n *\n * ```ts\n * import { WebSocketLink } from \"@apollo/client/link/ws\";\n * import { SubscriptionClient } from \"subscriptions-transport-ws\";\n *\n * const wsLink = new WebSocketLink(\n *   new SubscriptionClient(\"ws://localhost:4000/subscriptions\", {\n *     reconnect: true,\n *   })\n * );\n * ```\n *\n * @deprecated `WebSocketLink` uses the deprecated and unmaintained\n * `subscriptions-transport-ws` library. This link is no longer maintained and\n * will be removed in a future major version of Apollo Client. We recommend\n * switching to `GraphQLWsLink`, which uses the [`graphql-ws` library](https://the-guild.dev/graphql/ws) to\n * send GraphQL operations through WebSocket connections.\n */\nexport class WebSocketLink extends ApolloLink {\n  private subscriptionClient: SubscriptionClient;\n\n  constructor(\n    paramsOrClient: WebSocketLink.Configuration | SubscriptionClient\n  ) {\n    super();\n\n    if (__DEV__) {\n      invariant.warn(\n        \"`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).\"\n      );\n    }\n\n    if (paramsOrClient instanceof SubscriptionClient) {\n      this.subscriptionClient = paramsOrClient;\n    } else {\n      this.subscriptionClient = new SubscriptionClient(\n        paramsOrClient.uri,\n        paramsOrClient.options,\n        paramsOrClient.webSocketImpl\n      );\n    }\n  }\n\n  public request(\n    operation: ApolloLink.Operation\n  ): Observable<ApolloLink.Result> {\n    return this.subscriptionClient.request(\n      operation\n    ) as Observable<ApolloLink.Result>;\n  }\n}\n"],"names":[],"mappings":"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"}