@hamim_4444/pulsar 0.0.0-stage → 1.0.0

package/dist/storage/repositories/PostgresEngineOperationRepository.d.ts

@@ -0,0 +1,39 @@
+import { PostgresDriver } from "../drivers/PostgresDriver.d.ts";
+import type { EngineQueuesConfig } from "../../types/queue.types.d.ts";
+import type { IConfigurationObject, IConfigSyncResult } from "../../types/config.types.d.ts";
+export interface IPulsarPostgresEngineOperationRepository {
+    addRestart(queues: EngineQueuesConfig[]): Promise<void>;
+    deleteRestart(queue: string): Promise<void>;
+    checkFencingTokenValidity(queue: string, token: string | number): Promise<boolean>;
+    verifyAndSyncConfiguration(host: string, instanceId: string, url: string, configurations: IConfigurationObject): Promise<IConfigSyncResult>;
+    subscribeToDatabaseEvents<T extends unknown>(channel: string, onEvent: (event: T) => Promise<void>, onListen?: () => void): Promise<void>;
+    getPollingQueueEntries(queueName: string, limit: number): Promise<Array<IPoolQueueEntry>>;
+    deletePollingQueueEntry(id: number): Promise<void>;
+}
+export interface IPoolQueueEntry {
+    id: number;
+    queue: string;
+    payload: {
+        queue_name: string;
+        fencing_token: number;
+        execution_at: string;
+    };
+    created_at: string;
+}
+export declare class PostgresEngineOperationRepository implements IPulsarPostgresEngineOperationRepository {
+    private driver;
+    private readonly logger;
+    constructor(driver: PostgresDriver);
+    private get sql();
+    addRestart(queues: EngineQueuesConfig[]): Promise<void>;
+    updateRestartOwnership(queue: string | null | undefined, owner: string): Promise<void>;
+    deleteRestart(queue: string | '__GLOBAL__'): Promise<void>;
+    pingHealthCheck(): Promise<void>;
+    checkFencingTokenValidity(queue: string, token: string | number): Promise<boolean>;
+    verifyAndSyncConfiguration(host: 'PULSAR_STANDALONE' | 'NEBULA_CLUSTER', instanceId: string, url: string, configurations: IConfigurationObject): Promise<IConfigSyncResult>;
+    private synchronizeQueueTriggers;
+    subscribeToDatabaseEvents<T extends unknown>(channel: string, onEvent: (event: T) => Promise<void>, onListen?: () => void): Promise<void>;
+    getPollingQueueEntries(queueName: string, limit?: number): Promise<Array<IPoolQueueEntry>>;
+    deletePollingQueueEntry(id: number): Promise<void>;
+}
+//# sourceMappingURL=PostgresEngineOperationRepository.d.ts.map

package/dist/storage/repositories/PostgresEngineOperationRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresEngineOperationRepository.d.ts","sourceRoot":"","sources":["../../../src/storage/repositories/PostgresEngineOperationRepository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAO9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAG3F,MAAM,WAAW,wCAAwC;IACrD,UAAU,CAAC,MAAM,EAAG,kBAAkB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,yBAAyB,CAAC,KAAK,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM,GAAG,MAAM,GAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACtF,0BAA0B,CAAC,IAAI,EAAG,MAAM,EAAE,UAAU,EAAG,MAAM,EAAE,GAAG,EAAG,MAAM,EAAE,cAAc,EAAG,oBAAoB,GAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACjJ,yBAAyB,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAG,MAAM,EAAE,OAAO,EAAG,CAAC,KAAK,EAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9I,sBAAsB,CAAC,SAAS,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM,GAAI,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;IAC7F,uBAAuB,CAAC,EAAE,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAG,MAAM,CAAC;IACZ,KAAK,EAAG,MAAM,CAAC;IACf,OAAO,EAAG;QACN,UAAU,EAAG,MAAM,CAAC;QACpB,aAAa,EAAG,MAAM,CAAC;QACvB,YAAY,EAAG,MAAM,CAAC;KACzB,CAAC;IACF,UAAU,EAAG,MAAM,CAAC;CACvB;AAED,qBAAa,iCAAkC,YAAW,wCAAwC;IAGlF,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;gBAEd,MAAM,EAAG,cAAc;IAI3C,OAAO,KAAK,GAAG,GAEd;IAEK,UAAU,CAAC,MAAM,EAAG,kBAAkB,EAAE;IAiCxC,sBAAsB,CAAC,KAAK,EAAG,MAAM,GAAG,IAAI,YAAO,EAAE,KAAK,EAAG,MAAM;IAYnE,aAAa,CAAC,KAAK,EAAG,MAAM,GAAG,YAAY;IAO3C,eAAe;IAUf,yBAAyB,CAAC,KAAK,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM,GAAG,MAAM;IAsBjE,0BAA0B,CAAE,IAAI,EAAG,mBAAmB,GAAG,gBAAgB,EAAE,UAAU,EAAG,MAAM,EAAE,GAAG,EAAG,MAAM,EAAE,cAAc,EAAG,oBAAoB,GAAI,OAAO,CAAC,iBAAiB,CAAC;YAkDzK,wBAAwB;IAwDhC,yBAAyB,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAG,MAAM,EAAE,OAAO,EAAG,CAAC,KAAK,EAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI;IAY5H,sBAAsB,CAAC,SAAS,EAAG,MAAM,EAAE,KAAK,GAAG,MAAW,GAAI,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAajG,uBAAuB,CAAC,EAAE,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC;CAM7D"}

package/dist/storage/repositories/PostgresQueueRepository.d.ts

