@horizon-republic/nestjs-jetstream 2.3.6 → 2.4.1

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { ModuleMetadata, FactoryProvider, Type, Logger, OnApplicationShutdown, DynamicModule } from '@nestjs/common';
-import { MsgHdrs, StreamConfig, ConsumerConfig, ConnectionOptions, NatsConnection, Status, JetStreamManager, ConsumerInfo, JsMsg, Msg } from 'nats';
+import { MsgHdrs, StreamConfig, ConsumerConfig, DeliverPolicy, ReplayPolicy, ConnectionOptions, NatsConnection, Status, JetStreamManager, ConsumerInfo, JsMsg, Msg } from 'nats';
 import { MessageHandler, Server, CustomTransportStrategy, ClientProxy, ReadPacket, WritePacket, BaseRpcContext } from '@nestjs/microservices';
 import { Observable } from 'rxjs';
 
@@ -129,6 +129,37 @@ interface StreamConsumerOverrides {
     stream?: Partial<StreamConfig>;
     consumer?: Partial<ConsumerConfig>;
 }
+/**
+ * Configuration for ordered event consumers.
+ *
+ * Ordered consumers use Limits retention and deliver messages in strict
+ * sequential order with at-most-once delivery. No ack/nak/DLQ.
+ *
+ * Only a subset of consumer options applies — ordered consumers are
+ * ephemeral and auto-managed by nats.js.
+ */
+interface OrderedEventOverrides {
+    /** Stream overrides (e.g. `max_age`, `max_bytes`). */
+    stream?: Partial<StreamConfig>;
+    /**
+     * Where to start reading when the consumer is (re)created.
+     * @default DeliverPolicy.All
+     */
+    deliverPolicy?: DeliverPolicy;
+    /**
+     * Start sequence number. Only used when `deliverPolicy` is `StartSequence`.
+     */
+    optStartSeq?: number;
+    /**
+     * Start time (ISO string). Only used when `deliverPolicy` is `StartTime`.
+     */
+    optStartTime?: string;
+    /**
+     * Replay policy for historical messages.
+     * @default ReplayPolicy.Instant
+     */
+    replayPolicy?: ReplayPolicy;
+}
 /**
  * Root module configuration for `JetstreamModule.forRoot()`.
  *
@@ -160,6 +191,15 @@ interface JetstreamModuleOptions {
     events?: StreamConsumerOverrides;
     /** Broadcast event stream/consumer overrides. */
     broadcast?: StreamConsumerOverrides;
+    /**
+     * Ordered event consumer configuration.
+     *
+     * Ordered events use a separate stream with Limits retention and deliver
+     * messages in strict sequential order. Use `ordered:` prefix when publishing.
+     *
+     * @see OrderedEventOverrides
+     */
+    ordered?: OrderedEventOverrides;
     /**
      * Transport lifecycle hook handlers.
      * Unset hooks are silently ignored — no default logging.
@@ -244,8 +284,9 @@ type JetstreamModuleAsyncOptions = {
  * - `'ev'` — Workqueue events (at-least-once delivery to one consumer).
  * - `'cmd'` — RPC commands (JetStream mode only).
  * - `'broadcast'` — Broadcast events (fan-out to all consumers).
+ * - `'ordered'` — Ordered events (strict sequential delivery, Limits retention).
  */
