lightspeed-retail-sdk 3.3.4 → 3.3.5

package/README.md

@@ -2,9 +2,9 @@
 
 A modern JavaScript SDK for interacting with the Lightspeed Retail API. This SDK provides a convenient, secure, and flexible way to access Lightspeed Retail's features—including customer, item, and order management.
 
-**Current Version: 3.3.4** — improve error checking on token refresh to prevent false email warnings.
+**Current Version: 3.3.5** — improve error checking on token refresh to prevent false email warnings.
 
-## **🆕 Recent Updates (v3.3.4)**
+## **🆕 Recent Updates (v3.3.5)**
 
 - **Add centralized query param builder for API requests**: Add centralized query param builder for API requests. Supports input as object, string, or array, and manages relations/load_relations. Ensures no double-encoding of parameters and handles special cases for 'or' and 'timeStamp'.
 - **🎯 Enhanced Parameter Support**: All main getter methods now support both legacy and new object-based parameters with full backward compatibility
@@ -66,7 +66,7 @@ const items = await sdk.getItems({
 ## Table of Contents
 
 - [Another Unofficial Lightspeed Retail V3 API SDK](#another-unofficial-lightspeed-retail-v3-api-sdk)
-  - [**🆕 Recent Updates (v3.3.4)**](#-recent-updates-v334)
+  - [**🆕 Recent Updates (v3.3.5)**](#-recent-updates-v335)
   - [🚀 Key Features](#-key-features)
   - [🔄 Migrating from 3.1.x](#-migrating-from-31x)
     - [Backward Compatibility](#backward-compatibility)

package/dist/src/core/LightspeedSDK.cjs

@@ -291,6 +291,81 @@ class LightspeedSDKCore {
             this.refreshInProgress = false; // Release the lock
         }
     }
+    // Core API request handler
+    async executeApiRequest(options, retries = 0) {
+        await this.handleRateLimit(options);
+        const token = await this.getToken();
+        if (!token) throw new Error("Error Fetching Token");
+        options.headers = {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+            ...options.headers
+        };
+        // Centralized query param handling
+        if (options.params) {
+            const queryString = buildQueryParams(options.params);
+            if (queryString) {
+                // Remove any trailing ? or & from url
+                options.url = options.url.replace(/[?&]+$/, "");
+                options.url += (options.url.includes("?") ? "&" : "?") + queryString;
+            }
+            delete options.params; // Don't let axios try to re-encode
+        }
+        try {
+            const res = await (0, _axios.default)(options);
+            this.lastResponse = res;
+            if (options.method === "GET") {
+                var _res_data_attributes, _res_data_attributes1;
+                // Handle successful response with no data or empty data
+                if (!res.data || Object.keys(res.data).length === 0) {
+                    return {
+                        data: {},
+                        next: null,
+                        previous: null
+                    };
+                }
+                // Check if response has the expected structure but with empty arrays
+                const dataKeys = Object.keys(res.data).filter((key)=>key !== "@attributes");
+                if (dataKeys.length > 0) {
+                    const firstDataKey = dataKeys[0];
+                    const firstDataValue = res.data[firstDataKey];
+                // No need to log for empty arrays - this is normal
+                }
+                // Handle successful response with data
+                return {
+                    data: res.data,
+                    next: (_res_data_attributes = res.data["@attributes"]) === null || _res_data_attributes === void 0 ? void 0 : _res_data_attributes.next,
+                    previous: (_res_data_attributes1 = res.data["@attributes"]) === null || _res_data_attributes1 === void 0 ? void 0 : _res_data_attributes1.prev
+                };
+            } else {
+                return res.data;
+            }
+        } catch (err) {
+            var _err_response;
+            // Handle 401 auth errors with automatic retry
+            if (((_err_response = err.response) === null || _err_response === void 0 ? void 0 : _err_response.status) === 401 && !options._authRetryAttempted) {
+                console.log("🔄 401 error - forcing token refresh and retrying...");
+                options._authRetryAttempted = true;
+                this.token = null;
+                try {
+                    await this.refreshTokens();
+                    return this.executeApiRequest(options, retries);
+                } catch (refreshError) {
+                    console.error("Failed to refresh tokens:", refreshError.message);
+                    throw refreshError;
+                }
+            }
+            // Handle retryable errors
+            if (this.isRetryableError(err) && retries < this.maxRetries) {
+                this.handleError(`Network Error Retrying in 2 seconds...`, err.message, false);
+                await sleep(2000);
+                return this.executeApiRequest(options, retries + 1);
+            } else {
+                // Simple error handling - let the calling method decide how to handle it
+                throw err;
+            }
+        }
+    }
     // Paginated data fetching
     async getAllData(options) {
         var _options_params;

package/dist/src/core/LightspeedSDK.mjs

@@ -320,6 +320,97 @@ export class LightspeedSDKCore {
     }
   }
 
+  // Core API request handler
+  async executeApiRequest(options, retries = 0) {
+    await this.handleRateLimit(options);
+
+    const token = await this.getToken();
+    if (!token) throw new Error("Error Fetching Token");
+
+    options.headers = {
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/json",
+      ...options.headers,
+    };
+
+    // Centralized query param handling
+    if (options.params) {
+      const queryString = buildQueryParams(options.params);
+      if (queryString) {
+        // Remove any trailing ? or & from url
+        options.url = options.url.replace(/[?&]+$/, "");
+        options.url += (options.url.includes("?") ? "&" : "?") + queryString;
+      }
+      delete options.params; // Don't let axios try to re-encode
+    }
+
+    try {
+      const res = await axios(options);
+      this.lastResponse = res;
+
+      if (options.method === "GET") {
+        // Handle successful response with no data or empty data
+        if (!res.data || Object.keys(res.data).length === 0) {
+          return {
+            data: {},
+            next: null,
+            previous: null,
+          };
+        }
+
+        // Check if response has the expected structure but with empty arrays
+        const dataKeys = Object.keys(res.data).filter(
+          (key) => key !== "@attributes"
+        );
+        if (dataKeys.length > 0) {
+          const firstDataKey = dataKeys[0];
+          const firstDataValue = res.data[firstDataKey];
+
+          // No need to log for empty arrays - this is normal
+        }
+
+        // Handle successful response with data
+        return {
+          data: res.data,
+          next: res.data["@attributes"]?.next,
+          previous: res.data["@attributes"]?.prev,
+        };
+      } else {
+        return res.data;
+      }
+    } catch (err) {
+      // Handle 401 auth errors with automatic retry
+      if (err.response?.status === 401 && !options._authRetryAttempted) {
+        console.log("🔄 401 error - forcing token refresh and retrying...");
+
+        options._authRetryAttempted = true;
+        this.token = null;
+
+        try {
+          await this.refreshTokens();
+          return this.executeApiRequest(options, retries);
+        } catch (refreshError) {
+          console.error("Failed to refresh tokens:", refreshError.message);
+          throw refreshError;
+        }
+      }
+
+      // Handle retryable errors
+      if (this.isRetryableError(err) && retries < this.maxRetries) {
+        this.handleError(
+          `Network Error Retrying in 2 seconds...`,
+          err.message,
+          false
+        );
+        await sleep(2000);
+        return this.executeApiRequest(options, retries + 1);
+      } else {
+        // Simple error handling - let the calling method decide how to handle it
+        throw err;
+      }
+    }
+  }
+
   // Paginated data fetching
   async getAllData(options) {
     let allData = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lightspeed-retail-sdk",
-  "version": "3.3.4",
+  "version": "3.3.5",
   "description": "Another unofficial Lightspeed Retail API SDK for Node.js",
   "type": "module",
   "main": "dist/index.cjs",