@taruvi/refine-providers 1.1.6 → 1.1.8

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { DataProvider, AuthProvider, AccessControlProvider, MetaQuery, CrudFilter, CrudSort, Pagination } from '@refinedev/core';
-import { Client } from '@taruvi/sdk';
+import { Client, GraphFormat, GraphInclude } from '@taruvi/sdk';
 
 /**
  * Creates a Refine DataProvider for Taruvi database operations.
@@ -20,36 +20,52 @@ interface StorageUploadVariables {
 declare function storageDataProvider(client: Client): DataProvider;
 
 /**
- * Extended meta options for function execution.
+ * Meta options for function execution via custom().
  */
 interface FunctionMeta {
+    kind: "function";
     /** Whether to execute the function asynchronously */
     async?: boolean;
 }
-declare function functionsDataProvider(client: Client): DataProvider;
-
+/**
+ * Meta options for analytics query execution via custom().
+ */
+interface AnalyticsMeta {
+    kind: "analytics";
+}
+type AppCustomMeta = FunctionMeta | AnalyticsMeta;
 /**
  * Creates a Refine DataProvider for Taruvi App operations.
  *
- * This provider is specialized for fetching app-level data like roles and settings.
- *
- * Supported resources:
- * - "roles" (getList): Fetch app roles
- * - "settings" (getOne): Fetch app settings
+ * Supported operations:
+ * - getList("roles"): Fetch app roles
+ * - getOne("settings"): Fetch app settings
+ * - custom(): Execute edge functions or analytics queries via meta.kind
  *
  * @example
  * ```typescript
  * // Get app roles
- * const { data } = useList({
+ * useList({ dataProviderName: "app", resource: "roles" });
+ *
+ * // Get app settings
+ * useOne({ dataProviderName: "app", resource: "settings", id: "" });
+ *
+ * // Execute an edge function
+ * useCustom({
  *   dataProviderName: "app",
- *   resource: "roles",
+ *   url: "process-order",
+ *   method: "post",
+ *   config: { payload: { orderId: 123 } },
+ *   meta: { kind: "function", async: false },
  * });
  *
- * // Get app settings
- * const { data } = useOne({
+ * // Execute an analytics query
+ * useCustom({
  *   dataProviderName: "app",
- *   resource: "settings",
- *   id: "", // id is ignored for settings
+ *   url: "monthly-report",
+ *   method: "post",
+ *   config: { payload: { period: "Q1" } },
+ *   meta: { kind: "analytics" },
  * });
  * ```
  */
@@ -96,13 +112,10 @@ declare function appDataProvider(client: Client): DataProvider;
  */
 declare function userDataProvider(client: Client): DataProvider;
 
-/**
- * Extended meta options for analytics query execution.
- */
-interface AnalyticsMeta {
-    /** Additional parameters to pass to the analytics query */
-    params?: Record<string, unknown>;
-}
+/** @deprecated Use `appDataProvider` with `useCustom` and `meta.kind: "function"` instead. */
+declare function functionsDataProvider(client: Client): DataProvider;
+
+/** @deprecated Use `appDataProvider` with `useCustom` and `meta.kind: "analytics"` instead. */
 declare function analyticsDataProvider(client: Client): DataProvider;
 
 /**
@@ -203,6 +216,14 @@ interface TaruviMeta extends MetaQuery {
     groupBy?: string[];
     /** Filters for aggregate results (same format as regular filters) */
     having?: CrudFilter[];
+    /** Graph format: 'tree' or 'graph' */
+    format?: GraphFormat;
+    /** Graph traversal direction */
+    include?: GraphInclude;
+    /** Graph traversal depth */
+    depth?: number;
+    /** Graph edge types to filter */
+    graph_types?: string[];
 }
 /**
  * Response wrapper for Taruvi list endpoints.
@@ -257,4 +278,4 @@ declare function buildQueryString(params?: Record<string, unknown>): string;
  */
 declare function handleError(error: unknown): never;
 
