datatable-axios 0.0.7 → 0.0.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Mahmudun Nabi Kajal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Readme.md

@@ -1 +1,137 @@
-# Datatable Axios
+# Datatable Axios
+[![mahmudunnabikajal - datatable-axios](https://img.shields.io/static/v1?label=mahmudunnabikajal&message=datatable-axios&color=blue&logo=github)](https://github.com/mahmudunnabikajal/datatable-axios "Go to GitHub repo")
+[![Latest Stable Version](https://img.shields.io/npm/v/datatable-axios.svg)](https://www.npmjs.com/package/datatable-axios)
+[![NPM Downloads](https://img.shields.io/npm/dt/datatable-axios.svg)](https://www.npmjs.com/package/datatable-axios)
+[![License](https://img.shields.io/badge/License-MIT-blue)](#license)
+<!-- [![Documentation](https://img.shields.io/badge/Documentation-blue)](./docs/index.html "Go to project documentation") -->
+
+
+Datatable Axios is a simple and convenient npm package that helps you make GET, POST, and PUT requests with ease, while handling search parameters and pagination seamlessly. It's built on top of the popular Axios library, making it reliable and efficient for your data fetching needs.
+
+&nbsp;
+# Installation
+You can install Datatable Axios using npm:
+
+```bash
+npm install datatable-axios
+```
+&nbsp;
+# Why Datatable Axios?
+Simplify your `HTTP calls without repetition`. Say goodbye to repeating steps for every datatable request!
+
+- **`Cons:`** Without using the library, you can achieve the same functionality in Axios which `isn't readable & reusable`.
+```js
+const response = await axios.get('http://example.com/api/v1/products?page=2&paginate=25&search=we');
+console.log(response.data);
+```
+- **`Pros:`** After using this library, you can achieve the same functionality of Axios in a `readable & reusable way`
+```js
+const response = await datatable.get('products');
+console.log(response.data);
+```
+&nbsp;
+# Usage
+To get started with Datatable Axios, follow these simple steps:
+
+- use global axios plugin setup in `axios.js` (optional)
+``` js
+import axios from "axios"
+
+// Make the axios library globally available on the window object
+window.axios = axios
+// Set your base API URL for seamless requests
+window.axios.defaults.baseURL = "http://example.com/api/v1/"
+
+// Other configuration here
+```
+
+- Import the package at the top of your JavaScript file:
+
+```js
+import datatable from 'datatable-axios'
+```
+- Initialize an instance of the Datatable class:
+
+```js
+const datatable = new Datatable();
+```
+&nbsp;
+# Use of API URL:
+
+- When you have a global `axios.js` configuration setting with baseURL, simplify calls API by using just the path:
+```js
+const response = await datatable.get('products');
+console.log(response.data);
+```
+- If you're not utilizing a global `axios.js` configuration for with baseURL, include the full URL when making API calls:
+```js
+const response = await datatable.get('http://example.com/api/v1/products');
+console.log(response.data);
+```
+&nbsp;
+# Use of HTTP requests:
+
+- Perform a GET request:
+```js
+const response = await datatable.get('url or path');
+console.log(response.data); // Display the fetched data
+```
+- Perform a POST request:
+```js
+const response = await datatable.post('url or path');
+console.log(response.data); // Display the response data
+```
+- Perform a PUT request:
+```js
+const response = await datatable.put('url or path');
+console.log(response.data); // Display the updated data
+```
+&nbsp;
+# Example of HTTP call:
+- Example 1 : 
+```js
+datatable.get('http://example.com/api/v1/products')
+  .then(response => {
+    console.log("Data fetched successfully:", response.data);
+  })
+  .catch(error => {
+    console.error("An error occurred:", error);
+  });
+```
+- Example 2 : 
+```js
+try {
+  const response = await datatable.get('/api/v1/products');
+  console.log("Data fetched successfully:", response.data);
+} catch (error) {
+  console.error("An error occurred:", error);
+}
+```
+**`Note:`** Similar usage for POST and PUT requests
+<!-- # Advanced Usage
+You can also pass search parameters, pagination, and search queries to your requests:
+
+```js
+// Append search parameters to the URL
+const response = await datatable.get('https://api.example.com/data', {
+  page: 1,
+  paginate: 10,
+  search: 'keyword',
+});
+console.log(response.data);
+``` -->
+
+&nbsp;
+# Contributing
+We welcome contributions to enhance Datatable Axios! Feel free to open issues for bug reports or feature requests. If you'd like to contribute code, please fork the repository, make your changes, and submit a pull request.
+
+&nbsp;
+# License
+Released under [MIT License](LICENSE) by [@mahmudunnabikajal](https://github.com/mahmudunnabikajal).
+
+&nbsp;
+# Author
+Mahmudun Nabi Kajal<br />
+Contact:  [Linkedin](https://www.linkedin.com/in/mahmudun-nabi-kajal/), [GitHub](https://github.com/mahmudunnabikajal), [Gmail](mailto:mahmudunnabikajal)
+
+Feel free to reach out to me for any questions or feedback! I hope Datatable Axios simplifies your data fetching process for your datatable.

package/dist/datatable-axios.cjs.js

@@ -2,60 +2,91 @@
 
 var axios = require('axios');
 
+// Import the axios library
+
+// Make the axios library globally available on the window object
 window.axios = axios;
 
-// Create a URLSearchParams object to parse the query string
-const searchParams = new URLSearchParams(window.location.search);
-
-// Get individual query parameter values
+// Import the axios instance from the local file "./axios"
 
+// Parse the search parameters from the URL
+const searchParams = new URLSearchParams(window.location.search);
 
 class datatable {
     constructor() {
-        // this.page = router.currentRoute.value.query.page
-        // this.paginate = router.currentRoute.value.query.paginate
-        // this.search = router.currentRoute.value.query.search
+
     }
+
+    // Method to perform a GET request
     async get(url) {
-        // const page = router.currentRoute.value.query.page
-        // const paginate = router.currentRoute.value.query.paginate
-        // const search = router.currentRoute.value.query.search
+        // Retrieve values from search parameters
         const page = searchParams.get('page');
         const paginate = searchParams.get('paginate');
         const search = searchParams.get('search');
 
+        // Return a Promise that resolves when the request completes
         return new Promise(async (resolve) => {
             if (!page && !paginate && !search) {
+                // If no search parameters, make a regular GET request
                 await window.axios.get(url).then(response => {
-                    resolve(response);
+                    resolve(response); // Resolve the Promise with the response
                 });
             } else {
+                // If search parameters exist, append them to the URL
                 await window.axios.get(`${url}?page=${page}&paginate=${paginate}&search=${search}`).then(response => {
-                    resolve(response);
+                    resolve(response); // Resolve the Promise with the response
                 });
             }
         })
     }
+
+    // Method to perform a POST request
     async post(url) {
-        // const page = router.currentRoute.value.query.page
-        // const paginate = router.currentRoute.value.query.paginate
-        // const search = router.currentRoute.value.query.search
+        // Retrieve values from search parameters
         const page = searchParams.get('page');
         const paginate = searchParams.get('paginate');
         const search = searchParams.get('search');
 
+        // Return a Promise that resolves when the request completes
         return new Promise(async (resolve) => {
             if (!page && !paginate && !search) {
+                // If no search parameters, make a regular POST request
                 await window.axios.post(url).then(response => {
-                    resolve(response);
+                    resolve(response); // Resolve the Promise with the response
                 });
             } else {
+                // If search parameters exist, append them to the URL
                 await window.axios.post(`${url}?page=${page}&paginate=${paginate}&search=${search}`).then(response => {
-                    resolve(response);
+                    resolve(response); // Resolve the Promise with the response
+                });
+            }
+        })
+    }
+
+    // Method to perform a PUT request
+    async put(url) {
+        // Retrieve values from search parameters
+        const page = searchParams.get('page');
+        const paginate = searchParams.get('paginate');
+        const search = searchParams.get('search');
+
+        // Return a Promise that resolves when the request completes
+        return new Promise(async (resolve) => {
+            if (!page && !paginate && !search) {
+                // If no search parameters, make a regular PUT request
+                await window.axios.put(url).then(response => {
+                    resolve(response); // Resolve the Promise with the response
+                });
+            } else {
+                // If search parameters exist, append them to the URL
+                await window.axios.put(`${url}?page=${page}&paginate=${paginate}&search=${search}`).then(response => {
+                    resolve(response); // Resolve the Promise with the response
                 });
             }
         })
     }
 }
 
+// Import the "datatable" class from the local file "./datatable"
+
 module.exports = datatable;

package/dist/datatable-axios.esm.js

@@ -1,59 +1,90 @@
 import axios from 'axios';
 
+// Import the axios library
+
+// Make the axios library globally available on the window object
 window.axios = axios;
 
-// Create a URLSearchParams object to parse the query string
-const searchParams = new URLSearchParams(window.location.search);
-
-// Get individual query parameter values
+// Import the axios instance from the local file "./axios"
 
+// Parse the search parameters from the URL
+const searchParams = new URLSearchParams(window.location.search);
 
 class datatable {
     constructor() {
-        // this.page = router.currentRoute.value.query.page
-        // this.paginate = router.currentRoute.value.query.paginate
-        // this.search = router.currentRoute.value.query.search
+
     }
+
+    // Method to perform a GET request
     async get(url) {
-        // const page = router.currentRoute.value.query.page
-        // const paginate = router.currentRoute.value.query.paginate
-        // const search = router.currentRoute.value.query.search
+        // Retrieve values from search parameters
         const page = searchParams.get('page');
         const paginate = searchParams.get('paginate');
         const search = searchParams.get('search');
 
+        // Return a Promise that resolves when the request completes
         return new Promise(async (resolve) => {
             if (!page && !paginate && !search) {
+                // If no search parameters, make a regular GET request
                 await window.axios.get(url).then(response => {
-                    resolve(response);
+                    resolve(response); // Resolve the Promise with the response
                 });
             } else {
+                // If search parameters exist, append them to the URL
                 await window.axios.get(`${url}?page=${page}&paginate=${paginate}&search=${search}`).then(response => {
-                    resolve(response);
+                    resolve(response); // Resolve the Promise with the response
                 });
             }
         })
     }
+
+    // Method to perform a POST request
     async post(url) {
-        // const page = router.currentRoute.value.query.page
-        // const paginate = router.currentRoute.value.query.paginate
-        // const search = router.currentRoute.value.query.search
+        // Retrieve values from search parameters
         const page = searchParams.get('page');
         const paginate = searchParams.get('paginate');
         const search = searchParams.get('search');
 
+        // Return a Promise that resolves when the request completes
         return new Promise(async (resolve) => {
             if (!page && !paginate && !search) {
+                // If no search parameters, make a regular POST request
                 await window.axios.post(url).then(response => {
-                    resolve(response);
+                    resolve(response); // Resolve the Promise with the response
                 });
             } else {
+                // If search parameters exist, append them to the URL
                 await window.axios.post(`${url}?page=${page}&paginate=${paginate}&search=${search}`).then(response => {
-                    resolve(response);
+                    resolve(response); // Resolve the Promise with the response
+                });
+            }
+        })
+    }
+
+    // Method to perform a PUT request
+    async put(url) {
+        // Retrieve values from search parameters
+        const page = searchParams.get('page');
+        const paginate = searchParams.get('paginate');
+        const search = searchParams.get('search');
+
+        // Return a Promise that resolves when the request completes
+        return new Promise(async (resolve) => {
+            if (!page && !paginate && !search) {
+                // If no search parameters, make a regular PUT request
+                await window.axios.put(url).then(response => {
+                    resolve(response); // Resolve the Promise with the response
+                });
+            } else {
+                // If search parameters exist, append them to the URL
+                await window.axios.put(`${url}?page=${page}&paginate=${paginate}&search=${search}`).then(response => {
+                    resolve(response); // Resolve the Promise with the response
                 });
             }
         })
     }
 }
 
+// Import the "datatable" class from the local file "./datatable"
+
 export { datatable as default };

package/dist/datatable-axios.umd.js

@@ -4,62 +4,93 @@
     (global = typeof globalThis !== 'undefined' ? globalThis : global || self, global["datatable-axios"] = factory(global.axios));
 })(this, (function (axios) { 'use strict';
 
+    // Import the axios library
+
+    // Make the axios library globally available on the window object
     window.axios = axios;
 
-    // Create a URLSearchParams object to parse the query string
-    const searchParams = new URLSearchParams(window.location.search);
-
-    // Get individual query parameter values
+    // Import the axios instance from the local file "./axios"
 
+    // Parse the search parameters from the URL
+    const searchParams = new URLSearchParams(window.location.search);
 
     class datatable {
         constructor() {
-            // this.page = router.currentRoute.value.query.page
-            // this.paginate = router.currentRoute.value.query.paginate
-            // this.search = router.currentRoute.value.query.search
+
         }
+
+        // Method to perform a GET request
         async get(url) {
-            // const page = router.currentRoute.value.query.page
-            // const paginate = router.currentRoute.value.query.paginate
-            // const search = router.currentRoute.value.query.search
+            // Retrieve values from search parameters
             const page = searchParams.get('page');
             const paginate = searchParams.get('paginate');
             const search = searchParams.get('search');
 
+            // Return a Promise that resolves when the request completes
             return new Promise(async (resolve) => {
                 if (!page && !paginate && !search) {
+                    // If no search parameters, make a regular GET request
                     await window.axios.get(url).then(response => {
-                        resolve(response);
+                        resolve(response); // Resolve the Promise with the response
                     });
                 } else {
+                    // If search parameters exist, append them to the URL
                     await window.axios.get(`${url}?page=${page}&paginate=${paginate}&search=${search}`).then(response => {
-                        resolve(response);
+                        resolve(response); // Resolve the Promise with the response
                     });
                 }
             })
         }
+
+        // Method to perform a POST request
         async post(url) {
-            // const page = router.currentRoute.value.query.page
-            // const paginate = router.currentRoute.value.query.paginate
-            // const search = router.currentRoute.value.query.search
+            // Retrieve values from search parameters
             const page = searchParams.get('page');
             const paginate = searchParams.get('paginate');
             const search = searchParams.get('search');
 
+            // Return a Promise that resolves when the request completes
             return new Promise(async (resolve) => {
                 if (!page && !paginate && !search) {
+                    // If no search parameters, make a regular POST request
                     await window.axios.post(url).then(response => {
-                        resolve(response);
+                        resolve(response); // Resolve the Promise with the response
                     });
                 } else {
+                    // If search parameters exist, append them to the URL
                     await window.axios.post(`${url}?page=${page}&paginate=${paginate}&search=${search}`).then(response => {
-                        resolve(response);
+                        resolve(response); // Resolve the Promise with the response
+                    });
+                }
+            })
+        }
+
+        // Method to perform a PUT request
+        async put(url) {
+            // Retrieve values from search parameters
+            const page = searchParams.get('page');
+            const paginate = searchParams.get('paginate');
+            const search = searchParams.get('search');
+
+            // Return a Promise that resolves when the request completes
+            return new Promise(async (resolve) => {
+                if (!page && !paginate && !search) {
+                    // If no search parameters, make a regular PUT request
+                    await window.axios.put(url).then(response => {
+                        resolve(response); // Resolve the Promise with the response
+                    });
+                } else {
+                    // If search parameters exist, append them to the URL
+                    await window.axios.put(`${url}?page=${page}&paginate=${paginate}&search=${search}`).then(response => {
+                        resolve(response); // Resolve the Promise with the response
                     });
                 }
             })
         }
     }
 
+    // Import the "datatable" class from the local file "./datatable"
+
     return datatable;
 
 }));

package/package.json

@@ -1,59 +1,59 @@
-{
-  "name": "datatable-axios",
-  "version": "0.0.7",
-  "description": "A powerful npm package for effortless datatable interactions with seamless Axios calls. Effortlessly integrate search, paginate, and pagination functionalities into your projects with ease.",
-  "type": "module",
-  "main": "dist/datatable-axios.cjs.js",
-  "unpkg": "dist/datatable-axios.umd.js",
-  "jsdelivr": "dist/simple-datatables.umd.js",
-  "exports": {
-    ".": {
-      "import": "./dist/datatable-axios.esm.js",
-      "require": "./dist/datatable-axios.cjs.js"
-    }
-  },
-  "scripts": {
-    "build": "npm run build:rollup",
-    "build:vite": "vite build",
-    "build:rollup": "rollup -c"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/mahmudunnabikajal/datatable-axios.git"
-  },
-  "keywords": [
-    "datatable",
-    "axiosdatatable",
-    "datatableaxios",
-    "datatable-axios",
-    "DataTables",
-    "DataTable",
-    "table",
-    "grid",
-    "filter",
-    "sort",
-    "page",
-    "javascript-plugin",
-    "vite",
-    "npm",
-    "package"
-  ],
-  "author": "Mahmudun Nabi Kajal",
-  "license": "ISC",
-  "bugs": {
-    "url": "https://github.com/mahmudunnabikajal/datatable-axios/issues"
-  },
-  "homepage": "https://github.com/mahmudunnabikajal/datatable-axios#readme",
-  "peerDependencies": {
-    "axios": "*"
-  },
-  "devDependencies": {
-    "vite": "^4.4.9",
-    "@rollup/plugin-commonjs": "^25.0.4",
-    "@rollup/plugin-node-resolve": "^15.2.0",
-    "rollup": "^3.28.0"
-  },
-  "dependencies": {
-    "axios": "^1.4.0"
-  }
-}
+{
+  "name": "datatable-axios",
+  "version": "0.0.9",
+  "description": "A powerful npm package for effortless datatable interactions with seamless Axios calls. Effortlessly integrate search, paginate, and pagination functionalities into your projects with ease.",
+  "type": "module",
+  "main": "dist/datatable-axios.cjs.js",
+  "unpkg": "dist/datatable-axios.umd.js",
+  "jsdelivr": "dist/simple-datatables.umd.js",
+  "exports": {
+    ".": {
+      "import": "./dist/datatable-axios.esm.js",
+      "require": "./dist/datatable-axios.cjs.js"
+    }
+  },
+  "scripts": {
+    "build": "npm run build:rollup",
+    "build:vite": "vite build",
+    "build:rollup": "rollup -c"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mahmudunnabikajal/datatable-axios.git"
+  },
+  "keywords": [
+    "datatable",
+    "axiosdatatable",
+    "datatableaxios",
+    "datatable-axios",
+    "DataTables",
+    "DataTable",
+    "table",
+    "grid",
+    "filter",
+    "sort",
+    "page",
+    "javascript-plugin",
+    "vite",
+    "npm",
+    "package"
+  ],
+  "author": "Mahmudun Nabi Kajal",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/mahmudunnabikajal/datatable-axios/issues"
+  },
+  "homepage": "https://mahmudunnabikajal.github.io/datatable-axios/",
+  "peerDependencies": {
+    "axios": "*"
+  },
+  "devDependencies": {
+    "vite": "^4.4.9",
+    "@rollup/plugin-commonjs": "^25.0.4",
+    "@rollup/plugin-node-resolve": "^15.2.0",
+    "rollup": "^3.28.0"
+  },
+  "dependencies": {
+    "axios": "^1.4.0"
+  }
+}