@apollo/client 3.13.7 → 3.13.9-rc.0

package/__cjs/utilities/DeepPartial.d.cts

@@ -0,0 +1,15 @@
+import type { Primitive } from "@apollo/client/utilities/internal";
+type DeepPartialPrimitive = Primitive | Date | RegExp;
+/**
+ * Deeply makes all properties in `T` optional.
+ */
+export type DeepPartial<T> = T extends DeepPartialPrimitive ? T : T extends Map<infer TKey, infer TValue> ? DeepPartialMap<TKey, TValue> : T extends ReadonlyMap<infer TKey, infer TValue> ? DeepPartialReadonlyMap<TKey, TValue> : T extends Set<infer TItem> ? DeepPartialSet<TItem> : T extends ReadonlySet<infer TItem> ? DeepPartialReadonlySet<TItem> : T extends (...args: any[]) => unknown ? T | undefined : T extends object ? T extends (ReadonlyArray<infer TItem>) ? TItem[] extends (T) ? readonly TItem[] extends T ? ReadonlyArray<DeepPartial<TItem | undefined>> : Array<DeepPartial<TItem | undefined>> : DeepPartialObject<T> : DeepPartialObject<T> : unknown;
+type DeepPartialMap<TKey, TValue> = {} & Map<DeepPartial<TKey>, DeepPartial<TValue>>;
+type DeepPartialReadonlyMap<TKey, TValue> = {} & ReadonlyMap<DeepPartial<TKey>, DeepPartial<TValue>>;
+type DeepPartialSet<T> = {} & Set<DeepPartial<T>>;
+type DeepPartialReadonlySet<T> = {} & ReadonlySet<DeepPartial<T>>;
+type DeepPartialObject<T extends object> = {
+    [K in keyof T]?: DeepPartial<T[K]>;
+};
+export {};
+//# sourceMappingURL=DeepPartial.d.cts.map

package/__cjs/utilities/HKT.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=HKT.cjs.map

package/__cjs/utilities/HKT.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"HKT.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/__cjs/utilities/HKT.d.cts

@@ -0,0 +1,35 @@
+/**
+ * A helper interface to implement Higher-Kinded-Types (HKT) in TypeScript.
+ *
+ * @example
+ * For example usage, see `src/masking/GraphQLCodegenDataMasking.ts`.
+ *
+ * @beta
+ * The Higher-Kinded-Types implementation might change between minor versions,
+ * as we discover ways of making it more performant and/or our requirements to
+ * the HKT implementation change.
+ *
+ * We still want to encourage you to provide your own implementations of the types
+ * we make overridable this way, but keep in mind that this might require some
+ * extra work updating.
+ *
+ * @example
+ * ```ts
+ *   interface Concat extends HKT {
+ *     arg1: string;
+ *     arg2: string;
+ *     return: `${this["arg1"]}${this["arg2"]}`;
+ *   }
+ *
+ *   type Result = ApplyHKT<Concat, "Hello, ", "world!">;
+ *   // Result is "Hello, world!"
+ * ```
+ */
+export interface HKT {
+    arg1: unknown;
+    arg2: unknown;
+    arg3: unknown;
+    arg4: unknown;
+    return: unknown;
+}
+//# sourceMappingURL=HKT.d.cts.map

package/__cjs/utilities/caching/index.cjs

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cacheSizes = void 0;
+var sizes_js_1 = require("./sizes.cjs");
+Object.defineProperty(exports, "cacheSizes", { enumerable: true, get: function () { return sizes_js_1.cacheSizes; } });
+//# sourceMappingURL=index.cjs.map

package/__cjs/utilities/caching/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../../src/utilities/caching/index.ts"],"sourcesContent":["export type { CacheSizes } from \"./sizes.js\";\nexport { cacheSizes, defaultCacheSizes } from \"./sizes.js\";\n"],"names":[],"mappings":";;;AACA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAAS,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAS,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAmB,EAAnB,EAAA,CAAA,CAAA;"}

package/__cjs/utilities/caching/index.d.cts

@@ -0,0 +1,3 @@
+export type { CacheSizes } from "./sizes.cjs";
+export { cacheSizes, defaultCacheSizes } from "./sizes.cjs";
+//# sourceMappingURL=index.d.cts.map

package/__cjs/utilities/caching/sizes.cjs

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cacheSizes = void 0;
+const globals_1 = require("@apollo/client/utilities/internal/globals");
+const cacheSizeSymbol = Symbol.for("apollo.cacheSize");
+/**
+ *
+ * The global cache size configuration for Apollo Client.
+ *
+ * @remarks
+ *
+ * You can directly modify this object, but any modification will
+ * only have an effect on caches that are created after the modification.
+ *
+ * So for global caches, such as `canonicalStringify` and `print`,
+ * you might need to call `.reset` on them, which will essentially re-create them.
+ *
+ * Alternatively, you can set `globalThis[Symbol.for("apollo.cacheSize")]` before
+ * you load the Apollo Client package:
+ *
+ * @example
+ * ```ts
+ * globalThis[Symbol.for("apollo.cacheSize")] = {
+ *   print: 100
+ * } satisfies Partial<CacheSizes> // the `satisfies` is optional if using TypeScript
+ * ```
+ */
+exports.cacheSizes = { ...globals_1.global[cacheSizeSymbol] };
+//# sourceMappingURL=sizes.cjs.map

