@depup/apollo__client 4.1.6-depup.0

package/errors/CombinedProtocolErrors.js

@@ -0,0 +1,80 @@
+import { brand, isBranded } from "./utils.js";
+function defaultFormatMessage(errors) {
+    return errors.map((e) => e.message || "Error message not found.").join("\n");
+}
+/**
+ * Fatal transport-level errors returned when executing a subscription using the
+ * multipart HTTP subscription protocol. See the documentation on the
+ * [multipart HTTP protocol for GraphQL Subscriptions](https://www.apollographql.com/docs/graphos/routing/operations/subscriptions/multipart-protocol) for more information on these errors.
+ *
+ * @remarks
+ *
+ * These errors indicate issues with the subscription transport itself, rather
+ * than GraphQL-level errors. They typically occur when there are problems
+ * communicating with subgraphs from the Apollo Router.
+ *
+ * @example
+ *
+ * ```ts
+ * import { CombinedProtocolErrors } from "@apollo/client/errors";
+ *
+ * // Check if an error is a CombinedProtocolErrors instance
+ * if (CombinedProtocolErrors.is(error)) {
+ *   // Access individual protocol errors
+ *   error.errors.forEach((protocolError) => {
+ *     console.log(protocolError.message);
+ *     console.log(protocolError.extensions);
+ *   });
+ * }
+ * ```
+ */
+export class CombinedProtocolErrors extends Error {
+    /**
+     * A method that determines whether an error is a `CombinedProtocolErrors`
+     * object. This method enables TypeScript to narrow the error type.
+     *
+     * @example
+     *
+     * ```ts
+     * if (CombinedProtocolErrors.is(error)) {
+     *   // TypeScript now knows `error` is a CombinedProtocolErrors object
+     *   console.log(error.errors);
+     * }
+     * ```
+     */
+    static is(error) {
+        return isBranded(error, "CombinedProtocolErrors");
+    }
+    /**
+    * A function that formats the error message used for the error's `message`
+    * property. Override this method to provide your own formatting.
+    * 
+    * @remarks
+    * 
+    * The `formatMessage` function is called by the `CombinedProtocolErrors`
+    * constructor to provide a formatted message as the `message` property of the
+    * `CombinedProtocolErrors` object. Follow the ["Providing a custom message
+    * formatter"](https://www.apollographql.com/docs/react/api/errors/CombinedProtocolErrors#providing-a-custom-message-formatter) guide to learn how to modify the message format.
+    * 
+    * @param errors - The array of GraphQL errors returned from the server in the
+    * `errors` field of the response.
+    * @param options - Additional context that could be useful when formatting
+    * the message.
+    */
+    static formatMessage = defaultFormatMessage;
+    /**
+    * The raw list of errors returned by the top-level `errors` field in the
+    * multipart HTTP subscription response.
+    */
+    errors;
+    constructor(protocolErrors) {
+        super(CombinedProtocolErrors.formatMessage(protocolErrors, {
+            defaultFormatMessage,
+        }));
+        this.name = "CombinedProtocolErrors";
+        this.errors = protocolErrors;
+        brand(this);
+        Object.setPrototypeOf(this, CombinedProtocolErrors.prototype);
+    }
+}
+//# sourceMappingURL=CombinedProtocolErrors.js.map

