@shopify/ui-extensions-tester 2026.4.0-rc.2 → 2026.4.0

package/build/esm/index.mjs

@@ -1,3 +1,4 @@
+import { classPrivateFieldLooseBase as _classPrivateFieldLooseBase, classPrivateFieldLooseKey as _classPrivateFieldLooseKey } from './_virtual/_rollupPluginBabelHelpers.mjs';
 import * as fs from 'fs';
 import * as path from 'path';
 import { isCheckoutTarget } from './targets.mjs';
@@ -7,6 +8,8 @@ export { createNavigationHistoryEntry } from './navigation.mjs';
 import { API_VERSION } from './api-version.mjs';
 import { installFetchPolyfills, uninstallFetchPolyfills } from './fetch-polyfills.mjs';
 
+var _dispose;
+
 /**
  * Makes all properties in the API deeply mutable so tests can
  * override any value through the `extension.shopify` proxy:
@@ -15,6 +18,168 @@ import { installFetchPolyfills, uninstallFetchPolyfills } from './fetch-polyfill
  *   extension.shopify.i18n.translate = (key) => myTranslations[key];
  */
 
+/**
+ * `Symbol.dispose` for runtimes that support it, with a polyfill
+ * fallback so the library works on older Node versions too.
+ */
+const SymbolDispose = (_dispose = Symbol.dispose) !== null && _dispose !== void 0 ? _dispose : Symbol.for('Symbol.dispose');
+
+/**
+ * Members shared by both {@link ExtensionHarness} (returned by
+ * `getExtension`) and {@link DisposableExtensionHarness} (returned
+ * by `setUpExtension`).
+ */
+
+/**
+ * Returned by `getExtension`.  The caller is responsible for calling
+ * `setUp()` before each test and `tearDown()` after.
+ */
+
+/**
+ * Returned by `setUpExtension`.  Already set up — tears down
+ * automatically via `Symbol.dispose` (the `using` keyword):
+ *
+ * ```ts
+ * using extension = setUpExtension('purchase.checkout.block.render');
+ * ```
+ */
+var _target = /*#__PURE__*/_classPrivateFieldLooseKey("target");
+var _resolvedModule = /*#__PURE__*/_classPrivateFieldLooseKey("resolvedModule");
+var _modulePath = /*#__PURE__*/_classPrivateFieldLooseKey("modulePath");
+var _checkout = /*#__PURE__*/_classPrivateFieldLooseKey("checkout");
+var _networkAccess = /*#__PURE__*/_classPrivateFieldLooseKey("networkAccess");
+var _apiAccess = /*#__PURE__*/_classPrivateFieldLooseKey("apiAccess");
+var _fetchImpl = /*#__PURE__*/_classPrivateFieldLooseKey("fetchImpl");
+var _previousFetch = /*#__PURE__*/_classPrivateFieldLooseKey("previousFetch");
+var _navigationImpl = /*#__PURE__*/_classPrivateFieldLooseKey("navigationImpl");
+var _previousNavigation = /*#__PURE__*/_classPrivateFieldLooseKey("previousNavigation");
+class Extension {
+  constructor(target, options) {
+    var _options$configSearch;
+    Object.defineProperty(this, _target, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _resolvedModule, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _modulePath, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _checkout, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _networkAccess, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _apiAccess, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _fetchImpl, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _previousFetch, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _navigationImpl, {
+      writable: true,
+      value: createMockNavigation()
+    });
+    Object.defineProperty(this, _previousNavigation, {
+      writable: true,
+      value: void 0
+    });
+    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);
+    const tomlContent = fs.readFileSync(tomlPath, 'utf-8');
+    validateApiVersion(tomlContent);
+    const modulePath = parseTargetModule(tomlContent, target);
+    _classPrivateFieldLooseBase(this, _target)[_target] = target;
+    _classPrivateFieldLooseBase(this, _modulePath)[_modulePath] = modulePath;
+    _classPrivateFieldLooseBase(this, _resolvedModule)[_resolvedModule] = path.resolve(tomlDir, modulePath);
+    _classPrivateFieldLooseBase(this, _checkout)[_checkout] = isCheckoutTarget(target);
+    _classPrivateFieldLooseBase(this, _networkAccess)[_networkAccess] = _classPrivateFieldLooseBase(this, _checkout)[_checkout] && parseNetworkAccess(tomlContent);
+    _classPrivateFieldLooseBase(this, _apiAccess)[_apiAccess] = _classPrivateFieldLooseBase(this, _checkout)[_checkout] && parseApiAccess(tomlContent);
+  }
+  setUp() {
+    installFetchPolyfills();
+    _classPrivateFieldLooseBase(this, _fetchImpl)[_fetchImpl] = _classPrivateFieldLooseBase(this, _checkout)[_checkout] && !_classPrivateFieldLooseBase(this, _networkAccess)[_networkAccess] && !_classPrivateFieldLooseBase(this, _apiAccess)[_apiAccess] ? async () => {
+      // Checkout is the only surface that currently enforces
+      // fetch capabilities.
+      throw new Error('fetch() is not available. Add network_access = true or ' + 'api_access = true to [extensions.capabilities] in shopify.extension.toml.');
+    } : async () => new Response();
+    _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]));
+    globalThis.fetch = _classPrivateFieldLooseBase(this, _fetchImpl)[_fetchImpl];
+    globalThis.navigation = _classPrivateFieldLooseBase(this, _navigationImpl)[_navigationImpl];
+  }
+  get shopify() {
+    if (!globalThis.shopify) {
+      throw new Error('You must call extension.setUp() before accessing extension.shopify.');
+    }
+    return globalThis.shopify;
+  }
+  get fetch() {
+    return _classPrivateFieldLooseBase(this, _fetchImpl)[_fetchImpl];
+  }
+  set fetch(fn) {
+    _classPrivateFieldLooseBase(this, _fetchImpl)[_fetchImpl] = fn;
+    globalThis.fetch = fn;
+  }
+  get navigation() {
+    return _classPrivateFieldLooseBase(this, _navigationImpl)[_navigationImpl];
+  }
+  set navigation(obj) {
+    _classPrivateFieldLooseBase(this, _navigationImpl)[_navigationImpl] = obj;
+    globalThis.navigation = obj;
+  }
+  async render() {
+    const mod = await import(_classPrivateFieldLooseBase(this, _resolvedModule)[_resolvedModule]);
+    const renderFn = mod.default;
+    if (typeof renderFn !== 'function') {
+      throw new Error(`Expected default export of ${_classPrivateFieldLooseBase(this, _modulePath)[_modulePath]} to be a function, got ${typeof renderFn}`);
+    }
+    await renderFn();
+  }
+  tearDown() {
+    // Dynamically import preact to unmount cleanly without requiring
+    // the test file to depend on preact directly.
+    try {
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const {
+        render
+      } = require('preact');
+      render(null, document.body);
+    } catch {
+      // Fallback if preact isn't available
+      document.body.innerHTML = '';
+    }
+    delete globalThis.shopify;
+    if (_classPrivateFieldLooseBase(this, _previousFetch)[_previousFetch] === undefined) {
+      delete globalThis.fetch;
+    } else {
+      globalThis.fetch = _classPrivateFieldLooseBase(this, _previousFetch)[_previousFetch];
+    }
+    if (_classPrivateFieldLooseBase(this, _previousNavigation)[_previousNavigation] === undefined) {
+      delete globalThis.navigation;
+    } else {
+      globalThis.navigation = _classPrivateFieldLooseBase(this, _previousNavigation)[_previousNavigation];
+    }
+    uninstallFetchPolyfills();
+  }
+}
+const extensionCache = new Map();
+
 /**
  * Returns an extension test harness for the given target.
  *
@@ -31,92 +196,46 @@ import { installFetchPolyfills, uninstallFetchPolyfills } from './fetch-polyfill
  *   `shopify.extension.toml`. Defaults to the calling test file's directory.
  */
 function getExtension(target, options) {
-  var _options$configSearch;
-  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);
-  const tomlContent = fs.readFileSync(tomlPath, 'utf-8');
-  validateApiVersion(tomlContent);
-  const modulePath = parseTargetModule(tomlContent, target);
-  const resolvedModule = path.resolve(tomlDir, modulePath);
-  const checkout = isCheckoutTarget(target);
-  const networkAccess = checkout && parseNetworkAccess(tomlContent);
-  const apiAccess = checkout && parseApiAccess(tomlContent);
-  let fetchImpl;
-  let previousFetch;
-  let navigationImpl = createMockNavigation();
-  let previousNavigation;
-  const ext = {
-    setUp() {
-      installFetchPolyfills();
-      fetchImpl = checkout && !networkAccess && !apiAccess ? async () => {
-        // Checkout is the only surface that currently enforces
-        // fetch capabilities.
-        throw new Error('fetch() is not available. Add network_access = true or ' + 'api_access = true to [extensions.capabilities] in shopify.extension.toml.');
-      } : async () => new Response();
-      previousFetch = globalThis.fetch;
-      previousNavigation = globalThis.navigation;
-      globalThis.shopify = deepWritableProxy(createMockTargetApi(target));
-      globalThis.fetch = fetchImpl;
-      globalThis.navigation = navigationImpl;
-    },
-    get shopify() {
-      if (!globalThis.shopify) {
-        throw new Error('You must call extension.setUp() before accessing extension.shopify.');
-      }
-      return globalThis.shopify;
-    },
-    get fetch() {
-      return fetchImpl;
-    },
-    set fetch(fn) {
-      fetchImpl = fn;
-      globalThis.fetch = fn;
-    },
-    get navigation() {
-      return navigationImpl;
-    },
-    set navigation(obj) {
-      navigationImpl = obj;
-      globalThis.navigation = obj;
-    },
-    async render() {
-      const mod = await import(resolvedModule);
-      const renderFn = mod.default;
-      if (typeof renderFn !== 'function') {
-        throw new Error(`Expected default export of ${modulePath} to be a function, got ${typeof renderFn}`);
-      }
-      await renderFn();
-    },
-    tearDown() {
-      // Dynamically import preact to unmount cleanly without requiring
-      // the test file to depend on preact directly.
-      try {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const {
-          render
-        } = require('preact');
-        render(null, document.body);
-      } catch {
-        // Fallback if preact isn't available
-        document.body.innerHTML = '';
-      }
-      delete globalThis.shopify;
-      if (previousFetch === undefined) {
-        delete globalThis.fetch;
-      } else {
-        globalThis.fetch = previousFetch;
-      }
-      if (previousNavigation === undefined) {
-        delete globalThis.navigation;
-      } else {
-        globalThis.navigation = previousNavigation;
-      }
-      uninstallFetchPolyfills();
-    }
-  };
+  var _options$configSearch2;
+  const resolvedConfigSearchDir = (_options$configSearch2 = options === null || options === void 0 ? void 0 : options.configSearchDir) !== null && _options$configSearch2 !== void 0 ? _options$configSearch2 : path.dirname(getCallerFile());
+  const tomlPath = findToml(resolvedConfigSearchDir);
+  const tomlMtimeMs = fs.statSync(tomlPath).mtimeMs;
+  const cacheKey = JSON.stringify([target, tomlPath, tomlMtimeMs]);
+  const cached = extensionCache.get(cacheKey);
+  if (cached) {
+    return cached;
+  }
+  const ext = new Extension(target, {
+    configSearchDir: resolvedConfigSearchDir
+  });
+  extensionCache.set(cacheKey, ext);
   return ext;
 }