package/__cjs/utilities/caching/sizes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sizes.cjs","sources":["../../../../src/utilities/caching/sizes.ts"],"sourcesContent":["import { global } from \"@apollo/client/utilities/internal/globals\";\n\ndeclare global {\n  interface Window {\n    [cacheSizeSymbol]?: Partial<CacheSizes>;\n  }\n}\n\n/**\n * The cache sizes used by various Apollo Client caches.\n *\n * @remarks\n * All configurable caches hold memoized values. If an item is\n * cache-collected, it incurs only a small performance impact and\n * doesn't cause data loss. A smaller cache size might save you memory.\n *\n * You should choose cache sizes appropriate for storing a reasonable\n * number of values rather than every value. To prevent too much recalculation,\n * choose cache sizes that are at least large enough to hold memoized values for\n * all hooks/queries on the screen at any given time.\n */\n/*\n * We assume a \"base value\" of 1000 here, which is already very generous.\n * In most applications, it will be very unlikely that 1000 different queries\n * are on screen at the same time.\n */\nexport interface CacheSizes {\n  /**\n   * Cache size for the [`print`](https://github.com/apollographql/apollo-client/blob/main/src/utilities/graphql/print.ts) function.\n   *\n   * It is called with transformed `DocumentNode`s.\n   *\n   * @defaultValue\n   * Defaults to `2000`.\n   *\n   * @remarks\n   * This method is called to transform a GraphQL query AST parsed by `gql`\n   * back into a GraphQL string.\n   *\n   * @privateRemarks\n   * This method is called from the `QueryManager` and various `ApolloLink`s,\n   * always with the \"serverQuery\", so the server-facing part of a transformed\n   * `DocumentNode`.\n   */\n  print: number;\n  /**\n   * Cache size for the cache of [`DocumentTransform`](https://github.com/apollographql/apollo-client/blob/main/src/utilities/graphql/DocumentTransform.ts)\n   * instances with the `cache` option set to `true`.\n   *\n   * Can be called with user-defined or already-transformed `DocumentNode`s.\n   *\n   * @defaultValue\n   * Defaults to `2000`.\n   *\n   * @remarks\n   * The cache size here should be chosen with other `DocumentTransform`s in mind.\n   * For example, if there was a `DocumentTransform` that would take `x` `DocumentNode`s,\n   * and returned a differently-transformed `DocumentNode` depending if the app is\n   * online or offline, then we assume that the cache returns `2*x` documents.\n   * If that were concatenated with another `DocumentTransform` that would\n   * also duplicate the cache size, you'd need to account for `4*x` documents\n   * returned by the second transform.\n   *\n   * Due to an implementation detail of Apollo Client, if you use custom document\n   * transforms you should always add `n` (the \"base\" number of user-provided\n   * Documents) to the resulting cache size.\n   *\n   * If we assume that the user-provided transforms receive `n` documents and\n   * return `n` documents, the cache size should be `2*n`.\n   *\n   * If we assume that the chain of user-provided transforms receive `n` documents and\n   * return `4*n` documents, the cache size should be `5*n`.\n   *\n   * This size should also then be used in every other cache that mentions that\n   * it operates on a \"transformed\" `DocumentNode`.\n   *\n   * @privateRemarks\n   * Cache size for the `performWork` method of each [`DocumentTransform`](https://github.com/apollographql/apollo-client/blob/main/src/utilities/graphql/DocumentTransform.ts).\n   *\n   * No user-provided DocumentNode will actually be \"the last one\", as we run the\n   * `defaultDocumentTransform` before *and* after the user-provided transforms.\n   * For that reason, we need the extra `n` here - `n` for \"before transformation\"\n   * plus the actual maximum cache size of the user-provided transform chain.\n   *\n   * This method is called from `transformDocument`, which is called from\n   * `QueryManager` with a user-provided DocumentNode.\n   * It is also called with already-transformed DocumentNodes, assuming the\n   * user provided additional transforms.\n   *\n   */\n  \"documentTransform.cache\": number;\n  /**\n   * A cache inside of [`QueryManager`](https://github.com/apollographql/apollo-client/blob/main/src/core/QueryManager.ts).\n   *\n   * It is called with transformed `DocumentNode`s.\n   *\n   * @defaultValue\n   * Defaults to `2000`.\n   *\n   * @privateRemarks\n   * Cache size for the `transformCache` used in the `getDocumentInfo` method of `QueryManager`.\n   * Called throughout the `QueryManager` with transformed DocumentNodes.\n   */\n  \"queryManager.getDocumentInfo\": number;\n  /**\n   * A cache inside of [`PersistedQueryLink`](https://github.com/apollographql/apollo-client/blob/main/src/link/persisted-queries/index.ts).\n   *\n   * It is called with transformed `DocumentNode`s.\n   *\n   * @defaultValue\n   * Defaults to `2000`.\n   *\n   * @remarks\n   * This cache is used to cache the hashes of persisted queries.\n   *\n   * @privateRemarks\n   * Cache size for the `hashesByQuery` cache in the `PersistedQueryLink`.\n   */\n  \"PersistedQueryLink.persistedQueryHashes\": number;\n  /**\n   * Cache used by [`canonicalStringify`](https://github.com/apollographql/apollo-client/blob/main/src/utilities/common/canonicalStringify.ts).\n   *\n   * @defaultValue\n   * Defaults to `1000`.\n   *\n   * @remarks\n   * This cache contains the sorted keys of objects that are stringified by\n   * `canonicalStringify`.\n   * It uses the stringified unsorted keys of objects as keys.\n   * The cache will not grow beyond the size of different object **shapes**\n   * encountered in an application, no matter how much actual data gets stringified.\n   *\n   * @privateRemarks\n   * Cache size for the `sortingMap` in `canonicalStringify`.\n   */\n  canonicalStringify: number;\n  /**\n   * A cache inside of [`FragmentRegistry`](https://github.com/apollographql/apollo-client/blob/main/src/cache/inmemory/fragmentRegistry.ts).\n   *\n   * Can be called with user-defined or already-transformed `DocumentNode`s.\n   *\n   * @defaultValue\n   * Defaults to `2000`.\n   *\n   * @privateRemarks\n   *\n   * Cache size for the `transform` method of FragmentRegistry.\n   * This function is called as part of the `defaultDocumentTransform` which will be called with\n   * user-provided and already-transformed DocumentNodes.\n   *\n   */\n  \"fragmentRegistry.transform\": number;\n  /**\n   * A cache inside of [`FragmentRegistry`](https://github.com/apollographql/apollo-client/blob/main/src/cache/inmemory/fragmentRegistry.ts).\n   *\n   * This function is called with fragment names in the form of a string.\n   *\n   * @defaultValue\n   * Defaults to `1000`.\n   *\n   * @remarks\n   * The size of this case should be chosen with the number of fragments in\n   * your application in mind.\n   *\n   * Note:\n   * This function is a dependency of `fragmentRegistry.transform`, so having too small of a cache size here\n   * might involuntarily invalidate values in the `transform` cache.\n   *\n   * @privateRemarks\n   * Cache size for the `lookup` method of FragmentRegistry.\n   */\n  \"fragmentRegistry.lookup\": number;\n  /**\n   * Cache size for the `findFragmentSpreads` method of [`FragmentRegistry`](https://github.com/apollographql/apollo-client/blob/main/src/cache/inmemory/fragmentRegistry.ts).\n   *\n   * This function is called with transformed `DocumentNode`s, as well as recursively\n   * with every fragment spread referenced within that, or a fragment referenced by a\n   * fragment spread.\n   *\n   * @defaultValue\n   * Defaults to `4000`.\n   *\n   * @remarks\n   *\n   * Note: This function is a dependency of `fragmentRegistry.transform`, so having too small of cache size here\n   * might involuntarily invalidate values in the `transform` cache.\n   */\n  \"fragmentRegistry.findFragmentSpreads\": number;\n  /**\n   * Cache size for the `getFragmentDoc` method of [`ApolloCache`](https://github.com/apollographql/apollo-client/blob/main/src/cache/core/cache.ts).\n   *\n   * This function is called with user-provided fragment definitions.\n   *\n   * @defaultValue\n   * Defaults to `1000`.\n   *\n   * @remarks\n   * This function is called from `readFragment` with user-provided fragment definitions.\n   */\n  \"cache.fragmentQueryDocuments\": number;\n  /**\n   * Cache used in [`removeTypenameFromVariables`](https://github.com/apollographql/apollo-client/blob/main/src/link/remove-typename/removeTypenameFromVariables.ts).\n   *\n   * This function is called transformed `DocumentNode`s.\n   *\n   * @defaultValue\n   * Defaults to `2000`.\n   *\n   * @privateRemarks\n   * Cache size for the `getVariableDefinitions` function of `removeTypenameFromVariables`.\n   */\n  \"removeTypenameFromVariables.getVariableDefinitions\": number;\n  /**\n   * Cache size for the `maybeBroadcastWatch` method on [`InMemoryCache`](https://github.com/apollographql/apollo-client/blob/main/src/cache/inmemory/inMemoryCache.ts).\n   *\n   * Note: `maybeBroadcastWatch` will be set to the `resultCacheMaxSize` option and\n   * will fall back to this configuration value if the option is not set.\n   *\n   * @defaultValue\n   * Defaults to `5000`.\n   *\n   * @remarks\n   * This method is used for dependency tracking in the `InMemoryCache` and\n   * prevents from unnecessary re-renders.\n   * It is recommended to keep this value significantly higher than the number of\n   * possible subscribers you will have active at the same time in your application\n   * at any time.\n   */\n  \"inMemoryCache.maybeBroadcastWatch\": number;\n  /**\n   * Cache size for the `executeSelectionSet` method on [`StoreReader`](https://github.com/apollographql/apollo-client/blob/main/src/cache/inmemory/readFromStore.ts).\n   *\n   * Note:\n   * `executeSelectionSet` will be set to the `resultCacheMaxSize` option and\n   * will fall back to this configuration value if the option is not set.\n   *\n   * @defaultValue\n   * Defaults to `50000`.\n   *\n   * @remarks\n   * Every object that is read from the cache will be cached here, so it is\n   * recommended to set this to a high value.\n   */\n  \"inMemoryCache.executeSelectionSet\": number;\n  /**\n   * Cache size for the `executeSubSelectedArray` method on [`StoreReader`](https://github.com/apollographql/apollo-client/blob/main/src/cache/inmemory/readFromStore.ts).\n   *\n   * Note:\n   * `executeSubSelectedArray` will be set to the `resultCacheMaxSize` option and\n   * will fall back to this configuration value if the option is not set.\n   *\n   * @defaultValue\n   * Defaults to `10000`.\n   *\n   * @remarks\n   * Every array that is read from the cache will be cached here, so it is\n   * recommended to set this to a high value.\n   */\n  \"inMemoryCache.executeSubSelectedArray\": number;\n  /**\n   * Used by the internal `checkDocument` that traverses GraphQL documents and throws an error if the document is invalid.\n   * if they are not valid.\n   */\n  checkDocument: number;\n}\n\nconst cacheSizeSymbol = Symbol.for(\"apollo.cacheSize\");\n/**\n *\n * The global cache size configuration for Apollo Client.\n *\n * @remarks\n *\n * You can directly modify this object, but any modification will\n * only have an effect on caches that are created after the modification.\n *\n * So for global caches, such as `canonicalStringify` and `print`,\n * you might need to call `.reset` on them, which will essentially re-create them.\n *\n * Alternatively, you can set `globalThis[Symbol.for(\"apollo.cacheSize\")]` before\n * you load the Apollo Client package:\n *\n * @example\n * ```ts\n * globalThis[Symbol.for(\"apollo.cacheSize\")] = {\n *   print: 100\n * } satisfies Partial<CacheSizes> // the `satisfies` is optional if using TypeScript\n * ```\n */\nexport const cacheSizes: Partial<CacheSizes> = { ...global[cacheSizeSymbol] };\n\nexport const enum defaultCacheSizes {\n  checkDocument = 2000,\n  canonicalStringify = 1000,\n  print = 2000,\n  \"documentTransform.cache\" = 2000,\n  \"queryManager.getDocumentInfo\" = 2000,\n  \"PersistedQueryLink.persistedQueryHashes\" = 2000,\n  \"fragmentRegistry.transform\" = 2000,\n  \"fragmentRegistry.lookup\" = 1000,\n  \"fragmentRegistry.findFragmentSpreads\" = 4000,\n  \"cache.fragmentQueryDocuments\" = 1000,\n  \"removeTypenameFromVariables.getVariableDefinitions\" = 2000,\n  \"inMemoryCache.maybeBroadcastWatch\" = 5000,\n  \"inMemoryCache.executeSelectionSet\" = 50000,\n  \"inMemoryCache.executeSubSelectedArray\" = 10000,\n}\n"],"names":[],"mappings":";;;AAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AA0QA,CAAA,CAAA,CAAA,CAAA,EAAM,CAAN,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAwB,CAAxB,CAAA,CAAA,CAAA,CAAA,CAA8B,CAAC,CAA/B,CAAA,CAAkC,CAAC,CAAnC,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAqD,CAAC;AACtD,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;CAqBA,CAAA;AACa,CAAb,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAa,CAAb,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAA+C,EAAE,CAAjD,CAAA,CAAoD,CAApD,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAA0D,CAAC,CAA3D,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAA0E,EAA1E,CAAA;"}

