@relaybus/core 0.3.1 → 0.4.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { D as Duration, E as EventEnvelope, a as DomainEvent, S as StandardSchemaV1, P as PayloadOf, C as ClaimedDelivery, b as EventHeaders, c as EventStoreStatistics, d as ErrorInfo, e as PurgeResult, f as EventStore, T as Transport, g as EventReference, h as Clock, A as AppendEntry, i as AppendResult, j as ClaimRequest, L as LeaseReference, k as DeliveryQuery, l as DeliveryRecord, m as PurgeRequest, n as EventClass } from './transport-BlfzIBZD.cjs';
-export { o as AttemptsExhaustedError, p as CloseOptions, q as ConfigurationError, r as DELIVERY_STATUSES, s as DefineEventKeyOptions, t as DefineEventOptions, u as DeliveryStatus, v as DispatcherStoppedError, w as DrainIncompleteError, x as EventKeyFunction, y as EventStoreTransactionOptions, z as EventValidationError, H as HandlerTimeoutError, I as InvalidEnvelopeError, B as InvalidTransportMessage, F as LeaseLostError, G as LifecycleError, M as MAX_TIMER_DELAY_MS, N as NewDelivery, J as NonRetryableError, R as RelayBusError, K as TransactionRequiredError, O as TransactionTimeoutError, Q as TransportMessage, U as TransportMessageHandler, V as TransportSubscriptionHooks, W as ValidationIssue, X as assertEventType, Y as defineEvent, Z as systemClock, _ as toErrorInfo, $ as toMilliseconds, a0 as validatePayload } from './transport-BlfzIBZD.cjs';
+import { D as Duration, E as EventEnvelope, a as DomainEvent, S as StandardSchemaV1, P as PayloadOf, C as ClaimedDelivery, b as EventHeaders, c as EventStoreStatistics, d as ErrorInfo, e as PurgeResult, f as EventStore, T as Transport, g as EventReference, h as Clock, A as AppendEntry, i as AppendResult, j as ClaimRequest, L as LeaseReference, k as DeliveryQuery, l as DeliveryRecord, m as PurgeRequest, n as EventClass } from './transport-DIFdeXQY.cjs';
+export { o as AttemptsExhaustedError, p as CloseOptions, q as ConfigurationError, r as DELIVERY_STATUSES, s as DefineEventKeyOptions, t as DefineEventOptions, u as DeliveryStatus, v as DispatcherStoppedError, w as DrainIncompleteError, x as EventKeyFunction, y as EventStoreTransactionOptions, z as EventValidationError, H as HandlerTimeoutError, I as InvalidEnvelopeError, B as InvalidTransportMessage, F as LeaseLostError, G as LifecycleError, M as MAX_TIMER_DELAY_MS, N as NewDelivery, J as NonRetryableError, R as RelayBusError, K as TransactionRequiredError, O as TransactionTimeoutError, Q as TransportMessage, U as TransportMessageHandler, V as TransportSubscriptionHooks, W as ValidationIssue, X as assertEventType, Y as defineEvent, Z as systemClock, _ as toErrorInfo, $ as toMilliseconds, a0 as validatePayload } from './transport-DIFdeXQY.cjs';
 
 /**
  * How the delay between attempts is randomized.
@@ -965,6 +965,11 @@ declare class RelayBus<TTransaction = unknown> {
      */
     drain(maxBatches?: number): Promise<number>;
     listDeliveries(query?: DeliveryQuery): Promise<DeliveryRecord[]>;
+    /**
+     * Asks the dispatcher to claim now. Call it right after committing your own transaction that published,
+     * when the store cannot report the commit (see Tuning, "Wake-up after your transaction commits").
+     */
+    wake(): void;
     /** Moves dead deliveries back to pending with a fresh attempt budget. */
     requeue(deliveryIds: readonly string[]): Promise<number>;
     statistics(): Promise<EventStoreStatistics>;
@@ -972,4 +977,5 @@ declare class RelayBus<TTransaction = unknown> {
     purgeExpired(): Promise<PurgeResult>;
 }
 
