@shopify/ui-extensions-tester 2026.7.0-rc.2 → 2026.7.0-rc.4

package/README.md

@@ -401,6 +401,8 @@ Imports and executes the extension module's default export, rendering the extens
 
 A mock `shopify` global, typed correctly for the target under test. You can mutate any property.
 
+When testing `admin.app.home.render`, the mock `shopify` object also includes `toast`, `app`, and `loading()`.
+
 When testing `admin.app.intent.render`, the mock `shopify.intents` object also includes `response.ok()`, `response.error()`, and `response.closed()`.
 
 #### `extension.fetch`

package/build/cjs/admin/factories.js

@@ -77,6 +77,28 @@ function createMockStandardRenderingApi(target) {
     })
   };
 }
+function createMockToastApi() {
+  return {
+    show: () => {},
+    hide: () => {}
+  };
+}
+function createMockAppApi() {
+  return {
+    extensions: async () => []
+  };
+}
+function createMockLoadingApi() {
+  return () => {};
+}
+function createAppHomeMock(target) {
+  return {
+    ...createMockStandardRenderingApi(target),
+    toast: createMockToastApi(),
+    app: createMockAppApi(),
+    loading: createMockLoadingApi()
+  };
+}
 function createAppIntentRenderMock(target) {
   return {
     ...createMockStandardRenderingApi(target),
@@ -231,6 +253,7 @@ const adminMockFactories = {
   'admin.customers.segmentation-templates.data': createCustomerSegmentTemplateMock,
   'admin.app.tools.data': createMockStandardApi,
   // App render targets
+  'admin.app.home.render': createAppHomeMock,
   'admin.app.intent.render': createAppIntentRenderMock,
   // Block targets
   'admin.product-details.block.render': createMockBlockApi,

package/build/cjs/api-version.js

@@ -5,14 +5,14 @@ Object.defineProperty(exports, '__esModule', { value: true });
 /**
  * The API version supported by this version of the library.
  *
- * At build time, `"2026.7.0-rc.2"` is replaced by rollup with the
+ * At build time, `"2026.7.0-rc.4"` is replaced by rollup with the
  * raw NPM version string from package.json (e.g. `"2026.4.0-rc.1"`).
  *
  * When running from source (e.g. in tests), the placeholder is still
  * present, so we fall back to reading package.json via require.
  */
 
-const npmVersion = "2026.7.0-rc.2";
+const npmVersion = "2026.7.0-rc.4";
 function npmVersionToApiVersion(version) {
   const [year, minor] = version.split('.');
   return `${year}-${minor.padStart(2, '0')}`;

package/build/cjs/index.js

@@ -77,6 +77,9 @@ var _fetchImpl = /*#__PURE__*/_rollupPluginBabelHelpers.classPrivateFieldLooseKe
 var _previousFetch = /*#__PURE__*/_rollupPluginBabelHelpers.classPrivateFieldLooseKey("previousFetch");
 var _navigationImpl = /*#__PURE__*/_rollupPluginBabelHelpers.classPrivateFieldLooseKey("navigationImpl");
 var _previousNavigation = /*#__PURE__*/_rollupPluginBabelHelpers.classPrivateFieldLooseKey("previousNavigation");
+var _eventListeners = /*#__PURE__*/_rollupPluginBabelHelpers.classPrivateFieldLooseKey("eventListeners");
+var _addEventListener = /*#__PURE__*/_rollupPluginBabelHelpers.classPrivateFieldLooseKey("addEventListener");
+var _removeEventListener = /*#__PURE__*/_rollupPluginBabelHelpers.classPrivateFieldLooseKey("removeEventListener");
 class Extension {
   constructor(target, options) {
     var _options$configSearch;
@@ -120,6 +123,28 @@ class Extension {
       writable: true,
       value: void 0
     });
+    Object.defineProperty(this, _eventListeners, {
+      writable: true,
+      value: new Map()
+    });
+    Object.defineProperty(this, _addEventListener, {
+      writable: true,
+      value: (type, listener) => {
+        let set = _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].get(type);
+        if (!set) {
+          set = new Set();
+          _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].set(type, set);
+        }
+        set.add(listener);
+      }
+    });
+    Object.defineProperty(this, _removeEventListener, {
+      writable: true,
+      value: (type, listener) => {
+        var _classPrivateFieldLoo;
+        (_classPrivateFieldLoo = _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].get(type)) === null || _classPrivateFieldLoo === void 0 ? void 0 : _classPrivateFieldLoo.delete(listener);
+      }
+    });
     const configSearchDir = (_options$configSearch = options === null || options === void 0 ? void 0 : options.configSearchDir) !== null && _options$configSearch !== void 0 ? _options$configSearch : path__namespace.dirname(getCallerFile());
     const tomlPath = findToml(configSearchDir);
     const tomlDir = path__namespace.dirname(tomlPath);
@@ -143,10 +168,28 @@ class Extension {
     _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _previousFetch)[_previousFetch] = globalThis.fetch;
     _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _previousNavigation)[_previousNavigation] = globalThis.navigation;
     _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _navigationImpl)[_navigationImpl] = navigation.createMockNavigation();
