@memberjunction/scheduling-engine 2.107.0

package/dist/BaseScheduledJob.d.ts

@@ -0,0 +1,122 @@
+/**
+ * @fileoverview Base class for all scheduled job implementations
+ * @module @memberjunction/scheduling-engine
+ */
+import { ValidationResult, UserInfo } from '@memberjunction/core';
+import { ScheduledJobEntity, ScheduledJobRunEntity, ScheduledJobTypeEntity } from '@memberjunction/core-entities';
+import { ScheduledJobResult, ScheduledJobConfiguration, NotificationContent } from '@memberjunction/scheduling-base-types';
+/**
+ * Context passed to job execution
+ */
+export interface ScheduledJobExecutionContext {
+    Schedule: ScheduledJobEntity;
+    Run: ScheduledJobRunEntity;
+    ContextUser: UserInfo;
+}
+/**
+ * Abstract base class for scheduled job implementations
+ *
+ * Each ScheduledJobType in the database has a corresponding DriverClass that extends this base.
+ * The plugin is responsible for:
+ * - Parsing job-specific configuration from the Configuration JSON field
+ * - Executing the job with appropriate domain logic
+ * - Formatting notifications in a job-appropriate way
+ * - Validating job-specific configuration
+ *
+ * @abstract
+ * @example
+ * ```typescript
+ * @RegisterClass(BaseScheduledJob, 'ScheduledJobAgent')
+ * export class ScheduledJobAgent extends BaseScheduledJob {
+ *     async Execute(context: ScheduledJobExecutionContext): Promise<ScheduledJobResult> {
+ *         const config = this.parseConfiguration<AgentJobConfiguration>(context.Schedule);
+ *         const agentRun = await this.runAgent(config, context.ContextUser);
+ *         return {
+ *             Success: agentRun.Success ?? false,
+ *             ErrorMessage: agentRun.ErrorMessage,
+ *             Details: {
+ *                 AgentRunID: agentRun.ID,
+ *                 TokensUsed: agentRun.TotalTokensUsed,
+ *                 Cost: agentRun.TotalCost
+ *             }
+ *         };
+ *     }
+ * }
+ * ```
+ */
+export declare abstract class BaseScheduledJob {
+    /**
+     * Execute the scheduled job
+     *
+     * This is the main entry point for job execution. The plugin should:
+     * 1. Parse the Configuration JSON from context.Schedule
+     * 2. Perform the job-specific work
+     * 3. Return a ScheduledJobResult with Success, ErrorMessage, and Details
+     *
+     * The Details object will be serialized to JSON and stored in ScheduledJobRun.Details
+     *
+     * @param context - Execution context including schedule, run record, and user
+     * @returns Promise resolving to execution result
+     */
+    abstract Execute(context: ScheduledJobExecutionContext): Promise<ScheduledJobResult>;
+    /**
+     * Validate job-specific configuration
+     *
+     * Called when creating or updating a scheduled job to ensure the Configuration JSON
+     * is valid for this job type.
+     *
+     * @param schedule - The schedule being validated
+     * @returns Validation result with any errors or warnings
+     */
+    abstract ValidateConfiguration(schedule: ScheduledJobEntity): ValidationResult;
+    /**
+     * Format notification content for job completion
+     *
+     * Called by the engine when notifications are enabled and should be sent.
+     * The plugin can customize the notification based on the job type and execution result.
+     *
+     * @param context - Execution context
+     * @param result - The execution result
+     * @returns Notification content
+     */
+    abstract FormatNotification(context: ScheduledJobExecutionContext, result: ScheduledJobResult): NotificationContent;
+    /**
+     * Parse and validate the Configuration JSON field
+     *
+     * Helper method for plugins to parse their configuration with type safety.
+     * Throws if configuration is invalid.
+     *
+     * @template T - The configuration type
+     * @param schedule - The schedule containing the configuration
+     * @returns Parsed configuration
+     * @throws Error if configuration is missing or invalid
+     * @protected
+     */
+    protected parseConfiguration<T extends ScheduledJobConfiguration>(schedule: ScheduledJobEntity): T;
+    /**
+     * Get the job type entity for this plugin
+     *
+     * @param schedule - The schedule
+     * @param contextUser - User context
+     * @returns Promise resolving to the job type entity
+     * @protected
+     */
+    protected getJobType(schedule: ScheduledJobEntity, contextUser: UserInfo): Promise<ScheduledJobTypeEntity>;
+    /**
+     * Log execution progress
+     *
+     * @param message - Log message
+     * @param verboseOnly - Whether to only log in verbose mode
+     * @protected
+     */
+    protected log(message: string, verboseOnly?: boolean): void;
+    /**
+     * Log execution error
+     *
+     * @param message - Error message
+     * @param error - Optional error object
+     * @protected
+     */
+    protected logError(message: string, error?: any): void;
+}
+//# sourceMappingURL=BaseScheduledJob.d.ts.map

