atomic-queues 2.2.0 → 3.0.0

package/dist/grpc/grpc-client-pool.service.js

@@ -0,0 +1,307 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+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 __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var GrpcClientPool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrpcClientPool = void 0;
+const common_1 = require("@nestjs/common");
+const path = __importStar(require("path"));
+const uuid_1 = require("uuid");
+const constants_1 = require("../services/constants");
+/**
+ * gRPC Client Pool — maintains connections to peer servers.
+ *
+ * Provides `forward()` and `forwardAndWait()` methods that the
+ * MessageRouter calls when an entity is owned by a remote server.
+ */
+let GrpcClientPool = GrpcClientPool_1 = class GrpcClientPool {
+    constructor(config) {
+        this.config = config;
+        this.logger = new common_1.Logger(GrpcClientPool_1.name);
+        this.clients = new Map();
+        this.circuitBreakers = new Map();
+        this.grpcModule = null;
+        this.protoDescriptor = null;
+        this.failureThreshold = config.grpc?.circuitBreakerFailureThreshold ?? 3;
+        this.cooldownMs = config.grpc?.circuitBreakerCooldownMs ?? 2000;
+    }
+    async onModuleInit() {
+        if (this.config.grpc?.enabled) {
+            await this.ensureLoaded();
+        }
+    }
+    async onApplicationShutdown() {
+        for (const [, { client }] of this.clients) {
+            try {
+                client.close();
+            }
+            catch {
+                // ignore
+            }
+        }
+        this.clients.clear();
+        this.circuitBreakers.clear();
+    }
+    /**
+     * Ensure the gRPC module is loaded (lazy, for optional dependency).
+     */
+    async ensureLoaded() {
+        if (this.grpcModule)
+            return;
+        /* eslint-disable @typescript-eslint/no-var-requires */
+        const grpc = require('@grpc/grpc-js');
+        const protoLoader = require('@grpc/proto-loader');
+        /* eslint-enable @typescript-eslint/no-var-requires */
+        const protoPath = path.join(__dirname, 'atomicqueues.proto');
+        const packageDef = protoLoader.loadSync(protoPath, {
+            keepCase: false,
+            longs: String,
+            enums: String,
+            defaults: true,
+            oneofs: true,
+        });
+        this.grpcModule = grpc;
+        this.protoDescriptor = grpc.loadPackageDefinition(packageDef);
+    }
+    /**
+     * Get or create a client connection to a peer server.
+     */
+    checkCircuit(serverId) {
+        const cb = this.circuitBreakers.get(serverId);
+        if (!cb || cb.state === 'closed')
+            return;
+        if (cb.state === 'open') {
+            if (Date.now() - cb.openedAt >= this.cooldownMs) {
+                cb.state = 'half-open';
+                return;
+            }
+            throw new Error('PEER_CIRCUIT_OPEN');
+        }
+    }
+    recordSuccess(serverId) {
+        const cb = this.circuitBreakers.get(serverId);
+        if (cb) {
+            cb.state = 'closed';
+            cb.consecutiveFailures = 0;
+        }
+    }
+    recordFailure(serverId) {
+        let cb = this.circuitBreakers.get(serverId);
+        if (!cb) {
+            cb = { state: 'closed', consecutiveFailures: 0, lastFailureAt: 0, openedAt: 0 };
+            this.circuitBreakers.set(serverId, cb);
+        }
+        cb.consecutiveFailures++;
+        cb.lastFailureAt = Date.now();
+        if (cb.consecutiveFailures >= this.failureThreshold) {
+            cb.state = 'open';
+            cb.openedAt = Date.now();
+        }
+    }
+    openCircuit(serverId) {
+        let cb = this.circuitBreakers.get(serverId);
+        if (!cb) {
+            cb = { state: 'closed', consecutiveFailures: 0, lastFailureAt: 0, openedAt: 0 };
+            this.circuitBreakers.set(serverId, cb);
+        }
+        cb.state = 'open';
+        cb.openedAt = Date.now();
+    }
+    closeCircuit(serverId) {
+        const cb = this.circuitBreakers.get(serverId);
+        if (cb) {
+            cb.state = 'closed';
+            cb.consecutiveFailures = 0;
+        }
+    }
+    async getClient(serverId, address) {
+        this.checkCircuit(serverId);
+        const existing = this.clients.get(serverId);
+        if (existing && existing.address === address) {
+            return existing.client;
+        }
+        await this.ensureLoaded();
+        const ServiceClass = this.protoDescriptor.atomicqueues.v1.AtomicQueuesNode;
+        const channelOptions = {
+            'grpc.keepalive_time_ms': this.config.grpc?.keepaliveTimeMs ?? 10000,
+            'grpc.keepalive_timeout_ms': this.config.grpc?.keepaliveTimeoutMs ?? 5000,
+            'grpc.keepalive_permit_without_calls': 1,
+        };
+        const client = new ServiceClass(address, this.grpcModule.credentials.createInsecure(), channelOptions);
+        this.clients.set(serverId, { address, client });
+        this.logger.log(`Connected to peer ${serverId} at ${address}`);
+        return client;
+    }
+    /**
+     * Forward a message to a remote server (fire-and-forget).
+     */
+    async forward(serverId, address, message, originServerId, hops, senderEpoch = 0) {
+        const client = await this.getClient(serverId, address);
+        const envelope = {
+            id: message.id,
+            name: message.name,
+            payload: Buffer.from(JSON.stringify(message.data), 'utf-8'),
+            entityType: message.entityType,
+            entityId: message.entityId,
+            correlationId: message.correlationId ?? '',
+            isQuery: message.isQuery ?? false,
+            enqueuedAt: message.enqueuedAt,
+            attempts: message.attempts,
+            maxAttempts: message.maxAttempts,
+            originServer: originServerId,
+            hops: hops + 1,
+            senderEpoch,
+        };
+        const deadline = new Date(Date.now() + (this.config.grpc?.deadlines?.forwardMs ?? 1500));
+        return new Promise((resolve, reject) => {
+            client.forward(envelope, { deadline }, (err, response) => {
+                if (err) {
+                    reject(new Error(`gRPC forward to ${serverId} failed: ${err.message}`));
+                    return;
+                }
+                if (!response.accepted) {
+                    reject(new Error(`Forward rejected by ${serverId}: ${response.rejectReason}`));
+                    return;
+                }
+                resolve({
+                    id: message.id,
+                    entityKey: `${message.entityType}:${message.entityId}`,
+                });
+            });
+        });
+    }
+    /**
+     * Forward a message to a remote server and wait for the result.
+     */
+    async forwardAndWait(serverId, address, message, originServerId, hops, timeout, senderEpoch = 0) {
+        const client = await this.getClient(serverId, address);
+        const envelope = {
+            id: message.id,
+            name: message.name,
+            payload: Buffer.from(JSON.stringify(message.data), 'utf-8'),
+            entityType: message.entityType,
+            entityId: message.entityId,
+            correlationId: message.correlationId ?? (0, uuid_1.v4)(),
+            isQuery: true,
+            enqueuedAt: message.enqueuedAt,
+            attempts: message.attempts,
+            maxAttempts: message.maxAttempts,
+            originServer: originServerId,
+            hops: hops + 1,
+            senderEpoch,
+        };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`gRPC forwardAndWait to ${serverId} timed out after ${timeout}ms`));
+            }, timeout);
+            const stream = client.forwardAndWait(envelope);
+            stream.on('data', (response) => {
+                clearTimeout(timer);
+                if (response.error) {
+                    reject(new Error(response.error));
+                }
+                else if (response.result) {
+                    const resultJson = Buffer.from(response.result).toString('utf-8');
+                    resolve(JSON.parse(resultJson));
+                }
+                else {
+                    reject(new Error('Empty result from remote server'));
+                }
+            });
+            stream.on('error', (err) => {
+                clearTimeout(timer);
+                reject(new Error(`gRPC stream error from ${serverId}: ${err.message}`));
+            });
+            stream.on('end', () => {
+                clearTimeout(timer);
+                // If we haven't resolved yet, the stream ended without data
+            });
+        });
+    }
+    /**
+     * Ping a peer server.
+     */
+    async ping(serverId, address) {
+        const client = await this.getClient(serverId, address);
+        const myServerId = this.config.grpc?.serverId ?? 'unknown';
+        const deadline = new Date(Date.now() + (this.config.grpc?.deadlines?.pingMs ?? 1000));
+        return new Promise((resolve, _reject) => {
+            client.ping({ senderId: myServerId }, { deadline }, (err, response) => {
+                if (err) {
+                    resolve({ healthy: false, queueDepth: 0 });
+                    return;
+                }
+                resolve({
+                    healthy: true,
+                    queueDepth: response.queueDepth ?? 0,
+                });
+            });
+        });
+    }
+    /**
+     * Remove a client connection.
+     */
+    removeClient(serverId) {
+        const existing = this.clients.get(serverId);
+        if (existing) {
+            try {
+                existing.client.close();
+            }
+            catch {
+                // ignore
+            }
+            this.clients.delete(serverId);
+        }
+        this.circuitBreakers.delete(serverId);
+    }
+};
+exports.GrpcClientPool = GrpcClientPool;
+exports.GrpcClientPool = GrpcClientPool = GrpcClientPool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(constants_1.ATOMIC_QUEUES_CONFIG)),
+    __metadata("design:paramtypes", [Object])
+], GrpcClientPool);
+//# sourceMappingURL=grpc-client-pool.service.js.map