-type StreamKind = 'ev' | 'cmd' | 'broadcast';
+type StreamKind = 'ev' | 'cmd' | 'broadcast' | 'ordered';
 
 /** @internal Grouped pattern lists by stream kind, used for stream/consumer setup. */
 interface PatternsByKind {
@@ -255,6 +296,8 @@ interface PatternsByKind {
     commands: string[];
     /** Broadcast event patterns. */
     broadcasts: string[];
+    /** Ordered event patterns (strict sequential delivery). */
+    ordered: string[];
 }
 
 /**
@@ -367,6 +410,10 @@ declare class PatternRegistry {
     hasRpcHandlers(): boolean;
     /** Check if any workqueue event handlers are registered. */
     hasEventHandlers(): boolean;
+    /** Check if any ordered event handlers are registered. */
+    hasOrderedHandlers(): boolean;
+    /** Get fully-qualified NATS subjects for ordered handlers. */
+    getOrderedSubjects(): string[];
     /** Get patterns grouped by kind. */
     getPatternsByKind(): PatternsByKind;
     /** Normalize a full NATS subject back to the user-facing pattern. */
@@ -449,21 +496,14 @@ interface DeadLetterConfig {
     onDeadLetter(info: DeadLetterInfo): Promise<void>;
 }
 /**
- * Routes incoming event messages (workqueue and broadcast) to NestJS handlers.
+ * Routes incoming event messages (workqueue, broadcast, and ordered) to NestJS handlers.
  *
- * Delivery semantics (at-least-once):
- * - Handler executes first
- * - Success -> ack (message consumed)
- * - Handler error -> nak (NATS redelivers, up to `max_deliver` times)
- * - Dead letter (max_deliver reached) -> onDeadLetter hook -> term or nak
- * - Decode error -> term (no retry for malformed payloads)
- * - No handler found -> term (configuration error)
+ * **Workqueue & Broadcast** — at-least-once delivery:
+ * - Success -> ack | Error -> nak (retry) | Dead letter -> term
  *
- * Both workqueue and broadcast use the same ack/nak semantics.
- * Each durable consumer tracks delivery independently, so a nak from
- * one broadcast consumer does not affect others.
- *
- * Handlers must be idempotent — NATS may redeliver on failure or timeout.
+ * **Ordered** — strict sequential delivery:
+ * - No ack/nak/DLQ — nats.js auto-acknowledges ordered consumer messages.
+ * - Handler errors are logged but do not affect delivery.
  */
 declare class EventRouter {
     private readonly messageProvider;
@@ -479,7 +519,7 @@ declare class EventRouter {
      * Called after consumers are ensured so the DLQ map reflects reality.
      */
     updateMaxDeliverMap(consumerMaxDelivers: Map<string, number>): void;
-    /** Start routing event and broadcast messages to handlers. */
+    /** Start routing event, broadcast, and ordered messages to handlers. */
     start(): void;
     /** Stop routing and unsubscribe from all streams. */
     destroy(): void;
@@ -489,6 +529,8 @@ declare class EventRouter {
     private handle;
     /** Execute handler, then ack on success or nak/dead-letter on failure. */
     private executeHandler;
+    /** Handle an ordered message: decode -> execute handler -> no ack/nak. */
+    private handleOrdered;
     /** Check if the message has exhausted all delivery attempts. */
     private isDeadLetter;
     /** Handle a dead letter: invoke callback, then term or nak based on result. */
@@ -572,10 +614,13 @@ declare class MessageProvider {
     private readonly eventBus;
     private readonly logger;
     private readonly activeIterators;
+    private orderedReadyResolve;
+    private orderedReadyReject;
     private destroy$;
     private eventMessages$;
     private commandMessages$;
     private broadcastMessages$;
+    private orderedMessages$;
     constructor(connection: ConnectionProvider, eventBus: EventBus);
     /** Observable stream of workqueue event messages. */
     get events$(): Observable<JsMsg>;
@@ -583,6 +628,8 @@ declare class MessageProvider {
     get commands$(): Observable<JsMsg>;
     /** Observable stream of broadcast event messages. */
     get broadcasts$(): Observable<JsMsg>;
+    /** Observable stream of ordered event messages (strict sequential delivery). */
+    get ordered$(): Observable<JsMsg>;
     /**
      * Start consuming messages from the given consumer infos.
      *
@@ -590,6 +637,16 @@ declare class MessageProvider {
      * Call `destroy()` to stop all consumers.
      */
     start(consumers: Map<StreamKind, ConsumerInfo>): void;
+    /**
+     * Start an ordered consumer for strict sequential delivery.
+     *
+     * Unlike durable consumers, ordered consumers are ephemeral — created at
+     * consumption time, no durable state. nats.js handles auto-recreation.
+     *
+     * @param streamName - JetStream stream to consume from.
+     * @param filterSubjects - NATS subjects to filter on.
+     */
+    startOrdered(streamName: string, filterSubjects: string[], orderedConfig?: OrderedEventOverrides): Promise<void>;
     /** Stop all consumer flows and reinitialize subjects for potential restart. */
     destroy(): void;
     /** Create a self-healing consumer flow for a specific kind. */
@@ -598,6 +655,10 @@ declare class MessageProvider {
     private consumeOnce;
     /** Get the target subject for a consumer kind. */
     private getTargetSubject;
+    /** Create a self-healing ordered consumer flow. */
+    private createOrderedFlow;
+    /** Single iteration: create ordered consumer -> iterate messages. */
+    private consumeOrderedOnce;
 }
 
 /**
@@ -648,8 +709,10 @@ declare class JetstreamStrategy extends Server implements CustomTransportStrateg
     unwrap<T>(): T;
     /** Access the pattern registry (for module-level introspection). */
     getPatternRegistry(): PatternRegistry;
-    /** Determine which JetStream stream kinds are needed. */
+    /** Determine which JetStream streams are needed. */
     private resolveStreamKinds;
+    /** Determine which stream kinds need durable consumers (ordered consumers are ephemeral). */
+    private resolveDurableConsumerKinds;
     /** Build max_deliver map from actual NATS consumer configs (not options). */
     private buildMaxDeliverMap;
     private isCoreRpcMode;
@@ -831,7 +894,7 @@ declare class JetstreamClient extends ClientProxy {
     private setupInbox;
     /** Route an inbox reply to the matching pending callback. */
     private routeInboxReply;
-    /** Build event subject — workqueue or broadcast. */
+    /** Build event subject — workqueue, broadcast, or ordered. */
     private buildEventSubject;
     /** Build NATS headers merging custom headers with transport headers. */
     private buildHeaders;
@@ -865,13 +928,17 @@ declare class JetstreamRecord<TData = unknown> {
     readonly headers: ReadonlyMap<string, string>;
     /** Per-request RPC timeout override in ms. */
     readonly timeout?: number | undefined;
+    /** Custom message ID for JetStream deduplication. */
+    readonly messageId?: string | undefined;
     constructor(
     /** Message payload. */
     data: TData, 
     /** Custom headers set via {@link JetstreamRecordBuilder.setHeader}. */
     headers: ReadonlyMap<string, string>, 
     /** Per-request RPC timeout override in ms. */
-    timeout?: number | undefined);
+    timeout?: number | undefined, 
+    /** Custom message ID for JetStream deduplication. */
+    messageId?: string | undefined);
 }
 /**
  * Fluent builder for constructing JetstreamRecord instances.
@@ -883,6 +950,7 @@ declare class JetstreamRecordBuilder<TData = unknown> {
     private data;
     private readonly headers;
     private timeout;
+    private messageId;
     constructor(data?: TData);
     /**
      * Set the message payload.
@@ -905,6 +973,25 @@ declare class JetstreamRecordBuilder<TData = unknown> {
      * @throws Error if any header name is reserved by the transport.
      */
     setHeaders(headers: Record<string, string>): this;
+    /**
+     * Set a custom message ID for JetStream deduplication.
+     *
+     * NATS JetStream uses this ID to detect duplicate publishes within the
+     * stream's `duplicate_window`. If two messages with the same ID arrive
+     * within the window, the second is silently dropped.
+     *
+     * When not set, a random UUID is generated automatically.
+     *
+     * @param id - Unique message identifier (e.g. order ID, idempotency key).
+     *
+     * @example
+     * ```typescript
+     * new JetstreamRecordBuilder(data)
+     *   .setMessageId(`order-${order.id}`)
+     *   .build();
+     * ```
+     */
+    setMessageId(id: string): this;
     /**
      * Set per-request RPC timeout.
      *
@@ -1090,14 +1177,8 @@ declare enum JetstreamHeader {
     Subject = "x-subject",
     /** Internal name of the service that sent the message. */
     CallerName = "x-caller-name",
-    /** User-provided request ID (pass-through, not auto-generated). */
-    RequestId = "x-request-id",
-    /** User-provided trace ID for distributed tracing (pass-through). */
-    TraceId = "x-trace-id",
-    /** User-provided span ID for distributed tracing (pass-through). */
-    SpanId = "x-span-id",
     /** Set to `'true'` on error responses so the client can distinguish success from failure. */
     Error = "x-error"
 }
 
-export { type Codec, type DeadLetterInfo, EventBus, JETSTREAM_CODEC, JETSTREAM_CONNECTION, JETSTREAM_EVENT_BUS, JETSTREAM_OPTIONS, JetstreamClient, type JetstreamFeatureOptions, JetstreamHeader, JetstreamHealthIndicator, type JetstreamHealthStatus, JetstreamModule, type JetstreamModuleAsyncOptions, type JetstreamModuleOptions, JetstreamRecord, JetstreamRecordBuilder, JetstreamStrategy, JsonCodec, type RpcConfig, RpcContext, type StreamConsumerOverrides, TransportEvent, type TransportHooks, getClientToken, nanos };
+export { type Codec, type DeadLetterInfo, EventBus, JETSTREAM_CODEC, JETSTREAM_CONNECTION, JETSTREAM_EVENT_BUS, JETSTREAM_OPTIONS, JetstreamClient, type JetstreamFeatureOptions, JetstreamHeader, JetstreamHealthIndicator, type JetstreamHealthStatus, JetstreamModule, type JetstreamModuleAsyncOptions, type JetstreamModuleOptions, JetstreamRecord, JetstreamRecordBuilder, JetstreamStrategy, JsonCodec, type OrderedEventOverrides, type RpcConfig, RpcContext, type StreamConsumerOverrides, TransportEvent, type TransportHooks, getClientToken, nanos };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { ModuleMetadata, FactoryProvider, Type, Logger, OnApplicationShutdown, DynamicModule } from '@nestjs/common';
-import { MsgHdrs, StreamConfig, ConsumerConfig, ConnectionOptions, NatsConnection, Status, JetStreamManager, ConsumerInfo, JsMsg, Msg } from 'nats';
+import { MsgHdrs, StreamConfig, ConsumerConfig, DeliverPolicy, ReplayPolicy, ConnectionOptions, NatsConnection, Status, JetStreamManager, ConsumerInfo, JsMsg, Msg } from 'nats';
 import { MessageHandler, Server, CustomTransportStrategy, ClientProxy, ReadPacket, WritePacket, BaseRpcContext } from '@nestjs/microservices';
 import { Observable } from 'rxjs';
 
@@ -129,6 +129,37 @@ interface StreamConsumerOverrides {
     stream?: Partial<StreamConfig>;
     consumer?: Partial<ConsumerConfig>;
 }
+/**
+ * Configuration for ordered event consumers.
+ *
+ * Ordered consumers use Limits retention and deliver messages in strict
+ * sequential order with at-most-once delivery. No ack/nak/DLQ.
+ *
+ * Only a subset of consumer options applies — ordered consumers are
+ * ephemeral and auto-managed by nats.js.
+ */
+interface OrderedEventOverrides {
+    /** Stream overrides (e.g. `max_age`, `max_bytes`). */
+    stream?: Partial<StreamConfig>;
+    /**
+     * Where to start reading when the consumer is (re)created.
+     * @default DeliverPolicy.All
+     */
+    deliverPolicy?: DeliverPolicy;
+    /**
+     * Start sequence number. Only used when `deliverPolicy` is `StartSequence`.
+     */
+    optStartSeq?: number;
+    /**
+     * Start time (ISO string). Only used when `deliverPolicy` is `StartTime`.
+     */
+    optStartTime?: string;
+    /**
+     * Replay policy for historical messages.
+     * @default ReplayPolicy.Instant
+     */
+    replayPolicy?: ReplayPolicy;
+}
 /**
  * Root module configuration for `JetstreamModule.forRoot()`.
  *
@@ -160,6 +191,15 @@ interface JetstreamModuleOptions {
     events?: StreamConsumerOverrides;
     /** Broadcast event stream/consumer overrides. */
     broadcast?: StreamConsumerOverrides;
+    /**
+     * Ordered event consumer configuration.
+     *
+     * Ordered events use a separate stream with Limits retention and deliver
+     * messages in strict sequential order. Use `ordered:` prefix when publishing.
+     *
+     * @see OrderedEventOverrides
+     */
+    ordered?: OrderedEventOverrides;
     /**
      * Transport lifecycle hook handlers.
      * Unset hooks are silently ignored — no default logging.
@@ -244,8 +284,9 @@ type JetstreamModuleAsyncOptions = {
  * - `'ev'` — Workqueue events (at-least-once delivery to one consumer).
  * - `'cmd'` — RPC commands (JetStream mode only).
  * - `'broadcast'` — Broadcast events (fan-out to all consumers).
+ * - `'ordered'` — Ordered events (strict sequential delivery, Limits retention).
  */
-type StreamKind = 'ev' | 'cmd' | 'broadcast';
+type StreamKind = 'ev' | 'cmd' | 'broadcast' | 'ordered';
 
 /** @internal Grouped pattern lists by stream kind, used for stream/consumer setup. */
 interface PatternsByKind {
@@ -255,6 +296,8 @@ interface PatternsByKind {
     commands: string[];
     /** Broadcast event patterns. */
     broadcasts: string[];
+    /** Ordered event patterns (strict sequential delivery). */
+    ordered: string[];
 }
 
 /**
@@ -367,6 +410,10 @@ declare class PatternRegistry {
     hasRpcHandlers(): boolean;
     /** Check if any workqueue event handlers are registered. */
     hasEventHandlers(): boolean;
+    /** Check if any ordered event handlers are registered. */
+    hasOrderedHandlers(): boolean;
+    /** Get fully-qualified NATS subjects for ordered handlers. */
+    getOrderedSubjects(): string[];
     /** Get patterns grouped by kind. */
     getPatternsByKind(): PatternsByKind;
     /** Normalize a full NATS subject back to the user-facing pattern. */
@@ -449,21 +496,14 @@ interface DeadLetterConfig {
     onDeadLetter(info: DeadLetterInfo): Promise<void>;
 }
 /**
- * Routes incoming event messages (workqueue and broadcast) to NestJS handlers.
+ * Routes incoming event messages (workqueue, broadcast, and ordered) to NestJS handlers.
  *
- * Delivery semantics (at-least-once):
- * - Handler executes first
- * - Success -> ack (message consumed)
- * - Handler error -> nak (NATS redelivers, up to `max_deliver` times)
- * - Dead letter (max_deliver reached) -> onDeadLetter hook -> term or nak
- * - Decode error -> term (no retry for malformed payloads)
- * - No handler found -> term (configuration error)
+ * **Workqueue & Broadcast** — at-least-once delivery:
+ * - Success -> ack | Error -> nak (retry) | Dead letter -> term
  *
- * Both workqueue and broadcast use the same ack/nak semantics.
- * Each durable consumer tracks delivery independently, so a nak from
- * one broadcast consumer does not affect others.
- *
- * Handlers must be idempotent — NATS may redeliver on failure or timeout.
+ * **Ordered** — strict sequential delivery:
+ * - No ack/nak/DLQ — nats.js auto-acknowledges ordered consumer messages.
+ * - Handler errors are logged but do not affect delivery.
  */
 declare class EventRouter {
     private readonly messageProvider;
@@ -479,7 +519,7 @@ declare class EventRouter {
      * Called after consumers are ensured so the DLQ map reflects reality.
      */
     updateMaxDeliverMap(consumerMaxDelivers: Map<string, number>): void;
-    /** Start routing event and broadcast messages to handlers. */
+    /** Start routing event, broadcast, and ordered messages to handlers. */
     start(): void;
     /** Stop routing and unsubscribe from all streams. */
     destroy(): void;
@@ -489,6 +529,8 @@ declare class EventRouter {
     private handle;
     /** Execute handler, then ack on success or nak/dead-letter on failure. */
     private executeHandler;
+    /** Handle an ordered message: decode -> execute handler -> no ack/nak. */
+    private handleOrdered;
     /** Check if the message has exhausted all delivery attempts. */
     private isDeadLetter;
     /** Handle a dead letter: invoke callback, then term or nak based on result. */
@@ -572,10 +614,13 @@ declare class MessageProvider {
     private readonly eventBus;
     private readonly logger;
     private readonly activeIterators;
+    private orderedReadyResolve;
+    private orderedReadyReject;
     private destroy$;
     private eventMessages$;
     private commandMessages$;
     private broadcastMessages$;
+    private orderedMessages$;
     constructor(connection: ConnectionProvider, eventBus: EventBus);
     /** Observable stream of workqueue event messages. */
     get events$(): Observable<JsMsg>;
@@ -583,6 +628,8 @@ declare class MessageProvider {
     get commands$(): Observable<JsMsg>;
     /** Observable stream of broadcast event messages. */
     get broadcasts$(): Observable<JsMsg>;
+    /** Observable stream of ordered event messages (strict sequential delivery). */
+    get ordered$(): Observable<JsMsg>;
     /**
      * Start consuming messages from the given consumer infos.
      *
@@ -590,6 +637,16 @@ declare class MessageProvider {
      * Call `destroy()` to stop all consumers.
      */
     start(consumers: Map<StreamKind, ConsumerInfo>): void;
+    /**
+     * Start an ordered consumer for strict sequential delivery.
+     *
+     * Unlike durable consumers, ordered consumers are ephemeral — created at
+     * consumption time, no durable state. nats.js handles auto-recreation.
+     *
+     * @param streamName - JetStream stream to consume from.
+     * @param filterSubjects - NATS subjects to filter on.
+     */
+    startOrdered(streamName: string, filterSubjects: string[], orderedConfig?: OrderedEventOverrides): Promise<void>;
     /** Stop all consumer flows and reinitialize subjects for potential restart. */
     destroy(): void;
     /** Create a self-healing consumer flow for a specific kind. */
@@ -598,6 +655,10 @@ declare class MessageProvider {
     private consumeOnce;
     /** Get the target subject for a consumer kind. */
     private getTargetSubject;
+    /** Create a self-healing ordered consumer flow. */
+    private createOrderedFlow;
+    /** Single iteration: create ordered consumer -> iterate messages. */
+    private consumeOrderedOnce;
 }
 
 /**
@@ -648,8 +709,10 @@ declare class JetstreamStrategy extends Server implements CustomTransportStrateg
     unwrap<T>(): T;
     /** Access the pattern registry (for module-level introspection). */
     getPatternRegistry(): PatternRegistry;
-    /** Determine which JetStream stream kinds are needed. */
+    /** Determine which JetStream streams are needed. */
     private resolveStreamKinds;
+    /** Determine which stream kinds need durable consumers (ordered consumers are ephemeral). */
+    private resolveDurableConsumerKinds;
     /** Build max_deliver map from actual NATS consumer configs (not options). */
     private buildMaxDeliverMap;
     private isCoreRpcMode;
@@ -831,7 +894,7 @@ declare class JetstreamClient extends ClientProxy {
     private setupInbox;
     /** Route an inbox reply to the matching pending callback. */
     private routeInboxReply;
-    /** Build event subject — workqueue or broadcast. */
+    /** Build event subject — workqueue, broadcast, or ordered. */
     private buildEventSubject;
     /** Build NATS headers merging custom headers with transport headers. */
     private buildHeaders;
@@ -865,13 +928,17 @@ declare class JetstreamRecord<TData = unknown> {
     readonly headers: ReadonlyMap<string, string>;
     /** Per-request RPC timeout override in ms. */
     readonly timeout?: number | undefined;
+    /** Custom message ID for JetStream deduplication. */
+    readonly messageId?: string | undefined;
     constructor(
     /** Message payload. */
     data: TData, 
     /** Custom headers set via {@link JetstreamRecordBuilder.setHeader}. */
     headers: ReadonlyMap<string, string>, 
     /** Per-request RPC timeout override in ms. */
-    timeout?: number | undefined);
+    timeout?: number | undefined, 
+    /** Custom message ID for JetStream deduplication. */
+    messageId?: string | undefined);
 }
 /**
  * Fluent builder for constructing JetstreamRecord instances.
@@ -883,6 +950,7 @@ declare class JetstreamRecordBuilder<TData = unknown> {
     private data;
     private readonly headers;
     private timeout;
+    private messageId;
     constructor(data?: TData);
     /**
      * Set the message payload.
@@ -905,6 +973,25 @@ declare class JetstreamRecordBuilder<TData = unknown> {
      * @throws Error if any header name is reserved by the transport.
      */
     setHeaders(headers: Record<string, string>): this;
+    /**
+     * Set a custom message ID for JetStream deduplication.
+     *
+     * NATS JetStream uses this ID to detect duplicate publishes within the
+     * stream's `duplicate_window`. If two messages with the same ID arrive
+     * within the window, the second is silently dropped.
+     *
+     * When not set, a random UUID is generated automatically.
+     *
+     * @param id - Unique message identifier (e.g. order ID, idempotency key).
+     *
+     * @example
+     * ```typescript
+     * new JetstreamRecordBuilder(data)
+     *   .setMessageId(`order-${order.id}`)
+     *   .build();
+     * ```
+     */
+    setMessageId(id: string): this;
     /**
      * Set per-request RPC timeout.
      *
@@ -1090,14 +1177,8 @@ declare enum JetstreamHeader {
     Subject = "x-subject",
     /** Internal name of the service that sent the message. */
     CallerName = "x-caller-name",
-    /** User-provided request ID (pass-through, not auto-generated). */
-    RequestId = "x-request-id",
-    /** User-provided trace ID for distributed tracing (pass-through). */
-    TraceId = "x-trace-id",
-    /** User-provided span ID for distributed tracing (pass-through). */
-    SpanId = "x-span-id",
     /** Set to `'true'` on error responses so the client can distinguish success from failure. */
     Error = "x-error"
 }
 
-export { type Codec, type DeadLetterInfo, EventBus, JETSTREAM_CODEC, JETSTREAM_CONNECTION, JETSTREAM_EVENT_BUS, JETSTREAM_OPTIONS, JetstreamClient, type JetstreamFeatureOptions, JetstreamHeader, JetstreamHealthIndicator, type JetstreamHealthStatus, JetstreamModule, type JetstreamModuleAsyncOptions, type JetstreamModuleOptions, JetstreamRecord, JetstreamRecordBuilder, JetstreamStrategy, JsonCodec, type RpcConfig, RpcContext, type StreamConsumerOverrides, TransportEvent, type TransportHooks, getClientToken, nanos };
+export { type Codec, type DeadLetterInfo, EventBus, JETSTREAM_CODEC, JETSTREAM_CONNECTION, JETSTREAM_EVENT_BUS, JETSTREAM_OPTIONS, JetstreamClient, type JetstreamFeatureOptions, JetstreamHeader, JetstreamHealthIndicator, type JetstreamHealthStatus, JetstreamModule, type JetstreamModuleAsyncOptions, type JetstreamModuleOptions, JetstreamRecord, JetstreamRecordBuilder, JetstreamStrategy, JsonCodec, type OrderedEventOverrides, type RpcConfig, RpcContext, type StreamConsumerOverrides, TransportEvent, type TransportHooks, getClientToken, nanos };