-export { type AnalyticsMeta, type FunctionMeta, type LoginParams, type LogoutParams, REFINE_OPERATOR_MAP, type RegisterParams, type StorageUploadVariables, type TaruviListResponse, type TaruviMeta, accessControlProvider, analyticsDataProvider, appDataProvider, authProvider, buildQueryString, buildRefineQueryParams, convertRefineFilters, convertRefinePagination, convertRefineSorters, dataProvider, functionsDataProvider, handleError, storageDataProvider, userDataProvider };
+export { type AnalyticsMeta, type AppCustomMeta, type FunctionMeta, type LoginParams, type LogoutParams, REFINE_OPERATOR_MAP, type RegisterParams, type StorageUploadVariables, type TaruviListResponse, type TaruviMeta, accessControlProvider, analyticsDataProvider, appDataProvider, authProvider, buildQueryString, buildRefineQueryParams, convertRefineFilters, convertRefinePagination, convertRefineSorters, dataProvider, functionsDataProvider, handleError, storageDataProvider, userDataProvider };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { Database, Storage, Functions, App, User, Analytics, Auth, Policy } from '@taruvi/sdk';
+import { Graph, Database, Storage, Functions, Analytics, App, User, Auth, Policy } from '@taruvi/sdk';
 import DataLoader2 from 'dataloader';
 
 // src/dataProvider.ts
