nest-scheduler-engine 1.0.0

package/dist/migrations/index.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMigrations = getMigrations;
+function getMigrations(options = {}) {
+    const prefix = options.tablePrefix || "";
+    return [
+        {
+            version: "001_create_event_types",
+            up: getCreateEventTypesUp(prefix),
+            down: getCreateEventTypesDown(prefix),
+        },
+        {
+            version: "002_create_event_instances",
+            up: getCreateEventInstancesUp(prefix),
+            down: getCreateEventInstancesDown(prefix),
+        },
+        {
+            version: "003_create_event_executions",
+            up: getCreateEventExecutionsUp(prefix),
+            down: getCreateEventExecutionsDown(prefix),
+        },
+        {
+            version: "004_create_dead_letters",
+            up: getCreateDeadLettersUp(prefix),
+            down: getCreateDeadLettersDown(prefix),
+        },
+        {
+            version: "005_create_indexes",
+            up: getCreateIndexesUp(prefix),
+            down: getCreateIndexesDown(prefix),
+        },
+    ];
+}
+function getCreateEventTypesUp(prefix) {
+    return `
+CREATE TABLE IF NOT EXISTS ${prefix}event_types (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  name VARCHAR(100) UNIQUE NOT NULL,
+  description TEXT,
+  retry_max INTEGER DEFAULT 3,
+  retry_delay_ms INTEGER DEFAULT 5000,
+  retry_backoff VARCHAR(20) DEFAULT 'exponential',
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+`.trim();
+}
+function getCreateEventTypesDown(prefix) {
+    return `DROP TABLE IF EXISTS ${prefix}event_types CASCADE;`;
+}
+function getCreateEventInstancesUp(prefix) {
+    return `
+CREATE TABLE IF NOT EXISTS ${prefix}event_instances (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  event_type_id UUID NOT NULL REFERENCES ${prefix}event_types(id) ON DELETE CASCADE,
+  payload JSONB NOT NULL DEFAULT '{}',
+  schedule_type VARCHAR(20) NOT NULL,
+  scheduled_at TIMESTAMPTZ,
+  rrule TEXT,
+  next_run_at TIMESTAMPTZ NOT NULL,
+  status VARCHAR(20) NOT NULL DEFAULT 'ACTIVE',
+  retry_count INTEGER DEFAULT 0,
+  max_retries INTEGER DEFAULT 3,
+  locked_by VARCHAR(100),
+  locked_until TIMESTAMPTZ,
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  updated_at TIMESTAMPTZ DEFAULT NOW(),
+  
+  CONSTRAINT chk_schedule_type CHECK (schedule_type IN ('ONE_TIME', 'RECURRING')),
+  CONSTRAINT chk_status CHECK (status IN ('ACTIVE', 'EXECUTING', 'PAUSED', 'COMPLETED', 'FAILED', 'DEAD'))
+);
+`.trim();
+}
+function getCreateEventInstancesDown(prefix) {
+    return `DROP TABLE IF EXISTS ${prefix}event_instances CASCADE;`;
+}
+function getCreateEventExecutionsUp(prefix) {
+    return `
+CREATE TABLE IF NOT EXISTS ${prefix}event_executions (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  event_instance_id UUID NOT NULL REFERENCES ${prefix}event_instances(id) ON DELETE CASCADE,
+  status VARCHAR(20) NOT NULL,
+  started_at TIMESTAMPTZ NOT NULL,
+  completed_at TIMESTAMPTZ,
+  error TEXT,
+  duration_ms INTEGER,
+  
+  CONSTRAINT chk_execution_status CHECK (status IN ('SUCCESS', 'FAILURE', 'TIMEOUT'))
+);
+`.trim();
+}
+function getCreateEventExecutionsDown(prefix) {
+    return `DROP TABLE IF EXISTS ${prefix}event_executions CASCADE;`;
+}
+function getCreateDeadLettersUp(prefix) {
+    return `
+CREATE TABLE IF NOT EXISTS ${prefix}dead_letters (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  event_instance_id UUID NOT NULL REFERENCES ${prefix}event_instances(id) ON DELETE CASCADE,
+  last_error TEXT NOT NULL,
+  retry_count INTEGER NOT NULL,
+  dead_at TIMESTAMPTZ DEFAULT NOW()
+);
+`.trim();
+}
+function getCreateDeadLettersDown(prefix) {
+    return `DROP TABLE IF EXISTS ${prefix}dead_letters CASCADE;`;
+}
+function getCreateIndexesUp(prefix) {
+    return `
+-- Partial index for polling performance
+CREATE INDEX IF NOT EXISTS idx_${prefix}event_instances_due
+  ON ${prefix}event_instances (next_run_at)
+  WHERE status = 'ACTIVE';
+
+-- Index for event type lookups
+CREATE INDEX IF NOT EXISTS idx_${prefix}event_instances_type
+  ON ${prefix}event_instances (event_type_id);
+
+-- Index for execution lookups
+CREATE INDEX IF NOT EXISTS idx_${prefix}event_executions_instance
+  ON ${prefix}event_executions (event_instance_id);
+
+-- Index for dead letter lookups
+CREATE INDEX IF NOT EXISTS idx_${prefix}dead_letters_instance
+  ON ${prefix}dead_letters (event_instance_id);
+
+-- Index for status queries
+CREATE INDEX IF NOT EXISTS idx_${prefix}event_instances_status
+  ON ${prefix}event_instances (status);
+`.trim();
+}
+function getCreateIndexesDown(prefix) {
+    return `
+DROP INDEX IF EXISTS idx_${prefix}event_instances_due;
+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;
+`.trim();
+}
+//# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

