@ehrenkind/shopify-lib 0.7.1 → 0.7.4

package/dist/index.d.cts

@@ -3,18 +3,20 @@ import z from 'zod';
 /**
  * Deletes a customer from Shopify by their ID.
  * @param customerId - The customer ID (GID string, e.g., "gid://shopify/Customer/123")
+ * @param retries - Number of retries on transient errors. Defaults to 1; idempotent — re-delete is a no-op.
  * @returns The deleted customer ID, or null if not found
  * @throws ShopifyUserError if Shopify returns user errors
  */
-declare function deleteCustomerById(customerId: string): Promise<string | undefined>;
+declare function deleteCustomerById(customerId: string, retries?: number): Promise<string | undefined>;
 
 /**
  * Deletes files from Shopify by their IDs.
  * @param fileIds - Array of file IDs to delete (e.g., "gid://shopify/MediaImage/123")
+ * @param retries - Number of retries on transient errors. Defaults to 1.
  * @returns Array of successfully deleted file IDs
  * @throws ShopifyUserError if Shopify returns user errors
  */
-declare function deleteFilesByIds(fileIds: string[]): Promise<string[]>;
+declare function deleteFilesByIds(fileIds: string[], retries?: number): Promise<string[]>;
 
 /**
  * Creates a file in Shopify from an external URL.
@@ -22,6 +24,7 @@ declare function deleteFilesByIds(fileIds: string[]): Promise<string[]>;
  * @param url - The HTTPS URL of the file to upload (must be publicly accessible)
  * @param altText - Alt text description for accessibility
  * @param filename - The filename to use in Shopify
+ * @param retries - Number of retries on transient errors. Defaults to 0; fileCreate is not idempotent, so a retry after a successful-but-lost response would create a duplicate file.
  * @returns Promise resolving to the created file ID
  * @throws {Error} When the URL doesn't start with https://
  * @throws {ShopifyUserError} When the mutation fails
@@ -33,7 +36,7 @@ declare function deleteFilesByIds(fileIds: string[]): Promise<string[]>;
  *   'product-image.png'
  * )
  */
-declare function createFile(url: string, altText: string, filename: string): Promise<string>;
+declare function createFile(url: string, altText: string, filename: string, retries?: number): Promise<string>;
 
 type MetaobjectFieldDefinition$1 = {
     key: string;
@@ -62,6 +65,7 @@ type CreateMetaobjectDefinitionResult = {
  * Creates a metaobject definition in Shopify.
  *
  * @param input - The metaobject definition input
+ * @param retries - Number of retries on transient errors. Defaults to 0; not retried by default to avoid duplicate definition creation.
  * @returns Promise resolving to the created metaobject definition
  * @throws {ShopifyUserError} When the mutation fails
  * @throws {Error} When GraphQL errors occur
@@ -77,7 +81,7 @@ type CreateMetaobjectDefinitionResult = {
  *   ],
  * })
  */
