lightspeed-retail-sdk 2.0.6 → 2.0.8

package/README.md

@@ -1,43 +1,29 @@
 # Another Unofficial Lightspeed Retail V3 API SDK
 
-## Work In Progress
+A JavaScript SDK for interacting with the Lightspeed Retail API. This SDK provides a convenient way to access Lightspeed Retail's functionalities, including customer, item, order management, and more.
 
-Constributions Welcome
+## Update
 
-All methods accept relations, these should be provided as strings i.e.: `["relation1", "relation2"]`
-We currently have the following methods available,
+I have updated this package so it can be used with either index.cjs or index.mjs for imports.
 
-```
-getCustomer(id: int, relations?: string)
-getCustomers(relations?: string)
-getItem(id: int, relations?: string)
-getItems(relations?: string)
-getMultipleItems(ids: string = "[102, 103]", relations?: string)
-getVendorItems(id: int relations?: string)
-getMatrixItems(relations? string)
-getMatrixItem(id: int, relations? string)
-getCategory(id: int, relations?: string)
-getCategories(relations?: string)
-getManufacturer(id: int, relations?: string)
-getManufacturers(relations?: string)
-getOrder(id: int, relations?: string)
-getOrders(relations?: string)
-getOrdersByVendorID(id: int, relations?: string)
-getOpenOrdersByVendorID(id: int, relations?: string)
-getVendor(id: int, relations?: string)
-getVendors(relations?: string)
-getSale(id: int, relations?: string)
-getSales(relations?: string)
-getMultipleSales(ids: string = "[102, 103]", relations?: string)
-getSaleLinesByItem(id: int, relations?: string)
-getSaleLinesByItems(ids: string = `39, 2126, 3505`, startDate?, endDate?, relations?: string)
-getSaleLinesByVendorID(id: int, startDate?, endDate?, relations?: string)
+## Features
+
+- Easy-to-use methods for interacting with various Lightspeed Retail endpoints.
+- Built-in handling of API rate limits.
+- Automatic token management for authentication.
+- Support for paginated responses from the Lightspeed API.
+- Retry logic for handling transient network issues.
+
+## Installation
+
+```bash
+npm install lightspeed-retail-sdk
 ```
 
 ## Get started:
 
 ```
