@depup/apollo__client 4.1.6-depup.0

package/errors/ServerParseError.js

@@ -0,0 +1,72 @@
+import { brand, isBranded } from "./utils.js";
+/**
+ * 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 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) {
+        return isBranded(error, "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).
+    */
+    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(originalParseError, options) {
+        super(originalParseError instanceof Error ?
+            originalParseError.message
+            : "Could not parse server response", { cause: originalParseError });
+        this.name = "ServerParseError";
+        this.response = options.response;
+        this.statusCode = options.response.status;
+        this.bodyText = options.bodyText;
+        brand(this);
+        Object.setPrototypeOf(this, ServerParseError.prototype);
+    }
+}
+//# sourceMappingURL=ServerParseError.js.map

package/errors/ServerParseError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerParseError.js","sources":["../../src/errors/ServerParseError.ts"],"sourcesContent":["import { brand, isBranded } from \"./utils.js\";\n\nexport declare namespace ServerParseError {\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\n       * as a shortcut for `response.status`.\n       */\n      readonly statusCode: number;\n      /**\n       * The raw response body text.\n       */\n      readonly bodyText: string;\n    }\n  }\n}\n\n/**\n * Represents a failure to parse the response as JSON from the server. This\n * error helps debug issues where the server returns malformed JSON or non-JSON\n * content.\n *\n * @remarks\n *\n * This error occurs when Apollo Client receives a response from the server but\n * cannot parse it as valid JSON. This typically happens when the server returns\n * HTML error pages, plain text responses, or malformed JSON instead of the\n * expected GraphQL JSON response format.\n *\n * @example\n *\n * ```ts\n * import { ServerParseError } from \"@apollo/client/errors\";\n *\n * // Check if an error is a ServerParseError instance\n * if (ServerParseError.is(error)) {\n *   console.log(`Failed to parse response from ${error.response.url}`);\n *   console.log(`Raw response: ${error.bodyText}`);\n *   console.log(`Status code: ${error.statusCode}`);\n *\n *   // Access the original parse error\n *   console.log(`Parse error: ${error.cause}`);\n * }\n * ```\n */\nexport class ServerParseError extends Error {\n  /**\n   * A method that determines whether an error is a `ServerParseError`\n   * object. This method enables TypeScript to narrow the error type.\n   *\n   * @example\n   *\n   * ```ts\n   * if (ServerParseError.is(error)) {\n   *   // TypeScript now knows `error` is a ServerParseError object\n   *   console.log(error.statusCode);\n   * }\n   * ```\n   */\n  static is(error: unknown): error is ServerParseError {\n    return isBranded(error, \"ServerParseError\");\n  }\n  /** {@inheritDoc @apollo/client!ServerParseError.DocumentationTypes.InstanceProperties#response:member} */\n  readonly response: Response;\n\n  /** {@inheritDoc @apollo/client!ServerParseError.DocumentationTypes.InstanceProperties#statusCode:member} */\n  readonly statusCode: number;\n\n  /** {@inheritDoc @apollo/client!ServerParseError.DocumentationTypes.InstanceProperties#bodyText:member} */\n  readonly bodyText: string;\n\n  constructor(originalParseError: unknown, options: ServerParseError.Options) {\n    super(\n      originalParseError instanceof Error ?\n        originalParseError.message\n      : \"Could not parse server response\",\n      { cause: originalParseError }\n    );\n    this.name = \"ServerParseError\";\n    this.response = options.response;\n    this.statusCode = options.response.status;\n    this.bodyText = options.bodyText;\n\n    brand(this);\n    Object.setPrototypeOf(this, ServerParseError.prototype);\n  }\n}\n"],"names":[],"mappings":"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"}

package/errors/UnconventionalError.d.ts

@@ -0,0 +1,55 @@
+/**
+ * A wrapper error type that represents a non-standard error thrown from a
+ * A wrapper error type that represents a non-error value thrown from the
+ * link chain, such as a symbol, primitive or plain object. Read the `cause` property to
+ * determine the source of the error.
+ *
+ * @remarks
+ *
+ * This error is used to standardize error handling when non-Error values are
+ * thrown in the Apollo Client link chain or other parts of the system.
+ * JavaScript allows throwing any value (not just Error instances), and this
+ * wrapper ensures that all thrown values can be handled consistently as
+ * Error-like objects while preserving the original thrown value.
+ *
+ * > [!NOTE]
+ * > Plain strings thrown as errors are wrapped in regular [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) objects instead of `UnconventionalError` objects since strings can be safely used as the error's `message`.
+ *
+ * @example
+ *
+ * ```ts
+ * import { UnconventionalError } from "@apollo/client/errors";
+ *
+ * // Check if an error is an UnconventionalError instance
+ * if (UnconventionalError.is(error)) {
+ *   console.log("Non-standard error thrown:", error.cause);
+ *
+ *   // Check the type of the original thrown value
+ *   if (typeof error.cause === "symbol") {
+ *     console.log("A symbol was thrown:", error.cause.toString());
+ *   } else if (typeof error.cause === "object") {
+ *     console.log("An object was thrown:", error.cause);
+ *   } else {
+ *     console.log("Unexpected value thrown:", error.cause);
+ *   }
+ * }
+ * ```
+ */
+export declare class UnconventionalError extends Error {
+    /**
+     * A method that determines whether an error is an `UnconventionalError`
+     * object. This method enables TypeScript to narrow the error type.
+     *
+     * @example
+     *
+     * ```ts
+     * if (UnconventionalError.is(error)) {
+     *   // TypeScript now knows `error` is a UnconventionalError object
+     *   console.log("What caused this?", error.cause);
+     * }
+     * ```
+     */
+    static is(error: unknown): error is UnconventionalError;
+    constructor(errorType: unknown);
+}
+//# sourceMappingURL=UnconventionalError.d.ts.map

