@memberjunction/scheduling-engine 2.107.0

package/dist/drivers/ActionScheduledJobDriver.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * @fileoverview Driver for executing scheduled Action jobs
+ * @module @memberjunction/scheduling-engine
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoadActionScheduledJobDriver = exports.ActionScheduledJobDriver = void 0;
+const global_1 = require("@memberjunction/global");
+const BaseScheduledJob_1 = require("../BaseScheduledJob");
+const core_1 = require("@memberjunction/core");
+const actions_1 = require("@memberjunction/actions");
+/**
+ * Driver for executing scheduled Action jobs
+ *
+ * Configuration schema (stored in ScheduledJob.Configuration):
+ * {
+ *   ActionID: string,
+ *   Params?: Array<{
+ *     ActionParamID: string,
+ *     ValueType: 'Static' | 'SQL Statement',
+ *     Value: string
+ *   }>
+ * }
+ *
+ * Execution result details (stored in ScheduledJobRun.Details):
+ * {
+ *   ResultCode: string,
+ *   IsSuccess: boolean,
+ *   OutputParams?: any
+ * }
+ */
+let ActionScheduledJobDriver = class ActionScheduledJobDriver extends BaseScheduledJob_1.BaseScheduledJob {
+    async Execute(context) {
+        const config = this.parseConfiguration(context.Schedule);
+        // Load the action
+        await actions_1.ActionEngineServer.Instance.Config(false, context.ContextUser);
+        const action = actions_1.ActionEngineServer.Instance.Actions.find(a => a.ID === config.ActionID);
+        if (!action) {
+            throw new Error(`Action with ID ${config.ActionID} not found`);
+        }
+        this.log(`Executing action: ${action.Name}`);
+        // Process parameters (static values or SQL queries)
+        const params = await this.processParams(config.Params || [], context.ContextUser);
+        // Execute the action
+        const actionResult = await actions_1.ActionEngineServer.Instance.RunAction({
+            Action: action,
+            ContextUser: context.ContextUser,
+            Filters: [],
+            Params: params
+        });
+        return {
+            Success: actionResult.Success,
+            ErrorMessage: actionResult.Message || undefined,
+            Details: {
+                ResultCode: actionResult.Result?.ResultCode,
+                IsSuccess: actionResult.Success,
+                OutputParams: actionResult.Params
+            }
+        };
+    }
+    ValidateConfiguration(schedule) {
+        const result = new core_1.ValidationResult();
+        try {
+            const config = this.parseConfiguration(schedule);
+            if (!config.ActionID) {
+                result.Errors.push(new core_1.ValidationErrorInfo('Configuration.ActionID', 'ActionID is required', config.ActionID, core_1.ValidationErrorType.Failure));
+            }
+            // Validate params structure
+            if (config.Params) {
+                if (!Array.isArray(config.Params)) {
+                    result.Errors.push(new core_1.ValidationErrorInfo('Configuration.Params', 'Params must be an array', config.Params, core_1.ValidationErrorType.Failure));
+                }
+                else {
+                    for (let i = 0; i < config.Params.length; i++) {
+                        const param = config.Params[i];
+                        if (!param.ActionParamID) {
+                            result.Errors.push(new core_1.ValidationErrorInfo(`Configuration.Params[${i}].ActionParamID`, 'ActionParamID is required', param.ActionParamID, core_1.ValidationErrorType.Failure));
+                        }
+                        if (!param.ValueType || !['Static', 'SQL Statement'].includes(param.ValueType)) {
+                            result.Errors.push(new core_1.ValidationErrorInfo(`Configuration.Params[${i}].ValueType`, 'ValueType must be "Static" or "SQL Statement"', param.ValueType, core_1.ValidationErrorType.Failure));
+                        }
+                    }
+                }
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Invalid configuration';
+            result.Errors.push(new core_1.ValidationErrorInfo('Configuration', errorMessage, schedule.Configuration, core_1.ValidationErrorType.Failure));
+        }
+        result.Success = result.Errors.length === 0;
+        return result;
+    }
+    FormatNotification(context, result) {
+        const details = result.Details;
+        const subject = result.Success
+            ? `Scheduled Action Completed: ${context.Schedule.Name}`
+            : `Scheduled Action Failed: ${context.Schedule.Name}`;
+        const body = result.Success
+            ? `The scheduled action "${context.Schedule.Name}" completed successfully.\n\n` +
+                `Result Code: ${details?.ResultCode || 'N/A'}`
+            : `The scheduled action "${context.Schedule.Name}" failed.\n\n` +
+                `Error: ${result.ErrorMessage}`;
+        return {
+            Subject: subject,
+            Body: body,
+            Priority: result.Success ? 'Normal' : 'High',
+            Metadata: {
+                ScheduleID: context.Schedule.ID,
+                JobType: 'Action',
+                ResultCode: details?.ResultCode
+            }
+        };
+    }
+    async processParams(params, contextUser) {
+        if (!params) {
+            return [];
+        }
+        const allActionParams = actions_1.ActionEngineServer.Instance.ActionParams;
+        const result = [];
+        for (const param of params) {
+            const actionParam = allActionParams.find(p => p.ID === param.ActionParamID);
+            if (!actionParam) {
+                this.logError(`Action param ${param.ActionParamID} not found`);
+                continue;
+            }
+            let value = null;
+            switch (param.ValueType) {
+                case 'Static':
+                    // Value could be scalar or JSON
+                    const jsonValue = (0, global_1.SafeJSONParse)(param.Value);
+                    value = jsonValue !== null ? jsonValue : param.Value;
+                    break;
+                case 'SQL Statement':
+                    value = await this.executeSQL(param.Value);
+                    break;
+            }
+            result.push({
+                Name: actionParam.Name,
+                Value: value,
+                Type: actionParam.Type
+            });
+        }
+        return result;
+    }
+    async executeSQL(sql) {
+        try {
+            const sqlProvider = core_1.Metadata.Provider;
+            const result = await sqlProvider.ExecuteSQL(sql);
+            return result;
+        }
+        catch (error) {
+            this.logError(`Error executing SQL: ${sql}`, error);
+            return null;
+        }
+    }
+};
+exports.ActionScheduledJobDriver = ActionScheduledJobDriver;
+exports.ActionScheduledJobDriver = ActionScheduledJobDriver = __decorate([
+    (0, global_1.RegisterClass)(BaseScheduledJob_1.BaseScheduledJob, 'ActionScheduledJobDriver')
+], ActionScheduledJobDriver);
+/**
+ * Loader function to ensure this driver is registered
+ * Prevents tree-shaking from removing the class
+ */
+function LoadActionScheduledJobDriver() {
+    // No-op function, just ensures class is loaded
+}
+exports.LoadActionScheduledJobDriver = LoadActionScheduledJobDriver;
+//# sourceMappingURL=ActionScheduledJobDriver.js.map

package/dist/drivers/ActionScheduledJobDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionScheduledJobDriver.js","sourceRoot":"","sources":["../../src/drivers/ActionScheduledJobDriver.ts"],"names":[],"mappings":"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"}

package/dist/drivers/AgentScheduledJobDriver.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Driver for executing scheduled AI Agent jobs
+ * @module @memberjunction/scheduling-engine
+ */
+import { BaseScheduledJob, ScheduledJobExecutionContext } from '../BaseScheduledJob';
+import { ValidationResult } from '@memberjunction/core';
+import { ScheduledJobResult, NotificationContent } from '@memberjunction/scheduling-base-types';
+/**
+ * Driver for executing scheduled AI Agent jobs
+ *
+ * Configuration schema (stored in ScheduledJob.Configuration):
+ * {
+ *   AgentID: string,
+ *   ConversationID?: string,
+ *   StartingPayload?: any,
+ *   InitialMessage?: string,
+ *   ConfigurationID?: string,
+ *   OverrideModelID?: string
+ * }
+ *
+ * Execution result details (stored in ScheduledJobRun.Details):
+ * {
+ *   AgentRunID: string,
+ *   TokensUsed: number,
+ *   Cost: number,
+ *   ConversationID?: string
+ * }
+ */
+export declare class AgentScheduledJobDriver extends BaseScheduledJob {
+    Execute(context: ScheduledJobExecutionContext): Promise<ScheduledJobResult>;
+    ValidateConfiguration(schedule: any): ValidationResult;
+    FormatNotification(context: ScheduledJobExecutionContext, result: ScheduledJobResult): NotificationContent;
+    private loadAgent;
+}
+/**
+ * Loader function to ensure this driver is registered
+ * Prevents tree-shaking from removing the class
+ */
+export declare function LoadAgentScheduledJobDriver(): void;
+//# sourceMappingURL=AgentScheduledJobDriver.d.ts.map

package/dist/drivers/AgentScheduledJobDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentScheduledJobDriver.d.ts","sourceRoot":"","sources":["../../src/drivers/AgentScheduledJobDriver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAgE,MAAM,sBAAsB,CAAC;AAGtH,OAAO,EACH,kBAAkB,EAClB,mBAAmB,EAEtB,MAAM,uCAAuC,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBACa,uBAAwB,SAAQ,gBAAgB;IAC5C,OAAO,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA4CjF,qBAAqB,CAAC,QAAQ,EAAE,GAAG,GAAG,gBAAgB;IA4CtD,kBAAkB,CACrB,OAAO,EAAE,4BAA4B,EACrC,MAAM,EAAE,kBAAkB,GAC3B,mBAAmB;YA8BR,SAAS;CAW1B;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}

