houdini 1.1.2 → 1.1.4-react.0

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,29 @@
+import type { SendParams } from '../client/documentStore';
+import { FetchParams } from './types';
+import type { CursorHandlers, FetchFn, GraphQLObject, QueryArtifact, QueryResult } from './types';
+export declare function cursorHandlers<_Data extends GraphQLObject, _Input extends Record<string, any>>({ artifact, storeName, fetchUpdate: parentFetchUpdate, fetch: parentFetch, getState, getVariables, getSession, }: {
+    artifact: QueryArtifact;
+    storeName: string;
+    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,206 @@
+import { getCurrentConfig } from "./config";
+import { siteURL } from "./constants";
+import { deepEquals } from "./deepEquals";
+import { countPage, extractPageInfo, missingPageSizeError } from "./pageInfo";
+import { CachePolicy } from "./types";
+function cursorHandlers({
+  artifact,
+  storeName,
+  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 resultPath = [...artifact.refetch.path];
+    if (artifact.refetch.embedded) {
+      const { targetType } = artifact.refetch;
+      if (!config.types?.[targetType]?.resolve) {
+        throw new Error(
+          `Missing type resolve configuration for ${targetType}. For more information, see ${siteURL}/guides/pagination#paginated-fragments`
+        );
+      }
+      resultPath.unshift(config.types[targetType].resolve.queryField);
+    }
+  };
+  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/types.d.ts

@@ -25,6 +25,7 @@ declare global {
             };
             optimisticResponse?: GraphQLObject;
             parentID?: string;
+            silenceLoading?: boolean;
         }
     }
 }
@@ -193,6 +194,51 @@ export type ValueOf<Parent> = Parent[keyof Parent];
 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;