package/errors/UnconventionalError.js

@@ -0,0 +1,63 @@
+import { brand, isBranded } from "./utils.js";
+/**
+ * A wrapper error type that represents a non-standard error thrown from a
+ * A wrapper error type that represents a non-error value thrown from the
+ * link chain, such as a symbol, primitive or plain object. Read the `cause` property to
+ * determine the source of the error.
+ *
+ * @remarks
+ *
+ * This error is used to standardize error handling when non-Error values are
+ * thrown in the Apollo Client link chain or other parts of the system.
+ * JavaScript allows throwing any value (not just Error instances), and this
+ * wrapper ensures that all thrown values can be handled consistently as
+ * Error-like objects while preserving the original thrown value.
+ *
+ * > [!NOTE]
+ * > Plain strings thrown as errors are wrapped in regular [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) objects instead of `UnconventionalError` objects since strings can be safely used as the error's `message`.
+ *
+ * @example
+ *
+ * ```ts
+ * import { UnconventionalError } from "@apollo/client/errors";
+ *
+ * // Check if an error is an UnconventionalError instance
+ * if (UnconventionalError.is(error)) {
+ *   console.log("Non-standard error thrown:", error.cause);
+ *
+ *   // Check the type of the original thrown value
+ *   if (typeof error.cause === "symbol") {
+ *     console.log("A symbol was thrown:", error.cause.toString());
+ *   } else if (typeof error.cause === "object") {
+ *     console.log("An object was thrown:", error.cause);
+ *   } else {
+ *     console.log("Unexpected value thrown:", error.cause);
+ *   }
+ * }
+ * ```
+ */
+export class UnconventionalError extends Error {
+    /**
+     * A method that determines whether an error is an `UnconventionalError`
+     * object. This method enables TypeScript to narrow the error type.
+     *
+     * @example
+     *
+     * ```ts
+     * if (UnconventionalError.is(error)) {
+     *   // TypeScript now knows `error` is a UnconventionalError object
+     *   console.log("What caused this?", error.cause);
+     * }
+     * ```
+     */
+    static is(error) {
+        return isBranded(error, "UnconventionalError");
+    }
+    constructor(errorType) {
+        super("An error of unexpected shape occurred.", { cause: errorType });
+        this.name = "UnconventionalError";
+        brand(this);
+        Object.setPrototypeOf(this, UnconventionalError.prototype);
+    }
+}
+//# sourceMappingURL=UnconventionalError.js.map

package/errors/UnconventionalError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnconventionalError.js","sourceRoot":"","sources":["../../src/errors/UnconventionalError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,CAAC,KAAc;QACtB,OAAO,SAAS,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;IACjD,CAAC;IAED,YAAY,SAAkB;QAC5B,KAAK,CAAC,wCAAwC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAElC,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACF","sourcesContent":["import { brand, isBranded } from \"./utils.js\";\n\n/**\n * A wrapper error type that represents a non-standard error thrown from a\n * A wrapper error type that represents a non-error value thrown from the\n * link chain, such as a symbol, primitive or plain object. Read the `cause` property to\n * determine the source of the error.\n *\n * @remarks\n *\n * This error is used to standardize error handling when non-Error values are\n * thrown in the Apollo Client link chain or other parts of the system.\n * JavaScript allows throwing any value (not just Error instances), and this\n * wrapper ensures that all thrown values can be handled consistently as\n * Error-like objects while preserving the original thrown value.\n *\n * > [!NOTE]\n * > Plain strings thrown as errors are wrapped in regular [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) objects instead of `UnconventionalError` objects since strings can be safely used as the error's `message`.\n *\n * @example\n *\n * ```ts\n * import { UnconventionalError } from \"@apollo/client/errors\";\n *\n * // Check if an error is an UnconventionalError instance\n * if (UnconventionalError.is(error)) {\n *   console.log(\"Non-standard error thrown:\", error.cause);\n *\n *   // Check the type of the original thrown value\n *   if (typeof error.cause === \"symbol\") {\n *     console.log(\"A symbol was thrown:\", error.cause.toString());\n *   } else if (typeof error.cause === \"object\") {\n *     console.log(\"An object was thrown:\", error.cause);\n *   } else {\n *     console.log(\"Unexpected value thrown:\", error.cause);\n *   }\n * }\n * ```\n */\nexport class UnconventionalError extends Error {\n  /**\n   * A method that determines whether an error is an `UnconventionalError`\n   * object. This method enables TypeScript to narrow the error type.\n   *\n   * @example\n   *\n   * ```ts\n   * if (UnconventionalError.is(error)) {\n   *   // TypeScript now knows `error` is a UnconventionalError object\n   *   console.log(\"What caused this?\", error.cause);\n   * }\n   * ```\n   */\n  static is(error: unknown): error is UnconventionalError {\n    return isBranded(error, \"UnconventionalError\");\n  }\n\n  constructor(errorType: unknown) {\n    super(\"An error of unexpected shape occurred.\", { cause: errorType });\n    this.name = \"UnconventionalError\";\n\n    brand(this);\n    Object.setPrototypeOf(this, UnconventionalError.prototype);\n  }\n}\n"]}

