@bluecopa/react 0.1.36 → 0.1.38

package/README.md

@@ -24,6 +24,7 @@ A React library providing opinionated custom hooks for TanStack React Query inte
     - [`useDatasetSample(datasetId, options?)`](#usedatasetsampledatasetid-options)
     - [`useMetric(metricId, options?)`](#usemetricmetricid-options)
     - [`useInputTable(inputTableId, options?)`](#useinputtableinputtableid-options)
+    - [`useRows(tableId, options?)`](#userowstableid-options)
     - [`useGetFileUrlByFileId(fileId, options?)`](#usegetfileurlbyfileidfileid-options)
     - [`useGetPublishedWorkbookById(workbookId, options?)`](#usegetpublishedworkbookbyidworkbookid-options)
     - [`useGetTableById(tableId, options?)`](#usegettablebyidtableid-options)
@@ -219,6 +220,33 @@ function DatasetViewer({ datasetId }) {
 }
 ```
 
+#### `useRows` - Fetch input table rows with Supabase-style filtering
+
+```tsx
+import { useRows } from '@bluecopa/react';
+
+function TableRows({ tableId }) {
+  const { data, isLoading, error } = useRows(tableId, {
+    status: 'active',
+    price: 'gte.100',
+    limit: 25,
+    offset: 0
+  });
+  
+  if (isLoading) return <div>Loading rows...</div>;
+  if (error) return <div>Error: {error.message}</div>;
+  
+  return (
+    <div>
+      <div>Total: {data?.total_count ?? 0}</div>
+      {data?.data?.map(row => <div key={row._copa_id}>{JSON.stringify(row)}</div>)}
+    </div>
+  );
+}
+```
+
+📖 **For detailed documentation on `useRows` including filtering, pagination, and advanced usage, see [docs/useRows.md](./docs/useRows.md)**
+
 ## API Documentation
 
 ### `useUser(options?)`
@@ -293,6 +321,43 @@ Fetches input table data with limit parameters.
 - `error`: Error object if request failed
 - `refetch`: Function to manually trigger refetch
 
+### `useRows(tableId, options?)`
+
+Fetches rows from an input table with Supabase-style filtering, pagination, and sorting. Supports advanced filtering operators and group expressions.
+
+**Parameters:**  
+- `tableId`: ID of the input table (string | null | undefined)
+- `options` (optional): Query options extending `GetRowsOptions` and `BaseQueryOptions`:
+  - `limit`: Maximum rows to fetch (1-10000)
+  - `offset`: Number of rows to skip
+  - `order`: Sort order ('asc' or 'desc')
+  - `order_by`: Column name to sort by
+  - Filter fields: Any column name with Supabase-style operator syntax (e.g., `status: 'active'`, `price: 'gte.100'`, `status: 'in.(active,pending)'`)
+  - `or`: Supabase/PostgREST group expression for OR conditions
+  - `and`: Supabase/PostgREST group expression for AND conditions
+  - React Query options: `enabled`, `staleTime`, `gcTime`, `retry`, `retryDelay`, `onSuccess`, `onError`
+
+**Returns:**  
+- `data`: `GetRowsResponse` object containing:
+  - `data`: Array of row objects
+  - `count`: Number of rows in current page
+  - `total_count`: Total rows available
+- `isLoading`: Boolean indicating loading state
+- `error`: Error object if request failed
+- `refetch`: Function to manually trigger refetch
+
+**Example:**
+```tsx
+const { data, isLoading } = useRows('table-123', {
+  status: 'active',
+  price: 'gte.100',
+  limit: 25,
+  offset: 0
+});
+```
+
+📖 **For comprehensive documentation including all supported operators, filtering patterns, and advanced usage, see [docs/useRows.md](./docs/useRows.md)**
+
 ### `useGetFileUrlByFileId(fileId, options?)`
 
 Fetches the URL for a file by its ID.

package/dist/{COOQDZLH-DQnrP0WW.js → COOQDZLH-B_veh7tc.js}

@@ -1,5 +1,5 @@
-import { c, T as l, P as m, a as u, D as v, Q as i } from "./VREWMQAW-BEXgoAYz.js";
-import { g as d, c as f, a as e } from "./index-BOHSvoXk.js";
+import { c, T as l, P as m, a as u, D as v, Q as i } from "./VREWMQAW-BnM2Gcps.js";
+import { g as d, c as f, a as e } from "./index-CTdgL_Gu.js";
 var p = (a) => {
   const [r, t] = c({
     prefix: "TanstackQueryDevtools"

package/dist/{MU7WGUJF-BPpiEtaS.js → MU7WGUJF-BozjR1sa.js}

@@ -1,5 +1,5 @@
-import { c as s, T as c, P as u, a as i, b as m, C as P, Q as d } from "./VREWMQAW-BEXgoAYz.js";
-import { g as v, c as C, a as e } from "./index-BOHSvoXk.js";
+import { c as s, T as c, P as u, a as i, b as m, C as P, Q as d } from "./VREWMQAW-BnM2Gcps.js";
+import { g as v, c as C, a as e } from "./index-CTdgL_Gu.js";
 var h = (t) => {
   const [r, o] = s({
     prefix: "TanstackQueryDevtools"

package/dist/{VREWMQAW-BEXgoAYz.js → VREWMQAW-BnM2Gcps.js}

@@ -1,7 +1,7 @@
 var bs = Object.defineProperty;
 var ps = (e, t, n) => t in e ? bs(e, t, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[t] = n;
 var _e = (e, t, n) => ps(e, typeof t != "symbol" ? t + "" : t, n);
-import { b as xe, d as z, o as Ft, e as N, c as D, a as m, P as qo, S as B, t as _, i as k, f as V, h as F, j as ws, k as rr, u as $e, l as j, s as Vn, m as Gn, n as ut, p as A, q as xs, r as an, v as Ne, w as $s, x as _t, y as zt, z as Cs, A as Ss, B as xn, F as ks, C as Kr, D as Kt, $ as Ro, E as Es, G as Ds, H as W, I as Br, J as Ms, K as As, L as or, M as Fs, N as Ts, O as Rn, Q as Is, R as Ps, T as oe, U as Ls, V as Os } from "./index-BOHSvoXk.js";
+import { b as xe, d as z, o as Ft, e as N, c as D, a as m, P as qo, S as B, t as _, i as k, f as V, h as F, j as ws, k as rr, u as $e, l as j, s as Vn, m as Gn, n as ut, p as A, q as xs, r as an, v as Ne, w as $s, x as _t, y as zt, z as Cs, A as Ss, B as xn, F as ks, C as Kr, D as Kt, $ as Ro, E as Es, G as Ds, H as W, I as Br, J as Ms, K as As, L as or, M as Fs, N as Ts, O as Rn, Q as Is, R as Ps, T as oe, U as Ls, V as Os } from "./index-CTdgL_Gu.js";
 var _s = (e) => e != null, qs = (e) => e.filter(_s);
 function Rs(e) {
   return (...t) => {