package/errors/CombinedProtocolErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CombinedProtocolErrors.js","sources":["../../src/errors/CombinedProtocolErrors.ts"],"sourcesContent":["import type { GraphQLFormattedError } from \"graphql\";\n\nimport { brand, isBranded } from \"./utils.js\";\n\nexport declare namespace CombinedProtocolErrors {\n  export interface MessageFormatterOptions {\n    /**\n     * The default message formatter. Call this to get a string with the default\n     * formatted message.\n     *\n     * @remarks\n     * To format part of the message using the default message formatter, call\n     * the `defaultFormatMessage` function provided to the `options` argument of\n     * your message formatter.\n     *\n     * @example\n     *\n     * The following example prepends a string to the message and uses the\n     * default message formatter to format the error messages.\n     *\n     * ```ts\n     * CombinedProtocolErrors.formatMessage = (errors, { defaultFormatMessage }) => {\n     *   return `[Protocol errors]: ${defaultFormatMessage(errors)}`;\n     * };\n     * ```\n     */\n    defaultFormatMessage: (\n      errors: ReadonlyArray<GraphQLFormattedError>\n    ) => string;\n  }\n\n  /**\n   * By default, `CombinedProtocolErrors` formats the `message` property by\n   * joining each error's `message` field with a newline. To customize the\n   * format of the `message`, such as changing the delimiter or adding a message\n   * prefix, override the static `formatMessage` method.\n   *\n   * @remarks\n   *\n   * See the [`formatMessage`](https://www.apollographql.com/docs/react/api/errors/CombinedProtocolErrors) section for details about the parameters provided to the `formatMessage` function.\n   *\n   * > [!NOTE]\n   * > The message formatter needs to be configured before any operation is executed by Apollo Client, otherwise the default message formatter is used. We recommend configuring the message formatter before initializing your `ApolloClient` instance.\n   *\n   * @example\n   *\n   * The following example demonstrates how to format the error message by\n   * joining each error with a comma.\n   *\n   * ```ts\n   * import { CombinedProtocolErrors } from \"@apollo/client/errors\";\n   *\n   * CombinedProtocolErrors.formatMessage = (errors) => {\n   *   return errors.map((error) => error.message).join(\", \");\n   * };\n   * ```\n   *\n   * @param errors - The array of GraphQL errors returned from the server in the\n   * `errors` field of the response.\n   * @param options - Additional context that could be useful when formatting\n   * the message.\n   */\n  export type MessageFormatter = (\n    errors: ReadonlyArray<GraphQLFormattedError>,\n    options: MessageFormatterOptions\n  ) => string;\n\n  namespace DocumentationTypes {\n    /**\n     * A function that formats the error message used for the error's `message`\n     * property. Override this method to provide your own formatting.\n     *\n     * @remarks\n     *\n     * The `formatMessage` function is called by the `CombinedProtocolErrors`\n     * constructor to provide a formatted message as the `message` property of the\n     * `CombinedProtocolErrors` object. Follow the [\"Providing a custom message\n     * formatter\"](https://www.apollographql.com/docs/react/api/errors/CombinedProtocolErrors#providing-a-custom-message-formatter) guide to learn how to modify the message format.\n     *\n     * @param errors - The array of GraphQL errors returned from the server in the\n     * `errors` field of the response.\n     * @param options - Additional context that could be useful when formatting\n     * the message.\n     */\n    function formatMessage(\n      errors: ReadonlyArray<GraphQLFormattedError>,\n      options: MessageFormatterOptions\n    ): string;\n\n    interface InstanceProperties {\n      /**\n       * The raw list of errors returned by the top-level `errors` field in the\n       * multipart HTTP subscription response.\n       */\n      readonly errors: ReadonlyArray<GraphQLFormattedError>;\n    }\n  }\n}\n\nfunction defaultFormatMessage(errors: ReadonlyArray<GraphQLFormattedError>) {\n  return errors.map((e) => e.message || \"Error message not found.\").join(\"\\n\");\n}\n\n/**\n * Fatal transport-level errors returned when executing a subscription using the\n * multipart HTTP subscription protocol. See the documentation on the\n * [multipart HTTP protocol for GraphQL Subscriptions](https://www.apollographql.com/docs/graphos/routing/operations/subscriptions/multipart-protocol) for more information on these errors.\n *\n * @remarks\n *\n * These errors indicate issues with the subscription transport itself, rather\n * than GraphQL-level errors. They typically occur when there are problems\n * communicating with subgraphs from the Apollo Router.\n *\n * @example\n *\n * ```ts\n * import { CombinedProtocolErrors } from \"@apollo/client/errors\";\n *\n * // Check if an error is a CombinedProtocolErrors instance\n * if (CombinedProtocolErrors.is(error)) {\n *   // Access individual protocol errors\n *   error.errors.forEach((protocolError) => {\n *     console.log(protocolError.message);\n *     console.log(protocolError.extensions);\n *   });\n * }\n * ```\n */\nexport class CombinedProtocolErrors extends Error {\n  /**\n   * A method that determines whether an error is a `CombinedProtocolErrors`\n   * object. This method enables TypeScript to narrow the error type.\n   *\n   * @example\n   *\n   * ```ts\n   * if (CombinedProtocolErrors.is(error)) {\n   *   // TypeScript now knows `error` is a CombinedProtocolErrors object\n   *   console.log(error.errors);\n   * }\n   * ```\n   */\n  static is(error: unknown): error is CombinedProtocolErrors {\n    return isBranded(error, \"CombinedProtocolErrors\");\n  }\n\n  /** {@inheritDoc @apollo/client!CombinedProtocolErrors.DocumentationTypes.formatMessage:function(1)} */\n  static formatMessage: CombinedProtocolErrors.MessageFormatter =\n    defaultFormatMessage;\n\n  /** {@inheritDoc @apollo/client!CombinedProtocolErrors.DocumentationTypes.InstanceProperties#errors:member} */\n  readonly errors: ReadonlyArray<GraphQLFormattedError>;\n\n  constructor(\n    protocolErrors:\n      | Array<GraphQLFormattedError>\n      | ReadonlyArray<GraphQLFormattedError>\n  ) {\n    super(\n      CombinedProtocolErrors.formatMessage(protocolErrors, {\n        defaultFormatMessage,\n      })\n    );\n    this.name = \"CombinedProtocolErrors\";\n    this.errors = protocolErrors;\n\n    brand(this);\n    Object.setPrototypeOf(this, CombinedProtocolErrors.prototype);\n  }\n}\n"],"names":[],"mappings":"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"}