-export { AppendEntry, AppendResult, type BacklogEvent, type Catalog, type CatalogDeclaration, type CatalogDescription, type CatalogEntry, type CatalogEventClass, type CatalogEventName, type CatalogEventSelection, type CatalogEvents, CatalogPublisher, type CatalogRole, type ClaimFinishedEvent, ClaimRequest, ClaimedDelivery, Clock, DEFAULT_RETRY_POLICY, DEFAULT_ROUTE_RETRY_POLICY, type DefineCatalogOptions, type DeliveryKind, DeliveryQuery, DeliveryRecord, type DispatcherOptions, DomainEvent, Duration, ErrorInfo, EventClass, EventEnvelope, type EventHandler, EventHeaders, type EventOf, EventReference, EventStore, EventStoreStatistics, type FailureStage, type HandlerContext, type HandlerDescriptor, type HandlerFinishedEvent, type HandlerShapeOf, type HandlerStartedEvent, type HandlersOf, type IdentifierGenerator, InMemoryEventStore, type InMemoryEventStoreOptions, InMemoryTransaction, type InboundSubscriptionOptions, type InvalidMessageEvent, type JitterStrategy, LeaseReference, type MatchingHandlers, type NoExtraHandlers, type OperationOutcome, type PartialHandlersOf, PayloadOf, type ProcessTraceInput, type PublishFinishedEvent, type PublishOneOptions, type PublishOptions, type PublishTarget, type PublishTraceInput, PurgeRequest, PurgeResult, type ReceiveFinishedEvent, type ReceiveOutcome, type ReceiveStatus, RelayBus, type RelayBusLogger, type RelayBusObserver, type RelayBusOptions, type RelayBusTracer, type RetentionOptions, type RetryPolicy, type RetryPolicyOptions, type RouteOptions, type SendTraceInput, StandardSchemaV1, type StopOptions, type StopResult, type SubscribeCatalogOptions, type SubscribeOptions, TRACEPARENT_HEADER, TRACESTATE_HEADER, type TraceContext, type TransactionMode, Transport, type TransportSentEvent, type UnroutedEventPolicy, computeRetryDelay, consume, createRetryPolicy, createUuidV7, defineCatalog, defineHandlers, describeCatalog, isRetryableError, produce, traceContextOf };
+export { AppendEntry, AppendResult, CatalogPublisher, ClaimRequest, ClaimedDelivery, Clock, DEFAULT_RETRY_POLICY, DEFAULT_ROUTE_RETRY_POLICY, DeliveryQuery, DeliveryRecord, DomainEvent, Duration, ErrorInfo, EventClass, EventEnvelope, EventHeaders, EventReference, EventStore, EventStoreStatistics, InMemoryEventStore, InMemoryTransaction, LeaseReference, PayloadOf, PurgeRequest, PurgeResult, RelayBus, StandardSchemaV1, TRACEPARENT_HEADER, TRACESTATE_HEADER, Transport, computeRetryDelay, consume, createRetryPolicy, createUuidV7, defineCatalog, defineHandlers, describeCatalog, isRetryableError, produce, traceContextOf };
+export type { BacklogEvent, Catalog, CatalogDeclaration, CatalogDescription, CatalogEntry, CatalogEventClass, CatalogEventName, CatalogEventSelection, CatalogEvents, CatalogRole, ClaimFinishedEvent, DefineCatalogOptions, DeliveryKind, DispatcherOptions, EventHandler, EventOf, FailureStage, HandlerContext, HandlerDescriptor, HandlerFinishedEvent, HandlerShapeOf, HandlerStartedEvent, HandlersOf, IdentifierGenerator, InMemoryEventStoreOptions, InboundSubscriptionOptions, InvalidMessageEvent, JitterStrategy, MatchingHandlers, NoExtraHandlers, OperationOutcome, PartialHandlersOf, ProcessTraceInput, PublishFinishedEvent, PublishOneOptions, PublishOptions, PublishTarget, PublishTraceInput, ReceiveFinishedEvent, ReceiveOutcome, ReceiveStatus, RelayBusLogger, RelayBusObserver, RelayBusOptions, RelayBusTracer, RetentionOptions, RetryPolicy, RetryPolicyOptions, RouteOptions, SendTraceInput, StopOptions, StopResult, SubscribeCatalogOptions, SubscribeOptions, TraceContext, TransactionMode, TransportSentEvent, UnroutedEventPolicy };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { D as Duration, E as EventEnvelope, a as DomainEvent, S as StandardSchemaV1, P as PayloadOf, C as ClaimedDelivery, b as EventHeaders, c as EventStoreStatistics, d as ErrorInfo, e as PurgeResult, f as EventStore, T as Transport, g as EventReference, h as Clock, A as AppendEntry, i as AppendResult, j as ClaimRequest, L as LeaseReference, k as DeliveryQuery, l as DeliveryRecord, m as PurgeRequest, n as EventClass } from './transport-BlfzIBZD.js';
-export { o as AttemptsExhaustedError, p as CloseOptions, q as ConfigurationError, r as DELIVERY_STATUSES, s as DefineEventKeyOptions, t as DefineEventOptions, u as DeliveryStatus, v as DispatcherStoppedError, w as DrainIncompleteError, x as EventKeyFunction, y as EventStoreTransactionOptions, z as EventValidationError, H as HandlerTimeoutError, I as InvalidEnvelopeError, B as InvalidTransportMessage, F as LeaseLostError, G as LifecycleError, M as MAX_TIMER_DELAY_MS, N as NewDelivery, J as NonRetryableError, R as RelayBusError, K as TransactionRequiredError, O as TransactionTimeoutError, Q as TransportMessage, U as TransportMessageHandler, V as TransportSubscriptionHooks, W as ValidationIssue, X as assertEventType, Y as defineEvent, Z as systemClock, _ as toErrorInfo, $ as toMilliseconds, a0 as validatePayload } from './transport-BlfzIBZD.js';
+import { D as Duration, E as EventEnvelope, a as DomainEvent, S as StandardSchemaV1, P as PayloadOf, C as ClaimedDelivery, b as EventHeaders, c as EventStoreStatistics, d as ErrorInfo, e as PurgeResult, f as EventStore, T as Transport, g as EventReference, h as Clock, A as AppendEntry, i as AppendResult, j as ClaimRequest, L as LeaseReference, k as DeliveryQuery, l as DeliveryRecord, m as PurgeRequest, n as EventClass } from './transport-DIFdeXQY.js';
+export { o as AttemptsExhaustedError, p as CloseOptions, q as ConfigurationError, r as DELIVERY_STATUSES, s as DefineEventKeyOptions, t as DefineEventOptions, u as DeliveryStatus, v as DispatcherStoppedError, w as DrainIncompleteError, x as EventKeyFunction, y as EventStoreTransactionOptions, z as EventValidationError, H as HandlerTimeoutError, I as InvalidEnvelopeError, B as InvalidTransportMessage, F as LeaseLostError, G as LifecycleError, M as MAX_TIMER_DELAY_MS, N as NewDelivery, J as NonRetryableError, R as RelayBusError, K as TransactionRequiredError, O as TransactionTimeoutError, Q as TransportMessage, U as TransportMessageHandler, V as TransportSubscriptionHooks, W as ValidationIssue, X as assertEventType, Y as defineEvent, Z as systemClock, _ as toErrorInfo, $ as toMilliseconds, a0 as validatePayload } from './transport-DIFdeXQY.js';
 
 /**
  * How the delay between attempts is randomized.
@@ -965,6 +965,11 @@ declare class RelayBus<TTransaction = unknown> {
      */
     drain(maxBatches?: number): Promise<number>;
     listDeliveries(query?: DeliveryQuery): Promise<DeliveryRecord[]>;
