@shopify/ui-extensions 2025.10.0-rc.46 → 2025.10.0-rc.48

package/src/surfaces/checkout/preact/tests/delivery-group-list-target.test.ts

@@ -1,14 +1,20 @@
-import type {
-  DeliveryGroup,
-  ExtensionTarget,
-  ShippingOption,
-} from '@shopify/ui-extensions/checkout';
-
+import type {DeliveryGroup, ShippingOption} from '../../api/standard/standard';
 import {useDeliveryGroupListTarget} from '../delivery-group-list-target';
 
-import {mount, createMockStatefulRemoteSubscribable} from './mount';
+// See __mocks__/preact/hooks
+jest.mock('preact/hooks');
+
+import {
+  mount,
+  createMockSubscribableSignalLike,
+  setupGlobalShopifyMock,
+  tearDownGlobalShopifyMock,
+  createMockExtension,
+} from './mount';
+
+describe('useDeliveryGroupListTarget', () => {
+  afterEach(tearDownGlobalShopifyMock);
 
-describe.skip('useDeliveryGroupListTarget', () => {
   it('returns the DeliveryGroupList target if it exists', async () => {
     const deliveryGroup: DeliveryGroup = {
       selectedDeliveryOption: {
@@ -57,19 +63,19 @@ describe.skip('useDeliveryGroupListTarget', () => {
       ],
     };
 
-    const target: ExtensionTarget =
-      'purchase.checkout.shipping-option-list.render-before';
+    const target =
+      'purchase.checkout.shipping-option-list.render-before' as const;
 
-    const {value} = mount.hook(() => useDeliveryGroupListTarget(), {
-      extensionApi: {
-        extension: {target},
-        target: createMockStatefulRemoteSubscribable({
-          groupType: 'oneTimePurchase',
-          deliveryGroups: [deliveryGroup, deliveryGroup2],
-        }) as any,
-      },
+    setupGlobalShopifyMock<typeof target>({
+      extension: createMockExtension(target),
+      target: createMockSubscribableSignalLike({
+        groupType: 'oneTimePurchase',
+        deliveryGroups: [deliveryGroup, deliveryGroup2],
+      }),
     });
 
+    const {value} = mount.hook(() => useDeliveryGroupListTarget());
+
     expect(value).toStrictEqual({
       groupType: 'oneTimePurchase',
       deliveryGroups: [deliveryGroup, deliveryGroup2],

package/src/surfaces/checkout/preact/tests/delivery-group-target.test.ts

@@ -1,15 +1,21 @@
-import type {
-  DeliveryGroup,
-  ExtensionTarget,
-  ShippingOption,
-} from '@shopify/ui-extensions/checkout';
-
+import type {DeliveryGroup, ShippingOption} from '../../api/standard/standard';
 // eslint-disable-next-line import-x/no-deprecated
 import {useDeliveryGroupTarget} from '../delivery-group-target';
 
-import {mount, createMockStatefulRemoteSubscribable} from './mount';
+// See __mocks__/preact/hooks
+jest.mock('preact/hooks');
+
+import {
+  mount,
+  createMockSubscribableSignalLike,
+  setupGlobalShopifyMock,
+  tearDownGlobalShopifyMock,
+  createMockExtension,
+} from './mount';
+
+describe('useDeliveryGroupTarget', () => {
+  afterEach(tearDownGlobalShopifyMock);
 
-describe.skip('useDeliveryGroupTarget', () => {
   it('returns the DeliveryGroup target if it exists', async () => {
     const deliveryGroup: DeliveryGroup = {
       selectedDeliveryOption: {
@@ -58,20 +64,20 @@ describe.skip('useDeliveryGroupTarget', () => {
       ],
     };
 
-    const target: ExtensionTarget =
-      'purchase.checkout.shipping-option-list.render-before';
+    const target =
+      'purchase.checkout.shipping-option-list.render-before' as const;
 
-    // eslint-disable-next-line import-x/no-deprecated
-    const {value} = mount.hook(() => useDeliveryGroupTarget(), {
-      extensionApi: {
-        extension: {target},
-        target: createMockStatefulRemoteSubscribable({
-          groupType: 'oneTimePurchase',
-          deliveryGroups: [deliveryGroup, deliveryGroup2],
-        }) as any,
-      },
+    setupGlobalShopifyMock<typeof target>({
+      extension: createMockExtension(target),
+      target: createMockSubscribableSignalLike({
+        groupType: 'oneTimePurchase',
+        deliveryGroups: [deliveryGroup, deliveryGroup2],
+      }),
     });
 
+    // eslint-disable-next-line import-x/no-deprecated
+    const {value} = mount.hook(() => useDeliveryGroupTarget());
+
     expect(value).toStrictEqual(deliveryGroup);
   });
 });

package/src/surfaces/checkout/preact/tests/delivery-group.test.ts

@@ -2,14 +2,23 @@ import type {
   DeliveryGroup,
   ShippingOption,
   CartLine,
-} from '@shopify/ui-extensions/checkout';
+} from '../../api/standard/standard';
 
 import {useDeliveryGroup} from '../delivery-group';
 
-import type {PartialExtensionApi} from './mount';
-import {mount, createMockStatefulRemoteSubscribable} from './mount';
+import {
+  mount,
+  createMockSubscribableSignalLike,
+  setupGlobalShopifyMock,
+  tearDownGlobalShopifyMock,
+} from './mount';
+
+// See __mocks__/preact/hooks
+jest.mock('preact/hooks');
+
+describe('Delivery Group API hooks', () => {
+  afterEach(tearDownGlobalShopifyMock);
 
-describe.skip('Delivery Group API hooks', () => {
   describe('useDeliveryGroup', () => {
     const defaultLine = {
       id: 'gid://shopify/CartLine/stable_id',
@@ -35,17 +44,16 @@ describe.skip('Delivery Group API hooks', () => {
       },
       attributes: [],
       discountAllocations: [],
+      parentRelationship: null,
     } as CartLine;
 
     it('returns undefined when no delivery group is provided', async () => {
-      const extensionApi: PartialExtensionApi = {
-        lines: createMockStatefulRemoteSubscribable([defaultLine]),
-      };
-
-      const {value} = mount.hook(() => useDeliveryGroup(undefined), {
-        extensionApi,
+      setupGlobalShopifyMock({
+        lines: createMockSubscribableSignalLike([defaultLine]),
       });
 
+      const {value} = mount.hook(() => useDeliveryGroup(undefined));
+
       expect(value).toBeUndefined();
     });
 
@@ -112,14 +120,12 @@ describe.skip('Delivery Group API hooks', () => {
         ],
       };
 
-      const extensionApi: PartialExtensionApi = {
-        lines: createMockStatefulRemoteSubscribable([defaultLine]),
-      };
-
-      const {value} = mount.hook(() => useDeliveryGroup(deliveryGroup), {
-        extensionApi,
+      setupGlobalShopifyMock({
+        lines: createMockSubscribableSignalLike([defaultLine]),
       });
 
+      const {value} = mount.hook(() => useDeliveryGroup(deliveryGroup));
+
       const expectedDeliveryGroup = {
         ...deliveryGroup,
         selectedDeliveryOption: deliveryGroup.deliveryOptions[0],

package/src/surfaces/checkout/preact/tests/delivery-groups.test.ts

@@ -1,14 +1,20 @@
-import type {
-  DeliveryGroup,
-  ShippingOption,
-} from '@shopify/ui-extensions/checkout';
+import type {DeliveryGroup, ShippingOption} from '../../api/standard/standard';
 
 import {useDeliveryGroups} from '../delivery-groups';
 
-import type {PartialExtensionApi} from './mount';
-import {mount, createMockStatefulRemoteSubscribable} from './mount';
+// See __mocks__/preact/hooks
+jest.mock('preact/hooks');
+
+import {
+  mount,
+  createMockSubscribableSignalLike,
+  setupGlobalShopifyMock,
+  tearDownGlobalShopifyMock,
+} from './mount';
+
+describe('Delivery Groups API hooks', () => {
+  afterEach(tearDownGlobalShopifyMock);
 
-describe.skip('Delivery Groups API hooks', () => {
   describe('useDeliveryGroups', () => {
     it('returns the current devliery groups', async () => {
       const deliveryGroups: DeliveryGroup[] = [
@@ -51,11 +57,11 @@ describe.skip('Delivery Groups API hooks', () => {
         },
       ];
 
-      const extensionApi: PartialExtensionApi = {
-        deliveryGroups: createMockStatefulRemoteSubscribable(deliveryGroups),
-      };
+      setupGlobalShopifyMock({
+        deliveryGroups: createMockSubscribableSignalLike(deliveryGroups),
+      });
 
-      const {value} = mount.hook(() => useDeliveryGroups(), {extensionApi});
+      const {value} = mount.hook(() => useDeliveryGroups());
 
       expect(value).toBe(deliveryGroups);
     });

package/src/surfaces/checkout/preact/tests/delivery-selection-groups.test.ts

@@ -1,12 +1,20 @@
 import {faker} from '@faker-js/faker';
 
-import type {ExtensionTarget} from '@shopify/ui-extensions/checkout';
-
 import {useDeliverySelectionGroups} from '../delivery-selection-groups';
 
-import {mount, createMockStatefulRemoteSubscribable} from './mount';
+// See __mocks__/preact/hooks
+jest.mock('preact/hooks');
+
+import {
+  mount,
+  createMockSubscribableSignalLike,
+  setupGlobalShopifyMock,
+  tearDownGlobalShopifyMock,
+  createMockExtension,
+} from './mount';
 
-describe.skip('useDeliverySelectionGroups', () => {
+describe('useDeliverySelectionGroups', () => {
+  afterEach(tearDownGlobalShopifyMock);
   it('returns deliverySelectionGroups if it exists', async () => {
     const deliverySelectionGroup = {
       handle: faker.string.uuid(),
@@ -18,41 +26,40 @@ describe.skip('useDeliverySelectionGroups', () => {
       ],
       cost: {
         amount: 10,
-        currencyCode: 'USD',
+        currencyCode: 'USD' as const,
       },
       costAfterDiscounts: {
         amount: 10,
-        currencyCode: 'USD',
+        currencyCode: 'USD' as const,
       },
     };
 
-    const target: ExtensionTarget =
-      'purchase.checkout.shipping-option-list.render-before';
+    const target =
+      'purchase.checkout.shipping-option-list.render-before' as const;
 
-    const {value} = mount.hook(() => useDeliverySelectionGroups(), {
-      extensionApi: {
-        extension: {target},
-        deliverySelectionGroups: createMockStatefulRemoteSubscribable([
-          deliverySelectionGroup,
-        ]) as any,
-      },
+    setupGlobalShopifyMock<typeof target>({
+      extension: createMockExtension(target),
+      deliverySelectionGroups: createMockSubscribableSignalLike([
+        deliverySelectionGroup,
+      ]),
     });
 
+    const {value} = mount.hook(() => useDeliverySelectionGroups());
+
     expect(value).toStrictEqual([deliverySelectionGroup]);
   });
 
   it('returns undefined if delivery selection groups are missing', async () => {
-    const target: ExtensionTarget =
-      'purchase.checkout.shipping-option-list.render-before';
-
-    const {value} = mount.hook(() => useDeliverySelectionGroups(), {
-      extensionApi: {
-        extension: {target},
-        deliverySelectionGroups:
-          createMockStatefulRemoteSubscribable(undefined),
-      },
+    const target =
+      'purchase.checkout.shipping-option-list.render-before' as const;
+
+    setupGlobalShopifyMock<typeof target>({
+      extension: createMockExtension(target),
+      deliverySelectionGroups: createMockSubscribableSignalLike(undefined),
     });
 
+    const {value} = mount.hook(() => useDeliverySelectionGroups());
+
     expect(value).toBeUndefined();
   });
 });

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

@@ -1,14 +1,23 @@
 import type {
   CartDiscountCode,
   CartDiscountAllocation,
-} from '@shopify/ui-extensions/checkout';
+} from '../../api/standard/standard';
 
 import {useDiscountAllocations, useDiscountCodes} from '../discounts';
 
-import {mount, createMockStatefulRemoteSubscribable} from './mount';
-import type {PartialExtensionApi} from './mount';
+// See __mocks__/preact/hooks
+jest.mock('preact/hooks');
+
+import {
+  mount,
+  createMockSubscribableSignalLike,
+  setupGlobalShopifyMock,
+  tearDownGlobalShopifyMock,
+} from './mount';
+
+describe('Discounts API hooks', () => {
+  afterEach(tearDownGlobalShopifyMock);
 
-describe.skip('Discounts API hooks', () => {
   describe('useDiscountCodes', () => {
     it('returns the current discount codes', async () => {
       const discountCodes: CartDiscountCode[] = [
@@ -16,11 +25,11 @@ describe.skip('Discounts API hooks', () => {
         {code: 'free_shipping'},
       ];
 
-      const extensionApi: PartialExtensionApi = {
-        discountCodes: createMockStatefulRemoteSubscribable(discountCodes),
-      };
+      setupGlobalShopifyMock({
+        discountCodes: createMockSubscribableSignalLike(discountCodes),
+      });
 
-      const {value} = mount.hook(() => useDiscountCodes(), {extensionApi});
+      const {value} = mount.hook(() => useDiscountCodes());
 
       expect(value).toBe(discountCodes);
     });
@@ -55,15 +64,13 @@ describe.skip('Discounts API hooks', () => {
         },
       ];
 
-      const extensionApi: PartialExtensionApi = {
+      setupGlobalShopifyMock({
         discountAllocations:
-          createMockStatefulRemoteSubscribable(discountAllocations),
-      };
-
-      const {value} = mount.hook(() => useDiscountAllocations(), {
-        extensionApi,
+          createMockSubscribableSignalLike(discountAllocations),
       });
 
+      const {value} = mount.hook(() => useDiscountAllocations());
+
       expect(value).toBe(discountAllocations);
     });
   });

package/src/surfaces/checkout/preact/tests/extension-language.test.tsx

@@ -1,20 +1,29 @@
 import {useExtensionLanguage} from '../extension-language';
 
-import {mount, createMockStatefulRemoteSubscribable} from './mount';
+// See __mocks__/preact/hooks
+jest.mock('preact/hooks');
+
+import {
+  mount,
+  createMockSubscribableSignalLike,
+  setupGlobalShopifyMock,
+  tearDownGlobalShopifyMock,
+} from './mount';
+
+describe('useExtensionLanguage', () => {
+  afterEach(tearDownGlobalShopifyMock);
 
-describe.skip('useExtensionLanguage', () => {
   it('returns extension language from api', () => {
     const extensionLanguage = {isoCode: 'en-CA'};
 
-    const {value} = mount.hook(() => useExtensionLanguage(), {
-      extensionApi: {
-        localization: {
-          extensionLanguage:
-            createMockStatefulRemoteSubscribable(extensionLanguage),
-        },
+    setupGlobalShopifyMock({
+      localization: {
+        extensionLanguage: createMockSubscribableSignalLike(extensionLanguage),
       },
     });
 
+    const {value} = mount.hook(() => useExtensionLanguage());
+
     expect(value).toStrictEqual(extensionLanguage);
   });
 });

package/src/surfaces/checkout/preact/tests/gift-cards.test.tsx

@@ -1,11 +1,20 @@
-import type {AppliedGiftCard} from '@shopify/ui-extensions/checkout';
+import type {AppliedGiftCard} from '../../api/standard/standard';
 
 import {useAppliedGiftCards} from '../gift-cards';
 
-import {mount, createMockStatefulRemoteSubscribable} from './mount';
-import type {PartialExtensionApi} from './mount';
+// See __mocks__/preact/hooks
+jest.mock('preact/hooks');
+
+import {
+  mount,
+  createMockSubscribableSignalLike,
+  setupGlobalShopifyMock,
+  tearDownGlobalShopifyMock,
+} from './mount';
+
+describe('Gift cards API hooks', () => {
+  afterEach(tearDownGlobalShopifyMock);
 
-describe.skip('Gift cards API hooks', () => {
   describe('useAppliedGiftCards', () => {
     it('returns the current gift cards', async () => {
       const giftCards: AppliedGiftCard[] = [
@@ -21,11 +30,11 @@ describe.skip('Gift cards API hooks', () => {
         },
       ];
 
-      const extensionApi: PartialExtensionApi = {
-        appliedGiftCards: createMockStatefulRemoteSubscribable(giftCards),
-      };
+      setupGlobalShopifyMock({
+        appliedGiftCards: createMockSubscribableSignalLike(giftCards),
+      });
 
-      const {value} = mount.hook(() => useAppliedGiftCards(), {extensionApi});
+      const {value} = mount.hook(() => useAppliedGiftCards());
 
       expect(value).toBe(giftCards);
     });

package/src/surfaces/checkout/preact/tests/localized-fields.test.ts

@@ -1,21 +1,31 @@
-import type {LocalizedField} from '@shopify/ui-extensions/checkout';
+import type {LocalizedField} from '../../api/standard/standard';
 
 import {useLocalizedFields, useLocalizedField} from '../localized-fields';
 
-import {mount, createMockStatefulRemoteSubscribable} from './mount';
+// See __mocks__/preact/hooks
+jest.mock('preact/hooks');
+
+import {
+  mount,
+  createMockSubscribableSignalLike,
+  setupGlobalShopifyMock,
+  tearDownGlobalShopifyMock,
+} from './mount';
+
+describe('useLocalizedFields', () => {
+  afterEach(tearDownGlobalShopifyMock);
 
-describe.skip('useLocalizedFields', () => {
   it('throws an error if localized fields are not available', () => {
-    const extensionApi = {
+    setupGlobalShopifyMock({
       localizedFields: undefined,
-    };
+    });
 
     expect(() => {
-      mount.hook(() => useLocalizedFields(['TAX_CREDENTIAL_BR']), {
-        extensionApi,
-      });
+      mount.hook(() => useLocalizedFields(['TAX_CREDENTIAL_BR']));
     }).toThrow(
-      'Using localized fields requires having personal customer data permissions granted to your app.',
+      expect.objectContaining({
+        name: 'ScopeNotGrantedError',
+      }),
     );
   });
 
@@ -33,11 +43,11 @@ describe.skip('useLocalizedFields', () => {
       },
     ];
 
-    const extensionApi = {
-      localizedFields: createMockStatefulRemoteSubscribable(localizedFields),
-    };
+    setupGlobalShopifyMock({
+      localizedFields: createMockSubscribableSignalLike(localizedFields),
+    });
 
-    const {value} = mount.hook(() => useLocalizedFields(), {extensionApi});
+    const {value} = mount.hook(() => useLocalizedFields());
 
     expect(value).toStrictEqual(localizedFields);
   });
@@ -56,11 +66,11 @@ describe.skip('useLocalizedFields', () => {
       },
     ];
 
-    const extensionApi = {
-      localizedFields: createMockStatefulRemoteSubscribable(localizedFields),
-    };
+    setupGlobalShopifyMock({
+      localizedFields: createMockSubscribableSignalLike(localizedFields),
+    });
 
-    const {value} = mount.hook(() => useLocalizedFields([]), {extensionApi});
+    const {value} = mount.hook(() => useLocalizedFields([]));
 
     expect(value).toStrictEqual([]);
   });
@@ -79,14 +89,11 @@ describe.skip('useLocalizedFields', () => {
       },
     ];
 
-    const extensionApi = {
-      localizedFields: createMockStatefulRemoteSubscribable(localizedFields),
-    };
+    setupGlobalShopifyMock({
+      localizedFields: createMockSubscribableSignalLike(localizedFields),
+    });
 
-    const {value} = mount.hook(
-      () => useLocalizedFields(['TAX_CREDENTIAL_ES']),
-      {extensionApi},
-    );
+    const {value} = mount.hook(() => useLocalizedFields(['TAX_CREDENTIAL_ES']));
 
     expect(value).toStrictEqual([]);
   });
@@ -110,13 +117,12 @@ describe.skip('useLocalizedFields', () => {
       },
     ];
 
-    const extensionApi = {
-      localizedFields: createMockStatefulRemoteSubscribable(localizedFields),
-    };
+    setupGlobalShopifyMock({
+      localizedFields: createMockSubscribableSignalLike(localizedFields),
+    });
 
-    const {value} = mount.hook(
-      () => useLocalizedFields(['TAX_CREDENTIAL_MX', 'TAX_CREDENTIAL_USE_MX']),
-      {extensionApi},
+    const {value} = mount.hook(() =>
+      useLocalizedFields(['TAX_CREDENTIAL_MX', 'TAX_CREDENTIAL_USE_MX']),
     );
 
     expect(value).toMatchObject([localizedFields[0], localizedFields[2]]);
@@ -141,25 +147,24 @@ describe.skip('useLocalizedFields', () => {
       },
     ];
 
-    const extensionApi = {
-      localizedFields: createMockStatefulRemoteSubscribable(localizedFields),
-    };
-
-    const {value} = mount.hook(
-      () =>
-        useLocalizedFields([
-          'TAX_CREDENTIAL_MX',
-          'TAX_CREDENTIAL_BR',
-          'TAX_CREDENTIAL_USE_MX',
-        ]),
-      {extensionApi},
+    setupGlobalShopifyMock({
+      localizedFields: createMockSubscribableSignalLike(localizedFields),
+    });
+
+    const {value} = mount.hook(() =>
+      useLocalizedFields([
+        'TAX_CREDENTIAL_MX',
+        'TAX_CREDENTIAL_BR',
+        'TAX_CREDENTIAL_USE_MX',
+      ]),
     );
 
     expect(value).toMatchObject([localizedFields[0], localizedFields[2]]);
   });
 });
 
-describe.skip('useLocalizedField', () => {
+describe('useLocalizedField', () => {
+  afterEach(tearDownGlobalShopifyMock);
   it('returns the localized field that matches the passed key', async () => {
     const localizedFields: LocalizedField[] = [
       {
@@ -179,15 +184,12 @@ describe.skip('useLocalizedField', () => {
       },
     ];
 
-    const extensionApi = {
-      localizedFields: createMockStatefulRemoteSubscribable(localizedFields),
-    };
+    setupGlobalShopifyMock({
+      localizedFields: createMockSubscribableSignalLike(localizedFields),
+    });
 
-    const {value} = mount.hook(
-      () => useLocalizedField('TAX_CREDENTIAL_USE_MX'),
-      {
-        extensionApi,
-      },
+    const {value} = mount.hook(() =>
+      useLocalizedField('TAX_CREDENTIAL_USE_MX'),
     );
 
     expect(value).toStrictEqual(localizedFields[2]);
@@ -196,15 +198,12 @@ describe.skip('useLocalizedField', () => {
   it('returns undefined if no localized field matches the passed key', async () => {
     const localizedFields: LocalizedField[] = [];
 
-    const extensionApi = {
-      localizedFields: createMockStatefulRemoteSubscribable(localizedFields),
-    };
+    setupGlobalShopifyMock({
+      localizedFields: createMockSubscribableSignalLike(localizedFields),
+    });
 
-    const {value} = mount.hook(
-      () => useLocalizedField('TAX_CREDENTIAL_USE_MX'),
-      {
-        extensionApi,
-      },
+    const {value} = mount.hook(() =>
+      useLocalizedField('TAX_CREDENTIAL_USE_MX'),
     );
 
     expect(value).toBeUndefined();