@dashai/sdk 0.7.0

package/dist/react/index.d.ts

@@ -0,0 +1,117 @@
+import { L as ListOpts, P as Page, b as BaseRow, B as BaseInsert, c as BaseUpdate, i as TableClient } from '../types-BLNQ1S1C.js';
+import { Query, AggQuery, QueryResult } from '../query/index.js';
+
+/**
+ * Hook options. Mirrors {@link ListOpts} fields the caller most often
+ * wants reactive — `filter`, `sort`, `limit`, `offset` — and a
+ * convenience `enabled` switch to skip the fetch entirely (useful when
+ * the caller's filter depends on other not-yet-loaded state).
+ *
+ * The hook RE-FETCHES whenever any of these values change (compared
+ * by JSON.stringify — sufficient for the typical filter object;
+ * callers with non-serialisable filters can memoise their `opts` or
+ * call `refetch()` imperatively).
+ */
+interface UseTableOpts<Row> extends ListOpts<Row> {
+    /**
+     * When `false`, the hook returns the idle state (`isLoading: false`,
+     * `data: null`) and skips the fetch. Default `true`.
+     */
+    enabled?: boolean;
+}
+interface UseTableResult<Row> {
+    /** Page rows. `null` until first fetch resolves. */
+    data: Row[] | null;
+    /** Full page envelope (rows + cursor + total). `null` until first fetch. */
+    page: Page<Row> | null;
+    /** True during the in-flight fetch (including refetches). */
+    isLoading: boolean;
+    /**
+     * Set when the most recent fetch threw. Cleared on the next
+     * successful refetch.
+     */
+    error: Error | null;
+    /** Re-runs the list query with the current opts. */
+    refetch: () => Promise<void>;
+    /**
+     * Optimistically replace the local `data` without hitting the
+     * server. Useful for instant UI after a mutation; the next
+     * `refetch()` reconciles with the server.
+     */
+    mutate: (next: Row[]) => void;
+}
+/**
+ * Fetch a paginated list from a DashWise table. Re-runs when any of
+ * the `opts` change.
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading, error, refetch } = useTable(
+ *   db.db<Task>("tasks"),
+ *   { filter: { done: false }, sort: [{ field: "createdAt", desc: true }] }
+ * );
+ * ```
+ */
+declare function useTable<Row extends BaseRow, Insert extends BaseInsert = BaseInsert, Update extends BaseUpdate = BaseUpdate>(table: TableClient<Row, Insert, Update>, opts?: UseTableOpts<Row>): UseTableResult<Row>;
+
+interface UseRecordResult<Row, Update> {
+    /** The record. `null` until first fetch resolves or after `remove()`. */
+    data: Row | null;
+    /** True during the in-flight fetch (initial load OR refetch). */
+    isLoading: boolean;
+    /** True while a save / remove call is in flight. */
+    isSaving: boolean;
+    error: Error | null;
+    /** Re-run the GET. */
+    refetch: () => Promise<void>;
+    /**
+     * Patch the record. The hook PATCHes via `table.update(id, updates)`
+     * and refreshes `data` from the server's response. Throws on
+     * validation failure; callers can wrap in try/catch.
+     */
+    save: (updates: Update) => Promise<Row>;
+    /**
+     * Delete the record. After success, `data` becomes `null` and any
+     * subsequent `refetch()` will see the 404. The hook does NOT
+     * navigate; callers handle post-delete UX (toast, redirect, etc.).
+     */
+    remove: () => Promise<void>;
+}
+/**
+ * Fetch a single record by id from a DashWise table; expose save +
+ * remove handles so a detail page never needs to write
+ * `useEffect`/`useState`/`fetch` boilerplate.
+ *
+ * @example
+ * ```tsx
+ * const { data: task, isLoading, save } = useRecord(db.db<Task>("tasks"), id);
+ * if (!task) return <LoadingState />;
+ * return (
+ *   <Button onClick={() => save({ done: !task.done })}>
+ *     Toggle done
+ *   </Button>
+ * );
+ * ```
+ *
+ * Skips the fetch when `id` is null / undefined / "" — handy for
+ * conditional rendering ("show form only if there's a selected id").
+ */
+declare function useRecord<Row extends BaseRow, Insert extends BaseInsert = BaseInsert, Update extends BaseUpdate = BaseUpdate>(table: TableClient<Row, Insert, Update>, id: string | number | null | undefined): UseRecordResult<Row, Update>;
+
+interface UseQueryResult<T> {
+    /** Query result envelope. `null` until first fetch resolves. */
+    data: T | null;
+    /** True during the in-flight fetch (initial + refetches). */
+    isLoading: boolean;
+    /**
+     * Set when the most recent fetch threw. Cleared on the next
+     * successful refetch.
+     */
+    error: Error | null;
+    /** Re-run the query (uses the builder's current AST). */
+    refetch: () => Promise<void>;
+}
+declare function useQuery<Row extends BaseRow>(query: Query<Row>): UseQueryResult<Page<Row>>;
+declare function useQuery(query: AggQuery): UseQueryResult<QueryResult>;
+
+export { type UseQueryResult, type UseRecordResult, type UseTableOpts, type UseTableResult, useQuery, useRecord, useTable };