package/__cjs/utilities/caching/sizes.d.cts

@@ -0,0 +1,299 @@
+declare global {
+    interface Window {
+        [cacheSizeSymbol]?: Partial<CacheSizes>;
+    }
+}
+/**
+ * The cache sizes used by various Apollo Client caches.
+ *
+ * @remarks
+ * All configurable caches hold memoized values. If an item is
+ * cache-collected, it incurs only a small performance impact and
+ * doesn't cause data loss. A smaller cache size might save you memory.
+ *
+ * You should choose cache sizes appropriate for storing a reasonable
+ * number of values rather than every value. To prevent too much recalculation,
+ * choose cache sizes that are at least large enough to hold memoized values for
+ * all hooks/queries on the screen at any given time.
+ */
+export interface CacheSizes {
+    /**
+     * Cache size for the [`print`](https://github.com/apollographql/apollo-client/blob/main/src/utilities/graphql/print.ts) function.
+     *
+     * It is called with transformed `DocumentNode`s.
+     *
+     * @defaultValue
+     * Defaults to `2000`.
+     *
+     * @remarks
+     * This method is called to transform a GraphQL query AST parsed by `gql`
+     * back into a GraphQL string.
+     *
+     * @privateRemarks
+     * This method is called from the `QueryManager` and various `ApolloLink`s,
+     * always with the "serverQuery", so the server-facing part of a transformed
+     * `DocumentNode`.
+     */
+    print: number;
+    /**
+     * Cache size for the cache of [`DocumentTransform`](https://github.com/apollographql/apollo-client/blob/main/src/utilities/graphql/DocumentTransform.ts)
+     * instances with the `cache` option set to `true`.
+     *
+     * Can be called with user-defined or already-transformed `DocumentNode`s.
+     *
+     * @defaultValue
+     * Defaults to `2000`.
+     *
+     * @remarks
+     * The cache size here should be chosen with other `DocumentTransform`s in mind.
+     * For example, if there was a `DocumentTransform` that would take `x` `DocumentNode`s,
+     * and returned a differently-transformed `DocumentNode` depending if the app is
+     * online or offline, then we assume that the cache returns `2*x` documents.
+     * If that were concatenated with another `DocumentTransform` that would
+     * also duplicate the cache size, you'd need to account for `4*x` documents
+     * returned by the second transform.
+     *
+     * Due to an implementation detail of Apollo Client, if you use custom document
+     * transforms you should always add `n` (the "base" number of user-provided
+     * Documents) to the resulting cache size.
+     *
+     * If we assume that the user-provided transforms receive `n` documents and
+     * return `n` documents, the cache size should be `2*n`.
+     *
+     * If we assume that the chain of user-provided transforms receive `n` documents and
+     * return `4*n` documents, the cache size should be `5*n`.
+     *
+     * This size should also then be used in every other cache that mentions that
+     * it operates on a "transformed" `DocumentNode`.
+     *
+     * @privateRemarks
+     * Cache size for the `performWork` method of each [`DocumentTransform`](https://github.com/apollographql/apollo-client/blob/main/src/utilities/graphql/DocumentTransform.ts).
+     *
+     * No user-provided DocumentNode will actually be "the last one", as we run the
+     * `defaultDocumentTransform` before *and* after the user-provided transforms.
+     * For that reason, we need the extra `n` here - `n` for "before transformation"
+     * plus the actual maximum cache size of the user-provided transform chain.
+     *
+     * This method is called from `transformDocument`, which is called from
+     * `QueryManager` with a user-provided DocumentNode.
+     * It is also called with already-transformed DocumentNodes, assuming the
+     * user provided additional transforms.
+     *
+     */
+    "documentTransform.cache": number;
+    /**
+     * A cache inside of [`QueryManager`](https://github.com/apollographql/apollo-client/blob/main/src/core/QueryManager.ts).
+     *
+     * It is called with transformed `DocumentNode`s.
+     *
+     * @defaultValue
+     * Defaults to `2000`.
+     *
+     * @privateRemarks
+     * Cache size for the `transformCache` used in the `getDocumentInfo` method of `QueryManager`.
+     * Called throughout the `QueryManager` with transformed DocumentNodes.
+     */
+    "queryManager.getDocumentInfo": number;
+    /**
+     * A cache inside of [`PersistedQueryLink`](https://github.com/apollographql/apollo-client/blob/main/src/link/persisted-queries/index.ts).
+     *
+     * It is called with transformed `DocumentNode`s.
+     *
+     * @defaultValue
+     * Defaults to `2000`.
+     *
+     * @remarks
+     * This cache is used to cache the hashes of persisted queries.
+     *
+     * @privateRemarks
+     * Cache size for the `hashesByQuery` cache in the `PersistedQueryLink`.
+     */
+    "PersistedQueryLink.persistedQueryHashes": number;
+    /**
+     * Cache used by [`canonicalStringify`](https://github.com/apollographql/apollo-client/blob/main/src/utilities/common/canonicalStringify.ts).
+     *
+     * @defaultValue
+     * Defaults to `1000`.
+     *
+     * @remarks
+     * This cache contains the sorted keys of objects that are stringified by
+     * `canonicalStringify`.
+     * It uses the stringified unsorted keys of objects as keys.
+     * The cache will not grow beyond the size of different object **shapes**
+     * encountered in an application, no matter how much actual data gets stringified.
+     *
+     * @privateRemarks
+     * Cache size for the `sortingMap` in `canonicalStringify`.
+     */
+    canonicalStringify: number;
+    /**
+     * A cache inside of [`FragmentRegistry`](https://github.com/apollographql/apollo-client/blob/main/src/cache/inmemory/fragmentRegistry.ts).
+     *
+     * Can be called with user-defined or already-transformed `DocumentNode`s.
+     *
+     * @defaultValue
+     * Defaults to `2000`.
+     *
+     * @privateRemarks
+     *
+     * Cache size for the `transform` method of FragmentRegistry.
+     * This function is called as part of the `defaultDocumentTransform` which will be called with
+     * user-provided and already-transformed DocumentNodes.
+     *
+     */
+    "fragmentRegistry.transform": number;
+    /**
+     * A cache inside of [`FragmentRegistry`](https://github.com/apollographql/apollo-client/blob/main/src/cache/inmemory/fragmentRegistry.ts).
+     *
+     * This function is called with fragment names in the form of a string.
+     *
+     * @defaultValue
+     * Defaults to `1000`.
+     *
+     * @remarks
+     * The size of this case should be chosen with the number of fragments in
+     * your application in mind.
+     *
+     * Note:
+     * This function is a dependency of `fragmentRegistry.transform`, so having too small of a cache size here
+     * might involuntarily invalidate values in the `transform` cache.
+     *
+     * @privateRemarks
+     * Cache size for the `lookup` method of FragmentRegistry.
+     */
+    "fragmentRegistry.lookup": number;
+    /**
+     * Cache size for the `findFragmentSpreads` method of [`FragmentRegistry`](https://github.com/apollographql/apollo-client/blob/main/src/cache/inmemory/fragmentRegistry.ts).
+     *
+     * This function is called with transformed `DocumentNode`s, as well as recursively
+     * with every fragment spread referenced within that, or a fragment referenced by a
+     * fragment spread.
+     *
+     * @defaultValue
+     * Defaults to `4000`.
+     *
+     * @remarks
+     *
+     * Note: This function is a dependency of `fragmentRegistry.transform`, so having too small of cache size here
+     * might involuntarily invalidate values in the `transform` cache.
+     */
+    "fragmentRegistry.findFragmentSpreads": number;
+    /**
+     * Cache size for the `getFragmentDoc` method of [`ApolloCache`](https://github.com/apollographql/apollo-client/blob/main/src/cache/core/cache.ts).
+     *
+     * This function is called with user-provided fragment definitions.
+     *
+     * @defaultValue
+     * Defaults to `1000`.
+     *
+     * @remarks
+     * This function is called from `readFragment` with user-provided fragment definitions.
+     */
+    "cache.fragmentQueryDocuments": number;
+    /**
+     * Cache used in [`removeTypenameFromVariables`](https://github.com/apollographql/apollo-client/blob/main/src/link/remove-typename/removeTypenameFromVariables.ts).
+     *
+     * This function is called transformed `DocumentNode`s.
+     *
+     * @defaultValue
+     * Defaults to `2000`.
+     *
+     * @privateRemarks
+     * Cache size for the `getVariableDefinitions` function of `removeTypenameFromVariables`.
+     */
+    "removeTypenameFromVariables.getVariableDefinitions": number;
+    /**
+     * Cache size for the `maybeBroadcastWatch` method on [`InMemoryCache`](https://github.com/apollographql/apollo-client/blob/main/src/cache/inmemory/inMemoryCache.ts).
+     *
+     * Note: `maybeBroadcastWatch` will be set to the `resultCacheMaxSize` option and
+     * will fall back to this configuration value if the option is not set.
+     *
+     * @defaultValue
+     * Defaults to `5000`.
+     *
+     * @remarks
+     * This method is used for dependency tracking in the `InMemoryCache` and
+     * prevents from unnecessary re-renders.
+     * It is recommended to keep this value significantly higher than the number of
+     * possible subscribers you will have active at the same time in your application
+     * at any time.
+     */
+    "inMemoryCache.maybeBroadcastWatch": number;
+    /**
+     * Cache size for the `executeSelectionSet` method on [`StoreReader`](https://github.com/apollographql/apollo-client/blob/main/src/cache/inmemory/readFromStore.ts).
+     *
+     * Note:
+     * `executeSelectionSet` will be set to the `resultCacheMaxSize` option and
+     * will fall back to this configuration value if the option is not set.
+     *
+     * @defaultValue
+     * Defaults to `50000`.
+     *
+     * @remarks
+     * Every object that is read from the cache will be cached here, so it is
+     * recommended to set this to a high value.
+     */
+    "inMemoryCache.executeSelectionSet": number;
+    /**
+     * Cache size for the `executeSubSelectedArray` method on [`StoreReader`](https://github.com/apollographql/apollo-client/blob/main/src/cache/inmemory/readFromStore.ts).
+     *
+     * Note:
+     * `executeSubSelectedArray` will be set to the `resultCacheMaxSize` option and
+     * will fall back to this configuration value if the option is not set.
+     *
+     * @defaultValue
+     * Defaults to `10000`.
+     *
+     * @remarks
+     * Every array that is read from the cache will be cached here, so it is
+     * recommended to set this to a high value.
+     */
+    "inMemoryCache.executeSubSelectedArray": number;
+    /**
+     * Used by the internal `checkDocument` that traverses GraphQL documents and throws an error if the document is invalid.
+     * if they are not valid.
+     */
+    checkDocument: number;
+}
+declare const cacheSizeSymbol: unique symbol;
+/**
+ *
+ * The global cache size configuration for Apollo Client.
+ *
+ * @remarks
+ *
+ * You can directly modify this object, but any modification will
+ * only have an effect on caches that are created after the modification.
+ *
+ * So for global caches, such as `canonicalStringify` and `print`,
+ * you might need to call `.reset` on them, which will essentially re-create them.
+ *
+ * Alternatively, you can set `globalThis[Symbol.for("apollo.cacheSize")]` before
+ * you load the Apollo Client package:
+ *
+ * @example
+ * ```ts
+ * globalThis[Symbol.for("apollo.cacheSize")] = {
+ *   print: 100
+ * } satisfies Partial<CacheSizes> // the `satisfies` is optional if using TypeScript
+ * ```
+ */
+export declare const cacheSizes: Partial<CacheSizes>;
+export declare const enum defaultCacheSizes {
+    checkDocument = 2000,
+    canonicalStringify = 1000,
+    print = 2000,
+    "documentTransform.cache" = 2000,
+    "queryManager.getDocumentInfo" = 2000,
+    "PersistedQueryLink.persistedQueryHashes" = 2000,
+    "fragmentRegistry.transform" = 2000,
+    "fragmentRegistry.lookup" = 1000,
+    "fragmentRegistry.findFragmentSpreads" = 4000,
+    "cache.fragmentQueryDocuments" = 1000,
+    "removeTypenameFromVariables.getVariableDefinitions" = 2000,
+    "inMemoryCache.maybeBroadcastWatch" = 5000,
+    "inMemoryCache.executeSelectionSet" = 50000,
+    "inMemoryCache.executeSubSelectedArray" = 10000
+}
+export {};
+//# sourceMappingURL=sizes.d.cts.map