@@ -0,0 +1,25 @@
+import type { PostgresDriver } from "../drivers/PostgresDriver.d.ts";
+import type { IBatchCandidate } from "../../modules/Tick.module.d.ts";
+import { BaseQueueRepository } from "./QueueRepository.d.ts";
+export declare class PostgresQueueRepository extends BaseQueueRepository {
+    private readonly driver;
+    constructor(driver: PostgresDriver);
+    private get sql();
+    private get prefix();
+    registerWorker(queue: string, candidateBatches: IBatchCandidate[], concurrency: number, globalMaxConcurrency?: number): Promise<string[]>;
+    deregisterWorker(workerId: string, queue: string): Promise<void>;
+    getActiveWorkersCount(queue: string): Promise<number>;
+    setFutureSchedule(queue: string, scheduleAt: string): Promise<void>;
+    getGlobalActiveWorkersCount(): Promise<number>;
+    refundGlobalJobBudget(amount: number, window: string): Promise<void>;
+    private budgetKeyPrefix;
+    claimGlobalJobBudget(requested: number, maxGlobalJobsPerTick: number): Promise<{
+        granted: number;
+        window: string;
+    }>;
+    acquireQueueLock(lockKey: string, ownerId: string, ttlMs: number): Promise<boolean>;
+    releaseQueueLock(lockKey: string, ownerId: string): Promise<boolean>;
+    evaluateDeadRun(queueName: string, poolerType: "interval-driven-pooler" | "event-driven-pooler", totalJobs: number, continuationOwnerId: string, dispatchTtlMs?: number, idpLockKey?: string, edpLockPrefix?: string): Promise<boolean>;
+    clearDispatchPending(lockKey: string): Promise<void>;
+}
+//# sourceMappingURL=PostgresQueueRepository.d.ts.map

package/dist/storage/repositories/PostgresQueueRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresQueueRepository.d.ts","sourceRoot":"","sources":["../../../src/storage/repositories/PostgresQueueRepository.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAM3D,qBAAa,uBAAwB,SAAQ,mBAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAG,cAAc;IAKpD,OAAO,KAAK,GAAG,GAEd;IAED,OAAO,KAAK,MAAM,GAKjB;IAEc,cAAc,CAAE,KAAK,EAAG,MAAM,EAAE,gBAAgB,EAAG,eAAe,EAAE,EAAE,WAAW,EAAG,MAAM,EAAE,oBAAoB,GAAE,MAAiB;IAyBnI,gBAAgB,CAAC,QAAQ,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM;IAclD,qBAAqB,CAAC,KAAK,EAAG,MAAM;IAYpC,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC;IAWpE,2BAA2B;IAY3B,qBAAqB,CAAC,MAAM,EAAG,MAAM,EAAE,MAAM,EAAG,MAAM;IAYrE,OAAO,CAAC,eAAe;IAIR,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM;;;;IAgDpE,gBAAgB,CAAC,OAAO,EAAG,MAAM,EAAE,OAAO,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBtF,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAepE,eAAe,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,wBAAwB,GAAG,qBAAqB,EAC5D,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,MAAM,EAC3B,aAAa,GAAE,MAAc,EAC7B,UAAU,GAAE,MAAmB,EAC/B,aAAa,GAAE,MAAoB,GACnC,OAAO,CAAC,OAAO,CAAC;IAuDL,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQtE"}

package/dist/storage/repositories/QueueRepository.d.ts

@@ -0,0 +1,19 @@
+import type { IBatchCandidate } from "../../modules/Tick.module";
+export declare abstract class BaseQueueRepository {
+    abstract getActiveWorkersCount(queue: string): Promise<number>;
+    abstract getGlobalActiveWorkersCount(): Promise<number>;
+    abstract registerWorker(queue: string, candidateBatches: IBatchCandidate[], concurrency: number, globalMaxConcurrency: number): Promise<string[]>;
+    abstract deregisterWorker(workerId: string, queue: string): Promise<void>;
+    abstract claimGlobalJobBudget(requested: number, maxGlobalJobsPerTick: number): Promise<{
+        granted: number;
+        window: string;
+    }>;
+    abstract refundGlobalJobBudget(amount: number, window: string): Promise<void>;
+    abstract acquireQueueLock(lockKey: string, ownerId: string, ttlMs: number): Promise<boolean>;
+    abstract releaseQueueLock(lockKey: string, ownerId: string): Promise<boolean>;
+    abstract evaluateDeadRun(queueName: string, poolerType: "interval-driven-pooler" | "event-driven-pooler", totalJobs: number, continuationOwnerId: string, dispatchTtlMs: number, idpLockKey?: string, edpLockPrefix?: string): Promise<boolean>;
+    abstract clearDispatchPending(lockKey: string): Promise<void>;
+    abstract setFutureSchedule(queue: string, scheduleAt: string): Promise<void>;
+}
+export type IQueueRepository = BaseQueueRepository;
+//# sourceMappingURL=QueueRepository.d.ts.map