package/errors/index.d.ts

@@ -0,0 +1,14 @@
+export declare const PROTOCOL_ERRORS_SYMBOL: unique symbol;
+export declare function graphQLResultHasProtocolErrors<T extends {}>(result: T): result is T & {
+    extensions: Record<string | symbol, any>;
+};
+export declare function toErrorLike(error: unknown): import("@apollo/client").ErrorLike;
+export { CombinedGraphQLErrors } from "./CombinedGraphQLErrors.js";
+export { CombinedProtocolErrors } from "./CombinedProtocolErrors.js";
+export { isErrorLike } from "./isErrorLike.js";
+export { LinkError, registerLinkError } from "./LinkError.js";
+export { LocalStateError } from "./LocalStateError.js";
+export { ServerError } from "./ServerError.js";
+export { ServerParseError } from "./ServerParseError.js";
+export { UnconventionalError } from "./UnconventionalError.js";
+//# sourceMappingURL=index.d.ts.map

package/errors/index.js

@@ -0,0 +1,31 @@
+import { CombinedProtocolErrors } from "./CombinedProtocolErrors.js";
+import { isErrorLike } from "./isErrorLike.js";
+import { UnconventionalError } from "./UnconventionalError.js";
+// This Symbol allows us to pass transport-specific errors from the link chain
+// into QueryManager/client internals without risking a naming collision within
+// extensions (which implementers can use as they see fit).
+export const PROTOCOL_ERRORS_SYMBOL = Symbol();
+export function graphQLResultHasProtocolErrors(result) {
+    if ("extensions" in result) {
+        return CombinedProtocolErrors.is(result.extensions[PROTOCOL_ERRORS_SYMBOL]);
+    }
+    return false;
+}
+export function toErrorLike(error) {
+    if (isErrorLike(error)) {
+        return error;
+    }
+    if (typeof error === "string") {
+        return new Error(error, { cause: error });
+    }
+    return new UnconventionalError(error);
+}
+export { CombinedGraphQLErrors } from "./CombinedGraphQLErrors.js";
+export { CombinedProtocolErrors } from "./CombinedProtocolErrors.js";
+export { isErrorLike } from "./isErrorLike.js";
+export { LinkError, registerLinkError } from "./LinkError.js";
+export { LocalStateError } from "./LocalStateError.js";
+export { ServerError } from "./ServerError.js";
+export { ServerParseError } from "./ServerParseError.js";
+export { UnconventionalError } from "./UnconventionalError.js";
+//# sourceMappingURL=index.js.map