package/dist/BaseScheduledJob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseScheduledJob.d.ts","sourceRoot":"","sources":["../src/BaseScheduledJob.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAkD,gBAAgB,EAAE,QAAQ,EAAY,MAAM,sBAAsB,CAAC;AAC5H,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAClH,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAE3H;;GAEG;AACH,MAAM,WAAW,4BAA4B;IACzC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,GAAG,EAAE,qBAAqB,CAAC;IAC3B,WAAW,EAAE,QAAQ,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,8BAAsB,gBAAgB;IAClC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAEpF;;;;;;;;OAQG;IACH,QAAQ,CAAC,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,gBAAgB;IAE9E;;;;;;;;;OASG;IACH,QAAQ,CAAC,kBAAkB,CACvB,OAAO,EAAE,4BAA4B,EACrC,MAAM,EAAE,kBAAkB,GAC3B,mBAAmB;IAEtB;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,kBAAkB,CAAC,CAAC,SAAS,yBAAyB,EAC5D,QAAQ,EAAE,kBAAkB,GAC7B,CAAC;IAaJ;;;;;;;OAOG;cACa,UAAU,CACtB,QAAQ,EAAE,kBAAkB,EAC5B,WAAW,EAAE,QAAQ,GACtB,OAAO,CAAC,sBAAsB,CAAC;IAOlC;;;;;;OAMG;IACH,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,OAAe,GAAG,IAAI;IAQlE;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,IAAI;CAGzD"}

package/dist/BaseScheduledJob.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * @fileoverview Base class for all scheduled job implementations
+ * @module @memberjunction/scheduling-engine
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseScheduledJob = void 0;
+const core_1 = require("@memberjunction/core");
+/**
+ * Abstract base class for scheduled job implementations
+ *
+ * Each ScheduledJobType in the database has a corresponding DriverClass that extends this base.
+ * The plugin is responsible for:
+ * - Parsing job-specific configuration from the Configuration JSON field
+ * - Executing the job with appropriate domain logic
+ * - Formatting notifications in a job-appropriate way
+ * - Validating job-specific configuration
+ *
+ * @abstract
+ * @example
+ * ```typescript
+ * @RegisterClass(BaseScheduledJob, 'ScheduledJobAgent')
+ * export class ScheduledJobAgent extends BaseScheduledJob {
+ *     async Execute(context: ScheduledJobExecutionContext): Promise<ScheduledJobResult> {
+ *         const config = this.parseConfiguration<AgentJobConfiguration>(context.Schedule);
+ *         const agentRun = await this.runAgent(config, context.ContextUser);
+ *         return {
+ *             Success: agentRun.Success ?? false,
+ *             ErrorMessage: agentRun.ErrorMessage,
+ *             Details: {
+ *                 AgentRunID: agentRun.ID,
+ *                 TokensUsed: agentRun.TotalTokensUsed,
+ *                 Cost: agentRun.TotalCost
+ *             }
+ *         };
+ *     }
+ * }
+ * ```
+ */
+class BaseScheduledJob {
+    /**
+     * Parse and validate the Configuration JSON field
+     *
+     * Helper method for plugins to parse their configuration with type safety.
+     * Throws if configuration is invalid.
+     *
+     * @template T - The configuration type
+     * @param schedule - The schedule containing the configuration
+     * @returns Parsed configuration
+     * @throws Error if configuration is missing or invalid
+     * @protected
+     */
+    parseConfiguration(schedule) {
+        if (!schedule.Configuration) {
+            throw new Error(`Configuration is required for job type`);
+        }
+        try {
+            return JSON.parse(schedule.Configuration);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            throw new Error(`Invalid Configuration JSON: ${errorMessage}`);
+        }
+    }
+    /**
+     * Get the job type entity for this plugin
+     *
+     * @param schedule - The schedule
+     * @param contextUser - User context
+     * @returns Promise resolving to the job type entity
+     * @protected
+     */
+    async getJobType(schedule, contextUser) {
+        const md = new core_1.Metadata();
+        const jobType = await md.GetEntityObject('MJ: Scheduled Job Types', contextUser);
+        await jobType.Load(schedule.JobTypeID);
+        return jobType;
+    }
+    /**
+     * Log execution progress
+     *
+     * @param message - Log message
+     * @param verboseOnly - Whether to only log in verbose mode
+     * @protected
+     */
+    log(message, verboseOnly = false) {
+        (0, core_1.LogStatusEx)({
+            message: `[${this.constructor.name}] ${message}`,
+            verboseOnly,
+            isVerboseEnabled: () => (0, core_1.IsVerboseLoggingEnabled)()
+        });
+    }
+    /**
+     * Log execution error
+     *
+     * @param message - Error message
+     * @param error - Optional error object
+     * @protected
+     */
+    logError(message, error) {
+        (0, core_1.LogError)(`[${this.constructor.name}] ${message}`, undefined, error);
+    }
+}
+exports.BaseScheduledJob = BaseScheduledJob;
+//# sourceMappingURL=BaseScheduledJob.js.map

