@apollo/client 4.3.0-alpha.1 → 4.3.0-alpha.11

package/cache/core/types/Cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"Cache.js","sourceRoot":"","sources":["../../../../src/cache/core/types/Cache.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  DataValue,\n  DocumentNode,\n  OperationVariables,\n  TypedDocumentNode,\n  TypeOverrides,\n} from \"@apollo/client\";\nimport type { Unmasked } from \"@apollo/client/masking\";\nimport type { ExtensionsWithStreamInfo } from \"@apollo/client/utilities/internal\";\n\nimport type { ApolloCache } from \"../cache.js\";\n\nimport type {\n  AllFieldsModifier,\n  MissingFieldError,\n  Modifiers,\n} from \"./common.js\";\nexport declare namespace Cache {\n  export type WatchCallback<TData = unknown> = (\n    diff: Cache.DiffResult<TData>,\n    lastDiff?: Cache.DiffResult<TData>\n  ) => void;\n\n  export type Implementation =\n    TypeOverrides extends { cache: infer TCache } ?\n      TCache extends ApolloCache ?\n        TCache\n      : \"The cache type declared in TypeOverrides does not extend `ApolloCache` and cannot be used with Apollo Client. See https://www.apollographql.com/docs/react/data/typescript#declaring-the-cache-type.\"\n    : ApolloCache;\n\n  export interface ReadOptions<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n  > {\n    /**\n     * The GraphQL query shape to be used constructed using the `gql` template\n     * string tag from `graphql-tag`. The query will be used to determine the\n     * shape of the data to be read.\n     */\n    query: DocumentNode | TypedDocumentNode<TData, TVariables>;\n\n    /**\n     * Any variables that the GraphQL query may depend on.\n     */\n    variables?: TVariables;\n\n    /**\n     * The root id to be used. Defaults to \"ROOT_QUERY\", which is the ID of the\n     * root query object. This property makes writeQuery capable of writing data\n     * to any object in the cache.\n     */\n    id?: string;\n    rootId?: string;\n    previousResult?: any;\n    optimistic: boolean;\n    returnPartialData?: boolean;\n  }\n\n  export interface WriteOptions<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n  > {\n    /**\n     * The GraphQL query shape to be used constructed using the `gql` template\n     * string tag from `graphql-tag`. The query will be used to determine the\n     * shape of the data to be read.\n     */\n    query: DocumentNode | TypedDocumentNode<TData, TVariables>;\n\n    /**\n     * Any variables that the GraphQL query may depend on.\n     */\n    variables?: TVariables;\n\n    dataId?: string;\n    result: Unmasked<TData>;\n\n    /**\n     * Whether to notify query watchers.\n     * @defaultValue true\n     */\n    broadcast?: boolean;\n    /**\n     * When true, ignore existing field data rather than merging it with\n     * incoming data.\n     * @defaultValue false\n     */\n    overwrite?: boolean;\n\n    /**\n     * GraphQL extensions for the write operation. Any provided `extensions`\n     * are available in `merge` functions.\n     */\n    extensions?: ExtensionsWithStreamInfo;\n  }\n\n  export interface DiffOptions<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n  > extends Omit<ReadOptions<TData, TVariables>, \"rootId\"> {\n    // The DiffOptions interface is currently just an alias for\n    // ReadOptions, though DiffOptions used to be responsible for\n    // declaring the returnPartialData option.\n  }\n\n  export interface WatchOptions<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n  > extends DiffOptions<TData, TVariables> {\n    watcher?: object;\n    immediate?: boolean;\n    callback: WatchCallback<TData>;\n    lastDiff?: DiffResult<TData>;\n  }\n\n  export interface EvictOptions {\n    id?: string;\n    fieldName?: string;\n    args?: Record<string, any>;\n    broadcast?: boolean;\n  }\n\n  // Although you can call cache.reset() without options, its behavior can be\n  // configured by passing a Cache.ResetOptions object.\n  export interface ResetOptions {\n    discardWatches?: boolean;\n  }\n\n  export interface ModifyOptions<\n    Entity extends Record<string, any> = Record<string, any>,\n  > {\n    id?: string;\n    fields: Modifiers<Entity> | AllFieldsModifier<Entity>;\n    optimistic?: boolean;\n    broadcast?: boolean;\n  }\n\n  export interface BatchOptions<\n    TCache extends Cache.Implementation,\n    TUpdateResult = void,\n  > {\n    /**\n     * A function that performs cache operations. Receives the cache instance as its argument.\n     *\n     * The return value of this function becomes the return value of `batch`.\n     */\n    update(cache: TCache): TUpdateResult;\n\n    /**\n     * Controls how optimistic data is handled:\n     *\n     * - `string`: Creates a new optimistic layer with this ID. Use `removeOptimistic` later to remove it.\n     * - `true`: Updates the current top layer of the cache (including any optimistic data).\n     * - `false`: Updates only the root (non-optimistic) cache data.\n     *\n     * @defaultValue false\n     */\n    optimistic?: string | boolean;\n\n    /**\n     * If provided, removes the optimistic layer with this ID after the batch completes.\n     *\n     * This is useful for atomically applying server data while removing a pending optimistic update, triggering at most one broadcast for both operations.\n     *\n     * Note: this option is needed because calling `cache.removeOptimistic` during the transaction function may not be safe, since any modifications to cache layers may be discarded after the transaction finishes.\n     */\n    removeOptimistic?: string;\n\n    /**\n     * Optional callback invoked for each watcher affected by the batch operation.\n     *\n     * Receives the watch options, the new diff result, and optionally the previous diff result.\n     *\n     * Return `false` to prevent broadcasting to that specific watcher.\n     */\n    onWatchUpdated?: (\n      this: TCache,\n      watch: Cache.WatchOptions,\n      diff: Cache.DiffResult<any>,\n      lastDiff?: Cache.DiffResult<any> | undefined\n    ) => any;\n  }\n\n  export interface ReadQueryOptions<\n    TData,\n    TVariables extends OperationVariables,\n  > {\n    /**\n     * The GraphQL query shape to be used constructed using the `gql` template\n     * string tag. The query will be used to determine the\n     * shape of the data to be read.\n     */\n    query: DocumentNode | TypedDocumentNode<TData, TVariables>;\n\n    /**\n     * Any variables that the GraphQL query may depend on.\n     */\n    variables?: TVariables;\n\n    /**\n     * The root id to be used. Defaults to \"ROOT_QUERY\", which is the ID of the\n     * root query object. This property makes readQuery capable of reading data\n     * from any object in the cache.\n     */\n    id?: string;\n    /**\n     * Whether to return incomplete data rather than null.\n     * @defaultValue false\n     */\n    returnPartialData?: boolean;\n    /**\n     * Whether to read from optimistic or non-optimistic cache data. If\n     * this named option is provided, the optimistic parameter of the\n     * readQuery method can be omitted.\n     * @defaultValue false\n     */\n    optimistic?: boolean;\n  }\n\n  export type ReadFragmentOptions<\n    TData,\n    TVariables extends OperationVariables,\n  > = {\n    /**\n     * A GraphQL document created using the `gql` template string tag from\n     * `graphql-tag` with one or more fragments which will be used to determine\n     * the shape of data to read. If you provide more than one fragment in this\n     * document then you must also specify `fragmentName` to specify which\n     * fragment is the root fragment.\n     */\n    fragment: DocumentNode | TypedDocumentNode<TData, TVariables>;\n\n    /**\n     * The name of the fragment in your GraphQL document to be used. If you do\n     * not provide a `fragmentName` and there is only one fragment in your\n     * `fragment` document then that fragment will be used.\n     */\n    fragmentName?: string;\n\n    /**\n     * Any variables that your GraphQL fragments depend on.\n     */\n    variables?: TVariables;\n\n    /**\n     * Whether to return incomplete data rather than null.\n     * @defaultValue false\n     */\n    returnPartialData?: boolean;\n    /**\n     * Whether to read from optimistic or non-optimistic cache data. If\n     * this named option is provided, the optimistic parameter of the\n     * readFragment method can be omitted.\n     * @defaultValue false\n     */\n    optimistic?: boolean;\n  } & Cache.CacheIdentifierOption<TData>;\n\n  export interface WriteQueryOptions<\n    TData,\n    TVariables extends OperationVariables,\n  > {\n    /**\n     * The GraphQL query shape to be used constructed using the `gql` template\n     * string tag from `graphql-tag`. The query will be used to determine the\n     * shape of the data to be read.\n     */\n    query: DocumentNode | TypedDocumentNode<TData, TVariables>;\n\n    /**\n     * Any variables that the GraphQL query may depend on.\n     */\n    variables?: TVariables;\n\n    /**\n     * The root id to be used. Defaults to \"ROOT_QUERY\", which is the ID of the\n     * root query object. This property makes writeQuery capable of writing data\n     * to any object in the cache.\n     */\n    id?: string;\n\n    /**\n     * The data to write to the store.\n     */\n    data: Unmasked<TData>;\n    /**\n     * Whether to notify query watchers.\n     * @defaultValue true\n     */\n    broadcast?: boolean;\n    /**\n     * When true, ignore existing field data rather than merging it with\n     * incoming data.\n     * @defaultValue false\n     */\n    overwrite?: boolean;\n\n    /**\n     * GraphQL extensions for the write operation. Any provided `extensions`\n     * are available in `merge` functions.\n     */\n    extensions?: ExtensionsWithStreamInfo;\n  }\n\n  export type WriteFragmentOptions<\n    TData,\n    TVariables extends OperationVariables,\n  > = {\n    /**\n     * A GraphQL document created using the `gql` template string\n     * with one or more fragments which will be used to determine\n     * the shape of data to read. If you provide more than one fragment in this\n     * document then you must also specify `fragmentName` to specify specify which\n     * fragment is the root fragment.\n     */\n    fragment: DocumentNode | TypedDocumentNode<TData, TVariables>;\n\n    /**\n     * The name of the fragment in your GraphQL document to be used. If you do\n     * not provide a `fragmentName` and there is only one fragment in your\n     * `fragment` document then that fragment will be used.\n     */\n    fragmentName?: string;\n\n    /**\n     * Any variables that your GraphQL fragments depend on.\n     */\n    variables?: TVariables;\n    /**\n     * The data to write to the store.\n     */\n    data: Unmasked<TData>;\n    /**\n     * Whether to notify query watchers.\n     * @defaultValue true\n     */\n    broadcast?: boolean;\n    /**\n     * When true, ignore existing field data rather than merging it with\n     * incoming data.\n     * @defaultValue false\n     */\n    overwrite?: boolean;\n  } & Cache.CacheIdentifierOption<TData>;\n\n  export interface UpdateQueryOptions<\n    TData,\n    TVariables extends OperationVariables,\n  > extends Omit<\n      ReadQueryOptions<TData, TVariables> &\n        WriteQueryOptions<TData, TVariables>,\n      \"data\"\n    > {}\n\n  export type UpdateFragmentOptions<\n    TData,\n    TVariables extends OperationVariables,\n  > = Omit<\n    ReadFragmentOptions<TData, TVariables> &\n      WriteFragmentOptions<TData, TVariables>,\n    \"data\" | \"id\" | \"from\"\n  > &\n    Cache.CacheIdentifierOption<TData>;\n\n  export type DiffResult<TData> =\n    | {\n        result: DataValue.Complete<TData>;\n        complete: true;\n        missing?: never;\n        fromOptimisticTransaction?: boolean;\n      }\n    | {\n        result: DataValue.Partial<TData> | null;\n        complete: false;\n        missing?: MissingFieldError;\n        fromOptimisticTransaction?: boolean;\n      };\n\n  export type CacheIdentifierOption<TData> =\n    | {\n        /**\n         * The root id to be used. This id should take the same form as the\n         * value returned by the `cache.identify` function. If a value with your\n         * id does not exist in the store, `null` will be returned.\n         */\n        id?: string;\n\n        /**\n         * An object containing a `__typename` and primary key fields\n         * (such as `id`) identifying the entity object from which the fragment will\n         * be retrieved, or a `{ __ref: \"...\" }` reference, or a `string` ID\n         * (uncommon).\n         *\n         * @remarks\n         * `from` is given precedence over `id` when both are provided.\n         */\n        from?: never;\n      }\n    | {\n        /**\n         * The root id to be used. This id should take the same form as the\n         * value returned by the `cache.identify` function. If a value with your\n         * id does not exist in the store, `null` will be returned.\n         */\n        id?: never;\n\n        /**\n         * An object containing a `__typename` and primary key fields\n         * (such as `id`) identifying the entity object from which the fragment will\n         * be retrieved, or a `{ __ref: \"...\" }` reference, or a `string` ID\n         * (uncommon).\n         *\n         * @remarks\n         * `from` is given precedence over `id` when both are provided.\n         */\n        from?: ApolloCache.FromOptionValue<TData>;\n      };\n}\n"]}
+{"version":3,"file":"Cache.js","sourceRoot":"","sources":["../../../../src/cache/core/types/Cache.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  DataValue,\n  DocumentNode,\n  OperationVariables,\n  TypedDocumentNode,\n  TypeOverrides,\n} from \"@apollo/client\";\nimport type { Unmasked } from \"@apollo/client/masking\";\nimport type { ExtensionsWithStreamInfo } from \"@apollo/client/utilities/internal\";\n\nimport type { ApolloCache } from \"../cache.js\";\n\nimport type {\n  AllFieldsModifier,\n  MissingFieldError,\n  Modifiers,\n} from \"./common.js\";\nexport declare namespace Cache {\n  export type WatchCallback<TData = unknown> = (\n    diff: Cache.DiffResult<TData>,\n    lastDiff?: Cache.DiffResult<TData>\n  ) => void;\n\n  export type Implementation =\n    TypeOverrides extends { cache: infer TCache } ?\n      TCache extends ApolloCache ?\n        TCache\n      : \"The cache type declared in TypeOverrides does not extend `ApolloCache` and cannot be used with Apollo Client. See https://www.apollographql.com/docs/react/data/typescript#declaring-the-cache-type.\"\n    : ApolloCache;\n\n  export interface ReadOptions<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n  > {\n    /**\n     * The GraphQL query shape to be used constructed using the `gql` template\n     * string tag from `graphql-tag`. The query will be used to determine the\n     * shape of the data to be read.\n     */\n    query: DocumentNode | TypedDocumentNode<TData, TVariables>;\n\n    /**\n     * Any variables that the GraphQL query may depend on.\n     */\n    variables?: TVariables;\n\n    /**\n     * The root id to be used. Defaults to \"ROOT_QUERY\", which is the ID of the\n     * root query object. This property makes writeQuery capable of writing data\n     * to any object in the cache.\n     */\n    id?: string;\n    rootId?: string;\n    previousResult?: any;\n    optimistic: boolean;\n    returnPartialData?: boolean;\n  }\n\n  export interface WriteOptions<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n  > {\n    /**\n     * The GraphQL query shape to be used constructed using the `gql` template\n     * string tag from `graphql-tag`. The query will be used to determine the\n     * shape of the data to be read.\n     */\n    query: DocumentNode | TypedDocumentNode<TData, TVariables>;\n\n    /**\n     * Any variables that the GraphQL query may depend on.\n     */\n    variables?: TVariables;\n\n    dataId?: string;\n    result: Unmasked<TData>;\n\n    /**\n     * Whether to notify query watchers.\n     * @defaultValue true\n     */\n    broadcast?: boolean;\n    /**\n     * When true, ignore existing field data rather than merging it with\n     * incoming data.\n     * @defaultValue false\n     */\n    overwrite?: boolean;\n\n    /**\n     * GraphQL extensions for the write operation. Any provided `extensions`\n     * are available in `merge` functions.\n     */\n    extensions?: ExtensionsWithStreamInfo;\n  }\n\n  export interface DiffOptions<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n  > extends Omit<ReadOptions<TData, TVariables>, \"rootId\"> {\n    // The DiffOptions interface is currently just an alias for\n    // ReadOptions, though DiffOptions used to be responsible for\n    // declaring the returnPartialData option.\n  }\n\n  export interface WatchOptions<\n    TData = unknown,\n    TVariables extends OperationVariables = OperationVariables,\n  > extends DiffOptions<TData, TVariables> {\n    watcher?: object;\n    immediate?: boolean;\n    callback: WatchCallback<TData>;\n    lastDiff?: DiffResult<TData>;\n  }\n\n  export interface EvictOptions {\n    id?: string;\n    fieldName?: string;\n    args?: Record<string, any>;\n    broadcast?: boolean;\n  }\n\n  // Although you can call cache.reset() without options, its behavior can be\n  // configured by passing a Cache.ResetOptions object.\n  export interface ResetOptions {\n    discardWatches?: boolean;\n  }\n\n  export interface ModifyOptions<\n    Entity extends Record<string, any> = Record<string, any>,\n  > {\n    id?: string;\n    fields: Modifiers<Entity> | AllFieldsModifier<Entity>;\n    optimistic?: boolean;\n    broadcast?: boolean;\n  }\n\n  export interface BatchOptions<\n    TCache extends Cache.Implementation,\n    TUpdateResult = void,\n  > {\n    /**\n     * A function that performs cache operations. Receives the cache instance as its argument.\n     *\n     * The return value of this function becomes the return value of `batch`.\n     */\n    update(cache: TCache): TUpdateResult;\n\n    /**\n     * Controls how optimistic data is handled:\n     *\n     * - `string`: Creates a new optimistic layer with this ID. Use `removeOptimistic` later to remove it.\n     * - `true`: Updates the current top layer of the cache (including any optimistic data).\n     * - `false`: Updates only the root (non-optimistic) cache data.\n     *\n     * @defaultValue false\n     */\n    optimistic?: string | boolean;\n\n    /**\n     * If provided, removes the optimistic layer with this ID after the batch completes.\n     *\n     * This is useful for atomically applying server data while removing a pending optimistic update, triggering at most one broadcast for both operations.\n     *\n     * Note: this option is needed because calling `cache.removeOptimistic` during the transaction function may not be safe, since any modifications to cache layers may be discarded after the transaction finishes.\n     */\n    removeOptimistic?: string;\n\n    /**\n     * Optional callback invoked for each watcher affected by the batch operation.\n     *\n     * Receives the watch options, the new diff result, and optionally the previous diff result.\n     *\n     * Return `false` to prevent broadcasting to that specific watcher.\n     */\n    onWatchUpdated?: (\n      this: TCache,\n      watch: Cache.WatchOptions,\n      diff: Cache.DiffResult<any>,\n      lastDiff?: Cache.DiffResult<any> | undefined\n    ) => any;\n  }\n\n  export interface ReadQueryOptions<\n    TData,\n    TVariables extends OperationVariables,\n  > {\n    /**\n     * The GraphQL query shape to be used constructed using the `gql` template\n     * string tag. The query will be used to determine the\n     * shape of the data to be read.\n     */\n    query: DocumentNode | TypedDocumentNode<TData, TVariables>;\n\n    /**\n     * Any variables that the GraphQL query may depend on.\n     */\n    variables?: TVariables;\n\n    /**\n     * The root id to be used. Defaults to \"ROOT_QUERY\", which is the ID of the\n     * root query object. This property makes readQuery capable of reading data\n     * from any object in the cache.\n     */\n    id?: string;\n    /**\n     * Whether to return incomplete data rather than null.\n     * @defaultValue false\n     */\n    returnPartialData?: boolean;\n    /**\n     * Whether to read from optimistic or non-optimistic cache data. If\n     * this named option is provided, the optimistic parameter of the\n     * readQuery method can be omitted.\n     * @defaultValue false\n     */\n    optimistic?: boolean;\n  }\n\n  export type ReadFragmentOptions<\n    TData,\n    TVariables extends OperationVariables,\n  > = {\n    /**\n     * A GraphQL document created using the `gql` template string tag from\n     * `graphql-tag` with one or more fragments which will be used to determine\n     * the shape of data to read. If you provide more than one fragment in this\n     * document then you must also specify `fragmentName` to specify which\n     * fragment is the root fragment.\n     */\n    fragment: DocumentNode | TypedDocumentNode<TData, TVariables>;\n\n    /**\n     * The name of the fragment in your GraphQL document to be used. If you do\n     * not provide a `fragmentName` and there is only one fragment in your\n     * `fragment` document then that fragment will be used.\n     */\n    fragmentName?: string;\n\n    /**\n     * Any variables that your GraphQL fragments depend on.\n     */\n    variables?: TVariables;\n\n    /**\n     * Whether to return incomplete data rather than null.\n     * @defaultValue false\n     */\n    returnPartialData?: boolean;\n    /**\n     * Whether to read from optimistic or non-optimistic cache data. If\n     * this named option is provided, the optimistic parameter of the\n     * readFragment method can be omitted.\n     * @defaultValue false\n     */\n    optimistic?: boolean;\n  } & Cache.CacheIdentifierOption<TData>;\n\n  export interface WriteQueryOptions<\n    TData,\n    TVariables extends OperationVariables,\n  > {\n    /**\n     * The GraphQL query shape to be used constructed using the `gql` template\n     * string tag from `graphql-tag`. The query will be used to determine the\n     * shape of the data to be read.\n     */\n    query: DocumentNode | TypedDocumentNode<TData, TVariables>;\n\n    /**\n     * Any variables that the GraphQL query may depend on.\n     */\n    variables?: TVariables;\n\n    /**\n     * The root id to be used. Defaults to \"ROOT_QUERY\", which is the ID of the\n     * root query object. This property makes writeQuery capable of writing data\n     * to any object in the cache.\n     */\n    id?: string;\n\n    /**\n     * The data to write to the store.\n     */\n    data: Unmasked<TData>;\n    /**\n     * Whether to notify query watchers.\n     * @defaultValue true\n     */\n    broadcast?: boolean;\n    /**\n     * When true, ignore existing field data rather than merging it with\n     * incoming data.\n     * @defaultValue false\n     */\n    overwrite?: boolean;\n\n    /**\n     * GraphQL extensions for the write operation. Any provided `extensions`\n     * are available in `merge` functions.\n     */\n    extensions?: ExtensionsWithStreamInfo;\n  }\n\n  export type WriteFragmentOptions<\n    TData,\n    TVariables extends OperationVariables,\n  > = {\n    /**\n     * A GraphQL document created using the `gql` template string\n     * with one or more fragments which will be used to determine\n     * the shape of data to read. If you provide more than one fragment in this\n     * document then you must also specify `fragmentName` to specify specify which\n     * fragment is the root fragment.\n     */\n    fragment: DocumentNode | TypedDocumentNode<TData, TVariables>;\n\n    /**\n     * The name of the fragment in your GraphQL document to be used. If you do\n     * not provide a `fragmentName` and there is only one fragment in your\n     * `fragment` document then that fragment will be used.\n     */\n    fragmentName?: string;\n\n    /**\n     * Any variables that your GraphQL fragments depend on.\n     */\n    variables?: TVariables;\n    /**\n     * The data to write to the store.\n     */\n    data: Unmasked<TData>;\n    /**\n     * Whether to notify query watchers.\n     * @defaultValue true\n     */\n    broadcast?: boolean;\n    /**\n     * When true, ignore existing field data rather than merging it with\n     * incoming data.\n     * @defaultValue false\n     */\n    overwrite?: boolean;\n  } & Cache.CacheIdentifierOption<TData>;\n\n  export interface UpdateQueryOptions<\n    TData,\n    TVariables extends OperationVariables,\n  > extends Omit<\n      ReadQueryOptions<TData, TVariables> &\n        WriteQueryOptions<TData, TVariables>,\n      \"data\"\n    > {}\n\n  export type UpdateFragmentOptions<\n    TData,\n    TVariables extends OperationVariables,\n  > = Omit<\n    ReadFragmentOptions<TData, TVariables> &\n      WriteFragmentOptions<TData, TVariables>,\n    \"data\" | \"id\" | \"from\"\n  > &\n    Cache.CacheIdentifierOption<TData>;\n\n  export type DiffResult<TData> =\n    | {\n        result: DataValue.Complete<TData>;\n        complete: true;\n        missing?: never;\n        fromOptimisticTransaction?: boolean;\n      }\n    | {\n        result: DataValue.Partial<TData> | null;\n        complete: false;\n        missing?: MissingFieldError;\n        fromOptimisticTransaction?: boolean;\n      };\n\n  export type InternalDiffResultWithDataState<TData> =\n    | {\n        result: DataValue.Complete<TData>;\n        complete: true;\n        missing?: never;\n        dataState: \"complete\";\n        fromOptimisticTransaction?: boolean;\n      }\n    | {\n        result: DataValue.Streaming<TData>;\n        complete: false;\n        missing?: never;\n        dataState: \"streaming\";\n        fromOptimisticTransaction?: boolean;\n      }\n    | {\n        result: DataValue.Partial<TData>;\n        complete: false;\n        missing?: MissingFieldError;\n        dataState: \"partial\";\n        fromOptimisticTransaction?: boolean;\n      }\n    | {\n        result: null;\n        complete: false;\n        missing?: MissingFieldError;\n        dataState: \"empty\";\n        fromOptimisticTransaction?: boolean;\n      };\n\n  export type CacheIdentifierOption<TData> =\n    | {\n        /**\n         * The root id to be used. This id should take the same form as the\n         * value returned by the `cache.identify` function. If a value with your\n         * id does not exist in the store, `null` will be returned.\n         */\n        id?: string;\n\n        /**\n         * An object containing a `__typename` and primary key fields\n         * (such as `id`) identifying the entity object from which the fragment will\n         * be retrieved, or a `{ __ref: \"...\" }` reference, or a `string` ID\n         * (uncommon).\n         *\n         * @remarks\n         * `from` is given precedence over `id` when both are provided.\n         */\n        from?: never;\n      }\n    | {\n        /**\n         * The root id to be used. This id should take the same form as the\n         * value returned by the `cache.identify` function. If a value with your\n         * id does not exist in the store, `null` will be returned.\n         */\n        id?: never;\n\n        /**\n         * An object containing a `__typename` and primary key fields\n         * (such as `id`) identifying the entity object from which the fragment will\n         * be retrieved, or a `{ __ref: \"...\" }` reference, or a `string` ID\n         * (uncommon).\n         *\n         * @remarks\n         * `from` is given precedence over `id` when both are provided.\n         */\n        from?: ApolloCache.FromOptionValue<TData>;\n      };\n}\n"]}

