@horizon-republic/nestjs-jetstream 2.7.0 → 2.7.1

package/dist/index.cjs

@@ -47,9 +47,13 @@ __export(index_exports, {
   RpcContext: () => RpcContext,
   StreamKind: () => StreamKind,
   TransportEvent: () => TransportEvent,
+  buildSubject: () => buildSubject,
+  consumerName: () => consumerName,
   getClientToken: () => getClientToken,
+  internalName: () => internalName,
   isCoreRpcMode: () => isCoreRpcMode,
   isJetStreamRpcMode: () => isJetStreamRpcMode,
+  streamName: () => streamName,
   toNanos: () => toNanos
 });
 module.exports = __toCommonJS(index_exports);
@@ -2659,8 +2663,12 @@ JetstreamModule = __decorateClass([
   RpcContext,
   StreamKind,
   TransportEvent,
+  buildSubject,
+  consumerName,
   getClientToken,
+  internalName,
   isCoreRpcMode,
   isJetStreamRpcMode,
+  streamName,
   toNanos
 });

package/dist/index.d.cts

@@ -346,6 +346,13 @@ declare enum StreamKind {
     Broadcast = "broadcast",
     Ordered = "ordered"
 }
+/**
+ * Subset of {@link StreamKind} used for direct subject building.
+ *
+ * Excludes `Broadcast` because broadcast subjects use a different
+ * naming convention (`broadcast.{pattern}` instead of `{service}.{kind}.{pattern}`).
+ */
+type SubjectKind = Exclude<StreamKind, StreamKind.Broadcast>;
 
 /** @internal Grouped pattern lists by stream kind, used for stream/consumer setup. */
 interface PatternsByKind {
@@ -1347,6 +1354,38 @@ declare enum JetstreamHeader {
     /** Set to `'true'` on error responses so the client can distinguish success from failure. */
     Error = "x-error"
 }
+/**
+ * Build the internal service name with microservice suffix.
+ *
+ * @param name - Service name from `forRoot({ name })`.
+ * @returns `{name}__microservice`
+ */
+declare const internalName: (name: string) => string;
+/**
+ * Build a fully-qualified NATS subject for workqueue events, RPC commands, or ordered events.
+ *
+ * @param serviceName - Target service name.
+ * @param kind - Subject kind (`'ev'`, `'cmd'`, or `'ordered'`).
+ * @param pattern - The message pattern (e.g. `'user.created'`).
+ * @returns `{serviceName}__microservice.{kind}.{pattern}`
+ */
+declare const buildSubject: (serviceName: string, kind: SubjectKind, pattern: string) => string;
+/**
+ * Build the JetStream stream name for a given service and kind.
+ *
+ * @param serviceName - Service name from `forRoot({ name })`.
+ * @param kind - Stream kind (`'ev'`, `'cmd'`, or `'broadcast'`).
+ * @returns Stream name (e.g. `orders__microservice_ev-stream` or `broadcast-stream`).
+ */
+declare const streamName: (serviceName: string, kind: StreamKind) => string;
+/**
+ * Build the JetStream consumer name for a given service and kind.
+ *
+ * @param serviceName - Service name from `forRoot({ name })`.
+ * @param kind - Stream kind (`'ev'`, `'cmd'`, or `'broadcast'`).
+ * @returns Consumer name (e.g. `orders__microservice_ev-consumer`).
+ */
+declare const consumerName: (serviceName: string, kind: StreamKind) => string;
 /**
  * Prefixes used in event patterns to route to specific stream types.
  * Applied by the user when emitting events (e.g. `client.emit('broadcast:config.updated', data)`).
@@ -1362,4 +1401,4 @@ 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 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, MessageKind, type OrderedEventOverrides, PatternPrefix, type RpcConfig, RpcContext, type StreamConsumerOverrides, StreamKind, TransportEvent, type TransportHooks, getClientToken, isCoreRpcMode, isJetStreamRpcMode, toNanos };
+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, MessageKind, type OrderedEventOverrides, PatternPrefix, type RpcConfig, RpcContext, type StreamConsumerOverrides, StreamKind, TransportEvent, type TransportHooks, buildSubject, consumerName, getClientToken, internalName, isCoreRpcMode, isJetStreamRpcMode, streamName, toNanos };

package/dist/index.d.ts

@@ -346,6 +346,13 @@ declare enum StreamKind {
     Broadcast = "broadcast",
     Ordered = "ordered"
 }
+/**
+ * Subset of {@link StreamKind} used for direct subject building.
+ *
+ * Excludes `Broadcast` because broadcast subjects use a different
+ * naming convention (`broadcast.{pattern}` instead of `{service}.{kind}.{pattern}`).
+ */
+type SubjectKind = Exclude<StreamKind, StreamKind.Broadcast>;
 
 /** @internal Grouped pattern lists by stream kind, used for stream/consumer setup. */
 interface PatternsByKind {
@@ -1347,6 +1354,38 @@ declare enum JetstreamHeader {
     /** Set to `'true'` on error responses so the client can distinguish success from failure. */
     Error = "x-error"
 }
+/**
+ * Build the internal service name with microservice suffix.
+ *
+ * @param name - Service name from `forRoot({ name })`.
+ * @returns `{name}__microservice`
+ */
+declare const internalName: (name: string) => string;
+/**
+ * Build a fully-qualified NATS subject for workqueue events, RPC commands, or ordered events.
+ *
+ * @param serviceName - Target service name.
+ * @param kind - Subject kind (`'ev'`, `'cmd'`, or `'ordered'`).
+ * @param pattern - The message pattern (e.g. `'user.created'`).
+ * @returns `{serviceName}__microservice.{kind}.{pattern}`
+ */
+declare const buildSubject: (serviceName: string, kind: SubjectKind, pattern: string) => string;
+/**
+ * Build the JetStream stream name for a given service and kind.
+ *
+ * @param serviceName - Service name from `forRoot({ name })`.
+ * @param kind - Stream kind (`'ev'`, `'cmd'`, or `'broadcast'`).
+ * @returns Stream name (e.g. `orders__microservice_ev-stream` or `broadcast-stream`).
+ */
+declare const streamName: (serviceName: string, kind: StreamKind) => string;
+/**
+ * Build the JetStream consumer name for a given service and kind.
+ *
+ * @param serviceName - Service name from `forRoot({ name })`.
+ * @param kind - Stream kind (`'ev'`, `'cmd'`, or `'broadcast'`).
+ * @returns Consumer name (e.g. `orders__microservice_ev-consumer`).
+ */
+declare const consumerName: (serviceName: string, kind: StreamKind) => string;
 /**
  * Prefixes used in event patterns to route to specific stream types.
  * Applied by the user when emitting events (e.g. `client.emit('broadcast:config.updated', data)`).
@@ -1362,4 +1401,4 @@ 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 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, MessageKind, type OrderedEventOverrides, PatternPrefix, type RpcConfig, RpcContext, type StreamConsumerOverrides, StreamKind, TransportEvent, type TransportHooks, getClientToken, isCoreRpcMode, isJetStreamRpcMode, toNanos };
+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, MessageKind, type OrderedEventOverrides, PatternPrefix, type RpcConfig, RpcContext, type StreamConsumerOverrides, StreamKind, TransportEvent, type TransportHooks, buildSubject, consumerName, getClientToken, internalName, isCoreRpcMode, isJetStreamRpcMode, streamName, toNanos };

package/dist/index.js

@@ -2650,8 +2650,12 @@ export {
   RpcContext,
   StreamKind,
   TransportEvent,
+  buildSubject,
+  consumerName,
   getClientToken,
+  internalName,
   isCoreRpcMode,
   isJetStreamRpcMode,
+  streamName,
   toNanos
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@horizon-republic/nestjs-jetstream",
-  "version": "2.7.0",
+  "version": "2.7.1",
   "description": "A NestJS transport for NATS with JetStream events, broadcast fan-out, and Core/JetStream RPC.",
   "repository": {
     "type": "git",