Fix API endpoint structure and add version flexibility to HR Cloud component

Author: dannyroosevelt

components/hr_cloud/README.md

@@ -9,3 +9,13 @@ To use this integration, you'll need an HR Cloud account and an API key. To get
 1. Log in to your HR Cloud account
 2. Navigate to Settings > API Settings
 3. Create a new API key or use an existing one
+
+# API URL Structure
+
+This integration uses the HR Cloud API. If you encounter 404 errors, please confirm the correct API URL structure with your HR Cloud documentation, as it may vary depending on your account setup. The integration supports the following formats:
+
+- https://api.hrcloud.com/api/... (default)
+- https://api.hrcloud.com/v1/api/... (older accounts) 
+- https://api.hrcloud.com/v2/api/... (newer accounts)
+
+If you continue to encounter 404 errors, please contact HR Cloud support to confirm your API URL structure.

components/hr_cloud/hr_cloud.app.mjs

@@ -4,6 +4,13 @@ export default {
   type: "app",
   app: "hr_cloud",
   propDefinitions: {
+    apiVersion: {
+      type: "string",
+      label: "API Version",
+      description: "The HR Cloud API version to use. Leave empty to use the default version.",
+      default: "",
+      optional: true,
+    },
     departmentId: {
       type: "string",
       label: "Department",
@@ -147,7 +154,15 @@ export default {
   },
   methods: {
     _baseUrl() {
-      return "https://api.hrcloud.com/v1";
+      // Default to base URL without version
+      const baseUrl = "https://api.hrcloud.com";
+
+      // If a version is specified in the app props, use it
+      if (this.$auth.apiVersion) {
+        return `${baseUrl}/${this.$auth.apiVersion}`;
+      }
+
+      return baseUrl;
     },
     _authHeaders() {
       return {
@@ -169,14 +184,25 @@ export default {
         params,
         data,
       };
-      return axios($, config);
+
+      try {
+        console.log(`Making request to: ${config.url}`);
+        const response = await axios($, config);
+        return response;
+      } catch (error) {
+        console.error(`Error with request to ${path}: ${error.message}`);
+        if (error.response?.status === 404) {
+          throw new Error(`API endpoint not found (404): ${path}. Please verify the API URL structure in the HR Cloud documentation.`);
+        }
+        throw error;
+      }
     },
     async createWebhook({
       eventType, endpoint, metadata,
     }) {
       return this._makeRequest({
         method: "POST",
-        path: "/webhooks",
+        path: "/api/webhooks",
         data: {
           event_type: eventType,
           endpoint,
@@ -187,83 +213,83 @@ export default {
     async deleteWebhook(webhookId) {
       return this._makeRequest({
         method: "DELETE",
-        path: `/webhooks/${webhookId}`,
+        path: `/api/webhooks/${webhookId}`,
       });
     },
     async getEmployees(args = {}) {
       const response = await this._makeRequest({
-        path: "/employees",
+        path: "/api/employees",
         ...args,
       });
       return response.employees || [];
     },
     async getEmployee(employeeId, args = {}) {
       const response = await this._makeRequest({
-        path: `/employees/${employeeId}`,
+        path: `/api/employees/${employeeId}`,
         ...args,
       });
       return response.employee;
     },
     async createEmployee(args = {}) {
       return this._makeRequest({
         method: "POST",
-        path: "/employees",
+        path: "/api/employees",
         ...args,
       });
     },
     async getDepartments(args = {}) {
       const response = await this._makeRequest({
-        path: "/departments",
+        path: "/api/departments",
         ...args,
       });
       return response.departments || [];
     },
     async getJobTitles(args = {}) {
       const response = await this._makeRequest({
-        path: "/job-titles",
+        path: "/api/job-titles",
         ...args,
       });
       return response.job_titles || [];
     },
     async getLeaveRequests(args = {}) {
       const response = await this._makeRequest({
-        path: "/leave-requests",
+        path: "/api/leave-requests",
         ...args,
       });
       return response.leave_requests || [];
     },
     async getLeaveTypes(args = {}) {
       const response = await this._makeRequest({
-        path: "/leave-types",
+        path: "/api/leave-types",
         ...args,
       });
       return response.leave_types || [];
     },
     async approveLeaveRequest(requestId, args = {}) {
       return this._makeRequest({
         method: "PUT",
-        path: `/leave-requests/${requestId}/approve`,
+        path: `/api/leave-requests/${requestId}/approve`,
         ...args,
       });
     },
     async getProjects(args = {}) {
       const response = await this._makeRequest({
-        path: "/projects",
+        path: "/api/projects",
         ...args,
       });
       return response.projects || [];
     },
     async getTimesheetEntries(args = {}) {
       const response = await this._makeRequest({
-        path: "/timesheet-entries",
+        path: "/api/timesheet-entries",
         ...args,
       });
       return response.timesheet_entries || [];
     },
     async createTimesheetEntry(args = {}) {
       return this._makeRequest({
         method: "POST",
-        path: "/timesheet-entries",
+        path: "/api/timesheet-entries",
         ...args,
       });
     },