package/errors/LinkError.d.ts

@@ -0,0 +1,61 @@
+import type { ErrorLike } from "@apollo/client";
+/**
+* @internal Please do not use directly.
+* 
+* @deprecated This is an internal API and should not be used directly. This can be removed or changed at any time.
+*/
+export declare function registerLinkError(error: ErrorLike): void;
+/**
+ * A facade error type that keeps a registry of errors emitted from the link
+ * chain. `LinkError` is not an error class itself but rather a utility to
+ * detect whether an error originated from the link chain.
+ *
+ * @remarks
+ *
+ * Use `LinkError` to distinguish between errors from the link chain and custom
+ * errors. This is helpful for retrying an operation at the call site only when
+ * the error originates from the link chain.
+ *
+ * @example
+ *
+ * The following example creates a custom wrapped query function that detects
+ * whether the query includes an operation name and throws if not.
+ *
+ * ```ts
+ * import { LinkError } from "@apollo/client/errors";
+ *
+ * async function runQuery<TData>(query: TypedDocumentNode<TData>) {
+ *   if (!hasOperationName(query)) {
+ *     throw new Error("Queries should have operation names.");
+ *   }
+ *
+ *   return client.watchQuery({ query });
+ * }
+ *
+ * try {
+ *   const result = await runQuery(query);
+ * } catch (error) {
+ *   // Only log the error if the error wasn't our own custom thrown error
+ *   if (LinkError.is(error)) {
+ *     console.log("Got network error:", error.message);
+ *   }
+ * }
+ * ```
+ */
+export declare const LinkError: {
+    /**
+     * A method that determines whether an error originated from the link chain.
+     * `is` does not provide any type narrowing.
+     *
+     * @example
+     *
+     * ```ts
+     * if (LinkError.is(error)) {
+     *   // The error originated from the link chain
+     *   console.log("Got network error:", error.message);
+     * }
+     * ```
+     */
+    is: (error: unknown) => boolean;
+};
+//# sourceMappingURL=LinkError.d.ts.map

package/errors/LinkError.js

@@ -0,0 +1,63 @@
+const registry = new WeakSet();
+/**
+* @internal Please do not use directly.
+* 
+* @deprecated This is an internal API and should not be used directly. This can be removed or changed at any time.
+*/
+export function registerLinkError(error) {
+    registry.add(error);
+}
+/**
+ * A facade error type that keeps a registry of errors emitted from the link
+ * chain. `LinkError` is not an error class itself but rather a utility to
+ * detect whether an error originated from the link chain.
+ *
+ * @remarks
+ *
+ * Use `LinkError` to distinguish between errors from the link chain and custom
+ * errors. This is helpful for retrying an operation at the call site only when
+ * the error originates from the link chain.
+ *
+ * @example
+ *
+ * The following example creates a custom wrapped query function that detects
+ * whether the query includes an operation name and throws if not.
+ *
+ * ```ts
+ * import { LinkError } from "@apollo/client/errors";
+ *
+ * async function runQuery<TData>(query: TypedDocumentNode<TData>) {
+ *   if (!hasOperationName(query)) {
+ *     throw new Error("Queries should have operation names.");
+ *   }
+ *
+ *   return client.watchQuery({ query });
+ * }
+ *
+ * try {
+ *   const result = await runQuery(query);
+ * } catch (error) {
+ *   // Only log the error if the error wasn't our own custom thrown error
+ *   if (LinkError.is(error)) {
+ *     console.log("Got network error:", error.message);
+ *   }
+ * }
+ * ```
+ */
+export const LinkError = {
+    /**
+     * A method that determines whether an error originated from the link chain.
+     * `is` does not provide any type narrowing.
+     *
+     * @example
+     *
+     * ```ts
+     * if (LinkError.is(error)) {
+     *   // The error originated from the link chain
+     *   console.log("Got network error:", error.message);
+     * }
+     * ```
+     */
+    is: (error) => registry.has(error),
+};
+//# sourceMappingURL=LinkError.js.map

