@flowcore/pathways 0.16.3 → 0.17.0

package/script/pathways/cluster/cluster-manager.d.ts

@@ -0,0 +1,75 @@
+import type { FlowcoreEvent } from "../../contracts/event.js";
+import type { Logger } from "../logger.js";
+import type { ClusterRole, PathwayClusterOptions } from "./types.js";
+/**
+ * ClusterManager handles distributed event processing via leader election and WS workers.
+ *
+ * Lifecycle: register → heartbeat loop → leader election loop
+ * - Leader: opens WS connections to workers, distributes events round-robin
+ * - Worker: accepts WS from leader, processes events, sends ack/fail
+ * - Fallback: leader processes locally when no workers available
+ */
+export declare class ClusterManager {
+    private readonly coordinator;
+    private readonly transport;
+    private readonly instanceId;
+    private readonly advertisedAddress;
+    private readonly port;
+    private readonly leaseTtlMs;
+    private readonly leaseRenewIntervalMs;
+    private readonly heartbeatIntervalMs;
+    private readonly staleThresholdMs;
+    private readonly deliveryTimeoutMs;
+    private readonly workerConcurrency;
+    private readonly logger;
+    private role;
+    private running;
+    private heartbeatTimer;
+    private leaseTimer;
+    private deliveryTimeoutTimer;
+    private workerConnections;
+    private pendingDeliveries;
+    private workerAddresses;
+    private roundRobinIndex;
+    private wsServer;
+    private leaderConnection;
+    private eventHandler;
+    constructor(options: PathwayClusterOptions, logger?: Logger);
+    /**
+     * Set the handler that processes events locally (used by both leader fallback and workers)
+     */
+    setEventHandler(handler: (pathway: string, event: FlowcoreEvent) => Promise<void>): void;
+    /**
+     * Start the cluster: register instance, begin heartbeat, attempt leader election
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the cluster: release lease, unregister, close connections
+     */
+    stop(): Promise<void>;
+    /**
+     * Process an event through the cluster.
+     * - Leader: distribute to a worker or process locally if no workers
+     * - Worker: should not call this directly (receives events via WS)
+     */
+    processEvent(pathway: string, event: FlowcoreEvent): Promise<void>;
+    get isLeader(): boolean;
+    get isWorker(): boolean;
+    get currentRole(): ClusterRole;
+    get isRunning(): boolean;
+    get currentInstanceId(): string;
+    private tryAcquireLease;
+    private leaseLoop;
+    private onBecomeLeader;
+    private refreshWorkers;
+    private cleanupLeaderState;
+    private startWsServer;
+    private handleWorkerMessage;
+    private connectToWorker;
+    private handleLeaderMessage;
+    private getNextWorker;
+    private distributeToWorker;
+    private processLocally;
+    private checkDeliveryTimeouts;
+}
+//# sourceMappingURL=cluster-manager.d.ts.map

package/script/pathways/cluster/cluster-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-manager.d.ts","sourceRoot":"","sources":["../../../src/pathways/cluster/cluster-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAE1C,OAAO,KAAK,EACV,WAAW,EAGX,qBAAqB,EAMtB,MAAM,YAAY,CAAA;AAwCnB;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAQ;IAC7C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAQ;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAE/B,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,oBAAoB,CAA8C;IAG1E,OAAO,CAAC,iBAAiB,CAAwC;IACjE,OAAO,CAAC,iBAAiB,CAA0C;IACnE,OAAO,CAAC,eAAe,CAAe;IACtC,OAAO,CAAC,eAAe,CAAI;IAG3B,OAAO,CAAC,QAAQ,CAA6C;IAC7D,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,YAAY,CAA0E;gBAElF,OAAO,EAAE,qBAAqB,EAAE,MAAM,CAAC,EAAE,MAAM;IAe3D;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC;IAIjF;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiE3B;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BxE,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,WAAW,IAAI,WAAW,CAE7B;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;YAIa,eAAe;YAgBf,SAAS;YAeT,cAAc;YAId,cAAc;IAmC5B,OAAO,CAAC,kBAAkB;YAeZ,aAAa;YAgCb,mBAAmB;IA8CjC,OAAO,CAAC,eAAe;IAwCvB,OAAO,CAAC,mBAAmB;IA4B3B,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,kBAAkB;YAkCZ,cAAc;IAO5B,OAAO,CAAC,qBAAqB;CAS9B"}