houdini 1.0.0-next.2 → 1.0.0-next.20

package/build/runtime-cjs/cache/stuff.js

@@ -18,25 +18,9 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var stuff_exports = {};
 __export(stuff_exports, {
-  evaluateKey: () => evaluateKey,
-  flattenList: () => flattenList
+  evaluateKey: () => evaluateKey
 });
 module.exports = __toCommonJS(stuff_exports);
-function flattenList(source) {
-  const flat = [];
-  const unvisited = [source || []];
-  while (unvisited.length > 0) {
-    const target = unvisited.shift();
-    for (const id of target) {
-      if (Array.isArray(id)) {
-        unvisited.push(id);
-        continue;
-      }
-      flat.push(id);
-    }
-  }
-  return flat;
-}
 function evaluateKey(key, variables = {}) {
   let evaluated = "";
   let varName = "";
@@ -65,6 +49,5 @@ function evaluateKey(key, variables = {}) {
 const varChars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ_0123456789";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  evaluateKey,
-  flattenList
+  evaluateKey
 });

package/build/runtime-cjs/cache/subscription.d.ts

@@ -19,10 +19,11 @@ export declare class InMemorySubscriptions {
             [key: string]: GraphQLValue;
         };
     }): void;
-    addFieldSubscription({ id, key, selection, }: {
+    addFieldSubscription({ id, key, selection, type, }: {
         id: string;
         key: string;
         selection: FieldSelection;
+        type: string;
     }): void;
     registerList({ list, id, key, parentType, selection, filters, variables, }: {
         list: Required<Required<SubscriptionSelection>['fields'][string]>['list'];

package/build/runtime-cjs/cache/subscription.js

@@ -21,6 +21,7 @@ __export(subscription_exports, {
   InMemorySubscriptions: () => InMemorySubscriptions
 });
 module.exports = __toCommonJS(subscription_exports);
+var import_flatten = require("../lib/flatten");
 var import_selection = require("../lib/selection");
 var import_stuff = require("./stuff");
 class InMemorySubscriptions {
@@ -51,7 +52,8 @@ class InMemorySubscriptions {
       this.addFieldSubscription({
         id: parent,
         key,
-        selection: [spec, targetSelection2]
+        selection: [spec, targetSelection2],
+        type
       });
       if (list) {
         this.registerList({
@@ -69,7 +71,7 @@ class InMemorySubscriptions {
           parent,
           key
         );
-        let children = !Array.isArray(linkedRecord) ? [linkedRecord] : (0, import_stuff.flattenList)(linkedRecord) || [];
+        let children = !Array.isArray(linkedRecord) ? [linkedRecord] : (0, import_flatten.flatten)(linkedRecord) || [];
         for (const child of children) {
           if (!child) {
             continue;
@@ -88,7 +90,8 @@ class InMemorySubscriptions {
   addFieldSubscription({
     id,
     key,
-    selection
+    selection,
+    type
   }) {
     const spec = selection[0];
     if (!this.subscribers[id]) {
@@ -160,7 +163,8 @@ class InMemorySubscriptions {
         this.addFieldSubscription({
           id: parent,
           key,
-          selection: [spec, fieldSelection]
+          selection: [spec, fieldSelection],
+          type: linkedType
         });
         if (list) {
           this.registerList({
@@ -176,7 +180,7 @@ class InMemorySubscriptions {
         const childSelection = selection.selection;
         if (childSelection) {
           const { value: link } = this.cache._internal_unstable.storage.get(parent, key);
-          const children = !Array.isArray(link) ? [link] : (0, import_stuff.flattenList)(link);
+          const children = !Array.isArray(link) ? [link] : (0, import_flatten.flatten)(link);
           for (const linkedRecord of children) {
             if (!linkedRecord) {
               continue;
@@ -212,7 +216,7 @@ class InMemorySubscriptions {
         continue;
       }
       const { value: previousValue } = this.cache._internal_unstable.storage.get(id, key);
-      const links = !Array.isArray(previousValue) ? [previousValue] : (0, import_stuff.flattenList)(previousValue);
+      const links = !Array.isArray(previousValue) ? [previousValue] : (0, import_flatten.flatten)(previousValue);
       for (const link of links) {
         if (link !== null) {
           linkedIDs.push([link, fieldSelection.selection || {}]);
@@ -252,7 +256,7 @@ class InMemorySubscriptions {
       if (kind === "scalar") {
         continue;
       }
-      const nextTargets = Array.isArray(value) ? (0, import_stuff.flattenList)(value) : [value];
+      const nextTargets = Array.isArray(value) ? (0, import_flatten.flatten)(value) : [value];
       for (const id2 of nextTargets) {
         if (visited.includes(id2)) {
           continue;

package/build/runtime-cjs/client/documentStore.d.ts

@@ -2,31 +2,23 @@ import type { HoudiniClient } from '.';
 import type { Layer } from '../cache/storage';
 import type { ConfigFile } from '../lib/config';
 import { Writable } from '../lib/store';
-import type { CachePolicy, DocumentArtifact, QueryResult, GraphQLObject, SubscriptionSpec } from '../lib/types';
+import type { DocumentArtifact, QueryResult, GraphQLObject, SubscriptionSpec, CachePolicies } from '../lib/types';
 export declare class DocumentStore<_Data extends GraphQLObject, _Input extends Record<string, any>> extends Writable<QueryResult<_Data, _Input>> {
     #private;
     constructor({ artifact, plugins, pipeline, client, cache, initialValue, fetching, }: {
         artifact: DocumentArtifact;
-        plugins?: ClientPlugin[];
-        pipeline?: ClientPlugin[];
-        client: HoudiniClient;
+        plugins?: ClientHooks[];
+        pipeline?: ClientHooks[];
+        client: HoudiniClient | null;
         cache?: boolean;
         initialValue?: _Data | null;
         fetching?: boolean;
     });
-    send({ metadata, session, fetch, variables, policy, stuff, cacheParams, setup, }?: {
-        fetch?: Fetch;
-        variables?: Record<string, any> | null;
-        metadata?: App.Metadata | null;
-        session?: App.Session | null;
-        policy?: CachePolicy;
-        stuff?: Partial<App.Stuff>;
-        cacheParams?: ClientPluginContext['cacheParams'];
-        setup?: boolean;
-    }): Promise<QueryResult<_Data, _Input>>;
+    send({ metadata, session, fetch, variables, policy, stuff, cacheParams, setup, silenceEcho, }?: SendParams): Promise<QueryResult<_Data, _Input>>;
 }
 declare function marshalVariables<_Data extends GraphQLObject, _Input extends {}>(ctx: ClientPluginContext): Record<string, any>;
-export type ClientPlugin = () => {
+export type ClientPlugin = () => ClientHooks | null | (ClientHooks | ClientPlugin | null)[];
+export type ClientHooks = {
     start?: ClientPluginEnterPhase;
     beforeNetwork?: ClientPluginEnterPhase;
     network?: ClientPluginEnterPhase;
@@ -41,7 +33,7 @@ export type ClientPluginContext = {
     text: string;
     hash: string;
     artifact: DocumentArtifact;
-    policy?: CachePolicy;
+    policy?: CachePolicies;
     fetch?: Fetch;
     variables?: Record<string, any>;
     metadata?: App.Metadata | null;
@@ -53,7 +45,7 @@ export type ClientPluginContext = {
         forceNotify?: boolean;
         disableWrite?: boolean;
         disableRead?: boolean;
-        applyUpdates?: boolean;
+        applyUpdates?: string[];
     };
     stuff: App.Stuff;
 };
@@ -84,4 +76,15 @@ export type ClientPluginExitHandlers = Omit<ClientPluginEnterHandlers, 'resolve'
 export type ClientPluginErrorHandlers = ClientPluginEnterHandlers & {
     error: unknown;
 };
+export type SendParams = {
+    fetch?: Fetch;
+    variables?: Record<string, any> | null;
+    metadata?: App.Metadata | null;
+    session?: App.Session | null;
+    policy?: CachePolicies;
+    stuff?: Partial<App.Stuff>;
+    cacheParams?: ClientPluginContext['cacheParams'];
+    setup?: boolean;
+    silenceEcho?: boolean;
+};
 export {};

package/build/runtime-cjs/client/documentStore.js

@@ -47,13 +47,12 @@ class DocumentStore extends import_store.Writable {
     initialValue,
     fetching
   }) {
-    if (fetching === void 0) {
-      fetching = artifact.kind === import_types.ArtifactKind.Query;
-    }
+    fetching ??= artifact.kind === import_types.ArtifactKind.Query;
     const initialState = {
       data: initialValue ?? null,
       errors: null,
       partial: false,
+      stale: false,
       source: null,
       fetching,
       variables: null
@@ -70,13 +69,13 @@ class DocumentStore extends import_store.Writable {
     this.#client = client;
     this.#lastVariables = null;
     this.#configFile = (0, import_config.getCurrentConfig)();
-    this.#plugins = (pipeline ?? [
-      (0, import_plugins.cachePolicyPlugin)({
+    this.#plugins = pipeline ?? [
+      (0, import_plugins.cachePolicy)({
         enabled: cache,
         setFetching: (fetching2) => this.update((state) => ({ ...state, fetching: fetching2 }))
-      }),
+      })(),
       ...plugins ?? []
-    ]).map((factory) => factory());
+    ];
   }
   async send({
     metadata,
@@ -86,7 +85,8 @@ class DocumentStore extends import_store.Writable {
     policy,
     stuff,
     cacheParams,
-    setup = false
+    setup = false,
+    silenceEcho = false
   } = {}) {
     let context = new ClientPluginContextWrapper({
       config: this.#configFile,
@@ -117,6 +117,7 @@ class DocumentStore extends import_store.Writable {
         setup,
         currentStep: 0,
         index: 0,
+        silenceEcho,
         promise: {
           resolved: false,
           resolve,
@@ -254,6 +255,9 @@ class DocumentStore extends import_store.Writable {
     }
     this.#lastContext = ctx.context.draft();
     this.#lastVariables = this.#lastContext.stuff.inputs.marshaled;
+    if (ctx.silenceEcho && finalValue.data === this.state.data) {
+      return;
+    }
     this.set(finalValue);
   }
 }

package/build/runtime-cjs/client/index.d.ts

@@ -1,25 +1,27 @@
 /// <reference path="../../../../../houdini.d.ts" />
-import type { DocumentArtifact, GraphQLObject } from '../lib/types';
-import type { ClientPlugin } from './documentStore';
+import type { DocumentArtifact, GraphQLObject, NestedList } from '../lib/types';
+import type { ClientPlugin, ClientHooks } from './documentStore';
 import { DocumentStore } from './documentStore';
 import { type FetchParamFn, type ThrowOnErrorParams } from './plugins';
 export { DocumentStore, type ClientPlugin } from './documentStore';
-export { fetchPlugin, mutationPlugin, queryPlugin, subscriptionPlugin } from './plugins';
+export { fetch, mutation, query, subscription } from './plugins';
 type ConstructorArgs = {
     url: string;
     fetchParams?: FetchParamFn;
-    plugins?: ClientPlugin[];
-    pipeline?: ClientPlugin[];
+    plugins?: NestedList<ClientPlugin>;
+    pipeline?: NestedList<ClientPlugin>;
     throwOnError?: ThrowOnErrorParams;
 };
+export type ObserveParams<_Data extends GraphQLObject, _Artifact extends DocumentArtifact = DocumentArtifact> = {
+    artifact: _Artifact;
+    cache?: boolean;
+    initialValue?: _Data | null;
+    fetching?: boolean;
+};
 export declare class HoudiniClient {
     #private;
     url: string;
     constructor({ url, fetchParams, plugins, pipeline, throwOnError }: ConstructorArgs);
-    observe<_Data extends GraphQLObject, _Input extends Record<string, any>>({ artifact, cache, initialValue, fetching, }: {
-        artifact: DocumentArtifact;
-        cache?: boolean;
-        initialValue?: _Data | null;
-        fetching?: boolean;
-    }): DocumentStore<_Data, _Input>;
+    observe<_Data extends GraphQLObject, _Input extends Record<string, any>>({ artifact, cache, initialValue, fetching, }: ObserveParams<_Data>): DocumentStore<_Data, _Input>;
 }
+export declare function createPluginHooks(plugins: ClientPlugin[]): ClientHooks[];

package/build/runtime-cjs/client/index.js

@@ -26,12 +26,14 @@ var client_exports = {};
 __export(client_exports, {
   DocumentStore: () => import_documentStore2.DocumentStore,
   HoudiniClient: () => HoudiniClient,
-  fetchPlugin: () => import_plugins2.fetchPlugin,
-  mutationPlugin: () => import_plugins2.mutationPlugin,
-  queryPlugin: () => import_plugins2.queryPlugin,
-  subscriptionPlugin: () => import_plugins2.subscriptionPlugin
+  createPluginHooks: () => createPluginHooks,
+  fetch: () => import_plugins2.fetch,
+  mutation: () => import_plugins2.mutation,
+  query: () => import_plugins2.query,
+  subscription: () => import_plugins2.subscription
 });
 module.exports = __toCommonJS(client_exports);
+var import_flatten = require("../lib/flatten");
 var import_documentStore = require("./documentStore");
 var import_plugins = require("./plugins");
 var import_injectedPlugins = __toESM(require("./plugins/injectedPlugins"), 1);
@@ -46,16 +48,18 @@ class HoudiniClient {
         "A client cannot be given a pipeline and a list of plugins at the same time."
       );
     }
-    this.#plugins = [].concat(
-      throwOnError ? [(0, import_plugins.throwOnErrorPlugin)(throwOnError)] : [],
-      (0, import_plugins.fetchParamsPlugin)(fetchParams),
-      pipeline ?? [
-        import_plugins.queryPlugin,
-        import_plugins.mutationPlugin
-      ].concat(
-        plugins ?? [],
-        import_injectedPlugins.default,
-        (0, import_plugins.fetchPlugin)()
+    this.#plugins = (0, import_flatten.flatten)(
+      [].concat(
+        throwOnError ? [(0, import_plugins.throwOnError)(throwOnError)] : [],
+        (0, import_plugins.fetchParams)(fetchParams),
+        pipeline ?? [
+          import_plugins.query,
+          import_plugins.mutation
+        ].concat(
+          plugins ?? [],
+          import_injectedPlugins.default,
+          (0, import_plugins.fetch)()
+        )
       )
     );
     this.url = url;
@@ -69,19 +73,44 @@ class HoudiniClient {
     return new import_documentStore.DocumentStore({
       client: this,
       artifact,
-      plugins: this.#plugins,
+      plugins: createPluginHooks(this.#plugins),
       cache,
       initialValue,
       fetching
     });
   }
 }
+function createPluginHooks(plugins) {
+  return plugins.reduce((hooks, plugin) => {
+    if (typeof plugin !== "function") {
+      throw new Error("Encountered client plugin that's not a function");
+    }
+    const result = plugin();
+    if (!result) {
+      return hooks;
+    }
+    if (!Array.isArray(result)) {
+      return hooks.concat(result);
+    }
+    for (const value of result) {
+      if (!value) {
+        continue;
+      }
+      if (typeof value === "function") {
+        return hooks.concat(createPluginHooks([value]));
+      }
+      hooks.push(value);
+    }
+    return hooks;
+  }, []);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DocumentStore,
   HoudiniClient,
-  fetchPlugin,
-  mutationPlugin,
-  queryPlugin,
-  subscriptionPlugin
+  createPluginHooks,
+  fetch,
+  mutation,
+  query,
+  subscription
 });

package/build/runtime-cjs/client/plugins/cache.d.ts

@@ -1,7 +1,7 @@
 import cache from '../../cache';
 import type { Cache } from '../../cache/cache';
 import type { ClientPlugin } from '../documentStore';
-export declare const cachePolicyPlugin: ({ enabled, setFetching, cache: localCache, }: {
+export declare const cachePolicy: ({ enabled, setFetching, cache: localCache, }: {
     enabled: boolean;
     setFetching: (val: boolean) => void;
     cache?: Cache | undefined;

package/build/runtime-cjs/client/plugins/cache.js

@@ -24,18 +24,18 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var cache_exports = {};
 __export(cache_exports, {
-  cachePolicyPlugin: () => cachePolicyPlugin
+  cachePolicy: () => cachePolicy
 });
 module.exports = __toCommonJS(cache_exports);
 var import_cache = __toESM(require("../../cache"), 1);
 var import_types = require("../../lib/types");
-const cachePolicyPlugin = ({
+const cachePolicy = ({
   enabled,
   setFetching,
   cache: localCache = import_cache.default
 }) => () => {
   return {
-    network(ctx, { next, resolve, marshalVariables }) {
+    network(ctx, { initialValue, next, resolve, marshalVariables }) {
       const { policy, artifact } = ctx;
       let useCache = false;
       if (enabled && artifact.kind === import_types.ArtifactKind.Query && !ctx.cacheParams?.disableRead) {
@@ -49,10 +49,11 @@ const cachePolicyPlugin = ({
             return resolve(ctx, {
               fetching: false,
               variables: ctx.variables ?? null,
-              data: value.data,
+              data: allowed ? value.data : initialValue.data,
               errors: null,
               source: import_types.DataSource.Cache,
-              partial: value.partial
+              partial: allowed ? value.partial : false,
+              stale: value.stale
             });
           }
           useCache = !!(value.data !== null && allowed);
@@ -63,10 +64,11 @@ const cachePolicyPlugin = ({
               data: value.data,
               errors: null,
               source: import_types.DataSource.Cache,
-              partial: value.partial
+              partial: value.partial,
+              stale: value.stale
             });
           }
-          if (useCache && !value.partial) {
+          if (useCache && !value.partial && !value.stale) {
             return;
           }
         }
@@ -95,5 +97,5 @@ const cachePolicyPlugin = ({
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  cachePolicyPlugin
+  cachePolicy
 });

package/build/runtime-cjs/client/plugins/fetch.d.ts

@@ -1,6 +1,6 @@
 import type { RequestPayload } from '../../lib/types';
 import type { ClientPlugin } from '../documentStore';
-export declare const fetchPlugin: (target?: RequestHandler | string) => ClientPlugin;
+export declare const fetch: (target?: RequestHandler | string) => ClientPlugin;
 export type FetchContext = {
     fetch: typeof globalThis.fetch;
     metadata?: App.Metadata | null;

package/build/runtime-cjs/client/plugins/fetch.js

@@ -19,16 +19,16 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var fetch_exports = {};
 __export(fetch_exports, {
   extractFiles: () => extractFiles,
-  fetchPlugin: () => fetchPlugin,
+  fetch: () => fetch,
   isExtractableFile: () => isExtractableFile
 });
 module.exports = __toCommonJS(fetch_exports);
 var import_types = require("../../lib/types");
-const fetchPlugin = (target) => {
+const fetch = (target) => {
   return () => {
     return {
       async network(ctx, { client, resolve, marshalVariables }) {
-        const fetch = ctx.fetch ?? globalThis.fetch;
+        const fetch2 = ctx.fetch ?? globalThis.fetch;
         const fetchParams = {
           text: ctx.text,
           hash: ctx.hash,
@@ -45,7 +45,7 @@ const fetchPlugin = (target) => {
         const result = await fetchFn({
           fetch: (url, args) => {
             const newArgs = handleMultipart(fetchParams, args) ?? args;
-            return fetch(url, newArgs);
+            return fetch2(url, newArgs);
           },
           metadata: ctx.metadata,
           session: ctx.session || {},
@@ -57,6 +57,7 @@ const fetchPlugin = (target) => {
           data: result.data,
           errors: !result.errors || result.errors.length === 0 ? null : result.errors,
           partial: false,
+          stale: false,
           source: import_types.DataSource.Network
         });
       }
@@ -66,11 +67,11 @@ const fetchPlugin = (target) => {
 const defaultFetch = (url, params) => {
   if (!url) {
     throw new Error(
-      "Could not find configured client url. Please specify one in your houdini.config.js file."
+      "Could not find configured client url. Please specify one in your HoudiniClient constructor."
     );
   }
-  return async ({ fetch, text, variables }) => {
-    const result = await fetch(url, {
+  return async ({ fetch: fetch2, text, variables }) => {
+    const result = await fetch2(url, {
       method: "POST",
       body: JSON.stringify({ query: text, variables }),
       ...params,
@@ -172,6 +173,6 @@ function isPlainObject(value) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   extractFiles,
-  fetchPlugin,
+  fetch,
   isExtractableFile
 });

package/build/runtime-cjs/client/plugins/fetchParams.d.ts

@@ -1,9 +1,9 @@
 import type { DocumentArtifact } from '../../lib/types';
 import type { ClientPlugin, ClientPluginContext } from '../documentStore';
 export type FetchParamFn = (ctx: FetchParamsInput) => Required<ClientPluginContext>['fetchParams'];
-export declare const fetchParamsPlugin: (fn?: FetchParamFn) => ClientPlugin;
+export declare const fetchParams: (fn?: FetchParamFn) => ClientPlugin;
 export type FetchParamsInput = Pick<ClientPluginContext, 'config' | 'policy' | 'variables' | 'metadata' | 'session' | 'stuff'> & {
     text: string;
     hash: string;
-    artifact: DocumentArtifact;
+    document: DocumentArtifact;
 };

package/build/runtime-cjs/client/plugins/fetchParams.js

@@ -18,15 +18,20 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var fetchParams_exports = {};
 __export(fetchParams_exports, {
-  fetchParamsPlugin: () => fetchParamsPlugin
+  fetchParams: () => fetchParams
 });
 module.exports = __toCommonJS(fetchParams_exports);
-const fetchParamsPlugin = (fn = () => ({})) => () => ({
+const fetchParams = (fn = () => ({})) => () => ({
   beforeNetwork(ctx, { next, marshalVariables }) {
     next({
       ...ctx,
       fetchParams: fn({
-        ...ctx,
+        config: ctx.config,
+        policy: ctx.policy,
+        metadata: ctx.metadata,
+        session: ctx.session,
+        stuff: ctx.stuff,
+        document: ctx.artifact,
         variables: marshalVariables(ctx),
         text: ctx.artifact.raw,
         hash: ctx.artifact.hash
@@ -36,5 +41,5 @@ const fetchParamsPlugin = (fn = () => ({})) => () => ({
 });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  fetchParamsPlugin
+  fetchParams
 });

package/build/runtime-cjs/client/plugins/injectedPlugins.d.ts

@@ -1,3 +1,4 @@
+import type { NestedList } from '../../lib/types';
 import type { ClientPlugin } from '../documentStore';
-declare const plugins: ClientPlugin[];
+declare const plugins: NestedList<ClientPlugin>;
 export default plugins;

package/build/runtime-cjs/client/plugins/mutation.d.ts

@@ -1 +1 @@
-export declare const mutationPlugin: import("..").ClientPlugin;
+export declare const mutation: import("..").ClientPlugin;

package/build/runtime-cjs/client/plugins/mutation.js

@@ -24,14 +24,14 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var mutation_exports = {};
 __export(mutation_exports, {
-  mutationPlugin: () => mutationPlugin
+  mutation: () => mutation
 });
 module.exports = __toCommonJS(mutation_exports);
 var import_cache = __toESM(require("../../cache"), 1);
 var import_scalars = require("../../lib/scalars");
 var import_types = require("../../lib/types");
 var import_utils = require("../utils");
-const mutationPlugin = (0, import_utils.documentPlugin)(import_types.ArtifactKind.Mutation, () => {
+const mutation = (0, import_utils.documentPlugin)(import_types.ArtifactKind.Mutation, () => {
   return {
     async start(ctx, { next, marshalVariables }) {
       const layer = import_cache.default._internal_unstable.storage.createLayer(true);
@@ -82,5 +82,5 @@ const mutationPlugin = (0, import_utils.documentPlugin)(import_types.ArtifactKin
 });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  mutationPlugin
+  mutation
 });

package/build/runtime-cjs/client/plugins/query.d.ts

@@ -1,2 +1,2 @@
 import type { ClientPlugin } from '../documentStore';
-export declare const queryPlugin: ClientPlugin;
+export declare const query: ClientPlugin;

package/build/runtime-cjs/client/plugins/query.js

@@ -24,13 +24,13 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var query_exports = {};
 __export(query_exports, {
-  queryPlugin: () => queryPlugin
+  query: () => query
 });
 module.exports = __toCommonJS(query_exports);
 var import_cache = __toESM(require("../../cache"), 1);
 var import_types = require("../../lib/types");
 var import_utils = require("../utils");
-const queryPlugin = (0, import_utils.documentPlugin)(import_types.ArtifactKind.Query, function() {
+const query = (0, import_utils.documentPlugin)(import_types.ArtifactKind.Query, function() {
   let subscriptionSpec = null;
   let lastVariables = null;
   let artifactName = "";
@@ -54,12 +54,12 @@ const queryPlugin = (0, import_utils.documentPlugin)(import_types.ArtifactKind.Q
           selection: ctx.artifact.selection,
           variables: () => lastVariables,
           set: (newValue) => {
-            console.log("setting from cache update");
             resolve(ctx, {
               data: newValue,
               errors: null,
               fetching: false,
               partial: false,
+              stale: false,
               source: import_types.DataSource.Cache,
               variables: ctx.variables ?? null
             });
@@ -79,5 +79,5 @@ const queryPlugin = (0, import_utils.documentPlugin)(import_types.ArtifactKind.Q
 });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  queryPlugin
+  query
 });

package/build/runtime-cjs/client/plugins/subscription.d.ts

@@ -1,13 +1,12 @@
-import type { GraphQLObject } from '../../lib/types';
 import type { ClientPluginContext } from '../documentStore';
-export declare function subscriptionPlugin(factory: SubscriptionHandler): import("../documentStore").ClientPlugin;
+export declare function subscription(factory: SubscriptionHandler): import("../documentStore").ClientPlugin;
 export type SubscriptionHandler = (ctx: ClientPluginContext) => {
     subscribe: (payload: {
         query: string;
         variables?: {};
     }, handlers: {
         next: (payload: {
-            data?: GraphQLObject;
+            data?: {} | null;
             errors?: readonly {
                 message: string;
             }[];