package/errors/LinkError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkError.js","sources":["../../src/errors/LinkError.ts"],"sourcesContent":["import type { ErrorLike } from \"@apollo/client\";\n\nconst registry = new WeakSet<ErrorLike>();\n\n/** @internal Please do not use directly. */\nexport function registerLinkError(error: ErrorLike) {\n  registry.add(error);\n}\n\n/**\n * A facade error type that keeps a registry of errors emitted from the link\n * chain. `LinkError` is not an error class itself but rather a utility to\n * detect whether an error originated from the link chain.\n *\n * @remarks\n *\n * Use `LinkError` to distinguish between errors from the link chain and custom\n * errors. This is helpful for retrying an operation at the call site only when\n * the error originates from the link chain.\n *\n * @example\n *\n * The following example creates a custom wrapped query function that detects\n * whether the query includes an operation name and throws if not.\n *\n * ```ts\n * import { LinkError } from \"@apollo/client/errors\";\n *\n * async function runQuery<TData>(query: TypedDocumentNode<TData>) {\n *   if (!hasOperationName(query)) {\n *     throw new Error(\"Queries should have operation names.\");\n *   }\n *\n *   return client.watchQuery({ query });\n * }\n *\n * try {\n *   const result = await runQuery(query);\n * } catch (error) {\n *   // Only log the error if the error wasn't our own custom thrown error\n *   if (LinkError.is(error)) {\n *     console.log(\"Got network error:\", error.message);\n *   }\n * }\n * ```\n */\nexport const LinkError = {\n  /**\n   * A method that determines whether an error originated from the link chain.\n   * `is` does not provide any type narrowing.\n   *\n   * @example\n   *\n   * ```ts\n   * if (LinkError.is(error)) {\n   *   // The error originated from the link chain\n   *   console.log(\"Got network error:\", error.message);\n   * }\n   * ```\n   */\n  is: (error: unknown) => registry.has(error as ErrorLike),\n};\n"],"names":[],"mappings":"AAEA,CAAA,CAAA,CAAA,CAAA,EAAM,CAAN,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAiB,CAAjB,CAAA,EAAqB,CAArB,CAAA,CAAA,CAAA,CAAA,CAAA,CAA4B,CAA5B,CAAyC;;;;;;AAGzC,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAgB,CAAhB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAiC,CAAC,CAAlC,CAAA,CAAA,CAAA,CAAkD,EAAlD;IACE,CAAF,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAU,CAAC,CAAX,CAAA,CAAc,CAAC,CAAf,CAAA,CAAA,CAAA,CAAoB,CAAC;AACrB;AAEA,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCA,CAAA;AACA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAO,CAAP,CAAA,CAAA,CAAA,EAAa,CAAb,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAyB;IACvB,CAAF,CAAA;;;;;;;;;;;;KAYA,CAAA;IACE,CAAF,CAAI,EAAE,CAAC,CAAP,CAAA,CAAA,CAAA,CAAqB,EAAE,CAAvB,EAA0B,CAA1B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAkC,CAAC,CAAnC,CAAA,CAAsC,CAAC,CAAvC,CAAA,CAAA,CAAA,CAAyD,CAAC;AAC1D,CAAC;"}

package/errors/LocalStateError.d.ts

@@ -0,0 +1,56 @@
+export declare namespace LocalStateError {
+    interface Options {
+        path?: Array<string | number>;
+        sourceError?: unknown;
+    }
+    namespace DocumentationTypes {
+        interface InstanceProperties {
+            /** The path to the field that caused the error. */
+            readonly path?: Array<string | number>;
+        }
+    }
+}
+/**
+ * Represents a fatal error when executing `@client` fields from `LocalState`,
+ * typically to indicate a problem with the `LocalState` configuration or
+ * incorrect usage of a resolver function. This error does not represent user
+ * errors thrown in a local resolver when resolving `@client` fields.
+ *
+ * @example
+ *
+ * ```ts
+ * import { LocalStateError } from "@apollo/client/errors";
+ *
+ * // Check if an error is a LocalStateError instance
+ * if (LocalStateError.is(error)) {
+ *   console.log("Original error:", error.cause);
+ *
+ *   // Determine which field caused the error
+ *   if (error.path) {
+ *     console.log("Error occurred at field path:", error.path.join("."));
+ *   }
+ * }
+ * ```
+ */
+export declare class LocalStateError extends Error {
+    /**
+     * A method that determines whether an error is a `LocalStateError`
+     * object. This method enables TypeScript to narrow the error type.
+     *
+     * @example
+     *
+     * ```ts
+     * if (LocalStateError.is(error)) {
+     *   // TypeScript now knows `error` is a LocalStateError object
+     *   console.log(error.path);
+     * }
+     * ```
+     */
+    static is(error: unknown): error is LocalStateError;
+    /**
+    * The path to the field that caused the error.
+    */
+    readonly path?: Array<string | number>;
+    constructor(message: string, options?: LocalStateError.Options);
+}
+//# sourceMappingURL=LocalStateError.d.ts.map

