Refactor Xero Accounting API actions for improved error handling and consistency. Key changes include:

- Updated API request methods to use consistent casing for paths (e.g., `/Contacts` and `/Invoices`).
- Enhanced error handling in actions to provide clearer feedback when no results are found.
- Removed deprecated `find-contact` action and streamlined contact-related actions.
- Bumped versions for several actions to reflect updates and improvements.

These changes enhance the reliability and maintainability of the Xero Accounting API integration.

Author: luancazarine

components/xero_accounting_api/actions/create-bank-transaction/create-bank-transaction.mjs

@@ -116,10 +116,11 @@ export default {
     },
   },
   async run({ $ }) {
-    if ((!this.bankAccountCode && !this.bankAccountId)
-    || (!this.contactId && !this.contactName)
-    || !this.tenantId || !this.type || !this.lineItems) {
-      throw new ConfigurationError("Must provide one of **Bank Account Code** or **Bank Account ID**, **Contact ID** or **Contact Name**, **Tenant ID**, **Type**, and **Line Items** parameters.");
+    if (!this.bankAccountCode && !this.bankAccountId) {
+      throw new ConfigurationError("Must provide one of **Bank Account Code** or **Bank Account ID** parameters.");
+    }
+    if (!this.contactId && !this.contactName) {
+      throw new ConfigurationError("Must provide one of **Contact ID** or **Contact Name** parameters.");
     }
 
     const response = await this.xeroAccountingApi.createBankTransaction({

components/xero_accounting_api/actions/create-tracking-category/create-tracking-category.mjs

@@ -38,18 +38,20 @@ export default {
         },
       });
 
-      const parsedOptions = parseObject(this.options);
+      if (this.options) {
+        const parsedOptions = parseObject(this.options);
 
-      for (const option of parsedOptions) {
-        const optionResponse = await this.xeroAccountingApi.createTrackingOption({
-          $,
-          tenantId: this.tenantId,
-          trackingCategoryId: response.TrackingCategories[0].TrackingCategoryID,
-          data: {
-            Name: option,
-          },
-        });
-        response.TrackingCategories[0].Options.push(optionResponse.Options[0]);
+        for (const option of parsedOptions) {
+          const optionResponse = await this.xeroAccountingApi.createTrackingOption({
+            $,
+            tenantId: this.tenantId,
+            trackingCategoryId: response.TrackingCategories[0].TrackingCategoryID,
+            data: {
+              Name: option,
+            },
+          });
+          response.TrackingCategories[0].Options.push(optionResponse.Options[0]);
+        }
       }
 
       $.export("$summary", `Successfully created tracking category with ID: ${response.TrackingCategories[0].TrackingCategoryID}`);

components/xero_accounting_api/actions/create-update-contact/create-update-contact.mjs

@@ -1,11 +1,12 @@
+import { ConfigurationError } from "@pipedream/platform";
 import { removeNullEntries } from "../../common/util.mjs";
 import xeroAccountingApi from "../../xero_accounting_api.app.mjs";
 
 export default {
   key: "xero_accounting_api-create-update-contact",
   name: "Create or update contact ",
   description: "Creates a new contact or updates a contact if a contact already exists. [See the docs here](https://developer.xero.com/documentation/api/accounting/contacts)",
-  version: "0.0.3",
+  version: "0.1.0",
   type: "action",
   props: {
     xeroAccountingApi,
@@ -15,15 +16,11 @@ export default {
         "tenantId",
       ],
     },
-    actionType: {
-      label: "Type of action",
-      description: "This triggers an update if UPDATE is selected",
+    contactID: {
       type: "string",
-      options: [
-        "NEW",
-        "UPDATE",
-      ],
-      reloadProps: true,
+      label: "Contact ID",
+      description: "ID of the contact that requires update.",
+      optional: true,
     },
     name: {
       type: "string",
@@ -68,18 +65,10 @@ export default {
       default: "ACTIVE",
     },
   },
-  async additionalProps() {
-    const props = {};
-    if (this.actionType === "UPDATE") {
-      props.contactID = {
-        type: "string",
-        label: "Contact ID",
-        description: "ID of the contact that requires update.",
-      };
-    }
-    return props;
-  },
   async run({ $ }) {
+    if (!this.contactID && !this.name) {
+      throw new ConfigurationError("Must provide **Contact ID** or **Contact Name** parameter.");
+    }
     const {
       contactID,
       tenantId,
@@ -99,7 +88,7 @@ export default {
       ContactStatus: contactStatus,
     });
     contactID && (data.ContactID = contactID);
-    const response = await this.xeroAccountingApi.createContact({
+    const response = await this.xeroAccountingApi.createOrUpdateContact({
       $,
       tenantId,
       data,

components/xero_accounting_api/actions/download-invoice/download-invoice.mjs

@@ -37,6 +37,9 @@ export default {
       tenantId: this.tenantId,
       invoiceId: this.invoiceId,
       responseType: "arraybuffer",
+      headers: {
+        Accept: "application/pdf",
+      },
     });
 
     const invoicePdf = data.toString("base64");