Hostaway new action

Author: GTFalcao

components/hostaway/actions/create-reservation/create-reservation.mjs

@@ -0,0 +1,74 @@
+import hostaway from "../../hostaway.app.mjs";
+
+export default {
+  key: "hostaway-create-reservation",
+  name: "Create Reservation",
+  description: "Creates a new reservation in Hostaway. [See the documentation](https://api.hostaway.com/documentation#create-a-reservation)",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    hostaway,
+    channelId: {
+      propDefinition: [
+        hostaway,
+        "channelId",
+      ],
+    },
+    listingMapId: {
+      propDefinition: [
+        hostaway,
+        "listingId",
+      ],
+    },
+    arrivalDate: {
+      type: "string",
+      label: "Arrival Date",
+      description: "Arrival date in `YYYY-MM-DD` format, e.g. `2024-08-15`",
+    },
+    departureDate: {
+      type: "string",
+      label: "Departure Date",
+      description: "Departure date in `YYYY-MM-DD` format, e.g. `2024-08-19`",
+    },
+    guestName: {
+      type: "string",
+      label: "Guest Name",
+      description: "Name of the guest",
+      optional: true,
+    },
+    guestEmail: {
+      type: "string",
+      label: "Guest Email",
+      description: "Email address of the guest",
+      optional: true,
+    },
+    numberOfGuests: {
+      type: "integer",
+      label: "Number of Guests",
+      description: "Number of guests for the reservation",
+      optional: true,
+    },
+    additionalFields: {
+      type: "object",
+      label: "Additional Fields",
+      description: "Additional fields to set for the reservation. [See the documentation](https://api.hostaway.com/documentation#reservation-object) for all available fields.",
+      optional: true,
+    }
+  },
+  async run({ $ }) {
+    const { hostaway, additionalFields = {}, ...data } = this;
+    const { result } = await hostaway.createReservation({
+      $,
+      data: {
+        ...data,
+        ...additionalFields
+      },
+    });
+
+    if (result?.id) {
+      $.export("summary", `Successfully created reservation (ID: ${result.id})`);
+    }
+
+    return result;
+  },
+};

components/hostaway/common/constants.mjs

@@ -42,9 +42,28 @@ const COMMUNICATION_TYPES = [
   "whatsapp",
 ];
 
+const CHANNEL_OPTIONS = [
+  { value: 2018, label: "airbnbOfficial", },
+{ value: 2002, label: "homeaway", },
+{ value: 2005, label: "bookingcom", },
+{ value: 2007, label: "expedia", },
+{ value: 2009, label: "homeawayical", },
+{ value: 2010, label: "vrboical", },
+{ value: 2000, label: "direct", },
+{ value: 2013, label: "bookingengine", },
+{ value: 2015, label: "customIcal", },
+{ value: 2016, label: "tripadvisorical", },
+{ value: 2017, label: "wordpress", },
+{ value: 2019, label: "marriott", },
+{ value: 2020, label: "partner", },
+{ value: 2021, label: "gds", },
+{ value: 2022, label: "google", },
+]
+
 export default {
   DEFAULT_LIMIT,
   CATEGORIES,
   TASK_STATUS,
   COMMUNICATION_TYPES,
+  CHANNEL_OPTIONS,
 };

components/hostaway/hostaway.app.mjs

@@ -118,6 +118,12 @@ export default {
         })) || [];
       },
     },
+    channelId: {
+      type: "integer",
+      label: "Channel",
+      description: "Identifier of the channel",
+      options: constants.CHANNEL_OPTIONS
+    },
   },
   methods: {
     _baseUrl() {
@@ -211,5 +217,12 @@ export default {
         ...args,
       });
     },
+    createReservation(args = {}) {
+      return this._makeRequest({
+        path: "/reservations",
+        method: "POST",
+        ...args,
+      });
+    }
   },
 };