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

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

@@ -139,7 +139,7 @@ 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",
@@ -176,7 +176,7 @@ 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",

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.23",
   "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.23",
   "description": "Extension package to enable maintenance on Pluss Communities Platform",
   "scripts": {
     "gc": "node ../../tools/gc ./",

package/requests/getExternalSync.js

@@ -0,0 +1,171 @@
+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);
+
+    // Query externalentities table for this request
+    // Check both SeeStuff and Archibus entity types
+    const entityTypes = [
+      `${values.serviceKey}_SeeStuff`,
+      `${values.serviceKey}_Archibus`,
+    ];
+
+    log("getExternalSync", "CheckingEntityTypes", entityTypes, logId);
+
+    let externalSync = null;
+
+    // Check each external system type
+    for (const entityType of entityTypes) {
+      const query = await indexQuery("externalentities", {
+        IndexName: "InternalIdIndex",
+        KeyConditionExpression:
+          "EntityType = :entityType AND InternalId = :internalId",
+        ExpressionAttributeValues: {
+          ":entityType": entityType,
+          ":internalId": request.id,
+        },
+      });
+
+      log(
+        "getExternalSync",
+        `${entityType}_Results`,
+        query.Items.length,
+        logId
+      );
+
+      if (query.Items && query.Items.length > 0) {
+        const item = query.Items[0];
+        // Extract system name from entity type (e.g., "maintenance_SeeStuff" -> "SeeStuff")
+        const systemName = entityType.split("_")[1];
+
+        externalSync = {
+          externalSystem: systemName,
+          externalId: item.ExternalId,
+          syncedAt: item.LastUpdated,
+          trackedData: item.TrackedData || {},
+        };
+
+        log("getExternalSync", "FoundSync", externalSync, logId);
+        break; // Stop after finding first match
+      }
+    }
+
+    // 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

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