package/dist/grpc/grpc-client-pool.service.js.map

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

package/dist/grpc/grpc-server.service.d.ts

@@ -0,0 +1,47 @@
+import { OnModuleInit, OnApplicationShutdown } from '@nestjs/common';
+import { IAtomicQueuesModuleConfig } from '../domain';
+import { MessageRouter } from '../services/message-router';
+import { EntityWorkerManager } from '../workers';
+import { MasterCoordinator, LeaderElectionService, ClusterDiscoveryService } from '../cluster';
+/**
+ * gRPC Server — handles all cross-replica and cross-service communication.
+ *
+ * RPCs:
+ * - SpawnWorker / TeardownWorker / ListWorkers: Master → Replica
+ * - EnqueueToWorker / EnqueueToWorkerAndWait: Master → Replica (dispatch)
+ * - Petition / PetitionAndWait: Replica → Master (routing)
+ * - ReportIdle: Replica → Master (idle teardown)
+ * - Forward / ForwardAndWait: Master → Master (cross-service)
+ */
+export declare class GrpcServerService implements OnModuleInit, OnApplicationShutdown {
+    private readonly config;
+    private readonly router;
+    private readonly workerManager;
+    private readonly masterCoordinator;
+    private readonly leaderElection;
+    private readonly clusterDiscovery?;
+    private readonly logger;
+    private server;
+    private activePetitions;
+    private readonly maxConcurrentPetitions;
+    private nodeAddressCache;
+    constructor(config: IAtomicQueuesModuleConfig, router: MessageRouter, workerManager: EntityWorkerManager, masterCoordinator: MasterCoordinator, leaderElection: LeaderElectionService, clusterDiscovery?: ClusterDiscoveryService | undefined);
+    onModuleInit(): Promise<void>;
+    onApplicationShutdown(): Promise<void>;
+    private handleSpawnWorker;
+    private handleEnqueueToWorker;
+    private handleEnqueueToWorkerAndWait;
+    private handleTeardownWorker;
+    private handleListWorkers;
+    private handlePetition;
+    private handlePetitionAndWait;
+    private handleReportIdle;
+    private handleReportWorkers;
+    private handleForward;
+    private handleForwardAndWait;
+    private handlePing;
+    private resolveAndWaitTimeout;
+    private getReplicaAddress;
+    private deserializeEnvelope;
+}
+//# sourceMappingURL=grpc-server.service.d.ts.map

