@adobe-commerce/aio-experience-kit 1.0.1 → 1.0.3

package/dist/esm/utils/AdminUiSdk/index.js

@@ -1,27 +1,18 @@
-import { createClass as _createClass, toConsumableArray as _toConsumableArray, asyncToGenerator as _asyncToGenerator, regenerator as _regenerator, classCallCheck as _classCallCheck } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { createClass as _createClass, asyncToGenerator as _asyncToGenerator, regenerator as _regenerator, classCallCheck as _classCallCheck } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import { attach, register } from '@adobe/uix-guest';
 
 /**
- * AdminUiSdk - Utility for managing Adobe Admin UI extension registrations
+ * AdminUiSdk - Utility for managing Adobe Admin UI extensions
  *
  * @example
  * ```typescript
  * const sdk = new AdminUiSdk('admin_ui_extensibility');
  *
- * // Add a menu section (ID will be prefixed automatically: 'admin_ui_extensibility::apps')
- * sdk.addMenuSection('apps', 'Apps', 100);
- *
- * // Add a menu item (ID and parent will be prefixed automatically)
- * sdk.addMenuItem('first', 'First App on App Builder', 1, 'apps');
- *
- * // Add page configuration
- * sdk.addPage('Adobe Commerce First App on App Builder');
- *
- * // Get registration object
- * const registration = sdk.getRegistration();
- *
  * // Register with Adobe UIX
  * await sdk.registerExtension();
+ *
+ * // Get credentials
+ * const credentials = await sdk.getCredentials();
  * ```
  */
 var AdminUiSdk = /*#__PURE__*/function () {
@@ -32,8 +23,6 @@ var AdminUiSdk = /*#__PURE__*/function () {
    */
   function AdminUiSdk(extensionId) {
     _classCallCheck(this, AdminUiSdk);
-    this.menuItems = [];
-    this.pageTitle = null;
     if (!(extensionId !== null && extensionId !== void 0 && extensionId.trim())) {
       throw new Error('Extension ID is required and cannot be empty');
     }
@@ -53,130 +42,6 @@ var AdminUiSdk = /*#__PURE__*/function () {
     value: function isValidId(id) {
       return /^[a-zA-Z0-9_]+$/.test(id);
     }
-    /**
-     * Adds a menu item to the extension
-     * @param id - Unique identifier for the menu item (will be prefixed with extensionId)
-     * @param title - Display title for the menu item
-     * @param sortOrder - Sort order for menu positioning
-     * @param parent - Parent menu identifier (optional, will be prefixed with extensionId if provided)
-     * @throws {Error} If parameters are invalid or ID already exists
-     */
-  }, {
-    key: "addMenuItem",
-    value: function addMenuItem(id, title, sortOrder, parent) {
-      // Validation
-      if (!(id !== null && id !== void 0 && id.trim())) {
-        throw new Error('Menu item ID is required and cannot be empty');
-      }
-      if (!this.isValidId(id.trim())) {
-        throw new Error('Menu item ID must be alphanumeric with underscores only (no spaces, hyphens, or special characters)');
-      }
-      if (!(title !== null && title !== void 0 && title.trim())) {
-        throw new Error('Menu item title is required and cannot be empty');
-      }
-      if (parent !== undefined && !(parent !== null && parent !== void 0 && parent.trim())) {
-        throw new Error('Menu item parent cannot be empty if provided');
-      }
-      if (parent !== undefined && !this.isValidId(parent.trim())) {
-        throw new Error('Menu item parent must be alphanumeric with underscores only (no spaces, hyphens, or special characters)');
-      }
-      if (typeof sortOrder !== 'number' || sortOrder < 0) {
-        throw new Error('Menu item sortOrder must be a non-negative number');
-      }
-      // Create full ID with extension prefix
-      var fullId = "".concat(this.extensionId, "::").concat(id.trim());
-      // Check for duplicate IDs
-      if (this.menuItems.some(function (item) {
-        return item.id === fullId;
-      })) {
-        throw new Error("Menu item with ID '".concat(fullId, "' already exists"));
-      }
-      // Build menu item object - only include parent if provided
-      var menuItem = {
-        id: fullId,
-        title: title.trim(),
-        sortOrder: sortOrder
-      };
-      if (parent !== null && parent !== void 0 && parent.trim()) {
-        menuItem.parent = "".concat(this.extensionId, "::").concat(parent.trim());
-      }
-      // Add sanitized menu item
-      this.menuItems.push(menuItem);
-    }
-    /**
-     * Adds a menu section to the extension
-     * @param id - Unique identifier for the menu section (will be prefixed with extensionId)
-     * @param title - Display title for the menu section
-     * @param sortOrder - Sort order for section positioning
-     * @throws {Error} If parameters are invalid or ID already exists
-     */
-  }, {
-    key: "addMenuSection",
-    value: function addMenuSection(id, title, sortOrder) {
-      // Validation
-      if (!(id !== null && id !== void 0 && id.trim())) {
-        throw new Error('Menu section ID is required and cannot be empty');
-      }
-      if (!this.isValidId(id.trim())) {
-        throw new Error('Menu section ID must be alphanumeric with underscores only (no spaces, hyphens, or special characters)');
-      }
-      if (!(title !== null && title !== void 0 && title.trim())) {
-        throw new Error('Menu section title is required and cannot be empty');
-      }
-      if (typeof sortOrder !== 'number' || sortOrder < 0) {
-        throw new Error('Menu section sortOrder must be a non-negative number');
-      }
-      // Create full ID with extension prefix
-      var fullId = "".concat(this.extensionId, "::").concat(id.trim());
-      // Check for duplicate IDs
-      if (this.menuItems.some(function (item) {
-        return item.id === fullId;
-      })) {
-        throw new Error("Menu item with ID '".concat(fullId, "' already exists"));
-      }
-      // Add sanitized menu section with isSection: true
-      this.menuItems.push({
-        id: fullId,
-        title: title.trim(),
-        sortOrder: sortOrder,
-        isSection: true
-      });
-    }
-    /**
-     * Sets the page title for the extension
-     * @param title - The page title
-     * @throws {Error} If title is empty or invalid
-     */
-  }, {
-    key: "addPage",
-    value: function addPage(title) {
-      if (!(title !== null && title !== void 0 && title.trim())) {
-        throw new Error('Page title is required and cannot be empty');
-      }
-      this.pageTitle = title.trim();
-    }
-    /**
-     * Gets the complete registration object for the extension
-     * @returns The registration object with optional menu items and page configuration
-     */
-  }, {
-    key: "getRegistration",
-    value: function getRegistration() {
-      var registration = {};
-      // Only include menuItems if there are any
-      if (this.menuItems.length > 0) {
-        registration.menuItems = _toConsumableArray(this.menuItems); // Return copy to prevent mutation
-      }
-      // Only include page if title is set
-      if (this.pageTitle) {
-        registration.page = {
-          title: this.pageTitle
-        };
-      }
-      return {
-        registration: registration
-      };
-    }
     /**
      * Gets IMS credentials from Adobe UIX shared context
      * @returns Promise resolving to credentials object with imsToken and imsOrgId

package/dist/esm/utils/AdminUiSdk/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../../src/utils/AdminUiSdk/index.ts"],"sourcesContent":["/**\n * <license header>\n */\n\nimport { register, attach } from '@adobe/uix-guest';\nimport {\n  MenuItem,\n  AdminUiSdkRegistration,\n  AdminUiSdkInterface,\n  AdminUiSdkCredentials,\n} from './types';\n\n/**\n * AdminUiSdk - Utility for managing Adobe Admin UI extension registrations\n *\n * @example\n * ```typescript\n * const sdk = new AdminUiSdk('admin_ui_extensibility');\n *\n * // Add a menu section (ID will be prefixed automatically: 'admin_ui_extensibility::apps')\n * sdk.addMenuSection('apps', 'Apps', 100);\n *\n * // Add a menu item (ID and parent will be prefixed automatically)\n * sdk.addMenuItem('first', 'First App on App Builder', 1, 'apps');\n *\n * // Add page configuration\n * sdk.addPage('Adobe Commerce First App on App Builder');\n *\n * // Get registration object\n * const registration = sdk.getRegistration();\n *\n * // Register with Adobe UIX\n * await sdk.registerExtension();\n * ```\n */\nclass AdminUiSdk implements AdminUiSdkInterface {\n  private readonly extensionId: string;\n  private readonly menuItems: MenuItem[] = [];\n  private pageTitle: string | null = null;\n\n  /**\n   * Creates a new AdminUiSdk instance\n   * @param extensionId - Unique identifier for the extension\n   * @throws {Error} If extensionId is empty or invalid\n   */\n  constructor(extensionId: string) {\n    if (!extensionId?.trim()) {\n      throw new Error('Extension ID is required and cannot be empty');\n    }\n\n    const trimmedId = extensionId.trim();\n    if (!this.isValidId(trimmedId)) {\n      throw new Error(\n        'Extension ID must be alphanumeric with underscores only (no spaces, hyphens, or special characters)'\n      );\n    }\n\n    this.extensionId = trimmedId;\n  }\n\n  /**\n   * Validates that an ID contains only alphanumeric characters and underscores\n   * @param id - The ID to validate\n   * @returns true if valid, false otherwise\n   */\n  private isValidId(id: string): boolean {\n    return /^[a-zA-Z0-9_]+$/.test(id);\n  }\n\n  /**\n   * Adds a menu item to the extension\n   * @param id - Unique identifier for the menu item (will be prefixed with extensionId)\n   * @param title - Display title for the menu item\n   * @param sortOrder - Sort order for menu positioning\n   * @param parent - Parent menu identifier (optional, will be prefixed with extensionId if provided)\n   * @throws {Error} If parameters are invalid or ID already exists\n   */\n  addMenuItem(id: string, title: string, sortOrder: number, parent?: string): void {\n    // Validation\n    if (!id?.trim()) {\n      throw new Error('Menu item ID is required and cannot be empty');\n    }\n    if (!this.isValidId(id.trim())) {\n      throw new Error(\n        'Menu item ID must be alphanumeric with underscores only (no spaces, hyphens, or special characters)'\n      );\n    }\n    if (!title?.trim()) {\n      throw new Error('Menu item title is required and cannot be empty');\n    }\n    if (parent !== undefined && !parent?.trim()) {\n      throw new Error('Menu item parent cannot be empty if provided');\n    }\n    if (parent !== undefined && !this.isValidId(parent.trim())) {\n      throw new Error(\n        'Menu item parent must be alphanumeric with underscores only (no spaces, hyphens, or special characters)'\n      );\n    }\n    if (typeof sortOrder !== 'number' || sortOrder < 0) {\n      throw new Error('Menu item sortOrder must be a non-negative number');\n    }\n\n    // Create full ID with extension prefix\n    const fullId = `${this.extensionId}::${id.trim()}`;\n\n    // Check for duplicate IDs\n    if (this.menuItems.some(item => item.id === fullId)) {\n      throw new Error(`Menu item with ID '${fullId}' already exists`);\n    }\n\n    // Build menu item object - only include parent if provided\n    const menuItem: MenuItem = {\n      id: fullId,\n      title: title.trim(),\n      sortOrder,\n    };\n\n    if (parent?.trim()) {\n      menuItem.parent = `${this.extensionId}::${parent.trim()}`;\n    }\n\n    // Add sanitized menu item\n    this.menuItems.push(menuItem);\n  }\n\n  /**\n   * Adds a menu section to the extension\n   * @param id - Unique identifier for the menu section (will be prefixed with extensionId)\n   * @param title - Display title for the menu section\n   * @param sortOrder - Sort order for section positioning\n   * @throws {Error} If parameters are invalid or ID already exists\n   */\n  addMenuSection(id: string, title: string, sortOrder: number): void {\n    // Validation\n    if (!id?.trim()) {\n      throw new Error('Menu section ID is required and cannot be empty');\n    }\n    if (!this.isValidId(id.trim())) {\n      throw new Error(\n        'Menu section ID must be alphanumeric with underscores only (no spaces, hyphens, or special characters)'\n      );\n    }\n    if (!title?.trim()) {\n      throw new Error('Menu section title is required and cannot be empty');\n    }\n    if (typeof sortOrder !== 'number' || sortOrder < 0) {\n      throw new Error('Menu section sortOrder must be a non-negative number');\n    }\n\n    // Create full ID with extension prefix\n    const fullId = `${this.extensionId}::${id.trim()}`;\n\n    // Check for duplicate IDs\n    if (this.menuItems.some(item => item.id === fullId)) {\n      throw new Error(`Menu item with ID '${fullId}' already exists`);\n    }\n\n    // Add sanitized menu section with isSection: true\n    this.menuItems.push({\n      id: fullId,\n      title: title.trim(),\n      sortOrder,\n      isSection: true,\n    });\n  }\n\n  /**\n   * Sets the page title for the extension\n   * @param title - The page title\n   * @throws {Error} If title is empty or invalid\n   */\n  addPage(title: string): void {\n    if (!title?.trim()) {\n      throw new Error('Page title is required and cannot be empty');\n    }\n    this.pageTitle = title.trim();\n  }\n\n  /**\n   * Gets the complete registration object for the extension\n   * @returns The registration object with optional menu items and page configuration\n   */\n  getRegistration(): AdminUiSdkRegistration {\n    const registration: any = {};\n\n    // Only include menuItems if there are any\n    if (this.menuItems.length > 0) {\n      registration.menuItems = [...this.menuItems]; // Return copy to prevent mutation\n    }\n\n    // Only include page if title is set\n    if (this.pageTitle) {\n      registration.page = {\n        title: this.pageTitle,\n      };\n    }\n\n    return {\n      registration,\n    };\n  }\n\n  /**\n   * Gets IMS credentials from Adobe UIX shared context\n   * @returns Promise resolving to credentials object with imsToken and imsOrgId\n   * @throws {Error} If credentials retrieval fails\n   */\n  async getCredentials(): Promise<AdminUiSdkCredentials> {\n    try {\n      const guestConnection = await attach({ id: this.extensionId });\n      const imsToken = guestConnection?.sharedContext?.get('imsToken') || null;\n      const imsOrgId = guestConnection?.sharedContext?.get('imsOrgId') || null;\n\n      return {\n        imsToken,\n        imsOrgId,\n      };\n    } catch (error) {\n      throw new Error(\n        `Failed to get credentials for extension '${this.extensionId}': ${error instanceof Error ? error.message : 'Unknown error'}`\n      );\n    }\n  }\n\n  /**\n   * Registers the extension with Adobe UIX\n   * @throws {Error} If registration fails\n   */\n  async registerExtension(): Promise<void> {\n    try {\n      await register({\n        id: this.extensionId,\n        methods: {},\n      });\n    } catch (error) {\n      throw new Error(\n        `Failed to register extension '${this.extensionId}': ${error instanceof Error ? error.message : 'Unknown error'}`\n      );\n    }\n  }\n}\n\nexport default AdminUiSdk;\n\n// Re-export types for external use\nexport type {\n  MenuItem,\n  PageConfig,\n  Registration,\n  AdminUiSdkRegistration,\n  AdminUiSdkInterface,\n  AdminUiSdkCredentials,\n} from './types';\n"],"names":["AdminUiSdk","extensionId","_classCallCheck","menuItems","pageTitle","trim","Error","trimmedId","isValidId","_createClass","key","value","id","test","addMenuItem","title","sortOrder","parent","undefined","fullId","concat","some","item","menuItem","push","addMenuSection","isSection","addPage","getRegistration","registration","length","_toConsumableArray","page","_getCredentials","_asyncToGenerator","_regenerator","m","_callee","_guestConnection$shar","_guestConnection$shar2","guestConnection","imsToken","imsOrgId","_t","w","_context","p","n","attach","v","sharedContext","get","a","message","getCredentials","apply","arguments","_registerExtension","_callee2","_t2","_context2","register","methods","registerExtension"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../../../src/utils/AdminUiSdk/index.ts"],"sourcesContent":["/**\n * <license header>\n */\n\nimport { register, attach } from '@adobe/uix-guest';\nimport { AdminUiSdkInterface, AdminUiSdkCredentials } from './types';\n\n/**\n * AdminUiSdk - Utility for managing Adobe Admin UI extensions\n *\n * @example\n * ```typescript\n * const sdk = new AdminUiSdk('admin_ui_extensibility');\n *\n * // Register with Adobe UIX\n * await sdk.registerExtension();\n *\n * // Get credentials\n * const credentials = await sdk.getCredentials();\n * ```\n */\nclass AdminUiSdk implements AdminUiSdkInterface {\n  private readonly extensionId: string;\n\n  /**\n   * Creates a new AdminUiSdk instance\n   * @param extensionId - Unique identifier for the extension\n   * @throws {Error} If extensionId is empty or invalid\n   */\n  constructor(extensionId: string) {\n    if (!extensionId?.trim()) {\n      throw new Error('Extension ID is required and cannot be empty');\n    }\n\n    const trimmedId = extensionId.trim();\n    if (!this.isValidId(trimmedId)) {\n      throw new Error(\n        'Extension ID must be alphanumeric with underscores only (no spaces, hyphens, or special characters)'\n      );\n    }\n\n    this.extensionId = trimmedId;\n  }\n\n  /**\n   * Validates that an ID contains only alphanumeric characters and underscores\n   * @param id - The ID to validate\n   * @returns true if valid, false otherwise\n   */\n  private isValidId(id: string): boolean {\n    return /^[a-zA-Z0-9_]+$/.test(id);\n  }\n\n  /**\n   * Gets IMS credentials from Adobe UIX shared context\n   * @returns Promise resolving to credentials object with imsToken and imsOrgId\n   * @throws {Error} If credentials retrieval fails\n   */\n  async getCredentials(): Promise<AdminUiSdkCredentials> {\n    try {\n      const guestConnection = await attach({ id: this.extensionId });\n      const imsToken = guestConnection?.sharedContext?.get('imsToken') || null;\n      const imsOrgId = guestConnection?.sharedContext?.get('imsOrgId') || null;\n\n      return {\n        imsToken,\n        imsOrgId,\n      };\n    } catch (error) {\n      throw new Error(\n        `Failed to get credentials for extension '${this.extensionId}': ${error instanceof Error ? error.message : 'Unknown error'}`\n      );\n    }\n  }\n\n  /**\n   * Registers the extension with Adobe UIX\n   * @throws {Error} If registration fails\n   */\n  async registerExtension(): Promise<void> {\n    try {\n      await register({\n        id: this.extensionId,\n        methods: {},\n      });\n    } catch (error) {\n      throw new Error(\n        `Failed to register extension '${this.extensionId}': ${error instanceof Error ? error.message : 'Unknown error'}`\n      );\n    }\n  }\n}\n\nexport default AdminUiSdk;\n\n// Re-export types for external use\nexport type { AdminUiSdkInterface, AdminUiSdkCredentials } from './types';\n"],"names":["AdminUiSdk","extensionId","_classCallCheck","trim","Error","trimmedId","isValidId","_createClass","key","value","id","test","_getCredentials","_asyncToGenerator","_regenerator","m","_callee","_guestConnection$shar","_guestConnection$shar2","guestConnection","imsToken","imsOrgId","_t","w","_context","p","n","attach","v","sharedContext","get","a","concat","message","getCredentials","apply","arguments","_registerExtension","_callee2","_t2","_context2","register","methods","registerExtension"],"mappings":";;;AAOA;;;;;;;;;;;;;AAaG;AAbH,IAcMA,UAAU,gBAAA,YAAA;AAGd;;;;AAIG;EACH,SAAAA,UAAAA,CAAYC,WAAmB,EAAA;AAAAC,IAAAA,eAAA,OAAAF,UAAA,CAAA;IAC7B,IAAI,EAACC,WAAW,KAAA,IAAA,IAAXA,WAAW,KAAA,MAAA,IAAXA,WAAW,CAAEE,IAAI,EAAE,CAAA,EAAE;AACxB,MAAA,MAAM,IAAIC,KAAK,CAAC,8CAA8C,CAAC;AACjE,IAAA;AAEA,IAAA,IAAMC,SAAS,GAAGJ,WAAW,CAACE,IAAI,EAAE;AACpC,IAAA,IAAI,CAAC,IAAI,CAACG,SAAS,CAACD,SAAS,CAAC,EAAE;AAC9B,MAAA,MAAM,IAAID,KAAK,CACb,qGAAqG,CACtG;AACH,IAAA;IAEA,IAAI,CAACH,WAAW,GAAGI,SAAS;AAC9B,EAAA;AAEA;;;;AAIG;EAJH,OAAAE,YAAA,CAAAP,UAAA,EAAA,CAAA;IAAAQ,GAAA,EAAA,WAAA;AAAAC,IAAAA,KAAA,EAKQ,SAAAH,SAASA,CAACI,EAAU,EAAA;AAC1B,MAAA,OAAO,iBAAiB,CAACC,IAAI,CAACD,EAAE,CAAC;AACnC,IAAA;AAEA;;;;AAIG;AAJH,GAAA,EAAA;IAAAF,GAAA,EAAA,gBAAA;IAAAC,KAAA,GAAA,YAAA;MAAA,IAAAG,eAAA,GAAAC,iBAAA,cAAAC,YAAA,EAAA,CAAAC,CAAA,CAKA,SAAAC,OAAAA,GAAA;QAAA,IAAAC,qBAAA,EAAAC,sBAAA,EAAAC,eAAA,EAAAC,QAAA,EAAAC,QAAA,EAAAC,EAAA;AAAA,QAAA,OAAAR,YAAA,EAAA,CAAAS,CAAA,CAAA,UAAAC,QAAA,EAAA;AAAA,UAAA,OAAA,CAAA,EAAA,QAAAA,QAAA,CAAAC,CAAA,GAAAD,QAAA,CAAAE,CAAA;AAAA,YAAA,KAAA,CAAA;AAAAF,cAAAA,QAAA,CAAAC,CAAA,GAAA,CAAA;AAAAD,cAAAA,QAAA,CAAAE,CAAA,GAAA,CAAA;AAAA,cAAA,OAEkCC,MAAM,CAAC;gBAAEjB,EAAE,EAAE,IAAI,CAACT;AAAW,eAAE,CAAC;AAAA,YAAA,KAAA,CAAA;cAAxDkB,eAAe,GAAAK,QAAA,CAAAI,CAAA;cACfR,QAAQ,GAAG,CAAAD,eAAe,KAAA,IAAA,IAAfA,eAAe,KAAA,MAAA,IAAA,CAAAF,qBAAA,GAAfE,eAAe,CAAEU,aAAa,MAAA,IAAA,IAAAZ,qBAAA,uBAA9BA,qBAAA,CAAgCa,GAAG,CAAC,UAAU,CAAC,KAAI,IAAI;cAClET,QAAQ,GAAG,CAAAF,eAAe,KAAA,IAAA,IAAfA,eAAe,KAAA,MAAA,IAAA,CAAAD,sBAAA,GAAfC,eAAe,CAAEU,aAAa,MAAA,IAAA,IAAAX,sBAAA,uBAA9BA,sBAAA,CAAgCY,GAAG,CAAC,UAAU,CAAC,KAAI,IAAI;cAAA,OAAAN,QAAA,CAAAO,CAAA,CAAA,CAAA,EAEjE;AACLX,gBAAAA,QAAQ,EAARA,QAAQ;AACRC,gBAAAA,QAAQ,EAARA;eACD,CAAA;AAAA,YAAA,KAAA,CAAA;AAAAG,cAAAA,QAAA,CAAAC,CAAA,GAAA,CAAA;cAAAH,EAAA,GAAAE,QAAA,CAAAI,CAAA;cAAA,MAEK,IAAIxB,KAAK,CAAA,2CAAA,CAAA4B,MAAA,CAC+B,IAAI,CAAC/B,WAAW,EAAA,KAAA,CAAA,CAAA+B,MAAA,CAAMV,EAAA,YAAiBlB,KAAK,GAAGkB,EAAA,CAAMW,OAAO,GAAG,eAAe,CAAE,CAC7H;AAAA,YAAA,KAAA,CAAA;cAAA,OAAAT,QAAA,CAAAO,CAAA,CAAA,CAAA,CAAA;AAAA;AAAA,QAAA,CAAA,EAAAf,OAAA,EAAA,IAAA,EAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA;MAAA,CAEJ,CAAA,CAAA;AAAA,MAAA,SAfKkB,cAAcA,GAAA;AAAA,QAAA,OAAAtB,eAAA,CAAAuB,KAAA,CAAA,IAAA,EAAAC,SAAA,CAAA;AAAA,MAAA;AAAA,MAAA,OAAdF,cAAc;AAAA,IAAA,CAAA;AAiBpB;;;AAGG;AAHH;AAAA,GAAA,EAAA;IAAA1B,GAAA,EAAA,mBAAA;IAAAC,KAAA,GAAA,YAAA;MAAA,IAAA4B,kBAAA,GAAAxB,iBAAA,cAAAC,YAAA,EAAA,CAAAC,CAAA,CAIA,SAAAuB,QAAAA,GAAA;AAAA,QAAA,IAAAC,GAAA;AAAA,QAAA,OAAAzB,YAAA,EAAA,CAAAS,CAAA,CAAA,UAAAiB,SAAA,EAAA;AAAA,UAAA,OAAA,CAAA,EAAA,QAAAA,SAAA,CAAAf,CAAA,GAAAe,SAAA,CAAAd,CAAA;AAAA,YAAA,KAAA,CAAA;AAAAc,cAAAA,SAAA,CAAAf,CAAA,GAAA,CAAA;AAAAe,cAAAA,SAAA,CAAAd,CAAA,GAAA,CAAA;AAAA,cAAA,OAEUe,QAAQ,CAAC;gBACb/B,EAAE,EAAE,IAAI,CAACT,WAAW;AACpByC,gBAAAA,OAAO,EAAE;AACV,eAAA,CAAC;AAAA,YAAA,KAAA,CAAA;AAAAF,cAAAA,SAAA,CAAAd,CAAA,GAAA,CAAA;AAAA,cAAA;AAAA,YAAA,KAAA,CAAA;AAAAc,cAAAA,SAAA,CAAAf,CAAA,GAAA,CAAA;cAAAc,GAAA,GAAAC,SAAA,CAAAZ,CAAA;cAAA,MAEI,IAAIxB,KAAK,CAAA,gCAAA,CAAA4B,MAAA,CACoB,IAAI,CAAC/B,WAAW,EAAA,KAAA,CAAA,CAAA+B,MAAA,CAAMO,GAAA,YAAiBnC,KAAK,GAAGmC,GAAA,CAAMN,OAAO,GAAG,eAAe,CAAE,CAClH;AAAA,YAAA,KAAA,CAAA;cAAA,OAAAO,SAAA,CAAAT,CAAA,CAAA,CAAA,CAAA;AAAA;AAAA,QAAA,CAAA,EAAAO,QAAA,EAAA,IAAA,EAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA;MAAA,CAEJ,CAAA,CAAA;AAAA,MAAA,SAXKK,iBAAiBA,GAAA;AAAA,QAAA,OAAAN,kBAAA,CAAAF,KAAA,CAAA,IAAA,EAAAC,SAAA,CAAA;AAAA,MAAA;AAAA,MAAA,OAAjBO,iBAAiB;AAAA,IAAA,CAAA,EAAA;AAAA,GAAA,CAAA,CAAA;AAAA,CAAA;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe-commerce/aio-experience-kit",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "A comprehensive TypeScript toolkit for building Adobe Commerce Admin UI extensions with React Spectrum components. Provides production-ready components and utilities for Adobe I/O extensibility platform integration.",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",