package/errors/LocalStateError.js

@@ -0,0 +1,53 @@
+import { brand, isBranded } from "./utils.js";
+/**
+ * Represents a fatal error when executing `@client` fields from `LocalState`,
+ * typically to indicate a problem with the `LocalState` configuration or
+ * incorrect usage of a resolver function. This error does not represent user
+ * errors thrown in a local resolver when resolving `@client` fields.
+ *
+ * @example
+ *
+ * ```ts
+ * import { LocalStateError } from "@apollo/client/errors";
+ *
+ * // Check if an error is a LocalStateError instance
+ * if (LocalStateError.is(error)) {
+ *   console.log("Original error:", error.cause);
+ *
+ *   // Determine which field caused the error
+ *   if (error.path) {
+ *     console.log("Error occurred at field path:", error.path.join("."));
+ *   }
+ * }
+ * ```
+ */
+export class LocalStateError extends Error {
+    /**
+     * A method that determines whether an error is a `LocalStateError`
+     * object. This method enables TypeScript to narrow the error type.
+     *
+     * @example
+     *
+     * ```ts
+     * if (LocalStateError.is(error)) {
+     *   // TypeScript now knows `error` is a LocalStateError object
+     *   console.log(error.path);
+     * }
+     * ```
+     */
+    static is(error) {
+        return isBranded(error, "LocalStateError");
+    }
+    /**
+    * The path to the field that caused the error.
+    */
+    path;
+    constructor(message, options = {}) {
+        super(message, { cause: options.sourceError });
+        this.name = "LocalStateError";
+        this.path = options.path;
+        brand(this);
+        Object.setPrototypeOf(this, LocalStateError.prototype);
+    }
+}
+//# sourceMappingURL=LocalStateError.js.map