package/__cjs/utilities/common/stripTypename.cjs

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripTypename = stripTypename;
+const internal_1 = require("@apollo/client/utilities/internal");
+/**
+ * Deeply removes all `__typename` properties in the given object or array.
+ *
+ * @param value - The object or array that should have `__typename` removed.
+ * @returns The object with all `__typename` properties removed.
+ */
+function stripTypename(value) {
+    return (0, internal_1.omitDeep)(value, "__typename");
+}
+//# sourceMappingURL=stripTypename.cjs.map

package/__cjs/utilities/common/stripTypename.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripTypename.cjs","sources":["../../../../src/utilities/common/stripTypename.ts"],"sourcesContent":["import { omitDeep } from \"@apollo/client/utilities/internal\";\n\n/**\n * Deeply removes all `__typename` properties in the given object or array.\n *\n * @param value - The object or array that should have `__typename` removed.\n * @returns The object with all `__typename` properties removed.\n */\nexport function stripTypename<T>(value: T) {\n  return omitDeep(value, \"__typename\");\n}\n"],"names":[],"mappings":";;AAQA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AARA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAEA,CAAA,CAAA;;;;;CAKA,CAAA;AACA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAgB,CAAhB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAiC,CAAjC,CAAA,CAAA,CAAA,CAAA,EAAA;IACE,CAAF,CAAA,CAAA,CAAA,CAAA,EAAS,CAAT,CAAA,EAAS,CAAT,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAiB,CAAjB,CAAkB,CAAlB,CAAA,CAAA,CAAA,CAAuB,EAAE,CAAzB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAqC,CAAC;AACtC;"}

