@shopify/ui-extensions 2025.10.0-rc.8 → 2025.10.0

package/src/surfaces/checkout/extension-targets.ts

@@ -19,9 +19,10 @@ import type {StandardApi} from './api/standard/standard';
 import type {ShippingOptionItemApi} from './api/shipping/shipping-option-item';
 import type {ShippingOptionListApi} from './api/shipping/shipping-option-list';
 import type {
-  AnyComponent,
+  AnyCheckoutComponent,
   AllowedComponents,
-  AnyComponentExcept,
+  AnyCheckoutComponentExcept,
+  AnyThankYouComponent,
 } from './shared';
 
 /**
@@ -38,7 +39,7 @@ export interface RenderExtensionTargets {
    */
   'purchase.checkout.actions.render-before': RenderExtension<
     CheckoutApi & StandardApi<'purchase.checkout.actions.render-before'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered immediately before any actions within each step.
@@ -48,14 +49,14 @@ export interface RenderExtensionTargets {
    */
   'Checkout::Actions::RenderBefore': RenderExtension<
     CheckoutApi & StandardApi<'Checkout::Actions::RenderBefore'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered after all line items.
    */
   'purchase.checkout.cart-line-list.render-after': RenderExtension<
     CheckoutApi & StandardApi<'purchase.checkout.cart-line-list.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered after all line items.
@@ -65,7 +66,7 @@ export interface RenderExtensionTargets {
    */
   'Checkout::CartLines::RenderAfter': RenderExtension<
     CheckoutApi & StandardApi<'Checkout::CartLines::RenderAfter'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that renders on every line item, inside the details
@@ -75,7 +76,7 @@ export interface RenderExtensionTargets {
     CheckoutApi &
       CartLineItemApi &
       StandardApi<'purchase.checkout.cart-line-item.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that renders on every line item, inside the details
@@ -88,7 +89,7 @@ export interface RenderExtensionTargets {
     CheckoutApi &
       CartLineItemApi &
       StandardApi<'Checkout::CartLineDetails::RenderAfter'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that renders on every bundle line item, inside the details
@@ -98,7 +99,7 @@ export interface RenderExtensionTargets {
   'purchase.cart-line-item.line-components.render': RenderExtension<
     CartLineItemApi &
       StandardApi<'purchase.cart-line-item.line-components.render'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that renders on every bundle line item, inside the details
@@ -110,14 +111,14 @@ export interface RenderExtensionTargets {
   'Checkout::CartLineDetails::RenderLineComponents': RenderExtension<
     CartLineItemApi &
       StandardApi<'Checkout::CartLineDetails::RenderLineComponents'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered immediately after the contact form element.
    */
   'purchase.checkout.contact.render-after': RenderExtension<
     CheckoutApi & StandardApi<'purchase.checkout.contact.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered immediately after the contact form element.
@@ -127,7 +128,7 @@ export interface RenderExtensionTargets {
    */
   'Checkout::Contact::RenderAfter': RenderExtension<
     CheckoutApi & StandardApi<'Checkout::Contact::RenderAfter'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered after a purchase below the customer information.
@@ -138,7 +139,7 @@ export interface RenderExtensionTargets {
    */
   'Checkout::CustomerInformation::RenderAfter': RenderExtension<
     CheckoutApi & StandardApi<'Checkout::CustomerInformation::RenderAfter'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered between the shipping address header
@@ -147,7 +148,7 @@ export interface RenderExtensionTargets {
   'purchase.checkout.delivery-address.render-before': RenderExtension<
     CheckoutApi &
       StandardApi<'purchase.checkout.delivery-address.render-before'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered between the shipping address header
@@ -158,7 +159,7 @@ export interface RenderExtensionTargets {
    */
   'Checkout::DeliveryAddress::RenderBefore': RenderExtension<
     CheckoutApi & StandardApi<'Checkout::DeliveryAddress::RenderBefore'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered after the shipping address form elements.
@@ -166,7 +167,7 @@ export interface RenderExtensionTargets {
   'purchase.checkout.delivery-address.render-after': RenderExtension<
     CheckoutApi &
       StandardApi<'purchase.checkout.delivery-address.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A [block extension target](https://shopify.dev/docs/api/checkout-ui-extensions/extension-targets-overview#block-extension-targets) that isn't tied to a specific checkout section or feature.
@@ -178,7 +179,7 @@ export interface RenderExtensionTargets {
    */
   'purchase.checkout.block.render': RenderExtension<
     CheckoutApi & StandardApi<'purchase.checkout.block.render'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A [block extension target](https://shopify.dev/docs/api/checkout-ui-extensions/extension-targets-overview#block-extension-targets) that isn't tied to a specific checkout section or feature.
@@ -193,7 +194,7 @@ export interface RenderExtensionTargets {
    */
   'Checkout::Dynamic::Render': RenderExtension<
     CheckoutApi & StandardApi<'Checkout::Dynamic::Render'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A [block extension target](https://shopify.dev/docs/api/checkout-ui-extensions/extension-targets-overview#block-extension-targets) that renders exclusively on the **Thank you** page.
@@ -206,7 +207,7 @@ export interface RenderExtensionTargets {
    */
   'purchase.thank-you.block.render': RenderExtension<
     OrderConfirmationApi & StandardApi<'purchase.thank-you.block.render'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A [block extension target](https://shopify.dev/docs/api/checkout-ui-extensions/extension-targets-overview#block-extension-targets) that renders exclusively on the **Thank you** page.
@@ -221,7 +222,7 @@ export interface RenderExtensionTargets {
    */
   'Checkout::ThankYou::Dynamic::Render': RenderExtension<
     OrderConfirmationApi & StandardApi<'Checkout::ThankYou::Dynamic::Render'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that renders on every line item, inside the details
@@ -231,7 +232,7 @@ export interface RenderExtensionTargets {
     OrderConfirmationApi &
       CartLineItemApi &
       StandardApi<'purchase.thank-you.cart-line-item.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that renders on every line item, inside the details
@@ -244,7 +245,7 @@ export interface RenderExtensionTargets {
     OrderConfirmationApi &
       CartLineItemApi &
       StandardApi<'Checkout::ThankYou::CartLineDetails::RenderAfter'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered after all line items on the **Thank you** page.
@@ -252,7 +253,7 @@ export interface RenderExtensionTargets {
   'purchase.thank-you.cart-line-list.render-after': RenderExtension<
     OrderConfirmationApi &
       StandardApi<'purchase.thank-you.cart-line-list.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered after all line items on the **Thank you** page.
@@ -263,7 +264,7 @@ export interface RenderExtensionTargets {
   'Checkout::ThankYou::CartLines::RenderAfter': RenderExtension<
     OrderConfirmationApi &
       StandardApi<'Checkout::ThankYou::CartLines::RenderAfter'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered after a purchase below the customer information on the **Thank you** page.
@@ -271,7 +272,7 @@ export interface RenderExtensionTargets {
   'purchase.thank-you.customer-information.render-after': RenderExtension<
     OrderConfirmationApi &
       StandardApi<'purchase.thank-you.customer-information.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered after a purchase below the customer information on the **Thank you** page.
@@ -282,7 +283,7 @@ export interface RenderExtensionTargets {
   'Checkout::ThankYou::CustomerInformation::RenderAfter': RenderExtension<
     OrderConfirmationApi &
       StandardApi<'Checkout::ThankYou::CustomerInformation::RenderAfter'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that renders the gift card entry form fields after
@@ -295,7 +296,7 @@ export interface RenderExtensionTargets {
     RedeemableApi &
       CheckoutApi &
       StandardApi<'purchase.checkout.gift-card.render'>,
-    AnyComponentExcept<'Image' | 'Banner'>
+    AnyCheckoutComponentExcept<'Image' | 'Banner'>
   >;
   /**
    * A static extension target that renders the gift card entry form fields after
@@ -307,7 +308,7 @@ export interface RenderExtensionTargets {
    */
   'Checkout::GiftCard::Render': RenderExtension<
     RedeemableApi & CheckoutApi & StandardApi<'Checkout::GiftCard::Render'>,
-    AnyComponentExcept<'Image' | 'Banner'>
+    AnyCheckoutComponentExcept<'Image' | 'Banner'>
   >;
   /**
    * A static extension target that renders the form fields for a payment method when selected by the buyer.
@@ -318,7 +319,7 @@ export interface RenderExtensionTargets {
     PaymentOptionItemApi &
       CheckoutApi &
       StandardApi<'purchase.checkout.payment-option-item.details.render'>,
-    AnyComponentExcept<'Image' | 'Banner'>
+    AnyCheckoutComponentExcept<'Image' | 'Banner'>
   >;
   /**
    * A static extension target that renders the form fields for a payment method when selected by the buyer.
@@ -330,7 +331,7 @@ export interface RenderExtensionTargets {
     PaymentOptionItemApi &
       CheckoutApi &
       StandardApi<'Checkout::PaymentMethod::Render'>,
-    AnyComponentExcept<'Image' | 'Banner'>
+    AnyCheckoutComponentExcept<'Image' | 'Banner'>
   >;
   /**
    * A static extension target that renders after the hosted fields of a credit card payment method.
@@ -341,7 +342,7 @@ export interface RenderExtensionTargets {
     PaymentOptionItemApi &
       CheckoutApi &
       StandardApi<'purchase.checkout.payment-option-item.hosted-fields.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that renders after the hosted fields of a credit card payment method.
@@ -354,7 +355,7 @@ export interface RenderExtensionTargets {
     PaymentOptionItemApi &
       CheckoutApi &
       StandardApi<'Checkout::PaymentMethod::HostedFields::RenderAfter'>,
-    AnyComponentExcept<'Image' | 'Banner'>
+    AnyCheckoutComponentExcept<'Image' | 'Banner'>
   >;
   /**
    * A static extension target that renders a form modal when a buyer selects the custom onsite payment method.
@@ -364,7 +365,7 @@ export interface RenderExtensionTargets {
   'purchase.checkout.payment-option-item.action-required.render': RenderExtension<
     CheckoutApi &
       StandardApi<'purchase.checkout.payment-option-item.action-required.render'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that renders a form modal when a buyer selects the custom onsite payment method.
@@ -374,7 +375,7 @@ export interface RenderExtensionTargets {
    */
   'Checkout::PaymentMethod::RenderRequiredAction': RenderExtension<
     CheckoutApi & StandardApi<'Checkout::PaymentMethod::RenderRequiredAction'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that renders between the payment heading and payment method list.
@@ -383,7 +384,7 @@ export interface RenderExtensionTargets {
   'purchase.checkout.payment-method-list.render-before': RenderExtension<
     CheckoutApi &
       StandardApi<'purchase.checkout.payment-method-list.render-before'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that renders below the list of payment methods.
@@ -392,14 +393,14 @@ export interface RenderExtensionTargets {
   'purchase.checkout.payment-method-list.render-after': RenderExtension<
     CheckoutApi &
       StandardApi<'purchase.checkout.payment-method-list.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered in the order summary, before the discount form element.
    */
   'purchase.checkout.reductions.render-before': RenderExtension<
     CheckoutApi & StandardApi<'purchase.checkout.reductions.render-before'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered in the order summary, before the discount form element.
@@ -409,7 +410,7 @@ export interface RenderExtensionTargets {
    */
   'Checkout::Reductions::RenderBefore': RenderExtension<
     CheckoutApi & StandardApi<'Checkout::Reductions::RenderBefore'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered in the order summary, after the discount form
@@ -417,7 +418,7 @@ export interface RenderExtensionTargets {
    */
   'purchase.checkout.reductions.render-after': RenderExtension<
     CheckoutApi & StandardApi<'purchase.checkout.reductions.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered in the order summary, after the discount form
@@ -428,7 +429,7 @@ export interface RenderExtensionTargets {
    */
   'Checkout::Reductions::RenderAfter': RenderExtension<
     CheckoutApi & StandardApi<'Checkout::Reductions::RenderAfter'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered between the shipping method
@@ -438,7 +439,7 @@ export interface RenderExtensionTargets {
     ShippingOptionListApi &
       CheckoutApi &
       StandardApi<'purchase.checkout.shipping-option-list.render-before'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered between the shipping method
@@ -451,7 +452,7 @@ export interface RenderExtensionTargets {
     ShippingOptionListApi &
       CheckoutApi &
       StandardApi<'Checkout::ShippingMethods::RenderBefore'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered after the shipping method
@@ -461,7 +462,7 @@ export interface RenderExtensionTargets {
     ShippingOptionListApi &
       CheckoutApi &
       StandardApi<'purchase.checkout.shipping-option-list.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered after the shipping method
@@ -474,7 +475,7 @@ export interface RenderExtensionTargets {
     ShippingOptionListApi &
       CheckoutApi &
       StandardApi<'Checkout::ShippingMethods::RenderAfter'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered before pickup location options.
@@ -483,7 +484,7 @@ export interface RenderExtensionTargets {
     PickupLocationListApi &
       CheckoutApi &
       StandardApi<'purchase.checkout.pickup-location-list.render-before'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered before pickup location options.
@@ -495,7 +496,7 @@ export interface RenderExtensionTargets {
     PickupLocationListApi &
       CheckoutApi &
       StandardApi<'Checkout::PickupLocations::RenderBefore'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered after pickup location options.
@@ -504,7 +505,7 @@ export interface RenderExtensionTargets {
     PickupLocationListApi &
       CheckoutApi &
       StandardApi<'purchase.checkout.pickup-location-list.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered after pickup location options.
@@ -516,7 +517,7 @@ export interface RenderExtensionTargets {
     PickupLocationListApi &
       CheckoutApi &
       StandardApi<'Checkout::PickupLocations::RenderAfter'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered after the shipping method
@@ -526,7 +527,7 @@ export interface RenderExtensionTargets {
     ShippingOptionItemApi &
       CheckoutApi &
       StandardApi<'purchase.checkout.shipping-option-item.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered after the shipping method
@@ -539,7 +540,7 @@ export interface RenderExtensionTargets {
     ShippingOptionItemApi &
       CheckoutApi &
       StandardApi<'Checkout::ShippingMethodDetails::RenderAfter'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered under the shipping method
@@ -549,7 +550,7 @@ export interface RenderExtensionTargets {
     ShippingOptionItemApi &
       CheckoutApi &
       StandardApi<'purchase.checkout.shipping-option-item.details.render'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered under the shipping method
@@ -562,7 +563,7 @@ export interface RenderExtensionTargets {
     ShippingOptionItemApi &
       CheckoutApi &
       StandardApi<'Checkout::ShippingMethodDetails::RenderExpanded'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered immediately before the pickup points.
@@ -571,7 +572,7 @@ export interface RenderExtensionTargets {
     PickupPointListApi &
       CheckoutApi &
       StandardApi<'purchase.checkout.pickup-point-list.render-before'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered immediately before the pickup points.
@@ -583,7 +584,7 @@ export interface RenderExtensionTargets {
     PickupPointListApi &
       CheckoutApi &
       StandardApi<'Checkout::PickupPoints::RenderBefore'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered immediately after the pickup points.
@@ -592,7 +593,7 @@ export interface RenderExtensionTargets {
     PickupPointListApi &
       CheckoutApi &
       StandardApi<'purchase.checkout.pickup-point-list.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered immediately after the pickup points.
@@ -604,7 +605,7 @@ export interface RenderExtensionTargets {
     PickupPointListApi &
       CheckoutApi &
       StandardApi<'Checkout::PickupPoints::RenderAfter'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered after the pickup location
@@ -614,21 +615,21 @@ export interface RenderExtensionTargets {
     PickupLocationItemApi &
       CheckoutApi &
       StandardApi<'purchase.checkout.pickup-location-option-item.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered below the header.
    */
   'purchase.checkout.header.render-after': RenderExtension<
     CheckoutApi & StandardApi<'purchase.checkout.header.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered below the footer.
    */
   'purchase.checkout.footer.render-after': RenderExtension<
     CheckoutApi & StandardApi<'purchase.checkout.footer.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered on top of the checkout page as an overlay.
@@ -644,7 +645,7 @@ export interface RenderExtensionTargets {
   'purchase.thank-you.header.render-after': RenderExtension<
     OrderConfirmationApi &
       StandardApi<'purchase.thank-you.header.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered below the footer on the **Thank you** page.
@@ -652,7 +653,7 @@ export interface RenderExtensionTargets {
   'purchase.thank-you.footer.render-after': RenderExtension<
     OrderConfirmationApi &
       StandardApi<'purchase.thank-you.footer.render-after'>,
-    AnyComponent
+    AnyCheckoutComponent
   >;
   /**
    * A static extension target that is rendered on top of the **Thank you page** as an overlay.
@@ -662,6 +663,14 @@ export interface RenderExtensionTargets {
     OrderConfirmationApi & StandardApi<'purchase.thank-you.chat.render'>,
     AllowedComponents<'Chat'>
   >;
+  /**
+   * A static extension target that is rendered on top of the **Thank you page** as a dismissable announcement.
+   */
+  'purchase.thank-you.announcement.render': RenderExtension<
+    OrderConfirmationApi &
+      StandardApi<'purchase.thank-you.announcement.render'>,
+    AnyThankYouComponent
+  >;
 }
 
 export interface RunnableExtensionTargets {

package/src/surfaces/checkout/preact/api.ts

@@ -14,6 +14,10 @@ import {CheckoutUIExtensionError} from './errors';
  * which contains a basic set of properties about the checkout.
  *
  * For a full list of the API available to each extension target, see the [ExtensionTargets type](https://shopify.dev/docs/api/checkout-ui-extensions/apis/extensiontargets).
+ *
+ * > Note:
+ * > As of version 2025-10, you no longer need this hook. The full API object is accessible via
+ * > the global `shopify` object.
  */
 export function useApi<
   Target extends RenderExtensionTarget = RenderExtensionTarget,
@@ -22,7 +26,7 @@ export function useApi<
 
   if (!api) {
     throw new CheckoutUIExtensionError(
-      'You can only call this hook when running as a checkout UI extension on at least API version 2025-07.',
+      'You can only call this hook when running as a checkout UI extension on at least API version 2025-10.',
     );
   }
   return api;

package/src/surfaces/checkout/preact/attributes.ts

@@ -14,7 +14,7 @@ import {useSubscription} from './subscription';
  */
 export function useAttributes<
   Target extends RenderExtensionTarget = RenderExtensionTarget,
->(): Attribute[] | undefined {
+>(): Attribute[] {
   return useSubscription(useApi<Target>().attributes);
 }
 
@@ -28,7 +28,7 @@ export function useAttributeValues<
 >(keys: string[]): (string | undefined)[] {
   const attributes = useAttributes<Target>();
 
-  if (!attributes?.length) {
+  if (!attributes.length) {
     return [];
   }
 

package/src/surfaces/checkout/preact/subscription.ts

@@ -1,7 +1,8 @@
 import {useEffect, useState} from 'preact/hooks';
-import type {StatefulRemoteSubscribable} from '@remote-ui/async-subscription';
 
-type Subscriber<T> = Parameters<StatefulRemoteSubscribable<T>['subscribe']>[0];
+import type {SubscribableSignalLike} from '../shared';
+
+type Subscriber<T> = Parameters<SubscribableSignalLike<T>['subscribe']>[0];
 
 /**
  * Subscribes to the special wrapper type that all "changeable" values in the
@@ -9,13 +10,14 @@ type Subscriber<T> = Parameters<StatefulRemoteSubscribable<T>['subscribe']>[0];
  * and subscribes to update the value when changes occur in the checkout.
  *
  * > Note:
- * > You generally shouldn't need to use this directly, as there are dedicated hooks
- * > for accessing the current value of each individual resource in the checkout.
+ * > As of version 2025-10, you no longer need this hook. When you access `.value`
+ * > (instead of `.current`) on subscribable properties, Preact will automatically
+ * > re-render as `.value` changes.
  */
 export function useSubscription<Value>(
-  subscription: StatefulRemoteSubscribable<Value>,
+  subscription: SubscribableSignalLike<Value>,
 ): Value {
-  const [, setValue] = useState(subscription.current);
+  const [, setValue] = useState(subscription.value);
 
   useEffect(() => {
     let didUnsubscribe = false;
@@ -33,7 +35,7 @@ export function useSubscription<Value>(
     // Because we're subscribing in a passive effect,
     // it's possible for an update to occur between render and the effect handler.
     // Check for this and schedule an update if work has occurred.
-    checkForUpdates(subscription.current);
+    checkForUpdates(subscription.value);
 
     return () => {
       didUnsubscribe = true;
@@ -41,5 +43,5 @@ export function useSubscription<Value>(
     };
   }, [subscription]);
 
-  return subscription.current;
+  return subscription.value;
 }

package/src/surfaces/checkout/preact/tests/api.test.tsx

@@ -1,30 +1,39 @@
-/* eslint-disable jest/no-disabled-tests */
 import {useApi} from '../api';
 
-import {mount} from './mount';
+import {
+  mount,
+  setupGlobalShopifyMock,
+  tearDownGlobalShopifyMock,
+} from './mount';
+
+describe('useApi', () => {
+  beforeEach(() => {
+    setupGlobalShopifyMock({});
+  });
+
+  afterEach(tearDownGlobalShopifyMock);
 
-describe.skip('useApi', () => {
   it('returns api', async () => {
-    const extensionApi = {
-      extension: {target: 'purchase.checkout.block.render' as const},
-    };
-    const {value} = mount.hook(
-      () => useApi<'purchase.checkout.block.render'>(),
-      {
-        extensionApi,
-      },
+    const {value} = mount.hook(() =>
+      useApi<'purchase.checkout.block.render'>(),
     );
 
-    expect(value).toMatchObject(extensionApi);
+    expect(value).toMatchObject({
+      extension: {target: 'purchase.checkout.block.render'},
+    });
   });
 
   it('throws when not run inside a checkout UI extension', async () => {
+    tearDownGlobalShopifyMock();
+
     const runner = async () => {
       return mount.hook(() => useApi());
     };
 
     await expect(runner).rejects.toThrow(
-      'You can only call this hook when running as a checkout UI extension.',
+      expect.objectContaining({
+        name: 'CheckoutUIExtensionError',
+      }),
     );
   });
 });