package/dist/BaseScheduledJob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseScheduledJob.js","sourceRoot":"","sources":["../src/BaseScheduledJob.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,+CAA4H;AAa5H;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAsB,gBAAgB;IA0ClC;;;;;;;;;;;OAWG;IACO,kBAAkB,CACxB,QAA4B;QAE5B,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,CAAC;YACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAM,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YAC9E,MAAM,IAAI,KAAK,CAAC,+BAA+B,YAAY,EAAE,CAAC,CAAC;QACnE,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACO,KAAK,CAAC,UAAU,CACtB,QAA4B,EAC5B,WAAqB;QAErB,MAAM,EAAE,GAAG,IAAI,eAAQ,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,eAAe,CAAyB,yBAAyB,EAAE,WAAW,CAAC,CAAC;QACzG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACvC,OAAO,OAAO,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACO,GAAG,CAAC,OAAe,EAAE,cAAuB,KAAK;QACvD,IAAA,kBAAW,EAAC;YACR,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,OAAO,EAAE;YAChD,WAAW;YACX,gBAAgB,EAAE,GAAG,EAAE,CAAC,IAAA,8BAAuB,GAAE;SACpD,CAAC,CAAC;IACP,CAAC;IAED;;;;;;OAMG;IACO,QAAQ,CAAC,OAAe,EAAE,KAAW;QAC3C,IAAA,eAAQ,EAAC,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACxE,CAAC;CACJ;AAhHD,4CAgHC"}

package/dist/CronExpressionHelper.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Helper utilities for cron expression evaluation
+ * @module @memberjunction/scheduling-engine
+ */
+import { ValidationResult } from '@memberjunction/core';
+/**
+ * Utility class for cron expression parsing and evaluation
+ */
+export declare class CronExpressionHelper {
+    /**
+     * Determine if a cron expression is currently due
+     *
+     * @param cronExpression - Cron expression string
+     * @param timezone - IANA timezone (e.g., 'America/Chicago')
+     * @param evalTime - Time to evaluate against
+     * @returns True if the expression is due at evalTime
+     */
+    static IsExpressionDue(cronExpression: string, timezone: string, evalTime: Date): boolean;
+    /**
+     * Get the next execution time for a cron expression
+     *
+     * @param cronExpression - Cron expression string
+     * @param timezone - IANA timezone
+     * @param fromDate - Optional date to calculate from (defaults to now)
+     * @returns Next execution date
+     */
+    static GetNextRunTime(cronExpression: string, timezone: string, fromDate?: Date): Date;
+    /**
+     * Validate a cron expression
+     *
+     * @param cronExpression - Cron expression to validate
+     * @returns Validation result
+     */
+    static ValidateExpression(cronExpression: string): ValidationResult;
+}
+//# sourceMappingURL=CronExpressionHelper.d.ts.map