package/dist/storage/repositories/QueueRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueRepository.d.ts","sourceRoot":"","sources":["../../../src/storage/repositories/QueueRepository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,8BAAsB,mBAAmB;aACrB,qBAAqB,CAAC,KAAK,EAAG,MAAM,GAAI,OAAO,CAAC,MAAM,CAAC;aACvD,2BAA2B,IAAM,OAAO,CAAC,MAAM,CAAC;aAEhD,cAAc,CAAC,KAAK,EAAG,MAAM,EAAE,gBAAgB,EAAG,eAAe,EAAE,EAAE,WAAW,EAAG,MAAM,EAAE,oBAAoB,EAAG,MAAM,GAAI,OAAO,CAAC,MAAM,EAAE,CAAC;aAC7I,gBAAgB,CAAC,QAAQ,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC;aAEnE,oBAAoB,CAAC,SAAS,EAAG,MAAM,EAAE,oBAAoB,EAAG,MAAM,GAAI,OAAO,CAAC;QAAE,OAAO,EAAG,MAAM,CAAC;QAAC,MAAM,EAAG,MAAM,CAAA;KAAE,CAAC;aACxH,qBAAqB,CAAC,MAAM,EAAG,MAAM,EAAE,MAAM,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC;aAEvE,gBAAgB,CAAC,OAAO,EAAG,MAAM,EAAE,OAAO,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM,GAAI,OAAO,CAAC,OAAO,CAAC;aACvF,gBAAgB,CAAC,OAAO,EAAG,MAAM,EAAE,OAAO,EAAG,MAAM,GAAI,OAAO,CAAC,OAAO,CAAC;aAEvE,eAAe,CAC3B,SAAS,EAAG,MAAM,EAClB,UAAU,EAAG,wBAAwB,GAAG,qBAAqB,EAC7D,SAAS,EAAG,MAAM,EAClB,mBAAmB,EAAG,MAAM,EAC5B,aAAa,EAAG,MAAM,EACtB,UAAU,CAAC,EAAG,MAAM,EACpB,aAAa,CAAC,EAAG,MAAM,GACvB,OAAO,CAAC,OAAO,CAAC;aAEJ,oBAAoB,CAAC,OAAO,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC;aAEtD,iBAAiB,CAAC,KAAK,EAAG,MAAM,EAAE,UAAU,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC;CACzF;AAED,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC"}

package/dist/storage/repositories/RedisQueueRepository.d.ts

@@ -0,0 +1,27 @@
+import type { RedisDriver } from "../drivers/RedisDriver.d.ts";
+import type { IBatchCandidate } from "../../modules/Tick.module.d.ts";
+import { BaseQueueRepository } from "./QueueRepository.d.ts";
+export declare class RedisQueueRepository extends BaseQueueRepository {
+    private readonly driver;
+    private protocol;
+    constructor(driver: RedisDriver);
+    private get redis();
+    private get prefix();
+    registerWorker(queue: string, candidateBatches: IBatchCandidate[], concurrency: number, globalMaxConcurrency?: number): Promise<string[]>;
+    deregisterWorker(workerId: string, queue: string): Promise<void>;
+    getActiveWorkersCount(queue: string): Promise<number>;
+    getGlobalActiveWorkersCount(): Promise<number>;
+    setFutureSchedule(queue: string, scheduleAt: string): Promise<void>;
+    private budgetKeyPrefix;
+    claimGlobalJobBudget(requested: number, maxGlobalJobsPerTick: number): Promise<{
+        granted: number;
+        window: string;
+    }>;
+    refundGlobalJobBudget(amount: number, window: string): Promise<void>;
+    acquireQueueLock(lockKey: string, ownerId: string, ttlMs: number): Promise<boolean>;
+    releaseQueueLock(lockKey: string, ownerId: string): Promise<boolean>;
+    clearDispatchPending(lockKey: string): Promise<void>;
+    evaluateDeadRun(queueName: string, poolerType: "interval-driven-pooler" | "event-driven-pooler", totalJobs: number, continuationOwnerId: string, dispatchTtlMs?: number, idpLockKey?: string, edpLockPrefix?: string): Promise<boolean>;
+    private evalScript;
+}
+//# sourceMappingURL=RedisQueueRepository.d.ts.map

package/dist/storage/repositories/RedisQueueRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisQueueRepository.d.ts","sourceRoot":"","sources":["../../../src/storage/repositories/RedisQueueRepository.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAUpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAK3D,qBAAa,oBAAqB,SAAQ,mBAAmB;IAG7C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAkB;gBAEL,MAAM,EAAG,WAAW;IAMjD,OAAO,KAAK,KAAK,GAEhB;IAED,OAAO,KAAK,MAAM,GAKjB;IAEc,cAAc,CAAE,KAAK,EAAG,MAAM,EAAE,gBAAgB,EAAG,eAAe,EAAE,EAAE,WAAW,EAAG,MAAM,EAAE,oBAAoB,GAAE,MAAiB;IAoCnI,gBAAgB,CAAC,QAAQ,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM;IAalD,qBAAqB,CAAC,KAAK,EAAG,MAAM;IAMpC,2BAA2B;IAM3B,iBAAiB,CAAC,KAAK,EAAG,MAAM,EAAE,UAAU,EAAE,MAAM;IAKnE,OAAO,CAAC,eAAe;IAIR,oBAAoB,CAAC,SAAS,EAAG,MAAM,EAAE,oBAAoB,EAAG,MAAM;;;;IAetE,qBAAqB,CAAC,MAAM,EAAG,MAAM,EAAE,MAAM,EAAE,MAAM;IAOrD,gBAAgB,CAAC,OAAO,EAAG,MAAM,EAAE,OAAO,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM,GAAI,OAAO,CAAC,OAAO,CAAC;IAKvF,gBAAgB,CAAC,OAAO,EAAG,MAAM,EAAE,OAAO,EAAG,MAAM,GAAI,OAAO,CAAC,OAAO,CAAC;IAKvE,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC;IAKrD,eAAe,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,wBAAwB,GAAG,qBAAqB,EAC5D,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,MAAM,EAC3B,aAAa,GAAE,MAAc,EAC7B,UAAU,GAAE,MAAmB,EAC/B,aAAa,GAAE,MAAoB,GACnC,OAAO,CAAC,OAAO,CAAC;YAiBN,UAAU;CAQ3B"}

package/dist/subsys/DeferredTickEvaluator.d.ts