+
+/**
+ * Sets up an extension for testing and returns a disposable object
+ * that supports automatic teardown with the `using` keyword:
+ *
+ * ```ts
+ * test('rendering the extension', async () => {
+ *   using extension = setUpExtension(
+ *     'purchase.checkout.block.render',
+ *   );
+ *   await extension.render();
+ *   // tearDown() is called automatically at the end of the block
+ * });
+ * ```
+ *
+ * @param target - The extension target to mock.
+ * @param options - Optional configuration (same as {@link getExtension}).
+ */
+function setUpExtension(target, options) {
+  const extension = getExtension(target, options);
+  extension.setUp();
+  return Object.assign(extension, {
+    [SymbolDispose]: () => extension.tearDown()
+  });
+}
 function validateApiVersion(toml) {
   const match = toml.match(/^\s*api_version\s*=\s*"([^"]+)"/m);
   const tomlVersion = match === null || match === void 0 ? void 0 : match[1];
@@ -184,8 +303,10 @@ function getCallerFile() {
     const err = new Error();
     let callerFile = '';
     Error.prepareStackTrace = (_err, stack) => {
-      // stack[0] is getCallerFile, stack[1] is getExtension, stack[2] is the caller
-      for (let i = 2; i < stack.length; i++) {
+      // Walk the stack, skipping all frames that originate from this
+      // package file.  This works regardless of whether the caller is
+      // getExtension() or setUpExtension() → getExtension().
+      for (let i = 1; i < stack.length; i++) {
         const fileName = stack[i].getFileName();
         if (fileName && fileName !== thisPackageFilePath) {
           callerFile = fileName;
@@ -316,4 +437,4 @@ function deepWritableProxy(obj) {
   });
 }
 
-export { getExtension };
+export { SymbolDispose, getExtension, setUpExtension };

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

@@ -53,9 +53,14 @@ function createTransaction() {
     lineItems: []
   };
 }
+function createConnectivityApiContent() {
+  return {
+    current: createReadonlySignalLike(createConnectivityState())
+  };
+}
 function createMockBaseEventData() {
   return {
-    connectivity: createConnectivityState(),
+    connectivity: createConnectivityApiContent(),
     device: {
       name: 'Mock POS Device',
       deviceId: 1,

package/build/esnext/_virtual/_rollupPluginBabelHelpers.esnext

@@ -0,0 +1,10 @@
+function _classPrivateFieldLooseBase(e, t) {
+  if (!{}.hasOwnProperty.call(e, t)) throw new TypeError("attempted to use private field on non-instance");
+  return e;
+}
+var id = 0;
+function _classPrivateFieldLooseKey(e) {
+  return "__private_" + id++ + "_" + e;
+}
+
+export { _classPrivateFieldLooseBase as classPrivateFieldLooseBase, _classPrivateFieldLooseKey as classPrivateFieldLooseKey };

package/build/esnext/admin/factories.esnext

@@ -34,6 +34,13 @@ function createConfigApp() {
     applicationUrl: 'https://mock-app.test'
   };
 }
+function createIntentResponseApi() {
+  return {
+    ok: async () => {},
+    error: async () => {},
+    closed: async () => {}
+  };
+}
 function createMockStandardApi(target) {
   return {
     extension: {
@@ -66,6 +73,15 @@ function createMockStandardRenderingApi(target) {
     })
   };
 }
+function createAppIntentRenderMock(target) {
+  return {
+    ...createMockStandardRenderingApi(target),
+    intents: {
+      ...createMockStandardApi(target).intents,
+      response: createIntentResponseApi()
+    }
+  };
+}
 function createMockBlockApi(target) {
   return {
     ...createMockStandardRenderingApi(target),
@@ -210,6 +226,8 @@ const adminMockFactories = {
   // Runnable targets
   'admin.customers.segmentation-templates.data': createCustomerSegmentTemplateMock,
   'admin.app.tools.data': createMockStandardApi,
+  // App render targets
+  'admin.app.intent.render': createAppIntentRenderMock,
   // Block targets
   'admin.product-details.block.render': createMockBlockApi,
   'admin.order-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.4.0-rc.2"` is replaced by rollup with the
+ * At build time, `"2026.4.0"` 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.4.0-rc.2";
+const npmVersion = "2026.4.0";
 function npmVersionToApiVersion(version) {
   const [year, minor] = version.split('.');
   return `${year}-${minor.padStart(2, '0')}`;

package/build/esnext/checkout/factories.esnext

@@ -111,11 +111,6 @@ function createMockStandardApi(target) {
     }),
     selectedPaymentOptions: createSubscribableSignalLike([]),
     settings: createSubscribableSignalLike({}),
-    ui: {
-      overlay: {
-        close: () => {}
-      }
-    },
     version: '0.0.0',
     customerPrivacy: createSubscribableSignalLike({
       allowedProcessing: {