houdini 1.1.7 → 1.2.0-next.0

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

@@ -2,25 +2,33 @@ import { flatten } from "../lib/flatten";
 import { DocumentStore } from "./documentStore";
 import {
   fetch as fetchPlugin,
+  fetchParams as fetchParamsPlugin,
+  fragment as fragmentPlugin,
   mutation as mutationPlugin,
   query as queryPlugin,
-  fragment as fragmentPlugin,
-  throwOnError as throwOnErrorPlugin,
-  fetchParams as fetchParamsPlugin
+  throwOnError as throwOnErrorPlugin
 } from "./plugins";
 import pluginsFromPlugins from "./plugins/injectedPlugins";
 import { DocumentStore as DocumentStore2 } from "./documentStore";
 import { fetch, mutation, query, subscription } from "./plugins";
 class HoudiniClient {
   url;
-  #plugins;
-  constructor({ url, fetchParams, plugins, pipeline, throwOnError }) {
+  plugins;
+  throwOnError_operations;
+  constructor({
+    url,
+    fetchParams,
+    plugins,
+    pipeline,
+    throwOnError
+  }) {
     if (plugins && pipeline) {
       throw new Error(
         "A client cannot be given a pipeline and a list of plugins at the same time."
       );
     }
-    this.#plugins = flatten(
+    this.throwOnError_operations = throwOnError?.operations ?? [];
+    this.plugins = flatten(
       [].concat(
         throwOnError ? [throwOnErrorPlugin(throwOnError)] : [],
         fetchParamsPlugin(fetchParams),
@@ -46,7 +54,7 @@ class HoudiniClient {
     return new DocumentStore({
       client: this,
       artifact,
-      plugins: createPluginHooks(this.#plugins),
+      plugins: createPluginHooks(this.plugins),
       cache,
       initialValue,
       fetching

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

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

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

@@ -12,7 +12,7 @@ const cachePolicy = ({
     network(ctx, { initialValue, next, resolve, marshalVariables }) {
       const { policy, artifact } = ctx;
       let useCache = false;
-      if (enabled && artifact.kind === ArtifactKind.Query && !ctx.cacheParams?.disableRead) {
+      if (enabled && (artifact.kind === ArtifactKind.Query || artifact.kind === ArtifactKind.Fragment) && !ctx.cacheParams?.disableRead) {
         if (policy !== CachePolicy.NetworkOnly) {
           const value = localCache.read({
             selection: artifact.selection,
@@ -53,7 +53,17 @@ const cachePolicy = ({
           localCache._internal_unstable.collectGarbage();
         }, 0);
       }
-      setFetching(!useCache);
+      if (!ctx.stuff?.silenceLoading) {
+        let fetchingState = null;
+        if (!useCache && "enableLoadingState" in artifact && artifact.enableLoadingState) {
+          fetchingState = localCache.read({
+            selection: artifact.selection,
+            variables: marshalVariables(ctx),
+            loading: true
+          }).data;
+        }
+        setFetching(!useCache, fetchingState);
+      }
       return next(ctx);
     },
     afterNetwork(ctx, { resolve, value, marshalVariables }) {

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

@@ -21,6 +21,7 @@ export type FetchContext = {
 export type RequestHandlerArgs = FetchContext & FetchParams;
 export type RequestHandler<_Data = any> = (args: RequestHandlerArgs) => Promise<RequestPayload<_Data>>;
 export type FetchParams = {
+    name: string;
     text: string;
     hash: string;
     variables: {

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

@@ -8,6 +8,7 @@ const fetch = (target) => {
         }
         const fetch2 = ctx.fetch ?? globalThis.fetch;
         const fetchParams = {
+          name: ctx.artifact.name,
           text: ctx.text,
           hash: ctx.hash,
           variables: marshalVariables(ctx)
@@ -48,10 +49,10 @@ const defaultFetch = (url, params) => {
       "Could not find configured client url. Please specify one in your HoudiniClient constructor."
     );
   }
-  return async ({ fetch: fetch2, text, variables }) => {
+  return async ({ fetch: fetch2, name, text, variables }) => {
     const result = await fetch2(url, {
       method: "POST",
-      body: JSON.stringify({ query: text, variables }),
+      body: JSON.stringify({ operationName: name, query: text, variables }),
       ...params,
       headers: {
         Accept: "application/graphql+json, application/json",

package/build/runtime-esm/client/plugins/fragment.js

@@ -1,14 +1,20 @@
 import cache from "../../cache";
+import { deepEquals } from "../../lib/deepEquals";
 import { ArtifactKind, DataSource } from "../../lib/types";
 import { documentPlugin } from "../utils";
 const fragment = documentPlugin(ArtifactKind.Fragment, function() {
   let subscriptionSpec = null;
+  let lastReference = null;
   return {
     start(ctx, { next, resolve, variablesChanged, marshalVariables }) {
       if (!ctx.stuff.parentID) {
         return next(ctx);
       }
-      if (variablesChanged(ctx) && !ctx.cacheParams?.disableSubscriptions) {
+      const currentReference = {
+        parent: ctx.stuff.parentID,
+        variables: marshalVariables(ctx)
+      };
+      if (!ctx.cacheParams?.disableSubscriptions && (!deepEquals(lastReference, currentReference) || variablesChanged(ctx))) {
         if (subscriptionSpec) {
           cache.unsubscribe(subscriptionSpec, subscriptionSpec.variables?.() || {});
         }
@@ -31,6 +37,7 @@ const fragment = documentPlugin(ArtifactKind.Fragment, function() {
           }
         };
         cache.subscribe(subscriptionSpec, variables);
+        lastReference = currentReference;
       }
       next(ctx);
     },

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

@@ -18,10 +18,11 @@ const query = documentPlugin(ArtifactKind.Query, function() {
           cache.unsubscribe(subscriptionSpec, subscriptionSpec.variables?.() || {});
         }
         lastVariables = { ...marshalVariables(ctx) };
+        const variables = lastVariables;
         subscriptionSpec = {
           rootType: ctx.artifact.rootType,
           selection: ctx.artifact.selection,
-          variables: () => lastVariables,
+          variables: () => variables,
           set: (newValue) => {
             resolve(ctx, {
               data: newValue,

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

@@ -3,6 +3,7 @@ export declare function subscription(factory: SubscriptionHandler): import("../d
 export type SubscriptionHandler = (ctx: ClientPluginContext) => SubscriptionClient;
 export type SubscriptionClient = {
     subscribe: (payload: {
+        operationName: string;
         query: string;
         variables?: {};
     }, handlers: {

package/build/runtime-esm/client/plugins/subscription.js

@@ -32,6 +32,7 @@ function subscription(factory) {
         clearSubscription?.();
         clearSubscription = client.subscribe(
           {
+            operationName: ctx.artifact.name,
             query: ctx.artifact.raw,
             variables: marshalVariables(ctx)
           },

package/build/runtime-esm/client/plugins/throwOnError.d.ts

@@ -1,7 +1,8 @@
 import type { QueryResult } from '../../lib';
 import type { ClientPlugin, ClientPluginContext } from '../documentStore';
+export type ThrowOnErrorOperations = 'all' | 'query' | 'mutation' | 'subscription';
 export type ThrowOnErrorParams = {
-    operations: ('all' | 'query' | 'mutation' | 'subscription')[];
+    operations: ThrowOnErrorOperations[];
     error?: (errors: NonNullable<QueryResult<any, any>['errors']>, ctx: ClientPluginContext) => unknown;
 };
 export declare const throwOnError: ({ operations, error }: ThrowOnErrorParams) => ClientPlugin;

package/build/runtime-esm/lib/config.js

@@ -24,7 +24,8 @@ function defaultConfigValues(file) {
   };
 }
 function keyFieldsForType(configFile, type) {
-  return configFile.types?.[type]?.keys || configFile.defaultKeys;
+  const withDefault = defaultConfigValues(configFile);
+  return withDefault.types?.[type]?.keys || withDefault.defaultKeys;
 }
 function computeID(configFile, type, data) {
   const fields = keyFieldsForType(configFile, type);

package/build/runtime-esm/lib/pageInfo.d.ts

@@ -0,0 +1,7 @@
+import type { GraphQLObject, PageInfo } from './types';
+export declare function nullPageInfo(): PageInfo;
+export declare function missingPageSizeError(fnName: string): {
+    message: string;
+};
+export declare function extractPageInfo(data: any, path: string[]): PageInfo;
+export declare function countPage<_Data extends GraphQLObject>(source: string[], value: _Data | null): number;

package/build/runtime-esm/lib/pageInfo.js

@@ -0,0 +1,52 @@
+import { siteURL } from "./constants";
+function nullPageInfo() {
+  return { startCursor: null, endCursor: null, hasNextPage: false, hasPreviousPage: false };
+}
+function missingPageSizeError(fnName) {
+  return {
+    message: `${fnName} is missing the required page arguments. For more information, please visit this link: ${siteURL}/guides/pagination`
+  };
+}
+function extractPageInfo(data, path) {
+  if (!data) {
+    return {
+      startCursor: null,
+      endCursor: null,
+      hasNextPage: false,
+      hasPreviousPage: false
+    };
+  }
+  let localPath = [...path];
+  let current = data;
+  while (localPath.length > 0) {
+    if (!current) {
+      break;
+    }
+    current = current[localPath.shift()];
+  }
+  return current?.pageInfo ?? nullPageInfo();
+}
+function countPage(source, value) {
+  let data = value;
+  if (value === null || data === null || data === void 0) {
+    return 0;
+  }
+  for (const field of source) {
+    const obj = data[field];
+    if (obj && !Array.isArray(obj)) {
+      data = obj;
+    } else if (!data) {
+      throw new Error("Could not count page size");
+    }
+    if (Array.isArray(obj)) {
+      return obj.length;
+    }
+  }
+  return 0;
+}
+export {
+  countPage,
+  extractPageInfo,
+  missingPageSizeError,
+  nullPageInfo
+};

package/build/runtime-esm/lib/pagination.d.ts

@@ -0,0 +1,27 @@
+import type { SendParams } from '../client/documentStore';
+import type { CursorHandlers, FetchFn, GraphQLObject, QueryArtifact, QueryResult, FetchParams } from './types';
+export declare function cursorHandlers<_Data extends GraphQLObject, _Input extends Record<string, any>>({ artifact, fetchUpdate: parentFetchUpdate, fetch: parentFetch, getState, getVariables, getSession, }: {
+    artifact: QueryArtifact;
+    getState: () => _Data | null;
+    getVariables: () => _Input;
+    getSession: () => Promise<App.Session>;
+    fetch: FetchFn<_Data, _Input>;
+    fetchUpdate: (arg: SendParams, updates: string[]) => ReturnType<FetchFn<_Data, _Input>>;
+}): CursorHandlers<_Data, _Input>;
+export declare function offsetHandlers<_Data extends GraphQLObject, _Input extends {}>({ artifact, storeName, getState, getVariables, fetch: parentFetch, fetchUpdate: parentFetchUpdate, getSession, }: {
+    artifact: QueryArtifact;
+    fetch: FetchFn<_Data, _Input>;
+    fetchUpdate: (arg: SendParams) => ReturnType<FetchFn<_Data, _Input>>;
+    storeName: string;
+    getState: () => _Data | null;
+    getVariables: () => _Input;
+    getSession: () => Promise<App.Session>;
+}): {
+    loadNextPage: ({ limit, offset, fetch, metadata, }?: {
+        limit?: number | undefined;
+        offset?: number | undefined;
+        fetch?: typeof fetch | undefined;
+        metadata?: {} | undefined;
+    }) => Promise<void>;
+    fetch(params?: FetchParams<_Input>): Promise<QueryResult<_Data, _Input>>;
+};

package/build/runtime-esm/lib/pagination.js

@@ -0,0 +1,194 @@
+import { getCurrentConfig } from "./config";
+import { deepEquals } from "./deepEquals";
+import { countPage, extractPageInfo, missingPageSizeError } from "./pageInfo";
+import { CachePolicy } from "./types";
+function cursorHandlers({
+  artifact,
+  fetchUpdate: parentFetchUpdate,
+  fetch: parentFetch,
+  getState,
+  getVariables,
+  getSession
+}) {
+  const loadPage = async ({
+    pageSizeVar,
+    input,
+    functionName,
+    metadata = {},
+    fetch,
+    where
+  }) => {
+    const config = getCurrentConfig();
+    const loadVariables = {
+      ...getVariables(),
+      ...input
+    };
+    if (!loadVariables[pageSizeVar] && !artifact.refetch.pageSize) {
+      throw missingPageSizeError(functionName);
+    }
+    let isSinglePage = artifact.refetch?.mode === "SinglePage";
+    await (isSinglePage ? parentFetch : parentFetchUpdate)(
+      {
+        variables: loadVariables,
+        fetch,
+        metadata,
+        policy: isSinglePage ? artifact.policy : CachePolicy.NetworkOnly,
+        session: await getSession()
+      },
+      isSinglePage ? [] : [where === "start" ? "prepend" : "append"]
+    );
+  };
+  const getPageInfo = () => {
+    return extractPageInfo(getState(), artifact.refetch?.path ?? []);
+  };
+  return {
+    loadNextPage: async ({
+      first,
+      after,
+      fetch,
+      metadata
+    } = {}) => {
+      const currentPageInfo = getPageInfo();
+      if (!currentPageInfo.hasNextPage) {
+        return;
+      }
+      const input = {
+        first: first ?? artifact.refetch.pageSize,
+        after: after ?? currentPageInfo.endCursor,
+        before: null,
+        last: null
+      };
+      return await loadPage({
+        pageSizeVar: "first",
+        functionName: "loadNextPage",
+        input,
+        fetch,
+        metadata,
+        where: "end"
+      });
+    },
+    loadPreviousPage: async ({
+      last,
+      before,
+      fetch,
+      metadata
+    } = {}) => {
+      const currentPageInfo = getPageInfo();
+      if (!currentPageInfo.hasPreviousPage) {
+        return;
+      }
+      const input = {
+        before: before ?? currentPageInfo.startCursor,
+        last: last ?? artifact.refetch.pageSize,
+        first: null,
+        after: null
+      };
+      return await loadPage({
+        pageSizeVar: "last",
+        functionName: "loadPreviousPage",
+        input,
+        fetch,
+        metadata,
+        where: "start"
+      });
+    },
+    async fetch(args) {
+      const { variables } = args ?? {};
+      if (variables && !deepEquals(getVariables(), variables)) {
+        return await parentFetch(args);
+      }
+      try {
+        var currentPageInfo = extractPageInfo(getState(), artifact.refetch.path);
+      } catch {
+        return await parentFetch(args);
+      }
+      const queryVariables = {};
+      const count = countPage(artifact.refetch.path.concat("edges"), getState()) || artifact.refetch.pageSize;
+      if (count && count > artifact.refetch.pageSize) {
+        if (currentPageInfo.hasPreviousPage && currentPageInfo.hasNextPage && !(variables?.["first"] && variables?.["after"] || variables?.["last"] && variables?.["before"])) {
+          console.warn(`\u26A0\uFE0F Encountered a fetch() in the middle of the connection.
+Make sure to pass a cursor value by hand that includes the current set (ie the entry before startCursor)
+`);
+        }
+        if (!currentPageInfo.hasPreviousPage) {
+          queryVariables["first"] = count;
+          queryVariables["after"] = null;
+          queryVariables["last"] = null;
+          queryVariables["before"] = null;
+        } else if (!currentPageInfo.hasNextPage) {
+          queryVariables["last"] = count;
+          queryVariables["first"] = null;
+          queryVariables["after"] = null;
+          queryVariables["before"] = null;
+        }
+      }
+      Object.assign(queryVariables, variables ?? {});
+      const result = await parentFetch({
+        ...args,
+        variables: queryVariables
+      });
+      return result;
+    }
+  };
+}
+function offsetHandlers({
+  artifact,
+  storeName,
+  getState,
+  getVariables,
+  fetch: parentFetch,
+  fetchUpdate: parentFetchUpdate,
+  getSession
+}) {
+  let getOffset = () => artifact.refetch?.start || countPage(artifact.refetch.path, getState()) || artifact.refetch.pageSize;
+  let currentOffset = getOffset() ?? 0;
+  return {
+    loadNextPage: async ({
+      limit,
+      offset,
+      fetch,
+      metadata
+    } = {}) => {
+      const queryVariables = {
+        ...getVariables(),
+        offset: offset ?? getOffset()
+      };
+      if (limit || limit === 0) {
+        queryVariables.limit = limit;
+      }
+      if (!queryVariables.limit && !artifact.refetch.pageSize) {
+        throw missingPageSizeError("loadNextPage");
+      }
+      let isSinglePage = artifact.refetch?.mode === "SinglePage";
+      const targetFetch = isSinglePage ? parentFetch : parentFetchUpdate;
+      await targetFetch({
+        variables: queryVariables,
+        fetch,
+        metadata,
+        policy: isSinglePage ? artifact.policy : CachePolicy.NetworkOnly,
+        session: await getSession()
+      });
+      const pageSize = queryVariables.limit || artifact.refetch.pageSize;
+      currentOffset = offset + pageSize;
+    },
+    async fetch(params = {}) {
+      const { variables } = params;
+      if (variables && !deepEquals(getVariables(), variables)) {
+        return parentFetch.call(this, params);
+      }
+      const count = currentOffset || getOffset();
+      const queryVariables = {};
+      if (!artifact.refetch.pageSize || count > artifact.refetch.pageSize) {
+        queryVariables.limit = count;
+      }
+      return await parentFetch.call(this, {
+        ...params,
+        variables: queryVariables
+      });
+    }
+  };
+}
+export {
+  cursorHandlers,
+  offsetHandlers
+};

package/build/runtime-esm/lib/scalars.js

@@ -11,7 +11,7 @@ async function marshalSelection({
   if (Array.isArray(data)) {
     return await Promise.all(data.map((val) => marshalSelection({ selection, data: val })));
   }
-  const targetSelection = getFieldsForType(selection, data["__typename"]);
+  const targetSelection = getFieldsForType(selection, data["__typename"], false);
   return Object.fromEntries(
     await Promise.all(
       Object.entries(data).map(async ([fieldName, value]) => {

package/build/runtime-esm/lib/selection.d.ts

@@ -1,2 +1,2 @@
 import type { SubscriptionSelection } from './types';
-export declare function getFieldsForType(selection: SubscriptionSelection, __typename: string | undefined | null): Required<SubscriptionSelection>['fields'];
+export declare function getFieldsForType(selection: SubscriptionSelection, __typename: string | undefined | null, loading: boolean): Required<SubscriptionSelection>['fields'];

package/build/runtime-esm/lib/selection.js

@@ -1,4 +1,12 @@
-function getFieldsForType(selection, __typename) {
+function getFieldsForType(selection, __typename, loading) {
+  if (loading) {
+    if (selection.loadingTypes && selection.loadingTypes.length > 0) {
+      return deepMerge(
+        ...selection.loadingTypes.map((type) => selection.abstractFields?.fields[type])
+      );
+    }
+    return selection.fields ?? {};
+  }
   let targetSelection = selection.fields || {};
   if (selection.abstractFields && __typename) {
     const mappedType = selection.abstractFields.typeMap[__typename];
@@ -10,6 +18,25 @@ function getFieldsForType(selection, __typename) {
   }
   return targetSelection;
 }
+function deepMerge(...objects) {
+  const mergedObj = {};
+  for (let obj of objects) {
+    if (!obj) {
+      continue;
+    }
+    for (let prop in obj) {
+      if (prop in obj) {
+        const val = obj[prop];
+        if (typeof val === "object" && val !== null && !Array.isArray(val)) {
+          mergedObj[prop] = deepMerge(mergedObj[prop] || {}, val);
+        } else {
+          mergedObj[prop] = val;
+        }
+      }
+    }
+  }
+  return mergedObj;
+}
 export {
   getFieldsForType
 };

package/build/runtime-esm/lib/types.d.ts

@@ -25,6 +25,7 @@ declare global {
             };
             optimisticResponse?: GraphQLObject;
             parentID?: string;
+            silenceLoading?: boolean;
         }
     }
 }
@@ -52,9 +53,12 @@ export type CompiledDocumentKind = ArtifactKinds;
 export type QueryArtifact = BaseCompiledDocument<'HoudiniQuery'> & {
     policy?: CachePolicies;
     partial?: boolean;
+    enableLoadingState?: boolean;
 };
 export type MutationArtifact = BaseCompiledDocument<'HoudiniMutation'>;
-export type FragmentArtifact = BaseCompiledDocument<'HoudiniFragment'>;
+export type FragmentArtifact = BaseCompiledDocument<'HoudiniFragment'> & {
+    enableLoadingState?: boolean;
+};
 export type SubscriptionArtifact = BaseCompiledDocument<'HoudiniSubscription'>;
 export declare const RefetchUpdateMode: {
     readonly append: "append";
@@ -128,12 +132,31 @@ export type GraphQLObject = {
     [key: string]: GraphQLValue;
 };
 export type GraphQLValue = number | string | boolean | null | GraphQLObject | GraphQLValue[] | undefined;
+export type LoadingSpec = {
+    kind: 'continue';
+    list?: {
+        depth: number;
+        count: number;
+    };
+} | {
+    kind: 'value';
+    value?: any;
+    list?: {
+        depth: number;
+        count: number;
+    };
+};
 export type SubscriptionSelection = {
-    fragments?: Record<string, ValueMap>;
+    loadingTypes?: string[];
+    fragments?: Record<string, {
+        arguments: ValueMap;
+        loading?: boolean;
+    }>;
     fields?: {
         [fieldName: string]: {
             type: string;
             nullable?: boolean;
+            required?: boolean;
             keyRaw: string;
             operations?: MutationOperation[];
             list?: {
@@ -141,6 +164,7 @@ export type SubscriptionSelection = {
                 connection: boolean;
                 type: string;
             };
+            loading?: LoadingSpec;
             directives?: {
                 name: string;
                 arguments: ValueMap;
@@ -153,6 +177,7 @@ export type SubscriptionSelection = {
             }>;
             selection?: SubscriptionSelection;
             abstract?: boolean;
+            abstractHasRequired?: boolean;
         };
     };
     abstractFields?: {
@@ -194,9 +219,54 @@ export type RequestPayload<GraphQLObject = any> = {
 };
 export type NestedList<_Result = string> = (_Result | null | NestedList<_Result>)[];
 export type ValueOf<Parent> = Parent[keyof Parent];
-export declare const fragmentKey = " $fragments";
+export declare const fragmentKey: " $fragments";
 export type ValueNode = VariableNode | IntValueNode | FloatValueNode | StringValueNode | BooleanValueNode | NullValueNode | EnumValueNode | ListValueNode | ObjectValueNode;
 export type ValueMap = Record<string, ValueNode>;
+export type FetchParams<_Input> = {
+    variables?: _Input;
+    /**
+     * The policy to use when performing the fetch. If set to CachePolicy.NetworkOnly,
+     * a request will always be sent, even if the variables are the same as the last call
+     * to fetch.
+     */
+    policy?: CachePolicies;
+    /**
+     * An object that will be passed to the fetch function.
+     * You can do what you want with it!
+     */
+    metadata?: App.Metadata;
+};
+export type FetchFn<_Data extends GraphQLObject, _Input = any> = (params?: FetchParams<_Input>) => Promise<QueryResult<_Data, _Input>>;
+export type CursorHandlers<_Data extends GraphQLObject, _Input> = {
+    loadNextPage: (args?: {
+        first?: number;
+        after?: string;
+        fetch?: typeof globalThis.fetch;
+        metadata?: {};
+    }) => Promise<void>;
+    loadPreviousPage: (args?: {
+        last?: number;
+        before?: string;
+        fetch?: typeof globalThis.fetch;
+        metadata?: {};
+    }) => Promise<void>;
+    fetch(args?: FetchParams<_Input> | undefined): Promise<QueryResult<_Data, _Input>>;
+};
+export type OffsetHandlers<_Data extends GraphQLObject, _Input> = {
+    loadNextPage: (args?: {
+        limit?: number;
+        offset?: number;
+        metadata?: {};
+        fetch?: typeof globalThis.fetch;
+    }) => Promise<void>;
+    fetch(args?: FetchParams<_Input> | undefined): Promise<QueryResult<_Data, _Input>>;
+};
+export type PageInfo = {
+    startCursor: string | null;
+    endCursor: string | null;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+};
 interface IntValueNode {
     readonly kind: 'IntValue';
     readonly value: string;
@@ -241,4 +311,6 @@ interface VariableNode {
     readonly kind: 'Variable';
     readonly name: NameNode;
 }
+export declare const PendingValue: unique symbol;
+export type LoadingType = typeof PendingValue;
 export {};