@pipedream/jobnimbus 0.0.2 → 0.1.0

package/LICENSE

@@ -1,7 +1,41 @@
-Copyright 2020 Pipedream, Inc.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+Pipedream Source Available License Version 1.0
+ 
+This Pipedream Source Available License Agreement Version 1.0 (this “Agreement”) sets forth the terms on which Pipedream, Inc., a Delaware corporation (“Pipedream”) makes available certain software (the “Software”). By installing, downloading, accessing, using or distributing the Software, you agree to the terms of this Agreement. If you do not agree to such terms, you must not use the Software. If you are receiving the Software on behalf of a legal entity, you represent and warrant that you have the actual authority to agree to the terms and conditions of this Agreement on behalf of such entity. “Licensee” means you, an individual, or the entity on whose behalf you are receiving the Software.
+ 
+LICENSE GRANT AND CONDITIONS.
+ 
+1.1  License. Subject to the terms and conditions of this Agreement, Pipedream hereby grants to Licensee a non-exclusive, royalty-free, worldwide, non-transferable, non-sublicenseable license during the term of this Agreement to use, prepare modifications and derivative works, distribute (including without limitation in source code or object code form) and reproduce copies of the Software (the “License”). Licensee is not granted the right to, and Licensee shall not, exercise the License for an Excluded Purpose. For purposes of this Agreement, “Excluded Purpose” means any commercial use of the software including, but not limited to, making available any software-as-a-service, platform-as-a-service, infrastructure-as-a-service or other online service that competes with the Software or any other Pipedream products or services.
+ 
+1.2  Conditions. In consideration of the License, Licensee’s distribution of the Software is subject to the following conditions:
+ 
+a. Licensee must cause any Software modified by Licensee to carry prominent notices stating that Licensee modified the Software.
+ 
+b. On each Software copy, Licensee shall reproduce and not remove or alter all Pipedream or third party copyright or other proprietary notices contained in the Software, and Licensee must provide this with each copy: “This software is made available by Pipedream, Inc., under the terms of the Pipedream Source Available License, Version 1.0 located at https://github.com/PipedreamHQ/pipedream/blob/master/LICENSE. By installing, downloading, accessing, using or distributing the Software, you agree to the terms of such License Agreement.”
+ 
+1.3  Modifications. Licensee may add its own copyright notices to modifications made by Licensee and may provide additional or different license terms and conditions for use, reproduction, or distribution of Licensee’s modifications. While redistributing the Software or modifications thereof, Licensee may choose to offer, for a fee or free of charge, support, warranty, indemnity, or other obligations. Licensee, and not Pipedream, will be responsible for any such obligations.
+ 
+1.4  No Sublicensing. The License does not include the right to sublicense the Software; provided, however, that any recipient to which Licensee provides the Software may exercise the License so long as such recipient agrees to the terms and conditions of this Agreement.
+ 
+TERM AND TERMINATION.
+ 
+This Agreement will continue unless and until earlier terminated as set forth herein. If Licensee breaches any of its conditions or obligations under this Agreement, this Agreement will terminate automatically and the License will terminate automatically and permanently.
+ 
+INTELLECTUAL PROPERTY.
+ 
+As between the parties, Pipedream retains all right, title, and interest in the Software, and all intellectual property rights therein. Pipedream hereby reserves all rights not expressly granted to Licensee in this Agreement. Pipedream reserves all rights in its trademarks and service marks, and no licenses thereto are granted by this Agreement.
+ 
+DISCLAIMER.
+ 
+PIPEDREAM HEREBY DISCLAIMS ANY AND ALL WARRANTIES AND CONDITIONS, EXPRESS, IMPLIED, STATUTORY, OR OTHERWISE, AND SPECIFICALLY DISCLAIMS ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THE SOFTWARE.
+ 
+LIMITATION OF LIABILITY.
+ 
+PIPEDREAM WILL NOT BE LIABLE FOR ANY DAMAGES OF ANY KIND, INCLUDING BUT NOT LIMITED TO, LOST PROFITS OR ANY CONSEQUENTIAL, SPECIAL, INCIDENTAL, INDIRECT, OR DIRECT DAMAGES, HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, ARISING OUT OF THIS AGREEMENT. THE FOREGOING SHALL APPLY TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW.
+ 
+GENERAL.
+ 
+6.1  Governing Law. This Agreement will be governed by and interpreted in accordance with the laws of the state of California, without reference to its conflict of laws principles. If Licensee is located outside of the United States, any dispute, controversy or claim arising out of or relating to this Agreement will be referred to and finally determined by arbitration in accordance with the JAMS International Arbitration Rules. The tribunal will consist of one arbitrator. Judgment upon the award rendered by the arbitrator may be entered in any court having jurisdiction thereof. All disputes including arbitrations shall take place in Santa Clara County, California. The language to be used in any such proceedings shall be English.
+ 
+6.2.  Assignment. Licensee is not authorized to assign its rights under this Agreement to any third party. Pipedream may freely assign its rights under this Agreement to any third party.
+ 
+6.3.  Other. This Agreement is the entire agreement between the parties regarding the subject matter hereof. No amendment or modification of this Agreement will be valid or binding upon the parties unless made in writing and signed by the duly authorized representatives of both parties. In the event that any provision, including without limitation any condition, of this Agreement is held to be unenforceable, this Agreement and all licenses and rights granted hereunder will immediately terminate. Waiver by Pipedream of a breach of any provision of this Agreement or the failure by Pipedream to exercise any right hereunder will not be construed as a waiver of any subsequent breach of that right or as a waiver of any other right.

