@shopify/hydrogen-react 2024.10.1 → 2025.1.0

package/dist/types/storefront-api-types.d.ts

@@ -1,6 +1,6 @@
 /**
  * THIS FILE IS AUTO-GENERATED, DO NOT EDIT
- * Based on Storefront API 2024-10
+ * Based on Storefront API 2025-01
  * If changes need to happen to the types defined in this file, then generally the Storefront API needs to update. After it's updated, you can run `npm run graphql-types`.
  * Except custom Scalars, which are defined in the `codegen.ts` file
  */
@@ -142,9 +142,9 @@ export type Article = HasMetafields &
     id: Scalars['ID']['output'];
     /** The image associated with the article. */
     image?: Maybe<Image>;
-    /** Returns a metafield found by namespace and key. */
+    /** A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. */
     metafield?: Maybe<Metafield>;
-    /** The metafields associated with the resource matching the supplied list of namespaces and keys. */
+    /** A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. */
     metafields: Array<Maybe<Metafield>>;
     /** The URL used for viewing the resource on the shop's Online Store. Returns `null` if the resource is currently not published to the Online Store sales channel. */
     onlineStoreUrl?: Maybe<Scalars['URL']['output']>;
@@ -374,9 +374,9 @@ export type Blog = HasMetafields &
     handle: Scalars['String']['output'];
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
-    /** Returns a metafield found by namespace and key. */
+    /** A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. */
     metafield?: Maybe<Metafield>;
-    /** The metafields associated with the resource matching the supplied list of namespaces and keys. */
+    /** A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. */
     metafields: Array<Maybe<Metafield>>;
     /** The URL used for viewing the resource on the shop's Online Store. Returns `null` if the resource is currently not published to the Online Store sales channel. */
     onlineStoreUrl?: Maybe<Scalars['URL']['output']>;
