@crossdelta/cloudevents 0.6.5 → 0.6.7

package/bin/cli.js

@@ -734,6 +734,7 @@ var nats_publisher_exports = {};
 __export(nats_publisher_exports, {
   __resetNatsPublisher: () => __resetNatsPublisher,
   closeConnection: () => closeConnection,
+  connectNats: () => connectNats,
   deriveStreamFromType: () => deriveStreamFromType,
   deriveSubjectFromType: () => deriveSubjectFromType,
   isNatsConnected: () => isNatsConnected,
@@ -741,7 +742,7 @@ __export(nats_publisher_exports, {
   publishNatsEvent: () => publishNatsEvent,
   publishNatsRawEvent: () => publishNatsRawEvent
 });
-var sc, natsConnectionPromise, deriveSubjectFromEventType, getNatsConnection, closeConnection, isNatsConnected, __resetNatsPublisher, deriveSubjectFromType, deriveStreamFromType, publishNatsRawEvent, publishNatsEvent, publish;
+var sc, natsConnectionPromise, deriveSubjectFromEventType, getNatsConnection, closeConnection, connectNats, isNatsConnected, __resetNatsPublisher, deriveSubjectFromType, deriveStreamFromType, publishNatsRawEvent, publishNatsEvent, publish;
 var init_nats_publisher = __esm({
   "src/publishing/nats.publisher.ts"() {
     init_domain();
@@ -785,9 +786,13 @@ var init_nats_publisher = __esm({
         }
       }
     };
+    connectNats = async () => {
+      await getNatsConnection();
+    };
     isNatsConnected = async () => {
+      if (!natsConnectionPromise) return false;
       try {
-        const nc = await getNatsConnection();
+        const nc = await natsConnectionPromise;
         return !nc.isClosed() && !nc.isDraining();
       } catch {
         return false;

package/dist/index.cjs

@@ -1383,6 +1383,7 @@ var nats_publisher_exports = {};
 __export(nats_publisher_exports, {
   __resetNatsPublisher: () => exports.__resetNatsPublisher,
   closeConnection: () => exports.closeConnection,
+  connectNats: () => exports.connectNats,
   deriveStreamFromType: () => exports.deriveStreamFromType,
   deriveSubjectFromType: () => exports.deriveSubjectFromType,
   isNatsConnected: () => exports.isNatsConnected,
@@ -1390,7 +1391,7 @@ __export(nats_publisher_exports, {
   publishNatsEvent: () => exports.publishNatsEvent,
   publishNatsRawEvent: () => exports.publishNatsRawEvent
 });
-var sc, natsConnectionPromise, deriveSubjectFromEventType, getNatsConnection; exports.closeConnection = 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 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 init_nats_publisher = __esm({
   "src/publishing/nats.publisher.ts"() {
     init_domain();
@@ -1434,9 +1435,13 @@ var init_nats_publisher = __esm({
         }
       }
     };
+    exports.connectNats = async () => {
+      await getNatsConnection();
+    };
     exports.isNatsConnected = async () => {
+      if (!natsConnectionPromise) return false;
       try {
-        const nc = await getNatsConnection();
+        const nc = await natsConnectionPromise;
         return !nc.isClosed() && !nc.isDraining();
       } catch {
         return false;
@@ -2163,7 +2168,7 @@ function cloudEvents(options = {}) {
 // package.json
 var package_default = {
   name: "@crossdelta/cloudevents",
-  version: "0.6.5",
+  version: "0.6.7",
   description: "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream"};
 
 // src/plugin.ts

package/dist/index.d.cts

@@ -1208,9 +1208,12 @@ interface PublishNatsEventOptions {
  */
 declare const closeConnection: () => Promise<void>;
 /**
- * Returns true if NATS is reachable and the connection is not closed/draining.
- * Will attempt to establish a connection if none exists yet.
- * Suitable for use in readiness health checks.
+ * Eagerly establishes the NATS connection. Call this on application startup
+ * so that `isNatsConnected()` reflects real connectivity from the first probe.
+ */
+declare const connectNats: () => Promise<void>;
+/**
+ * Returns true if a NATS connection is currently established and healthy.
  */
 declare const isNatsConnected: () => Promise<boolean>;
 /**
@@ -1498,4 +1501,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 PublishEventContext, type PublishEventOptions, type PublishNatsEventOptions, type RoutingConfig, type SchemaField, type StreamConfig, type StreamDefinition, type StreamWiredEffect, __resetNatsPublisher, checkAndMarkProcessed, clearHandlerCache, closeConnection, cloudEvents, 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, 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 PublishEventContext, type PublishEventOptions, type PublishNatsEventOptions, 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, resetDefaultIdempotencyStore, singularize, streamWired, toKebabCase, toPascalCase, validateEventType };

package/dist/index.d.ts

@@ -1208,9 +1208,12 @@ interface PublishNatsEventOptions {
  */
 declare const closeConnection: () => Promise<void>;
 /**
- * Returns true if NATS is reachable and the connection is not closed/draining.
- * Will attempt to establish a connection if none exists yet.
- * Suitable for use in readiness health checks.
+ * Eagerly establishes the NATS connection. Call this on application startup
+ * so that `isNatsConnected()` reflects real connectivity from the first probe.
+ */
+declare const connectNats: () => Promise<void>;
+/**
+ * Returns true if a NATS connection is currently established and healthy.
  */
 declare const isNatsConnected: () => Promise<boolean>;
 /**
@@ -1498,4 +1501,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 PublishEventContext, type PublishEventOptions, type PublishNatsEventOptions, type RoutingConfig, type SchemaField, type StreamConfig, type StreamDefinition, type StreamWiredEffect, __resetNatsPublisher, checkAndMarkProcessed, clearHandlerCache, closeConnection, cloudEvents, 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, 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 PublishEventContext, type PublishEventOptions, type PublishNatsEventOptions, 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, resetDefaultIdempotencyStore, singularize, streamWired, toKebabCase, toPascalCase, validateEventType };

package/dist/index.js

@@ -1358,6 +1358,7 @@ var nats_publisher_exports = {};
 __export(nats_publisher_exports, {
   __resetNatsPublisher: () => __resetNatsPublisher,
   closeConnection: () => closeConnection,
+  connectNats: () => connectNats,
   deriveStreamFromType: () => deriveStreamFromType,
   deriveSubjectFromType: () => deriveSubjectFromType,
   isNatsConnected: () => isNatsConnected,
@@ -1365,7 +1366,7 @@ __export(nats_publisher_exports, {
   publishNatsEvent: () => publishNatsEvent,
   publishNatsRawEvent: () => publishNatsRawEvent
 });
-var sc, natsConnectionPromise, deriveSubjectFromEventType, getNatsConnection, closeConnection, isNatsConnected, __resetNatsPublisher, deriveSubjectFromType, deriveStreamFromType, publishNatsRawEvent, publishNatsEvent, publish;
+var sc, natsConnectionPromise, deriveSubjectFromEventType, getNatsConnection, closeConnection, connectNats, isNatsConnected, __resetNatsPublisher, deriveSubjectFromType, deriveStreamFromType, publishNatsRawEvent, publishNatsEvent, publish;
 var init_nats_publisher = __esm({
   "src/publishing/nats.publisher.ts"() {
     init_domain();
@@ -1409,9 +1410,13 @@ var init_nats_publisher = __esm({
         }
       }
     };
+    connectNats = async () => {
+      await getNatsConnection();
+    };
     isNatsConnected = async () => {
+      if (!natsConnectionPromise) return false;
       try {
-        const nc = await getNatsConnection();
+        const nc = await natsConnectionPromise;
         return !nc.isClosed() && !nc.isDraining();
       } catch {
         return false;
@@ -2138,7 +2143,7 @@ function cloudEvents(options = {}) {
 // package.json
 var package_default = {
   name: "@crossdelta/cloudevents",
-  version: "0.6.5",
+  version: "0.6.7",
   description: "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream"};
 
 // src/plugin.ts
@@ -2750,4 +2755,4 @@ async function consumeNatsEvents(options) {
 // src/index.ts
 init_utils();
 
-export { __resetNatsPublisher, checkAndMarkProcessed, clearHandlerCache, closeConnection, cloudEvents, 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, resetDefaultIdempotencyStore, singularize, streamWired, toKebabCase, toPascalCase, validateEventType };
+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, resetDefaultIdempotencyStore, singularize, streamWired, toKebabCase, toPascalCase, validateEventType };

package/package.json

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