package/README.md

@@ -0,0 +1,12 @@
+# Overview
+
+Jobnimbus API can be used to create custom applications for managing job
+information.
+
+Some examples of what you can build using the Jobnimbus API include:
+
+- A custom job board
+- A job search engine
+- A job management system
+- A CRM for job-related information
+- A job-related data analytics platform

package/actions/common/contact-base.mjs

@@ -0,0 +1,209 @@
+import app from "../../jobnimbus.app.mjs";
+import utils from "../../common/utils.mjs";
+
+export default {
+  props: {
+    app,
+    firstName: {
+      type: "string",
+      label: "First Name",
+      description: "The first name of the person this contact record is associated with.",
+      optional: true,
+    },
+    lastName: {
+      type: "string",
+      label: "Last Name",
+      description: "The last name of the person this contact record is associated with.",
+      optional: true,
+    },
+    displayName: {
+      type: "string",
+      label: "Display Name",
+      description: "The company name that this contact record is associated with.",
+      optional: true,
+    },
+    company: {
+      type: "string",
+      label: "Company Name",
+      description: "Display name used mainly for QB syncing.",
+      optional: true,
+    },
+    number: {
+      type: "string",
+      label: "Number",
+      description: "The customer defined template generated number assigned to this record, based off of the record id.",
+      optional: true,
+    },
+    isActive: {
+      type: "boolean",
+      label: "Is Active",
+      description: "Whether this record is active(true) or deleted(false).",
+      optional: true,
+    },
+    isArchived: {
+      type: "boolean",
+      label: "Is Archived",
+      description: "Whether this record has been archived (true) or not (false).",
+      optional: true,
+    },
+    tags: {
+      type: "string[]",
+      label: "Tags",
+      description: "List of string tags",
+      optional: true,
+    },
+    description: {
+      type: "string",
+      label: "Description",
+      description: "The description of this record.",
+      optional: true,
+    },
+    address1: {
+      type: "string",
+      label: "Address Line 1",
+      description: "The line 1 portion of the physical address.",
+      optional: true,
+    },
+    address2: {
+      type: "string",
+      label: "Address Line 2",
+      description: "The line 2 portion of the physical address.",
+      optional: true,
+    },
+    city: {
+      type: "string",
+      label: "City",
+      description: "The city portion of the physical address.",
+      optional: true,
+    },
+    state: {
+      type: "string",
+      label: "State",
+      description: "The state text portion of the physical address.",
+      optional: true,
+    },
+    zip: {
+      type: "string",
+      label: "Zip",
+      description: "The postal code portion of the physical address.",
+      optional: true,
+    },
+    country: {
+      type: "string",
+      label: "Country",
+      description: "The country portion of the physical address.",
+      optional: true,
+    },
+    geoLat: {
+      type: "string",
+      label: "Geo Latitude",
+      description: "The latitude of geo coordinates of the address associated with this record.",
+      optional: true,
+    },
+    geoLong: {
+      type: "string",
+      label: "Geo Longitude",
+      description: "The longitude of geo coordinates of the address associated with this record.",
+      optional: true,
+    },
+    estimatedTime: {
+      type: "integer",
+      label: "Estimated Time",
+      description: "The number of minutes this record is estimated to take to complete.",
+      optional: true,
+    },
+    isLead: {
+      type: "boolean",
+      label: "Is Lead",
+      description: "Whether this record is a lead or not.",
+      optional: true,
+    },
+    isClosed: {
+      type: "boolean",
+      label: "Is Closed",
+      description: "Whether this record is closed or not.",
+      optional: true,
+    },
+    isSubcontractor: {
+      type: "boolean",
+      label: "Is Subcontractor",
+      description: "Whether this contact is a subcontractor or not for User.",
+      optional: true,
+    },
+    email: {
+      propDefinition: [
+        app,
+        "email",
+      ],
+      optional: true,
+    },
+    homePhone: {
+      type: "string",
+      label: "Home Phone",
+      description: "The home phone number associated with this contact.",
+      optional: true,
+    },
+    mobilePhone: {
+      type: "string",
+      label: "Mobile Phone",
+      description: "The mobile phone number associated with this contact.",
+      optional: true,
+    },
+    workPhone: {
+      type: "string",
+      label: "Work Phone",
+      description: "The work phone number associated with this contact.",
+      optional: true,
+    },
+    faxNumber: {
+      type: "string",
+      label: "Fax Number",
+      description: "The fax number associated with this contact.",
+      optional: true,
+    },
+    website: {
+      type: "string",
+      label: "Website",
+      description: "Website",
+      optional: true,
+    },
+    additionalFields: {
+      type: "object",
+      label: "Additional Fields",
+      description: "Additional fields that can be added according to API docs and custom fields.",
+      optional: true,
+    },
+  },
+  methods: {
+    prepareData() {
+      const pairs = {
+        firstName: "first_name",
+        lastName: "last_name",
+        displayName: "display_name",
+        isActive: "is_active",
+        isArchived: "is_archived",
+        address1: "address_line1",
+        address2: "address_line2",
+        state: "state_text",
+        country: "country_name",
+        estimatedTime: "estimated_time",
+        isLead: "is_lead",
+        isClosed: "is_closed",
+        isSubcontractor: "is_sub_contractor",
+        homePhone: "home_phone",
+        mobilePhone: "mobile_phone",
+        workPhone: "work_phone",
+        faxNumber: "fax_number",
+      };
+      const data = {
+        ...utils.extractProps(this, pairs),
+        geo: {
+          lat: parseFloat(this.geoLat),
+          lon: parseFloat(this.geoLong),
+        },
+        ...this.additionalFields,
+      };
+      return data;
+    },
+  },
+};