package/errors/LocalStateError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalStateError.js","sources":["../../src/errors/LocalStateError.ts"],"sourcesContent":["import { brand, isBranded } from \"./utils.js\";\n\nexport declare namespace LocalStateError {\n  export interface Options {\n    path?: Array<string | number>;\n    sourceError?: unknown;\n  }\n\n  namespace DocumentationTypes {\n    interface InstanceProperties {\n      /** The path to the field that caused the error. */\n      readonly path?: Array<string | number>;\n    }\n  }\n}\n\n/**\n * Represents a fatal error when executing `@client` fields from `LocalState`,\n * typically to indicate a problem with the `LocalState` configuration or\n * incorrect usage of a resolver function. This error does not represent user\n * errors thrown in a local resolver when resolving `@client` fields.\n *\n * @example\n *\n * ```ts\n * import { LocalStateError } from \"@apollo/client/errors\";\n *\n * // Check if an error is a LocalStateError instance\n * if (LocalStateError.is(error)) {\n *   console.log(\"Original error:\", error.cause);\n *\n *   // Determine which field caused the error\n *   if (error.path) {\n *     console.log(\"Error occurred at field path:\", error.path.join(\".\"));\n *   }\n * }\n * ```\n */\nexport class LocalStateError extends Error {\n  /**\n   * A method that determines whether an error is a `LocalStateError`\n   * object. This method enables TypeScript to narrow the error type.\n   *\n   * @example\n   *\n   * ```ts\n   * if (LocalStateError.is(error)) {\n   *   // TypeScript now knows `error` is a LocalStateError object\n   *   console.log(error.path);\n   * }\n   * ```\n   */\n  static is(error: unknown): error is LocalStateError {\n    return isBranded(error, \"LocalStateError\");\n  }\n\n  /** {@inheritDoc @apollo/client!LocalStateError.DocumentationTypes.InstanceProperties#path:member} */\n  readonly path?: Array<string | number>;\n\n  constructor(message: string, options: LocalStateError.Options = {}) {\n    super(message, { cause: options.sourceError });\n    this.name = \"LocalStateError\";\n    this.path = options.path;\n\n    brand(this);\n    Object.setPrototypeOf(this, LocalStateError.prototype);\n  }\n}\n"],"names":[],"mappings":"AAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAO,EAAE,CAAT,CAAA,CAAA,CAAA,CAAc,EAAE,CAAhB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,EAAiC,CAAjC,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAA6C;AAgB7C,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;CAqBA,CAAA;AACA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,EAAa,CAAb,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAqC,CAArC,CAAA,CAAA,CAAA,EAAA;IACE,CAAF,CAAA;;;;;;;;;;;;KAYA,CAAA;IACE,CAAF,CAAA,CAAA,CAAA,CAAA,EAAS,CAAT,CAAW,CAAC,CAAZ,CAAA,CAAA,CAAA,CAA0B,EAA1B;QACI,CAAJ,CAAA,CAAA,CAAA,CAAA,EAAW,CAAX,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAoB,CAAC,CAArB,CAAA,CAAA,CAAA,CAA0B,EAAE,CAA5B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAA6C,CAAC;IAC5C;;;;IAGS,CAAX,CAAA,CAAA,CAAe;IAEb,CAAF,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAc,CAAd,CAAA,CAAA,CAAA,CAAA,CAAA,CAA6B,EAAE,CAA/B,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAkE,CAAlE,CAAoE,EAApE;QACI,CAAJ,CAAA,CAAA,CAAA,CAAS,CAAC,CAAV,CAAA,CAAA,CAAA,CAAA,CAAA,CAAiB,EAAE,EAAE,CAArB,CAAA,CAAA,CAAA,CAA0B,EAAE,CAA5B,CAAA,CAAA,CAAA,CAAA,CAAA,CAAmC,CAAC,CAApC,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAiD,CAAC;QAC9C,CAAJ,CAAA,CAAA,CAAQ,CAAC,CAAT,CAAA,CAAA,EAAA,EAAgB,CAAhB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAiC;QAC7B,CAAJ,CAAA,CAAA,CAAQ,CAAC,CAAT,CAAA,CAAA,EAAA,EAAgB,CAAhB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAuB,CAAC,CAAxB,CAAA,CAAA,CAA4B;QAExB,CAAJ,CAAA,CAAA,CAAA,CAAS,CAAC,CAAV,CAAA,CAAA,CAAc,CAAC;QACX,CAAJ,CAAA,CAAA,CAAA,CAAA,CAAU,CAAC,CAAX,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAyB,CAAC,CAA1B,CAAA,CAAA,CAA8B,EAAE,CAAhC,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAA+C,CAAC,CAAhD,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAyD,CAAC;IACxD;AACF;"}

package/errors/ServerError.d.ts

@@ -0,0 +1,87 @@
+export declare namespace ServerError {
+    interface Options {
+        response: Response;
+        bodyText: string;
+    }
+    namespace DocumentationTypes {
+        interface InstanceProperties {
+            /**
+             * The raw [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response) object provided by the [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API).
+             */
+            readonly response: Response;
+            /**
+             * The status code returned by the server in the response. This is provided as
+             * a shortcut for `response.status`.
+             */
+            readonly statusCode: number;
+            /**
+             * The raw response body text.
+             */
+            readonly bodyText: string;
+        }
+    }
+}
+/**
+ * Represents an error when a non-200 HTTP status code is returned from the
+ * server according to the [GraphQL Over HTTP specification](https://graphql.github.io/graphql-over-http/draft/). This error
+ * contains the full server response, including status code and body text.
+ *
+ * @remarks
+ *
+ * This error occurs when your GraphQL server responds with an HTTP status code
+ * other than 200 (such as 4xx or 5xx status codes) with any media type other
+ * than [`application/graphql-response+json`](https://graphql.github.io/graphql-over-http/draft/#sec-application-graphql-response-json).
+ *
+ * Servers that return non-200 status codes with other media types are not
+ * guaranteed to contain a well-formed GraphQL response and may indicate issues
+ * at the HTTP level, such as authentication failures, server unavailability,
+ * or other HTTP-level problems.
+ *
+ * @example
+ *
+ * ```ts
+ * import { ServerError } from "@apollo/client/errors";
+ *
+ * // Check if an error is a ServerError instance
+ * if (ServerError.is(error)) {
+ *   console.log(`Server returned status: ${error.statusCode}`);
+ *   console.log(`Response body: ${error.bodyText}`);
+ *
+ *   // Handle specific status codes
+ *   if (error.statusCode === 401) {
+ *     // Handle unauthorized access
+ *   }
+ * }
+ * ```
+ */
+export declare class ServerError extends Error {
+    /**
+     * A method that determines whether an error is a `ServerError` object. This
+     * method enables TypeScript to narrow the error type.
+     *
+     * @example
+     *
+     * ```ts
+     * if (ServerError.is(error)) {
+     *   // TypeScript now knows `error` is a ServerError object
+     *   console.log(error.errors);
+     * }
+     * ```
+     */
+    static is(error: unknown): error is ServerError;
+    /**
+    * The raw [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response) object provided by the [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API).
+    */
+    readonly response: Response;
+    /**
+    * The status code returned by the server in the response. This is provided as
+    * a shortcut for `response.status`.
+    */
+    readonly statusCode: number;
+    /**
+    * The raw response body text.
+    */
+    readonly bodyText: string;
+    constructor(message: string, options: ServerError.Options);
+}
+//# sourceMappingURL=ServerError.d.ts.map