@@ -0,0 +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"}

package/dist/models/dead-letter.model.d.ts

@@ -0,0 +1,8 @@
+export declare class DeadLetter {
+    id: string;
+    eventInstanceId: string;
+    lastError: string;
+    retryCount: number;
+    deadAt: Date;
+    constructor(data: Partial<DeadLetter>);
+}

package/dist/models/dead-letter.model.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeadLetter = void 0;
+class DeadLetter {
+    constructor(data) {
+        Object.assign(this, data);
+    }
+}
+exports.DeadLetter = DeadLetter;
+//# sourceMappingURL=dead-letter.model.js.map

package/dist/models/dead-letter.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter.model.js","sourceRoot":"","sources":["../../src/models/dead-letter.model.ts"],"names":[],"mappings":";;;AAGA,MAAa,UAAU;IAOrB,YAAY,IAAyB;QACnC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF;AAVD,gCAUC"}

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

@@ -0,0 +1,13 @@
+import { ExecutionStatus } from '../types/enums';
+export declare class EventExecution {
+    id: string;
+    eventInstanceId: string;
+    status: ExecutionStatus;
+    startedAt: Date;
+    completedAt: Date | null;
+    error: string | null;
+    durationMs: number | null;
+    constructor(data: Partial<EventExecution>);
+    isComplete(): boolean;
+    calculateDuration(): number | null;
+}

package/dist/models/event-execution.model.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventExecution = void 0;
+class EventExecution {
+    constructor(data) {
+        Object.assign(this, data);
+    }
+    isComplete() {
+        return this.completedAt !== null;
+    }
+    calculateDuration() {
+        if (this.completedAt && this.startedAt) {
+            return this.completedAt.getTime() - this.startedAt.getTime();
+        }
+        return null;
+    }
+}
+exports.EventExecution = EventExecution;
+//# sourceMappingURL=event-execution.model.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-execution.model.js","sourceRoot":"","sources":["../../src/models/event-execution.model.ts"],"names":[],"mappings":";;;AAKA,MAAa,cAAc;IASzB,YAAY,IAA6B;QACvC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;IAKD,UAAU;QACR,OAAO,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC;IACnC,CAAC;IAKD,iBAAiB;QACf,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QAC/D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA7BD,wCA6BC"}

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