package/actions/create-attachment/create-attachment.mjs

@@ -0,0 +1,69 @@
+import app from "../../jobnimbus.app.mjs";
+import utils from "../../common/utils.mjs";
+import { attachmentTypes } from "../../common/constants.mjs";
+import { ConfigurationError } from "@pipedream/platform";
+import fs from "fs";
+
+export default {
+  key: "jobnimbus-create-attachment",
+  version: "0.0.1",
+  type: "action",
+  name: "Create Attachment",
+  description: "Creates an attachment. [See the documentation](https://documenter.getpostman.com/view/3919598/S11PpG4x#5f3f485b-91f9-4ed9-912c-99a07987ac6c)",
+  props: {
+    app,
+    filePath: {
+      type: "string",
+      label: "File Path",
+      description: "The file to upload, please provide a valid file from `/tmp`. To upload a file to `/tmp` folder, please follow the doc [here](https://pipedream.com/docs/code/nodejs/working-with-files/#writing-a-file-to-tmp)",
+    },
+    type: {
+      type: "string",
+      label: "Type",
+      description: "The record type.",
+      options: attachmentTypes,
+    },
+    customerIdFromContacts: { //There is no endpoint that can be customers fetched from.
+      propDefinition: [
+        app,
+        "customerIdFromContacts",
+      ],
+      optional: true,
+    },
+    filename: {
+      type: "string",
+      label: "File Name",
+      description: "Name of the file to be uploaded.",
+      optional: true,
+    },
+    description: {
+      type: "string",
+      label: "Description",
+      description: "The description of the file.",
+      optional: true,
+    },
+  },
+  async run ({ $ }) {
+    const filePath = utils.isValidFile(this.filePath);
+    if (!filePath) {
+      throw new ConfigurationError("`File Path` must be a valid file path!");
+    }
+    const fileData = fs.readFileSync(filePath, {
+      flag: "r",
+      encoding: "base64",
+    });
+    const data = {
+      ...utils.extractProps(this, {
+        customerIdFromContacts: "customer",
+      }),
+      data: fileData,
+    };
+    delete data["filePath"];
+    const resp = await this.app.createAttachment({
+      $,
+      data,
+    });
+    $.export("$summary", `Successfully created attachment with ID ${resp.jnid}`);
+    return resp;
+  },
+};

