new components

Author: michelle0927

components/hullo/actions/add-update-member/add-update-member.mjs

@@ -3,27 +3,100 @@ import hullo from "../../hullo.app.mjs";
 export default {
   key: "hullo-add-update-member",
   name: "Add or Update Member",
-  description: "Adds a new member or updates an existing member's data in Hullo",
-  version: "0.0.{{ts}}",
+  description: "Adds a new member or updates an existing member's data in Hullo. [See the documentation](https://app.hullo.me/docs/index.html#?route=post-/endpoints/members)",
+  version: "0.0.1",
   type: "action",
   props: {
     hullo,
-    memberId: {
+    phoneNumber: {
       propDefinition: [
         hullo,
-        "memberId",
+        "phoneNumber",
       ],
     },
-    memberInfo: {
+    fullName: {
+      type: "string",
+      label: "Full Name",
+      description: "The full name of the member. REQUIRED if creating a new member.",
+      optional: true,
+    },
+    registrationDate: {
+      type: "string",
+      label: "Registration Date",
+      description: "The date the member was registered in ISO-8601 format. Example: `2000-01-23T04:56:07.000+00:00`",
+      optional: true,
+    },
+    groups: {
+      type: "string[]",
+      label: "Groups",
+      description: "An array containing the names of groups this member belongs to",
+      optional: true,
+    },
+    attributes: {
       propDefinition: [
         hullo,
-        "memberInfo",
+        "attributes",
       ],
+      reloadProps: true,
+    },
+  },
+  async additionalProps() {
+    const props = {};
+    if (!this.attributes?.length) {
+      return props;
+    }
+    for (const attribute of this.attributes) {
+      props[attribute] = {
+        type: "string",
+        label: attribute,
+        description: `Value for ${attribute}`,
+      };
+    }
+    return props;
+  },
+  methods: {
+    async formatAttributes(attributeKeys, attributeValues) {
+      const attributes = await this.hullo.listAttributes();
+      const formattedAttributes = {};
+      for (const key of attributeKeys) {
+        const { type } = attributes.find(({ name }) => name === key);
+        const value = type === "NUMBER"
+          ? +attributeValues[key]
+          : type === "LIST"
+            ? JSON.parse(attributeValues[key])
+            : attributeValues[key];
+        formattedAttributes[key] = [
+          value,
+        ];
+      }
+      return formattedAttributes;
     },
   },
   async run({ $ }) {
-    const response = await this.hullo.addOrUpdateMember(this.memberId, this.memberInfo);
-    $.export("$summary", `Successfully added or updated member with ID ${this.memberId}`);
+    const {
+      hullo,
+      formatAttributes,
+      phoneNumber,
+      fullName,
+      registrationDate,
+      groups,
+      attributes,
+      ...attributeValues
+    } = this;
+
+    const response = await hullo.addOrUpdateMember({
+      $,
+      data: {
+        phoneNumber,
+        fullName,
+        registrationDate,
+        groups,
+        attributes: attributes?.length
+          ? await formatAttributes(attributes, attributeValues)
+          : undefined,
+      },
+    });
+    $.export("$summary", `Successfully added or updated member with phone number ${this.phoneNumber}`);
     return response;
   },
 };

components/hullo/actions/send-message/send-message.mjs

@@ -3,27 +3,32 @@ import hullo from "../../hullo.app.mjs";
 export default {
   key: "hullo-send-message",
   name: "Send Message",
-  description: "Sends a personalized message to a Hullo member.",
-  version: "0.0.{{ts}}",
+  description: "Sends a personalized message to a Hullo member. [See the documentation](https://app.hullo.me/docs/index.html#?route=post-/endpoints/messages)",
+  version: "0.0.1",
   type: "action",
   props: {
     hullo,
-    memberId: {
+    phoneNumber: {
       propDefinition: [
         hullo,
-        "memberId",
+        "phoneNumber",
       ],
     },
-    messageContent: {
-      propDefinition: [
-        hullo,
-        "messageContent",
-      ],
+    messageText: {
+      type: "string",
+      label: "Message Text",
+      description: "The message text to send. Min length: 1, Max length: 640",
     },
   },
   async run({ $ }) {
-    const response = await this.hullo.sendMessage(this.memberId, this.messageContent);
-    $.export("$summary", `Successfully sent message to member with ID: ${this.memberId}`);
+    const response = await this.hullo.sendMessage({
+      $,
+      data: {
+        phoneNumber: this.phoneNumber,
+        messageText: this.messageText,
+      },
+    });
+    $.export("$summary", `Successfully sent message to member with phone number: ${this.phoneNumber}`);
     return response;
   },
 };

components/hullo/hullo.app.mjs

@@ -4,58 +4,58 @@ export default {
   type: "app",
   app: "hullo",
   propDefinitions: {
-    memberId: {
-      type: "string",
-      label: "Member ID",
-      description: "The ID of the Hullo member",
+    attributes: {
+      type: "string[]",
+      label: "Attributes",
+      description: "The attributes that describe the member",
+      optional: true,
+      async options() {
+        const attributes = await this.listAttributes();
+        return attributes?.map(({ name }) => name ) || [];
+      },
     },
-    messageContent: {
+    phoneNumber: {
       type: "string",
-      label: "Message Content",
-      description: "The content of the message to send",
-    },
-    memberInfo: {
-      type: "object",
-      label: "Member Info",
-      description: "Details of the member such as name, email, etc.",
+      label: "Phone Number",
+      description: "The phone number of the member",
     },
   },
   methods: {
     _baseUrl() {
-      return "https://app.hullo.me/api";
+      return "https://app.hullo.me/api/endpoints";
     },
-    async _makeRequest(opts = {}) {
+    _makeRequest(opts = {}) {
       const {
         $ = this,
-        method = "GET",
         path,
-        headers,
         ...otherOpts
       } = opts;
       return axios($, {
         ...otherOpts,
-        method,
-        url: this._baseUrl() + path,
+        url: `${this._baseUrl()}${path}`,
         headers: {
-          ...headers,
-          Authorization: `Bearer ${this.$auth.api_token}`,
+          "X-API-KEY": `${this.$auth.api_key}`,
         },
       });
     },
-    async sendMessage(memberId, messageContent) {
+    listAttributes(opts = {}) {
+      return this._makeRequest({
+        path: "/attributes",
+        ...opts,
+      });
+    },
+    sendMessage(opts = {}) {
       return this._makeRequest({
         method: "POST",
-        path: `/members/${memberId}/messages`,
-        data: {
-          content: messageContent,
-        },
+        path: "/messages",
+        ...opts,
       });
     },
-    async addOrUpdateMember(memberId, memberInfo) {
+    addOrUpdateMember(opts = {}) {
       return this._makeRequest({
-        method: "PUT",
-        path: `/members/${memberId}`,
-        data: memberInfo,
+        method: "POST",
+        path: "/members",
+        ...opts,
       });
     },
   },

components/hullo/package.json

@@ -11,5 +11,8 @@
   "author": "Pipedream <[email protected]> (https://pipedream.com/)",
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "@pipedream/platform": "^3.0.3"
   }
-}
+}