@@ -0,0 +1,22 @@
+import { EventStatus, ScheduleType } from '../types/enums';
+export declare class EventInstance {
+    id: string;
+    eventTypeId: string;
+    payload: Record<string, any>;
+    scheduleType: ScheduleType;
+    scheduledAt: Date | null;
+    rrule: string | null;
+    nextRunAt: Date;
+    status: EventStatus;
+    retryCount: number;
+    maxRetries: number;
+    lockedBy: string | null;
+    lockedUntil: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+    eventTypeName?: string;
+    constructor(data: Partial<EventInstance>);
+    isLocked(): boolean;
+    canRetry(): boolean;
+    isDue(): boolean;
+}

package/dist/models/event-instance.model.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventInstance = void 0;
+const enums_1 = require("../types/enums");
+class EventInstance {
+    constructor(data) {
+        Object.assign(this, data);
+    }
+    isLocked() {
+        if (!this.lockedUntil)
+            return false;
+        return new Date() < this.lockedUntil;
+    }
+    canRetry() {
+        return this.retryCount < this.maxRetries;
+    }
+    isDue() {
+        return this.status === enums_1.EventStatus.ACTIVE && new Date() >= this.nextRunAt;
+    }
+}
+exports.EventInstance = EventInstance;
+//# sourceMappingURL=event-instance.model.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-instance.model.js","sourceRoot":"","sources":["../../src/models/event-instance.model.ts"],"names":[],"mappings":";;;AAAA,0CAA2D;AAK3D,MAAa,aAAa;IAmBxB,YAAY,IAA4B;QACtC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;IAKD,QAAQ;QACN,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QACpC,OAAO,IAAI,IAAI,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;IACvC,CAAC;IAKD,QAAQ;QACN,OAAO,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IAC3C,CAAC;IAKD,KAAK;QACH,OAAO,IAAI,CAAC,MAAM,KAAK,mBAAW,CAAC,MAAM,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC;IAC5E,CAAC;CACF;AA5CD,sCA4CC"}

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

@@ -0,0 +1,14 @@
+import { RetryBackoff } from '../types/enums';
+import { RetryPolicy } from '../types/inputs';
+export declare class EventType {
+    id: string;
+    name: string;
+    description: string;
+    retryMax: number;
+    retryDelayMs: number;
+    retryBackoff: RetryBackoff;
+    createdAt: Date;
+    updatedAt: Date;
+    constructor(data: Partial<EventType>);
+    get retryPolicy(): RetryPolicy;
+}

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventType = void 0;
+class EventType {
+    constructor(data) {
+        Object.assign(this, data);
+    }
+    get retryPolicy() {
+        return {
+            maxRetries: this.retryMax,
+            delayMs: this.retryDelayMs,
+            backoff: this.retryBackoff,
+        };
+    }
+}
+exports.EventType = EventType;
+//# sourceMappingURL=event-type.model.js.map

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

@@ -0,0 +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"}

package/dist/models/index.d.ts

@@ -0,0 +1,4 @@
+export * from './event-type.model';
+export * from './event-instance.model';
+export * from './event-execution.model';
+export * from './dead-letter.model';

package/dist/models/index.js

@@ -0,0 +1,21 @@
+"use strict";
+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 });
+__exportStar(require("./event-type.model"), exports);
+__exportStar(require("./event-instance.model"), exports);
+__exportStar(require("./event-execution.model"), exports);
+__exportStar(require("./dead-letter.model"), exports);
+//# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,yDAAuC;AACvC,0DAAwC;AACxC,sDAAoC"}

package/dist/registry/handler.registry.d.ts