package/actions/create-contact/create-contact.mjs

@@ -0,0 +1,40 @@
+/* eslint-disable pipedream/props-label */
+/* eslint-disable pipedream/props-description */
+import base from "../common/contact-base.mjs";
+
+export default {
+  key: "jobnimbus-create-contact",
+  version: "0.0.1",
+  type: "action",
+  name: "Create Contact",
+  description: "Creates a contact. [See the documentation](https://documenter.getpostman.com/view/3919598/S11PpG4x#7ec1541f-7241-4840-9322-0ed83c01d48e)",
+  ...base,
+  props: {
+    ...base.props,
+    firstName: {
+      ...base.props.firstName,
+      optional: false,
+    },
+    lastName: {
+      ...base.props.lastName,
+      optional: false,
+    },
+    displayName: {
+      ...base.props.displayName,
+      optional: false,
+    },
+    company: {
+      ...base.props.company,
+      optional: false,
+    },
+  },
+  async run ({ $ }) {
+    const data = this.prepareData();
+    const resp = await this.app.createContact({
+      $,
+      data,
+    });
+    $.export("$summary", `Successfully created contact with ID ${resp.jnid}`);
+    return resp;
+  },
+};

package/actions/find-contact-by-email/find-contact-by-email.mjs

@@ -0,0 +1,36 @@
+import app from "../../jobnimbus.app.mjs";
+
+export default {
+  key: "jobnimbus-find-contact-by-email",
+  version: "0.0.1",
+  type: "action",
+  name: "Find Contact By Email",
+  description: "Finds contact by email. [See the documentation](https://documenter.getpostman.com/view/3919598/S11PpG4x#46dff3eb-80ae-46b1-a399-eb80ab2a09bc)",
+  props: {
+    app,
+    email: {
+      propDefinition: [
+        app,
+        "email",
+      ],
+    },
+  },
+  async run ({ $ }) {
+    const resp = await this.app.getContacts({
+      $,
+      params: {
+        filter: {
+          must: [
+            {
+              term: {
+                email: this.email,
+              },
+            },
+          ],
+        },
+      },
+    });
+    $.export("$summary", "Contact has been retrieved successfully.");
+    return resp;
+  },
+};

package/actions/find-contact-by-id/find-contact-by-id.mjs

@@ -0,0 +1,26 @@
+import app from "../../jobnimbus.app.mjs";
+
+export default {
+  key: "jobnimbus-find-contact-by-id",
+  version: "0.0.1",
+  type: "action",
+  name: "Find Contact By ID",
+  description: "Finds contact by ID. [See the documentation](https://documenter.getpostman.com/view/3919598/S11PpG4x#02875033-b94e-4ed9-83cc-d157fba8e5d5)",
+  props: {
+    app,
+    contactId: {
+      propDefinition: [
+        app,
+        "contactId",
+      ],
+    },
+  },
+  async run ({ $ }) {
+    const resp = await this.app.getContact({
+      $,
+      contactId: this.contactId,
+    });
+    $.export("$summary", "Contact has been retrieved successfully.");
+    return resp;
+  },
+};