@@ -80,6 +80,18 @@ 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 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.baseUrl}/api/apps/${config.appSlug}`;
@@ -90,6 +102,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 Database(client).from(tableName);
       query = applyFilters(query, filters);
       query = applySorters(query, sorters);
@@ -102,6 +120,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 Database(client).from(tableName);
       query = applyPopulate(query, taruviMeta);
       const response = await query.get(String(id)).execute();
@@ -111,6 +134,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 Database(client).from(tableName);
       query = query.filter(idColumn, "in", ids.map(String));
@@ -122,6 +154,10 @@ function dataProvider(client) {
       const { resource, variables, meta } = params;
       const taruviMeta = meta;
       const tableName = getTableName(resource, taruviMeta);
+      if (isGraphQuery(taruviMeta)) {
+        const data2 = await new Graph(client).from(tableName).createEdge(variables).execute();
+        return { data: data2 };
+      }
       const data = await new Database(client).from(tableName).create(variables).execute();
       return { data };
     },
@@ -140,6 +176,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 Graph(client).from(tableName).updateEdge(String(id), variables).execute();
+        return { data: data2 };
+      }
       const data = await new Database(client).from(tableName).get(String(id)).update(variables).execute();
       return { data };
     },
@@ -158,6 +198,10 @@ function dataProvider(client) {
       const { resource, id, meta } = params;
       const taruviMeta = meta;
       const tableName = getTableName(resource, taruviMeta);
+      if (isGraphQuery(taruviMeta)) {
+        const data2 = await new Graph(client).from(tableName).deleteEdge([String(id)]).execute();
+        return { data: data2 };
+      }
       const data = await new Database(client).from(tableName).delete(String(id)).execute();
       return { data };
     },
@@ -165,34 +209,36 @@ function dataProvider(client) {
       const { resource, ids, meta } = params;
       const taruviMeta = meta;
       const tableName = getTableName(resource, taruviMeta);
+      if (isGraphQuery(taruviMeta)) {
+        const data2 = await new Graph(client).from(tableName).deleteEdge(ids.map(String)).execute();
+        return { data: [data2] };
+      }
       const data = await Promise.all(
-        ids.map(async (id) => {
-          return new Database(client).from(tableName).delete(String(id)).execute();
-        })
+        ids.map((id) => new Database(client).from(tableName).delete(String(id)).execute())
       );
       return { data };
     },
     custom: async (params) => {
       const { url, method, payload, query } = params;
+      let fullUrl = `api/apps/${config.appSlug}/datatables/${url}`;
       let data;
       switch (method.toLowerCase()) {
         case "get": {
-          let requestUrl = url;
           if (query && Object.keys(query).length > 0) {
             const queryString = new URLSearchParams(query).toString();
-            requestUrl = `${url}${url.includes("?") ? "&" : "?"}${queryString}`;
+            fullUrl = `${fullUrl}${fullUrl.includes("?") ? "&" : "?"}${queryString}`;
           }
-          data = await client.httpClient.get(requestUrl);
+          data = await client.httpClient.get(fullUrl);
           break;
         }
         case "post":
-          data = await client.httpClient.post(url, payload);
+          data = await client.httpClient.post(fullUrl, payload);
           break;
         case "put":
-          data = await client.httpClient.put(url, payload);
+          data = await client.httpClient.put(fullUrl, payload);
           break;
         case "delete":
-          data = await client.httpClient.delete(url);
+          data = await client.httpClient.delete(fullUrl);
           break;
         default:
           throw new Error(`Unsupported HTTP method: ${method}`);
@@ -401,25 +447,25 @@ function storageDataProvider(client) {
     },
     custom: async (params) => {
       const { url, method, payload, query } = params;
+      let fullUrl = `api/apps/${config.appSlug}/storage/buckets/${url}`;
       let data;
       switch (method.toLowerCase()) {
         case "get": {
-          let requestUrl = url;
           if (query && Object.keys(query).length > 0) {
             const queryString = new URLSearchParams(query).toString();
-            requestUrl = `${url}${url.includes("?") ? "&" : "?"}${queryString}`;
+            fullUrl = `${fullUrl}${fullUrl.includes("?") ? "&" : "?"}${queryString}`;
           }
-          data = await client.httpClient.get(requestUrl);
+          data = await client.httpClient.get(fullUrl);
           break;
         }
         case "post":
-          data = await client.httpClient.post(url, payload);
+          data = await client.httpClient.post(fullUrl, payload);
           break;
         case "put":
-          data = await client.httpClient.put(url, payload);
+          data = await client.httpClient.put(fullUrl, payload);
           break;
         case "delete":
-          data = await client.httpClient.delete(url);
+          data = await client.httpClient.delete(fullUrl);
           break;
         default:
           throw new Error(`Unsupported HTTP method: ${method}`);
@@ -430,83 +476,11 @@ function storageDataProvider(client) {
     updateMany: void 0
   };
 }
-function functionsDataProvider(client) {
-  const config = client.getConfig();
-  const baseApiUrl = `${config.baseUrl}/api/apps/${config.appSlug}`;
-  const functions = new Functions(client);
-  return {
-    /**
-     * Execute an edge function.
-     *
-     * @param resource - The function slug to execute
-     * @param variables - Parameters to pass to the function
-     * @param meta.async - Whether to execute asynchronously (default: false)
-     */
-    create: async ({
-      resource,
-      variables,
-      meta
-    }) => {
-      const functionMeta = meta;
-      const response = await functions.execute(resource, {
-        async: functionMeta?.async ?? false,
-        params: variables
-      });
-      return { data: response.data };
-    },
-    getApiUrl: () => baseApiUrl,
-    // Edge functions don't support custom method - use create() instead
-    custom: async () => {
-      throw new Error(
-        "custom is not supported for edge functions. Use useCreate to execute functions."
-      );
-    },
-    // Edge functions don't support other CRUD operations
-    getList: async () => {
-      throw new Error(
-        "getList is not supported for edge functions. Use useCreate to execute functions."
-      );
-    },
-    getOne: async () => {
-      throw new Error(
-        "getOne is not supported for edge functions. Use useCreate to execute functions."
-      );
-    },
-    getMany: async () => {
-      throw new Error(
-        "getMany is not supported for edge functions. Use useCreate to execute functions."
-      );
-    },
-    createMany: async () => {
-      throw new Error(
-        "createMany is not supported for edge functions. Use useCreate to execute functions."
-      );
-    },
-    update: async () => {
-      throw new Error(
-        "update is not supported for edge functions. Use useCreate to execute functions."
-      );
-    },
-    updateMany: async () => {
-      throw new Error(
-        "updateMany is not supported for edge functions. Use useCreate to execute functions."
-      );
-    },
-    deleteOne: async () => {
-      throw new Error(
-        "deleteOne is not supported for edge functions. Use useCreate to execute functions."
-      );
-    },
-    deleteMany: async () => {
-      throw new Error(
-        "deleteMany is not supported for edge functions. Use useCreate to execute functions."
-      );
-    }
-  };
-}
 function appDataProvider(client) {
   const config = client.getConfig();
   const baseApiUrl = `${config.baseUrl}/api/apps/${config.appSlug}`;
+  const functions = new Functions(client);
+  const analytics = new Analytics(client);
   return {
     getList: async (params) => {
       const { resource } = params;
@@ -520,7 +494,6 @@ function appDataProvider(client) {
       }
       throw new Error(`Unknown app resource: ${resource}. Supported resources: roles`);
     },
-    getApiUrl: () => baseApiUrl,
     getOne: async (params) => {
       const { resource } = params;
       if (resource === "settings") {
@@ -532,12 +505,32 @@ function appDataProvider(client) {
       }
       throw new Error(`Unknown app resource for getOne: ${resource}. Supported resources: settings`);
     },
-    // App resources are read-only
+    custom: async (params) => {
+      const { url: slug, payload, meta } = params;
+      const customMeta = meta;
+      if (customMeta?.kind === "function") {
+        const response = await functions.execute(slug, {
+          async: customMeta.async ?? false,
+          params: payload ?? {}
+        });
+        return { data: response.data };
+      }
+      if (customMeta?.kind === "analytics") {
+        const response = await analytics.execute(slug, {
+          params: payload ?? {}
+        });
+        return { data: response.data };
+      }
+      throw new Error(
+        'Specify meta.kind as "function" or "analytics" for custom operations on the app provider.'
+      );
+    },
+    getApiUrl: () => baseApiUrl,
     getMany: async () => {
       throw new Error("getMany is not supported for app resources");
     },
     create: async () => {
-      throw new Error("create is not supported for app resources");
+      throw new Error("create is not supported for app resources. Use useCustom with meta.kind");
     },
     createMany: async () => {
       throw new Error("createMany is not supported for app resources");
@@ -553,9 +546,6 @@ function appDataProvider(client) {
     },
     deleteMany: async () => {
       throw new Error("deleteMany is not supported for app resources");
-    },
-    custom: async () => {
-      throw new Error("custom is not supported for app resources");
     }
   };
 }
@@ -695,6 +685,80 @@ function userDataProvider(client) {
     }
   };
 }
+function functionsDataProvider(client) {
+  const config = client.getConfig();
+  const baseApiUrl = `${config.baseUrl}/api/apps/${config.appSlug}`;
+  const functions = new Functions(client);
+  return {
+    /**
+     * Execute an edge function.
+     *
+     * @param resource - The function slug to execute
+     * @param variables - Parameters to pass to the function
+     * @param meta.async - Whether to execute asynchronously (default: false)
+     */
+    create: async ({
+      resource,
+      variables,
+      meta
+    }) => {
+      const functionMeta = meta;
+      const response = await functions.execute(resource, {
+        async: functionMeta?.async ?? false,
+        params: variables
+      });
+      return { data: response.data };
+    },
+    getApiUrl: () => baseApiUrl,
+    // Edge functions don't support custom method - use create() instead
+    custom: async () => {
+      throw new Error(
+        "custom is not supported for edge functions. Use useCreate to execute functions."
+      );
+    },
+    // Edge functions don't support other CRUD operations
+    getList: async () => {
+      throw new Error(
+        "getList is not supported for edge functions. Use useCreate to execute functions."
+      );
+    },
+    getOne: async () => {
+      throw new Error(
+        "getOne is not supported for edge functions. Use useCreate to execute functions."
+      );
+    },
+    getMany: async () => {
+      throw new Error(
+        "getMany is not supported for edge functions. Use useCreate to execute functions."
+      );
+    },
+    createMany: async () => {
+      throw new Error(
+        "createMany is not supported for edge functions. Use useCreate to execute functions."
+      );
+    },
+    update: async () => {
+      throw new Error(
+        "update is not supported for edge functions. Use useCreate to execute functions."
+      );
+    },
+    updateMany: async () => {
+      throw new Error(
+        "updateMany is not supported for edge functions. Use useCreate to execute functions."
+      );
+    },
+    deleteOne: async () => {
+      throw new Error(
+        "deleteOne is not supported for edge functions. Use useCreate to execute functions."
+      );
+    },
+    deleteMany: async () => {
+      throw new Error(
+        "deleteMany is not supported for edge functions. Use useCreate to execute functions."
+      );
+    }
+  };
+}
 function analyticsDataProvider(client) {
   const config = client.getConfig();
   const baseApiUrl = `${config.baseUrl}/api/apps/${config.appSlug}`;