@taruvi/refine-providers 1.1.5 → 1.1.7

package/README.md

@@ -12,8 +12,8 @@ npm install @taruvi/refine-providers @taruvi/sdk @refinedev/core
 
 ```tsx
 import { Refine } from "@refinedev/core";
+import { Client } from "@taruvi/sdk";
 import {
-  Client,
   dataProvider,
   storageDataProvider,
   appDataProvider,
@@ -52,7 +52,7 @@ This package includes multiple specialized data providers:
 
 | Provider | Purpose | SDK Class | Hook |
 |----------|---------|-----------|------|
-| `dataProvider` | Database CRUD operations | `Database` | `useList`, `useOne`, `useCreate`, etc. |
+| `dataProvider` | Database CRUD & Graph operations | `Database`, `Graph` | `useList`, `useOne`, `useCreate`, etc. |
 | `storageDataProvider` | File storage operations | `Storage` | `useList`, `useCreate`, `useDelete` |
 | `functionsDataProvider` | Edge function execution | `Functions` | `useCreate` |
 | `appDataProvider` | App-level data (roles, settings) | `App` | `useList`, `useOne` |
@@ -68,7 +68,8 @@ The main data provider for CRUD operations on database tables.
 ### Basic Usage
 
 ```tsx
-import { dataProvider, Client } from "@taruvi/refine-providers";
+import { Client } from "@taruvi/sdk";
+import { dataProvider } from "@taruvi/refine-providers";
 
 const client = new Client({ apiKey, appSlug, baseUrl });
 
@@ -192,6 +193,93 @@ const { data } = useList({
 });
 ```
 
+### Graph Operations
+
+The data provider supports graph traversal and edge management when graph meta options are provided.
+
+#### Reading Graph Data
+
+```tsx
+// Get graph structure for a record
+const { data } = useOne({
+  resource: "employees",
+  id: "1",
+  meta: {
+    format: "graph",        // 'tree' or 'graph'
+    include: "descendants", // 'descendants', 'ancestors', or 'both'
+    depth: 2,               // traversal depth
+    graph_types: ["manager", "mentor"], // filter by edge types
+  },
+});
+
+// List with graph format
+const { data } = useList({
+  resource: "employees",
+  meta: {
+    format: "tree",
+    include: "both",
+    depth: 3,
+  },
+});
+```
+
+#### Graph Meta Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `format` | `'tree' \| 'graph'` | Output format for graph data |
+| `include` | `'descendants' \| 'ancestors' \| 'both'` | Direction of graph traversal |
+| `depth` | `number` | How deep to traverse relationships |
+| `graph_types` | `string[]` | Filter edges by type |
+
+#### Managing Graph Edges
+
+When any graph meta option is present, mutation operations work with edges:
+
+```tsx
+// Create an edge
+const { mutate: createEdge } = useCreate();
+createEdge({
+  resource: "employees",
+  values: {
+    from_id: 1,
+    to_id: 2,
+    type: "manager",
+    metadata: { since: "2024-01-01" },
+  },
+  meta: { format: "graph" }, // triggers graph mode
+});
+
+// Update an edge
+const { mutate: updateEdge } = useUpdate();
+updateEdge({
+  resource: "employees",
+  id: "edge-123", // edge ID
+  values: {
+    from_id: 1,
+    to_id: 3,
+    type: "manager",
+  },
+  meta: { format: "graph" },
+});
+
+// Delete edges
+const { mutate: deleteEdge } = useDelete();
+deleteEdge({
+  resource: "employees",
+  id: "edge-123",
+  meta: { format: "graph" },
+});
+
+// Delete multiple edges
+const { mutate: deleteEdges } = useDeleteMany();
+deleteEdges({
+  resource: "employees",
+  ids: ["edge-123", "edge-456"],
+  meta: { format: "graph" },
+});
+```
+
 ---
 
 ## Storage Data Provider
@@ -201,7 +289,8 @@ For file upload, download, and management operations.
 ### Setup
 
 ```tsx
-import { storageDataProvider, Client } from "@taruvi/refine-providers";
+import { Client } from "@taruvi/sdk";
+import { storageDataProvider } from "@taruvi/refine-providers";
 
 const client = new Client({ apiKey, appSlug, baseUrl });
 
@@ -291,7 +380,7 @@ For executing Taruvi edge functions.
 ### Setup
 
 ```tsx
-import { functionsDataProvider, Client } from "@taruvi/refine-providers";
+import { functionsDataProvider } from "@taruvi/refine-providers";
 
 <Refine
   dataProvider={{
@@ -366,7 +455,7 @@ For fetching app-level data like roles and settings.
 ### Setup
 
 ```tsx