package/actions/update-contact/update-contact.mjs

@@ -0,0 +1,30 @@
+import base from "../common/contact-base.mjs";
+
+export default {
+  key: "jobnimbus-update-contact",
+  version: "0.0.1",
+  type: "action",
+  name: "Update Contact",
+  description: "Updates a contact. [See the documentation](https://documenter.getpostman.com/view/3919598/S11PpG4x#6c94f9a6-2bac-4189-9b2e-5d856f0fe310)",
+  ...base,
+  props: {
+    app: base.props.app,
+    contactId: {
+      propDefinition: [
+        base.props.app,
+        "contactId",
+      ],
+    },
+    ...base.props,
+  },
+  async run ({ $ }) {
+    const data = this.prepareData();
+    const resp = await this.app.updateContact({
+      $,
+      contactId: this.contactId,
+      data,
+    });
+    $.export("$summary", "Contact has been updated successfully.");
+    return resp;
+  },
+};

package/common/constants.mjs

@@ -0,0 +1,38 @@
+const attachmentTypes = [
+  {
+    label: "Document",
+    value: "1",
+  },
+  {
+    label: "Photo",
+    value: "2",
+  },
+  {
+    label: "Email Attachment",
+    value: "3",
+  },
+  {
+    label: "naturalForms",
+    value: "4",
+  },
+  {
+    label: "Invoice",
+    value: "5",
+  },
+  {
+    label: "Eagleview",
+    value: "6",
+  },
+  {
+    label: "Accurence",
+    value: "7",
+  },
+  {
+    label: "Credit Memo",
+    value: "8",
+  },
+];
+
+export {
+  attachmentTypes,
+};

package/common/utils.mjs

@@ -0,0 +1,75 @@
+import fs from "fs";
+
+const PAGE_SIZE = 25;
+
+export default {
+  isValidFile(filePath) {
+    const filePathWithTmp = `/tmp/${filePath}`;
+    if (fs.existsSync(filePathWithTmp)) {
+      return filePathWithTmp;
+    }
+    if (fs.existsSync(filePath)) {
+      return filePath;
+    }
+    return false;
+  },
+  extractProps(that, pairs) {
+    const {
+      // eslint-disable-next-line no-unused-vars
+      app,
+      ...props
+    } = that;
+    return Object.keys(props)
+      .reduce((acc, key) => {
+        const keyMapped = pairs[key];
+        const value = props[key];
+        const newKey = keyMapped ?? key;
+        return {
+          ...acc,
+          [newKey]: value,
+        };
+      }, {});
+  },
+  async asyncPropHandler({
+    resourceFn, page, mapper, params, resourceKey = "results",
+  } = {}) {
+    const { [resourceKey]: items } =
+      await resourceFn({
+        params: {
+          ...params,
+          ...(typeof page != "undefined" && {
+            from: page * PAGE_SIZE,
+            size: PAGE_SIZE,
+          }),
+        },
+      });
+    return items.map(mapper);
+  },
+  async *getResourcesStream({
+    resourceFn, resourceFnArgs, resourceKey,
+  }) {
+    let page = 0;
+    while (true) {
+      const { [resourceKey]: nextResources } =
+        await resourceFn({
+          ...resourceFnArgs,
+          params: {
+            ...resourceFnArgs?.params,
+            from: page++ * PAGE_SIZE,
+            size: PAGE_SIZE,
+          },
+        });
+      if (!nextResources?.length) {
+        console.log("No more resources");
+        return;
+      }
+      for (const resource of nextResources) {
+        yield resource;
+      }
+      if (nextResources?.length < PAGE_SIZE) {
+        console.log("Number of resources less than page size");
+        return;
+      }
+    }
+  },
+};

package/jobnimbus.app.mjs