package/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,8EAA8E;AAC9E,+EAA+E;AAC/E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,sBAAsB,GAAkB,MAAM,EAAE,CAAC;AAM9D,MAAM,UAAU,8BAA8B,CAC5C,MAAS;IAIT,IAAI,YAAY,IAAI,MAAM,EAAE,CAAC;QAC3B,OAAO,sBAAsB,CAAC,EAAE,CAC7B,MAAkC,CAAC,UAAU,CAAC,sBAAsB,CAAC,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["import { CombinedProtocolErrors } from \"./CombinedProtocolErrors.js\";\nimport { isErrorLike } from \"./isErrorLike.js\";\nimport { UnconventionalError } from \"./UnconventionalError.js\";\n\n// This Symbol allows us to pass transport-specific errors from the link chain\n// into QueryManager/client internals without risking a naming collision within\n// extensions (which implementers can use as they see fit).\nexport const PROTOCOL_ERRORS_SYMBOL: unique symbol = Symbol();\n\ntype WithSymbolExtensions<T> = T & {\n  extensions: Record<string | symbol, any>;\n};\n\nexport function graphQLResultHasProtocolErrors<T extends {}>(\n  result: T\n): result is T & {\n  extensions: Record<string | symbol, any>;\n} {\n  if (\"extensions\" in result) {\n    return CombinedProtocolErrors.is(\n      (result as WithSymbolExtensions<T>).extensions[PROTOCOL_ERRORS_SYMBOL]\n    );\n  }\n  return false;\n}\n\nexport function toErrorLike(error: unknown) {\n  if (isErrorLike(error)) {\n    return error;\n  }\n\n  if (typeof error === \"string\") {\n    return new Error(error, { cause: error });\n  }\n\n  return new UnconventionalError(error);\n}\n\nexport { CombinedGraphQLErrors } from \"./CombinedGraphQLErrors.js\";\nexport { CombinedProtocolErrors } from \"./CombinedProtocolErrors.js\";\nexport { isErrorLike } from \"./isErrorLike.js\";\nexport { LinkError, registerLinkError } from \"./LinkError.js\";\nexport { LocalStateError } from \"./LocalStateError.js\";\nexport { ServerError } from \"./ServerError.js\";\nexport { ServerParseError } from \"./ServerParseError.js\";\nexport { UnconventionalError } from \"./UnconventionalError.js\";\n"]}

package/errors/isErrorLike.d.ts

@@ -0,0 +1,3 @@
+import type { ErrorLike } from "@apollo/client";
+export declare function isErrorLike(error: unknown): error is ErrorLike;
+//# sourceMappingURL=isErrorLike.d.ts.map

package/errors/isErrorLike.js

@@ -0,0 +1,9 @@
+export function isErrorLike(error) {
+    return (error !== null &&
+        typeof error === "object" &&
+        typeof error.message === "string" &&
+        typeof error.name === "string" &&
+        (typeof error.stack === "string" ||
+            typeof error.stack === "undefined"));
+}
+//# sourceMappingURL=isErrorLike.js.map

package/errors/isErrorLike.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isErrorLike.js","sourceRoot":"","sources":["../../src/errors/isErrorLike.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAQ,KAAmB,CAAC,OAAO,KAAK,QAAQ;QAChD,OAAQ,KAAmB,CAAC,IAAI,KAAK,QAAQ;QAC7C,CAAC,OAAQ,KAAmB,CAAC,KAAK,KAAK,QAAQ;YAC7C,OAAQ,KAAmB,CAAC,KAAK,KAAK,WAAW,CAAC,CACrD,CAAC;AACJ,CAAC","sourcesContent":["import type { ErrorLike } from \"@apollo/client\";\n\nexport function isErrorLike(error: unknown): error is ErrorLike {\n  return (\n    error !== null &&\n    typeof error === \"object\" &&\n    typeof (error as ErrorLike).message === \"string\" &&\n    typeof (error as ErrorLike).name === \"string\" &&\n    (typeof (error as ErrorLike).stack === \"string\" ||\n      typeof (error as ErrorLike).stack === \"undefined\")\n  );\n}\n"]}

package/errors/utils.d.ts

@@ -0,0 +1,3 @@
+export declare function isBranded(error: unknown, name: string): boolean;
+export declare function brand(error: Error): void;
+//# sourceMappingURL=utils.d.ts.map

package/errors/utils.js

@@ -0,0 +1,14 @@
+export function isBranded(error, name) {
+    return (typeof error === "object" &&
+        error !== null &&
+        error[Symbol.for("apollo.error")] === name);
+}
+export function brand(error) {
+    Object.defineProperty(error, Symbol.for("apollo.error"), {
+        value: error.name,
+        enumerable: false,
+        writable: false,
+        configurable: false,
+    });
+}
+//# sourceMappingURL=utils.js.map