package/cache/index.d.ts

@@ -1,6 +1,7 @@
 export type { Transaction } from "./core/cache.js";
 export type { WatchFragmentOptions, WatchFragmentResult, } from "./deprecated.js";
 export { ApolloCache } from "./core/cache.js";
+export { Scalar } from "./core/Scalar.js";
 export type { Cache } from "./core/types/Cache.js";
 export type { IgnoreModifier, MissingTree, Modifier, ModifierDetails, Modifiers, ReadFieldOptions, } from "./core/types/common.js";
 export { MissingFieldError } from "./core/types/common.js";
@@ -11,9 +12,9 @@ export { defaultDataIdFromObject, fieldNameFromStoreName, } from "./inmemory/hel
 export { InMemoryCache } from "./inmemory/inMemoryCache.js";
 export type { ReactiveVar } from "./inmemory/reactiveVars.js";
 export { cacheSlot, makeVar } from "./inmemory/reactiveVars.js";
-export type { FieldFunctionOptions, FieldMergeFunction, FieldMergeFunctionOptions, FieldPolicy, FieldReadFunction, FieldReadFunctionOptions, PossibleTypesMap, TypePolicies, TypePolicy, } from "./inmemory/policies.js";
+export type { FieldFunctionOptions, FieldMergeFunction, FieldMergeFunctionOptions, FieldPolicy, FieldReadFunction, FieldReadFunctionOptions, KeyArgsFunction, PossibleTypesMap, TypePolicies, TypePolicy, } from "./inmemory/policies.js";
 export { Policies } from "./inmemory/policies.js";
 export type { FragmentRegistryAPI } from "./inmemory/fragmentRegistry.js";
 export { createFragmentRegistry } from "./inmemory/fragmentRegistry.js";
