@cap-js-community/event-queue/src/runner/runner.js

An event queue that enables secure transactional processing of asynchronous and periodic events, featuring instant event processing with Redis Pub/Sub and load distribution across all application instances.

"use strict";

const { randomUUID } = require("crypto");

const cds = require("@sap/cds");

const eventQueueConfig = require("../config");
const WorkerQueue = require("../shared/WorkerQueue");
const cdsHelper = require("../shared/cdsHelper");
const distributedLock = require("../shared/distributedLock");
const SetIntervalDriftSafe = require("../shared/SetIntervalDriftSafe");
const periodicEvents = require("../periodicEvents");
const common = require("../shared/common");
const config = require("../config");
const redisPub = require("../redis/redisPub");
const openEvents = require("./openEvents");
const { runEventCombinationForTenant } = require("./runnerHelper");
const { trace } = require("../shared/openTelemetry");

const COMPONENT_NAME = "/eventQueue/runner";
const EVENT_QUEUE_RUN_ID = "RUN_ID";
const EVENT_QUEUE_RUN_TS = "RUN_TS";
const EVENT_QUEUE_RUN_REDIS_CHECK = "RUN_REDIS_CHECK";
const EVENT_QUEUE_UPDATE_PERIODIC_EVENTS = "UPDATE_PERIODIC_EVENTS";

let OFFSET_FIRST_RUN;

let tenantIdHash;
let singleRunDone;

const singleTenantDb = () => _scheduleFunction(_checkPeriodicEventsSingleTenantOneTime, _singleTenantDb);

const multiTenancyDb = () => _scheduleFunction(async () => {}, _multiTenancyDb);

const multiTenancyRedis = () => _scheduleFunction(async () => {}, _multiTenancyRedis);

const singleTenantRedis = () => _scheduleFunction(_checkPeriodicEventsSingleTenantOneTime, _singleTenantRedis);

const _scheduleFunction = async (singleRunFn, periodicFn) => {
  const logger = cds.log(COMPONENT_NAME);
  const eventsForAutomaticRun = eventQueueConfig.allEvents;
  if (!eventsForAutomaticRun.length) {
    logger.warn("no events for automatic run are configured - skipping runner registration");
    return;
  }

  const fnWithRunningCheck = () => {
    const logger = cds.log(COMPONENT_NAME);
    if (!eventQueueConfig.isEventQueueActive) {
      logger.info("runner is deactivated via config variable. Skipping this run.");
      return;
    }
    if (!singleRunDone) {
      singleRunDone = true;
      singleRunFn()
        .then(periodicFn)
        .catch(() => (singleRunDone = false));
      return;
    }
    return periodicFn();
  };

  const offsetDependingOnLastRun = await _calculateOffsetForFirstRun();

  logger.info("first event-queue run scheduled", {
    firstRunScheduledFor: new Date(Date.now() + offsetDependingOnLastRun).toISOString(),
  });

  setTimeout(() => {
    fnWithRunningCheck();
    const intervalRunner = new SetIntervalDriftSafe(eventQueueConfig.runInterval);
    intervalRunner.run(fnWithRunningCheck);
  }, offsetDependingOnLastRun).unref();
};

const _multiTenancyRedis = async () => {
  const logger = cds.log(COMPONENT_NAME);
  try {
    logger.info("executing event queue run for multi instance and tenant");
    const tenantIds = await cdsHelper.getAllTenantIds();
    const shouldContinue = await _checkPeriodicEventUpdate(tenantIds);
    shouldContinue && (await _executeEventsAllTenantsRedis(tenantIds));
  } catch (err) {
    logger.info("executing event queue run for multi instance and tenant failed", err);
  }
};

