@mearie/core 0.2.3 → 0.3.0

package/dist/index.cjs

@@ -594,8 +594,10 @@ const denormalize = (selections, storage, value, variables, accessor) => {
 			const value = selection.selections ? denormalizeField(null, selection.selections, fieldValue) : fieldValue;
 			if (name in fields) mergeFields(fields, { [name]: value });
 			else fields[name] = value;
-		} else if (selection.kind === "FragmentSpread") if (storageKey !== null && storageKey !== RootFieldKey) fields[FragmentRefKey] = storageKey;
-		else mergeFields(fields, denormalizeField(storageKey, selection.selections, value));
+		} else if (selection.kind === "FragmentSpread") if (storageKey !== null && storageKey !== RootFieldKey) {
+			fields[FragmentRefKey] = storageKey;
+			if (accessor) denormalize(selection.selections, storage, { [EntityLinkKey]: storageKey }, variables, accessor);
+		} else mergeFields(fields, denormalizeField(storageKey, selection.selections, value));
 		else if (selection.kind === "InlineFragment" && selection.on === data[typenameFieldKey]) mergeFields(fields, denormalizeField(storageKey, selection.selections, value));
 		return fields;
 	};
@@ -616,6 +618,7 @@ var Cache = class {
 	#storage = { [RootFieldKey]: {} };
 	#subscriptions = /* @__PURE__ */ new Map();
 	#memo = /* @__PURE__ */ new Map();
+	#stale = /* @__PURE__ */ new Set();
 	constructor(schemaMetadata) {
 		this.#schemaMeta = schemaMetadata;
 	}
@@ -628,12 +631,14 @@ var Cache = class {
 	writeQuery(artifact, variables, data) {
 		const dependencies = /* @__PURE__ */ new Set();
 		const subscriptions = /* @__PURE__ */ new Set();
+		const entityStaleCleared = /* @__PURE__ */ new Set();
 		normalize(this.#schemaMeta, artifact.selections, this.#storage, data, variables, (storageKey, fieldKey, oldValue, newValue) => {
-			if (oldValue !== newValue) {
-				const dependencyKey = makeDependencyKey(storageKey, fieldKey);
-				dependencies.add(dependencyKey);
-			}
+			const depKey = makeDependencyKey(storageKey, fieldKey);
+			if (this.#stale.delete(depKey)) dependencies.add(depKey);
+			if (!entityStaleCleared.has(storageKey) && this.#stale.delete(storageKey)) entityStaleCleared.add(storageKey);
+			if (oldValue !== newValue) dependencies.add(depKey);
 		});
+		for (const entityKey of entityStaleCleared) this.#collectSubscriptions(entityKey, void 0, subscriptions);
 		for (const dependency of dependencies) {
 			const ss = this.#subscriptions.get(dependency);
 			if (ss) for (const s of ss) subscriptions.add(s);
@@ -648,13 +653,22 @@ var Cache = class {
 	* @returns Denormalized query result or null if not found.
 	*/
 	readQuery(artifact, variables) {
-		const { data, partial } = denormalize(artifact.selections, this.#storage, this.#storage[RootFieldKey], variables);
-		if (partial) return null;
+		let stale = false;
+		const { data, partial } = denormalize(artifact.selections, this.#storage, this.#storage[RootFieldKey], variables, (storageKey, fieldKey) => {
+			if (this.#stale.has(storageKey) || this.#stale.has(makeDependencyKey(storageKey, fieldKey))) stale = true;
+		});
+		if (partial) return {
+			data: null,
+			stale: false
+		};
 		const key = makeMemoKey("query", artifact.name, stringify(variables));
 		const prev = this.#memo.get(key);
 		const result = prev === void 0 ? data : replaceEqualDeep(prev, data);
 		this.#memo.set(key, result);
-		return result;
+		return {
+			data: result,
+			stale
+		};
 	}
 	/**
 	* Subscribes to cache invalidations for a specific query.
@@ -680,14 +694,26 @@ var Cache = class {
 	*/
 	readFragment(artifact, fragmentRef) {
 		const entityKey = fragmentRef[FragmentRefKey];
-		if (!this.#storage[entityKey]) return null;
-		const { data, partial } = denormalize(artifact.selections, this.#storage, { [EntityLinkKey]: entityKey }, {});
-		if (partial) return null;
+		if (!this.#storage[entityKey]) return {
+			data: null,
+			stale: false
+		};
+		let stale = false;
+		const { data, partial } = denormalize(artifact.selections, this.#storage, { [EntityLinkKey]: entityKey }, {}, (storageKey, fieldKey) => {
+			if (this.#stale.has(storageKey) || this.#stale.has(makeDependencyKey(storageKey, fieldKey))) stale = true;
+		});
+		if (partial) return {
+			data: null,
+			stale: false
+		};
 		const key = makeMemoKey("fragment", artifact.name, entityKey);
 		const prev = this.#memo.get(key);
 		const result = prev === void 0 ? data : replaceEqualDeep(prev, data);
 		this.#memo.set(key, result);
-		return result;
+		return {
+			data: result,
+			stale
+		};
 	}
 	subscribeFragment(artifact, fragmentRef, listener) {
 		const entityKey = fragmentRef[FragmentRefKey];
@@ -700,17 +726,25 @@ var Cache = class {
 	}
 	readFragments(artifact, fragmentRefs) {
 		const results = [];
+		let stale = false;
 		for (const ref of fragmentRefs) {
-			const data = this.readFragment(artifact, ref);
-			if (data === null) return null;
-			results.push(data);
+			const result = this.readFragment(artifact, ref);
+			if (result.data === null) return {
+				data: null,
+				stale: false
+			};
+			if (result.stale) stale = true;
+			results.push(result.data);
 		}
 		const entityKeys = fragmentRefs.map((ref) => ref[FragmentRefKey]);
 		const key = makeMemoKey("fragments", artifact.name, entityKeys.join(","));
 		const prev = this.#memo.get(key);
 		const result = prev === void 0 ? results : replaceEqualDeep(prev, results);
 		this.#memo.set(key, result);
-		return result;
+		return {
+			data: result,
+			stale
+		};
 	}
 	subscribeFragments(artifact, fragmentRefs, listener) {
 		const dependencies = /* @__PURE__ */ new Set();
@@ -730,20 +764,21 @@ var Cache = class {
 		const subscriptions = /* @__PURE__ */ new Set();
 		for (const target of targets) if (target.__typename === "Query") if ("field" in target) {
 			const fieldKey = makeFieldKeyFromArgs(target.field, target.args);
-			delete this.#storage[RootFieldKey]?.[fieldKey];
+			const depKey = makeDependencyKey(RootFieldKey, fieldKey);
+			this.#stale.add(depKey);
 			this.#collectSubscriptions(RootFieldKey, fieldKey, subscriptions);
 		} else {
-			this.#storage[RootFieldKey] = {};
+			this.#stale.add(RootFieldKey);
 			this.#collectSubscriptions(RootFieldKey, void 0, subscriptions);
 		}
 		else if ("id" in target) {
 			const entityKey = resolveEntityKey(target.__typename, target.id, this.#schemaMeta.entities[target.__typename]?.keyFields);
 			if ("field" in target) {
 				const fieldKey = makeFieldKeyFromArgs(target.field, target.args);
-				delete this.#storage[entityKey]?.[fieldKey];
+				this.#stale.add(makeDependencyKey(entityKey, fieldKey));
 				this.#collectSubscriptions(entityKey, fieldKey, subscriptions);
 			} else {
-				delete this.#storage[entityKey];
+				this.#stale.add(entityKey);
 				this.#collectSubscriptions(entityKey, void 0, subscriptions);
 			}
 		} else {
@@ -752,10 +787,10 @@ var Cache = class {
 				const entityKey = key;
 				if ("field" in target) {
 					const fieldKey = makeFieldKeyFromArgs(target.field, target.args);
-					delete this.#storage[entityKey]?.[fieldKey];
+					this.#stale.add(makeDependencyKey(entityKey, fieldKey));
 					this.#collectSubscriptions(entityKey, fieldKey, subscriptions);
 				} else {
-					delete this.#storage[entityKey];
+					this.#stale.add(entityKey);
 					this.#collectSubscriptions(entityKey, void 0, subscriptions);
 				}
 			}
@@ -814,6 +849,7 @@ var Cache = class {
 		this.#storage = { [RootFieldKey]: {} };
 		this.#subscriptions.clear();
 		this.#memo.clear();
+		this.#stale.clear();
 	}
 };
 
@@ -857,9 +893,10 @@ const cacheExchange = (options = {}) => {
 						return require_make.pipe(require_make.merge(require_make.fromValue(void 0), trigger.source), require_make.switchMap(() => require_make.fromSubscription(() => cache.readFragments(op.artifact, fragmentRef), () => cache.subscribeFragments(op.artifact, fragmentRef, async () => {
 							await Promise.resolve();
 							trigger.next();
-						}))), require_make.takeUntil(teardown$), require_make.map((data) => ({
+						}))), require_make.takeUntil(teardown$), require_make.map(({ data, stale }) => ({
 							operation: op,
 							data,
+							...stale && { metadata: { cache: { stale: true } } },
 							errors: []
 						})));
 					}
@@ -873,9 +910,10 @@ const cacheExchange = (options = {}) => {
 					return require_make.pipe(require_make.merge(require_make.fromValue(void 0), trigger.source), require_make.switchMap(() => require_make.fromSubscription(() => cache.readFragment(op.artifact, fragmentRef), () => cache.subscribeFragment(op.artifact, fragmentRef, async () => {
 						await Promise.resolve();
 						trigger.next();
-					}))), require_make.takeUntil(teardown$), require_make.map((data) => ({
+					}))), require_make.takeUntil(teardown$), require_make.map(({ data, stale }) => ({
 						operation: op,
 						data,
+						...stale && { metadata: { cache: { stale: true } } },
 						errors: []
 					})));
 				}));
@@ -889,8 +927,8 @@ const cacheExchange = (options = {}) => {
 					return require_make.pipe(require_make.merge(require_make.fromValue(void 0), trigger.source), require_make.switchMap(() => require_make.fromSubscription(() => cache.readQuery(op.artifact, op.variables), () => cache.subscribeQuery(op.artifact, op.variables, async () => {
 						await Promise.resolve();
 						trigger.next();
-					}))), require_make.takeUntil(teardown$), require_make.mergeMap((data) => {
-						if (data !== null) {
+					}))), require_make.takeUntil(teardown$), require_make.mergeMap(({ data, stale }) => {
+						if (data !== null && !stale) {
 							hasData = true;
 							return require_make.fromValue({
 								operation: op,
@@ -898,6 +936,16 @@ const cacheExchange = (options = {}) => {
 								errors: []
 							});
 						}
+						if (data !== null && stale) {
+							hasData = true;
+							refetch$.next(op);
+							return require_make.fromValue({
+								operation: op,
+								data,
+								metadata: { cache: { stale: true } },
+								errors: []
+							});
+						}
 						if (hasData) {
 							refetch$.next(op);
 							return empty();
@@ -910,8 +958,8 @@ const cacheExchange = (options = {}) => {
 						return empty();
 					}));
 				}), require_make.filter(() => fetchPolicy === "cache-only" || fetchPolicy === "cache-and-network" || fetchPolicy === "cache-first")), require_make.pipe(require_make.merge(nonCache$, require_make.pipe(query$, require_make.filter((op) => {
-					const cached = cache.readQuery(op.artifact, op.variables);
-					return fetchPolicy === "cache-and-network" || cached === null;
+					const { data } = cache.readQuery(op.artifact, op.variables);
+					return fetchPolicy === "cache-and-network" || data === null;
 				})), require_make.pipe(ops$, require_make.filter((op) => op.variant === "teardown")), refetch$.source), forward, require_make.tap((result) => {
 					if (result.operation.variant === "request" && result.data) cache.writeQuery(result.operation.artifact, result.operation.variables, result.data);
 				}), require_make.filter((result) => result.operation.variant !== "request" || result.operation.artifact.kind !== "query" || fetchPolicy === "network-only" || !!(result.errors && result.errors.length > 0))));

package/dist/index.d.cts

@@ -116,6 +116,7 @@ declare const createClient: <T extends SchemaMeta$1>(config: ClientOptions<T>) =
 //#endregion
 //#region src/exchange.d.ts
 interface OperationMetadataMap {}
+interface OperationResultMetadataMap {}
 type OperationMetadata = { [K in keyof OperationMetadataMap]?: OperationMetadataMap[K] } & Record<string, unknown>;
 type BaseOperation = {
   key: string;
@@ -135,7 +136,7 @@ type OperationResult = {
   data?: unknown;
   errors?: readonly OperationError[];
   extensions?: Record<string, unknown>;
-  stale?: boolean;
+  metadata?: OperationResultMetadataMap & Record<string, unknown>;
 };
 type ExchangeInput<TMeta extends SchemaMeta$1 = SchemaMeta$1> = {
   forward: ExchangeIO;
@@ -243,6 +244,11 @@ declare module '@mearie/core' {
   interface ExchangeExtensionMap {
     cache: CacheOperations;
   }
+  interface OperationResultMetadataMap {
+    cache?: {
+      stale: boolean;
+    };
+  }
 }
 type CacheOptions = {
   fetchPolicy?: 'cache-first' | 'cache-and-network' | 'network-only' | 'cache-only';
@@ -345,4 +351,4 @@ declare class RequiredFieldError extends Error {
  */
 declare const stringify: (value: unknown) => string;
 //#endregion
-export { AggregatedError, type Artifact, type ArtifactKind, type CacheOptions, type CacheSnapshot, Client, type ClientOptions, type DataOf, type Exchange, ExchangeError, type ExchangeErrorExtensionsMap, type ExchangeExtensionMap, type ExchangeIO, type ExchangeResult, type FragmentOptions, type FragmentRefs, GraphQLError, type HttpOptions, type MutationOptions, type Operation, type OperationError, type OperationMetadata, type OperationMetadataMap, type OperationResult, type QueryOptions, type RequiredAction, RequiredFieldError, type RetryOptions, type SchemaMeta, type SubscriptionClient, type SubscriptionExchangeOptions, type SubscriptionOptions, type VariablesOf, cacheExchange, createClient, dedupExchange, fragmentExchange, httpExchange, isAggregatedError, isExchangeError, isGraphQLError, requiredExchange, retryExchange, stringify, subscriptionExchange };
+export { AggregatedError, type Artifact, type ArtifactKind, type CacheOptions, type CacheSnapshot, Client, type ClientOptions, type DataOf, type Exchange, ExchangeError, type ExchangeErrorExtensionsMap, type ExchangeExtensionMap, type ExchangeIO, type ExchangeResult, type FragmentOptions, type FragmentRefs, GraphQLError, type HttpOptions, type MutationOptions, type Operation, type OperationError, type OperationMetadata, type OperationMetadataMap, type OperationResult, type OperationResultMetadataMap, type QueryOptions, type RequiredAction, RequiredFieldError, type RetryOptions, type SchemaMeta, type SubscriptionClient, type SubscriptionExchangeOptions, type SubscriptionOptions, type VariablesOf, cacheExchange, createClient, dedupExchange, fragmentExchange, httpExchange, isAggregatedError, isExchangeError, isGraphQLError, requiredExchange, retryExchange, stringify, subscriptionExchange };

package/dist/index.d.mts

@@ -116,6 +116,7 @@ declare const createClient: <T extends SchemaMeta$1>(config: ClientOptions<T>) =
 //#endregion
 //#region src/exchange.d.ts
 interface OperationMetadataMap {}
+interface OperationResultMetadataMap {}
 type OperationMetadata = { [K in keyof OperationMetadataMap]?: OperationMetadataMap[K] } & Record<string, unknown>;
 type BaseOperation = {
   key: string;
@@ -135,7 +136,7 @@ type OperationResult = {
   data?: unknown;
   errors?: readonly OperationError[];
   extensions?: Record<string, unknown>;
-  stale?: boolean;
+  metadata?: OperationResultMetadataMap & Record<string, unknown>;
 };
 type ExchangeInput<TMeta extends SchemaMeta$1 = SchemaMeta$1> = {
   forward: ExchangeIO;
@@ -243,6 +244,11 @@ declare module '@mearie/core' {
   interface ExchangeExtensionMap {
     cache: CacheOperations;
   }
+  interface OperationResultMetadataMap {
+    cache?: {
+      stale: boolean;
+    };
+  }
 }
 type CacheOptions = {
   fetchPolicy?: 'cache-first' | 'cache-and-network' | 'network-only' | 'cache-only';
@@ -345,4 +351,4 @@ declare class RequiredFieldError extends Error {
  */
 declare const stringify: (value: unknown) => string;
 //#endregion
-export { AggregatedError, type Artifact, type ArtifactKind, type CacheOptions, type CacheSnapshot, Client, type ClientOptions, type DataOf, type Exchange, ExchangeError, type ExchangeErrorExtensionsMap, type ExchangeExtensionMap, type ExchangeIO, type ExchangeResult, type FragmentOptions, type FragmentRefs, GraphQLError, type HttpOptions, type MutationOptions, type Operation, type OperationError, type OperationMetadata, type OperationMetadataMap, type OperationResult, type QueryOptions, type RequiredAction, RequiredFieldError, type RetryOptions, type SchemaMeta, type SubscriptionClient, type SubscriptionExchangeOptions, type SubscriptionOptions, type VariablesOf, cacheExchange, createClient, dedupExchange, fragmentExchange, httpExchange, isAggregatedError, isExchangeError, isGraphQLError, requiredExchange, retryExchange, stringify, subscriptionExchange };
+export { AggregatedError, type Artifact, type ArtifactKind, type CacheOptions, type CacheSnapshot, Client, type ClientOptions, type DataOf, type Exchange, ExchangeError, type ExchangeErrorExtensionsMap, type ExchangeExtensionMap, type ExchangeIO, type ExchangeResult, type FragmentOptions, type FragmentRefs, GraphQLError, type HttpOptions, type MutationOptions, type Operation, type OperationError, type OperationMetadata, type OperationMetadataMap, type OperationResult, type OperationResultMetadataMap, type QueryOptions, type RequiredAction, RequiredFieldError, type RetryOptions, type SchemaMeta, type SubscriptionClient, type SubscriptionExchangeOptions, type SubscriptionOptions, type VariablesOf, cacheExchange, createClient, dedupExchange, fragmentExchange, httpExchange, isAggregatedError, isExchangeError, isGraphQLError, requiredExchange, retryExchange, stringify, subscriptionExchange };

package/dist/index.mjs

@@ -593,8 +593,10 @@ const denormalize = (selections, storage, value, variables, accessor) => {
 			const value = selection.selections ? denormalizeField(null, selection.selections, fieldValue) : fieldValue;
 			if (name in fields) mergeFields(fields, { [name]: value });
 			else fields[name] = value;
-		} else if (selection.kind === "FragmentSpread") if (storageKey !== null && storageKey !== RootFieldKey) fields[FragmentRefKey] = storageKey;
-		else mergeFields(fields, denormalizeField(storageKey, selection.selections, value));
+		} else if (selection.kind === "FragmentSpread") if (storageKey !== null && storageKey !== RootFieldKey) {
+			fields[FragmentRefKey] = storageKey;
+			if (accessor) denormalize(selection.selections, storage, { [EntityLinkKey]: storageKey }, variables, accessor);
+		} else mergeFields(fields, denormalizeField(storageKey, selection.selections, value));
 		else if (selection.kind === "InlineFragment" && selection.on === data[typenameFieldKey]) mergeFields(fields, denormalizeField(storageKey, selection.selections, value));
 		return fields;
 	};
@@ -615,6 +617,7 @@ var Cache = class {
 	#storage = { [RootFieldKey]: {} };
 	#subscriptions = /* @__PURE__ */ new Map();
 	#memo = /* @__PURE__ */ new Map();
+	#stale = /* @__PURE__ */ new Set();
 	constructor(schemaMetadata) {
 		this.#schemaMeta = schemaMetadata;
 	}
@@ -627,12 +630,14 @@ var Cache = class {
 	writeQuery(artifact, variables, data) {
 		const dependencies = /* @__PURE__ */ new Set();
 		const subscriptions = /* @__PURE__ */ new Set();
+		const entityStaleCleared = /* @__PURE__ */ new Set();
 		normalize(this.#schemaMeta, artifact.selections, this.#storage, data, variables, (storageKey, fieldKey, oldValue, newValue) => {
-			if (oldValue !== newValue) {
-				const dependencyKey = makeDependencyKey(storageKey, fieldKey);
-				dependencies.add(dependencyKey);
-			}
+			const depKey = makeDependencyKey(storageKey, fieldKey);
+			if (this.#stale.delete(depKey)) dependencies.add(depKey);
+			if (!entityStaleCleared.has(storageKey) && this.#stale.delete(storageKey)) entityStaleCleared.add(storageKey);
+			if (oldValue !== newValue) dependencies.add(depKey);
 		});
+		for (const entityKey of entityStaleCleared) this.#collectSubscriptions(entityKey, void 0, subscriptions);
 		for (const dependency of dependencies) {
 			const ss = this.#subscriptions.get(dependency);
 			if (ss) for (const s of ss) subscriptions.add(s);
@@ -647,13 +652,22 @@ var Cache = class {
 	* @returns Denormalized query result or null if not found.
 	*/
 	readQuery(artifact, variables) {
-		const { data, partial } = denormalize(artifact.selections, this.#storage, this.#storage[RootFieldKey], variables);
-		if (partial) return null;
+		let stale = false;
+		const { data, partial } = denormalize(artifact.selections, this.#storage, this.#storage[RootFieldKey], variables, (storageKey, fieldKey) => {
+			if (this.#stale.has(storageKey) || this.#stale.has(makeDependencyKey(storageKey, fieldKey))) stale = true;
+		});
+		if (partial) return {
+			data: null,
+			stale: false
+		};
 		const key = makeMemoKey("query", artifact.name, stringify(variables));
 		const prev = this.#memo.get(key);
 		const result = prev === void 0 ? data : replaceEqualDeep(prev, data);
 		this.#memo.set(key, result);
-		return result;
+		return {
+			data: result,
+			stale
+		};
 	}
 	/**
 	* Subscribes to cache invalidations for a specific query.
@@ -679,14 +693,26 @@ var Cache = class {
 	*/
 	readFragment(artifact, fragmentRef) {
 		const entityKey = fragmentRef[FragmentRefKey];
-		if (!this.#storage[entityKey]) return null;
-		const { data, partial } = denormalize(artifact.selections, this.#storage, { [EntityLinkKey]: entityKey }, {});
-		if (partial) return null;
+		if (!this.#storage[entityKey]) return {
+			data: null,
+			stale: false
+		};
+		let stale = false;
+		const { data, partial } = denormalize(artifact.selections, this.#storage, { [EntityLinkKey]: entityKey }, {}, (storageKey, fieldKey) => {
+			if (this.#stale.has(storageKey) || this.#stale.has(makeDependencyKey(storageKey, fieldKey))) stale = true;
+		});
+		if (partial) return {
+			data: null,
+			stale: false
+		};
 		const key = makeMemoKey("fragment", artifact.name, entityKey);
 		const prev = this.#memo.get(key);
 		const result = prev === void 0 ? data : replaceEqualDeep(prev, data);
 		this.#memo.set(key, result);
-		return result;
+		return {
+			data: result,
+			stale
+		};
 	}
 	subscribeFragment(artifact, fragmentRef, listener) {
 		const entityKey = fragmentRef[FragmentRefKey];
@@ -699,17 +725,25 @@ var Cache = class {
 	}
 	readFragments(artifact, fragmentRefs) {
 		const results = [];
+		let stale = false;
 		for (const ref of fragmentRefs) {
-			const data = this.readFragment(artifact, ref);
-			if (data === null) return null;
-			results.push(data);
+			const result = this.readFragment(artifact, ref);
+			if (result.data === null) return {
+				data: null,
+				stale: false
+			};
+			if (result.stale) stale = true;
+			results.push(result.data);
 		}
 		const entityKeys = fragmentRefs.map((ref) => ref[FragmentRefKey]);
 		const key = makeMemoKey("fragments", artifact.name, entityKeys.join(","));
 		const prev = this.#memo.get(key);
 		const result = prev === void 0 ? results : replaceEqualDeep(prev, results);
 		this.#memo.set(key, result);
-		return result;
+		return {
+			data: result,
+			stale
+		};
 	}
 	subscribeFragments(artifact, fragmentRefs, listener) {
 		const dependencies = /* @__PURE__ */ new Set();
@@ -729,20 +763,21 @@ var Cache = class {
 		const subscriptions = /* @__PURE__ */ new Set();
 		for (const target of targets) if (target.__typename === "Query") if ("field" in target) {
 			const fieldKey = makeFieldKeyFromArgs(target.field, target.args);
-			delete this.#storage[RootFieldKey]?.[fieldKey];
+			const depKey = makeDependencyKey(RootFieldKey, fieldKey);
+			this.#stale.add(depKey);
 			this.#collectSubscriptions(RootFieldKey, fieldKey, subscriptions);
 		} else {
-			this.#storage[RootFieldKey] = {};
+			this.#stale.add(RootFieldKey);
 			this.#collectSubscriptions(RootFieldKey, void 0, subscriptions);
 		}
 		else if ("id" in target) {
 			const entityKey = resolveEntityKey(target.__typename, target.id, this.#schemaMeta.entities[target.__typename]?.keyFields);
 			if ("field" in target) {
 				const fieldKey = makeFieldKeyFromArgs(target.field, target.args);
-				delete this.#storage[entityKey]?.[fieldKey];
+				this.#stale.add(makeDependencyKey(entityKey, fieldKey));
 				this.#collectSubscriptions(entityKey, fieldKey, subscriptions);
 			} else {
-				delete this.#storage[entityKey];
+				this.#stale.add(entityKey);
 				this.#collectSubscriptions(entityKey, void 0, subscriptions);
 			}
 		} else {
@@ -751,10 +786,10 @@ var Cache = class {
 				const entityKey = key;
 				if ("field" in target) {
 					const fieldKey = makeFieldKeyFromArgs(target.field, target.args);
-					delete this.#storage[entityKey]?.[fieldKey];
+					this.#stale.add(makeDependencyKey(entityKey, fieldKey));
 					this.#collectSubscriptions(entityKey, fieldKey, subscriptions);
 				} else {
-					delete this.#storage[entityKey];
+					this.#stale.add(entityKey);
 					this.#collectSubscriptions(entityKey, void 0, subscriptions);
 				}
 			}
@@ -813,6 +848,7 @@ var Cache = class {
 		this.#storage = { [RootFieldKey]: {} };
 		this.#subscriptions.clear();
 		this.#memo.clear();
+		this.#stale.clear();
 	}
 };
 
@@ -856,9 +892,10 @@ const cacheExchange = (options = {}) => {
 						return pipe(merge(fromValue(void 0), trigger.source), switchMap(() => fromSubscription(() => cache.readFragments(op.artifact, fragmentRef), () => cache.subscribeFragments(op.artifact, fragmentRef, async () => {
 							await Promise.resolve();
 							trigger.next();
-						}))), takeUntil(teardown$), map((data) => ({
+						}))), takeUntil(teardown$), map(({ data, stale }) => ({
 							operation: op,
 							data,
+							...stale && { metadata: { cache: { stale: true } } },
 							errors: []
 						})));
 					}
@@ -872,9 +909,10 @@ const cacheExchange = (options = {}) => {
 					return pipe(merge(fromValue(void 0), trigger.source), switchMap(() => fromSubscription(() => cache.readFragment(op.artifact, fragmentRef), () => cache.subscribeFragment(op.artifact, fragmentRef, async () => {
 						await Promise.resolve();
 						trigger.next();
-					}))), takeUntil(teardown$), map((data) => ({
+					}))), takeUntil(teardown$), map(({ data, stale }) => ({
 						operation: op,
 						data,
+						...stale && { metadata: { cache: { stale: true } } },
 						errors: []
 					})));
 				}));
@@ -888,8 +926,8 @@ const cacheExchange = (options = {}) => {
 					return pipe(merge(fromValue(void 0), trigger.source), switchMap(() => fromSubscription(() => cache.readQuery(op.artifact, op.variables), () => cache.subscribeQuery(op.artifact, op.variables, async () => {
 						await Promise.resolve();
 						trigger.next();
-					}))), takeUntil(teardown$), mergeMap((data) => {
-						if (data !== null) {
+					}))), takeUntil(teardown$), mergeMap(({ data, stale }) => {
+						if (data !== null && !stale) {
 							hasData = true;
 							return fromValue({
 								operation: op,
@@ -897,6 +935,16 @@ const cacheExchange = (options = {}) => {
 								errors: []
 							});
 						}
+						if (data !== null && stale) {
+							hasData = true;
+							refetch$.next(op);
+							return fromValue({
+								operation: op,
+								data,
+								metadata: { cache: { stale: true } },
+								errors: []
+							});
+						}
 						if (hasData) {
 							refetch$.next(op);
 							return empty();
@@ -909,8 +957,8 @@ const cacheExchange = (options = {}) => {
 						return empty();
 					}));
 				}), filter(() => fetchPolicy === "cache-only" || fetchPolicy === "cache-and-network" || fetchPolicy === "cache-first")), pipe(merge(nonCache$, pipe(query$, filter((op) => {
-					const cached = cache.readQuery(op.artifact, op.variables);
-					return fetchPolicy === "cache-and-network" || cached === null;
+					const { data } = cache.readQuery(op.artifact, op.variables);
+					return fetchPolicy === "cache-and-network" || data === null;
 				})), pipe(ops$, filter((op) => op.variant === "teardown")), refetch$.source), forward, tap((result) => {
 					if (result.operation.variant === "request" && result.data) cache.writeQuery(result.operation.artifact, result.operation.variables, result.data);
 				}), filter((result) => result.operation.variant !== "request" || result.operation.artifact.kind !== "query" || fetchPolicy === "network-only" || !!(result.errors && result.errors.length > 0))));

package/package.json

@@ -1,15 +1,22 @@
 {
   "name": "@mearie/core",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "Type-safe, zero-overhead GraphQL client",
   "keywords": [
     "graphql",
     "graphql-client",
     "typescript",
+    "type-safe",
     "codegen",
-    "cache"
+    "cache",
+    "normalized-cache",
+    "react",
+    "vue",
+    "svelte",
+    "solid",
+    "vite"
   ],
-  "homepage": "https://github.com/devunt/mearie#readme",
+  "homepage": "https://mearie.dev/",
   "bugs": {
     "url": "https://github.com/devunt/mearie/issues"
   },
@@ -55,7 +62,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@mearie/shared": "0.2.1"
+    "@mearie/shared": "0.2.2"
   },
   "devDependencies": {
     "tsdown": "^0.20.3",