-declare function createMetaobjectDefinition(input: CreateMetaobjectDefinitionInput): Promise<CreateMetaobjectDefinitionResult>;
+declare function createMetaobjectDefinition(input: CreateMetaobjectDefinitionInput, retries?: number): Promise<CreateMetaobjectDefinitionResult>;
 
 type FulfillmentLineItem$1 = {
     id: number | bigint | string;
@@ -97,6 +101,7 @@ type CreateFulfillmentResult = {
  * @param fulfillmentOrderId - The fulfillment order ID (numeric, bigint, or GID string)
  * @param fulfillmentOrderLineItems - Line items to fulfill with their quantities
  * @param options - Optional tracking and notification settings
+ * @param retries - Number of retries on transient errors. Defaults to 0; fulfillmentCreate is not idempotent — a retry after a successful-but-lost response would create a duplicate fulfillment, double-decrement inventory, and may trigger duplicate customer emails.
  * @returns Promise resolving to the created fulfillment
  * @throws {ShopifyUserError} When the mutation fails
  * @throws {Error} When GraphQL errors occur
@@ -120,7 +125,7 @@ declare function createFulfillment(fulfillmentOrderId: number | bigint | string,
     carrier?: string;
     trackingUrl?: string;
     notifyCustomer?: boolean;
-}): Promise<CreateFulfillmentResult>;
+}, retries?: number): Promise<CreateFulfillmentResult>;
 
 type UpdateFulfillmentTrackingResult = {
     trackingNumbers: string[];
@@ -133,6 +138,7 @@ type UpdateFulfillmentTrackingResult = {
  * @param fulfillmentId - The fulfillment ID (numeric, bigint, or GID string)
  * @param trackingNumber - The new tracking number to add
  * @param notifyCustomer - Whether to notify the customer (default: false)
+ * @param retries - Number of retries on transient errors. Defaults to 1.
  * @returns Promise resolving to the updated tracking info
  * @throws {ShopifyUserError} When the mutation fails
  * @throws {Error} When fulfillment not found or GraphQL errors occur
@@ -144,12 +150,13 @@ type UpdateFulfillmentTrackingResult = {
  * // Add tracking and notify customer (e.g., last item in order)
  * await updateFulfillmentTracking(123456789, 'TRACK456', true)
  */
-declare function updateFulfillmentTracking(fulfillmentId: number | bigint | string, trackingNumber: string, notifyCustomer?: boolean): Promise<UpdateFulfillmentTrackingResult>;
+declare function updateFulfillmentTracking(fulfillmentId: number | bigint | string, trackingNumber: string, notifyCustomer?: boolean, retries?: number): Promise<UpdateFulfillmentTrackingResult>;
 
 /**
  * Cancel an order in Shopify.
  *
  * @param orderId - The order ID (numeric, bigint, or GID string)
+ * @param retries - Number of retries on transient errors. Defaults to 0; this is a destructive mutation and is not retried by default to avoid duplicate cancellations.
  * @returns Promise resolving to true on success
  * @throws {ShopifyUserError} When cancellation fails (e.g., ORDER_ALREADY_CANCELLED)
  *
@@ -167,7 +174,7 @@ declare function updateFulfillmentTracking(fulfillmentId: number | bigint | stri
  *   }
  * }
  */
-declare function cancelOrderById(orderId: number | bigint | string): Promise<boolean>;
+declare function cancelOrderById(orderId: number | bigint | string, retries?: number): Promise<boolean>;
 
 type Maybe<T> = T | null;
 type InputMaybe<T> = Maybe<T>;
@@ -1039,7 +1046,7 @@ type Article = HasEvents & HasMetafieldDefinitions & HasMetafields & HasPublishe
     body: Scalars['HTML']['output'];
     /** List of the article's comments. */
     comments: CommentConnection;
-    /** Count of comments. */
+    /** Count of comments. Limited to a maximum of 10000 by default. */
     commentsCount?: Maybe<Count>;
     /** The date and time (ISO 8601 format) when the article was created. */
     createdAt: Scalars['DateTime']['output'];
@@ -1174,7 +1181,7 @@ type Blog = HasEvents & HasMetafieldDefinitions & HasMetafields & HasPublishedTr
     __typename?: 'Blog';
     /** List of the blog's articles. */
     articles: ArticleConnection;
-    /** Count of articles. */
+    /** Count of articles. Limited to a maximum of 10000 by default. */
     articlesCount?: Maybe<Count>;
     /** Indicates whether readers can post comments to the blog and if comments are moderated or not. */
     commentPolicy: CommentPolicy;
@@ -1262,6 +1269,8 @@ type BusinessEntity = Node & {
     __typename?: 'BusinessEntity';
     /** The address of the merchant's Business Entity. */
     address: BusinessEntityAddress;
+    /** Whether the Business Entity is archived from the shop. */
+    archived: Scalars['Boolean']['output'];
     /** The name of the company associated with the merchant's Business Entity. */
     companyName?: Maybe<Scalars['String']['output']>;
     /** The display name of the merchant's Business Entity. */
@@ -1633,6 +1642,8 @@ type ChannelInformation = Node & {
     channelDefinition?: Maybe<ChannelDefinition>;
     /** The unique ID for the channel. */
     channelId: Scalars['ID']['output'];
+    /** The publishing destination display name or channel name. */
+    displayName?: Maybe<Scalars['String']['output']>;
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
 };
@@ -3439,6 +3450,18 @@ declare enum CurrencyCode {
     /** Zambian Kwacha (ZMW). */
     Zmw = "ZMW"
 }
+/** Represents a currency exchange adjustment applied to an order transaction. */
+type CurrencyExchangeAdjustment = Node & {
+    __typename?: 'CurrencyExchangeAdjustment';
+    /** The adjustment amount in both shop and presentment currencies. */
+    adjustment: MoneyV2;
+    /** The final amount in both shop and presentment currencies after the adjustment. */
+    finalAmountSet: MoneyV2;
+    /** A globally-unique ID. */
+    id: Scalars['ID']['output'];
+    /** The original amount in both shop and presentment currencies before the adjustment. */
+    originalAmountSet: MoneyV2;
+};
 /** Currency formats configured for the merchant. These formats are available to use within Liquid. */
 type CurrencyFormats = {
     __typename?: 'CurrencyFormats';
@@ -3460,6 +3483,8 @@ type CurrencySetting = {
     currencyName: Scalars['String']['output'];
     /** Whether the currency is enabled or not. An enabled currency setting is visible to buyers and allows orders to be generated with that currency as presentment. */
     enabled: Scalars['Boolean']['output'];
+    /** The manual rate, if enabled, that applies to this currency when converting from shop currency. This rate is specific to the associated market's currency setting. */
+    manualRate?: Maybe<Scalars['Decimal']['output']>;
     /** The date and time when the active exchange rate for the currency was last modified. It can be the automatic rate's creation date, or the manual rate's last updated at date if active. */
     rateUpdatedAt?: Maybe<Scalars['DateTime']['output']>;
 };
@@ -6944,6 +6969,8 @@ type DraftOrderPlatformDiscount = {
      * @deprecated Use `discountClasses` instead.
      */
     discountClass: DiscountClass;
+    /** The discount classes. */
+    discountClasses: Array<DiscountClass>;
     /** The discount node for the platform discount. */
     discountNode?: Maybe<DiscountNode>;
     /** The ID of the discount. */
@@ -7073,6 +7100,18 @@ type ExchangeLineItem = Node & {
      * @deprecated Use `lineItems` instead.
      */
     lineItem?: Maybe<LineItem>;
+    /** The order line items for the exchange. */
+    lineItems?: Maybe<Array<LineItem>>;
+    /** The quantity of the exchange item that can be processed. */
+    processableQuantity: Scalars['Int']['output'];
+    /** The quantity of the exchange item that have been processed. */
+    processedQuantity: Scalars['Int']['output'];
+    /** The number of units ordered, including refunded and removed units. */
+    quantity: Scalars['Int']['output'];
+    /** The quantity of the exchange item that haven't been processed. */
+    unprocessedQuantity: Scalars['Int']['output'];
+    /** The ID of the variant at time of return creation. */
+    variantId?: Maybe<Scalars['ID']['output']>;
 };
 /** An auto-generated type for paginating through multiple ExchangeLineItems. */
 type ExchangeLineItemConnection = {
@@ -9140,6 +9179,12 @@ type Image = HasMetafields & {
      * @deprecated Use `url` instead.
      */
     src: Scalars['URL']['output'];
+    /**
+     * The ThumbHash of the image.
+     *
+     * Useful to display placeholder images while the original image is loading.
+     */
+    thumbhash?: Maybe<Scalars['String']['output']>;
     /**
      * The location of the transformed image as a URL.
      *
@@ -9420,6 +9465,12 @@ type InventoryScheduledChangeEdge = {
     /** The item at the end of InventoryScheduledChangeEdge. */
     node: InventoryScheduledChange;
 };
+/** The financial transfer details for a return outcome that results in an invoice. */
+type InvoiceReturnOutcome = {
+    __typename?: 'InvoiceReturnOutcome';
+    /** The total monetary value to be invoiced in shop and presentment currencies. */
+    amount: MoneyBag;
+};
 /**
  * Interoperability metadata for types that directly correspond to a REST Admin API resource.
  * For example, on the Product type, LegacyInteroperability returns metadata for the corresponding [Product object](https://shopify.dev/api/admin-graphql/latest/objects/product) in the REST Admin API.
@@ -9647,6 +9698,8 @@ type LineItemGroup = Node & {
     customAttributes: Array<Attribute>;
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
+    /** ID of the product of the line item group. */
+    productId?: Maybe<Scalars['ID']['output']>;
     /** Quantity of the line item group on the order. */
     quantity: Scalars['Int']['output'];
     /** Title of the line item group. */
@@ -10370,6 +10423,8 @@ type MarketCurrencySettings = {
      * in the market's base currency.
      */
     localCurrencies: Scalars['Boolean']['output'];
+    /** Whether or not rounding is enabled on multi-currency prices. */
+    roundingEnabled: Scalars['Boolean']['output'];
 };
 /** An auto-generated type which holds one Market and a cursor during pagination. */
 type MarketEdge = {
@@ -10997,28 +11052,9 @@ type MetafieldAccess = {
     admin?: Maybe<MetafieldAdminAccess>;
     /** The access permitted on the Customer Account API. */
     customerAccount: MetafieldCustomerAccountAccess;
-    /**
-     * The explicit grants for this metafield definition, superseding the default admin access
-     * for the specified grantees.
-     * @deprecated Explicit grants are [deprecated](https://shopify.dev/changelog/deprecating-explicit-access-grants-for-app-owned-metafields).
-     *  This will be removed in 2025-07.
-     */
-    grants: Array<MetafieldAccessGrant>;
     /** The access permitted on the Storefront API. */
     storefront?: Maybe<MetafieldStorefrontAccess>;
 };
-/**
- * An explicit access grant for the metafields under this definition.
- *
- * Explicit grants are [deprecated](https://shopify.dev/changelog/deprecating-explicit-access-grants-for-app-owned-metafields).
- */
-type MetafieldAccessGrant = {
-    __typename?: 'MetafieldAccessGrant';
-    /** The level of access the grantee has. */
-    access: MetafieldGrantAccessLevel;
-    /** The grantee being granted access. */
-    grantee: Scalars['String']['output'];
-};
 /** Metafield access permissions for the Admin API. */
 declare enum MetafieldAdminAccess {
     /** The merchant has read-only access. No other apps have access. */
@@ -11285,13 +11321,6 @@ type MetafieldEdge = {
     /** The item at the end of MetafieldEdge. */
     node: Metafield;
 };
-/** Possible access levels for explicit metafield access grants. */
-declare enum MetafieldGrantAccessLevel {
-    /** Read metafield access. */
-    Read = "READ",
-    /** Read and write metafield access. */
-    ReadWrite = "READ_WRITE"
-}
 /**
  * The input fields to use to create or update a metafield through a mutation on the owning resource.
  * An alternative way to create or update a metafield is by using the
@@ -12036,6 +12065,13 @@ type MoneyBag = {
     /** Amount in shop currency. */
     shopMoney: MoneyV2;
 };
+/** The input fields for a monetary value with currency. */
+type MoneyInput = {
+    /** Decimal money amount. */
+    amount: Scalars['Decimal']['input'];
+    /** Currency of the money. */
+    currencyCode: CurrencyCode;
+};
 /** A precise monetary value and its associated currency. Combines a decimal amount with a three-letter currency code to express prices, costs, and other financial values throughout the API. For example, 12.99 USD. */
 type MoneyV2 = {
     __typename?: 'MoneyV2';
@@ -12401,6 +12437,8 @@ type Order = CommentEventSubject & HasEvents & HasLocalizationExtensions & HasLo
      * Commonly used for special delivery instructions, gift messages, or internal processing notes.
      */
     note?: Maybe<Scalars['String']['output']>;
+    /** The order number used to generate the name using the store's configured order number prefix/suffix. This number isn't guaranteed to follow a consecutive integer sequence (e.g. 1, 2, 3..), nor is it guaranteed to be unique across multiple stores, or even for a single store. */
+    number: Scalars['Int']['output'];
     /**
      * The total amount of all additional fees, such as import fees or taxes, that were applied when an order was created.
      * Returns `null` if additional fees aren't applicable.
@@ -12836,7 +12874,15 @@ declare enum OrderCancelUserErrorCode {
     /** The record with the ID used as the input value couldn't be found. */
     NotFound = "NOT_FOUND",
     /** An order refund was requested but the user does not have the refund_orders permission. */
-    NoRefundPermission = "NO_REFUND_PERMISSION"
+    NoRefundPermission = "NO_REFUND_PERMISSION",
+    /** An order refund was requested but the user does not have the refund_to_store_credit permission. */
+    NoRefundToStoreCreditPermission = "NO_REFUND_TO_STORE_CREDIT_PERMISSION",
+    /** A store credit order refund was requested but the order is a B2B order. */
+    StoreCreditRefundB2BNotSupported = "STORE_CREDIT_REFUND_B2B_NOT_SUPPORTED",
+    /** A store credit order refund was requested but the expiration date is in the past. */
+    StoreCreditRefundExpirationInPast = "STORE_CREDIT_REFUND_EXPIRATION_IN_PAST",
+    /** A store credit order refund was requested but the order has no customer. */
+    StoreCreditRefundMissingCustomer = "STORE_CREDIT_REFUND_MISSING_CUSTOMER"
 }
 /** Details about the order cancellation. */
 type OrderCancellation = {
@@ -13068,6 +13114,10 @@ type OrderTransaction = Node & {
     authorizationExpiresAt?: Maybe<Scalars['DateTime']['output']>;
     /** Date and time when the transaction was created. */
     createdAt: Scalars['DateTime']['output'];
+    /** An adjustment on the transaction showing the amount lost or gained  due to fluctuations in the currency exchange rate. */
+    currencyExchangeAdjustment?: Maybe<CurrencyExchangeAdjustment>;
+    /** The Shopify Point of Sale device used to process the transaction. */
+    device?: Maybe<PointOfSaleDevice>;
     /** A standardized error code, independent of the payment provider. */
     errorCode?: Maybe<OrderTransactionErrorCode>;
     /** The transaction fees charged on the order transaction. Only present for Shopify Payments transactions. */
@@ -13080,6 +13130,8 @@ type OrderTransaction = Node & {
     id: Scalars['ID']['output'];
     /** The kind of transaction. */
     kind: OrderTransactionKind;
+    /** The physical location where the transaction was processed. */
+    location?: Maybe<Location>;
     /** Whether the transaction is processed by manual payment gateway. */
     manualPaymentGateway: Scalars['Boolean']['output'];
     /** Whether the transaction can be manually captured. */
@@ -13384,7 +13436,7 @@ type PaymentCustomization = HasMetafieldDefinitions & HasMetafields & Node & {
     title: Scalars['String']['output'];
 };
 /** Payment details related to a transaction. */
-type PaymentDetails = CardPaymentDetails | LocalPaymentMethodsPaymentDetails | ShopPayInstallmentsPaymentDetails;
+type PaymentDetails = CardPaymentDetails | LocalPaymentMethodsPaymentDetails | PaypalWalletPaymentDetails | ShopPayInstallmentsPaymentDetails;
 /** All possible instrument outputs for Payment Mandates. */
 type PaymentInstrument = VaultCreditCard | VaultPaypalBillingAgreement;
 /**
@@ -13536,6 +13588,18 @@ declare enum PaypalExpressSubscriptionsGatewayStatus {
     /** The status is pending. */
     Pending = "PENDING"
 }
+/** PayPal Wallet payment details related to a transaction. */
+type PaypalWalletPaymentDetails = BasePaymentDetails & {
+    __typename?: 'PaypalWalletPaymentDetails';
+    /** The name of payment method used by the buyer. */
+    paymentMethodName?: Maybe<Scalars['String']['output']>;
+};
+/** Represents a mobile device that Shopify Point of Sale has been installed on. */
+type PointOfSaleDevice = Node & {
+    __typename?: 'PointOfSaleDevice';
+    /** A globally-unique ID. */
+    id: Scalars['ID']['output'];
+};
 /**
  * A list that defines pricing for [product variants](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant). Price lists override default product prices with either fixed prices or percentage-based adjustments.
  *
@@ -13863,6 +13927,18 @@ type Product = HasEvents & HasMetafieldDefinitions & HasMetafields & HasPublishe
      * @deprecated Use `category` instead.
      */
     productCategory?: Maybe<ProductCategory>;
+    /**
+     * A list of products that contain at least one variant associated with
+     * at least one of the current products' variants via group relationship.
+     */
+    productComponents: ProductComponentTypeConnection;
+    /**
+     * A count of unique products that contain at least one variant associated with
+     * at least one of the current products' variants via group relationship.
+     */
+    productComponentsCount?: Maybe<Count>;
+    /** A list of products that has a variant that contains any of this product's variants as a component. */
+    productParents: ProductConnection;
     /**
      * A list of the channels where the product is published.
      * @deprecated Use `resourcePublications` instead.
@@ -14153,6 +14229,38 @@ type ProductCompareAtPriceRange = {
     /** The lowest variant's compare-at price. */
     minVariantCompareAtPrice: MoneyV2;
 };
+/** The product component information. */
+type ProductComponentType = {
+    __typename?: 'ProductComponentType';
+    /** The list of products' variants that are components. */
+    componentVariants: ProductVariantConnection;
+    /** The number of component variants for the product component. */
+    componentVariantsCount?: Maybe<Count>;
+    /** The list of products' variants that are not components. */
+    nonComponentVariants: ProductVariantConnection;
+    /** The number of non_components variants for the product component. */
+    nonComponentVariantsCount?: Maybe<Count>;
+    /** The product that's a component. */
+    product: Product;
+};
+/** An auto-generated type for paginating through multiple ProductComponentTypes. */
+type ProductComponentTypeConnection = {
+    __typename?: 'ProductComponentTypeConnection';
+    /** The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node. */
+    edges: Array<ProductComponentTypeEdge>;
+    /** A list of nodes that are contained in ProductComponentTypeEdge. You can fetch data about an individual node, or you can follow the edges to fetch data about a collection of related nodes. At each node, you specify the fields that you want to retrieve. */
+    nodes: Array<ProductComponentType>;
+    /** An object that’s used to retrieve [cursor information](https://shopify.dev/api/usage/pagination-graphql) about the current page. */
+    pageInfo: PageInfo;
+};
+/** An auto-generated type which holds one ProductComponentType and a cursor during pagination. */
+type ProductComponentTypeEdge = {
+    __typename?: 'ProductComponentTypeEdge';
+    /** The position of each node in an array, used in [pagination](https://shopify.dev/api/usage/pagination-graphql). */
+    cursor: Scalars['String']['output'];
+    /** The item at the end of ProductComponentTypeEdge. */
+    node: ProductComponentType;
+};
 /** An auto-generated type for paginating through multiple Products. */
 type ProductConnection = {
     __typename?: 'ProductConnection';
@@ -14399,6 +14507,8 @@ type ProductVariant$1 = HasEvents & HasMetafieldDefinitions & HasMetafields & Ha
     price: Scalars['Money']['output'];
     /** The product that this variant belongs to. */
     product: Product;
+    /** A list of products that have product variants that contain this variant as a product component. */
+    productParents: ProductConnection;
     /** A list of the product variant components. */
     productVariantComponents: ProductVariantComponentConnection;
     /**
@@ -14424,6 +14534,8 @@ type ProductVariant$1 = HasEvents & HasMetafieldDefinitions & HasMetafields & Ha
     sellingPlanGroups: SellingPlanGroupConnection;
     /** Count of selling plan groups associated with the product variant. */
     sellingPlanGroupsCount?: Maybe<Count>;
+    /** Whether to show the unit price for this product variant. */
+    showUnitPrice: Scalars['Boolean']['output'];
     /**
      * A case-sensitive identifier for the product variant in the shop.
      * Required in order to connect to a fulfillment service.
@@ -14447,6 +14559,8 @@ type ProductVariant$1 = HasEvents & HasMetafieldDefinitions & HasMetafields & Ha
     title: Scalars['String']['output'];
     /** The published translations associated with the resource. */
     translations: Array<Translation>;
+    /** The unit price value for the variant based on the variant measurement. */
+    unitPrice?: Maybe<MoneyV2>;
     /** The unit price measurement for the variant. */
     unitPriceMeasurement?: Maybe<UnitPriceMeasurement>;
     /** The date and time (ISO 8601 format) when the product variant was last modified. */
@@ -14509,6 +14623,8 @@ type ProductVariantContextualPricing = {
     quantityPriceBreaks: QuantityPriceBreakConnection;
     /** The quantity rule applied for a given context. */
     quantityRule: QuantityRule;
+    /** The unit price value for the given context based on the variant measurement. */
+    unitPrice?: Maybe<MoneyV2>;
 };
 /** An auto-generated type which holds one ProductVariant and a cursor during pagination. */
 type ProductVariantEdge = {
@@ -14585,10 +14701,14 @@ type ProductVariantsBulkInput = {
      * omitted from channels that don't support bundles.
      */
     requiresComponents?: InputMaybe<Scalars['Boolean']['input']>;
+    /** Whether the unit price should be shown for this product variant. */
+    showUnitPrice?: InputMaybe<Scalars['Boolean']['input']>;
     /** The tax code associated with the variant. */
     taxCode?: InputMaybe<Scalars['String']['input']>;
     /** Whether the variant is taxable. */
     taxable?: InputMaybe<Scalars['Boolean']['input']>;
+    /** The unit price measurement for the product variant. */
+    unitPriceMeasurement?: InputMaybe<UnitPriceMeasurementInput>;
 };
 /** Error codes for failed variant bulk update mutations. */
 type ProductVariantsBulkUpdateUserError = DisplayableError & {
@@ -15016,6 +15136,8 @@ type RefundEdge = {
 };
 /** The input fields to create a refund. */
 type RefundInput = {
+    /** Whether to allow the total refunded amount to surpass the amount paid for the order. */
+    allowOverRefunding?: InputMaybe<Scalars['Boolean']['input']>;
     /** The currency that is used to refund the order. This must be the presentment currency, which is the currency used by the customer. This is a required field for orders where the currency and presentment currency differ. */
     currency?: InputMaybe<CurrencyCode>;
     /** An optional reason for a discrepancy between calculated and actual refund amounts. */
@@ -15030,6 +15152,8 @@ type RefundInput = {
     refundDuties?: InputMaybe<Array<RefundDutyInput>>;
     /** A list of line items to refund. */
     refundLineItems?: InputMaybe<Array<RefundLineItemInput>>;
+    /** A list of instructions to process the financial outcome of the refund. */
+    refundMethods?: InputMaybe<Array<RefundMethodInput>>;
     /** The input fields that are required to reimburse shipping costs. */
     shipping?: InputMaybe<ShippingRefundInput>;
     /** A list of transactions involved in the refund. */
@@ -15116,6 +15240,21 @@ declare enum RefundLineItemRestockType {
     /** The refund line item was returned. Use this when restocking line items that were fulfilled. */
     Return = "RETURN"
 }
+/** The input fields for processing the financial outcome of a refund. */
+type RefundMethodInput = {
+    /** The details of the refund to store credit. */
+    storeCreditRefund?: InputMaybe<StoreCreditRefundInput>;
+};
+/** The financial transfer details for a return outcome that results in a refund. */
+type RefundReturnOutcome = {
+    __typename?: 'RefundReturnOutcome';
+    /** The total monetary value to be refunded in shop and presentment currencies. */
+    amount: MoneyBag;
+    /** A list of suggested refund methods. */
+    suggestedRefundMethods: Array<SuggestedRefundMethod>;
+    /** A list of suggested order transactions. */
+    suggestedTransactions: Array<SuggestedOrderTransaction>;
+};
 /** A shipping line item that's included in a refund. */
 type RefundShippingLine = Node & {
     __typename?: 'RefundShippingLine';
@@ -15365,6 +15504,10 @@ type RestrictedForResource = {
  */
 type Return = Node & {
     __typename?: 'Return';
+    /** The date and time when the return was closed. */
+    closedAt?: Maybe<Scalars['DateTime']['output']>;
+    /** The date and time when the return was created. */
+    createdAt: Scalars['DateTime']['output'];
     /** Additional information about the declined return. */
     decline?: Maybe<ReturnDecline>;
     /** The exchange line items attached to the return. */
@@ -15377,6 +15520,8 @@ type Return = Node & {
     order: Order;
     /** The list of refunds associated with the return. */
     refunds: RefundConnection;
+    /** The date and time when the return was approved. */
+    requestApprovedAt?: Maybe<Scalars['DateTime']['output']>;
     /** The return line items attached to the return. */
     returnLineItems: ReturnLineItemTypeConnection;
     /** The return shipping fees for the return. */
@@ -15385,6 +15530,8 @@ type Return = Node & {
     reverseFulfillmentOrders: ReverseFulfillmentOrderConnection;
     /** The status of the return. */
     status: ReturnStatus;
+    /** A suggested financial outcome for the return. */
+    suggestedFinancialOutcome?: Maybe<SuggestedReturnFinancialOutcome>;
     /**
      * A suggested refund for the return.
      * @deprecated Use `suggestedFinancialOutcome` instead.
@@ -15437,6 +15584,10 @@ type ReturnLineItemType = {
     customerNote?: Maybe<Scalars['String']['output']>;
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
+    /** The quantity that can be processed. */
+    processableQuantity: Scalars['Int']['output'];
+    /** The quantity that has been processed. */
+    processedQuantity: Scalars['Int']['output'];
     /** The quantity being returned. */
     quantity: Scalars['Int']['output'];
     /** The quantity that can be refunded. */
@@ -15447,6 +15598,8 @@ type ReturnLineItemType = {
     returnReason: ReturnReason;
     /** Additional information about the reason for the return. Maximum length: 255 characters. */
     returnReasonNote: Scalars['String']['output'];
+    /** The quantity that has't been processed. */
+    unprocessedQuantity: Scalars['Int']['output'];
 };
 /** An auto-generated type for paginating through multiple ReturnLineItemTypes. */
 type ReturnLineItemTypeConnection = {
@@ -15466,6 +15619,8 @@ type ReturnLineItemTypeEdge = {
     /** The item at the end of ReturnLineItemTypeEdge. */
     node: ReturnLineItemType;
 };
+/** The financial transfer details for the return outcome. */
+type ReturnOutcomeFinancialTransfer = InvoiceReturnOutcome | RefundReturnOutcome;
 /** The reason for returning the return line item. */
 declare enum ReturnReason {
     /** The item is returned because the buyer did not like the color. Displays as **Color**. */
@@ -15640,6 +15795,8 @@ type ReverseFulfillmentOrderConnection = {
 /** The details of the arrangement of an item. */
 type ReverseFulfillmentOrderDisposition = Node & {
     __typename?: 'ReverseFulfillmentOrderDisposition';
+    /** The date and time when the disposition was created. */
+    createdAt: Scalars['DateTime']['output'];
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
     /** The location where the disposition occurred. */
@@ -16554,7 +16711,7 @@ type ShippingRefundInput = {
  *
  * Includes core business details like the shop name, contact emails, billing address, and currency settings. The shop configuration determines customer account requirements, available sales channels, enabled features, payment settings, and policy documents. Also provides access to shop-level resources such as staff members, fulfillment services, navigation settings, and storefront access tokens.
  */
-type Shop = HasMetafields & HasPublishedTranslations & Node & {
+type Shop = HasMetafieldDefinitions & HasMetafields & HasPublishedTranslations & Node & {
     __typename?: 'Shop';
     /** Account owner information. */
     accountOwner: StaffMember;
@@ -16704,6 +16861,11 @@ type Shop = HasMetafields & HasPublishedTranslations & Node & {
      * for the purposes of adding and storing additional information.
      */
     metafield?: Maybe<Metafield>;
+    /**
+     * List of metafield definitions.
+     * @deprecated This field will be removed in a future version. Use `QueryRoot.metafieldDefinitions` instead.
+     */
+    metafieldDefinitions: MetafieldDefinitionConnection;
     /**
      * A list of [custom fields](https://shopify.dev/docs/apps/build/custom-data)
      * that a merchant associates with a Shopify resource.
@@ -17047,6 +17209,8 @@ type ShopPlan = {
     displayName: Scalars['String']['output'];
     /** Whether the shop is a partner development shop for testing purposes. */
     partnerDevelopment: Scalars['Boolean']['output'];
+    /** The public display name of the shop's billing plan. Possible values are: Advanced, Agentic, Agentic Enterprise, Basic, Development, Grow, Inactive, Lite, Other, Paused, Plus, Plus Trial, Retail, Shop Component, Shopify Finance, Staff Business, Starter, and Trial. */
+    publicDisplayName: Scalars['String']['output'];
     /** Whether the shop has a Shopify Plus subscription. */
     shopifyPlus: Scalars['Boolean']['output'];
 };
@@ -18177,6 +18341,13 @@ type StoreCreditAccountTransactionEdge = {
 };
 /** The origin of a store credit account transaction. */
 type StoreCreditAccountTransactionOrigin = OrderTransaction;
+/** The input fields to process a refund to store credit. */
+type StoreCreditRefundInput = {
+    /** The amount to be issued as store credit. */
+    amount: MoneyInput;
+    /** An optional expiration date for the store credit being issued. */
+    expiresAt?: InputMaybe<Scalars['DateTime']['input']>;
+};
 /** The event that caused the store credit account transaction. */
 declare enum StoreCreditSystemEvent {
     /** An adjustment was made to the store credit account. */
@@ -18597,7 +18768,7 @@ type SubscriptionDeliveryMethod = SubscriptionDeliveryMethodLocalDelivery | Subs
 type SubscriptionDeliveryMethodLocalDelivery = {
     __typename?: 'SubscriptionDeliveryMethodLocalDelivery';
     /** The address to deliver to. */
-    address: SubscriptionMailingAddress;
+    address: MailingAddress;
     /** The details of the local delivery method to use. */
     localDeliveryOption: SubscriptionDeliveryMethodLocalDeliveryOption;
 };
@@ -18644,7 +18815,7 @@ type SubscriptionDeliveryMethodPickupOption = {
 type SubscriptionDeliveryMethodShipping = {
     __typename?: 'SubscriptionDeliveryMethodShipping';
     /** The address to ship to. */
-    address: SubscriptionMailingAddress;
+    address: MailingAddress;
     /** The details of the shipping method to use. */
     shippingOption: SubscriptionDeliveryMethodShippingOption;
 };
@@ -18817,44 +18988,6 @@ type SubscriptionLineEdge = {
     /** The item at the end of SubscriptionLineEdge. */
     node: SubscriptionLine;
 };
-/** Represents a Mailing Address on a Subscription. */
-type SubscriptionMailingAddress = {
-    __typename?: 'SubscriptionMailingAddress';
-    /** 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 name of the country. */
-    country?: Maybe<Scalars['String']['output']>;
-    /**
-     * The two-letter code for the country of the address.
-     *
-     * For example, US.
-     */
-    countryCode?: Maybe<CountryCode>;
-    /** The first name of the customer. */
-    firstName?: Maybe<Scalars['String']['output']>;
-    /** The last name of the customer. */
-    lastName?: Maybe<Scalars['String']['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 region of the address, such as the province, state, or district. */
-    province?: 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']>;
-};
 /** Custom subscription discount. */
 type SubscriptionManualDiscount = {
     __typename?: 'SubscriptionManualDiscount';
@@ -18979,6 +19112,8 @@ type SuggestedRefund$1 = {
     subtotal: Scalars['Money']['output'];
     /** The sum of all the prices of the line items being refunded in shop and presentment currencies. */
     subtotalSet: MoneyBag;
+    /** A list of suggested refund methods. */
+    suggestedRefundMethods: Array<SuggestedRefundMethod>;
     /** A list of suggested order transactions. */
     suggestedTransactions: Array<SuggestedOrderTransaction>;
     /** The total cart discount amount that was applied to all line items in this refund. */
@@ -18993,6 +19128,35 @@ type SuggestedRefund$1 = {
      */
     totalTaxes: Scalars['Money']['output'];
 };
+/** Generic attributes of a suggested refund method. */
+type SuggestedRefundMethod = {
+    /** The suggested amount to refund in shop and presentment currencies. */
+    amount: MoneyBag;
+    /** The maximum available amount to refund in shop and presentment currencies. */
+    maximumRefundable: MoneyBag;
+};
+/** Represents a return financial outcome suggested by Shopify based on the items being reimbursed. You can then use the suggested outcome object to generate an actual refund or invoice for the return. */
+type SuggestedReturnFinancialOutcome = {
+    __typename?: 'SuggestedReturnFinancialOutcome';
+    /** The sum of all the discounted prices of the line items being refunded. */
+    discountedSubtotal: MoneyBag;
+    /** The financial transfer details for the return outcome. */
+    financialTransfer?: Maybe<ReturnOutcomeFinancialTransfer>;
+    /** The total monetary value available to refund in shop and presentment currencies. */
+    maximumRefundable: MoneyBag;
+    /** A list of duties to be refunded from the order. */
+    refundDuties: Array<RefundDuty>;
+    /** The shipping costs to be refunded from the order. */
+    shipping: ShippingRefund;
+    /** The sum of all the additional fees being refunded in shop and presentment currencies. The value must be positive. */
+    totalAdditionalFees: MoneyBag;
+    /** The total cart discount amount that was applied to all line items in this refund. */
+    totalCartDiscountAmount: MoneyBag;
+    /** The sum of all the duties being refunded from the order in shop and presentment currencies. The value must be positive. */
+    totalDuties: MoneyBag;
+    /** The sum of the taxes being refunded in shop and presentment currencies. The value must be positive. */
+    totalTax: MoneyBag;
+};
 /** Represents a return refund suggested by Shopify based on the items being reimbursed. You can then use the suggested refund object to generate an actual refund for the return. */
 type SuggestedReturnRefund = {
     __typename?: 'SuggestedReturnRefund';
@@ -19369,12 +19533,27 @@ type UnitPriceMeasurement = {
     /** The reference value for the unit price measurement. */
     referenceValue: Scalars['Int']['output'];
 };
+/** The input fields for the measurement used to calculate a unit price for a product variant (e.g. $9.99 / 100ml). */
+type UnitPriceMeasurementInput = {
+    /** The quantity unit for the unit price measurement. */
+    quantityUnit?: InputMaybe<UnitPriceMeasurementMeasuredUnit>;
+    /** The quantity value for the unit price measurement. */
+    quantityValue?: InputMaybe<Scalars['Float']['input']>;
+    /** The reference unit for the unit price measurement. */
+    referenceUnit?: InputMaybe<UnitPriceMeasurementMeasuredUnit>;
+    /** The reference value for the unit price measurement. */
+    referenceValue?: InputMaybe<Scalars['Int']['input']>;
+};
 /** The accepted types of unit of measurement. */
 declare enum UnitPriceMeasurementMeasuredType {
     /** Unit of measurements representing areas. */
     Area = "AREA",
+    /** Unit of measurements representing counts. */
+    Count = "COUNT",
     /** Unit of measurements representing lengths. */
     Length = "LENGTH",
+    /** The type of measurement is unknown. Upgrade to the latest version of the API to resolve this type. */
+    Unknown = "UNKNOWN",
     /** Unit of measurements representing volumes. */
     Volume = "VOLUME",
     /** Unit of measurements representing weights. */
@@ -19386,12 +19565,26 @@ declare enum UnitPriceMeasurementMeasuredUnit {
     Cl = "CL",
     /** 100 centimeters equals 1 meter. */
     Cm = "CM",
+    /** Imperial system unit of volume (U.S. customary unit). */
+    Floz = "FLOZ",
+    /** 1 foot equals 12 inches. */
+    Ft = "FT",
+    /** Imperial system unit of area. */
+    Ft2 = "FT2",
     /** Metric system unit of weight. */
     G = "G",
+    /** 1 gallon equals 128 fluid ounces (U.S. customary unit). */
+    Gal = "GAL",
+    /** Imperial system unit of length. */
+    In = "IN",
+    /** 1 item, a unit of count. */
+    Item = "ITEM",
     /** 1 kilogram equals 1000 grams. */
     Kg = "KG",
     /** Metric system unit of volume. */
     L = "L",
+    /** Imperial system unit of weight. */
+    Lb = "LB",
     /** Metric system unit of length. */
     M = "M",
     /** Metric system unit of area. */
@@ -19403,7 +19596,17 @@ declare enum UnitPriceMeasurementMeasuredUnit {
     /** 1000 milliliters equals 1 liter. */
     Ml = "ML",
     /** 1000 millimeters equals 1 meter. */
-    Mm = "MM"
+    Mm = "MM",
+    /** 16 ounces equals 1 pound. */
+    Oz = "OZ",
+    /** 1 pint equals 16 fluid ounces (U.S. customary unit). */
+    Pt = "PT",
+    /** 1 quart equals 32 fluid ounces (U.S. customary unit). */
+    Qt = "QT",
+    /** The unit of measurement is unknown. Upgrade to the latest version of the API to resolve this unit. */
+    Unknown = "UNKNOWN",
+    /** 1 yard equals 36 inches. */
+    Yd = "YD"
 }
 /** Systems of weights and measures. */
 declare enum UnitSystem {
@@ -19611,6 +19814,7 @@ type CreateRefundResult = {
  *
  * @param orderId - The order ID (numeric, bigint, or GID string)
  * @param options - Refund configuration options
+ * @param retries - Number of retries on transient errors. Defaults to 0; refunds are not retried by default to avoid double refunds.
  * @returns Promise resolving to the created refund
  * @throws {ShopifyUserError} When the mutation fails
  * @throws {Error} When GraphQL errors occur
@@ -19628,7 +19832,7 @@ type CreateRefundResult = {
  *   ]
  * })
  */
-declare function createRefund(orderId: number | bigint | string, options?: CreateRefundOptions): Promise<CreateRefundResult>;
+declare function createRefund(orderId: number | bigint | string, options?: CreateRefundOptions, retries?: number): Promise<CreateRefundResult>;
 
 type VariantUpdateInput = Omit<ProductVariantsBulkInput, 'id'> & {
     id: string;
@@ -19642,10 +19846,11 @@ type BulkUpdateProductVariantsResult = {
  *
  * @param productId - The product GID
  * @param variants - Array of variant updates (id required, plus fields to update)
+ * @param retries - Number of retries on transient errors. Defaults to 1; safe because update is idempotent for the same input.
  * @returns Array of updated variants with id and sku
  * @throws {ShopifyUserError} When the mutation fails
  */
-declare function bulkUpdateProductVariants(productId: string, variants: VariantUpdateInput[]): Promise<BulkUpdateProductVariantsResult[]>;
+declare function bulkUpdateProductVariants(productId: string, variants: VariantUpdateInput[], retries?: number): Promise<BulkUpdateProductVariantsResult[]>;
 
 type UpsertMetaobjectInput = {
     type: string;
@@ -19665,11 +19870,12 @@ type UpsertMetaobjectResult = {
  * Creates or updates a metaobject in Shopify based on its type and handle.
  *
  * @param input - The metaobject type, handle, and fields
+ * @param retries - Number of retries on transient errors. Defaults to 1; safe because upsert is idempotent on type+handle.
  * @returns The created/updated metaobject
  * @throws {ShopifyUserError} When the upsert fails due to validation errors
  * @throws {Error} When GraphQL errors occur or no metaobject is returned
  */
-declare function upsertMetaobject(input: UpsertMetaobjectInput): Promise<UpsertMetaobjectResult>;
+declare function upsertMetaobject(input: UpsertMetaobjectInput, retries?: number): Promise<UpsertMetaobjectResult>;
 
 type CustomerDeleteMutationVariables = Exact<{
     input: CustomerDeleteInput;
@@ -20144,6 +20350,7 @@ type OrderPaymentDetailsByIdQuery = {
         transactions: Array<(Pick<OrderTransaction, 'createdAt' | 'gateway' | 'formattedGateway' | 'kind' | 'paymentId'> & {
             amountSet: {
                 shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+                presentmentMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
             };
         })>;
     }>;
@@ -20277,7 +20484,7 @@ interface GeneratedQueryTypes {
         return: OrderCancellationInfoByNameQuery;
         variables: OrderCancellationInfoByNameQueryVariables;
     };
-    "#graphql\n  query orderPaymentDetailsById($id: ID!) {\n    order(id: $id) {\n      transactions {\n        amountSet {\n          shopMoney {\n            amount\n            currencyCode\n          }\n        }\n        createdAt\n        gateway\n        formattedGateway\n        kind\n        paymentId\n      }\n    }\n  }\n": {
+    "#graphql\n  query orderPaymentDetailsById($id: ID!) {\n    order(id: $id) {\n      transactions {\n        amountSet {\n          shopMoney {\n            amount\n            currencyCode\n          }\n          presentmentMoney {\n            amount\n            currencyCode\n          }\n        }\n        createdAt\n        gateway\n        formattedGateway\n        kind\n        paymentId\n      }\n    }\n  }\n": {
         return: OrderPaymentDetailsByIdQuery;
         variables: OrderPaymentDetailsByIdQueryVariables;
     };
@@ -20331,7 +20538,7 @@ interface GeneratedMutationTypes {
         return: UpsertMetaobjectMutation;
         variables: UpsertMetaobjectMutationVariables;
     };
-    "#graphql\n  mutation orderCancel($orderId: ID!) {\n    orderCancel(\n      orderId: $orderId\n      refund: true\n      restock: false\n      reason: CUSTOMER\n      notifyCustomer: true\n    ) {\n      orderCancelUserErrors {\n        code\n        field\n        message\n      }\n    }\n  }\n": {
+    "#graphql\n  mutation orderCancel($orderId: ID!) {\n    orderCancel(\n      orderId: $orderId\n      refundMethod: { originalPaymentMethodsRefund: true }\n      restock: false\n      reason: CUSTOMER\n      notifyCustomer: true\n    ) {\n      orderCancelUserErrors {\n        code\n        field\n        message\n      }\n    }\n  }\n": {
         return: OrderCancelMutation;
         variables: OrderCancelMutationVariables;
     };
@@ -20375,10 +20582,12 @@ interface CalculateRefundOptions {
  *
  * @param orderId - The order ID (numeric, bigint, or GID string)
  * @param options - Options for the refund calculation
+ * @param retries - Number of retries on transient errors. Defaults to 3.
  * @returns The suggested refund or undefined
  */
-declare function calculateRefund(orderId: number | bigint | string, options?: CalculateRefundOptions): Promise<SuggestedRefund | undefined>;
+declare function calculateRefund(orderId: number | bigint | string, options?: CalculateRefundOptions, retries?: number): Promise<SuggestedRefund | undefined>;
 
+declare function isRetryableError(error: unknown): boolean;
 interface ShopifyUserErrorDetail {
     code?: string | null;
     field?: string[] | null;
@@ -20532,9 +20741,11 @@ declare const GetLeanOrderByIdReturn: z.ZodObject<{
 }>;
 type LeanOrder = z.infer<typeof GetLeanOrderByIdReturn> | undefined;
 type FullOrder = NonNullable<OrderByIdFullQuery['order']>;
-declare function getOrderById(id: number | bigint): Promise<LeanOrder>;
-declare function getOrderById(id: number | bigint, detailLevel: 'lean'): Promise<LeanOrder>;
-declare function getOrderById(id: number | bigint, detailLevel: 'full'): Promise<FullOrder | undefined>;
+type OrderDetailLevel$1 = 'lean' | 'full';
+declare function getOrderById(id: number | bigint, retries?: number): Promise<LeanOrder>;
+declare function getOrderById(id: number | bigint, detailLevel: 'lean', retries?: number): Promise<LeanOrder>;
+declare function getOrderById(id: number | bigint, detailLevel: 'full', retries?: number): Promise<FullOrder | undefined>;
+declare function getOrderById(id: number | bigint, detailLevel: OrderDetailLevel$1, retries?: number): Promise<LeanOrder | FullOrder>;
 
 declare const GetLeanOrderByNameReturn: z.ZodObject<{
     id: z.ZodString;
@@ -20601,9 +20812,11 @@ declare const GetLeanOrderByNameReturn: z.ZodObject<{
 }>;
 type LeanOrderByName = z.infer<typeof GetLeanOrderByNameReturn> | undefined;
 type FullOrderByName = NonNullable<NonNullable<OrdersByNameFullQuery['orders']>['edges'][number]['node']> | undefined;
-declare function getOrderByName(orderName: string, detailLevel: 'lean'): Promise<LeanOrderByName>;
-declare function getOrderByName(orderName: string, detailLevel: 'full'): Promise<FullOrderByName>;
-declare function getOrderByName(orderName: string): Promise<LeanOrderByName>;
+type OrderDetailLevel = 'lean' | 'full';
+declare function getOrderByName(orderName: string, retries?: number): Promise<LeanOrderByName>;
+declare function getOrderByName(orderName: string, detailLevel: 'lean', retries?: number): Promise<LeanOrderByName>;
+declare function getOrderByName(orderName: string, detailLevel: 'full', retries?: number): Promise<FullOrderByName>;
+declare function getOrderByName(orderName: string, detailLevel: OrderDetailLevel, retries?: number): Promise<LeanOrderByName | FullOrderByName>;
 
 type OrderCancellationInfo = NonNullable<OrderCancellationInfoByNameQuery['orders']['edges'][number]['node']>;
 /**
@@ -20611,10 +20824,11 @@ type OrderCancellationInfo = NonNullable<OrderCancellationInfoByNameQuery['order
  * Returns undefined if no order is found with the specified name.
  *
  * @param {string} orderName - The order name to search for (e.g., "B12345").
+ * @param {number} retries - Number of retries on transient errors. Defaults to 3.
  * @returns {Promise<OrderCancellationInfo | undefined>} A promise that resolves to the order cancellation info or undefined if not found.
  * @throws {Error} If the GraphQL query fails or if the response structure is invalid.
  */
-declare function getOrderCancellationInfoByName(orderName: string): Promise<OrderCancellationInfo | undefined>;
+declare function getOrderCancellationInfoByName(orderName: string, retries?: number): Promise<OrderCancellationInfo | undefined>;
 
 declare const GetLeanProductVariantsReturn: z.ZodArray<z.ZodObject<{
     productId: z.ZodString;
@@ -20651,10 +20865,11 @@ type LeanProductVariantsOptions = {
  * @param {string[]} [skus] - An optional array of SKUs to filter by. If provided, only variants matching these SKUs will be fetched.
  * @param {LeanProductVariantsOptions} [options] - Optional settings.
  * @param {boolean} [options.activeOnly=false] - If true, excludes ARCHIVED products at query level.
+ * @param {number} retries - Number of retries on transient errors. Defaults to 3.
  * @returns {Promise<LeanProductVariant[]>} A promise that resolves to an array of lean product variant data.
  * @throws {Error} If the GraphQL query fails, returns no data, or if the `productVariants` field is missing in the response.
  */
-declare function getLeanProductVariants(skus?: string[], options?: LeanProductVariantsOptions): Promise<LeanProductVariant[]>;
+declare function getLeanProductVariants(skus?: string[], options?: LeanProductVariantsOptions, retries?: number): Promise<LeanProductVariant[]>;
 
 declare const GetProductVariantsBySkusReturn: z.ZodArray<z.ZodObject<{
     productId: z.ZodString;
@@ -20690,10 +20905,11 @@ type ProductVariantsBySkusOptions = {
  * @param {string[]} skus - Array of SKUs to filter by.
  * @param {ProductVariantsBySkusOptions} [options] - Optional settings.
  * @param {boolean} [options.activeOnly=false] - If true, excludes ARCHIVED products at query level.
+ * @param {number} retries - Number of retries on transient errors. Defaults to 3.
  * @returns {Promise<ProductVariantBySku[]>} A promise that resolves to an array of product variant data.
  * @throws {Error} If the GraphQL query fails or returns no data.
  */
-declare function getProductVariantsBySkus(skus: string[], options?: ProductVariantsBySkusOptions): Promise<ProductVariantBySku[]>;
+declare function getProductVariantsBySkus(skus: string[], options?: ProductVariantsBySkusOptions, retries?: number): Promise<ProductVariantBySku[]>;
 
 declare const ProductVariantSchema: z.ZodObject<{
     status: z.ZodEnum<["ACTIVE", "ARCHIVED", "DRAFT"]>;
@@ -20740,10 +20956,11 @@ type ProductVariant = z.infer<typeof ProductVariantSchema>;
  * Each variant includes product info with combined title (product + variant title
  * when variant title is not "Default Title"), URL with variant ID, and inventory data.
  *
+ * @param {number} retries - Number of retries on transient errors. Defaults to 3.
  * @returns {Promise<ProductVariant[]>} A promise that resolves to an array of product variants.
  * @throws {Error} If the GraphQL query fails or if the response is missing expected data.
  */
-declare function getAllProductVariants(): Promise<ProductVariant[]>;
+declare function getAllProductVariants(retries?: number): Promise<ProductVariant[]>;
 
 type OrderPaymentDetails = NonNullable<OrderPaymentDetailsByIdQuery['order']>;
 /**
@@ -20751,10 +20968,11 @@ type OrderPaymentDetails = NonNullable<OrderPaymentDetailsByIdQuery['order']>;
  * Returns undefined if no order is found with the specified ID.
  *
  * @param {bigint} id - The numerical Shopify order ID (e.g., 12345678n).
+ * @param {number} retries - Number of retries on transient errors. Defaults to 3.
  * @returns {Promise<OrderPaymentDetails | undefined>} A promise that resolves to the order payment data or undefined if not found.
  * @throws {Error} If the GraphQL query fails.
  */
-declare function getOrderPaymentDetailsById(id: bigint): Promise<OrderPaymentDetails | undefined>;
+declare function getOrderPaymentDetailsById(id: bigint, retries?: number): Promise<OrderPaymentDetails | undefined>;
 
 type Fulfillment = NonNullable<FulfillmentByIdQuery['fulfillment']>;
 /**
@@ -20762,10 +20980,11 @@ type Fulfillment = NonNullable<FulfillmentByIdQuery['fulfillment']>;
  * Returns undefined if no fulfillment is found with the specified ID.
  *
  * @param {string | number | bigint} id - The Shopify fulfillment ID. Can be a GID string (e.g., "gid://shopify/Fulfillment/123456789") or a numeric ID (e.g., 123456789 or 123456789n).
+ * @param {number} retries - Number of retries on transient errors. Defaults to 3.
  * @returns {Promise<Fulfillment | undefined>} A promise that resolves to the fulfillment data or undefined if not found.
  * @throws {Error} If the GraphQL query fails or if the response structure is invalid.
  */
-declare function getFulfillmentById(id: string | number | bigint): Promise<Fulfillment | undefined>;
+declare function getFulfillmentById(id: string | number | bigint, retries?: number): Promise<Fulfillment | undefined>;
 
 type FulfillmentOrderEdge = NonNullable<FulfillmentOrdersByOrderIdQuery['order']>['fulfillmentOrders']['edges'][number];
 type FulfillmentOrder = FulfillmentOrderEdge['node'];
@@ -20775,10 +20994,11 @@ type FulfillmentOrderLineItem = FulfillmentOrder['lineItems']['edges'][number]['
  * Returns an empty array if no order is found or if the order has no fulfillment orders.
  *
  * @param {string | number | bigint} orderId - The Shopify order ID. Can be a GID string (e.g., "gid://shopify/Order/123456789") or a numeric ID (e.g., 123456789 or 123456789n).
+ * @param {number} retries - Number of retries on transient errors. Defaults to 3.
  * @returns {Promise<FulfillmentOrder[]>} A promise that resolves to an array of fulfillment orders.
  * @throws {Error} If the GraphQL query fails or if the response structure is invalid.
  */
-declare function getFulfillmentOrdersByOrderId(orderId: string | number | bigint): Promise<FulfillmentOrder[]>;
+declare function getFulfillmentOrdersByOrderId(orderId: string | number | bigint, retries?: number): Promise<FulfillmentOrder[]>;
 
 type FulfillmentTrackingIds = {
     trackingNumbers: string[];
@@ -20789,10 +21009,11 @@ type FulfillmentTrackingIds = {
  * Returns the tracking numbers and the tracking company.
  *
  * @param {string | number | bigint} id - The Shopify fulfillment ID. Can be a GID string (e.g., "gid://shopify/Fulfillment/123456789") or a numeric ID (e.g., 123456789 or 123456789n).
+ * @param {number} retries - Number of retries on transient errors. Defaults to 3.
  * @returns {Promise<FulfillmentTrackingIds | undefined>} A promise that resolves to the tracking info or undefined if fulfillment not found.
  * @throws {Error} If the GraphQL query fails.
  */
-declare function getFulfillmentTrackingIds(id: string | number | bigint): Promise<FulfillmentTrackingIds | undefined>;
+declare function getFulfillmentTrackingIds(id: string | number | bigint, retries?: number): Promise<FulfillmentTrackingIds | undefined>;
 
 type Customer = CustomersByEmailQuery['customers']['edges'][number]['node'];
 /**
@@ -20801,10 +21022,11 @@ type Customer = CustomersByEmailQuery['customers']['edges'][number]['node'];
  *
  * @param {string} email - The email address to search for.
  * @param {number} limit - Maximum number of customers to return. Defaults to 10.
+ * @param {number} retries - Number of retries on transient errors. Defaults to 3.
  * @returns {Promise<Customer[]>} A promise that resolves to an array of customers.
  * @throws {Error} If the GraphQL query fails or if the response structure is invalid.
  */
-declare function getCustomersByEmail(email: string, limit?: number): Promise<Customer[]>;
+declare function getCustomersByEmail(email: string, limit?: number, retries?: number): Promise<Customer[]>;
 
 type CustomerSegmentMember = CustomerSegmentMembersWithStatisticsQuery['customerSegmentMembers']['edges'][number]['node'];
 type SegmentAttributeStatistics = CustomerSegmentMembersWithStatisticsQuery['customerSegmentMembers']['statistics']['attributeStatistics'];
@@ -20822,10 +21044,11 @@ interface CustomerSegmentMembersResult {
  * @param {string} query - The segment query filter string (e.g., "customer_account_status = 'ENABLED'").
  * @param {string} statisticsAttributeName - Attribute name for statistics (e.g., "amount_spent").
  * @param {number} limit - Maximum number of members to return. Defaults to 250.
+ * @param {number} retries - Number of retries on transient errors. Defaults to 3.
  * @returns {Promise<CustomerSegmentMembersResult>} Members with statistics.
  * @throws {Error} If the GraphQL query fails.
  */
-declare function getCustomerSegmentMembers(query: string, statisticsAttributeName: string, limit?: number): Promise<CustomerSegmentMembersResult>;
+declare function getCustomerSegmentMembers(query: string, statisticsAttributeName: string, limit?: number, retries?: number): Promise<CustomerSegmentMembersResult>;
 
 type CustomerOrders = NonNullable<OrdersByCustomerIdQuery['customer']>['orders'];
 type OrderPreview = CustomerOrders['edges'][number]['node'];
@@ -20835,10 +21058,11 @@ type OrderPreview = CustomerOrders['edges'][number]['node'];
  *
  * @param {number | bigint} customerId - The numerical Shopify customer ID.
  * @param {number} limit - Maximum number of orders to return. Defaults to 250.
+ * @param {number} retries - Number of retries on transient errors. Defaults to 3.
  * @returns {Promise<OrderPreview[]>} A promise that resolves to an array of order previews.
  * @throws {Error} If the GraphQL query fails.
  */
-declare function getOrdersByCustomerId(customerId: number | bigint, limit?: number): Promise<OrderPreview[]>;
+declare function getOrdersByCustomerId(customerId: number | bigint, limit?: number, retries?: number): Promise<OrderPreview[]>;
 
 /**
  * Extract numeric ID from a Shopify GID string.
@@ -20855,8 +21079,9 @@ type Metaobject = NonNullable<MetaobjectByHandleQuery['metaobjectByHandle']>;
  * Returns undefined if no metaobject is found with the specified type and handle.
  *
  * @param handle - The handle input containing type and handle
+ * @param retries - Number of retries on transient errors. Defaults to 3.
  * @returns A promise that resolves to the metaobject data or undefined if not found.
  */
-declare function getMetaobjectByHandle(handle: MetaobjectHandleInput): Promise<Metaobject | undefined>;
+declare function getMetaobjectByHandle(handle: MetaobjectHandleInput, retries?: number): Promise<Metaobject | undefined>;
 
-export { type BulkUpdateProductVariantsResult, type CalculateRefundLineItem, type CalculateRefundOptions, type CreateFulfillmentResult, type CreateMetaobjectDefinitionInput, type CreateMetaobjectDefinitionResult, type CreateRefundLineItem, type CreateRefundOptions, type CreateRefundResult, type CreateRefundTransaction, type Customer, type CustomerSegmentMember, type CustomerSegmentMembersResult, type Fulfillment, type FulfillmentLineItem$1 as FulfillmentLineItem, type FulfillmentOrder, type FulfillmentOrderLineItem, type FulfillmentTrackingIds, type FullOrder, type FullOrderByName, type LeanOrder, type LeanOrderByName, type LeanProductVariant, type LeanProductVariantsOptions, type Metaobject, type MetaobjectFieldDefinition$1 as MetaobjectFieldDefinition, type MetaobjectHandleInput, type OrderCancellationInfo, type OrderPaymentDetails, type OrderPreview, type ProductVariant, type ProductVariantBySku, type ProductVariantsBySkusOptions, type RefundMoney, type SegmentAttributeStatistics, ShopifyUserError, type ShopifyUserErrorDetail, type SuggestedRefund, type UpdateFulfillmentTrackingResult, type UpsertMetaobjectInput, type UpsertMetaobjectResult, type VariantUpdateInput, bulkUpdateProductVariants, calculateRefund, cancelOrderById, createFile, createFulfillment, createMetaobjectDefinition, createRefund, deleteCustomerById, deleteFilesByIds, getAllProductVariants, getCustomerSegmentMembers, getCustomersByEmail, getFulfillmentById, getFulfillmentOrdersByOrderId, getFulfillmentTrackingIds, getLeanProductVariants, getMetaobjectByHandle, getOrderById, getOrderByName, getOrderCancellationInfoByName, getOrderPaymentDetailsById, getOrdersByCustomerId, getProductVariantsBySkus, parseGid, updateFulfillmentTracking, upsertMetaobject };
+export { type BulkUpdateProductVariantsResult, type CalculateRefundLineItem, type CalculateRefundOptions, type CreateFulfillmentResult, type CreateMetaobjectDefinitionInput, type CreateMetaobjectDefinitionResult, type CreateRefundLineItem, type CreateRefundOptions, type CreateRefundResult, type CreateRefundTransaction, type Customer, type CustomerSegmentMember, type CustomerSegmentMembersResult, type Fulfillment, type FulfillmentLineItem$1 as FulfillmentLineItem, type FulfillmentOrder, type FulfillmentOrderLineItem, type FulfillmentTrackingIds, type FullOrder, type FullOrderByName, type LeanOrder, type LeanOrderByName, type LeanProductVariant, type LeanProductVariantsOptions, type Metaobject, type MetaobjectFieldDefinition$1 as MetaobjectFieldDefinition, type MetaobjectHandleInput, type OrderCancellationInfo, type OrderPaymentDetails, type OrderPreview, type ProductVariant, type ProductVariantBySku, type ProductVariantsBySkusOptions, type RefundMoney, type SegmentAttributeStatistics, ShopifyUserError, type ShopifyUserErrorDetail, type SuggestedRefund, type UpdateFulfillmentTrackingResult, type UpsertMetaobjectInput, type UpsertMetaobjectResult, type VariantUpdateInput, bulkUpdateProductVariants, calculateRefund, cancelOrderById, createFile, createFulfillment, createMetaobjectDefinition, createRefund, deleteCustomerById, deleteFilesByIds, getAllProductVariants, getCustomerSegmentMembers, getCustomersByEmail, getFulfillmentById, getFulfillmentOrdersByOrderId, getFulfillmentTrackingIds, getLeanProductVariants, getMetaobjectByHandle, getOrderById, getOrderByName, getOrderCancellationInfoByName, getOrderPaymentDetailsById, getOrdersByCustomerId, getProductVariantsBySkus, isRetryableError, parseGid, updateFulfillmentTracking, upsertMetaobject };