@horizon-republic/nestjs-jetstream 2.11.0 → 2.12.0

package/dist/index.d.cts

@@ -553,9 +553,13 @@ declare class JetstreamClient extends ClientProxy {
      * uses a separate `_sch` namespace that is NOT matched by any consumer filter.
      * NATS holds the message and publishes it to the target subject after the delay.
      *
+     * A unique per-message suffix is appended because the server stores schedules
+     * as rollup messages — one active schedule per subject (ADR-51). Without it,
+     * concurrent schedules of the same pattern would silently replace each other.
+     *
      * Examples:
-     * - `{svc}__microservice.ev.order.reminder` → `{svc}__microservice._sch.order.reminder`
-     * - `broadcast.config.updated` → `broadcast._sch.config.updated`
+     * - `{svc}__microservice.ev.order.reminder` → `{svc}__microservice._sch.order.reminder.<nuid>`
+     * - `broadcast.config.updated` → `broadcast._sch.config.updated.<nuid>`
      */
     private buildScheduleSubject;
 }
@@ -935,6 +939,8 @@ interface OtelOptions {
     errorClassifier?(err: unknown): ErrorClassification;
 }
 
+type ProvisioningEntity = 'stream' | 'consumer';
+
 /**
  * Stream config overrides exposed to users.
  *
@@ -1073,6 +1079,14 @@ interface MetadataRegistryOptions {
      */
     ttl?: number;
 }
+/** Provisioning behavior. Stream reservations are always logged at boot (INFO). */
+interface ProvisioningOptions {
+    /**
+     * Opt-in storage budget check via `getAccountInfo()` before provisioning.
+     * Warn-only; never blocks boot. Off by default.
+     */
+    preflightStorageCheck?: boolean;
+}
 /**
  * Root module configuration for `JetstreamModule.forRoot()`.
  *
@@ -1234,9 +1248,14 @@ interface JetstreamModuleOptions {
      * consuming application, all tracer calls are no-ops — there is no
      * runtime cost.
      *
+     * Accepts a full {@link OtelOptions} object, or the boolean shorthand
+     * `true` (== defaults) / `false` (== `{ enabled: false }`).
+     *
      * @see OtelOptions
      */
