@adobe-commerce/aio-toolkit 1.0.6 → 1.0.7

package/dist/index.mjs

@@ -5551,6 +5551,7 @@ var _OnboardCommerce = class _OnboardCommerce {
    * @param merchantId - Merchant ID for Adobe Commerce
    * @param environmentId - Environment ID for Adobe Commerce
    * @param logger - Optional logger instance for logging operations
+   * @param isPaaS - Flag to indicate if the Commerce instance is PaaS (defaults to false)
    * @throws {Error} When required parameters are missing or invalid
    * @example
    * ```typescript
@@ -5563,7 +5564,7 @@ var _OnboardCommerce = class _OnboardCommerce {
    * );
    * ```
    */
-  constructor(adobeCommerceClient, merchantId, environmentId, logger = null) {
+  constructor(adobeCommerceClient, merchantId, environmentId, logger = null, isPaaS = false) {
     if (!adobeCommerceClient) {
       throw new Error("Adobe Commerce client is required");
     }
@@ -5576,6 +5577,7 @@ var _OnboardCommerce = class _OnboardCommerce {
     this.adobeCommerceClient = adobeCommerceClient;
     this.merchantId = merchantId;
     this.environmentId = environmentId;
+    this.isPaaS = isPaaS;
     this.customLogger = new custom_logger_default(logger);
     this.configureProvider = new configure_provider_default(
       adobeCommerceClient,
@@ -5632,16 +5634,22 @@ var _OnboardCommerce = class _OnboardCommerce {
             `[FETCH] Retrieved ${existingSubscriptions.length} existing event subscription(s)`
           );
         }
-        this.customLogger.debug("[FETCH] Fetching supported events list...");
-        const supportedEventsResult = await this.eventService.supportedList();
         let supportedEvents = [];
-        if (!supportedEventsResult.success) {
-          this.customLogger.error(
-            `[ERROR] Failed to fetch supported events: ${supportedEventsResult.error}`
-          );
+        if (!this.isPaaS) {
+          this.customLogger.debug("[FETCH] Fetching supported events list...");
+          const supportedEventsResult = await this.eventService.supportedList();
+          if (!supportedEventsResult.success) {
+            this.customLogger.error(
+              `[ERROR] Failed to fetch supported events: ${supportedEventsResult.error}`
+            );
+          } else {
+            supportedEvents = Array.isArray(supportedEventsResult.data) ? supportedEventsResult.data : [];
+            this.customLogger.debug(
+              `[FETCH] Retrieved ${supportedEvents.length} supported event(s)`
+            );
+          }
         } else {
-          supportedEvents = Array.isArray(supportedEventsResult.data) ? supportedEventsResult.data : [];
-          this.customLogger.debug(`[FETCH] Retrieved ${supportedEvents.length} supported event(s)`);
+          this.customLogger.debug("[SKIP] Skipping supported events validation for PaaS instance");
         }
         const { alreadySubscribed, needsSubscription, unsupported } = this.filterEventsBySubscriptionStatus(
           commerceEventsConfig,
@@ -5684,6 +5692,15 @@ ${JSON.stringify(preparedEvent.event, null, 2)}`
           }
         }
         this.logEventSubscriptionSummary(result, provider.label);
+        if (this.isPaaS) {
+          this.customLogger.info("[IMPORTANT] \u26A0\uFE0F  Post-Subscription Steps for PaaS:");
+          this.customLogger.info(
+            "[IMPORTANT] 1. Run: bin/magento events:generate:module to generate module after successful event subscription"
+          );
+          this.customLogger.info(
+            "[IMPORTANT] 2. Run: bin/magento setup:upgrade && bin/magento setup:di:compile && bin/magento cache:flush to install the generated module"
+          );
+        }
       }
       return {
         success: true,
@@ -5741,6 +5758,10 @@ ${JSON.stringify(preparedEvent.event, null, 2)}`
   /**
    * Prepares event payload by transforming event names and adding provider information
    *
+   * For PaaS instances, the parent field is omitted to support native events (observer.*, plugin.*)
+   * which would be rejected by Adobe Commerce as invalid aliases if parent is set to the same name.
+   * For non-PaaS instances, the parent field is set to the event name as usual.
+   *
    * @param eventSpec - Event specification object containing event details
    * @param providerId - Provider ID to assign to the event
    * @returns Modified event specification with updated event properties
@@ -5757,12 +5778,18 @@ ${JSON.stringify(preparedEvent.event, null, 2)}`
       throw new Error("Valid provider ID is required");
     }
     const modifiedEventSpec = JSON.parse(JSON.stringify(eventSpec));
-    modifiedEventSpec.event.parent = modifiedEventSpec.event.name;
+    const eventName = modifiedEventSpec.event.name;
+    if (!this.isPaaS) {
+      modifiedEventSpec.event.parent = eventName;
+    }
     modifiedEventSpec.event.provider_id = providerId;
     modifiedEventSpec.event.destination = "default";
     modifiedEventSpec.event.provider_id = providerId;
     modifiedEventSpec.event.priority = true;
     modifiedEventSpec.event.hipaa_audit_required = false;
+    if (!modifiedEventSpec.event.rules) {
+      modifiedEventSpec.event.rules = [];
+    }
     return modifiedEventSpec;
   }
   /**