// NOTE: _checkPeriodicEventUpdate the function must return truthy if _executeEventsAllTenantsRedis should continue
//       processing open events. The idea is: if _multiTenancyPeriodicEvents is executed after the deployment we want
//       to wait for all instances that periodic events are up-to-date and the updating of periodic events does not
//       interfere with the processing of events
const _checkPeriodicEventUpdate = async (tenantIds) => {
  if (!eventQueueConfig.updatePeriodicEvents || !eventQueueConfig.periodicEvents.length) {
    cds.log(COMPONENT_NAME).info("updating of periodic events is disabled or no periodic events configured", {
      updateEnabled: eventQueueConfig.updatePeriodicEvents,
      events: eventQueueConfig.periodicEvents.length,
    });
    return true;
  }
  const hash = common.hashStringTo32Bit(JSON.stringify(tenantIds));
  if (!tenantIdHash) {
    tenantIdHash = hash;
    return await _multiTenancyPeriodicEvents(tenantIds).catch((err) => {
      cds.log(COMPONENT_NAME).error("Error during triggering updating periodic events!", err);
    });
  }
  if (tenantIdHash && tenantIdHash !== hash) {
    tenantIdHash = hash;
    cds.log(COMPONENT_NAME).info("tenant id hash changed, triggering updating periodic events!");
    await _multiTenancyPeriodicEvents(tenantIds).catch((err) => {
      cds.log(COMPONENT_NAME).error("Error during triggering updating periodic events!", err);
    });
    return true;
  } else {
    return true;
  }
};

const _executeEventsAllTenantsRedis = async (tenantIds) => {
  const logger = cds.log(COMPONENT_NAME);
  try {
    // NOTE: do checks for all tenants on the same app instance --> acquire lock tenant independent
    //       distribute from this instance to all others
    const dummyContext = new cds.EventContext({});
    const couldAcquireLock = config.tenantIdFilterEventProcessing
      ? true
      : await trace(
          dummyContext,
          "acquire-lock-master-runner",
          async () => {
            return await distributedLock.acquireLock(dummyContext, EVENT_QUEUE_RUN_REDIS_CHECK, {
              expiryTime: eventQueueConfig.runInterval * 0.95,
              tenantScoped: false,
            });
          },
          { newRootSpan: true }
        );
    if (!couldAcquireLock) {
      return;
    }
  } catch (err) {
    logger.error("executing event queue run for multi instance and tenant failed", err);
  }

  for (const tenantId of tenantIds) {
    try {
      await cds.tx({ tenant: tenantId }, async (tx) => {
        await trace(
          tx.context,
          "get-openEvents-and-publish",
          async () => {
            const authInfo = await common.getAuthContext(tenantId);
            tx.context.user = new cds.User.Privileged({
              id: config.userId,
              authInfo,
              tokenInfo: authInfo?.token,
            });
            const entries = await openEvents.getOpenQueueEntries(tx, false);
            logger.info("broadcasting events for run", {
              tenantId,
              entries: entries.length,
            });
            if (!entries.length) {
              return;
            }
            // Do not wait until this is finished - as broadcastEvent has a retry mechanism and can delay this loop
            redisPub.broadcastEvent(tenantId, entries).catch((err) => {
              logger.error("broadcasting event failed", err, {
                tenantId,
                entries: entries.length,
              });
            });
          },
          { newRootSpan: true }
        );
      });
    } catch (err) {
      logger.error("broadcasting events for tenant failed", { tenantId }, err);
    }
  }
};

