@arex95/vue-core 1.1.40 → 1.1.41

package/dist/composables/axios/index.d.ts

@@ -1,3 +1,3 @@
 export * from './axiosFetch';
-export * from './createFetch';
+export * from './useFetch';
 export * from './useVueQuery';

package/dist/composables/axios/useFetch.d.ts

@@ -0,0 +1,9 @@
+import { AxiosInstance, AxiosRequestConfig } from 'axios';
+import { UseQueryOptions } from '@tanstack/vue-query';
+/**
+ * Creates a fetchFn for Axios requests with an optional custom instance.
+ * @param fetchComposable - The fn to use for the request (can be any fetch function).
+ * @param axiosCustomInstance - An optional custom Axios instance to use for the request.
+ * @returns A function that handles the request using the provided fn.
+ */
+export declare function useFetch(fetchFn: Function, axiosCustomInstance?: AxiosInstance): (axiosRequestConfig: AxiosRequestConfig, options?: UseQueryOptions) => any;

package/dist/index.mjs

@@ -2926,7 +2926,7 @@ class RestStd {
     static resource;
     static isFormData = false;
     static headers = {};
-    static fetchComposable;
+    static fetchFn;
     /**
      * Set global headers for all requests.
      * @param headers Object containing headers to be set globally.
@@ -2950,12 +2950,12 @@ class RestStd {
      * Fetch a list of items from the server.
      *
      * @param params Query parameters for filtering the results.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static getAll(params, options = {}) {
-        return this.fetchComposable({
-            method: 'GET',
+        return this.fetchFn({
+            method: "GET",
             url: this.resource,
             params,
             headers: this.headers,
@@ -2966,12 +2966,12 @@ class RestStd {
      *
      * @param id The ID of the item to fetch.
      * @param params Additional query parameters for the request.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static getOne(id, params, options = {}) {
-        return this.fetchComposable({
-            method: 'GET',
+        return this.fetchFn({
+            method: "GET",
             url: `${this.resource}/${id}`,
             params,
             headers: this.headers,
@@ -2981,18 +2981,43 @@ class RestStd {
      * Create a new item on the server.
      *
      * @param data The data for the new item to create.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static create(data, options = {}) {
         const transformedData = this.transformData(data);
-        return this.fetchComposable({
-            method: 'POST',
+        return this.fetchFn({
+            method: "POST",
             url: this.resource,
             data: transformedData,
             headers: {
                 ...this.headers,
-                'Content-Type': this.isFormData ? ContentTypeEnum.FORM_DATA : ContentTypeEnum.JSON,
+                "Content-Type": this.isFormData
+                    ? ContentTypeEnum.FORM_DATA
+                    : ContentTypeEnum.JSON,
+            },
+        }, options);
+    }
+    /**
+     * Create multiple new items on the server.
+     *
+     * @param data An array of data for the items to create.
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function.
+     */
+    static bulkCreate(data, options = {}) {
+        const transformedData = this.isFormData
+            ? data.map((item) => this.transformData(item))
+            : data;
+        return this.fetchFn({
+            method: "POST",
+            url: `${this.resource}/bulk`,
+            data: transformedData,
+            headers: {
+                ...this.headers,
+                "Content-Type": this.isFormData
+                    ? ContentTypeEnum.FORM_DATA
+                    : ContentTypeEnum.JSON,
             },
         }, options);
     }
@@ -3001,18 +3026,43 @@ class RestStd {
      *
      * @param id The ID of the item to update.
      * @param data The updated data for the item.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static update(id, data, options = {}) {
         const transformedData = this.transformData(data);
-        return this.fetchComposable({
-            method: 'PUT',
+        return this.fetchFn({
+            method: "PUT",
             url: `${this.resource}/${id}`,
             data: transformedData,
             headers: {
                 ...this.headers,
-                'Content-Type': this.isFormData ? ContentTypeEnum.FORM_DATA : ContentTypeEnum.JSON,
+                "Content-Type": this.isFormData
+                    ? ContentTypeEnum.FORM_DATA
+                    : ContentTypeEnum.JSON,
+            },
+        }, options);
+    }
+    /**
+     * Update multiple existing items on the server.
+     *
+     * @param data An array of data for the items to update (each object should have an ID).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function.
+     */
+    static bulkUpdate(data, options = {}) {
+        const transformedData = this.isFormData
+            ? data.map((item) => this.transformData(item))
+            : data;
+        return this.fetchFn({
+            method: "PUT",
+            url: `${this.resource}/bulk`,
+            data: transformedData,
+            headers: {
+                ...this.headers,
+                "Content-Type": this.isFormData
+                    ? ContentTypeEnum.FORM_DATA
+                    : ContentTypeEnum.JSON,
             },
         }, options);
     }
@@ -3021,18 +3071,20 @@ class RestStd {
      *
      * @param id The ID of the item to update.
      * @param data The updated data for the item.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static patch(id, data, options = {}) {
         const transformedData = this.transformData(data);
-        return this.fetchComposable({
-            method: 'PATCH',
+        return this.fetchFn({
+            method: "PATCH",
             url: `${this.resource}/${id}`,
             data: transformedData,
             headers: {
                 ...this.headers,
-                'Content-Type': this.isFormData ? ContentTypeEnum.FORM_DATA : ContentTypeEnum.JSON,
+                "Content-Type": this.isFormData
+                    ? ContentTypeEnum.FORM_DATA
+                    : ContentTypeEnum.JSON,
             },
         }, options);
     }
@@ -3040,47 +3092,39 @@ class RestStd {
      * Delete an item from the server.
      *
      * @param id The ID of the item to delete.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static delete(id, options = {}) {
-        return this.fetchComposable({
-            method: 'DELETE',
+        return this.fetchFn({
+            method: "DELETE",
             url: `${this.resource}/${id}`,
             headers: this.headers,
         }, options);
     }
     /**
-     * Custom request method for more flexibility.
+     * Delete multiple items from the server by their IDs.
      *
-     * @param method HTTP method (GET, POST, etc.).
-     * @param params Query parameters.
-     * @param data Request body data.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param ids An array of IDs of the items to delete.
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function.
      */
-    static customRequest(method, params, data, options = {}) {
-        const transformedData = this.transformData(data);
-        return this.fetchComposable({
-            method: method,
-            url: this.resource,
-            params: params,
-            data: transformedData,
-            headers: {
-                ...this.headers,
-                'Content-Type': this.isFormData ? ContentTypeEnum.FORM_DATA : ContentTypeEnum.JSON,
-            },
+    static bulkDelete(ids, options = {}) {
+        return this.fetchFn({
+            method: "DELETE",
+            url: `${this.resource}/bulk`,
+            data: { ids },
+            headers: this.headers,
         }, options);
     }
     /**
-     * Save method that decides whether to create or update based on the presence of 'id'.
-     * It calls either create or update based on the data.
+     * Upsert method that decides whether to create or update based on the presence of 'id'.
      *
      * @param data The data for the item to create or update.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
-    static save(data, options = {}) {
+    static upsert(data, options = {}) {
         if (data.id) {
             return this.update(data.id, data, options);
         }
@@ -3088,6 +3132,31 @@ class RestStd {
             return this.create(data, options);
         }
     }
+    /**
+     * Custom request method for more flexibility.
+     *
+     * @param method HTTP method (GET, POST, etc.).
+     * @param url The custom URL for the request.
+     * @param params Query parameters.
+     * @param data Request body data.
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
+     */
+    static customRequest(method, url, params, data, options = {}) {
+        const transformedData = this.transformData(data);
+        return this.fetchFn({
+            method: method,
+            url: url,
+            params: params,
+            data: transformedData,
+            headers: {
+                ...this.headers,
+                "Content-Type": this.isFormData
+                    ? ContentTypeEnum.FORM_DATA
+                    : ContentTypeEnum.JSON,
+            },
+        }, options);
+    }
 }
 
 /**
@@ -3107,15 +3176,15 @@ async function axiosFetch(axios, axiosRequest) {
 }
 
 /**
- * Creates a fetchComposable for Axios requests with an optional custom instance.
- * @param fetchComposable - The composable to use for the request (can be any fetch function).
+ * Creates a fetchFn for Axios requests with an optional custom instance.
+ * @param fetchComposable - The fn to use for the request (can be any fetch function).
  * @param axiosCustomInstance - An optional custom Axios instance to use for the request.
- * @returns A function that handles the request using the provided composable.
+ * @returns A function that handles the request using the provided fn.
  */
-function createFetch(fetchComposable, axiosCustomInstance) {
+function useFetch(fetchFn, axiosCustomInstance) {
     const instance = axiosCustomInstance || getConfiguredAxiosInstance();
     return (axiosRequestConfig, options) => {
-        return fetchComposable(instance, axiosRequestConfig, options);
+        return fetchFn(instance, axiosRequestConfig, options);
     };
 }
 
@@ -3579,4 +3648,4 @@ const ArexVueCore = {
     },
 };
 
-export { AppTypes, ArchiveTypes, ArexVueCore, AudioTypes, AxiosService, ContentTypeEnum, DocumentTypes, ERROR_MESSAGES, ERROR_STYLES, ErrorEnum, ErrorMessages, ErrorStyles, ExceptionEnum, FontTypes, ImageTypes, KeyCodeEnum, OtherTypes, RestStd, ScreenBreakpoint, ScreenSize, StorageKeyEnum, StorageTypeEnum, TextTypes, VideoTypes, ab2hex, addCustomKeyboardShortcut, addDays, addDoubleClickListener, addKeyListener, ageAtDate, axiosFetch, blobToFormData, bufferToBlob, calculateAge, cleanCredentials, clickOutside, compareObject, configAppKey, configAxios, configEndpoints, configRefreshTokenPaths, configSession, configTokenKeys, configTokenPaths, copyToClipboard, countWords, createFetch, createKeyMap, customShortcut, daysBetween, daysToNextBirthday, debounce, debounceAsync, debounceAsyncValidator, debounceAsyncWithImmediate, debounceLeading, debounceLeadingTrailing, debounceTrailing, decrypt, deepClone, deepEqual, deepMerge, detectKeyHold, disableCopy, disableF12Key, disableMouseButtons, disableRightClick, disableSpecificKeys, downloadBlob, enableMouseButtons, enableRightClick, enableSpecificKeys, encrypt, exportToCSV, exportToExcel, exportToJSON, exportToText, exportToXML, extractAndValidateTokens, filterObjectByKeys, flattenObject, formDataToObject, formatDate, generateRandomString, getAppKey, getAuthRefreshToken, getAuthToken, getConfiguredAxiosInstance, getDecryptedItem, getEndOfMonth, getEndpointsConfig, getObjectDifferences, getObjectKeys, getQueryParam, getRefreshTokenPathsConfig, getSessionConfig, getSessionId, getSessionPersistence, getStartOfMonth, getTokenConfig, getTokenPathsConfig, handleError, hasNestedProperties, hex2ab, importKey, isEmptyObject, isLeapYear, isStrongPassword, isValidAge, isValidCreditCard, isValidDate, isValidEmail, isValidExpiryDate, isValidHexColor, isValidHexColorAlpha, isValidHexNumber, isValidIP, isValidPhoneNumber, isValidSSN, isValidTime, isValidURL, isValidUsername, isValidZIP, lowerFirst, objectToFormData, objectToFormDataEnhanced, objectToQueryString, openWindow, parseDate, proxyToPlainObject, readFileAsDataURL, readFileAsText, refreshTokens, registerKeyboardShortcuts, removeAccent, removeClickOutside, removeCustomKeyboardShortcut, removeCustomShortcuts, removeDoubleClickListener, removeEmptyProperties, removeKeyListeners, replaceAll, reverseString, safeGet, screenMap, scrollToTop, simulateKeyPress, stopDetectingKeyHold, storeAuthRefreshToken, storeAuthToken, storeEncryptedItem, storeTokens, stringToBlob, subtractDays, throttle, toCamelCase, toKebabCase, toggleTabNavigation, truncateString, unregisterKeyboardShortcuts, upperFirst, useAuth, useBreakpoint, useFilter, usePagination, useSorter, useVueQuery, validateAlphanumeric, validateLetters, validateNumbers, verifyAuth };
+export { AppTypes, ArchiveTypes, ArexVueCore, AudioTypes, AxiosService, ContentTypeEnum, DocumentTypes, ERROR_MESSAGES, ERROR_STYLES, ErrorEnum, ErrorMessages, ErrorStyles, ExceptionEnum, FontTypes, ImageTypes, KeyCodeEnum, OtherTypes, RestStd, ScreenBreakpoint, ScreenSize, StorageKeyEnum, StorageTypeEnum, TextTypes, VideoTypes, ab2hex, addCustomKeyboardShortcut, addDays, addDoubleClickListener, addKeyListener, ageAtDate, axiosFetch, blobToFormData, bufferToBlob, calculateAge, cleanCredentials, clickOutside, compareObject, configAppKey, configAxios, configEndpoints, configRefreshTokenPaths, configSession, configTokenKeys, configTokenPaths, copyToClipboard, countWords, createKeyMap, customShortcut, daysBetween, daysToNextBirthday, debounce, debounceAsync, debounceAsyncValidator, debounceAsyncWithImmediate, debounceLeading, debounceLeadingTrailing, debounceTrailing, decrypt, deepClone, deepEqual, deepMerge, detectKeyHold, disableCopy, disableF12Key, disableMouseButtons, disableRightClick, disableSpecificKeys, downloadBlob, enableMouseButtons, enableRightClick, enableSpecificKeys, encrypt, exportToCSV, exportToExcel, exportToJSON, exportToText, exportToXML, extractAndValidateTokens, filterObjectByKeys, flattenObject, formDataToObject, formatDate, generateRandomString, getAppKey, getAuthRefreshToken, getAuthToken, getConfiguredAxiosInstance, getDecryptedItem, getEndOfMonth, getEndpointsConfig, getObjectDifferences, getObjectKeys, getQueryParam, getRefreshTokenPathsConfig, getSessionConfig, getSessionId, getSessionPersistence, getStartOfMonth, getTokenConfig, getTokenPathsConfig, handleError, hasNestedProperties, hex2ab, importKey, isEmptyObject, isLeapYear, isStrongPassword, isValidAge, isValidCreditCard, isValidDate, isValidEmail, isValidExpiryDate, isValidHexColor, isValidHexColorAlpha, isValidHexNumber, isValidIP, isValidPhoneNumber, isValidSSN, isValidTime, isValidURL, isValidUsername, isValidZIP, lowerFirst, objectToFormData, objectToFormDataEnhanced, objectToQueryString, openWindow, parseDate, proxyToPlainObject, readFileAsDataURL, readFileAsText, refreshTokens, registerKeyboardShortcuts, removeAccent, removeClickOutside, removeCustomKeyboardShortcut, removeCustomShortcuts, removeDoubleClickListener, removeEmptyProperties, removeKeyListeners, replaceAll, reverseString, safeGet, screenMap, scrollToTop, simulateKeyPress, stopDetectingKeyHold, storeAuthRefreshToken, storeAuthToken, storeEncryptedItem, storeTokens, stringToBlob, subtractDays, throttle, toCamelCase, toKebabCase, toggleTabNavigation, truncateString, unregisterKeyboardShortcuts, upperFirst, useAuth, useBreakpoint, useFetch, useFilter, usePagination, useSorter, useVueQuery, validateAlphanumeric, validateLetters, validateNumbers, verifyAuth };

package/dist/rest/RestStd.d.ts

@@ -2,7 +2,7 @@ export declare class RestStd {
     static resource: string;
     static isFormData: boolean;
     static headers: Record<string, string>;
-    static fetchComposable: Function;
+    static fetchFn: Function;
     /**
      * Set global headers for all requests.
      * @param headers Object containing headers to be set globally.
@@ -18,8 +18,8 @@ export declare class RestStd {
      * Fetch a list of items from the server.
      *
      * @param params Query parameters for filtering the results.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static getAll<T>(params?: Record<string, any>, options?: object): any;
     /**
@@ -27,61 +27,85 @@ export declare class RestStd {
      *
      * @param id The ID of the item to fetch.
      * @param params Additional query parameters for the request.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static getOne<T>(id: string | number, params?: Record<string, any>, options?: object): any;
     /**
      * Create a new item on the server.
      *
      * @param data The data for the new item to create.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static create<T>(data: any, options?: object): any;
+    /**
+     * Create multiple new items on the server.
+     *
+     * @param data An array of data for the items to create.
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function.
+     */
+    static bulkCreate<T>(data: any[], options?: object): any;
     /**
      * Update an existing item on the server.
      *
      * @param id The ID of the item to update.
      * @param data The updated data for the item.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static update<T>(id: string | number, data: any, options?: object): any;
+    /**
+     * Update multiple existing items on the server.
+     *
+     * @param data An array of data for the items to update (each object should have an ID).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function.
+     */
+    static bulkUpdate<T>(data: any[], options?: object): any;
     /**
      * Partially update an existing item on the server.
      *
      * @param id The ID of the item to update.
      * @param data The updated data for the item.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static patch<T>(id: string | number, data: any, options?: object): any;
     /**
      * Delete an item from the server.
      *
      * @param id The ID of the item to delete.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static delete<T>(id: string | number, options?: object): any;
     /**
-     * Custom request method for more flexibility.
+     * Delete multiple items from the server by their IDs.
      *
-     * @param method HTTP method (GET, POST, etc.).
-     * @param params Query parameters.
-     * @param data Request body data.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param ids An array of IDs of the items to delete.
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function.
      */
-    static customRequest<T>(method: string, params?: Record<string, any>, data?: any, options?: object): any;
+    static bulkDelete<T>(ids: (string | number)[], options?: object): any;
     /**
-     * Save method that decides whether to create or update based on the presence of 'id'.
-     * It calls either create or update based on the data.
+     * Upsert method that decides whether to create or update based on the presence of 'id'.
      *
      * @param data The data for the item to create or update.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
+     */
+    static upsert<T>(data: any, options?: object): any;
+    /**
+     * Custom request method for more flexibility.
+     *
+     * @param method HTTP method (GET, POST, etc.).
+     * @param url The custom URL for the request.
+     * @param params Query parameters.
+     * @param data Request body data.
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
-    static save<T>(data: any, options?: object): any;
+    static customRequest<T>(method: string, url: string, params?: Record<string, any>, data?: any, options?: object): any;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arex95/vue-core",
-  "version": "1.1.40",
+  "version": "1.1.41",
   "description": "Opinionated Vue Core",
   "main": "dist/index.js",
   "module": "dist/index.mjs",