package/errors/ServerError.js

@@ -0,0 +1,75 @@
+import { brand, isBranded } from "./utils.js";
+/**
+ * Represents an error when a non-200 HTTP status code is returned from the
+ * server according to the [GraphQL Over HTTP specification](https://graphql.github.io/graphql-over-http/draft/). This error
+ * contains the full server response, including status code and body text.
+ *
+ * @remarks
+ *
+ * This error occurs when your GraphQL server responds with an HTTP status code
+ * other than 200 (such as 4xx or 5xx status codes) with any media type other
+ * than [`application/graphql-response+json`](https://graphql.github.io/graphql-over-http/draft/#sec-application-graphql-response-json).
+ *
+ * Servers that return non-200 status codes with other media types are not
+ * guaranteed to contain a well-formed GraphQL response and may indicate issues
+ * at the HTTP level, such as authentication failures, server unavailability,
+ * or other HTTP-level problems.
+ *
+ * @example
+ *
+ * ```ts
+ * import { ServerError } from "@apollo/client/errors";
+ *
+ * // Check if an error is a ServerError instance
+ * if (ServerError.is(error)) {
+ *   console.log(`Server returned status: ${error.statusCode}`);
+ *   console.log(`Response body: ${error.bodyText}`);
+ *
+ *   // Handle specific status codes
+ *   if (error.statusCode === 401) {
+ *     // Handle unauthorized access
+ *   }
+ * }
+ * ```
+ */
+export class ServerError extends Error {
+    /**
+     * A method that determines whether an error is a `ServerError` object. This
+     * method enables TypeScript to narrow the error type.
+     *
+     * @example
+     *
+     * ```ts
+     * if (ServerError.is(error)) {
+     *   // TypeScript now knows `error` is a ServerError object
+     *   console.log(error.errors);
+     * }
+     * ```
+     */
+    static is(error) {
+        return isBranded(error, "ServerError");
+    }
+    /**
+    * The raw [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response) object provided by the [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API).
+    */
+    response;
+    /**
+    * The status code returned by the server in the response. This is provided as
+    * a shortcut for `response.status`.
+    */
+    statusCode;
+    /**
+    * The raw response body text.
+    */
+    bodyText;
+    constructor(message, options) {
+        super(message);
+        this.name = "ServerError";
+        this.response = options.response;
+        this.statusCode = options.response.status;
+        this.bodyText = options.bodyText;
+        brand(this);
+        Object.setPrototypeOf(this, ServerError.prototype);
+    }
+}
+//# sourceMappingURL=ServerError.js.map