package/__cjs/utilities/common/stripTypename.d.cts

@@ -0,0 +1,8 @@
+/**
+ * Deeply removes all `__typename` properties in the given object or array.
+ *
+ * @param value - The object or array that should have `__typename` removed.
+ * @returns The object with all `__typename` properties removed.
+ */
+export declare function stripTypename<T>(value: T): import("@apollo/client/utilities/internal").DeepOmit<T, "__typename">;
+//# sourceMappingURL=stripTypename.d.cts.map

package/__cjs/utilities/environment/index.cjs

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__DEV__ = void 0;
+exports.__DEV__ = globalThis.__DEV__ === true;
+//# sourceMappingURL=index.cjs.map

package/__cjs/utilities/environment/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../../src/utilities/environment/index.ts"],"sourcesContent":["declare const globalThis: { __DEV__?: boolean };\n\nexport const __DEV__: boolean = globalThis.__DEV__ === true;\n"],"names":[],"mappings":";;;AAEa,CAAb,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAa,CAAb,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAgC,CAAhC,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAA0C,CAAC,CAA3C,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,EAAuD,CAAvD,CAAA,CAAA,CAAA;"}

package/__cjs/utilities/environment/index.d.cts

@@ -0,0 +1,2 @@
+export declare const __DEV__: boolean;
+//# sourceMappingURL=index.d.cts.map

