@plusscommunities/pluss-maintenance-aws-forms 2.1.22 → 2.1.24

package/getData.js

@@ -5,6 +5,7 @@ const generateJsonResponse = require("@plusscommunities/pluss-core-aws/helper/ge
 const getAssignees = require("./requests/getAssignees");
 const getRequests = require("./requests/getRequests");
 const getRequest = require("./requests/getRequest");
+const getExternalSync = require("./requests/getExternalSync");
 
 module.exports.getData = async (event, context, callback) => {
   init(config);
@@ -34,6 +35,12 @@ module.exports.getData = async (event, context, callback) => {
           log(action, "ResponseLength", response.data.Users.length, logId);
         }
         break;
+      case "externalsync":
+        response = await getExternalSync(event);
+        if (response.status === 200) {
+          log(action, "ExternalSystem", response.data.externalSystem, logId);
+        }
+        break;
       default:
         break;
     }

package/integration/archibus/ArchibusStrategy.js

@@ -128,6 +128,7 @@ class ArchibusStrategy extends IntegrationStrategy {
         InternalId: request.id,
         ExternalId: response.data.wrId,
         TrackedData: {},
+        SystemType: "Archibus",
       });
 
       // Save the Archibus ID as the job number and add history entry
@@ -139,12 +140,13 @@ class ArchibusStrategy extends IntegrationStrategy {
       if (!updatedJob.history) updatedJob.history = [];
       updatedJob.history.push({
         timestamp: moment.utc().valueOf(),
-        action: "ExternalIDSet",
+        EntryType: "ExternalIDSet",
         externalId: response.data.wrId,
         user: {
           displayName: "Archibus Integration",
           id: "system",
         },
+        systemType: "Archibus",
       });
 
       await editRef(values.tableNameMaintenance, "id", request.id, {
@@ -176,11 +178,12 @@ class ArchibusStrategy extends IntegrationStrategy {
         if (!failedJob.history) failedJob.history = [];
         failedJob.history.push({
           timestamp: moment.utc().valueOf(),
-          action: "ExternalIDSetFailed",
+          EntryType: "ExternalIDSetFailed",
           user: {
             displayName: "Archibus Integration",
             id: "system",
           },
+          systemType: "Archibus",
         });
 
         await editRef(values.tableNameMaintenance, "id", request.id, {

package/integration/seestuff/SeeStuffStrategy.js

@@ -167,7 +167,7 @@ class SeeStuffStrategy extends IntegrationStrategy {
         if (!failedJob.history) failedJob.history = [];
         failedJob.history.push({
           timestamp: moment.utc().valueOf(),
-          action: "ExternalIDSetFailed",
+          EntryType: "ExternalIDSetFailed",
           user: {
             displayName: "SeeStuff Integration",
             id: "system",

package/package-lock.json

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

package/package.json

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

package/requests/getExternalSync.js

@@ -0,0 +1,147 @@
+const getRef = require("@plusscommunities/pluss-core-aws/db/common/getRef");
+const indexQuery = require("@plusscommunities/pluss-core-aws/db/common/indexQuery");
+const validateMasterAuth = require("@plusscommunities/pluss-core-aws/helper/auth/validateMasterAuth");
+const isValidAssignee = require("./helper/isValidAssignee");
+const getSessionUserFromReqAuthKey = require("@plusscommunities/pluss-core-aws/helper/auth/getSessionUserFromReqAuthKey");
+const { log } = require("@plusscommunities/pluss-core-aws/helper");
+const { values } = require("../values.config");
+
+/**
+ * Retrieves external system sync information for a maintenance request
+ *
+ * Checks both SeeStuff and Archibus external entity tables to find
+ * if the request has been synced to an external system.
+ *
+ * @param {Object} event - Lambda event object
+ * @param {Object} params - Query parameters (optional, uses event.queryStringParameters if not provided)
+ * @returns {Object} Response object with status and data
+ *
+ * Response format (200):
+ * {
+ *   externalSystem: "SeeStuff" | "Archibus",
+ *   externalId: string,
+ *   syncedAt: number (Unix timestamp),
+ *   trackedData: object
+ * }
+ *
+ * Error responses:
+ * - 422: Missing required field (id)
+ * - 404: Request not found OR no external sync exists
+ * - 403: Not authorized (user doesn't have permission to view request)
+ * - 500: Internal server error
+ */
+module.exports = async (event, params) => {
+  const data = params || event.queryStringParameters || {};
+  const logId = log("getExternalSync", "Params", data);
+
+  // Validate input
+  if (!data.id) {
+    log("getExternalSync", "MissingId", true, logId);
+    return {
+      status: 422,
+      data: { error: "Missing required field: id" },
+    };
+  }
+
+  try {
+    // Get the request to verify it exists and get site for permission check
+    let request;
+    try {
+      request = await getRef(values.tableNameMaintenance, "id", data.id);
+    } catch (error) {
+      log("getExternalSync", "RequestNotFound", { id: data.id }, logId);
+      return {
+        status: 404,
+        data: { error: "Request not found" },
+      };
+    }
+
+    if (!request) {
+      log("getExternalSync", "RequestNotFound", { id: data.id }, logId);
+      return {
+        status: 404,
+        data: { error: "Request not found" },
+      };
+    }
+
+    // Check permissions (same pattern as getRequest.js)
+    // Three levels of access:
+    // 1. Full admin with maintenance tracking permission
+    // 2. User assigned to the request
+    // 3. User who created the request
+    const authorised = await validateMasterAuth(
+      event,
+      values.permissionMaintenanceTracking,
+      request.site
+    );
+
+    const assignAuthorised = await isValidAssignee(
+      event,
+      request.site,
+      request.AssigneeId
+    );
+
+    if (!authorised && !assignAuthorised) {
+      // Check if user is the request owner
+      const userId = await getSessionUserFromReqAuthKey(event);
+      if (userId !== request.userID) {
+        log(
+          "getExternalSync",
+          "NotAuthorised",
+          { userId, requestOwner: request.userID },
+          logId
+        );
+        return {
+          status: 403,
+          data: { error: "Not authorised" },
+        };
+      }
+    }
+
+    log("getExternalSync", "Authorised", true, logId);
+
+    let externalSync = null;
+    const query = await indexQuery("externalentities", {
+      IndexName: "OnlyInternalIdIndex",
+      KeyConditionExpression: "InternalId = :internalId",
+      ExpressionAttributeValues: {
+        ":internalId": request.id,
+      },
+    });
+
+    log("getExternalSync", "Results", query.Items.length, logId);
+
+    if (query.Items && query.Items.length > 0) {
+      const item = query.Items[0];
+      externalSync = {
+        systemType: item.SystemType,
+        externalId: item.ExternalId,
+        syncedAt: item.LastUpdated,
+        trackedData: item.TrackedData || {},
+      };
+
+      log("getExternalSync", "FoundSync", externalSync, logId);
+    }
+
+    // If no external sync found, return 404
+    if (!externalSync) {
+      log("getExternalSync", "NoSyncFound", { id: data.id }, logId);
+      return {
+        status: 404,
+        data: { error: "No external sync found" },
+      };
+    }
+
+    log("getExternalSync", "Success", externalSync, logId);
+    return {
+      status: 200,
+      data: externalSync,
+    };
+  } catch (error) {
+    log("getExternalSync", "InternalError", error.toString(), logId);
+    return {
+      status: 500,
+      data: { error: "Internal error", message: error.message },
+    };
+  }
+};

package/requests/setExternalJobId.js

@@ -67,6 +67,7 @@ module.exports = async (event, data) => {
       LastUpdated: moment().valueOf(),
       TrackedData: data.trackedData || {},
       Site: job.site, // Store for site-specific queries
+      SystemType: data.systemType,
     });
 
     log(action, "ExternalEntityCreated", externalEntity, logId);
@@ -75,9 +76,10 @@ module.exports = async (event, data) => {
     if (!job.history) job.history = [];
     job.history.push({
       timestamp: moment.utc().valueOf(),
-      action: "ExternalIDSet",
+      EntryType: "ExternalIDSet",
       externalId: data.externalId,
       user,
+      systemType: data.systemType,
     });
 
     // 8. Update job with history and optionally update job number for system parity