package/errors/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/errors/utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,IAAY;IACpD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAa,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,KAAK,IAAI,CACpD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,KAAY;IAChC,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE;QACvD,KAAK,EAAE,KAAK,CAAC,IAAI;QACjB,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;AACL,CAAC","sourcesContent":["export function isBranded(error: unknown, name: string) {\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    (error as any)[Symbol.for(\"apollo.error\")] === name\n  );\n}\n\nexport function brand(error: Error) {\n  Object.defineProperty(error, Symbol.for(\"apollo.error\"), {\n    value: error.name,\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  });\n}\n"]}

package/incremental/handlers/defer20220824.d.ts

@@ -0,0 +1,66 @@
+import type { DocumentNode, FormattedExecutionResult, GraphQLFormattedError } from "graphql";
+import type { ApolloLink } from "@apollo/client/link";
+import type { DeepPartial, HKT } from "@apollo/client/utilities";
+import type { Incremental } from "../types.js";
+export declare namespace Defer20220824Handler {
+    interface Defer20220824Result extends HKT {
+        arg1: unknown;
+        arg2: unknown;
+        return: Defer20220824Handler.Chunk<Record<string, unknown>>;
+    }
+    interface TypeOverrides {
+        AdditionalApolloLinkResultTypes: Defer20220824Result;
+    }
+    type InitialResult<TData = Record<string, unknown>> = {
+        data?: TData | null | undefined;
+        errors?: ReadonlyArray<GraphQLFormattedError>;
+        extensions?: Record<string, unknown>;
+        hasNext: boolean;
+        incremental?: ReadonlyArray<IncrementalResult<TData>>;
+    };
+    type SubsequentResult<TData = Record<string, unknown>> = {
+        extensions?: Record<string, unknown>;
+        hasNext: boolean;
+        incremental?: Array<IncrementalResult<TData>>;
+    };
+    type IncrementalDeferResult<TData = Record<string, unknown>> = {
+        data?: TData | null;
+        errors?: ReadonlyArray<GraphQLFormattedError>;
+        extensions?: Record<string, unknown>;
+        path?: Incremental.Path;
+        label?: string;
+    };
+    type IncrementalStreamResult<TData = Array<unknown>> = {
+        errors?: ReadonlyArray<GraphQLFormattedError>;
+        items?: TData;
+        path?: Incremental.Path;
+        label?: string;
+        extensions?: Record<string, unknown>;
+    };
+    type IncrementalResult<TData = Record<string, unknown>> = IncrementalDeferResult<TData> | IncrementalStreamResult<TData>;
+    type Chunk<TData extends Record<string, unknown>> = InitialResult<TData> | SubsequentResult<TData>;
+}
+declare class DeferRequest<TData extends Record<string, unknown>> implements Incremental.IncrementalRequest<Defer20220824Handler.Chunk<TData>, TData> {
+    hasNext: boolean;
+    private errors;
+    private extensions;
+    private data;
+    private ignoredImpossibleStreamPaths;
+    private merge;
+    handle(cacheData: TData | DeepPartial<TData> | null | undefined, chunk: Defer20220824Handler.Chunk<TData>): FormattedExecutionResult<TData>;
+}
+/**
+ * This handler implements the `@defer` directive as specified in this historical commit:
+ * https://github.com/graphql/graphql-spec/tree/48cf7263a71a683fab03d45d309fd42d8d9a6659/spec
+ */
+export declare class Defer20220824Handler implements Incremental.Handler<Defer20220824Handler.Chunk<any>> {
+    isIncrementalResult(result: Record<string, any>): result is Defer20220824Handler.SubsequentResult | Defer20220824Handler.InitialResult;
+    extractErrors(result: ApolloLink.Result<any>): GraphQLFormattedError[] | undefined;
+    prepareRequest(request: ApolloLink.Request): ApolloLink.Request;
+    startRequest<TData extends Record<string, unknown>>(_: {
+        query: DocumentNode;
+    }): DeferRequest<TData>;
+}
+export declare function hasIncrementalChunks(result: Record<string, any>): result is Required<Defer20220824Handler.SubsequentResult>;
+export {};
+//# sourceMappingURL=defer20220824.d.ts.map

package/incremental/handlers/defer20220824.js

@@ -0,0 +1,122 @@
+import { DeepMerger, hasDirectives, isNonEmptyArray, } from "@apollo/client/utilities/internal";
+class DeferRequest {
+    hasNext = true;
+    errors = [];
+    extensions = {};
+    data = {};
+    // This tracks paths for `@stream` arrays that returns items: null due to
+    // errors thrown for non-null array items. We stop processing future updates
+    // to these stream arrays to prevent creating sparse arrays or inserting
+    // `null` for an expected non-null value which could cause runtime crashes.
+    ignoredImpossibleStreamPaths = new Set();
+    merge(normalized, atPath) {
+        if (normalized.data !== undefined) {
+            this.data = new DeepMerger({ arrayMerge: "truncate" }).merge(this.data, normalized.data, { atPath });
+        }
+        if (normalized.errors) {
+            this.errors.push(...normalized.errors);
+        }
+        Object.assign(this.extensions, normalized.extensions);
+    }
+    handle(
+    // we'll get `undefined` here in case of a `no-cache` fetch policy,
+    // so we'll continue with the last value this request had accumulated
+    cacheData = this.data, chunk) {
+        this.hasNext = chunk.hasNext;
+        this.data = cacheData;
+        if (hasIncrementalChunks(chunk)) {
+            for (const incremental of chunk.incremental) {
+                const { path, errors, extensions } = incremental;
+                if ("items" in incremental) {
+                    // Remove the array index from the end of the array since each future
+                    // chunk sends a different array index. This normalizes the path to
+                    // ensure we ignore updates to this field if `items` is `null`.
+                    const stringPath = path?.slice(0, -1).join(".") ?? "";
+                    if (incremental.items === null) {
+                        this.ignoredImpossibleStreamPaths.add(stringPath);
+                    }
+                    if (this.ignoredImpossibleStreamPaths.has(stringPath)) {
+                        this.merge({ errors, extensions });
+                        continue;
+                    }
+                }
+                let data = "items" in incremental ? incremental.items
+                    // Ensure `data: null` isn't merged for `@defer` responses by
+                    // falling back to `undefined`
+                    : "data" in incremental ? incremental.data ?? undefined
+                        : undefined;
+                if (path && typeof path.at(-1) === "number" && Array.isArray(data)) {
+                    const startingIdx = path.at(-1);
+                    data.forEach((item, idx) => {
+                        this.merge({ data: item }, [
+                            ...path.slice(0, -1),
+                            startingIdx + idx,
+                        ]);
+                    });
+                }
+                else {
+                    this.merge({ data }, path);
+                }
+                this.merge({ errors, extensions });
+            }
+        }
+        else {
+            this.merge(chunk);
+        }
+        const result = { data: this.data };
+        if (isNonEmptyArray(this.errors)) {
+            result.errors = this.errors;
+        }
+        if (Object.keys(this.extensions).length > 0) {
+            result.extensions = this.extensions;
+        }
+        return result;
+    }
+}
+/**
+ * This handler implements the `@defer` directive as specified in this historical commit:
+ * https://github.com/graphql/graphql-spec/tree/48cf7263a71a683fab03d45d309fd42d8d9a6659/spec
+ */
+export class Defer20220824Handler {
+    isIncrementalResult(result) {
+        return "hasNext" in result;
+    }
+    extractErrors(result) {
+        const acc = [];
+        const push = ({ errors, }) => {
+            if (errors) {
+                acc.push(...errors);
+            }
+        };
+        if (this.isIncrementalResult(result)) {
+            if ("errors" in result) {
+                push(result);
+            }
+            if (hasIncrementalChunks(result)) {
+                result.incremental.forEach(push);
+            }
+        }
+        if (acc.length) {
+            return acc;
+        }
+    }
+    prepareRequest(request) {
+        if (hasDirectives(["defer", "stream"], request.query)) {
+            const context = request.context ?? {};
+            const http = (context.http ??= {});
+            http.accept = [
+                "multipart/mixed;deferSpec=20220824",
+                ...(http.accept || []),
+            ];
+        }
+        return request;
+    }
+    startRequest(_) {
+        return new DeferRequest();
+    }
+}
+// only exported for use in tests
+export function hasIncrementalChunks(result) {
+    return isNonEmptyArray(result.incremental);
+}
+//# sourceMappingURL=defer20220824.js.map

package/incremental/handlers/defer20220824.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defer20220824.js","sourceRoot":"","sources":["../../../src/incremental/handlers/defer20220824.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  DocumentNode,\n  FormattedExecutionResult,\n  GraphQLFormattedError,\n} from \"graphql\";\n\nimport type { ApolloLink } from \"@apollo/client/link\";\nimport type { DeepPartial, HKT } from \"@apollo/client/utilities\";\nimport {\n  DeepMerger,\n  hasDirectives,\n  isNonEmptyArray,\n} from \"@apollo/client/utilities/internal\";\n\nimport type { Incremental } from \"../types.js\";\n\nexport declare namespace Defer20220824Handler {\n  interface Defer20220824Result extends HKT {\n    arg1: unknown; // TData\n    arg2: unknown; // TExtensions\n    return: Defer20220824Handler.Chunk<Record<string, unknown>>;\n  }\n  export interface TypeOverrides {\n    AdditionalApolloLinkResultTypes: Defer20220824Result;\n  }\n\n  export type InitialResult<TData = Record<string, unknown>> = {\n    data?: TData | null | undefined;\n    errors?: ReadonlyArray<GraphQLFormattedError>;\n    extensions?: Record<string, unknown>;\n    hasNext: boolean;\n    incremental?: ReadonlyArray<IncrementalResult<TData>>;\n  };\n\n  export type SubsequentResult<TData = Record<string, unknown>> = {\n    extensions?: Record<string, unknown>;\n    hasNext: boolean;\n    incremental?: Array<IncrementalResult<TData>>;\n  };\n\n  export type IncrementalDeferResult<TData = Record<string, unknown>> = {\n    data?: TData | null;\n    errors?: ReadonlyArray<GraphQLFormattedError>;\n    extensions?: Record<string, unknown>;\n    path?: Incremental.Path;\n    label?: string;\n  };\n\n  export type IncrementalStreamResult<TData = Array<unknown>> = {\n    errors?: ReadonlyArray<GraphQLFormattedError>;\n    items?: TData;\n    path?: Incremental.Path;\n    label?: string;\n    extensions?: Record<string, unknown>;\n  };\n\n  export type IncrementalResult<TData = Record<string, unknown>> =\n    | IncrementalDeferResult<TData>\n    | IncrementalStreamResult<TData>;\n\n  export type Chunk<TData extends Record<string, unknown>> =\n    | InitialResult<TData>\n    | SubsequentResult<TData>;\n}\n\nclass DeferRequest<TData extends Record<string, unknown>>\n  implements\n    Incremental.IncrementalRequest<Defer20220824Handler.Chunk<TData>, TData>\n{\n  public hasNext = true;\n\n  private errors: Array<GraphQLFormattedError> = [];\n  private extensions: Record<string, any> = {};\n  private data: any = {};\n  // This tracks paths for `@stream` arrays that returns items: null due to\n  // errors thrown for non-null array items. We stop processing future updates\n  // to these stream arrays to prevent creating sparse arrays or inserting\n  // `null` for an expected non-null value which could cause runtime crashes.\n  private ignoredImpossibleStreamPaths = new Set<string>();\n\n  private merge(\n    normalized: FormattedExecutionResult<TData>,\n    atPath?: DeepMerger.MergeOptions[\"atPath\"]\n  ) {\n    if (normalized.data !== undefined) {\n      this.data = new DeepMerger({ arrayMerge: \"truncate\" }).merge(\n        this.data,\n        normalized.data,\n        { atPath }\n      );\n    }\n    if (normalized.errors) {\n      this.errors.push(...normalized.errors);\n    }\n    Object.assign(this.extensions, normalized.extensions);\n  }\n\n  handle(\n    // we'll get `undefined` here in case of a `no-cache` fetch policy,\n    // so we'll continue with the last value this request had accumulated\n    cacheData: TData | DeepPartial<TData> | null | undefined = this.data,\n    chunk: Defer20220824Handler.Chunk<TData>\n  ): FormattedExecutionResult<TData> {\n    this.hasNext = chunk.hasNext;\n    this.data = cacheData;\n\n    if (hasIncrementalChunks(chunk)) {\n      for (const incremental of chunk.incremental) {\n        const { path, errors, extensions } = incremental;\n\n        if (\"items\" in incremental) {\n          // Remove the array index from the end of the array since each future\n          // chunk sends a different array index. This normalizes the path to\n          // ensure we ignore updates to this field if `items` is `null`.\n          const stringPath = path?.slice(0, -1).join(\".\") ?? \"\";\n\n          if (incremental.items === null) {\n            this.ignoredImpossibleStreamPaths.add(stringPath);\n          }\n\n          if (this.ignoredImpossibleStreamPaths.has(stringPath)) {\n            this.merge({ errors, extensions });\n            continue;\n          }\n        }\n\n        let data: any =\n          \"items\" in incremental ? incremental.items\n            // Ensure `data: null` isn't merged for `@defer` responses by\n            // falling back to `undefined`\n          : \"data\" in incremental ? incremental.data ?? undefined\n          : undefined;\n\n        if (path && typeof path.at(-1) === \"number\" && Array.isArray(data)) {\n          const startingIdx = path.at(-1) as number;\n          data.forEach((item, idx) => {\n            this.merge({ data: item }, [\n              ...path!.slice(0, -1),\n              startingIdx + idx,\n            ]);\n          });\n        } else {\n          this.merge({ data }, path);\n        }\n\n        this.merge({ errors, extensions });\n      }\n    } else {\n      this.merge(chunk);\n    }\n\n    const result: FormattedExecutionResult<TData> = { data: this.data };\n\n    if (isNonEmptyArray(this.errors)) {\n      result.errors = this.errors;\n    }\n\n    if (Object.keys(this.extensions).length > 0) {\n      result.extensions = this.extensions;\n    }\n\n    return result;\n  }\n}\n\n/**\n * This handler implements the `@defer` directive as specified in this historical commit:\n * https://github.com/graphql/graphql-spec/tree/48cf7263a71a683fab03d45d309fd42d8d9a6659/spec\n */\nexport class Defer20220824Handler\n  implements Incremental.Handler<Defer20220824Handler.Chunk<any>>\n{\n  isIncrementalResult(\n    result: Record<string, any>\n  ): result is\n    | Defer20220824Handler.SubsequentResult\n    | Defer20220824Handler.InitialResult {\n    return \"hasNext\" in result;\n  }\n\n  extractErrors(result: ApolloLink.Result<any>) {\n    const acc: GraphQLFormattedError[] = [];\n    const push = ({\n      errors,\n    }: {\n      errors?: ReadonlyArray<GraphQLFormattedError>;\n    }) => {\n      if (errors) {\n        acc.push(...errors);\n      }\n    };\n    if (this.isIncrementalResult(result)) {\n      if (\"errors\" in result) {\n        push(result);\n      }\n      if (hasIncrementalChunks(result)) {\n        result.incremental.forEach(push);\n      }\n    }\n    if (acc.length) {\n      return acc;\n    }\n  }\n\n  prepareRequest(request: ApolloLink.Request): ApolloLink.Request {\n    if (hasDirectives([\"defer\", \"stream\"], request.query)) {\n      const context = request.context ?? {};\n      const http = (context.http ??= {});\n      http.accept = [\n        \"multipart/mixed;deferSpec=20220824\",\n        ...(http.accept || []),\n      ];\n    }\n\n    return request;\n  }\n  startRequest<TData extends Record<string, unknown>>(_: {\n    query: DocumentNode;\n  }) {\n    return new DeferRequest<TData>();\n  }\n}\n\n// only exported for use in tests\nexport function hasIncrementalChunks(\n  result: Record<string, any>\n): result is Required<Defer20220824Handler.SubsequentResult> {\n  return isNonEmptyArray(result.incremental);\n}\n"]}