const _executeEventsAllTenants = async (tenantIds) => {
  const promises = [];
  for (const tenantId of tenantIds) {
    const id = cds.utils.uuid();
    let tenantContext;
    let events;
    try {
      events = await trace(
        { id, tenant: tenantId },
        "fetch-openEvents-and-authInfo",
        async () => {
          const user = await cds.tx({ tenant: tenantId }, async () => {
            const authInfo = await common.getAuthContext(tenantId);
            return new cds.User.Privileged({ id: config.userId, authInfo, tokenInfo: authInfo?.token });
          });
          tenantContext = {
            tenant: tenantId,
            user,
          };
          return await cds.tx(tenantContext, async (tx) => {
            return await openEvents.getOpenQueueEntries(tx);
          });
        },
        { newRootSpan: true }
      );
    } catch (err) {
      cds.log(COMPONENT_NAME).error("fetching open events for tenant failed", { tenantId }, err);
      continue;
    }

    if (!events.length) {
      continue;
    }

    promises.concat(
      events.map(async (openEvent) => {
        const eventConfig = config.getEventConfig(openEvent.type, openEvent.subType, openEvent.namespace);
        const label = [openEvent.namespace, eventConfig.type, eventConfig.subType].join("##");
        return await WorkerQueue.instance.addToQueue(
          eventConfig.load,
          label,
          eventConfig.priority,
          eventConfig.increasePriorityOverTime,
          async () => {
            return await cds.tx(tenantContext, async ({ context }) => {
              await trace(
                context,
                label,
                async () => {
                  try {
                    await runEventCombinationForTenant(
                      context,
                      eventConfig.type,
                      eventConfig.subType,
                      openEvent.namespace,
                      {
                        skipWorkerPool: true,
                      }
                    );
                  } catch (err) {
                    cds.log(COMPONENT_NAME).error("executing event-queue run for tenant failed", {
                      tenantId,
                    });
                  }
                },
                { newRootSpan: true }
              );
            });
          }
        );
      })
    );
  }
  return Promise.allSettled(promises);
};

const _executePeriodicEventsAllTenants = async (tenantIds) => {
  for (const tenantId of tenantIds) {
    try {
      const user = await cds.tx({ tenant: tenantId }, async () => {
        const authInfo = await common.getAuthContext(tenantId);
        return new cds.User.Privileged({ id: config.userId, authInfo, tokenInfo: authInfo?.token });
      });
      const tenantContext = {
        tenant: tenantId,
        user,
      };
      await cds.tx(tenantContext, async ({ context }) => {
        await trace(tenantContext, "update-periodic-events-for-tenant", async () => {
          if (!config.redisEnabled && !config.tenantIdFilterEventProcessing) {
            const couldAcquireLock = await distributedLock.acquireLock(context, EVENT_QUEUE_UPDATE_PERIODIC_EVENTS, {
              expiryTime: eventQueueConfig.runInterval * 0.95,
            });
            if (!couldAcquireLock) {
              return;
            }
          }
          await _checkPeriodicEventsSingleTenant(context);
        });
      });
    } catch (err) {
      cds.log(COMPONENT_NAME).error("executing event-queue run for tenant failed", {
        tenantId,
      });
    }
  }
};

const _singleTenantDb = async () => {
  const id = cds.utils.uuid();
  const events = await trace(
    { id },
    "fetch-openEvents-and-authInfo",
    async () => {
      return await cds.tx({}, async (tx) => {
        return await openEvents.getOpenQueueEntries(tx);
      });
    },
    { newRootSpan: true }
  );

  for (const openEvent of events) {
    const eventConfig = config.getEventConfig(openEvent.type, openEvent.subType, openEvent.namespace);
    const label = [openEvent.namespace, eventConfig.type, eventConfig.subType].join("##");
    await WorkerQueue.instance.addToQueue(
      eventConfig.load,
      label,
      eventConfig.priority,
      eventConfig.increasePriorityOverTime,
      async () => {
        return await cds.tx({}, async ({ context }) => {
          await trace(
            context,
            label,
            async () => {
              try {
                await runEventCombinationForTenant(
                  context,
                  eventConfig.type,
                  eventConfig.subType,
                  openEvent.namespace,
                  {
                    skipWorkerPool: true,
                  }
                );
              } catch (err) {
                cds.log(COMPONENT_NAME).error("executing event-queue run for tenant failed");
              }
            },
            { newRootSpan: true }
          );
        });
      }
    );
  }
};