package/errors/ServerError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerError.js","sources":["../../src/errors/ServerError.ts"],"sourcesContent":["import { brand, isBranded } from \"./utils.js\";\n\nexport declare namespace ServerError {\n  export interface Options {\n    response: Response;\n    bodyText: string;\n  }\n\n  namespace DocumentationTypes {\n    interface InstanceProperties {\n      /**\n       * The raw [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response) object provided by the [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API).\n       */\n      readonly response: Response;\n      /**\n       * The status code returned by the server in the response. This is provided as\n       * a shortcut for `response.status`.\n       */\n      readonly statusCode: number;\n\n      /**\n       * The raw response body text.\n       */\n      readonly bodyText: string;\n    }\n  }\n}\n\n/**\n * Represents an error when a non-200 HTTP status code is returned from the\n * server according to the [GraphQL Over HTTP specification](https://graphql.github.io/graphql-over-http/draft/). This error\n * contains the full server response, including status code and body text.\n *\n * @remarks\n *\n * This error occurs when your GraphQL server responds with an HTTP status code\n * other than 200 (such as 4xx or 5xx status codes) with any media type other\n * than [`application/graphql-response+json`](https://graphql.github.io/graphql-over-http/draft/#sec-application-graphql-response-json).\n *\n * Servers that return non-200 status codes with other media types are not\n * guaranteed to contain a well-formed GraphQL response and may indicate issues\n * at the HTTP level, such as authentication failures, server unavailability,\n * or other HTTP-level problems.\n *\n * @example\n *\n * ```ts\n * import { ServerError } from \"@apollo/client/errors\";\n *\n * // Check if an error is a ServerError instance\n * if (ServerError.is(error)) {\n *   console.log(`Server returned status: ${error.statusCode}`);\n *   console.log(`Response body: ${error.bodyText}`);\n *\n *   // Handle specific status codes\n *   if (error.statusCode === 401) {\n *     // Handle unauthorized access\n *   }\n * }\n * ```\n */\nexport class ServerError extends Error {\n  /**\n   * A method that determines whether an error is a `ServerError` object. This\n   * method enables TypeScript to narrow the error type.\n   *\n   * @example\n   *\n   * ```ts\n   * if (ServerError.is(error)) {\n   *   // TypeScript now knows `error` is a ServerError object\n   *   console.log(error.errors);\n   * }\n   * ```\n   */\n  static is(error: unknown): error is ServerError {\n    return isBranded(error, \"ServerError\");\n  }\n\n  /** {@inheritDoc @apollo/client!ServerError.DocumentationTypes.InstanceProperties#response:member} */\n  readonly response: Response;\n\n  /** {@inheritDoc @apollo/client!ServerError.DocumentationTypes.InstanceProperties#statusCode:member} */\n  readonly statusCode: number;\n\n  /** {@inheritDoc @apollo/client!ServerError.DocumentationTypes.InstanceProperties#bodyText:member} */\n  readonly bodyText: string;\n\n  constructor(message: string, options: ServerError.Options) {\n    super(message);\n    this.name = \"ServerError\";\n    this.response = options.response;\n    this.statusCode = options.response.status;\n    this.bodyText = options.bodyText;\n\n    brand(this);\n    Object.setPrototypeOf(this, ServerError.prototype);\n  }\n}\n"],"names":[],"mappings":"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"}

package/errors/ServerParseError.d.ts

@@ -0,0 +1,82 @@
+export declare namespace ServerParseError {
+    interface Options {
+        response: Response;
+        bodyText: string;
+    }
+    namespace DocumentationTypes {
+        interface InstanceProperties {
+            /**
+             * The raw [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response) object provided by the [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API).
+             */
+            readonly response: Response;
+            /**
+             * The status code returned by the server in the response. This is provided
+             * as a shortcut for `response.status`.
+             */
+            readonly statusCode: number;
+            /**
+             * The raw response body text.
+             */
+            readonly bodyText: string;
+        }
+    }
+}
+/**
+ * Represents a failure to parse the response as JSON from the server. This
+ * error helps debug issues where the server returns malformed JSON or non-JSON
+ * content.
+ *
+ * @remarks
+ *
+ * This error occurs when Apollo Client receives a response from the server but
+ * cannot parse it as valid JSON. This typically happens when the server returns
+ * HTML error pages, plain text responses, or malformed JSON instead of the
+ * expected GraphQL JSON response format.
+ *
+ * @example
+ *
+ * ```ts
+ * import { ServerParseError } from "@apollo/client/errors";
+ *
+ * // Check if an error is a ServerParseError instance
+ * if (ServerParseError.is(error)) {
+ *   console.log(`Failed to parse response from ${error.response.url}`);
+ *   console.log(`Raw response: ${error.bodyText}`);
+ *   console.log(`Status code: ${error.statusCode}`);
+ *
+ *   // Access the original parse error
+ *   console.log(`Parse error: ${error.cause}`);
+ * }
+ * ```
+ */
+export declare class ServerParseError extends Error {
+    /**
+     * A method that determines whether an error is a `ServerParseError`
+     * object. This method enables TypeScript to narrow the error type.
+     *
+     * @example
+     *
+     * ```ts
+     * if (ServerParseError.is(error)) {
+     *   // TypeScript now knows `error` is a ServerParseError object
+     *   console.log(error.statusCode);
+     * }
+     * ```
+     */
+    static is(error: unknown): error is ServerParseError;
+    /**
+    * The raw [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response) object provided by the [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API).
+    */
+    readonly response: Response;
+    /**
+    * The status code returned by the server in the response. This is provided
+    * as a shortcut for `response.status`.
+    */
+    readonly statusCode: number;
+    /**
+    * The raw response body text.
+    */
+    readonly bodyText: string;
+    constructor(originalParseError: unknown, options: ServerParseError.Options);
+}
+//# sourceMappingURL=ServerParseError.d.ts.map