package/dist/CronExpressionHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CronExpressionHelper.d.ts","sourceRoot":"","sources":["../src/CronExpressionHelper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,gBAAgB,EAA4C,MAAM,sBAAsB,CAAC;AAElG;;GAEG;AACH,qBAAa,oBAAoB;IAC7B;;;;;;;OAOG;WACW,eAAe,CACzB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,IAAI,GACf,OAAO;IAkBV;;;;;;;OAOG;WACW,cAAc,CACxB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,IAAI,GAChB,IAAI;IAcP;;;;;OAKG;WACW,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB;CA4B7E"}

package/dist/CronExpressionHelper.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * @fileoverview Helper utilities for cron expression evaluation
+ * @module @memberjunction/scheduling-engine
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CronExpressionHelper = void 0;
+const cronParser = __importStar(require("cron-parser"));
+const core_1 = require("@memberjunction/core");
+/**
+ * Utility class for cron expression parsing and evaluation
+ */
+class CronExpressionHelper {
+    /**
+     * Determine if a cron expression is currently due
+     *
+     * @param cronExpression - Cron expression string
+     * @param timezone - IANA timezone (e.g., 'America/Chicago')
+     * @param evalTime - Time to evaluate against
+     * @returns True if the expression is due at evalTime
+     */
+    static IsExpressionDue(cronExpression, timezone, evalTime) {
+        try {
+            const options = {
+                currentDate: evalTime,
+                tz: timezone
+            };
+            const interval = cronParser.parseExpression(cronExpression, options);
+            const nextExecution = interval.next().toDate();
+            // Job is due if next execution time is before or at current eval time
+            return nextExecution <= evalTime;
+        }
+        catch (error) {
+            console.error('Error evaluating cron expression:', error);
+            return false;
+        }
+    }
+    /**
+     * Get the next execution time for a cron expression
+     *
+     * @param cronExpression - Cron expression string
+     * @param timezone - IANA timezone
+     * @param fromDate - Optional date to calculate from (defaults to now)
+     * @returns Next execution date
+     */
+    static GetNextRunTime(cronExpression, timezone, fromDate) {
+        try {
+            const options = {
+                currentDate: fromDate || new Date(),
+                tz: timezone
+            };
+            const interval = cronParser.parseExpression(cronExpression, options);
+            return interval.next().toDate();
+        }
+        catch (error) {
+            throw new Error(`Failed to calculate next run time: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Validate a cron expression
+     *
+     * @param cronExpression - Cron expression to validate
+     * @returns Validation result
+     */
+    static ValidateExpression(cronExpression) {
+        const result = new core_1.ValidationResult();
+        if (!cronExpression || cronExpression.trim().length === 0) {
+            result.Errors.push(new core_1.ValidationErrorInfo('CronExpression', 'Cron expression is required', cronExpression, core_1.ValidationErrorType.Failure));
+            return result;
+        }
+        try {
+            cronParser.parseExpression(cronExpression);
+            result.Success = true;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Invalid cron expression';
+            result.Errors.push(new core_1.ValidationErrorInfo('CronExpression', errorMessage, cronExpression, core_1.ValidationErrorType.Failure));
+        }
+        return result;
+    }
+}
+exports.CronExpressionHelper = CronExpressionHelper;
+//# sourceMappingURL=CronExpressionHelper.js.map

package/dist/CronExpressionHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CronExpressionHelper.js","sourceRoot":"","sources":["../src/CronExpressionHelper.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,wDAA0C;AAC1C,+CAAkG;AAElG;;GAEG;AACH,MAAa,oBAAoB;IAC7B;;;;;;;OAOG;IACI,MAAM,CAAC,eAAe,CACzB,cAAsB,EACtB,QAAgB,EAChB,QAAc;QAEd,IAAI,CAAC;YACD,MAAM,OAAO,GAAG;gBACZ,WAAW,EAAE,QAAQ;gBACrB,EAAE,EAAE,QAAQ;aACf,CAAC;YAEF,MAAM,QAAQ,GAAG,UAAU,CAAC,eAAe,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YACrE,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;YAE/C,sEAAsE;YACtE,OAAO,aAAa,IAAI,QAAQ,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;YAC1D,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,cAAc,CACxB,cAAsB,EACtB,QAAgB,EAChB,QAAe;QAEf,IAAI,CAAC;YACD,MAAM,OAAO,GAAG;gBACZ,WAAW,EAAE,QAAQ,IAAI,IAAI,IAAI,EAAE;gBACnC,EAAE,EAAE,QAAQ;aACf,CAAC;YAEF,MAAM,QAAQ,GAAG,UAAU,CAAC,eAAe,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YACrE,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,sCAAsC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QACtH,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,kBAAkB,CAAC,cAAsB;QACnD,MAAM,MAAM,GAAG,IAAI,uBAAgB,EAAE,CAAC;QAEtC,IAAI,CAAC,cAAc,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,0BAAmB,CACtC,gBAAgB,EAChB,6BAA6B,EAC7B,cAAc,EACd,0BAAmB,CAAC,OAAO,CAC9B,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,IAAI,CAAC;YACD,UAAU,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;YAC3C,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAAC;YACxF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,0BAAmB,CACtC,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,0BAAmB,CAAC,OAAO,CAC9B,CAAC,CAAC;QACP,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ;AA3FD,oDA2FC"}

package/dist/NotificationManager.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Notification delivery manager for scheduled jobs
+ * @module @memberjunction/scheduling-engine
+ */
+import { NotificationContent, NotificationChannel } from '@memberjunction/scheduling-base-types';
+/**
+ * Manager for sending notifications about scheduled job execution
+ */
+export declare class NotificationManager {
+    /**
+     * Send a notification about a scheduled job completion
+     *
+     * @param recipientUserId - User to notify
+     * @param content - Notification content
+     * @param channels - Delivery channels (Email, InApp)
+     */
+    static SendScheduledJobNotification(recipientUserId: string, content: NotificationContent, channels: NotificationChannel[]): Promise<void>;
+}
+//# sourceMappingURL=NotificationManager.d.ts.map

package/dist/NotificationManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationManager.d.ts","sourceRoot":"","sources":["../src/NotificationManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAEjG;;GAEG;AACH,qBAAa,mBAAmB;IAC5B;;;;;;OAMG;WACiB,4BAA4B,CAC5C,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,mBAAmB,EAAE,GAChC,OAAO,CAAC,IAAI,CAAC;CAyBnB"}

package/dist/NotificationManager.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * @fileoverview Notification delivery manager for scheduled jobs
+ * @module @memberjunction/scheduling-engine
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationManager = void 0;
+const core_1 = require("@memberjunction/core");
+/**
+ * Manager for sending notifications about scheduled job execution
+ */
+class NotificationManager {
+    /**
+     * Send a notification about a scheduled job completion
+     *
+     * @param recipientUserId - User to notify
+     * @param content - Notification content
+     * @param channels - Delivery channels (Email, InApp)
+     */
+    static async SendScheduledJobNotification(recipientUserId, content, channels) {
+        // TODO: Implement actual notification delivery
+        // This will integrate with MJ's notification system once available
+        (0, core_1.LogStatus)(`[NotificationManager] Would send notification to user ${recipientUserId}`);
+        (0, core_1.LogStatus)(`  Subject: ${content.Subject}`);
+        (0, core_1.LogStatus)(`  Channels: ${channels.join(', ')}`);
+        (0, core_1.LogStatus)(`  Priority: ${content.Priority}`);
+        // Placeholder for future implementation:
+        // - Email: Use CommunicationEngine with email provider
+        // - InApp: Create InAppNotification entity record
+        // For now, just log that we would send it
+        for (const channel of channels) {
+            switch (channel) {
+                case 'Email':
+                    (0, core_1.LogStatus)(`  [Email] Body: ${content.Body.substring(0, 100)}...`);
+                    break;
+                case 'InApp':
+                    (0, core_1.LogStatus)(`  [InApp] Notification created`);
+                    break;
+            }
+        }
+    }
+}
+exports.NotificationManager = NotificationManager;
+//# sourceMappingURL=NotificationManager.js.map

package/dist/NotificationManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationManager.js","sourceRoot":"","sources":["../src/NotificationManager.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,+CAA2D;AAG3D;;GAEG;AACH,MAAa,mBAAmB;IAC5B;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAC5C,eAAuB,EACvB,OAA4B,EAC5B,QAA+B;QAE/B,+CAA+C;QAC/C,mEAAmE;QAEnE,IAAA,gBAAS,EAAC,yDAAyD,eAAe,EAAE,CAAC,CAAC;QACtF,IAAA,gBAAS,EAAC,cAAc,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3C,IAAA,gBAAS,EAAC,eAAe,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChD,IAAA,gBAAS,EAAC,eAAe,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE7C,yCAAyC;QACzC,uDAAuD;QACvD,kDAAkD;QAElD,0CAA0C;QAC1C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC7B,QAAQ,OAAO,EAAE,CAAC;gBACd,KAAK,OAAO;oBACR,IAAA,gBAAS,EAAC,mBAAmB,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;oBAClE,MAAM;gBACV,KAAK,OAAO;oBACR,IAAA,gBAAS,EAAC,gCAAgC,CAAC,CAAC;oBAC5C,MAAM;YACd,CAAC;QACL,CAAC;IACL,CAAC;CACJ;AArCD,kDAqCC"}

package/dist/ScheduledJobEngine.d.ts

@@ -0,0 +1,188 @@
+/**
+ * @fileoverview Engine for managing and executing scheduled jobs
+ * @module @memberjunction/scheduling-engine
+ */
+import { UserInfo } from '@memberjunction/core';
+import { ScheduledJobRunEntity } from '@memberjunction/core-entities';
+import { SchedulingEngineBase } from '@memberjunction/scheduling-engine-base';
+/**
+ * Engine for managing scheduled job execution
+ *
+ * This engine extends SchedulingEngineBase with execution capabilities:
+ * - Evaluates cron expressions to determine which jobs are due
+ * - Instantiates the appropriate plugin for each job type
+ * - Executes jobs and tracks results in ScheduledJobRun
+ * - Sends notifications based on job configuration
+ * - Updates job statistics (RunCount, SuccessCount, FailureCount)
+ * - Manages distributed locking for multi-server environments
+ *
+ * @description ONLY USE ON SERVER-SIDE. For metadata only, use SchedulingEngineBase which can be used anywhere.
+ *
+ * @example
+ * ```typescript
+ * const engine = SchedulingEngine.Instance;
+ * await engine.Config(false, contextUser);
+ * const runs = await engine.ExecuteScheduledJobs(contextUser);
+ * console.log(`Executed ${runs.length} scheduled jobs`);
+ * ```
+ */
+export declare class SchedulingEngine extends SchedulingEngineBase {
+    /**
+     * Get singleton instance
+     */
+    static get Instance(): SchedulingEngine;
+    private pollingTimer?;
+    private isPolling;
+    private hasInitialized;
+    /**
+     * Start continuous polling for scheduled jobs
+     * Uses adaptive interval based on ActivePollingInterval
+     *
+     * @param contextUser - User context for execution
+     */
+    StartPolling(contextUser: UserInfo): void;
+    /**
+     * Stop continuous polling
+     */
+    StopPolling(): void;
+    /**
+     * Check if polling is currently active
+     */
+    get IsPolling(): boolean;
+    /**
+     * Handle job changes (create, update, delete)
+     * Reloads job metadata and restarts polling if needed
+     *
+     * This method is called automatically by ScheduledJobEntityExtended.Save() and Delete()
+     *
+     * @param contextUser - User context for reloading metadata
+     */
+    OnJobChanged(contextUser: UserInfo): Promise<void>;
+    /**
+     * Execute all scheduled jobs that are currently due
+     *
+     * Evaluates each active job's cron expression against the current time.
+     * Jobs that are due are executed via their plugin's Execute method.
+     *
+     * @param contextUser - User context for execution
+     * @param evalTime - Optional time to evaluate against (defaults to now)
+     * @returns Array of scheduled job run records
+     */
+    ExecuteScheduledJobs(contextUser: UserInfo, evalTime?: Date): Promise<ScheduledJobRunEntity[]>;
+    /**
+     * Execute a specific scheduled job by ID
+     *
+     * @param jobId - ID of the job to execute
+     * @param contextUser - User context for execution
+     * @returns The scheduled job run record
+     */
+    ExecuteScheduledJob(jobId: string, contextUser: UserInfo): Promise<ScheduledJobRunEntity>;
+    /**
+     * Determine if a job is currently due for execution
+     *
+     * @param job - The scheduled job
+     * @param evalTime - Time to evaluate against
+     * @returns True if the job should execute now
+     * @private
+     */
+    private isJobDue;
+    /**
+     * Execute a single scheduled job
+     *
+     * @param job - The job to execute
+     * @param contextUser - User context
+     * @returns The created job run record
+     * @private
+     */
+    private executeJob;
+    /**
+     * Create a new ScheduledJobRun record
+     *
+     * @param job - The scheduled job
+     * @param contextUser - User context
+     * @returns The created run entity
+     * @private
+     */
+    private createJobRun;
+    /**
+     * Update job statistics after execution
+     *
+     * @param job - The scheduled job
+     * @param success - Whether the run succeeded
+     * @param runId - The run ID
+     * @private
+     */
+    private updateJobStatistics;
+    /**
+     * Send notifications if configured
+     *
+     * @param job - The scheduled job
+     * @param context - Execution context
+     * @param result - Execution result
+     * @param plugin - The job plugin
+     * @private
+     */
+    private sendNotificationsIfNeeded;
+    /**
+     * Try to acquire a lock for job execution
+     * Uses atomic database update to prevent race conditions
+     *
+     * @param job - The job to lock
+     * @returns True if lock acquired, false if already locked
+     * @private
+     */
+    private tryAcquireLock;
+    /**
+     * Release a lock after job execution
+     *
+     * @param job - The job to unlock
+     * @private
+     */
+    private releaseLock;
+    /**
+     * Clean up a stale lock (when ExpectedCompletionAt has passed)
+     *
+     * @param job - The job with stale lock
+     * @private
+     */
+    private cleanupStaleLock;
+    /**
+     * Create a queued job run for later execution
+     *
+     * @param job - The job to queue
+     * @param contextUser - User context
+     * @returns The queued run entity
+     * @private
+     */
+    private createQueuedJobRun;
+    /**
+     * Get unique identifier for this server instance
+     *
+     * @returns Server instance identifier
+     * @private
+     */
+    private getInstanceIdentifier;
+    /**
+     * Generate a GUID for lock tokens
+     *
+     * @returns Generated GUID
+     * @private
+     */
+    private generateGuid;
+    /**
+     * Initialize NextRunAt for jobs that don't have it set
+     * @param contextUser - User context
+     * @private
+     */
+    private initializeNextRunTimes;
+    /**
+     * Clean up stale locks on startup
+     * Releases any locks that have expired (ExpectedCompletionAt in the past)
+     * @param contextUser - User context
+     * @private
+     */
+    private cleanupStaleLocks;
+    private log;
+    private logError;
+}
+//# sourceMappingURL=ScheduledJobEngine.d.ts.map

package/dist/ScheduledJobEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScheduledJobEngine.d.ts","sourceRoot":"","sources":["../src/ScheduledJobEngine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,QAAQ,EAKX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAsB,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAG1F,OAAO,EAAE,oBAAoB,EAA4B,MAAM,wCAAwC,CAAC;AAOxG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,gBAAiB,SAAQ,oBAAoB;IACtD;;OAEG;IACH,WAAkB,QAAQ,IAAI,gBAAgB,CAE7C;IAED,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,cAAc,CAAkB;IAExC;;;;;OAKG;IACI,YAAY,CAAC,WAAW,EAAE,QAAQ,GAAG,IAAI;IA0DhD;;OAEG;IACI,WAAW,IAAI,IAAI;IAa1B;;OAEG;IACH,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED;;;;;;;OAOG;IACU,YAAY,CAAC,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAc/D;;;;;;;;;OASG;IACU,oBAAoB,CAC7B,WAAW,EAAE,QAAQ,EACrB,QAAQ,GAAE,IAAiB,GAC5B,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAkCnC;;;;;;OAMG;IACU,mBAAmB,CAC5B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,QAAQ,GACtB,OAAO,CAAC,qBAAqB,CAAC;IAWjC;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;IAkBhB;;;;;;;OAOG;YACW,UAAU;IAgGxB;;;;;;;OAOG;YACW,YAAY;IAmB1B;;;;;;;OAOG;YACW,mBAAmB;IAoBjC;;;;;;;;OAQG;YACW,yBAAyB;IAmCvC;;;;;;;OAOG;YACW,cAAc;IAsE5B;;;;;OAKG;YACW,WAAW;IAYzB;;;;;OAKG;YACW,gBAAgB;IAK9B;;;;;;;OAOG;YACW,kBAAkB;IAqBhC;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAQpB;;;;OAIG;YACW,sBAAsB;IAcpC;;;;;OAKG;YACW,iBAAiB;IAkD/B,OAAO,CAAC,GAAG;IAQX,OAAO,CAAC,QAAQ;CAGnB"}