+    /**
+     * Asks the dispatcher to claim now. Call it right after committing your own transaction that published,
+     * when the store cannot report the commit (see Tuning, "Wake-up after your transaction commits").
+     */
+    wake(): void;
     /** Moves dead deliveries back to pending with a fresh attempt budget. */
     requeue(deliveryIds: readonly string[]): Promise<number>;
     statistics(): Promise<EventStoreStatistics>;
@@ -972,4 +977,5 @@ declare class RelayBus<TTransaction = unknown> {
     purgeExpired(): Promise<PurgeResult>;
 }
 
-export { AppendEntry, AppendResult, type BacklogEvent, type Catalog, type CatalogDeclaration, type CatalogDescription, type CatalogEntry, type CatalogEventClass, type CatalogEventName, type CatalogEventSelection, type CatalogEvents, CatalogPublisher, type CatalogRole, type ClaimFinishedEvent, ClaimRequest, ClaimedDelivery, Clock, DEFAULT_RETRY_POLICY, DEFAULT_ROUTE_RETRY_POLICY, type DefineCatalogOptions, type DeliveryKind, DeliveryQuery, DeliveryRecord, type DispatcherOptions, DomainEvent, Duration, ErrorInfo, EventClass, EventEnvelope, type EventHandler, EventHeaders, type EventOf, EventReference, EventStore, EventStoreStatistics, type FailureStage, type HandlerContext, type HandlerDescriptor, type HandlerFinishedEvent, type HandlerShapeOf, type HandlerStartedEvent, type HandlersOf, type IdentifierGenerator, InMemoryEventStore, type InMemoryEventStoreOptions, InMemoryTransaction, type InboundSubscriptionOptions, type InvalidMessageEvent, type JitterStrategy, LeaseReference, type MatchingHandlers, type NoExtraHandlers, type OperationOutcome, type PartialHandlersOf, PayloadOf, type ProcessTraceInput, type PublishFinishedEvent, type PublishOneOptions, type PublishOptions, type PublishTarget, type PublishTraceInput, PurgeRequest, PurgeResult, type ReceiveFinishedEvent, type ReceiveOutcome, type ReceiveStatus, RelayBus, type RelayBusLogger, type RelayBusObserver, type RelayBusOptions, type RelayBusTracer, type RetentionOptions, type RetryPolicy, type RetryPolicyOptions, type RouteOptions, type SendTraceInput, StandardSchemaV1, type StopOptions, type StopResult, type SubscribeCatalogOptions, type SubscribeOptions, TRACEPARENT_HEADER, TRACESTATE_HEADER, type TraceContext, type TransactionMode, Transport, type TransportSentEvent, type UnroutedEventPolicy, computeRetryDelay, consume, createRetryPolicy, createUuidV7, defineCatalog, defineHandlers, describeCatalog, isRetryableError, produce, traceContextOf };
+export { AppendEntry, AppendResult, CatalogPublisher, ClaimRequest, ClaimedDelivery, Clock, DEFAULT_RETRY_POLICY, DEFAULT_ROUTE_RETRY_POLICY, DeliveryQuery, DeliveryRecord, DomainEvent, Duration, ErrorInfo, EventClass, EventEnvelope, EventHeaders, EventReference, EventStore, EventStoreStatistics, InMemoryEventStore, InMemoryTransaction, LeaseReference, PayloadOf, PurgeRequest, PurgeResult, RelayBus, StandardSchemaV1, TRACEPARENT_HEADER, TRACESTATE_HEADER, Transport, computeRetryDelay, consume, createRetryPolicy, createUuidV7, defineCatalog, defineHandlers, describeCatalog, isRetryableError, produce, traceContextOf };
+export type { BacklogEvent, Catalog, CatalogDeclaration, CatalogDescription, CatalogEntry, CatalogEventClass, CatalogEventName, CatalogEventSelection, CatalogEvents, CatalogRole, ClaimFinishedEvent, DefineCatalogOptions, DeliveryKind, DispatcherOptions, EventHandler, EventOf, FailureStage, HandlerContext, HandlerDescriptor, HandlerFinishedEvent, HandlerShapeOf, HandlerStartedEvent, HandlersOf, IdentifierGenerator, InMemoryEventStoreOptions, InboundSubscriptionOptions, InvalidMessageEvent, JitterStrategy, MatchingHandlers, NoExtraHandlers, OperationOutcome, PartialHandlersOf, ProcessTraceInput, PublishFinishedEvent, PublishOneOptions, PublishOptions, PublishTarget, PublishTraceInput, ReceiveFinishedEvent, ReceiveOutcome, ReceiveStatus, RelayBusLogger, RelayBusObserver, RelayBusOptions, RelayBusTracer, RetentionOptions, RetryPolicy, RetryPolicyOptions, RouteOptions, SendTraceInput, StopOptions, StopResult, SubscribeCatalogOptions, SubscribeOptions, TraceContext, TransactionMode, TransportSentEvent, UnroutedEventPolicy };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { ConfigurationError, assertEventType, CompositeKey, Milliseconds, NonRetryableError, DrainIncompleteError, LifecycleError, schedule, toErrorInfo, LeaseSettlement, TransactionTimeoutError, PositiveInteger, DispatcherStoppedError, DeliveryLeaseIdentity, LeaseLostError, AttemptsExhaustedError, validatePayload, HandlerTimeoutError, TransactionRequiredError, keyFromDefinition, InvalidEnvelopeError } from './chunk-NOR5JHVN.js';
+import { ConfigurationError, assertEventType, CompositeKey, Milliseconds, NonRetryableError, DrainIncompleteError, LifecycleError, toErrorInfo, LeaseSettlement, schedule, TransactionTimeoutError, PositiveInteger, DispatcherStoppedError, DeliveryLeaseIdentity, LeaseLostError, AttemptsExhaustedError, validatePayload, HandlerTimeoutError, TransactionRequiredError, keyFromDefinition, InvalidEnvelopeError } from './chunk-NOR5JHVN.js';
 export { AttemptsExhaustedError, ConfigurationError, DispatcherStoppedError, DrainIncompleteError, EventValidationError, HandlerTimeoutError, InvalidEnvelopeError, LeaseLostError, LifecycleError, MAX_TIMER_DELAY_MS, NonRetryableError, RelayBusError, TransactionRequiredError, TransactionTimeoutError, assertEventType, defineEvent, toErrorInfo, toMilliseconds, validatePayload } from './chunk-NOR5JHVN.js';
 import { randomBytes } from 'crypto';
 import { AsyncLocalStorage } from 'async_hooks';
