@ehrenkind/shopify-lib 0.0.5 → 0.0.6

package/dist/index.d.cts

@@ -86,7 +86,11 @@ type Scalars = {
         output: any;
     };
 };
-/** The permission required to access a Shopify Admin API or Storefront API resource for a shop. Merchants grant access scopes that are requested by applications. */
+/**
+ * A permission that controls access to [GraphQL Admin API](https://shopify.dev/docs/api/usage/access-scopes#authenticated-access-scopes) or [Storefront API](https://shopify.dev/docs/api/usage/access-scopes#unauthenticated-access-scopes) types. Each scope defines what data an [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) can read or write, following the format `{action}_{resource}` where action is typically "read" or "write".
+ *
+ * Apps declare required and optional access scopes in their configuration. During installation, merchants review and grant these permissions, determining what shop data the app can access. The granted scopes remain active until the merchant uninstalls the app or revokes them. Apps can programmatically revoke their own dynamically granted optional scopes using [`appRevokeAccessScopes`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appRevokeAccessScopes).
+ */
 type AccessScope = {
     __typename?: 'AccessScope';
     /** A description of the actions that the access scope allows an app to perform. */
@@ -125,7 +129,11 @@ type AddAllProductsOperation = Node & ResourceOperation & {
     /** The status of this operation. */
     status: ResourceOperationStatus;
 };
-/** The additional fees that have been applied to the order. */
+/**
+ * Additional fees applied to an [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) beyond the standard product and shipping costs. Additional fees typically include duties, import fees, or other special handling charges that need separate tracking from regular [`LineItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/LineItem) objects.
+ *
+ * Each fee includes its name, price in both shop and presentment currencies, and any applicable taxes broken down by [`TaxLine`](https://shopify.dev/docs/api/admin-graphql/latest/objects/TaxLine).
+ */
 type AdditionalFee = Node & {
     __typename?: 'AdditionalFee';
     /** A globally-unique ID. */
@@ -149,7 +157,11 @@ type AllDiscountItems = {
     /** Whether all items are eligible for the discount. This value always returns `true`. */
     allItems: Scalars['Boolean']['output'];
 };
-/** A Shopify application. */
+/**
+ * A Shopify application that extends store functionality. Apps integrate with Shopify through APIs to add features, automate workflows, or connect external services.
+ *
+ * Provides metadata about the app including its developer information and listing details in the Shopify App Store. Use the [`installation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App#field-App.fields.installation) field to determine if the app is currently installed on the shop and access installation-specific details like granted [`AccessScope`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AccessScope) objects. Check [`failedRequirements`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App#field-App.fields.failedRequirements) before installation to identify any prerequisites that must be met.
+ */
 type App = Node & {
     __typename?: 'App';
     /** A unique application API identifier. */
@@ -187,7 +199,7 @@ type App = Node & {
     icon: Image;
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
-    /** Webpage where you can install the app. */
+    /** Webpage where you can install the app, if app requires explicit user permission. */
     installUrl?: Maybe<Scalars['URL']['output']>;
     /**
      * Corresponding AppInstallation for this shop and App.
@@ -251,7 +263,20 @@ type AppConnection = {
     /** An object that’s used to retrieve [cursor information](https://shopify.dev/api/usage/pagination-graphql) about the current page. */
     pageInfo: PageInfo;
 };
-/** App credits can be applied by the merchant towards future app purchases, subscriptions, or usage records in Shopify. */
+/**
+ * Represents monetary credits that merchants can apply toward future app purchases, subscriptions, or usage-based billing within their Shopify store. App credits provide a flexible way to offer refunds, promotional credits, or compensation without processing external payments.
+ *
+ * For example, if a merchant experiences service downtime, an app might issue credits equivalent to the affected billing period. These credits can apply to future charges, reducing the merchant's next invoice or extending their subscription period.
+ *
+ * Use the `AppCredit` object to:
+ * - Issue refunds for service interruptions or billing disputes
+ * - Provide promotional credits for new merchant onboarding
+ * - Compensate merchants for app-related issues or downtime
+ * - Create loyalty rewards or referral bonuses within your billing system
+ * - Track credit balances and application history for accounting purposes
+ *
+ * For comprehensive billing strategies and credit management patterns, see the [subscription billing guide](https://shopify.dev/docs/apps/launch/billing/subscription-billing).
+ */
 type AppCredit = Node & {
     __typename?: 'AppCredit';
     /** The amount that can be used towards future app purchases in Shopify. */
@@ -384,7 +409,11 @@ type AppFeedback = {
     /** Conveys the state of the feedback and whether it requires merchant action or not. */
     state: ResourceFeedbackState;
 };
-/** Represents an installed application on a shop. */
+/**
+ * An app installed on a shop. Each installation tracks the permissions granted to the app through [`AccessScope`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AccessScope) objects, along with billing subscriptions and [`Metafield`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metafield) objects.
+ *
+ * The installation provides metafields that only the owning [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) can access. These metafields store app-specific configuration that merchants and other apps can't modify. The installation also provides URLs for launching and uninstalling the app, along with any active [`AppSubscription`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscription) objects or [`AppPurchaseOneTime`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppPurchaseOneTime) purchases.
+ */
 type AppInstallation = HasMetafields & Node & {
     __typename?: 'AppInstallation';
     /** The access scopes granted to the application by a merchant during installation. */
@@ -431,7 +460,13 @@ type AppInstallation = HasMetafields & Node & {
     /** The URL to uninstall the application. */
     uninstallUrl?: Maybe<Scalars['URL']['output']>;
 };
-/** The app plan that the merchant is subscribed to. */
+/**
+ * Contains the pricing details for the app plan that a merchant has subscribed to within their current billing arrangement.
+ *
+ * This simplified object focuses on the essential pricing information merchants need to understand their current subscription costs and billing structure.
+ *
+ * Details about subscription management and pricing strategies are available in the [app billing documentation](https://shopify.dev/docs/apps/launch/billing).
+ */
 type AppPlanV2 = {
     __typename?: 'AppPlanV2';
     /** The plan billed to a shop on a recurring basis. */
@@ -473,7 +508,22 @@ type AppPurchase = {
     /** Whether the app purchase is a test transaction. */
     test: Scalars['Boolean']['output'];
 };
-/** Services and features purchased once by a store. */
+/**
+ * Represents a one-time purchase of app services or features by a merchant, tracking the transaction details and status throughout the billing lifecycle. This object captures essential information about non-recurring charges, including price and merchant acceptance status.
+ *
+ * One-time purchases are particularly valuable for apps offering premium features, professional services, or digital products that don't require ongoing subscriptions. For instance, a photography app might sell premium filters as one-time purchases, while a marketing app could charge for individual campaign setups or advanced analytics reports.
+ *
+ * Use the `AppPurchaseOneTime` object to:
+ * - Track the status of individual feature purchases and service charges
+ * - Track payment status for premium content or digital products
+ * - Access purchase details to enable or disable features based on payment status
+ *
+ * The purchase status indicates whether the charge is pending merchant approval, has been accepted and processed, or was declined. This status tracking is crucial for apps that need to conditionally enable features based on successful payment completion.
+ *
+ * Purchase records include creation timestamps, pricing details, and test flags to distinguish between production charges and development testing. The test flag ensures that development and staging environments don't generate actual charges while maintaining realistic billing flow testing.
+ *
+ * For detailed implementation patterns and billing best practices, see the [one-time-charges page](https://shopify.dev/docs/apps/launch/billing/one-time-charges).
+ */
 type AppPurchaseOneTime = AppPurchase & Node & {
     __typename?: 'AppPurchaseOneTime';
     /** The date and time when the app purchase occurred. */
@@ -547,7 +597,25 @@ type AppRecurringPricing = {
     /** The amount and currency to be charged to the subscribing shop every billing interval. */
     price: MoneyV2;
 };
-/** Represents app revenue that was captured externally by the partner. */
+/**
+ * Tracks revenue that was captured outside of Shopify's billing system but needs to be attributed to the app for comprehensive revenue reporting and partner analytics. This object enables accurate revenue tracking when apps process payments through external systems while maintaining visibility into total app performance.
+ *
+ * External revenue attribution is essential for apps that offer multiple payment channels or process certain transactions outside Shopify's billing infrastructure. For example, an enterprise app might process large custom contracts through external payment processors, or a marketplace app could handle direct merchant-to-merchant transactions that still generate app commissions.
+ *
+ * Use the `AppRevenueAttributionRecord` object to:
+ * - Report revenue from external payment processors and billing systems
+ * - Track commission-based earnings from marketplace or referral activities
+ * - Maintain comprehensive revenue analytics across multiple payment channels
+ * - Ensure accurate partner revenue sharing and commission calculations
+ * - Generate complete financial reports that include all app-generated revenue streams
+ * - Support compliance requirements for external revenue documentation
+ *
+ * Each attribution record includes the captured amount, external transaction timestamp, and idempotency keys to prevent duplicate reporting. The record type field categorizes different revenue streams, enabling detailed analytics and reporting segmentation.
+ *
+ * Revenue attribution records are particularly important for apps participating in Shopify's partner program, as they ensure accurate revenue sharing calculations and comprehensive performance metrics. The captured timestamp reflects when the external payment was processed, not when the attribution record was created in Shopify.
+ *
+ * For detailed revenue attribution values, see the [AppRevenueAttributionType enum](https://shopify.dev/docs/api/admin-graphql/latest/enums/AppRevenueAttributionType).
+ */
 type AppRevenueAttributionRecord = Node & {
     __typename?: 'AppRevenueAttributionRecord';
     /** The financial amount captured in this attribution. */
@@ -598,7 +666,15 @@ declare enum AppRevenueAttributionType {
     /** Other app revenue collection type. */
     Other = "OTHER"
 }
-/** Provides users access to services and/or features for a duration of time. */
+/**
+ * A recurring billing agreement that associates an [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) with a merchant's shop. Each subscription contains one or more [`AppSubscriptionLineItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscriptionLineItem) objects that define the pricing structure. The pricing structure can include recurring charges, usage-based pricing, or both.
+ *
+ * The subscription tracks billing details including the current period end date, trial days, and [`AppSubscriptionStatus`](https://shopify.dev/docs/api/admin-graphql/latest/enums/AppSubscriptionStatus).
+ *
+ * Merchants must approve subscriptions through a [confirmation URL](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appSubscriptionCreate#returns-confirmationUrl) before billing begins. Test subscriptions allow developers to verify billing flows without actual charges.
+ *
+ * Learn more about [subscription billing](https://shopify.dev/docs/apps/launch/billing/subscription-billing) and [testing charges](https://shopify.dev/docs/apps/launch/billing/managed-pricing#test-charges).
+ */
 type AppSubscription = Node & {
     __typename?: 'AppSubscription';
     /** The date and time when the app subscription was created. */
@@ -667,7 +743,20 @@ type AppSubscriptionEdge = {
     /** The item at the end of AppSubscriptionEdge. */
     node: AppSubscription;
 };
-/** The plan attached to an app subscription. */
+/**
+ * Represents a component of an app subscription that contains pricing details for either recurring fees or usage-based charges. Each subscription has exactly 1 or 2 line items - one for recurring fees and/or one for usage fees.
+ *
+ * If a subscription has both recurring and usage pricing, there will be 2 line items. If it only has one type of pricing, the subscription will have a single line item for that pricing model.
+ *
+ * Use the `AppSubscriptionLineItem` object to:
+ * - View the pricing terms a merchant has agreed to
+ * - Distinguish between recurring and usage fee components
+ * - Access detailed billing information for each pricing component
+ *
+ * This read-only object provides visibility into the subscription's pricing structure without allowing modifications.
+ *
+ * Read about subscription pricing models in the [billing architecture guide](https://shopify.dev/docs/apps/launch/billing/subscription-billing).
+ */
 type AppSubscriptionLineItem = {
     __typename?: 'AppSubscriptionLineItem';
     /** A globally-unique ID. */
@@ -698,8 +787,17 @@ declare enum AppSubscriptionStatus {
     Pending = "PENDING"
 }
 /**
- * Defines a usage pricing model for the app subscription.
- * These charges are variable based on how much the merchant uses the app.
+ * Defines usage-based pricing terms for app subscriptions where merchants pay based on their actual consumption of app features or services. This pricing model provides flexibility for merchants who want to pay only for what they use rather than fixed monthly fees.
+ *
+ * For example, an email marketing app might charge variable pricing per email sent, with a monthly cap of variable pricing, allowing small merchants to pay minimal amounts while protecting larger merchants from excessive charges.
+ *
+ * Use the `AppUsagePricing` object to:
+ * - View consumption-based billing for variable app usage
+ * - See spending caps that protect merchants from unexpected charges
+ *
+ * The balance and capped amount fields provide apps with data about current usage costs and remaining budget within the billing period, which apps can present to merchants to promote transparency in variable pricing.
+ *
+ * For implementation guidance, see the [usage billing documentation](https://shopify.dev/docs/apps/launch/billing/subscription-billing/create-usage-based-subscriptions).
  */
 type AppUsagePricing = {
     __typename?: 'AppUsagePricing';
@@ -754,7 +852,11 @@ type AppUsageRecordEdge = {
     /** The item at the end of AppUsageRecordEdge. */
     node: AppUsageRecord;
 };
-/** An article in the blogging system. */
+/**
+ * An article that contains content, author information, and metadata. Articles belong to a [`Blog`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Blog) and can include HTML-formatted body text, summary text, and an associated image. Merchants publish articles to share content, drive traffic, and engage customers.
+ *
+ * Articles can be organized with tags and published immediately or scheduled for future publication using the [`publishedAt`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Article#field-Article.fields.publishedAt) timestamp. The API manages comments on articles when the blog's comment policy enables them.
+ */
 type Article = HasEvents & HasMetafieldDefinitions & HasMetafields & HasPublishedTranslations & Navigable & Node & {
     __typename?: 'Article';
     /** The name of the author of the article. */
@@ -827,7 +929,18 @@ type Article = HasEvents & HasMetafieldDefinitions & HasMetafields & HasPublishe
     /** The date and time (ISO 8601 format) when the article was last updated. */
     updatedAt?: Maybe<Scalars['DateTime']['output']>;
 };
-/** Represents an article author in an Article. */
+/**
+ * Represents the author of an article. This object provides the author's full name for attribution purposes.
+ *
+ * The `ArticleAuthor` is a simple object that contains only the author's name field. When articles are created or updated, the author information is stored and can be displayed alongside the article content.
+ *
+ * Use the `ArticleAuthor` object to:
+ * - Retrieve the author's name for display in article bylines
+ * - Show author attribution in article listings
+ * - Display who wrote specific content
+ *
+ * Note: This object only contains the author's full name. It does not include additional author details like bio, email, or social media links.
+ */
 type ArticleAuthor = {
     __typename?: 'ArticleAuthor';
     /** The author's full name. */
@@ -881,8 +994,9 @@ type BasePaymentDetails = {
     paymentMethodName?: Maybe<Scalars['String']['output']>;
 };
 /**
- * Shopify stores come with a built-in blogging engine, allowing a shop to have one or more blogs.  Blogs are meant
- * to be used as a type of magazine or newsletter for the shop, with content that changes over time.
+ * A blog for publishing articles in the online store. Stores can have multiple blogs to organize content by topic or purpose.
+ *
+ * Each blog contains articles with their associated comments, tags, and metadata. The comment policy controls whether readers can post comments and whether moderation is required. Blogs use customizable URL handles and can apply alternate templates for specialized layouts.
  */
 type Blog = HasEvents & HasMetafieldDefinitions & HasMetafields & HasPublishedTranslations & Node & {
     __typename?: 'Blog';
@@ -935,7 +1049,19 @@ type Blog = HasEvents & HasMetafieldDefinitions & HasMetafields & HasPublishedTr
     /** The date and time when the blog was update. */
     updatedAt?: Maybe<Scalars['DateTime']['output']>;
 };
-/** FeedBurner provider details. Any blogs that aren't already integrated with FeedBurner can't use the service. */
+/**
+ * RSS feed provider details for blog syndication. This object contains the location and path information for external feed services that were previously integrated with the blog.
+ *
+ * The `BlogFeed` object maintains the feed URL and path to ensure existing feed subscriptions continue working.
+ *
+ * Use the `BlogFeed` object to:
+ * - Access RSS feed provider configuration
+ * - Retrieve feed location and path information
+ * - Maintain existing feed syndication settings
+ *
+ * > Note:
+ * > This is a legacy feature. New integrations with external feed services are not supported.
+ */
 type BlogFeed = {
     __typename?: 'BlogFeed';
     /** Blog feed provider url. */
@@ -953,7 +1079,13 @@ type BundlesFeature = {
     /** Whether a shop has any fixed bundle products or has a cartTransform function installed. */
     sellsBundles: Scalars['Boolean']['output'];
 };
-/** Represents a merchant's Business Entity. */
+/**
+ * A legal entity through which a merchant operates. Each business entity contains its own [`BusinessEntityAddress`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BusinessEntityAddress), company information, and can be associated with its own [`ShopifyPaymentsAccount`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsAccount). [`Market`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Market) objects can be assigned to a business entity to determine payment processing and [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) attribution.
+ *
+ * Every shop must have one primary business entity. Additional entities enable international operations by establishing legal presence in multiple countries.
+ *
+ * Learn more about [managing multiple legal entities](https://shopify.dev/docs/apps/build/markets/multiple-entities).
+ */
 type BusinessEntity = Node & {
     __typename?: 'BusinessEntity';
     /** The address of the merchant's Business Entity. */
@@ -966,7 +1098,11 @@ type BusinessEntity = Node & {
     id: Scalars['ID']['output'];
     /** Whether it's the merchant's primary Business Entity. */
     primary: Scalars['Boolean']['output'];
-    /** Shopify Payments account information, including balances and payouts. */
+    /**
+     * Returns the Shopify Payments account information for the shop. Includes current balances across all currencies, payout schedules, and bank account configurations.
+     *
+     * The account includes [`ShopifyPaymentsBalanceTransaction`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsBalanceTransaction) records showing charges, refunds, and adjustments that affect your balance. Also includes [`ShopifyPaymentsDispute`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDispute) records and [`ShopifyPaymentsPayout`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsPayout) history between the account and connected [`ShopifyPaymentsBankAccount`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsBankAccount) configurations.
+     */
     shopifyPaymentsAccount?: Maybe<ShopifyPaymentsAccount>;
 };
 /** Represents the address of a merchant's Business Entity. */
@@ -1101,7 +1237,7 @@ type CalculatedDraftOrderLineItem = {
     /** The weight unit and value. */
     weight?: Maybe<Weight>;
 };
-/** Card payment details related to a transaction. */
+/** Credit card payment information captured during a transaction. Includes cardholder details, card metadata, verification response codes, and the [`DigitalWallet`](https://shopify.dev/docs/api/admin-graphql/latest/enums/DigitalWallet#valid-values) when used. */
 type CardPaymentDetails = BasePaymentDetails & {
     __typename?: 'CardPaymentDetails';
     /** The response code from the address verification system (AVS). The code is always a single letter. */
@@ -1125,7 +1261,13 @@ type CardPaymentDetails = BasePaymentDetails & {
     /** Digital wallet used for the payment. */
     wallet?: Maybe<DigitalWallet>;
 };
-/** Represents the cart transform feature configuration for the shop. */
+/**
+ * Controls which cart transformation operations apps can perform in your store. This lets you define exactly what types of cart modifications are allowed based on your checkout setup and business needs.
+ *
+ * The eligible operations determine what cart transform functions can accomplish, providing a clear boundary for app capabilities within the store's ecosystem.
+ *
+ * Learn more about [cart transform operations](https://shopify.dev/docs/api/functions/latest/cart-transform#multiple-operations).
+ */
 type CartTransformEligibleOperations = {
     __typename?: 'CartTransformEligibleOperations';
     /** The shop is eligible for expand operations. */
@@ -1135,7 +1277,15 @@ type CartTransformEligibleOperations = {
     /** The shop is eligible for update operations. */
     updateOperation: Scalars['Boolean']['output'];
 };
-/** Represents the cart transform feature configuration for the shop. */
+/**
+ * Provides access to the cart transform feature configuration for the merchant's store. This wrapper object indicates whether cart transformation capabilities are enabled and what operations are available.
+ *
+ * For example, when checking if your app can deploy customized bundle features, you would query this object to confirm cart transforms are supported and review the eligible operations.
+ *
+ * The feature configuration helps apps determine compatibility before attempting to create transform functions.
+ *
+ * Learn more about [cart transformation](https://shopify.dev/docs/api/admin-graphql/latest/objects/CartTransform).
+ */
 type CartTransformFeature = {
     __typename?: 'CartTransformFeature';
     /** The cart transform operations eligible for the shop. */
@@ -1207,21 +1357,19 @@ declare enum CatalogStatus {
     Draft = "DRAFT"
 }
 /**
- * A channel represents an app where you sell a group of products and collections.
- * A channel can be a platform or marketplace such as Facebook or Pinterest, an online store, or POS.
+ * An authenticated link to an external platform that supports syndication and optionally order ingestion, such as Facebook, Pinterest, an online store, or Point of Sale (POS).
+ *
+ * Each channel provides access to its underlying [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App), published products and collections, and [`Publication`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication) settings, as well as what features of the platform it supports such as [scheduled publishing](https://shopify.dev/docs/apps/build/sales-channels/scheduled-product-publishing). Use channels to manage where catalog items appear, track publication status across platforms, and control [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) visibility for different customer touchpoints.
  */
 type Channel = Node & {
     __typename?: 'Channel';
     /** The underlying app used by the channel. */
     app: App;
-    /** The collection publications for the list of collections published to the channel. */
+    /** The list of collection publications. Each record represents information about the publication of a collection. */
     collectionPublicationsV3: ResourcePublicationConnection;
     /** The list of collections published to the channel. */
     collections: CollectionConnection;
-    /**
-     * The unique identifier for the channel.
-     * @deprecated Use `id` instead.
-     */
+    /** The unique identifier for the channel. */
     handle: Scalars['String']['output'];
     /** Whether the collection is available to the channel. */
     hasCollection: Scalars['Boolean']['output'];
@@ -1246,24 +1394,11 @@ type Channel = Node & {
      * @deprecated Use `productPublicationsV3` instead.
      */
     productPublications: ProductPublicationConnection;
-    /** The product publications for the list of products published to the channel. */
+    /** The list of product publication records for products published to this channel. */
     productPublicationsV3: ResourcePublicationConnection;
     /** The list of products published to the channel. */
     products: ProductConnection;
-    /**
-     * Retrieves the total count of products that are currently published to a specific sales channel. This provides a quick way to understand channel inventory without fetching the full product list.
-     *
-     * For example, when building channel management dashboards, you can display how many products are available in each channel like "150 products in Online Store" or "75 products in Facebook Shop."
-     *
-     * Use `ChannelProductsCount` to:
-     * - Display inventory summaries in channel management interfaces
-     * - Monitor product distribution across sales channels
-     * - Validate channel setup and product availability
-     *
-     * The count reflects only published products and updates as merchants add or remove products from channels.
-     *
-     * Learn more about [sales channels](https://shopify.dev/docs/api/admin-graphql/latest/objects/Channel). Limited to a maximum of 10000 by default.
-     */
+    /** Retrieves the total count of [`products`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) published to a specific sales channel. Limited to a maximum of 10000 by default. */
     productsCount?: Maybe<Count>;
     /** Whether the channel supports future publishing. */
     supportsFuturePublishing: Scalars['Boolean']['output'];
@@ -1279,8 +1414,9 @@ type ChannelConnection = {
     pageInfo: PageInfo;
 };
 /**
- * A channel definition represents channels surfaces on the platform.
- * A channel definition can be a platform or a subsegment of it such as Facebook Home, Instagram Live, Instagram Shops, or WhatsApp chat.
+ * A specific selling surface within a [sales channel](https://shopify.dev/docs/apps/build/sales-channels) platform. A channel definition identifies where products can be sold. Definitions can represent entire platforms (like Facebook or TikTok) or specific sales channels within those platforms, such as Instagram Shops, Instagram Shopping, or TikTok Live.
+ *
+ * Each definition includes the parent [`Channel`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Channel) name and subchannel name to indicate the selling surface hierarchy. The marketplace flag identifies whether this surface represents a marketplace channel such as shops on Facebook, Instagram, or Buy on Google.
  */
 type ChannelDefinition = Node & {
     __typename?: 'ChannelDefinition';
@@ -1308,7 +1444,11 @@ type ChannelEdge = {
     /** The item at the end of ChannelEdge. */
     node: Channel;
 };
-/** Contains the information for a given sales channel. */
+/**
+ * Identifies the [sales channel](https://shopify.dev/docs/apps/build/sales-channels) and [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) from which an [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) originated. Provides attribution details such as the specific platform (Facebook Marketplace, Instagram Shopping) or marketplace where the order was placed.
+ *
+ * Links to the app that manages the channel and optional [`ChannelDefinition`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ChannelDefinition) details that specify the exact sub-channel or selling surface.
+ */
 type ChannelInformation = Node & {
     __typename?: 'ChannelInformation';
     /** The app associated with the channel. */
@@ -1769,7 +1909,16 @@ type Comment = HasEvents & Node & {
     /** The user agent of the commenter. */
     userAgent?: Maybe<Scalars['String']['output']>;
 };
-/** The author of a comment. */
+/**
+ * The author of a comment on a blog article, containing the commenter's name and email address. This information helps merchants moderate comments and potentially engage with their community.
+ *
+ * For example, when reviewing pending comments, merchants can see the commenter's name and email to help with moderation decisions or to enable follow-up communication if needed.
+ *
+ * Use the `CommentAuthor` object to:
+ * - Display comment attribution
+ * - Support comment moderation workflows
+ * - Enable merchant-to-reader communication
+ */
 type CommentAuthor = {
     __typename?: 'CommentAuthor';
     /** The author's email. */
@@ -1824,7 +1973,7 @@ declare enum CommentStatus {
     /** The comment is unapproved. */
     Unapproved = "UNAPPROVED"
 }
-/** Represents information about a company which is also a customer of the shop. */
+/** A business entity that purchases from the shop as part of B2B commerce. Companies organize multiple locations and contacts who can place orders on behalf of the organization. [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation) objects can have custom pricing through [`Catalog`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Catalog) and [`PriceList`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceList) configurations. */
 type Company = CommentEventSubject & HasEvents & HasMetafieldDefinitions & HasMetafields & Navigable & Node & {
     __typename?: 'Company';
     /**
@@ -1942,7 +2091,11 @@ type CompanyAddress = Node & {
      */
     zoneCode?: Maybe<Scalars['String']['output']>;
 };
-/** A person that acts on behalf of company associated to [a customer](https://shopify.dev/api/admin-graphql/latest/objects/customer). */
+/**
+ * A person who acts on behalf of a [`Company`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Company) to make B2B purchases. Company contacts are associated with [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) accounts and can place orders on behalf of their company.
+ *
+ * Each contact can be assigned to one or more [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation) objects with specific roles that determine their permissions and access to catalogs, pricing, and payment terms configured for those locations.
+ */
 type CompanyContact = Node & {
     __typename?: 'CompanyContact';
     /** The company to which the contact belongs. */
@@ -2055,7 +2208,11 @@ type CompanyContactRoleEdge = {
     /** The item at the end of CompanyContactRoleEdge. */
     node: CompanyContactRole;
 };
-/** A location or branch of a [company that's a customer](https://shopify.dev/api/admin-graphql/latest/objects/company) of the shop. Configuration of B2B relationship, for example prices lists and checkout settings, may be done for a location. */
+/**
+ * A location or branch of a [`Company`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Company) that's a customer of the shop. Company locations enable B2B customers to manage multiple branches with distinct billing and shipping addresses, tax settings, and checkout configurations.
+ *
+ * Each location can have its own [`Catalog`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Catalog) objects that determine which products are published and their pricing. The [`BuyerExperienceConfiguration`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BuyerExperienceConfiguration) determines checkout behavior including [`PaymentTerms`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentTerms), and whether orders require merchant review. B2B customers select which location they're purchasing for, which determines the applicable catalogs, pricing, [`TaxExemption`](https://shopify.dev/docs/api/admin-graphql/latest/enums/TaxExemption) values, and checkout settings for their [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) objects.
+ */
 type CompanyLocation = CommentEventSubject & HasEvents & HasMetafieldDefinitions & HasMetafields & Navigable & Node & {
     __typename?: 'CompanyLocation';
     /** The address used as billing address for the location. */
@@ -2211,7 +2368,7 @@ type CompanyLocationsCondition = {
     /** The company locations that comprise the market. */
     companyLocations: CompanyLocationConnection;
 };
-/** Details for count of elements. */
+/** A numeric count with precision information indicating whether the count is exact or an estimate. */
 type Count = {
     __typename?: 'Count';
     /** The count of elements. */
@@ -3141,14 +3298,19 @@ type CurrencySettingEdge = {
     node: CurrencySetting;
 };
 /**
- * Represents information about a customer of the shop, such as the customer's contact details, their order
- * history, and whether they've agreed to receive marketing material by email.
+ * Information about a customer of the shop, such as the customer's contact details, purchase history, and marketing preferences.
  *
- * **Caution:** Only use this data if it's required for your app's functionality. Shopify will restrict [access to scopes](https://shopify.dev/api/usage/access-scopes) for apps that don't have a legitimate use for the associated data.
+ * Tracks the customer's total spending through the [`amountSpent`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer#field-amountSpent) field and provides access to associated data such as payment methods and subscription contracts.
+ *
+ * > Caution:
+ * > Only use this data if it's required for your app's functionality. Shopify will restrict [access to scopes](https://shopify.dev/api/usage/access-scopes) for apps that don't have a legitimate use for the associated data.
  */
 type Customer = CommentEventSubject & HasEvents & HasMetafieldDefinitions & HasMetafields & HasStoreCreditAccounts & LegacyInteroperability & Node & {
     __typename?: 'Customer';
-    /** A list of addresses associated with the customer. */
+    /**
+     * A list of addresses associated with the customer. Limited to 250 addresses. Use `addresses_v2` for paginated access to all addresses.
+     * @deprecated Limited to 250 addresses. Use `addresses_v2` for paginated access to all addresses.
+     */
     addresses: Array<MailingAddress>;
     /** The addresses associated with the customer. */
     addressesV2: MailingAddressConnection;
@@ -3303,7 +3465,7 @@ type Customer = CommentEventSubject & HasEvents & HasMetafieldDefinitions & HasM
     /** Whether the customer has verified their email address. Defaults to `true` if the customer is created through the Shopify admin or API. */
     verifiedEmail: Scalars['Boolean']['output'];
 };
-/** Information about the shop's customer accounts. */
+/** Information about the shop's customer account-related settings. Includes the [customer account version](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerAccountsV2#field-CustomerAccountsV2.fields.customerAccountsVersion) which indicates whether the merchant is using new customer accounts or legacy customer accounts, along with other account configuration such as login requirements. */
 type CustomerAccountsV2 = {
     __typename?: 'CustomerAccountsV2';
     /** Indicates which version of customer accounts the merchant is using in online store and checkout. */
@@ -3403,7 +3565,11 @@ type CustomerEdge = {
     /** The item at the end of CustomerEdge. */
     node: Customer;
 };
-/** Represents an email address. */
+/**
+ * A customer's email address with marketing consent. This includes the email address, marketing subscription status, and opt-in level according to [M3AAWG best practices guidelines](https://www.m3aawg.org/news/updated-m3aawg-best-practices-for-senders-urge-opt-in-only-mailings-address-sender-transparency).
+ *
+ * It also provides the timestamp of when customers last updated marketing consent and URLs for unsubscribing from marketing emails or opting in or out of email open tracking. The [`sourceLocation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerEmailAddress#field-CustomerEmailAddress.fields.sourceLocation) field indicates where the customer consented to receive marketing material.
+ */
 type CustomerEmailAddress = {
     __typename?: 'CustomerEmailAddress';
     /** The customer's default email address. */
@@ -3493,7 +3659,7 @@ declare enum CustomerEmailMarketingState {
     /** The customer isn't currently subscribed to email marketing but was previously subscribed. */
     Unsubscribed = "UNSUBSCRIBED"
 }
-/** Represents a customer's visiting activities on a shop's online store. */
+/** Tracks a customer's path to purchase through their online store visits. The journey captures key moments like shop sessions that led to the order, helping merchants understand customer behavior and marketing attribution within a 30-day window. Includes the first and last sessions before an [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order), the time between initial visit and conversion, and the customer's order position in their purchase history. */
 type CustomerJourney = {
     __typename?: 'CustomerJourney';
     /** The position of the current order within the customer's order history. */
@@ -3507,7 +3673,11 @@ type CustomerJourney = {
     /** Events preceding a customer order, such as shop sessions. */
     moments: Array<CustomerMoment>;
 };
-/** Represents a customer's visiting activities on a shop's online store. */
+/**
+ * A [`CustomerJourney`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerJourney) through the online store leading up to an [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order). Tracks session data, attribution sources, and the timeline from first visit to purchase conversion.
+ *
+ * The summary includes the customer's position in their order history, days between first visit and order creation, and details about their first and last sessions. Use the [`moments`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerJourneySummary#field-moments) connection to access the complete timeline of customer interactions before the purchase.
+ */
 type CustomerJourneySummary = {
     __typename?: 'CustomerJourneySummary';
     /** The position of the current order within the customer's order history. Test orders aren't included. */
@@ -3664,7 +3834,11 @@ type CustomerPaymentInstrumentBillingAddress = {
     /** The zip or postal code of the address. */
     zip?: Maybe<Scalars['String']['output']>;
 };
-/** A customer's payment method. */
+/**
+ * A customer's saved payment method. Stores the payment instrument details and billing information for recurring charges.
+ *
+ * The payment method supports types included in the [`CustomerPaymentInstrument`](https://shopify.dev/docs/api/admin-graphql/latest/unions/CustomerPaymentInstrument) union.
+ */
 type CustomerPaymentMethod = Node & {
     __typename?: 'CustomerPaymentMethod';
     /** The customer to whom the payment method belongs. */
@@ -3912,7 +4086,11 @@ type CustomerStatistics = {
     /** The RFM (Recency, Frequency, Monetary) group of the customer. */
     rfmGroup?: Maybe<CustomerRfmGroup>;
 };
-/** Represents a customer's session visiting a shop's online store, including information about the marketing activity attributed to starting the session. */
+/**
+ * A customer's session on the online store. Tracks how the [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) arrived at the store, including the landing page, referral source, and any associated marketing campaigns.
+ *
+ * The visit captures attribution data such as [`UTMParameters`](https://shopify.dev/docs/api/admin-graphql/latest/objects/UTMParameters), referral codes, and the [`MarketingEvent`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketingEvent) that drove the session. This information helps merchants understand which marketing efforts successfully bring customers to their store.
+ */
 type CustomerVisit = CustomerMoment & Node & {
     __typename?: 'CustomerVisit';
     /** A globally-unique ID. */
@@ -4055,7 +4233,16 @@ type DeliveryBrandedPromise = {
  *       "variant_id": 258644705304
  *     }],
  *     "currency": "USD",
- *     "locale": "en"
+ *     "locale": "en",
+ *     "order_totals": {
+ *       "subtotal_price": "1999",
+ *       "total_price": "2199",
+ *       "discount_amount": "150"
+ *     },
+ *     "customer": {
+ *       "id": 207119551,
+ *       "tags": ["VIP", "wholesale"]
+ *     }
  *   }
  * }
  * ```
@@ -4087,7 +4274,15 @@ type DeliveryBrandedPromise = {
  *            "total_price": "3587",
  *            "currency": "USD",
  *            "min_delivery_date": "2013-04-12 14:48:45 -0400",
- *            "max_delivery_date": "2013-04-12 14:48:45 -0400"
+ *            "max_delivery_date": "2013-04-12 14:48:45 -0400",
+ *            "metafields": [
+ *                {
+ *                    "key": "tracking_url",
+ *                    "value": "abc123",
+ *                    "namespace": "carrier_service_metadata",
+ *                    "type": "single_line_text_field"
+ *                }
+ *            ]
  *        }
  *    ]
  * }
@@ -4111,12 +4306,13 @@ type DeliveryBrandedPromise = {
  * | ----------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  * | `service_name`          | Yes      | The name of the rate, which customers see at checkout. For example: `Expedited Mail`.                                                                                                                        |
  * | `description`           | Yes      | A description of the rate, which customers see at checkout. For example: `Includes tracking and insurance`.                                                                                                  |
- * | `service_code`          | Yes      | A unique code associated with the rate. For example: `expedited_mail`.                                                                                                                                       |
+ * | `service_code`          | Yes      | A unique code associated with the rate that must be consistent across requests. For example: `expedited_mail`.                                                                                               |
  * | `currency`              | Yes      | The currency of the shipping rate.                                                                                                                                                                           |
  * | `total_price`           | Yes      | The total price expressed in subunits. If the currency doesn't use subunits, then the value must be multiplied by 100. For example: `"total_price": 500` for 5.00 CAD, `"total_price": 100000` for 1000 JPY. |
  * | `phone_required`        | No       | Whether the customer must provide a phone number at checkout.                                                                                                                                                |
  * | `min_delivery_date`     | No       | The earliest delivery date for the displayed rate.                                                                                                                                                           |
  * | `max_delivery_date`     | No       | The latest delivery date for the displayed rate to still be valid.                                                                                                                                           |
+ * | `metafields`            | No       | An array of metafield objects to attach custom metadata to the shipping rate.                                                                                                                                |
  *
  * ### Special conditions
  *
@@ -4124,6 +4320,7 @@ type DeliveryBrandedPromise = {
  * * To force backup rates instead, return a 40x or 50x HTTP code with any content. A good choice is the regular 404 Not Found code.
  * * Redirects (30x codes) will only be followed for the same domain as the original callback URL. Attempting to redirect to a different domain will trigger backup rates.
  * * There is no retry mechanism. The response must be successful on the first try, within the time budget listed below. Timeouts or errors will trigger backup rates.
+ * * The `service_code` must be stable and consistent across requests for the same shipping option. It should not contain dynamic values like session IDs, timestamps, or request-specific identifiers. Use metafields for passing dynamic or session-specific data.
  *
  * ## Response Timeouts
  *
@@ -4343,7 +4540,11 @@ type DeliveryLocationGroupZoneEdge = {
     /** The item at the end of DeliveryLocationGroupZoneEdge. */
     node: DeliveryLocationGroupZone;
 };
-/** The delivery method used by a fulfillment order. */
+/**
+ * Information about the delivery method selected for a [`FulfillmentOrder`](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrder). Includes the method type, expected delivery timeframe, and any additional information needed for delivery.
+ *
+ * The delivery method stores details from checkout such as the carrier, branded promises like Shop Promise, and the delivery option name shown to the buyer. Additional information like delivery instructions or contact phone numbers helps fulfill the [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) correctly.
+ */
 type DeliveryMethod = Node & {
     __typename?: 'DeliveryMethod';
     /** The Additional information to consider when performing the delivery. */
@@ -4468,7 +4669,13 @@ type DeliveryProductVariantsCount = {
     /** The product variant count. */
     count: Scalars['Int']['output'];
 };
-/** A shipping profile. In Shopify, a shipping profile is a set of shipping rates scoped to a set of products or variants that can be shipped from selected locations to zones. Learn more about [building with delivery profiles](https://shopify.dev/apps/build/purchase-options/deferred/delivery-and-deferment/build-delivery-profiles). */
+/**
+ * A shipping profile that defines shipping rates for specific [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) objects and [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) objects. Delivery profiles determine which products can ship from which [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) objects to which zones, and at what rates.
+ *
+ * Profiles can associate with [`SellingPlanGroup`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanGroup) objects to provide custom shipping rules for subscriptions, such as free shipping or restricted delivery zones. The default profile applies to all products that aren't assigned to other profiles.
+ *
+ * Learn more about [building delivery profiles](https://shopify.dev/apps/build/purchase-options/deferred/delivery-and-deferment/build-delivery-profiles).
+ */
 type DeliveryProfile = Node & {
     __typename?: 'DeliveryProfile';
     /** The number of active shipping rates for the profile. */
@@ -4477,7 +4684,10 @@ type DeliveryProfile = Node & {
     default: Scalars['Boolean']['output'];
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
-    /** Whether this shop has enabled legacy compatibility mode for delivery profiles. */
+    /**
+     * Whether this shop has enabled legacy compatibility mode for delivery profiles.
+     * @deprecated Legacy mode profiles are no longer supported.
+     */
     legacyMode: Scalars['Boolean']['output'];
     /** The number of locations without rates defined. */
     locationsWithoutRatesCount: Scalars['Int']['output'];
@@ -4600,7 +4810,11 @@ declare enum DigitalWallet {
 }
 /** A discount offers promotional value and can be applied by entering a code or automatically when conditions are met. Discounts can provide fixed amounts, percentage reductions, free shipping, or Buy X Get Y (BXGY) benefits on specific products or the entire order. For more complex scenarios, developers can use Function-backed discounts to create custom discount configurations. */
 type Discount = DiscountAutomaticApp | DiscountAutomaticBasic | DiscountAutomaticBxgy | DiscountAutomaticFreeShipping | DiscountCodeApp | DiscountCodeBasic | DiscountCodeBxgy | DiscountCodeFreeShipping;
-/** An amount that's allocated to a line based on an associated discount application. */
+/**
+ * The actual amount discounted on a line item or shipping line. While [`DiscountApplication`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/DiscountApplication) captures the discount's intentions and rules, The `DiscountAllocation` object shows the final calculated discount amount applied to each line.
+ *
+ * The allocation includes the discounted amount in both shop and presentment currencies, with a reference to the originating discount application.
+ */
 type DiscountAllocation = {
     __typename?: 'DiscountAllocation';
     /**
@@ -4693,7 +4907,11 @@ declare enum DiscountApplicationTargetType {
     /** The discount applies onto shipping lines. */
     ShippingLine = "SHIPPING_LINE"
 }
-/** The type of discount associated to the automatic discount. For example, the automatic discount might offer a basic discount using a fixed percentage, or a fixed amount, on specific products from the order. The automatic discount may also be a BXGY discount, which offers customer discounts on select products if they add a specific product to their order. */
+/**
+ * The types of automatic discounts applied in the cart and at checkout when an order meets specific criteria.
+ *
+ * Includes [`DiscountAutomaticApp`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticApp) for custom logic using the [Discount Function API](https://shopify.dev/docs/api/functions/latest/discount), [`DiscountAutomaticBasic`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticBasic) for percentage or fixed amount reductions, [`DiscountAutomaticBxgy`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticBxgy) for Buy X Get Y promotions, and [`DiscountAutomaticFreeShipping`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticFreeShipping) for delivery incentives.
+ */
 type DiscountAutomatic = DiscountAutomaticApp | DiscountAutomaticBasic | DiscountAutomaticBxgy | DiscountAutomaticFreeShipping;
 /**
  * The `DiscountAutomaticApp` object stores information about automatic discounts
@@ -5725,7 +5943,13 @@ type DiscountCountryAll = {
     /** Whether the discount can be applied to all countries as shipping destination. This value is always `true`. */
     allCountries: Scalars['Boolean']['output'];
 };
-/** The `DiscountCustomerAll` object lets you target all customers for discount eligibility. */
+/**
+ * Creates the broadest possible discount reach by targeting all customers, regardless of their purchase history or segment membership. This gives merchants maximum flexibility to run store-wide promotions without worrying about customer eligibility restrictions.
+ *
+ * For example, a flash sale or grand opening promotion would target all customers to maximize participation and store visibility.
+ *
+ * Learn more about [customer targeting](https://help.shopify.com/manual/discounts/).
+ */
 type DiscountCustomerAll = {
     __typename?: 'DiscountCustomerAll';
     /** Whether the discount can be applied by all customers. This value is always `true`. */
@@ -5778,7 +6002,21 @@ type DiscountCustomerSegments = {
 };
 /** The type used for targeting a set of customers who are eligible for the discount. For example, the discount might be available to all customers or it might only be available to a specific set of customers. You can define the set of customers by targeting a list of customer segments, or by targeting a list of specific customers. */
 type DiscountCustomerSelection = DiscountCustomerAll | DiscountCustomerSegments | DiscountCustomers;
-/** A list of individual customers eligible for the discount. */
+/**
+ * Defines customer targeting for discounts through specific individual customers. This object allows merchants to create exclusive discounts that are only available to explicitly selected customers.
+ *
+ * For example, a VIP customer appreciation discount might target specific high-value customers by individually selecting them, or a beta program discount could be offered to selected early adopters.
+ *
+ * Use `DiscountCustomers` to:
+ * - Target specific individual customers for exclusive promotions
+ * - Create personalized discount experiences for selected customers
+ * - Offer special discounts to VIP or loyal customers
+ * - Provide exclusive access to promotions for specific individuals
+ *
+ * This targeting method requires you to add each customer who should be eligible for the discount. For broader targeting based on customer attributes or segments, use [`DiscountCustomerSegments`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountCustomerSegments) instead.
+ *
+ * Learn more about creating customer-specific discounts using [`discountCodeBasicCreate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/discountCodeBasicCreate) and [`discountCodeBasicUpdate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/discountCodeBasicUpdate).
+ */
 type DiscountCustomers = {
     __typename?: 'DiscountCustomers';
     /** The list of individual customers eligible for the discount. */
@@ -5788,7 +6026,13 @@ type DiscountCustomers = {
 type DiscountEffect = DiscountAmount | DiscountPercentage;
 /** The type used to target the items required for discount eligibility, or the items to which the application of a discount might apply. For example, for a customer to be eligible for a discount, they're required to add an item from a specified collection to their order. Alternatively, a customer might be required to add a specific product or product variant. When using this type to target which items the discount will apply to, the discount might apply to all items on the order, or to specific products and product variants, or items in a given collection. */
 type DiscountItems = AllDiscountItems | DiscountCollections | DiscountProducts;
-/** The minimum quantity of items required for the discount to apply. */
+/**
+ * Specifies the minimum item quantity required for discount eligibility, helping merchants create volume-based promotions that encourage larger purchases. This threshold applies to qualifying items in the customer's cart.
+ *
+ * For example, a "Buy 3, Get 10% Off" promotion would set the minimum quantity to 3 items.
+ *
+ * Learn more about [discount requirements](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountApplication).
+ */
 type DiscountMinimumQuantity = {
     __typename?: 'DiscountMinimumQuantity';
     /** The minimum quantity of items that's required for the discount to be applied. */
@@ -5855,7 +6099,13 @@ type DiscountOnQuantity = {
     /** The number of items being discounted. The customer must have at least this many items of specified products or product variants in their order to be eligible for the discount. */
     quantity: DiscountQuantity;
 };
-/** A discount effect that gives customers a percentage off of specified items on their order. */
+/**
+ * Creates percentage-based discounts that reduce item prices by a specified percentage amount. This gives merchants a flexible way to offer proportional savings that automatically scale with order value.
+ *
+ * For example, a "20% off all winter clothing" promotion would use this object to apply consistent percentage savings across different price points.
+ *
+ * Learn more about [discount types](https://help.shopify.com/manual/discounts/).
+ */
 type DiscountPercentage = {
     __typename?: 'DiscountPercentage';
     /** The percentage value of the discount. */
@@ -6094,7 +6344,7 @@ type DraftOrder = CommentEventSubject & HasEvents & HasLocalizationExtensions &
     lineItems: DraftOrderLineItemConnection;
     /**
      * A subtotal of the line items and corresponding discounts,
-     * excluding include shipping charges, shipping discounts, taxes, or order discounts.
+     * excluding shipping charges, shipping discounts, taxes, or order discounts.
      */
     lineItemsSubtotalPrice: MoneyBag;
     /**
@@ -6177,7 +6427,7 @@ type DraftOrder = CommentEventSubject & HasEvents & HasLocalizationExtensions &
     taxesIncluded: Scalars['Boolean']['output'];
     /** Total discounts. */
     totalDiscountsSet: MoneyBag;
-    /** Total price of line items. */
+    /** Total price of line items, excluding discounts. */
     totalLineItemsPriceSet: MoneyBag;
     /**
      * The total price, in shop currency, includes taxes, shipping charges, and discounts.
@@ -6275,7 +6525,11 @@ type DraftOrderEdge = {
     /** The item at the end of DraftOrderEdge. */
     node: DraftOrder;
 };
-/** The line item for a draft order. */
+/**
+ * A line item in a draft order. Line items are either [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) objects or custom items created manually with specific pricing and attributes.
+ *
+ * Each line item includes [quantity](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrderLineItem#field-DraftOrderLineItem.fields.quantity), [pricing](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrderLineItem#field-DraftOrderLineItem.fields.originalUnitPrice), [discounts](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrderLineItem#field-DraftOrderLineItem.fields.discountedTotal), [tax information](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrderLineItem#field-DraftOrderLineItem.fields.taxLines), and [custom attributes](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrderLineItem#field-DraftOrderLineItem.fields.customAttributes). For [bundle products](https://shopify.dev/docs/apps/build/products/bundles), the line item includes components that define the individual products within the bundle.
+ */
 type DraftOrderLineItem = Node & {
     __typename?: 'DraftOrderLineItem';
     /** The custom applied discount. */
@@ -7834,7 +8088,12 @@ type FulfillmentService = {
     inventoryManagement: Scalars['Boolean']['output'];
     /** Location associated with the fulfillment service. */
     location?: Maybe<Location>;
-    /** Whether the fulfillment service can stock inventory alongside other locations. */
+    /**
+     * Whether the fulfillment service can stock inventory alongside other locations.
+     * @deprecated Fulfillment services are all migrating to permit SKU sharing.
+     * Setting permits SKU sharing to false [is no longer supported](https://shopify.dev/changelog/setting-permitsskusharing-argument-to-false-when-creating-a-fulfillment-service-returns-an-error).
+     *
+     */
     permitsSkuSharing: Scalars['Boolean']['output'];
     /** Whether the fulfillment service requires products to be physically shipped. */
     requiresShippingMethod: Scalars['Boolean']['output'];
@@ -8099,7 +8358,13 @@ type GenericFile = File & Node & {
     /** The generic file's URL. */
     url?: Maybe<Scalars['URL']['output']>;
 };
-/** Represents an issued gift card. */
+/**
+ * A gift card that customers use as a payment method. Stores the initial value, current balance, and expiration date.
+ *
+ * You can issue gift cards to a specific [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) or send them to a [`GiftCardRecipient`](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardRecipient) with a personalized message. The card tracks its transaction history through [`GiftCardCreditTransaction`](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardCreditTransaction) and [`GiftCardDebitTransaction`](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardDebitTransaction) records. You can create and deactivate gift cards using the [`GiftCardCreate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardCreate) and [`GiftCardDeactivate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardDeactivate) mutations, respectively.
+ *
+ * > Note: After a gift card is deactivated, it can't be used for further purchases or re-enabled.
+ */
 type GiftCard = Node & {
     __typename?: 'GiftCard';
     /** The gift card's remaining balance. */
@@ -8339,9 +8604,9 @@ declare enum InclusiveTaxPricingStrategy {
     IncludesTaxesInPriceBasedOnCountry = "INCLUDES_TAXES_IN_PRICE_BASED_ON_COUNTRY"
 }
 /**
- * Represents the goods available to be shipped to a customer.
- * It holds essential information about the goods, including SKU and whether it is tracked.
- * Learn [more about the relationships between inventory objects](https://shopify.dev/docs/apps/build/orders-fulfillment/inventory-management-apps/manage-quantities-states#inventory-object-relationships).
+ * A [product variant's](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) inventory information across all locations. The inventory item connects the product variant to its [inventory levels](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryLevel) at different locations, tracking stock keeping unit (SKU), whether quantities are tracked, shipping requirements, and customs information for the product.
+ *
+ * Learn more about [inventory object relationships](https://shopify.dev/docs/apps/build/orders-fulfillment/inventory-management-apps/manage-quantities-states#inventory-object-relationships).
  */
 type InventoryItem = LegacyInteroperability & Node & {
     __typename?: 'InventoryItem';
@@ -8404,7 +8669,7 @@ type InventoryItemEdge = {
     /** The item at the end of InventoryItemEdge. */
     node: InventoryItem;
 };
-/** Represents the packaged dimension for an inventory item. */
+/** Weight information for an [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryItem) when packaged. Provides the weight specification used for inventory management and shipping calculations. Learn more about [managing inventory](https://shopify.dev/docs/apps/build/orders-fulfillment/inventory-management-apps). */
 type InventoryItemMeasurement = Node & {
     __typename?: 'InventoryItemMeasurement';
     /** A globally-unique ID. */
@@ -8413,8 +8678,9 @@ type InventoryItemMeasurement = Node & {
     weight?: Maybe<Weight>;
 };
 /**
- * The quantities of an inventory item that are related to a specific location.
- * Learn [more about the relationships between inventory objects](https://shopify.dev/docs/apps/build/orders-fulfillment/inventory-management-apps/manage-quantities-states#inventory-object-relationships).
+ * The quantities of an inventory item at a specific location. Each inventory level connects one [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryItem) to one [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location), tracking multiple quantity states like available, on-hand, incoming, and committed.
+ *
+ * The [`quantities`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryLevel#field-InventoryLevel.fields.quantities) field provides access to different inventory states. Learn [more about inventory states and relationships](https://shopify.dev/docs/apps/build/orders-fulfillment/inventory-management-apps/manage-quantities-states#inventory-object-relationships).
  */
 type InventoryLevel = Node & {
     __typename?: 'InventoryLevel';
@@ -8430,7 +8696,10 @@ type InventoryLevel = Node & {
     item: InventoryItem;
     /** The location associated with the inventory level. */
     location: Location;
-    /** Quantities for the requested names. */
+    /**
+     * The quantity of an inventory item at a specific location, for a quantity
+     * [name](https://shopify.dev/docs/apps/fulfillment/inventory-management-apps#inventory-states).
+     */
     quantities: Array<InventoryQuantity>;
     /** Scheduled changes for the requested quantity names. */
     scheduledChanges: InventoryScheduledChangeConnection;
@@ -8455,19 +8724,30 @@ type InventoryLevelEdge = {
     /** The item at the end of InventoryLevelEdge. */
     node: InventoryLevel;
 };
-/** Represents a quantity of an inventory item at a specific location, for a specific name. */
+/**
+ * The `InventoryQuantity` object lets you manage and track inventory quantities for specific [states](https://shopify.dev/docs/apps/fulfillment/inventory-management-apps#inventory-states).
+ * Inventory quantities represent different states of items such as available for purchase, committed to orders, reserved for drafts, incoming from suppliers, or set aside for quality control or safety stock.
+ *
+ * You can use [inventory levels](https://shopify.dev/docs/api/admin-graphql/latest/objects/inventorylevel) to manage where inventory items are stocked. You can also [make inventory adjustments](https://shopify.dev/docs/api/admin-graphql/latest/mutations/inventoryAdjustQuantities) to apply changes to inventory quantities.
+ *
+ * Inventory quantities can be managed by a merchant or by [fulfillment services](https://shopify.dev/docs/api/admin-graphql/latest/objects/fulfillmentservice) that handle inventory tracking.
+ * Learn more about working with [Shopify's inventory management system](https://shopify.dev/docs/apps/fulfillment/inventory-management-apps).
+ */
 type InventoryQuantity = Node & {
     __typename?: 'InventoryQuantity';
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
     /**
-     * The [name](https://shopify.dev/docs/apps/fulfillment/inventory-management-apps#inventory-states)
+     * The inventory state [name](https://shopify.dev/docs/apps/fulfillment/inventory-management-apps#inventory-states)
      * that identifies the inventory quantity.
      */
     name: Scalars['String']['output'];
-    /** The quantity for the quantity name. */
+    /**
+     * The quantity of an inventory item at a specific location, for a quantity
+     * [name](https://shopify.dev/docs/apps/fulfillment/inventory-management-apps#inventory-states).
+     */
     quantity: Scalars['Int']['output'];
-    /** When the quantity was last updated. */
+    /** When the inventory quantity was last updated. */
     updatedAt?: Maybe<Scalars['DateTime']['output']>;
 };
 /** Returns the scheduled changes to inventory states related to the ledger document. */
@@ -8726,7 +9006,13 @@ type LineItemEdge = {
     /** The item at the end of LineItemEdge. */
     node: LineItem;
 };
-/** A line item group (bundle) to which a line item belongs to. */
+/**
+ * The information for [line items](https://shopify.dev/docs/api/admin-graphql/latest/objects/LineItem) that are part of a bundle. When a bundle is purchased, each component line item references its [`LineItemGroup`](https://shopify.dev/docs/api/admin-graphql/latest/objects/LineItemGroup) through the [`lineItemGroup`](https://shopify.dev/docs/api/admin-graphql/latest/objects/LineItem#field-lineItemGroup) field to maintain the relationship with the bundle.
+ *
+ * The parent bundle's product, variant, and custom attributes enable apps to group and display bundle components in order management systems, transactional emails, and other contexts where understanding the bundle structure is needed.
+ *
+ * Learn more about [product bundles](https://shopify.dev/docs/apps/build/product-merchandising/bundles).
+ */
 type LineItemGroup = Node & {
     __typename?: 'LineItemGroup';
     /** A list of attributes that represent custom features or special requests. */
@@ -9176,9 +9462,9 @@ type LocationsCondition = {
     locations: LocationConnection;
 };
 /**
- * Represents a customer mailing address.
+ * A physical mailing address. For example, a [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer)'s default address and an [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order)'s billing address are both mailing addresses. Stores standard address components, customer name information, and company details.
  *
- * For example, a customer's default address and an order's billing address are both mailling addresses.
+ * The address includes geographic coordinates ([`latitude`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.latitude) and [`longitude`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.longitude)). You can format addresses for display using the [`formatted`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.formatted) field with options to include or exclude name and company information.
  */
 type MailingAddress = Node & {
     __typename?: 'MailingAddress';
@@ -9362,7 +9648,13 @@ type Market = HasMetafieldDefinitions & HasMetafields & Node & {
      */
     webPresences: MarketWebPresenceConnection;
 };
-/** A list of products with publishing and pricing information associated with markets. */
+/**
+ * A catalog for managing product availability and pricing for specific [`Market`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Market) contexts. Each catalog links to one or more markets and defines what [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) objects customers see through its [`Publication`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication) settings. The catalog can include a [`PriceList`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceList) for market-specific pricing adjustments.
+ *
+ * Use catalogs to create distinct shopping experiences for different geographic regions or customer segments.
+ *
+ * Learn more about [building a catalog](https://shopify.dev/docs/apps/build/markets/build-catalog) and [managing markets](https://shopify.dev/docs/apps/build/markets).
+ */
 type MarketCatalog = Catalog & Node & {
     __typename?: 'MarketCatalog';
     /** A globally-unique ID. */
@@ -10017,7 +10309,7 @@ type MerchantApprovalSignals = {
 };
 /**
  * Metafields enable you to attach additional information to a Shopify resource, such as a [Product](https://shopify.dev/api/admin-graphql/latest/objects/product) or a [Collection](https://shopify.dev/api/admin-graphql/latest/objects/collection).
- * For more information about where you can attach metafields refer to [HasMetafields](https://shopify.dev/api/admin/graphql/reference/common-objects/HasMetafields).
+ * For more information about where you can attach metafields refer to [HasMetafields](https://shopify.dev/api/admin-graphql/latest/interfaces/HasMetafields).
  * Some examples of the data that metafields enable you to store are specifications, size charts, downloadable documents, release dates, images, or part numbers.
  * Metafields are identified by an owner resource, namespace, and key. and store a value along with type information for that value.
  */
@@ -10054,7 +10346,7 @@ type Metafield = HasCompareDigest & LegacyInteroperability & Node & {
     /** A list of reference objects if the metafield's type is a resource reference list. */
     references?: Maybe<MetafieldReferenceConnection>;
     /**
-     * The type of data that is stored in the metafield.
+     * The type of data that's stored in the metafield.
      * Refer to the list of [supported types](https://shopify.dev/apps/metafields/types).
      */
     type: Scalars['String']['output'];
@@ -10161,8 +10453,9 @@ declare enum MetafieldCustomerAccountAccess {
     ReadWrite = "READ_WRITE"
 }
 /**
- * Metafield definitions enable you to define additional validation constraints for metafields, and enable the
- * merchant to edit metafield values in context.
+ * Defines the structure, validation rules, and permissions for [`Metafield`](https://shopify.dev/docs/api/admin-graphql/current/objects/Metafield) objects attached to a specific owner type. Each definition establishes a schema that metafields must follow, including the data type and validation constraints.
+ *
+ * The definition controls access permissions across different APIs, determines whether the metafield can be used for filtering or as a collection condition, and can be constrained to specific resource subtypes.
  */
 type MetafieldDefinition = Node & {
     __typename?: 'MetafieldDefinition';
@@ -10488,7 +10781,11 @@ declare enum MetafieldValueType {
     /** A text field. */
     String = "STRING"
 }
-/** Provides an object instance represented by a MetaobjectDefinition. */
+/**
+ * An instance of custom structured data defined by a [`MetaobjectDefinition`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MetaobjectDefinition). [Metaobjects](https://shopify.dev/docs/apps/build/custom-data#what-are-metaobjects) store reusable data that extends beyond Shopify's standard resources, such as product highlights, size charts, or custom content sections.
+ *
+ * Each metaobject includes fields that match the field types and validation rules specified in its definition, which also determines the metaobject's capabilities, such as storefront visibility, publishing and translation support. [`Metafields`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metafield) can reference metaobjects to connect custom data with [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) objects, [`Collection`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection) objects, and other Shopify resources.
+ */
 type Metaobject = Node & {
     __typename?: 'Metaobject';
     /** Metaobject capabilities for this Metaobject. */
@@ -10646,7 +10943,11 @@ type MetaobjectConnection = {
     /** An object that’s used to retrieve [cursor information](https://shopify.dev/api/usage/pagination-graphql) about the current page. */
     pageInfo: PageInfo;
 };
-/** Provides the definition of a generic object structure composed of metafields. */
+/**
+ * Defines the structure and configuration for a custom data type in Shopify. Each definition specifies the fields, validation rules, and capabilities that apply to all [`Metaobject`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metaobject) entries created from it.
+ *
+ * The definition includes field definitions that determine what data to store, access controls for [the Shopify admin](https://shopify.dev/docs/apps/build/custom-data/permissions#admin-permissions) and [Storefront](https://shopify.dev/docs/apps/build/custom-data/permissions#storefront-permissions) APIs, and capabilities such as publishability and translatability. You can track which [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) or [`StaffMember`](https://shopify.dev/docs/api/admin-graphql/latest/objects/StaffMember) created the definition and optionally base it on a [`StandardMetaobjectDefinitionTemplate`](https://shopify.dev/docs/api/admin-graphql/latest/objects/StandardMetaobjectDefinitionTemplate).
+ */
 type MetaobjectDefinition = Node & {
     __typename?: 'MetaobjectDefinition';
     /** Access configuration for the metaobject definition. */
@@ -10810,10 +11111,7 @@ type Model3dSource = {
     /** The 3d model source's URL. */
     url: Scalars['String']['output'];
 };
-/**
- * A collection of monetary values in their respective currencies. Typically used in the context of multi-currency pricing and transactions,
- * when an amount in the shop's currency is converted to the customer's currency of choice (the presentment currency).
- */
+/** A collection of monetary values in their respective currencies. Used throughout the API for multi-currency pricing and transactions, when an amount in the shop's currency is converted to the customer's currency of choice. The `presentmentMoney` field contains the amount in the customer's selected currency. The `shopMoney` field contains the equivalent in the shop's base currency. */
 type MoneyBag = {
     __typename?: 'MoneyBag';
     /** Amount in presentment currency. */
@@ -10821,7 +11119,7 @@ type MoneyBag = {
     /** Amount in shop currency. */
     shopMoney: MoneyV2;
 };
-/** A precise monetary value and its associated currency. For example, 12.99 USD. */
+/** 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';
     /**
@@ -11562,7 +11860,11 @@ type OrderAdjustmentEdge = {
     /** The item at the end of OrderAdjustmentEdge. */
     node: OrderAdjustment;
 };
-/** The [application](https://shopify.dev/apps) that created the order. */
+/**
+ * Identifies the [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) that created an order. Common sources include "online store" for web purchases, "Point of Sale" for in-person sales, or custom app names for orders created through third-party integrations.
+ *
+ * Use this information to track order attribution, analyze sales channels, and route orders to appropriate fulfillment workflows based on their source.
+ */
 type OrderApp = {
     __typename?: 'OrderApp';
     /** The application icon. */
@@ -12010,7 +12312,11 @@ declare enum OrderTransactionStatus {
     /** The transaction status is unknown. */
     Unknown = "UNKNOWN"
 }
-/** A page on the Online Store. */
+/**
+ * A standalone content page in the online store. Pages display HTML-formatted content for informational pages like "About Us", contact information, or shipping policies.
+ *
+ * Each page has a unique handle for URL routing and supports custom template suffixes for specialized layouts. Pages can be published or hidden, and include creation and update timestamps.
+ */
 type Page = HasEvents & HasMetafieldDefinitions & HasMetafields & HasPublishedTranslations & Navigable & Node & {
     __typename?: 'Page';
     /** The text content of the page, complete with HTML markup. */
@@ -12197,7 +12503,13 @@ type PaymentSettings = {
     /** List of the digital wallets which the shop supports. */
     supportedDigitalWallets: Array<DigitalWallet>;
 };
-/** Represents the payment terms for an order or draft order. */
+/**
+ * Payment conditions for an [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) or [`DraftOrder`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder), including when payment is due and how it's scheduled. Payment terms are created from templates that specify net terms (payment due after a certain number of days) or fixed schedules with specific due dates. You can optionally provide custom payment schedules using [`PaymentScheduleInput`](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/PaymentScheduleInput).
+ *
+ * Each payment term contains one or more [`PaymentSchedule`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentSchedule), which you can access through the [`paymentSchedules`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentTerms#field-PaymentTerms.fields.paymentSchedules) field. Payment schedules contain detailed information for each payment installment.
+ *
+ * Learn more about [payment terms](https://shopify.dev/docs/apps/build/checkout/payments/payment-terms).
+ */
 type PaymentTerms = Node & {
     __typename?: 'PaymentTerms';
     /** The draft order associated with the payment terms. */
@@ -12761,7 +13073,7 @@ type Product = HasEvents & HasMetafieldDefinitions & HasMetafields & HasPublishe
     updatedAt: Scalars['DateTime']['output'];
     /**
      * A list of [variants](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) associated with the product.
-     * If querying a single product at the root, you can fetch up to 2000 variants.
+     * If querying a single product at the root, you can fetch up to 2048 variants.
      */
     variants: ProductVariantConnection;
     /**
@@ -12859,7 +13171,7 @@ type ProductBundleComponentQuantityOptionValue = {
     /** The quantity of the option value. */
     quantity: Scalars['Int']['output'];
 };
-/** The details of a specific product category within the [Shopify product taxonomy](https://shopify.github.io/product-taxonomy/releases/unstable/?categoryId=sg-4-17-2-17). */
+/** The details of a specific product category within Shopify's [standardized product taxonomy](https://shopify.github.io/product-taxonomy/releases/unstable/?categoryId=sg-4-17-2-17). Provides access to the associated [`ProductTaxonomyNode`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductTaxonomyNode). */
 type ProductCategory = {
     __typename?: 'ProductCategory';
     /** The product taxonomy node associated with the product category. */
@@ -12883,12 +13195,7 @@ type ProductConnection = {
     /** An object that’s used to retrieve [cursor information](https://shopify.dev/api/usage/pagination-graphql) about the current page. */
     pageInfo: PageInfo;
 };
-/**
- * The price of a product in a specific country.
- * Prices vary between countries.
- * Refer to [Product](https://shopify.dev/docs/api/admin-graphql/latest/queries/product?example=Get+the+price+range+for+a+product+for+buyers+from+Canada)
- * for more information on how to use this object.
- */
+/** The price of a [product](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) in a specific country. Shows the minimum and maximum variant prices through the price range and the count of fixed quantity rules that apply to the product's variants in the given pricing context. */
 type ProductContextualPricing = {
     __typename?: 'ProductContextualPricing';
     /** The number of fixed quantity rules for the product's variants on the price list. */
@@ -12913,9 +13220,9 @@ type ProductEdge = {
     node: Product;
 };
 /**
- * The product property names. For example, "Size", "Color", and "Material".
- * Variants are selected based on permutations of these options.
- * The limit for each product property name is 255 characters.
+ * A product attribute that customers can choose from, such as "Size", "Color", or "Material". [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) objects use options to define the different variations available for purchase. Each option has a name and a set of possible values that combine to create [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) objects.
+ *
+ * The option includes its display position, associated values, and optional [`LinkedMetafield`](https://shopify.dev/docs/api/admin-graphql/latest/objects/LinkedMetafield) for structured data. Options support translations for international selling and track which [`ProductOptionValue`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductOptionValue) objects that variants actively use versus unused values that exist without associated variants.
  */
 type ProductOption = HasPublishedTranslations & Node & {
     __typename?: 'ProductOption';
@@ -12934,7 +13241,11 @@ type ProductOption = HasPublishedTranslations & Node & {
     /** The corresponding value to the product option name. */
     values: Array<Scalars['String']['output']>;
 };
-/** The product option value names. For example, "Red", "Blue", and "Green" for a "Color" option. */
+/**
+ * A specific value for a [`ProductOption`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductOption), such as "Red" or "Blue" for a "Color" option. Each value can be assigned to [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) objects to create different versions of a [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product).
+ *
+ * The value tracks whether any variants currently use it through the [`hasVariants`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductOptionValue#field-hasVariants) field. Values can include visual representations through swatches that display colors or images. When linked to a [`Metafield`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metafield), the [`linkedMetafieldValue`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductOptionValue#field-linkedMetafieldValue) provides additional structured data for the option value.
+ */
 type ProductOptionValue = HasPublishedTranslations & Node & {
     __typename?: 'ProductOptionValue';
     /** Whether the product option value has any linked variants. */
@@ -13078,7 +13389,10 @@ type ProductVariant = HasEvents & HasMetafieldDefinitions & HasMetafields & HasP
     events: EventConnection;
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
-    /** The featured image for the variant. */
+    /**
+     * The featured image for the variant.
+     * @deprecated Use `media` instead.
+     */
     image?: Maybe<Image>;
     /** The inventory item, which is used to query for inventory information. */
     inventoryItem: InventoryItem;
@@ -13334,7 +13648,13 @@ declare enum ProductVariantsBulkUpdateUserErrorCode {
     /** The variant already exists. */
     VariantAlreadyExists = "VARIANT_ALREADY_EXISTS"
 }
-/** A publication is a group of products and collections that is published to an app. */
+/**
+ * A group of [products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) and [collections](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection) that are published to an app.
+ *
+ * Each publication manages which products and collections display on its associated [`Channel`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Channel). Merchants can automatically publish products when they're created if [`autoPublish`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication#field-Publication.fields.autoPublish) is enabled, or manually control publication through publication records.
+ *
+ * Publications support scheduled publishing through future publish dates for online store channels, allowing merchants to coordinate product launches and promotional campaigns. The [`catalog`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication#field-Publication.fields.catalog) field links to pricing and availability rules specific to that publication's context.
+ */
 type Publication = Node & {
     __typename?: 'Publication';
     /**
@@ -13346,7 +13666,7 @@ type Publication = Node & {
     autoPublish: Scalars['Boolean']['output'];
     /** The catalog associated with the publication. */
     catalog?: Maybe<Catalog>;
-    /** The collection publications for the list of collections published to the publication. */
+    /** The list of collection publication records, each representing the publication status and details for a collection published to this publication (typically channel). */
     collectionPublicationsV3: ResourcePublicationConnection;
     /** The list of collections published to the publication. */
     collections: CollectionConnection;
@@ -14551,7 +14871,11 @@ type SearchResultEdge = {
     /** The item at the end of SearchResultEdge. */
     node: SearchResult;
 };
-/** A dynamic collection of customers based on specific criteria. */
+/**
+ * A group of [customers](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) that meet specific criteria defined through [ShopifyQL query](https://shopify.dev/docs/api/shopifyql/segment-query-language-reference) conditions. Common use cases for segments include customer analytics, targeted marketing campaigns, and automated discount eligibility.
+ *
+ * The segment's [`query`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Segment#field-query) field contains ShopifyQL conditions that determine membership, such as purchase history, location, or engagement patterns. Tracks when the segment was created with [`creationDate`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Segment#field-creationDate) and when it was last modified with [`lastEditDate`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Segment#field-lastEditDate).
+ */
 type Segment = Node & {
     __typename?: 'Segment';
     /** The date and time when the segment was added to the store. */
@@ -14579,12 +14903,14 @@ type SelectedOption = {
     value: Scalars['String']['output'];
 };
 /**
- * Represents how a product can be sold and purchased. Selling plans and associated records (selling plan groups
- * and policies) are deleted 48 hours after a merchant uninstalls their subscriptions app. We recommend backing
- * up these records if you need to restore them later.
+ * How a product can be sold and purchased through recurring billing or deferred purchase options. Defines the specific terms for subscriptions, pre-orders, or try-before-you-buy offers, including when to bill customers, when to fulfill orders, and what pricing adjustments to apply.
+ *
+ * Each selling plan has billing, delivery, and pricing policies that control the purchase experience. The plan's [`options`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlan#field-SellingPlan.fields.options) and [`category`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlan#field-SellingPlan.fields.category) help merchants organize and report on different selling strategies. Plans are grouped within a [`SellingPlanGroup`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanGroup) that associates them with [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) and [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) objects.
  *
- * For more information on selling plans, refer to
- * [*Creating and managing selling plans*](https://shopify.dev/docs/apps/selling-strategies/subscriptions/selling-plans).
+ * > Caution:
+ * > Selling plans and associated records are automatically deleted 48 hours after a merchant uninstalls the [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) that created them. Back up these records if you need to restore them later.
+ *
+ * Learn more about [selling plans](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/selling-plans/build-a-selling-plan).
  */
 type SellingPlan = HasMetafieldDefinitions & HasMetafields & HasPublishedTranslations & Node & {
     __typename?: 'SellingPlan';
@@ -14835,9 +15161,12 @@ declare enum SellingPlanFulfillmentTrigger {
     Unknown = "UNKNOWN"
 }
 /**
- * Represents a selling method (for example, "Subscribe and save" or "Pre-paid"). Selling plan groups
- * and associated records (selling plans and policies) are deleted 48 hours after a merchant
- * uninstalls their subscriptions app. We recommend backing up these records if you need to restore them later.
+ * A selling method that defines how products can be sold through purchase options like subscriptions, pre-orders, or try-before-you-buy. Groups one or more [`SellingPlan`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlan) objects that share the same selling method and options.
+ *
+ * The group provides buyer-facing labels and merchant-facing descriptions for the selling method. Associates [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) and [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) objects with selling plan groups to offer them through these purchase options.
+ *
+ * > Caution:
+ * > Selling plan groups and their associated records are automatically deleted 48 hours after a merchant uninstalls the [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) that created them. Back up these records if you need to restore them later.
  */
 type SellingPlanGroup = HasPublishedTranslations & Node & {
     __typename?: 'SellingPlanGroup';
@@ -15185,7 +15514,10 @@ type Shop = HasMetafields & HasPublishedTranslations & Node & {
     assignedFulfillmentOrders: FulfillmentOrderConnection;
     /** The list of sales channels not currently installed on the shop. */
     availableChannelApps: AppConnection;
-    /** The shop's billing address information. */
+    /**
+     * The shop's billing address information.
+     * @deprecated Use `shopAddress` instead.
+     */
     billingAddress: ShopAddress;
     /** List of all channel definitions associated with a shop. */
     channelDefinitionsForInstalledChannels: Array<AvailableChannelDefinitionsByChannel>;
@@ -15238,7 +15570,7 @@ type Shop = HasMetafields & HasPublishedTranslations & Node & {
     draftOrderTags: StringConnection;
     /**
      * List of saved draft orders on the shop.
-     * @deprecated Use `QueryRoot.draftOrders` instead.
+     * @deprecated Removed as of 2026-01. Use `QueryRoot.draftOrders` instead.
      */
     draftOrders: DraftOrderConnection;
     /**
@@ -15711,10 +16043,9 @@ type ShopifyFunction = {
     useCreationUi: Scalars['Boolean']['output'];
 };
 /**
- * Balance and payout information for a
- * [Shopify Payments](https://help.shopify.com/manual/payments/shopify-payments/getting-paid-with-shopify-payments)
- * account. Balance includes all balances for the currencies supported by the shop.
- * You can also query for a list of payouts, where each payout includes the corresponding currencyCode field.
+ * Financial account information for merchants using Shopify Payments. Tracks current balances across all supported currencies, payout schedules, and [`ShopifyPaymentsBalanceTransaction`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsBalanceTransaction) records.
+ *
+ * The account includes configuration details such as [`ShopifyPaymentsBankAccount`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsBankAccount) objects for receiving [`ShopifyPaymentsPayout`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsPayout) transfers, statement descriptors that appear on customer credit card statements, and the [`ShopifyPaymentsPayoutSchedule`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsPayoutSchedule) that determines when funds transfer to your bank. Access balance transactions to review individual charges, refunds, and adjustments that affect your account balance. Query payouts to track money movement between your Shopify Payments balance and bank accounts.
  */
 type ShopifyPaymentsAccount = Node & {
     __typename?: 'ShopifyPaymentsAccount';
@@ -15786,7 +16117,7 @@ type ShopifyPaymentsAssociatedOrder = {
     /** The name of the associated order. */
     name: Scalars['String']['output'];
 };
-/** A transaction that contributes to a Shopify Payments account balance. */
+/** A transaction that contributes to a Shopify Payments account balance. Records money movement from charges, refunds, payouts, adjustments, or other payment activities. Includes the gross amount, processing fees, and resulting net amount that affects the account balance. Links to the source of the transaction and associated [`ShopifyPaymentsPayout`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsPayout) details, with optional references to [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) objects or adjustment reasons when applicable. */
 type ShopifyPaymentsBalanceTransaction = Node & {
     __typename?: 'ShopifyPaymentsBalanceTransaction';
     /**
@@ -16023,8 +16354,9 @@ type ShopifyPaymentsExtendedAuthorization = {
     standardAuthorizationExpiresAt: Scalars['DateTime']['output'];
 };
 /**
- * Payouts represent the movement of money between a merchant's Shopify
- * Payments balance and their bank account.
+ * A transfer of funds between a merchant's Shopify Payments balance and their [`ShopifyPaymentsBankAccount`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsBankAccount). Provides the [net amount](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsPayout#field-ShopifyPaymentsPayout.fields.net), [issue date](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsPayout#field-ShopifyPaymentsPayout.fields.issuedAt), and current [`ShopifyPaymentsPayoutStatus`](https://shopify.dev/docs/api/admin-graphql/latest/enums/ShopifyPaymentsPayoutStatus).
+ *
+ * The payout includes a [`ShopifyPaymentsPayoutSummary`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsPayoutSummary) that breaks down fees and gross amounts by transaction type, such as charges, refunds, and adjustments. The [`ShopifyPaymentsPayoutTransactionType`](https://shopify.dev/docs/api/admin-graphql/latest/enums/ShopifyPaymentsPayoutTransactionType) indicates whether funds move into the bank account (deposit) or back to Shopify Payments (withdrawal).
  */
 type ShopifyPaymentsPayout = LegacyInteroperability & Node & {
     __typename?: 'ShopifyPaymentsPayout';
@@ -16198,12 +16530,28 @@ type ShopifyPaymentsTransactionSet = {
 };
 /** The possible types of transactions. */
 declare enum ShopifyPaymentsTransactionType {
+    /** The ach_bank_failure_debit_fee transaction type. */
+    AchBankFailureDebitFee = "ACH_BANK_FAILURE_DEBIT_FEE",
+    /** The ach_bank_failure_debit_reversal_fee transaction type. */
+    AchBankFailureDebitReversalFee = "ACH_BANK_FAILURE_DEBIT_REVERSAL_FEE",
     /** The adjustment transaction type. */
     Adjustment = "ADJUSTMENT",
+    /** The ads_publisher_credit transaction type. */
+    AdsPublisherCredit = "ADS_PUBLISHER_CREDIT",
+    /** The ads_publisher_credit_reversal transaction type. */
+    AdsPublisherCreditReversal = "ADS_PUBLISHER_CREDIT_REVERSAL",
     /** The advance transaction type. */
     Advance = "ADVANCE",
     /** The advance funding transaction type. */
     AdvanceFunding = "ADVANCE_FUNDING",
+    /** The agentic_fee_tax_credit transaction type. */
+    AgenticFeeTaxCredit = "AGENTIC_FEE_TAX_CREDIT",
+    /** The agentic_fee_tax_credit_reversal transaction type. */
+    AgenticFeeTaxCreditReversal = "AGENTIC_FEE_TAX_CREDIT_REVERSAL",
+    /** The agentic_fee_tax_debit transaction type. */
+    AgenticFeeTaxDebit = "AGENTIC_FEE_TAX_DEBIT",
+    /** The agentic_fee_tax_debit_reversal transaction type. */
+    AgenticFeeTaxDebitReversal = "AGENTIC_FEE_TAX_DEBIT_REVERSAL",
     /** The anomaly_credit transaction type. */
     AnomalyCredit = "ANOMALY_CREDIT",
     /** The anomaly_credit_reversal transaction type. */
@@ -16320,6 +16668,10 @@ declare enum ShopifyPaymentsTransactionType {
     PromotionCredit = "PROMOTION_CREDIT",
     /** The promotion_credit_reversal transaction type. */
     PromotionCreditReversal = "PROMOTION_CREDIT_REVERSAL",
+    /** The referral_fee transaction type. */
+    ReferralFee = "REFERRAL_FEE",
+    /** The referral_fee_tax transaction type. */
+    ReferralFeeTax = "REFERRAL_FEE_TAX",
     /** The refund transaction type. */
     Refund = "REFUND",
     /** The refund_adjustment transaction type. */
@@ -16453,7 +16805,11 @@ declare enum ShopifyProtectStatus {
     /** The order received a fraudulent chargeback and it was protected. */
     Protected = "PROTECTED"
 }
-/** Represents the data about a staff member's Shopify account. Merchants can use staff member data to get more information about the staff members in their store. */
+/**
+ * A user account that can access the Shopify admin to manage store operations. Includes personal information and account status.
+ *
+ * You can assign staff members to [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation) objects for [B2B operations](https://shopify.dev/docs/apps/build/b2b), limiting their actions to those locations.
+ */
 type StaffMember = Node & {
     __typename?: 'StaffMember';
     /** The type of account the staff member has. */
@@ -16754,13 +17110,11 @@ declare enum StoreCreditSystemEvent {
     TaxFinalization = "TAX_FINALIZATION"
 }
 /**
- * A token that's used to delegate unauthenticated access scopes to clients that need to access
- * the unauthenticated [Storefront API](https://shopify.dev/docs/api/storefront).
+ * A token that delegates unauthenticated access scopes to clients that need to access the [Storefront API](https://shopify.dev/docs/api/storefront). Storefront access tokens enable headless storefronts and custom applications to interact with a store on behalf of customers without requiring authentication.
  *
- * An app can have a maximum of 100 active storefront access
- * tokens for each shop.
+ * The token provides specific permissions, such as reading [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) data, managing carts, or creating [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) accounts. An app can have a maximum of 100 active storefront access tokens for each [`Shop`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Shop).
  *
- * [Get started with the Storefront API](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/getting-started).
+ * Learn more about [building with the Storefront API](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/getting-started).
  */
 type StorefrontAccessToken = Node & {
     __typename?: 'StorefrontAccessToken';
@@ -16824,9 +17178,9 @@ type SubscriptionAppliedCodeDiscount = {
     rejectionReason?: Maybe<SubscriptionDiscountRejectionReason>;
 };
 /**
- * A record of an execution of the subscription billing process. Billing attempts use
- * idempotency keys to avoid duplicate order creation. A successful billing attempt
- * will create an order.
+ * A record of an execution of the subscription billing process. Billing attempts use idempotency keys to avoid duplicate order creation.
+ *
+ * When a billing attempt completes successfully, it creates an [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order). The attempt includes associated payment transactions and any errors that occur during billing. If 3D Secure authentication is required, the `nextActionUrl` field provides the redirect URL for customer verification.
  */
 type SubscriptionBillingAttempt = Node & {
     __typename?: 'SubscriptionBillingAttempt';
@@ -16970,7 +17324,13 @@ type SubscriptionBillingPolicy = {
     /** Minimum amount of cycles required in the subscription. */
     minCycles?: Maybe<Scalars['Int']['output']>;
 };
-/** Represents a Subscription Contract. */
+/**
+ * A subscription contract that defines recurring purchases for a customer. Each contract specifies what products to deliver, when to bill and ship them, and at what price.
+ *
+ * The contract includes [`SubscriptionBillingPolicy`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingPolicy) and [`SubscriptionDeliveryPolicy`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionDeliveryPolicy) that control the frequency of charges and fulfillments. [`SubscriptionLine`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionLine) items define the products, quantities, and pricing for each recurring [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order). The contract tracks [`SubscriptionBillingAttempt`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingAttempt) records, payment status, and generated orders throughout its lifecycle. [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) instances manage contracts through various status transitions including active, paused, failed, cancelled, or expired states.
+ *
+ * Learn more about [building subscription contracts](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/build-a-subscription-contract) and [updating subscription contracts](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/update-a-subscription-contract).
+ */
 type SubscriptionContract = Node & SubscriptionContractBase & {
     __typename?: 'SubscriptionContract';
     /** The subscription app that the subscription contract is registered to. */
@@ -17278,7 +17638,13 @@ declare enum SubscriptionDiscountRejectionReason {
 }
 /** The value of the discount and how it will be applied. */
 type SubscriptionDiscountValue = SubscriptionDiscountFixedAmountValue | SubscriptionDiscountPercentageValue;
-/** Represents a Subscription Line. */
+/**
+ * A product line item within a [`SubscriptionContract`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionContract). Each line represents a specific product variant that the customer subscribes to, including its quantity, pricing, and whether shipping is required.
+ *
+ * The line maintains references to the [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant), [`SellingPlan`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlan), and custom [`Attribute`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Attribute) objects. It tracks the current price and any scheduled price changes through its [`pricingPolicy`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionPricingPolicy). You can modify lines through [`SubscriptionDraft`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionDraft) objects without affecting the original contract until you commit changes.
+ *
+ * Learn more about [subscription contracts](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts) and [selling plans](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/selling-plans).
+ */
 type SubscriptionLine = {
     __typename?: 'SubscriptionLine';
     /** The origin contract of the line if it was concatenated from another contract. */
@@ -17478,7 +17844,13 @@ declare enum SuggestedOrderTransactionKind {
     /** A suggested refund transaction for an order. */
     SuggestedRefund = "SUGGESTED_REFUND"
 }
-/** Represents a refund suggested by Shopify based on the items being reimbursed. You can then use the suggested refund object to generate an actual refund. */
+/**
+ * A refund amount that Shopify suggests based on the items, duties, and shipping costs that customers return. Provides a breakdown of all monetary values including subtotals, taxes, discounts, and the maximum refundable amount.
+ *
+ * The suggested refund includes [`RefundLineItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/RefundLineItem) objects to refund with their quantities and restock instructions, [`RefundDuty`](https://shopify.dev/docs/api/admin-graphql/latest/objects/RefundDuty) objects for duty reimbursements, and [`ShippingRefund`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShippingRefund) for shipping cost refunds. Provides [`SuggestedOrderTransaction`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SuggestedOrderTransaction) objects and the [`SuggestedRefundMethod`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/SuggestedRefundMethod) interface to process the refund through the appropriate gateways.
+ *
+ * Learn more about [previewing and refunding duties](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/view-and-refund-duties#step-3-preview-a-refund-that-includes-duties).
+ */
 type SuggestedRefund = {
     __typename?: 'SuggestedRefund';
     /**
@@ -17722,7 +18094,11 @@ type TaxonomyAttribute = Node & {
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
 };
-/** The details of a specific product category within the [Shopify product taxonomy](https://shopify.github.io/product-taxonomy/releases/unstable/?categoryId=sg-4-17-2-17). */
+/**
+ * A product category within Shopify's [standardized product taxonomy](https://shopify.github.io/product-taxonomy/releases/unstable/?categoryId=sg-4-17-2-17). Provides hierarchical organization through parent-child relationships, with each category tracking its ancestors, children, and level in the taxonomy tree.
+ *
+ * Categories include attributes specific to their product type and navigation properties like whether they're root, leaf, or archived categories. The taxonomy enables consistent product classification across Shopify and integrated marketplaces.
+ */
 type TaxonomyCategory = Node & {
     __typename?: 'TaxonomyCategory';
     /** The IDs of the category's ancestor categories. */
@@ -17834,7 +18210,13 @@ type TransactionFee = Node & {
     /** Name of the type of fee. */
     type: Scalars['String']['output'];
 };
-/** Translation of a field of a resource. */
+/**
+ * A localized version of a field on a resource. Translations enable merchants to provide content in multiple languages for [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) objects, [`Collection`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection) objects, and other store resources.
+ *
+ * Each translation specifies the locale, the field being translated (identified by its key), and the translated value. Translations can be market-specific, allowing different content for the same language across different markets, or available globally when no [`Market`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Market) is specified. The `outdated` flag indicates whether the original content has changed since this translation was last updated.
+ *
+ * Learn more about [managing translated content](https://shopify.dev/docs/apps/build/markets/manage-translated-content).
+ */
 type Translation = {
     __typename?: 'Translation';
     /** On the resource that this translation belongs to, the reference to the value being translated. */
@@ -17929,7 +18311,7 @@ declare enum UnitSystem {
     /** Metric system of weights and measures. */
     MetricSystem = "METRIC_SYSTEM"
 }
-/** Represents an error in the input of a mutation. */
+/** An error in the input of a mutation. Mutations return `UserError` objects to indicate validation failures, such as invalid field values or business logic violations, that prevent the operation from completing. */
 type UserError = DisplayableError & {
     __typename?: 'UserError';
     /** The path to the input field that caused the error. */
@@ -18046,7 +18428,11 @@ type VideoSource = {
     /** The video source's width. */
     width: Scalars['Int']['output'];
 };
-/** A weight, which includes a numeric value and a unit of measurement. */
+/**
+ * A weight measurement with its numeric value and unit. Used throughout the API, for example in shipping calculations, delivery conditions, order line items, and inventory measurements.
+ *
+ * The weight combines a decimal value with a standard unit of measurement to ensure consistent weight handling across different regional systems.
+ */
 type Weight = {
     __typename?: 'Weight';
     /** The unit of measurement for `value`. */
@@ -18078,6 +18464,14 @@ type ConnectMetaObjectToProductVariantMutation = {
         userErrors: Array<Pick<ProductVariantsBulkUpdateUserError, 'field' | 'message'>>;
     }>;
 };
+type OrderPaymentDetailsByIdQueryVariables = Exact<{
+    id: Scalars['ID']['input'];
+}>;
+type OrderPaymentDetailsByIdQuery = {
+    order?: Maybe<{
+        transactions: Array<Pick<OrderTransaction, 'createdAt' | 'gateway' | 'formattedGateway' | 'kind' | 'paymentId'>>;
+    }>;
+};
 type OrdersByNameQueryVariables = Exact<{
     first: Scalars['Int']['input'];
     queryFilter: Scalars['String']['input'];
@@ -18214,6 +18608,10 @@ type ProductHandlesQuery = {
     };
 };
 interface GeneratedQueryTypes {
+    "#graphql\n  query orderPaymentDetailsById($id: ID!) {\n    order(id: $id) {\n      transactions {\n        createdAt\n        gateway\n        formattedGateway\n        kind\n        paymentId\n      }\n    }\n  }\n": {
+        return: OrderPaymentDetailsByIdQuery;
+        variables: OrderPaymentDetailsByIdQueryVariables;
+    };
     "#graphql\n  query ordersByName($first: Int!, $queryFilter: String!) {\n    orders(first: $first, query: $queryFilter) {\n      edges {\n        node {\n          id\n          name\n          createdAt\n          updatedAt\n          totalPriceSet {\n            shopMoney {\n              amount\n              currencyCode\n            }\n          }\n          customer {\n            id\n            lastName\n            defaultEmailAddress {\n              emailAddress\n            }\n            displayName\n            firstName\n          }\n          displayFinancialStatus\n          displayFulfillmentStatus\n        }\n      }\n      pageInfo {\n        hasNextPage\n        endCursor\n      }\n    }\n  }\n": {
         return: OrdersByNameQuery;
         variables: OrdersByNameQueryVariables;
@@ -18245,14 +18643,94 @@ declare module '@shopify/admin-api-client' {
     }
 }
 
-declare const GetLeanOrderByNameReturn: z.ZodNullable<z.ZodObject<any, {}, {}>>;
+declare const GetLeanOrderByNameReturn: z.ZodNullable<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    totalPrice: z.ZodObject<{
+        amount: z.ZodString;
+        currencyCode: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        amount: string;
+        currencyCode: string;
+    }, {
+        amount: string;
+        currencyCode: string;
+    }>;
+    customer: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        emailAddress: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        displayName: string;
+        emailAddress: string | null;
+    }, {
+        id: string;
+        displayName: string;
+        emailAddress: string | null;
+    }>>;
+    financialStatus: z.ZodNullable<z.ZodString>;
+    fulfillmentStatus: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    name: string;
+    customer: {
+        id: string;
+        displayName: string;
+        emailAddress: string | null;
+    } | null;
+    totalPrice: {
+        amount: string;
+        currencyCode: string;
+    };
+    fulfillmentStatus: string | null;
+    financialStatus: string | null;
+}, {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    name: string;
+    customer: {
+        id: string;
+        displayName: string;
+        emailAddress: string | null;
+    } | null;
+    totalPrice: {
+        amount: string;
+        currencyCode: string;
+    };
+    fulfillmentStatus: string | null;
+    financialStatus: string | null;
+}>>;
 type GetLeanOrderByNameReturnType = z.infer<typeof GetLeanOrderByNameReturn>;
 type GetFullOrderByNameReturnType = NonNullable<NonNullable<OrdersByNameFullQuery['orders']>['edges'][number]['node']> | null;
 declare function getOrderByName(orderName: string, detailLevel: 'lean'): Promise<GetLeanOrderByNameReturnType>;
 declare function getOrderByName(orderName: string, detailLevel: 'full'): Promise<GetFullOrderByNameReturnType>;
 declare function getOrderByName(orderName: string): Promise<GetLeanOrderByNameReturnType>;
 
-declare const GetLeanProductVariantsReturn: z.ZodArray<z.ZodObject<any, {}, {}>>;
+declare const GetLeanProductVariantsReturn: z.ZodArray<z.ZodObject<{
+    productId: z.ZodString;
+    productTitle: z.ZodString;
+    variantId: z.ZodString;
+    variantTitle: z.ZodString;
+    sku: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    productId: string;
+    variantId: string;
+    sku: string;
+    variantTitle: string;
+    productTitle: string;
+}, {
+    productId: string;
+    variantId: string;
+    sku: string;
+    variantTitle: string;
+    productTitle: string;
+}>, "many">;
 type GetLeanProductVariantsReturnType = z.infer<typeof GetLeanProductVariantsReturn>;
 /**
  * Retrieves a lean list of product variants from Shopify, optionally filtered by SKUs.
@@ -18265,4 +18743,74 @@ type GetLeanProductVariantsReturnType = z.infer<typeof GetLeanProductVariantsRet
  */
 declare function getLeanProductVariants(skus?: string[]): Promise<GetLeanProductVariantsReturnType>;
 
-export { getLeanProductVariants, getOrderByName };
+declare const GetOrderPaymentDetailsByNameReturn: z.ZodObject<{
+    order: z.ZodObject<{
+        transactions: z.ZodArray<z.ZodObject<{
+            createdAt: z.ZodString;
+            gateway: z.ZodString;
+            formattedGateway: z.ZodString;
+            kind: z.ZodString;
+            paymentId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            createdAt: string;
+            gateway: string;
+            formattedGateway: string;
+            kind: string;
+            paymentId: string;
+        }, {
+            createdAt: string;
+            gateway: string;
+            formattedGateway: string;
+            kind: string;
+            paymentId: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        transactions: {
+            createdAt: string;
+            gateway: string;
+            formattedGateway: string;
+            kind: string;
+            paymentId: string;
+        }[];
+    }, {
+        transactions: {
+            createdAt: string;
+            gateway: string;
+            formattedGateway: string;
+            kind: string;
+            paymentId: string;
+        }[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    order: {
+        transactions: {
+            createdAt: string;
+            gateway: string;
+            formattedGateway: string;
+            kind: string;
+            paymentId: string;
+        }[];
+    };
+}, {
+    order: {
+        transactions: {
+            createdAt: string;
+            gateway: string;
+            formattedGateway: string;
+            kind: string;
+            paymentId: string;
+        }[];
+    };
+}>;
+type GetOrderPaymentDetailsByNameReturnType = z.infer<typeof GetOrderPaymentDetailsByNameReturn>;
+/**
+ * Retrieves a single order from Shopify by its order name (e.g., "B12345").
+ * Returns null if no order is found with the specified name.
+ *
+ * @param {bigint} id - The numerical Shopify order id for (e.g., "12345678").
+ * @returns {Promise<GetOrderPaymentDetailsByNameReturnType>} A promise that resolves to the order data or null if not found.
+ * @throws {Error} If the GraphQL query fails or if the response structure is invalid.
+ */
+declare function getOrderPaymentDetailsById(id: bigint): Promise<GetOrderPaymentDetailsByNameReturnType>;
+
+export { getLeanProductVariants, getOrderByName, getOrderPaymentDetailsById };