nest-scheduler-engine 2.0.0 → 3.1.0

package/CHANGELOG.md

@@ -120,6 +120,48 @@ This is a major release with comprehensive production-grade features, fault tole
 - Added inline documentation for all new utilities
 - Test examples and patterns
 
+## [2.1.0] - 2026-04-12
+
+### Added
+
+- **Declarative Cron Jobs**: new `@Cron` method decorator to declare cron-style schedules directly on provider methods. The decorator converts a 5-field cron expression into an RRULE and schedules a recurring event using the engine. Decorator options include `name`, `timezone`, `payload`, `startDate`, `endDate`, `enabled`, and `recoverMissedExecutions`.
+
+### Notes
+
+- Initial implementation performs in-memory discovery at bootstrap and schedules idempotently using `cron:<eventTypeName>` idempotency keys. Persistent cron metadata, advanced missed-execution recovery, and full timezone persistence are planned next.
+
+
+## [3.0.0] - 2026-04-12
+
+### Added
+
+- **Priority & Concurrency Control**: Added `priority` and `maxConcurrency` fields to event types to control execution order and limits per event type.
+- **Bulk Scheduling API**: Implemented `scheduleEvents` with transaction support and `PARTIAL_SUCCESS` mode for partial failures.
+- **Middleware System**: Added a middleware pipeline allowing injection of custom logic (logging, tracing, auth, metrics) into the handler execution path.
+- **Polling Engine Enhancements**: Polling now orders events by priority and enforces concurrency limits while selecting events.
+- **Concurrency Manager Service**: New `ConcurrencyManager` to track and enforce per-event-type concurrency counts across instances.
+- **Tests & Docs**: Unit tests added for bulk scheduling, middleware, and priority/concurrency; README updated with examples.
+
+### Changed
+
+- Package version bumped to `3.0.0` with Node.js >= 18 requirement retained.
+
+### Notes
+
+- These features enable more predictable scheduling in mixed workloads (high-priority vs background jobs) and safer horizontal scaling by enforcing concurrency limits.
+
+
+## [3.1.0] - 2026-04-12
+
+### Added
+
+- **Declarative Cron Jobs**: `@Cron` method decorator to declare cron-style schedules directly on provider methods. The decorator converts a 5-field cron expression into an RRULE and schedules a recurring event using the engine. Decorator options include `name`, `timezone`, `payload`, `startDate`, `endDate`, `enabled`, and `recoverMissedExecutions`.
+
+### Notes
+
+- Initial implementation performs discovery at module init and schedules idempotently using `cron:<eventTypeName>` idempotency keys. Persistent cron metadata, advanced missed-execution recovery, and full timezone persistence are planned next.
+
+
 ### Migration Guide from 1.x to 2.x
 
 #### Breaking Changes

package/README.md

@@ -2,7 +2,7 @@
 
 A production-grade, event-type-driven scheduling engine for NestJS applications. This package provides a flexible and scalable solution for scheduling and executing recurring and one-time events with built-in fault tolerance, retry logic, dead-letter handling, and RRULE support (RFC 5545).
 
-> **Version 2.0.0** - Now with production-grade features including circuit breakers, health checks, graceful shutdown, and comprehensive error handling. See [CHANGELOG.md](CHANGELOG.md) for migration guide.
+> **Version 3.1.0** - Adds declarative Cron decorator and production features (priority/concurrency). See [CHANGELOG.md](CHANGELOG.md) for details and migration guide.
 
 ## Features
 
@@ -14,8 +14,9 @@ A production-grade, event-type-driven scheduling engine for NestJS applications.
 - **RRULE Support** - RFC 5545 compliant recurrence rules for complex recurring schedules.
 - **Framework-Agnostic Core** - Core logic is framework-agnostic with a NestJS wrapper module.
 - **Horizontal Scalability** - Multiple instances can run concurrently with database-level locking.
+- **Persistent Storage** - All scheduler state (event types, event instances, execution history, dead letters, and cron metadata) is persisted in the consumer database via the `IDatabaseAdapter` you provide. This ensures scheduled jobs survive process restarts and multiple instances coordinate safely using database locks and idempotency keys.
 
-### Production Features (v2.0.0+)
+### Production Features (v3.0.0+)
 - **Fault Tolerance** - Circuit breaker pattern prevents cascading failures and protects downstream systems.
 - **Advanced Retry** - Exponential backoff with jitter and capped delays for optimal retry behavior.
 - **Health Checks** - Component-level health monitoring for database, queue, poller, and dispatcher.
@@ -27,6 +28,9 @@ A production-grade, event-type-driven scheduling engine for NestJS applications.
 - **Observability Hooks** - Lifecycle hooks for monitoring, alerting, and audit logging.
 - **Edge Case Handling** - Comprehensive validation for dates, RRULE, payloads, state transitions, and more. See [EDGE_CASES.md](EDGE_CASES.md).
 
