@adobe-commerce/aio-toolkit 1.2.2 → 1.2.3

package/CHANGELOG.md

@@ -5,6 +5,61 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.3] - 2026-04-01
+
+### ✨ Features
+
+- **feat(integration): Add `RabbitMQClient` — push-based AMQP consumer and publisher**
+
+  New `RabbitMQClient` class in `src/integration/rabbit-mq-client` provides a
+  clean, typed interface for consuming and publishing messages via AMQP (RabbitMQ).
+
+  **`consume(queueName, options, handler)`**
+  - Checks queue depth via `channel.checkQueue` — skips immediately when empty
+  - Sets `channel.prefetch(maxParallel)` for broker-side concurrency control
+  - Processes `effectiveBatch = min(batchSize, messageCount)` messages
+  - Acks on successful handler execution; nacks on failure (requeue configurable)
+  - Optional exchange assertion and queue binding via `options.exchange`
+  - Returns `ConsumeStats` — consumed, acked, nacked counts plus per-failure details
+
+  **`publish(queueName, payloads)`**
+  - Asserts queue and sends each payload via `sendToQueue` with `persistent: true`
+  - Records write-buffer-full (`sendToQueue` returns `false`) and thrown errors
+  - Returns `PublishStats` — published and failed counts plus per-failure details
+
+  Both methods open a dedicated connection per call and always close channel and
+  connection in a `finally` block.
+
+  **Exported types** (from `rabbit-mq-client/types`):
+  `RabbitMQCredentials`, `RabbitMQConsumeOptions`, `MessageHandler`,
+  `ConsumeStats`, `PublishStats`
+
+  **Note:** `batchSize` and `maxParallel` are required in `RabbitMQConsumeOptions`
+  — the caller must choose appropriate limits for their workload.
+
+### 🐛 Bug Fixes
+
+- **fix(abdb): Preserve `error.cause` on `AbdbCollection` thrown errors**
+
+  `run()` now assigns `.cause` to each re-thrown `Error` so callers can access
+  the original error via `err.cause`. Previously the root cause was silently
+  discarded. Assignment is done via `(err as any).cause` for compatibility with
+  the ES2020 TypeScript target (the ES2022 `Error(msg, { cause })` constructor
+  overload is not available in ES2020 lib typings).
+
+- **fix(abdb): Guard `DbError instanceof` check against undefined export**
+
+  The `DbError` branch now uses `DbError && error instanceof DbError` so the
+  code does not throw a `TypeError` in environments where `@adobe/aio-lib-db`
+  does not export `DbError` at runtime. Unrecognised errors fall through to the
+  `unexpected error` path as expected.
+
+- **fix(abdb): Correct file header comment in `adobe-aio-lib-db.d.ts`**
+
+  The comment incorrectly read `@adobe/aio-lib-ims`; updated to `@adobe/aio-lib-db`.
+
+---
+
 ## [1.2.2] - 2026-04-01
 
 ### 🐛 Bug Fixes

package/README.md

