@amqp-contract/contract 0.17.0 → 0.19.0

package/dist/index.cjs

@@ -67,10 +67,9 @@ function defineMessage(payload, options) {
 }
 
 //#endregion
-//#region src/builder/binding.ts
+//#region src/builder/queue-utils.ts
 /**
 * Type guard to check if a queue entry is a QueueWithTtlBackoffInfrastructure.
-* Duplicated here to avoid circular dependency with queue.ts.
 * @internal
 */
 function isQueueWithTtlBackoffInfrastructure$1(entry) {
@@ -78,13 +77,15 @@ function isQueueWithTtlBackoffInfrastructure$1(entry) {
 }
 /**
 * Extract the plain QueueDefinition from a QueueEntry.
-* Duplicated here to avoid circular dependency with queue.ts.
 * @internal
 */
-function extractQueueInternal(entry) {
+function extractQueueFromEntry(entry) {
 	if (isQueueWithTtlBackoffInfrastructure$1(entry)) return entry.queue;
 	return entry;
 }
+
+//#endregion
+//#region src/builder/binding.ts
 /**
 * Define a binding between a queue and an exchange.
 *
@@ -97,7 +98,7 @@ function extractQueueInternal(entry) {
 * @internal
 */
 function defineQueueBinding(queue, exchange, options) {
-	const queueDef = extractQueueInternal(queue);
+	const queueDef = extractQueueFromEntry(queue);
 	if (exchange.type === "fanout") return {
 		type: "queue",
 		queue: queueDef,
@@ -198,7 +199,7 @@ function resolveTtlBackoffOptions(options) {
 * ```
 */
 function isQueueWithTtlBackoffInfrastructure(entry) {
-	return typeof entry === "object" && entry !== null && "__brand" in entry && entry.__brand === "QueueWithTtlBackoffInfrastructure";
+	return isQueueWithTtlBackoffInfrastructure$1(entry);
 }
 /**
 * Extract the plain QueueDefinition from a QueueEntry.
@@ -249,14 +250,13 @@ function isQueueWithTtlBackoffInfrastructure(entry) {
 * @see defineTtlBackoffQueue - Creates queues with TTL-backoff infrastructure
 */
 function extractQueue(entry) {
-	if (isQueueWithTtlBackoffInfrastructure(entry)) return entry.queue;
-	return entry;
+	return extractQueueFromEntry(entry);
 }
 /**
-* Wrap a queue definition with TTL-backoff retry infrastructure.
+* Create TTL-backoff retry infrastructure (wait queue + bindings) for a queue.
 * @internal
 */
-function wrapWithTtlBackoffInfrastructure(queue) {
+function createTtlBackoffInfrastructure(queue) {
 	if (!queue.deadLetter) throw new Error(`Queue "${queue.name}" does not have a dead letter exchange configured. TTL-backoff retry requires deadLetter to be set on the queue.`);
 	const dlx = queue.deadLetter.exchange;
 	const waitQueueName = `${queue.name}-wait`;
@@ -270,15 +270,23 @@ function wrapWithTtlBackoffInfrastructure(queue) {
 		},
 		retry: resolveTtlBackoffOptions(void 0)
 	};
-	const waitQueueBinding = defineQueueBindingInternal(waitQueue, dlx, { routingKey: waitQueueName });
-	const mainQueueRetryBinding = defineQueueBindingInternal(queue, dlx, { routingKey: queue.name });
+	return {
+		waitQueue,
+		waitQueueBinding: defineQueueBindingInternal(waitQueue, dlx, { routingKey: waitQueueName }),
+		mainQueueRetryBinding: defineQueueBindingInternal(queue, dlx, { routingKey: queue.name })
+	};
+}
+/**
+* Wrap a queue definition with TTL-backoff retry infrastructure.
+* @internal
+*/
+function wrapWithTtlBackoffInfrastructure(queue) {
+	const infra = createTtlBackoffInfrastructure(queue);
 	return {
 		__brand: "QueueWithTtlBackoffInfrastructure",
 		queue,
 		deadLetter: queue.deadLetter,
-		waitQueue,
-		waitQueueBinding,
-		mainQueueRetryBinding
+		...infra
 	};
 }
 function defineQueue(name, options) {
@@ -610,21 +618,41 @@ function defineEventPublisher(exchange, message, options) {
 * @internal
 */
 function defineEventConsumer(eventPublisher, queue, options) {
-	const { exchange, message, routingKey: publisherRoutingKey } = eventPublisher;
+	const { exchange: sourceExchange, message, routingKey: publisherRoutingKey } = eventPublisher;
 	const bindingRoutingKey = options?.routingKey ?? publisherRoutingKey;
 	const bindingOptions = {};
 	if (bindingRoutingKey !== void 0) bindingOptions.routingKey = bindingRoutingKey;
 	const bindingArguments = options?.arguments ?? eventPublisher.arguments;
 	if (bindingArguments !== void 0) bindingOptions.arguments = bindingArguments;
-	const binding = defineQueueBindingInternal(queue, exchange, bindingOptions);
+	const bridgeExchange = options?.bridgeExchange;
+	if (bridgeExchange) {
+		const binding = defineQueueBindingInternal(queue, bridgeExchange, bindingOptions);
+		const consumer = defineConsumer(queue, message);
+		const exchangeBindingOptions = {};
+		if (bindingRoutingKey !== void 0) exchangeBindingOptions.routingKey = bindingRoutingKey;
+		const e2eBinding = sourceExchange.type === "fanout" ? defineExchangeBinding(bridgeExchange, sourceExchange) : defineExchangeBinding(bridgeExchange, sourceExchange, exchangeBindingOptions);
+		return {
+			__brand: "EventConsumerResult",
+			consumer,
+			binding,
+			exchange: sourceExchange,
+			queue: consumer.queue,
+			deadLetterExchange: consumer.queue.deadLetter?.exchange,
+			exchangeBinding: e2eBinding,
+			bridgeExchange
+		};
+	}
+	const binding = defineQueueBindingInternal(queue, sourceExchange, bindingOptions);
 	const consumer = defineConsumer(queue, message);
 	return {
 		__brand: "EventConsumerResult",
 		consumer,
 		binding,
-		exchange,
+		exchange: sourceExchange,
 		queue: consumer.queue,
-		deadLetterExchange: consumer.queue.deadLetter?.exchange
+		deadLetterExchange: consumer.queue.deadLetter?.exchange,
+		exchangeBinding: void 0,
+		bridgeExchange: void 0
 	};
 }
 /**
@@ -670,11 +698,26 @@ function defineCommandConsumer(queue, exchange, message, options) {
 * @internal
 */
 function defineCommandPublisher(commandConsumer, options) {
-	const { exchange, message, routingKey: consumerRoutingKey } = commandConsumer;
+	const { exchange: targetExchange, message, routingKey: consumerRoutingKey } = commandConsumer;
 	const publisherRoutingKey = options?.routingKey ?? consumerRoutingKey;
+	const bridgeExchange = options?.bridgeExchange;
+	if (bridgeExchange) {
+		const publisherOptions = {};
+		if (publisherRoutingKey !== void 0) publisherOptions.routingKey = publisherRoutingKey;
+		const publisher = definePublisherInternal(bridgeExchange, message, publisherOptions);
+		const e2eBindingOptions = {};
+		if (publisherRoutingKey !== void 0) e2eBindingOptions.routingKey = publisherRoutingKey;
+		return {
+			__brand: "BridgedPublisherConfig",
+			publisher,
+			exchangeBinding: bridgeExchange.type === "fanout" ? defineExchangeBinding(targetExchange, bridgeExchange) : defineExchangeBinding(targetExchange, bridgeExchange, e2eBindingOptions),
+			bridgeExchange,
+			targetExchange
+		};
+	}
 	const publisherOptions = {};
 	if (publisherRoutingKey !== void 0) publisherOptions.routingKey = publisherRoutingKey;
-	return definePublisherInternal(exchange, message, publisherOptions);
+	return definePublisherInternal(targetExchange, message, publisherOptions);
 }
 /**
 * Type guard to check if a value is a CommandConsumerConfig.
@@ -685,6 +728,15 @@ function defineCommandPublisher(commandConsumer, options) {
 function isCommandConsumerConfig(value) {
 	return typeof value === "object" && value !== null && "__brand" in value && value.__brand === "CommandConsumerConfig";
 }
+/**
+* Type guard to check if a value is a BridgedPublisherConfig.
+*
+* @param value - The value to check
+* @returns True if the value is a BridgedPublisherConfig
+*/
+function isBridgedPublisherConfig(value) {
+	return typeof value === "object" && value !== null && "__brand" in value && value.__brand === "BridgedPublisherConfig";
+}
 
 //#endregion
 //#region src/builder/contract.ts
@@ -766,7 +818,13 @@ function defineContract(definition) {
 	if (inputPublishers && Object.keys(inputPublishers).length > 0) {
 		const processedPublishers = {};
 		const exchanges = {};
-		for (const [name, entry] of Object.entries(inputPublishers)) if (isEventPublisherConfig(entry)) {
+		const publisherBindings = {};
+		for (const [name, entry] of Object.entries(inputPublishers)) if (isBridgedPublisherConfig(entry)) {
+			exchanges[entry.bridgeExchange.name] = entry.bridgeExchange;
+			exchanges[entry.targetExchange.name] = entry.targetExchange;
+			publisherBindings[`${name}ExchangeBinding`] = entry.exchangeBinding;
+			processedPublishers[name] = entry.publisher;
+		} else if (isEventPublisherConfig(entry)) {
 			exchanges[entry.exchange.name] = entry.exchange;
 			const publisherOptions = {};
 			if (entry.routingKey !== void 0) publisherOptions.routingKey = entry.routingKey;
@@ -781,6 +839,10 @@ function defineContract(definition) {
 			...result.exchanges,
 			...exchanges
 		};
+		result.bindings = {
+			...result.bindings,
+			...publisherBindings
+		};
 	}
 	if (inputConsumers && Object.keys(inputConsumers).length > 0) {
 		const processedConsumers = {};
@@ -794,6 +856,9 @@ function defineContract(definition) {
 			queues[queueEntry.name] = queueEntry;
 			exchanges[entry.binding.exchange.name] = entry.binding.exchange;
 			if (queueEntry.deadLetter?.exchange) exchanges[queueEntry.deadLetter.exchange.name] = queueEntry.deadLetter.exchange;
+			if (entry.exchangeBinding) consumerBindings[`${name}ExchangeBinding`] = entry.exchangeBinding;
+			if (entry.bridgeExchange) exchanges[entry.bridgeExchange.name] = entry.bridgeExchange;
+			if (entry.exchange) exchanges[entry.exchange.name] = entry.exchange;
 		} else if (isCommandConsumerConfig(entry)) {
 			processedConsumers[name] = entry.consumer;
 			consumerBindings[`${name}Binding`] = entry.binding;
@@ -809,22 +874,11 @@ function defineContract(definition) {
 			if (queueEntry.deadLetter?.exchange) exchanges[queueEntry.deadLetter.exchange.name] = queueEntry.deadLetter.exchange;
 		}
 		for (const queue of Object.values(queues)) if (queue.retry?.mode === "ttl-backoff" && queue.deadLetter) {
-			const dlx = queue.deadLetter.exchange;
-			const waitQueueName = `${queue.name}-wait`;
-			const waitQueue = {
-				name: waitQueueName,
-				type: "quorum",
-				durable: queue.durable ?? true,
-				deadLetter: {
-					exchange: dlx,
-					routingKey: queue.name
-				},
-				retry: resolveTtlBackoffOptions(void 0)
-			};
-			queues[waitQueueName] = waitQueue;
-			consumerBindings[`${queue.name}WaitBinding`] = defineQueueBindingInternal(waitQueue, dlx, { routingKey: waitQueueName });
-			consumerBindings[`${queue.name}RetryBinding`] = defineQueueBindingInternal(queue, dlx, { routingKey: queue.name });
-			exchanges[dlx.name] = dlx;
+			const infra = createTtlBackoffInfrastructure(queue);
+			queues[infra.waitQueue.name] = infra.waitQueue;
+			consumerBindings[`${queue.name}WaitBinding`] = infra.waitQueueBinding;
+			consumerBindings[`${queue.name}RetryBinding`] = infra.mainQueueRetryBinding;
+			exchanges[queue.deadLetter.exchange.name] = queue.deadLetter.exchange;
 		}
 		result.consumers = processedConsumers;
 		result.bindings = {
@@ -888,23 +942,9 @@ function defineContract(definition) {
 * ```
 */
 function defineTtlBackoffRetryInfrastructure(queueEntry, options) {
-	const queue = extractQueue(queueEntry);
-	if (!queue.deadLetter) throw new Error(`Queue "${queue.name}" does not have a dead letter exchange configured. TTL-backoff retry requires deadLetter to be set on the queue.`);
-	const dlx = queue.deadLetter.exchange;
-	const waitQueueName = `${queue.name}-wait`;
-	const waitQueue = defineQueue(waitQueueName, {
-		type: "quorum",
-		durable: options?.waitQueueDurable ?? queue.durable ?? true,
-		deadLetter: {
-			exchange: dlx,
-			routingKey: queue.name
-		}
-	});
-	return {
-		waitQueue,
-		waitQueueBinding: defineQueueBindingInternal(waitQueue, dlx, { routingKey: waitQueueName }),
-		mainQueueRetryBinding: defineQueueBindingInternal(queue, dlx, { routingKey: queue.name })
-	};
+	const infra = createTtlBackoffInfrastructure(extractQueue(queueEntry));
+	if (options?.waitQueueDurable !== void 0) infra.waitQueue.durable = options.waitQueueDurable;
+	return infra;
 }
 
 //#endregion
@@ -925,6 +965,7 @@ exports.defineTtlBackoffQueue = defineTtlBackoffQueue;
 exports.defineTtlBackoffRetryInfrastructure = defineTtlBackoffRetryInfrastructure;
 exports.extractConsumer = extractConsumer;
 exports.extractQueue = extractQueue;
+exports.isBridgedPublisherConfig = isBridgedPublisherConfig;
 exports.isCommandConsumerConfig = isCommandConsumerConfig;
 exports.isEventConsumerResult = isEventConsumerResult;
 exports.isEventPublisherConfig = isEventPublisherConfig;

package/dist/index.d.cts

@@ -641,7 +641,7 @@ type QueueEntry<TName extends string = string> = QueueDefinition<TName> | QueueW
  * @template TPayload - The Standard Schema v1 compatible schema for the message payload
  * @template THeaders - The Standard Schema v1 compatible schema for the message headers (optional)
  */
-type MessageDefinition<TPayload extends AnySchema = AnySchema, THeaders extends StandardSchemaV1<Record<string, unknown>> | undefined = undefined> = {
+type MessageDefinition<TPayload extends AnySchema = AnySchema, THeaders extends StandardSchemaV1<Record<string, unknown>> | undefined = StandardSchemaV1<Record<string, unknown>> | undefined> = {
   /**
    * The payload schema for validating message content.
    * Must be a Standard Schema v1 compatible schema (Zod, Valibot, ArkType, etc.).
@@ -836,6 +836,23 @@ type EventConsumerResultBase = {
   exchange: ExchangeDefinition;
   queue: QueueDefinition;
   deadLetterExchange: ExchangeDefinition | undefined;
+  exchangeBinding: ExchangeBindingDefinition | undefined;
+  bridgeExchange: ExchangeDefinition | undefined;
+};
+/**
+ * Base type for bridged publisher configuration.
+ *
+ * A bridged publisher publishes to a bridge exchange, which forwards messages
+ * to the target exchange via an exchange-to-exchange binding.
+ *
+ * @see defineCommandPublisher with bridgeExchange option
+ */
+type BridgedPublisherConfigBase = {
+  __brand: "BridgedPublisherConfig";
+  publisher: PublisherDefinition;
+  exchangeBinding: ExchangeBindingDefinition;
+  bridgeExchange: ExchangeDefinition;
+  targetExchange: ExchangeDefinition;
 };
 /**
  * Complete AMQP contract definition (output type).
@@ -909,7 +926,7 @@ type ContractDefinition = {
  * - A plain PublisherDefinition from definePublisher
  * - An EventPublisherConfig from defineEventPublisher (auto-extracted to publisher)
  */
-type PublisherEntry = PublisherDefinition | EventPublisherConfigBase;
+type PublisherEntry = PublisherDefinition | EventPublisherConfigBase | BridgedPublisherConfigBase;
 /**
  * Consumer entry that can be passed to defineContract's consumers section.
  *
@@ -966,7 +983,7 @@ type ContractDefinitionInput = {
  * Extract the exchange from a publisher entry.
  * @internal
  */
-type ExtractPublisherExchange<T extends PublisherEntry> = T extends EventPublisherConfigBase ? T["exchange"] : T extends PublisherDefinition ? T["exchange"] : never;
+type ExtractPublisherExchange<T extends PublisherEntry> = T extends BridgedPublisherConfigBase ? T["bridgeExchange"] : T extends EventPublisherConfigBase ? T["exchange"] : T extends PublisherDefinition ? T["exchange"] : never;
 /**
  * Extract the QueueDefinition from a QueueEntry type.
  * For QueueWithTtlBackoffInfrastructure, returns the inner queue definition.
@@ -1057,7 +1074,7 @@ type ExtractConsumerDefinitions<TConsumers extends Record<string, ConsumerEntry>
  * Extract the publisher definition from a publisher entry.
  * @internal
  */
-type ExtractPublisherDefinition<T extends PublisherEntry> = T extends EventPublisherConfigBase ? PublisherDefinition<T["message"]> & (T["exchange"] extends FanoutExchangeDefinition ? {
+type ExtractPublisherDefinition<T extends PublisherEntry> = T extends BridgedPublisherConfigBase ? T["publisher"] : T extends EventPublisherConfigBase ? PublisherDefinition<T["message"]> & (T["exchange"] extends FanoutExchangeDefinition ? {
   exchange: T["exchange"];
   routingKey?: never;
 } : {
@@ -1069,6 +1086,56 @@ type ExtractPublisherDefinition<T extends PublisherEntry> = T extends EventPubli
  * @internal
  */
 type ExtractPublisherDefinitions<TPublishers extends Record<string, PublisherEntry>> = { [K in keyof TPublishers]: ExtractPublisherDefinition<TPublishers[K]> };
+/**
+ * Extract the bridge exchange from a consumer entry (when bridgeExchange is set).
+ * @internal
+ */
+type ExtractBridgeExchangeFromConsumer<T extends ConsumerEntry> = T extends EventConsumerResultBase ? T["bridgeExchange"] extends ExchangeDefinition ? T["bridgeExchange"] : never : never;
+/**
+ * Extract bridge exchanges from all consumers in a contract.
+ * @internal
+ */
+type ExtractBridgeExchangesFromConsumers<TConsumers extends Record<string, ConsumerEntry>> = { [K in keyof TConsumers as ExtractBridgeExchangeFromConsumer<TConsumers[K]> extends never ? never : ExtractBridgeExchangeFromConsumer<TConsumers[K]>["name"]]: ExtractBridgeExchangeFromConsumer<TConsumers[K]> };
+/**
+ * Extract the target exchange from a bridged publisher entry.
+ * @internal
+ */
+type ExtractTargetExchangeFromPublisher<T extends PublisherEntry> = T extends BridgedPublisherConfigBase ? T["targetExchange"] : never;
+/**
+ * Extract target exchanges from all publishers in a contract.
+ * @internal
+ */
+type ExtractTargetExchangesFromPublishers<TPublishers extends Record<string, PublisherEntry>> = { [K in keyof TPublishers as ExtractTargetExchangeFromPublisher<TPublishers[K]> extends never ? never : ExtractTargetExchangeFromPublisher<TPublishers[K]>["name"]]: ExtractTargetExchangeFromPublisher<TPublishers[K]> };
+/**
+ * Check if a consumer entry has an exchange binding (e2e).
+ * @internal
+ */
+type HasConsumerExchangeBinding<T extends ConsumerEntry> = T extends EventConsumerResultBase ? T["exchangeBinding"] extends ExchangeBindingDefinition ? true : false : false;
+/**
+ * Extract the exchange binding from a consumer entry.
+ * @internal
+ */
+type ExtractConsumerExchangeBinding<T extends ConsumerEntry> = T extends EventConsumerResultBase ? T["exchangeBinding"] extends ExchangeBindingDefinition ? T["exchangeBinding"] : never : never;
+/**
+ * Extract exchange bindings from all consumers in a contract.
+ * @internal
+ */
+type ExtractExchangeBindingsFromConsumers<TConsumers extends Record<string, ConsumerEntry>> = { [K in keyof TConsumers as HasConsumerExchangeBinding<TConsumers[K]> extends true ? `${K & string}ExchangeBinding` : never]: ExtractConsumerExchangeBinding<TConsumers[K]> };
+/**
+ * Check if a publisher entry has an exchange binding (bridged).
+ * @internal
+ */
+type HasPublisherExchangeBinding<T extends PublisherEntry> = T extends BridgedPublisherConfigBase ? true : false;
+/**
+ * Extract the exchange binding from a bridged publisher entry.
+ * @internal
+ */
+type ExtractPublisherExchangeBinding<T extends PublisherEntry> = T extends BridgedPublisherConfigBase ? T["exchangeBinding"] : never;
+/**
+ * Extract exchange bindings from all publishers in a contract.
+ * @internal
+ */
+type ExtractExchangeBindingsFromPublishers<TPublishers extends Record<string, PublisherEntry>> = { [K in keyof TPublishers as HasPublisherExchangeBinding<TPublishers[K]> extends true ? `${K & string}ExchangeBinding` : never]: ExtractPublisherExchangeBinding<TPublishers[K]> };
 /**
  * Contract output type with all resources extracted and properly typed.
  *
@@ -1080,9 +1147,9 @@ type ExtractPublisherDefinitions<TPublishers extends Record<string, PublisherEnt
  * - consumers: Normalized consumer definitions
  */
 type ContractOutput<TContract extends ContractDefinitionInput> = {
-  exchanges: (TContract["publishers"] extends Record<string, PublisherEntry> ? ExtractExchangesFromPublishers<TContract["publishers"]> : {}) & (TContract["consumers"] extends Record<string, ConsumerEntry> ? ExtractExchangesFromConsumers<TContract["consumers"]> : {}) & (TContract["consumers"] extends Record<string, ConsumerEntry> ? ExtractDeadLetterExchangesFromConsumers<TContract["consumers"]> : {});
+  exchanges: (TContract["publishers"] extends Record<string, PublisherEntry> ? ExtractExchangesFromPublishers<TContract["publishers"]> : {}) & (TContract["consumers"] extends Record<string, ConsumerEntry> ? ExtractExchangesFromConsumers<TContract["consumers"]> : {}) & (TContract["consumers"] extends Record<string, ConsumerEntry> ? ExtractDeadLetterExchangesFromConsumers<TContract["consumers"]> : {}) & (TContract["consumers"] extends Record<string, ConsumerEntry> ? ExtractBridgeExchangesFromConsumers<TContract["consumers"]> : {}) & (TContract["publishers"] extends Record<string, PublisherEntry> ? ExtractTargetExchangesFromPublishers<TContract["publishers"]> : {});
   queues: TContract["consumers"] extends Record<string, ConsumerEntry> ? ExtractQueuesFromConsumers<TContract["consumers"]> : {};
-  bindings: TContract["consumers"] extends Record<string, ConsumerEntry> ? ExtractBindingsFromConsumers<TContract["consumers"]> : {};
+  bindings: (TContract["consumers"] extends Record<string, ConsumerEntry> ? ExtractBindingsFromConsumers<TContract["consumers"]> : {}) & (TContract["consumers"] extends Record<string, ConsumerEntry> ? ExtractExchangeBindingsFromConsumers<TContract["consumers"]> : {}) & (TContract["publishers"] extends Record<string, PublisherEntry> ? ExtractExchangeBindingsFromPublishers<TContract["publishers"]> : {});
   publishers: TContract["publishers"] extends Record<string, PublisherEntry> ? ExtractPublisherDefinitions<TContract["publishers"]> : {};
   consumers: TContract["consumers"] extends Record<string, ConsumerEntry> ? ExtractConsumerDefinitions<TContract["consumers"]> : {};
 };
@@ -2048,13 +2115,15 @@ type EventPublisherConfig<TMessage extends MessageDefinition, TExchange extends
  *
  * @template TMessage - The message definition
  */
-type EventConsumerResult<TMessage extends MessageDefinition, TExchange extends ExchangeDefinition = ExchangeDefinition, TQueue extends QueueDefinition = QueueDefinition, TDlxExchange extends ExchangeDefinition | undefined = ExchangeDefinition | undefined> = {
+type EventConsumerResult<TMessage extends MessageDefinition, TExchange extends ExchangeDefinition = ExchangeDefinition, TQueue extends QueueDefinition = QueueDefinition, TDlxExchange extends ExchangeDefinition | undefined = ExchangeDefinition | undefined, TExchangeBinding extends ExchangeBindingDefinition | undefined = ExchangeBindingDefinition | undefined, TBridgeExchange extends ExchangeDefinition | undefined = ExchangeDefinition | undefined> = {
   /** Discriminator to identify this as an event consumer result */__brand: "EventConsumerResult"; /** The consumer definition for processing messages */
   consumer: ConsumerDefinition<TMessage>; /** The binding connecting the queue to the exchange */
-  binding: QueueBindingDefinition; /** The exchange this consumer subscribes to */
+  binding: QueueBindingDefinition; /** The source exchange this consumer subscribes to */
   exchange: TExchange; /** The queue this consumer reads from */
   queue: TQueue; /** The dead letter exchange from the queue, if configured */
-  deadLetterExchange: TDlxExchange;
+  deadLetterExchange: TDlxExchange; /** The exchange-to-exchange binding when bridging, if configured */
+  exchangeBinding: TExchangeBinding; /** The bridge (local domain) exchange when bridging, if configured */
+  bridgeExchange: TBridgeExchange;
 };
 /**
  * Define an event publisher for broadcasting messages via fanout exchange.
@@ -2150,6 +2219,50 @@ declare function defineEventPublisher<TMessage extends MessageDefinition, TRouti
   routingKey: RoutingKey<TRoutingKey>;
   arguments?: Record<string, unknown>;
 }): EventPublisherConfig<TMessage, TExchange, TRoutingKey>;
+/**
+ * Create a consumer that subscribes to an event from a fanout exchange via a bridge exchange.
+ *
+ * When `bridgeExchange` is provided, the queue binds to the bridge exchange instead of the
+ * source exchange, and an exchange-to-exchange binding is created from the source to the bridge.
+ *
+ * @param eventPublisher - The event publisher configuration
+ * @param queue - The queue that will receive messages
+ * @param options - Binding configuration with required bridgeExchange
+ * @param options.bridgeExchange - The fanout bridge exchange (must be fanout to match source)
+ * @returns An object with the consumer definition, queue binding, and exchange binding
+ */
+declare function defineEventConsumer<TMessage extends MessageDefinition, TExchange extends FanoutExchangeDefinition, TQueueEntry extends QueueEntry, TBridgeExchange extends FanoutExchangeDefinition>(eventPublisher: EventPublisherConfig<TMessage, TExchange, undefined>, queue: TQueueEntry, options: {
+  bridgeExchange: TBridgeExchange;
+  arguments?: Record<string, unknown>;
+}): EventConsumerResult<TMessage, TExchange, ExtractQueueFromEntry<TQueueEntry>, ExtractDlxFromEntry<TQueueEntry>, ExchangeBindingDefinition, TBridgeExchange>;
+/**
+ * Create a consumer that subscribes to an event from a direct exchange via a bridge exchange.
+ *
+ * @param eventPublisher - The event publisher configuration
+ * @param queue - The queue that will receive messages
+ * @param options - Binding configuration with required bridgeExchange
+ * @param options.bridgeExchange - The bridge exchange (must be direct or topic to preserve routing keys)
+ * @returns An object with the consumer definition, queue binding, and exchange binding
+ */
+declare function defineEventConsumer<TMessage extends MessageDefinition, TRoutingKey extends string, TExchange extends DirectExchangeDefinition, TQueueEntry extends QueueEntry, TBridgeExchange extends DirectExchangeDefinition | TopicExchangeDefinition>(eventPublisher: EventPublisherConfig<TMessage, TExchange, TRoutingKey>, queue: TQueueEntry, options: {
+  bridgeExchange: TBridgeExchange;
+  arguments?: Record<string, unknown>;
+}): EventConsumerResult<TMessage, TExchange, ExtractQueueFromEntry<TQueueEntry>, ExtractDlxFromEntry<TQueueEntry>, ExchangeBindingDefinition, TBridgeExchange>;
+/**
+ * Create a consumer that subscribes to an event from a topic exchange via a bridge exchange.
+ *
+ * @param eventPublisher - The event publisher configuration
+ * @param queue - The queue that will receive messages
+ * @param options - Binding configuration with required bridgeExchange
+ * @param options.bridgeExchange - The bridge exchange (must be direct or topic to preserve routing keys)
+ * @param options.routingKey - Override routing key with pattern (defaults to publisher's key)
+ * @returns An object with the consumer definition, queue binding, and exchange binding
+ */
+declare function defineEventConsumer<TMessage extends MessageDefinition, TRoutingKey extends string, TExchange extends TopicExchangeDefinition, TQueueEntry extends QueueEntry, TBridgeExchange extends DirectExchangeDefinition | TopicExchangeDefinition, TConsumerRoutingKey extends string = TRoutingKey>(eventPublisher: EventPublisherConfig<TMessage, TExchange, TRoutingKey>, queue: TQueueEntry, options: {
+  bridgeExchange: TBridgeExchange;
+  routingKey?: BindingPattern<TConsumerRoutingKey>;
+  arguments?: Record<string, unknown>;
+}): EventConsumerResult<TMessage, TExchange, ExtractQueueFromEntry<TQueueEntry>, ExtractDlxFromEntry<TQueueEntry>, ExchangeBindingDefinition, TBridgeExchange>;
 /**
  * Create a consumer that subscribes to an event from a fanout exchange.
  *
@@ -2245,6 +2358,23 @@ type CommandConsumerConfig<TMessage extends MessageDefinition, TExchange extends
   message: TMessage; /** The routing key pattern for the binding */
   routingKey: TRoutingKey;
 };
+/**
+ * Configuration for a bridged command publisher.
+ *
+ * A bridged publisher publishes to a bridge exchange (local domain), which forwards
+ * messages to the target exchange (remote domain) via an exchange-to-exchange binding.
+ *
+ * @template TMessage - The message definition
+ * @template TBridgeExchange - The bridge (local domain) exchange definition
+ * @template TTargetExchange - The target (remote domain) exchange definition
+ */
+type BridgedPublisherConfig<TMessage extends MessageDefinition, TBridgeExchange extends ExchangeDefinition, TTargetExchange extends ExchangeDefinition> = {
+  /** Discriminator to identify this as a bridged publisher config */__brand: "BridgedPublisherConfig"; /** The publisher definition (publishes to bridge exchange) */
+  publisher: PublisherDefinition<TMessage>; /** The exchange-to-exchange binding (bridge → target) */
+  exchangeBinding: ExchangeBindingDefinition; /** The bridge (local domain) exchange */
+  bridgeExchange: TBridgeExchange; /** The target (remote domain) exchange */
+  targetExchange: TTargetExchange;
+};
 /**
  * Define a command consumer for receiving commands via fanout exchange.
  *
@@ -2336,6 +2466,41 @@ declare function defineCommandConsumer<TMessage extends MessageDefinition, TRout
   routingKey: BindingPattern<TRoutingKey>;
   arguments?: Record<string, unknown>;
 }): CommandConsumerConfig<TMessage, TExchange, TRoutingKey, ExtractQueueFromEntry<TQueueEntry>, ExtractDlxFromEntry<TQueueEntry>>;
+/**
+ * Create a bridged publisher that sends commands to a fanout exchange consumer via a bridge exchange.
+ *
+ * @param commandConsumer - The command consumer configuration
+ * @param options - Configuration with required bridgeExchange
+ * @param options.bridgeExchange - The local domain exchange to bridge through
+ * @returns A bridged publisher configuration
+ */
+declare function defineCommandPublisher<TMessage extends MessageDefinition, TExchange extends FanoutExchangeDefinition, TBridgeExchange extends FanoutExchangeDefinition>(commandConsumer: CommandConsumerConfig<TMessage, TExchange, undefined>, options: {
+  bridgeExchange: TBridgeExchange;
+}): BridgedPublisherConfig<TMessage, TBridgeExchange, TExchange>;
+/**
+ * Create a bridged publisher that sends commands to a direct exchange consumer via a bridge exchange.
+ *
+ * @param commandConsumer - The command consumer configuration
+ * @param options - Configuration with required bridgeExchange
+ * @param options.bridgeExchange - The bridge exchange (must be direct or topic to preserve routing keys)
+ * @returns A bridged publisher configuration
+ */
+declare function defineCommandPublisher<TMessage extends MessageDefinition, TRoutingKey extends string, TExchange extends DirectExchangeDefinition, TBridgeExchange extends DirectExchangeDefinition | TopicExchangeDefinition>(commandConsumer: CommandConsumerConfig<TMessage, TExchange, TRoutingKey>, options: {
+  bridgeExchange: TBridgeExchange;
+}): BridgedPublisherConfig<TMessage, TBridgeExchange, TExchange>;
+/**
+ * Create a bridged publisher that sends commands to a topic exchange consumer via a bridge exchange.
+ *
+ * @param commandConsumer - The command consumer configuration
+ * @param options - Configuration with required bridgeExchange and optional routingKey override
+ * @param options.bridgeExchange - The bridge exchange (must be direct or topic to preserve routing keys)
+ * @param options.routingKey - Override routing key (must match consumer's pattern)
+ * @returns A bridged publisher configuration
+ */
+declare function defineCommandPublisher<TMessage extends MessageDefinition, TRoutingKey extends string, TExchange extends TopicExchangeDefinition, TBridgeExchange extends DirectExchangeDefinition | TopicExchangeDefinition, TPublisherRoutingKey extends string = TRoutingKey>(commandConsumer: CommandConsumerConfig<TMessage, TExchange, TRoutingKey>, options: {
+  bridgeExchange: TBridgeExchange;
+  routingKey?: RoutingKey<TPublisherRoutingKey>;
+}): BridgedPublisherConfig<TMessage, TBridgeExchange, TExchange>;
 /**
  * Create a publisher that sends commands to a fanout exchange consumer.
  *
@@ -2401,6 +2566,13 @@ declare function defineCommandPublisher<TMessage extends MessageDefinition, TRou
  * @returns True if the value is a CommandConsumerConfig
  */
 declare function isCommandConsumerConfig(value: unknown): value is CommandConsumerConfig<MessageDefinition, ExchangeDefinition, string | undefined>;
+/**
+ * Type guard to check if a value is a BridgedPublisherConfig.
+ *
+ * @param value - The value to check
+ * @returns True if the value is a BridgedPublisherConfig
+ */
+declare function isBridgedPublisherConfig(value: unknown): value is BridgedPublisherConfig<MessageDefinition, ExchangeDefinition, ExchangeDefinition>;
 //#endregion
 //#region src/builder/ttl-backoff.d.ts
 /**
@@ -2469,5 +2641,5 @@ declare function defineTtlBackoffRetryInfrastructure(queueEntry: QueueEntry, opt
   waitQueueDurable?: boolean;
 }): TtlBackoffRetryInfrastructure;
 //#endregion
-export { type AnySchema, type BaseExchangeDefinition, type BindingDefinition, type BindingPattern, type ClassicQueueDefinition, type ClassicQueueOptions, type CommandConsumerConfig, type CommandConsumerConfigBase, type CompressionAlgorithm, type ConsumerDefinition, type ConsumerEntry, type ContractDefinition, type ContractDefinitionInput, type ContractOutput, type DeadLetterConfig, type DefineQueueOptions, type DefineQuorumQueueOptions, type DefineTtlBackoffQueueOptions, type DirectExchangeDefinition, type EventConsumerResult, type EventConsumerResultBase, type EventPublisherConfig, type EventPublisherConfigBase, type ExchangeBindingDefinition, type ExchangeDefinition, type FanoutExchangeDefinition, type InferConsumerNames, type InferPublisherNames, type MatchingRoutingKey, type MessageDefinition, type PublisherDefinition, type PublisherEntry, type QueueBindingDefinition, type QueueDefinition, type QueueEntry, type QueueType, type QueueWithTtlBackoffInfrastructure, type QuorumNativeRetryOptions, type QuorumQueueDefinition, type QuorumQueueOptions, type ResolvedRetryOptions, type ResolvedTtlBackoffRetryOptions, type RoutingKey, type TopicExchangeDefinition, type TtlBackoffRetryInfrastructure, type TtlBackoffRetryOptions, defineCommandConsumer, defineCommandPublisher, defineConsumer, defineContract, defineEventConsumer, defineEventPublisher, defineExchange, defineExchangeBinding, defineMessage, definePublisher, defineQueue, defineQueueBinding, defineQuorumQueue, defineTtlBackoffQueue, defineTtlBackoffRetryInfrastructure, extractConsumer, extractQueue, isCommandConsumerConfig, isEventConsumerResult, isEventPublisherConfig, isQueueWithTtlBackoffInfrastructure };
+export { type AnySchema, type BaseExchangeDefinition, type BindingDefinition, type BindingPattern, type BridgedPublisherConfig, type BridgedPublisherConfigBase, type ClassicQueueDefinition, type ClassicQueueOptions, type CommandConsumerConfig, type CommandConsumerConfigBase, type CompressionAlgorithm, type ConsumerDefinition, type ConsumerEntry, type ContractDefinition, type ContractDefinitionInput, type ContractOutput, type DeadLetterConfig, type DefineQueueOptions, type DefineQuorumQueueOptions, type DefineTtlBackoffQueueOptions, type DirectExchangeDefinition, type EventConsumerResult, type EventConsumerResultBase, type EventPublisherConfig, type EventPublisherConfigBase, type ExchangeBindingDefinition, type ExchangeDefinition, type FanoutExchangeDefinition, type InferConsumerNames, type InferPublisherNames, type MatchingRoutingKey, type MessageDefinition, type PublisherDefinition, type PublisherEntry, type QueueBindingDefinition, type QueueDefinition, type QueueEntry, type QueueType, type QueueWithTtlBackoffInfrastructure, type QuorumNativeRetryOptions, type QuorumQueueDefinition, type QuorumQueueOptions, type ResolvedRetryOptions, type ResolvedTtlBackoffRetryOptions, type RoutingKey, type TopicExchangeDefinition, type TtlBackoffRetryInfrastructure, type TtlBackoffRetryOptions, defineCommandConsumer, defineCommandPublisher, defineConsumer, defineContract, defineEventConsumer, defineEventPublisher, defineExchange, defineExchangeBinding, defineMessage, definePublisher, defineQueue, defineQueueBinding, defineQuorumQueue, defineTtlBackoffQueue, defineTtlBackoffRetryInfrastructure, extractConsumer, extractQueue, isBridgedPublisherConfig, isCommandConsumerConfig, isEventConsumerResult, isEventPublisherConfig, isQueueWithTtlBackoffInfrastructure };
 //# sourceMappingURL=index.d.cts.map