@plusscommunities/pluss-core-aws 2.0.23 → 2.0.24-beta.0

package/helper/notifySiteConfigs.js

@@ -0,0 +1,117 @@
+/**
+ * Notify SiteConfigs Service of Operational Data Changes
+ *
+ * This helper provides a pre-filtering mechanism for auto-propagation.
+ * When operational data changes (sites, usertypes, interfaces, strings, jobTypes),
+ * this function:
+ *
+ * 1. Queries SourceSiteIdIndex to check if any templates use this site as source
+ * 2. If none found → early return (no Lambda invoke, 99% of cases)
+ * 3. If templates found → invokes siteConfigs Lambda to handle republishing
+ *
+ * This hybrid approach ensures:
+ * - No Lambda latency for most sites (pre-filter catches non-source sites)
+ * - Publishing logic stays encapsulated in siteConfigs service
+ * - Minimal cross-service coupling
+ *
+ * Usage:
+ *   const notifySiteConfigs = require("@plusscommunities/pluss-core-aws/helper/notifySiteConfigs");
+ *   await notifySiteConfigs(siteId, logId);
+ */
+
+const AWS = require("aws-sdk");
+const indexQuery = require("../db/common/indexQuery");
+const { log } = require("./index");
+
+const lambda = new AWS.Lambda();
+
+const TABLE_NAME = "siteconfigs";
+
+/**
+ * Check if a site has any templates using it as a source
+ * @param {string} siteId - The site ID to check
+ * @returns {Promise<Array>} Array of template IDs (empty if none)
+ */
+const getTemplatesForSourceSite = async (siteId) => {
+  try {
+    const result = await indexQuery(TABLE_NAME, {
+      IndexName: "SourceSiteIdIndex",
+      KeyConditionExpression: "SourceSiteId = :sourceSiteId",
+      ExpressionAttributeValues: {
+        ":sourceSiteId": siteId,
+      },
+      ProjectionExpression: "Id", // Only need IDs for pre-filter
+    });
+    return (result.Items || []).map((item) => item.Id);
+  } catch (err) {
+    // Table or index might not exist in all deployments
+    log("notifySiteConfigs", "QueryError", { siteId, error: err.message });
+    return [];
+  }
+};
+
+/**
+ * Invoke the siteConfigs operationalDataChanged Lambda
+ * @param {string} siteId - The source site that changed
+ * @param {Array<string>} templateIds - List of template IDs to republish
+ * @param {string} logId - Log ID for tracing
+ */
+const invokeSiteConfigsLambda = async (siteId, templateIds, logId) => {
+  // Build function name from environment
+  // Format: {client}-siteConfigs-{stage}-operationalDataChanged
+  const client = process.env.client || "dev";
+  const stage = process.env.stage || "dev";
+  const functionName = `${client}-siteConfigs-${stage}-operationalDataChanged`;
+
+  const payload = {
+    siteId,
+    templateIds,
+    logId,
+    source: "notifySiteConfigs",
+  };
+
+  log("notifySiteConfigs", "InvokingLambda", { functionName, siteId, templateCount: templateIds.length }, logId);
+
+  try {
+    await lambda
+      .invoke({
+        FunctionName: functionName,
+        InvocationType: "Event", // Async invocation
+        Payload: JSON.stringify(payload),
+      })
+      .promise();
+
+    log("notifySiteConfigs", "LambdaInvoked", { functionName, siteId }, logId);
+  } catch (err) {
+    log("notifySiteConfigs", "LambdaError", { functionName, siteId, error: err.message }, logId);
+    // Don't throw - this is a non-critical operation
+  }
+};
+
+/**
+ * Notify siteConfigs service that operational data has changed for a site.
+ * Performs pre-filtering to avoid unnecessary Lambda invocations.
+ *
+ * @param {string} siteId - The site ID where operational data changed
+ * @param {string} logId - Optional log ID for tracing
+ */
+const notifySiteConfigs = async (siteId, logId) => {
+  if (!siteId) {
+    return;
+  }
+
+  // Pre-filter: Check if this site is a source for any templates
+  const templateIds = await getTemplatesForSourceSite(siteId);
+
+  if (templateIds.length === 0) {
+    // No Lambda invocation needed
+    return;
+  }
+
+  log("notifySiteConfigs", "TemplatesFound", { siteId, count: templateIds.length }, logId);
+
+  // Invoke siteConfigs Lambda to handle republishing
+  await invokeSiteConfigsLambda(siteId, templateIds, logId);
+};
+
+module.exports = notifySiteConfigs;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plusscommunities/pluss-core-aws",
-  "version": "2.0.23",
+  "version": "2.0.24-beta.0",
   "description": "Core extension package for Pluss Communities platform",
   "scripts": {
     "betapatch": "npm version prepatch --preid=beta",
@@ -34,4 +34,4 @@
     "serverless-domain-manager": "^3.3.1",
     "serverless-prune-plugin": "^1.4.1"
   }
-}
+}