@adobe-commerce/aio-toolkit 1.2.2 → 1.2.4

package/dist/index.d.mts

@@ -271,6 +271,16 @@ interface AbdbRecord {
     [key: string]: unknown;
 }
 type AbdbRepositoryFilter = Record<string, unknown>;
+type AbdbFindSortDirection = 'asc' | 'desc';
+type AbdbFindSort = {
+    column: string;
+    direction?: AbdbFindSortDirection;
+};
+type AbdbFindOptions = {
+    current_page?: number;
+    page_size?: number;
+    sort?: AbdbFindSort;
+};
 
 declare class AbdbRepository<T extends AbdbRecord = AbdbRecord> {
     private readonly _collection;
@@ -279,7 +289,7 @@ declare class AbdbRepository<T extends AbdbRecord = AbdbRecord> {
     constructor(collection: AbdbCollection, token: string, region?: string);
     getName(): string;
     getCollection(): AbdbCollection;
-    find(filter?: AbdbRepositoryFilter): Promise<T[]>;
+    find(filter?: AbdbRepositoryFilter, options?: AbdbFindOptions): Promise<T[]>;
     findOne(filter: AbdbRepositoryFilter): Promise<T | null>;
     findById(id: string): Promise<T | null>;
     delete(filter?: AbdbRepositoryFilter): Promise<Record<string, any>>;
@@ -329,7 +339,7 @@ interface WebhookActionSuccessResponse {
 }
 interface WebhookActionExceptionResponse {
     op: typeof WebhookActionOperation.EXCEPTION;
-    class?: string;
+    type?: string;
     message?: string;
 }
 interface WebhookActionAddResponse {
@@ -375,7 +385,7 @@ declare class WebhookAction {
 
 declare class WebhookActionResponse {
     static success(): WebhookActionSuccessResponse;
-    static exception(message?: string, exceptionClass?: string): WebhookActionExceptionResponse;
+    static exception(message?: string, exceptionType?: string): WebhookActionExceptionResponse;
     static add(path: string, value: any, instance?: string): WebhookActionAddResponse;
     static replace(path: string, value: any, instance?: string): WebhookActionReplaceResponse;
     static remove(path: string): WebhookActionRemoveResponse;
@@ -788,6 +798,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 +1137,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 AbdbFindOptions, type AbdbFindSort, type AbdbFindSortDirection, 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

@@ -271,6 +271,16 @@ interface AbdbRecord {
     [key: string]: unknown;
 }
 type AbdbRepositoryFilter = Record<string, unknown>;
+type AbdbFindSortDirection = 'asc' | 'desc';
+type AbdbFindSort = {
+    column: string;
+    direction?: AbdbFindSortDirection;
+};
+type AbdbFindOptions = {
+    current_page?: number;
+    page_size?: number;
+    sort?: AbdbFindSort;
+};
 
 declare class AbdbRepository<T extends AbdbRecord = AbdbRecord> {
     private readonly _collection;
@@ -279,7 +289,7 @@ declare class AbdbRepository<T extends AbdbRecord = AbdbRecord> {
     constructor(collection: AbdbCollection, token: string, region?: string);
     getName(): string;
     getCollection(): AbdbCollection;
-    find(filter?: AbdbRepositoryFilter): Promise<T[]>;
+    find(filter?: AbdbRepositoryFilter, options?: AbdbFindOptions): Promise<T[]>;
     findOne(filter: AbdbRepositoryFilter): Promise<T | null>;
     findById(id: string): Promise<T | null>;
     delete(filter?: AbdbRepositoryFilter): Promise<Record<string, any>>;
@@ -329,7 +339,7 @@ interface WebhookActionSuccessResponse {
 }
 interface WebhookActionExceptionResponse {
     op: typeof WebhookActionOperation.EXCEPTION;
-    class?: string;
+    type?: string;
     message?: string;
 }
 interface WebhookActionAddResponse {
@@ -375,7 +385,7 @@ declare class WebhookAction {
 
 declare class WebhookActionResponse {
     static success(): WebhookActionSuccessResponse;
-    static exception(message?: string, exceptionClass?: string): WebhookActionExceptionResponse;
+    static exception(message?: string, exceptionType?: string): WebhookActionExceptionResponse;
     static add(path: string, value: any, instance?: string): WebhookActionAddResponse;
     static replace(path: string, value: any, instance?: string): WebhookActionReplaceResponse;
     static remove(path: string): WebhookActionRemoveResponse;
@@ -788,6 +798,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 +1137,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 AbdbFindOptions, type AbdbFindSort, type AbdbFindSortDirection, 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();
     }
@@ -6043,13 +6048,31 @@ var _AbdbRepository = class _AbdbRepository {
    * Returns all documents matching `filter` as an array.
    * Passing no filter (or an empty object) returns every document in the collection.
    *
+   * Pagination and sorting are applied in the following MongoDB cursor order:
+   * `.find(filter)` → `.sort(...)` → `.skip(...)` → `.limit(...)` → `.toArray()`
+   *
    * @param filter - Optional query filter (default: `{}`)
+   * @param options - Optional pagination and sort configuration
+   * @param options.sort - Column and direction to sort by (`'asc'` maps to `1`, `'desc'` to `-1`)
+   * @param options.page_size - Maximum number of documents to return
+   * @param options.current_page - 1-based page index; combined with `page_size` to compute `.skip()`
    * @returns Array of matched documents (may be empty)
    */
-  async find(filter = {}) {
+  async find(filter = {}, options = {}) {
     return this._collection.run(
       async (collection) => {
-        return collection.find(filter).toArray();
+        const { current_page, page_size, sort } = options;
+        let cursor = collection.find(filter);
+        if (sort?.column) {
+          cursor = cursor.sort({ [sort.column]: sort.direction === "desc" ? -1 : 1 });
+        }
+        if (page_size !== void 0 && page_size > 0) {
+          if (current_page !== void 0 && current_page > 1) {
+            cursor = cursor.skip((current_page - 1) * page_size);
+          }
+          cursor = cursor.limit(page_size);
+        }
+        return cursor.toArray();
       },
       this._token,
       this._region
@@ -6470,7 +6493,7 @@ var _WebhookActionResponse = class _WebhookActionResponse {
    * processing the webhook. This helps with debugging and error tracking.
    *
    * @param message - Optional error message describing what went wrong
-   * @param exceptionClass - Optional exception class name for categorization (e.g., 'Magento\\Framework\\Exception\\LocalizedException')
+   * @param exceptionType - Optional exception type name for categorization (e.g., 'Magento\\Framework\\Exception\\LocalizedException')
    * @returns An exception response object
    *
    * @example
@@ -6492,15 +6515,15 @@ var _WebhookActionResponse = class _WebhookActionResponse {
    * });
    * ```
    */
-  static exception(message, exceptionClass) {
+  static exception(message, exceptionType) {
     const response = {
       op: "exception" /* EXCEPTION */
     };
     if (message !== void 0) {
       response.message = message;
     }
-    if (exceptionClass !== void 0) {
-      response.class = exceptionClass;
+    if (exceptionType !== void 0) {
+      response.type = exceptionType;
     }
     return response;
   }
@@ -11757,6 +11780,166 @@ __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, and pulls up to
+   * `effectiveBatch = min(batchSize, messageCount)` messages via channel.get.
+   * Messages are processed in parallel windows of `maxParallel`. channel.get returns
+   * false when the queue is empty, so the method exits deterministically without any
+   * cancellation logic. 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 {
+      try {
+        await channel?.close();
+      } catch {
+      }
+      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`), the message is still counted as published and the
+   * method waits for the channel's `drain` event before continuing, to respect backpressure
+   * without losing messages. Only genuine send errors (thrown exceptions) are counted as
+   * failures. 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 await this.publishBatch(channel, queueName, payloads);
+    } finally {
+      try {
+        await channel?.close();
+      } catch {
+      }
+      await connection.close();
+    }
+  }
+  /**
+   * Sends each payload to the queue via `sendToQueue`. Tracks published and failed counts.
+   * When `sendToQueue` returns `false` (write buffer full / backpressure), the message is
+   * still counted as published — it is already accepted by the channel — and the loop
+   * pauses until the channel emits `drain` before continuing, preventing unbounded memory
+   * pressure. A payload is only counted as failed when `sendToQueue` throws an error.
+   */
+  async 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 });
+        stats.published++;
+        if (!sent) {
+          await new Promise((resolve) => channel.once("drain", resolve));
+        }
+      } 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 pulls up to
+   * `effectiveBatch = min(batchSize, messageCount)` messages using channel.get
+   * (AMQP basic.get). Messages are processed in parallel windows of `maxParallel`:
+   * each window pulls up to `maxParallel` messages sequentially, then processes them
+   * concurrently via Promise.all before moving to the next window.
+   *
+   * channel.get returns false when the queue is empty, so the loop exits immediately
+   * if siblings have drained the queue — no consumer registration, no cancel, no hang.
+   */
+  async processBatch(channel, queueName, options, handler) {
+    const stats = { consumed: 0, acked: 0, nacked: 0, errors: [] };
+    const { batchSize, maxParallel } = options;
+    const { messageCount } = await channel.checkQueue(queueName);
+    if (messageCount === 0) return stats;
+    const effectiveBatch = Math.min(batchSize, messageCount);
+    while (stats.consumed < effectiveBatch) {
+      const windowSize = Math.min(maxParallel, effectiveBatch - stats.consumed);
+      const window = [];
+      for (let i = 0; i < windowSize; i++) {
+        const msg = await channel.get(queueName, { noAck: false });
+        if (!msg) break;
+        window.push(msg);
+        stats.consumed++;
+      }
+      if (window.length === 0) break;
+      await Promise.all(
+        window.map((msg) => this.processMessage(channel, queueName, msg, stats, options, handler))
+      );
+      if (window.length < windowSize) break;
+    }
+    return stats;
+  }
+  /**
+   * 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 +12960,7 @@ var AdminUiSdk = _AdminUiSdk;
   Parameters,
   ProviderManager,
   PublishEvent,
+  RabbitMQClient,
   RegistrationManager,
   RestClient,
   RuntimeAction,