-import { appDataProvider, Client } from "@taruvi/refine-providers";
+import { appDataProvider } from "@taruvi/refine-providers";
 
 <Refine
   dataProvider={{
@@ -408,7 +497,7 @@ For fetching user-level data including users list and current user details.
 ### Setup
 
 ```tsx
-import { userDataProvider, Client } from "@taruvi/refine-providers";
+import { userDataProvider } from "@taruvi/refine-providers";
 
 <Refine
   dataProvider={{
@@ -466,7 +555,7 @@ For executing predefined analytics queries.
 ### Setup
 
 ```tsx
-import { analyticsDataProvider, Client } from "@taruvi/refine-providers";
+import { analyticsDataProvider } from "@taruvi/refine-providers";
 
 <Refine
   dataProvider={{
@@ -541,7 +630,8 @@ Redirect-based authentication using Taruvi's Web UI Flow.
 ### Setup
 
 ```tsx
-import { authProvider, Client } from "@taruvi/refine-providers";
+import { Client } from "@taruvi/sdk";
+import { authProvider } from "@taruvi/refine-providers";
 
 const client = new Client({ apiKey, appSlug, baseUrl });
 
@@ -613,7 +703,7 @@ Resource-based authorization using Cerbos policies.
 ### Setup
 
 ```tsx
-import { accessControlProvider, Client } from "@taruvi/refine-providers";
+import { accessControlProvider } from "@taruvi/refine-providers";
 
 <Refine
   authProvider={authProvider(client)}
@@ -692,8 +782,8 @@ const { data } = useCan({
 Use multiple providers together:
 
 ```tsx
+import { Client } from "@taruvi/sdk";
 import {
-  Client,
   dataProvider,
   storageDataProvider,
   functionsDataProvider,
@@ -744,42 +834,14 @@ import type {
   StorageUploadVariables,
 
   // Auth types
-  TaruviUser,
   LoginParams,
   LogoutParams,
   RegisterParams,
-
-  // SDK types (re-exported)
-  TaruviConfig,
-  RoleResponse,
-  AnalyticsRequest,
-  AnalyticsResponse,
 } from "@taruvi/refine-providers";
 ```
 
 ---
 
-## SDK Re-exports
-
-For convenience, SDK classes are re-exported:
-
-```tsx
-import {
-  Client,
-  Auth,
-  Policy,
-  Functions,
-  App,
-  Analytics,
-} from "@taruvi/refine-providers";
-
-// Use SDK directly when needed
-const auth = new Auth(client);
-const isLoggedIn = auth.isUserAuthenticated();
-```
-
----
-
 ## Utility Functions
 
 Advanced users can access utility functions:

package/dist/index.cjs

@@ -86,9 +86,21 @@ function applyPopulate(query, meta) {
   const populateArray = Array.isArray(meta.populate) ? meta.populate : meta.populate.split(",").map((s) => s.trim());
   return query.populate(populateArray);
 }
+function isGraphQuery(meta) {
+  return !!(meta?.format || meta?.graph_types || meta?.include || meta?.depth);
+}
+function buildGraphQuery(client, tableName, meta, recordId) {
+  let query = new sdk.Graph(client).from(tableName);
+  if (recordId) query = query.get(recordId);
+  if (meta?.format) query = query.format(meta.format);
+  if (meta?.include) query = query.include(meta.include);
+  if (meta?.depth) query = query.depth(meta.depth);
+  if (meta?.graph_types) query = query.types(meta.graph_types);
+  return query;
+}
 function dataProvider(client) {
   const config = client.getConfig();
-  const baseApiUrl = `${config.apiUrl}/api/apps/${config.appSlug}`;
+  const baseApiUrl = `${config.baseUrl}/api/apps/${config.appSlug}`;
   const getIdColumn = (meta) => meta?.idColumnName ?? "id";
   const getTableName = (resource, meta) => meta?.tableName ?? resource;
   return {
@@ -96,6 +108,12 @@ function dataProvider(client) {
       const { resource, pagination, filters, sorters, meta } = params;
       const taruviMeta = meta;
       const tableName = getTableName(resource, taruviMeta);
+      if (isGraphQuery(taruviMeta)) {
+        const response2 = await buildGraphQuery(client, tableName, taruviMeta).execute();
+        const data = Array.isArray(response2) ? response2 : response2?.data ?? [];
+        const total = response2?.total ?? data.length;
+        return { data, total };
+      }
       let query = new sdk.Database(client).from(tableName);
       query = applyFilters(query, filters);
       query = applySorters(query, sorters);
@@ -108,6 +126,11 @@ function dataProvider(client) {
       const { resource, id, meta } = params;
       const taruviMeta = meta;
       const tableName = getTableName(resource, taruviMeta);
+      if (isGraphQuery(taruviMeta)) {
+        const response2 = await buildGraphQuery(client, tableName, taruviMeta, String(id)).execute();
+        const data = Array.isArray(response2) ? response2[0] : response2?.data?.[0] ?? response2;
+        return { data };
+      }
       let query = new sdk.Database(client).from(tableName);
       query = applyPopulate(query, taruviMeta);
       const response = await query.get(String(id)).execute();
@@ -117,6 +140,15 @@ function dataProvider(client) {
       const { resource, ids, meta } = params;
       const taruviMeta = meta;
       const tableName = getTableName(resource, taruviMeta);
+      if (isGraphQuery(taruviMeta)) {
+        const data = await Promise.all(
+          ids.map(async (id) => {
+            const response2 = await buildGraphQuery(client, tableName, taruviMeta, String(id)).execute();
+            return Array.isArray(response2) ? response2[0] : response2?.data?.[0] ?? response2;
+          })
+        );
+        return { data };
+      }
       const idColumn = getIdColumn(taruviMeta);
       let query = new sdk.Database(client).from(tableName);
       query = query.filter(idColumn, "in", ids.map(String));
@@ -128,6 +160,10 @@ function dataProvider(client) {
       const { resource, variables, meta } = params;
       const taruviMeta = meta;
       const tableName = getTableName(resource, taruviMeta);
+      if (isGraphQuery(taruviMeta)) {
+        const data2 = await new sdk.Graph(client).from(tableName).createEdge(variables).execute();
+        return { data: data2 };
+      }
       const data = await new sdk.Database(client).from(tableName).create(variables).execute();
       return { data };
     },
@@ -146,6 +182,10 @@ function dataProvider(client) {
       const { resource, id, variables, meta } = params;
       const taruviMeta = meta;
       const tableName = getTableName(resource, taruviMeta);
+      if (isGraphQuery(taruviMeta)) {
+        const data2 = await new sdk.Graph(client).from(tableName).updateEdge(String(id), variables).execute();
+        return { data: data2 };
+      }
       const data = await new sdk.Database(client).from(tableName).get(String(id)).update(variables).execute();
       return { data };
     },
@@ -164,6 +204,10 @@ function dataProvider(client) {
       const { resource, id, meta } = params;
       const taruviMeta = meta;
       const tableName = getTableName(resource, taruviMeta);
+      if (isGraphQuery(taruviMeta)) {
+        const data2 = await new sdk.Graph(client).from(tableName).deleteEdge([String(id)]).execute();
+        return { data: data2 };
+      }
       const data = await new sdk.Database(client).from(tableName).delete(String(id)).execute();
       return { data };
     },
@@ -171,21 +215,28 @@ function dataProvider(client) {
       const { resource, ids, meta } = params;
       const taruviMeta = meta;
       const tableName = getTableName(resource, taruviMeta);
+      if (isGraphQuery(taruviMeta)) {
+        const data2 = await new sdk.Graph(client).from(tableName).deleteEdge(ids.map(String)).execute();
+        return { data: [data2] };
+      }
       const data = await Promise.all(
-        ids.map(async (id) => {
-          return new sdk.Database(client).from(tableName).delete(String(id)).execute();
-        })
+        ids.map((id) => new sdk.Database(client).from(tableName).delete(String(id)).execute())
       );
       return { data };
     },
     custom: async (params) => {
-      const { url, method, payload } = params;
-      const fullUrl = url.startsWith("http") ? url : `${baseApiUrl}${url}`;
+      const { url, method, payload, query } = params;
+      let fullUrl = `api/apps/${config.appSlug}/datatables/${url}`;
       let data;
       switch (method.toLowerCase()) {
-        case "get":
+        case "get": {
+          if (query && Object.keys(query).length > 0) {
+            const queryString = new URLSearchParams(query).toString();
+            fullUrl = `${fullUrl}${fullUrl.includes("?") ? "&" : "?"}${queryString}`;
+          }
           data = await client.httpClient.get(fullUrl);
           break;
+        }
         case "post":
           data = await client.httpClient.post(fullUrl, payload);
           break;
@@ -327,7 +378,7 @@ function handleError(error) {
 // src/storageDataProvider.ts
 function storageDataProvider(client) {
   const config = client.getConfig();
-  const baseApiUrl = `${config.apiUrl}/api/apps/${config.appSlug}`;
+  const baseApiUrl = `${config.baseUrl}/api/apps/${config.appSlug}`;
   const getBucketName = (resource, meta) => meta?.bucketName ?? resource;
   const buildFilters = (params) => {
     const filters = {
@@ -401,13 +452,18 @@ function storageDataProvider(client) {
       return { data: [data] };
     },
     custom: async (params) => {
-      const { url, method, payload } = params;
-      const fullUrl = url.startsWith("http") ? url : `${baseApiUrl}${url}`;
+      const { url, method, payload, query } = params;
+      let fullUrl = `api/apps/${config.appSlug}/storage/buckets/${url}`;
       let data;
       switch (method.toLowerCase()) {
-        case "get":
+        case "get": {
+          if (query && Object.keys(query).length > 0) {
+            const queryString = new URLSearchParams(query).toString();
+            fullUrl = `${fullUrl}${fullUrl.includes("?") ? "&" : "?"}${queryString}`;
+          }
           data = await client.httpClient.get(fullUrl);
           break;
+        }
         case "post":
           data = await client.httpClient.post(fullUrl, payload);
           break;
@@ -428,7 +484,7 @@ function storageDataProvider(client) {
 }
 function functionsDataProvider(client) {
   const config = client.getConfig();
-  const baseApiUrl = `${config.apiUrl}/api/apps/${config.appSlug}`;
+  const baseApiUrl = `${config.baseUrl}/api/apps/${config.appSlug}`;
   const functions = new sdk.Functions(client);
   return {
     /**
@@ -502,7 +558,7 @@ function functionsDataProvider(client) {
 }
 function appDataProvider(client) {
   const config = client.getConfig();
-  const baseApiUrl = `${config.apiUrl}/api/apps/${config.appSlug}`;
+  const baseApiUrl = `${config.baseUrl}/api/apps/${config.appSlug}`;
   return {
     getList: async (params) => {
       const { resource } = params;
@@ -598,10 +654,10 @@ function buildUserListFilters(filters, sorters, pagination) {
 }
 function userDataProvider(client) {
   const config = client.getConfig();
-  const baseApiUrl = `${config.apiUrl}/api/apps/${config.appSlug}`;
+  const baseApiUrl = `${config.baseUrl}/api/apps/${config.appSlug}`;
   return {
     getList: async (params) => {
-      const { resource, pagination, filters, sorters } = params;
+      const { resource, pagination, filters, sorters, meta } = params;
       if (resource === "users") {
         const user = new sdk.User(client);
         const userFilters = buildUserListFilters(filters, sorters, pagination);
@@ -611,18 +667,29 @@ function userDataProvider(client) {
           total: response.total
         };
       }
-      throw new Error(`Unknown user resource for getList: ${resource}. Supported resources: users`);
+      if (resource === "roles") {
+        const username = meta?.username;
+        if (!username) {
+          throw new Error("roles resource requires meta.username");
+        }
+        const user = new sdk.User(client);
+        const response = await user.getUser(username);
+        const roles = response.roles || [];
+        return {
+          data: roles,
+          total: roles.length
+        };
+      }
+      throw new Error(`Unknown user resource for getList: ${resource}. Supported: users, roles`);
     },
     getOne: async (params) => {
       const { resource, id } = params;
       if (resource === "users") {
         const user = new sdk.User(client);
         const response = await user.getUser(String(id));
-        return {
-          data: response
-        };
+        return { data: response };
       }
-      throw new Error(`Unknown user resource for getOne: ${resource}. Supported resources: me, users`);
+      throw new Error(`Unknown user resource for getOne: ${resource}. Supported: users`);
     },
     getApiUrl: () => baseApiUrl,
     create: async (params) => {
@@ -682,7 +749,7 @@ function userDataProvider(client) {
 }
 function analyticsDataProvider(client) {
   const config = client.getConfig();
-  const baseApiUrl = `${config.apiUrl}/api/apps/${config.appSlug}`;
+  const baseApiUrl = `${config.baseUrl}/api/apps/${config.appSlug}`;
   const analytics = new sdk.Analytics(client);
   return {
     /**