@taruvi/refine-providers 1.0.7 → 1.0.8

package/README.md

@@ -20,6 +20,7 @@ import {
   accessControlProvider,
 } from "@taruvi/refine-providers";
 
+// Initialize the Taruvi client
 const client = new Client({
   apiKey: "your-api-key",
   appSlug: "your-app-slug",
@@ -43,47 +44,17 @@ function App() {
 }
 ```
 
----
-
-## Exports
-
-```typescript
-// Data Providers
-import { dataProvider } from "@taruvi/refine-providers";           // Database CRUD
-import { storageDataProvider } from "@taruvi/refine-providers";    // File storage
-import { functionsDataProvider } from "@taruvi/refine-providers";  // Edge functions
-import { appDataProvider } from "@taruvi/refine-providers";        // App data (roles)
-import { analyticsDataProvider } from "@taruvi/refine-providers";  // Analytics queries
-
-// Auth Providers
-import { authProvider } from "@taruvi/refine-providers";           // Authentication
-import { accessControlProvider } from "@taruvi/refine-providers";  // Cerbos permissions
+## Data Providers
 
-// Types
-import type {
-  TaruviMeta,
-  TaruviListResponse,
-  TaruviUser,
-  StorageUploadVariables,
-  FunctionMeta,
-  AnalyticsMeta,
-} from "@taruvi/refine-providers";
+This package includes multiple specialized data providers:
 
-// SDK re-exports
-import { Client, Auth, Policy, Functions, App, Analytics } from "@taruvi/refine-providers";
-```
-
----
-
-## Data Providers Overview
-
-| Provider | Purpose | Hook | Resource Parameter |
-|----------|---------|------|-------------------|
-| `dataProvider` | Database CRUD | `useList`, `useOne`, `useCreate`, `useUpdate`, `useDelete` | Table name |
-| `storageDataProvider` | File storage | `useList`, `useCreate`, `useDelete` | Bucket name |
-| `functionsDataProvider` | Edge functions | `useCustom` | Function slug |
-| `appDataProvider` | App roles | `useList` | `"roles"` |
-| `analyticsDataProvider` | Analytics queries | `useCustom` | Query slug |
+| Provider | Purpose | SDK Class | Hook |
+|----------|---------|-----------|------|
+| `dataProvider` | Database CRUD operations | `Database` | `useList`, `useOne`, `useCreate`, etc. |
+| `storageDataProvider` | File storage operations | `Storage` | `useList`, `useCreate`, `useDelete` |
+| `functionsDataProvider` | Edge function execution | `Functions` | `useCreate` |
+| `appDataProvider` | App-level data (roles) | `App` | `useList` |
+| `analyticsDataProvider` | Analytics queries | `Analytics` | `useCreate` |
 
 ---
 
@@ -91,229 +62,130 @@ import { Client, Auth, Policy, Functions, App, Analytics } from "@taruvi/refine-
 
 The main data provider for CRUD operations on database tables.
 
-### Setup
+### Basic Usage
 
-```typescript
+```tsx
 import { dataProvider, Client } from "@taruvi/refine-providers";
 
 const client = new Client({ apiKey, appSlug, baseUrl });
 
-<Refine dataProvider={dataProvider(client)} />
-```
-
-### Operations
-
-| Method | HTTP | Endpoint |
-|--------|------|----------|
-| `getList` | GET | `/api/apps/{app}/datatables/{table}/data/` |
-| `getOne` | GET | `/api/apps/{app}/datatables/{table}/data/{id}/` |
-| `getMany` | GET | `/api/apps/{app}/datatables/{table}/data/?id__in=1,2,3` |
-| `create` | POST | `/api/apps/{app}/datatables/{table}/data/` |
-| `update` | PATCH | `/api/apps/{app}/datatables/{table}/data/{id}/` |
-| `deleteOne` | DELETE | `/api/apps/{app}/datatables/{table}/data/{id}/` |
-
-### Usage Examples
-
-#### List Records
-
-```typescript
-import { useList } from "@refinedev/core";
-
-const { data, isLoading } = useList({
-  resource: "users",
-  pagination: { currentPage: 1, pageSize: 10 },
-  filters: [
-    { field: "status", operator: "eq", value: "active" },
-    { field: "age", operator: "gte", value: 18 },
-  ],
-  sorters: [
-    { field: "created_at", order: "desc" },
-  ],
-  meta: {
-    populate: ["department", "manager"],
-  },
-});
-
-// Returns: { data: User[], total: number }
-```
-
-#### Get Single Record
-
-```typescript
-import { useOne } from "@refinedev/core";
-
-const { data } = useOne({
-  resource: "users",
-  id: 123,
-  meta: {
-    populate: ["department"],
-  },
-});
-
-// Returns: { data: User }
+<Refine
+  dataProvider={dataProvider(client)}
+  resources={[{ name: "posts" }]}
+/>
 ```
 
-#### Get Multiple Records
+### Supported Operations
 
-```typescript
-import { useMany } from "@refinedev/core";
-
-const { data } = useMany({
-  resource: "users",
-  ids: [1, 2, 3],
-});
+All standard Refine CRUD operations are supported:
 
-// Returns: { data: User[] }
-```
+```tsx
+// List records
+const { data } = useList({ resource: "posts" });
 
-#### Create Record
+// Get single record
+const { data } = useOne({ resource: "posts", id: 1 });
 
-```typescript
-import { useCreate } from "@refinedev/core";
+// Get multiple records
+const { data } = useMany({ resource: "posts", ids: [1, 2, 3] });
 
+// Create record
 const { mutate } = useCreate();
+mutate({ resource: "posts", values: { title: "Hello" } });
 
-mutate({
-  resource: "users",
-  values: {
-    name: "John Doe",
-    email: "john@example.com",
-  },
-});
-```
-
-#### Update Record
-
-```typescript
-import { useUpdate } from "@refinedev/core";
-
+// Update record
 const { mutate } = useUpdate();
+mutate({ resource: "posts", id: 1, values: { title: "Updated" } });
 
-mutate({
-  resource: "users",
-  id: 123,
-  values: {
-    name: "Jane Doe",
-  },
-});
-```
-
-#### Delete Record
-
-```typescript
-import { useDelete } from "@refinedev/core";
-
+// Delete record
 const { mutate } = useDelete();
-
-mutate({
-  resource: "users",
-  id: 123,
-});
-```
-
-### Meta Options
-
-```typescript
-useList({
-  resource: "posts",
-  meta: {
-    tableName: "blog_posts",              // Override table name
-    populate: ["author", "comments.user"], // FK population (array or string)
-    select: ["id", "title", "status"],    // Field selection
-    idColumnName: "post_id",              // Custom ID column
-    aggregate: ["sum(views)", "count(*)"], // Aggregations
-    groupBy: ["category"],                // Group by
-    having: [{ field: "sum(views)", operator: "gte", value: 100 }],
-  },
-});
+mutate({ resource: "posts", id: 1 });
 ```
 
 ### Filtering
 
-All Refine filter operators are supported:
-
-| Operator | Query Parameter | Example |
-|----------|-----------------|---------|
-| `eq` | `field=value` | `status=active` |
-| `ne` | `field__ne=value` | `status__ne=deleted` |
-| `lt`, `gt`, `lte`, `gte` | `field__lt=value` | `age__gte=18` |
-| `contains` | `field__contains=value` | `name__contains=john` |
-| `containss` | `field__icontains=value` | `name__icontains=John` (case-insensitive) |
-| `startswith` | `field__startswith=value` | `code__startswith=PRE` |
-| `endswith` | `field__endswith=value` | `email__endswith=@gmail.com` |
-| `in` | `field__in=a,b,c` | `status__in=active,pending` |
-| `nin` | `field__nin=a,b` | `status__nin=deleted` |
-| `null` | `field__null=true` | `deleted_at__null=true` |
-| `nnull` | `field__nnull=true` | `email__nnull=true` |
-| `between` | `field__between=min,max` | `price__between=10,100` |
-
-```typescript
-useList({
-  resource: "products",
+Full support for Refine filter operators:
+
+```tsx
+const { data } = useList({
+  resource: "posts",
   filters: [
-    { field: "status", operator: "eq", value: "active" },
-    { field: "price", operator: "between", value: [10, 100] },
-    { field: "category_id", operator: "in", value: [1, 2, 3] },
-    { field: "name", operator: "containss", value: "phone" },
-    { field: "deleted_at", operator: "null", value: true },
+    { field: "status", operator: "eq", value: "published" },
+    { field: "views", operator: "gte", value: 100 },
+    { field: "title", operator: "contains", value: "refine" },
+    { field: "category", operator: "in", value: ["tech", "news"] },
   ],
 });
 ```
 
-### Sorting
+**Supported Operators:**
+
+| Operator | Description | Example |
+|----------|-------------|---------|
+| `eq` | Equal | `status = "active"` |
+| `ne` | Not equal | `status != "deleted"` |
+| `lt`, `gt`, `lte`, `gte` | Comparison | `age >= 18` |
+| `contains`, `ncontains` | Contains (case-sensitive) | `title contains "hello"` |
+| `containss`, `ncontainss` | Contains (case-insensitive) | `title icontains "hello"` |
+| `startswith`, `endswith` | String matching | `email endswith "@gmail.com"` |
+| `in`, `nin` | Array membership | `status in ["active", "pending"]` |
+| `null`, `nnull` | Null checks | `deleted_at is null` |
+| `between`, `nbetween` | Range | `price between [10, 100]` |
 
-```typescript
-useList({
+### Sorting & Pagination
+
+```tsx
+const { data } = useList({
   resource: "posts",
   sorters: [
-    { field: "created_at", order: "desc" },  // -created_at
-    { field: "title", order: "asc" },        // title
+    { field: "created_at", order: "desc" },
+    { field: "title", order: "asc" },
   ],
-});
-// Query: ?ordering=-created_at,title
-```
-
-### Pagination
-
-```typescript
-useList({
-  resource: "users",
   pagination: {
-    currentPage: 2,
-    pageSize: 25,
+    currentPage: 1,
+    pageSize: 20,
   },
 });
-// Query: ?page=2&page_size=25
-
-// Disable pagination
-useList({
-  resource: "users",
-  pagination: { mode: "off" },
-});
 ```
 
-### Populate (Foreign Key Relations)
+### Meta Options
 
-Populate uses the SDK's `.populate()` method:
+Use the `meta` parameter for Taruvi-specific features:
 
-```typescript
-// Array format
-useList({
+```tsx
+const { data } = useList({
   resource: "posts",
-  meta: { populate: ["author", "category"] },
-});
+  meta: {
+    // Override table name (when resource differs from table)
+    tableName: "blog_posts",
 
-// Nested relations
-useList({
-  resource: "posts",
-  meta: { populate: ["author", "comments.user"] },
+    // Populate foreign key relations
+    populate: ["author", "category"],
+    // or populate all: populate: "*"
+
+    // Select specific fields
+    select: ["id", "title", "status"],
+
+    // Custom ID column
+    idColumnName: "post_id",
+  },
 });
+```
 
-// String format
-useOne({
-  resource: "posts",
-  id: 1,
-  meta: { populate: "author,comments.user" },
+### Aggregations
+
+Support for aggregate queries with grouping:
+
+```tsx
+const { data } = useList({
+  resource: "orders",
+  meta: {
+    aggregate: ["sum(total)", "count(*)", "avg(quantity)"],
+    groupBy: ["status", "category"],
+    having: [
+      { field: "sum(total)", operator: "gte", value: 1000 },
+    ],
+  },
 });
 ```
 
@@ -325,8 +197,10 @@ For file upload, download, and management operations.
 
 ### Setup
 
-```typescript
-import { storageDataProvider } from "@taruvi/refine-providers";
+```tsx
+import { storageDataProvider, Client } from "@taruvi/refine-providers";
+
+const client = new Client({ apiKey, appSlug, baseUrl });
 
 <Refine
   dataProvider={{
@@ -336,30 +210,24 @@ import { storageDataProvider } from "@taruvi/refine-providers";
 />
 ```
 
-**Note:** In storage operations, `resource` = bucket name, `id` = file path.
-
 ### List Files
 
-```typescript
+```tsx
 const { data } = useList({
-  resource: "documents",  // bucket name
+  resource: "documents", // bucket name
   dataProviderName: "storage",
-  filters: [
-    { field: "mimetype_category", operator: "eq", value: "image" },
-    { field: "size", operator: "lte", value: 5242880 },  // 5MB
-  ],
 });
 ```
 
 ### Upload Files
 
-```typescript
+```tsx
 import { useCreate } from "@refinedev/core";
 import type { StorageUploadVariables } from "@taruvi/refine-providers";
 
 const { mutate } = useCreate<any, any, StorageUploadVariables>();
 
-// Single file
+// Single file upload
 mutate({
   resource: "documents",
   dataProviderName: "storage",
@@ -382,38 +250,33 @@ mutate({
 });
 ```
 
-### Download/Get File
-
-```typescript
-const { data } = useOne({
-  resource: "documents",
-  dataProviderName: "storage",
-  id: "folder/myfile.pdf",  // file path
-});
-```
-
 ### Delete Files
 
-```typescript
-import { useDeleteMany } from "@refinedev/core";
-
+```tsx
 const { mutate } = useDeleteMany();
 
 mutate({
   resource: "documents",
   dataProviderName: "storage",
-  ids: ["file1.pdf", "folder/file2.pdf"],
+  ids: ["path/to/file1.pdf", "path/to/file2.pdf"],
 });
 ```
 
-### StorageUploadVariables Interface
+### Filter Files
 
-```typescript
-interface StorageUploadVariables {
-  files: File[];                         // Required: File objects
-  paths?: string[];                      // Optional: Custom paths (defaults to file.name)
-  metadatas?: Record<string, unknown>[]; // Optional: Metadata for each file
-}
+```tsx
+const { data } = useList({
+  resource: "documents",
+  dataProviderName: "storage",
+  filters: [
+    { field: "mimetype_category", operator: "eq", value: "image" },
+    { field: "size", operator: "lte", value: 5242880 }, // 5MB
+    { field: "visibility", operator: "eq", value: "public" },
+  ],
+  meta: {
+    bucketName: "uploads", // Override bucket name
+  },
+});
 ```
 
 ---
@@ -424,8 +287,8 @@ For executing Taruvi edge functions.
 
 ### Setup
 
-```typescript
-import { functionsDataProvider } from "@taruvi/refine-providers";
+```tsx
+import { functionsDataProvider, Client } from "@taruvi/refine-providers";
 
 <Refine
   dataProvider={{
@@ -437,75 +300,56 @@ import { functionsDataProvider } from "@taruvi/refine-providers";
 
 ### Execute Function
 
-Use `useCustom` with the function slug as the URL:
+Use the `useCreate` hook with the function slug as the resource:
 
-```typescript
-import { useCustom } from "@refinedev/core";
+```tsx
+import { useCreate } from "@refinedev/core";
 
-// Query style (immediate execution)
-const { data, isLoading } = useCustom({
+const { mutate, mutation } = useCreate();
+
+// Execute function
+mutate({
   dataProviderName: "functions",
-  url: "process-order",  // function slug
-  method: "post",
-  config: {
-    payload: {
-      orderId: 123,
-      action: "confirm",
-    },
+  resource: "process-order",  // function slug
+  values: {
+    orderId: 123,
+    action: "confirm",
   },
   meta: {
-    async: false,  // Set to true for async execution
+    async: false, // Set to true for async execution
   },
 });
 
-if (isLoading) {
+// Check loading state
+if (mutation.isPending) {
   console.log("Executing function...");
 }
 ```
 
-### Mutation Style
-
-```typescript
-import { useCustomMutation } from "@refinedev/core";
-
-const { mutate, isLoading } = useCustomMutation();
-
-mutate({
-  dataProviderName: "functions",
-  url: "send-notification",
-  method: "post",
-  values: { userId: 456, message: "Hello" },
-});
-```
-
 ### With Callbacks
 
-```typescript
+```tsx
 mutate(
   {
     dataProviderName: "functions",
-    url: "send-notification",
-    method: "post",
+    resource: "send-notification",
     values: { userId: 456, message: "Hello" },
   },
   {
-    onSuccess: (data) => console.log("Result:", data),
-    onError: (error) => console.error("Failed:", error),
+    onSuccess: (data) => console.log("Function result:", data),
+    onError: (error) => console.error("Function failed:", error),
   }
 );
 ```
 
-### Async Execution
+### Async Function Execution
 
-```typescript
+```tsx
 // Long-running task - returns immediately with job ID
-const { data } = useCustom({
+mutate({
   dataProviderName: "functions",
-  url: "long-running-task",
-  method: "post",
-  config: {
-    payload: { taskId: 789 },
-  },
+  resource: "long-running-task",
+  values: { taskId: 789 },
   meta: { async: true },
 });
 ```
@@ -518,8 +362,8 @@ For fetching app-level data like roles.
 
 ### Setup
 
-```typescript
-import { appDataProvider } from "@taruvi/refine-providers";
+```tsx
+import { appDataProvider, Client } from "@taruvi/refine-providers";
 
 <Refine
   dataProvider={{
@@ -531,12 +375,10 @@ import { appDataProvider } from "@taruvi/refine-providers";
 
 ### Fetch Roles
 
-```typescript
-import { useList } from "@refinedev/core";
-
+```tsx
 const { data } = useList({
-  dataProviderName: "app",
   resource: "roles",
+  dataProviderName: "app",
 });
 
 // Returns: { data: [{ id, name, permissions, ... }], total: number }
@@ -550,8 +392,8 @@ For executing predefined analytics queries.
 
 ### Setup
 
-```typescript
-import { analyticsDataProvider } from "@taruvi/refine-providers";
+```tsx
+import { analyticsDataProvider, Client } from "@taruvi/refine-providers";
 
 <Refine
   dataProvider={{
@@ -561,64 +403,62 @@ import { analyticsDataProvider } from "@taruvi/refine-providers";
 />
 ```
 
-### Execute Query
+### Execute Analytics Query
+
+Use the `useCreate` hook with the query slug as the resource:
 
-Use `useCustom` with the query slug as the URL:
+```tsx
+import { useCreate } from "@refinedev/core";
 
-```typescript
-import { useCustom } from "@refinedev/core";
+const { mutate, mutation } = useCreate();
 
-// Query style (immediate execution)
-const { data, isLoading } = useCustom({
+// Execute analytics query
+mutate({
   dataProviderName: "analytics",
-  url: "monthly-sales-report",  // query slug
-  method: "post",
-  config: {
-    payload: {
-      start_date: "2024-01-01",
-      end_date: "2024-12-31",
-      region: "US",
-    },
+  resource: "monthly-sales-report",  // query slug
+  values: {
+    start_date: "2024-01-01",
+    end_date: "2024-12-31",
+    region: "US",
   },
 });
 
-if (isLoading) {
+// Check loading state
+if (mutation.isPending) {
   console.log("Running query...");
 }
 ```
 
-### Mutation Style
-
-```typescript
-import { useCustomMutation } from "@refinedev/core";
-
-const { mutate, isLoading } = useCustomMutation();
-
-mutate({
-  dataProviderName: "analytics",
-  url: "dashboard-metrics",
-  method: "post",
-  values: { period: "last_30_days" },
-});
-```
-
 ### With Callbacks
 
-```typescript
+```tsx
 mutate(
   {
     dataProviderName: "analytics",
-    url: "dashboard-metrics",
-    method: "post",
+    resource: "dashboard-metrics",
     values: { period: "last_30_days" },
   },
   {
-    onSuccess: (data) => console.log("Result:", data),
-    onError: (error) => console.error("Failed:", error),
+    onSuccess: (data) => console.log("Query result:", data),
+    onError: (error) => console.error("Query failed:", error),
   }
 );
 ```
 
+### Query with Aggregations
+
+```tsx
+mutate({
+  dataProviderName: "analytics",
+  resource: "revenue-by-region",
+  values: {
+    year: 2024,
+    group_by: "region",
+    include_forecast: true,
+  },
+});
+```
+
 ---
 
 ## Auth Provider
@@ -627,15 +467,19 @@ Redirect-based authentication using Taruvi's Web UI Flow.
 
 ### Setup
 
-```typescript
-import { authProvider } from "@taruvi/refine-providers";
+```tsx
+import { authProvider, Client } from "@taruvi/refine-providers";
+
+const client = new Client({ apiKey, appSlug, baseUrl });
 
-<Refine authProvider={authProvider(client)} />
+<Refine
+  authProvider={authProvider(client)}
+/>
 ```
 
 ### Login
 
-```typescript
+```tsx
 import { useLogin } from "@refinedev/core";
 
 const { mutate: login } = useLogin();
@@ -646,7 +490,7 @@ login({ callbackUrl: "/dashboard" });
 
 ### Logout
 
-```typescript
+```tsx
 import { useLogout } from "@refinedev/core";
 
 const { mutate: logout } = useLogout();
@@ -654,9 +498,9 @@ const { mutate: logout } = useLogout();
 logout({ callbackUrl: "/login" });
 ```
 
-### Register
+### Register/Signup
 
-```typescript
+```tsx
 import { useRegister } from "@refinedev/core";
 
 const { mutate: register } = useRegister();
@@ -666,7 +510,7 @@ register({ callbackUrl: "/welcome" });
 
 ### Get Current User
 
-```typescript
+```tsx
 import { useGetIdentity } from "@refinedev/core";
 import type { TaruviUser } from "@taruvi/refine-providers";
 
@@ -676,21 +520,9 @@ console.log(user?.username);
 console.log(user?.email);
 ```
 
-### Check Authentication
-
-```typescript
-import { useIsAuthenticated } from "@refinedev/core";
-
-const { data } = useIsAuthenticated();
-
-if (data?.authenticated) {
-  // User is logged in
-}
-```
-
-### Get Permissions
+### Check Permissions
 
-```typescript
+```tsx
 import { usePermissions } from "@refinedev/core";
 
 const { data: permissions } = usePermissions();
@@ -699,19 +531,6 @@ console.log(permissions?.roles);
 console.log(permissions?.is_staff);
 ```
 
-### TaruviUser Interface
-
-```typescript
-interface TaruviUser {
-  user_id: number;
-  username: string;
-  email?: string;
-  exp?: number;       // Token expiration
-  iat?: number;       // Token issued at
-  [key: string]: unknown;
-}
-```
-
 ---
 
 ## Access Control Provider
@@ -720,8 +539,8 @@ Resource-based authorization using Cerbos policies.
 
 ### Setup
 
-```typescript
-import { accessControlProvider } from "@taruvi/refine-providers";
+```tsx
+import { accessControlProvider, Client } from "@taruvi/refine-providers";
 
 <Refine
   authProvider={authProvider(client)}
@@ -731,7 +550,7 @@ import { accessControlProvider } from "@taruvi/refine-providers";
 
 ### Check Permissions
 
-```typescript
+```tsx
 import { useCan } from "@refinedev/core";
 
 const { data } = useCan({
@@ -753,15 +572,6 @@ import { CanAccess } from "@refinedev/core";
 <CanAccess resource="posts" action="delete" params={{ id: 1 }}>
   <DeleteButton />
 </CanAccess>
-
-// With fallback
-<CanAccess
-  resource="admin"
-  action="view"
-  fallback={<p>Access denied</p>}
->
-  <AdminPanel />
-</CanAccess>
 ```
 
 ### Define Entity Type
@@ -774,7 +584,7 @@ For Cerbos, specify the entity type in resource meta:
     {
       name: "posts",
       meta: {
-        entityType: "blog",  // Used in Cerbos policy
+        entityType: "blog", // Used in Cerbos policy
       },
     },
   ]}
@@ -785,7 +595,7 @@ For Cerbos, specify the entity type in resource meta:
 
 ## Multiple Data Providers
 
-Use all providers together:
+Use multiple providers together:
 
 ```tsx
 import {
@@ -795,8 +605,6 @@ import {
   functionsDataProvider,
   appDataProvider,
   analyticsDataProvider,
-  authProvider,
-  accessControlProvider,
 } from "@taruvi/refine-providers";
 
 const client = new Client({ apiKey, appSlug, baseUrl });
@@ -809,42 +617,32 @@ const client = new Client({ apiKey, appSlug, baseUrl });
     app: appDataProvider(client),
     analytics: analyticsDataProvider(client),
   }}
-  authProvider={authProvider(client)}
-  accessControlProvider={accessControlProvider(client)}
 />
 
-// Usage:
-useList({ resource: "posts" });                                     // default
-useList({ resource: "images", dataProviderName: "storage" });       // storage
-useList({ resource: "roles", dataProviderName: "app" });            // app
-
-// Functions and Analytics use useCustom
-const { data: funcResult } = useCustom({
-  dataProviderName: "functions",
-  url: "my-func",
-  method: "post",
-  config: { payload: { key: "value" } },
-});
+// Then specify which provider to use:
+useList({ resource: "posts" }); // Uses default
+useList({ resource: "images", dataProviderName: "storage" });
+useList({ resource: "roles", dataProviderName: "app" });
 
-const { data: analyticsResult } = useCustom({
-  dataProviderName: "analytics",
-  url: "my-query",
-  method: "post",
-  config: { payload: { period: "last_30_days" } },
-});
+// For functions and analytics, use useCreate:
+const { mutate } = useCreate();
+mutate({ dataProviderName: "functions", resource: "my-function", values: {...} });
+mutate({ dataProviderName: "analytics", resource: "my-query", values: {...} });
 ```
 
 ---
 
 ## TypeScript Types
 
-```typescript
+All types are exported for TypeScript users:
+
+```tsx
 import type {
   // Meta types
   TaruviMeta,
   TaruviListResponse,
-  FunctionMeta,
   AnalyticsMeta,
+  FunctionMeta,
   StorageUploadVariables,
 
   // Auth types
@@ -861,26 +659,13 @@ import type {
 } from "@taruvi/refine-providers";
 ```
 
-### TaruviMeta Interface
-
-```typescript
-interface TaruviMeta {
-  tableName?: string;              // Override table name
-  bucketName?: string;             // Override bucket name
-  populate?: string | string[];    // FK population
-  select?: string | string[];      // Field selection
-  idColumnName?: string;           // Custom ID column
-  aggregate?: string[];            // Aggregation expressions
-  groupBy?: string[];              // Group by fields
-  having?: CrudFilter[];           // Having clause
-}
-```
-
 ---
 
 ## SDK Re-exports
 
-```typescript
+For convenience, SDK classes are re-exported:
+
+```tsx
 import {
   Client,
   Auth,
@@ -899,7 +684,9 @@ const isLoggedIn = auth.isUserAuthenticated();
 
 ## Utility Functions
 
-```typescript
+Advanced users can access utility functions:
+
+```tsx
 import {
   REFINE_OPERATOR_MAP,
   convertRefineFilters,
@@ -909,70 +696,6 @@ import {
   buildQueryString,
   handleError,
 } from "@taruvi/refine-providers";
-
-// Convert filters to query params
-const params = convertRefineFilters([
-  { field: "status", operator: "eq", value: "active" },
-]);
-// Result: { status: "active" }
-
-// Convert sorters
-const ordering = convertRefineSorters([
-  { field: "created_at", order: "desc" },
-]);
-// Result: "-created_at"
-```
-
----
-
-## Error Handling
-
-```typescript
-const { data, error, isError } = useList({ resource: "users" });
-
-if (isError) {
-  console.error(error.message);
-}
-```
-
-Auth errors are handled by `authProvider.onError`:
-- **401**: Attempts token refresh, then redirects to login
-- **403**: Returns error (user authenticated but not authorized)
-
----
-
-## Architecture
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    React Application                        │
-│              (using Refine hooks/components)                │
-└─────────────────────────────────────────────────────────────┘
-                              │
-                              ▼
-┌─────────────────────────────────────────────────────────────┐
-│                    @refinedev/core                          │
-│        (useList, useCreate, useLogin, CanAccess, etc.)      │
-└─────────────────────────────────────────────────────────────┘
-                              │
-                              ▼
-┌─────────────────────────────────────────────────────────────┐
-│                  @taruvi/refine-providers                   │
-│  Data: dataProvider, storageDataProvider, functionsData-    │
-│        Provider, appDataProvider, analyticsDataProvider     │
-│  Auth: authProvider, accessControlProvider                  │
-└─────────────────────────────────────────────────────────────┘
-                              │
-                              ▼
-┌─────────────────────────────────────────────────────────────┐
-│                      @taruvi/sdk                            │
-│  Database, Storage, Functions, App, Analytics, Auth, Policy │
-└─────────────────────────────────────────────────────────────┘
-                              │
-                              ▼
-┌─────────────────────────────────────────────────────────────┐
-│                  Taruvi Backend API                         │
-└─────────────────────────────────────────────────────────────┘
 ```
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taruvi/refine-providers",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Refine.dev data provider for Taruvi Data Service",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -65,6 +65,6 @@
     "url": "https://github.com/taruvi-io/sdk/issues"
   },
   "dependencies": {
-    "@taruvi/sdk": "^1.2.1"
+    "@taruvi/sdk": "^1.2.3"
   }
 }