+- **Persistent DB-backed State** - Scheduler persists event types, instances, execution history, and dead letters via the provided `IDatabaseAdapter`. Persistent state enables recovery after restarts, safe horizontal scaling, and idempotent scheduling operations (use shipped migrations and `tablePrefix` to namespace tables).
+
+
 ## Installation
 
 ```bash
@@ -278,6 +282,32 @@ export class NotificationService {
 }
 ```
 
+### Declarative Cron Jobs (new)
+
+You can declare cron-style scheduled jobs using the `@Cron` method decorator. The decorator converts a standard 5-field cron expression into an RRULE and schedules it through the engine.
+
+Example:
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { Cron } from 'nest-scheduler-engine/decorators/cron.decorator';
+
+@Injectable()
+export class JobsService {
+  @Cron('0 9 * * *', { name: 'DAILY_SUMMARY', timezone: 'America/Los_Angeles' })
+  async handleDailySummary() {
+    // business logic executed by the scheduler engine
+  }
+}
+```
+
+Notes:
+- The decorator converts the cron expression to an RRULE (RFC 5545) using an internal converter and schedules a recurring event.
+- Each decorated method is registered as an event handler and mapped to a unique event type.
+- Scheduling is idempotent: by default a cron job uses an idempotency key `cron:<eventTypeName>` to avoid duplicate scheduled instances on bootstrap.
+- The discovery currently runs at module init and will create the event type and schedule the recurring event if it does not already exist.
+- Advanced features (persistent cron metadata table, timezone persistence, missed-execution recovery and versioning) are planned and will be enabled progressively; basic decorator + idempotent scheduling is available now.
+
 ## API Reference
 
 ### SchedulerService
@@ -310,6 +340,193 @@ Main service for interacting with the scheduler.
 - `listDeadLetters(): Promise<DeadLetter[]>`
 - `retryDeadLetter(id: string): Promise<EventInstance>`
 
+#### Bulk Scheduling (v2.1.0+)
+
+- `scheduleEvents(inputs: ScheduleEventInput[], options?: BulkScheduleOptions): Promise<EventInstance[]>`
+
+#### Middleware
+
+- `use(middleware: MiddlewareFunction | IMiddleware): void`
+
+## High-ROI Features (v2.1.0+)
+
+### Priority + Concurrency Control
+
+Control execution priority and limit concurrent executions per event type.
+
+**Create Event Types with Priority:**
+
+```typescript
+// High priority events execute first
+const urgentEventType = await scheduler.createEventType({
+  name: 'URGENT_NOTIFICATION',
+  description: 'Critical user notifications',
+  priority: 10,          // Higher = higher priority (default: 0)
+  maxConcurrency: 5,     // Max 5 concurrent executions (default: null = unlimited)
+});
+
+// Low priority background jobs
+const backgroundEventType = await scheduler.createEventType({
+  name: 'BACKGROUND_SYNC',
+  description: 'Background data sync',
+  priority: 1,           // Lower priority
+  maxConcurrency: 2,     // Limit to 2 concurrent executions
+});
+```
+
+**How it works:**
+- Polling engine orders events by `priority DESC, next_run_at ASC`
+- Higher priority events are picked first
+- `maxConcurrency` prevents resource exhaustion:
+  - `null` or `undefined` = unlimited (default)
+  - `> 0` = maximum concurrent executions
+  - `= 0` = event type disabled
+- Prevents starvation of low-priority events through fair scheduling
+- Distributed-safe: Uses database queries to track concurrency
+
+**Use Cases:**
+- Critical user notifications (high priority)
+- Background cleanup jobs (low priority)
+- Rate-limited API calls (maxConcurrency = 1)
+- Resource-intensive tasks (maxConcurrency = 3)
+
+### Bulk Scheduling API
+
+Schedule thousands of events efficiently in a single operation.
+
+```typescript
+// Prepare batch of events
+const events = users.map(user => ({
+  eventTypeName: 'WELCOME_EMAIL',
+  payload: { userId: user.id, email: user.email },
+  scheduleType: ScheduleType.ONE_TIME,
+  scheduledAt: new Date(Date.now() + 3600000), // 1 hour from now
+  idempotencyKey: `welcome-${user.id}`,        // Prevent duplicates
+}));
+
+// FAIL_ALL mode: Transaction-safe, rolls back if any event fails
+const scheduled = await scheduler.scheduleEvents(events, { mode: 'FAIL_ALL' });
+
+// PARTIAL_SUCCESS mode: Continues on errors
+const scheduled = await scheduler.scheduleEvents(events, { mode: 'PARTIAL_SUCCESS' });
+```
+
+**Features:**
+- **Transaction Support**: FAIL_ALL mode uses single transaction
+- **Partial Success**: PARTIAL_SUCCESS mode processes valid events
+- **Validation**: All inputs validated before processing
+- **Idempotency**: Detects duplicate idempotency keys in batch
+- **Performance**: Optimized for 1000+ events
+
+**Options:**
+- `mode: 'FAIL_ALL'` (default): All-or-nothing transaction
+- `mode: 'PARTIAL_SUCCESS'`: Returns successful events, logs failures
+
+**Use Cases:**
+- Onboarding campaigns (bulk welcome emails)
+- Batch reporting jobs
+- Mass reminders/notifications
+- Data migration scheduling
+
+### Middleware System
+
+Inject custom logic into the event execution pipeline.
+
+**Register Middleware:**
+
+```typescript
+// Logging middleware
+scheduler.use(async (ctx, next) => {
+  console.log(`[START] ${ctx.eventType} - ${ctx.eventId}`);
+  const start = Date.now();
+  
+  await next(); // Call next middleware or handler
+  
+  const duration = Date.now() - start;
+  console.log(`[END] ${ctx.eventType} - ${duration}ms`);
+});
+
+// Tracing middleware (e.g., OpenTelemetry)
+scheduler.use(async (ctx, next) => {
+  const span = tracer.startSpan(ctx.eventType, {
+    attributes: {
+      'event.id': ctx.eventId,
+      'event.type': ctx.eventType,
+      'event.attempt': ctx.attemptNumber,
+      'event.correlation_id': ctx.correlationId,
+    },
+  });
+  
+  try {
+    await next();
+    span.setStatus({ code: SpanStatusCode.OK });
+  } catch (error) {
+    span.recordException(error);
+    span.setStatus({ code: SpanStatusCode.ERROR });
+    throw error;
+  } finally {
+    span.end();
+  }
+});
+
+// Authentication/authorization middleware
+scheduler.use(async (ctx, next) => {
+  if (ctx.payload.requiresAuth) {
+    await validateAuthToken(ctx.payload.token);
+  }
+  await next();
+});
+```
+
+**Middleware Context:**
+
+```typescript
+interface MiddlewareContext {
+  eventId: string;           // Unique event instance ID
+  eventType: string;         // Event type name
+  payload: Record<string, any>;  // Event payload
+  attemptNumber: number;     // Current execution attempt
+  correlationId: string;     // Correlation ID for tracing
+  scheduledAt: Date;         // Original scheduled time
+  startedAt: Date;           // Execution start time
+}
+```
+
+**Class-based Middleware:**
+
+```typescript
+class MetricsMiddleware implements IMiddleware {
+  async use(ctx: MiddlewareContext, next: NextFunction) {
+    metrics.increment('events.started', { type: ctx.eventType });
+    
+    try {
+      await next();
+      metrics.increment('events.succeeded', { type: ctx.eventType });
+    } catch (error) {
+      metrics.increment('events.failed', { type: ctx.eventType });
+      throw error;
+    }
+  }
+}
+
+scheduler.use(new MetricsMiddleware());
+```
+
+**Features:**
+- **Execution Order**: Middleware executes in registration order
+- **Pre/Post Processing**: Code before `next()` runs first, code after runs last
+- **Error Propagation**: Errors bubble up through middleware chain
+- **Async Support**: Full async/await support
+- **No Breaking Changes**: Existing handlers work unchanged
+
+**Use Cases:**
+- Distributed tracing (OpenTelemetry, Jaeger)
+- Performance monitoring (execution times)
+- Payload validation/transformation
+- Authentication/authorization
+- Custom logging and audit trails
+- Analytics and metrics collection
+
 ## Production Features
 
 ### Error Handling
@@ -695,6 +912,12 @@ The package creates the following tables:
 
 All tables support an optional prefix via `tablePrefix` config option.
 
+Persistence note:
+
+- All scheduler state (event types, event instances, execution history, dead letters) is persisted to your database via the `IDatabaseAdapter` you provide. The package does not create or manage database connections itself — consumers must supply an adapter implementation (see `src/interfaces/database-adapter.interface.ts`) that performs `query` and `transaction` operations against their chosen database client. This ensures scheduled jobs survive process restarts and can be safely scaled across multiple instances: locks, idempotency keys, and database transactions provide distributed-safety for scheduling operations.
+
+Be sure to run the shipped migrations and set `tablePrefix` if you want to namespace tables in a shared schema.
+
 ## What's New in v2.0.0
 
 Version 2.0.0 brings production-grade features and comprehensive testing:

package/dist/constants.d.ts

@@ -0,0 +1,29 @@
+export declare const DEFAULTS: {
+    POLLING_INTERVAL_MS: number;
+    LOCK_DURATION_MS: number;
+    BATCH_SIZE: number;
+    MAX_BATCH_SIZE: number;
+    CONCURRENCY: number;
+    HANDLER_TIMEOUT_MS: number;
+    GRACE_PERIOD_MS: number;
+    RRULE_MAX_COMPUTATION_ATTEMPTS: number;
+    RRULE_MAX_OCCURRENCES: number;
+    RRULE_MAX_COMPUTATION_TIME_MS: number;
+    RRULE_MAX_FUTURE_YEARS: number;
+    MAX_PAYLOAD_DEPTH: number;
+    MAX_PAYLOAD_PREVIEW_CHARS: number;
+    MAX_PAYLOAD_SIZE_BYTES: number;
+    SQS_MAX_PAYLOAD_BYTES: number;
+    RETRY_BASE_DELAY_MS: number;
+    RETRY_MAX_DELAY_MS: number;
+    CIRCUIT_BREAKER_RESET_MS: number;
+    CIRCUIT_BREAKER_TIMEOUT_MS: number;
+    MAX_FUTURE_DATE: Date;
+    MIN_PAST_DATE: Date;
+    INTERVAL_MAX: number;
+    COUNT_MAX: number;
+    RETRY_DELAY_MAX_MS: number;
+    EVENT_TYPE_NAME_MAX_LENGTH: number;
+    IDEMPOTENCY_KEY_MAX_LENGTH: number;
+};
+export default DEFAULTS;

package/dist/constants.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULTS = void 0;
+exports.DEFAULTS = {
+    POLLING_INTERVAL_MS: 5000,
+    LOCK_DURATION_MS: 30000,
+    BATCH_SIZE: 50,
+    MAX_BATCH_SIZE: 1000,
+    CONCURRENCY: 10,
+    HANDLER_TIMEOUT_MS: 300000,
+    GRACE_PERIOD_MS: 30000,
+    RRULE_MAX_COMPUTATION_ATTEMPTS: 10,
+    RRULE_MAX_OCCURRENCES: 1000,
+    RRULE_MAX_COMPUTATION_TIME_MS: 5000,
+    RRULE_MAX_FUTURE_YEARS: 100,
+    MAX_PAYLOAD_DEPTH: 10,
+    MAX_PAYLOAD_PREVIEW_CHARS: 100,
+    MAX_PAYLOAD_SIZE_BYTES: 2 * 1024 * 1024,
+    SQS_MAX_PAYLOAD_BYTES: 256 * 1024,
+    RETRY_BASE_DELAY_MS: 1000,
+    RETRY_MAX_DELAY_MS: 5 * 60 * 1000,
+    CIRCUIT_BREAKER_RESET_MS: 30000,
+    CIRCUIT_BREAKER_TIMEOUT_MS: 60000,
+    MAX_FUTURE_DATE: new Date('2099-12-31T23:59:59.999Z'),
+    MIN_PAST_DATE: new Date('2000-01-01T00:00:00.000Z'),
+    INTERVAL_MAX: 1000,
+    COUNT_MAX: 100000,
+    RETRY_DELAY_MAX_MS: 24 * 60 * 60 * 1000,
+    EVENT_TYPE_NAME_MAX_LENGTH: 255,
+    IDEMPOTENCY_KEY_MAX_LENGTH: 255,
+};
+exports.default = exports.DEFAULTS;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAIa,QAAA,QAAQ,GAAG;IAEtB,mBAAmB,EAAE,IAAI;IACzB,gBAAgB,EAAE,KAAK;IACvB,UAAU,EAAE,EAAE;IACd,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,EAAE;IAGf,kBAAkB,EAAE,MAAM;IAG1B,eAAe,EAAE,KAAK;IAGtB,8BAA8B,EAAE,EAAE;IAClC,qBAAqB,EAAE,IAAI;IAC3B,6BAA6B,EAAE,IAAI;IACnC,sBAAsB,EAAE,GAAG;IAG3B,iBAAiB,EAAE,EAAE;IACrB,yBAAyB,EAAE,GAAG;IAC9B,sBAAsB,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IACvC,qBAAqB,EAAE,GAAG,GAAG,IAAI;IAGjC,mBAAmB,EAAE,IAAI;IACzB,kBAAkB,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI;IAGjC,wBAAwB,EAAE,KAAK;IAC/B,0BAA0B,EAAE,KAAK;IAGjC,eAAe,EAAE,IAAI,IAAI,CAAC,0BAA0B,CAAC;IACrD,aAAa,EAAE,IAAI,IAAI,CAAC,0BAA0B,CAAC;IACnD,YAAY,EAAE,IAAI;IAClB,SAAS,EAAE,MAAM;IACjB,kBAAkB,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IAGvC,0BAA0B,EAAE,GAAG;IAC/B,0BAA0B,EAAE,GAAG;CAChC,CAAC;AAEF,kBAAe,gBAAQ,CAAC"}

package/dist/decorators/cron.decorator.d.ts

@@ -0,0 +1,11 @@
+export declare const CRON_METADATA = "scheduler:cron";
+export interface CronOptions {
+    name?: string;
+    timezone?: string;
+    payload?: Record<string, any>;
+    startDate?: Date;
+    endDate?: Date;
+    enabled?: boolean;
+    recoverMissedExecutions?: boolean;
+}
+export declare function Cron(expression: string, options?: CronOptions): MethodDecorator;

package/dist/decorators/cron.decorator.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CRON_METADATA = void 0;
+exports.Cron = Cron;
+const common_1 = require("@nestjs/common");
+exports.CRON_METADATA = 'scheduler:cron';
+function Cron(expression, options = {}) {
+    return (target, propertyKey, descriptor) => {
+        (0, common_1.SetMetadata)(exports.CRON_METADATA, { expression, options })(descriptor.value);
+    };
+}
+//# sourceMappingURL=cron.decorator.js.map

package/dist/decorators/cron.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.decorator.js","sourceRoot":"","sources":["../../src/decorators/cron.decorator.ts"],"names":[],"mappings":";;;AAcA,oBAIC;AAlBD,2CAA6C;AAEhC,QAAA,aAAa,GAAG,gBAAgB,CAAC;AAY9C,SAAgB,IAAI,CAAC,UAAkB,EAAE,UAAuB,EAAE;IAChE,OAAO,CAAC,MAAW,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;QACnF,IAAA,oBAAW,EAAC,qBAAa,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -6,9 +6,10 @@ export type { IQueueAdapter, QueueMessage, } from './interfaces/queue-adapter.in
 export type { ILoggerAdapter } from './interfaces/logger-adapter.interface';
 export type { ICacheAdapter } from './interfaces/cache-adapter.interface';
 export type { IEventHandler, HandlerResult, ExecutionContext, } from './interfaces/event-handler.interface';
+export type { MiddlewareContext, MiddlewareFunction, NextFunction, IMiddleware, } from './interfaces/middleware.interface';
 export type { SchedulerConfig, SchedulerHooks, SchedulerModuleOptions, SchedulerModuleAsyncOptions, AdapterProvider, } from './interfaces/config.interface';
 export { EventStatus, ScheduleType, RetryBackoff, ExecutionStatus, } from './types/enums';
-export type { RetryPolicy, CreateEventTypeInput, ScheduleEventInput, EventFilters, PaginatedResult, } from './types/inputs';
+export type { RetryPolicy, CreateEventTypeInput, ScheduleEventInput, BulkScheduleOptions, EventFilters, PaginatedResult, } from './types/inputs';
 export { EventType } from './models/event-type.model';
 export { EventInstance } from './models/event-instance.model';
 export { EventExecution } from './models/event-execution.model';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAGxB,kEAAgE;AAAvD,qHAAA,gBAAgB,OAAA;AAGzB,gFAAoE;AAA3D,uHAAA,YAAY,OAAA;AAgCrB,uCAKuB;AAJrB,oGAAA,WAAW,OAAA;AACX,qGAAA,YAAY,OAAA;AACZ,qGAAA,YAAY,OAAA;AACZ,wGAAA,eAAe,OAAA;AAYjB,8DAAsD;AAA7C,6GAAA,SAAS,OAAA;AAClB,sEAA8D;AAArD,qHAAA,aAAa,OAAA;AACtB,wEAAgE;AAAvD,uHAAA,cAAc,OAAA;AACvB,gEAAwD;AAA/C,+GAAA,UAAU,OAAA;AAGnB,2CAA0E;AAAjE,2GAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAGxB,kEAAgE;AAAvD,qHAAA,gBAAgB,OAAA;AAGzB,gFAAoE;AAA3D,uHAAA,YAAY,OAAA;AAuCrB,uCAKuB;AAJrB,oGAAA,WAAW,OAAA;AACX,qGAAA,YAAY,OAAA;AACZ,qGAAA,YAAY,OAAA;AACZ,wGAAA,eAAe,OAAA;AAajB,8DAAsD;AAA7C,6GAAA,SAAS,OAAA;AAClB,sEAA8D;AAArD,qHAAA,aAAa,OAAA;AACtB,wEAAgE;AAAvD,uHAAA,cAAc,OAAA;AACvB,gEAAwD;AAA/C,+GAAA,UAAU,OAAA;AAGnB,2CAA0E;AAAjE,2GAAA,aAAa,OAAA"}

package/dist/interfaces/middleware.interface.d.ts

@@ -0,0 +1,14 @@
+export interface MiddlewareContext {
+    eventId: string;
+    eventType: string;
+    payload: Record<string, any>;
+    attemptNumber: number;
+    correlationId: string;
+    scheduledAt: Date;
+    startedAt: Date;
+}
+export type NextFunction = () => Promise<void>;
+export type MiddlewareFunction = (ctx: MiddlewareContext, next: NextFunction) => Promise<void>;
+export interface IMiddleware {
+    use(ctx: MiddlewareContext, next: NextFunction): Promise<void>;
+}

package/dist/interfaces/middleware.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=middleware.interface.js.map

package/dist/interfaces/middleware.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.interface.js","sourceRoot":"","sources":["../../src/interfaces/middleware.interface.ts"],"names":[],"mappings":""}

package/dist/migrations/index.js

@@ -40,6 +40,8 @@ CREATE TABLE IF NOT EXISTS ${prefix}event_types (
   retry_max INTEGER DEFAULT 3,
   retry_delay_ms INTEGER DEFAULT 5000,
   retry_backoff VARCHAR(20) DEFAULT 'exponential',
+  priority INTEGER NOT NULL DEFAULT 0,
+  max_concurrency INTEGER DEFAULT NULL,
   created_at TIMESTAMPTZ DEFAULT NOW(),
   updated_at TIMESTAMPTZ DEFAULT NOW()
 );
@@ -128,6 +130,10 @@ CREATE INDEX IF NOT EXISTS idx_${prefix}dead_letters_instance
 -- Index for status queries
 CREATE INDEX IF NOT EXISTS idx_${prefix}event_instances_status
   ON ${prefix}event_instances (status);
+
+-- Index for priority ordering
+CREATE INDEX IF NOT EXISTS idx_${prefix}event_types_priority
+  ON ${prefix}event_types (priority DESC);
 `.trim();
 }
 function getCreateIndexesDown(prefix) {
@@ -137,6 +143,7 @@ DROP INDEX IF EXISTS idx_${prefix}event_instances_type;
 DROP INDEX IF EXISTS idx_${prefix}event_executions_instance;
 DROP INDEX IF EXISTS idx_${prefix}dead_letters_instance;
 DROP INDEX IF EXISTS idx_${prefix}event_instances_status;
+DROP INDEX IF EXISTS idx_${prefix}event_types_priority;
 `.trim();
 }
 //# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":";;AAmBA,sCA8BC;AA9BD,SAAgB,aAAa,CAAC,UAA4B,EAAE;IAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;IAEzC,OAAO;QACL;YACE,OAAO,EAAE,wBAAwB;YACjC,EAAE,EAAE,qBAAqB,CAAC,MAAM,CAAC;YACjC,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC;SACtC;QACD;YACE,OAAO,EAAE,4BAA4B;YACrC,EAAE,EAAE,yBAAyB,CAAC,MAAM,CAAC;YACrC,IAAI,EAAE,2BAA2B,CAAC,MAAM,CAAC;SAC1C;QACD;YACE,OAAO,EAAE,6BAA6B;YACtC,EAAE,EAAE,0BAA0B,CAAC,MAAM,CAAC;YACtC,IAAI,EAAE,4BAA4B,CAAC,MAAM,CAAC;SAC3C;QACD;YACE,OAAO,EAAE,yBAAyB;YAClC,EAAE,EAAE,sBAAsB,CAAC,MAAM,CAAC;YAClC,IAAI,EAAE,wBAAwB,CAAC,MAAM,CAAC;SACvC;QACD;YACE,OAAO,EAAE,oBAAoB;YAC7B,EAAE,EAAE,kBAAkB,CAAC,MAAM,CAAC;YAC9B,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC;SACnC;KACF,CAAC;AACJ,CAAC;AAGD,SAAS,qBAAqB,CAAC,MAAc;IAC3C,OAAO;6BACoB,MAAM;;;;;;;;;;CAUlC,CAAC,IAAI,EAAE,CAAC;AACT,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAc;IAC7C,OAAO,wBAAwB,MAAM,sBAAsB,CAAC;AAC9D,CAAC;AAGD,SAAS,yBAAyB,CAAC,MAAc;IAC/C,OAAO;6BACoB,MAAM;;2CAEQ,MAAM;;;;;;;;;;;;;;;;;CAiBhD,CAAC,IAAI,EAAE,CAAC;AACT,CAAC;AAED,SAAS,2BAA2B,CAAC,MAAc;IACjD,OAAO,wBAAwB,MAAM,0BAA0B,CAAC;AAClE,CAAC;AAGD,SAAS,0BAA0B,CAAC,MAAc;IAChD,OAAO;6BACoB,MAAM;;+CAEY,MAAM;;;;;;;;;CASpD,CAAC,IAAI,EAAE,CAAC;AACT,CAAC;AAED,SAAS,4BAA4B,CAAC,MAAc;IAClD,OAAO,wBAAwB,MAAM,2BAA2B,CAAC;AACnE,CAAC;AAGD,SAAS,sBAAsB,CAAC,MAAc;IAC5C,OAAO;6BACoB,MAAM;;+CAEY,MAAM;;;;;CAKpD,CAAC,IAAI,EAAE,CAAC;AACT,CAAC;AAED,SAAS,wBAAwB,CAAC,MAAc;IAC9C,OAAO,wBAAwB,MAAM,uBAAuB,CAAC;AAC/D,CAAC;AAGD,SAAS,kBAAkB,CAAC,MAAc;IACxC,OAAO;;iCAEwB,MAAM;OAChC,MAAM;;;;iCAIoB,MAAM;OAChC,MAAM;;;iCAGoB,MAAM;OAChC,MAAM;;;iCAGoB,MAAM;OAChC,MAAM;;;iCAGoB,MAAM;OAChC,MAAM;CACZ,CAAC,IAAI,EAAE,CAAC;AACT,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAc;IAC1C,OAAO;2BACkB,MAAM;2BACN,MAAM;2BACN,MAAM;2BACN,MAAM;2BACN,MAAM;CAChC,CAAC,IAAI,EAAE,CAAC;AACT,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":";;AAmBA,sCA8BC;AA9BD,SAAgB,aAAa,CAAC,UAA4B,EAAE;IAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;IAEzC,OAAO;QACL;YACE,OAAO,EAAE,wBAAwB;YACjC,EAAE,EAAE,qBAAqB,CAAC,MAAM,CAAC;YACjC,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC;SACtC;QACD;YACE,OAAO,EAAE,4BAA4B;YACrC,EAAE,EAAE,yBAAyB,CAAC,MAAM,CAAC;YACrC,IAAI,EAAE,2BAA2B,CAAC,MAAM,CAAC;SAC1C;QACD;YACE,OAAO,EAAE,6BAA6B;YACtC,EAAE,EAAE,0BAA0B,CAAC,MAAM,CAAC;YACtC,IAAI,EAAE,4BAA4B,CAAC,MAAM,CAAC;SAC3C;QACD;YACE,OAAO,EAAE,yBAAyB;YAClC,EAAE,EAAE,sBAAsB,CAAC,MAAM,CAAC;YAClC,IAAI,EAAE,wBAAwB,CAAC,MAAM,CAAC;SACvC;QACD;YACE,OAAO,EAAE,oBAAoB;YAC7B,EAAE,EAAE,kBAAkB,CAAC,MAAM,CAAC;YAC9B,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC;SACnC;KACF,CAAC;AACJ,CAAC;AAGD,SAAS,qBAAqB,CAAC,MAAc;IAC3C,OAAO;6BACoB,MAAM;;;;;;;;;;;;CAYlC,CAAC,IAAI,EAAE,CAAC;AACT,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAc;IAC7C,OAAO,wBAAwB,MAAM,sBAAsB,CAAC;AAC9D,CAAC;AAGD,SAAS,yBAAyB,CAAC,MAAc;IAC/C,OAAO;6BACoB,MAAM;;2CAEQ,MAAM;;;;;;;;;;;;;;;;;CAiBhD,CAAC,IAAI,EAAE,CAAC;AACT,CAAC;AAED,SAAS,2BAA2B,CAAC,MAAc;IACjD,OAAO,wBAAwB,MAAM,0BAA0B,CAAC;AAClE,CAAC;AAGD,SAAS,0BAA0B,CAAC,MAAc;IAChD,OAAO;6BACoB,MAAM;;+CAEY,MAAM;;;;;;;;;CASpD,CAAC,IAAI,EAAE,CAAC;AACT,CAAC;AAED,SAAS,4BAA4B,CAAC,MAAc;IAClD,OAAO,wBAAwB,MAAM,2BAA2B,CAAC;AACnE,CAAC;AAGD,SAAS,sBAAsB,CAAC,MAAc;IAC5C,OAAO;6BACoB,MAAM;;+CAEY,MAAM;;;;;CAKpD,CAAC,IAAI,EAAE,CAAC;AACT,CAAC;AAED,SAAS,wBAAwB,CAAC,MAAc;IAC9C,OAAO,wBAAwB,MAAM,uBAAuB,CAAC;AAC/D,CAAC;AAGD,SAAS,kBAAkB,CAAC,MAAc;IACxC,OAAO;;iCAEwB,MAAM;OAChC,MAAM;;;;iCAIoB,MAAM;OAChC,MAAM;;;iCAGoB,MAAM;OAChC,MAAM;;;iCAGoB,MAAM;OAChC,MAAM;;;iCAGoB,MAAM;OAChC,MAAM;;;iCAGoB,MAAM;OAChC,MAAM;CACZ,CAAC,IAAI,EAAE,CAAC;AACT,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAc;IAC1C,OAAO;2BACkB,MAAM;2BACN,MAAM;2BACN,MAAM;2BACN,MAAM;2BACN,MAAM;2BACN,MAAM;CAChC,CAAC,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/models/event-type.model.d.ts

@@ -7,6 +7,8 @@ export declare class EventType {
     retryMax: number;
     retryDelayMs: number;
     retryBackoff: RetryBackoff;
+    priority: number;
+    maxConcurrency: number | null;
     createdAt: Date;
     updatedAt: Date;
     constructor(data: Partial<EventType>);

package/dist/models/event-type.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-type.model.js","sourceRoot":"","sources":["../../src/models/event-type.model.ts"],"names":[],"mappings":";;;AAMA,MAAa,SAAS;IAUpB,YAAY,IAAwB;QAClC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,WAAW;QACb,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,QAAQ;YACzB,OAAO,EAAE,IAAI,CAAC,YAAY;YAC1B,OAAO,EAAE,IAAI,CAAC,YAAY;SAC3B,CAAC;IACJ,CAAC;CACF;AArBD,8BAqBC"}
+{"version":3,"file":"event-type.model.js","sourceRoot":"","sources":["../../src/models/event-type.model.ts"],"names":[],"mappings":";;;AAMA,MAAa,SAAS;IAYpB,YAAY,IAAwB;QAClC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,WAAW;QACb,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,QAAQ;YACzB,OAAO,EAAE,IAAI,CAAC,YAAY;YAC1B,OAAO,EAAE,IAAI,CAAC,YAAY;SAC3B,CAAC;IACJ,CAAC;CACF;AAvBD,8BAuBC"}

package/dist/scheduler.module.js

@@ -11,16 +11,19 @@ exports.SchedulerModule = void 0;
 const common_1 = require("@nestjs/common");
 const core_1 = require("@nestjs/core");
 const console_logger_1 = require("./utils/console-logger");
+const constants_1 = require("./constants");
 const event_manager_service_1 = require("./services/event-manager.service");
 const polling_engine_service_1 = require("./services/polling-engine.service");
 const dispatcher_service_1 = require("./services/dispatcher.service");
+const concurrency_manager_service_1 = require("./services/concurrency-manager.service");
+const cron_discovery_service_1 = require("./services/cron-discovery.service");
 const scheduler_service_1 = require("./services/scheduler.service");
 const handler_registry_1 = require("./registry/handler.registry");
 const DEFAULT_CONFIG = {
-    pollingIntervalMs: 5000,
-    lockDurationMs: 30000,
-    batchSize: 50,
-    concurrency: 10,
+    pollingIntervalMs: constants_1.DEFAULTS.POLLING_INTERVAL_MS,
+    lockDurationMs: constants_1.DEFAULTS.LOCK_DURATION_MS,
+    batchSize: constants_1.DEFAULTS.BATCH_SIZE,
+    concurrency: constants_1.DEFAULTS.CONCURRENCY,
     deadLetterEnabled: true,
     tablePrefix: '',
     workerMode: true,
@@ -33,7 +36,7 @@ let SchedulerModule = SchedulerModule_1 = class SchedulerModule {
             module: SchedulerModule_1,
             imports: [core_1.DiscoveryModule],
             providers,
-            exports: [scheduler_service_1.SchedulerService, event_manager_service_1.EventManager, handler_registry_1.HandlerRegistry],
+            exports: [scheduler_service_1.SchedulerService, event_manager_service_1.EventManager, dispatcher_service_1.Dispatcher, handler_registry_1.HandlerRegistry],
         };
     }
     static forRootAsync(options) {
@@ -42,7 +45,7 @@ let SchedulerModule = SchedulerModule_1 = class SchedulerModule {
             module: SchedulerModule_1,
             imports: [...(options.imports || []), core_1.DiscoveryModule],
             providers,
-            exports: [scheduler_service_1.SchedulerService, event_manager_service_1.EventManager, handler_registry_1.HandlerRegistry],
+            exports: [scheduler_service_1.SchedulerService, event_manager_service_1.EventManager, dispatcher_service_1.Dispatcher, handler_registry_1.HandlerRegistry],
         };
     }
     static createProviders(options) {
@@ -76,7 +79,9 @@ let SchedulerModule = SchedulerModule_1 = class SchedulerModule {
                 ? [this.createAdapterProvider('CACHE_ADAPTER', options.cache)]
                 : []),
             handler_registry_1.HandlerRegistry,
+            cron_discovery_service_1.CronDiscovery,
             event_manager_service_1.EventManager,
+            concurrency_manager_service_1.ConcurrencyManager,
             polling_engine_service_1.PollingEngine,
             dispatcher_service_1.Dispatcher,
             scheduler_service_1.SchedulerService,
@@ -132,7 +137,9 @@ let SchedulerModule = SchedulerModule_1 = class SchedulerModule {
                 inject: ['SCHEDULER_OPTIONS'],
             },
             handler_registry_1.HandlerRegistry,
+            cron_discovery_service_1.CronDiscovery,
             event_manager_service_1.EventManager,
+            concurrency_manager_service_1.ConcurrencyManager,
             polling_engine_service_1.PollingEngine,
             dispatcher_service_1.Dispatcher,
             scheduler_service_1.SchedulerService,

package/dist/scheduler.module.js.map

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

package/dist/services/concurrency-manager.service.d.ts

@@ -0,0 +1,11 @@
+import { IDatabaseAdapter } from '../interfaces/database-adapter.interface';
+import { ILoggerAdapter } from '../interfaces/logger-adapter.interface';
+export declare class ConcurrencyManager {
+    private readonly db;
+    private readonly logger;
+    private readonly tablePrefix;
+    constructor(db: IDatabaseAdapter, logger: ILoggerAdapter, tablePrefix: string);
+    getCurrentExecutingCount(eventTypeId: string): Promise<number>;
+    canExecute(eventTypeId: string, maxConcurrency: number | null): Promise<boolean>;
+    getBulkExecutingCounts(eventTypeIds: string[]): Promise<Map<string, number>>;
+}