package/__cjs/utilities/environment/index.development.cjs

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__DEV__ = void 0;
+exports.__DEV__ = true;
+//# sourceMappingURL=index.development.cjs.map

package/__cjs/utilities/environment/index.development.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.development.cjs","sources":["../../../../src/utilities/environment/index.development.ts"],"sourcesContent":["export const __DEV__ = true as boolean;\n"],"names":[],"mappings":";;;AAAa,CAAb,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAa,CAAb,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAuB,CAAvB,CAAA,CAAA,CAAA;"}

package/__cjs/utilities/environment/index.development.d.cts

@@ -0,0 +1,2 @@
+export declare const __DEV__: boolean;
+//# sourceMappingURL=index.development.d.cts.map

package/__cjs/utilities/environment/index.production.cjs

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__DEV__ = void 0;
+exports.__DEV__ = false;
+//# sourceMappingURL=index.production.cjs.map

package/__cjs/utilities/environment/index.production.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.production.cjs","sources":["../../../../src/utilities/environment/index.production.ts"],"sourcesContent":["export const __DEV__ = false as boolean;\n"],"names":[],"mappings":";;;AAAa,CAAb,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAa,CAAb,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAuB,CAAvB,CAAA,CAAA,CAAA,CAAA;"}

package/__cjs/utilities/environment/index.production.d.cts