package/dist/react/index.js

@@ -0,0 +1,195 @@
+'use client';
+import { useState, useRef, useCallback, useEffect } from 'react';
+
+// src/react/use-table.ts
+function useTable(table, opts = {}) {
+  const { enabled = true, ...listOpts } = opts;
+  const [page, setPage] = useState(null);
+  const [isLoading, setIsLoading] = useState(enabled);
+  const [error, setError] = useState(null);
+  const fingerprint = JSON.stringify(listOpts);
+  const tableRef = useRef(table);
+  tableRef.current = table;
+  const refetch = useCallback(async () => {
+    if (!enabled) return;
+    setIsLoading(true);
+    setError(null);
+    try {
+      const result = await tableRef.current.list(JSON.parse(fingerprint));
+      setPage(result);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setIsLoading(false);
+    }
+  }, [enabled, fingerprint]);
+  useEffect(() => {
+    if (!enabled) {
+      setIsLoading(false);
+      return;
+    }
+    let cancelled = false;
+    setIsLoading(true);
+    setError(null);
+    void (async () => {
+      try {
+        const result = await tableRef.current.list(JSON.parse(fingerprint));
+        if (cancelled) return;
+        setPage(result);
+      } catch (err) {
+        if (cancelled) return;
+        setError(err instanceof Error ? err : new Error(String(err)));
+      } finally {
+        if (cancelled) return;
+        setIsLoading(false);
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [enabled, fingerprint]);
+  const mutate = useCallback((next) => {
+    setPage(
+      (prev) => prev ? { ...prev, rows: next } : { rows: next, total: next.length, limit: next.length, offset: 0 }
+    );
+  }, []);
+  return {
+    data: page ? page.rows : null,
+    page,
+    isLoading,
+    error,
+    refetch,
+    mutate
+  };
+}
+function useRecord(table, id) {
+  const enabled = id !== null && id !== void 0 && id !== "";
+  const [data, setData] = useState(null);
+  const [isLoading, setIsLoading] = useState(enabled);
+  const [isSaving, setIsSaving] = useState(false);
+  const [error, setError] = useState(null);
+  const tableRef = useRef(table);
+  tableRef.current = table;
+  const refetch = useCallback(async () => {
+    if (!enabled) return;
+    setIsLoading(true);
+    setError(null);
+    try {
+      const row = await tableRef.current.get(Number(id));
+      setData(row);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setIsLoading(false);
+    }
+  }, [enabled, id]);
+  useEffect(() => {
+    if (!enabled) {
+      setData(null);
+      setIsLoading(false);
+      return;
+    }
+    let cancelled = false;
+    setIsLoading(true);
+    setError(null);
+    void (async () => {
+      try {
+        const row = await tableRef.current.get(Number(id));
+        if (cancelled) return;
+        setData(row);
+      } catch (err) {
+        if (cancelled) return;
+        setError(err instanceof Error ? err : new Error(String(err)));
+      } finally {
+        if (cancelled) return;
+        setIsLoading(false);
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [enabled, id]);
+  const save = useCallback(
+    async (updates) => {
+      if (!enabled) {
+        throw new Error("useRecord.save: id is null/empty");
+      }
+      setIsSaving(true);
+      setError(null);
+      try {
+        const row = await tableRef.current.update(Number(id), updates);
+        setData(row);
+        return row;
+      } catch (err) {
+        const e = err instanceof Error ? err : new Error(String(err));
+        setError(e);
+        throw e;
+      } finally {
+        setIsSaving(false);
+      }
+    },
+    [enabled, id]
+  );
+  const remove = useCallback(async () => {
+    if (!enabled) return;
+    setIsSaving(true);
+    setError(null);
+    try {
+      await tableRef.current.delete(Number(id));
+      setData(null);
+    } catch (err) {
+      const e = err instanceof Error ? err : new Error(String(err));
+      setError(e);
+      throw e;
+    } finally {
+      setIsSaving(false);
+    }
+  }, [enabled, id]);
+  return { data, isLoading, isSaving, error, refetch, save, remove };
+}
+function useQuery(query) {
+  const [data, setData] = useState(null);
+  const [isLoading, setIsLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const fingerprint = JSON.stringify(query.toAst());
+  const queryRef = useRef(query);
+  queryRef.current = query;
+  const refetch = useCallback(async () => {
+    setIsLoading(true);
+    setError(null);
+    try {
+      const result = await queryRef.current.execute();
+      setData(result);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setIsLoading(false);
+    }
+  }, [fingerprint]);
+  useEffect(() => {
+    let cancelled = false;
+    setIsLoading(true);
+    setError(null);
+    void (async () => {
+      try {
+        const result = await queryRef.current.execute();
+        if (cancelled) return;
+        setData(result);
+      } catch (err) {
+        if (cancelled) return;
+        setError(err instanceof Error ? err : new Error(String(err)));
+      } finally {
+        if (cancelled) return;
+        setIsLoading(false);
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [fingerprint]);
+  return { data, isLoading, error, refetch };
+}
+
+export { useQuery, useRecord, useTable };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/use-table.ts","../../src/react/use-record.ts","../../src/react/use-query.ts"],"names":["useState","useRef","useCallback","useEffect"],"mappings":"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","file":"index.js","sourcesContent":["'use client';\n\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport type {\n  BaseInsert,\n  BaseRow,\n  BaseUpdate,\n  ListOpts,\n  Page,\n  TableClient,\n} from '../data/types.js';\n\n/**\n * Hook options. Mirrors {@link ListOpts} fields the caller most often\n * wants reactive — `filter`, `sort`, `limit`, `offset` — and a\n * convenience `enabled` switch to skip the fetch entirely (useful when\n * the caller's filter depends on other not-yet-loaded state).\n *\n * The hook RE-FETCHES whenever any of these values change (compared\n * by JSON.stringify — sufficient for the typical filter object;\n * callers with non-serialisable filters can memoise their `opts` or\n * call `refetch()` imperatively).\n */\nexport interface UseTableOpts<Row> extends ListOpts<Row> {\n  /**\n   * When `false`, the hook returns the idle state (`isLoading: false`,\n   * `data: null`) and skips the fetch. Default `true`.\n   */\n  enabled?: boolean;\n}\n\nexport interface UseTableResult<Row> {\n  /** Page rows. `null` until first fetch resolves. */\n  data: Row[] | null;\n  /** Full page envelope (rows + cursor + total). `null` until first fetch. */\n  page: Page<Row> | null;\n  /** True during the in-flight fetch (including refetches). */\n  isLoading: boolean;\n  /**\n   * Set when the most recent fetch threw. Cleared on the next\n   * successful refetch.\n   */\n  error: Error | null;\n  /** Re-runs the list query with the current opts. */\n  refetch: () => Promise<void>;\n  /**\n   * Optimistically replace the local `data` without hitting the\n   * server. Useful for instant UI after a mutation; the next\n   * `refetch()` reconciles with the server.\n   */\n  mutate: (next: Row[]) => void;\n}\n\n/**\n * Fetch a paginated list from a DashWise table. Re-runs when any of\n * the `opts` change.\n *\n * @example\n * ```tsx\n * const { data, isLoading, error, refetch } = useTable(\n *   db.db<Task>(\"tasks\"),\n *   { filter: { done: false }, sort: [{ field: \"createdAt\", desc: true }] }\n * );\n * ```\n */\nexport function useTable<\n  Row extends BaseRow,\n  Insert extends BaseInsert = BaseInsert,\n  Update extends BaseUpdate = BaseUpdate,\n>(\n  table: TableClient<Row, Insert, Update>,\n  opts: UseTableOpts<Row> = {},\n): UseTableResult<Row> {\n  const { enabled = true, ...listOpts } = opts;\n  const [page, setPage] = useState<Page<Row> | null>(null);\n  const [isLoading, setIsLoading] = useState<boolean>(enabled);\n  const [error, setError] = useState<Error | null>(null);\n\n  // Memoise the listOpts fingerprint so we don't refetch on every\n  // render. JSON.stringify is good enough for plain-object filters;\n  // callers with non-serialisable opts can pre-memoise + pass a\n  // stable reference.\n  const fingerprint = JSON.stringify(listOpts);\n\n  // Stable ref to the table client so the effect doesn't refire when\n  // a fresh client instance is constructed each render (a common\n  // anti-pattern that would otherwise trash the hook's behaviour).\n  const tableRef = useRef(table);\n  tableRef.current = table;\n\n  const refetch = useCallback(async () => {\n    if (!enabled) return;\n    setIsLoading(true);\n    setError(null);\n    try {\n      const result = await tableRef.current.list(JSON.parse(fingerprint));\n      setPage(result);\n    } catch (err) {\n      setError(err instanceof Error ? err : new Error(String(err)));\n    } finally {\n      setIsLoading(false);\n    }\n  }, [enabled, fingerprint]);\n\n  useEffect(() => {\n    if (!enabled) {\n      setIsLoading(false);\n      return;\n    }\n    let cancelled = false;\n    setIsLoading(true);\n    setError(null);\n    void (async () => {\n      try {\n        const result = await tableRef.current.list(JSON.parse(fingerprint));\n        if (cancelled) return;\n        setPage(result);\n      } catch (err) {\n        if (cancelled) return;\n        setError(err instanceof Error ? err : new Error(String(err)));\n      } finally {\n        if (cancelled) return;\n        setIsLoading(false);\n      }\n    })();\n    return () => {\n      cancelled = true;\n    };\n  }, [enabled, fingerprint]);\n\n  const mutate = useCallback((next: Row[]) => {\n    setPage((prev) =>\n      prev\n        ? { ...prev, rows: next }\n        : { rows: next, total: next.length, limit: next.length, offset: 0 },\n    );\n  }, []);\n\n  return {\n    data: page ? page.rows : null,\n    page,\n    isLoading,\n    error,\n    refetch,\n    mutate,\n  };\n}\n","'use client';\n\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport type {\n  BaseInsert,\n  BaseRow,\n  BaseUpdate,\n  TableClient,\n} from '../data/types.js';\n\nexport interface UseRecordResult<Row, Update> {\n  /** The record. `null` until first fetch resolves or after `remove()`. */\n  data: Row | null;\n  /** True during the in-flight fetch (initial load OR refetch). */\n  isLoading: boolean;\n  /** True while a save / remove call is in flight. */\n  isSaving: boolean;\n  error: Error | null;\n  /** Re-run the GET. */\n  refetch: () => Promise<void>;\n  /**\n   * Patch the record. The hook PATCHes via `table.update(id, updates)`\n   * and refreshes `data` from the server's response. Throws on\n   * validation failure; callers can wrap in try/catch.\n   */\n  save: (updates: Update) => Promise<Row>;\n  /**\n   * Delete the record. After success, `data` becomes `null` and any\n   * subsequent `refetch()` will see the 404. The hook does NOT\n   * navigate; callers handle post-delete UX (toast, redirect, etc.).\n   */\n  remove: () => Promise<void>;\n}\n\n/**\n * Fetch a single record by id from a DashWise table; expose save +\n * remove handles so a detail page never needs to write\n * `useEffect`/`useState`/`fetch` boilerplate.\n *\n * @example\n * ```tsx\n * const { data: task, isLoading, save } = useRecord(db.db<Task>(\"tasks\"), id);\n * if (!task) return <LoadingState />;\n * return (\n *   <Button onClick={() => save({ done: !task.done })}>\n *     Toggle done\n *   </Button>\n * );\n * ```\n *\n * Skips the fetch when `id` is null / undefined / \"\" — handy for\n * conditional rendering (\"show form only if there's a selected id\").\n */\nexport function useRecord<\n  Row extends BaseRow,\n  Insert extends BaseInsert = BaseInsert,\n  Update extends BaseUpdate = BaseUpdate,\n>(\n  table: TableClient<Row, Insert, Update>,\n  id: string | number | null | undefined,\n): UseRecordResult<Row, Update> {\n  const enabled = id !== null && id !== undefined && id !== '';\n  const [data, setData] = useState<Row | null>(null);\n  const [isLoading, setIsLoading] = useState<boolean>(enabled);\n  const [isSaving, setIsSaving] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  // Stable ref to the table client (see use-table.ts for rationale).\n  const tableRef = useRef(table);\n  tableRef.current = table;\n\n  const refetch = useCallback(async () => {\n    if (!enabled) return;\n    setIsLoading(true);\n    setError(null);\n    try {\n      const row = await tableRef.current.get(Number(id));\n      setData(row);\n    } catch (err) {\n      setError(err instanceof Error ? err : new Error(String(err)));\n    } finally {\n      setIsLoading(false);\n    }\n  }, [enabled, id]);\n\n  useEffect(() => {\n    if (!enabled) {\n      setData(null);\n      setIsLoading(false);\n      return;\n    }\n    let cancelled = false;\n    setIsLoading(true);\n    setError(null);\n    void (async () => {\n      try {\n        const row = await tableRef.current.get(Number(id));\n        if (cancelled) return;\n        setData(row);\n      } catch (err) {\n        if (cancelled) return;\n        setError(err instanceof Error ? err : new Error(String(err)));\n      } finally {\n        if (cancelled) return;\n        setIsLoading(false);\n      }\n    })();\n    return () => {\n      cancelled = true;\n    };\n  }, [enabled, id]);\n\n  const save = useCallback(\n    async (updates: Update): Promise<Row> => {\n      if (!enabled) {\n        throw new Error('useRecord.save: id is null/empty');\n      }\n      setIsSaving(true);\n      setError(null);\n      try {\n        const row = await tableRef.current.update(Number(id), updates);\n        setData(row);\n        return row;\n      } catch (err) {\n        const e = err instanceof Error ? err : new Error(String(err));\n        setError(e);\n        throw e;\n      } finally {\n        setIsSaving(false);\n      }\n    },\n    [enabled, id],\n  );\n\n  const remove = useCallback(async (): Promise<void> => {\n    if (!enabled) return;\n    setIsSaving(true);\n    setError(null);\n    try {\n      await tableRef.current.delete(Number(id));\n      setData(null);\n    } catch (err) {\n      const e = err instanceof Error ? err : new Error(String(err));\n      setError(e);\n      throw e;\n    } finally {\n      setIsSaving(false);\n    }\n  }, [enabled, id]);\n\n  return { data, isLoading, isSaving, error, refetch, save, remove };\n}\n","'use client';\n\n/**\n * React hook for the typed query plane — Phase 2 slice 5.\n *\n * Mirrors {@link useTable}'s cancellation + AST-hash-based refetch\n * pattern, but operates on the typed builder ({@link Query} or\n * {@link AggQuery}) rather than a raw table client + opts. The\n * builder's `.toAst()` output is the cache key — when the AST hash\n * changes, the hook refetches.\n *\n * Two overloads:\n *   - `useQuery(query)` where `query: Query<Row>` → result.data is\n *     `Page<Row>` (the standard list envelope).\n *   - `useQuery(aggQuery)` where `aggQuery: AggQuery` → result.data\n *     is `QueryResult` (aggregation envelope).\n *\n * Returns `{ data, isLoading, error, refetch }`. No `.mutate()` (the\n * builder is the source of truth — to refresh, change the builder\n * inputs; to optimistically tweak, callers can wrap with their own\n * state).\n *\n * @example\n * ```tsx\n * import { qb } from '@dashai/generated';\n * import { useQuery } from '@dashai/sdk/react';\n *\n * function OpenTasks() {\n *   const { data, isLoading, error, refetch } = useQuery(\n *     qb.tasks.where({ done: false }).orderBy([{ field: 'priority', dir: 'desc' }])\n *   );\n *   if (isLoading) return <Spinner />;\n *   if (error) return <Err err={error} />;\n *   return <ul>{data?.rows.map((t) => <li key={t.id}>{t.title}</li>)}</ul>;\n * }\n * ```\n */\n\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport type { BaseRow, Page } from '../data/types.js';\nimport type { AggQuery, Query, QueryResult } from '../query/builder.js';\n\n// ── Result shapes ──────────────────────────────────────────────────────\n\nexport interface UseQueryResult<T> {\n  /** Query result envelope. `null` until first fetch resolves. */\n  data: T | null;\n  /** True during the in-flight fetch (initial + refetches). */\n  isLoading: boolean;\n  /**\n   * Set when the most recent fetch threw. Cleared on the next\n   * successful refetch.\n   */\n  error: Error | null;\n  /** Re-run the query (uses the builder's current AST). */\n  refetch: () => Promise<void>;\n}\n\n// ── Overloads ──────────────────────────────────────────────────────────\n\nexport function useQuery<Row extends BaseRow>(\n  query: Query<Row>,\n): UseQueryResult<Page<Row>>;\nexport function useQuery(query: AggQuery): UseQueryResult<QueryResult>;\n\n// ── Implementation ─────────────────────────────────────────────────────\n\n/**\n * Shared implementation for both overloads. Both `Query<Row>` and\n * `AggQuery` expose `.toAst()` + `.execute()`; the result type is\n * what the overload narrows.\n */\nexport function useQuery(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  query: { toAst: () => unknown; execute: () => Promise<any> },\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): UseQueryResult<any> {\n  const [data, setData] = useState<unknown | null>(null);\n  const [isLoading, setIsLoading] = useState<boolean>(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  // Cache key = JSON-stringified AST. Same trade-off as `useTable`'s\n  // fingerprint: cheap, good enough for the common case, callers\n  // with non-serialisable inputs can memoise their builder upstream.\n  // Computed every render but only the string identity changes\n  // trigger the effect.\n  const fingerprint = JSON.stringify(query.toAst());\n\n  // Stable ref to the builder so the effect's call site doesn't\n  // re-fire when the caller passes a fresh builder instance every\n  // render (the chainable methods return new instances each time,\n  // so this is the common case).\n  const queryRef = useRef(query);\n  queryRef.current = query;\n\n  const refetch = useCallback(async () => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      const result = await queryRef.current.execute();\n      setData(result);\n    } catch (err) {\n      setError(err instanceof Error ? err : new Error(String(err)));\n    } finally {\n      setIsLoading(false);\n    }\n  }, [fingerprint]);\n\n  useEffect(() => {\n    let cancelled = false;\n    setIsLoading(true);\n    setError(null);\n    void (async () => {\n      try {\n        const result = await queryRef.current.execute();\n        if (cancelled) return;\n        setData(result);\n      } catch (err) {\n        if (cancelled) return;\n        setError(err instanceof Error ? err : new Error(String(err)));\n      } finally {\n        if (cancelled) return;\n        setIsLoading(false);\n      }\n    })();\n    return () => {\n      cancelled = true;\n    };\n  }, [fingerprint]);\n\n  return { data, isLoading, error, refetch };\n}\n"]}