@crossdelta/cloudevents 0.7.10 → 0.7.12

package/README.md

@@ -596,7 +596,9 @@ app.use('/events', cloudEvents({ discover: 'src/events/**/*.handler.ts' }))
 | `consumeNatsEvents(options)` | Consume fire-and-forget |
 | `publish(type, data)` | Publish event (fire-and-forget) |
 | `request(type, data, opts?)` | Publish event and await reply (Request-Reply) |
-| `isNatsConnected()` | Check if NATS connection is live (for health checks) |
+| `isNatsConnected()` | Check if NATS publisher connection is live (for health checks) |
+| `isConsumerConnected()` | Check if any NATS consumer connection is live (for readiness probes) |
+| `configureNatsPublisher(config)` | Set connection options for the publisher singleton |
 | `closeConnection()` | Drain and close the NATS connection (for CLI tools) |
 ---
 

package/bin/cli.js

@@ -4,7 +4,7 @@ import * as fs from 'fs';
 import { existsSync, readdirSync, statSync } from 'fs';
 import * as path from 'path';
 import { join } from 'path';
-import { createFlow, createGenerationResult, input, initGenerationContext, trackChange, printGenerationSummary, change, runFlow } from '@crossdelta/flowcore';
+import { createFlow, createGenerationResult, input, initGenerationContext, trackChange, printGenerationSummary, runFlow, change } from '@crossdelta/flowcore';
 import 'url';
 import 'glob';
 import 'zod';
@@ -733,11 +733,34 @@ var init_domain = __esm({
   }
 });
 
