@crossdelta/cloudevents 0.7.14 → 0.7.16

package/bin/cli.js

@@ -733,28 +733,6 @@ 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, {
@@ -770,12 +748,11 @@ __export(nats_publisher_exports, {
   publishNatsRawEvent: () => publishNatsRawEvent,
   request: () => request
 });
-var sc, natsConnectionPromise, deriveSubjectFromEventType, connectionConfig, configureNatsPublisher, getNatsConnection, closeConnection, connectNats, isNatsConnected, __resetNatsPublisher, deriveSubjectFromType, deriveStreamFromType, publishNatsRawEvent, publishNatsEvent, publish, DEFAULT_REQUEST_TIMEOUT, request;
+var sc, natsConnectionPromise, deriveSubjectFromEventType, connectionConfig, configureNatsPublisher, natsConnected, 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;
@@ -790,17 +767,21 @@ var init_nats_publisher = __esm({
     configureNatsPublisher = (config) => {
       connectionConfig = config;
     };
+    natsConnected = false;
     getNatsConnection = async (servers) => {
       if (!natsConnectionPromise) {
         const url = servers ?? process.env.NATS_URL ?? "nats://localhost:4222";
         natsConnectionPromise = connect({
           servers: url,
-          ...buildConnectOptions(connectionConfig, "long-lived")
+          waitOnFirstConnect: connectionConfig?.waitOnFirstConnect ?? true,
+          maxReconnectAttempts: connectionConfig?.maxReconnectAttempts ?? -1
         }).then((connection) => {
+          natsConnected = true;
           logger.debug(`[NATS] connected to ${url}`);
           return connection;
         }).catch((error) => {
           logger.error("[NATS] connection error", error);
+          natsConnected = false;
           natsConnectionPromise = null;
           throw error;
         });
@@ -821,20 +802,14 @@ var init_nats_publisher = __esm({
         }
       }
     };
-    connectNats = async () => {
-      await getNatsConnection();
-    };
-    isNatsConnected = async () => {
-      if (!natsConnectionPromise) return false;
-      try {
-        const nc = await natsConnectionPromise;
-        return !nc.isClosed() && !nc.isDraining();
-      } catch {
-        return false;
-      }
+    connectNats = () => {
+      getNatsConnection().catch(() => {
+      });
     };
+    isNatsConnected = () => natsConnected;
     __resetNatsPublisher = async () => {
       await closeConnection();
+      natsConnected = false;
       connectionConfig = void 0;
     };
     deriveSubjectFromType = (eventType, config) => {

package/dist/index.cjs

@@ -1367,49 +1367,6 @@ 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, {
@@ -1425,12 +1382,11 @@ __export(nats_publisher_exports, {
   publishNatsRawEvent: () => exports.publishNatsRawEvent,
   request: () => exports.request
 });
-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 sc, natsConnectionPromise, deriveSubjectFromEventType, connectionConfig; exports.configureNatsPublisher = void 0; var natsConnected, 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;
@@ -1445,17 +1401,21 @@ var init_nats_publisher = __esm({
     exports.configureNatsPublisher = (config) => {
       connectionConfig = config;
     };
+    natsConnected = false;
     getNatsConnection = async (servers) => {
       if (!natsConnectionPromise) {
         const url = servers ?? process.env.NATS_URL ?? "nats://localhost:4222";
         natsConnectionPromise = nats.connect({
           servers: url,
-          ...buildConnectOptions(connectionConfig, "long-lived")
+          waitOnFirstConnect: connectionConfig?.waitOnFirstConnect ?? true,
+          maxReconnectAttempts: connectionConfig?.maxReconnectAttempts ?? -1
         }).then((connection) => {
+          natsConnected = true;
           logger.debug(`[NATS] connected to ${url}`);
           return connection;
         }).catch((error) => {
           logger.error("[NATS] connection error", error);
+          natsConnected = false;
           natsConnectionPromise = null;
           throw error;
         });
@@ -1476,20 +1436,14 @@ var init_nats_publisher = __esm({
         }
       }
     };
-    exports.connectNats = async () => {
-      await getNatsConnection();
-    };
-    exports.isNatsConnected = async () => {
-      if (!natsConnectionPromise) return false;
-      try {
-        const nc = await natsConnectionPromise;
-        return !nc.isClosed() && !nc.isDraining();
-      } catch {
-        return false;
-      }
+    exports.connectNats = () => {
+      getNatsConnection().catch(() => {
+      });
     };
+    exports.isNatsConnected = () => natsConnected;
     exports.__resetNatsPublisher = async () => {
       await exports.closeConnection();
+      natsConnected = false;
       connectionConfig = void 0;
     };
     exports.deriveSubjectFromType = (eventType, config) => {
@@ -2234,7 +2188,7 @@ function cloudEvents(options = {}) {
 // package.json
 var package_default = {
   name: "@crossdelta/cloudevents",
-  version: "0.7.14",
+  version: "0.7.16",
   description: "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream & Core"};
 
 // src/plugin.ts
@@ -2467,13 +2421,47 @@ function createBaseMessageProcessor(deps) {
   };
 }
 
-// src/transports/nats/index.ts
-init_connection();
+// src/transports/nats/connection.ts
+var LONG_LIVED_DEFAULTS = {
+  waitOnFirstConnect: false,
+  maxReconnectAttempts: -1
+};
+var SHORT_LIVED_DEFAULTS = {
+  waitOnFirstConnect: true,
+  maxReconnectAttempts: 10
+};
+var 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
+  };
+};
+var CONNECTION_REGISTRY_KEY = "__crossdelta_nats_connections__";
+var getConnectionRegistry = () => {
+  if (!globalThis[CONNECTION_REGISTRY_KEY]) {
+    globalThis[CONNECTION_REGISTRY_KEY] = /* @__PURE__ */ new Map();
+  }
+  return globalThis[CONNECTION_REGISTRY_KEY];
+};
+var registerConnection = (name, connection) => {
+  getConnectionRegistry().set(name, connection);
+};
+var unregisterConnection = (name) => {
+  getConnectionRegistry().delete(name);
+};
+var 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/transports/nats/jetstream-consumer.ts
 init_domain();
 init_logging();
-init_connection();
 
 // src/transports/nats/jetstream-message-processor.ts
 var createJetStreamMessageProcessor = (deps) => {
@@ -2765,7 +2753,6 @@ 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) => {
@@ -2890,6 +2877,7 @@ exports.ensureJetStreams = ensureJetStreams;
 exports.eventSchema = eventSchema;
 exports.getDefaultIdempotencyStore = getDefaultIdempotencyStore;
 exports.handleEvent = handleEvent;
+exports.isConsumerConnected = isConsumerConnected;
 exports.listEvents = listEvents;
 exports.parseEventFromContext = parseEventFromContext;
 exports.publishEvent = publishEvent;

package/dist/index.d.cts

@@ -1299,7 +1299,7 @@ interface CloudEventsPfPluginOptions {
 declare const createPfPlugin: (options?: CloudEventsPfPluginOptions) => PfPlugin;
 
 interface NatsConnectionConfig {
-    /** Retry the initial connection instead of failing immediately. @default true */
+    /** Retry the initial connection instead of failing immediately. @default false */
     waitOnFirstConnect?: boolean;
     /** Maximum reconnect attempts (-1 = unlimited). @default -1 */
     maxReconnectAttempts?: number;
@@ -1336,14 +1336,16 @@ declare const configureNatsPublisher: (config: NatsConnectionConfig) => void;
  */
 declare const closeConnection: () => Promise<void>;
 /**
- * Eagerly establishes the NATS connection. Call this on application startup
- * so that `isNatsConnected()` reflects real connectivity from the first probe.
+ * Starts the NATS connection in the background (fire-and-forget).
+ * Does NOT block — nats.js retries internally via `waitOnFirstConnect: true`.
+ * Call on startup so `isNatsConnected()` reflects connectivity once established.
  */
-declare const connectNats: () => Promise<void>;
+declare const connectNats: () => void;
 /**
  * Returns true if a NATS connection is currently established and healthy.
+ * Non-blocking — checks a flag set when `connect()` resolves.
  */
-declare const isNatsConnected: () => Promise<boolean>;
+declare const isNatsConnected: () => boolean;
 /**
  * Reset publisher state (for testing only)
  * @internal

package/dist/index.d.ts

@@ -1299,7 +1299,7 @@ interface CloudEventsPfPluginOptions {
 declare const createPfPlugin: (options?: CloudEventsPfPluginOptions) => PfPlugin;
 
 interface NatsConnectionConfig {
-    /** Retry the initial connection instead of failing immediately. @default true */
+    /** Retry the initial connection instead of failing immediately. @default false */
     waitOnFirstConnect?: boolean;
     /** Maximum reconnect attempts (-1 = unlimited). @default -1 */
     maxReconnectAttempts?: number;
@@ -1336,14 +1336,16 @@ declare const configureNatsPublisher: (config: NatsConnectionConfig) => void;
  */
 declare const closeConnection: () => Promise<void>;
 /**
- * Eagerly establishes the NATS connection. Call this on application startup
- * so that `isNatsConnected()` reflects real connectivity from the first probe.
+ * Starts the NATS connection in the background (fire-and-forget).
+ * Does NOT block — nats.js retries internally via `waitOnFirstConnect: true`.
+ * Call on startup so `isNatsConnected()` reflects connectivity once established.
  */
-declare const connectNats: () => Promise<void>;
+declare const connectNats: () => void;
 /**
  * Returns true if a NATS connection is currently established and healthy.
+ * Non-blocking — checks a flag set when `connect()` resolves.
  */
-declare const isNatsConnected: () => Promise<boolean>;
+declare const isNatsConnected: () => boolean;
 /**
  * Reset publisher state (for testing only)
  * @internal

package/dist/index.js

@@ -1342,49 +1342,6 @@ 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, {
@@ -1400,12 +1357,11 @@ __export(nats_publisher_exports, {
   publishNatsRawEvent: () => publishNatsRawEvent,
   request: () => request
 });
-var sc, natsConnectionPromise, deriveSubjectFromEventType, connectionConfig, configureNatsPublisher, getNatsConnection, closeConnection, connectNats, isNatsConnected, __resetNatsPublisher, deriveSubjectFromType, deriveStreamFromType, publishNatsRawEvent, publishNatsEvent, publish, DEFAULT_REQUEST_TIMEOUT, request;
+var sc, natsConnectionPromise, deriveSubjectFromEventType, connectionConfig, configureNatsPublisher, natsConnected, 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;
@@ -1420,17 +1376,21 @@ var init_nats_publisher = __esm({
     configureNatsPublisher = (config) => {
       connectionConfig = config;
     };
+    natsConnected = false;
     getNatsConnection = async (servers) => {
       if (!natsConnectionPromise) {
         const url = servers ?? process.env.NATS_URL ?? "nats://localhost:4222";
         natsConnectionPromise = connect({
           servers: url,
-          ...buildConnectOptions(connectionConfig, "long-lived")
+          waitOnFirstConnect: connectionConfig?.waitOnFirstConnect ?? true,
+          maxReconnectAttempts: connectionConfig?.maxReconnectAttempts ?? -1
         }).then((connection) => {
+          natsConnected = true;
           logger.debug(`[NATS] connected to ${url}`);
           return connection;
         }).catch((error) => {
           logger.error("[NATS] connection error", error);
+          natsConnected = false;
           natsConnectionPromise = null;
           throw error;
         });
@@ -1451,20 +1411,14 @@ var init_nats_publisher = __esm({
         }
       }
     };
-    connectNats = async () => {
-      await getNatsConnection();
-    };
-    isNatsConnected = async () => {
-      if (!natsConnectionPromise) return false;
-      try {
-        const nc = await natsConnectionPromise;
-        return !nc.isClosed() && !nc.isDraining();
-      } catch {
-        return false;
-      }
+    connectNats = () => {
+      getNatsConnection().catch(() => {
+      });
     };
+    isNatsConnected = () => natsConnected;
     __resetNatsPublisher = async () => {
       await closeConnection();
+      natsConnected = false;
       connectionConfig = void 0;
     };
     deriveSubjectFromType = (eventType, config) => {
@@ -2209,7 +2163,7 @@ function cloudEvents(options = {}) {
 // package.json
 var package_default = {
   name: "@crossdelta/cloudevents",
-  version: "0.7.14",
+  version: "0.7.16",
   description: "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream & Core"};
 
 // src/plugin.ts
@@ -2442,13 +2396,47 @@ function createBaseMessageProcessor(deps) {
   };
 }
 
-// src/transports/nats/index.ts
-init_connection();
+// src/transports/nats/connection.ts
+var LONG_LIVED_DEFAULTS = {
+  waitOnFirstConnect: false,
+  maxReconnectAttempts: -1
+};
+var SHORT_LIVED_DEFAULTS = {
+  waitOnFirstConnect: true,
+  maxReconnectAttempts: 10
+};
+var 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
+  };
+};
+var CONNECTION_REGISTRY_KEY = "__crossdelta_nats_connections__";
+var getConnectionRegistry = () => {
+  if (!globalThis[CONNECTION_REGISTRY_KEY]) {
+    globalThis[CONNECTION_REGISTRY_KEY] = /* @__PURE__ */ new Map();
+  }
+  return globalThis[CONNECTION_REGISTRY_KEY];
+};
+var registerConnection = (name, connection) => {
+  getConnectionRegistry().set(name, connection);
+};
+var unregisterConnection = (name) => {
+  getConnectionRegistry().delete(name);
+};
+var 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/transports/nats/jetstream-consumer.ts
 init_domain();
 init_logging();
-init_connection();
 
 // src/transports/nats/jetstream-message-processor.ts
 var createJetStreamMessageProcessor = (deps) => {
@@ -2740,7 +2728,6 @@ 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) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossdelta/cloudevents",
-  "version": "0.7.14",
+  "version": "0.7.16",
   "description": "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream & Core",
   "author": "crossdelta",
   "license": "MIT",