const _singleTenantRedis = async () => {
  const id = cds.utils.uuid();
  const logger = cds.log(COMPONENT_NAME);
  try {
    // NOTE: do checks for open events on one app instance distribute from this instance to all others
    const dummyContext = new cds.EventContext({});
    const couldAcquireLock = await trace(
      dummyContext,
      "acquire-lock-master-runner",
      async () => {
        return await distributedLock.acquireLock(dummyContext, EVENT_QUEUE_RUN_REDIS_CHECK, {
          expiryTime: eventQueueConfig.runInterval * 0.95,
          tenantScoped: false,
        });
      },
      { newRootSpan: true }
    );
    if (!couldAcquireLock) {
      return;
    }

    await trace(
      { id },
      "get-openEvents-and-publish",
      async () => {
        return await cds.tx({}, async (tx) => {
          const entries = await openEvents.getOpenQueueEntries(tx, false);
          logger.info("broadcasting events for run", {
            entries: entries.length,
          });
          if (!entries.length) {
            return;
          }
          // Do not wait until this is finished - as broadcastEvent has a retry mechanism and can delay this loop
          redisPub.broadcastEvent(null, entries).catch((err) => {
            logger.error("broadcasting event failed", err, {
              entries: entries.length,
            });
          });
        });
      },
      { newRootSpan: true }
    );
  } catch (err) {
    logger.info("executing event queue run for single tenant via redis", err);
  }
};

const _acquireRunId = async (context) => {
  let runId = randomUUID();
  const couldSetValue = await distributedLock.setValueWithExpire(context, EVENT_QUEUE_RUN_ID, runId, {
    tenantScoped: false,
    expiryTime: eventQueueConfig.runInterval * 0.95,
  });

  if (couldSetValue) {
    await distributedLock.setValueWithExpire(context, EVENT_QUEUE_RUN_TS, new Date().toISOString(), {
      tenantScoped: false,
      expiryTime: eventQueueConfig.runInterval,
      overrideValue: true,
    });
  } else {
    runId = await distributedLock.getValue(context, EVENT_QUEUE_RUN_ID, {
      tenantScoped: false,
    });
  }

  return runId;
};

const _calculateOffsetForFirstRun = async () => {
  let offsetDependingOnLastRun = OFFSET_FIRST_RUN ?? (config.developmentMode ? 500 : 10 * 1000);
  const now = Date.now();
  // NOTE: this is only supported with Redis, because this is a tenant agnostic information
  //       currently there is no proper place to store this information beside t0 schema
  const dummyContext = new cds.EventContext({});
  try {
    await trace(dummyContext, "calculateOffsetForFirstRun", async () => {
      if (eventQueueConfig.redisEnabled) {
        let lastRunTs = await distributedLock.getValue(dummyContext, EVENT_QUEUE_RUN_TS, {
          tenantScoped: false,
        });
        if (!lastRunTs) {
          const ts = new Date(now).toISOString();
          const couldSetValue = await distributedLock.setValueWithExpire(dummyContext, EVENT_QUEUE_RUN_TS, ts, {
            tenantScoped: false,
            expiryTime: eventQueueConfig.runInterval,
          });
          if (couldSetValue) {
            lastRunTs = ts;
          } else {
            lastRunTs = await distributedLock.getValue(dummyContext, EVENT_QUEUE_RUN_TS, {
              tenantScoped: false,
            });
          }
        }
        offsetDependingOnLastRun = new Date(lastRunTs).getTime() + eventQueueConfig.runInterval - now;
      }
    });
  } catch (err) {
    cds
      .log(COMPONENT_NAME)
      .error("calculating offset for first run failed, falling back to default. Runs might be out-of-sync.", err);
  }
  return offsetDependingOnLastRun;
};