package/dist/grpc/grpc-server.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc-server.service.d.ts","sourceRoot":"","sources":["../../src/grpc/grpc-server.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,YAAY,EACZ,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,yBAAyB,EAAsB,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAkC/F;;;;;;;;;GASG;AACH,qBACa,iBAAkB,YAAW,YAAY,EAAE,qBAAqB;IAQ3C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IAChE,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc;IACnB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAbhD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,gBAAgB,CAAgE;gBAGvC,MAAM,EAAE,yBAAyB,EACtB,MAAM,EAAE,aAAa,EAC9D,aAAa,EAAE,mBAAmB,EAElC,iBAAiB,EAAE,iBAAiB,EACpC,cAAc,EAAE,qBAAqB,EACzB,gBAAgB,CAAC,EAAE,uBAAuB,YAAA;IAKnE,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAyE7B,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5C,OAAO,CAAC,iBAAiB;YAUX,qBAAqB;YA+BrB,4BAA4B;YAiD5B,oBAAoB;IAUlC,OAAO,CAAC,iBAAiB;YAeX,cAAc;YA2Cd,qBAAqB;IAgEnC,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,mBAAmB;YAab,aAAa;YA2Bb,oBAAoB;IAqDlC,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,qBAAqB;YAQf,iBAAiB;IAkB/B,OAAO,CAAC,mBAAmB;CAkB5B"}