@crossdelta/cloudevents 0.6.8 → 0.7.2

package/README.md

@@ -192,9 +192,16 @@ consumeJetStreams({
 
 // Core NATS — fire-and-forget, simpler
 await consumeNatsEvents({
-  subjects: ['notifications.*'],
+  subject: 'notifications.*',
+  consumerName: 'my-service',
   discover: './src/events/**/*.handler.ts',
 })
+
+// NATS Core Request-Reply — synchronous validation feedback
+// Consumer returns result, publisher awaits it
+import { request } from '@crossdelta/cloudevents'
+const result = await request('call.received', payload)
+// result: { accepted: true, data: { ... } } | { accepted: false, error: '...' }
 ```
 
 ---
@@ -555,7 +562,8 @@ app.use('/events', cloudEvents({ discover: 'src/events/**/*.handler.ts' }))
 | `ensureJetStreams(options)` | Create/update JetStream streams |
 | `consumeJetStreams(options)` | Consume from multiple streams |
 | `consumeNatsEvents(options)` | Consume fire-and-forget |
-| `publish(type, data)` | Publish event |
+| `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) |
 | `closeConnection()` | Drain and close the NATS connection (for CLI tools) |
 ---

package/bin/cli.js

@@ -740,9 +740,10 @@ __export(nats_publisher_exports, {
   isNatsConnected: () => isNatsConnected,
   publish: () => publish,
   publishNatsEvent: () => publishNatsEvent,
-  publishNatsRawEvent: () => publishNatsRawEvent
+  publishNatsRawEvent: () => publishNatsRawEvent,
+  request: () => request
 });
-var sc, natsConnectionPromise, deriveSubjectFromEventType, getNatsConnection, closeConnection, connectNats, isNatsConnected, __resetNatsPublisher, deriveSubjectFromType, deriveStreamFromType, publishNatsRawEvent, publishNatsEvent, publish;
+var sc, natsConnectionPromise, deriveSubjectFromEventType, 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();
@@ -874,6 +875,30 @@ var init_nats_publisher = __esm({
       const natsSubject = typeof eventTypeOrContract === "string" ? deriveSubjectFromEventType(eventTypeOrContract) : eventTypeOrContract.channel?.subject ?? eventTypeOrContract.type;
       return publishNatsRawEvent(natsSubject, eventType, eventData, options);
     };
+    DEFAULT_REQUEST_TIMEOUT = 1e4;
+    request = async (eventTypeOrContract, eventData, options) => {
+      const eventType = typeof eventTypeOrContract === "string" ? eventTypeOrContract : eventTypeOrContract.type;
+      const natsSubject = typeof eventTypeOrContract === "string" ? deriveSubjectFromEventType(eventTypeOrContract) : eventTypeOrContract.channel?.subject ?? eventTypeOrContract.type;
+      const cloudEvent = {
+        specversion: "1.0",
+        type: eventType,
+        source: options?.source || "api-gateway",
+        id: crypto.randomUUID(),
+        time: (/* @__PURE__ */ new Date()).toISOString(),
+        datacontenttype: "application/json",
+        data: eventData,
+        ...options?.subject && { subject: options.subject },
+        ...options?.tenantId && { tenantid: options.tenantId }
+      };
+      const data = JSON.stringify(cloudEvent);
+      const nc = await getNatsConnection(options?.servers);
+      const msg = await nc.request(natsSubject, sc.encode(data), {
+        timeout: options?.timeout ?? DEFAULT_REQUEST_TIMEOUT
+      });
+      logger.debug(`Request-Reply for ${eventType} on ${natsSubject} (id=${cloudEvent.id})`);
+      const responseJson = sc.decode(msg.data);
+      return JSON.parse(responseJson);
+    };
   }
 });
 

package/dist/index.cjs