@@ -505,7 +505,7 @@ export type BrandColors = {
 export type BuyerInput = {
   /** The identifier of the company location. */
   companyLocationId?: InputMaybe<Scalars['ID']['input']>;
-  /** The storefront customer access token retrieved from the [Customer Accounts API](https://shopify.dev/docs/api/customer/reference/mutations/storefrontCustomerAccessTokenCreate). */
+  /** The customer access token retrieved from the [Customer Accounts API](https://shopify.dev/docs/api/customer#step-obtain-access-token). */
   customerAccessToken: Scalars['String']['input'];
 };
 
@@ -548,6 +548,8 @@ export type Cart = HasMetafields &
     cost: CartCost;
     /** The date and time when the cart was created. */
     createdAt: Scalars['DateTime']['output'];
+    /** The delivery properties of the cart. */
+    delivery: CartDelivery;
     /**
      * The delivery groups available for the cart, based on the buyer identity default
      * delivery address preference or the default address of the logged-in customer.
@@ -571,9 +573,9 @@ export type Cart = HasMetafields &
     id: Scalars['ID']['output'];
     /** A list of lines containing information about the items the customer intends to purchase. */
     lines: BaseCartLineConnection;
-    /** Returns a metafield found by namespace and key. */
+    /** A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. */
     metafield?: Maybe<Metafield>;
-    /** The metafields associated with the resource matching the supplied list of namespaces and keys. */
+    /** A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. */
     metafields: Array<Maybe<Metafield>>;
     /** A note that's associated with the cart. For example, the note can be a personalized message to the buyer. */
     note?: Maybe<Scalars['String']['output']>;
@@ -648,6 +650,17 @@ export type CartMetafieldsArgs = {
   identifiers: Array<HasMetafieldsIdentifier>;
 };
 
+/** A delivery address of the buyer that is interacting with the cart. */
+export type CartAddress = CartDeliveryAddress;
+
+/** The input fields to provide exactly one of a variety of delivery address types. */
+export type CartAddressInput = {
+  /** Copies details from the customer address to an address on this cart. */
+  copyFromCustomerAddressId?: InputMaybe<Scalars['ID']['input']>;
+  /** A delivery address stored on this cart. */
+  deliveryAddress?: InputMaybe<CartDeliveryAddressInput>;
+};
+
 /** Return type for `cartAttributesUpdate` mutation. */
 export type CartAttributesUpdatePayload = {
   __typename?: 'CartAttributesUpdatePayload';
@@ -662,6 +675,8 @@ export type CartAttributesUpdatePayload = {
 /** The discounts automatically applied to the cart line based on prerequisites that have been met. */
 export type CartAutomaticDiscountAllocation = CartDiscountAllocation & {
   __typename?: 'CartAutomaticDiscountAllocation';
+  /** The discount that have been applied on the cart line. */
+  discountApplication: CartDiscountApplication;
   /** The discounted amount that has been applied to the cart line. */
   discountedAmount: MoneyV2;
   /** The type of line that the discount is applicable towards. */
@@ -693,6 +708,13 @@ export type CartBuyerIdentity = {
    * The rank of the preferences is determined by the order of the addresses in the array. Preferences
    * can be used to populate relevant fields in the checkout flow.
    *
+   * As of the `2025-01` release, `buyerIdentity.deliveryAddressPreferences` is deprecated.
+   * Delivery addresses are now part of the `CartDelivery` object and managed with three new mutations:
+   * - `cartDeliveryAddressAdd`
+   * - `cartDeliveryAddressUpdate`
+   * - `cartDeliveryAddressDelete`
+   *
+   * @deprecated Use `cart.delivery` instead.
    */
   deliveryAddressPreferences: Array<DeliveryAddress>;
   /** The email address of the buyer that's interacting with the cart. */
@@ -723,14 +745,6 @@ export type CartBuyerIdentityInput = {
   countryCode?: InputMaybe<CountryCode>;
   /** The access token used to identify the customer associated with the cart. */
   customerAccessToken?: InputMaybe<Scalars['String']['input']>;
-  /**
-   * An ordered set of delivery addresses tied to the buyer that is interacting with the cart.
-   * The rank of the preferences is determined by the order of the addresses in the array. Preferences
-   * can be used to populate relevant fields in the checkout flow.
-   *
-   * The input must not contain more than `250` values.
-   */
-  deliveryAddressPreferences?: InputMaybe<Array<DeliveryAddressInput>>;
   /** The email address of the buyer that is interacting with the cart. */
   email?: InputMaybe<Scalars['String']['input']>;
   /** The phone number of the buyer that is interacting with the cart. */
@@ -771,6 +785,8 @@ export type CartCodeDiscountAllocation = CartDiscountAllocation & {
   __typename?: 'CartCodeDiscountAllocation';
   /** The code used to apply the discount. */
   code: Scalars['String']['output'];
+  /** The discount that have been applied on the cart line. */
+  discountApplication: CartDiscountApplication;
   /** The discounted amount that has been applied to the cart line. */
   discountedAmount: MoneyV2;
   /** The type of line that the discount is applicable towards. */
@@ -845,13 +861,37 @@ export type CartCost = {
   totalAmount: MoneyV2;
   /** Whether the total amount is estimated. */
   totalAmountEstimated: Scalars['Boolean']['output'];
-  /** The duty amount for the customer to pay at checkout. */
+  /**
+   * The duty amount for the customer to pay at checkout.
+   * @deprecated Tax and duty amounts are no longer available and will be removed in a future version.
+   * Please see [the changelog](https://shopify.dev/changelog/tax-and-duties-are-deprecated-in-storefront-cart-api)
+   * for more information.
+   *
+   */
   totalDutyAmount?: Maybe<MoneyV2>;
-  /** Whether the total duty amount is estimated. */
+  /**
+   * Whether the total duty amount is estimated.
+   * @deprecated Tax and duty amounts are no longer available and will be removed in a future version.
+   * Please see [the changelog](https://shopify.dev/changelog/tax-and-duties-are-deprecated-in-storefront-cart-api)
+   * for more information.
+   *
+   */
   totalDutyAmountEstimated: Scalars['Boolean']['output'];
-  /** The tax amount for the customer to pay at checkout. */
+  /**
+   * The tax amount for the customer to pay at checkout.
+   * @deprecated Tax and duty amounts are no longer available and will be removed in a future version.
+   * Please see [the changelog](https://shopify.dev/changelog/tax-and-duties-are-deprecated-in-storefront-cart-api)
+   * for more information.
+   *
+   */
   totalTaxAmount?: Maybe<MoneyV2>;
-  /** Whether the total tax amount is estimated. */
+  /**
+   * Whether the total tax amount is estimated.
+   * @deprecated Tax and duty amounts are no longer available and will be removed in a future version.
+   * Please see [the changelog](https://shopify.dev/changelog/tax-and-duties-are-deprecated-in-storefront-cart-api)
+   * for more information.
+   *
+   */
   totalTaxAmountEstimated: Scalars['Boolean']['output'];
 };
 
@@ -869,6 +909,8 @@ export type CartCreatePayload = {
 /** The discounts automatically applied to the cart line based on prerequisites that have been met. */
 export type CartCustomDiscountAllocation = CartDiscountAllocation & {
   __typename?: 'CartCustomDiscountAllocation';
+  /** The discount that have been applied on the cart line. */
+  discountApplication: CartDiscountApplication;
   /** The discounted amount that has been applied to the cart line. */
   discountedAmount: MoneyV2;
   /** The type of line that the discount is applicable towards. */
@@ -877,6 +919,157 @@ export type CartCustomDiscountAllocation = CartDiscountAllocation & {
   title: Scalars['String']['output'];
 };
 
+/**
+ * The delivery properties of the cart.
+ *
+ */
+export type CartDelivery = {
+  __typename?: 'CartDelivery';
+  /** Selectable addresses to present to the buyer on the cart. */
+  addresses: Array<CartSelectableAddress>;
+};
+
+/**
+ * The delivery properties of the cart.
+ *
+ */
+export type CartDeliveryAddressesArgs = {
+  selected?: InputMaybe<Scalars['Boolean']['input']>;
+};
+
+/** Represents a mailing address for customers and shipping. */
+export type CartDeliveryAddress = {
+  __typename?: 'CartDeliveryAddress';
+  /** The first line of the address. Typically the street address or PO Box number. */
+  address1?: Maybe<Scalars['String']['output']>;
+  /**
+   * The second line of the address. Typically the number of the apartment, suite, or unit.
+   *
+   */
+  address2?: Maybe<Scalars['String']['output']>;
+  /** The name of the city, district, village, or town. */
+  city?: Maybe<Scalars['String']['output']>;
+  /** The name of the customer's company or organization. */
+  company?: Maybe<Scalars['String']['output']>;
+  /**
+   * The two-letter code for the country of the address.
+   *
+   * For example, US.
+   *
+   */
+  countryCode?: Maybe<Scalars['String']['output']>;
+  /** The first name of the customer. */
+  firstName?: Maybe<Scalars['String']['output']>;
+  /** A formatted version of the address, customized by the provided arguments. */
+  formatted: Array<Scalars['String']['output']>;
+  /** A comma-separated list of the values for city, province, and country. */
+  formattedArea?: Maybe<Scalars['String']['output']>;
+  /** The last name of the customer. */
+  lastName?: Maybe<Scalars['String']['output']>;
+  /** The latitude coordinate of the customer address. */
+  latitude?: Maybe<Scalars['Float']['output']>;
+  /** The longitude coordinate of the customer address. */
+  longitude?: Maybe<Scalars['Float']['output']>;
+  /** The full name of the customer, based on firstName and lastName. */
+  name?: Maybe<Scalars['String']['output']>;
+  /**
+   * A unique phone number for the customer.
+   *
+   * Formatted using E.164 standard. For example, _+16135551111_.
+   *
+   */
+  phone?: Maybe<Scalars['String']['output']>;
+  /**
+   * The alphanumeric code for the region.
+   *
+   * For example, ON.
+   *
+   */
+  provinceCode?: Maybe<Scalars['String']['output']>;
+  /** The zip or postal code of the address. */
+  zip?: Maybe<Scalars['String']['output']>;
+};
+
+/** Represents a mailing address for customers and shipping. */
+export type CartDeliveryAddressFormattedArgs = {
+  withCompany?: InputMaybe<Scalars['Boolean']['input']>;
+  withName?: InputMaybe<Scalars['Boolean']['input']>;
+};
+
+/** The input fields to create or update a cart address. */
+export type CartDeliveryAddressInput = {
+  /**
+   * The first line of the address. Typically the street address or PO Box number.
+   *
+   */
+  address1?: InputMaybe<Scalars['String']['input']>;
+  /**
+   * The second line of the address. Typically the number of the apartment, suite, or unit.
+   *
+   */
+  address2?: InputMaybe<Scalars['String']['input']>;
+  /**
+   * The name of the city, district, village, or town.
+   *
+   */
+  city?: InputMaybe<Scalars['String']['input']>;
+  /**
+   * The name of the customer's company or organization.
+   *
+   */
+  company?: InputMaybe<Scalars['String']['input']>;
+  /** The name of the country. */
+  countryCode?: InputMaybe<CountryCode>;
+  /** The first name of the customer. */
+  firstName?: InputMaybe<Scalars['String']['input']>;
+  /** The last name of the customer. */
+  lastName?: InputMaybe<Scalars['String']['input']>;
+  /**
+   * A unique phone number for the customer.
+   *
+   * Formatted using E.164 standard. For example, _+16135551111_.
+   *
+   */
+  phone?: InputMaybe<Scalars['String']['input']>;
+  /** The region of the address, such as the province, state, or district. */
+  provinceCode?: InputMaybe<Scalars['String']['input']>;
+  /** The zip or postal code of the address. */
+  zip?: InputMaybe<Scalars['String']['input']>;
+};
+
+/** Return type for `cartDeliveryAddressesAdd` mutation. */
+export type CartDeliveryAddressesAddPayload = {
+  __typename?: 'CartDeliveryAddressesAddPayload';
+  /** The updated cart. */
+  cart?: Maybe<Cart>;
+  /** The list of errors that occurred from executing the mutation. */
+  userErrors: Array<CartUserError>;
+  /** A list of warnings that occurred during the mutation. */
+  warnings: Array<CartWarning>;
+};
+
+/** Return type for `cartDeliveryAddressesRemove` mutation. */
+export type CartDeliveryAddressesRemovePayload = {
+  __typename?: 'CartDeliveryAddressesRemovePayload';
+  /** The updated cart. */
+  cart?: Maybe<Cart>;
+  /** The list of errors that occurred from executing the mutation. */
+  userErrors: Array<CartUserError>;
+  /** A list of warnings that occurred during the mutation. */
+  warnings: Array<CartWarning>;
+};
+
+/** Return type for `cartDeliveryAddressesUpdate` mutation. */
+export type CartDeliveryAddressesUpdatePayload = {
+  __typename?: 'CartDeliveryAddressesUpdatePayload';
+  /** The updated cart. */
+  cart?: Maybe<Cart>;
+  /** The list of errors that occurred from executing the mutation. */
+  userErrors: Array<CartUserError>;
+  /** A list of warnings that occurred during the mutation. */
+  warnings: Array<CartWarning>;
+};
+
 /** Preferred location used to find the closest pick up point based on coordinates. */
 export type CartDeliveryCoordinatesPreference = {
   __typename?: 'CartDeliveryCoordinatesPreference';
@@ -974,6 +1167,16 @@ export type CartDeliveryGroupType =
   /** The delivery group only contains subscription merchandise. */
   | 'SUBSCRIPTION';
 
+/** The input fields for the cart's delivery properties. */
+export type CartDeliveryInput = {
+  /**
+   * Selectable addresses to present to the buyer on the cart.
+   *
+   * The input must not contain more than `250` values.
+   */
+  addresses?: InputMaybe<Array<CartSelectableAddressInput>>;
+};
+
 /** Information about a delivery option. */
 export type CartDeliveryOption = {
   __typename?: 'CartDeliveryOption';
@@ -1034,6 +1237,8 @@ export type CartDeliveryPreferenceInput = {
  *
  */
 export type CartDirectPaymentMethodInput = {
+  /** Indicates if the customer has accepted the subscription terms. Defaults to false. */
+  acceptedSubscriptionTerms?: InputMaybe<Scalars['Boolean']['input']>;
   /** The customer's billing address. */
   billingAddress: MailingAddressInput;
   /** The source of the credit card payment. */
@@ -1044,12 +1249,30 @@ export type CartDirectPaymentMethodInput = {
 
 /** The discounts that have been applied to the cart line. */
 export type CartDiscountAllocation = {
+  /** The discount that have been applied on the cart line. */
+  discountApplication: CartDiscountApplication;
   /** The discounted amount that has been applied to the cart line. */
   discountedAmount: MoneyV2;
   /** The type of line that the discount is applicable towards. */
   targetType: DiscountApplicationTargetType;
 };
 
+/**
+ * The discount application capture the intentions of a discount source at
+ *         the time of application.
+ */
+export type CartDiscountApplication = {
+  __typename?: 'CartDiscountApplication';
+  /** The method by which the discount's value is allocated to its entitled items. */
+  allocationMethod: DiscountApplicationAllocationMethod;
+  /** Which lines of targetType that the discount is allocated over. */
+  targetSelection: DiscountApplicationTargetSelection;
+  /** The type of line that the discount is applicable towards. */
+  targetType: DiscountApplicationTargetType;
+  /** The value of the discount application. */
+  value: PricingValue;
+};
+
 /** The discount codes applied to the cart. */
 export type CartDiscountCode = {
   __typename?: 'CartDiscountCode';
@@ -1088,6 +1311,8 @@ export type CartErrorCode =
   | 'INVALID'
   /** Company location not found or not allowed. */
   | 'INVALID_COMPANY_LOCATION'
+  /** The delivery address was not found. */
+  | 'INVALID_DELIVERY_ADDRESS_ID'
   /** Delivery group was not found in cart. */
   | 'INVALID_DELIVERY_GROUP'
   /** Delivery option was not valid. */
@@ -1120,10 +1345,14 @@ export type CartErrorCode =
   | 'MISSING_NOTE'
   /** The note length must be below the specified maximum. */
   | 'NOTE_TOO_LONG'
+  /** Only one delivery address can be selected. */
+  | 'ONLY_ONE_DELIVERY_ADDRESS_CAN_BE_SELECTED'
   /** The payment method is not supported. */
   | 'PAYMENT_METHOD_NOT_SUPPORTED'
   /** The given province cannot be found. */
   | 'PROVINCE_NOT_FOUND'
+  /** Too many delivery addresses on Cart. */
+  | 'TOO_MANY_DELIVERY_ADDRESSES'
   /** A general error occurred during address validation. */
   | 'UNSPECIFIED_ADDRESS_ERROR'
   /** Validation failed. */
@@ -1155,6 +1384,17 @@ export type CartFreePaymentMethodInput = {
   billingAddress: MailingAddressInput;
 };
 
+/** Return type for `cartGiftCardCodesRemove` mutation. */
+export type CartGiftCardCodesRemovePayload = {
+  __typename?: 'CartGiftCardCodesRemovePayload';
+  /** The updated cart. */
+  cart?: Maybe<Cart>;
+  /** The list of errors that occurred from executing the mutation. */
+  userErrors: Array<CartUserError>;
+  /** A list of warnings that occurred during the mutation. */
+  warnings: Array<CartWarning>;
+};
+
 /** Return type for `cartGiftCardCodesUpdate` mutation. */
 export type CartGiftCardCodesUpdatePayload = {
   __typename?: 'CartGiftCardCodesUpdatePayload';
@@ -1181,6 +1421,8 @@ export type CartInput = {
    *
    */
   buyerIdentity?: InputMaybe<CartBuyerIdentityInput>;
+  /** The delivery-related fields for the cart. */
+  delivery?: InputMaybe<CartDeliveryInput>;
   /**
    * The case-insensitive discount codes that the customer added at checkout.
    *
@@ -1421,6 +1663,15 @@ export type CartNoteUpdatePayload = {
   warnings: Array<CartWarning>;
 };
 
+/** An error occurred during the cart operation. */
+export type CartOperationError = {
+  __typename?: 'CartOperationError';
+  /** The error code. */
+  code: Scalars['String']['output'];
+  /** The error message. */
+  message?: Maybe<Scalars['String']['output']>;
+};
+
 /**
  * The input fields for updating the payment method that will be used to checkout.
  *
@@ -1493,6 +1744,63 @@ export type CartPreferencesInput = {
   wallet?: InputMaybe<Array<Scalars['String']['input']>>;
 };
 
+/** Return type for `cartPrepareForCompletion` mutation. */
+export type CartPrepareForCompletionPayload = {
+  __typename?: 'CartPrepareForCompletionPayload';
+  /** The result of cart preparation for completion. */
+  result?: Maybe<CartPrepareForCompletionResult>;
+  /** The list of errors that occurred from executing the mutation. */
+  userErrors: Array<CartUserError>;
+};
+
+/** The result of cart preparation. */
+export type CartPrepareForCompletionResult =
+  | CartStatusNotReady
+  | CartStatusReady
+  | CartThrottled;
+
+/**
+ * A selectable delivery address for a cart.
+ *
+ */
+export type CartSelectableAddress = {
+  __typename?: 'CartSelectableAddress';
+  /** The delivery address. */
+  address: CartAddress;
+  /** A unique identifier for the address, specific to this cart. */
+  id: Scalars['ID']['output'];
+  /** This delivery address will not be associated with the buyer after a successful checkout. */
+  oneTimeUse: Scalars['Boolean']['output'];
+  /** Sets exactly one address as pre-selected for the buyer. */
+  selected: Scalars['Boolean']['output'];
+};
+
+/** The input fields for a selectable delivery address in a cart. */
+export type CartSelectableAddressInput = {
+  /** Exactly one kind of delivery address. */
+  address: CartAddressInput;
+  /** When true, this delivery address will not be associated with the buyer after a successful checkout. */
+  oneTimeUse?: InputMaybe<Scalars['Boolean']['input']>;
+  /** Sets exactly one address as pre-selected for the buyer. */
+  selected?: InputMaybe<Scalars['Boolean']['input']>;
+  /** Defines what kind of address validation is requested. */
+  validationStrategy?: InputMaybe<DeliveryAddressValidationStrategy>;
+};
+
+/** The input fields to update a line item on a cart. */
+export type CartSelectableAddressUpdateInput = {
+  /** Exactly one kind of delivery address. */
+  address?: InputMaybe<CartAddressInput>;
+  /** The id of the selectable address. */
+  id: Scalars['ID']['input'];
+  /** When true, this delivery address will not be associated with the buyer after a successful checkout. */
+  oneTimeUse?: InputMaybe<Scalars['Boolean']['input']>;
+  /** Sets exactly one address as pre-selected for the buyer. */
+  selected?: InputMaybe<Scalars['Boolean']['input']>;
+  /** Defines what kind of address validation is requested. */
+  validationStrategy?: InputMaybe<DeliveryAddressValidationStrategy>;
+};
+
 /**
  * The input fields for updating the selected delivery options for a delivery group.
  *
@@ -1515,6 +1823,22 @@ export type CartSelectedDeliveryOptionsUpdatePayload = {
   warnings: Array<CartWarning>;
 };
 
+/** Cart is not ready for payment update and completion. */
+export type CartStatusNotReady = {
+  __typename?: 'CartStatusNotReady';
+  /** The result of cart preparation for completion. */
+  cart?: Maybe<Cart>;
+  /** The list of errors that caused the cart to not be ready for payment update and completion. */
+  errors: Array<CartOperationError>;
+};
+
+/** Cart is ready for payment update and completion. */
+export type CartStatusReady = {
+  __typename?: 'CartStatusReady';
+  /** The result of cart preparation for completion. */
+  cart?: Maybe<Cart>;
+};
+
 /** Return type for `cartSubmitForCompletion` mutation. */
 export type CartSubmitForCompletionPayload = {
   __typename?: 'CartSubmitForCompletionPayload';
@@ -1531,6 +1855,17 @@ export type CartSubmitForCompletionResult =
   | SubmitSuccess
   | SubmitThrottled;
 
+/**
+ * Response signifying that the access to cart request is currently being throttled.
+ * The client can retry after `poll_after`.
+ *
+ */
+export type CartThrottled = {
+  __typename?: 'CartThrottled';
+  /** The polling delay. */
+  pollAfter: Scalars['DateTime']['output'];
+};
+
 /** Represents an error that happens during execution of a cart mutation. */
 export type CartUserError = DisplayableError & {
   __typename?: 'CartUserError';
@@ -1566,6 +1901,8 @@ export type CartWarning = {
 
 /** The code for the cart warning. */
 export type CartWarningCode =
+  /** A delivery address with the same details already exists on this cart. */
+  | 'DUPLICATE_DELIVERY_ADDRESS'
   /** The merchandise does not have enough stock. */
   | 'MERCHANDISE_NOT_ENOUGH_STOCK'
   /** The merchandise is out of stock. */
@@ -1573,6 +1910,15 @@ export type CartWarningCode =
   /** Gift cards are not available as a payment method. */
   | 'PAYMENTS_GIFT_CARDS_UNAVAILABLE';
 
+/**
+ * A filter used to view a subset of products in a collection matching a specific category value.
+ *
+ */
+export type CategoryFilter = {
+  /** The id of the category to filter on. */
+  id: Scalars['String']['input'];
+};
+
 /**
  * A collection represents a grouping of products that a shop owner can create to
  * organize them or make their shops easier to browse.
@@ -1597,9 +1943,9 @@ export type Collection = HasMetafields &
     id: Scalars['ID']['output'];
     /** Image associated with the collection. */
     image?: Maybe<Image>;
-    /** Returns a metafield found by namespace and key. */
+    /** A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. */
     metafield?: Maybe<Metafield>;
-    /** The metafields associated with the resource matching the supplied list of namespaces and keys. */
+    /** A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. */
     metafields: Array<Maybe<Metafield>>;
     /** The URL used for viewing the resource on the shop's Online Store. Returns `null` if the resource is currently not published to the Online Store sales channel. */
     onlineStoreUrl?: Maybe<Scalars['URL']['output']>;
@@ -1764,9 +2110,9 @@ export type Company = HasMetafields &
     externalId?: Maybe<Scalars['String']['output']>;
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
-    /** Returns a metafield found by namespace and key. */
+    /** A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. */
     metafield?: Maybe<Metafield>;
-    /** The metafields associated with the resource matching the supplied list of namespaces and keys. */
+    /** A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. */
     metafields: Array<Maybe<Metafield>>;
     /** The name of the company. */
     name: Scalars['String']['output'];
@@ -1812,9 +2158,9 @@ export type CompanyLocation = HasMetafields &
     id: Scalars['ID']['output'];
     /** The preferred locale of the company location. */
     locale?: Maybe<Scalars['String']['output']>;
-    /** Returns a metafield found by namespace and key. */
+    /** A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. */
     metafield?: Maybe<Metafield>;
-    /** The metafields associated with the resource matching the supplied list of namespaces and keys. */
+    /** A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. */
     metafields: Array<Maybe<Metafield>>;
     /** The name of the company location. */
     name: Scalars['String']['output'];
@@ -2810,9 +3156,9 @@ export type Customer = HasMetafields & {
   id: Scalars['ID']['output'];
   /** The customer’s last name. */
   lastName?: Maybe<Scalars['String']['output']>;
-  /** Returns a metafield found by namespace and key. */
+  /** A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. */
   metafield?: Maybe<Metafield>;
-  /** The metafields associated with the resource matching the supplied list of namespaces and keys. */
+  /** A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. */
   metafields: Array<Maybe<Metafield>>;
   /** The number of orders that the customer has made at the store in their lifetime. */
   numberOfOrders: Scalars['UnsignedInt64']['output'];
@@ -3587,9 +3933,9 @@ export type GeoCoordinateInput = {
 
 /** Represents information about the metafields associated to the specified resource. */
 export type HasMetafields = {
-  /** Returns a metafield found by namespace and key. */
+  /** A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. */
   metafield?: Maybe<Metafield>;
-  /** The metafields associated with the resource matching the supplied list of namespaces and keys. */
+  /** A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. */
   metafields: Array<Maybe<Metafield>>;
 };
 
@@ -4088,9 +4434,9 @@ export type Location = HasMetafields &
     address: LocationAddress;
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
-    /** Returns a metafield found by namespace and key. */
+    /** A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. */
     metafield?: Maybe<Metafield>;
-    /** The metafields associated with the resource matching the supplied list of namespaces and keys. */
+    /** A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. */
     metafields: Array<Maybe<Metafield>>;
     /** The name of the location. */
     name: Scalars['String']['output'];
@@ -4350,9 +4696,9 @@ export type Market = HasMetafields &
     handle: Scalars['String']['output'];
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
-    /** Returns a metafield found by namespace and key. */
+    /** A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. */
     metafield?: Maybe<Metafield>;
-    /** The metafields associated with the resource matching the supplied list of namespaces and keys. */
+    /** A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. */
     metafields: Array<Maybe<Metafield>>;
   };
 
@@ -4899,8 +5245,16 @@ export type Mutation = {
   cartBuyerIdentityUpdate?: Maybe<CartBuyerIdentityUpdatePayload>;
   /** Creates a new cart. */
   cartCreate?: Maybe<CartCreatePayload>;
+  /** Adds delivery addresses to the cart. */
+  cartDeliveryAddressesAdd?: Maybe<CartDeliveryAddressesAddPayload>;
+  /** Removes delivery addresses from the cart. */
+  cartDeliveryAddressesRemove?: Maybe<CartDeliveryAddressesRemovePayload>;
+  /** Updates one or more delivery addresses on a cart. */
+  cartDeliveryAddressesUpdate?: Maybe<CartDeliveryAddressesUpdatePayload>;
   /** Updates the discount codes applied to the cart. */
   cartDiscountCodesUpdate?: Maybe<CartDiscountCodesUpdatePayload>;
+  /** Removes the gift card codes applied to the cart. */
+  cartGiftCardCodesRemove?: Maybe<CartGiftCardCodesRemovePayload>;
   /** Updates the gift card codes applied to the cart. */
   cartGiftCardCodesUpdate?: Maybe<CartGiftCardCodesUpdatePayload>;
   /** Adds a merchandise line to the cart. */
@@ -4922,6 +5276,8 @@ export type Mutation = {
   cartNoteUpdate?: Maybe<CartNoteUpdatePayload>;
   /** Update the customer's payment method that will be used to checkout. */
   cartPaymentUpdate?: Maybe<CartPaymentUpdatePayload>;
+  /** Prepare the cart for cart checkout completion. */
+  cartPrepareForCompletion?: Maybe<CartPrepareForCompletionPayload>;
   /** Update the selected delivery options for a delivery group. */
   cartSelectedDeliveryOptionsUpdate?: Maybe<CartSelectedDeliveryOptionsUpdatePayload>;
   /** Submit the cart for checkout completion. */
@@ -5021,12 +5377,36 @@ export type MutationCartCreateArgs = {
   input?: InputMaybe<CartInput>;
 };
 
+/** The schema’s entry-point for mutations. This acts as the public, top-level API from which all mutation queries must start. */
+export type MutationCartDeliveryAddressesAddArgs = {
+  addresses: Array<CartSelectableAddressInput>;
+  cartId: Scalars['ID']['input'];
+};
+
+/** The schema’s entry-point for mutations. This acts as the public, top-level API from which all mutation queries must start. */
+export type MutationCartDeliveryAddressesRemoveArgs = {
+  addressIds: Array<Scalars['ID']['input']>;
+  cartId: Scalars['ID']['input'];
+};
+
+/** The schema’s entry-point for mutations. This acts as the public, top-level API from which all mutation queries must start. */
+export type MutationCartDeliveryAddressesUpdateArgs = {
+  addresses: Array<CartSelectableAddressUpdateInput>;
+  cartId: Scalars['ID']['input'];
+};
+
 /** The schema’s entry-point for mutations. This acts as the public, top-level API from which all mutation queries must start. */
 export type MutationCartDiscountCodesUpdateArgs = {
   cartId: Scalars['ID']['input'];
   discountCodes?: InputMaybe<Array<Scalars['String']['input']>>;
 };
 
+/** The schema’s entry-point for mutations. This acts as the public, top-level API from which all mutation queries must start. */
+export type MutationCartGiftCardCodesRemoveArgs = {
+  appliedGiftCardIds: Array<Scalars['ID']['input']>;
+  cartId: Scalars['ID']['input'];
+};
+
 /** The schema’s entry-point for mutations. This acts as the public, top-level API from which all mutation queries must start. */
 export type MutationCartGiftCardCodesUpdateArgs = {
   cartId: Scalars['ID']['input'];
@@ -5073,6 +5453,11 @@ export type MutationCartPaymentUpdateArgs = {
   payment: CartPaymentInput;
 };
 
+/** The schema’s entry-point for mutations. This acts as the public, top-level API from which all mutation queries must start. */
+export type MutationCartPrepareForCompletionArgs = {
+  cartId: Scalars['ID']['input'];
+};
+
 /** The schema’s entry-point for mutations. This acts as the public, top-level API from which all mutation queries must start. */
 export type MutationCartSelectedDeliveryOptionsUpdateArgs = {
   cartId: Scalars['ID']['input'];
@@ -5244,9 +5629,9 @@ export type Order = HasMetafields &
     id: Scalars['ID']['output'];
     /** List of the order’s line items. */
     lineItems: OrderLineItemConnection;
-    /** Returns a metafield found by namespace and key. */
+    /** A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. */
     metafield?: Maybe<Metafield>;
-    /** The metafields associated with the resource matching the supplied list of namespaces and keys. */
+    /** A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. */
     metafields: Array<Maybe<Metafield>>;
     /**
      * Unique identifier for the order that appears on the order.
@@ -5510,9 +5895,9 @@ export type Page = HasMetafields &
     handle: Scalars['String']['output'];
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
-    /** Returns a metafield found by namespace and key. */
+    /** A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. */
     metafield?: Maybe<Metafield>;
-    /** The metafields associated with the resource matching the supplied list of namespaces and keys. */
+    /** A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. */
     metafields: Array<Maybe<Metafield>>;
     /** The URL used for viewing the resource on the shop's Online Store. Returns `null` if the resource is currently not published to the Online Store sales channel. */
     onlineStoreUrl?: Maybe<Scalars['URL']['output']>;
@@ -5612,11 +5997,11 @@ export type PaginatedSitemapResources = {
 /** Settings related to payments. */
 export type PaymentSettings = {
   __typename?: 'PaymentSettings';
-  /** List of the card brands which the shop accepts. */
+  /** List of the card brands which the business entity accepts. */
   acceptedCardBrands: Array<CardBrand>;
   /** The url pointing to the endpoint to vault credit cards. */
   cardVaultUrl: Scalars['URL']['output'];
-  /** The country where the shop is located. */
+  /** The country where the shop is located. When multiple business entities operate within the shop, then this will represent the country of the business entity that's serving the specified buyer context. */
   countryCode: CountryCode;
   /** The three-letter code for the shop's primary currency. */
   currencyCode: CurrencyCode;
@@ -5628,7 +6013,7 @@ export type PaymentSettings = {
   enabledPresentmentCurrencies: Array<CurrencyCode>;
   /** The shop’s Shopify Payments account ID. */
   shopifyPaymentsAccountId?: Maybe<Scalars['String']['output']>;
-  /** List of the digital wallets which the shop supports. */
+  /** List of the digital wallets which the business entity supports. */
   supportedDigitalWallets: Array<DigitalWallet>;
 };
 
@@ -5702,10 +6087,16 @@ export type PricingPercentageValue = {
 export type PricingValue = MoneyV2 | PricingPercentageValue;
 
 /**
- * A product represents an individual item for sale in a Shopify store. Products are often physical, but they don't have to be.
- * For example, a digital download (such as a movie, music or ebook file) also
- * qualifies as a product, as do services (such as equipment rental, work for hire,
- * customization of another product or an extended warranty).
+ * The `Product` object lets you manage products in a merchant’s store.
+ *
+ * Products are the goods and services that merchants offer to customers.
+ * They can include various details such as title, description, price, images, and options such as size or color.
+ * You can use [product variants](/docs/api/storefront/latest/objects/ProductVariant)
+ * to create or update different versions of the same product.
+ * You can also add or update product [media](/docs/api/storefront/latest/interfaces/Media).
+ * Products can be organized by grouping them into a [collection](/docs/api/storefront/latest/objects/Collection).
+ *
+ * Learn more about working with [products and collections](/docs/storefronts/headless/building-with-the-storefront-api/products-collections).
  *
  */
 export type Product = HasMetafields &
@@ -5728,17 +6119,22 @@ export type Product = HasMetafields &
     adjacentVariants: Array<ProductVariant>;
     /** Indicates if at least one product variant is available for sale. */
     availableForSale: Scalars['Boolean']['output'];
-    /** The taxonomy category for the product. */
+    /** The category of a product from [Shopify's Standard Product Taxonomy](https://shopify.github.io/product-taxonomy/releases/unstable/?categoryId=sg-4-17-2-17). */
     category?: Maybe<TaxonomyCategory>;
-    /** List of collections a product belongs to. */
+    /** A list of [collections](/docs/api/storefront/latest/objects/Collection) that include the product. */
     collections: CollectionConnection;
-    /** The compare at price of the product across all variants. */
+    /** The [compare-at price range](https://help.shopify.com/manual/products/details/product-pricing/sale-pricing) of the product in the shop's default currency. */
     compareAtPriceRange: ProductPriceRange;
     /** The date and time when the product was created. */
     createdAt: Scalars['DateTime']['output'];
-    /** Stripped description of the product, single line with HTML tags removed. */
+    /** A single-line description of the product, with [HTML tags](https://developer.mozilla.org/en-US/docs/Web/HTML) removed. */
     description: Scalars['String']['output'];
-    /** The description of the product, complete with HTML formatting. */
+    /**
+     * The description of the product, with
+     * HTML tags. For example, the description might include
+     * bold `<strong></strong>` and italic `<i></i>` text.
+     *
+     */
     descriptionHtml: Scalars['HTML']['output'];
     /**
      * An encoded string containing all option value combinations
@@ -5809,8 +6205,9 @@ export type Product = HasMetafields &
      */
     featuredImage?: Maybe<Image>;
     /**
-     * A human-friendly unique string for the Product automatically generated from its title.
-     * They are used by the Liquid templating language to refer to objects.
+     * A unique, human-readable string of the product's title.
+     * A handle can contain letters, hyphens (`-`), and numbers, but no spaces.
+     * The handle is used in the online store URL for the product.
      *
      */
     handle: Scalars['String']['output'];
@@ -5820,27 +6217,36 @@ export type Product = HasMetafields &
     images: ImageConnection;
     /** Whether the product is a gift card. */
     isGiftCard: Scalars['Boolean']['output'];
-    /** The media associated with the product. */
+    /** The [media](/docs/apps/build/online-store/product-media) that are associated with the product. Valid media are images, 3D models, videos. */
     media: MediaConnection;
-    /** Returns a metafield found by namespace and key. */
+    /** A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. */
     metafield?: Maybe<Metafield>;
-    /** The metafields associated with the resource matching the supplied list of namespaces and keys. */
+    /** A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. */
     metafields: Array<Maybe<Metafield>>;
     /**
-     * The URL used for viewing the resource on the shop's Online Store. Returns
-     * `null` if the resource is currently not published to the Online Store sales channel.
+     * The product's URL on the online store.
+     * If `null`, then the product isn't published to the online store sales channel.
      *
      */
     onlineStoreUrl?: Maybe<Scalars['URL']['output']>;
-    /** List of product options. */
+    /** A list of product options. The limit is defined by the [shop's resource limits for product options](/docs/api/admin-graphql/latest/objects/Shop#field-resourcelimits) (`Shop.resourceLimits.maxProductOptions`). */
     options: Array<ProductOption>;
-    /** The price range. */
+    /**
+     * The minimum and maximum prices of a product, expressed in decimal numbers.
+     * For example, if the product is priced between $10.00 and $50.00,
+     * then the price range is $10.00 - $50.00.
+     *
+     */
     priceRange: ProductPriceRange;
-    /** A categorization that a product can be tagged with, commonly used for filtering and searching. */
+    /**
+     * The [product type](https://help.shopify.com/manual/products/details/product-type)
+     * that merchants define.
+     *
+     */
     productType: Scalars['String']['output'];
     /** The date and time when the product was published to the channel. */
     publishedAt: Scalars['DateTime']['output'];
-    /** Whether the product can only be purchased with a selling plan. */
+    /** Whether the product can only be purchased with a [selling plan](/docs/apps/build/purchase-options/subscriptions/selling-plans). Products that are sold on subscription (`requiresSellingPlan: true`) can be updated only for online stores. If you update a product to be subscription-only (`requiresSellingPlan:false`), then the product is unpublished from all channels, except the online store. */
     requiresSellingPlan: Scalars['Boolean']['output'];
     /**
      * Find an active product variant based on selected options, availability or the first variant.
@@ -5850,19 +6256,32 @@ export type Product = HasMetafields &
      *
      */
     selectedOrFirstAvailableVariant?: Maybe<ProductVariant>;
-    /** A list of a product's available selling plan groups. A selling plan group represents a selling method. For example, 'Subscribe and save' is a selling method where customers pay for goods or services per delivery. A selling plan group contains individual selling plans. */
+    /** A list of all [selling plan groups](/docs/apps/build/purchase-options/subscriptions/selling-plans/build-a-selling-plan) that are associated with the product either directly, or through the product's variants. */
     sellingPlanGroups: SellingPlanGroupConnection;
-    /** The product's SEO information. */
+    /**
+     * The [SEO title and description](https://help.shopify.com/manual/promoting-marketing/seo/adding-keywords)
+     * that are associated with a product.
+     *
+     */
     seo: Seo;
     /**
-     * A comma separated list of tags that have been added to the product.
-     * Additional access scope required for private apps: unauthenticated_read_product_tags.
+     * A comma-separated list of searchable keywords that are
+     * associated with the product. For example, a merchant might apply the `sports`
+     * and `summer` tags to products that are associated with sportwear for summer.
+     * Updating `tags` overwrites any existing tags that were previously added to the product.
+     * To add new tags without overwriting existing tags,
+     * use the GraphQL Admin API's [`tagsAdd`](/docs/api/admin-graphql/latest/mutations/tagsadd)
+     * mutation.
      *
      */
     tags: Array<Scalars['String']['output']>;
-    /** The product’s title. */
+    /**
+     * The name for the product that displays to customers. The title is used to construct the product's handle.
+     * For example, if a product is titled "Black Sunglasses", then the handle is `black-sunglasses`.
+     *
+     */
     title: Scalars['String']['output'];
-    /** The total quantity of inventory in stock for this Product. */
+    /** The quantity of inventory that's in stock. */
     totalInventory?: Maybe<Scalars['Int']['output']>;
     /** URL parameters to be added to a page URL to track the origin of on-site search traffic for [analytics reporting](https://help.shopify.com/manual/reports-and-analytics/shopify-reports/report-types/default-reports/behaviour-reports). Returns a result when accessed through the [search](https://shopify.dev/docs/api/storefront/current/queries/search) or [predictiveSearch](https://shopify.dev/docs/api/storefront/current/queries/predictiveSearch) queries, otherwise returns null. */
     trackingParameters?: Maybe<Scalars['String']['output']>;
@@ -5881,19 +6300,25 @@ export type Product = HasMetafields &
      *
      */
     variantBySelectedOptions?: Maybe<ProductVariant>;
-    /** List of the product’s variants. */
+    /** A list of [variants](/docs/api/storefront/latest/objects/ProductVariant) that are associated with the product. */
     variants: ProductVariantConnection;
-    /** The total count of variants for this product. */
+    /** The number of [variants](/docs/api/storefront/latest/objects/ProductVariant) that are associated with the product. */
     variantsCount?: Maybe<Count>;
-    /** The product’s vendor name. */
+    /** The name of the product's vendor. */
     vendor: Scalars['String']['output'];
   };
 
 /**
- * A product represents an individual item for sale in a Shopify store. Products are often physical, but they don't have to be.
- * For example, a digital download (such as a movie, music or ebook file) also
- * qualifies as a product, as do services (such as equipment rental, work for hire,
- * customization of another product or an extended warranty).
+ * The `Product` object lets you manage products in a merchant’s store.
+ *
+ * Products are the goods and services that merchants offer to customers.
+ * They can include various details such as title, description, price, images, and options such as size or color.
+ * You can use [product variants](/docs/api/storefront/latest/objects/ProductVariant)
+ * to create or update different versions of the same product.
+ * You can also add or update product [media](/docs/api/storefront/latest/interfaces/Media).
+ * Products can be organized by grouping them into a [collection](/docs/api/storefront/latest/objects/Collection).
+ *
+ * Learn more about working with [products and collections](/docs/storefronts/headless/building-with-the-storefront-api/products-collections).
  *
  */
 export type ProductAdjacentVariantsArgs = {
@@ -5903,10 +6328,16 @@ export type ProductAdjacentVariantsArgs = {
 };
 
 /**
- * A product represents an individual item for sale in a Shopify store. Products are often physical, but they don't have to be.
- * For example, a digital download (such as a movie, music or ebook file) also
- * qualifies as a product, as do services (such as equipment rental, work for hire,
- * customization of another product or an extended warranty).
+ * The `Product` object lets you manage products in a merchant’s store.
+ *
+ * Products are the goods and services that merchants offer to customers.
+ * They can include various details such as title, description, price, images, and options such as size or color.
+ * You can use [product variants](/docs/api/storefront/latest/objects/ProductVariant)
+ * to create or update different versions of the same product.
+ * You can also add or update product [media](/docs/api/storefront/latest/interfaces/Media).
+ * Products can be organized by grouping them into a [collection](/docs/api/storefront/latest/objects/Collection).
+ *
+ * Learn more about working with [products and collections](/docs/storefronts/headless/building-with-the-storefront-api/products-collections).
  *
  */
 export type ProductCollectionsArgs = {
@@ -5918,10 +6349,16 @@ export type ProductCollectionsArgs = {
 };
 
 /**
- * A product represents an individual item for sale in a Shopify store. Products are often physical, but they don't have to be.
- * For example, a digital download (such as a movie, music or ebook file) also
- * qualifies as a product, as do services (such as equipment rental, work for hire,
- * customization of another product or an extended warranty).
+ * The `Product` object lets you manage products in a merchant’s store.
+ *
+ * Products are the goods and services that merchants offer to customers.
+ * They can include various details such as title, description, price, images, and options such as size or color.
+ * You can use [product variants](/docs/api/storefront/latest/objects/ProductVariant)
+ * to create or update different versions of the same product.
+ * You can also add or update product [media](/docs/api/storefront/latest/interfaces/Media).
+ * Products can be organized by grouping them into a [collection](/docs/api/storefront/latest/objects/Collection).
+ *
+ * Learn more about working with [products and collections](/docs/storefronts/headless/building-with-the-storefront-api/products-collections).
  *
  */
 export type ProductDescriptionArgs = {
@@ -5929,10 +6366,16 @@ export type ProductDescriptionArgs = {
 };
 
 /**
- * A product represents an individual item for sale in a Shopify store. Products are often physical, but they don't have to be.
- * For example, a digital download (such as a movie, music or ebook file) also
- * qualifies as a product, as do services (such as equipment rental, work for hire,
- * customization of another product or an extended warranty).
+ * The `Product` object lets you manage products in a merchant’s store.
+ *
+ * Products are the goods and services that merchants offer to customers.
+ * They can include various details such as title, description, price, images, and options such as size or color.
+ * You can use [product variants](/docs/api/storefront/latest/objects/ProductVariant)
+ * to create or update different versions of the same product.
+ * You can also add or update product [media](/docs/api/storefront/latest/interfaces/Media).
+ * Products can be organized by grouping them into a [collection](/docs/api/storefront/latest/objects/Collection).
+ *
+ * Learn more about working with [products and collections](/docs/storefronts/headless/building-with-the-storefront-api/products-collections).
  *
  */
 export type ProductImagesArgs = {
@@ -5945,10 +6388,16 @@ export type ProductImagesArgs = {
 };
 
 /**
- * A product represents an individual item for sale in a Shopify store. Products are often physical, but they don't have to be.
- * For example, a digital download (such as a movie, music or ebook file) also
- * qualifies as a product, as do services (such as equipment rental, work for hire,
- * customization of another product or an extended warranty).
+ * The `Product` object lets you manage products in a merchant’s store.
+ *
+ * Products are the goods and services that merchants offer to customers.
+ * They can include various details such as title, description, price, images, and options such as size or color.
+ * You can use [product variants](/docs/api/storefront/latest/objects/ProductVariant)
+ * to create or update different versions of the same product.
+ * You can also add or update product [media](/docs/api/storefront/latest/interfaces/Media).
+ * Products can be organized by grouping them into a [collection](/docs/api/storefront/latest/objects/Collection).
+ *
+ * Learn more about working with [products and collections](/docs/storefronts/headless/building-with-the-storefront-api/products-collections).
  *
  */
 export type ProductMediaArgs = {
@@ -5961,10 +6410,16 @@ export type ProductMediaArgs = {
 };
 
 /**
- * A product represents an individual item for sale in a Shopify store. Products are often physical, but they don't have to be.
- * For example, a digital download (such as a movie, music or ebook file) also
- * qualifies as a product, as do services (such as equipment rental, work for hire,
- * customization of another product or an extended warranty).
+ * The `Product` object lets you manage products in a merchant’s store.
+ *
+ * Products are the goods and services that merchants offer to customers.
+ * They can include various details such as title, description, price, images, and options such as size or color.
+ * You can use [product variants](/docs/api/storefront/latest/objects/ProductVariant)
+ * to create or update different versions of the same product.
+ * You can also add or update product [media](/docs/api/storefront/latest/interfaces/Media).
+ * Products can be organized by grouping them into a [collection](/docs/api/storefront/latest/objects/Collection).
+ *
+ * Learn more about working with [products and collections](/docs/storefronts/headless/building-with-the-storefront-api/products-collections).
  *
  */
 export type ProductMetafieldArgs = {
@@ -5973,10 +6428,16 @@ export type ProductMetafieldArgs = {
 };
 
 /**
- * A product represents an individual item for sale in a Shopify store. Products are often physical, but they don't have to be.
- * For example, a digital download (such as a movie, music or ebook file) also
- * qualifies as a product, as do services (such as equipment rental, work for hire,
- * customization of another product or an extended warranty).
+ * The `Product` object lets you manage products in a merchant’s store.
+ *
+ * Products are the goods and services that merchants offer to customers.
+ * They can include various details such as title, description, price, images, and options such as size or color.
+ * You can use [product variants](/docs/api/storefront/latest/objects/ProductVariant)
+ * to create or update different versions of the same product.
+ * You can also add or update product [media](/docs/api/storefront/latest/interfaces/Media).
+ * Products can be organized by grouping them into a [collection](/docs/api/storefront/latest/objects/Collection).
+ *
+ * Learn more about working with [products and collections](/docs/storefronts/headless/building-with-the-storefront-api/products-collections).
  *
  */
 export type ProductMetafieldsArgs = {
@@ -5984,10 +6445,16 @@ export type ProductMetafieldsArgs = {
 };
 
 /**
- * A product represents an individual item for sale in a Shopify store. Products are often physical, but they don't have to be.
- * For example, a digital download (such as a movie, music or ebook file) also
- * qualifies as a product, as do services (such as equipment rental, work for hire,
- * customization of another product or an extended warranty).
+ * The `Product` object lets you manage products in a merchant’s store.
+ *
+ * Products are the goods and services that merchants offer to customers.
+ * They can include various details such as title, description, price, images, and options such as size or color.
+ * You can use [product variants](/docs/api/storefront/latest/objects/ProductVariant)
+ * to create or update different versions of the same product.
+ * You can also add or update product [media](/docs/api/storefront/latest/interfaces/Media).
+ * Products can be organized by grouping them into a [collection](/docs/api/storefront/latest/objects/Collection).
+ *
+ * Learn more about working with [products and collections](/docs/storefronts/headless/building-with-the-storefront-api/products-collections).
  *
  */
 export type ProductOptionsArgs = {
@@ -5995,10 +6462,16 @@ export type ProductOptionsArgs = {
 };
 
 /**
- * A product represents an individual item for sale in a Shopify store. Products are often physical, but they don't have to be.
- * For example, a digital download (such as a movie, music or ebook file) also
- * qualifies as a product, as do services (such as equipment rental, work for hire,
- * customization of another product or an extended warranty).
+ * The `Product` object lets you manage products in a merchant’s store.
+ *
+ * Products are the goods and services that merchants offer to customers.
+ * They can include various details such as title, description, price, images, and options such as size or color.
+ * You can use [product variants](/docs/api/storefront/latest/objects/ProductVariant)
+ * to create or update different versions of the same product.
+ * You can also add or update product [media](/docs/api/storefront/latest/interfaces/Media).
+ * Products can be organized by grouping them into a [collection](/docs/api/storefront/latest/objects/Collection).
+ *
+ * Learn more about working with [products and collections](/docs/storefronts/headless/building-with-the-storefront-api/products-collections).
  *
  */
 export type ProductSelectedOrFirstAvailableVariantArgs = {
@@ -6008,10 +6481,16 @@ export type ProductSelectedOrFirstAvailableVariantArgs = {
 };
 
 /**
- * A product represents an individual item for sale in a Shopify store. Products are often physical, but they don't have to be.
- * For example, a digital download (such as a movie, music or ebook file) also
- * qualifies as a product, as do services (such as equipment rental, work for hire,
- * customization of another product or an extended warranty).
+ * The `Product` object lets you manage products in a merchant’s store.
+ *
+ * Products are the goods and services that merchants offer to customers.
+ * They can include various details such as title, description, price, images, and options such as size or color.
+ * You can use [product variants](/docs/api/storefront/latest/objects/ProductVariant)
+ * to create or update different versions of the same product.
+ * You can also add or update product [media](/docs/api/storefront/latest/interfaces/Media).
+ * Products can be organized by grouping them into a [collection](/docs/api/storefront/latest/objects/Collection).
+ *
+ * Learn more about working with [products and collections](/docs/storefronts/headless/building-with-the-storefront-api/products-collections).
  *
  */
 export type ProductSellingPlanGroupsArgs = {
@@ -6023,10 +6502,16 @@ export type ProductSellingPlanGroupsArgs = {
 };
 
 /**
- * A product represents an individual item for sale in a Shopify store. Products are often physical, but they don't have to be.
- * For example, a digital download (such as a movie, music or ebook file) also
- * qualifies as a product, as do services (such as equipment rental, work for hire,
- * customization of another product or an extended warranty).
+ * The `Product` object lets you manage products in a merchant’s store.
+ *
+ * Products are the goods and services that merchants offer to customers.
+ * They can include various details such as title, description, price, images, and options such as size or color.
+ * You can use [product variants](/docs/api/storefront/latest/objects/ProductVariant)
+ * to create or update different versions of the same product.
+ * You can also add or update product [media](/docs/api/storefront/latest/interfaces/Media).
+ * Products can be organized by grouping them into a [collection](/docs/api/storefront/latest/objects/Collection).
+ *
+ * Learn more about working with [products and collections](/docs/storefronts/headless/building-with-the-storefront-api/products-collections).
  *
  */
 export type ProductVariantBySelectedOptionsArgs = {
@@ -6036,10 +6521,16 @@ export type ProductVariantBySelectedOptionsArgs = {
 };
 
 /**
- * A product represents an individual item for sale in a Shopify store. Products are often physical, but they don't have to be.
- * For example, a digital download (such as a movie, music or ebook file) also
- * qualifies as a product, as do services (such as equipment rental, work for hire,
- * customization of another product or an extended warranty).
+ * The `Product` object lets you manage products in a merchant’s store.
+ *
+ * Products are the goods and services that merchants offer to customers.
+ * They can include various details such as title, description, price, images, and options such as size or color.
+ * You can use [product variants](/docs/api/storefront/latest/objects/ProductVariant)
+ * to create or update different versions of the same product.
+ * You can also add or update product [media](/docs/api/storefront/latest/interfaces/Media).
+ * Products can be organized by grouping them into a [collection](/docs/api/storefront/latest/objects/Collection).
+ *
+ * Learn more about working with [products and collections](/docs/storefronts/headless/building-with-the-storefront-api/products-collections).
  *
  */
 export type ProductVariantsArgs = {
@@ -6111,6 +6602,8 @@ export type ProductEdge = {
 export type ProductFilter = {
   /** Filter on if the product is available for sale. */
   available?: InputMaybe<Scalars['Boolean']['input']>;
+  /** A product category to filter on. */
+  category?: InputMaybe<CategoryFilter>;
   /** A range of prices to filter with-in. */
   price?: InputMaybe<PriceRangeFilter>;
   /** A product metafield to filter on. */
@@ -6121,6 +6614,8 @@ export type ProductFilter = {
   productVendor?: InputMaybe<Scalars['String']['input']>;
   /** A product tag to filter on. */
   tag?: InputMaybe<Scalars['String']['input']>;
+  /** A standard product attribute metafield to filter on. */
+  taxonomyMetafield?: InputMaybe<TaxonomyMetafieldFilter>;
   /** A variant metafield to filter on. */
   variantMetafield?: InputMaybe<MetafieldFilter>;
   /** A variant option to filter on. */
@@ -6289,9 +6784,9 @@ export type ProductVariant = HasMetafields &
     id: Scalars['ID']['output'];
     /** Image associated with the product variant. This field falls back to the product image if no image is available. */
     image?: Maybe<Image>;
-    /** Returns a metafield found by namespace and key. */
+    /** A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. */
     metafield?: Maybe<Metafield>;
-    /** The metafields associated with the resource matching the supplied list of namespaces and keys. */
+    /** A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. */
     metafields: Array<Maybe<Metafield>>;
     /** The product variant’s price. */
     price: MoneyV2;
@@ -6730,6 +7225,8 @@ export type QueryRoot = {
   pageByHandle?: Maybe<Page>;
   /** List of the shop's pages. */
   pages: PageConnection;
+  /** Settings related to payments. */
+  paymentSettings: PaymentSettings;
   /** List of the predictive search results. */
   predictiveSearch?: Maybe<PredictiveSearchResult>;
   /** Fetch a specific `Product` by one of its unique attributes. */
@@ -6754,7 +7251,7 @@ export type QueryRoot = {
   productTags: StringConnection;
   /** List of product types for the shop's products that are published to your app. */
   productTypes: StringConnection;
-  /** List of the shop’s products. For storefront search, use [`search` query](https://shopify.dev/docs/api/storefront/latest/queries/search). */
+  /** Returns a list of the shop's products. For storefront search, use the [`search`](https://shopify.dev/docs/api/storefront/latest/queries/search) query. */
   products: ProductConnection;
   /** The list of public Storefront API versions, including supported, release candidate and unstable versions. */
   publicApiVersions: Array<ApiVersion>;
@@ -7149,9 +7646,9 @@ export type SellingPlan = HasMetafields & {
   description?: Maybe<Scalars['String']['output']>;
   /** A globally-unique ID. */
   id: Scalars['ID']['output'];
-  /** Returns a metafield found by namespace and key. */
+  /** A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. */
   metafield?: Maybe<Metafield>;
-  /** The metafields associated with the resource matching the supplied list of namespaces and keys. */
+  /** A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. */
   metafields: Array<Maybe<Metafield>>;
   /** The name of the selling plan. For example, '6 weeks of prepaid granola, delivered weekly'. */
   name: Scalars['String']['output'];
@@ -7385,7 +7882,7 @@ export type SellingPlanOption = {
 export type SellingPlanPercentagePriceAdjustment = {
   __typename?: 'SellingPlanPercentagePriceAdjustment';
   /** The percentage value of the price adjustment. */
-  adjustmentPercentage: Scalars['Int']['output'];
+  adjustmentPercentage: Scalars['Float']['output'];
 };
 
 /** Represents by how much the price of a variant associated with a selling plan is adjusted. Each variant can have up to two price adjustments. If a variant has multiple price adjustments, then the first price adjustment applies when the variant is initially purchased. The second price adjustment applies after a certain number of orders (specified by the `orderCount` field) are made. If a selling plan doesn't have any price adjustments, then the unadjusted price of the variant is the effective price. */
@@ -7431,9 +7928,9 @@ export type Shop = HasMetafields &
     description?: Maybe<Scalars['String']['output']>;
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
-    /** Returns a metafield found by namespace and key. */
+    /** A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. */
     metafield?: Maybe<Metafield>;
-    /** The metafields associated with the resource matching the supplied list of namespaces and keys. */
+    /** A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. */
     metafields: Array<Maybe<Metafield>>;
     /** A string representing the way currency is formatted when the currency isn’t specified. */
     moneyFormat: Scalars['String']['output'];
@@ -8058,13 +8555,15 @@ export type StoreAvailabilityEdge = {
 };
 
 /**
- * An auto-generated type for paginating through a list of Strings.
+ * An auto-generated type for paginating through multiple Strings.
  *
  */
 export type StringConnection = {
   __typename?: 'StringConnection';
   /** A list of edges. */
   edges: Array<StringEdge>;
+  /** A list of the nodes contained in StringEdge. */
+  nodes: Array<Scalars['String']['output']>;
   /** Information to aid in pagination. */
   pageInfo: PageInfo;
 };
@@ -8207,6 +8706,8 @@ export type SubmitSuccess = {
   __typename?: 'SubmitSuccess';
   /** The ID of the cart completion attempt that will be used for polling for the result. */
   attemptId: Scalars['String']['output'];
+  /** The url to which the buyer should be redirected after the cart is successfully submitted. */
+  redirectUrl: Scalars['URL']['output'];
 };
 
 /** Cart submit for checkout completion is throttled. */
@@ -8244,6 +8745,19 @@ export type TaxonomyCategory = Node & {
   name: Scalars['String']['output'];
 };
 
+/**
+ * A filter used to view a subset of products in a collection matching a specific taxonomy metafield value.
+ *
+ */
+export type TaxonomyMetafieldFilter = {
+  /** The key of the metafield to filter on. */
+  key: Scalars['String']['input'];
+  /** The namespace of the metafield to filter on. */
+  namespace: Scalars['String']['input'];
+  /** The value of the metafield. */
+  value: Scalars['String']['input'];
+};
+
 /** Represents a resource that you can track the origin of the search traffic. */
 export type Trackable = {
   /** URL parameters to be added to a page URL to track the origin of on-site search traffic for [analytics reporting](https://help.shopify.com/manual/reports-and-analytics/shopify-reports/report-types/default-reports/behaviour-reports). Returns a result when accessed through the [search](https://shopify.dev/docs/api/storefront/current/queries/search) or [predictiveSearch](https://shopify.dev/docs/api/storefront/current/queries/predictiveSearch) queries, otherwise returns null. */