@@ -2992,7 +2992,7 @@ var EventPublisher = class {
     context,
     delayMs
   }) {
-    const result = await this.#appendInTransaction(entries, context);
+    const { result, committed } = await this.#appendInTransaction(entries, context);
     const appended = new Set(result.appendedEventIds);
     const published = entries.map((entry) => entry.event).filter((envelope) => appended.has(envelope.id));
     if (published.length > 0) {
@@ -3001,22 +3001,26 @@ var EventPublisher = class {
         deliveries: result.appendedDeliveryCount
       });
       if (delayMs === 0) {
-        this.#parts.scheduleWake();
+        this.#parts.scheduleWake(committed);
       }
     }
   }
+  /** Appends in the caller's transaction, else in one of the store's; `committed` tells which. */
   async #appendInTransaction(entries, { options, scope, now }) {
     const { store, transactionMode, transactionResolver } = this.#parts;
     const transaction = options.transaction ?? scope?.transaction ?? transactionResolver?.();
     if (transaction !== void 0) {
-      return store.append(transaction, entries, now);
+      return { result: await store.append(transaction, entries, now), committed: false };
     }
     if (transactionMode === "required") {
       throw new TransactionRequiredError(
         "publish found no transaction. Pass { transaction }, publish inside bus.transaction(), configure transactionResolver, or set transactionMode to optional"
       );
     }
