@n8n/engine 0.17.0 → 0.18.0

package/dist/graph/validate-executable-graph.js

@@ -4,6 +4,7 @@ exports.MAX_SLOT_INDEX = void 0;
 exports.validateExecutableGraph = validateExecutableGraph;
 const common_1 = require("../common");
 const graph_validation_error_1 = require("./graph-validation.error");
+const loops_1 = require("./loops");
 const workflow_graph_queries_1 = require("./workflow-graph-queries");
 exports.MAX_SLOT_INDEX = 100;
 function validateExecutableGraph(graph) {
@@ -14,9 +15,7 @@ function validateExecutableGraph(graph) {
     if (triggers.length > 1) {
         throw new graph_validation_error_1.GraphValidationError('Graph must have exactly one trigger node');
     }
-    if (graph.edges.some((edge) => edge.isBackEdge)) {
-        throw new common_1.UnimplementedError('Graphs with back-edges (loops) are not supported yet');
-    }
+    (0, loops_1.validateLoops)(graph);
     const [trigger] = triggers;
     const reachable = new Set([trigger.id, ...(0, workflow_graph_queries_1.getDescendantNodeIds)(graph, trigger.id)]);
     for (const edge of graph.edges) {
@@ -36,6 +35,8 @@ function validateExecutableGraph(graph) {
     }
     const seenInputSlots = new Set();
     for (const edge of graph.edges) {
+        if (edge.isBackEdge)
+            continue;
         const slot = `${edge.to}#${edge.inputIndex}`;
         if (seenInputSlots.has(slot)) {
             throw new common_1.UnimplementedError(`Node ${edge.to} has more than one edge into input slot ${edge.inputIndex}; converging branches on one slot is not supported yet`);

package/dist/graph/validate-executable-graph.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-executable-graph.js","sourceRoot":"","sources":["../../src/graph/validate-executable-graph.ts"],"names":[],"mappings":";;;;AAAA,sCAA+C;AAC/C,qEAAgE;AAEhE,qEAAgE;AAEnD,QAAA,cAAc,GAAG,GAAG,CAAC;AAUlC,iCAAwC,KAAoB;IAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IACvE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,6CAAoB,CAAC,yCAAyC,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,6CAAoB,CAAC,0CAA0C,CAAC,CAAC;IAC5E,CAAC;IAID,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,2BAAkB,CAAC,sDAAsD,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC;IAC3B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,IAAA,6CAAoB,EAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpF,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,6CAAoB,CAC7B,QAAQ,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,kEAAkE,IAAI,CAAC,EAAE,kBAAkB,IAAI,CAAC,IAAI,UAAU,CAC7I,CAAC;QACH,CAAC;IACF,CAAC;IAID,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,KAAK,MAAM,KAAK,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,6CAAoB,CAC7B,QAAQ,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,mBAAmB,KAAK,0CAA0C,CACjG,CAAC;YACH,CAAC;YACD,IAAI,KAAK,GAAG,QAAA,cAAc,EAAE,CAAC;gBAC5B,MAAM,IAAI,6CAAoB,CAC7B,QAAQ,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,mBAAmB,KAAK,wBAAwB,QAAA,cAAc,wBAAwB,CACrH,CAAC;YACH,CAAC;QACF,CAAC;IACF,CAAC;IAID,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAC7C,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,2BAAkB,CAC3B,QAAQ,IAAI,CAAC,EAAE,2CAA2C,IAAI,CAAC,UAAU,wDAAwD,CACjI,CAAC;QACH,CAAC;QACD,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACF,CAAC"}
+{"version":3,"file":"validate-executable-graph.js","sourceRoot":"","sources":["../../src/graph/validate-executable-graph.ts"],"names":[],"mappings":";;;;AAAA,sCAA+C;AAC/C,qEAAgE;AAChE,mCAAwC;AAExC,qEAAgE;AAEnD,QAAA,cAAc,GAAG,GAAG,CAAC;AAUlC,iCAAwC,KAAoB;IAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IACvE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,6CAAoB,CAAC,yCAAyC,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,6CAAoB,CAAC,0CAA0C,CAAC,CAAC;IAC5E,CAAC;IAED,IAAA,qBAAa,EAAC,KAAK,CAAC,CAAC;IAErB,MAAM,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC;IAC3B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,IAAA,6CAAoB,EAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpF,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,6CAAoB,CAC7B,QAAQ,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,kEAAkE,IAAI,CAAC,EAAE,kBAAkB,IAAI,CAAC,IAAI,UAAU,CAC7I,CAAC;QACH,CAAC;IACF,CAAC;IAID,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,KAAK,MAAM,KAAK,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,6CAAoB,CAC7B,QAAQ,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,mBAAmB,KAAK,0CAA0C,CACjG,CAAC;YACH,CAAC;YACD,IAAI,KAAK,GAAG,QAAA,cAAc,EAAE,CAAC;gBAC5B,MAAM,IAAI,6CAAoB,CAC7B,QAAQ,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,mBAAmB,KAAK,wBAAwB,QAAA,cAAc,wBAAwB,CACrH,CAAC;YACH,CAAC;QACF,CAAC;IACF,CAAC;IAID,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,UAAU;YAAE,SAAS;QAC9B,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAC7C,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,2BAAkB,CAC3B,QAAQ,IAAI,CAAC,EAAE,2CAA2C,IAAI,CAAC,UAAU,wDAAwD,CACjI,CAAC;QACH,CAAC;QACD,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACF,CAAC"}

package/dist/graph/workflow-graph.d.ts

@@ -1,5 +1,9 @@
 export type StepType = 'trigger' | 'v1-node' | 'wait' | 'subworkflow' | 'batch';
 export type StepConfig = unknown;
+export interface BatchStepConfig {
+    batchSize: number;
+}
+export declare function isBatchStepConfig(config: unknown): config is BatchStepConfig;
 export interface GraphNode {
     id: string;
     name: string;

package/dist/graph/workflow-graph.js

@@ -1,3 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBatchStepConfig = isBatchStepConfig;
+function isBatchStepConfig(config) {
+    if (typeof config !== 'object' || config === null)
+        return false;
+    const { batchSize } = config;
+    return typeof batchSize === 'number' && Number.isInteger(batchSize) && batchSize >= 1;
+}
 //# sourceMappingURL=workflow-graph.js.map

package/dist/graph/workflow-graph.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-graph.js","sourceRoot":"","sources":["../../src/graph/workflow-graph.ts"],"names":[],"mappings":""}
+{"version":3,"file":"workflow-graph.js","sourceRoot":"","sources":["../../src/graph/workflow-graph.ts"],"names":[],"mappings":";;;AA0BA,2BAAkC,MAAe;IAChD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAChE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAiC,CAAC;IACxD,OAAO,OAAO,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,CAAC;AACvF,CAAC"}

package/dist/index.d.ts

@@ -1,15 +1,19 @@
 export { createEngineRuntime } from './runtime';
 export type { EngineRuntime, EngineRuntimeOptions } from './runtime';
-export { InvalidIdentityTokenError, mintIdentityToken, SharedSecretIdentityVerifier, } from './auth';
-export type { AuthenticatedCaller, IdentityVerifier } from './auth';
-export type { EngineErrorResponse } from './server';
+export type { EngineLogger } from './logging';
+export { ACTION_TOKEN, IDENTITY_TOKEN, InvalidActionTokenError, InvalidIdentityTokenError, mintActionToken, mintIdentityToken, SharedSecretIdentityVerifier, verifyActionToken, } from './auth';
+export type { AuthenticatedCaller, ActionScope, IdentityVerifier } from './auth';
+export type { EngineErrorResponse, ExecutionSnapshot, ExecutionStepsResponse, StepDetail, } from './server';
+export { MAX_LIFECYCLE_EVENTS_PER_BATCH, lifecycleEventBatchSchema, lifecycleEventSchema, } from './lifecycle-events';
+export type { LifecycleEventCallback, LifecycleEvent, LifecycleEventBatch, } from './lifecycle-events';
 export type { JsonObject, JsonValue } from './common';
-export type { GraphEdge, GraphNode, StepConfig, StepType, WorkflowGraph, } from './graph';
+export { deriveLoops, isBatchStepConfig } from './graph';
+export type { BatchStepConfig, GraphEdge, GraphNode, StepConfig, StepType, WorkflowGraph, WorkflowLoop, } from './graph';
 export type { ExternalDependencies, IStepExecutor, StepExecutionContext, StepExecutionRequest, StepExecutionResult, } from './dependencies';
 export { AllowAllAdmittance, AdmittanceRejectedError } from './admittance';
 export type { AdmittanceDecision, AdmittanceRequest, AdmittanceService, } from './admittance';
 export type { ExecutionEnqueuedEvent, OrchestrationMessage, StepSettledEvent, StepMessage, StepReadyEvent, WorkQueue, } from './queue';
 export { ExecutionNotFoundError, StepNotFoundError } from './execution';
-export type { ExecutionMode, ExecutionRecord, ExecutionStatus, ExecutionStore, NewExecutionRecord, NewStepRecord, StartExecutionRequest, StartExecutionResult, StepError, StepKey, StepKeyId, StepRecord, StepSlots, StepStatus, StepStore, TriggerOutputs, } from './execution';
+export type { ExecutionMode, ExecutionViewStore, ExecutionRecord, ExecutionStatus, ExecutionStore, ExecutionView, NewExecutionRecord, NewStepRecord, StartExecutionRequest, StartExecutionResult, StepError, StepKey, StepKeyId, StepRecord, StepSlots, StepStatus, StepStore, StepView, TriggerOutputs, } from './execution';
 export { createDataSource, WorkflowExecution, WorkflowStepExecution } from './database';
 export type { EngineStores } from './database';

package/dist/index.js

@@ -1,12 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkflowStepExecution = exports.WorkflowExecution = exports.createDataSource = exports.StepNotFoundError = exports.ExecutionNotFoundError = exports.AdmittanceRejectedError = exports.AllowAllAdmittance = exports.SharedSecretIdentityVerifier = exports.mintIdentityToken = exports.InvalidIdentityTokenError = exports.createEngineRuntime = void 0;
+exports.WorkflowStepExecution = exports.WorkflowExecution = exports.createDataSource = exports.StepNotFoundError = exports.ExecutionNotFoundError = exports.AdmittanceRejectedError = exports.AllowAllAdmittance = exports.isBatchStepConfig = exports.deriveLoops = exports.lifecycleEventSchema = exports.lifecycleEventBatchSchema = exports.MAX_LIFECYCLE_EVENTS_PER_BATCH = exports.verifyActionToken = exports.SharedSecretIdentityVerifier = exports.mintIdentityToken = exports.mintActionToken = exports.InvalidIdentityTokenError = exports.InvalidActionTokenError = exports.IDENTITY_TOKEN = exports.ACTION_TOKEN = exports.createEngineRuntime = void 0;
 var runtime_1 = require("./runtime");
 Object.defineProperty(exports, "createEngineRuntime", { enumerable: true, get: function () { return runtime_1.createEngineRuntime; } });
 var auth_1 = require("./auth");
+Object.defineProperty(exports, "ACTION_TOKEN", { enumerable: true, get: function () { return auth_1.ACTION_TOKEN; } });
+Object.defineProperty(exports, "IDENTITY_TOKEN", { enumerable: true, get: function () { return auth_1.IDENTITY_TOKEN; } });
+Object.defineProperty(exports, "InvalidActionTokenError", { enumerable: true, get: function () { return auth_1.InvalidActionTokenError; } });
 Object.defineProperty(exports, "InvalidIdentityTokenError", { enumerable: true, get: function () { return auth_1.InvalidIdentityTokenError; } });
+Object.defineProperty(exports, "mintActionToken", { enumerable: true, get: function () { return auth_1.mintActionToken; } });
 Object.defineProperty(exports, "mintIdentityToken", { enumerable: true, get: function () { return auth_1.mintIdentityToken; } });
 Object.defineProperty(exports, "SharedSecretIdentityVerifier", { enumerable: true, get: function () { return auth_1.SharedSecretIdentityVerifier; } });
+Object.defineProperty(exports, "verifyActionToken", { enumerable: true, get: function () { return auth_1.verifyActionToken; } });
+var lifecycle_events_1 = require("./lifecycle-events");
+Object.defineProperty(exports, "MAX_LIFECYCLE_EVENTS_PER_BATCH", { enumerable: true, get: function () { return lifecycle_events_1.MAX_LIFECYCLE_EVENTS_PER_BATCH; } });
+Object.defineProperty(exports, "lifecycleEventBatchSchema", { enumerable: true, get: function () { return lifecycle_events_1.lifecycleEventBatchSchema; } });
+Object.defineProperty(exports, "lifecycleEventSchema", { enumerable: true, get: function () { return lifecycle_events_1.lifecycleEventSchema; } });
+var graph_1 = require("./graph");
+Object.defineProperty(exports, "deriveLoops", { enumerable: true, get: function () { return graph_1.deriveLoops; } });
+Object.defineProperty(exports, "isBatchStepConfig", { enumerable: true, get: function () { return graph_1.isBatchStepConfig; } });
 var admittance_1 = require("./admittance");
 Object.defineProperty(exports, "AllowAllAdmittance", { enumerable: true, get: function () { return admittance_1.AllowAllAdmittance; } });
 Object.defineProperty(exports, "AdmittanceRejectedError", { enumerable: true, get: function () { return admittance_1.AdmittanceRejectedError; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAAgD;AAAvC,8GAAA,mBAAmB,OAAA;AAG5B,+BAIgB;AAHf,iHAAA,yBAAyB,OAAA;AACzB,yGAAA,iBAAiB,OAAA;AACjB,oHAAA,4BAA4B,OAAA;AAwB7B,2CAA2E;AAAlE,gHAAA,kBAAkB,OAAA;AAAE,qHAAA,uBAAuB,OAAA;AAgBpD,yCAAwE;AAA/D,mHAAA,sBAAsB,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAoBlD,uCAAwF;AAA/E,4GAAA,gBAAgB,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AAAE,iHAAA,qBAAqB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAAgD;AAAvC,8GAAA,mBAAmB,OAAA;AAK5B,+BASgB;AARf,oGAAA,YAAY,OAAA;AACZ,sGAAA,cAAc,OAAA;AACd,+GAAA,uBAAuB,OAAA;AACvB,iHAAA,yBAAyB,OAAA;AACzB,uGAAA,eAAe,OAAA;AACf,yGAAA,iBAAiB,OAAA;AACjB,oHAAA,4BAA4B,OAAA;AAC5B,yGAAA,iBAAiB,OAAA;AAYlB,uDAI4B;AAH3B,kIAAA,8BAA8B,OAAA;AAC9B,6HAAA,yBAAyB,OAAA;AACzB,wHAAA,oBAAoB,OAAA;AAUrB,iCAAyD;AAAhD,oGAAA,WAAW,OAAA;AAAE,0GAAA,iBAAiB,OAAA;AAmBvC,2CAA2E;AAAlE,gHAAA,kBAAkB,OAAA;AAAE,qHAAA,uBAAuB,OAAA;AAgBpD,yCAAwE;AAA/D,mHAAA,sBAAsB,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAuBlD,uCAAwF;AAA/E,4GAAA,gBAAgB,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AAAE,iHAAA,qBAAqB,OAAA"}

package/dist/lifecycle-events/batching-lifecycle-event-publisher.d.ts

@@ -0,0 +1,26 @@
+import type { LifecycleEventPublisher } from './lifecycle-event-publisher';
+import type { LifecycleEventCallback, LifecycleEvent } from './lifecycle-event.types';
+export declare const DEFAULT_LIFECYCLE_EVENT_FLUSH_INTERVAL_MS = 50;
+export declare const DEFAULT_LIFECYCLE_EVENT_SEND_TIMEOUT_MS = 10000;
+export declare const DEFAULT_MAX_PENDING_EVENTS: number;
+export declare class BatchingLifecycleEventPublisher implements LifecycleEventPublisher {
+    private readonly send;
+    private readonly flushIntervalMs;
+    private readonly batchSize;
+    private readonly maxPending;
+    private readonly sendTimeoutMs;
+    private readonly pending;
+    private flushTimer;
+    private draining;
+    private stopped;
+    private abandoned;
+    private dropped;
+    constructor(send: LifecycleEventCallback, flushIntervalMs?: number, batchSize?: number, maxPending?: number, sendTimeoutMs?: number);
+    publish(event: LifecycleEvent): void;
+    stop(): Promise<void>;
+    private startDraining;
+    private drain;
+    private reportDropped;
+    private arm;
+    private disarm;
+}

package/dist/lifecycle-events/batching-lifecycle-event-publisher.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatchingLifecycleEventPublisher = exports.DEFAULT_MAX_PENDING_EVENTS = exports.DEFAULT_LIFECYCLE_EVENT_SEND_TIMEOUT_MS = exports.DEFAULT_LIFECYCLE_EVENT_FLUSH_INTERVAL_MS = void 0;
+const lifecycle_event_schema_1 = require("./lifecycle-event.schema");
+exports.DEFAULT_LIFECYCLE_EVENT_FLUSH_INTERVAL_MS = 50;
+exports.DEFAULT_LIFECYCLE_EVENT_SEND_TIMEOUT_MS = 10_000;
+exports.DEFAULT_MAX_PENDING_EVENTS = 20 * lifecycle_event_schema_1.MAX_LIFECYCLE_EVENTS_PER_BATCH;
+class BatchingLifecycleEventPublisher {
+    send;
+    flushIntervalMs;
+    batchSize;
+    maxPending;
+    sendTimeoutMs;
+    pending = [];
+    flushTimer;
+    draining;
+    stopped = false;
+    abandoned = false;
+    dropped = 0;
+    constructor(send, flushIntervalMs = exports.DEFAULT_LIFECYCLE_EVENT_FLUSH_INTERVAL_MS, batchSize = lifecycle_event_schema_1.MAX_LIFECYCLE_EVENTS_PER_BATCH, maxPending = exports.DEFAULT_MAX_PENDING_EVENTS, sendTimeoutMs = exports.DEFAULT_LIFECYCLE_EVENT_SEND_TIMEOUT_MS) {
+        this.send = send;
+        this.flushIntervalMs = flushIntervalMs;
+        this.batchSize = batchSize;
+        this.maxPending = maxPending;
+        this.sendTimeoutMs = sendTimeoutMs;
+    }
+    publish(event) {
+        if (this.stopped)
+            return;
+        if (this.pending.length >= this.maxPending) {
+            this.dropped++;
+            return;
+        }
+        this.pending.push(event);
+        if (this.pending.length >= this.batchSize)
+            this.startDraining();
+        else
+            this.arm();
+    }
+    async stop() {
+        this.stopped = true;
+        this.startDraining();
+        try {
+            await withDeadline('lifecycle event drain', this.sendTimeoutMs, async () => {
+                await this.draining;
+            });
+        }
+        catch {
+            this.abandoned = true;
+        }
+        this.reportDropped();
+    }
+    startDraining() {
+        this.disarm();
+        if (this.draining)
+            return;
+        this.draining = this.drain().finally(() => {
+            this.draining = undefined;
+        });
+    }
+    async drain() {
+        await Promise.resolve();
+        while (this.pending.length > 0 && !this.abandoned) {
+            const batch = this.pending.splice(0, this.batchSize);
+            this.reportDropped();
+            try {
+                await withDeadline('lifecycle event callback', this.sendTimeoutMs, async (signal) => await this.send(batch, signal));
+            }
+            catch (error) {
+                console.warn(`engine: lifecycle event callback failed, dropped ${batch.length} event(s)`, error);
+            }
+        }
+        if (this.pending.length > 0) {
+            console.warn(`engine: lifecycle event publisher stopped, dropped ${this.pending.length} unsent event(s)`);
+            this.pending.length = 0;
+        }
+    }
+    reportDropped() {
+        if (this.dropped === 0)
+            return;
+        console.warn(`engine: lifecycle event backlog full, dropped ${this.dropped} event(s)`);
+        this.dropped = 0;
+    }
+    arm() {
+        if (this.flushTimer)
+            return;
+        this.flushTimer = setTimeout(() => {
+            this.flushTimer = undefined;
+            this.startDraining();
+        }, this.flushIntervalMs);
+        this.flushTimer.unref();
+    }
+    disarm() {
+        if (!this.flushTimer)
+            return;
+        clearTimeout(this.flushTimer);
+        this.flushTimer = undefined;
+    }
+}
+exports.BatchingLifecycleEventPublisher = BatchingLifecycleEventPublisher;
+async function withDeadline(what, ms, work) {
+    const overdue = new AbortController();
+    let timer;
+    try {
+        return await Promise.race([
+            work(overdue.signal),
+            new Promise((_, reject) => {
+                timer = setTimeout(() => {
+                    const error = new Error(`${what} did not settle within ${ms}ms`);
+                    overdue.abort(error);
+                    reject(error);
+                }, ms);
+                timer.unref();
+            }),
+        ]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=batching-lifecycle-event-publisher.js.map

package/dist/lifecycle-events/batching-lifecycle-event-publisher.js.map

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

package/dist/lifecycle-events/index.d.ts

@@ -0,0 +1,6 @@
+export { BatchingLifecycleEventPublisher, DEFAULT_MAX_PENDING_EVENTS, DEFAULT_LIFECYCLE_EVENT_FLUSH_INTERVAL_MS, DEFAULT_LIFECYCLE_EVENT_SEND_TIMEOUT_MS, } from './batching-lifecycle-event-publisher';
+export { noopLifecycleEventPublisher } from './lifecycle-event-publisher';
+export type { LifecycleEventPublisher } from './lifecycle-event-publisher';
+export { MAX_LIFECYCLE_EVENTS_PER_BATCH, lifecycleEventBatchSchema, lifecycleEventSchema, } from './lifecycle-event.schema';
+export type { LifecycleEventBatch } from './lifecycle-event.schema';
+export type { LifecycleEventCallback, LifecycleEvent } from './lifecycle-event.types';

package/dist/lifecycle-events/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lifecycleEventSchema = exports.lifecycleEventBatchSchema = exports.MAX_LIFECYCLE_EVENTS_PER_BATCH = exports.noopLifecycleEventPublisher = exports.DEFAULT_LIFECYCLE_EVENT_SEND_TIMEOUT_MS = exports.DEFAULT_LIFECYCLE_EVENT_FLUSH_INTERVAL_MS = exports.DEFAULT_MAX_PENDING_EVENTS = exports.BatchingLifecycleEventPublisher = void 0;
+var batching_lifecycle_event_publisher_1 = require("./batching-lifecycle-event-publisher");
+Object.defineProperty(exports, "BatchingLifecycleEventPublisher", { enumerable: true, get: function () { return batching_lifecycle_event_publisher_1.BatchingLifecycleEventPublisher; } });
+Object.defineProperty(exports, "DEFAULT_MAX_PENDING_EVENTS", { enumerable: true, get: function () { return batching_lifecycle_event_publisher_1.DEFAULT_MAX_PENDING_EVENTS; } });
+Object.defineProperty(exports, "DEFAULT_LIFECYCLE_EVENT_FLUSH_INTERVAL_MS", { enumerable: true, get: function () { return batching_lifecycle_event_publisher_1.DEFAULT_LIFECYCLE_EVENT_FLUSH_INTERVAL_MS; } });
+Object.defineProperty(exports, "DEFAULT_LIFECYCLE_EVENT_SEND_TIMEOUT_MS", { enumerable: true, get: function () { return batching_lifecycle_event_publisher_1.DEFAULT_LIFECYCLE_EVENT_SEND_TIMEOUT_MS; } });
+var lifecycle_event_publisher_1 = require("./lifecycle-event-publisher");
+Object.defineProperty(exports, "noopLifecycleEventPublisher", { enumerable: true, get: function () { return lifecycle_event_publisher_1.noopLifecycleEventPublisher; } });
+var lifecycle_event_schema_1 = require("./lifecycle-event.schema");
+Object.defineProperty(exports, "MAX_LIFECYCLE_EVENTS_PER_BATCH", { enumerable: true, get: function () { return lifecycle_event_schema_1.MAX_LIFECYCLE_EVENTS_PER_BATCH; } });
+Object.defineProperty(exports, "lifecycleEventBatchSchema", { enumerable: true, get: function () { return lifecycle_event_schema_1.lifecycleEventBatchSchema; } });
+Object.defineProperty(exports, "lifecycleEventSchema", { enumerable: true, get: function () { return lifecycle_event_schema_1.lifecycleEventSchema; } });
+//# sourceMappingURL=index.js.map

package/dist/lifecycle-events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lifecycle-events/index.ts"],"names":[],"mappings":";;;AAAA,2FAK8C;AAJ7C,qJAAA,+BAA+B,OAAA;AAC/B,gJAAA,0BAA0B,OAAA;AAC1B,+JAAA,yCAAyC,OAAA;AACzC,6JAAA,uCAAuC,OAAA;AAExC,yEAA0E;AAAjE,wIAAA,2BAA2B,OAAA;AAEpC,mEAIkC;AAHjC,wIAAA,8BAA8B,OAAA;AAC9B,mIAAA,yBAAyB,OAAA;AACzB,8HAAA,oBAAoB,OAAA"}

package/dist/lifecycle-events/lifecycle-event-publisher.d.ts

@@ -0,0 +1,6 @@
+import type { LifecycleEvent } from './lifecycle-event.types';
+export interface LifecycleEventPublisher {
+    publish(event: LifecycleEvent): void;
+    stop(): Promise<void>;
+}
+export declare const noopLifecycleEventPublisher: LifecycleEventPublisher;

package/dist/lifecycle-events/lifecycle-event-publisher.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noopLifecycleEventPublisher = void 0;
+exports.noopLifecycleEventPublisher = Object.freeze({
+    publish: () => { },
+    stop: async () => { },
+});
+//# sourceMappingURL=lifecycle-event-publisher.js.map

package/dist/lifecycle-events/lifecycle-event-publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-event-publisher.js","sourceRoot":"","sources":["../../src/lifecycle-events/lifecycle-event-publisher.ts"],"names":[],"mappings":";;;AAWa,QAAA,2BAA2B,GAA4B,MAAM,CAAC,MAAM,CAAC;IACjF,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;IACjB,IAAI,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;CACpB,CAAC,CAAC"}