const _multiTenancyDb = async () => {
  const logger = cds.log(COMPONENT_NAME);
  try {
    logger.info("executing event queue run for single instance and multi tenant");
    const tenantIds = await cdsHelper.getAllTenantIds();
    await _checkPeriodicEventUpdate(tenantIds);
    return await _executeEventsAllTenants(tenantIds);
  } catch (err) {
    logger.error("Couldn't fetch tenant ids for event queue processing! Next try after defined interval.", err);
  }
};

const _multiTenancyPeriodicEvents = async (tenantIds) => {
  const logger = cds.log(COMPONENT_NAME);
  try {
    logger.info("executing event queue update periodic events");

    const dummyContext = new cds.EventContext({});
    return await trace(
      dummyContext,
      "update-periodic-events",
      async () => {
        if (config.redisEnabled && !config.tenantIdFilterEventProcessing) {
          const couldAcquireLock = await distributedLock.acquireLock(dummyContext, EVENT_QUEUE_UPDATE_PERIODIC_EVENTS, {
            expiryTime: 60 * 1000, // short living lock --> assume we do not have 2 onboards within 1 minute
            tenantScoped: false,
          });
          if (!couldAcquireLock) {
            return;
          }
        }

        tenantIds = tenantIds ?? (await cdsHelper.getAllTenantIds());
        await _executePeriodicEventsAllTenants(tenantIds);
        return true;
      },
      { newRootSpan: true }
    );
  } catch (err) {
    logger.error("Couldn't fetch tenant ids for updating periodic event processing!", err);
  }
};

const _checkPeriodicEventsSingleTenantOneTime = async () => {
  const logger = cds.log(COMPONENT_NAME);
  if (!eventQueueConfig.updatePeriodicEvents || !eventQueueConfig.periodicEvents.length) {
    logger.info("updating of periodic events is disabled or no periodic events configured", {
      updateEnabled: eventQueueConfig.updatePeriodicEvents,
      events: eventQueueConfig.periodicEvents.length,
    });
    return;
  }

  const dummyContext = new cds.EventContext({});
  return await trace(
    dummyContext,
    "update-periodic-events",
    async () => {
      const couldAcquireLock = await distributedLock.acquireLock(dummyContext, EVENT_QUEUE_UPDATE_PERIODIC_EVENTS, {
        expiryTime: 60 * 1000,
        tenantScoped: false,
      });
      if (!couldAcquireLock) {
        logger.info("skipping updating periodic events - lock not acquired");
        return;
      }
      return await cds.tx({}, async (tx) => await periodicEvents.checkAndInsertPeriodicEvents(tx.context));
    },
    { newRootSpan: true }
  );
};

const _checkPeriodicEventsSingleTenant = async (context) => {
  const logger = cds.log(COMPONENT_NAME);
  if (!eventQueueConfig.updatePeriodicEvents || !eventQueueConfig.periodicEvents.length) {
    logger.info("updating of periodic events is disabled or no periodic events configured", {
      updateEnabled: eventQueueConfig.updatePeriodicEvents,
      events: eventQueueConfig.periodicEvents.length,
    });
    return;
  }
  try {
    logger.info("executing updating periodic events", {
      tenantId: context.tenant,
      subdomain: context.user?.authInfo?.getSubdomain?.(),
    });
    await periodicEvents.checkAndInsertPeriodicEvents(context);
  } catch (err) {
    logger.error("Couldn't update periodic events for tenant! Next try after defined interval.", err, {
      tenantId: context.tenant,
      redisEnabled: eventQueueConfig.redisEnabled,
    });
  }
};

module.exports = {
  singleTenantDb,
  multiTenancyDb,
  multiTenancyRedis,
  singleTenantRedis,
  __: {
    _singleTenantDb,
    _multiTenancyRedis,
    _singleTenantRedis,
    _multiTenancyDb,
    _calculateOffsetForFirstRun,
    _acquireRunId,
    EVENT_QUEUE_RUN_TS,
    clearHash: () => (tenantIdHash = null),
    setOffsetFirstRun: (value) => (OFFSET_FIRST_RUN = value),
  },
};