-    return store.transaction((ownTransaction) => store.append(ownTransaction, entries, now));
+    const result = await store.transaction(
+      (ownTransaction) => store.append(ownTransaction, entries, now)
+    );
+    return { result, committed: true };
   }
   async #createEnvelope(input) {
     const { event, options, id, scope, now, correlationId } = input;
@@ -3113,7 +3117,7 @@ var EventReceiver = class {
     const status = result.duplicateEventIds.length > 0 ? "duplicate" : "accepted";
     notifier.notify("onReceived", { envelope: normalized, status });
     if (result.appendedDeliveryCount > 0) {
-      scheduleWake();
+      scheduleWake(true);
     }
     return status;
   }
@@ -3203,6 +3207,58 @@ function createInboxAndOutbox(core, hooks) {
   };
 }
 
+// src/bus/publish-wake-ups.ts
+var FIRST_WAKE_MS = 25;
+var SECOND_WAKE_MS = 100;
+var LAST_WAKE_MS = 250;
+var WAKE_DELAYS_MS = [FIRST_WAKE_MS, SECOND_WAKE_MS, LAST_WAKE_MS];
+var PublishWakeUps = class {
+  #dependencies;
+  #lastPublishAt = 0;
+  #cancel;
+  /** When the pending timer fires. */
+  #dueAt = 0;
+  constructor(dependencies) {
+    this.#dependencies = dependencies;
+  }
+  /**
+   * Wakes the dispatcher for a publish: at once when its transaction has `committed` (one of relaybus'
+   * own), else at the wake-ups after it.
+   */
+  afterPublish(committed) {
+    if (committed) {
+      this.#dependencies.wake();
+      return;
+    }
+    this.#lastPublishAt = this.#dependencies.clock.now().getTime();
+    if (this.#cancel === void 0 || this.#dueAt > this.#lastPublishAt + FIRST_WAKE_MS) {
+      this.cancel();
+      this.#cancel = this.#arm(FIRST_WAKE_MS);
+    }
+  }
+  cancel() {
+    this.#cancel?.();
+    this.#cancel = void 0;
+  }
+  #fire() {
+    this.#cancel = void 0;
+    this.#dependencies.wake();
+    const elapsed = this.#dependencies.clock.now().getTime() - this.#lastPublishAt;
+    const next = WAKE_DELAYS_MS.find((delay) => delay > elapsed);
+    if (next !== void 0) {
+      this.#cancel = this.#arm(next - elapsed);
+    }
+  }
+  #arm(delayMs) {
+    this.#dueAt = this.#dependencies.clock.now().getTime() + delayMs;
+    return schedule(this.#dependencies.clock, {
+      run: () => this.#fire(),
+      delayMs,
+      unref: true
+    });
+  }
+};
+
 // src/transaction-budget.ts
 async function runBudgetedTransaction(store, { clock, timeoutMs, work }) {
   const startedAt = clock.now().getTime();
@@ -3235,20 +3291,24 @@ function createTimeoutError(timeoutMs, cause) {
 
 // src/relay-bus.ts
 var DEFAULT_DRAIN_BATCHES = 1e3;
-var WAKE_DELAY_MS = 25;
 var RelayBus = class {
   #parts;
   #lifecycle;
+  #wakeUps;
   constructor(options) {
     this.#parts = assembleRelayBus(options, {
       reportUnrouted: (envelope) => this.#reportUnrouted(envelope),
-      scheduleWake: () => this.#scheduleWake(),
+      scheduleWake: (committed) => this.#scheduleWake(committed),
       statistics: () => this.statistics()
     });
     this.#lifecycle = new BusLifecycle({
       ...this.#parts,
       closeTransports: (deadline) => this.#closeTransports(deadline)
     });
