@pipedream/evenium 0.6.0 → 0.7.0

package/actions/add-participants/add-participants.mjs

@@ -0,0 +1,92 @@
+import {
+  PARTICIPANT_GENDER_OPTIONS,
+  PARTICIPANT_STATUS_OPTIONS,
+} from "../../common/constants.mjs";
+import app from "../../evenium.app.mjs";
+
+export default {
+  type: "action",
+  key: "evenium-add-participants",
+  version: "0.0.1",
+  name: "Add Participants",
+  description: "Adds participants (guests) to an event. [See the documentation](https://static.evenium.com/api-docs/organizer/index-json.html#5.3)",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: false,
+  },
+  props: {
+    app,
+    eventId: {
+      propDefinition: [
+        app,
+        "eventId",
+      ],
+    },
+    firstName: {
+      type: "string",
+      label: "First Name",
+      description: "The first name of the participant",
+    },
+    lastName: {
+      type: "string",
+      label: "Last Name",
+      description: "The last name of the participant",
+    },
+    email: {
+      type: "string",
+      label: "Email",
+      description: "The email address of the participant",
+    },
+    company: {
+      type: "string",
+      label: "Company",
+      description: "The company name of the participant",
+      optional: true,
+    },
+    gender: {
+      type: "string",
+      label: "Gender",
+      description: "The gender of the participant",
+      optional: true,
+      options: PARTICIPANT_GENDER_OPTIONS,
+    },
+    status: {
+      type: "string",
+      label: "Status",
+      description: "The registration status of the participant",
+      optional: true,
+      options: PARTICIPANT_STATUS_OPTIONS,
+    },
+  },
+  async run({ $ }) {
+    const guestData = {
+      firstName: this.firstName,
+      lastName: this.lastName,
+      email: this.email,
+    };
+
+    if (this.company) {
+      guestData.company = this.company;
+    }
+
+    if (this.gender) {
+      guestData.gender = this.gender;
+    }
+
+    if (this.status) {
+      guestData.status = this.status;
+    }
+
+    const response = await this.app.createGuest({
+      $,
+      eventId: this.eventId,
+      data: guestData,
+    });
+
+    $.export("$summary", `Successfully added participant "**${this.firstName} ${this.lastName}**" with \`guestId\`: ${response.guestId}`);
+
+    return response;
+  },
+};
+

package/actions/create-event/create-event.mjs

@@ -0,0 +1,84 @@
+import app from "../../evenium.app.mjs";
+
+export default {
+  type: "action",
+  key: "evenium-create-event",
+  version: "0.0.1",
+  name: "Create Event",
+  description: "Creates a new event. [See the documentation](https://static.evenium.com/api-docs/organizer/index-json.html#_create_events)",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: false,
+  },
+  props: {
+    app,
+    title: {
+      type: "string",
+      label: "Title",
+      description: "The title of the event",
+    },
+    startDate: {
+      type: "string",
+      label: "Start Date",
+      description: "The start date of the event in RFC 3339 format (e.g., 2010-07-10T07:00:00.000Z)",
+    },
+    endDate: {
+      type: "string",
+      label: "End Date",
+      description: "The end date of the event in RFC 3339 format (e.g., 2010-07-12T17:00:00.000Z)",
+    },
+    description: {
+      type: "string",
+      label: "Description",
+      description: "The description of the event",
+      optional: true,
+    },
+    addressName: {
+      type: "string",
+      label: "Address Name",
+      description: "The name of the address",
+      optional: true,
+    },
+    addressStreet: {
+      type: "string",
+      label: "Address Street",
+      description: "The street of the address",
+      optional: true,
+    },
+    addressCity: {
+      type: "string",
+      label: "Address City",
+      description: "The city of the address",
+      optional: true,
+    },
+    addressCountryCode: {
+      type: "string",
+      label: "Address Country Code",
+      description: "The country code of the address",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const response = await this.app.createEvent({
+      $,
+      data: {
+        title: this.title,
+        startDate: this.startDate,
+        endDate: this.endDate,
+        description: this.description,
+        location: {
+          name: this.addressName,
+          street: this.addressStreet,
+          city: this.addressCity,
+          countryCode: this.addressCountryCode,
+        },
+      },
+    });
+
+    $.export("$summary", `Successfully created event with ID: ${response.id}`);
+
+    return response;
+  },
+};
+

package/common/constants.mjs

@@ -0,0 +1,43 @@
+export const LIMIT = 100;
+
+export const PARTICIPANT_STATUS_OPTIONS = [
+  {
+    label: "Unanswered",
+    value: "UNANSWERED",
+  },
+  {
+    label: "Pending",
+    value: "PENDING",
+  },
+  {
+    label: "Valid",
+    value: "VALID",
+  },
+  {
+    label: "Reserved",
+    value: "RESERVED",
+  },
+  {
+    label: "Confirmed",
+    value: "CONFIRMED",
+  },
+  {
+    label: "Declined",
+    value: "DECLINED",
+  },
+  {
+    label: "Canceled",
+    value: "CANCELED",
+  },
+];
+
+export const PARTICIPANT_GENDER_OPTIONS = [
+  {
+    label: "Male",
+    value: "MALE",
+  },
+  {
+    label: "Female",
+    value: "FEMALE",
+  },
+];