@@ -0,0 +1,131 @@
+import { axios } from "@pipedream/platform";
+import utils from "./common/utils.mjs";
+
+export default {
+  type: "app",
+  app: "jobnimbus",
+  propDefinitions: {
+    contactId: {
+      type: "string",
+      label: "Contact ID",
+      description: "JNID of the contact.",
+      async options({ page }) {
+        return utils.asyncPropHandler({
+          resourceFn: this.getContacts,
+          page,
+          params: {
+            fields: "jnid,display_name",
+          },
+          mapper: ({
+            display_name: label,
+            jnid: value,
+          }) => ({
+            label,
+            value,
+          }),
+        });
+      },
+    },
+    customerIdFromContacts: {
+      type: "string",
+      label: "Customer ID",
+      description: "JNID of the customer. These options are fetched from contacts. There can be missing customers or duplicates. If missing, please provide the ID manually.",
+      async options({ page }) {
+        return utils.asyncPropHandler({
+          resourceFn: this.getContacts,
+          page,
+          params: {
+            fields: "customer,company",
+          },
+          mapper: ({
+            company: label,
+            customer: value,
+          }) => ({
+            label,
+            value,
+          }),
+        });
+      },
+    },
+    email: {
+      type: "string",
+      label: "Email",
+      description: "The email address associated with the contact.",
+    },
+  },
+  methods: {
+    _getUrl(path) {
+      return `https://app.jobnimbus.com/api1${path}`;
+    },
+    _getHeaders(headers = {}) {
+      return {
+        "Authorization": `Bearer ${this.$auth.api_key}`,
+        "Content-Type": "application/json",
+        "Accept": "application/json",
+        "User-Agent": "@PipedreamHQ/pipedream v0.1",
+        ...headers,
+      };
+    },
+    _makeRequest({
+      $ = this, path, headers, ...args
+    } = {}) {
+      const config = {
+        url: this._getUrl(path),
+        headers: this._getHeaders(headers),
+        ...args,
+      };
+      return axios($, config);
+    },
+    getContact({
+      contactId, ...args
+    } = {}) {
+      return this._makeRequest({
+        path: `/contacts/${contactId}`,
+        ...args,
+      });
+    },
+    getJob({
+      jobId, ...args
+    } = {}) {
+      return this._makeRequest({
+        path: `/jobs/${jobId}`,
+        ...args,
+      });
+    },
+    getContacts(args = {}) {
+      return this._makeRequest({
+        path: "/contacts",
+        ...args,
+      });
+    },
+    getActivities(args = {}) {
+      return this._makeRequest({
+        path: "/activities",
+        ...args,
+      });
+    },
+    createContact(args = {}) {
+      return this._makeRequest({
+        path: "/contacts",
+        method: "POST",
+        ...args,
+      });
+    },
+    updateContact({
+      contactId, ...args
+    } = {}) {
+      return this._makeRequest({
+        path: `/contacts/${contactId}`,
+        method: "PUT",
+        ...args,
+      });
+    },
+    createAttachment(args = {}) {
+      return this._makeRequest({
+        path: "/files",
+        method: "POST",
+        ...args,
+      });
+    },
+  },
+};

package/package.json