+// src/transports/nats/connection.ts
+var LONG_LIVED_DEFAULTS, SHORT_LIVED_DEFAULTS, buildConnectOptions;
+var init_connection = __esm({
+  "src/transports/nats/connection.ts"() {
+    LONG_LIVED_DEFAULTS = {
+      waitOnFirstConnect: true,
+      maxReconnectAttempts: -1
+    };
+    SHORT_LIVED_DEFAULTS = {
+      waitOnFirstConnect: true,
+      maxReconnectAttempts: 10
+    };
+    buildConnectOptions = (config, mode) => {
+      const defaults = mode === "long-lived" ? LONG_LIVED_DEFAULTS : SHORT_LIVED_DEFAULTS;
+      return {
+        waitOnFirstConnect: config?.waitOnFirstConnect ?? defaults.waitOnFirstConnect,
+        maxReconnectAttempts: config?.maxReconnectAttempts ?? defaults.maxReconnectAttempts
+      };
+    };
+  }
+});
+
 // src/publishing/nats.publisher.ts
 var nats_publisher_exports = {};
 __export(nats_publisher_exports, {
   __resetNatsPublisher: () => __resetNatsPublisher,
   closeConnection: () => closeConnection,
+  configureNatsPublisher: () => configureNatsPublisher,
   connectNats: () => connectNats,
   deriveStreamFromType: () => deriveStreamFromType,
   deriveSubjectFromType: () => deriveSubjectFromType,
@@ -747,11 +770,12 @@ __export(nats_publisher_exports, {
   publishNatsRawEvent: () => publishNatsRawEvent,
   request: () => request
 });
-var sc, natsConnectionPromise, deriveSubjectFromEventType, getNatsConnection, closeConnection, connectNats, isNatsConnected, __resetNatsPublisher, deriveSubjectFromType, deriveStreamFromType, publishNatsRawEvent, publishNatsEvent, publish, DEFAULT_REQUEST_TIMEOUT, request;
+var sc, natsConnectionPromise, deriveSubjectFromEventType, connectionConfig, configureNatsPublisher, getNatsConnection, closeConnection, connectNats, isNatsConnected, __resetNatsPublisher, deriveSubjectFromType, deriveStreamFromType, publishNatsRawEvent, publishNatsEvent, publish, DEFAULT_REQUEST_TIMEOUT, request;
 var init_nats_publisher = __esm({
   "src/publishing/nats.publisher.ts"() {
     init_domain();
     init_infrastructure();
+    init_connection();
     init_utils();
     sc = StringCodec();
     natsConnectionPromise = null;
@@ -763,10 +787,16 @@ var init_nats_publisher = __esm({
       const pluralDomain = pluralize(domain);
       return `${pluralDomain}.${action}`;
     };
+    configureNatsPublisher = (config) => {
+      connectionConfig = config;
+    };
     getNatsConnection = async (servers) => {
       if (!natsConnectionPromise) {
         const url = servers ?? process.env.NATS_URL ?? "nats://localhost:4222";
-        natsConnectionPromise = connect({ servers: url }).then((connection) => {
+        natsConnectionPromise = connect({
+          servers: url,
+          ...buildConnectOptions(connectionConfig, "long-lived")
+        }).then((connection) => {
           logger.debug(`[NATS] connected to ${url}`);
           return connection;
         }).catch((error) => {
@@ -805,6 +835,7 @@ var init_nats_publisher = __esm({
     };
     __resetNatsPublisher = async () => {
       await closeConnection();
+      connectionConfig = void 0;
     };
     deriveSubjectFromType = (eventType, config) => {
       if (!config?.typeToSubjectMap) {

package/dist/index.cjs

@@ -1367,11 +1367,55 @@ var init_domain = __esm({
   }
 });
 
+// src/transports/nats/connection.ts
+var LONG_LIVED_DEFAULTS, SHORT_LIVED_DEFAULTS, buildConnectOptions, CONNECTION_REGISTRY_KEY, getConnectionRegistry, registerConnection, unregisterConnection; exports.isConsumerConnected = void 0;
+var init_connection = __esm({
+  "src/transports/nats/connection.ts"() {
+    LONG_LIVED_DEFAULTS = {
+      waitOnFirstConnect: true,
+      maxReconnectAttempts: -1
+    };
+    SHORT_LIVED_DEFAULTS = {
+      waitOnFirstConnect: true,
+      maxReconnectAttempts: 10
+    };
+    buildConnectOptions = (config, mode) => {
+      const defaults = mode === "long-lived" ? LONG_LIVED_DEFAULTS : SHORT_LIVED_DEFAULTS;
+      return {
+        waitOnFirstConnect: config?.waitOnFirstConnect ?? defaults.waitOnFirstConnect,
+        maxReconnectAttempts: config?.maxReconnectAttempts ?? defaults.maxReconnectAttempts
+      };
+    };
+    CONNECTION_REGISTRY_KEY = "__crossdelta_nats_connections__";
+    getConnectionRegistry = () => {
+      if (!globalThis[CONNECTION_REGISTRY_KEY]) {
+        globalThis[CONNECTION_REGISTRY_KEY] = /* @__PURE__ */ new Map();
+      }
+      return globalThis[CONNECTION_REGISTRY_KEY];
+    };
+    registerConnection = (name, connection) => {
+      getConnectionRegistry().set(name, connection);
+    };
+    unregisterConnection = (name) => {
+      getConnectionRegistry().delete(name);
+    };
+    exports.isConsumerConnected = () => {
+      const registry = getConnectionRegistry();
+      if (registry.size === 0) return false;
+      for (const connection of registry.values()) {
+        if (!connection.isClosed() && !connection.isDraining()) return true;
+      }
+      return false;
+    };
+  }
+});
+
 // src/publishing/nats.publisher.ts
 var nats_publisher_exports = {};
 __export(nats_publisher_exports, {
   __resetNatsPublisher: () => exports.__resetNatsPublisher,
   closeConnection: () => exports.closeConnection,
+  configureNatsPublisher: () => exports.configureNatsPublisher,
   connectNats: () => exports.connectNats,
   deriveStreamFromType: () => exports.deriveStreamFromType,
   deriveSubjectFromType: () => exports.deriveSubjectFromType,
@@ -1381,11 +1425,12 @@ __export(nats_publisher_exports, {
   publishNatsRawEvent: () => exports.publishNatsRawEvent,
   request: () => exports.request
 });
-var sc, natsConnectionPromise, deriveSubjectFromEventType, getNatsConnection; exports.closeConnection = void 0; exports.connectNats = void 0; exports.isNatsConnected = void 0; exports.__resetNatsPublisher = void 0; exports.deriveSubjectFromType = void 0; exports.deriveStreamFromType = void 0; exports.publishNatsRawEvent = void 0; exports.publishNatsEvent = void 0; exports.publish = void 0; var DEFAULT_REQUEST_TIMEOUT; exports.request = void 0;
+var sc, natsConnectionPromise, deriveSubjectFromEventType, connectionConfig; exports.configureNatsPublisher = void 0; var getNatsConnection; exports.closeConnection = void 0; exports.connectNats = void 0; exports.isNatsConnected = void 0; exports.__resetNatsPublisher = void 0; exports.deriveSubjectFromType = void 0; exports.deriveStreamFromType = void 0; exports.publishNatsRawEvent = void 0; exports.publishNatsEvent = void 0; exports.publish = void 0; var DEFAULT_REQUEST_TIMEOUT; exports.request = void 0;
 var init_nats_publisher = __esm({
   "src/publishing/nats.publisher.ts"() {
     init_domain();
     init_infrastructure();
+    init_connection();
     init_utils();
     sc = nats.StringCodec();
     natsConnectionPromise = null;
@@ -1397,10 +1442,16 @@ var init_nats_publisher = __esm({
       const pluralDomain = exports.pluralize(domain);
       return `${pluralDomain}.${action}`;
     };
+    exports.configureNatsPublisher = (config) => {
+      connectionConfig = config;
+    };
     getNatsConnection = async (servers) => {
       if (!natsConnectionPromise) {
         const url = servers ?? process.env.NATS_URL ?? "nats://localhost:4222";
-        natsConnectionPromise = nats.connect({ servers: url }).then((connection) => {
+        natsConnectionPromise = nats.connect({
+          servers: url,
+          ...buildConnectOptions(connectionConfig, "long-lived")
+        }).then((connection) => {
           logger.debug(`[NATS] connected to ${url}`);
           return connection;
         }).catch((error) => {
@@ -1439,6 +1490,7 @@ var init_nats_publisher = __esm({
     };
     exports.__resetNatsPublisher = async () => {
       await exports.closeConnection();
+      connectionConfig = void 0;
     };
     exports.deriveSubjectFromType = (eventType, config) => {
       if (!config?.typeToSubjectMap) {
@@ -2182,7 +2234,7 @@ function cloudEvents(options = {}) {
 // package.json
 var package_default = {
   name: "@crossdelta/cloudevents",
-  version: "0.7.10",
+  version: "0.7.12",
   description: "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream & Core"};
 
 // src/plugin.ts
@@ -2415,9 +2467,13 @@ function createBaseMessageProcessor(deps) {
   };
 }
 
+// src/transports/nats/index.ts
+init_connection();
+
 // src/transports/nats/jetstream-consumer.ts
 init_domain();
 init_logging();
+init_connection();
 
 // src/transports/nats/jetstream-message-processor.ts
 var createJetStreamMessageProcessor = (deps) => {
@@ -2473,7 +2529,8 @@ async function ensureJetStreamStream(options) {
   const pass = options.pass ?? process.env.NATS_PASSWORD;
   const nc = await nats.connect({
     servers,
-    ...user && pass ? { user, pass } : {}
+    ...user && pass ? { user, pass } : {},
+    ...buildConnectOptions(options.connection, "short-lived")
   });
   try {
     const jsm = await nc.jetstreamManager();
@@ -2514,7 +2571,8 @@ async function ensureJetStreamStreams(options) {
   const pass = options.pass ?? process.env.NATS_PASSWORD;
   const nc = await nats.connect({
     servers,
-    ...user && pass ? { user, pass } : {}
+    ...user && pass ? { user, pass } : {},
+    ...buildConnectOptions(options.connection, "short-lived")
   });
   try {
     const jsm = await nc.jetstreamManager();
@@ -2566,8 +2624,10 @@ async function consumeJetStreamEvents(options) {
   logger.info(`[${name}] discovered ${processedHandlers.length} handler(s): ${handlerNames}`);
   const nc = await nats.connect({
     servers,
-    ...user && pass ? { user, pass } : {}
+    ...user && pass ? { user, pass } : {},
+    ...buildConnectOptions(options.connection, "long-lived")
   });
+  registerConnection(name, nc);
   logger.info(`[${name}] connected to NATS: ${servers}${user ? " (authenticated)" : ""}`);
   const jsm = await nc.jetstreamManager();
   const js = nc.jetstream();
@@ -2634,8 +2694,10 @@ async function consumeJetStreamStreams(options) {
   logger.info(`[${name}] discovered ${processedHandlers.length} handler(s): ${handlerNames}`);
   const nc = await nats.connect({
     servers,
-    ...user && pass ? { user, pass } : {}
+    ...user && pass ? { user, pass } : {},
+    ...buildConnectOptions(options.connection, "long-lived")
   });
+  registerConnection(name, nc);
   logger.info(`[${name}] connected to NATS: ${servers}${user ? " (authenticated)" : ""}`);
   const jsm = await nc.jetstreamManager();
   const js = nc.jetstream();
@@ -2703,6 +2765,7 @@ var consumeJetStreams = consumeJetStreamStreams;
 // src/transports/nats/nats-consumer.ts
 init_domain();
 init_logging();
+init_connection();
 var sc3 = nats.StringCodec();
 var isRequestMessage = (msg) => Boolean(msg.reply);
 var sendReply = (msg, payload) => {
@@ -2762,6 +2825,7 @@ async function cleanupConsumer(name) {
     consumer.subscription.unsubscribe();
     await consumer.connection.drain();
     registry.delete(name);
+    unregisterConnection(name);
   }
 }
 async function consumeNatsEvents(options) {
@@ -2777,12 +2841,14 @@ async function consumeNatsEvents(options) {
   logger.info(`[${name}] discovered ${processedHandlers.length} handler(s): ${handlerNames}`);
   const nc = await nats.connect({
     servers,
-    ...user && pass ? { user, pass } : {}
+    ...user && pass ? { user, pass } : {},
+    ...buildConnectOptions(options.connection, "long-lived")
   });
   logger.info(`[${name}] connected to NATS: ${servers}${user ? " (authenticated)" : ""}`);
   const sub = nc.subscribe(subject, { queue: name });
   logger.info(`[${name}] subscribed to subject: ${subject} (queue: ${name})`);
   getConsumerRegistry().set(name, { subscription: sub, connection: nc });
+  registerConnection(name, nc);
   const dlqEnabled = Boolean(options.quarantineTopic || options.errorTopic);
   const { handleMessage, handleUnhandledProcessingError } = createNatsMessageProcessor({
     name,

package/dist/index.d.cts

@@ -1298,6 +1298,18 @@ interface CloudEventsPfPluginOptions {
 }
 declare const createPfPlugin: (options?: CloudEventsPfPluginOptions) => PfPlugin;
 
+interface NatsConnectionConfig {
+    /** Retry the initial connection instead of failing immediately. @default true */
+    waitOnFirstConnect?: boolean;
+    /** Maximum reconnect attempts (-1 = unlimited). @default -1 */
+    maxReconnectAttempts?: number;
+}
+/**
+ * Returns true if at least one registered consumer connection is alive.
+ * Returns false if no consumers are registered or all are closed/draining.
+ */
+declare const isConsumerConnected: () => boolean;
+
 interface RequestNatsEventOptions {
     servers?: string;
     source?: string;
@@ -1314,6 +1326,11 @@ interface PublishNatsEventOptions {
     /** Close connection after publishing (for CLI tools) */
     closeAfterPublish?: boolean;
 }
+/**
+ * Configure connection defaults for the publisher singleton.
+ * Call before any publish/request to override defaults.
+ */
+declare const configureNatsPublisher: (config: NatsConnectionConfig) => void;
 /**
  * Close the NATS connection and reset state
  */
@@ -1408,6 +1425,8 @@ interface JetStreamStreamOptions {
     subjects: string[];
     /** Stream configuration */
     config?: StreamConfig;
+    /** NATS connection tuning */
+    connection?: NatsConnectionConfig;
 }
 /**
  * Stream definition for batch operations
@@ -1432,6 +1451,8 @@ interface JetStreamStreamsOptions {
     pass?: string;
     /** Array of stream definitions */
     streams: StreamDefinition[];
+    /** NATS connection tuning */
+    connection?: NatsConnectionConfig;
 }
 /**
  * JetStream consumer configuration
@@ -1487,6 +1508,8 @@ interface JetStreamConsumerOptions extends Pick<CloudEventsOptions, 'quarantineT
      * @default 86400000 (24 hours)
      */
     idempotencyTtl?: number;
+    /** NATS connection tuning */
+    connection?: NatsConnectionConfig;
 }
 /**
  * Ensures a JetStream stream exists with the given configuration.
@@ -1570,6 +1593,8 @@ interface JetStreamStreamsConsumerOptions extends Pick<CloudEventsOptions, 'quar
     idempotencyStore?: IdempotencyStore | false;
     /** TTL for idempotency records in milliseconds @default 86400000 */
     idempotencyTtl?: number;
+    /** NATS connection tuning */
+    connection?: NatsConnectionConfig;
 }
 /**
  * Consume CloudEvents from multiple JetStream streams with a single connection.
@@ -1619,6 +1644,8 @@ interface NatsConsumerOptions extends Pick<CloudEventsOptions, 'quarantineTopic'
     user?: string;
     /** NATS password for authentication (defaults to NATS_PASSWORD env var) */
     pass?: string;
+    /** NATS connection tuning */
+    connection?: NatsConnectionConfig;
 }
 /**
  * Connects to NATS, discovers matching event handlers, and processes incoming CloudEvents.
@@ -1631,4 +1658,4 @@ interface NatsConsumerOptions extends Pick<CloudEventsOptions, 'quarantineTopic'
  */
 declare function consumeNatsEvents(options: NatsConsumerOptions): Promise<Subscription>;
 
-export { type ChannelConfig, type ChannelMetadata, type CloudEventsPfPluginOptions, type ContractCreatedEffect, type ContractPaths, type CreateEventContext, type CreateEventOptions, type DomainEffect, type EnrichedEvent, type EventContext, type EventNames, type EventTypeValidation, type FileSystem, type HandleEventOptions, type HandlerCreatedEffect, type IdempotencyStore, type InferEventData, type JetStreamConsumerOptions, type JetStreamStreamOptions, type JetStreamStreamsConsumerOptions, type JetStreamStreamsOptions, type ListEventsContext, type NatsRequestResponse, type PublishEventContext, type PublishEventOptions, type PublishNatsEventOptions, type RequestNatsEventOptions, type RoutingConfig, type SchemaField, type StreamConfig, type StreamDefinition, type StreamWiredEffect, __resetNatsPublisher, checkAndMarkProcessed, clearHandlerCache, closeConnection, cloudEvents, connectNats, consumeJetStreamEvents, consumeJetStreamStreams, consumeJetStreams, consumeNatsEvents, contractCreated, createContract, createEvent, createEventFlowSteps, createInMemoryIdempotencyStore, createMemoryFileSystem, createPfPlugin, deriveEventNames, deriveStreamFromType, deriveSubjectFromType, discoverEventTypes, ensureJetStreamStream, ensureJetStreamStreams, ensureJetStreams, eventSchema, extractTypeFromSchema, generateContract, generateContractContent, generateEventHandler, generateEventHandlerContent, generateJsonMock, generateJsonMockFromContract, generateMock, generateMockContent, getContractFilePath, getContractPaths, getDefaultIdempotencyStore, getHandlerFilePath, getHandlerPath, getJsonMockPath, getMockFilePath, getStreamName, handleEvent, handlerCreated, initFaker, isNatsConnected, isValidEventType, jsonMockExists, listEvents, listEventsFlowSteps, loadJsonMock, normalizeSubject, parseDataInput, parseEventFromContext, parseEventTypeFromContract, parseEventTypeFromHandler, parseFieldsInput, pluralize, publish, publishEvent, publishEventFlowSteps, publishNatsEvent, publishNatsRawEvent, publishRawEvent, request, resetDefaultIdempotencyStore, singularize, streamWired, toKebabCase, toPascalCase, validateEventType };
+export { type ChannelConfig, type ChannelMetadata, type CloudEventsPfPluginOptions, type ContractCreatedEffect, type ContractPaths, type CreateEventContext, type CreateEventOptions, type DomainEffect, type EnrichedEvent, type EventContext, type EventNames, type EventTypeValidation, type FileSystem, type HandleEventOptions, type HandlerCreatedEffect, type IdempotencyStore, type InferEventData, type JetStreamConsumerOptions, type JetStreamStreamOptions, type JetStreamStreamsConsumerOptions, type JetStreamStreamsOptions, type ListEventsContext, type NatsConnectionConfig, type NatsRequestResponse, type PublishEventContext, type PublishEventOptions, type PublishNatsEventOptions, type RequestNatsEventOptions, type RoutingConfig, type SchemaField, type StreamConfig, type StreamDefinition, type StreamWiredEffect, __resetNatsPublisher, checkAndMarkProcessed, clearHandlerCache, closeConnection, cloudEvents, configureNatsPublisher, connectNats, consumeJetStreamEvents, consumeJetStreamStreams, consumeJetStreams, consumeNatsEvents, contractCreated, createContract, createEvent, createEventFlowSteps, createInMemoryIdempotencyStore, createMemoryFileSystem, createPfPlugin, deriveEventNames, deriveStreamFromType, deriveSubjectFromType, discoverEventTypes, ensureJetStreamStream, ensureJetStreamStreams, ensureJetStreams, eventSchema, extractTypeFromSchema, generateContract, generateContractContent, generateEventHandler, generateEventHandlerContent, generateJsonMock, generateJsonMockFromContract, generateMock, generateMockContent, getContractFilePath, getContractPaths, getDefaultIdempotencyStore, getHandlerFilePath, getHandlerPath, getJsonMockPath, getMockFilePath, getStreamName, handleEvent, handlerCreated, initFaker, isConsumerConnected, isNatsConnected, isValidEventType, jsonMockExists, listEvents, listEventsFlowSteps, loadJsonMock, normalizeSubject, parseDataInput, parseEventFromContext, parseEventTypeFromContract, parseEventTypeFromHandler, parseFieldsInput, pluralize, publish, publishEvent, publishEventFlowSteps, publishNatsEvent, publishNatsRawEvent, publishRawEvent, request, resetDefaultIdempotencyStore, singularize, streamWired, toKebabCase, toPascalCase, validateEventType };

package/dist/index.d.ts

@@ -1298,6 +1298,18 @@ interface CloudEventsPfPluginOptions {
 }
 declare const createPfPlugin: (options?: CloudEventsPfPluginOptions) => PfPlugin;
 
+interface NatsConnectionConfig {
+    /** Retry the initial connection instead of failing immediately. @default true */
+    waitOnFirstConnect?: boolean;
+    /** Maximum reconnect attempts (-1 = unlimited). @default -1 */
+    maxReconnectAttempts?: number;
+}
+/**
+ * Returns true if at least one registered consumer connection is alive.
+ * Returns false if no consumers are registered or all are closed/draining.
+ */
+declare const isConsumerConnected: () => boolean;
+
 interface RequestNatsEventOptions {
     servers?: string;
     source?: string;
@@ -1314,6 +1326,11 @@ interface PublishNatsEventOptions {
     /** Close connection after publishing (for CLI tools) */
     closeAfterPublish?: boolean;
 }
+/**
+ * Configure connection defaults for the publisher singleton.
+ * Call before any publish/request to override defaults.
+ */
+declare const configureNatsPublisher: (config: NatsConnectionConfig) => void;
 /**
  * Close the NATS connection and reset state
  */
@@ -1408,6 +1425,8 @@ interface JetStreamStreamOptions {
     subjects: string[];
     /** Stream configuration */
     config?: StreamConfig;
+    /** NATS connection tuning */
+    connection?: NatsConnectionConfig;
 }
 /**
  * Stream definition for batch operations
@@ -1432,6 +1451,8 @@ interface JetStreamStreamsOptions {
     pass?: string;
     /** Array of stream definitions */
     streams: StreamDefinition[];
+    /** NATS connection tuning */
+    connection?: NatsConnectionConfig;
 }
 /**
  * JetStream consumer configuration
@@ -1487,6 +1508,8 @@ interface JetStreamConsumerOptions extends Pick<CloudEventsOptions, 'quarantineT
      * @default 86400000 (24 hours)
      */
     idempotencyTtl?: number;
+    /** NATS connection tuning */
+    connection?: NatsConnectionConfig;
 }
 /**
  * Ensures a JetStream stream exists with the given configuration.
@@ -1570,6 +1593,8 @@ interface JetStreamStreamsConsumerOptions extends Pick<CloudEventsOptions, 'quar
     idempotencyStore?: IdempotencyStore | false;
     /** TTL for idempotency records in milliseconds @default 86400000 */
     idempotencyTtl?: number;
+    /** NATS connection tuning */
+    connection?: NatsConnectionConfig;
 }
 /**
  * Consume CloudEvents from multiple JetStream streams with a single connection.
@@ -1619,6 +1644,8 @@ interface NatsConsumerOptions extends Pick<CloudEventsOptions, 'quarantineTopic'
     user?: string;
     /** NATS password for authentication (defaults to NATS_PASSWORD env var) */
     pass?: string;
+    /** NATS connection tuning */
+    connection?: NatsConnectionConfig;
 }
 /**
  * Connects to NATS, discovers matching event handlers, and processes incoming CloudEvents.
@@ -1631,4 +1658,4 @@ interface NatsConsumerOptions extends Pick<CloudEventsOptions, 'quarantineTopic'
  */
 declare function consumeNatsEvents(options: NatsConsumerOptions): Promise<Subscription>;
 
-export { type ChannelConfig, type ChannelMetadata, type CloudEventsPfPluginOptions, type ContractCreatedEffect, type ContractPaths, type CreateEventContext, type CreateEventOptions, type DomainEffect, type EnrichedEvent, type EventContext, type EventNames, type EventTypeValidation, type FileSystem, type HandleEventOptions, type HandlerCreatedEffect, type IdempotencyStore, type InferEventData, type JetStreamConsumerOptions, type JetStreamStreamOptions, type JetStreamStreamsConsumerOptions, type JetStreamStreamsOptions, type ListEventsContext, type NatsRequestResponse, type PublishEventContext, type PublishEventOptions, type PublishNatsEventOptions, type RequestNatsEventOptions, type RoutingConfig, type SchemaField, type StreamConfig, type StreamDefinition, type StreamWiredEffect, __resetNatsPublisher, checkAndMarkProcessed, clearHandlerCache, closeConnection, cloudEvents, connectNats, consumeJetStreamEvents, consumeJetStreamStreams, consumeJetStreams, consumeNatsEvents, contractCreated, createContract, createEvent, createEventFlowSteps, createInMemoryIdempotencyStore, createMemoryFileSystem, createPfPlugin, deriveEventNames, deriveStreamFromType, deriveSubjectFromType, discoverEventTypes, ensureJetStreamStream, ensureJetStreamStreams, ensureJetStreams, eventSchema, extractTypeFromSchema, generateContract, generateContractContent, generateEventHandler, generateEventHandlerContent, generateJsonMock, generateJsonMockFromContract, generateMock, generateMockContent, getContractFilePath, getContractPaths, getDefaultIdempotencyStore, getHandlerFilePath, getHandlerPath, getJsonMockPath, getMockFilePath, getStreamName, handleEvent, handlerCreated, initFaker, isNatsConnected, isValidEventType, jsonMockExists, listEvents, listEventsFlowSteps, loadJsonMock, normalizeSubject, parseDataInput, parseEventFromContext, parseEventTypeFromContract, parseEventTypeFromHandler, parseFieldsInput, pluralize, publish, publishEvent, publishEventFlowSteps, publishNatsEvent, publishNatsRawEvent, publishRawEvent, request, resetDefaultIdempotencyStore, singularize, streamWired, toKebabCase, toPascalCase, validateEventType };
+export { type ChannelConfig, type ChannelMetadata, type CloudEventsPfPluginOptions, type ContractCreatedEffect, type ContractPaths, type CreateEventContext, type CreateEventOptions, type DomainEffect, type EnrichedEvent, type EventContext, type EventNames, type EventTypeValidation, type FileSystem, type HandleEventOptions, type HandlerCreatedEffect, type IdempotencyStore, type InferEventData, type JetStreamConsumerOptions, type JetStreamStreamOptions, type JetStreamStreamsConsumerOptions, type JetStreamStreamsOptions, type ListEventsContext, type NatsConnectionConfig, type NatsRequestResponse, type PublishEventContext, type PublishEventOptions, type PublishNatsEventOptions, type RequestNatsEventOptions, type RoutingConfig, type SchemaField, type StreamConfig, type StreamDefinition, type StreamWiredEffect, __resetNatsPublisher, checkAndMarkProcessed, clearHandlerCache, closeConnection, cloudEvents, configureNatsPublisher, connectNats, consumeJetStreamEvents, consumeJetStreamStreams, consumeJetStreams, consumeNatsEvents, contractCreated, createContract, createEvent, createEventFlowSteps, createInMemoryIdempotencyStore, createMemoryFileSystem, createPfPlugin, deriveEventNames, deriveStreamFromType, deriveSubjectFromType, discoverEventTypes, ensureJetStreamStream, ensureJetStreamStreams, ensureJetStreams, eventSchema, extractTypeFromSchema, generateContract, generateContractContent, generateEventHandler, generateEventHandlerContent, generateJsonMock, generateJsonMockFromContract, generateMock, generateMockContent, getContractFilePath, getContractPaths, getDefaultIdempotencyStore, getHandlerFilePath, getHandlerPath, getJsonMockPath, getMockFilePath, getStreamName, handleEvent, handlerCreated, initFaker, isConsumerConnected, isNatsConnected, isValidEventType, jsonMockExists, listEvents, listEventsFlowSteps, loadJsonMock, normalizeSubject, parseDataInput, parseEventFromContext, parseEventTypeFromContract, parseEventTypeFromHandler, parseFieldsInput, pluralize, publish, publishEvent, publishEventFlowSteps, publishNatsEvent, publishNatsRawEvent, publishRawEvent, request, resetDefaultIdempotencyStore, singularize, streamWired, toKebabCase, toPascalCase, validateEventType };

package/dist/index.js

@@ -4,7 +4,7 @@ import * as fs from 'fs';
 import { existsSync, readdirSync, statSync } from 'fs';
 import * as path from 'path';
 import { join, dirname } from 'path';
-import { createFlow, createGenerationResult, input, initGenerationContext, trackChange, printGenerationSummary, change, runFlow } from '@crossdelta/flowcore';
+import { createFlow, createGenerationResult, input, initGenerationContext, trackChange, printGenerationSummary, runFlow, change } from '@crossdelta/flowcore';
 import { fileURLToPath } from 'url';
 import { glob } from 'glob';
 import { z } from 'zod';
@@ -1342,11 +1342,55 @@ var init_domain = __esm({
   }
 });
 
+// src/transports/nats/connection.ts
+var LONG_LIVED_DEFAULTS, SHORT_LIVED_DEFAULTS, buildConnectOptions, CONNECTION_REGISTRY_KEY, getConnectionRegistry, registerConnection, unregisterConnection, isConsumerConnected;
+var init_connection = __esm({
+  "src/transports/nats/connection.ts"() {
+    LONG_LIVED_DEFAULTS = {
+      waitOnFirstConnect: true,
+      maxReconnectAttempts: -1
+    };
+    SHORT_LIVED_DEFAULTS = {
+      waitOnFirstConnect: true,
+      maxReconnectAttempts: 10
+    };
+    buildConnectOptions = (config, mode) => {
+      const defaults = mode === "long-lived" ? LONG_LIVED_DEFAULTS : SHORT_LIVED_DEFAULTS;
+      return {
+        waitOnFirstConnect: config?.waitOnFirstConnect ?? defaults.waitOnFirstConnect,
+        maxReconnectAttempts: config?.maxReconnectAttempts ?? defaults.maxReconnectAttempts
+      };
+    };
+    CONNECTION_REGISTRY_KEY = "__crossdelta_nats_connections__";
+    getConnectionRegistry = () => {
+      if (!globalThis[CONNECTION_REGISTRY_KEY]) {
+        globalThis[CONNECTION_REGISTRY_KEY] = /* @__PURE__ */ new Map();
+      }
+      return globalThis[CONNECTION_REGISTRY_KEY];
+    };
+    registerConnection = (name, connection) => {
+      getConnectionRegistry().set(name, connection);
+    };
+    unregisterConnection = (name) => {
+      getConnectionRegistry().delete(name);
+    };
+    isConsumerConnected = () => {
+      const registry = getConnectionRegistry();
+      if (registry.size === 0) return false;
+      for (const connection of registry.values()) {
+        if (!connection.isClosed() && !connection.isDraining()) return true;
+      }
+      return false;
+    };
+  }
+});
+
 // src/publishing/nats.publisher.ts
 var nats_publisher_exports = {};
 __export(nats_publisher_exports, {
   __resetNatsPublisher: () => __resetNatsPublisher,
   closeConnection: () => closeConnection,
+  configureNatsPublisher: () => configureNatsPublisher,
   connectNats: () => connectNats,
   deriveStreamFromType: () => deriveStreamFromType,
   deriveSubjectFromType: () => deriveSubjectFromType,
@@ -1356,11 +1400,12 @@ __export(nats_publisher_exports, {
   publishNatsRawEvent: () => publishNatsRawEvent,
   request: () => request
 });
-var sc, natsConnectionPromise, deriveSubjectFromEventType, getNatsConnection, closeConnection, connectNats, isNatsConnected, __resetNatsPublisher, deriveSubjectFromType, deriveStreamFromType, publishNatsRawEvent, publishNatsEvent, publish, DEFAULT_REQUEST_TIMEOUT, request;
+var sc, natsConnectionPromise, deriveSubjectFromEventType, connectionConfig, configureNatsPublisher, getNatsConnection, closeConnection, connectNats, isNatsConnected, __resetNatsPublisher, deriveSubjectFromType, deriveStreamFromType, publishNatsRawEvent, publishNatsEvent, publish, DEFAULT_REQUEST_TIMEOUT, request;
 var init_nats_publisher = __esm({
   "src/publishing/nats.publisher.ts"() {
     init_domain();
     init_infrastructure();
+    init_connection();
     init_utils();
     sc = StringCodec();
     natsConnectionPromise = null;
@@ -1372,10 +1417,16 @@ var init_nats_publisher = __esm({
       const pluralDomain = pluralize(domain);
       return `${pluralDomain}.${action}`;
     };
+    configureNatsPublisher = (config) => {
+      connectionConfig = config;
+    };
     getNatsConnection = async (servers) => {
       if (!natsConnectionPromise) {
         const url = servers ?? process.env.NATS_URL ?? "nats://localhost:4222";
-        natsConnectionPromise = connect({ servers: url }).then((connection) => {
+        natsConnectionPromise = connect({
+          servers: url,
+          ...buildConnectOptions(connectionConfig, "long-lived")
+        }).then((connection) => {
           logger.debug(`[NATS] connected to ${url}`);
           return connection;
         }).catch((error) => {
@@ -1414,6 +1465,7 @@ var init_nats_publisher = __esm({
     };
     __resetNatsPublisher = async () => {
       await closeConnection();
+      connectionConfig = void 0;
     };
     deriveSubjectFromType = (eventType, config) => {
       if (!config?.typeToSubjectMap) {
@@ -2157,7 +2209,7 @@ function cloudEvents(options = {}) {
 // package.json
 var package_default = {
   name: "@crossdelta/cloudevents",
-  version: "0.7.10",
+  version: "0.7.12",
   description: "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream & Core"};
 
 // src/plugin.ts
@@ -2390,9 +2442,13 @@ function createBaseMessageProcessor(deps) {
   };
 }
 
+// src/transports/nats/index.ts
+init_connection();
+
 // src/transports/nats/jetstream-consumer.ts
 init_domain();
 init_logging();
+init_connection();
 
 // src/transports/nats/jetstream-message-processor.ts
 var createJetStreamMessageProcessor = (deps) => {
@@ -2448,7 +2504,8 @@ async function ensureJetStreamStream(options) {
   const pass = options.pass ?? process.env.NATS_PASSWORD;
   const nc = await connect({
     servers,
-    ...user && pass ? { user, pass } : {}
+    ...user && pass ? { user, pass } : {},
+    ...buildConnectOptions(options.connection, "short-lived")
   });
   try {
     const jsm = await nc.jetstreamManager();
@@ -2489,7 +2546,8 @@ async function ensureJetStreamStreams(options) {
   const pass = options.pass ?? process.env.NATS_PASSWORD;
   const nc = await connect({
     servers,
-    ...user && pass ? { user, pass } : {}
+    ...user && pass ? { user, pass } : {},
+    ...buildConnectOptions(options.connection, "short-lived")
   });
   try {
     const jsm = await nc.jetstreamManager();
@@ -2541,8 +2599,10 @@ async function consumeJetStreamEvents(options) {
   logger.info(`[${name}] discovered ${processedHandlers.length} handler(s): ${handlerNames}`);
   const nc = await connect({
     servers,
-    ...user && pass ? { user, pass } : {}
+    ...user && pass ? { user, pass } : {},
+    ...buildConnectOptions(options.connection, "long-lived")
   });
+  registerConnection(name, nc);
   logger.info(`[${name}] connected to NATS: ${servers}${user ? " (authenticated)" : ""}`);
   const jsm = await nc.jetstreamManager();
   const js = nc.jetstream();
@@ -2609,8 +2669,10 @@ async function consumeJetStreamStreams(options) {
   logger.info(`[${name}] discovered ${processedHandlers.length} handler(s): ${handlerNames}`);
   const nc = await connect({
     servers,
-    ...user && pass ? { user, pass } : {}
+    ...user && pass ? { user, pass } : {},
+    ...buildConnectOptions(options.connection, "long-lived")
   });
+  registerConnection(name, nc);
   logger.info(`[${name}] connected to NATS: ${servers}${user ? " (authenticated)" : ""}`);
   const jsm = await nc.jetstreamManager();
   const js = nc.jetstream();
@@ -2678,6 +2740,7 @@ var consumeJetStreams = consumeJetStreamStreams;
 // src/transports/nats/nats-consumer.ts
 init_domain();
 init_logging();
+init_connection();
 var sc3 = StringCodec();
 var isRequestMessage = (msg) => Boolean(msg.reply);
 var sendReply = (msg, payload) => {
@@ -2737,6 +2800,7 @@ async function cleanupConsumer(name) {
     consumer.subscription.unsubscribe();
     await consumer.connection.drain();
     registry.delete(name);
+    unregisterConnection(name);
   }
 }
 async function consumeNatsEvents(options) {
@@ -2752,12 +2816,14 @@ async function consumeNatsEvents(options) {
   logger.info(`[${name}] discovered ${processedHandlers.length} handler(s): ${handlerNames}`);
   const nc = await connect({
     servers,
-    ...user && pass ? { user, pass } : {}
+    ...user && pass ? { user, pass } : {},
+    ...buildConnectOptions(options.connection, "long-lived")
   });
   logger.info(`[${name}] connected to NATS: ${servers}${user ? " (authenticated)" : ""}`);
   const sub = nc.subscribe(subject, { queue: name });
   logger.info(`[${name}] subscribed to subject: ${subject} (queue: ${name})`);
   getConsumerRegistry().set(name, { subscription: sub, connection: nc });
+  registerConnection(name, nc);
   const dlqEnabled = Boolean(options.quarantineTopic || options.errorTopic);
   const { handleMessage, handleUnhandledProcessingError } = createNatsMessageProcessor({
     name,
@@ -2782,4 +2848,4 @@ async function consumeNatsEvents(options) {
 // src/index.ts
 init_utils();
 
-export { __resetNatsPublisher, checkAndMarkProcessed, clearHandlerCache, closeConnection, cloudEvents, connectNats, consumeJetStreamEvents, consumeJetStreamStreams, consumeJetStreams, consumeNatsEvents, contractCreated, createContract, createEvent, createEventFlowSteps, createInMemoryIdempotencyStore, createMemoryFileSystem, createPfPlugin, deriveEventNames, deriveStreamFromType, deriveSubjectFromType, discoverEventTypes, ensureJetStreamStream, ensureJetStreamStreams, ensureJetStreams, eventSchema, extractTypeFromSchema, generateContract, generateContractContent, generateEventHandler, generateEventHandlerContent, generateJsonMock, generateJsonMockFromContract, generateMock, generateMockContent, getContractFilePath, getContractPaths, getDefaultIdempotencyStore, getHandlerFilePath, getHandlerPath, getJsonMockPath, getMockFilePath, getStreamName, handleEvent, handlerCreated, initFaker, isNatsConnected, isValidEventType, jsonMockExists, listEvents, listEventsFlowSteps, loadJsonMock, normalizeSubject, parseDataInput, parseEventFromContext, parseEventTypeFromContract, parseEventTypeFromHandler, parseFieldsInput, pluralize, publish, publishEvent, publishEventFlowSteps, publishNatsEvent, publishNatsRawEvent, publishRawEvent, request, resetDefaultIdempotencyStore, singularize, streamWired, toKebabCase, toPascalCase, validateEventType };
+export { __resetNatsPublisher, checkAndMarkProcessed, clearHandlerCache, closeConnection, cloudEvents, configureNatsPublisher, connectNats, consumeJetStreamEvents, consumeJetStreamStreams, consumeJetStreams, consumeNatsEvents, contractCreated, createContract, createEvent, createEventFlowSteps, createInMemoryIdempotencyStore, createMemoryFileSystem, createPfPlugin, deriveEventNames, deriveStreamFromType, deriveSubjectFromType, discoverEventTypes, ensureJetStreamStream, ensureJetStreamStreams, ensureJetStreams, eventSchema, extractTypeFromSchema, generateContract, generateContractContent, generateEventHandler, generateEventHandlerContent, generateJsonMock, generateJsonMockFromContract, generateMock, generateMockContent, getContractFilePath, getContractPaths, getDefaultIdempotencyStore, getHandlerFilePath, getHandlerPath, getJsonMockPath, getMockFilePath, getStreamName, handleEvent, handlerCreated, initFaker, isConsumerConnected, isNatsConnected, isValidEventType, jsonMockExists, listEvents, listEventsFlowSteps, loadJsonMock, normalizeSubject, parseDataInput, parseEventFromContext, parseEventTypeFromContract, parseEventTypeFromHandler, parseFieldsInput, pluralize, publish, publishEvent, publishEventFlowSteps, publishNatsEvent, publishNatsRawEvent, publishRawEvent, request, resetDefaultIdempotencyStore, singularize, streamWired, toKebabCase, toPascalCase, validateEventType };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossdelta/cloudevents",
-  "version": "0.7.10",
+  "version": "0.7.12",
   "description": "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream & Core",
   "author": "crossdelta",
   "license": "MIT",
@@ -47,7 +47,7 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@crossdelta/flowcore": "workspace:*",
+    "@crossdelta/flowcore": "^0.1.2",
     "cloudevents": "^10.0.0",
     "glob": "^11.1.0",
     "nats": "^2.29.3",