-export type { ApolloReducerConfig, DiffQueryAgainstStoreOptions, IdGetter, IdGetterObj, InMemoryCacheConfig, MergeInfo, MergeTree, NormalizedCache, NormalizedCacheObject, OptimisticStoreItem, ReadMergeModifyContext, ReadQueryOptions, StoreObject, StoreValue, } from "./inmemory/types.js";
+export type { ApolloReducerConfig, DiffIncrementalInfo, DiffQueryAgainstStoreOptions, IdGetter, IdGetterObj, InMemoryCacheConfig, InputObjectConfig, InputObjectsOption, MergeInfo, MergeTree, NormalizedCache, NormalizedCacheObject, OptimisticStoreItem, ReadMergeModifyContext, ReadQueryOptions, StoreObject, StoreValue, } from "./inmemory/types.js";
 //# sourceMappingURL=index.d.ts.map

package/cache/index.js

@@ -1,4 +1,5 @@
 export { ApolloCache } from "./core/cache.js";
+export { Scalar } from "./core/Scalar.js";
 export { MissingFieldError } from "./core/types/common.js";
 export { canonicalStringify, isReference } from "@apollo/client/utilities";
 export { EntityStore } from "./inmemory/entityStore.js";

package/cache/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAU9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE3E,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAahE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC","sourcesContent":["export type { Transaction } from \"./core/cache.js\";\nexport type {\n  WatchFragmentOptions,\n  WatchFragmentResult,\n} from \"./deprecated.js\";\nexport { ApolloCache } from \"./core/cache.js\";\nexport type { Cache } from \"./core/types/Cache.js\";\nexport type {\n  IgnoreModifier,\n  MissingTree,\n  Modifier,\n  ModifierDetails,\n  Modifiers,\n  ReadFieldOptions,\n} from \"./core/types/common.js\";\nexport { MissingFieldError } from \"./core/types/common.js\";\n\nexport type { Reference } from \"@apollo/client/utilities\";\nexport { canonicalStringify, isReference } from \"@apollo/client/utilities\";\n\nexport { EntityStore } from \"./inmemory/entityStore.js\";\nexport {\n  defaultDataIdFromObject,\n  fieldNameFromStoreName,\n} from \"./inmemory/helpers.js\";\n\nexport { InMemoryCache } from \"./inmemory/inMemoryCache.js\";\n\nexport type { ReactiveVar } from \"./inmemory/reactiveVars.js\";\nexport { cacheSlot, makeVar } from \"./inmemory/reactiveVars.js\";\n\nexport type {\n  FieldFunctionOptions,\n  FieldMergeFunction,\n  FieldMergeFunctionOptions,\n  FieldPolicy,\n  FieldReadFunction,\n  FieldReadFunctionOptions,\n  PossibleTypesMap,\n  TypePolicies,\n  TypePolicy,\n} from \"./inmemory/policies.js\";\nexport { Policies } from \"./inmemory/policies.js\";\n\nexport type { FragmentRegistryAPI } from \"./inmemory/fragmentRegistry.js\";\nexport { createFragmentRegistry } from \"./inmemory/fragmentRegistry.js\";\n\nexport type {\n  ApolloReducerConfig,\n  DiffQueryAgainstStoreOptions,\n  IdGetter,\n  IdGetterObj,\n  InMemoryCacheConfig,\n  MergeInfo,\n  MergeTree,\n  NormalizedCache,\n  NormalizedCacheObject,\n  OptimisticStoreItem,\n  ReadMergeModifyContext,\n  ReadQueryOptions,\n  StoreObject,\n  StoreValue,\n} from \"./inmemory/types.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAU1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE3E,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAchE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC","sourcesContent":["export type { Transaction } from \"./core/cache.js\";\nexport type {\n  WatchFragmentOptions,\n  WatchFragmentResult,\n} from \"./deprecated.js\";\nexport { ApolloCache } from \"./core/cache.js\";\nexport { Scalar } from \"./core/Scalar.js\";\nexport type { Cache } from \"./core/types/Cache.js\";\nexport type {\n  IgnoreModifier,\n  MissingTree,\n  Modifier,\n  ModifierDetails,\n  Modifiers,\n  ReadFieldOptions,\n} from \"./core/types/common.js\";\nexport { MissingFieldError } from \"./core/types/common.js\";\n\nexport type { Reference } from \"@apollo/client/utilities\";\nexport { canonicalStringify, isReference } from \"@apollo/client/utilities\";\n\nexport { EntityStore } from \"./inmemory/entityStore.js\";\nexport {\n  defaultDataIdFromObject,\n  fieldNameFromStoreName,\n} from \"./inmemory/helpers.js\";\n\nexport { InMemoryCache } from \"./inmemory/inMemoryCache.js\";\n\nexport type { ReactiveVar } from \"./inmemory/reactiveVars.js\";\nexport { cacheSlot, makeVar } from \"./inmemory/reactiveVars.js\";\n\nexport type {\n  FieldFunctionOptions,\n  FieldMergeFunction,\n  FieldMergeFunctionOptions,\n  FieldPolicy,\n  FieldReadFunction,\n  FieldReadFunctionOptions,\n  KeyArgsFunction,\n  PossibleTypesMap,\n  TypePolicies,\n  TypePolicy,\n} from \"./inmemory/policies.js\";\nexport { Policies } from \"./inmemory/policies.js\";\n\nexport type { FragmentRegistryAPI } from \"./inmemory/fragmentRegistry.js\";\nexport { createFragmentRegistry } from \"./inmemory/fragmentRegistry.js\";\n\nexport type {\n  ApolloReducerConfig,\n  DiffIncrementalInfo,\n  DiffQueryAgainstStoreOptions,\n  IdGetter,\n  IdGetterObj,\n  InMemoryCacheConfig,\n  InputObjectConfig,\n  InputObjectsOption,\n  MergeInfo,\n  MergeTree,\n  NormalizedCache,\n  NormalizedCacheObject,\n  OptimisticStoreItem,\n  ReadMergeModifyContext,\n  ReadQueryOptions,\n  StoreObject,\n  StoreValue,\n} from \"./inmemory/types.js\";\n"]}