-    otel?: OtelOptions;
+    otel?: OtelOptions | boolean;
+    /** Provisioning behavior. */
+    provisioning?: ProvisioningOptions;
 }
 /** Options for `JetstreamModule.forFeature()`. */
 interface JetstreamFeatureOptions {
@@ -1258,15 +1277,6 @@ type JetstreamModuleAsyncOptions = {
     name: string;
     /** Additional module imports (e.g., ConfigModule). */
     imports?: ModuleMetadata['imports'];
-    /**
-     * Built-in Prometheus metrics. Specified at the async-options level (parallel
-     * to {@link name}) because module composition is decided synchronously before
-     * the async factory runs. Use `true` for defaults, a {@link MetricsConfig}
-     * object for full control, or omit/`false` to disable entirely.
-     *
-     * @see JetstreamModuleOptions.metrics
-     */
-    metrics?: MetricsOption;
 } & ({
     useFactory(...args: unknown[]): Promise<Omit<JetstreamModuleOptions, 'name'>> | Omit<JetstreamModuleOptions, 'name'>;
     inject?: FactoryProvider['inject'];
@@ -1319,8 +1329,11 @@ interface DeadLetterConfig {
      * Used to detect when a message from a given stream has exhausted all delivery attempts.
      */
     maxDeliverByStream: Map<string, number>;
-    /** Async callback invoked when a message exhausts all deliveries. */
-    onDeadLetter(info: DeadLetterInfo): Promise<void>;
+    /**
+     * Async callback invoked when a message exhausts all deliveries.
+     * Optional: in dlq-only mode dead letters go to the DLQ stream without a callback.
+     */
+    onDeadLetter?(info: DeadLetterInfo): Promise<void>;
 }
 /** Options for configuring RPC processing behavior. */
 interface RpcRouterOptions {
@@ -1461,6 +1474,11 @@ declare class StreamProvider {
     private handleExistingStream;
     private buildMutableOnlyConfig;
     private logChanges;
+    private buildReservation;
+    private errorContext;
+    private runStreamOp;
+    /** The broadcast stream is global — every service in the cluster shares it. */
+    private isSharedStream;
     /** Build the full stream config by merging defaults with user overrides. */
     private buildConfig;
     /**
@@ -1515,11 +1533,28 @@ declare class EventRouter {
     private getAckExtensionConfig;
     /**
      * Last-resort path for a dead letter: invoke `onDeadLetter`, then `term` on
-     * success or `nak` on hook failure so NATS retries on the next delivery
-     * cycle. Used when DLQ stream isn't configured, or when publishing to it
-     * failed and we still have to surface the message somewhere observable.
+     * success. On failure the message is nak'd to release it, but the server
+     * never redelivers past `max_deliver` — it stays in the stream for manual
+     * recovery. Used when the DLQ stream isn't configured, or when publishing
+     * to it failed and we still have to surface the message somewhere.
      */
     private fallbackToOnDeadLetterCallback;
+    /**
+     * Copy the original message headers for the DLQ republish, dropping NATS
+     * server control headers: a copied Nats-TTL expires the DLQ entry (or gets
+     * the publish rejected when the DLQ stream has no allow_msg_ttl), a copied
+     * Nats-Msg-Id collides with the DLQ dedup window.
+     */
+    private buildDlqHeaders;
+    /**
+     * Attempt the DLQ publish up to {@link DLQ_PUBLISH_ATTEMPTS} times.
+     *
+     * Past `max_deliver` the server never redelivers, so an in-process retry is
+     * the only second chance a dead letter gets. There is no artificial delay
+     * between attempts: when the broker is unreachable each publish already
+     * spends its own request timeout, which spaces the attempts naturally.
+     */
+    private publishToDlqWithRetry;
     /**
      * Publish a dead letter to the configured Dead-Letter Queue (DLQ) stream.
      *
@@ -1630,6 +1665,7 @@ declare class ConsumerProvider {
      * Create a consumer, handling the race where another pod creates it first.
      */
     private createConsumer;
+    private runConsumerOp;
     /** Build consumer config by merging defaults with user overrides. */
     private buildConfig;
     /** Get default config for a consumer kind. */
@@ -1771,7 +1807,7 @@ declare class MetadataProvider {
  * NATS JetStream API error codes used by the transport.
  *
  * Ref: https://github.com/nats-io/nats-server (server error definitions)
- * Verified on NATS 2.12.6 via integration tests (2026-04-02).
+ * Codes verified across NATS 2.12.6–2.14.1 via integration tests (original codes: 2026-04-02).
  */
 declare enum NatsErrorCode {
     /** Consumer does not exist on the specified stream. */
@@ -1779,7 +1815,14 @@ declare enum NatsErrorCode {
     /** Consumer name already in use with different configuration (race condition on create). */
     ConsumerAlreadyExists = 10148,
     /** Stream does not exist. */
-    StreamNotFound = 10059
+    StreamNotFound = 10059,
+    /** Storage resources exceeded — reservation exceeds server `max_file_store`. */
+    StorageResourcesExceeded = 10047,
+    /**
+     * No suitable peers for placement (fewer healthy peers than `num_replicas`,
+     * or no peer has storage headroom). Confirmed at runtime by the cluster integration test.
+     */
+    NoSuitablePeers = 10005
 }
 
 /**
@@ -1814,7 +1857,7 @@ declare class JetstreamStrategy extends Server implements CustomTransportStrateg
      *
      * Called by NestJS when `connectMicroservice()` is used, or internally by the module.
      */
-    listen(callback: () => void): Promise<void>;
+    listen(callback: (...args: unknown[]) => void): Promise<void>;
     /** Stop all consumers, routers, subscriptions, and metadata heartbeat. Called during shutdown. */
     close(): void;
     /**
@@ -1844,9 +1887,13 @@ declare class JetstreamStrategy extends Server implements CustomTransportStrateg
     unwrap<T>(): T;
     /** Access the pattern registry (for module-level introspection). */
     getPatternRegistry(): PatternRegistry;
+    private doListen;
     /** Determine which streams and durable consumers are needed. */
     private resolveRequiredKinds;
-    /** Populate the shared ack_wait map from actual NATS consumer configs. */
+    /** Subscribe the event and RPC routers to the message subjects. */
+    private startRouters;
+    /** Begin durable and ordered consumption; routers must already be subscribed. */
+    private startConsumption;
     private populateAckWaitMap;
     /** Build max_deliver map from actual NATS consumer configs (not options). */
     private buildMaxDeliverMap;
@@ -2353,4 +2400,30 @@ declare const isJetStreamRpcMode: (rpc: RpcConfig | undefined) => boolean;
 /** Check if the RPC config specifies Core mode (default). */
 declare const isCoreRpcMode: (rpc: RpcConfig | undefined) => boolean;
 
-export { type CaptureBodyOptions, type Codec, ConsumeKind, type ConsumeSourceMsg, DEFAULT_BROADCAST_CONSUMER_CONFIG, DEFAULT_BROADCAST_STREAM_CONFIG, DEFAULT_COMMAND_CONSUMER_CONFIG, DEFAULT_COMMAND_STREAM_CONFIG, DEFAULT_DLQ_STREAM_CONFIG, DEFAULT_EVENT_CONSUMER_CONFIG, DEFAULT_EVENT_STREAM_CONFIG, DEFAULT_JETSTREAM_RPC_TIMEOUT, DEFAULT_METADATA_BUCKET, DEFAULT_METADATA_HISTORY, DEFAULT_METADATA_REPLICAS, DEFAULT_METADATA_TTL, DEFAULT_ORDERED_STREAM_CONFIG, DEFAULT_RPC_TIMEOUT, DEFAULT_SHUTDOWN_TIMEOUT, DEFAULT_TRACES, type DeadLetterInfo, type ErrorClassification, type HandlerMetadata, JETSTREAM_CODEC, JETSTREAM_CONNECTION, JETSTREAM_OPTIONS, JetstreamClient, type JetstreamConsumeContext, JetstreamDlqHeader, type JetstreamFeatureOptions, JetstreamHeader, JetstreamHealthIndicator, type JetstreamHealthStatus, JetstreamModule, type JetstreamModuleAsyncOptions, type JetstreamModuleOptions, type JetstreamPublishContext, JetstreamRecord, JetstreamRecordBuilder, type JetstreamResponseContext, JetstreamStrategy, JetstreamTrace, JsonCodec, MIN_METADATA_TTL, MessageKind, type MetadataRegistryOptions, MsgpackCodec, NatsErrorCode, type OrderedEventOverrides, type OtelOptions, PatternPrefix, PublishKind, RESERVED_HEADERS, type RpcConfig, RpcContext, type ScheduleRecordOptions, type ServerEndpoint, type StreamConfigOverrides, type StreamConsumerOverrides, StreamKind, TRACER_NAME, TransportEvent, type TransportHooks, buildBroadcastSubject, buildSubject, consumerName, dlqStreamName, getClientToken, internalName, isCoreRpcMode, isJetStreamRpcMode, metadataKey, streamName, toNanos };
+interface ProvisioningErrorFields {
+    readonly entity: ProvisioningEntity;
+    readonly target: string;
+    readonly kind: string;
+    readonly errCode: number;
+    readonly errDescription: string;
+    readonly remediation: string;
+    readonly maxBytes?: number;
+    readonly numReplicas?: number;
+    readonly reservation?: number;
+    readonly cause: unknown;
+}
+/** Non-recoverable stream/consumer provisioning failure; preserves the NATS error as `cause`. */
+declare class JetstreamProvisioningError extends Error {
+    readonly entity: ProvisioningEntity;
+    readonly target: string;
+    readonly kind: string;
+    readonly errCode: number;
+    readonly errDescription: string;
+    readonly remediation: string;
+    readonly maxBytes?: number;
+    readonly numReplicas?: number;
+    readonly reservation?: number;
+    constructor(fields: ProvisioningErrorFields);
+}
+
+export { type CaptureBodyOptions, type Codec, ConsumeKind, type ConsumeSourceMsg, DEFAULT_BROADCAST_CONSUMER_CONFIG, DEFAULT_BROADCAST_STREAM_CONFIG, DEFAULT_COMMAND_CONSUMER_CONFIG, DEFAULT_COMMAND_STREAM_CONFIG, DEFAULT_DLQ_STREAM_CONFIG, DEFAULT_EVENT_CONSUMER_CONFIG, DEFAULT_EVENT_STREAM_CONFIG, DEFAULT_JETSTREAM_RPC_TIMEOUT, DEFAULT_METADATA_BUCKET, DEFAULT_METADATA_HISTORY, DEFAULT_METADATA_REPLICAS, DEFAULT_METADATA_TTL, DEFAULT_ORDERED_STREAM_CONFIG, DEFAULT_RPC_TIMEOUT, DEFAULT_SHUTDOWN_TIMEOUT, DEFAULT_TRACES, type DeadLetterInfo, type ErrorClassification, type HandlerMetadata, JETSTREAM_CODEC, JETSTREAM_CONNECTION, JETSTREAM_OPTIONS, JetstreamClient, type JetstreamConsumeContext, JetstreamDlqHeader, type JetstreamFeatureOptions, JetstreamHeader, JetstreamHealthIndicator, type JetstreamHealthStatus, JetstreamModule, type JetstreamModuleAsyncOptions, type JetstreamModuleOptions, JetstreamProvisioningError, type JetstreamPublishContext, JetstreamRecord, JetstreamRecordBuilder, type JetstreamResponseContext, JetstreamStrategy, JetstreamTrace, JsonCodec, MIN_METADATA_TTL, MessageKind, type MetadataRegistryOptions, MsgpackCodec, NatsErrorCode, type OrderedEventOverrides, type OtelOptions, PatternPrefix, type ProvisioningOptions, PublishKind, RESERVED_HEADERS, type RpcConfig, RpcContext, type ScheduleRecordOptions, type ServerEndpoint, type StreamConfigOverrides, type StreamConsumerOverrides, StreamKind, TRACER_NAME, TransportEvent, type TransportHooks, buildBroadcastSubject, buildSubject, consumerName, dlqStreamName, getClientToken, internalName, isCoreRpcMode, isJetStreamRpcMode, metadataKey, streamName, toNanos };

package/dist/index.d.ts

@@ -553,9 +553,13 @@ declare class JetstreamClient extends ClientProxy {
      * uses a separate `_sch` namespace that is NOT matched by any consumer filter.
      * NATS holds the message and publishes it to the target subject after the delay.
      *
+     * A unique per-message suffix is appended because the server stores schedules
+     * as rollup messages — one active schedule per subject (ADR-51). Without it,
+     * concurrent schedules of the same pattern would silently replace each other.
+     *
      * Examples:
-     * - `{svc}__microservice.ev.order.reminder` → `{svc}__microservice._sch.order.reminder`
-     * - `broadcast.config.updated` → `broadcast._sch.config.updated`
+     * - `{svc}__microservice.ev.order.reminder` → `{svc}__microservice._sch.order.reminder.<nuid>`
+     * - `broadcast.config.updated` → `broadcast._sch.config.updated.<nuid>`
      */
     private buildScheduleSubject;
 }
@@ -935,6 +939,8 @@ interface OtelOptions {
     errorClassifier?(err: unknown): ErrorClassification;
 }
 
+type ProvisioningEntity = 'stream' | 'consumer';
+
 /**
  * Stream config overrides exposed to users.
  *
@@ -1073,6 +1079,14 @@ interface MetadataRegistryOptions {
      */
     ttl?: number;
 }
+/** Provisioning behavior. Stream reservations are always logged at boot (INFO). */
+interface ProvisioningOptions {
+    /**
+     * Opt-in storage budget check via `getAccountInfo()` before provisioning.
+     * Warn-only; never blocks boot. Off by default.
+     */
+    preflightStorageCheck?: boolean;
+}
 /**
  * Root module configuration for `JetstreamModule.forRoot()`.
  *
@@ -1234,9 +1248,14 @@ interface JetstreamModuleOptions {
      * consuming application, all tracer calls are no-ops — there is no
      * runtime cost.
      *
+     * Accepts a full {@link OtelOptions} object, or the boolean shorthand
+     * `true` (== defaults) / `false` (== `{ enabled: false }`).
+     *
      * @see OtelOptions
      */
-    otel?: OtelOptions;
+    otel?: OtelOptions | boolean;
+    /** Provisioning behavior. */
+    provisioning?: ProvisioningOptions;
 }
 /** Options for `JetstreamModule.forFeature()`. */
 interface JetstreamFeatureOptions {
@@ -1258,15 +1277,6 @@ type JetstreamModuleAsyncOptions = {
     name: string;
     /** Additional module imports (e.g., ConfigModule). */
     imports?: ModuleMetadata['imports'];
-    /**
-     * Built-in Prometheus metrics. Specified at the async-options level (parallel
-     * to {@link name}) because module composition is decided synchronously before
-     * the async factory runs. Use `true` for defaults, a {@link MetricsConfig}
-     * object for full control, or omit/`false` to disable entirely.
-     *
-     * @see JetstreamModuleOptions.metrics
-     */
-    metrics?: MetricsOption;
 } & ({
     useFactory(...args: unknown[]): Promise<Omit<JetstreamModuleOptions, 'name'>> | Omit<JetstreamModuleOptions, 'name'>;
     inject?: FactoryProvider['inject'];
@@ -1319,8 +1329,11 @@ interface DeadLetterConfig {
      * Used to detect when a message from a given stream has exhausted all delivery attempts.
      */
     maxDeliverByStream: Map<string, number>;
-    /** Async callback invoked when a message exhausts all deliveries. */
-    onDeadLetter(info: DeadLetterInfo): Promise<void>;
+    /**
+     * Async callback invoked when a message exhausts all deliveries.
+     * Optional: in dlq-only mode dead letters go to the DLQ stream without a callback.
+     */
+    onDeadLetter?(info: DeadLetterInfo): Promise<void>;
 }
 /** Options for configuring RPC processing behavior. */
 interface RpcRouterOptions {
@@ -1461,6 +1474,11 @@ declare class StreamProvider {
     private handleExistingStream;
     private buildMutableOnlyConfig;
     private logChanges;
+    private buildReservation;
+    private errorContext;
+    private runStreamOp;
+    /** The broadcast stream is global — every service in the cluster shares it. */
+    private isSharedStream;
     /** Build the full stream config by merging defaults with user overrides. */
     private buildConfig;
     /**
@@ -1515,11 +1533,28 @@ declare class EventRouter {
     private getAckExtensionConfig;
     /**
      * Last-resort path for a dead letter: invoke `onDeadLetter`, then `term` on
-     * success or `nak` on hook failure so NATS retries on the next delivery
-     * cycle. Used when DLQ stream isn't configured, or when publishing to it
-     * failed and we still have to surface the message somewhere observable.
+     * success. On failure the message is nak'd to release it, but the server
+     * never redelivers past `max_deliver` — it stays in the stream for manual
+     * recovery. Used when the DLQ stream isn't configured, or when publishing
+     * to it failed and we still have to surface the message somewhere.
      */
     private fallbackToOnDeadLetterCallback;
+    /**
+     * Copy the original message headers for the DLQ republish, dropping NATS
+     * server control headers: a copied Nats-TTL expires the DLQ entry (or gets
+     * the publish rejected when the DLQ stream has no allow_msg_ttl), a copied
+     * Nats-Msg-Id collides with the DLQ dedup window.
+     */
+    private buildDlqHeaders;
+    /**
+     * Attempt the DLQ publish up to {@link DLQ_PUBLISH_ATTEMPTS} times.
+     *
+     * Past `max_deliver` the server never redelivers, so an in-process retry is
+     * the only second chance a dead letter gets. There is no artificial delay
+     * between attempts: when the broker is unreachable each publish already
+     * spends its own request timeout, which spaces the attempts naturally.
+     */
+    private publishToDlqWithRetry;
     /**
      * Publish a dead letter to the configured Dead-Letter Queue (DLQ) stream.
      *
@@ -1630,6 +1665,7 @@ declare class ConsumerProvider {
      * Create a consumer, handling the race where another pod creates it first.
      */
     private createConsumer;
+    private runConsumerOp;
     /** Build consumer config by merging defaults with user overrides. */
     private buildConfig;
     /** Get default config for a consumer kind. */
@@ -1771,7 +1807,7 @@ declare class MetadataProvider {
  * NATS JetStream API error codes used by the transport.
  *
  * Ref: https://github.com/nats-io/nats-server (server error definitions)
- * Verified on NATS 2.12.6 via integration tests (2026-04-02).
+ * Codes verified across NATS 2.12.6–2.14.1 via integration tests (original codes: 2026-04-02).
  */
 declare enum NatsErrorCode {
     /** Consumer does not exist on the specified stream. */
@@ -1779,7 +1815,14 @@ declare enum NatsErrorCode {
     /** Consumer name already in use with different configuration (race condition on create). */
     ConsumerAlreadyExists = 10148,
     /** Stream does not exist. */
-    StreamNotFound = 10059
+    StreamNotFound = 10059,
+    /** Storage resources exceeded — reservation exceeds server `max_file_store`. */
+    StorageResourcesExceeded = 10047,
+    /**
+     * No suitable peers for placement (fewer healthy peers than `num_replicas`,
+     * or no peer has storage headroom). Confirmed at runtime by the cluster integration test.
+     */
+    NoSuitablePeers = 10005
 }
 
 /**
@@ -1814,7 +1857,7 @@ declare class JetstreamStrategy extends Server implements CustomTransportStrateg
      *
      * Called by NestJS when `connectMicroservice()` is used, or internally by the module.
      */
-    listen(callback: () => void): Promise<void>;
+    listen(callback: (...args: unknown[]) => void): Promise<void>;
     /** Stop all consumers, routers, subscriptions, and metadata heartbeat. Called during shutdown. */
     close(): void;
     /**
@@ -1844,9 +1887,13 @@ declare class JetstreamStrategy extends Server implements CustomTransportStrateg
     unwrap<T>(): T;
     /** Access the pattern registry (for module-level introspection). */
     getPatternRegistry(): PatternRegistry;
+    private doListen;
     /** Determine which streams and durable consumers are needed. */
     private resolveRequiredKinds;
-    /** Populate the shared ack_wait map from actual NATS consumer configs. */
+    /** Subscribe the event and RPC routers to the message subjects. */
+    private startRouters;
+    /** Begin durable and ordered consumption; routers must already be subscribed. */
+    private startConsumption;
     private populateAckWaitMap;
     /** Build max_deliver map from actual NATS consumer configs (not options). */
     private buildMaxDeliverMap;
@@ -2353,4 +2400,30 @@ declare const isJetStreamRpcMode: (rpc: RpcConfig | undefined) => boolean;
 /** Check if the RPC config specifies Core mode (default). */
 declare const isCoreRpcMode: (rpc: RpcConfig | undefined) => boolean;
 
-export { type CaptureBodyOptions, type Codec, ConsumeKind, type ConsumeSourceMsg, DEFAULT_BROADCAST_CONSUMER_CONFIG, DEFAULT_BROADCAST_STREAM_CONFIG, DEFAULT_COMMAND_CONSUMER_CONFIG, DEFAULT_COMMAND_STREAM_CONFIG, DEFAULT_DLQ_STREAM_CONFIG, DEFAULT_EVENT_CONSUMER_CONFIG, DEFAULT_EVENT_STREAM_CONFIG, DEFAULT_JETSTREAM_RPC_TIMEOUT, DEFAULT_METADATA_BUCKET, DEFAULT_METADATA_HISTORY, DEFAULT_METADATA_REPLICAS, DEFAULT_METADATA_TTL, DEFAULT_ORDERED_STREAM_CONFIG, DEFAULT_RPC_TIMEOUT, DEFAULT_SHUTDOWN_TIMEOUT, DEFAULT_TRACES, type DeadLetterInfo, type ErrorClassification, type HandlerMetadata, JETSTREAM_CODEC, JETSTREAM_CONNECTION, JETSTREAM_OPTIONS, JetstreamClient, type JetstreamConsumeContext, JetstreamDlqHeader, type JetstreamFeatureOptions, JetstreamHeader, JetstreamHealthIndicator, type JetstreamHealthStatus, JetstreamModule, type JetstreamModuleAsyncOptions, type JetstreamModuleOptions, type JetstreamPublishContext, JetstreamRecord, JetstreamRecordBuilder, type JetstreamResponseContext, JetstreamStrategy, JetstreamTrace, JsonCodec, MIN_METADATA_TTL, MessageKind, type MetadataRegistryOptions, MsgpackCodec, NatsErrorCode, type OrderedEventOverrides, type OtelOptions, PatternPrefix, PublishKind, RESERVED_HEADERS, type RpcConfig, RpcContext, type ScheduleRecordOptions, type ServerEndpoint, type StreamConfigOverrides, type StreamConsumerOverrides, StreamKind, TRACER_NAME, TransportEvent, type TransportHooks, buildBroadcastSubject, buildSubject, consumerName, dlqStreamName, getClientToken, internalName, isCoreRpcMode, isJetStreamRpcMode, metadataKey, streamName, toNanos };
+interface ProvisioningErrorFields {
+    readonly entity: ProvisioningEntity;
+    readonly target: string;
+    readonly kind: string;
+    readonly errCode: number;
+    readonly errDescription: string;
+    readonly remediation: string;
+    readonly maxBytes?: number;
+    readonly numReplicas?: number;
+    readonly reservation?: number;
+    readonly cause: unknown;
+}
+/** Non-recoverable stream/consumer provisioning failure; preserves the NATS error as `cause`. */
+declare class JetstreamProvisioningError extends Error {
+    readonly entity: ProvisioningEntity;
+    readonly target: string;
+    readonly kind: string;
+    readonly errCode: number;
+    readonly errDescription: string;
+    readonly remediation: string;
+    readonly maxBytes?: number;
+    readonly numReplicas?: number;
+    readonly reservation?: number;
+    constructor(fields: ProvisioningErrorFields);
+}
+
+export { type CaptureBodyOptions, type Codec, ConsumeKind, type ConsumeSourceMsg, DEFAULT_BROADCAST_CONSUMER_CONFIG, DEFAULT_BROADCAST_STREAM_CONFIG, DEFAULT_COMMAND_CONSUMER_CONFIG, DEFAULT_COMMAND_STREAM_CONFIG, DEFAULT_DLQ_STREAM_CONFIG, DEFAULT_EVENT_CONSUMER_CONFIG, DEFAULT_EVENT_STREAM_CONFIG, DEFAULT_JETSTREAM_RPC_TIMEOUT, DEFAULT_METADATA_BUCKET, DEFAULT_METADATA_HISTORY, DEFAULT_METADATA_REPLICAS, DEFAULT_METADATA_TTL, DEFAULT_ORDERED_STREAM_CONFIG, DEFAULT_RPC_TIMEOUT, DEFAULT_SHUTDOWN_TIMEOUT, DEFAULT_TRACES, type DeadLetterInfo, type ErrorClassification, type HandlerMetadata, JETSTREAM_CODEC, JETSTREAM_CONNECTION, JETSTREAM_OPTIONS, JetstreamClient, type JetstreamConsumeContext, JetstreamDlqHeader, type JetstreamFeatureOptions, JetstreamHeader, JetstreamHealthIndicator, type JetstreamHealthStatus, JetstreamModule, type JetstreamModuleAsyncOptions, type JetstreamModuleOptions, JetstreamProvisioningError, type JetstreamPublishContext, JetstreamRecord, JetstreamRecordBuilder, type JetstreamResponseContext, JetstreamStrategy, JetstreamTrace, JsonCodec, MIN_METADATA_TTL, MessageKind, type MetadataRegistryOptions, MsgpackCodec, NatsErrorCode, type OrderedEventOverrides, type OtelOptions, PatternPrefix, type ProvisioningOptions, PublishKind, RESERVED_HEADERS, type RpcConfig, RpcContext, type ScheduleRecordOptions, type ServerEndpoint, type StreamConfigOverrides, type StreamConsumerOverrides, StreamKind, TRACER_NAME, TransportEvent, type TransportHooks, buildBroadcastSubject, buildSubject, consumerName, dlqStreamName, getClientToken, internalName, isCoreRpcMode, isJetStreamRpcMode, metadataKey, streamName, toNanos };