-import LightspeedRetailSDK from "lightspeed-retail-sdk";
+import LightspeedRetailSDK from "lightspeed-retail-sdk/index.mjs";
 
 const api = new LightspeedRetailSDK({
   accountID: "Your Account No.",
@@ -58,6 +44,45 @@ console.log(item);
 7497 being the itemID. You can pass required relations as above.
 ```
 
+## Methods
+
+- `getCustomer(id, relations)`: Fetches a specific customer by ID. Optionally, related data can be included.
+- `getCustomers(relations)`: Retrieves all customers. Optionally, related data can be included.
+- `getItem(id, relations)`: Fetches a specific item by ID. Optionally, related data can be included.
+- `getMultipleItems(items, relations)`: Retrieves multiple items by their IDs. Optionally, related data can be included.
+- `getItems(relations)`: Retrieves all items. Optionally, related data can be included.
+- `getvendorItems(vendorID, relations)`: Retrieves all items for a specific vendor. Optionally, related data can be included.
+- `getMatrixItems(relations)`: Fetches all matrix items. Optionally, related data can be included.
+- `getMatrixItem(id, relations)`: Fetches a specific matrix item by ID. Optionally, related data can be included.
+- `getCategory(id, relations)`: Retrieves a specific category by ID. Optionally, related data can be included.
+- `getCategories(relations)`: Retrieves all categories. Optionally, related data can be included.
+- `getManufacturer(id, relations)`: Fetches a specific manufacturer by ID. Optionally, related data can be included.
+- `getManufacturers(relations)`: Retrieves all manufacturers. Optionally, related data can be included.
+- `getOrder(id, relations)`: Fetches a specific order by ID. Optionally, related data can be included.
+- `getOrders(relations)`: Retrieves all orders. Optionally, related data can be included.
+- `getOrdersByVendorID(id, relations)`: Retrieves all orders for a specific vendor. Optionally, related data can be included.
+- `getOpenOrdersByVendorID(id, relations)`: Fetches all open orders for a specific vendor. Optionally, related data can be included.
+- `getVendor(id, relations)`: Fetches a specific vendor by ID. Optionally, related data can be included.
+- `getVendors(relations)`: Retrieves all vendors. Optionally, related data can be included.
+- `getSale(id, relations)`: Fetches a specific sale by ID. Optionally, related data can be included.
+- `getSales(relations)`: Retrieves all sales. Optionally, related data can be included.
+- `getMultipleSales(saleIDs, relations)`: Fetches multiple sales by their IDs. Optionally, related data can be included.
+- `getSaleLinesByItem(itemID, relations)`: Retrieves sale lines for a specific item. Optionally, related data can be included.
+- `getSaleLinesByItems(ids, startDate, endDate, relations)`: Retrieves sale lines for multiple items, filtered by date range. Optionally, related data can be included.
+- `getSaleLinesByVendorID(id, startDate, endDate, relations)`: Fetches sale lines for a specific vendor, filtered by date range. Optionally, related data can be included.
+
+## Contributing
+
+Contributions are welcome!
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+## Disclaimer
+
+This SDK is not officially affiliated with Lightspeed HQ and is provided "as is" with no warranty.
+
 ## More Info
 
 The documentation for the Lightspeed Retail API can be found at https://developers.lightspeedhq.com/retail/introduction/introduction/

package/index.cjs

@@ -0,0 +1,646 @@
+const axios = require("axios");
+
+const operationUnits = { GET: 1, POST: 10, PUT: 10 };
+const getRequestUnits = (operation) => operationUnits[operation] || 10;
+
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+class LightspeedRetailSDK {
+  static BASE_URL = "https://api.lightspeedapp.com/API/V3/Account";
+  static TOKEN_URL = "https://cloud.lightspeedapp.com/oauth/access_token.php";
+
+  constructor(opts) {
+    const { clientID, clientSecret, refreshToken, accountID } = opts;
+
+    this.clientID = clientID;
+    this.clientSecret = clientSecret;
+    this.refreshToken = refreshToken;
+    this.accountID = accountID;
+    this.baseUrl = LightspeedRetailSDK.BASE_URL;
+    this.tokenUrl = LightspeedRetailSDK.TOKEN_URL;
+    this.maxRetries = 3;
+    this.lastResponse = null;
+    this.token = null;
+    this.tokenExpiry = null;
+  }
+
+  // handleError function to handle errors
+  handleError(context, err, shouldThrow = true) {
+    // Context includes information about where the error occurred
+    const detailedMessage = `Error in ${context}: ${err.message}`;
+
+    // Log the error message
+    console.error(detailedMessage);
+
+    // Log the stack trace if available
+    if (err.stack) {
+      console.error("Stack trace:", err.stack);
+    }
+
+    // If the error has response data, log it
+    if (err.response) {
+      console.error("Error response:", {
+        status: err.response.status,
+        headers: err.response.headers,
+        data: err.response.data,
+      });
+    }
+
+    // Optionally rethrow the error with the detailed message
+    if (shouldThrow) {
+      throw new Error(detailedMessage);
+    }
+  }
+
+  // Update the last response
+  setLastResponse = (response) => (this.lastResponse = response);
+
+  // Handle rate limits
+  handleRateLimit = async (options) => {
+    if (!this.lastResponse) return null;
+
+    const { method } = options;
+    const requestUnits = getRequestUnits(method);
+    const rateHeader = this.lastResponse.headers["x-ls-api-bucket-level"];
+
+    if (!rateHeader) return null;
+
+    const [used, available] = rateHeader.split("/");
+    const availableUnits = available - used;
+    if (requestUnits <= availableUnits) return 0;
+
+    const dripRate = parseInt(this.lastResponse.headers["x-ls-api-drip-rate"], 10);
+
+    // Check if dripRate is a valid number greater than 0
+    if (isNaN(dripRate) || dripRate <= 0) {
+      this.handleError.error("Invalid drip rate received from API");
+    }
+
+    const unitWait = requestUnits - availableUnits;
+    const delay = Math.ceil((unitWait / dripRate) * 1000);
+    await sleep(delay);
+
+    return unitWait;
+  };
+
+  // Get a new token
+  getToken = async () => {
+    const now = new Date();
+    const bufferTime = 1 * 60 * 1000; // 1 minute buffer
+
+    // Check if the token exists and is still valid
+    if (this.token && this.tokenExpiry.getTime() - now.getTime() > bufferTime) {
+      return this.token;
+    }
+
+    // Fetch a new token if needed
+    const body = {
+      grant_type: "refresh_token",
+      client_id: this.clientID,
+      client_secret: this.clientSecret,
+      refresh_token: this.refreshToken,
+    };
+
+    try {
+      const response = await axios({
+        url: this.tokenUrl,
+        method: "post",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        data: JSON.stringify(body),
+      });
+
+      const tokenData = await response.data;
+
+      // Set token and expiry time
+      this.token = tokenData.access_token;
+      this.tokenExpiry = new Date(now.getTime() + tokenData.expires_in * 1000);
+
+      return this.token;
+    } catch (error) {
+      return this.handleError("GET TOKEN ERROR", error);
+    }
+  };
+
+  // Fetch a resource
+  executeApiRequest = async (options, retries = 0) => {
+    await this.handleRateLimit(options);
+
+    const token = await this.getToken();
+    if (!token) throw new Error("Error Fetching Token");
+
+    // Set common headers
+    options.headers = {
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/json",
+      ...options.headers, // Merge with any additional headers passed in options
+    };
+
+    try {
+      const res = await axios(options);
+      this.lastResponse = res;
+
+      // Return the data
+      if (options.method === "GET") {
+        return {
+          data: res.data,
+          next: res.next,
+          previous: res.previous,
+        };
+      } else {
+        return res.data; // For POST and PUT, typically just return the data
+      }
+    } catch (err) {
+      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 {
+        this.handleError(`Failed Request statusText: ${err.response?.statusText}`);
+        this.handleError(`Failed data: ${err.response?.data}`);
+        throw err;
+      }
+    }
+  };
+
+  // Get paginated data
+  async getAllData(options) {
+    let allData = [];
+    while (options.url) {
+      const { data } = await this.executeApiRequest(options);
+      let next = data["@attributes"].next;
+      let selectDataArray = Object.keys(data)[1];
+      let selectedData = data[selectDataArray];
+      allData = allData.concat(selectedData);
+      options.url = next;
+    }
+    return allData;
+  }
+
+  // Check if error is retryable
+  isRetryableError = (err) => {
+    if (!err.response) {
+      // No response (network error or timeout)
+      return true;
+    }
+
+    // Retry for server errors (500-599)
+    return err.response.status >= 500 && err.response.status <= 599;
+  };
+
+  // Get customer by ID
+  async getCustomer(id, relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Customer/${id}.json`,
+      method: "GET",
+    };
+
+    if (!id) return this.handleError("You need to provide a customerID");
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET CUSTOMERS ERROR", error);
+    }
+  }
+
+  // Get all customers
+  async getCustomers(relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Customer.json`,
+      method: "GET",
+    };
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET CUSTOMERS ERROR", error);
+    }
+  }
+
+  // Get item by ID
+  async getItem(id, relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Item/${id}.json`,
+      method: "GET",
+    };
+
+    if (!id) return this.handleError("You need to provide a itemID");
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET ITEM ERROR", error);
+    }
+  }
+
+  // Get multiple items by ID
+  async getMultipleItems(items, relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Item.json`,
+      method: "GET",
+    };
+
+    if (!items) this.handleError("You need to provide itemID's");
+
+    if (items) options.url = options.url + `?itemID=IN,${items}`;
+
+    if (relations) options.url = options.url + `&load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET ITEMS ERROR", error);
+    }
+  }
+
+  // Get all items
+  async getItems(relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Item.json`,
+      method: "GET",
+    };
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET ITEMS ERROR", error);
+    }
+  }
+
+  // Get all items by vendor
+  async getvendorItems(vendorID, relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Item.json?defaultVendorID=${vendorID}`,
+      method: "GET",
+    };
+
+    if (relations) options.url = options.url + `&load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET ITEMS ERROR", error);
+    }
+  }
+
+  // Get all Matrix Items
+  async getMatrixItems(relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/ItemMatrix.json`,
+      method: "GET",
+    };
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET ITEM ERROR", error);
+    }
+  }
+
+  // Get Matrix Item by ID
+  async getMatrixItem(id, relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/ItemMatrix/${id}.json`,
+      method: "GET",
+    };
+
+    if (!id) return this.handleError("You need to provide a itemID");
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET ITEM ERROR", error);
+    }
+  }
+
+  // Get category by ID
+  async getCategory(id, relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Category/${id}.json`,
+      method: "GET",
+    };
+
+    if (!id) return this.handleError("You need to provide a categoryID");
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET CATEGORY ERROR", error);
+    }
+  }
+
+  // Get all categories
+  async getCategories(relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Category.json`,
+      method: "GET",
+    };
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET CATEGORIES ERROR", error);
+    }
+  }
+
+  // Get Manufacturer by ID
+  async getManufacturer(id, relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Manufacturer/${id}.json`,
+      method: "GET",
+    };
+
+    if (!id) return this.handleError("You need to provide a manufacturerID");
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET MANUFACTURER ERROR", error);
+    }
+  }
+
+  // Get all manufacturers
+  async getManufacturers(relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Manufacturer.json`,
+      method: "GET",
+    };
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET MANUFACTURERS ERROR", error);
+    }
+  }
+
+  // Get order by ID
+  async getOrder(id, relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Order/${id}.json`,
+      method: "GET",
+    };
+
+    if (!id) return this.handleError("You need to provide a orderID");
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET ORDER ERROR", error);
+    }
+  }
+
+  // Get all orders
+  async getOrders(relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Order.json`,
+      method: "GET",
+    };
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET ORDERS ERROR", error);
+    }
+  }
+
+  // Get all orders by vendor
+  async getOrdersByVendorID(id, relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Order.json?load_relations=["Vendor"]&vendorID=${id}`,
+      method: "GET",
+    };
+
+    if (!id) return this.handleError("You need to provide a vendorID");
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET ORDER ERROR", error);
+    }
+  }
+
+  // Get all open orders by vendor
+  async getOpenOrdersByVendorID(id, relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Order.json?load_relations=["Vendor", "OrderLines"]&vendorID=${id}&complete=false`,
+      method: "GET",
+    };
+
+    if (!id) return this.handleError("You need to provide a vendorID");
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET ORDER ERROR", error);
+    }
+  }
+
+  // Get vendor by ID
+  async getVendor(id, relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Vendor/${id}.json`,
+      method: "GET",
+    };
+
+    if (!id) return this.handleError("You need to provide a vendorID");
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET VENDOR ERROR", error);
+    }
+  }
+
+  // Get all vendors
+  async getVendors(relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Vendor.json`,
+      method: "GET",
+    };
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET VENDORS ERROR", error);
+    }
+  }
+
+  // Get sale by ID
+  async getSale(id, relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Sale/${id}.json`,
+      method: "GET",
+    };
+
+    if (!id) return this.handleError("You need to provide a saleID");
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET SALE ERROR", error);
+    }
+  }
+
+  // Get all sales
+  async getSales(relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Sale.json`,
+      method: "GET",
+    };
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET SALES ERROR", error);
+    }
+  }
+
+  async getMultipleSales(saleIDs, relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/Sale.json?saleID=IN,${saleIDs}`,
+      method: "GET",
+    };
+
+    if (relations) options.url = options.url + `?load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET SALE ERROR", error);
+    }
+  }
+
+  async getSaleLinesByItem(itemID, relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/SaleLine.json?itemID=${itemID}`,
+      method: "GET",
+    };
+
+    if (relations) options.url = options.url + `&load_relations=${relations}`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET SALE ERROR", error);
+    }
+  }
+
+  // Get sales lines by item ID's and date range
+  async getSaleLinesByItems(ids, startDate = undefined, endDate = undefined, relations) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/SaleLine.json?itemID=IN,[${ids}]`,
+      method: "GET",
+    };
+
+    if (!ids) return this.handleError("You need to provide itemIDs");
+    if (startDate && !endDate) return this.handleError("You need to provide an end date");
+    if (endDate && !startDate)
+      return this.handleError("You need to provide a start date");
+
+    if (relations) options.url = options.url + `&load_relations=${relations}`;
+
+    if (startDate && endDate)
+      options.url =
+        options.url + `&timeStamp=%3E%3C%2C${startDate}%2C${endDate}&sort=timeStamp`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET SALE ERROR", error);
+    }
+  }
+
+  // Get sales lines by vendor ID's and date range
+  async getSaleLinesByVendorID(
+    id,
+    startDate = undefined,
+    endDate = undefined,
+    relations
+  ) {
+    const options = {
+      url: `${this.baseUrl}/${this.accountID}/SaleLine.json?load_relations=${
+        relations ? relations : `["Item"]`
+      }&Item.defaultVendorID=${id}`,
+      method: "GET",
+    };
+
+    if (!id) return this.handleError("You need to provide a vendorID");
+    if (startDate && !endDate) return this.handleError("You need to provide an end date");
+    if (endDate && !startDate)
+      return this.handleError("You need to provide a start date");
+
+    if (startDate && endDate)
+      options.url =
+        options.url + `&timeStamp=%3E%3C%2C${startDate}%2C${endDate}&sort=timeStamp`;
+
+    try {
+      const response = await this.getAllData(options);
+      return response;
+    } catch (error) {
+      return this.handleError("GET SALE ERROR", error);
+    }
+  }
+}
+
+module.exports = LightspeedRetailSDK;

package/{index.js → index.mjs}

@@ -1,22 +1,14 @@
 import axios from "axios";
 
-// Cost per operation
-const getRequestUnits = (operation) => {
-  switch (operation) {
-    case "GET":
-      return 1;
-    case "POST":
-      return 10;
-    case "PUT":
-      return 10;
-    default:
-      return 10;
-  }
-};
+const operationUnits = { GET: 1, POST: 10, PUT: 10 };
+const getRequestUnits = (operation) => operationUnits[operation] || 10;
 
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
 class LightspeedRetailSDK {
+  static BASE_URL = "https://api.lightspeedapp.com/API/V3/Account";
+  static TOKEN_URL = "https://cloud.lightspeedapp.com/oauth/access_token.php";
+
   constructor(opts) {
     const { clientID, clientSecret, refreshToken, accountID } = opts;
 
@@ -24,23 +16,50 @@ class LightspeedRetailSDK {
     this.clientSecret = clientSecret;
     this.refreshToken = refreshToken;
     this.accountID = accountID;
-    this.baseUrl = "https://api.lightspeedapp.com/API/V3/Account";
+    this.baseUrl = LightspeedRetailSDK.BASE_URL;
+    this.tokenUrl = LightspeedRetailSDK.TOKEN_URL;
     this.maxRetries = 3;
     this.lastResponse = null;
+    this.token = null;
+    this.tokenExpiry = null;
   }
 
-  handleError(msg, err) {
-    console.error(`${msg} - ${err}`);
-    throw err;
+  // handleError function to handle errors
+  handleError(context, err, shouldThrow = true) {
+    // Context includes information about where the error occurred
+    const detailedMessage = `Error in ${context}: ${err.message}`;
+
+    // Log the error message
+    console.error(detailedMessage);
+
+    // Log the stack trace if available
+    if (err.stack) {
+      console.error("Stack trace:", err.stack);
+    }
+
+    // If the error has response data, log it
+    if (err.response) {
+      console.error("Error response:", {
+        status: err.response.status,
+        headers: err.response.headers,
+        data: err.response.data,
+      });
+    }
+
+    // Optionally rethrow the error with the detailed message
+    if (shouldThrow) {
+      throw new Error(detailedMessage);
+    }
   }
 
+  // Update the last response
   setLastResponse = (response) => (this.lastResponse = response);
 
+  // Handle rate limits
   handleRateLimit = async (options) => {
     if (!this.lastResponse) return null;
 
     const { method } = options;
-
     const requestUnits = getRequestUnits(method);
     const rateHeader = this.lastResponse.headers["x-ls-api-bucket-level"];
 
@@ -50,7 +69,13 @@ class LightspeedRetailSDK {
     const availableUnits = available - used;
     if (requestUnits <= availableUnits) return 0;
 
-    const dripRate = this.lastResponse.headers["x-ls-api-drip-rate"];
+    const dripRate = parseInt(this.lastResponse.headers["x-ls-api-drip-rate"], 10);
+
+    // Check if dripRate is a valid number greater than 0
+    if (isNaN(dripRate) || dripRate <= 0) {
+      this.handleError.error("Invalid drip rate received from API");
+    }
+
     const unitWait = requestUnits - availableUnits;
     const delay = Math.ceil((unitWait / dripRate) * 1000);
     await sleep(delay);
@@ -58,7 +83,17 @@ class LightspeedRetailSDK {
     return unitWait;
   };
 
+  // Get a new token
   getToken = async () => {
+    const now = new Date();
+    const bufferTime = 1 * 60 * 1000; // 1 minute buffer
+
+    // Check if the token exists and is still valid
+    if (this.token && this.tokenExpiry.getTime() - now.getTime() > bufferTime) {
+      return this.token;
+    }
+
+    // Fetch a new token if needed
     const body = {
       grant_type: "refresh_token",
       client_id: this.clientID,
@@ -66,68 +101,94 @@ class LightspeedRetailSDK {
       refresh_token: this.refreshToken,
     };
 
-    const response = await axios({
-      url: "https://cloud.lightspeedapp.com/oauth/access_token.php",
-      method: "post",
-      headers: {
-        "Content-Type": "application/json",
-      },
-      data: JSON.stringify(body),
-    }).catch((error) => console.error(error.data));
-
-    const tokenData = await response.data;
-    const token = tokenData.access_token;
-
-    return token;
+    try {
+      const response = await axios({
+        url: this.tokenUrl,
+        method: "post",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        data: JSON.stringify(body),
+      });
+
+      const tokenData = await response.data;
+
+      // Set token and expiry time
+      this.token = tokenData.access_token;
+      this.tokenExpiry = new Date(now.getTime() + tokenData.expires_in * 1000);
+
+      return this.token;
+    } catch (error) {
+      return this.handleError("GET TOKEN ERROR", error);
+    }
   };
 
-  getResource = async (options, retries = 0) => {
-    this.handleRateLimit(options);
+  // Fetch a resource
+  executeApiRequest = async (options, retries = 0) => {
+    await this.handleRateLimit(options);
 
     const token = await this.getToken();
-
     if (!token) throw new Error("Error Fetching Token");
 
+    // Set common headers
     options.headers = {
       Authorization: `Bearer ${token}`,
       "Content-Type": "application/json",
+      ...options.headers, // Merge with any additional headers passed in options
     };
 
     try {
       const res = await axios(options);
       this.lastResponse = res;
-      return {
-        data: res.data,
-        next: res.next,
-        previous: res.previous,
-      };
+
+      // Return the data
+      if (options.method === "GET") {
+        return {
+          data: res.data,
+          next: res.next,
+          previous: res.previous,
+        };
+      } else {
+        return res.data; // For POST and PUT, typically just return the data
+      }
     } catch (err) {
-      if (retries < this.maxRetries) {
-        console.log(`Error: ${err}, retrying in 2 seconds...`);
-        await new Promise((resolve) => setTimeout(resolve, 2000));
-        return await this.getResource(options.url, retries + 1);
+      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 {
-        console.error(`Failed Request statusText: `, res.statusText);
-        console.log(`Failed data: `, response.data);
+        this.handleError(`Failed Request statusText: ${err.response?.statusText}`);
+        this.handleError(`Failed data: ${err.response?.data}`);
         throw err;
       }
     }
   };
 
+  // Get paginated data
   async getAllData(options) {
     let allData = [];
     while (options.url) {
-      const { data } = await this.getResource(options);
+      const { data } = await this.executeApiRequest(options);
       let next = data["@attributes"].next;
       let selectDataArray = Object.keys(data)[1];
       let selectedData = data[selectDataArray];
       allData = allData.concat(selectedData);
       options.url = next;
     }
-    // console.log(allData);
     return allData;
   }
 
+  // Check if error is retryable
+  isRetryableError = (err) => {
+    if (!err.response) {
+      // No response (network error or timeout)
+      return true;
+    }
+
+    // Retry for server errors (500-599)
+    return err.response.status >= 500 && err.response.status <= 599;
+  };
+
   // Get customer by ID
   async getCustomer(id, relations) {
     const options = {

package/package.json

@@ -1,22 +1,25 @@
 {
   "name": "lightspeed-retail-sdk",
-  "version": "2.0.6",
+  "version": "2.0.8",
   "description": "Another unofficial Lightspeed Retail API SDK for Node.js",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+  "type": "module",
+  "main": "index.cjs",
+  "module": "index.mjs",
+  "exports": {
+    ".": {
+      "require": "./index.cjs",
+      "default": "./index.mjs"
+    }
   },
-  "author": "@morley_darryl",
+  "author": "https://github.com/darrylmorley",
   "license": "ISC",
   "dependencies": {
     "axios": "^1.3.4",
-    "qs": "^6.11.1",
-    "retry": "^0.13.1"
+    "dotenv": "^16.4.4"
   },
-  "type": "module",
   "repository": {
     "type": "git",
-    "url": "https://github.com/darrylmorley/lightspeed-retail-sdk"
+    "url": "git+https://github.com/darrylmorley/lightspeed-retail-sdk.git"
   },
   "keywords": [
     "lightspeed retail",