@memberjunction/scheduling-base-types

Core type definitions for MemberJunction's scheduled jobs system. This lightweight package provides interfaces and type aliases used throughout the scheduling stack, with no heavy dependencies.

Architecture

graph TD
    A["@memberjunction/scheduling-base-types
(Types Only)"]
    B["@memberjunction/scheduling-engine-base
(Metadata Cache)"] --> A
    C["@memberjunction/scheduling-engine
(Execution)"] --> A
    D["@memberjunction/scheduling-actions
(Agentic Tools)"] --> A

    style A fill:#2d6a9f,stroke:#1a4971,color:#fff
    style B fill:#2d8659,stroke:#1a5c3a,color:#fff
    style C fill:#7c5295,stroke:#563a6b,color:#fff
    style D fill:#b8762f,stroke:#8a5722,color:#fff
Copy

Overview

This package defines the shared type contracts used across the entire scheduling subsystem. It is designed to be imported anywhere (client or server) without pulling in execution logic or heavy framework dependencies.

Exported types:

• ScheduledJobResult: Result returned by a scheduled job execution, including success/failure, error messages, and job-type-specific details
• ScheduledJobConfiguration: Base interface for job-specific configuration JSON
• AgentJobConfiguration: Configuration for AI Agent scheduled jobs (AgentID, ConversationID, etc.)
• ActionJobConfiguration: Configuration for Action scheduled jobs (ActionID, Params, etc.)
• NotificationContent: Structure for job notification messages (Subject, Body, Priority)
• ScheduledJobRunStatus: Union type for run statuses (Running, Completed, Failed, Cancelled, Timeout)
• ScheduledJobStatus: Union type for schedule statuses (Pending, Active, Paused, Disabled, Expired)
• NotificationChannel: Union type for notification delivery (Email, InApp)

Installation

npm install @memberjunction/scheduling-base-types
Copy

Usage

import {
    ScheduledJobResult,
    AgentJobConfiguration,
    ActionJobConfiguration,
    ScheduledJobRunStatus,
    NotificationContent
} from '@memberjunction/scheduling-base-types';

// Job result from execution
const result: ScheduledJobResult = {
    Success: true,
    Details: {
        AgentRunID: 'run-guid',
        TokensUsed: 1500,
        Cost: 0.023
    }
};

// Agent job configuration
const agentConfig: AgentJobConfiguration = {
    AgentID: 'agent-guid',
    InitialMessage: 'Generate daily report',
    ConfigurationID: 'config-guid'
};

// Action job configuration
const actionConfig: ActionJobConfiguration = {
    ActionID: 'action-guid',
    Params: [
        { ActionParamID: 'param-1', ValueType: 'Static', Value: '42' },
        { ActionParamID: 'param-2', ValueType: 'SQL Statement', Value: 'SELECT TOP 1 ID FROM Users' }
    ]
};
Copy

Type Reference

ScheduledJobResult

Status Types

Dependencies

License

ISC