package/incremental/handlers/graphql17Alpha9.d.ts

@@ -0,0 +1,98 @@
+import type { DocumentNode, FormattedExecutionResult, GraphQLFormattedError } from "graphql";
+import type { ApolloLink } from "@apollo/client/link";
+import type { DeepPartial, HKT } from "@apollo/client/utilities";
+import type { Incremental } from "../types.js";
+export declare namespace GraphQL17Alpha9Handler {
+    interface GraphQL17Alpha9Result extends HKT {
+        arg1: unknown;
+        arg2: unknown;
+        return: GraphQL17Alpha9Handler.Chunk<Record<string, unknown>>;
+    }
+    interface TypeOverrides {
+        AdditionalApolloLinkResultTypes: GraphQL17Alpha9Result;
+    }
+    type InitialResult<TData = Record<string, unknown>> = {
+        data: TData;
+        errors?: ReadonlyArray<GraphQLFormattedError>;
+        pending: ReadonlyArray<PendingResult>;
+        hasNext: boolean;
+        extensions?: Record<string, unknown>;
+    };
+    type SubsequentResult<TData = unknown> = {
+        hasNext: boolean;
+        pending?: ReadonlyArray<PendingResult>;
+        incremental?: ReadonlyArray<IncrementalResult<TData>>;
+        completed?: ReadonlyArray<CompletedResult>;
+        extensions?: Record<string, unknown>;
+    };
+    interface PendingResult {
+        id: string;
+        path: Incremental.Path;
+        label?: string;
+    }
+    interface CompletedResult {
+        id: string;
+        errors?: ReadonlyArray<GraphQLFormattedError>;
+    }
+    interface IncrementalDeferResult<TData = Record<string, unknown>> {
+        errors?: ReadonlyArray<GraphQLFormattedError>;
+        data: TData;
+        id: string;
+        subPath?: Incremental.Path;
+        extensions?: Record<string, unknown>;
+    }
+    interface IncrementalStreamResult<TData = ReadonlyArray<unknown>> {
+        errors?: ReadonlyArray<GraphQLFormattedError>;
+        items: TData;
+        id: string;
+        subPath?: Incremental.Path;
+        extensions?: Record<string, unknown>;
+    }
+    type IncrementalResult<TData = unknown> = IncrementalDeferResult<TData> | IncrementalStreamResult<TData>;
+    type Chunk<TData> = InitialResult<TData> | SubsequentResult<TData>;
+}
+declare class IncrementalRequest<TData> implements Incremental.IncrementalRequest<GraphQL17Alpha9Handler.Chunk<TData>, TData> {
+    hasNext: boolean;
+    private data;
+    private errors;
+    private extensions;
+    private pending;
+    private streamInfo;
+    private streamPositions;
+    handle(cacheData: TData | DeepPartial<TData> | null | undefined, chunk: GraphQL17Alpha9Handler.Chunk<TData>): FormattedExecutionResult<TData>;
+    private merge;
+}
+/**
+ * Provides handling for the incremental delivery specification implemented by
+ * graphql.js version `17.0.0-alpha.9`.
+ */
+export declare class GraphQL17Alpha9Handler implements Incremental.Handler<GraphQL17Alpha9Handler.Chunk<any>> {
+    /**
+    * @internal
+    * 
+    * @deprecated This is an internal API and should not be used directly. This can be removed or changed at any time.
+    */
+    isIncrementalResult(result: ApolloLink.Result<any>): result is GraphQL17Alpha9Handler.InitialResult | GraphQL17Alpha9Handler.SubsequentResult;
+    /**
+    * @internal
+    * 
+    * @deprecated This is an internal API and should not be used directly. This can be removed or changed at any time.
+    */
+    prepareRequest(request: ApolloLink.Request): ApolloLink.Request;
+    /**
+    * @internal
+    * 
+    * @deprecated This is an internal API and should not be used directly. This can be removed or changed at any time.
+    */
+    extractErrors(result: ApolloLink.Result<any>): GraphQLFormattedError[] | undefined;
+    /**
+    * @internal
+    * 
+    * @deprecated This is an internal API and should not be used directly. This can be removed or changed at any time.
+    */
+    startRequest<TData>(_: {
+        query: DocumentNode;
+    }): IncrementalRequest<TData>;
+}
+export {};
+//# sourceMappingURL=graphql17Alpha9.d.ts.map