@@ -1508,6 +1508,107 @@ if (directInfo.isValid) {
 - `extract(headersOrParams)` - Extracts Bearer token from headers or OpenWhisk params
 - `info(token)` - Analyzes token string and returns validation/expiry details
 
+#### `RabbitMQClient`
+Push-based AMQP consumer and publisher for RabbitMQ. Manages the full connection lifecycle per call (connect → channel → close) and exposes a clean, typed interface without exposing raw AMQP primitives to the caller.
+
+**Installation**
+```bash
+npm install amqplib
+```
+
+**Basic Usage**
+```typescript
+const { RabbitMQClient } = require('@adobe-commerce/aio-toolkit');
+
+const client = new RabbitMQClient({
+  host: 'rabbitmq.example.com',
+  port: '5672',
+  username: 'user',
+  password: 'secret',
+  vhost: '/',
+  secure: false, // set true to use amqps://
+});
+```
+
+**Consuming messages**
+```typescript
+const stats = await client.consume(
+  'orders-queue',
+  { batchSize: 100, maxParallel: 10 },
+  async (queueName, content) => {
+    const order = JSON.parse(content);
+    await processOrder(order);
+  }
+);
+
+console.log(`consumed=${stats.consumed} acked=${stats.acked} nacked=${stats.nacked}`);
+if (stats.errors.length) {
+  console.error('Failed messages:', stats.errors);
+}
+```
+
+**Consuming with exchange binding**
+```typescript
+const stats = await client.consume(
+  'orders-queue',
+  {
+    batchSize: 50,
+    maxParallel: 5,
+    exchange: 'orders-exchange', // asserts exchange + binds queue before consuming
+    nackRequeue: false,          // dead-letter failed messages instead of requeueing
+  },
+  async (queueName, content) => {
+    await processOrder(JSON.parse(content));
+  }
+);
+```
+
+**Publishing messages**
+```typescript
+const payloads = orders.map(o => JSON.stringify(o));
+const stats = await client.publish('orders-queue', payloads);
+
+console.log(`published=${stats.published} failed=${stats.failed}`);
+if (stats.errors.length) {
+  console.error('Failed payloads:', stats.errors);
+}
+```
+
+**API Reference**
+
+| Method | Description | Returns |
+|---|---|---|
+| `consume(queueName, options, handler)` | Checks queue depth, sets prefetch, and push-consumes up to `batchSize` messages | `Promise<ConsumeStats>` |
+| `publish(queueName, payloads)` | Asserts queue and enqueues each payload as a persistent message | `Promise<PublishStats>` |
+
+**`RabbitMQConsumeOptions`**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `batchSize` | `number` | ✅ | Maximum number of messages to process in this call |
+| `maxParallel` | `number` | ✅ | Max unacked messages in-flight at once (broker-side prefetch) |
+| `nackRequeue` | `boolean` | — | Requeue on nack (default: `true`) |
+| `exchange` | `string` | — | If set, asserts a `direct` exchange and binds the queue before consuming |
+
+**`ConsumeStats`**
+
+| Field | Type | Description |
+|---|---|---|
+| `consumed` | `number` | Total messages received from the broker |
+| `acked` | `number` | Messages successfully processed and acked |
+| `nacked` | `number` | Messages that failed handler and were nacked |
+| `errors` | `Array<{ content: string; error: unknown }>` | Per-failure details |
+
+**`PublishStats`**
+
+| Field | Type | Description |
+|---|---|---|
+| `published` | `number` | Messages successfully enqueued |
+| `failed` | `number` | Messages that could not be enqueued |
+| `errors` | `Array<{ payload: string; error: unknown }>` | Per-failure details (buffer full or thrown) |
+
+---
+
 #### `InfiniteLoopBreaker`
 Detect and prevent infinite loops in event-driven applications.
 

package/dist/index.d.mts

@@ -788,6 +788,50 @@ declare class OnboardCommerce {
     private logEventSubscriptionSummary;
 }
 
+type RabbitMQCredentials = {
+    host: string;
+    port: string;
+    username: string;
+    password: string;
+    vhost: string;
+    secure?: boolean;
+};
+type RabbitMQConsumeOptions = {
+    batchSize: number;
+    maxParallel: number;
+    nackRequeue?: boolean;
+    exchange?: string;
+};
+type MessageHandler = (queueName: string, content: string) => Promise<void> | void;
+type ConsumeStats = {
+    consumed: number;
+    acked: number;
+    nacked: number;
+    errors: Array<{
+        content: string;
+        error: unknown;
+    }>;
+};
+type PublishStats = {
+    published: number;
+    failed: number;
+    errors: Array<{
+        payload: string;
+        error: unknown;
+    }>;
+};
+
+declare class RabbitMQClient {
+    private readonly credentials;
+    constructor(credentials: RabbitMQCredentials);
+    consume(queueName: string, options: RabbitMQConsumeOptions, handler: MessageHandler): Promise<ConsumeStats>;
+    publish(queueName: string, payloads: string[]): Promise<PublishStats>;
+    private publishBatch;
+    private buildConnectionUrl;
+    private processBatch;
+    private processMessage;
+}
+
 declare class AdobeAuth {
     static getToken(clientId: string, clientSecret: string, technicalAccountId: string, technicalAccountEmail: string, imsOrgId: string, scopes: string[], currentContext?: string): Promise<string>;
 }
@@ -1083,4 +1127,4 @@ declare class AdminUiSdk {
     getRegistration(): AdminUiSdkRegistration;
 }
 
-export { AbdbCollection, type AbdbCollectionCallback, AbdbColumn, type AbdbColumnJson, type AbdbColumnOptions, AbdbColumnType, type AbdbRecord, AbdbRepository, type AbdbRepositoryFilter, type AbdbRunCallback, type AddColumnOptions, AdminUiSdk, type AdminUiSdkRegistration, AdobeAuth, AdobeCommerceClient, type AdobeIMSConfig, type BaseTelemetry, type BaseTelemetryValidator, BasicAuthConnection, BearerToken, type BearerTokenInfo, type CommerceEvent, type CommerceEventConfig, type CommerceEventField, type Connection, type CreateEventResult, CreateEvents, type CreateProviderParams, type CreateProviderResult, type CreateRegistrationResult, CreateRegistrations, type ErrorResponse, EventConsumerAction, type EventData, type EventMetadata, type EventMetadataInputModel, type EventMetadataListResponse, EventMetadataManager, type ExtendedRequestError, type FileMetadata, type FileRecord, FileRepository, GenerateBasicAuthToken, type GetProviderQueryParams, type GetRegistrationQueryParams, GraphQlAction, type HALLink, type Headers, HttpMethod, HttpStatus, IOEventsApiError, type IOEventsError, ImsConnection, ImsToken, type ImsTokenResult, InfiniteLoopBreaker, type InfiniteLoopData, IoEventsGlobals, JsonMessageProcessor, type ListProvidersQueryParams, type ListRegistrationQueryParams, type MenuItem, Oauth1aConnection, OnboardCommerce, type OnboardCommerceConfig, type OnboardCommerceResult, OnboardEvents, type OnboardEventsInput, type OnboardEventsResponse, OnboardEvents as OnboardIOEvents, Openwhisk, OpenwhiskAction, type OpenwhiskConfig, type Page, Parameters, type Provider, type ProviderInputModel, ProviderManager, PublishEvent, type PublishEventResult, type Registration, type RegistrationCreateModel, type RegistrationListResponse, RegistrationManager, RestClient, RuntimeAction, RuntimeActionResponse, type RuntimeActionResponseType, RuntimeApiGatewayService, ShippingCarrier, type ShippingCarrierData, ShippingCarrierMethod, type ShippingCarrierMethodAdditionalData, type ShippingCarrierMethodData, ShippingCarrierResponse, SignatureVerification, SuccessChecker, type SuccessResponse, Telemetry, TelemetryInputError, type TokenResult, Validator, WebhookAction, type WebhookActionAddResponse, type WebhookActionExceptionResponse, WebhookActionOperation, type WebhookActionRemoveResponse, type WebhookActionReplaceResponse, WebhookActionResponse, type WebhookActionResponseType, type WebhookActionSuccessResponse, type WorkspaceConfig };
+export { AbdbCollection, type AbdbCollectionCallback, AbdbColumn, type AbdbColumnJson, type AbdbColumnOptions, AbdbColumnType, type AbdbRecord, AbdbRepository, type AbdbRepositoryFilter, type AbdbRunCallback, type AddColumnOptions, AdminUiSdk, type AdminUiSdkRegistration, AdobeAuth, AdobeCommerceClient, type AdobeIMSConfig, type BaseTelemetry, type BaseTelemetryValidator, BasicAuthConnection, BearerToken, type BearerTokenInfo, type CommerceEvent, type CommerceEventConfig, type CommerceEventField, type Connection, type ConsumeStats, type CreateEventResult, CreateEvents, type CreateProviderParams, type CreateProviderResult, type CreateRegistrationResult, CreateRegistrations, type ErrorResponse, EventConsumerAction, type EventData, type EventMetadata, type EventMetadataInputModel, type EventMetadataListResponse, EventMetadataManager, type ExtendedRequestError, type FileMetadata, type FileRecord, FileRepository, GenerateBasicAuthToken, type GetProviderQueryParams, type GetRegistrationQueryParams, GraphQlAction, type HALLink, type Headers, HttpMethod, HttpStatus, IOEventsApiError, type IOEventsError, ImsConnection, ImsToken, type ImsTokenResult, InfiniteLoopBreaker, type InfiniteLoopData, IoEventsGlobals, JsonMessageProcessor, type ListProvidersQueryParams, type ListRegistrationQueryParams, type MenuItem, type MessageHandler, Oauth1aConnection, OnboardCommerce, type OnboardCommerceConfig, type OnboardCommerceResult, OnboardEvents, type OnboardEventsInput, type OnboardEventsResponse, OnboardEvents as OnboardIOEvents, Openwhisk, OpenwhiskAction, type OpenwhiskConfig, type Page, Parameters, type Provider, type ProviderInputModel, ProviderManager, PublishEvent, type PublishEventResult, type PublishStats, RabbitMQClient, type RabbitMQConsumeOptions, type RabbitMQCredentials, type Registration, type RegistrationCreateModel, type RegistrationListResponse, RegistrationManager, RestClient, RuntimeAction, RuntimeActionResponse, type RuntimeActionResponseType, RuntimeApiGatewayService, ShippingCarrier, type ShippingCarrierData, ShippingCarrierMethod, type ShippingCarrierMethodAdditionalData, type ShippingCarrierMethodData, ShippingCarrierResponse, SignatureVerification, SuccessChecker, type SuccessResponse, Telemetry, TelemetryInputError, type TokenResult, Validator, WebhookAction, type WebhookActionAddResponse, type WebhookActionExceptionResponse, WebhookActionOperation, type WebhookActionRemoveResponse, type WebhookActionReplaceResponse, WebhookActionResponse, type WebhookActionResponseType, type WebhookActionSuccessResponse, type WorkspaceConfig };

package/dist/index.d.ts

@@ -788,6 +788,50 @@ declare class OnboardCommerce {
     private logEventSubscriptionSummary;
 }
 
+type RabbitMQCredentials = {
+    host: string;
+    port: string;
+    username: string;
+    password: string;
+    vhost: string;
+    secure?: boolean;
+};
+type RabbitMQConsumeOptions = {
+    batchSize: number;
+    maxParallel: number;
+    nackRequeue?: boolean;
+    exchange?: string;
+};
+type MessageHandler = (queueName: string, content: string) => Promise<void> | void;
+type ConsumeStats = {
+    consumed: number;
+    acked: number;
+    nacked: number;
+    errors: Array<{
+        content: string;
+        error: unknown;
+    }>;
+};
+type PublishStats = {
+    published: number;
+    failed: number;
+    errors: Array<{
+        payload: string;
+        error: unknown;
+    }>;
+};
+
+declare class RabbitMQClient {
+    private readonly credentials;
+    constructor(credentials: RabbitMQCredentials);
+    consume(queueName: string, options: RabbitMQConsumeOptions, handler: MessageHandler): Promise<ConsumeStats>;
+    publish(queueName: string, payloads: string[]): Promise<PublishStats>;
+    private publishBatch;
+    private buildConnectionUrl;
+    private processBatch;
+    private processMessage;
+}
+
 declare class AdobeAuth {
     static getToken(clientId: string, clientSecret: string, technicalAccountId: string, technicalAccountEmail: string, imsOrgId: string, scopes: string[], currentContext?: string): Promise<string>;
 }
@@ -1083,4 +1127,4 @@ declare class AdminUiSdk {
     getRegistration(): AdminUiSdkRegistration;
 }
 
-export { AbdbCollection, type AbdbCollectionCallback, AbdbColumn, type AbdbColumnJson, type AbdbColumnOptions, AbdbColumnType, type AbdbRecord, AbdbRepository, type AbdbRepositoryFilter, type AbdbRunCallback, type AddColumnOptions, AdminUiSdk, type AdminUiSdkRegistration, AdobeAuth, AdobeCommerceClient, type AdobeIMSConfig, type BaseTelemetry, type BaseTelemetryValidator, BasicAuthConnection, BearerToken, type BearerTokenInfo, type CommerceEvent, type CommerceEventConfig, type CommerceEventField, type Connection, type CreateEventResult, CreateEvents, type CreateProviderParams, type CreateProviderResult, type CreateRegistrationResult, CreateRegistrations, type ErrorResponse, EventConsumerAction, type EventData, type EventMetadata, type EventMetadataInputModel, type EventMetadataListResponse, EventMetadataManager, type ExtendedRequestError, type FileMetadata, type FileRecord, FileRepository, GenerateBasicAuthToken, type GetProviderQueryParams, type GetRegistrationQueryParams, GraphQlAction, type HALLink, type Headers, HttpMethod, HttpStatus, IOEventsApiError, type IOEventsError, ImsConnection, ImsToken, type ImsTokenResult, InfiniteLoopBreaker, type InfiniteLoopData, IoEventsGlobals, JsonMessageProcessor, type ListProvidersQueryParams, type ListRegistrationQueryParams, type MenuItem, Oauth1aConnection, OnboardCommerce, type OnboardCommerceConfig, type OnboardCommerceResult, OnboardEvents, type OnboardEventsInput, type OnboardEventsResponse, OnboardEvents as OnboardIOEvents, Openwhisk, OpenwhiskAction, type OpenwhiskConfig, type Page, Parameters, type Provider, type ProviderInputModel, ProviderManager, PublishEvent, type PublishEventResult, type Registration, type RegistrationCreateModel, type RegistrationListResponse, RegistrationManager, RestClient, RuntimeAction, RuntimeActionResponse, type RuntimeActionResponseType, RuntimeApiGatewayService, ShippingCarrier, type ShippingCarrierData, ShippingCarrierMethod, type ShippingCarrierMethodAdditionalData, type ShippingCarrierMethodData, ShippingCarrierResponse, SignatureVerification, SuccessChecker, type SuccessResponse, Telemetry, TelemetryInputError, type TokenResult, Validator, WebhookAction, type WebhookActionAddResponse, type WebhookActionExceptionResponse, WebhookActionOperation, type WebhookActionRemoveResponse, type WebhookActionReplaceResponse, WebhookActionResponse, type WebhookActionResponseType, type WebhookActionSuccessResponse, type WorkspaceConfig };
+export { AbdbCollection, type AbdbCollectionCallback, AbdbColumn, type AbdbColumnJson, type AbdbColumnOptions, AbdbColumnType, type AbdbRecord, AbdbRepository, type AbdbRepositoryFilter, type AbdbRunCallback, type AddColumnOptions, AdminUiSdk, type AdminUiSdkRegistration, AdobeAuth, AdobeCommerceClient, type AdobeIMSConfig, type BaseTelemetry, type BaseTelemetryValidator, BasicAuthConnection, BearerToken, type BearerTokenInfo, type CommerceEvent, type CommerceEventConfig, type CommerceEventField, type Connection, type ConsumeStats, type CreateEventResult, CreateEvents, type CreateProviderParams, type CreateProviderResult, type CreateRegistrationResult, CreateRegistrations, type ErrorResponse, EventConsumerAction, type EventData, type EventMetadata, type EventMetadataInputModel, type EventMetadataListResponse, EventMetadataManager, type ExtendedRequestError, type FileMetadata, type FileRecord, FileRepository, GenerateBasicAuthToken, type GetProviderQueryParams, type GetRegistrationQueryParams, GraphQlAction, type HALLink, type Headers, HttpMethod, HttpStatus, IOEventsApiError, type IOEventsError, ImsConnection, ImsToken, type ImsTokenResult, InfiniteLoopBreaker, type InfiniteLoopData, IoEventsGlobals, JsonMessageProcessor, type ListProvidersQueryParams, type ListRegistrationQueryParams, type MenuItem, type MessageHandler, Oauth1aConnection, OnboardCommerce, type OnboardCommerceConfig, type OnboardCommerceResult, OnboardEvents, type OnboardEventsInput, type OnboardEventsResponse, OnboardEvents as OnboardIOEvents, Openwhisk, OpenwhiskAction, type OpenwhiskConfig, type Page, Parameters, type Provider, type ProviderInputModel, ProviderManager, PublishEvent, type PublishEventResult, type PublishStats, RabbitMQClient, type RabbitMQConsumeOptions, type RabbitMQCredentials, type Registration, type RegistrationCreateModel, type RegistrationListResponse, RegistrationManager, RestClient, RuntimeAction, RuntimeActionResponse, type RuntimeActionResponseType, RuntimeApiGatewayService, ShippingCarrier, type ShippingCarrierData, ShippingCarrierMethod, type ShippingCarrierMethodAdditionalData, type ShippingCarrierMethodData, ShippingCarrierResponse, SignatureVerification, SuccessChecker, type SuccessResponse, Telemetry, TelemetryInputError, type TokenResult, Validator, WebhookAction, type WebhookActionAddResponse, type WebhookActionExceptionResponse, WebhookActionOperation, type WebhookActionRemoveResponse, type WebhookActionReplaceResponse, WebhookActionResponse, type WebhookActionResponseType, type WebhookActionSuccessResponse, type WorkspaceConfig };

package/dist/index.js

@@ -64,6 +64,7 @@ __export(index_exports, {
   Parameters: () => parameters_default,
   ProviderManager: () => provider_default,
   PublishEvent: () => publish_event_default,
+  RabbitMQClient: () => rabbit_mq_client_default,
   RegistrationManager: () => registration_default,
   RestClient: () => rest_client_default,
   RuntimeAction: () => runtime_action_default,
@@ -5946,11 +5947,15 @@ var _AbdbCollection = class _AbdbCollection {
       const collection = await client.collection(this._name);
       return await callback(collection, client);
     } catch (error) {
-      if (error instanceof import_aio_lib_db.DbError) {
-        throw new Error(`AbdbCollection: database error: ${error.message}`);
+      if (import_aio_lib_db.DbError && error instanceof import_aio_lib_db.DbError) {
+        const dbErr = new Error(`AbdbCollection: database error: ${error.message}`);
+        dbErr.cause = error;
+        throw dbErr;
       }
       const detail = error instanceof Error ? error.message : String(error);
-      throw new Error(`AbdbCollection: unexpected error: ${detail}`);
+      const unexpectedErr = new Error(`AbdbCollection: unexpected error: ${detail}`);
+      unexpectedErr.cause = error;
+      throw unexpectedErr;
     } finally {
       await client?.close();
     }
@@ -11757,6 +11762,185 @@ __name(_OnboardCommerce, "OnboardCommerce");
 var OnboardCommerce = _OnboardCommerce;
 var onboard_commerce_default = OnboardCommerce;
 
+// src/integration/rabbit-mq-client/index.ts
+var import_amqplib = __toESM(require("amqplib"));
+var _RabbitMQClient = class _RabbitMQClient {
+  /**
+   * @param credentials - AMQP connection credentials (host, port, username, password, vhost).
+   */
+  constructor(credentials) {
+    this.credentials = credentials;
+  }
+  /**
+   * Opens an AMQP connection, checks queue depth, sets prefetch for concurrency control,
+   * and starts a push consumer. The broker delivers at most `maxParallel` unacked messages
+   * at a time, so processing concurrency is naturally bounded without a separate semaphore.
+   * The consumer is cancelled once `effectiveBatch = min(batchSize, messageCount)` messages
+   * are received and processed. The connection is always closed in a `finally` block.
+   *
+   * @param queueName - Name of the queue to consume from.
+   * @param options - Consume configuration (batchSize, maxParallel, nackRequeue, exchange).
+   * @param handler - Callback invoked with the queue name and decoded string content of each message.
+   * @returns Counts of consumed, acked, and nacked messages; plus per-failure details in `errors`.
+   * @throws Propagates connection, exchange-assertion, or queue-assertion errors to the caller.
+   */
+  async consume(queueName, options, handler) {
+    const connection = await import_amqplib.default.connect(this.buildConnectionUrl());
+    let channel;
+    try {
+      channel = await connection.createChannel();
+      if (options.exchange) {
+        await channel.assertExchange(options.exchange, "direct", { durable: true });
+        await channel.assertQueue(queueName, { durable: true });
+        await channel.bindQueue(queueName, options.exchange, queueName);
+      } else {
+        await channel.assertQueue(queueName, { durable: true });
+      }
+      return await this.processBatch(channel, queueName, options, handler);
+    } finally {
+      await channel?.close();
+      await connection.close();
+    }
+  }
+  /**
+   * Opens an AMQP connection, asserts the queue, and enqueues each payload in `payloads`.
+   * Each payload is sent as a persistent message via `sendToQueue`. If the write buffer is
+   * full (`sendToQueue` returns `false`) or the call throws, the payload is recorded in
+   * `stats.errors` and counted as failed. The connection is always closed in a `finally`
+   * block regardless of outcome.
+   *
+   * @param queueName - Name of the queue to publish to.
+   * @param payloads - Array of string payloads to enqueue.
+   * @returns Counts of published and failed messages; plus per-failure details in `errors`.
+   * @throws Propagates connection or queue-assertion errors to the caller.
+   */
+  async publish(queueName, payloads) {
+    const connection = await import_amqplib.default.connect(this.buildConnectionUrl());
+    let channel;
+    try {
+      channel = await connection.createChannel();
+      await channel.assertQueue(queueName, { durable: true });
+      return this.publishBatch(channel, queueName, payloads);
+    } finally {
+      await channel?.close();
+      await connection.close();
+    }
+  }
+  /**
+   * Sends each payload to the queue via `sendToQueue`. Tracks published and failed counts.
+   * A payload is considered failed when `sendToQueue` returns `false` (write buffer full)
+   * or throws an error.
+   */
+  publishBatch(channel, queueName, payloads) {
+    const stats = { published: 0, failed: 0, errors: [] };
+    for (const payload of payloads) {
+      try {
+        const sent = channel.sendToQueue(queueName, Buffer.from(payload), { persistent: true });
+        if (sent) {
+          stats.published++;
+        } else {
+          stats.failed++;
+          stats.errors.push({ payload, error: new Error("Write buffer full") });
+        }
+      } catch (error) {
+        stats.failed++;
+        stats.errors.push({ payload, error });
+      }
+    }
+    return stats;
+  }
+  /**
+   * Builds the AMQP connection URL from the stored credentials.
+   * Uses `amqps://` when `secure` is true, `amqp://` otherwise.
+   * Username, password, and vhost are percent-encoded to handle special characters.
+   */
+  buildConnectionUrl() {
+    const { host, port, username, password, vhost, secure = false } = this.credentials;
+    const protocol = secure ? "amqps" : "amqp";
+    return `${protocol}://${encodeURIComponent(username)}:${encodeURIComponent(password)}@${host}:${port}/${encodeURIComponent(vhost)}`;
+  }
+  /**
+   * Checks queue depth via `channel.checkQueue`, then sets `channel.prefetch(maxParallel)`
+   * for broker-side concurrency control. Registers a push consumer that receives
+   * `effectiveBatch = min(batchSize, messageCount)` messages. The Promise resolves after
+   * `channel.consume` setup completes and all in-flight handlers have settled.
+   *
+   * Because the broker delivers at most `maxParallel` unacked messages at a time, processing
+   * concurrency is bounded without a separate semaphore — each ack/nack releases a slot.
+   */
+  async processBatch(channel, queueName, options, handler) {
+    const stats = { consumed: 0, acked: 0, nacked: 0, errors: [] };
+    const maxParallel = Math.floor(options.maxParallel);
+    const batchSize = Math.floor(options.batchSize);
+    const { messageCount } = await channel.checkQueue(queueName);
+    if (messageCount === 0) return stats;
+    const effectiveBatch = Math.min(batchSize, messageCount);
+    await channel.prefetch(maxParallel);
+    return new Promise((resolve, reject) => {
+      let consumerTag = "";
+      let cancelRequested = false;
+      let received = 0;
+      let pending = 0;
+      let setupDone = false;
+      const maybeResolve = /* @__PURE__ */ __name(() => {
+        if ((received >= effectiveBatch || cancelRequested) && pending === 0 && setupDone) {
+          resolve(stats);
+        }
+      }, "maybeResolve");
+      const msgCallback = /* @__PURE__ */ __name(async (msg) => {
+        if (!msg || received >= effectiveBatch) return;
+        received++;
+        stats.consumed++;
+        pending++;
+        if (received >= effectiveBatch) {
+          cancelRequested = true;
+          if (consumerTag) {
+            channel.cancel(consumerTag).catch(reject);
+          }
+        }
+        await this.processMessage(channel, queueName, msg, stats, options, handler);
+        pending--;
+        maybeResolve();
+      }, "msgCallback");
+      channel.consume(queueName, msgCallback, { noAck: false }).then(async ({ consumerTag: tag }) => {
+        consumerTag = tag;
+        setupDone = true;
+        if (cancelRequested) {
+          channel.cancel(tag).catch(reject);
+        } else if (received === 0) {
+          const { messageCount: remaining } = await channel.checkQueue(queueName);
+          if (remaining === 0) {
+            cancelRequested = true;
+            channel.cancel(tag).catch(reject);
+          }
+        }
+        maybeResolve();
+      }).catch(reject);
+    });
+  }
+  /**
+   * Invokes `handler` with the queue name and decoded message content. Acks on success.
+   * On failure, nacks the message and records the content and error in `stats.errors`.
+   * Whether to requeue on nack is controlled by `options.nackRequeue` (default: true).
+   */
+  async processMessage(channel, queueName, msg, stats, options, handler) {
+    const { nackRequeue = true } = options;
+    const content = msg.content.toString();
+    try {
+      await handler(queueName, content);
+      channel.ack(msg);
+      stats.acked++;
+    } catch (error) {
+      channel.nack(msg, false, nackRequeue);
+      stats.errors.push({ content, error });
+      stats.nacked++;
+    }
+  }
+};
+__name(_RabbitMQClient, "RabbitMQClient");
+var RabbitMQClient = _RabbitMQClient;
+var rabbit_mq_client_default = RabbitMQClient;
+
 // src/commerce/adobe-commerce-client/index.ts
 var import_got = __toESM(require("got"));
 var _AdobeCommerceClient = class _AdobeCommerceClient {
@@ -12777,6 +12961,7 @@ var AdminUiSdk = _AdminUiSdk;
   Parameters,
   ProviderManager,
   PublishEvent,
+  RabbitMQClient,
   RegistrationManager,
   RestClient,
   RuntimeAction,