package/cache/inmemory/entityStore.d.ts

@@ -23,6 +23,9 @@ export declare abstract class EntityStore implements NormalizedCache {
     evict(options: Cache.EvictOptions, limit: EntityStore): boolean;
     clear(): void;
     extract(): NormalizedCacheObject;
+    private hasScalarConfig;
+    private coerceStoreObject;
+    private coerceValue;
     replace(newData: NormalizedCacheObject | null): void;
     abstract getStorage(idOrObj: string | StoreObject, ...storeFieldNames: (string | number)[]): StorageType;
     private rootIds;

package/cache/inmemory/entityStore.js

@@ -3,7 +3,7 @@ import { Trie } from "@wry/trie";
 import { dep } from "optimism";
 import { isReference } from "@apollo/client/utilities";
 import { __DEV__ } from "@apollo/client/utilities/environment";
-import { DeepMerger, isNonNullObject, makeReference, maybeDeepFreeze, } from "@apollo/client/utilities/internal";
+import { DeepMerger, isNonNullObject, isPlainObject, makeReference, maybeDeepFreeze, } from "@apollo/client/utilities/internal";
 import { invariant } from "@apollo/client/utilities/invariant";
 import { fieldNameFromStoreName, hasOwn } from "./helpers.js";
 const DELETE = {};
@@ -68,12 +68,17 @@ export class EntityStore {
         if (isReference(newer))
             newer = newer.__ref;
         const existing = typeof older === "string" ? this.lookup((dataId = older)) : older;
-        const incoming = typeof newer === "string" ? this.lookup((dataId = newer)) : newer;
+        let incoming = typeof newer === "string" ? this.lookup((dataId = newer)) : newer;
         // If newer was a string ID, but that ID was not defined in this store,
         // then there are no fields to be merged, so we're done.
         if (!incoming)
             return;
-        invariant(typeof dataId === "string", 104);
+        invariant(typeof dataId === "string", 107);
+        // Parse all scalars before merging so that the storeObjectReconciler can
+        // deep compare the parsed value with the existing value
+        incoming = this.coerceStoreObject(incoming, (scalar, value) => scalar.coerceToParsed(value), incoming.__typename ||
+            existing?.__typename ||
+            this.policies.rootTypenamesById[dataId]);
         const merged = new DeepMerger({
             reconciler: storeObjectReconciler,
         }).merge(existing, incoming);
@@ -175,7 +180,7 @@ export class EntityStore {
                             if (__DEV__) {
                                 const checkReference = (ref) => {
                                     if (this.lookup(ref.__ref) === undefined) {
-                                        __DEV__ && invariant.warn(105, ref);
+                                        __DEV__ && invariant.warn(108, ref);
                                         return true;
                                     }
                                 };
@@ -204,7 +209,7 @@ export class EntityStore {
                                             }
                                         }
                                         if (seenReference && someNonReference !== undefined) {
-                                            __DEV__ && invariant.warn(106, someNonReference);
+                                            __DEV__ && invariant.warn(109, someNonReference);
                                             break;
                                         }
                                     }
@@ -277,7 +282,14 @@ export class EntityStore {
         this.replace(null);
     }
     extract() {
-        const obj = this.toObject();
+        let obj = this.toObject();
+        if (this.hasScalarConfig()) {
+            obj = Object.fromEntries(Object.entries(obj).map(([dataId, storeObject]) => [
+                dataId,
+                storeObject &&
+                    this.coerceStoreObject(storeObject, (scalar, value) => scalar.coerceToSerialized(value), storeObject?.__typename || this.policies.rootTypenamesById[dataId]),
+            ]));
+        }
         const extraRootIds = [];
         this.getRootIdSet().forEach((id) => {
             if (!hasOwn.call(this.policies.rootTypenamesById, id)) {
@@ -289,6 +301,37 @@ export class EntityStore {
         }
         return obj;
     }
+    hasScalarConfig() {
+        return !!this.policies.cache["config"].scalars;
+    }
+    coerceStoreObject(obj, coerce, typename = obj.__typename) {
+        if (!typename || !this.hasScalarConfig()) {
+            return obj;
+        }
+        let changed = false;
+        const entries = Object.entries(obj).map(([storeFieldName, value]) => {
+            const scalar = this.policies.getScalarForField(typename, fieldNameFromStoreName(storeFieldName));
+            const newValue = this.coerceValue(value, coerce, scalar);
+            changed ||= newValue !== value;
+            return [storeFieldName, newValue];
+        });
+        return changed ? Object.fromEntries(entries) : obj;
+    }
+    coerceValue(value, coerce, scalar) {
+        if (value == null) {
+            return value;
+        }
+        if (Array.isArray(value)) {
+            return value.map((item) => this.coerceValue(item, coerce, scalar));
+        }
+        if (scalar) {
+            return coerce(scalar, value);
+        }
+        if (isPlainObject(value) && "__typename" in value) {
+            return this.coerceStoreObject(value, coerce);
+        }
+        return value;
+    }
     replace(newData) {
         Object.keys(this.data).forEach((dataId) => {
             if (!(newData && hasOwn.call(newData, dataId))) {