@pipedream/jobnimbus 0.0.3 → 1.0.0

package/README.md

@@ -1,12 +1,11 @@
 # Overview
 
-Jobnimbus API can be used to create custom applications for managing job
-information.
+The Jobnimbus API allows for the creation of complex workflows revolving around job and customer management within the construction and contracting industries. With this API, users can automate tasks such as updating job statuses, managing contacts, and creating tasks or appointments. This streamlines the process of moving a job from lead to completion, ensuring communication and record-keeping are seamless.
 
-Some examples of what you can build using the Jobnimbus API include:
+# Example Use Cases
 
-- A custom job board
-- A job search engine
-- A job management system
-- A CRM for job-related information
-- A job-related data analytics platform
+- **Automated Job Status Updates**: Trigger a Pipedream workflow whenever a job status is updated in Jobnimbus to send a custom notification via SMS or email through Twilio or SendGrid. This keeps team members in the loop in real-time about job progress.
+
+- **Dynamic Contact Import**: When a new contact is added to a Google Sheet, use Pipedream to automatically create a corresponding contact in Jobnimbus. This ensures your customer database is always synchronized and up-to-date without manual entry.
+
+- **Task Management with Calendar Integration**: On creation of a new task in Jobnimbus, trigger a Pipedream workflow to add an event to a Google Calendar, inviting all relevant team members. This automation helps in scheduling and making sure everyone is aware of their assignments.

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,82 @@
+import app from "../../jobnimbus.app.mjs";
+import utils from "../../common/utils.mjs";
+import { attachmentTypes } from "../../common/constants.mjs";
+import {
+  ConfigurationError, getFileStream,
+} from "@pipedream/platform";
+
+export default {
+  key: "jobnimbus-create-attachment",
+  version: "1.0.0",
+  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,
+    file: {
+      type: "string",
+      label: "File Path or URL",
+      description: "The file to upload. Provide a file URL or a path to a file in the `/tmp` directory.",
+    },
+    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,
+    },
+  },
+  methods: {
+    streamToBase64(stream) {
+      return new Promise((resolve, reject) => {
+        const chunks = [];
+        stream.on("data", (chunk) => chunks.push(chunk));
+        stream.on("end", () => {
+          const buffer = Buffer.concat(chunks);
+          resolve(buffer.toString("base64"));
+        });
+        stream.on("error", reject);
+      });
+    },
+  },
+  async run ({ $ }) {
+    if (!this.file) {
+      throw new ConfigurationError("The `File Path or URL` prop is required.");
+    }
+
+    const stream = await getFileStream(this.file);
+    const fileData = await this.streamToBase64(stream);
+
+    const data = {
+      ...utils.extractProps(this, {
+        customerIdFromContacts: "customer",
+      }),
+      data: fileData,
+    };
+    delete data.file;
+    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,18 @@
 {
   "name": "@pipedream/jobnimbus",
-  "version": "0.0.3",
+  "version": "1.0.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/)",
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "@pipedream/platform": "^3.1.0"
   }
 }

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,
+      };
+    },
+  },
+};