@depup/apollo__client 4.1.6-depup.0

package/utilities/caching/sizes.d.ts

@@ -0,0 +1,286 @@
+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).
+     *
+     * @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).
+     *
+     * @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).
+     *
+     * @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.ts.map

package/utilities/caching/sizes.js

@@ -0,0 +1,26 @@
+import { global } from "@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
+ * ```
+ */
+export const cacheSizes = { ...global[cacheSizeSymbol] };
+//# sourceMappingURL=sizes.js.map

package/utilities/caching/sizes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sizes.js","sourceRoot":"","sources":["../../../src/utilities/caching/sizes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA6PnE,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AACvD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAwB,EAAE,GAAG,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC","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  \"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  \"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   * @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   * @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   * @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 * 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 *\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"]}

package/utilities/common/stripTypename.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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.
+ *
+ * @example
+ *
+ * ```ts
+ * stripTypename({
+ *   __typename: "User",
+ *   id: 1,
+ *   profile: { __typename: "Profile", name: "John Doe" },
+ * });
+ * // => { id: 1, profile: { name: "John Doe"}}
+ * ```
+ */
+export declare function stripTypename<T>(value: T): import("@apollo/client/utilities/internal").DeepOmit<T, "__typename">;
+//# sourceMappingURL=stripTypename.d.ts.map

package/utilities/common/stripTypename.js

@@ -0,0 +1,22 @@
+import { omitDeep } from "@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.
+ *
+ * @example
+ *
+ * ```ts
+ * stripTypename({
+ *   __typename: "User",
+ *   id: 1,
+ *   profile: { __typename: "Profile", name: "John Doe" },
+ * });
+ * // => { id: 1, profile: { name: "John Doe"}}
+ * ```
+ */
+export function stripTypename(value) {
+    return omitDeep(value, "__typename");
+}
+//# sourceMappingURL=stripTypename.js.map

package/utilities/common/stripTypename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripTypename.js","sourceRoot":"","sources":["../../../src/utilities/common/stripTypename.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAAI,KAAQ;IACvC,OAAO,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;AACvC,CAAC","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 *\n * @example\n *\n * ```ts\n * stripTypename({\n *   __typename: \"User\",\n *   id: 1,\n *   profile: { __typename: \"Profile\", name: \"John Doe\" },\n * });\n * // => { id: 1, profile: { name: \"John Doe\"}}\n * ```\n */\nexport function stripTypename<T>(value: T) {\n  return omitDeep(value, \"__typename\");\n}\n"]}

package/utilities/environment/index.d.ts

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

package/utilities/environment/index.development.d.ts

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

package/utilities/environment/index.development.js

@@ -0,0 +1,2 @@
+export const __DEV__ = true;
+//# sourceMappingURL=index.development.js.map

package/utilities/environment/index.development.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.development.js","sourceRoot":"","sources":["../../../src/utilities/environment/index.development.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,IAAe,CAAC","sourcesContent":["export const __DEV__ = true as boolean;\n"]}

package/utilities/environment/index.js

@@ -0,0 +1,2 @@
+export const __DEV__ = globalThis.__DEV__ === true;
+//# sourceMappingURL=index.js.map

package/utilities/environment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utilities/environment/index.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAY,UAAU,CAAC,OAAO,KAAK,IAAI,CAAC","sourcesContent":["declare const globalThis: { __DEV__?: boolean };\n\nexport const __DEV__: boolean = globalThis.__DEV__ === true;\n"]}

package/utilities/environment/index.production.d.ts

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

package/utilities/environment/index.production.js

@@ -0,0 +1,2 @@
+export const __DEV__ = false;
+//# sourceMappingURL=index.production.js.map

package/utilities/environment/index.production.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.production.js","sourceRoot":"","sources":["../../../src/utilities/environment/index.production.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,KAAgB,CAAC","sourcesContent":["export const __DEV__ = false as boolean;\n"]}

package/utilities/graphql/DocumentTransform.d.ts

