Backport compliance changes to 2025-07 (#3477)

* Adds DiscountAllocation to CartLineItem API

Following the lead of
https://shopify.dev/docs/api/storefront/latest/objects/DiscountAllocation.

* Adds return and refund ids to ReturnTransactionData and ExchangeTransactionData

* POS: adds receipt header block target

---------

Co-authored-by: Alex Graffeo-Cohen <[email protected]>

Author: chadcromwell

.changeset/discount-allocations.md

@@ -0,0 +1,5 @@
+---
+'@shopify/ui-extensions': minor
+---
+
+Added optional `discountAllocations` field to Cart Line Item API so that POS extensions can see the precise proportion of a discount applied to a particular line item. Only the `allocatedAmount` field is included for this purpose, matching the Storefront API structure. See https://shopify.dev/docs/api/storefront/latest/objects/DiscountAllocation.

.changeset/hip-seas-change.md

@@ -0,0 +1,5 @@
+---
+'@shopify/ui-extensions': minor
+---
+
+Adds pos.receipt-header.block.render extension target

.changeset/tough-panthers-impress.md

@@ -0,0 +1,5 @@
+---
+'@shopify/ui-extensions': minor
+---
+
+Modified transaction data interface fields to include returnId and refundId to Return and Exchange TransactionData.

packages/ui-extensions/src/surfaces/point-of-sale/event/data/ExchangeTransactionData.ts

@@ -3,6 +3,7 @@ import {LineItem} from '../../types/cart';
 
 export interface ExchangeTransactionData extends BaseTransactionComplete {
   transactionType: 'Exchange';
+  returnId?: number;
   exchangeId?: number;
   lineItemsAdded: LineItem[];
   lineItemsRemoved: LineItem[];

packages/ui-extensions/src/surfaces/point-of-sale/event/data/ReturnTransactionData.ts

@@ -3,6 +3,7 @@ import {LineItem} from '../../types/cart';
 
 export interface ReturnTransactionData extends BaseTransactionComplete {
   transactionType: 'Return';
+  refundId?: number;
   returnId?: number;
   exchangeId?: number;
   lineItems: LineItem[];

packages/ui-extensions/src/surfaces/point-of-sale/targets.ts

@@ -185,6 +185,10 @@ export interface ExtensionTargets {
     {[key: string]: any} & StorageApi & TransactionCompleteWithReprintData,
     ReceiptComponents
   >;
+  'pos.receipt-header.block.render': RenderExtension<
+    {[key: string]: any} & StorageApi & TransactionCompleteWithReprintData,
+    ReceiptComponents
+  >;
 }
 
 export type ExtensionTarget = keyof ExtensionTargets;

packages/ui-extensions/src/surfaces/point-of-sale/types/cart.ts

@@ -1,5 +1,6 @@
 import {CountryCode} from './country-code';
 import {TaxLine} from './tax-line';
+import {DiscountAllocation} from './discount-allocation';
 
 export interface Cart {
   /**
@@ -40,6 +41,7 @@ export interface LineItem {
   variantId?: number;
   productId?: number;
   discounts: Discount[];
+  discountAllocations?: DiscountAllocation[];
   taxable: boolean;
   taxLines: TaxLine[];
   sku?: string;

packages/ui-extensions/src/surfaces/point-of-sale/types/discount-allocation.ts

@@ -0,0 +1,5 @@
+import type {MoneyV2} from './money';
+
+export interface DiscountAllocation {
+  allocatedAmount: MoneyV2;
+}

packages/ui-extensions/src/surfaces/point-of-sale/types/money.ts

@@ -2,3 +2,8 @@ export interface Money {
   amount: number;
   currency: string;
 }
+
+export interface MoneyV2 {
+  amount: string;
+  currencyCode: string;
+}