@@ -0,0 +1,23 @@
+import type { PulsarEventBus } from "../service/PulsarEventBus";
+import type { PulsarClock } from "./PulsarClock";
+import type { Scheduler } from "../modules/Scheduler.module";
+import type { ILogger } from "./LoggerService";
+import type { EngineQueuesConfig } from "@package/src/types/queue.types";
+export declare class DeferredTickEvaluator {
+    private minBootRequirementSec;
+    private scheduler;
+    private events;
+    private clock;
+    private logger;
+    constructor(minBootRequirementSec: number, scheduler: Scheduler, events: PulsarEventBus, clock: PulsarClock, logger: ILogger);
+    private timers;
+    private watchdogTimer;
+    private isShutdownTriggered;
+    evaluateUpcomingDelayedNext(upcomingTimeMs: number, queue: string): void;
+    private startDelayedSleepWatchdog;
+    private triggerGracefulShutdown;
+    stopRuntimeWatchdog(): void;
+    clearTimer(queue: string): void;
+    forceExecuteTickLater(queue: EngineQueuesConfig, targetTimestamp: number): void;
+}
+//# sourceMappingURL=DeferredTickEvaluator.d.ts.map

package/dist/subsys/DeferredTickEvaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeferredTickEvaluator.d.ts","sourceRoot":"","sources":["../../src/subsys/DeferredTickEvaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,qBAAa,qBAAqB;IAE1B,OAAO,CAAC,qBAAqB;IAC7B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;gBAJN,qBAAqB,EAAG,MAAM,EAC9B,SAAS,EAAG,SAAS,EACrB,MAAM,EAAG,cAAc,EACvB,KAAK,EAAG,WAAW,EACnB,MAAM,EAAG,OAAO;IAG5B,OAAO,CAAC,MAAM,CAAoD;IAClE,OAAO,CAAC,aAAa,CAAgD;IACrE,OAAO,CAAC,mBAAmB,CAAS;IAE7B,2BAA2B,CAAC,cAAc,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM;IAwB1E,OAAO,CAAC,yBAAyB;IAoBjC,OAAO,CAAC,uBAAuB;IAcxB,mBAAmB;IAOnB,UAAU,CAAC,KAAK,EAAG,MAAM;IASzB,qBAAqB,CAAC,KAAK,EAAG,kBAAkB,EAAE,eAAe,EAAG,MAAM;CAyBpF"}

package/dist/subsys/EventBus.d.ts

@@ -0,0 +1,13 @@
+type EventCallback<T = any> = (payload: T) => void;
+export type AppModule = () => void;
+export declare class EventBus {
+    private events;
+    private globalListeners;
+    get listenerCount(): number;
+    on(event: string, callback: EventCallback): void;
+    off(event: string, callback: EventCallback): void;
+    emit<T>(event: string, payload: T): void;
+}
+declare const AppEvents: EventBus;
+export default AppEvents;
+//# sourceMappingURL=EventBus.d.ts.map

package/dist/subsys/EventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../src/subsys/EventBus.ts"],"names":[],"mappings":"AAAA,KAAK,aAAa,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;AAEnD,MAAM,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC;AAEnC,qBAAa,QAAQ;IACjB,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,eAAe,CAAuB;IAE9C,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa;IAgBzC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa;IAW1C,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;CAMpC;AAED,QAAA,MAAM,SAAS,UAAiB,CAAC;AAEjC,eAAe,SAAS,CAAC"}

package/dist/subsys/ExecutionProfileSwitcher.d.ts

@@ -0,0 +1,10 @@
+import type { EngineQueuesConfig } from "../types/queue.types";
+import type { ILogger } from "./LoggerService";
+export declare class ExecutionProfileSwitcher {
+    private logger;
+    private transitionItems;
+    constructor(logger: ILogger);
+    transitionToIdleMode({ queue, stateTransitionPolicy }: EngineQueuesConfig): void;
+    transitionToActiveMode({ queue, profile, stateTransitionPolicy }: EngineQueuesConfig): void;
+}
+//# sourceMappingURL=ExecutionProfileSwitcher.d.ts.map

package/dist/subsys/ExecutionProfileSwitcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionProfileSwitcher.d.ts","sourceRoot":"","sources":["../../src/subsys/ExecutionProfileSwitcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI/C,qBAAa,wBAAwB;IAGrB,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,eAAe,CAAqB;gBAExB,MAAM,EAAG,OAAO;IAEpC,oBAAoB,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAG,kBAAkB;IAuB1E,sBAAsB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,EAAG,kBAAkB;CASxF"}

package/dist/subsys/LoggerService.d.ts