@@ -1350,7 +1350,7 @@ function handleEvent(schemaOrOptions, handler, eventType) {
       safeParse
     };
     async handle(payload, context) {
-      await Promise.resolve(handler(payload, context));
+      return await Promise.resolve(handler(payload, context));
     }
   };
   Object.defineProperty(HandlerClass, "name", {
@@ -1389,9 +1389,10 @@ __export(nats_publisher_exports, {
   isNatsConnected: () => exports.isNatsConnected,
   publish: () => exports.publish,
   publishNatsEvent: () => exports.publishNatsEvent,
-  publishNatsRawEvent: () => exports.publishNatsRawEvent
+  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 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 init_nats_publisher = __esm({
   "src/publishing/nats.publisher.ts"() {
     init_domain();
@@ -1523,6 +1524,30 @@ var init_nats_publisher = __esm({
       const natsSubject = typeof eventTypeOrContract === "string" ? deriveSubjectFromEventType(eventTypeOrContract) : eventTypeOrContract.channel?.subject ?? eventTypeOrContract.type;
       return exports.publishNatsRawEvent(natsSubject, eventType, eventData, options);
     };
+    DEFAULT_REQUEST_TIMEOUT = 1e4;
+    exports.request = async (eventTypeOrContract, eventData, options) => {
+      const eventType = typeof eventTypeOrContract === "string" ? eventTypeOrContract : eventTypeOrContract.type;
+      const natsSubject = typeof eventTypeOrContract === "string" ? deriveSubjectFromEventType(eventTypeOrContract) : eventTypeOrContract.channel?.subject ?? eventTypeOrContract.type;
+      const cloudEvent = {
+        specversion: "1.0",
+        type: eventType,
+        source: options?.source || "api-gateway",
+        id: crypto.randomUUID(),
+        time: (/* @__PURE__ */ new Date()).toISOString(),
+        datacontenttype: "application/json",
+        data: eventData,
+        ...options?.subject && { subject: options.subject },
+        ...options?.tenantId && { tenantid: options.tenantId }
+      };
+      const data = JSON.stringify(cloudEvent);
+      const nc = await getNatsConnection(options?.servers);
+      const msg = await nc.request(natsSubject, sc.encode(data), {
+        timeout: options?.timeout ?? DEFAULT_REQUEST_TIMEOUT
+      });
+      logger.debug(`Request-Reply for ${eventType} on ${natsSubject} (id=${cloudEvent.id})`);
+      const responseJson = sc.decode(msg.data);
+      return JSON.parse(responseJson);
+    };
   }
 });
 
@@ -1870,7 +1895,7 @@ var processHandler = (HandlerClass) => {
     name: HandlerClass.name,
     schema: metadata.schema,
     handle: async (payload, context) => {
-      await Promise.resolve(instance.handle(payload, context));
+      return await Promise.resolve(instance.handle(payload, context));
     },
     match: metadata.match,
     safeParse: metadata.safeParse || false
@@ -2168,8 +2193,8 @@ function cloudEvents(options = {}) {
 // package.json
 var package_default = {
   name: "@crossdelta/cloudevents",
-  version: "0.6.8",
-  description: "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream"};
+  version: "0.7.2",
+  description: "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream & Core"};
 
 // src/plugin.ts
 var createAddCommand = (config) => ({
@@ -2344,8 +2369,8 @@ function createBaseMessageProcessor(deps) {
   };
   const executeHandler2 = async (handler, enriched, context) => {
     try {
-      await handler.handle(enriched.data, enriched);
-      return { success: true };
+      const result = await handler.handle(enriched.data, enriched);
+      return { success: true, result };
     } catch (error) {
       if (dlqEnabled) {
         await publishRecoverableError(context, error, options);
@@ -2359,15 +2384,15 @@ function createBaseMessageProcessor(deps) {
     const handler = findHandler(enriched);
     if (!handler) {
       const result2 = await handleMissingHandler(context, enriched.eventType);
-      return result2.shouldAck;
+      return { shouldAck: result2.shouldAck };
     }
     const validationResult = validateEventData(handler, enriched.data);
     if ("error" in validationResult) {
       const result2 = await handleValidationFailure(validationResult, handler, context);
-      return result2.shouldAck;
+      return { shouldAck: result2.shouldAck };
     }
     const result = await executeHandler2(handler, enriched, context);
-    return result.success;
+    return { shouldAck: result.success, result: result.result };
   };
   const handleParseError = async (error, context, redeliveryCount = 0) => {
     logger2.error(`[${name}] failed to parse CloudEvent (attempt ${redeliveryCount + 1})`, error);
@@ -2419,7 +2444,8 @@ var createJetStreamMessageProcessor = (deps) => {
     try {
       const cloudEvent = base.parseCloudEvent(msg.data);
       const enriched = base.toEnrichedEvent(cloudEvent);
-      return base.processEvent(cloudEvent, enriched);
+      const { shouldAck } = await base.processEvent(cloudEvent, enriched);
+      return shouldAck;
     } catch (error) {
       const unknownCtx = toUnknownContext(msg);
       const context = createProcessingContext("unknown", decode(msg.data), unknownCtx, void 0);
@@ -2686,8 +2712,14 @@ var consumeJetStreams = consumeJetStreamStreams;
 // src/transports/nats/nats-consumer.ts
 init_domain();
 init_logging();
-
-// src/transports/nats/nats-message-processor.ts
+var sc3 = nats.StringCodec();
+var isRequestMessage = (msg) => Boolean(msg.reply);
+var sendReply = (msg, payload) => {
+  if (isRequestMessage(msg)) {
+    msg.respond(sc3.encode(JSON.stringify(payload)));
+  }
+};
+var isStructuredReply = (value) => value != null && typeof value === "object" && "accepted" in value;
 var createNatsMessageProcessor = (deps) => {
   const { subject, decode } = deps;
   const base = createBaseMessageProcessor(deps);
@@ -2703,14 +2735,18 @@ var createNatsMessageProcessor = (deps) => {
     try {
       const cloudEvent = base.parseCloudEvent(msg.data);
       const enriched = base.toEnrichedEvent(cloudEvent);
-      await base.processEvent(cloudEvent, enriched);
+      const { result } = await base.processEvent(cloudEvent, enriched);
+      const reply = isStructuredReply(result) ? result : { accepted: true, ...result != null ? { data: result } : {} };
+      sendReply(msg, reply);
     } catch (error) {
+      sendReply(msg, { accepted: false, error: error instanceof Error ? error.message : "Processing failed" });
       const unknownCtx = toUnknownContext(msg);
       const context = createProcessingContext("unknown", decode(msg.data), unknownCtx, void 0);
       await base.handleParseError(error, context);
     }
   };
   const handleUnhandledProcessingError = async (msg, error) => {
+    sendReply(msg, { accepted: false, error: error instanceof Error ? error.message : "Unhandled error" });
     const unknownCtx = toUnknownContext(msg);
     const context = createProcessingContext("unknown", decode(msg.data), unknownCtx, void 0);
     await base.handleUnhandledError(error, context);
@@ -2719,7 +2755,7 @@ var createNatsMessageProcessor = (deps) => {
 };
 
 // src/transports/nats/nats-consumer.ts
-var sc3 = nats.StringCodec();
+var sc4 = nats.StringCodec();
 var CONSUMER_REGISTRY_KEY = "__crossdelta_nats_consumers__";
 function getConsumerRegistry() {
   if (!globalThis[CONSUMER_REGISTRY_KEY]) {
@@ -2763,7 +2799,7 @@ async function consumeNatsEvents(options) {
     dlqEnabled,
     options,
     processedHandlers,
-    decode: (data) => sc3.decode(data),
+    decode: (data) => sc4.decode(data),
     logger
   });
   const processSubscription = async () => {

package/dist/index.d.cts

@@ -406,7 +406,7 @@ declare const publishEvent: (eventType: string, data: Record<string, unknown>, o
  * Event handler interface
  */
 interface EventHandler<T = unknown> {
-    handle(payload: T, context?: unknown): Promise<void> | void;
+    handle(payload: T, context?: unknown): Promise<unknown> | unknown;
 }
 /**
  * Constructor type for event handler classes that implement the EventHandler interface
@@ -593,7 +593,7 @@ declare function createContract<TSchema extends ZodTypeAny>(options: {
  * })
  * ```
  */
-declare function handleEvent<TSchema extends ZodTypeAny>(schemaOrOptions: TSchema | HandleEventOptions<TSchema> | HandleEventOptions, handler: (payload: TSchema['_output'], context?: EventContext) => Promise<void> | void, eventType?: string): HandlerConstructor;
+declare function handleEvent<TSchema extends ZodTypeAny>(schemaOrOptions: TSchema | HandleEventOptions<TSchema> | HandleEventOptions, handler: (payload: TSchema['_output'], context?: EventContext) => Promise<unknown> | unknown, eventType?: string): HandlerConstructor;
 /**
  * Creates an event schema with type inference
  * Automatically enforces the presence of a 'type' field
@@ -1297,6 +1297,14 @@ interface CloudEventsPfPluginOptions {
 }
 declare const createPfPlugin: (options?: CloudEventsPfPluginOptions) => PfPlugin;
 
+interface RequestNatsEventOptions {
+    servers?: string;
+    source?: string;
+    subject?: string;
+    tenantId?: string;
+    /** Timeout in milliseconds for the request (default: 10000) */
+    timeout?: number;
+}
 interface PublishNatsEventOptions {
     servers?: string;
     source?: string;
@@ -1333,6 +1341,25 @@ declare const publish: (eventTypeOrContract: string | {
         subject?: string;
     };
 }, eventData: unknown, options?: PublishNatsEventOptions) => Promise<string>;
+interface NatsRequestResponse<T = unknown> {
+    accepted: boolean;
+    data?: T;
+    error?: string;
+    [key: string]: unknown;
+}
+/**
+ * Publish a CloudEvent via NATS Request-Reply and wait for the consumer's response.
+ *
+ * The subscriber is expected to call `msg.respond()` with a JSON-encoded
+ * `NatsRequestResponse`. If no subscriber replies within the timeout the
+ * returned promise rejects.
+ */
+declare const request: <T = unknown>(eventTypeOrContract: string | {
+    type: string;
+    channel?: {
+        subject?: string;
+    };
+}, eventData: unknown, options?: RequestNatsEventOptions) => Promise<NatsRequestResponse<T>>;
 
 interface PublishEventOptions {
     projectId?: string;
@@ -1603,4 +1630,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, 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 };
+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 };

package/dist/index.d.ts

@@ -406,7 +406,7 @@ declare const publishEvent: (eventType: string, data: Record<string, unknown>, o
  * Event handler interface
  */
 interface EventHandler<T = unknown> {
-    handle(payload: T, context?: unknown): Promise<void> | void;
+    handle(payload: T, context?: unknown): Promise<unknown> | unknown;
 }
 /**
  * Constructor type for event handler classes that implement the EventHandler interface
@@ -593,7 +593,7 @@ declare function createContract<TSchema extends ZodTypeAny>(options: {
  * })
  * ```
  */
-declare function handleEvent<TSchema extends ZodTypeAny>(schemaOrOptions: TSchema | HandleEventOptions<TSchema> | HandleEventOptions, handler: (payload: TSchema['_output'], context?: EventContext) => Promise<void> | void, eventType?: string): HandlerConstructor;
+declare function handleEvent<TSchema extends ZodTypeAny>(schemaOrOptions: TSchema | HandleEventOptions<TSchema> | HandleEventOptions, handler: (payload: TSchema['_output'], context?: EventContext) => Promise<unknown> | unknown, eventType?: string): HandlerConstructor;
 /**
  * Creates an event schema with type inference
  * Automatically enforces the presence of a 'type' field
@@ -1297,6 +1297,14 @@ interface CloudEventsPfPluginOptions {
 }
 declare const createPfPlugin: (options?: CloudEventsPfPluginOptions) => PfPlugin;
 
+interface RequestNatsEventOptions {
+    servers?: string;
+    source?: string;
+    subject?: string;
+    tenantId?: string;
+    /** Timeout in milliseconds for the request (default: 10000) */
+    timeout?: number;
+}
 interface PublishNatsEventOptions {
     servers?: string;
     source?: string;
@@ -1333,6 +1341,25 @@ declare const publish: (eventTypeOrContract: string | {
         subject?: string;
     };
 }, eventData: unknown, options?: PublishNatsEventOptions) => Promise<string>;
+interface NatsRequestResponse<T = unknown> {
+    accepted: boolean;
+    data?: T;
+    error?: string;
+    [key: string]: unknown;
+}
+/**
+ * Publish a CloudEvent via NATS Request-Reply and wait for the consumer's response.
+ *
+ * The subscriber is expected to call `msg.respond()` with a JSON-encoded
+ * `NatsRequestResponse`. If no subscriber replies within the timeout the
+ * returned promise rejects.
+ */
+declare const request: <T = unknown>(eventTypeOrContract: string | {
+    type: string;
+    channel?: {
+        subject?: string;
+    };
+}, eventData: unknown, options?: RequestNatsEventOptions) => Promise<NatsRequestResponse<T>>;
 
 interface PublishEventOptions {
     projectId?: string;
@@ -1603,4 +1630,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, 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 };
+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 };

package/dist/index.js

@@ -1325,7 +1325,7 @@ function handleEvent(schemaOrOptions, handler, eventType) {
       safeParse
     };
     async handle(payload, context) {
-      await Promise.resolve(handler(payload, context));
+      return await Promise.resolve(handler(payload, context));
     }
   };
   Object.defineProperty(HandlerClass, "name", {
@@ -1364,9 +1364,10 @@ __export(nats_publisher_exports, {
   isNatsConnected: () => isNatsConnected,
   publish: () => publish,
   publishNatsEvent: () => publishNatsEvent,
-  publishNatsRawEvent: () => publishNatsRawEvent
+  publishNatsRawEvent: () => publishNatsRawEvent,
+  request: () => request
 });
-var sc, natsConnectionPromise, deriveSubjectFromEventType, getNatsConnection, closeConnection, connectNats, isNatsConnected, __resetNatsPublisher, deriveSubjectFromType, deriveStreamFromType, publishNatsRawEvent, publishNatsEvent, publish;
+var sc, natsConnectionPromise, deriveSubjectFromEventType, 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();
@@ -1498,6 +1499,30 @@ var init_nats_publisher = __esm({
       const natsSubject = typeof eventTypeOrContract === "string" ? deriveSubjectFromEventType(eventTypeOrContract) : eventTypeOrContract.channel?.subject ?? eventTypeOrContract.type;
       return publishNatsRawEvent(natsSubject, eventType, eventData, options);
     };
+    DEFAULT_REQUEST_TIMEOUT = 1e4;
+    request = async (eventTypeOrContract, eventData, options) => {
+      const eventType = typeof eventTypeOrContract === "string" ? eventTypeOrContract : eventTypeOrContract.type;
+      const natsSubject = typeof eventTypeOrContract === "string" ? deriveSubjectFromEventType(eventTypeOrContract) : eventTypeOrContract.channel?.subject ?? eventTypeOrContract.type;
+      const cloudEvent = {
+        specversion: "1.0",
+        type: eventType,
+        source: options?.source || "api-gateway",
+        id: crypto.randomUUID(),
+        time: (/* @__PURE__ */ new Date()).toISOString(),
+        datacontenttype: "application/json",
+        data: eventData,
+        ...options?.subject && { subject: options.subject },
+        ...options?.tenantId && { tenantid: options.tenantId }
+      };
+      const data = JSON.stringify(cloudEvent);
+      const nc = await getNatsConnection(options?.servers);
+      const msg = await nc.request(natsSubject, sc.encode(data), {
+        timeout: options?.timeout ?? DEFAULT_REQUEST_TIMEOUT
+      });
+      logger.debug(`Request-Reply for ${eventType} on ${natsSubject} (id=${cloudEvent.id})`);
+      const responseJson = sc.decode(msg.data);
+      return JSON.parse(responseJson);
+    };
   }
 });
 
@@ -1845,7 +1870,7 @@ var processHandler = (HandlerClass) => {
     name: HandlerClass.name,
     schema: metadata.schema,
     handle: async (payload, context) => {
-      await Promise.resolve(instance.handle(payload, context));
+      return await Promise.resolve(instance.handle(payload, context));
     },
     match: metadata.match,
     safeParse: metadata.safeParse || false
@@ -2143,8 +2168,8 @@ function cloudEvents(options = {}) {
 // package.json
 var package_default = {
   name: "@crossdelta/cloudevents",
-  version: "0.6.8",
-  description: "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream"};
+  version: "0.7.2",
+  description: "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream & Core"};
 
 // src/plugin.ts
 var createAddCommand = (config) => ({
@@ -2319,8 +2344,8 @@ function createBaseMessageProcessor(deps) {
   };
   const executeHandler2 = async (handler, enriched, context) => {
     try {
-      await handler.handle(enriched.data, enriched);
-      return { success: true };
+      const result = await handler.handle(enriched.data, enriched);
+      return { success: true, result };
     } catch (error) {
       if (dlqEnabled) {
         await publishRecoverableError(context, error, options);
@@ -2334,15 +2359,15 @@ function createBaseMessageProcessor(deps) {
     const handler = findHandler(enriched);
     if (!handler) {
       const result2 = await handleMissingHandler(context, enriched.eventType);
-      return result2.shouldAck;
+      return { shouldAck: result2.shouldAck };
     }
     const validationResult = validateEventData(handler, enriched.data);
     if ("error" in validationResult) {
       const result2 = await handleValidationFailure(validationResult, handler, context);
-      return result2.shouldAck;
+      return { shouldAck: result2.shouldAck };
     }
     const result = await executeHandler2(handler, enriched, context);
-    return result.success;
+    return { shouldAck: result.success, result: result.result };
   };
   const handleParseError = async (error, context, redeliveryCount = 0) => {
     logger2.error(`[${name}] failed to parse CloudEvent (attempt ${redeliveryCount + 1})`, error);
@@ -2394,7 +2419,8 @@ var createJetStreamMessageProcessor = (deps) => {
     try {
       const cloudEvent = base.parseCloudEvent(msg.data);
       const enriched = base.toEnrichedEvent(cloudEvent);
-      return base.processEvent(cloudEvent, enriched);
+      const { shouldAck } = await base.processEvent(cloudEvent, enriched);
+      return shouldAck;
     } catch (error) {
       const unknownCtx = toUnknownContext(msg);
       const context = createProcessingContext("unknown", decode(msg.data), unknownCtx, void 0);
@@ -2661,8 +2687,14 @@ var consumeJetStreams = consumeJetStreamStreams;
 // src/transports/nats/nats-consumer.ts
 init_domain();
 init_logging();
-
-// src/transports/nats/nats-message-processor.ts
+var sc3 = StringCodec();
+var isRequestMessage = (msg) => Boolean(msg.reply);
+var sendReply = (msg, payload) => {
+  if (isRequestMessage(msg)) {
+    msg.respond(sc3.encode(JSON.stringify(payload)));
+  }
+};
+var isStructuredReply = (value) => value != null && typeof value === "object" && "accepted" in value;
 var createNatsMessageProcessor = (deps) => {
   const { subject, decode } = deps;
   const base = createBaseMessageProcessor(deps);
@@ -2678,14 +2710,18 @@ var createNatsMessageProcessor = (deps) => {
     try {
       const cloudEvent = base.parseCloudEvent(msg.data);
       const enriched = base.toEnrichedEvent(cloudEvent);
-      await base.processEvent(cloudEvent, enriched);
+      const { result } = await base.processEvent(cloudEvent, enriched);
+      const reply = isStructuredReply(result) ? result : { accepted: true, ...result != null ? { data: result } : {} };
+      sendReply(msg, reply);
     } catch (error) {
+      sendReply(msg, { accepted: false, error: error instanceof Error ? error.message : "Processing failed" });
       const unknownCtx = toUnknownContext(msg);
       const context = createProcessingContext("unknown", decode(msg.data), unknownCtx, void 0);
       await base.handleParseError(error, context);
     }
   };
   const handleUnhandledProcessingError = async (msg, error) => {
+    sendReply(msg, { accepted: false, error: error instanceof Error ? error.message : "Unhandled error" });
     const unknownCtx = toUnknownContext(msg);
     const context = createProcessingContext("unknown", decode(msg.data), unknownCtx, void 0);
     await base.handleUnhandledError(error, context);
@@ -2694,7 +2730,7 @@ var createNatsMessageProcessor = (deps) => {
 };
 
 // src/transports/nats/nats-consumer.ts
-var sc3 = StringCodec();
+var sc4 = StringCodec();
 var CONSUMER_REGISTRY_KEY = "__crossdelta_nats_consumers__";
 function getConsumerRegistry() {
   if (!globalThis[CONSUMER_REGISTRY_KEY]) {
@@ -2738,7 +2774,7 @@ async function consumeNatsEvents(options) {
     dlqEnabled,
     options,
     processedHandlers,
-    decode: (data) => sc3.decode(data),
+    decode: (data) => sc4.decode(data),
     logger
   });
   const processSubscription = async () => {
@@ -2755,4 +2791,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, 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, request, resetDefaultIdempotencyStore, singularize, streamWired, toKebabCase, toPascalCase, validateEventType };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@crossdelta/cloudevents",
-  "version": "0.6.8",
-  "description": "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream",
+  "version": "0.7.2",
+  "description": "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream & Core",
   "author": "crossdelta",
   "license": "MIT",
   "keywords": [
@@ -47,7 +47,7 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@crossdelta/flowcore": "0.1.0",
+    "@crossdelta/flowcore": "0.1.1",
     "cloudevents": "^10.0.0",
     "glob": "^11.1.0",
     "nats": "^2.29.3",