@@ -0,0 +1,2 @@
+export declare const __DEV__: boolean;
+//# sourceMappingURL=index.production.d.cts.map

package/__cjs/utilities/graphql/DocumentTransform.cjs

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentTransform = void 0;
+const caches_1 = require("@wry/caches");
+const trie_1 = require("@wry/trie");
+const optimism_1 = require("optimism");
+const internal_1 = require("@apollo/client/utilities/internal");
+const invariant_1 = require("@apollo/client/utilities/invariant");
+const index_js_1 = require("../caching/index.cjs");
+function identity(document) {
+    return document;
+}
+class DocumentTransform {
+    transform;
+    cached;
+    resultCache = new WeakSet();
+    // This default implementation of getCacheKey can be overridden by providing
+    // options.getCacheKey to the DocumentTransform constructor. In general, a
+    // getCacheKey function may either return an array of keys (often including
+    // the document) to be used as a cache key, or undefined to indicate the
+    // transform for this document should not be cached.
+    getCacheKey(document) {
+        return [document];
+    }
+    static identity() {
+        // No need to cache this transform since it just returns the document
+        // unchanged. This should save a bit of memory that would otherwise be
+        // needed to populate the `documentCache` of this transform.
+        return new DocumentTransform(identity, { cache: false });
+    }
+    static split(predicate, left, right = DocumentTransform.identity()) {
+        return Object.assign(new DocumentTransform((document) => {
+            const documentTransform = predicate(document) ? left : right;
+            return documentTransform.transformDocument(document);
+        }, 
+        // Reasonably assume both `left` and `right` transforms handle their own caching
+        { cache: false }), { left, right });
+    }
+    constructor(transform, options = {}) {
+        this.transform = transform;
+        if (options.getCacheKey) {
+            // Override default `getCacheKey` function, which returns [document].
+            this.getCacheKey = options.getCacheKey;
+        }
+        this.cached = options.cache !== false;
+        this.resetCache();
+    }
+    /**
+     * Resets the internal cache of this transform, if it has one.
+     */
+    resetCache() {
+        if (this.cached) {
+            const stableCacheKeys = new trie_1.Trie();
+            this.performWork = (0, optimism_1.wrap)(DocumentTransform.prototype.performWork.bind(this), {
+                makeCacheKey: (document) => {
+                    const cacheKeys = this.getCacheKey(document);
+                    if (cacheKeys) {
+                        (0, invariant_1.invariant)(Array.isArray(cacheKeys), 20);
+                        return stableCacheKeys.lookupArray(cacheKeys);
+                    }
+                },
+                max: index_js_1.cacheSizes["documentTransform.cache"],
+                cache: (caches_1.WeakCache),
+            });
+        }
+    }
+    performWork(document) {
+        (0, internal_1.checkDocument)(document);
+        return this.transform(document);
+    }
+    transformDocument(document) {
+        // If a user passes an already transformed result back to this function,
+        // immediately return it.
+        if (this.resultCache.has(document)) {
+            return document;
+        }
+        const transformedDocument = this.performWork(document);
+        this.resultCache.add(transformedDocument);
+        return transformedDocument;
+    }
+    concat(otherTransform) {
+        return Object.assign(new DocumentTransform((document) => {
+            return otherTransform.transformDocument(this.transformDocument(document));
+        }, 
+        // Reasonably assume both transforms handle their own caching
+        { cache: false }), {
+            left: this,
+            right: otherTransform,
+        });
+    }
+    /**
+    * @internal
+    * Used to iterate through all transforms that are concatenations or `split` links.
+    * 
+    * @deprecated This is an internal API and should not be used directly. This can be removed or changed at any time.
+    */
+    left;
+    /**
+    * @internal
+    * Used to iterate through all transforms that are concatenations or `split` links.
+    * 
+    * @deprecated This is an internal API and should not be used directly. This can be removed or changed at any time.
+    */
+    right;
+}
+exports.DocumentTransform = DocumentTransform;
+//# sourceMappingURL=DocumentTransform.cjs.map