@@ -0,0 +1,15 @@
+export interface ILogger {
+    log(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    debug?(message: string, ...args: any[]): void;
+}
+export declare class LoggerService implements ILogger {
+    private static provider;
+    setProvider(customLogger: ILogger): void;
+    log(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    debug(message: string, ...args: any[]): void;
+}
+//# sourceMappingURL=LoggerService.d.ts.map

package/dist/subsys/LoggerService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoggerService.d.ts","sourceRoot":"","sources":["../../src/subsys/LoggerService.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACpB,GAAG,CAAC,OAAO,EAAG,MAAM,EAAE,GAAG,IAAI,EAAG,GAAG,EAAE,GAAI,IAAI,CAAC;IAC9C,IAAI,CAAC,OAAO,EAAG,MAAM,EAAE,GAAG,IAAI,EAAG,GAAG,EAAE,GAAI,IAAI,CAAC;IAC/C,KAAK,CAAC,OAAO,EAAG,MAAM,EAAE,GAAG,IAAI,EAAG,GAAG,EAAE,GAAI,IAAI,CAAC;IAChD,KAAK,CAAC,CAAC,OAAO,EAAG,MAAM,EAAE,GAAG,IAAI,EAAG,GAAG,EAAE,GAAI,IAAI,CAAC;CACpD;AASD,qBAAa,aAAc,YAAW,OAAO;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IAEjD,WAAW,CAAC,YAAY,EAAE,OAAO;IAIjC,GAAG,CAAC,OAAO,EAAG,MAAM,EAAE,GAAG,IAAI,EAAG,GAAG,EAAE;IAIrC,IAAI,CAAC,OAAO,EAAG,MAAM,EAAE,GAAG,IAAI,EAAG,GAAG,EAAE;IAItC,KAAK,CAAC,OAAO,EAAG,MAAM,EAAE,GAAG,IAAI,EAAG,GAAG,EAAE;IAIvC,KAAK,CAAC,OAAO,EAAG,MAAM,EAAE,GAAG,IAAI,EAAG,GAAG,EAAE;CAKjD"}

package/dist/subsys/PulsarClock.d.ts

@@ -0,0 +1,32 @@
+export interface ClockOptions {
+    /** Maximum allowed runtime in milliseconds for the entire engine execution (e.g., 25000 for 25s) */
+    maxExecutionBudgetMs?: number;
+    /** Safety margin in milliseconds reserved for graceful cleanup/shutdown */
+    safetyBufferMs?: number;
+    /** Maximum number of execution spans to retain in memory */
+    maxTrackHistory?: number;
+    enabled?: boolean;
+}
+export declare class PulsarClock {
+    private tracks;
+    private startTime;
+    private maxExecutionBudgetMs;
+    private safetyBufferMs;
+    private maxTrackHistory;
+    private enabled;
+    cpuExecutionMicroseconds: number;
+    constructor(options?: ClockOptions);
+    trackExecutionTime<T>({ contextId }: {
+        contextId: string;
+    }, fn: () => Promise<T>): Promise<T>;
+    getElapsedTotalTime(): number;
+    getTimeRemaining(): number;
+    getAverageTickDuration(lastN?: number): number;
+    /**
+     * Determines if executing another tick is safe.
+     * Uses recent average tick duration to estimate whether another tick will exceed the deadline.
+     */
+    isSafeToContinue(): boolean;
+    clear(contextId: string): void;
+}
+//# sourceMappingURL=PulsarClock.d.ts.map

package/dist/subsys/PulsarClock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PulsarClock.d.ts","sourceRoot":"","sources":["../../src/subsys/PulsarClock.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IACzB,oGAAoG;IACpG,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAA8D;IAC5E,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,OAAO,CAAU;IAElB,wBAAwB,SAAK;gBAExB,OAAO,GAAE,YAAiB;IAQzB,kBAAkB,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,EAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmBpG,mBAAmB,IAAK,MAAM;IAI9B,gBAAgB,IAAK,MAAM;IAM3B,sBAAsB,CAAC,KAAK,SAAI,GAAG,MAAM;IAOhD;;;OAGG;IACI,gBAAgB,IAAK,OAAO;IAe5B,KAAK,CAAC,SAAS,EAAG,MAAM;CAGlC"}

package/dist/subsys/RuntimeCacheStorage.d.ts

@@ -0,0 +1,18 @@
+export declare class RuntimeCacheStorage {
+    static store: Map<string, any>;
+    kv: {
+        set: <V>(key: string, value: V) => void;
+        get: <K>(key: string) => K | undefined;
+        has: (key: string) => boolean;
+        delete: (key: string) => boolean;
+        clear: () => void;
+    };
+    lists: {
+        add: (key: string, value: string) => void;
+        remove: (key: string, value: string) => boolean;
+        get: (key: string) => Set<string> | undefined;
+        has: (key: string, value: string) => boolean;
+    };
+}
+export declare const createRuntimeCacheStorage: () => RuntimeCacheStorage;
+//# sourceMappingURL=RuntimeCacheStorage.d.ts.map

package/dist/subsys/RuntimeCacheStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeCacheStorage.d.ts","sourceRoot":"","sources":["../../src/subsys/RuntimeCacheStorage.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAmB;IAC5B,OAAc,KAAK,EAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAa;IAE5C,EAAE;cACC,CAAC,OAAQ,MAAM,SAAU,CAAC;cAI1B,CAAC,OAAQ,MAAM,KAAI,CAAC,GAAG,SAAS;mBAI1B,MAAM,KAAI,OAAO;sBAId,MAAM,KAAI,OAAO;;MAOnC;IAEM,KAAK;mBACI,MAAM,SAAU,MAAM;sBAUnB,MAAM,SAAU,MAAM;mBAQzB,MAAM,KAAI,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS;mBAKjC,MAAM,SAAU,MAAM,KAAI,OAAO;MAOhD;CACJ;AAED,eAAO,MAAM,yBAAyB,2BAAkC,CAAC"}

package/dist/subsys/RuntimeEventBridge.d.ts

@@ -0,0 +1,14 @@
+import type { PulsarUnifiedStorage } from "../storage/PulsarStorage";
+import type { IRuntimeExecutionContext } from "../runtimes/runtimeTypes";
+import type { ILogger } from "./LoggerService";
+export declare class RuntimeEventBridge {
+    protected readonly storage: PulsarUnifiedStorage;
+    protected readonly logger: ILogger;
+    private readonly pgNotifyChannel;
+    private readonly runtimeExecutionId;
+    constructor(storage: PulsarUnifiedStorage, logger: ILogger);
+    registerPgNotifyHandler(ctx: IRuntimeExecutionContext): Promise<void>;
+    registerPollingHandler(ctx: IRuntimeExecutionContext): Promise<void>;
+    private handleTriggerValidity;
+}
+//# sourceMappingURL=RuntimeEventBridge.d.ts.map

package/dist/subsys/RuntimeEventBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeEventBridge.d.ts","sourceRoot":"","sources":["../../src/subsys/RuntimeEventBridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI/C,qBAAa,kBAAkB;IAKvB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAG,oBAAoB;IACjD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAG,OAAO;IALvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgD;IAChF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuB;gBAGnC,OAAO,EAAG,oBAAoB,EAC9B,MAAM,EAAG,OAAO;IAG1B,uBAAuB,CAAC,GAAG,EAAG,wBAAwB;IAoBtD,sBAAsB,CAAC,GAAG,EAAG,wBAAwB;YAkBpD,qBAAqB;CAoCtC"}

package/dist/transport/PulsarTransportManager.d.ts

@@ -0,0 +1,10 @@
+import type postgres from "postgres";
+import type { TransportConfig, WebhookHandleRequestParams } from "./types";
+export declare class PulsarTransportManager {
+    private strategy;
+    constructor(config: TransportConfig, db?: postgres.Sql);
+    handleRequest(args: WebhookHandleRequestParams): Promise<import("./types").StandardResponse>;
+    initialize(onTrigger: (queue: string) => Promise<void>): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=PulsarTransportManager.d.ts.map

package/dist/transport/PulsarTransportManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PulsarTransportManager.d.ts","sourceRoot":"","sources":["../../src/transport/PulsarTransportManager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAsB,eAAe,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAE/F,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,QAAQ,CAAsB;gBAE1B,MAAM,EAAG,eAAe,EAAE,EAAE,CAAC,EAAG,QAAQ,CAAC,GAAG;IAmB3C,aAAa,CAAC,IAAI,EAAG,0BAA0B;IAQ/C,UAAU,CAAC,SAAS,EAAG,CAAC,KAAK,EAAG,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;IAQxD,QAAQ;CAGxB"}

package/dist/transport/strategies/PollingTransport.d.ts

@@ -0,0 +1,13 @@
+import type { IPollingTransportStrategy } from "../types";
+import type postgres from "postgres";
+export declare class PollingTransport implements IPollingTransportStrategy {
+    private readonly sql;
+    private readonly intervalMs;
+    readonly type = "polling";
+    private timer?;
+    private lastSeenId;
+    constructor(sql: postgres.Sql, intervalMs?: number);
+    start(onTrigger: (targetQueue: string) => Promise<void>): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=PollingTransport.d.ts.map

package/dist/transport/strategies/PollingTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PollingTransport.d.ts","sourceRoot":"","sources":["../../../src/transport/strategies/PollingTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAErC,qBAAa,gBAAiB,YAAW,yBAAyB;IAM1D,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAN/B,SAAgB,IAAI,aAAa;IACjC,OAAO,CAAC,KAAK,CAAC,CAAiB;IAC/B,OAAO,CAAC,UAAU,CAAK;gBAGF,GAAG,EAAE,QAAQ,CAAC,GAAG,EACjB,UAAU,GAAE,MAAa;IAGxC,KAAK,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBvE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG9B"}

package/dist/transport/strategies/TcpListenTransport.d.ts

@@ -0,0 +1,11 @@
+import type { ITcpListenTransportStrategy } from "../types";
+import type postgres from "postgres";
+export declare class TcpListenTransport implements ITcpListenTransportStrategy {
+    private readonly sql;
+    private readonly channel;
+    readonly type = "tcp_listen";
+    constructor(sql: postgres.Sql, channel?: string);
+    start(onTrigger: (targetQueue: string) => Promise<void>): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=TcpListenTransport.d.ts.map

package/dist/transport/strategies/TcpListenTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TcpListenTransport.d.ts","sourceRoot":"","sources":["../../../src/transport/strategies/TcpListenTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAChF,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAErC,qBAAa,kBAAmB,YAAW,2BAA2B;IAI9D,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ5B,SAAgB,IAAI,gBAAgB;gBAGf,GAAG,EAAG,QAAQ,CAAC,GAAG,EAClB,OAAO,GAAG,MAA+B;IAGxD,KAAK,CAAC,SAAS,EAAE,CAAC,WAAW,EAAG,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAI,OAAO,CAAC,IAAI,CAAC;IAczE,IAAI;CAGb"}

package/dist/transport/strategies/WebhookTransport.d.ts

@@ -0,0 +1,9 @@
+import type { IWebhookTransportStrategy, StandardResponse, WebhookHandleRequestParams } from "../types";
+export declare class WebhookTransport implements IWebhookTransportStrategy {
+    readonly type: "webhook";
+    constructor();
+    start(onTrigger: (targetQueue: string) => Promise<void>): Promise<void>;
+    handleRequest({ req, unifiedStorage, isolate, getEngine, instanceId }: WebhookHandleRequestParams): Promise<StandardResponse>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=WebhookTransport.d.ts.map

package/dist/transport/strategies/WebhookTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookTransport.d.ts","sourceRoot":"","sources":["../../../src/transport/strategies/WebhookTransport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAKxG,qBAAa,gBAAiB,YAAW,yBAAyB;IAC9D,SAAgB,IAAI,EAAG,SAAS,CAAU;;IAMpC,KAAK,CAAC,SAAS,EAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAI,OAAO,CAAC,IAAI,CAAC;IAMlE,aAAa,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,EAAG,0BAA0B,GAAI,OAAO,CAAC,gBAAgB,CAAC;IAItI,IAAI;CAGb"}

package/dist/transport/types.d.ts

@@ -0,0 +1,41 @@
+import type { IsolateInstance } from "../service/Isolate.service";
+import type { Pulsar } from "../service/Pulsar.service";
+import type { PulsarUnifiedStorage } from "../storage";
+export type TransportType = "webhook" | "tcp_listen" | "polling";
+export type WebhookHandleRequestParams = {
+    req: Request;
+    unifiedStorage: PulsarUnifiedStorage;
+    isolate?: IsolateInstance;
+    getEngine: (instanceId: string) => Pulsar;
+    instanceId: string;
+};
+export type StandardResponse = {
+    status: number;
+    message: string;
+};
+export interface IWebhookTransportStrategy {
+    readonly type: "webhook";
+    handleRequest(params: WebhookHandleRequestParams): Promise<StandardResponse>;
+}
+export interface ITcpListenTransportStrategy {
+    readonly type: "tcp_listen";
+    start(onTrigger: (targetQueue: string) => Promise<void>): Promise<void>;
+    stop(): Promise<void>;
+}
+export interface IPollingTransportStrategy {
+    readonly type: "polling";
+    start(onTrigger: (targetQueue: string) => Promise<void>): Promise<void>;
+    stop(): Promise<void>;
+}
+export type ITransportStrategy = IWebhookTransportStrategy | ITcpListenTransportStrategy | IPollingTransportStrategy;
+export type TransportConfig = {
+    mode: "webhook";
+} | {
+    mode: "tcp_listen";
+    channelName?: string;
+} | {
+    mode: "polling";
+    pollingIntervalMs?: number;
+    channelName?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/transport/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;AAEjE,MAAM,MAAM,0BAA0B,GAAG;IACrC,GAAG,EAAG,OAAO,CAAC;IACd,cAAc,EAAG,oBAAoB,CAAC;IACtC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,CAAC,UAAU,EAAG,MAAM,KAAK,MAAM,CAAC;IAC3C,UAAU,EAAG,MAAM,CAAC;CACvB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,MAAM,EAAG,MAAM,CAAC;IAChB,OAAO,EAAG,MAAM,CAAC;CACpB,CAAA;AAGD,MAAM,WAAW,yBAAyB;IACtC,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAC;IAC1B,aAAa,CAAC,MAAM,EAAG,0BAA0B,GAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,2BAA2B;IACxC,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAC;IAC7B,KAAK,CAAC,SAAS,EAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,IAAI,IAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACtC,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,SAAS,EAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,IAAI,IAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAGD,MAAM,MAAM,kBAAkB,GACxB,yBAAyB,GACzB,2BAA2B,GAC3B,yBAAyB,CAAC;AAGhC,MAAM,MAAM,eAAe,GACrB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types/base.types.d.ts

@@ -0,0 +1,54 @@
+import type { QueueModule } from "../helpers/defineQueue.d.ts";
+import type { ILogger } from "../subsys/LoggerService.d.ts";
+import type { PulsarUnifiedStorage } from "../storage/PulsarStorage.d.ts";
+import type { IIntegration, IntegrationConstructor } from "./integrations.types.d.ts";
+import type { NebulaClusterConfig } from "./nebula.types.d.ts";
+import type { PersistentConfig, ServerlessVMConfig, V8IsolateConfig } from "./runtime.types.d.ts";
+export interface EngineSwarmConfig {
+    maxGlobalConcurrency?: number;
+    spawnerAlgorithm?: "LEAST_CONNECTIONS" | "ROUND_ROBIN" | "CBS";
+    globalMaxJobsPerTick?: number;
+}
+export type BaseEngineConfig = {
+    instanceId: string;
+    autoMigrate: boolean;
+    nebula?: NebulaClusterConfig;
+    /**
+     * The unified storage layer responsible for state management, queue operations, and distributed locks.
+     *
+     * The engine requires **PostgreSQL** as its core underlying storage driver to handle fundamental database
+     * functions and lock tables. However, adding **Redis** to the unified storage driver unlocks an optimized
+     * dual-layer storage architecture.
+     *
+     * When Redis is configured alongside PostgreSQL, the engine automatically offloads high frequency,
+     * heavy throughput read and write operations—such as worker registration, batch dispatches, and job
+     * acknowledgments to Redis memory.
+     *
+     * ### Storage Mode Behavior:
+     * * **PostgreSQL Only:** Handles all state persistence, transactional safety, and queue operations directly on the database.
+     * * **PostgreSQL + Redis (Recommended):** Offloads runtime operational load from PostgreSQL to Redis memory,
+     *   significantly reducing database pressure and boosting overall engine processing speeds and throughput by 25% or more.
+     */
+    storage: PulsarUnifiedStorage;
+    queues: QueueModule[];
+    /**
+     * Consumer configuration for HTTP endpoints.
+     * When provided, Pulsar will make POST requests to this URL for each job.
+     * The job payload will be sent in the request body.
+     */
+    swarmConfig?: EngineSwarmConfig;
+    integrations?: Array<IntegrationConstructor | IIntegration>;
+    logger?: ILogger;
+    onEvents?: {
+        queueComplete?: (ctx: {
+            queue: string;
+            at: number;
+        }) => Promise<void> | void;
+        engineRestart?: () => Promise<void>;
+    };
+};
+/**
+ * Primary engine configuration union with runtime-level type enforcement.
+ */
+export type EngineConfig = V8IsolateConfig | ServerlessVMConfig | PersistentConfig;
+//# sourceMappingURL=base.types.d.ts.map

package/dist/types/base.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.types.d.ts","sourceRoot":"","sources":["../../src/types/base.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEhG,MAAM,WAAW,iBAAiB;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,mBAAmB,GAAG,aAAa,GAAG,KAAK,CAAC;IAC/D,oBAAoB,CAAC,EAAG,MAAM,CAAC;CAClC;AAID,MAAM,MAAM,gBAAgB,GAAG;IAC3B,UAAU,EAAG,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IAErB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAE7B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,EAAG,oBAAoB,CAAC;IAE/B,MAAM,EAAG,WAAW,EAAE,CAAC;IAEvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC,YAAY,CAAC,EAAE,KAAK,CAAC,sBAAsB,GAAG,YAAY,CAAC,CAAC;IAE5D,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,QAAQ,CAAC,EAAG;QACR,aAAa,CAAC,EAAG,CAAC,GAAG,EAAG;YAAE,KAAK,EAAG,MAAM,CAAC;YAAC,EAAE,EAAG,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACjF,aAAa,CAAC,EAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;KACxC,CAAA;CACJ,CAAA;AAGD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,kBAAkB,GAAG,gBAAgB,CAAC"}

package/dist/types/config.types.d.ts

@@ -0,0 +1,54 @@
+import type { PulsarRuntime } from "./runtime.types";
+type RawPathKeys<T> = T extends object ? {
+    [K in keyof T & (string | number)]: T[K] extends Array<any> ? `${K}` : T[K] extends object ? `${K}` | `${K}.${RawPathKeys<T[K]>}` : `${K}`;
+}[keyof T & (string | number)] : never;
+/**
+ * Define exact paths or prefix patterns that MUST NOT be mutated via set().
+ *    - 'storage' | 'storage.${string}': Storage instance should not be swapped on the fly.
+ *    - 'runtime': Prevents switching execution environment at runtime.
+ *    - 'onEvents' | 'onEvents.${string}': Prevents overwriting event hooks.
+ */
+type BlockedPaths = "storage" | `storage.${string}` | "runtime" | "onEvents" | `onEvents.${string}` | "isolate" | `isolate.${string}`;
+/**
+ * Filtered paths allowed specifically for `set()` operations.
+ */
+export type SettablePathKeys<T> = Exclude<RawPathKeys<T>, BlockedPaths>;
+/**
+ * All paths available for `get()` operations (unrestricted read access).
+ */
+export type ReadablePathKeys<T> = RawPathKeys<T>;
+/**
+ * Type utility to infer the value type corresponding to a dot-notation path string.
+ */
+export type PathValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? PathValue<T[K], Rest> : never : P extends keyof T ? T[P] : never;
+export interface IConfigurationObject {
+    queues: Array<{
+        queue: string;
+        pooler: string;
+    }>;
+    self_url: string;
+    runtime: PulsarRuntime;
+}
+export interface IConfigSyncResult {
+    isChanged: boolean;
+    isNew: boolean;
+    oldConfigurations?: IConfigurationObject;
+    delta?: {
+        urlChanged: boolean;
+        addedQueues: Array<{
+            queue: string;
+            pooler: string;
+        }>;
+        removedQueues: Array<{
+            queue: string;
+            pooler: string;
+        }>;
+        modifiedQueues: Array<{
+            queue: string;
+            oldPooler: string;
+            newPooler: string;
+        }>;
+    };
+}
+export {};
+//# sourceMappingURL=config.types.d.ts.map

package/dist/types/config.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.types.d.ts","sourceRoot":"","sources":["../../src/types/config.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAClC;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,GACvD,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAC5B,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE;CAClD,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,GAC9B,KAAK,CAAC;AAEV;;;;;GAKG;AACH,KAAK,YAAY,GACb,SAAS,GACT,WAAW,MAAM,EAAE,GACnB,SAAS,GACT,UAAU,GACV,YAAY,MAAM,EAAE,GACpB,SAAS,GACT,WAAW,MAAM,EAAE,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,MAAM,IAAI,EAAE,GAC7E,CAAC,SAAS,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,KAAK,GACjD,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAGrC,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAG,KAAK,CAAC;QAAE,KAAK,EAAG,MAAM,CAAC;QAAC,MAAM,EAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,QAAQ,EAAG,MAAM,CAAC;IAClB,OAAO,EAAG,aAAa,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,CAAC,EAAE,oBAAoB,CAAC;IACzC,KAAK,CAAC,EAAE;QACJ,UAAU,EAAE,OAAO,CAAC;QACpB,WAAW,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACtD,aAAa,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACxD,cAAc,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClF,CAAA;CACJ"}

package/dist/types/consumer.types.d.ts

@@ -0,0 +1,36 @@
+export type JobContext<T = any> = {
+    /**
+     * The ID Of Worker Which Picked This Batch
+     *
+     * When using callback, the consumer must deregister using this worker id for freeing up the slot
+    ***/
+    workerId: string;
+    /***
+     * The ID Of The Queue From Which This Batch Was Picked
+    ***/
+    queue: string;
+    /***
+     * The Payloads Of The Batch
+    ***/
+    payload: T;
+    /***
+     * The Number Of Attempts This Job Has Undergone
+    ***/
+    attempts: number;
+    timestamp: number;
+};
+export type EngineConsumerConfig = {
+    type: "http";
+    queue: string;
+    url: string;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+} | {
+    type: "socket";
+    queue: string;
+} | {
+    type: "callback";
+    queue: string;
+    handler(job: JobContext): Promise<void>;
+};
+//# sourceMappingURL=consumer.types.d.ts.map

package/dist/types/consumer.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer.types.d.ts","sourceRoot":"","sources":["../../src/types/consumer.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,GAAG,IAAI;IAC9B;;;;QAII;IACJ,QAAQ,EAAG,MAAM,CAAC;IAElB;;QAEI;IACJ,KAAK,EAAG,MAAM,CAAC;IAEf;;QAEI;IACJ,OAAO,EAAG,CAAC,CAAC;IAEZ;;QAEI;IACJ,QAAQ,EAAG,MAAM,CAAC;IAClB,SAAS,EAAG,MAAM,CAAC;CACtB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAC5B;IACE,IAAI,EAAG,MAAM,CAAC;IACd,KAAK,EAAG,MAAM,CAAC;IACf,GAAG,EAAG,MAAM,CAAC;IACb,OAAO,CAAC,EAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,SAAS,CAAC,EAAG,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAG,QAAQ,CAAC;IAChB,KAAK,EAAG,MAAM,CAAC;CAChB,GACD;IACA,IAAI,EAAG,UAAU,CAAC;IAClB,KAAK,EAAG,MAAM,CAAC;IACf,OAAO,CAAC,GAAG,EAAG,UAAU,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C,CAAC"}