package/evenium.app.mjs

@@ -1,11 +1,111 @@
+import { axios } from "@pipedream/platform";
+import { LIMIT } from "./common/constants.mjs";
+
 export default {
   type: "app",
   app: "evenium",
-  propDefinitions: {},
+  propDefinitions: {
+    eventId: {
+      type: "string",
+      label: "Event ID",
+      description: "The ID of the event",
+      async options({ page }) {
+        const { events } = await this.listEvents({
+          params: {
+            firstResult: (page - 1) * LIMIT,
+            maxResults: LIMIT,
+          },
+        });
+
+        return events?.map((event) => ({
+          label: `${event.title} (${event.id})`,
+          value: event.id,
+        })) || [];
+      },
+    },
+  },
   methods: {
-    // this.$auth contains connected account data
-    authKeys() {
-      console.log(Object.keys(this.$auth));
+    _baseUrl() {
+      return "https://evenium.com/api/1";
+    },
+    _getHeaders(headers = {}) {
+      return {
+        "X-Evenium-Token": this.$auth.access_token,
+        "Content-Type": "application/json",
+        "Accept": "application/json",
+        ...headers,
+      };
+    },
+    _makeRequest({
+      $ = this, path, headers, ...otherConfig
+    } = {}) {
+      return axios($, {
+        url: `${this._baseUrl()}${path}`,
+        headers: this._getHeaders(headers),
+        ...otherConfig,
+      });
+    },
+    createEvent({
+      data, ...opts
+    } = {}) {
+      return this._makeRequest({
+        method: "POST",
+        path: "/events",
+        data,
+        ...opts,
+      });
+    },
+    listEvents(opts = {}) {
+      return this._makeRequest({
+        path: "/events",
+        ...opts,
+      });
+    },
+    createGuest({
+      eventId, ...opts
+    } = {}) {
+      return this._makeRequest({
+        method: "POST",
+        path: `/events/${eventId}/guests`,
+        ...opts,
+      });
+    },
+    listGuests({
+      eventId, ...opts
+    } = {}) {
+      return this._makeRequest({
+        path: `/events/${eventId}/guests`,
+        ...opts,
+      });
+    },
+    async *paginate({
+      fn, params = {}, maxResults = null, dataField, ...opts
+    }) {
+      let hasMore = false;
+      let count = 0;
+      let page = 0;
+
+      do {
+        params.firstResult = page * LIMIT;
+        params.maxResults = LIMIT;
+
+        const {
+          [dataField]: data,
+          more,
+        } = await fn({
+          params,
+          ...opts,
+        });
+
+        for (const d of data || []) {
+          yield d;
+
+          if (maxResults && ++count === maxResults) {
+            return count;
+          }
+        }
+        hasMore = more;
+      } while (hasMore);
     },
   },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/evenium",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Pipedream evenium Components",
   "main": "evenium.app.mjs",
   "keywords": [
@@ -13,6 +13,6 @@
     "access": "public"
   },
   "dependencies": {
-    "@pipedream/platform": "^3.0.0"
+    "@pipedream/platform": "^3.1.1"
   }
 }

package/sources/common/base-polling.mjs

@@ -0,0 +1,74 @@
+import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";
+import evenium from "../../evenium.app.mjs";
+
+export default {
+  props: {
+    evenium,
+    db: "$.service.db",
+    timer: {
+      type: "$.interface.timer",
+      default: {
+        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
+      },
+    },
+  },
+  methods: {
+    _getLastDate() {
+      return this.db.get("lastDate");
+    },
+    _setLastDate(lastDate) {
+      this.db.set("lastDate", lastDate);
+    },
+    getFieldId() {
+      throw new Error("getFieldId is not implemented");
+    },
+    getFunction() {
+      throw new Error("getFunction is not implemented");
+    },
+    getDataField() {
+      throw new Error("getDataField is not implemented");
+    },
+    getArgs() {
+      return {};
+    },
+    async processEvents(maxResults = false) {
+      const lastDate = this._getLastDate();
+      const fields = this.getFields();
+      const response = this.evenium.paginate({
+        fn: this.getFunction(),
+        ...this.getArgs(),
+        dataField: fields.data,
+        params: {
+          [fields.filter]: lastDate,
+          maxResults,
+        },
+      });
+
+      const responseArray = [];
+      for await (const item of response) {
+        responseArray.push(item);
+      }
+
+      if (responseArray.length) {
+        this._setLastDate(responseArray[0][fields.date]);
+      }
+
+      for (const result of responseArray.reverse()) {
+        this.$emit(result, {
+          id: result[fields.id],
+          summary: this.getSummary(result),
+          ts: Date.parse(result[fields.date]),
+        });
+      }
+    },
+  },
+  hooks: {
+    async deploy() {
+      await this.processEvents(10);
+    },
+  },
+  async run() {
+    await this.processEvents();
+  },
+};
+

package/sources/new-event/new-event.mjs

@@ -0,0 +1,31 @@
+import common from "../common/base-polling.mjs";
+import sampleEmit from "./test-event.mjs";
+
+export default {
+  ...common,
+  key: "evenium-new-event",
+  name: "New Event",
+  description: "Emit new event when a new event is created. [See the documentation](https://static.evenium.com/api-docs/organizer/index-json.html#_get_all_events)",
+  version: "0.0.1",
+  type: "source",
+  dedupe: "unique",
+  methods: {
+    ...common.methods,
+    getFields() {
+      return {
+        data: "events",
+        filter: "createdAfter",
+        date: "creationDate",
+        id: "id",
+      };
+    },
+    getSummary(result) {
+      return `New Event: ${result.title}`;
+    },
+    getFunction() {
+      return this.evenium.listEvents;
+    },
+  },
+  sampleEmit,
+};
+

package/sources/new-event/test-event.mjs

@@ -0,0 +1,10 @@
+export default {
+  "id": "16083",
+  "title": "Colloque : valoriser et transférer les résultats de la recherche",
+  "description": "Séjour au Club Med la Palmyre 600 personnes Anniversaire des 15 ans de la société Arval Phh",
+  "startDate": "2010-06-28T08:00:00.000+02:00",
+  "endDate": "2010-06-31T18:00:00.000+02:00",
+  "creationDate": "2010-04-02T13:02:51.000+02:00",
+  "status": "OPEN",
+  "url": "/site/colloque-valoriser-et-transferer-les-resultats-de-larecherche"
+}

package/sources/new-participant/new-participant.mjs

@@ -0,0 +1,44 @@
+import common from "../common/base-polling.mjs";
+import sampleEmit from "./test-event.mjs";
+
+export default {
+  ...common,
+  key: "evenium-new-participant",
+  name: "New Participant",
+  description: "Emit new event when a new participant (guest) is added to an event. [See the documentation](https://static.evenium.com/api-docs/organizer/index-json.html#_get_all_guests)",
+  version: "0.0.1",
+  type: "source",
+  dedupe: "unique",
+  props: {
+    ...common.props,
+    eventId: {
+      propDefinition: [
+        common.props.evenium,
+        "eventId",
+      ],
+    },
+  },
+  methods: {
+    ...common.methods,
+    getArgs() {
+      return {
+        eventId: this.eventId,
+      };
+    },
+    getFields() {
+      return {
+        data: "guests",
+        filter: "since",
+        date: "lastUpdate",
+        id: "guestId",
+      };
+    },
+    getSummary(result) {
+      return `New Participant: ${result.firstName} ${result.lastName}`;
+    },
+    getFunction() {
+      return this.evenium.listGuests;
+    },
+  },
+  sampleEmit,
+};

package/sources/new-participant/test-event.mjs

@@ -0,0 +1,80 @@
+export default {
+  "contactId": "1003525",
+  "eventId": "10574",
+  "firstName": "Sophie",
+  "lastName": "SERES",
+  "gender": "FEMALE",
+  "email": "noreply@evenium.com",
+  "company": "EVENIUM",
+  "lastUpdate": "2009-10-06T18:01:08.000Z",
+  "status": "DECLINED",
+  "category": "1010",
+  "categoryLabel": "Organizor",
+  "fields": [{
+          "name": "ADDR_CITY",
+          "value": "PARIS"
+  },{
+          "name": "IMPORT_FLAG",
+          "value": "Y"
+  },{
+          "name": "ADDR_STREET_NAME",
+          "value": "2, rue de sèze"
+  },{
+          "name": "1005064",
+          "value": "Ile de france"
+  },{
+          "name": "1005096",
+          "value": "3EME Etage"
+  },{
+          "name": "ADDR_POSTAL_CODE",
+          "value": "75009"
+  },{
+          "eventOnly": "true",
+          "name": "1012983",
+          "value": "Good"
+  },{
+          "eventOnly": "true",
+          "name": "1013008",
+          "value": "Fair"
+  },{
+          "eventOnly": "true",
+          "name": "1013003",
+          "value": "Very good"
+  },{
+          "eventOnly": "true",
+          "name": "1012996",
+          "value": "Good"
+  },{
+          "eventOnly": "true",
+          "name": "1013007",
+          "value": "Good"
+  },{
+          "eventOnly": "true",
+          "name": "1012994",
+          "value": "Good"
+  },{
+          "eventOnly": "true",
+          "name": "1012993",
+          "value": "Very good"
+  },{
+          "eventOnly": "true",
+          "name": "1013005",
+          "value": "Very good"
+  },{
+          "eventOnly": "true",
+          "name": "1012982",
+          "value": "Very good"
+  },{
+          "eventOnly": "true",
+          "name": "1012986",
+          "value": "Poor"
+  },{
+          "eventOnly": "true",
+          "name": "1012995",
+          "value": "Very good"
+  },{
+          "eventOnly": "true",
+          "name": "1013004",
+          "value": "Good"
+  }]
+}