@@ -0,0 +1,143 @@
+import type { DocumentNode } from "graphql";
+export type DocumentTransformCacheKey = ReadonlyArray<unknown>;
+type TransformFn = (document: DocumentNode) => DocumentNode;
+interface DocumentTransformOptions {
+    /**
+     * Determines whether to cache the transformed GraphQL document. Caching can
+     * speed up repeated calls to the document transform for the same input
+     * document. Set to `false` to completely disable caching for the document
+     * transform. When disabled, this option takes precedence over the [`getCacheKey`](#getcachekey)
+     * option.
+     *
+     * @defaultValue `true`
+     */
+    cache?: boolean;
+    /**
+     * Defines a custom cache key for a GraphQL document that will determine whether to re-run the document transform when given the same input GraphQL document. Returns an array that defines the cache key. Return `undefined` to disable caching for that GraphQL document.
+     *
+     * > [!NOTE]
+     * > The items in the array can be any type, but each item needs to be
+     * > referentially stable to guarantee a stable cache key.
+     *
+     * @defaultValue `(document) => [document]`
+     */
+    getCacheKey?: (document: DocumentNode) => DocumentTransformCacheKey | undefined;
+}
+/**
+ * A class for transforming GraphQL documents. See the [Document transforms
+ * documentation](https://www.apollographql.com/docs/react/data/document-transforms) for more details on using them.
+ *
+ * @example
+ *
+ * ```ts
+ * import { DocumentTransform } from "@apollo/client/utilities";
+ * import { visit } from "graphql";
+ *
+ * const documentTransform = new DocumentTransform((doc) => {
+ *   return visit(doc, {
+ *     // ...
+ *   });
+ * });
+ *
+ * const transformedDoc = documentTransform.transformDocument(myDocument);
+ * ```
+ */
+export declare class DocumentTransform {
+    private readonly transform;
+    private cached;
+    private readonly resultCache;
+    private getCacheKey;
+    /**
+     * Creates a DocumentTransform that returns the input document unchanged.
+     *
+     * @returns The input document
+     */
+    static identity(): DocumentTransform;
+    /**
+     * Creates a DocumentTransform that conditionally applies one of two transforms.
+     *
+     * @param predicate - Function that determines which transform to apply
+     * @param left - Transform to apply when `predicate` returns `true`
+     * @param right - Transform to apply when `predicate` returns `false`. If not provided, it defaults to `DocumentTransform.identity()`.
+     * @returns A DocumentTransform that conditionally applies a document transform based on the predicate
+     *
+     * @example
+     *
+     * ```ts
+     * import { isQueryOperation } from "@apollo/client/utilities";
+     *
+     * const conditionalTransform = DocumentTransform.split(
+     *   (document) => isQueryOperation(document),
+     *   queryTransform,
+     *   mutationTransform
+     * );
+     * ```
+     */
+    static split(predicate: (document: DocumentNode) => boolean, left: DocumentTransform, right?: DocumentTransform): DocumentTransform & {
+        left: DocumentTransform;
+        right: DocumentTransform;
+    };
+    constructor(transform: TransformFn, options?: DocumentTransformOptions);
+    /**
+     * Resets the internal cache of this transform, if it is cached.
+     */
+    resetCache(): void;
+    private performWork;
+    /**
+     * Transforms a GraphQL document using the configured transform function.
+     *
+     * @remarks
+     *
+     * Note that `transformDocument` caches the transformed document. Calling
+     * `transformDocument` again with the already-transformed document will
+     * immediately return it.
+     *
+     * @param document - The GraphQL document to transform
+     * @returns The transformed document
+     *
+     * @example
+     *
+     * ```ts
+     * const document = gql`
+     *   # ...
+     * `;
+     *
+     * const documentTransform = new DocumentTransform(transformFn);
+     * const transformedDocument = documentTransform.transformDocument(document);
+     * ```
+     */
+    transformDocument(document: DocumentNode): DocumentNode;
+    /**
+     * Combines this document transform with another document transform. The
+     * returned document transform first applies the current document transform,
+     * then applies the other document transform.
+     *
+     * @param otherTransform - The transform to apply after this one
+     * @returns A new DocumentTransform that applies both transforms in sequence
+     *
+     * @example
+     *
+     * ```ts
+     * const combinedTransform = addTypenameTransform.concat(
+     *   removeDirectivesTransform
+     * );
+     * ```
+     */
+    concat(otherTransform: DocumentTransform): DocumentTransform;
+    /**
+    * @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.
+    */
+    readonly left?: DocumentTransform;
+    /**
+    * @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.
+    */
+    readonly right?: DocumentTransform;
+}
+export {};
+//# sourceMappingURL=DocumentTransform.d.ts.map