package/dist/drivers/AgentScheduledJobDriver.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * @fileoverview Driver for executing scheduled AI Agent jobs
+ * @module @memberjunction/scheduling-engine
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoadAgentScheduledJobDriver = exports.AgentScheduledJobDriver = void 0;
+const global_1 = require("@memberjunction/global");
+const BaseScheduledJob_1 = require("../BaseScheduledJob");
+const core_1 = require("@memberjunction/core");
+const ai_agents_1 = require("@memberjunction/ai-agents");
+/**
+ * Driver for executing scheduled AI Agent jobs
+ *
+ * Configuration schema (stored in ScheduledJob.Configuration):
+ * {
+ *   AgentID: string,
+ *   ConversationID?: string,
+ *   StartingPayload?: any,
+ *   InitialMessage?: string,
+ *   ConfigurationID?: string,
+ *   OverrideModelID?: string
+ * }
+ *
+ * Execution result details (stored in ScheduledJobRun.Details):
+ * {
+ *   AgentRunID: string,
+ *   TokensUsed: number,
+ *   Cost: number,
+ *   ConversationID?: string
+ * }
+ */
+let AgentScheduledJobDriver = class AgentScheduledJobDriver extends BaseScheduledJob_1.BaseScheduledJob {
+    async Execute(context) {
+        // Parse agent-specific configuration
+        const config = this.parseConfiguration(context.Schedule);
+        // Load the agent entity
+        const agent = await this.loadAgent(config.AgentID, context.ContextUser);
+        this.log(`Executing agent: ${agent.Name}`);
+        // Execute the agent
+        const runner = new ai_agents_1.AgentRunner();
+        // Build conversation messages - if initial message provided, add it as user message
+        const conversationMessages = config.InitialMessage
+            ? [{ role: 'user', content: config.InitialMessage }]
+            : [];
+        const result = await runner.RunAgent({
+            agent: agent,
+            conversationMessages: conversationMessages,
+            payload: config.StartingPayload,
+            contextUser: context.ContextUser
+        });
+        // Link agent run back to scheduled job run
+        if (result.agentRun.ID && context.Run.ID) {
+            result.agentRun.ScheduledJobRunID = context.Run.ID;
+            await result.agentRun.Save();
+        }
+        // Build result with agent-specific details
+        return {
+            Success: result.success,
+            ErrorMessage: result.agentRun.ErrorMessage || undefined,
+            Details: {
+                AgentRunID: result.agentRun.ID,
+                TokensUsed: result.agentRun.TotalTokensUsed,
+                Cost: result.agentRun.TotalCost,
+                ConversationID: result.agentRun.ConversationID,
+                Status: result.agentRun.Status
+            }
+        };
+    }
+    ValidateConfiguration(schedule) {
+        const result = new core_1.ValidationResult();
+        try {
+            const config = this.parseConfiguration(schedule);
+            // Validate required fields
+            if (!config.AgentID) {
+                result.Errors.push(new core_1.ValidationErrorInfo('Configuration.AgentID', 'AgentID is required', config.AgentID, core_1.ValidationErrorType.Failure));
+            }
+            // Validate StartingPayload is valid JSON if provided
+            if (config.StartingPayload) {
+                try {
+                    JSON.stringify(config.StartingPayload);
+                }
+                catch {
+                    result.Errors.push(new core_1.ValidationErrorInfo('Configuration.StartingPayload', 'StartingPayload must be valid JSON', config.StartingPayload, core_1.ValidationErrorType.Failure));
+                }
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Invalid configuration';
+            result.Errors.push(new core_1.ValidationErrorInfo('Configuration', errorMessage, schedule.Configuration, core_1.ValidationErrorType.Failure));
+        }
+        result.Success = result.Errors.length === 0;
+        return result;
+    }
+    FormatNotification(context, result) {
+        const config = this.parseConfiguration(context.Schedule);
+        const details = result.Details;
+        const subject = result.Success
+            ? `Scheduled Agent Completed: ${context.Schedule.Name}`
+            : `Scheduled Agent Failed: ${context.Schedule.Name}`;
+        const body = result.Success
+            ? `The scheduled agent "${context.Schedule.Name}" completed successfully.\n\n` +
+                `Tokens Used: ${details?.TokensUsed || 'N/A'}\n` +
+                `Cost: $${details?.Cost?.toFixed(6) || 'N/A'}\n` +
+                `Agent Run ID: ${details?.AgentRunID}`
+            : `The scheduled agent "${context.Schedule.Name}" failed.\n\n` +
+                `Error: ${result.ErrorMessage}\n` +
+                `Agent Run ID: ${details?.AgentRunID || 'N/A'}`;
+        return {
+            Subject: subject,
+            Body: body,
+            Priority: result.Success ? 'Normal' : 'High',
+            Metadata: {
+                ScheduleID: context.Schedule.ID,
+                JobType: 'Agent',
+                AgentID: config.AgentID,
+                AgentRunID: details?.AgentRunID
+            }
+        };
+    }
+    async loadAgent(agentId, contextUser) {
+        const md = new core_1.Metadata();
+        const agent = await md.GetEntityObject('AI Agents', contextUser);
+        const loaded = await agent.Load(agentId);
+        if (!loaded) {
+            throw new Error(`Agent with ID ${agentId} not found`);
+        }
+        return agent;
+    }
+};
+exports.AgentScheduledJobDriver = AgentScheduledJobDriver;
+exports.AgentScheduledJobDriver = AgentScheduledJobDriver = __decorate([
+    (0, global_1.RegisterClass)(BaseScheduledJob_1.BaseScheduledJob, 'AgentScheduledJobDriver')
+], AgentScheduledJobDriver);
+/**
+ * Loader function to ensure this driver is registered
+ * Prevents tree-shaking from removing the class
+ */
+function LoadAgentScheduledJobDriver() {
+    // No-op function, just ensures class is loaded
+}
+exports.LoadAgentScheduledJobDriver = LoadAgentScheduledJobDriver;
+//# sourceMappingURL=AgentScheduledJobDriver.js.map

package/dist/drivers/AgentScheduledJobDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentScheduledJobDriver.js","sourceRoot":"","sources":["../../src/drivers/AgentScheduledJobDriver.ts"],"names":[],"mappings":"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"}

package/dist/drivers/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Export all scheduled job drivers
+ * @module @memberjunction/scheduling-engine
+ */
+export * from './AgentScheduledJobDriver';
+export * from './ActionScheduledJobDriver';
+/**
+ * Loader function to ensure all drivers are registered
+ * Call this at application startup to prevent tree-shaking
+ */
+export declare function LoadScheduledJobDrivers(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/drivers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/drivers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C"}

package/dist/drivers/index.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * @fileoverview Export all scheduled job drivers
+ * @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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoadScheduledJobDrivers = void 0;
+const AgentScheduledJobDriver_1 = require("./AgentScheduledJobDriver");
+const ActionScheduledJobDriver_1 = require("./ActionScheduledJobDriver");
+__exportStar(require("./AgentScheduledJobDriver"), exports);
+__exportStar(require("./ActionScheduledJobDriver"), exports);
+/**
+ * Loader function to ensure all drivers are registered
+ * Call this at application startup to prevent tree-shaking
+ */
+function LoadScheduledJobDrivers() {
+    (0, AgentScheduledJobDriver_1.LoadAgentScheduledJobDriver)();
+    (0, ActionScheduledJobDriver_1.LoadActionScheduledJobDriver)();
+}
+exports.LoadScheduledJobDrivers = LoadScheduledJobDrivers;
+//# sourceMappingURL=index.js.map

package/dist/drivers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/drivers/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,uEAAwE;AACxE,yEAA0E;AAE1E,4DAA0C;AAC1C,6DAA2C;AAE3C;;;GAGG;AACH,SAAgB,uBAAuB;IACnC,IAAA,qDAA2B,GAAE,CAAC;IAC9B,IAAA,uDAA4B,GAAE,CAAC;AACnC,CAAC;AAHD,0DAGC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview Main export for Scheduling Engine
+ * @module @memberjunction/scheduling-engine
+ */
+export * from './BaseScheduledJob';
+export * from './ScheduledJobEngine';
+export * from './CronExpressionHelper';
+export * from './NotificationManager';
+export * from './drivers';
+/**
+ * Loader function to ensure all drivers and extended entities are registered
+ * Call this at application startup
+ */
+export declare function LoadSchedulingEngine(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAE1B;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAG3C"}

package/dist/index.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * @fileoverview Main export for Scheduling Engine
+ * @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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoadSchedulingEngine = void 0;
+const drivers_1 = require("./drivers");
+const scheduling_engine_base_1 = require("@memberjunction/scheduling-engine-base");
+__exportStar(require("./BaseScheduledJob"), exports);
+__exportStar(require("./ScheduledJobEngine"), exports);
+__exportStar(require("./CronExpressionHelper"), exports);
+__exportStar(require("./NotificationManager"), exports);
+__exportStar(require("./drivers"), exports);
+/**
+ * Loader function to ensure all drivers and extended entities are registered
+ * Call this at application startup
+ */
+function LoadSchedulingEngine() {
+    (0, scheduling_engine_base_1.LoadBaseSchedulingEngine)();
+    (0, drivers_1.LoadScheduledJobDrivers)();
+}
+exports.LoadSchedulingEngine = LoadSchedulingEngine;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,uCAAoD;AACpD,mFAAkF;AAElF,qDAAmC;AACnC,uDAAqC;AACrC,yDAAuC;AACvC,wDAAsC;AACtC,4CAA0B;AAE1B;;;GAGG;AACH,SAAgB,oBAAoB;IAChC,IAAA,iDAAwB,GAAE,CAAC;IAC3B,IAAA,iCAAuB,GAAE,CAAC;AAC9B,CAAC;AAHD,oDAGC"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@memberjunction/scheduling-engine",
+  "version": "2.107.0",
+  "description": "MemberJunction: Scheduling Engine - core engine for executing scheduled jobs with plugin architecture",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch"
+  },
+  "author": "MemberJunction.com",
+  "license": "ISC",
+  "dependencies": {
+    "@memberjunction/core": "2.100.3",
+    "@memberjunction/core-entities": "2.107.0",
+    "@memberjunction/global": "2.100.3",
+    "@memberjunction/scheduling-base-types": "2.107.0",
+    "@memberjunction/scheduling-engine-base": "2.107.0",
+    "@memberjunction/ai-agents": "2.107.0",
+    "@memberjunction/actions": "2.107.0",
+    "@memberjunction/sqlserver-dataprovider": "2.107.0",
+    "cron-parser": "^4.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "20.14.2",
+    "typescript": "^5.4.5"
+  }
+}