-    globalThis.shopify = deepWritableProxy(targetApis.createMockTargetApi(_rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _target)[_target]));
+    _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].clear();
+    globalThis.shopify = deepWritableProxy(Object.assign(targetApis.createMockTargetApi(_rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _target)[_target]), {
+      addEventListener: _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _addEventListener)[_addEventListener],
+      removeEventListener: _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _removeEventListener)[_removeEventListener]
+    }));
     globalThis.fetch = _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _fetchImpl)[_fetchImpl];
     globalThis.navigation = _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _navigationImpl)[_navigationImpl];
   }
+  dispatch(type, event) {
+    const listeners = _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].get(type);
+    if (!listeners) return;
+    // Snapshot so listeners that register/unregister during dispatch
+    // don't mutate the iteration.
+    for (const listener of [...listeners]) {
+      try {
+        listener(event);
+      } catch {
+        // Fire-and-forget: per the shopify.addEventListener contract,
+        // listener errors must not affect other listeners.
+      }
+    }
+  }
   get shopify() {
     if (!globalThis.shopify) {
       throw new Error('You must call extension.setUp() before accessing extension.shopify.');
@@ -189,6 +232,7 @@ class Extension {
       document.body.innerHTML = '';
     }
     delete globalThis.shopify;
+    _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].clear();
     if (_rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _previousFetch)[_previousFetch] === undefined) {
       delete globalThis.fetch;
     } else {

package/build/cjs/point-of-sale/factories.js

@@ -406,6 +406,58 @@ function createActionTargetCashDrawerMock(target) {
   };
 }
 
+// Data target factories
+function createDataTargetMock(target) {
+  return {
+    extensionPoint: target,
+    extension: {
+      apiVersion: '2026-04',
+      target
+    },
+    i18n: i18n.createMockI18n(),
+    session: {
+      currentSession: createSessionCurrentSession(),
+      getSessionToken: async () => 'mock-session-token',
+      deviceId: 1
+    },
+    storage: index.createStorage(),
+    locale: {
+      current: signals.createReadonlySignalLike('en-US')
+    },
+    connectivity: {
+      current: signals.createReadonlySignalLike(createConnectivityState())
+    },
+    device: {
+      name: 'Mock POS Device',
+      registerName: 'Register 1',
+      getDeviceId: async () => 'mock-device-id',
+      isTablet: async () => false
+    },
+    productSearch: {
+      searchProducts: async () => ({
+        items: [],
+        hasNextPage: false
+      }),
+      fetchProductWithId: async () => undefined,
+      fetchProductsWithIds: async () => ({
+        fetchedResources: [],
+        idsForResourcesNotFound: []
+      }),
+      fetchProductVariantWithId: async () => undefined,
+      fetchProductVariantsWithIds: async () => ({
+        fetchedResources: [],
+        idsForResourcesNotFound: []
+      }),
+      fetchProductVariantsWithProductId: async () => [],
+      fetchPaginatedProductVariantsWithProductId: async () => ({
+        items: [],
+        hasNextPage: false
+      })
+    },
+    ...createMockCartApi()
+  };
+}
+
 // Event target factories
 function createTransactionCompleteMock(_target) {
   return {
@@ -491,6 +543,8 @@ const posMockFactories = {
   'pos.register-details.block.render': createStandardActionCashDrawerMock,
   // Group Q: ActionTargetApi + CashDrawerApi
   'pos.register-details.action.render': createActionTargetCashDrawerMock,
+  // Data targets
+  'pos.app.ready.data': createDataTargetMock,
   // Event targets
   'pos.transaction-complete.event.observe': createTransactionCompleteMock,
   'pos.cash-tracking-session-start.event.observe': createCashTrackingSessionStartMock,

package/build/cjs/targets.js

@@ -17,6 +17,14 @@ Object.defineProperty(exports, '__esModule', { value: true });
  * For event targets (functions) this is the `data` parameter type.
  */
 
+/**
+ * Maps an extension target to the event map available via
+ * `shopify.addEventListener` on that surface.
+ *
+ * - POS targets: the POS `ShopifyEventMap`.
+ * - Other surfaces: no host events, so the map is empty.
+ */
+
 function isCheckoutTarget(target) {
   return target.startsWith('purchase.checkout') || target.startsWith('purchase.thank-you') || target.startsWith('purchase.cart-line-item') || target.startsWith('Checkout::');
 }

package/build/esm/admin/factories.mjs

@@ -73,6 +73,28 @@ function createMockStandardRenderingApi(target) {
     })
   };
 }