+    this.#wakeUps = new PublishWakeUps({
+      clock: this.#parts.clock,
+      wake: () => this.#parts.dispatcher.wake()
+    });
   }
   get store() {
     return this.#parts.store;
@@ -3375,6 +3435,7 @@ var RelayBus = class {
     if (!first) {
       return stopping;
     }
+    this.#wakeUps.cancel();
     const result = await stopping;
     if (!result.graceful) {
       this.#parts.logger.warn(
@@ -3408,6 +3469,13 @@ var RelayBus = class {
   listDeliveries(query = {}) {
     return this.#parts.store.listDeliveries(query);
   }
+  /**
+   * Asks the dispatcher to claim now. Call it right after committing your own transaction that published,
+   * when the store cannot report the commit (see Tuning, "Wake-up after your transaction commits").
+   */
+  wake() {
+    this.#parts.dispatcher.wake();
+  }
   /** Moves dead deliveries back to pending with a fresh attempt budget. */
   async requeue(deliveryIds) {
     const moved = await this.#parts.store.requeue(deliveryIds, this.#parts.clock.now());
@@ -3479,15 +3547,11 @@ var RelayBus = class {
     const routes = registrations.filter((registration) => registration.forwardsToTransport).length;
     return { handlers: registrations.length - routes, routes };
   }
-  #scheduleWake() {
+  #scheduleWake(committed) {
     if (this.#lifecycle.state !== "running" || this.#parts.dispatcher.watchesNewDeliveries) {
       return;
     }
-    schedule(this.#parts.clock, {
-      run: () => this.#parts.dispatcher.wake(),
-      delayMs: WAKE_DELAY_MS,
-      unref: true
-    });
+    this.#wakeUps.afterPublish(committed);
   }
   /** Closes every transport, each at most until the deadline; past it they are asked to force. */
   async #closeTransports(deadline) {