@@ -1,18 +1,17 @@
 {
   "name": "@pipedream/jobnimbus",
-  "version": "0.0.2",
+  "version": "0.1.0",
   "description": "Pipedream Jobnimbus Components",
-  "main": "dist/app/jobnimbus.app.mjs",
+  "main": "jobnimbus.app.mjs",
   "keywords": [
     "pipedream",
     "jobnimbus"
   ],
-  "files": [
-    "dist"
-  ],
   "homepage": "https://pipedream.com/apps/jobnimbus",
   "author": "Pipedream <support@pipedream.com> (https://pipedream.com/)",
-  "license": "MIT",
+  "dependencies": {
+    "@pipedream/platform": "^1.5.1"
+  },
   "publishConfig": {
     "access": "public"
   }

package/sources/activity-created/activity-created.mjs

@@ -0,0 +1,11 @@
+import common from "../common/activity-based.mjs";
+
+export default {
+  ...common,
+  key: "jobnimbus-activity-created",
+  name: "New Activity Created Event",
+  description: "Emit new events when a new activity created. [See the docs](https://documenter.getpostman.com/view/3919598/S11PpG4x#62c713fe-5d46-4fd6-9953-db49255fd5e0)",
+  version: "0.0.1",
+  type: "source",
+  dedupe: "unique",
+};

package/sources/common/activity-based.mjs

@@ -0,0 +1,38 @@
+import common from "./common.mjs";
+
+export default {
+  ...common,
+  methods: {
+    ...common.methods,
+    getResourceFnConfig() {
+      return {
+        resourceFn: this.app.getActivities,
+        resourceFnArgs: {
+          boardId: this.boardId,
+          params: {
+            must: [
+              {
+                range: {
+                  date_created: {
+                    gte: this.getLastComparable(),
+                  },
+                },
+              },
+            ],
+          },
+        },
+        resourceKey: "activity",
+      };
+    },
+    getComparable(item) {
+      return item.date_created;
+    },
+    getMeta(item) {
+      return {
+        id: item.date_created,
+        summary: item.note,
+        ts: item.date_created * 1000,
+      };
+    },
+  },
+};

package/sources/common/common.mjs

@@ -0,0 +1,57 @@
+import app from "../../jobnimbus.app.mjs";
+import utils from "../../common/utils.mjs";
+import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";
+
+export default {
+  props: {
+    app,
+    timer: {
+      type: "$.interface.timer",
+      default: {
+        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
+      },
+    },
+    db: "$.service.db",
+  },
+  methods: {
+    setLastComparable(lastComparable) {
+      this.db.set("lastComparable", lastComparable);
+    },
+    getLastComparable() {
+      return this.db.get("lastComparable") || 0;
+    },
+    getResourceFnConfig() {
+      throw new Error("getResourceFnConfig() is not implemented!");
+    },
+    getItem(item) {
+      return item;
+    },
+    getMeta() {
+      throw new Error("getMeta() is not implemented!");
+    },
+    getComparable() {
+      throw new Error("getComparable() is not implemented!");
+    },
+    compareFn() {
+      return true;
+    },
+  },
+  async run() {
+    let lastComparable = this.getLastComparable();
+    const resourcesStream = utils.getResourcesStream(this.getResourceFnConfig());
+    for await (const resource of resourcesStream) {
+      const comparable = this.getComparable(resource);
+      if (lastComparable < comparable && this.compareFn(resource)) {
+        const item = await this.getItem(resource);
+        this.$emit(
+          item,
+          this.getMeta(item),
+        );
+      }
+      if (lastComparable < comparable) {
+        lastComparable = comparable;
+      }
+    }
+    this.setLastComparable(lastComparable);
+  },
+};

package/sources/contact-created/contact-created.mjs

@@ -0,0 +1,29 @@
+import common from "../common/activity-based.mjs";
+
+export default {
+  ...common,
+  key: "jobnimbus-contact-created",
+  name: "New Contact Created Event",
+  description: "Emit new events when a new contact is created. [See the docs](https://documenter.getpostman.com/view/3919598/S11PpG4x#62c713fe-5d46-4fd6-9953-db49255fd5e0)",
+  version: "0.0.1",
+  type: "source",
+  dedupe: "unique",
+  methods: {
+    ...common.methods,
+    compareFn(item) {
+      return item?.record_type_name == "Contact Created";
+    },
+    getItem(item) {
+      return this.app.getContact({
+        contactId: item.primary.id,
+      });
+    },
+    getMeta(item) {
+      return {
+        id: item.date_created,
+        summary: `New contact has been created - ID: ${item.jnid}`,
+        ts: item.date_created * 1000,
+      };
+    },
+  },
+};

package/sources/contact-deleted/contact-deleted.mjs

@@ -0,0 +1,24 @@
+import common from "../common/activity-based.mjs";
+
+export default {
+  ...common,
+  key: "jobnimbus-contact-deleted",
+  name: "New Contact Deleted Event",
+  description: "Emit new events when a contact is deleted. [See the docs](https://documenter.getpostman.com/view/3919598/S11PpG4x#62c713fe-5d46-4fd6-9953-db49255fd5e0)",
+  version: "0.0.1",
+  type: "source",
+  dedupe: "unique",
+  methods: {
+    ...common.methods,
+    compareFn(item) {
+      return item?.record_type_name == "Contact Deleted";
+    },
+    getMeta(item) {
+      return {
+        id: item.date_created,
+        summary: `Contact has been deleted - ID: ${item.primary.id}`,
+        ts: item.date_created * 1000,
+      };
+    },
+  },
+};

package/sources/contact-updated/contact-updated.mjs

@@ -0,0 +1,29 @@
+import common from "../common/activity-based.mjs";
+
+export default {
+  ...common,
+  key: "jobnimbus-contact-updated",
+  name: "New Contact Updated Event",
+  description: "Emit new events when a contact is updated. [See the docs](https://documenter.getpostman.com/view/3919598/S11PpG4x#62c713fe-5d46-4fd6-9953-db49255fd5e0)",
+  version: "0.0.1",
+  type: "source",
+  dedupe: "unique",
+  methods: {
+    ...common.methods,
+    compareFn(item) {
+      return item?.record_type_name == "Contact Modified";
+    },
+    async getItem(item) {
+      return this.app.getContact({
+        contactId: item.primary.id,
+      });
+    },
+    getMeta(item) {
+      return {
+        id: item.date_updated,
+        summary: `Contact has been updated - ID: ${item.jnid}`,
+        ts: item.date_updated * 1000,
+      };
+    },
+  },
+};

package/sources/job-created/job-created.mjs

@@ -0,0 +1,29 @@
+import common from "../common/activity-based.mjs";
+
+export default {
+  ...common,
+  key: "jobnimbus-job-created",
+  name: "New Job Created Event",
+  description: "Emit new events when a new job is created. [See the docs](https://documenter.getpostman.com/view/3919598/S11PpG4x#62c713fe-5d46-4fd6-9953-db49255fd5e0)",
+  version: "0.0.1",
+  type: "source",
+  dedupe: "unique",
+  methods: {
+    ...common.methods,
+    compareFn(item) {
+      return item?.record_type_name == "Job Created";
+    },
+    async getItem(item) {
+      return this.app.getJob({
+        jobId: item.primary.id,
+      });
+    },
+    getMeta(item) {
+      return {
+        id: item.date_created,
+        summary: `New job has been created - ID: ${item.jnid}`,
+        ts: item.date_created * 1000,
+      };
+    },
+  },
+};

package/sources/job-deleted/job-deleted.mjs

@@ -0,0 +1,24 @@
+import common from "../common/activity-based.mjs";
+
+export default {
+  ...common,
+  key: "jobnimbus-job-deleted",
+  name: "New Job Deleted Event",
+  description: "Emit new events when a job is deleted. [See the docs](https://documenter.getpostman.com/view/3919598/S11PpG4x#62c713fe-5d46-4fd6-9953-db49255fd5e0)",
+  version: "0.0.1",
+  type: "source",
+  dedupe: "unique",
+  methods: {
+    ...common.methods,
+    compareFn(item) {
+      return item?.record_type_name == "Job Deleted";
+    },
+    getMeta(item) {
+      return {
+        id: item.date_created,
+        summary: `Job has been deleted - ID: ${item.primary.id}`,
+        ts: item.date_created * 1000,
+      };
+    },
+  },
+};

package/sources/job-updated/job-updated.mjs

@@ -0,0 +1,29 @@
+import common from "../common/activity-based.mjs";
+
+export default {
+  ...common,
+  key: "jobnimbus-job-updated",
+  name: "New Job Updated Event",
+  description: "Emit new events when a job is updated. [See the docs](https://documenter.getpostman.com/view/3919598/S11PpG4x#62c713fe-5d46-4fd6-9953-db49255fd5e0)",
+  version: "0.0.1",
+  type: "source",
+  dedupe: "unique",
+  methods: {
+    ...common.methods,
+    compareFn(item) {
+      return item?.record_type_name == "Job Modified";
+    },
+    async getItem(item) {
+      return this.app.getJob({
+        jobId: item.primary.id,
+      });
+    },
+    getMeta(item) {
+      return {
+        id: item.date_updated,
+        summary: `Job has been updated - ID: ${item.jnid}`,
+        ts: item.date_updated * 1000,
+      };
+    },
+  },
+};