@@ -0,0 +1,18 @@
+import { OnModuleInit } from "@nestjs/common";
+import { DiscoveryService, MetadataScanner, Reflector } from "@nestjs/core";
+import { IEventHandler } from "../interfaces/event-handler.interface";
+export declare class HandlerRegistry implements OnModuleInit {
+    private readonly discoveryService;
+    private readonly metadataScanner;
+    private readonly reflector;
+    private readonly handlers;
+    constructor(discoveryService: DiscoveryService, metadataScanner: MetadataScanner, reflector: Reflector);
+    onModuleInit(): Promise<void>;
+    private discoverHandlers;
+    private isEventHandler;
+    register(eventType: string, handler: IEventHandler): void;
+    get(eventType: string): IEventHandler | undefined;
+    has(eventType: string): boolean;
+    getEventTypes(): string[];
+    getAll(): Map<string, IEventHandler>;
+}

package/dist/registry/handler.registry.js

@@ -0,0 +1,69 @@
+"use strict";
+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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandlerRegistry = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const event_handler_decorator_1 = require("../decorators/event-handler.decorator");
+let HandlerRegistry = class HandlerRegistry {
+    constructor(discoveryService, metadataScanner, reflector) {
+        this.discoveryService = discoveryService;
+        this.metadataScanner = metadataScanner;
+        this.reflector = reflector;
+        this.handlers = new Map();
+    }
+    async onModuleInit() {
+        await this.discoverHandlers();
+    }
+    async discoverHandlers() {
+        const providers = this.discoveryService.getProviders();
+        for (const wrapper of providers) {
+            const { instance } = wrapper;
+            if (!instance || typeof instance !== "object") {
+                continue;
+            }
+            const eventType = this.reflector.get(event_handler_decorator_1.EVENT_HANDLER_METADATA, instance.constructor);
+            if (eventType && this.isEventHandler(instance)) {
+                this.register(eventType, instance);
+            }
+        }
+    }
+    isEventHandler(instance) {
+        return (typeof instance.handle === "function" &&
+            typeof instance.eventType === "string");
+    }
+    register(eventType, handler) {
+        if (this.handlers.has(eventType)) {
+            throw new Error(`Event handler for type "${eventType}" is already registered`);
+        }
+        this.handlers.set(eventType, handler);
+    }
+    get(eventType) {
+        return this.handlers.get(eventType);
+    }
+    has(eventType) {
+        return this.handlers.has(eventType);
+    }
+    getEventTypes() {
+        return Array.from(this.handlers.keys());
+    }
+    getAll() {
+        return new Map(this.handlers);
+    }
+};
+exports.HandlerRegistry = HandlerRegistry;
+exports.HandlerRegistry = HandlerRegistry = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.DiscoveryService,
+        core_1.MetadataScanner,
+        core_1.Reflector])
+], HandlerRegistry);
+//# sourceMappingURL=handler.registry.js.map

package/dist/registry/handler.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.registry.js","sourceRoot":"","sources":["../../src/registry/handler.registry.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA0D;AAC1D,uCAA4E;AAG5E,mFAA+E;AAOxE,IAAM,eAAe,GAArB,MAAM,eAAe;IAG1B,YACmB,gBAAkC,EAClC,eAAgC,EAChC,SAAoB;QAFpB,qBAAgB,GAAhB,gBAAgB,CAAkB;QAClC,oBAAe,GAAf,eAAe,CAAiB;QAChC,cAAS,GAAT,SAAS,CAAW;QALtB,aAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAM1D,CAAC;IAEJ,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAChC,CAAC;IAKO,KAAK,CAAC,gBAAgB;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,CAAC;QAEvD,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;YAChC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;YAC7B,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC9C,SAAS;YACX,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAClC,gDAAsB,EACtB,QAAQ,CAAC,WAAW,CACrB,CAAC;YAEF,IAAI,SAAS,IAAI,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/C,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAyB,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;IACH,CAAC;IAKO,cAAc,CAAC,QAAa;QAClC,OAAO,CACL,OAAO,QAAQ,CAAC,MAAM,KAAK,UAAU;YACrC,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,CACvC,CAAC;IACJ,CAAC;IAKD,QAAQ,CAAC,SAAiB,EAAE,OAAsB;QAChD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,2BAA2B,SAAS,yBAAyB,CAC9D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAKD,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAKD,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAKD,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAKD,MAAM;QACJ,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;CACF,CAAA;AArFY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,mBAAU,GAAE;qCAK0B,uBAAgB;QACjB,sBAAe;QACrB,gBAAS;GAN5B,eAAe,CAqF3B"}

