@plusscommunities/pluss-maintenance-aws-forms 2.1.18 → 2.1.19

package/package.json

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

package/requests/setExternalJobId.js

@@ -0,0 +1,121 @@
+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 validateMasterAuth = require("@plusscommunities/pluss-core-aws/helper/auth/validateMasterAuth");
+const getUserPreviewFromReq = require("@plusscommunities/pluss-core-aws/helper/getUserPreviewFromReq");
+const moment = require("moment");
+const { values } = require("../values.config");
+const { log } = require("@plusscommunities/pluss-core-aws/helper");
+
+module.exports = async (event, data) => {
+  const action = "setExternalJobId";
+  const logId = log(action, "Input", data);
+
+  try {
+    // 1. Validate required fields
+    if (!data.id || !data.externalId || !data.systemType) {
+      return {
+        status: 422,
+        data: {
+          error: "Missing required fields: id, externalId, systemType",
+        },
+      };
+    }
+
+    // 2. Find the job by ID (UUID)
+    let job;
+
+    try {
+      job = await getRef(values.tableNameMaintenance, "id", data.id);
+    } catch (error) {
+      log(action, "Error:JobNotFound", { error: error.message }, logId);
+      return { status: 404, data: { error: "Job not found" } };
+    }
+
+    if (!job) {
+      log(action, "JobNotFound", { id: data.id }, logId);
+      return { status: 404, data: { error: "Job not found" } };
+    }
+
+    // 3. Validate authorization using the job's site
+    const authorised = await validateMasterAuth(
+      event,
+      values.permissionMaintenanceTracking,
+      job.site
+    );
+
+    if (!authorised) {
+      log(action, "NotAuthorised", { site: job.site }, logId);
+      return { status: 403, data: { error: "Not authorised" } };
+    }
+
+    // 4. Get user preview for history tracking
+    const user = await getUserPreviewFromReq(event);
+
+    // 5. Create entity type identifier
+    const entityType = `${values.serviceKey}_${data.systemType}`;
+    const rowId = `${entityType}_${data.externalId}`;
+
+    log(action, "CreatingExternalEntity", { entityType, rowId }, logId);
+
+    // 6. Create/update external entity mapping
+    const externalEntity = await updateRef("externalentities", {
+      RowId: rowId,
+      EntityType: entityType,
+      InternalId: job.id,
+      ExternalId: data.externalId,
+      LastUpdated: moment().valueOf(),
+      TrackedData: data.trackedData || {},
+      Site: job.site, // Store for site-specific queries
+    });
+
+    log(action, "ExternalEntityCreated", externalEntity, logId);
+
+    // 7. Add history entry
+    if (!job.history) job.history = [];
+    job.history.push({
+      timestamp: moment.utc().valueOf(),
+      action: "ExternalIDSet",
+      externalId: data.externalId,
+      user,
+    });
+
+    // 8. Update job with history and optionally update job number for system parity
+    let updatedJob = job;
+
+    if (!isNaN(data.externalId)) {
+      log(
+        action,
+        "UpdatingJobNumber",
+        {
+          oldJobNo: job.jobNo,
+          newJobNo: data.externalId,
+        },
+        logId
+      );
+
+      updatedJob = await editRef(values.tableNameMaintenance, "id", job.id, {
+        jobNo: Number(data.externalId),
+        jobId: Number(data.externalId) + "",
+        history: job.history,
+      });
+
+      log(action, "JobNumberUpdated", updatedJob, logId);
+    }
+
+    return {
+      status: 200,
+      data: {
+        success: true,
+        job: updatedJob,
+        externalEntity: externalEntity,
+      },
+    };
+  } catch (error) {
+    log(action, "InternalError", error, logId);
+    return {
+      status: 500,
+      data: { error: "Internal error", message: error.message },
+    };
+  }
+};

package/updateData.js

@@ -4,6 +4,7 @@ const { init } = require("@plusscommunities/pluss-core-aws/config");
 const config = require("./config.json");
 const assignRequest = require("./requests/assignRequest");
 const updatePriority = require("./requests/updatePriority");
+const setExternalJobId = require("./requests/setExternalJobId");
 
 module.exports.updateData = async (event, context, callback) => {
   init(config);
@@ -21,7 +22,11 @@ module.exports.updateData = async (event, context, callback) => {
       case "priority":
         response = await updatePriority(event, data);
         break;
+      case "externalid":
+        response = await setExternalJobId(event, data);
+        break;
       default:
+        response = { status: 404, data: { error: "Action not found" } };
         break;
     }
   } catch (err) {
@@ -33,5 +38,9 @@ module.exports.updateData = async (event, context, callback) => {
 
   log(action, "Response", response, logId);
 
+  if (!response) {
+    response = { status: 500, data: { error: "No response generated" } };
+  }
+
   return callback(null, generateJsonResponse(response.status, response.data));
 };