+function createMockToastApi() {
+  return {
+    show: () => {},
+    hide: () => {}
+  };
+}
+function createMockAppApi() {
+  return {
+    extensions: async () => []
+  };
+}
+function createMockLoadingApi() {
+  return () => {};
+}
+function createAppHomeMock(target) {
+  return {
+    ...createMockStandardRenderingApi(target),
+    toast: createMockToastApi(),
+    app: createMockAppApi(),
+    loading: createMockLoadingApi()
+  };
+}
 function createAppIntentRenderMock(target) {
   return {
     ...createMockStandardRenderingApi(target),
@@ -227,6 +249,7 @@ const adminMockFactories = {
   'admin.customers.segmentation-templates.data': createCustomerSegmentTemplateMock,
   'admin.app.tools.data': createMockStandardApi,
   // App render targets
+  'admin.app.home.render': createAppHomeMock,
   'admin.app.intent.render': createAppIntentRenderMock,
   // Block targets
   'admin.product-details.block.render': createMockBlockApi,

package/build/esm/api-version.mjs

@@ -1,14 +1,14 @@
 /**
  * The API version supported by this version of the library.
  *
- * At build time, `"2026.7.0-rc.2"` is replaced by rollup with the
+ * At build time, `"2026.7.0-rc.4"` is replaced by rollup with the
  * raw NPM version string from package.json (e.g. `"2026.4.0-rc.1"`).
  *
  * When running from source (e.g. in tests), the placeholder is still
  * present, so we fall back to reading package.json via require.
  */
 
-const npmVersion = "2026.7.0-rc.2";
+const npmVersion = "2026.7.0-rc.4";
 function npmVersionToApiVersion(version) {
   const [year, minor] = version.split('.');
   return `${year}-${minor.padStart(2, '0')}`;

package/build/esm/index.mjs

@@ -53,6 +53,9 @@ var _fetchImpl = /*#__PURE__*/_classPrivateFieldLooseKey("fetchImpl");
 var _previousFetch = /*#__PURE__*/_classPrivateFieldLooseKey("previousFetch");
 var _navigationImpl = /*#__PURE__*/_classPrivateFieldLooseKey("navigationImpl");
 var _previousNavigation = /*#__PURE__*/_classPrivateFieldLooseKey("previousNavigation");
+var _eventListeners = /*#__PURE__*/_classPrivateFieldLooseKey("eventListeners");
+var _addEventListener = /*#__PURE__*/_classPrivateFieldLooseKey("addEventListener");
+var _removeEventListener = /*#__PURE__*/_classPrivateFieldLooseKey("removeEventListener");
 class Extension {
   constructor(target, options) {
     var _options$configSearch;
@@ -96,6 +99,28 @@ class Extension {
       writable: true,
       value: void 0
     });
+    Object.defineProperty(this, _eventListeners, {
+      writable: true,
+      value: new Map()
+    });
+    Object.defineProperty(this, _addEventListener, {
+      writable: true,
+      value: (type, listener) => {
+        let set = _classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].get(type);
+        if (!set) {
+          set = new Set();
+          _classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].set(type, set);
+        }
+        set.add(listener);
+      }
+    });
+    Object.defineProperty(this, _removeEventListener, {
+      writable: true,
+      value: (type, listener) => {
+        var _classPrivateFieldLoo;
+        (_classPrivateFieldLoo = _classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].get(type)) === null || _classPrivateFieldLoo === void 0 ? void 0 : _classPrivateFieldLoo.delete(listener);
+      }
+    });
     const configSearchDir = (_options$configSearch = options === null || options === void 0 ? void 0 : options.configSearchDir) !== null && _options$configSearch !== void 0 ? _options$configSearch : path.dirname(getCallerFile());
     const tomlPath = findToml(configSearchDir);
     const tomlDir = path.dirname(tomlPath);
@@ -119,10 +144,28 @@ class Extension {
     _classPrivateFieldLooseBase(this, _previousFetch)[_previousFetch] = globalThis.fetch;
     _classPrivateFieldLooseBase(this, _previousNavigation)[_previousNavigation] = globalThis.navigation;
     _classPrivateFieldLooseBase(this, _navigationImpl)[_navigationImpl] = createMockNavigation();
-    globalThis.shopify = deepWritableProxy(createMockTargetApi(_classPrivateFieldLooseBase(this, _target)[_target]));
+    _classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].clear();
+    globalThis.shopify = deepWritableProxy(Object.assign(createMockTargetApi(_classPrivateFieldLooseBase(this, _target)[_target]), {
+      addEventListener: _classPrivateFieldLooseBase(this, _addEventListener)[_addEventListener],
+      removeEventListener: _classPrivateFieldLooseBase(this, _removeEventListener)[_removeEventListener]
+    }));
     globalThis.fetch = _classPrivateFieldLooseBase(this, _fetchImpl)[_fetchImpl];
     globalThis.navigation = _classPrivateFieldLooseBase(this, _navigationImpl)[_navigationImpl];
   }
+  dispatch(type, event) {
+    const listeners = _classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].get(type);
+    if (!listeners) return;
+    // Snapshot so listeners that register/unregister during dispatch
+    // don't mutate the iteration.
+    for (const listener of [...listeners]) {
+      try {
+        listener(event);
+      } catch {
+        // Fire-and-forget: per the shopify.addEventListener contract,
+        // listener errors must not affect other listeners.
+      }
+    }
+  }
   get shopify() {
     if (!globalThis.shopify) {
       throw new Error('You must call extension.setUp() before accessing extension.shopify.');
@@ -165,6 +208,7 @@ class Extension {
       document.body.innerHTML = '';
     }
     delete globalThis.shopify;
+    _classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].clear();
     if (_classPrivateFieldLooseBase(this, _previousFetch)[_previousFetch] === undefined) {
       delete globalThis.fetch;
     } else {

package/build/esm/point-of-sale/factories.mjs

@@ -402,6 +402,58 @@ function createActionTargetCashDrawerMock(target) {
   };
 }
 
+// Data target factories
+function createDataTargetMock(target) {
+  return {
+    extensionPoint: target,
+    extension: {
+      apiVersion: '2026-04',
+      target
+    },
+    i18n: createMockI18n(),
+    session: {
+      currentSession: createSessionCurrentSession(),
+      getSessionToken: async () => 'mock-session-token',
+      deviceId: 1
+    },
+    storage: createStorage(),
+    locale: {
+      current: createReadonlySignalLike('en-US')
+    },
+    connectivity: {
+      current: createReadonlySignalLike(createConnectivityState())
+    },
+    device: {
+      name: 'Mock POS Device',
+      registerName: 'Register 1',
+      getDeviceId: async () => 'mock-device-id',
+      isTablet: async () => false
+    },
+    productSearch: {
+      searchProducts: async () => ({
+        items: [],
+        hasNextPage: false
+      }),
+      fetchProductWithId: async () => undefined,
+      fetchProductsWithIds: async () => ({
+        fetchedResources: [],
+        idsForResourcesNotFound: []
+      }),
+      fetchProductVariantWithId: async () => undefined,
+      fetchProductVariantsWithIds: async () => ({
+        fetchedResources: [],
+        idsForResourcesNotFound: []
+      }),
+      fetchProductVariantsWithProductId: async () => [],
+      fetchPaginatedProductVariantsWithProductId: async () => ({
+        items: [],
+        hasNextPage: false
+      })
+    },
+    ...createMockCartApi()
+  };
+}
+
 // Event target factories
 function createTransactionCompleteMock(_target) {
   return {
@@ -487,6 +539,8 @@ const posMockFactories = {
   'pos.register-details.block.render': createStandardActionCashDrawerMock,
   // Group Q: ActionTargetApi + CashDrawerApi
   'pos.register-details.action.render': createActionTargetCashDrawerMock,
+  // Data targets
+  'pos.app.ready.data': createDataTargetMock,
   // Event targets
   'pos.transaction-complete.event.observe': createTransactionCompleteMock,
   'pos.cash-tracking-session-start.event.observe': createCashTrackingSessionStartMock,

package/build/esm/targets.mjs

@@ -13,6 +13,14 @@
  * For event targets (functions) this is the `data` parameter type.
  */
 
+/**
+ * Maps an extension target to the event map available via
+ * `shopify.addEventListener` on that surface.
+ *
+ * - POS targets: the POS `ShopifyEventMap`.
+ * - Other surfaces: no host events, so the map is empty.
+ */
+
 function isCheckoutTarget(target) {
   return target.startsWith('purchase.checkout') || target.startsWith('purchase.thank-you') || target.startsWith('purchase.cart-line-item') || target.startsWith('Checkout::');
 }

package/build/esnext/admin/factories.esnext

@@ -73,6 +73,28 @@ function createMockStandardRenderingApi(target) {
     })
   };
 }
+function createMockToastApi() {
+  return {
+    show: () => {},
+    hide: () => {}
+  };
+}
+function createMockAppApi() {
+  return {
+    extensions: async () => []
+  };
+}
+function createMockLoadingApi() {
+  return () => {};
+}
+function createAppHomeMock(target) {
+  return {
+    ...createMockStandardRenderingApi(target),
+    toast: createMockToastApi(),
+    app: createMockAppApi(),
+    loading: createMockLoadingApi()
+  };
+}
 function createAppIntentRenderMock(target) {
   return {
     ...createMockStandardRenderingApi(target),
@@ -227,6 +249,7 @@ const adminMockFactories = {
   'admin.customers.segmentation-templates.data': createCustomerSegmentTemplateMock,
   'admin.app.tools.data': createMockStandardApi,
   // App render targets
+  'admin.app.home.render': createAppHomeMock,
   'admin.app.intent.render': createAppIntentRenderMock,
   // Block targets
   'admin.product-details.block.render': createMockBlockApi,

package/build/esnext/api-version.esnext

@@ -1,14 +1,14 @@
 /**
  * The API version supported by this version of the library.
  *
- * At build time, `"2026.7.0-rc.2"` is replaced by rollup with the
+ * At build time, `"2026.7.0-rc.4"` is replaced by rollup with the
  * raw NPM version string from package.json (e.g. `"2026.4.0-rc.1"`).
  *
  * When running from source (e.g. in tests), the placeholder is still
  * present, so we fall back to reading package.json via require.
  */
 
-const npmVersion = "2026.7.0-rc.2";
+const npmVersion = "2026.7.0-rc.4";
 function npmVersionToApiVersion(version) {
   const [year, minor] = version.split('.');
   return `${year}-${minor.padStart(2, '0')}`;

package/build/esnext/index.esnext

@@ -53,6 +53,9 @@ var _fetchImpl = /*#__PURE__*/_classPrivateFieldLooseKey("fetchImpl");
 var _previousFetch = /*#__PURE__*/_classPrivateFieldLooseKey("previousFetch");
 var _navigationImpl = /*#__PURE__*/_classPrivateFieldLooseKey("navigationImpl");
 var _previousNavigation = /*#__PURE__*/_classPrivateFieldLooseKey("previousNavigation");
+var _eventListeners = /*#__PURE__*/_classPrivateFieldLooseKey("eventListeners");
+var _addEventListener = /*#__PURE__*/_classPrivateFieldLooseKey("addEventListener");
+var _removeEventListener = /*#__PURE__*/_classPrivateFieldLooseKey("removeEventListener");
 class Extension {
   constructor(target, options) {
     var _options$configSearch;
@@ -96,6 +99,28 @@ class Extension {
       writable: true,
       value: void 0
     });
+    Object.defineProperty(this, _eventListeners, {
+      writable: true,
+      value: new Map()
+    });
+    Object.defineProperty(this, _addEventListener, {
+      writable: true,
+      value: (type, listener) => {
+        let set = _classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].get(type);
+        if (!set) {
+          set = new Set();
+          _classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].set(type, set);
+        }
+        set.add(listener);
+      }
+    });
+    Object.defineProperty(this, _removeEventListener, {
+      writable: true,
+      value: (type, listener) => {
+        var _classPrivateFieldLoo;
+        (_classPrivateFieldLoo = _classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].get(type)) === null || _classPrivateFieldLoo === void 0 ? void 0 : _classPrivateFieldLoo.delete(listener);
+      }
+    });
     const configSearchDir = (_options$configSearch = options === null || options === void 0 ? void 0 : options.configSearchDir) !== null && _options$configSearch !== void 0 ? _options$configSearch : path.dirname(getCallerFile());
     const tomlPath = findToml(configSearchDir);
     const tomlDir = path.dirname(tomlPath);
@@ -119,10 +144,28 @@ class Extension {
     _classPrivateFieldLooseBase(this, _previousFetch)[_previousFetch] = globalThis.fetch;
     _classPrivateFieldLooseBase(this, _previousNavigation)[_previousNavigation] = globalThis.navigation;
     _classPrivateFieldLooseBase(this, _navigationImpl)[_navigationImpl] = createMockNavigation();
-    globalThis.shopify = deepWritableProxy(createMockTargetApi(_classPrivateFieldLooseBase(this, _target)[_target]));
+    _classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].clear();
+    globalThis.shopify = deepWritableProxy(Object.assign(createMockTargetApi(_classPrivateFieldLooseBase(this, _target)[_target]), {
+      addEventListener: _classPrivateFieldLooseBase(this, _addEventListener)[_addEventListener],
+      removeEventListener: _classPrivateFieldLooseBase(this, _removeEventListener)[_removeEventListener]
+    }));
     globalThis.fetch = _classPrivateFieldLooseBase(this, _fetchImpl)[_fetchImpl];
     globalThis.navigation = _classPrivateFieldLooseBase(this, _navigationImpl)[_navigationImpl];
   }
+  dispatch(type, event) {
+    const listeners = _classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].get(type);
+    if (!listeners) return;
+    // Snapshot so listeners that register/unregister during dispatch
+    // don't mutate the iteration.
+    for (const listener of [...listeners]) {
+      try {
+        listener(event);
+      } catch {
+        // Fire-and-forget: per the shopify.addEventListener contract,
+        // listener errors must not affect other listeners.
+      }
+    }
+  }
   get shopify() {
     if (!globalThis.shopify) {
       throw new Error('You must call extension.setUp() before accessing extension.shopify.');
@@ -165,6 +208,7 @@ class Extension {
       document.body.innerHTML = '';
     }
     delete globalThis.shopify;
+    _classPrivateFieldLooseBase(this, _eventListeners)[_eventListeners].clear();
     if (_classPrivateFieldLooseBase(this, _previousFetch)[_previousFetch] === undefined) {
       delete globalThis.fetch;
     } else {

package/build/esnext/point-of-sale/factories.esnext

@@ -402,6 +402,58 @@ function createActionTargetCashDrawerMock(target) {
   };
 }
 
+// Data target factories
+function createDataTargetMock(target) {
+  return {
+    extensionPoint: target,
+    extension: {
+      apiVersion: '2026-04',
+      target
+    },
+    i18n: createMockI18n(),
+    session: {
+      currentSession: createSessionCurrentSession(),
+      getSessionToken: async () => 'mock-session-token',
+      deviceId: 1
+    },
+    storage: createStorage(),
+    locale: {
+      current: createReadonlySignalLike('en-US')
+    },
+    connectivity: {
+      current: createReadonlySignalLike(createConnectivityState())
+    },
+    device: {
+      name: 'Mock POS Device',
+      registerName: 'Register 1',
+      getDeviceId: async () => 'mock-device-id',
+      isTablet: async () => false
+    },
+    productSearch: {
+      searchProducts: async () => ({
+        items: [],
+        hasNextPage: false
+      }),
+      fetchProductWithId: async () => undefined,
+      fetchProductsWithIds: async () => ({
+        fetchedResources: [],
+        idsForResourcesNotFound: []
+      }),
+      fetchProductVariantWithId: async () => undefined,
+      fetchProductVariantsWithIds: async () => ({
+        fetchedResources: [],
+        idsForResourcesNotFound: []
+      }),
+      fetchProductVariantsWithProductId: async () => [],
+      fetchPaginatedProductVariantsWithProductId: async () => ({
+        items: [],
+        hasNextPage: false
+      })
+    },
+    ...createMockCartApi()
+  };
+}
+
 // Event target factories
 function createTransactionCompleteMock(_target) {
   return {
@@ -487,6 +539,8 @@ const posMockFactories = {
   'pos.register-details.block.render': createStandardActionCashDrawerMock,
   // Group Q: ActionTargetApi + CashDrawerApi
   'pos.register-details.action.render': createActionTargetCashDrawerMock,
+  // Data targets
+  'pos.app.ready.data': createDataTargetMock,
   // Event targets
   'pos.transaction-complete.event.observe': createTransactionCompleteMock,
   'pos.cash-tracking-session-start.event.observe': createCashTrackingSessionStartMock,

package/build/esnext/targets.esnext

@@ -13,6 +13,14 @@
  * For event targets (functions) this is the `data` parameter type.
  */
 
+/**
+ * Maps an extension target to the event map available via
+ * `shopify.addEventListener` on that surface.
+ *
+ * - POS targets: the POS `ShopifyEventMap`.
+ * - Other surfaces: no host events, so the map is empty.
+ */
+
 function isCheckoutTarget(target) {
   return target.startsWith('purchase.checkout') || target.startsWith('purchase.thank-you') || target.startsWith('purchase.cart-line-item') || target.startsWith('Checkout::');
 }

package/build/ts/admin/factories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factories.d.ts","sourceRoot":"","sources":["../../../src/admin/factories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAMjB,MAAM,8BAA8B,CAAC;AAKtC;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,eAAe,IACxD,gBAAgB,CAAC,CAAC,CAAC,SAAS;IAAC,GAAG,EAAE,MAAM,GAAG,CAAA;CAAC,GACxC,IAAI,CAAC,GAAG,EAAE,KAAK,MAAM,EAAE,CAAC,GACxB,KAAK,CAAC;AAsBZ,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAQ7D;AA4UD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,eAAe,EAChE,MAAM,EAAE,CAAC,GACR,oBAAoB,CAAC,CAAC,CAAC,CASzB"}
+{"version":3,"file":"factories.d.ts","sourceRoot":"","sources":["../../../src/admin/factories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EASjB,MAAM,8BAA8B,CAAC;AAKtC;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,eAAe,IACxD,gBAAgB,CAAC,CAAC,CAAC,SAAS;IAAC,GAAG,EAAE,MAAM,GAAG,CAAA;CAAC,GACxC,IAAI,CAAC,GAAG,EAAE,KAAK,MAAM,EAAE,CAAC,GACxB,KAAK,CAAC;AAsBZ,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAQ7D;AAuWD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,eAAe,EAChE,MAAM,EAAE,CAAC,GACR,oBAAoB,CAAC,CAAC,CAAC,CASzB"}