package/dist/scheduler.module.d.ts

@@ -0,0 +1,10 @@
+import { DynamicModule } from '@nestjs/common';
+import { SchedulerModuleOptions, SchedulerModuleAsyncOptions } from './interfaces/config.interface';
+export declare class SchedulerModule {
+    static forRoot(options: SchedulerModuleOptions): DynamicModule;
+    static forRootAsync(options: SchedulerModuleAsyncOptions): DynamicModule;
+    private static createProviders;
+    private static createAsyncProviders;
+    private static createAdapterProvider;
+    private static resolveAdapter;
+}

package/dist/scheduler.module.js

@@ -0,0 +1,183 @@
+"use strict";
+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;
+};
+var SchedulerModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+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 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 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,
+    deadLetterEnabled: true,
+    tablePrefix: '',
+    workerMode: true,
+    pollerOnly: false,
+};
+let SchedulerModule = SchedulerModule_1 = class SchedulerModule {
+    static forRoot(options) {
+        const providers = this.createProviders(options);
+        return {
+            module: SchedulerModule_1,
+            imports: [core_1.DiscoveryModule],
+            providers,
+            exports: [scheduler_service_1.SchedulerService, event_manager_service_1.EventManager, handler_registry_1.HandlerRegistry],
+        };
+    }
+    static forRootAsync(options) {
+        const providers = this.createAsyncProviders(options);
+        return {
+            module: SchedulerModule_1,
+            imports: [...(options.imports || []), core_1.DiscoveryModule],
+            providers,
+            exports: [scheduler_service_1.SchedulerService, event_manager_service_1.EventManager, handler_registry_1.HandlerRegistry],
+        };
+    }
+    static createProviders(options) {
+        const config = {
+            ...DEFAULT_CONFIG,
+            ...options.config,
+        };
+        const hooks = options.hooks || {};
+        return [
+            {
+                provide: 'SCHEDULER_CONFIG',
+                useValue: config,
+            },
+            {
+                provide: 'TABLE_PREFIX',
+                useValue: config.tablePrefix || '',
+            },
+            {
+                provide: 'SCHEDULER_HOOKS',
+                useValue: hooks,
+            },
+            this.createAdapterProvider('DATABASE_ADAPTER', options.database),
+            this.createAdapterProvider('QUEUE_ADAPTER', options.queue),
+            options.logger
+                ? this.createAdapterProvider('LOGGER_ADAPTER', options.logger)
+                : {
+                    provide: 'LOGGER_ADAPTER',
+                    useClass: console_logger_1.ConsoleLogger,
+                },
+            ...(options.cache
+                ? [this.createAdapterProvider('CACHE_ADAPTER', options.cache)]
+                : []),
+            handler_registry_1.HandlerRegistry,
+            event_manager_service_1.EventManager,
+            polling_engine_service_1.PollingEngine,
+            dispatcher_service_1.Dispatcher,
+            scheduler_service_1.SchedulerService,
+        ];
+    }
+    static createAsyncProviders(options) {
+        return [
+            {
+                provide: 'SCHEDULER_OPTIONS',
+                useFactory: options.useFactory,
+                inject: options.inject || [],
+            },
+            {
+                provide: 'SCHEDULER_CONFIG',
+                useFactory: (opts) => ({
+                    ...DEFAULT_CONFIG,
+                    ...opts.config,
+                }),
+                inject: ['SCHEDULER_OPTIONS'],
+            },
+            {
+                provide: 'TABLE_PREFIX',
+                useFactory: (opts) => opts.config?.tablePrefix || '',
+                inject: ['SCHEDULER_OPTIONS'],
+            },
+            {
+                provide: 'SCHEDULER_HOOKS',
+                useFactory: (opts) => opts.hooks || {},
+                inject: ['SCHEDULER_OPTIONS'],
+            },
+            {
+                provide: 'DATABASE_ADAPTER',
+                useFactory: async (opts) => {
+                    return this.resolveAdapter(opts.database);
+                },
+                inject: ['SCHEDULER_OPTIONS', ...(options.inject || [])],
+            },
+            {
+                provide: 'QUEUE_ADAPTER',
+                useFactory: async (opts) => {
+                    return this.resolveAdapter(opts.queue);
+                },
+                inject: ['SCHEDULER_OPTIONS', ...(options.inject || [])],
+            },
+            {
+                provide: 'LOGGER_ADAPTER',
+                useFactory: async (opts) => {
+                    if (opts.logger) {
+                        return this.resolveAdapter(opts.logger);
+                    }
+                    return new console_logger_1.ConsoleLogger();
+                },
+                inject: ['SCHEDULER_OPTIONS'],
+            },
+            handler_registry_1.HandlerRegistry,
+            event_manager_service_1.EventManager,
+            polling_engine_service_1.PollingEngine,
+            dispatcher_service_1.Dispatcher,
+            scheduler_service_1.SchedulerService,
+        ];
+    }
+    static createAdapterProvider(token, config) {
+        if (config.useClass) {
+            return {
+                provide: token,
+                useClass: config.useClass,
+            };
+        }
+        if (config.useFactory) {
+            return {
+                provide: token,
+                useFactory: config.useFactory,
+                inject: config.inject || [],
+            };
+        }
+        if (config.useExisting) {
+            return {
+                provide: token,
+                useExisting: config.useExisting,
+            };
+        }
+        throw new Error(`Invalid adapter provider configuration for ${token}`);
+    }
+    static async resolveAdapter(config) {
+        if (config.useFactory) {
+            const factory = config.useFactory;
+            const result = factory();
+            return result instanceof Promise ? await result : result;
+        }
+        if (config.useClass) {
+            return new config.useClass();
+        }
+        if (config.useExisting) {
+            return config.useExisting;
+        }
+        throw new Error('Invalid adapter configuration');
+    }
+};
+exports.SchedulerModule = SchedulerModule;
+exports.SchedulerModule = SchedulerModule = SchedulerModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], SchedulerModule);
+//# sourceMappingURL=scheduler.module.js.map

package/dist/scheduler.module.js.map

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

package/dist/services/dispatcher.service.d.ts

@@ -0,0 +1,26 @@
+import { OnModuleInit } from '@nestjs/common';
+import { IDatabaseAdapter } from '../interfaces/database-adapter.interface';
+import { IQueueAdapter } from '../interfaces/queue-adapter.interface';
+import { ILoggerAdapter } from '../interfaces/logger-adapter.interface';
+import { HandlerRegistry } from '../registry/handler.registry';
+export declare class Dispatcher implements OnModuleInit {
+    private readonly db;
+    private readonly queue;
+    private readonly logger;
+    private readonly tablePrefix;
+    private readonly config;
+    private readonly hooks;
+    private readonly handlerRegistry;
+    constructor(db: IDatabaseAdapter, queue: IQueueAdapter, logger: ILoggerAdapter, tablePrefix: string, config: any, hooks: any, handlerRegistry: HandlerRegistry);
+    onModuleInit(): Promise<void>;
+    private handleMessage;
+    private executeEvent;
+    private handleSuccess;
+    private handleFailure;
+    private markEventFailed;
+    private recordExecutionStart;
+    private recordExecutionSuccess;
+    private recordExecutionFailure;
+    private getEventInstance;
+    private getEventType;
+}