@plusscommunities/pluss-maintenance-aws 2.1.21 → 2.1.22

package/integration/index.js

@@ -1,6 +1,7 @@
 const getString = require("@plusscommunities/pluss-core-aws/db/strings/getString");
 const { getRowId, log } = require("@plusscommunities/pluss-core-aws/helper");
 const ArchibusStrategy = require("./archibus/ArchibusStrategy");
+const SeeStuffStrategy = require("./seestuff/SeeStuffStrategy");
 const IntegrationStrategy = require("./IntegrationStrategy");
 const { values } = require("../values.config");
 
@@ -16,6 +17,8 @@ exports.getStrategy = async (site) => {
     switch (importConfig.Strategy) {
       case "Archibus":
         return new ArchibusStrategy(importConfig);
+      case "SeeStuff":
+        return new SeeStuffStrategy(importConfig);
       default:
         return new IntegrationStrategy();
     }

package/integration/seestuff/SeeStuffStrategy.js

@@ -0,0 +1,293 @@
+const axios = require("axios");
+const moment = require("moment");
+const _ = require("lodash");
+const IntegrationStrategy = require("../IntegrationStrategy");
+const { log, getRowId } = require("@plusscommunities/pluss-core-aws/helper");
+const editRef = require("@plusscommunities/pluss-core-aws/db/common/editRef");
+const updateRef = require("@plusscommunities/pluss-core-aws/db/common/updateRef");
+const getRef = require("@plusscommunities/pluss-core-aws/db/common/getRef");
+const indexQuery = require("@plusscommunities/pluss-core-aws/db/common/indexQuery");
+const { values } = require("../../values.config");
+
+class SeeStuffStrategy extends IntegrationStrategy {
+  constructor(config) {
+    super();
+    this.baseUrl = config.BaseUrl; // base URL for the API
+    this.apiKeyHeader = config.APIKeyHeader; // header to use for API key
+    this.apiKey = config.APIKey; // API key
+
+    const url = new URL(this.baseUrl);
+    this.host = url.host;
+
+    this.siteMap = config.SiteMap ?? {};
+  }
+
+  /**
+   * Gets the entity type for the integration
+   *
+   * @returns {String} The entity type for the integration
+   */
+  getEntityType = () => {
+    return `${values.serviceKey}_SeeStuff`;
+  };
+
+  /**
+   * Validates the integration
+   *
+   * @returns {Boolean} Whether the integration is valid
+   */
+  isValidIntegration = () => {
+    return true;
+  };
+
+  /**
+   * Gets the refresh interval for the SeeStuff system
+   *
+   * @returns {Number} The refresh interval in milliseconds
+   */
+  getRefreshInterval = () => {
+    return Number.MAX_SAFE_INTEGER; // should never refresh
+  };
+
+  /**
+   * Creates a request in the SeeStuff system
+   *
+   * @param {Object} request - Request definition on Pluss
+   * @param {Object} mockResponse - Mock response from SeeStuff to simulate response
+   * @returns {Boolean} Whether the request was created on SeeStuff
+   */
+  createRequest = async (request, mockResponse = null) => {
+    const logId = log("SeeStuff:CreateRequest", "Start", request);
+
+    try {
+      // Get user details for room/address and CRMID
+      let userRoom = request.room || "";
+      let crmResidentId = "";
+
+      // Map site to location code if available
+      const location = this.siteMap[request.site];
+      if (!location) {
+        log("SeeStuff:CreateRequest", "LocationNotFound", request.site, logId);
+        return false;
+      }
+
+      if (request.userID) {
+        try {
+          // Look up user from users table
+          const user = await getRef("users", "Id", request.userID);
+          log("SeeStuff:CreateRequest", "User", user, logId);
+
+          if (user) {
+            // Get user's address/room
+            if (user.unit) {
+              userRoom = user.unit;
+            }
+
+            // Get CRMID from user fields
+            try {
+              const crmIdField = await getRef(
+                "userfields",
+                "RowId",
+                getRowId(request.userID, "CRMID")
+              );
+              if (crmIdField && crmIdField.Value) {
+                crmResidentId = crmIdField.Value;
+              }
+              log("SeeStuff:CreateRequest", "CRMID", crmResidentId, logId);
+            } catch (fieldError) {
+              log(
+                "SeeStuff:CreateRequest",
+                "CRMIDLookupError",
+                fieldError,
+                logId
+              );
+            }
+          }
+        } catch (userError) {
+          log("SeeStuff:CreateRequest", "UserLookupError", userError, logId);
+        }
+      }
+
+      // Format description similar to Archibus
+      const description = `${request.title}${
+        _.isEmpty(request.description) ? "" : `\n\n${request.description}`
+      }${_.isEmpty(request.room) ? "" : `\n\nLocation: ${request.room}`}${
+        _.isEmpty(request.userName) ? "" : `\n\nName: ${request.userName}`
+      }${_.isEmpty(request.phone) ? "" : `\n\nPhone: ${request.phone}`}${
+        _.isEmpty(request.type) ? "" : `\n\nJob Type: ${request.type}`
+      }${
+        _.isEmpty(request.images)
+          ? ""
+          : `\n\nImages: ${request.images.join("\n")}`
+      }`;
+
+      // Format date_reported
+      const dateReported = moment().format("YYYY-MM-DD HH:mm:ss");
+
+      // Build payload
+      const data = {
+        externalId: request.id,
+        description: description,
+        priority: "P3",
+        location: location,
+        room: userRoom,
+        date_reported: dateReported,
+        crmResidentId: crmResidentId,
+      };
+
+      log("SeeStuff:CreateRequest", "Request", data, logId);
+
+      const response =
+        mockResponse ??
+        (await axios({
+          method: "POST",
+          url: `${this.baseUrl}/assetmgmt/servicerequests`,
+          timeout: 30000,
+          headers: {
+            [this.apiKeyHeader]: this.apiKey,
+            "Content-Type": "application/json",
+            Host: this.host,
+          },
+          data,
+        }));
+
+      log("SeeStuff:CreateRequest", "Response", response.data, logId);
+
+      return true;
+    } catch (e) {
+      log("SeeStuff:CreateRequest", "Error", e, logId);
+
+      // Add history entry for failed integration
+      try {
+        const failedJob = await getRef(
+          values.tableNameMaintenance,
+          "id",
+          request.id
+        );
+        if (!failedJob.history) failedJob.history = [];
+        failedJob.history.push({
+          timestamp: moment.utc().valueOf(),
+          action: "ExternalIDSetFailed",
+          user: {
+            displayName: "SeeStuff Integration",
+            id: "system",
+          },
+        });
+
+        await editRef(values.tableNameMaintenance, "id", request.id, {
+          history: failedJob.history,
+        });
+      } catch (historyError) {
+        log("SeeStuff:CreateRequest", "HistoryError", historyError, logId);
+      }
+    }
+    return false;
+  };
+
+  /**
+   * Fetches a request from the SeeStuff system
+   * Not implemented yet
+   *
+   * @param {String} externalId - Id of the request on SeeStuff
+   * @returns {Object} The request as it exists on SeeStuff
+   */
+  getRequest = async (externalId) => {
+    return null;
+  };
+
+  /**
+   * Refreshes a request from the SeeStuff system
+   * Not implemented yet
+   *
+   * @param {String} requestId - Id of the request on Pluss
+   * @param {String} externalId - Id of the request on SeeStuff
+   * @param {Object} trackedData - The set of fields tracked
+   * @returns {Boolean} Whether the request had any changes on SeeStuff
+   */
+  refreshFromSource = async (requestId, externalId, trackedData) => {
+    return false;
+  };
+
+  /**
+   * Get SeeStuff Id of the request
+   * Queries externalentities table to find the external ID
+   *
+   * @param {Object} request - Request definition on Pluss
+   * @returns {String} Id of the request on SeeStuff
+   */
+  getExternalId = async (request) => {
+    const logId = log("SeeStuff:GetExternalId", "Start", { Id: request.id });
+
+    // get external id
+    const externalEntityQuery = await indexQuery("externalentities", {
+      IndexName: "InternalIdIndex",
+      KeyConditionExpression:
+        "EntityType = :entityType AND InternalId = :internalId",
+      ExpressionAttributeValues: {
+        ":entityType": this.getEntityType(),
+        ":internalId": request.id,
+      },
+    });
+
+    log(
+      "SeeStuff:GetExternalId",
+      "ExternalLength",
+      externalEntityQuery.Items.length,
+      logId
+    );
+    if (_.isEmpty(externalEntityQuery.Items)) {
+      return null;
+    }
+
+    const externalId = externalEntityQuery.Items[0].ExternalId;
+    log("SeeStuff:GetExternalId", "ExternalId", externalId, logId);
+
+    return externalId;
+  };
+
+  /**
+   * Perform actions when a task's status has changed
+   * Not implemented yet
+   *
+   * @param {Object} request - Request definition on Pluss
+   * @returns {Boolean} Represents whether the actions were successful
+   */
+  onStatusChanged = async (request) => {
+    return true;
+  };
+
+  /**
+   * Perform actions when a comment has been added to a task
+   * Not implemented yet
+   *
+   * @param {Object} request - Request definition on Pluss
+   * @returns {Boolean} Represents whether the actions were successful
+   */
+  onCommentAdded = async (request) => {
+    return true;
+  };
+
+  /**
+   * Perform actions when a note has been added to a task
+   * Not implemented yet
+   *
+   * @param {Object} request - Request definition on Pluss
+   * @returns {Boolean} Represents whether the actions were successful
+   */
+  onNotesAdded = async (request) => {
+    return true;
+  };
+
+  /**
+   * Perform completion actions when a task is completed
+   * Not implemented yet
+   *
+   * @param {Object} request - Request definition on Pluss
+   * @returns {Boolean} Represents whether the actions were successful
+   */
+  onCompleteRequest = async (request) => {
+    return true;
+  };
+}
+
+module.exports = SeeStuffStrategy;

package/package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@plusscommunities/pluss-maintenance-aws",
-  "version": "2.1.21",
+  "version": "2.1.22",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plusscommunities/pluss-maintenance-aws",
-  "version": "2.1.21",
+  "version": "2.1.22",
   "description": "Extension package to enable maintenance on Pluss Communities Platform",
   "scripts": {
     "gc": "node ../../tools/gc ./",