@enfyra/sdk-nuxt 0.2.1 → 0.2.2

package/README.md

@@ -143,6 +143,9 @@ await execute({
 - `query?: Record<string, any>` - URL query parameters
 - `headers?: Record<string, string>` - Custom headers
 - `errorContext?: string` - Error context for logging
+- `onError?: (error: ApiError, context?: string) => void` - Custom error handler
+- `batchSize?: number` - Batch size for chunking large operations (default: no limit)
+- `concurrent?: number` - Maximum concurrent requests (default: no limit)
 - `key?: string` - Cache key (SSR mode, optional)
 - `default?: () => T` - Default value (SSR mode only)
 
@@ -153,8 +156,10 @@ await execute({
 **Execute Options (Client mode only):**
 - `id?: string | number` - Single resource ID
 - `ids?: (string | number)[]` - Batch operation IDs (PATCH/DELETE)
-- `files?: FormData[]` - Batch file upload (POST)
+- `files?: FormData[]` - Array of FormData objects for batch upload (POST)
 - `body?: any` - Override request body
+- `batchSize?: number` - Override batch size for this execution
+- `concurrent?: number` - Override concurrent limit for this execution
 
 ### `useEnfyraAuth()`
 
@@ -178,7 +183,7 @@ await fetchUser()                 // Refresh user data
 ### Batch Operations
 
 ```typescript
-// Batch delete multiple items
+// Basic batch delete - unlimited parallel requests
 const { execute: deleteItems } = useEnfyraApi('/items', {
   method: 'delete',
   errorContext: 'Delete Items'
@@ -186,14 +191,50 @@ const { execute: deleteItems } = useEnfyraApi('/items', {
 
 await deleteItems({ ids: ['1', '2', '3'] });
 
-// Batch file upload
-const { execute: uploadFiles } = useEnfyraApi('/files', {
-  method: 'post', 
+// Advanced batch operations with concurrency control
+const { execute: deleteMany } = useEnfyraApi('/users', {
+  method: 'delete',
+  batchSize: 10,      // Process 10 items at a time
+  concurrent: 3,      // Max 3 requests simultaneously
+  onError: (error, context) => toast.error(`${context}: ${error.message}`)
+});
+
+// Delete 100 users in controlled batches
+await deleteMany({ ids: Array.from({length: 100}, (_, i) => `user-${i}`) });
+
+// Override batch settings per execution
+const { execute: updateUsers } = useEnfyraApi('/users', {
+  method: 'patch',
+  batchSize: 20,     // Default: 20 per batch
+  concurrent: 5      // Default: 5 concurrent
+});
+
+// This execution uses different settings
+await updateUsers({ 
+  ids: largeUserList,
+  body: { status: 'active' },
+  batchSize: 50,     // Override: 50 per batch for this call
+  concurrent: 10     // Override: 10 concurrent for this call
+});
+
+// Batch file upload with progress control
+const { execute: uploadFiles } = useEnfyraApi('/file_definition', {
+  method: 'post',
+  batchSize: 5,      // Upload 5 files at a time
+  concurrent: 2,     // Max 2 uploads simultaneously
   errorContext: 'Upload Files'
 });
 
+// Convert files to FormData array (matches enfyra_app pattern)
+const formDataArray = selectedFiles.map(file => {
+  const formData = new FormData();
+  formData.append('file', file);
+  formData.append('folder', folderId || 'null');
+  return formData;
+});
+
 await uploadFiles({ 
-  files: [formData1, formData2, formData3] 
+  files: formDataArray // Array of FormData objects
 });
 ```
 

package/dist/composables/useEnfyraApi.mjs

@@ -16,7 +16,7 @@ function handleError(error, context, customHandler) {
   return apiError;
 }
 export function useEnfyraApi(path, opts = {}) {
-  const { method = "get", body, query, errorContext, onError, ssr, key } = opts;
+  const { method = "get", body, query, errorContext, onError, ssr, key, batchSize, concurrent } = opts;
   if (ssr) {
     const config = useRuntimeConfig().public.enfyraSDK;
     const basePath = (typeof path === "function" ? path() : path).replace(/^\/?api\/?/, "").replace(/^\/+/, "");
@@ -65,12 +65,38 @@ export function useEnfyraApi(path, opts = {}) {
       const basePath = (typeof path === "function" ? path() : path).replace(/^\/?api\/?/, "").replace(/^\/+/, "");
       const finalBody = executeOpts?.body || unref(body);
       const finalQuery = unref(query);
+      const effectiveBatchSize = executeOpts?.batchSize ?? batchSize;
+      const effectiveConcurrent = executeOpts?.concurrent ?? concurrent;
       const buildPath = (...segments) => {
         return segments.filter(Boolean).join("/");
       };
       const fullBaseURL = apiUrl + (apiPrefix || "");
+      async function processBatch(items, processor) {
+        const results = [];
+        if (!effectiveBatchSize && !effectiveConcurrent) {
+          const promises = items.map(processor);
+          return await Promise.all(promises);
+        }
+        const chunks = effectiveBatchSize ? Array.from(
+          { length: Math.ceil(items.length / effectiveBatchSize) },
+          (_, i) => items.slice(i * effectiveBatchSize, i * effectiveBatchSize + effectiveBatchSize)
+        ) : [items];
+        for (const chunk of chunks) {
+          if (effectiveConcurrent && chunk.length > effectiveConcurrent) {
+            for (let i = 0; i < chunk.length; i += effectiveConcurrent) {
+              const batch = chunk.slice(i, i + effectiveConcurrent);
+              const batchResults = await Promise.all(batch.map(processor));
+              results.push(...batchResults);
+            }
+          } else {
+            const chunkResults = await Promise.all(chunk.map(processor));
+            results.push(...chunkResults);
+          }
+        }
+        return results;
+      }
       if (!opts.disableBatch && executeOpts?.ids && executeOpts.ids.length > 0 && (method.toLowerCase() === "patch" || method.toLowerCase() === "delete")) {
-        const promises = executeOpts.ids.map(async (id) => {
+        const responses = await processBatch(executeOpts.ids, async (id) => {
           const finalPath2 = buildPath(basePath, id);
           return $fetch(finalPath2, {
             baseURL: fullBaseURL,
@@ -80,12 +106,11 @@ export function useEnfyraApi(path, opts = {}) {
             query: finalQuery
           });
         });
-        const responses = await Promise.all(promises);
         data.value = responses;
         return responses;
       }
       if (!opts.disableBatch && method.toLowerCase() === "post" && executeOpts?.files && Array.isArray(executeOpts.files) && executeOpts.files.length > 0) {
-        const promises = executeOpts.files.map(async (fileObj) => {
+        const responses = await processBatch(executeOpts.files, async (fileObj) => {
           return $fetch(basePath, {
             baseURL: fullBaseURL,
             method,
@@ -95,7 +120,6 @@ export function useEnfyraApi(path, opts = {}) {
             query: finalQuery
           });
         });
-        const responses = await Promise.all(promises);
         data.value = responses;
         return responses;
       }

package/dist/index.d.ts

@@ -17,6 +17,10 @@ export interface ApiOptions<T> {
     errorContext?: string;
     onError?: (error: ApiError, context?: string) => void;
     disableBatch?: boolean;
+    /** Batch size for chunking large operations (default: no limit) */
+    batchSize?: number;
+    /** Maximum concurrent requests (default: no limit) */
+    concurrent?: number;
     default?: () => T;
     /** Enable SSR with useFetch instead of $fetch */
     ssr?: boolean;
@@ -46,16 +50,22 @@ export interface UseEnfyraApiSSRReturn<T> extends AsyncData<T | null, ApiError>
     error: Ref<ApiError | null>;
     refresh: () => Promise<void>;
 }
+export interface ExecuteOptions {
+    body?: any;
+    id?: string | number;
+    ids?: (string | number)[];
+    /** Array of FormData objects for batch upload */
+    files?: FormData[];
+    /** Override batch size for this specific execution */
+    batchSize?: number;
+    /** Override concurrent limit for this specific execution */
+    concurrent?: number;
+}
 export interface UseEnfyraApiClientReturn<T> {
     data: Ref<T | null>;
     error: Ref<ApiError | null>;
     pending: Ref<boolean>;
-    execute: (executeOpts?: {
-        body?: any;
-        id?: string | number;
-        ids?: (string | number)[];
-        files?: any[];
-    }) => Promise<T | T[] | null>;
+    execute: (executeOpts?: ExecuteOptions) => Promise<T | T[] | null>;
 }
 export * from './auth';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@enfyra/sdk-nuxt",
   "configKey": "enfyraSDK",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "builder": {
     "@nuxt/module-builder": "0.8.4",
     "unbuild": "2.0.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enfyra/sdk-nuxt",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Nuxt SDK for Enfyra CMS",
   "repository": {
     "type": "git",

package/src/composables/useEnfyraApi.ts

@@ -3,6 +3,7 @@ import type {
   ApiOptions,
   ApiError,
   BackendErrorExtended,
+  ExecuteOptions,
   UseEnfyraApiSSRReturn,
   UseEnfyraApiClientReturn,
 } from "../types";
@@ -46,7 +47,7 @@ export function useEnfyraApi<T = any>(
   path: (() => string) | string,
   opts: ApiOptions<T> = {}
 ): UseEnfyraApiSSRReturn<T> | UseEnfyraApiClientReturn<T> {
-  const { method = "get", body, query, errorContext, onError, ssr, key } = opts;
+  const { method = "get", body, query, errorContext, onError, ssr, key, batchSize, concurrent } = opts;
 
   // SSR mode - use useFetch
   if (ssr) {
@@ -101,12 +102,7 @@ export function useEnfyraApi<T = any>(
   const error = ref<ApiError | null>(null);
   const pending = ref(false);
 
-  const execute = async (executeOpts?: {
-    body?: any;
-    id?: string | number;
-    ids?: (string | number)[];
-    files?: any[];
-  }) => {
+  const execute = async (executeOpts?: ExecuteOptions) => {
     pending.value = true;
     error.value = null;
 
@@ -120,6 +116,10 @@ export function useEnfyraApi<T = any>(
         .replace(/^\/+/, ""); // Remove leading slashes
       const finalBody = executeOpts?.body || unref(body);
       const finalQuery = unref(query);
+      
+      // Use executeOpts overrides if provided, otherwise fall back to options
+      const effectiveBatchSize = executeOpts?.batchSize ?? batchSize;
+      const effectiveConcurrent = executeOpts?.concurrent ?? concurrent;
 
       // Helper function to build clean path
       const buildPath = (...segments: (string | number)[]): string => {
@@ -129,6 +129,44 @@ export function useEnfyraApi<T = any>(
       // Build full base URL with prefix
       const fullBaseURL = apiUrl + (apiPrefix || "");
 
+      // Helper function for batch processing with chunking and concurrency control
+      async function processBatch<T>(
+        items: any[],
+        processor: (item: any) => Promise<T>
+      ): Promise<T[]> {
+        const results: T[] = [];
+        
+        // If no limits, process all at once (current behavior)
+        if (!effectiveBatchSize && !effectiveConcurrent) {
+          const promises = items.map(processor);
+          return await Promise.all(promises);
+        }
+
+        // Chunk items by batchSize
+        const chunks = effectiveBatchSize ? 
+          Array.from({ length: Math.ceil(items.length / effectiveBatchSize) }, (_, i) =>
+            items.slice(i * effectiveBatchSize, i * effectiveBatchSize + effectiveBatchSize)
+          ) : [items];
+
+        // Process each chunk
+        for (const chunk of chunks) {
+          if (effectiveConcurrent && chunk.length > effectiveConcurrent) {
+            // Process chunk with concurrency limit
+            for (let i = 0; i < chunk.length; i += effectiveConcurrent) {
+              const batch = chunk.slice(i, i + effectiveConcurrent);
+              const batchResults = await Promise.all(batch.map(processor));
+              results.push(...batchResults);
+            }
+          } else {
+            // Process entire chunk at once
+            const chunkResults = await Promise.all(chunk.map(processor));
+            results.push(...chunkResults);
+          }
+        }
+
+        return results;
+      }
+
       // Batch operation with multiple IDs (only for patch and delete)
       if (
         !opts.disableBatch &&
@@ -136,7 +174,7 @@ export function useEnfyraApi<T = any>(
         executeOpts.ids.length > 0 &&
         (method.toLowerCase() === "patch" || method.toLowerCase() === "delete")
       ) {
-        const promises = executeOpts.ids.map(async (id) => {
+        const responses = await processBatch(executeOpts.ids, async (id) => {
           const finalPath = buildPath(basePath, id);
           return $fetch<T>(finalPath, {
             baseURL: fullBaseURL,
@@ -147,7 +185,6 @@ export function useEnfyraApi<T = any>(
           });
         });
 
-        const responses = await Promise.all(promises);
         data.value = responses as T;
         return responses;
       }
@@ -160,7 +197,7 @@ export function useEnfyraApi<T = any>(
         Array.isArray(executeOpts.files) &&
         executeOpts.files.length > 0
       ) {
-        const promises = executeOpts.files.map(async (fileObj: any) => {
+        const responses = await processBatch(executeOpts.files, async (fileObj: any) => {
           return $fetch<T>(basePath, {
             baseURL: fullBaseURL,
             method: method as any,
@@ -170,7 +207,6 @@ export function useEnfyraApi<T = any>(
           });
         });
 
-        const responses = await Promise.all(promises);
         data.value = responses as T;
         return responses;
       }

package/src/types/index.ts

@@ -19,6 +19,10 @@ export interface ApiOptions<T> {
   errorContext?: string;
   onError?: (error: ApiError, context?: string) => void;
   disableBatch?: boolean;
+  /** Batch size for chunking large operations (default: no limit) */
+  batchSize?: number;
+  /** Maximum concurrent requests (default: no limit) */
+  concurrent?: number;
   default?: () => T;
   /** Enable SSR with useFetch instead of $fetch */
   ssr?: boolean;
@@ -54,17 +58,25 @@ export interface UseEnfyraApiSSRReturn<T> extends AsyncData<T | null, ApiError>
   refresh: () => Promise<void>;
 }
 
+// Execute options interface
+export interface ExecuteOptions {
+  body?: any;
+  id?: string | number;
+  ids?: (string | number)[];
+  /** Array of FormData objects for batch upload */
+  files?: FormData[];
+  /** Override batch size for this specific execution */
+  batchSize?: number;
+  /** Override concurrent limit for this specific execution */
+  concurrent?: number;
+}
+
 // Client Mode return type
 export interface UseEnfyraApiClientReturn<T> {
   data: Ref<T | null>;
   error: Ref<ApiError | null>;
   pending: Ref<boolean>;
-  execute: (executeOpts?: {
-    body?: any;
-    id?: string | number;
-    ids?: (string | number)[];
-    files?: any[];
-  }) => Promise<T | T[] | null>;
+  execute: (executeOpts?: ExecuteOptions) => Promise<T | T[] | null>;
 }