@ehrenkind/shopify-lib 0.4.0 → 0.5.0

package/dist/index.d.cts

@@ -1,7 +1,146 @@
 import z from 'zod';
 
-declare const DeleteCustomerByIdReturn: z.ZodNullable<z.ZodString>;
-declare function deleteCustomerById(customerId: string): Promise<z.infer<typeof DeleteCustomerByIdReturn>>;
+/**
+ * Deletes a customer from Shopify by their ID.
+ * @param customerId - The customer ID (GID string, e.g., "gid://shopify/Customer/123")
+ * @returns The deleted customer ID, or null if not found
+ * @throws ShopifyUserError if Shopify returns user errors
+ */
+declare function deleteCustomerById(customerId: string): Promise<string | undefined>;
+
+/**
+ * Deletes files from Shopify by their IDs.
+ * @param fileIds - Array of file IDs to delete (e.g., "gid://shopify/MediaImage/123")
+ * @returns Array of successfully deleted file IDs
+ * @throws ShopifyUserError if Shopify returns user errors
+ */
+declare function deleteFilesByIds(fileIds: string[]): Promise<string[]>;
+
+/**
+ * Creates a file in Shopify from an external URL.
+ *
+ * @param url - The HTTPS URL of the file to upload (must be publicly accessible)
+ * @param altText - Alt text description for accessibility
+ * @param filename - The filename to use in Shopify
+ * @returns Promise resolving to the created file ID
+ * @throws {Error} When the URL doesn't start with https://
+ * @throws {ShopifyUserError} When the mutation fails
+ *
+ * @example
+ * const fileId = await createFile(
+ *   'https://example.com/image.png',
+ *   'Product image',
+ *   'product-image.png'
+ * )
+ */
+declare function createFile(url: string, altText: string, filename: string): Promise<string>;
+
+type MetaobjectFieldDefinition$1 = {
+    key: string;
+    name?: string;
+    type: string;
+    description?: string;
+    required?: boolean;
+};
+type CreateMetaobjectDefinitionInput = {
+    type: string;
+    name?: string;
+    description?: string;
+    displayNameKey?: string;
+    fieldDefinitions: MetaobjectFieldDefinition$1[];
+};
+type CreateMetaobjectDefinitionResult = {
+    id: string;
+    name: string;
+    type: string;
+};
+/**
+ * Creates a metaobject definition in Shopify.
+ *
+ * @param input - The metaobject definition input
+ * @returns Promise resolving to the created metaobject definition
+ * @throws {ShopifyUserError} When the mutation fails
+ * @throws {Error} When GraphQL errors occur
+ *
+ * @example
+ * await createMetaobjectDefinition({
+ *   type: 'my_custom_type',
+ *   name: 'My Custom Type',
+ *   description: 'A custom metaobject definition',
+ *   fieldDefinitions: [
+ *     { key: 'title', name: 'Title', type: 'single_line_text_field' },
+ *     { key: 'description', name: 'Description', type: 'multi_line_text_field' },
+ *   ],
+ * })
+ */
+declare function createMetaobjectDefinition(input: CreateMetaobjectDefinitionInput): Promise<CreateMetaobjectDefinitionResult>;
+
+type FulfillmentLineItem$1 = {
+    id: number | bigint | string;
+    quantity: number;
+};
+type CreateFulfillmentResult = {
+    id: string;
+    status: string;
+    trackingInfo: {
+        company: string | null;
+        number: string | null;
+    }[];
+};
+/**
+ * Creates a fulfillment for a fulfillment order with optional tracking info.
+ *
+ * @param fulfillmentOrderId - The fulfillment order ID (numeric, bigint, or GID string)
+ * @param fulfillmentOrderLineItems - Line items to fulfill with their quantities
+ * @param options - Optional tracking and notification settings
+ * @returns Promise resolving to the created fulfillment
+ * @throws {ShopifyUserError} When the mutation fails
+ * @throws {Error} When GraphQL errors occur
+ *
+ * @example
+ * // Fulfill specific line items without tracking
+ * await createFulfillment(123456789, [{ id: 111, quantity: 2 }])
+ *
+ * // Fulfill all items without tracking
+ * await createFulfillment(123456789, [])
+ *
+ * // Fulfill with tracking info
+ * await createFulfillment(
+ *   123456789,
+ *   [{ id: 111, quantity: 2 }],
+ *   { trackingNumber: 'TRACK123', carrier: 'DHL', notifyCustomer: true }
+ * )
+ */
+declare function createFulfillment(fulfillmentOrderId: number | bigint | string, fulfillmentOrderLineItems: FulfillmentLineItem$1[], options?: {
+    trackingNumber?: string;
+    carrier?: string;
+    trackingUrl?: string;
+    notifyCustomer?: boolean;
+}): Promise<CreateFulfillmentResult>;
+
+type UpdateFulfillmentTrackingResult = {
+    trackingNumbers: string[];
+    trackingCompany: string | null;
+};
+/**
+ * Adds a tracking number to an existing fulfillment.
+ * Fetches existing tracking info and appends the new tracking number.
+ *
+ * @param fulfillmentId - The fulfillment ID (numeric, bigint, or GID string)
+ * @param trackingNumber - The new tracking number to add
+ * @param notifyCustomer - Whether to notify the customer (default: false)
+ * @returns Promise resolving to the updated tracking info
+ * @throws {ShopifyUserError} When the mutation fails
+ * @throws {Error} When fulfillment not found or GraphQL errors occur
+ *
+ * @example
+ * // Add tracking to fulfillment, don't notify customer yet
+ * await updateFulfillmentTracking(123456789, 'TRACK123')
+ *
+ * // Add tracking and notify customer (e.g., last item in order)
+ * await updateFulfillmentTracking(123456789, 'TRACK456', true)
+ */
+declare function updateFulfillmentTracking(fulfillmentId: number | bigint | string, trackingNumber: string, notifyCustomer?: boolean): Promise<UpdateFulfillmentTrackingResult>;
 
 /**
  * Cancel an order in Shopify.
@@ -26,30 +165,6 @@ declare function deleteCustomerById(customerId: string): Promise<z.infer<typeof
  */
 declare function cancelOrderById(orderId: number | bigint | string): Promise<boolean>;
 
-interface ShopifyUserErrorDetail {
-    code?: string | null;
-    field?: string[] | null;
-    message?: string | null;
-}
-/**
- * Custom error class for Shopify mutation userErrors.
- * Preserves the full error array so callers can inspect specific error codes.
- *
- * @example
- * try {
- *   await cancelOrderById(orderId)
- * } catch (error) {
- *   if (error instanceof ShopifyUserError) {
- *     const alreadyCancelled = error.errors.some(e => e.code === 'ORDER_ALREADY_CANCELLED')
- *     if (alreadyCancelled) { ... }
- *   }
- * }
- */
-declare class ShopifyUserError extends Error {
-    readonly errors: ShopifyUserErrorDetail[];
-    constructor(message: string, errors: ShopifyUserErrorDetail[]);
-}
-
 type Maybe<T> = T | null;
 type InputMaybe<T> = Maybe<T>;
 type Exact<T extends {
@@ -476,7 +591,7 @@ type AppInstallation = HasMetafields & Node & {
     app: App;
     /**
      * Channel associated with the installed application.
-     * @deprecated Use `publication` instead.
+     * @deprecated Use the root-level `channels` query instead.
      */
     channel?: Maybe<Channel>;
     /** Credits that can be used towards future app purchases. */
@@ -498,7 +613,10 @@ type AppInstallation = HasMetafields & Node & {
     metafields: MetafieldConnection;
     /** One-time purchases to a shop. */
     oneTimePurchases: AppPurchaseOneTimeConnection;
-    /** The publication associated with the installed application. */
+    /**
+     * The publication associated with the installed application.
+     * @deprecated Use the root-level `publications` query instead.
+     */
     publication?: Maybe<Publication>;
     /** The records that track the externally-captured revenue for the app. The records are used for revenue attribution purposes. */
     revenueAttributionRecords: AppRevenueAttributionRecordConnection;
@@ -1279,7 +1397,7 @@ type CalculatedDraftOrderLineItem = {
      */
     uuid: Scalars['String']['output'];
     /** The product variant for the line item. */
-    variant?: Maybe<ProductVariant>;
+    variant?: Maybe<ProductVariant$1>;
     /** The name of the variant. */
     variantTitle?: Maybe<Scalars['String']['output']>;
     /** The name of the vendor who created the product variant. */
@@ -1624,6 +1742,7 @@ type Collection = HasEvents & HasMetafieldDefinitions & HasMetafields & HasPubli
      * Whether the resource is published to the app's
      * [publication](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication).
      * For example, the resource might be published to the app's online store channel.
+     * @deprecated Use `publishedOnPublication` instead.
      */
     publishedOnCurrentPublication: Scalars['Boolean']['output'];
     /**
@@ -1900,7 +2019,7 @@ type CombinedListing = {
 type CombinedListingChild = {
     __typename?: 'CombinedListingChild';
     /** The parent variant. */
-    parentVariant: ProductVariant;
+    parentVariant: ProductVariant$1;
     /** The child product. */
     product: Product;
 };
@@ -2153,7 +2272,7 @@ type CompanyContact = Node & {
     /** The date and time ([ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)) at which the company contact was created at Shopify. */
     createdAt: Scalars['DateTime']['output'];
     /** The customer associated to this contact. */
-    customer: Customer;
+    customer: Customer$1;
     /** The list of draft orders for the company contact. */
     draftOrders: DraftOrderConnection;
     /** A globally-unique ID. */
@@ -2965,6 +3084,13 @@ type CountryHarmonizedSystemCodeEdge = {
     /** The item at the end of CountryHarmonizedSystemCodeEdge. */
     node: CountryHarmonizedSystemCode;
 };
+/** The input fields required to specify a harmonized system code. */
+type CountryHarmonizedSystemCodeInput = {
+    /** The ISO 3166-1 alpha-2 country code for the country that issued the specified harmonized system code. */
+    countryCode: CountryCode;
+    /** Country specific harmonized system code. */
+    harmonizedSystemCode: Scalars['String']['input'];
+};
 /**
  * The currency codes that represent the world currencies throughout the Admin API. Currency codes include
  * [standard ISO 4217 codes](https://en.wikipedia.org/wiki/ISO_4217), legacy codes, non-standard codes,
@@ -3355,11 +3481,11 @@ type CurrencySettingEdge = {
  * > 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 & {
+type Customer$1 = CommentEventSubject & HasEvents & HasMetafieldDefinitions & HasMetafields & HasStoreCreditAccounts & LegacyInteroperability & Node & {
     __typename?: '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.
+     * A list of addresses associated with the customer. Limited to 250 addresses. Use `addressesV2` for paginated access to all addresses.
+     * @deprecated Limited to 250 addresses. Use `addressesV2` for paginated access to all addresses.
      */
     addresses: Array<MailingAddress>;
     /** The addresses associated with the customer. */
@@ -3540,7 +3666,7 @@ type CustomerConnection = {
     /** The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node. */
     edges: Array<CustomerEdge>;
     /** A list of nodes that are contained in CustomerEdge. You can fetch data about an individual node, or you can follow the edges to fetch data about a collection of related nodes. At each node, you specify the fields that you want to retrieve. */
-    nodes: Array<Customer>;
+    nodes: Array<Customer$1>;
     /** An object that’s used to retrieve [cursor information](https://shopify.dev/api/usage/pagination-graphql) about the current page. */
     pageInfo: PageInfo;
 };
@@ -3628,7 +3754,7 @@ type CustomerEdge = {
     /** The position of each node in an array, used in [pagination](https://shopify.dev/api/usage/pagination-graphql). */
     cursor: Scalars['String']['output'];
     /** The item at the end of CustomerEdge. */
-    node: Customer;
+    node: Customer$1;
 };
 /**
  * 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).
@@ -3907,7 +4033,7 @@ type CustomerPaymentInstrumentBillingAddress = {
 type CustomerPaymentMethod = Node & {
     __typename?: 'CustomerPaymentMethod';
     /** The customer to whom the payment method belongs. */
-    customer?: Maybe<Customer>;
+    customer?: Maybe<Customer$1>;
     /** The ID of this payment method. */
     id: Scalars['ID']['output'];
     /** The instrument for this payment method. */
@@ -4076,6 +4202,65 @@ declare enum CustomerRfmGroup {
     /** Customers with no orders yet. */
     Prospects = "PROSPECTS"
 }
+/** The member of a segment. */
+type CustomerSegmentMember$1 = HasMetafields & {
+    __typename?: 'CustomerSegmentMember';
+    /** The total amount of money that the member has spent on orders. */
+    amountSpent?: Maybe<MoneyV2>;
+    /** The member's default address. */
+    defaultAddress?: Maybe<MailingAddress>;
+    /** The member's default email address. */
+    defaultEmailAddress?: Maybe<CustomerEmailAddress>;
+    /** The member's default phone number. */
+    defaultPhoneNumber?: Maybe<CustomerPhoneNumber>;
+    /** The full name of the member, which is based on the values of the `first_name` and `last_name` fields. If the member's first name and last name aren't available, then the customer's email address is used. If the customer's email address isn't available, then the customer's phone number is used. */
+    displayName: Scalars['String']['output'];
+    /** The member's first name. */
+    firstName?: Maybe<Scalars['String']['output']>;
+    /** The member’s ID. */
+    id: Scalars['ID']['output'];
+    /** The member's last name. */
+    lastName?: Maybe<Scalars['String']['output']>;
+    /** The ID of the member's most recent order. */
+    lastOrderId?: Maybe<Scalars['ID']['output']>;
+    /** Whether the customer can be merged with another customer. */
+    mergeable: CustomerMergeable;
+    /**
+     * A [custom field](https://shopify.dev/docs/apps/build/custom-data),
+     * including its `namespace` and `key`, that's associated with a Shopify resource
+     * for the purposes of adding and storing additional information.
+     */
+    metafield?: Maybe<Metafield>;
+    /**
+     * A list of [custom fields](https://shopify.dev/docs/apps/build/custom-data)
+     * that a merchant associates with a Shopify resource.
+     */
+    metafields: MetafieldConnection;
+    /** A note about the member. */
+    note?: Maybe<Scalars['String']['output']>;
+    /** The total number of orders that the member has made. */
+    numberOfOrders?: Maybe<Scalars['UnsignedInt64']['output']>;
+};
+/** The connection type for the `CustomerSegmentMembers` object. */
+type CustomerSegmentMemberConnection = {
+    __typename?: 'CustomerSegmentMemberConnection';
+    /** A list of edges. */
+    edges: Array<CustomerSegmentMemberEdge>;
+    /** An object that’s used to retrieve [cursor information](https://shopify.dev/api/usage/pagination-graphql) about the current page. */
+    pageInfo: PageInfo;
+    /** The statistics for a given segment. */
+    statistics: SegmentStatistics;
+    /** The total number of members in a given segment. */
+    totalCount: Scalars['Int']['output'];
+};
+/** An auto-generated type which holds one CustomerSegmentMember and a cursor during pagination. */
+type CustomerSegmentMemberEdge = {
+    __typename?: 'CustomerSegmentMemberEdge';
+    /** The position of each node in an array, used in [pagination](https://shopify.dev/api/usage/pagination-graphql). */
+    cursor: Scalars['String']['output'];
+    /** The item at the end of CustomerSegmentMemberEdge. */
+    node: CustomerSegmentMember$1;
+};
 /** Represents a Shop Pay card instrument for customer payment method. */
 type CustomerShopPayAgreement = {
     __typename?: 'CustomerShopPayAgreement';
@@ -5559,8 +5744,8 @@ type DiscountCodeApp = {
     /** The date and time when the discount was updated. */
     updatedAt: Scalars['DateTime']['output'];
     /**
-     * The maximum number of times that a customer can use the discount.
-     * For discounts with unlimited usage, specify `null`.
+     * The maximum number of times the discount can be redeemed.
+     * For unlimited usage, specify `null`.
      */
     usageLimit?: Maybe<Scalars['Int']['output']>;
 };
@@ -5673,8 +5858,8 @@ type DiscountCodeBasic = {
     /** The date and time when the discount was updated. */
     updatedAt: Scalars['DateTime']['output'];
     /**
-     * The maximum number of times that a customer can use the discount.
-     * For discounts with unlimited usage, specify `null`.
+     * The maximum number of times the discount can be redeemed.
+     * For unlimited usage, specify `null`.
      */
     usageLimit?: Maybe<Scalars['Int']['output']>;
 };
@@ -5775,8 +5960,8 @@ type DiscountCodeBxgy = {
     /** The date and time when the discount was updated. */
     updatedAt: Scalars['DateTime']['output'];
     /**
-     * The maximum number of times that a customer can use the discount.
-     * For discounts with unlimited usage, specify `null`.
+     * The maximum number of times the discount can be redeemed.
+     * For unlimited usage, specify `null`.
      */
     usageLimit?: Maybe<Scalars['Int']['output']>;
     /** The maximum number of times that the discount can be applied to an order. */
@@ -5914,8 +6099,8 @@ type DiscountCodeFreeShipping = {
     /** The date and time when the discount was updated. */
     updatedAt: Scalars['DateTime']['output'];
     /**
-     * The maximum number of times that a customer can use the discount.
-     * For discounts with unlimited usage, specify `null`.
+     * The maximum number of times the discount can be redeemed.
+     * For unlimited usage, specify `null`.
      */
     usageLimit?: Maybe<Scalars['Int']['output']>;
 };
@@ -6085,7 +6270,7 @@ type DiscountCustomerSelection = DiscountCustomerAll | DiscountCustomerSegments
 type DiscountCustomers = {
     __typename?: 'DiscountCustomers';
     /** The list of individual customers eligible for the discount. */
-    customers: Array<Customer>;
+    customers: Array<Customer$1>;
 };
 /** The type of discount that will be applied. Currently, only a percentage discount is supported. */
 type DiscountEffect = DiscountAmount | DiscountPercentage;
@@ -6384,7 +6569,7 @@ type DraftOrder = CommentEventSubject & HasEvents & HasLocalizationExtensions &
     /** The custom information added to the draft order on behalf of the customer. */
     customAttributes: Array<Attribute>;
     /** The customer who will be sent an invoice. */
-    customer?: Maybe<Customer>;
+    customer?: Maybe<Customer$1>;
     /** A default [cursor](https://shopify.dev/api/usage/pagination-graphql) that returns the single next record, sorted ascending by ID. */
     defaultCursor: Scalars['String']['output'];
     /** All discount codes applied. */
@@ -6705,7 +6890,7 @@ type DraftOrderLineItem = Node & {
      */
     uuid: Scalars['String']['output'];
     /** The product variant for the line item. */
-    variant?: Maybe<ProductVariant>;
+    variant?: Maybe<ProductVariant$1>;
     /** The name of the variant. */
     variantTitle?: Maybe<Scalars['String']['output']>;
     /** The name of the vendor who created the product variant. */
@@ -7006,7 +7191,7 @@ type ExchangeV2LineItem = {
     /** The title of the product or variant. This field only applies to custom line items. */
     title: Scalars['String']['output'];
     /** The product variant of the line item. */
-    variant?: Maybe<ProductVariant>;
+    variant?: Maybe<ProductVariant$1>;
     /** The name of the variant. */
     variantTitle?: Maybe<Scalars['String']['output']>;
     /** The name of the vendor who created the product variant. */
@@ -7030,6 +7215,43 @@ type ExchangeV2Returns = {
     /** The total value of the items being returned. */
     totalPriceSet: MoneyBag;
 };
+/** Represents a video hosted outside of Shopify. */
+type ExternalVideo = File & Media & Node & {
+    __typename?: 'ExternalVideo';
+    /** A word or phrase to describe the contents or the function of a file. */
+    alt?: Maybe<Scalars['String']['output']>;
+    /** The date and time ([ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)) when the file was created. */
+    createdAt: Scalars['DateTime']['output'];
+    /** The embed URL of the video for the respective host. */
+    embedUrl: Scalars['URL']['output'];
+    /**
+     * The URL.
+     * @deprecated Use `originUrl` instead.
+     */
+    embeddedUrl: Scalars['URL']['output'];
+    /** Any errors that have occurred on the file. */
+    fileErrors: Array<FileError>;
+    /** The status of the file. */
+    fileStatus: FileStatus;
+    /** The host of the external video. */
+    host: MediaHost;
+    /** A globally-unique ID. */
+    id: Scalars['ID']['output'];
+    /** The media content type. */
+    mediaContentType: MediaContentType;
+    /** Any errors which have occurred on the media. */
+    mediaErrors: Array<MediaError>;
+    /** The warnings attached to the media. */
+    mediaWarnings: Array<MediaWarning>;
+    /** The origin URL of the video on the respective host. */
+    originUrl: Scalars['URL']['output'];
+    /** The preview image for the media. */
+    preview?: Maybe<MediaPreviewImage>;
+    /** Current status of the media. */
+    status: MediaStatus;
+    /** The date and time ([ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)) when the file was last updated. */
+    updatedAt: Scalars['DateTime']['output'];
+};
 /** Requirements that must be met before an app can be installed. */
 type FailedRequirement = {
     __typename?: 'FailedRequirement';
@@ -7063,6 +7285,55 @@ type File = {
     /** The date and time ([ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)) when the file was last updated. */
     updatedAt: Scalars['DateTime']['output'];
 };
+/** The possible content types for a file object. */
+declare enum FileContentType {
+    /** An externally hosted video. */
+    ExternalVideo = "EXTERNAL_VIDEO",
+    /** A Shopify-hosted generic file. */
+    File = "FILE",
+    /** A Shopify-hosted image. */
+    Image = "IMAGE",
+    /** A Shopify-hosted 3D model. */
+    Model_3D = "MODEL_3D",
+    /** A Shopify-hosted video file. It's recommended to use this type for all video files. */
+    Video = "VIDEO"
+}
+/** The input fields that are required to create a file object. */
+type FileCreateInput = {
+    /** The alt text description of the file for screen readers and accessibility. */
+    alt?: InputMaybe<Scalars['String']['input']>;
+    /** The file content type. If omitted, then Shopify will attempt to determine the content type during file processing. */
+    contentType?: InputMaybe<FileContentType>;
+    /** How to handle if filename is already in use. */
+    duplicateResolutionMode?: InputMaybe<FileCreateInputDuplicateResolutionMode>;
+    /**
+     * The name of the file. If provided, then the file is created with the specified filename.
+     * If not provided, then the filename from the `originalSource` is used.
+     */
+    filename?: InputMaybe<Scalars['String']['input']>;
+    /**
+     * An external URL (for images only) or a
+     * [staged upload URL](https://shopify.dev/api/admin-graphql/latest/mutations/stageduploadscreate).
+     */
+    originalSource: Scalars['String']['input'];
+};
+/** The input fields for handling if filename is already in use. */
+declare enum FileCreateInputDuplicateResolutionMode {
+    /** Append a UUID if filename is already in use. */
+    AppendUuid = "APPEND_UUID",
+    /** Raise an error if filename is already in use. */
+    RaiseError = "RAISE_ERROR",
+    /** Replace the existing file if filename is already in use. */
+    Replace = "REPLACE"
+}
+/** Return type for `fileDelete` mutation. */
+type FileDeletePayload = {
+    __typename?: 'FileDeletePayload';
+    /** The IDs of the deleted files. */
+    deletedFileIds?: Maybe<Array<Scalars['ID']['output']>>;
+    /** The list of errors that occurred from executing the mutation. */
+    userErrors: Array<FilesUserError>;
+};
 /**
  * A file error. This typically occurs when there is an issue with the file itself causing it to fail validation.
  * Check the file before attempting to upload again.
@@ -7156,6 +7427,75 @@ declare enum FileStatus {
     /** File has been uploaded but hasn't been processed. */
     Uploaded = "UPLOADED"
 }
+/** Possible error codes that can be returned by `FilesUserError`. */
+declare enum FilesErrorCode {
+    /** The alt value exceeds the maximum limit of 512 characters. */
+    AltValueLimitExceeded = "ALT_VALUE_LIMIT_EXCEEDED",
+    /** The search term must not be blank. */
+    BlankSearch = "BLANK_SEARCH",
+    /** The provided filename already exists. */
+    FilenameAlreadyExists = "FILENAME_ALREADY_EXISTS",
+    /** File does not exist. */
+    FileDoesNotExist = "FILE_DOES_NOT_EXIST",
+    /** File has a pending operation. */
+    FileLocked = "FILE_LOCKED",
+    /** The input value is invalid. */
+    Invalid = "INVALID",
+    /** Duplicate resolution mode is not supported for this file type. */
+    InvalidDuplicateModeForType = "INVALID_DUPLICATE_MODE_FOR_TYPE",
+    /** Invalid duplicate resolution mode provided. */
+    InvalidDuplicateResolutionMode = "INVALID_DUPLICATE_RESOLUTION_MODE",
+    /** File cannot be updated in a failed state. */
+    InvalidFailedMediaState = "INVALID_FAILED_MEDIA_STATE",
+    /** The provided filename is invalid. */
+    InvalidFilename = "INVALID_FILENAME",
+    /** Invalid filename extension. */
+    InvalidFilenameExtension = "INVALID_FILENAME_EXTENSION",
+    /** Invalid image source url value provided. */
+    InvalidImageSourceUrl = "INVALID_IMAGE_SOURCE_URL",
+    /** Search query isn't supported. */
+    InvalidQuery = "INVALID_QUERY",
+    /** Cannot create file with custom filename which does not match original source extension. */
+    MismatchedFilenameAndOriginalSource = "MISMATCHED_FILENAME_AND_ORIGINAL_SOURCE",
+    /** At least one argument is required. */
+    MissingArguments = "MISSING_ARGUMENTS",
+    /** Duplicate resolution mode REPLACE cannot be used without specifying filename. */
+    MissingFilenameForDuplicateModeReplace = "MISSING_FILENAME_FOR_DUPLICATE_MODE_REPLACE",
+    /** Exceeded the limit of non-image media per shop. */
+    NonImageMediaPerShopLimitExceeded = "NON_IMAGE_MEDIA_PER_SHOP_LIMIT_EXCEEDED",
+    /** The file is not in the READY state. */
+    NonReadyState = "NON_READY_STATE",
+    /** Exceeded the limit of media per product. */
+    ProductMediaLimitExceeded = "PRODUCT_MEDIA_LIMIT_EXCEEDED",
+    /** One or more associated products are suspended. */
+    ProductSuspended = "PRODUCT_SUSPENDED",
+    /** The target resource does not exist. */
+    ReferenceTargetDoesNotExist = "REFERENCE_TARGET_DOES_NOT_EXIST",
+    /** Specify one argument: search, IDs, or deleteAll. */
+    TooManyArguments = "TOO_MANY_ARGUMENTS",
+    /** Cannot add more than 10000 references to a file. */
+    TooManyFileReference = "TOO_MANY_FILE_REFERENCE",
+    /** The file type is not supported. */
+    UnacceptableAsset = "UNACCEPTABLE_ASSET",
+    /** The file is not supported on trial accounts. Select a plan to upload this file. */
+    UnacceptableTrialAsset = "UNACCEPTABLE_TRIAL_ASSET",
+    /** The file is not supported on trial accounts that have not validated their email. Either select a plan or verify the shop owner email to upload this file. */
+    UnacceptableUnverifiedTrialAsset = "UNACCEPTABLE_UNVERIFIED_TRIAL_ASSET",
+    /** The file type is not supported for referencing. */
+    UnsupportedFileReference = "UNSUPPORTED_FILE_REFERENCE",
+    /** Filename update is only supported on Image and GenericFile. */
+    UnsupportedMediaTypeForFilenameUpdate = "UNSUPPORTED_MEDIA_TYPE_FOR_FILENAME_UPDATE"
+}
+/** An error that happens during the execution of a Files API query or mutation. */
+type FilesUserError = DisplayableError & {
+    __typename?: 'FilesUserError';
+    /** The error code. */
+    code?: Maybe<FilesErrorCode>;
+    /** The path to the input field that caused the error. */
+    field?: Maybe<Array<Scalars['String']['output']>>;
+    /** The error message. */
+    message: Scalars['String']['output'];
+};
 /** A filter option is one possible value in a search filter. */
 type FilterOption = {
     __typename?: 'FilterOption';
@@ -7192,7 +7532,7 @@ type FinancialSummaryDiscountApplication = {
  *
  * Multiple fulfillments can exist for a single order when items either ship separately or from different locations.
  */
-type Fulfillment = LegacyInteroperability & Node & {
+type Fulfillment$1 = LegacyInteroperability & Node & {
     __typename?: 'Fulfillment';
     /** The date and time when the fulfillment was created. */
     createdAt: Scalars['DateTime']['output'];
@@ -7244,7 +7584,7 @@ type FulfillmentConnection = {
     /** The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node. */
     edges: Array<FulfillmentEdge>;
     /** A list of nodes that are contained in FulfillmentEdge. You can fetch data about an individual node, or you can follow the edges to fetch data about a collection of related nodes. At each node, you specify the fields that you want to retrieve. */
-    nodes: Array<Fulfillment>;
+    nodes: Array<Fulfillment$1>;
     /** An object that’s used to retrieve [cursor information](https://shopify.dev/api/usage/pagination-graphql) about the current page. */
     pageInfo: PageInfo;
 };
@@ -7291,7 +7631,7 @@ type FulfillmentEdge = {
     /** The position of each node in an array, used in [pagination](https://shopify.dev/api/usage/pagination-graphql). */
     cursor: Scalars['String']['output'];
     /** The item at the end of FulfillmentEdge. */
-    node: Fulfillment;
+    node: Fulfillment$1;
 };
 /**
  * A tracking event that records the status and location of a fulfillment at a specific point in time. Each event captures details such as the [status](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentEvent#field-FulfillmentEvent.fields.status) (for example, in transit, out for delivery, delivered) and any [messages](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentEvent#field-FulfillmentEvent.fields.message) associated with the event.
@@ -7408,6 +7748,28 @@ declare enum FulfillmentHoldReason {
     /** The fulfillment hold is applied because of an unknown delivery date. */
     UnknownDeliveryDate = "UNKNOWN_DELIVERY_DATE"
 }
+/** The input fields used to create a fulfillment from fulfillment orders. */
+type FulfillmentInput = {
+    /**
+     * Pairs of `fulfillment_order_id` and `fulfillment_order_line_items` that represent the fulfillment
+     * order line items that have to be fulfilled for each fulfillment order.  For any given pair, if the
+     * fulfillment order line items are left blank then all the fulfillment order line items of the
+     * associated fulfillment order ID will be fulfilled.
+     */
+    lineItemsByFulfillmentOrder: Array<FulfillmentOrderLineItemsInput>;
+    /**
+     * Whether the customer is notified.
+     * If `true`, then a notification is sent when the fulfillment is created. The default value is `false`.
+     */
+    notifyCustomer?: InputMaybe<Scalars['Boolean']['input']>;
+    /** Address information about the location from which the order was fulfilled. */
+    originAddress?: InputMaybe<FulfillmentOriginAddressInput>;
+    /**
+     * The fulfillment's tracking information, including a tracking URL, a tracking number,
+     * and the company associated with the fulfillment.
+     */
+    trackingInfo?: InputMaybe<FulfillmentTrackingInput>;
+};
 /**
  * A line item from an [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) that's included in a [`Fulfillment`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Fulfillment). Links the fulfillment to specific items from the original order, tracking how many units were fulfilled.
  *
@@ -7617,7 +7979,7 @@ type FulfillmentLineItemEdge = {
  *
  * [Learn about fulfillment workflows](https://shopify.dev/apps/fulfillment).
  */
-type FulfillmentOrder = Node & {
+type FulfillmentOrder$1 = Node & {
     __typename?: 'FulfillmentOrder';
     /**
      * The fulfillment order's assigned location. This is the location where the fulfillment is expected to happen.
@@ -7778,9 +8140,9 @@ type FulfillmentOrderAssignedLocation = {
 type FulfillmentOrderConnection = {
     __typename?: 'FulfillmentOrderConnection';
     /** The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node. */
-    edges: Array<FulfillmentOrderEdge>;
+    edges: Array<FulfillmentOrderEdge$1>;
     /** A list of nodes that are contained in FulfillmentOrderEdge. You can fetch data about an individual node, or you can follow the edges to fetch data about a collection of related nodes. At each node, you specify the fields that you want to retrieve. */
-    nodes: Array<FulfillmentOrder>;
+    nodes: Array<FulfillmentOrder$1>;
     /** An object that’s used to retrieve [cursor information](https://shopify.dev/api/usage/pagination-graphql) about the current page. */
     pageInfo: PageInfo;
 };
@@ -7815,12 +8177,12 @@ type FulfillmentOrderDestination = Node & {
     zip?: Maybe<Scalars['String']['output']>;
 };
 /** An auto-generated type which holds one FulfillmentOrder and a cursor during pagination. */
-type FulfillmentOrderEdge = {
+type FulfillmentOrderEdge$1 = {
     __typename?: 'FulfillmentOrderEdge';
     /** The position of each node in an array, used in [pagination](https://shopify.dev/api/usage/pagination-graphql). */
     cursor: Scalars['String']['output'];
     /** The item at the end of FulfillmentOrderEdge. */
-    node: FulfillmentOrder;
+    node: FulfillmentOrder$1;
 };
 /** The international duties relevant to a fulfillment order. */
 type FulfillmentOrderInternationalDuties = {
@@ -7861,7 +8223,7 @@ type FulfillmentOrderLineItem = Node & {
     /** The total number of units to be fulfilled. */
     totalQuantity: Scalars['Int']['output'];
     /** The product variant associated to the fulfillment order line item. */
-    variant?: Maybe<ProductVariant>;
+    variant?: Maybe<ProductVariant$1>;
     /** The name of the variant. */
     variantTitle?: Maybe<Scalars['String']['output']>;
     /** The name of the vendor who made the variant. */
@@ -7901,6 +8263,13 @@ type FulfillmentOrderLineItemFinancialSummary = {
     /** Number of line items that this financial summary applies to. */
     quantity: Scalars['Int']['output'];
 };
+/** The input fields used to include the quantity of the fulfillment order line item that should be fulfilled. */
+type FulfillmentOrderLineItemInput = {
+    /** The ID of the fulfillment order line item. */
+    id: Scalars['ID']['input'];
+    /** The quantity of the fulfillment order line item. */
+    quantity: Scalars['Int']['input'];
+};
 /** A fulfillment order line item warning. For example, a warning about why a fulfillment request was rejected. */
 type FulfillmentOrderLineItemWarning = {
     __typename?: 'FulfillmentOrderLineItemWarning';
@@ -7909,6 +8278,17 @@ type FulfillmentOrderLineItemWarning = {
     /** The title of warning. */
     title?: Maybe<Scalars['String']['output']>;
 };
+/** The input fields used to include the line items of a specified fulfillment order that should be fulfilled. */
+type FulfillmentOrderLineItemsInput = {
+    /** The ID of the fulfillment order. */
+    fulfillmentOrderId: Scalars['ID']['input'];
+    /**
+     * The fulfillment order line items to be fulfilled.
+     * If left blank, all line items of the fulfillment order will be fulfilled.
+     * Accepts a maximum of 512 line items.
+     */
+    fulfillmentOrderLineItems?: InputMaybe<Array<FulfillmentOrderLineItemInput>>;
+};
 /** A location that a fulfillment order can potentially move to. */
 type FulfillmentOrderLocationForMove = {
     __typename?: 'FulfillmentOrderLocationForMove';
@@ -7961,7 +8341,7 @@ type FulfillmentOrderLocationForMoveEdge = {
 type FulfillmentOrderMerchantRequest = Node & {
     __typename?: 'FulfillmentOrderMerchantRequest';
     /** The fulfillment order associated with the merchant request. */
-    fulfillmentOrder: FulfillmentOrder;
+    fulfillmentOrder: FulfillmentOrder$1;
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
     /** The kind of request made. */
@@ -8071,6 +8451,21 @@ type FulfillmentOriginAddress = {
     /** The zip code of the fulfillment location. */
     zip?: Maybe<Scalars['String']['output']>;
 };
+/** The input fields used to include the address at which the fulfillment occurred. This input object is intended for tax purposes, as a full address is required for tax providers to accurately calculate taxes. Typically this is the address of the warehouse or fulfillment center. To retrieve a fulfillment location's address, use the `assignedLocation` field on the [`FulfillmentOrder`](/docs/api/admin-graphql/latest/objects/FulfillmentOrder) object instead. */
+type FulfillmentOriginAddressInput = {
+    /** The street address of the fulfillment location. */
+    address1?: InputMaybe<Scalars['String']['input']>;
+    /** The second line of the address. Typically the number of the apartment, suite, or unit. */
+    address2?: InputMaybe<Scalars['String']['input']>;
+    /** The city in which the fulfillment location is located. */
+    city?: InputMaybe<Scalars['String']['input']>;
+    /** The country of the fulfillment location. */
+    countryCode: Scalars['String']['input'];
+    /** The province of the fulfillment location. */
+    provinceCode?: InputMaybe<Scalars['String']['input']>;
+    /** The zip code of the fulfillment location. */
+    zip?: InputMaybe<Scalars['String']['input']>;
+};
 /**
  * A **Fulfillment Service** is a third party warehouse that prepares and ships orders
  * on behalf of the store owner. Fulfillment services charge a fee to package and ship items
@@ -8392,6 +8787,113 @@ type FulfillmentTrackingInfo = {
      */
     url?: Maybe<Scalars['URL']['output']>;
 };
+/**
+ * The input fields that specify all possible fields for tracking information.
+ *
+ * > Note:
+ * > If you provide the `url` field, you should not provide the `urls` field.
+ * >
+ * > If you provide the `number` field, you should not provide the `numbers` field.
+ * >
+ * > If you provide the `url` field, you should provide the `number` field.
+ * >
+ * > If you provide the `urls` field, you should provide the `numbers` field.
+ */
+type FulfillmentTrackingInput = {
+    /**
+     * The name of the tracking company.
+     *
+     * If you specify a tracking company name from
+     * [the list](https://shopify.dev/api/admin-graphql/latest/objects/FulfillmentTrackingInfo#supported-tracking-companies),
+     * Shopify will automatically build tracking URLs for all provided tracking numbers,
+     * which will make the tracking numbers clickable in the interface.
+     * The same tracking company will be applied to all tracking numbers specified.
+     *
+     * Additionally, for the tracking companies listed on the
+     * [Shipping Carriers help page](https://help.shopify.com/manual/shipping/understanding-shipping/shipping-carriers#integrated-shipping-carriers)
+     * Shopify will automatically update the fulfillment's `shipment_status` field during the fulfillment process.
+     *
+     * > Note:
+     * > Send the tracking company name exactly as written in
+     * > [the list](https://shopify.dev/api/admin-graphql/latest/objects/FulfillmentTrackingInfo#supported-tracking-companies)
+     * > (capitalization matters).
+     */
+    company?: InputMaybe<Scalars['String']['input']>;
+    /**
+     * The tracking number of the fulfillment.
+     *
+     * The tracking number will be clickable in the interface if one of the following applies
+     * (the highest in the list has the highest priority):
+     *
+     * * Tracking url provided in the `url` field.
+     * * [Shopify-known tracking company name](https://shopify.dev/api/admin-graphql/latest/objects/FulfillmentTrackingInfo#supported-tracking-companies)
+     *   specified in the `company` field.
+     *   Shopify will build the tracking URL automatically based on the tracking number specified.
+     * * The tracking number has a Shopify-known format.
+     *   Shopify will guess the tracking provider and build the tracking url based on the tracking number format.
+     *   Not all tracking carriers are supported, and multiple tracking carriers may use similarly formatted tracking numbers.
+     *   This can result in an invalid tracking URL.
+     *   It is highly recommended that you send the tracking company and the tracking URL.
+     */
+    number?: InputMaybe<Scalars['String']['input']>;
+    /**
+     * The tracking numbers of the fulfillment, one or many.
+     *
+     * With multiple tracking numbers, you can provide tracking information
+     * for all shipments associated with the fulfillment, if there are more than one.
+     * For example, if you're shipping assembly parts of one furniture item in several boxes.
+     *
+     * Tracking numbers will be clickable in the interface if one of the following applies
+     * (the highest in the list has the highest priority):
+     *
+     * * Tracking URLs provided in the `urls` field.
+     *   The tracking URLs will be matched to the tracking numbers based on their positions in the arrays.
+     * * [Shopify-known tracking company name](https://shopify.dev/api/admin-graphql/latest/objects/FulfillmentTrackingInfo#supported-tracking-companies)
+     *   specified in the `company` field.
+     *   Shopify will build tracking URLs automatically for all tracking numbers specified.
+     *   The same tracking company will be applied to all tracking numbers.
+     * * Tracking numbers have a Shopify-known format.
+     *   Shopify will guess tracking providers and build tracking URLs based on the tracking number formats.
+     *   Not all tracking carriers are supported, and multiple tracking carriers may use similarly formatted tracking numbers.
+     *   This can result in an invalid tracking URL.
+     *   It is highly recommended that you send the tracking company and the tracking URLs.
+     */
+    numbers?: InputMaybe<Array<Scalars['String']['input']>>;
+    /**
+     * The URL to track the fulfillment.
+     *
+     * The tracking URL is displayed in the merchant's admin on the order page.
+     * The tracking URL is displayed in the shipping confirmation email, which can optionally be sent to the customer.
+     * When accounts are enabled, it's also displayed in the customer's order history.
+     *
+     * The URL must be an [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986) and
+     * [RFC 3987](https://datatracker.ietf.org/doc/html/rfc3987)-compliant URI string.
+     * For example, `"https://www.myshipping.com/track/?tracknumbers=TRACKING_NUMBER"` is a valid URL.
+     * It includes a scheme (`https`) and a host (`myshipping.com`).
+     */
+    url?: InputMaybe<Scalars['URL']['input']>;
+    /**
+     * The URLs to track the fulfillment, one or many.
+     *
+     * The tracking URLs are displayed in the merchant's admin on the order page.
+     * The tracking URLs are displayed in the shipping confirmation email, which can optionally be sent to the customer.
+     * When accounts are enabled, the tracking URLs are also displayed in the customer's order history.
+     *
+     * If you're not specifying a
+     * [Shopify-known](https://shopify.dev/api/admin-graphql/latest/objects/FulfillmentTrackingInfo#supported-tracking-companies)
+     * tracking company name in the `company` field,
+     * then provide tracking URLs for all tracking numbers from the `numbers` field.
+     *
+     * Tracking URLs from the `urls` array field are being matched with the tracking numbers from the `numbers` array
+     * field correspondingly their positions in the arrays.
+     *
+     * Each URL must be an [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986) and
+     * [RFC 3987](https://datatracker.ietf.org/doc/html/rfc3987)-compliant URI string.
+     * For example, `"https://www.myshipping.com/track/?tracknumbers=TRACKING_NUMBER"` is a valid URL.
+     * It includes a scheme (`https`) and a host (`myshipping.com`).
+     */
+    urls?: InputMaybe<Array<Scalars['URL']['input']>>;
+};
 /** The App Bridge information for a Shopify Function. */
 type FunctionsAppBridge = {
     __typename?: 'FunctionsAppBridge';
@@ -8450,7 +8952,7 @@ type GiftCard = Node & {
     /** The date and time at which the gift card was created. */
     createdAt: Scalars['DateTime']['output'];
     /** The customer who will receive the gift card. */
-    customer?: Maybe<Customer>;
+    customer?: Maybe<Customer$1>;
     /** The date and time at which the gift card was deactivated. */
     deactivatedAt?: Maybe<Scalars['DateTime']['output']>;
     /** Whether the gift card is enabled. */
@@ -8486,7 +8988,7 @@ type GiftCardRecipient = {
     /** The preferred name of the recipient who will receive the gift card. */
     preferredName?: Maybe<Scalars['String']['output']>;
     /** The recipient who will receive the gift card. */
-    recipient: Customer;
+    recipient: Customer$1;
     /** The scheduled datetime on which the gift card will be sent to the recipient. The gift card will be sent within an hour of the specified datetime. */
     sendNotificationAt?: Maybe<Scalars['DateTime']['output']>;
 };
@@ -8727,7 +9229,7 @@ type InventoryItem = LegacyInteroperability & Node & {
     /** The date and time when the inventory item was updated. */
     updatedAt: Scalars['DateTime']['output'];
     /** The variant that owns this inventory item. */
-    variant: ProductVariant;
+    variant: ProductVariant$1;
 };
 /** An auto-generated type for paginating through multiple InventoryItems. */
 type InventoryItemConnection = {
@@ -8747,6 +9249,27 @@ type InventoryItemEdge = {
     /** The item at the end of InventoryItemEdge. */
     node: InventoryItem;
 };
+/** The input fields for an inventory item. */
+type InventoryItemInput = {
+    /** Unit cost associated with the inventory item, the currency is the shop's default currency. */
+    cost?: InputMaybe<Scalars['Decimal']['input']>;
+    /** The country where the item was manufactured or produced, specified using the standard two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code. */
+    countryCodeOfOrigin?: InputMaybe<CountryCode>;
+    /** List of country-specific harmonized system codes. */
+    countryHarmonizedSystemCodes?: InputMaybe<Array<CountryHarmonizedSystemCodeInput>>;
+    /** The harmonized system code of the inventory item. This must be a number between 6 and 13 digits. */
+    harmonizedSystemCode?: InputMaybe<Scalars['String']['input']>;
+    /** The measurements of an inventory item. */
+    measurement?: InputMaybe<InventoryItemMeasurementInput>;
+    /** The province where the item was manufactured or produced, specified using the standard two-letter [ISO 3166-2 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-2) province code. */
+    provinceCodeOfOrigin?: InputMaybe<Scalars['String']['input']>;
+    /** Whether the inventory item needs to be physically shipped to the customer. Items that require shipping are physical products, while digital goods and services typically don't require shipping and can be fulfilled electronically. */
+    requiresShipping?: InputMaybe<Scalars['Boolean']['input']>;
+    /** The SKU (stock keeping unit) of the inventory item. */
+    sku?: InputMaybe<Scalars['String']['input']>;
+    /** Whether the inventory item is tracked. */
+    tracked?: InputMaybe<Scalars['Boolean']['input']>;
+};
 /** 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';
@@ -8755,6 +9278,11 @@ type InventoryItemMeasurement = Node & {
     /** The weight of the inventory item. */
     weight?: Maybe<Weight>;
 };
+/** The input fields for an inventory item measurement. */
+type InventoryItemMeasurementInput = {
+    /** The weight of the inventory item. */
+    weight?: InputMaybe<WeightInput>;
+};
 /**
  * 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.
  *
@@ -8802,6 +9330,13 @@ type InventoryLevelEdge = {
     /** The item at the end of InventoryLevelEdge. */
     node: InventoryLevel;
 };
+/** The input fields for an inventory level. */
+type InventoryLevelInput = {
+    /** The available quantity of an inventory item at a location. */
+    availableQuantity: Scalars['Int']['input'];
+    /** The ID of a location associated with the inventory level. */
+    locationId: Scalars['ID']['input'];
+};
 /**
  * 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.
@@ -9060,7 +9595,7 @@ type LineItem = Node & {
     /** The number of units not yet fulfilled. */
     unfulfilledQuantity: Scalars['Int']['output'];
     /** The Variant object associated with this line item. */
-    variant?: Maybe<ProductVariant>;
+    variant?: Maybe<ProductVariant$1>;
     /** The title of the variant at time of order creation. */
     variantTitle?: Maybe<Scalars['String']['output']>;
     /** The name of the vendor who made the variant. */
@@ -10229,6 +10764,13 @@ declare enum MediaErrorCode {
     /** Video failed validation. */
     VideoValidationError = "VIDEO_VALIDATION_ERROR"
 }
+/** Host for a Media Resource. */
+declare enum MediaHost {
+    /** Host for Vimeo embedded videos. */
+    Vimeo = "VIMEO",
+    /** Host for YouTube embedded videos. */
+    Youtube = "YOUTUBE"
+}
 /**
  * The `MediaImage` object represents an image hosted on Shopify's
  * [content delivery network (CDN)](https://shopify.dev/docs/storefronts/themes/best-practices/performance/platform#shopify-cdn).
@@ -10697,6 +11239,20 @@ type MetafieldDefinitionValidation = {
     /** The validation value. */
     value?: Maybe<Scalars['String']['output']>;
 };
+/**
+ * The name and value for a metafield definition validation.
+ *
+ * For example, for a metafield definition of `single_line_text_field` type, you can set a validation with the name `min` and a value of `10`.
+ * This validation will ensure that the value of the metafield is at least 10 characters.
+ *
+ * Refer to the [list of supported validations](https://shopify.dev/apps/build/custom-data/metafields/list-of-validation-options).
+ */
+type MetafieldDefinitionValidationInput = {
+    /** The name for the metafield definition validation. */
+    name: Scalars['String']['input'];
+    /** The value for the metafield definition validation. */
+    value: Scalars['String']['input'];
+};
 /** Possible metafield definition validation statuses. */
 declare enum MetafieldDefinitionValidationStatus {
     /** All of this definition's metafields are valid. */
@@ -10721,6 +11277,43 @@ declare enum MetafieldGrantAccessLevel {
     /** Read and write metafield access. */
     ReadWrite = "READ_WRITE"
 }
+/**
+ * The input fields to use to create or update a metafield through a mutation on the owning resource.
+ * An alternative way to create or update a metafield is by using the
+ * [metafieldsSet](https://shopify.dev/api/admin-graphql/latest/mutations/metafieldsSet) mutation.
+ */
+type MetafieldInput = {
+    /** The unique ID of the metafield. Using `owner_id`, `namespace`, and `key` is preferred for creating and updating. */
+    id?: InputMaybe<Scalars['ID']['input']>;
+    /**
+     * The unique identifier for a metafield within its namespace.
+     *
+     * Required when creating a metafield, but optional when updating. Used to help identify the metafield when
+     * updating, but can't be updated itself.
+     *
+     * Must be 2-64 characters long and can contain alphanumeric, hyphen, and underscore characters.
+     */
+    key?: InputMaybe<Scalars['String']['input']>;
+    /**
+     * The container for a group of metafields that the metafield is or will be associated with. Used in tandem with
+     * `key` to lookup a metafield on a resource, preventing conflicts with other metafields with the same `key`.
+     *
+     * Required when creating a metafield, but optional when updating. Used to help identify the metafield when
+     * updating, but can't be updated itself.
+     *
+     * Must be 3-255 characters long and can contain alphanumeric, hyphen, and underscore characters.
+     */
+    namespace?: InputMaybe<Scalars['String']['input']>;
+    /**
+     * The type of data that is stored in the metafield.
+     * Refer to the list of [supported types](https://shopify.dev/apps/metafields/types).
+     *
+     * Required when creating or updating a metafield without a definition.
+     */
+    type?: InputMaybe<Scalars['String']['input']>;
+    /** The data stored in the metafield. Always stored as a string, regardless of the metafield's type. */
+    value?: InputMaybe<Scalars['String']['input']>;
+};
 /** Possible types of a metafield's owner resource. */
 declare enum MetafieldOwnerType {
     /** The Api Permission metafield owner type. */
@@ -10778,7 +11371,7 @@ declare enum MetafieldOwnerType {
     Validation = "VALIDATION"
 }
 /** The resource referenced by the metafield value. */
-type MetafieldReference = Collection | Company | Customer | GenericFile | MediaImage | Metaobject | Model3d | Order | Page | Product | ProductVariant | TaxonomyValue | Video;
+type MetafieldReference = Collection | Company | Customer$1 | GenericFile | MediaImage | Metaobject$1 | Model3d | Order | Page | Product | ProductVariant$1 | TaxonomyValue | Video;
 /** An auto-generated type for paginating through multiple MetafieldReferences. */
 type MetafieldReferenceConnection = {
     __typename?: 'MetafieldReferenceConnection';
@@ -10798,7 +11391,7 @@ type MetafieldReferenceEdge = {
     node?: Maybe<MetafieldReference>;
 };
 /** Types of resources that may use metafields to reference other resources. */
-type MetafieldReferencer = AppInstallation | Article | Blog | Collection | Company | CompanyLocation | Customer | DeliveryCustomization | DiscountAutomaticNode | DiscountCodeNode | DiscountNode | DraftOrder | FulfillmentOrder | Location | Market | Metaobject | Order | Page | PaymentCustomization | Product | ProductVariant | Shop;
+type MetafieldReferencer = AppInstallation | Article | Blog | Collection | Company | CompanyLocation | Customer$1 | DeliveryCustomization | DiscountAutomaticNode | DiscountCodeNode | DiscountNode | DraftOrder | FulfillmentOrder$1 | Location | Market | Metaobject$1 | Order | Page | PaymentCustomization | Product | ProductVariant$1 | Shop;
 /**
  * Defines a relation between two resources via a reference metafield.
  * The referencer owns the joining field with a given namespace and key,
@@ -10864,7 +11457,7 @@ declare enum MetafieldValueType {
  *
  * 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 & {
+type Metaobject$1 = Node & {
     __typename?: 'Metaobject';
     /** Metaobject capabilities for this Metaobject. */
     capabilities: MetaobjectCapabilityData;
@@ -10908,6 +11501,13 @@ type MetaobjectAccess = {
     /** The access permitted on the Storefront API. */
     storefront: MetaobjectStorefrontAccess;
 };
+/** The input fields that set access permissions for the definition's metaobjects. */
+type MetaobjectAccessInput = {
+    /** The access permitted on the Admin API. */
+    admin?: InputMaybe<MetaobjectAdminAccessInput>;
+    /** The access permitted on the Storefront API. */
+    storefront?: InputMaybe<MetaobjectStorefrontAccess>;
+};
 /**
  * Metaobject access permissions for the Admin API. When the metaobject is app-owned, the owning app always has
  * full access.
@@ -10924,6 +11524,16 @@ declare enum MetaobjectAdminAccess {
     /** The merchant and other apps have read and write access. */
     PublicReadWrite = "PUBLIC_READ_WRITE"
 }
+/**
+ * Metaobject access permissions for the Admin API. When the metaobject is app-owned, the owning app always has
+ * full access.
+ */
+declare enum MetaobjectAdminAccessInput {
+    /** The merchant has read-only access. No other apps have access. */
+    MerchantRead = "MERCHANT_READ",
+    /** The merchant has read and write access. No other apps have access. */
+    MerchantReadWrite = "MERCHANT_READ_WRITE"
+}
 /** Provides the capabilities of a metaobject definition. */
 type MetaobjectCapabilities = {
     __typename?: 'MetaobjectCapabilities';
@@ -10964,6 +11574,17 @@ type MetaobjectCapabilitiesTranslatable = {
     /** Indicates if the capability is enabled. */
     enabled: Scalars['Boolean']['output'];
 };
+/** The input fields for creating a metaobject capability. */
+type MetaobjectCapabilityCreateInput = {
+    /** The input for enabling the Online Store capability. */
+    onlineStore?: InputMaybe<MetaobjectCapabilityOnlineStoreInput>;
+    /** The input for enabling the publishable capability. */
+    publishable?: InputMaybe<MetaobjectCapabilityPublishableInput>;
+    /** The input for enabling the renderable capability. */
+    renderable?: InputMaybe<MetaobjectCapabilityRenderableInput>;
+    /** The input for enabling the translatable capability. */
+    translatable?: InputMaybe<MetaobjectCapabilityTranslatableInput>;
+};
 /** Provides the capabilities of a metaobject. */
 type MetaobjectCapabilityData = {
     __typename?: 'MetaobjectCapabilityData';
@@ -10972,18 +11593,35 @@ type MetaobjectCapabilityData = {
     /** The publishable capability for this metaobject. */
     publishable?: Maybe<MetaobjectCapabilityDataPublishable>;
 };
+/** The input fields for metaobject capabilities. */
+type MetaobjectCapabilityDataInput = {
+    /** Online Store capability input. */
+    onlineStore?: InputMaybe<MetaobjectCapabilityDataOnlineStoreInput>;
+    /** Publishable capability input. */
+    publishable?: InputMaybe<MetaobjectCapabilityDataPublishableInput>;
+};
 /** The Online Store capability for the parent metaobject. */
 type MetaobjectCapabilityDataOnlineStore = {
     __typename?: 'MetaobjectCapabilityDataOnlineStore';
     /** The theme template used when viewing the metaobject in a store. */
     templateSuffix?: Maybe<Scalars['String']['output']>;
 };
+/** The input fields for the Online Store capability to control renderability on the Online Store. */
+type MetaobjectCapabilityDataOnlineStoreInput = {
+    /** The theme template used when viewing the metaobject in a store. */
+    templateSuffix?: InputMaybe<Scalars['String']['input']>;
+};
 /** The publishable capability for the parent metaobject. */
 type MetaobjectCapabilityDataPublishable = {
     __typename?: 'MetaobjectCapabilityDataPublishable';
     /** The visibility status of this metaobject across all channels. */
     status: MetaobjectStatus;
 };
+/** The input fields for publishable capability to adjust visibility on channels. */
+type MetaobjectCapabilityDataPublishableInput = {
+    /** The visibility status of this metaobject across all channels. */
+    status: MetaobjectStatus;
+};
 /** The Online Store capability data for the metaobject definition. */
 type MetaobjectCapabilityDefinitionDataOnlineStore = {
     __typename?: 'MetaobjectCapabilityDefinitionDataOnlineStore';
@@ -10992,6 +11630,13 @@ type MetaobjectCapabilityDefinitionDataOnlineStore = {
     /** The URL handle for accessing pages of this metaobject type in the Online Store. */
     urlHandle: Scalars['String']['output'];
 };
+/** The input fields of the Online Store capability. */
+type MetaobjectCapabilityDefinitionDataOnlineStoreInput = {
+    /** Whether to redirect published metaobjects automatically when the URL handle changes. */
+    createRedirects?: InputMaybe<Scalars['Boolean']['input']>;
+    /** The URL handle for accessing pages of this metaobject type in the Online Store. */
+    urlHandle: Scalars['String']['input'];
+};
 /** The renderable capability data for the metaobject definition. */
 type MetaobjectCapabilityDefinitionDataRenderable = {
     __typename?: 'MetaobjectCapabilityDefinitionDataRenderable';
@@ -11000,7 +11645,38 @@ type MetaobjectCapabilityDefinitionDataRenderable = {
     /** The metaobject field used as an alias for the SEO page title. */
     metaTitleKey?: Maybe<Scalars['String']['output']>;
 };
-/** Metaobject Capabilities types which can be enabled. */
+/** The input fields of the renderable capability for SEO aliases. */
+type MetaobjectCapabilityDefinitionDataRenderableInput = {
+    /** The metaobject field used as an alias for the SEO page description. */
+    metaDescriptionKey?: InputMaybe<Scalars['String']['input']>;
+    /** The metaobject field used as an alias for the SEO page title. */
+    metaTitleKey?: InputMaybe<Scalars['String']['input']>;
+};
+/** The input fields for enabling and disabling the Online Store capability. */
+type MetaobjectCapabilityOnlineStoreInput = {
+    /** The data associated with the Online Store capability. */
+    data?: InputMaybe<MetaobjectCapabilityDefinitionDataOnlineStoreInput>;
+    /** Indicates whether the capability should be enabled or disabled. */
+    enabled: Scalars['Boolean']['input'];
+};
+/** The input fields for enabling and disabling the publishable capability. */
+type MetaobjectCapabilityPublishableInput = {
+    /** Indicates whether the capability should be enabled or disabled. */
+    enabled: Scalars['Boolean']['input'];
+};
+/** The input fields for enabling and disabling the renderable capability. */
+type MetaobjectCapabilityRenderableInput = {
+    /** The data associated with the renderable capability. */
+    data?: InputMaybe<MetaobjectCapabilityDefinitionDataRenderableInput>;
+    /** Indicates whether the capability should be enabled or disabled. */
+    enabled: Scalars['Boolean']['input'];
+};
+/** The input fields for enabling and disabling the translatable capability. */
+type MetaobjectCapabilityTranslatableInput = {
+    /** Indicates whether the capability should be enabled or disabled. */
+    enabled: Scalars['Boolean']['input'];
+};
+/** Metaobject Capabilities types which can be enabled. */
 declare enum MetaobjectCapabilityType {
     /** Allows for a Metaobject to be rendered as an Online Store page. */
     OnlineStore = "ONLINE_STORE",
@@ -11017,7 +11693,7 @@ type MetaobjectConnection = {
     /** The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node. */
     edges: Array<MetaobjectEdge>;
     /** A list of nodes that are contained in MetaobjectEdge. You can fetch data about an individual node, or you can follow the edges to fetch data about a collection of related nodes. At each node, you specify the fields that you want to retrieve. */
-    nodes: Array<Metaobject>;
+    nodes: Array<Metaobject$1>;
     /** An object that’s used to retrieve [cursor information](https://shopify.dev/api/usage/pagination-graphql) about the current page. */
     pageInfo: PageInfo;
 };
@@ -11057,13 +11733,34 @@ type MetaobjectDefinition = Node & {
     /** The type of the object definition. Defines the namespace of associated metafields. */
     type: Scalars['String']['output'];
 };
+/** The input fields for creating a metaobject definition. */
+type MetaobjectDefinitionCreateInput = {
+    /** Access configuration for the metaobjects created with this definition. */
+    access?: InputMaybe<MetaobjectAccessInput>;
+    /** The capabilities of the metaobject definition. */
+    capabilities?: InputMaybe<MetaobjectCapabilityCreateInput>;
+    /** An administrative description of the definition. */
+    description?: InputMaybe<Scalars['String']['input']>;
+    /** The key of a field to reference as the display name for metaobjects of this type. */
+    displayNameKey?: InputMaybe<Scalars['String']['input']>;
+    /** A set of field definitions to create on this metaobject definition. */
+    fieldDefinitions: Array<MetaobjectFieldDefinitionCreateInput>;
+    /** A human-readable name for the definition. This can be changed at any time. */
+    name?: InputMaybe<Scalars['String']['input']>;
+    /**
+     * The type of the metaobject definition. This can't be changed.
+     *
+     * Must be 3-255 characters long and only contain alphanumeric, hyphen, and underscore characters.
+     */
+    type: Scalars['String']['input'];
+};
 /** An auto-generated type which holds one Metaobject and a cursor during pagination. */
 type MetaobjectEdge = {
     __typename?: 'MetaobjectEdge';
     /** The position of each node in an array, used in [pagination](https://shopify.dev/api/usage/pagination-graphql). */
     cursor: Scalars['String']['output'];
     /** The item at the end of MetaobjectEdge. */
-    node: Metaobject;
+    node: Metaobject$1;
 };
 /** Provides a field definition and the data value assigned to it. */
 type MetaobjectField = {
@@ -11107,6 +11804,39 @@ type MetaobjectFieldDefinition = {
      */
     validations: Array<MetafieldDefinitionValidation>;
 };
+/** The input fields for creating a metaobject field definition. */
+type MetaobjectFieldDefinitionCreateInput = {
+    /** An administrative description of the field. */
+    description?: InputMaybe<Scalars['String']['input']>;
+    /**
+     * The key of the new field definition. This can't be changed.
+     *
+     * Must be 2-64 characters long and only contain alphanumeric, hyphen, and underscore characters.
+     */
+    key: Scalars['String']['input'];
+    /** A human-readable name for the field. This can be changed at any time. */
+    name?: InputMaybe<Scalars['String']['input']>;
+    /** Whether metaobjects require a saved value for the field. */
+    required?: InputMaybe<Scalars['Boolean']['input']>;
+    /** The metafield type applied to values of the field. */
+    type: Scalars['String']['input'];
+    /** Custom validations that apply to values assigned to the field. */
+    validations?: InputMaybe<Array<MetafieldDefinitionValidationInput>>;
+};
+/** The input fields for a metaobject field value. */
+type MetaobjectFieldInput = {
+    /** The key of the field. */
+    key: Scalars['String']['input'];
+    /** The value of the field. */
+    value: Scalars['String']['input'];
+};
+/** The input fields for retrieving a metaobject by handle. */
+type MetaobjectHandleInput = {
+    /** The handle of the metaobject to create or update. */
+    handle: Scalars['String']['input'];
+    /** The type of the metaobject. Must match an existing metaobject definition type. */
+    type: Scalars['String']['input'];
+};
 /** Defines visibility status for metaobjects. */
 declare enum MetaobjectStatus {
     /** The metaobjects is active for public use. */
@@ -11129,6 +11859,100 @@ type MetaobjectThumbnail = {
     /** The hexadecimal color code to be used for respresenting this metaobject. */
     hex?: Maybe<Scalars['String']['output']>;
 };
+/** The input fields for upserting a metaobject. */
+type MetaobjectUpsertInput = {
+    /** Capabilities for the metaobject. */
+    capabilities?: InputMaybe<MetaobjectCapabilityDataInput>;
+    /** Values for fields. These are mapped by key to fields of the metaobject definition. */
+    fields?: InputMaybe<Array<MetaobjectFieldInput>>;
+    /** The handle of the metaobject. */
+    handle?: InputMaybe<Scalars['String']['input']>;
+};
+/** Defines errors encountered while managing metaobject resources. */
+type MetaobjectUserError = DisplayableError & {
+    __typename?: 'MetaobjectUserError';
+    /** The error code. */
+    code?: Maybe<MetaobjectUserErrorCode>;
+    /** The index of the failing list element in an array. */
+    elementIndex?: Maybe<Scalars['Int']['output']>;
+    /** The key of the failing object element. */
+    elementKey?: Maybe<Scalars['String']['output']>;
+    /** The path to the input field that caused the error. */
+    field?: Maybe<Array<Scalars['String']['output']>>;
+    /** The error message. */
+    message: Scalars['String']['output'];
+};
+/** Possible error codes that can be returned by `MetaobjectUserError`. */
+declare enum MetaobjectUserErrorCode {
+    /** Admin access can only be specified on metaobject definitions that have an app-reserved type. */
+    AdminAccessInputNotAllowed = "ADMIN_ACCESS_INPUT_NOT_ALLOWED",
+    /** Definition is managed by app configuration and cannot be modified through the API. */
+    AppConfigManaged = "APP_CONFIG_MANAGED",
+    /** The input value is blank. */
+    Blank = "BLANK",
+    /** The capability you are using is not enabled. */
+    CapabilityNotEnabled = "CAPABILITY_NOT_ENABLED",
+    /** The display name cannot be the same when using the metaobject as a product option. */
+    DisplayNameConflict = "DISPLAY_NAME_CONFLICT",
+    /** Duplicate inputs were provided for this field key. */
+    DuplicateFieldInput = "DUPLICATE_FIELD_INPUT",
+    /** Renderable data input is referencing an invalid field. */
+    FieldTypeInvalid = "FIELD_TYPE_INVALID",
+    /** The targeted object cannot be modified. */
+    Immutable = "IMMUTABLE",
+    /** The input value isn't included in the list. */
+    Inclusion = "INCLUSION",
+    /** The maximum number of input metaobjects has been exceeded. */
+    InputLimitExceeded = "INPUT_LIMIT_EXCEEDED",
+    /** An unexpected error occurred. */
+    InternalError = "INTERNAL_ERROR",
+    /** The input value is invalid. */
+    Invalid = "INVALID",
+    /** The value for the metafield definition option was invalid. */
+    InvalidOption = "INVALID_OPTION",
+    /** The metafield type is invalid. */
+    InvalidType = "INVALID_TYPE",
+    /** The value is invalid for the metafield type or the definition options. */
+    InvalidValue = "INVALID_VALUE",
+    /** The maximum number of metaobjects definitions has been exceeded. */
+    MaxDefinitionsExceeded = "MAX_DEFINITIONS_EXCEEDED",
+    /** The maximum number of metaobjects per shop has been exceeded. */
+    MaxObjectsExceeded = "MAX_OBJECTS_EXCEEDED",
+    /** The input is missing required keys. */
+    MissingRequiredKeys = "MISSING_REQUIRED_KEYS",
+    /** Not authorized. */
+    NotAuthorized = "NOT_AUTHORIZED",
+    /** Missing required fields were found for this object. */
+    ObjectFieldRequired = "OBJECT_FIELD_REQUIRED",
+    /** The specified field key is already in use. */
+    ObjectFieldTaken = "OBJECT_FIELD_TAKEN",
+    /** The input value needs to be blank. */
+    Present = "PRESENT",
+    /** The requested record couldn't be found. */
+    RecordNotFound = "RECORD_NOT_FOUND",
+    /** The action cannot be completed because associated metaobjects are referenced by another resource. */
+    ReferenceExistsError = "REFERENCE_EXISTS_ERROR",
+    /** The provided name is reserved for system use. */
+    ReservedName = "RESERVED_NAME",
+    /** Definition is required by an installed app and cannot be deleted. */
+    StandardMetaobjectDefinitionDependentOnApp = "STANDARD_METAOBJECT_DEFINITION_DEPENDENT_ON_APP",
+    /** The input value is already taken. */
+    Taken = "TAKEN",
+    /** The input value is too long. */
+    TooLong = "TOO_LONG",
+    /** The input value is too short. */
+    TooShort = "TOO_SHORT",
+    /** No field definition found for this key. */
+    UndefinedObjectField = "UNDEFINED_OBJECT_FIELD",
+    /** No metaobject definition found for this type. */
+    UndefinedObjectType = "UNDEFINED_OBJECT_TYPE",
+    /** The Online Store URL handle cannot be blank. */
+    UrlHandleBlank = "URL_HANDLE_BLANK",
+    /** The Online Store URL handle is invalid. */
+    UrlHandleInvalid = "URL_HANDLE_INVALID",
+    /** The Online Store URL handle is already taken. */
+    UrlHandleTaken = "URL_HANDLE_TAKEN"
+}
 /** Represents a Shopify hosted 3D model. */
 type Model3d = File & Media & Node & {
     __typename?: 'Model3d';
@@ -11394,7 +12218,7 @@ type Order = CommentEventSubject & HasEvents & HasLocalizationExtensions & HasLo
      * The customer who placed an order. Returns `null` if an order was created through a checkout without customer authentication, such as a guest checkout.
      * Learn more about [customer accounts](https://help.shopify.com/manual/customers/customer-accounts).
      */
-    customer?: Maybe<Customer>;
+    customer?: Maybe<Customer$1>;
     /**
      * Whether the customer agreed to receive marketing emails at the time of purchase.
      * Use this to ensure compliance with marketing consent laws and to segment customers for email campaigns.
@@ -11480,7 +12304,7 @@ type Order = CommentEventSubject & HasEvents & HasLocalizationExtensions & HasLo
      */
     fulfillmentOrders: FulfillmentOrderConnection;
     /** A list of shipments for the order. Fulfillments represent the physical shipment of products to customers. */
-    fulfillments: Array<Fulfillment>;
+    fulfillments: Array<Fulfillment$1>;
     /** The total number of fulfillments for the order, including canceled ones. */
     fulfillmentsCount?: Maybe<Count>;
     /** Whether the order has been paid in full. This field returns `true` when the total amount received equals or exceeds the order total. */
@@ -11759,7 +12583,7 @@ type Order = CommentEventSubject & HasEvents & HasLocalizationExtensions & HasLo
      * A calculated refund suggestion for the order based on specified line items, shipping, and duties.
      * Use this to preview refund amounts, taxes, and processing fees before creating an actual refund.
      */
-    suggestedRefund?: Maybe<SuggestedRefund>;
+    suggestedRefund?: Maybe<SuggestedRefund$1>;
     /**
      * A comma separated list of tags associated with the order. Updating `tags` overwrites
      * any existing tags that were previously added to the order. To add new tags without overwriting
@@ -11938,6 +12762,17 @@ type OrderAdjustmentEdge = {
     /** The item at the end of OrderAdjustmentEdge. */
     node: OrderAdjustment;
 };
+/** Discrepancy reasons for order adjustments. */
+declare enum OrderAdjustmentInputDiscrepancyReason {
+    /** The discrepancy reason is customer. */
+    Customer = "CUSTOMER",
+    /** The discrepancy reason is damage. */
+    Damage = "DAMAGE",
+    /** The discrepancy reason is not one of the predefined reasons. */
+    Other = "OTHER",
+    /** The discrepancy reason is restocking. */
+    Restock = "RESTOCK"
+}
 /**
  * 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.
  *
@@ -12266,7 +13101,9 @@ type OrderTransaction = Node & {
     processedAt?: Maybe<Scalars['DateTime']['output']>;
     /**
      * The transaction receipt that the payment gateway attaches to the transaction.
-     * The value of this field depends on which payment gateway processed the transaction.
+     * > **Note:** This field is **gateway-specific** and **not a stable contract**.
+     * > Its structure and contents can vary by payment gateway and may change without notice.
+     * > Apps **shouldn't parse or rely on this field for business logic**; prefer typed fields on `OrderTransaction` and related objects.
      */
     receiptJson?: Maybe<Scalars['JSON']['output']>;
     /** The settlement currency. */
@@ -12374,6 +13211,19 @@ declare enum OrderTransactionErrorCode {
     /** The gateway or merchant configuration doesn't support a feature, such as network tokenization. */
     UnsupportedFeature = "UNSUPPORTED_FEATURE"
 }
+/** The input fields for the information needed to create an order transaction. */
+type OrderTransactionInput = {
+    /** The amount of money for this transaction. */
+    amount: Scalars['Money']['input'];
+    /** The payment gateway to use for this transaction. */
+    gateway: Scalars['String']['input'];
+    /** The kind of transaction. */
+    kind: OrderTransactionKind;
+    /** The ID of the order associated with the transaction. */
+    orderId: Scalars['ID']['input'];
+    /** The ID of the optional parent transaction, for example the authorization of a capture. */
+    parentId?: InputMaybe<Scalars['ID']['input']>;
+};
 /** The different kinds of order transactions. */
 declare enum OrderTransactionKind {
     /**
@@ -12764,7 +13614,7 @@ type PriceListPrice = {
     /** A list of quantity breaks for the product variant. */
     quantityPriceBreaks: QuantityPriceBreakConnection;
     /** The product variant associated with this price. */
-    variant: ProductVariant;
+    variant: ProductVariant$1;
 };
 /** An auto-generated type for paginating through multiple PriceListPrices. */
 type PriceListPriceConnection = {
@@ -13041,6 +13891,7 @@ type Product = HasEvents & HasMetafieldDefinitions & HasMetafields & HasPublishe
      * Whether the resource is published to the app's
      * [publication](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication).
      * For example, the resource might be published to the app's online store channel.
+     * @deprecated Use `publishedOnPublication` instead.
      */
     publishedOnCurrentPublication: Scalars['Boolean']['output'];
     /**
@@ -13058,6 +13909,7 @@ type Product = HasEvents & HasMetafieldDefinitions & HasMetafields & HasPublishe
     /**
      * The resource that's either published or staged to be published to
      * the [publication](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication).
+     * @deprecated Use `resourcePublications` instead.
      */
     resourcePublicationOnCurrentPublication?: Maybe<ResourcePublicationV2>;
     /**
@@ -13468,7 +14320,7 @@ type ProductTaxonomyNode = Node & {
  *
  * Learn more about [Shopify's product model](https://shopify.dev/docs/apps/build/graphql/migrate/new-product-model/product-model-components).
  */
-type ProductVariant = HasEvents & HasMetafieldDefinitions & HasMetafields & HasPublishedTranslations & LegacyInteroperability & Navigable & Node & {
+type ProductVariant$1 = HasEvents & HasMetafieldDefinitions & HasMetafields & HasPublishedTranslations & LegacyInteroperability & Navigable & Node & {
     __typename?: 'ProductVariant';
     /** Whether the product variant is available for sale. */
     availableForSale: Scalars['Boolean']['output'];
@@ -13596,7 +14448,7 @@ type ProductVariantComponent = Node & {
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
     /** The product variant associated with the component. */
-    productVariant: ProductVariant;
+    productVariant: ProductVariant$1;
     /** The required quantity of the component. */
     quantity: Scalars['Int']['output'];
 };
@@ -13624,7 +14476,7 @@ type ProductVariantConnection = {
     /** The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node. */
     edges: Array<ProductVariantEdge>;
     /** A list of nodes that are contained in ProductVariantEdge. You can fetch data about an individual node, or you can follow the edges to fetch data about a collection of related nodes. At each node, you specify the fields that you want to retrieve. */
-    nodes: Array<ProductVariant>;
+    nodes: Array<ProductVariant$1>;
     /** An object that’s used to retrieve [cursor information](https://shopify.dev/api/usage/pagination-graphql) about the current page. */
     pageInfo: PageInfo;
 };
@@ -13649,7 +14501,7 @@ type ProductVariantEdge = {
     /** The position of each node in an array, used in [pagination](https://shopify.dev/api/usage/pagination-graphql). */
     cursor: Scalars['String']['output'];
     /** The item at the end of ProductVariantEdge. */
-    node: ProductVariant;
+    node: ProductVariant$1;
 };
 /** The valid values for the inventory policy of a product variant once it is out of stock. */
 declare enum ProductVariantInventoryPolicy {
@@ -13684,6 +14536,45 @@ type ProductVariantPricePairEdge = {
     /** The item at the end of ProductVariantPricePairEdge. */
     node: ProductVariantPricePair;
 };
+/** The input fields for specifying a product variant to create as part of a variant bulk mutation. */
+type ProductVariantsBulkInput = {
+    /** The value of the barcode associated with the product variant. */
+    barcode?: InputMaybe<Scalars['String']['input']>;
+    /** The compare-at price of the variant. */
+    compareAtPrice?: InputMaybe<Scalars['Money']['input']>;
+    /** Specifies the product variant to update or delete. */
+    id?: InputMaybe<Scalars['ID']['input']>;
+    /** The inventory item associated with the variant, used for unit cost. */
+    inventoryItem?: InputMaybe<InventoryItemInput>;
+    /** Whether customers are allowed to place an order for the variant when it's out of stock. Defaults to `DENY`. */
+    inventoryPolicy?: InputMaybe<ProductVariantInventoryPolicy>;
+    /**
+     * The inventory quantities at each location where the variant is stocked. The number of elements
+     * in the array of inventory quantities can't exceed the amount specified for the plan.
+     * Supported as input with the `productVariantsBulkCreate` mutation only.
+     */
+    inventoryQuantities?: InputMaybe<Array<InventoryLevelInput>>;
+    /** The ID of the media that's associated with the variant. */
+    mediaId?: InputMaybe<Scalars['ID']['input']>;
+    /** The URL of the media to associate with the variant. */
+    mediaSrc?: InputMaybe<Array<Scalars['String']['input']>>;
+    /** The additional customizable information about the product variant. */
+    metafields?: InputMaybe<Array<MetafieldInput>>;
+    /** The custom properties that a shop owner uses to define product variants. */
+    optionValues?: InputMaybe<Array<VariantOptionValueInput>>;
+    /** The price of the variant. */
+    price?: InputMaybe<Scalars['Money']['input']>;
+    /**
+     * Whether a product variant requires components. The default value is `false`.
+     * If `true`, then the product variant can only be purchased as a parent bundle with components and it will be
+     * omitted from channels that don't support bundles.
+     */
+    requiresComponents?: InputMaybe<Scalars['Boolean']['input']>;
+    /** The tax code associated with the variant. */
+    taxCode?: InputMaybe<Scalars['String']['input']>;
+    /** Whether the variant is taxable. */
+    taxable?: InputMaybe<Scalars['Boolean']['input']>;
+};
 /** Error codes for failed variant bulk update mutations. */
 type ProductVariantsBulkUpdateUserError = DisplayableError & {
     __typename?: 'ProductVariantsBulkUpdateUserError';
@@ -13859,6 +14750,7 @@ type Publishable = {
      * Whether the resource is published to the app's
      * [publication](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication).
      * For example, the resource might be published to the app's online store channel.
+     * @deprecated Use `publishedOnPublication` instead.
      */
     publishedOnCurrentPublication: Scalars['Boolean']['output'];
     /**
@@ -13905,7 +14797,7 @@ type PurchasingCompany = {
     location: CompanyLocation;
 };
 /** Represents information about the purchasing entity for the order or draft order. */
-type PurchasingEntity = Customer | PurchasingCompany;
+type PurchasingEntity = Customer$1 | PurchasingCompany;
 /**
  * Quantity price breaks lets you offer different rates that are based on the
  * amount of a specific variant being ordered.
@@ -13921,7 +14813,7 @@ type QuantityPriceBreak = Node & {
     /** The price list associated with this quantity break. */
     priceList: PriceList;
     /** The product variant associated with this quantity break. */
-    variant: ProductVariant;
+    variant: ProductVariant$1;
 };
 /** An auto-generated type for paginating through multiple QuantityPriceBreaks. */
 type QuantityPriceBreakConnection = {
@@ -13967,7 +14859,7 @@ type QuantityRule = {
     /** Whether the values of the quantity rule were explicitly set. */
     originType: QuantityRuleOriginType;
     /** The product variant for which the quantity rule is applied. */
-    productVariant: ProductVariant;
+    productVariant: ProductVariant$1;
 };
 /** An auto-generated type for paginating through multiple QuantityRules. */
 type QuantityRuleConnection = {
@@ -14085,6 +14977,20 @@ type RefundDuty = {
     /** The duty associated with this refunded duty. */
     originalDuty?: Maybe<Duty>;
 };
+/** The input fields required to reimburse duties on a refund. */
+type RefundDutyInput = {
+    /** The ID of the duty in the refund. */
+    dutyId: Scalars['ID']['input'];
+    /** The type of refund for this duty. */
+    refundType?: InputMaybe<RefundDutyRefundType>;
+};
+/** The type of refund to perform for a particular refund duty. */
+declare enum RefundDutyRefundType {
+    /** The duty is fully refunded. */
+    Full = "FULL",
+    /** The duty is proportionally refunded based on the quantity of the refunded line item. */
+    Proportional = "PROPORTIONAL"
+}
 /** An auto-generated type which holds one Refund and a cursor during pagination. */
 type RefundEdge = {
     __typename?: 'RefundEdge';
@@ -14093,6 +14999,27 @@ type RefundEdge = {
     /** The item at the end of RefundEdge. */
     node: Refund;
 };
+/** The input fields to create a refund. */
+type RefundInput = {
+    /** The currency that is used to refund the order. This must be the presentment currency, which is the currency used by the customer. This is a required field for orders where the currency and presentment currency differ. */
+    currency?: InputMaybe<CurrencyCode>;
+    /** An optional reason for a discrepancy between calculated and actual refund amounts. */
+    discrepancyReason?: InputMaybe<OrderAdjustmentInputDiscrepancyReason>;
+    /** An optional note that's attached to the refund. */
+    note?: InputMaybe<Scalars['String']['input']>;
+    /** Whether to send a refund notification to the customer. */
+    notify?: InputMaybe<Scalars['Boolean']['input']>;
+    /** The ID of the order that's being refunded. */
+    orderId: Scalars['ID']['input'];
+    /** A list of duties to refund. */
+    refundDuties?: InputMaybe<Array<RefundDutyInput>>;
+    /** A list of line items to refund. */
+    refundLineItems?: InputMaybe<Array<RefundLineItemInput>>;
+    /** The input fields that are required to reimburse shipping costs. */
+    shipping?: InputMaybe<ShippingRefundInput>;
+    /** A list of transactions involved in the refund. */
+    transactions?: InputMaybe<Array<OrderTransactionInput>>;
+};
 /**
  * A [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) or [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) being refunded from an order. Each refund line item tracks the quantity, pricing, and restocking details for items returned to the merchant.
  *
@@ -14152,6 +15079,17 @@ type RefundLineItemEdge = {
     /** The item at the end of RefundLineItemEdge. */
     node: RefundLineItem;
 };
+/** The input fields required to reimburse line items on a refund. */
+type RefundLineItemInput = {
+    /** The ID of the line item in the refund. */
+    lineItemId: Scalars['ID']['input'];
+    /** The intended location for restocking. If the `restockType` is set to `NO_RESTOCK`, then this value is empty. */
+    locationId?: InputMaybe<Scalars['ID']['input']>;
+    /** The quantity of the associated line item to be refunded. */
+    quantity: Scalars['Int']['input'];
+    /** The type of restock for this line item. */
+    restockType?: InputMaybe<RefundLineItemRestockType>;
+};
 /** The type of restock performed for a particular refund line item. */
 declare enum RefundLineItemRestockType {
     /** The refund line item was canceled. Use this when restocking unfulfilled line items. */
@@ -14994,6 +15932,20 @@ type Segment = Node & {
     /** A precise definition of the segment. The definition is composed of a combination of conditions on facts about customers. */
     query: Scalars['String']['output'];
 };
+/** The statistics of a given attribute. */
+type SegmentAttributeStatistics$1 = {
+    __typename?: 'SegmentAttributeStatistics';
+    /** The average of a given attribute. */
+    average: Scalars['Float']['output'];
+    /** The sum of a given attribute. */
+    sum: Scalars['Float']['output'];
+};
+/** The statistics of a given segment. */
+type SegmentStatistics = {
+    __typename?: 'SegmentStatistics';
+    /** The statistics of a given attribute. */
+    attributeStatistics: SegmentAttributeStatistics$1;
+};
 /**
  * Properties used by customers to select a product variant.
  * Products can have multiple options, like different sizes or colors.
@@ -15575,6 +16527,13 @@ type ShippingRefund = {
     /** The monetary value of the tax allocated to shipping fees to be refunded in shop and presentment currencies. */
     taxSet: MoneyBag;
 };
+/** The input fields that are required to reimburse shipping costs. */
+type ShippingRefundInput = {
+    /** The monetary value of the shipping fees to be reimbursed. */
+    amount?: InputMaybe<Scalars['Money']['input']>;
+    /** Whether a full refund is provided. */
+    fullRefund?: InputMaybe<Scalars['Boolean']['input']>;
+};
 /**
  * The central configuration and settings hub for a Shopify store. Access business information, operational preferences, feature availability, and store-wide settings that control how the shop operates.
  *
@@ -17299,21 +18258,27 @@ type SubscriptionBillingAttempt = Node & {
     createdAt: Scalars['DateTime']['output'];
     /**
      * A code corresponding to a payment error during processing.
-     * @deprecated Use `processingError.code` instead to get the errorCode
+     * @deprecated Use `state` instead.
      */
     errorCode?: Maybe<SubscriptionBillingAttemptErrorCode>;
     /**
      * A message describing a payment error during processing.
-     * @deprecated Use `processingError.message` instead to get the errorMessage
+     * @deprecated Use `state` instead.
      */
     errorMessage?: Maybe<Scalars['String']['output']>;
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
     /** A unique key generated by the client to avoid duplicate payments. */
     idempotencyKey: Scalars['String']['output'];
-    /** The URL where the customer needs to be redirected so they can complete the 3D Secure payment flow. */
+    /**
+     * The URL where the customer needs to be redirected so they can complete the 3D Secure payment flow.
+     * @deprecated Use `state` instead.
+     */
     nextActionUrl?: Maybe<Scalars['URL']['output']>;
-    /** The result of this billing attempt if completed successfully. */
+    /**
+     * The result of this billing attempt if completed successfully.
+     * @deprecated Use `state` instead.
+     */
     order?: Maybe<Order>;
     /**
      * The date and time used to calculate fulfillment intervals for a billing attempt that
@@ -17325,9 +18290,15 @@ type SubscriptionBillingAttempt = Node & {
     paymentGroupId?: Maybe<Scalars['String']['output']>;
     /** The reference shared between payment attempts with similar payment details. */
     paymentSessionId?: Maybe<Scalars['String']['output']>;
-    /** Error information from processing the billing attempt. */
+    /**
+     * Error information from processing the billing attempt.
+     * @deprecated Use `state` instead.
+     */
     processingError?: Maybe<SubscriptionBillingAttemptProcessingError>;
-    /** Whether the billing attempt is still processing. */
+    /**
+     * Whether the billing attempt is still processing.
+     * @deprecated Use `state` instead.
+     */
     ready: Scalars['Boolean']['output'];
     /** Whether the billing attempt respects the merchant's inventory policy. */
     respectInventoryPolicy: Scalars['Boolean']['output'];
@@ -17361,7 +18332,7 @@ type SubscriptionBillingAttemptEdge = {
 declare enum SubscriptionBillingAttemptErrorCode {
     /** The amount is too small. */
     AmountTooSmall = "AMOUNT_TOO_SMALL",
-    /** There was an error during the authentication. */
+    /** There was an error during the payment authentication. */
     AuthenticationError = "AUTHENTICATION_ERROR",
     /** Payment method was canceled by buyer. */
     BuyerCanceledPaymentMethod = "BUYER_CANCELED_PAYMENT_METHOD",
@@ -17457,7 +18428,7 @@ type SubscriptionContract = Node & SubscriptionContractBase & {
     /** A list of the custom attributes to be added to the generated orders. */
     customAttributes: Array<Attribute>;
     /** The customer to whom the subscription contract belongs. */
-    customer?: Maybe<Customer>;
+    customer?: Maybe<Customer$1>;
     /** The customer payment method that's used for the subscription contract. */
     customerPaymentMethod?: Maybe<CustomerPaymentMethod>;
     /** The delivery method for each billing of the subscription contract. */
@@ -17514,7 +18485,7 @@ type SubscriptionContractBase = {
     /** A list of the custom attributes to be added to the generated orders. */
     customAttributes: Array<Attribute>;
     /** The customer to whom the subscription contract belongs. */
-    customer?: Maybe<Customer>;
+    customer?: Maybe<Customer$1>;
     /** The customer payment method that's used for the subscription contract. */
     customerPaymentMethod?: Maybe<CustomerPaymentMethod>;
     /** The delivery method for each billing of the subscription contract. */
@@ -17960,7 +18931,7 @@ declare enum SuggestedOrderTransactionKind {
  *
  * 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 = {
+type SuggestedRefund$1 = {
     __typename?: 'SuggestedRefund';
     /**
      * The total monetary value to be refunded.
@@ -18432,6 +19403,19 @@ type UserError = DisplayableError & {
     /** The error message. */
     message: Scalars['String']['output'];
 };
+/** The input fields required to create or modify a product variant's option value. */
+type VariantOptionValueInput = {
+    /** Specifies the product option value by ID. */
+    id?: InputMaybe<Scalars['ID']['input']>;
+    /** Metafield value associated with an option. */
+    linkedMetafieldValue?: InputMaybe<Scalars['String']['input']>;
+    /** Specifies the product option value by name. */
+    name?: InputMaybe<Scalars['String']['input']>;
+    /** Specifies the product option by ID. */
+    optionId?: InputMaybe<Scalars['ID']['input']>;
+    /** Specifies the product option by name. */
+    optionName?: InputMaybe<Scalars['String']['input']>;
+};
 /** Represents a credit card payment instrument. */
 type VaultCreditCard = {
     __typename?: 'VaultCreditCard';
@@ -18553,6 +19537,13 @@ type Weight = {
     /** The weight value using the unit system specified with `unit`. */
     value: Scalars['Float']['output'];
 };
+/** The input fields for the weight unit and value inputs. */
+type WeightInput = {
+    /** Unit of measurement for `value`. */
+    unit: WeightUnit;
+    /** The weight value using the unit system specified with `weight_unit`. */
+    value: Scalars['Float']['input'];
+};
 /** Units of measurement for weight. */
 declare enum WeightUnit {
     /** Metric system unit of mass. */
@@ -18565,6 +19556,104 @@ declare enum WeightUnit {
     Pounds = "POUNDS"
 }
 
+type CreateRefundLineItem = {
+    lineItemId: number | bigint | string;
+    quantity: number;
+    restockType?: 'NO_RESTOCK' | 'CANCEL' | 'RETURN';
+    locationId?: number | bigint | string;
+};
+type CreateRefundTransaction = {
+    amount: string;
+    gateway: string;
+    parentId?: number | bigint | string;
+};
+type CreateRefundOptions = {
+    currency?: CurrencyCode;
+    note?: string;
+    notify?: boolean;
+    refundLineItems?: CreateRefundLineItem[];
+    shipping?: {
+        fullRefund?: boolean;
+        amount?: string;
+    };
+    transactions?: CreateRefundTransaction[];
+};
+type RefundMoney = {
+    amount: string;
+    currencyCode: string;
+};
+type CreateRefundResult = {
+    id: string;
+    totalRefunded: {
+        shopMoney: RefundMoney;
+        presentmentMoney: RefundMoney;
+    };
+};
+/**
+ * Creates a refund for an order.
+ *
+ * @param orderId - The order ID (numeric, bigint, or GID string)
+ * @param options - Refund configuration options
+ * @returns Promise resolving to the created refund
+ * @throws {ShopifyUserError} When the mutation fails
+ * @throws {Error} When GraphQL errors occur
+ *
+ * @example
+ * await createRefund(12345678901234, {
+ *   currency: 'EUR',
+ *   notify: true,
+ *   note: 'Customer return',
+ *   refundLineItems: [
+ *     { lineItemId: 111, quantity: 1, restockType: 'NO_RESTOCK' }
+ *   ],
+ *   transactions: [
+ *     { amount: '25.00', gateway: 'shopify_payments', parentId: 222 }
+ *   ]
+ * })
+ */
+declare function createRefund(orderId: number | bigint | string, options?: CreateRefundOptions): Promise<CreateRefundResult>;
+
+type VariantUpdateInput = Omit<ProductVariantsBulkInput, 'id'> & {
+    id: string;
+};
+type BulkUpdateProductVariantsResult = {
+    id: string;
+    sku: string | null;
+};
+/**
+ * Bulk updates product variants.
+ *
+ * @param productId - The product GID
+ * @param variants - Array of variant updates (id required, plus fields to update)
+ * @returns Array of updated variants with id and sku
+ * @throws {ShopifyUserError} When the mutation fails
+ */
+declare function bulkUpdateProductVariants(productId: string, variants: VariantUpdateInput[]): Promise<BulkUpdateProductVariantsResult[]>;
+
+type UpsertMetaobjectInput = {
+    type: string;
+    handle: string;
+    fields: MetaobjectFieldInput[];
+};
+type UpsertMetaobjectResult = {
+    id: string;
+    handle: string;
+    displayName: string;
+    fields: Array<{
+        key: string;
+        value: string | null;
+    }>;
+};
+/**
+ * Creates or updates a metaobject in Shopify based on its type and handle.
+ *
+ * @param input - The metaobject type, handle, and fields
+ * @returns The created/updated metaobject
+ * @throws {ShopifyUserError} When the upsert fails due to validation errors
+ * @throws {Error} When GraphQL errors occur or no metaobject is returned
+ */
+declare function upsertMetaobject(input: UpsertMetaobjectInput): Promise<UpsertMetaobjectResult>;
+
 type CustomerDeleteMutationVariables = Exact<{
     input: CustomerDeleteInput;
 }>;
@@ -18573,6 +19662,69 @@ type CustomerDeleteMutation = {
         userErrors: Array<Pick<UserError, 'field' | 'message'>>;
     })>;
 };
+type CreateFileMutationVariables = Exact<{
+    files: Array<FileCreateInput> | FileCreateInput;
+}>;
+type CreateFileMutation = {
+    fileCreate?: Maybe<{
+        files?: Maybe<Array<Pick<ExternalVideo, 'id'> | Pick<GenericFile, 'id'> | Pick<MediaImage, 'id'> | Pick<Model3d, 'id'> | Pick<Video, 'id'>>>;
+        userErrors: Array<Pick<FilesUserError, 'code' | 'field' | 'message'>>;
+    }>;
+};
+type FileDeleteMutationVariables = Exact<{
+    fileIds: Array<Scalars['ID']['input']> | Scalars['ID']['input'];
+}>;
+type FileDeleteMutation = {
+    fileDelete?: Maybe<(Pick<FileDeletePayload, 'deletedFileIds'> & {
+        userErrors: Array<Pick<FilesUserError, 'code' | 'field' | 'message'>>;
+    })>;
+};
+type CreateFulfillmentMutationVariables = Exact<{
+    fulfillment: FulfillmentInput;
+}>;
+type CreateFulfillmentMutation = {
+    fulfillmentCreate?: Maybe<{
+        fulfillment?: Maybe<(Pick<Fulfillment$1, 'id' | 'status'> & {
+            trackingInfo: Array<Pick<FulfillmentTrackingInfo, 'company' | 'number'>>;
+        })>;
+        userErrors: Array<Pick<UserError, 'field' | 'message'>>;
+    }>;
+};
+type UpdateFulfillmentTrackingMutationVariables = Exact<{
+    fulfillmentId: Scalars['ID']['input'];
+    trackingNumbers: Array<Scalars['String']['input']> | Scalars['String']['input'];
+    company?: InputMaybe<Scalars['String']['input']>;
+    notifyCustomer?: InputMaybe<Scalars['Boolean']['input']>;
+}>;
+type UpdateFulfillmentTrackingMutation = {
+    fulfillmentTrackingInfoUpdate?: Maybe<{
+        fulfillment?: Maybe<{
+            trackingInfo: Array<Pick<FulfillmentTrackingInfo, 'number' | 'company'>>;
+        }>;
+        userErrors: Array<Pick<UserError, 'field' | 'message'>>;
+    }>;
+};
+type CreateMetaobjectDefinitionMutationVariables = Exact<{
+    definition: MetaobjectDefinitionCreateInput;
+}>;
+type CreateMetaobjectDefinitionMutation = {
+    metaobjectDefinitionCreate?: Maybe<{
+        metaobjectDefinition?: Maybe<Pick<MetaobjectDefinition, 'id' | 'name' | 'type'>>;
+        userErrors: Array<Pick<MetaobjectUserError, 'code' | 'field' | 'message'>>;
+    }>;
+};
+type UpsertMetaobjectMutationVariables = Exact<{
+    handle: MetaobjectHandleInput;
+    metaobject: MetaobjectUpsertInput;
+}>;
+type UpsertMetaobjectMutation = {
+    metaobjectUpsert?: Maybe<{
+        metaobject?: Maybe<(Pick<Metaobject$1, 'id' | 'handle' | 'displayName'> & {
+            fields: Array<Pick<MetaobjectField, 'key' | 'value'>>;
+        })>;
+        userErrors: Array<Pick<MetaobjectUserError, 'code' | 'field' | 'message'>>;
+    }>;
+};
 type OrderCancelMutationVariables = Exact<{
     orderId: Scalars['ID']['input'];
 }>;
@@ -18581,6 +19733,16 @@ type OrderCancelMutation = {
         orderCancelUserErrors: Array<Pick<OrderCancelUserError, 'code' | 'field' | 'message'>>;
     }>;
 };
+type BulkUpdateProductVariantsMutationVariables = Exact<{
+    productId: Scalars['ID']['input'];
+    variants: Array<ProductVariantsBulkInput> | ProductVariantsBulkInput;
+}>;
+type BulkUpdateProductVariantsMutation = {
+    productVariantsBulkUpdate?: Maybe<{
+        productVariants?: Maybe<Array<Pick<ProductVariant$1, 'id' | 'sku'>>>;
+        userErrors: Array<Pick<ProductVariantsBulkUpdateUserError, 'code' | 'field' | 'message'>>;
+    }>;
+};
 type ConnectMetaObjectToProductVariantMutationVariables = Exact<{
     productId: Scalars['ID']['input'];
     variantId: Scalars['ID']['input'];
@@ -18589,10 +19751,176 @@ type ConnectMetaObjectToProductVariantMutationVariables = Exact<{
 }>;
 type ConnectMetaObjectToProductVariantMutation = {
     productVariantsBulkUpdate?: Maybe<{
-        productVariants?: Maybe<Array<Pick<ProductVariant, 'id'>>>;
+        productVariants?: Maybe<Array<Pick<ProductVariant$1, 'id'>>>;
         userErrors: Array<Pick<ProductVariantsBulkUpdateUserError, 'field' | 'message'>>;
     }>;
 };
+type CreateRefundMutationVariables = Exact<{
+    input: RefundInput;
+}>;
+type CreateRefundMutation = {
+    refundCreate?: Maybe<{
+        refund?: Maybe<(Pick<Refund, 'id'> & {
+            totalRefundedSet: {
+                shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+                presentmentMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+            };
+        })>;
+        userErrors: Array<Pick<UserError, 'field' | 'message'>>;
+    }>;
+};
+type CustomerSegmentMembersWithStatisticsQueryVariables = Exact<{
+    query: Scalars['String']['input'];
+    first: Scalars['Int']['input'];
+    statisticsAttributeName: Scalars['String']['input'];
+}>;
+type CustomerSegmentMembersWithStatisticsQuery = {
+    customerSegmentMembers: (Pick<CustomerSegmentMemberConnection, 'totalCount'> & {
+        statistics: {
+            attributeStatistics: Pick<SegmentAttributeStatistics$1, 'sum' | 'average'>;
+        };
+        edges: Array<{
+            node: (Pick<CustomerSegmentMember$1, 'id' | 'firstName' | 'lastName' | 'displayName'> & {
+                defaultEmailAddress?: Maybe<Pick<CustomerEmailAddress, 'emailAddress'>>;
+            });
+        }>;
+        pageInfo: Pick<PageInfo, 'hasNextPage' | 'endCursor'>;
+    });
+};
+type CustomersByEmailQueryVariables = Exact<{
+    query: Scalars['String']['input'];
+    first: Scalars['Int']['input'];
+}>;
+type CustomersByEmailQuery = {
+    customers: {
+        edges: Array<{
+            node: (Pick<Customer$1, 'id' | 'email' | 'firstName' | 'lastName' | 'numberOfOrders'> & {
+                amountSpent: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+                defaultAddress?: Maybe<Pick<MailingAddress, 'id' | 'address1' | 'address2' | 'city' | 'province' | 'country' | 'zip' | 'phone'>>;
+                addresses: Array<Pick<MailingAddress, 'id' | 'address1' | 'address2' | 'city' | 'province' | 'country' | 'zip' | 'phone'>>;
+            });
+        }>;
+    };
+};
+type FulfillmentOrdersByOrderIdQueryVariables = Exact<{
+    orderId: Scalars['ID']['input'];
+}>;
+type FulfillmentOrdersByOrderIdQuery = {
+    order?: Maybe<{
+        fulfillmentOrders: {
+            edges: Array<{
+                node: (Pick<FulfillmentOrder$1, 'id' | 'status'> & {
+                    lineItems: {
+                        edges: Array<{
+                            node: (Pick<FulfillmentOrderLineItem, 'id' | 'remainingQuantity' | 'totalQuantity'> & {
+                                lineItem: Pick<LineItem, 'id'>;
+                            });
+                        }>;
+                    };
+                });
+            }>;
+        };
+    }>;
+};
+type FulfillmentByIdQueryVariables = Exact<{
+    id: Scalars['ID']['input'];
+}>;
+type FulfillmentByIdQuery = {
+    fulfillment?: Maybe<(Pick<Fulfillment$1, 'id' | 'name' | 'createdAt' | 'updatedAt' | 'status' | 'totalQuantity' | 'estimatedDeliveryAt' | 'deliveredAt'> & {
+        location?: Maybe<Pick<Location, 'id' | 'legacyResourceId' | 'name'>>;
+        service?: Maybe<Pick<FulfillmentService, 'handle' | 'serviceName'>>;
+        trackingInfo: Array<Pick<FulfillmentTrackingInfo, 'company' | 'number' | 'url'>>;
+        originAddress?: Maybe<Pick<FulfillmentOriginAddress, 'address1' | 'address2' | 'city' | 'countryCode' | 'provinceCode' | 'zip'>>;
+        fulfillmentLineItems: {
+            edges: Array<{
+                node: (Pick<FulfillmentLineItem, 'id' | 'quantity'> & {
+                    originalTotalSet: {
+                        shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+                    };
+                    lineItem: (Pick<LineItem, 'id' | 'title' | 'sku'> & {
+                        variant?: Maybe<Pick<ProductVariant$1, 'id'>>;
+                    });
+                });
+            }>;
+        };
+    })>;
+};
+type FulfillmentTrackingIdsQueryVariables = Exact<{
+    id: Scalars['ID']['input'];
+}>;
+type FulfillmentTrackingIdsQuery = {
+    fulfillment?: Maybe<(Pick<Fulfillment$1, 'id'> & {
+        trackingInfo: Array<Pick<FulfillmentTrackingInfo, 'company' | 'number'>>;
+    })>;
+};
+type MetaobjectByHandleQueryVariables = Exact<{
+    handle: MetaobjectHandleInput;
+}>;
+type MetaobjectByHandleQuery = {
+    metaobjectByHandle?: Maybe<(Pick<Metaobject$1, 'id' | 'handle' | 'type' | 'displayName' | 'updatedAt'> & {
+        fields: Array<Pick<MetaobjectField, 'key' | 'value' | 'type'>>;
+    })>;
+};
+type SuggestedRefundQueryVariables = Exact<{
+    orderId: Scalars['ID']['input'];
+    refundLineItems?: InputMaybe<Array<RefundLineItemInput> | RefundLineItemInput>;
+    refundShipping?: InputMaybe<Scalars['Boolean']['input']>;
+    shippingAmount?: InputMaybe<Scalars['Money']['input']>;
+    suggestFullRefund?: InputMaybe<Scalars['Boolean']['input']>;
+}>;
+type SuggestedRefundQuery = {
+    order?: Maybe<(Pick<Order, 'id' | 'name'> & {
+        suggestedRefund?: Maybe<{
+            amountSet: {
+                shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+            };
+            maximumRefundableSet: {
+                shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+            };
+            subtotalSet: {
+                shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+            };
+            totalTaxSet: {
+                shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+            };
+            discountedSubtotalSet: {
+                shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+            };
+            totalCartDiscountAmountSet: {
+                shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+            };
+            shipping: {
+                amountSet: {
+                    shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+                };
+                maximumRefundableSet: {
+                    shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+                };
+            };
+            refundLineItems: Array<(Pick<RefundLineItem, 'quantity' | 'restockType'> & {
+                lineItem: Pick<LineItem, 'id' | 'sku' | 'title' | 'quantity'>;
+                priceSet: {
+                    shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+                };
+                subtotalSet: {
+                    shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+                };
+                totalTaxSet: {
+                    shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+                };
+            })>;
+            suggestedTransactions: Array<(Pick<SuggestedOrderTransaction, 'gateway' | 'kind'> & {
+                amountSet: {
+                    shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+                };
+                maximumRefundableSet?: Maybe<{
+                    shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+                }>;
+                parentTransaction?: Maybe<Pick<OrderTransaction, 'id'>>;
+            })>;
+        }>;
+    })>;
+};
 type OrderByIdQueryVariables = Exact<{
     id: Scalars['ID']['input'];
 }>;
@@ -18601,7 +19929,7 @@ type OrderByIdQuery = {
         totalPriceSet: {
             shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
         };
-        customer?: Maybe<(Pick<Customer, 'id' | 'lastName' | 'displayName' | 'firstName'> & {
+        customer?: Maybe<(Pick<Customer$1, 'id' | 'lastName' | 'displayName' | 'firstName'> & {
             defaultEmailAddress?: Maybe<Pick<CustomerEmailAddress, 'emailAddress'>>;
         })>;
         shippingAddress?: Maybe<Pick<MailingAddress, 'firstName' | 'lastName' | 'address1' | 'address2' | 'city' | 'province' | 'country' | 'zip'>>;
@@ -18615,7 +19943,7 @@ type OrderByIdFullQuery = {
         totalPriceSet: {
             shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
         };
-        customer?: Maybe<Pick<Customer, 'id' | 'firstName' | 'lastName' | 'email' | 'phone'>>;
+        customer?: Maybe<Pick<Customer$1, 'id' | 'firstName' | 'lastName' | 'email' | 'phone'>>;
         shippingAddress?: Maybe<Pick<MailingAddress, 'firstName' | 'lastName' | 'address1' | 'address2' | 'city' | 'province' | 'country' | 'zip'>>;
         billingAddress?: Maybe<Pick<MailingAddress, 'firstName' | 'lastName' | 'address1' | 'address2' | 'city' | 'province' | 'country' | 'zip'>>;
         lineItems: {
@@ -18629,7 +19957,7 @@ type OrderByIdFullQuery = {
                 });
             }>;
         };
-        fulfillments: Array<(Pick<Fulfillment, 'id' | 'name' | 'totalQuantity' | 'status' | 'createdAt' | 'estimatedDeliveryAt' | 'deliveredAt'> & {
+        fulfillments: Array<(Pick<Fulfillment$1, 'id' | 'name' | 'totalQuantity' | 'status' | 'createdAt' | 'estimatedDeliveryAt' | 'deliveredAt'> & {
             trackingInfo: Array<Pick<FulfillmentTrackingInfo, 'company' | 'number' | 'url'>>;
             fulfillmentLineItems: {
                 edges: Array<{
@@ -18670,7 +19998,7 @@ type OrdersByNameQuery = {
                 totalPriceSet: {
                     shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
                 };
-                customer?: Maybe<(Pick<Customer, 'id' | 'lastName' | 'displayName' | 'firstName'> & {
+                customer?: Maybe<(Pick<Customer$1, 'id' | 'lastName' | 'displayName' | 'firstName'> & {
                     defaultEmailAddress?: Maybe<Pick<CustomerEmailAddress, 'emailAddress'>>;
                 })>;
             });
@@ -18726,11 +20054,11 @@ type OrdersByNameFullQuery = {
                     presentmentMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
                     shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
                 };
-                customer?: Maybe<(Pick<Customer, 'id' | 'lastName' | 'displayName' | 'firstName'> & {
+                customer?: Maybe<(Pick<Customer$1, 'id' | 'lastName' | 'displayName' | 'firstName'> & {
                     defaultEmailAddress?: Maybe<Pick<CustomerEmailAddress, 'emailAddress'>>;
                 })>;
                 displayAddress?: Maybe<Pick<MailingAddress, 'address1' | 'address2' | 'city' | 'company' | 'country' | 'countryCodeV2' | 'firstName' | 'formattedArea' | 'id' | 'lastName' | 'name' | 'phone' | 'province' | 'provinceCode' | 'timeZone' | 'zip'>>;
-                fulfillments: Array<(Pick<Fulfillment, 'createdAt' | 'deliveredAt' | 'displayStatus' | 'estimatedDeliveryAt' | 'updatedAt' | 'totalQuantity' | 'status' | 'name' | 'id'> & {
+                fulfillments: Array<(Pick<Fulfillment$1, 'createdAt' | 'deliveredAt' | 'displayStatus' | 'estimatedDeliveryAt' | 'updatedAt' | 'totalQuantity' | 'status' | 'name' | 'id'> & {
                     trackingInfo: Array<Pick<FulfillmentTrackingInfo, 'company' | 'url'>>;
                 })>;
                 lineItems: {
@@ -18769,6 +20097,17 @@ type OrdersByNameFullQuery = {
         pageInfo: Pick<PageInfo, 'hasNextPage' | 'endCursor'>;
     };
 };
+type OrderCancellationInfoByNameQueryVariables = Exact<{
+    first: Scalars['Int']['input'];
+    queryFilter: Scalars['String']['input'];
+}>;
+type OrderCancellationInfoByNameQuery = {
+    orders: {
+        edges: Array<{
+            node: Pick<Order, 'id' | 'name' | 'cancelledAt'>;
+        }>;
+    };
+};
 type OrderPaymentDetailsByIdQueryVariables = Exact<{
     id: Scalars['ID']['input'];
 }>;
@@ -18781,6 +20120,46 @@ type OrderPaymentDetailsByIdQuery = {
         })>;
     }>;
 };
+type OrdersByCustomerIdQueryVariables = Exact<{
+    customerId: Scalars['ID']['input'];
+    first: Scalars['Int']['input'];
+}>;
+type OrdersByCustomerIdQuery = {
+    customer?: Maybe<(Pick<Customer$1, 'id'> & {
+        orders: {
+            edges: Array<{
+                node: (Pick<Order, 'id' | 'name' | 'createdAt' | 'cancelledAt' | 'cancelReason' | 'displayFulfillmentStatus'> & {
+                    totalPriceSet: {
+                        shopMoney: Pick<MoneyV2, 'amount' | 'currencyCode'>;
+                    };
+                    lineItems: {
+                        edges: Array<{
+                            node: (Pick<LineItem, 'sku' | 'title'> & {
+                                image?: Maybe<Pick<Image, 'url' | 'width' | 'height' | 'altText'>>;
+                            });
+                        }>;
+                    };
+                });
+            }>;
+        };
+    })>;
+};
+type AllProductVariantsQueryVariables = Exact<{
+    first: Scalars['Int']['input'];
+    after?: InputMaybe<Scalars['String']['input']>;
+}>;
+type AllProductVariantsQuery = {
+    productVariants: {
+        edges: Array<{
+            node: (Pick<ProductVariant$1, 'id' | 'legacyResourceId' | 'sku' | 'barcode' | 'inventoryQuantity' | 'price' | 'title'> & {
+                product: (Pick<Product, 'status' | 'title' | 'description' | 'handle' | 'onlineStoreUrl'> & {
+                    featuredImage?: Maybe<Pick<Image, 'url'>>;
+                });
+            });
+        }>;
+        pageInfo: Pick<PageInfo, 'hasNextPage' | 'endCursor'>;
+    };
+};
 type LeanProductVariantsQueryVariables = Exact<{
     first: Scalars['Int']['input'];
     after?: InputMaybe<Scalars['String']['input']>;
@@ -18789,13 +20168,28 @@ type LeanProductVariantsQueryVariables = Exact<{
 type LeanProductVariantsQuery = {
     productVariants: {
         edges: Array<{
-            node: (Pick<ProductVariant, 'id' | 'title' | 'sku'> & {
+            node: (Pick<ProductVariant$1, 'id' | 'title' | 'sku'> & {
                 product: Pick<Product, 'id' | 'title'>;
             });
         }>;
         pageInfo: Pick<PageInfo, 'hasNextPage' | 'endCursor'>;
     };
 };
+type ProductVariantsBySkusQueryVariables = Exact<{
+    first: Scalars['Int']['input'];
+    after?: InputMaybe<Scalars['String']['input']>;
+    queryFilter?: InputMaybe<Scalars['String']['input']>;
+}>;
+type ProductVariantsBySkusQuery = {
+    productVariants: {
+        edges: Array<{
+            node: (Pick<ProductVariant$1, 'id' | 'title' | 'sku'> & {
+                product: Pick<Product, 'id' | 'title' | 'status'>;
+            });
+        }>;
+        pageInfo: Pick<PageInfo, 'hasNextPage' | 'endCursor'>;
+    };
+};
 type ProductHandlesQueryVariables = Exact<{
     first: Scalars['Int']['input'];
 }>;
@@ -18807,6 +20201,34 @@ type ProductHandlesQuery = {
     };
 };
 interface GeneratedQueryTypes {
+    "#graphql\n  query customerSegmentMembersWithStatistics($query: String!, $first: Int!, $statisticsAttributeName: String!) {\n    customerSegmentMembers(query: $query, first: $first) {\n      statistics {\n        attributeStatistics(attributeName: $statisticsAttributeName) {\n          sum\n          average\n        }\n      }\n      edges {\n        node {\n          id\n          firstName\n          lastName\n          displayName\n          defaultEmailAddress {\n            emailAddress\n          }\n        }\n      }\n      pageInfo {\n        hasNextPage\n        endCursor\n      }\n      totalCount\n    }\n  }\n": {
+        return: CustomerSegmentMembersWithStatisticsQuery;
+        variables: CustomerSegmentMembersWithStatisticsQueryVariables;
+    };
+    "#graphql\n  query customersByEmail($query: String!, $first: Int!) {\n    customers(first: $first, query: $query) {\n      edges {\n        node {\n          id\n          email\n          firstName\n          lastName\n          numberOfOrders\n          amountSpent {\n            amount\n            currencyCode\n          }\n          defaultAddress {\n            id\n            address1\n            address2\n            city\n            province\n            country\n            zip\n            phone\n          }\n          addresses {\n            id\n            address1\n            address2\n            city\n            province\n            country\n            zip\n            phone\n          }\n        }\n      }\n    }\n  }\n": {
+        return: CustomersByEmailQuery;
+        variables: CustomersByEmailQueryVariables;
+    };
+    "#graphql\n  query fulfillmentOrdersByOrderId($orderId: ID!) {\n    order(id: $orderId) {\n      fulfillmentOrders(first: 50) {\n        edges {\n          node {\n            id\n            status\n            lineItems(first: 100) {\n              edges {\n                node {\n                  id\n                  remainingQuantity\n                  totalQuantity\n                  lineItem {\n                    id\n                  }\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n": {
+        return: FulfillmentOrdersByOrderIdQuery;
+        variables: FulfillmentOrdersByOrderIdQueryVariables;
+    };
+    "#graphql\n  query fulfillmentById($id: ID!) {\n    fulfillment(id: $id) {\n      id\n      name\n      createdAt\n      updatedAt\n      status\n      totalQuantity\n      estimatedDeliveryAt\n      deliveredAt\n      location {\n        id\n        legacyResourceId\n        name\n      }\n      service {\n        handle\n        serviceName\n      }\n      trackingInfo(first: 10) {\n        company\n        number\n        url\n      }\n      originAddress {\n        address1\n        address2\n        city\n        countryCode\n        provinceCode\n        zip\n      }\n      fulfillmentLineItems(first: 100) {\n        edges {\n          node {\n            id\n            quantity\n            originalTotalSet {\n              shopMoney {\n                amount\n                currencyCode\n              }\n            }\n            lineItem {\n              id\n              title\n              sku\n              variant {\n                id\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n": {
+        return: FulfillmentByIdQuery;
+        variables: FulfillmentByIdQueryVariables;
+    };
+    "#graphql\n  query fulfillmentTrackingIds($id: ID!) {\n    fulfillment(id: $id) {\n      id\n      trackingInfo(first: 50) {\n        company\n        number\n      }\n    }\n  }\n": {
+        return: FulfillmentTrackingIdsQuery;
+        variables: FulfillmentTrackingIdsQueryVariables;
+    };
+    "#graphql\n  query metaobjectByHandle($handle: MetaobjectHandleInput!) {\n    metaobjectByHandle(handle: $handle) {\n      id\n      handle\n      type\n      displayName\n      updatedAt\n      fields {\n        key\n        value\n        type\n      }\n    }\n  }\n": {
+        return: MetaobjectByHandleQuery;
+        variables: MetaobjectByHandleQueryVariables;
+    };
+    "#graphql\n  query suggestedRefund(\n    $orderId: ID!\n    $refundLineItems: [RefundLineItemInput!]\n    $refundShipping: Boolean\n    $shippingAmount: Money\n    $suggestFullRefund: Boolean\n  ) {\n    order(id: $orderId) {\n      id\n      name\n      suggestedRefund(\n        refundLineItems: $refundLineItems\n        refundShipping: $refundShipping\n        shippingAmount: $shippingAmount\n        suggestFullRefund: $suggestFullRefund\n      ) {\n        amountSet {\n          shopMoney {\n            amount\n            currencyCode\n          }\n        }\n        maximumRefundableSet {\n          shopMoney {\n            amount\n            currencyCode\n          }\n        }\n        subtotalSet {\n          shopMoney {\n            amount\n            currencyCode\n          }\n        }\n        totalTaxSet {\n          shopMoney {\n            amount\n            currencyCode\n          }\n        }\n        discountedSubtotalSet {\n          shopMoney {\n            amount\n            currencyCode\n          }\n        }\n        totalCartDiscountAmountSet {\n          shopMoney {\n            amount\n            currencyCode\n          }\n        }\n        shipping {\n          amountSet {\n            shopMoney {\n              amount\n              currencyCode\n            }\n          }\n          maximumRefundableSet {\n            shopMoney {\n              amount\n              currencyCode\n            }\n          }\n        }\n        refundLineItems {\n          lineItem {\n            id\n            sku\n            title\n            quantity\n          }\n          quantity\n          priceSet {\n            shopMoney {\n              amount\n              currencyCode\n            }\n          }\n          subtotalSet {\n            shopMoney {\n              amount\n              currencyCode\n            }\n          }\n          totalTaxSet {\n            shopMoney {\n              amount\n              currencyCode\n            }\n          }\n          restockType\n        }\n        suggestedTransactions {\n          gateway\n          kind\n          amountSet {\n            shopMoney {\n              amount\n              currencyCode\n            }\n          }\n          maximumRefundableSet {\n            shopMoney {\n              amount\n              currencyCode\n            }\n          }\n          parentTransaction {\n            id\n          }\n        }\n      }\n    }\n  }\n": {
+        return: SuggestedRefundQuery;
+        variables: SuggestedRefundQueryVariables;
+    };
     "#graphql\n  query orderById($id: ID!) {\n    order(id: $id) {\n      id\n      name\n      createdAt\n      updatedAt\n      cancelledAt\n      cancelReason\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      shippingAddress {\n        firstName\n        lastName\n        address1\n        address2\n        city\n        province\n        country\n        zip\n      }\n    }\n  }\n": {
         return: OrderByIdQuery;
         variables: OrderByIdQueryVariables;
@@ -18823,14 +20245,30 @@ interface GeneratedQueryTypes {
         return: OrdersByNameFullQuery;
         variables: OrdersByNameFullQueryVariables;
     };
+    "#graphql\n  query orderCancellationInfoByName($first: Int!, $queryFilter: String!) {\n    orders(first: $first, query: $queryFilter) {\n      edges {\n        node {\n          id\n          name\n          cancelledAt\n        }\n      }\n    }\n  }\n": {
+        return: OrderCancellationInfoByNameQuery;
+        variables: OrderCancellationInfoByNameQueryVariables;
+    };
     "#graphql\n  query orderPaymentDetailsById($id: ID!) {\n    order(id: $id) {\n      transactions {\n        amountSet {\n          shopMoney {\n            amount\n            currencyCode\n          }\n        }\n        createdAt\n        gateway\n        formattedGateway\n        kind\n        paymentId\n      }\n    }\n  }\n": {
         return: OrderPaymentDetailsByIdQuery;
         variables: OrderPaymentDetailsByIdQueryVariables;
     };
+    "#graphql\n  query ordersByCustomerId($customerId: ID!, $first: Int!) {\n    customer(id: $customerId) {\n      id\n      orders(first: $first, reverse: true) {\n        edges {\n          node {\n            id\n            name\n            createdAt\n            cancelledAt\n            cancelReason\n            displayFulfillmentStatus\n            totalPriceSet {\n              shopMoney {\n                amount\n                currencyCode\n              }\n            }\n            lineItems(first: 100) {\n              edges {\n                node {\n                  sku\n                  title\n                  image {\n                    url\n                    width\n                    height\n                    altText\n                  }\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n": {
+        return: OrdersByCustomerIdQuery;
+        variables: OrdersByCustomerIdQueryVariables;
+    };
+    "#graphql\n  query allProductVariants($first: Int!, $after: String) {\n    productVariants(first: $first, after: $after) {\n      edges {\n        node {\n          id\n          legacyResourceId\n          sku\n          barcode\n          inventoryQuantity\n          price\n          title\n          product {\n            status\n            title\n            description\n            handle\n            onlineStoreUrl\n            featuredImage {\n              url\n            }\n          }\n        }\n      }\n      pageInfo {\n        hasNextPage\n        endCursor\n      }\n    }\n  }\n": {
+        return: AllProductVariantsQuery;
+        variables: AllProductVariantsQueryVariables;
+    };
     "#graphql\n    query leanProductVariants($first: Int!, $after: String, $queryFilter: String) {\n      productVariants(first: $first, after: $after, query: $queryFilter) {\n        edges {\n          node { \n            id\n            title\n            sku\n            product {\n              id\n              title\n            }\n          }\n        }\n        pageInfo { \n          hasNextPage\n          endCursor\n        }\n      }\n    }\n  ": {
         return: LeanProductVariantsQuery;
         variables: LeanProductVariantsQueryVariables;
     };
+    "#graphql\n    query productVariantsBySkus($first: Int!, $after: String, $queryFilter: String) {\n      productVariants(first: $first, after: $after, query: $queryFilter) {\n        edges {\n          node {\n            id\n            title\n            sku\n            product {\n              id\n              title\n              status\n            }\n          }\n        }\n        pageInfo {\n          hasNextPage\n          endCursor\n        }\n      }\n    }\n  ": {
+        return: ProductVariantsBySkusQuery;
+        variables: ProductVariantsBySkusQueryVariables;
+    };
     "#graphql\n      query productHandles($first: Int!) {\n        products(first: $first) {\n          edges {\n            node {\n              handle\n              title\n            }\n          }\n        }\n      }": {
         return: ProductHandlesQuery;
         variables: ProductHandlesQueryVariables;
@@ -18841,14 +20279,46 @@ interface GeneratedMutationTypes {
         return: CustomerDeleteMutation;
         variables: CustomerDeleteMutationVariables;
     };
+    "#graphql\n  mutation createFile($files: [FileCreateInput!]!) {\n    fileCreate(files: $files) {\n      files {\n        id\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n    }\n  }\n": {
+        return: CreateFileMutation;
+        variables: CreateFileMutationVariables;
+    };
+    "#graphql\n    mutation fileDelete($fileIds: [ID!]!) {\n      fileDelete(fileIds: $fileIds) {\n        deletedFileIds\n        userErrors {\n          code\n          field\n          message\n        }\n      }\n    }\n  ": {
+        return: FileDeleteMutation;
+        variables: FileDeleteMutationVariables;
+    };
+    "#graphql\n  mutation createFulfillment($fulfillment: FulfillmentInput!) {\n    fulfillmentCreate(fulfillment: $fulfillment) {\n      fulfillment {\n        id\n        status\n        trackingInfo {\n          company\n          number\n        }\n      }\n      userErrors {\n        field\n        message\n      }\n    }\n  }\n": {
+        return: CreateFulfillmentMutation;
+        variables: CreateFulfillmentMutationVariables;
+    };
+    "#graphql\n  mutation updateFulfillmentTracking(\n    $fulfillmentId: ID!\n    $trackingNumbers: [String!]!\n    $company: String\n    $notifyCustomer: Boolean\n  ) {\n    fulfillmentTrackingInfoUpdate(\n      fulfillmentId: $fulfillmentId\n      trackingInfoInput: { numbers: $trackingNumbers, company: $company }\n      notifyCustomer: $notifyCustomer\n    ) {\n      fulfillment {\n        trackingInfo {\n          number\n          company\n        }\n      }\n      userErrors {\n        field\n        message\n      }\n    }\n  }\n": {
+        return: UpdateFulfillmentTrackingMutation;
+        variables: UpdateFulfillmentTrackingMutationVariables;
+    };
+    "#graphql\n  mutation createMetaobjectDefinition($definition: MetaobjectDefinitionCreateInput!) {\n    metaobjectDefinitionCreate(definition: $definition) {\n      metaobjectDefinition {\n        id\n        name\n        type\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n    }\n  }\n": {
+        return: CreateMetaobjectDefinitionMutation;
+        variables: CreateMetaobjectDefinitionMutationVariables;
+    };
+    "#graphql\n  mutation upsertMetaobject(\n    $handle: MetaobjectHandleInput!\n    $metaobject: MetaobjectUpsertInput!\n  ) {\n    metaobjectUpsert(handle: $handle, metaobject: $metaobject) {\n      metaobject {\n        id\n        handle\n        displayName\n        fields {\n          key\n          value\n        }\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n    }\n  }\n": {
+        return: UpsertMetaobjectMutation;
+        variables: UpsertMetaobjectMutationVariables;
+    };
     "#graphql\n  mutation orderCancel($orderId: ID!) {\n    orderCancel(\n      orderId: $orderId\n      refund: true\n      restock: false\n      reason: CUSTOMER\n      notifyCustomer: true\n    ) {\n      orderCancelUserErrors {\n        code\n        field\n        message\n      }\n    }\n  }\n": {
         return: OrderCancelMutation;
         variables: OrderCancelMutationVariables;
     };
+    "#graphql\n  mutation bulkUpdateProductVariants(\n    $productId: ID!\n    $variants: [ProductVariantsBulkInput!]!\n  ) {\n    productVariantsBulkUpdate(\n      productId: $productId\n      variants: $variants\n    ) {\n      productVariants {\n        id\n        sku\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n    }\n  }\n": {
+        return: BulkUpdateProductVariantsMutation;
+        variables: BulkUpdateProductVariantsMutationVariables;
+    };
     "#graphql\n    mutation connectMetaObjectToProductVariant($productId: ID!, $variantId: ID!, $metaObjectId: String!, $metaObjectKey: String!) {\n      productVariantsBulkUpdate(\n        productId: $productId\n        variants: [\n          {\n            id: $variantId\n            metafields: [\n              {\n                namespace: \"custom\"\n                key: $metaObjectKey\n                value: $metaObjectId\n                type: \"metaobject_reference\"\n              }\n            ]\n          }\n        ] \n      ) {\n        productVariants { \n          id\n        }\n        userErrors {\n          field\n          message\n        }\n      }\n    }\n  ": {
         return: ConnectMetaObjectToProductVariantMutation;
         variables: ConnectMetaObjectToProductVariantMutationVariables;
     };
+    "#graphql\n  mutation createRefund($input: RefundInput!) {\n    refundCreate(input: $input) {\n      refund {\n        id\n        totalRefundedSet {\n          shopMoney {\n            amount\n            currencyCode\n          }\n          presentmentMoney {\n            amount\n            currencyCode\n          }\n        }\n      }\n      userErrors {\n        field\n        message\n      }\n    }\n  }\n": {
+        return: CreateRefundMutation;
+        variables: CreateRefundMutationVariables;
+    };
 }
 declare module '@shopify/admin-api-client' {
     type InputMaybe<T> = InputMaybe<T>;
@@ -18858,7 +20328,54 @@ declare module '@shopify/admin-api-client' {
     }
 }
 
-declare const GetLeanOrderByIdReturn: z.ZodNullable<z.ZodObject<{
+type SuggestedRefund = NonNullable<NonNullable<SuggestedRefundQuery['order']>['suggestedRefund']>;
+interface CalculateRefundLineItem {
+    lineItemId: number | bigint | string;
+    quantity: number;
+    restockType?: 'NO_RESTOCK' | 'CANCEL' | 'RETURN';
+    locationId?: string;
+}
+interface CalculateRefundOptions {
+    refundLineItems?: CalculateRefundLineItem[];
+    refundShipping?: boolean;
+    shippingAmount?: string;
+    suggestFullRefund?: boolean;
+}
+/**
+ * Calculate a suggested refund for an order.
+ * Returns undefined if the order is not found or has no refundable items.
+ *
+ * @param orderId - The order ID (numeric, bigint, or GID string)
+ * @param options - Options for the refund calculation
+ * @returns The suggested refund or undefined
+ */
+declare function calculateRefund(orderId: number | bigint | string, options?: CalculateRefundOptions): Promise<SuggestedRefund | undefined>;
+
+interface ShopifyUserErrorDetail {
+    code?: string | null;
+    field?: string[] | null;
+    message?: string | null;
+}
+/**
+ * Custom error class for Shopify mutation userErrors.
+ * Preserves the full error array so callers can inspect specific error codes.
+ *
+ * @example
+ * try {
+ *   await cancelOrderById(orderId)
+ * } catch (error) {
+ *   if (error instanceof ShopifyUserError) {
+ *     const alreadyCancelled = error.errors.some(e => e.code === 'ORDER_ALREADY_CANCELLED')
+ *     if (alreadyCancelled) { ... }
+ *   }
+ * }
+ */
+declare class ShopifyUserError extends Error {
+    readonly errors: ShopifyUserErrorDetail[];
+    constructor(message: string, errors: ShopifyUserErrorDetail[]);
+}
+
+declare const GetLeanOrderByIdReturn: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     createdAt: z.ZodString;
@@ -18869,11 +20386,11 @@ declare const GetLeanOrderByIdReturn: z.ZodNullable<z.ZodObject<{
         amount: z.ZodString;
         currencyCode: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        currencyCode: string;
         amount: string;
-    }, {
         currencyCode: string;
+    }, {
         amount: string;
+        currencyCode: string;
     }>;
     customer: z.ZodNullable<z.ZodObject<{
         id: z.ZodString;
@@ -18884,14 +20401,14 @@ declare const GetLeanOrderByIdReturn: z.ZodNullable<z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         id: string;
         displayName: string;
-        lastName: string | null;
         firstName: string | null;
+        lastName: string | null;
         emailAddress: string | null;
     }, {
         id: string;
         displayName: string;
-        lastName: string | null;
         firstName: string | null;
+        lastName: string | null;
         emailAddress: string | null;
     }>>;
     financialStatus: z.ZodNullable<z.ZodString>;
@@ -18906,8 +20423,8 @@ declare const GetLeanOrderByIdReturn: z.ZodNullable<z.ZodObject<{
         country: z.ZodNullable<z.ZodString>;
         zip: z.ZodNullable<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        lastName: string | null;
         firstName: string | null;
+        lastName: string | null;
         address1: string | null;
         address2: string | null;
         city: string | null;
@@ -18915,8 +20432,8 @@ declare const GetLeanOrderByIdReturn: z.ZodNullable<z.ZodObject<{
         country: string | null;
         zip: string | null;
     }, {
-        lastName: string | null;
         firstName: string | null;
+        lastName: string | null;
         address1: string | null;
         address2: string | null;
         city: string | null;
@@ -18929,18 +20446,19 @@ declare const GetLeanOrderByIdReturn: z.ZodNullable<z.ZodObject<{
     createdAt: string;
     updatedAt: string;
     name: string;
-    cancelledAt: string | null;
+    fulfillmentStatus: string | null;
     cancelReason: string | null;
+    cancelledAt: string | null;
     customer: {
         id: string;
         displayName: string;
-        lastName: string | null;
         firstName: string | null;
+        lastName: string | null;
         emailAddress: string | null;
     } | null;
     shippingAddress: {
-        lastName: string | null;
         firstName: string | null;
+        lastName: string | null;
         address1: string | null;
         address2: string | null;
         city: string | null;
@@ -18949,28 +20467,28 @@ declare const GetLeanOrderByIdReturn: z.ZodNullable<z.ZodObject<{
         zip: string | null;
     } | null;
     totalPrice: {
-        currencyCode: string;
         amount: string;
+        currencyCode: string;
     };
-    fulfillmentStatus: string | null;
     financialStatus: string | null;
 }, {
     id: string;
     createdAt: string;
     updatedAt: string;
     name: string;
-    cancelledAt: string | null;
+    fulfillmentStatus: string | null;
     cancelReason: string | null;
+    cancelledAt: string | null;
     customer: {
         id: string;
         displayName: string;
-        lastName: string | null;
         firstName: string | null;
+        lastName: string | null;
         emailAddress: string | null;
     } | null;
     shippingAddress: {
-        lastName: string | null;
         firstName: string | null;
+        lastName: string | null;
         address1: string | null;
         address2: string | null;
         city: string | null;
@@ -18979,19 +20497,18 @@ declare const GetLeanOrderByIdReturn: z.ZodNullable<z.ZodObject<{
         zip: string | null;
     } | null;
     totalPrice: {
-        currencyCode: string;
         amount: string;
+        currencyCode: string;
     };
-    fulfillmentStatus: string | null;
     financialStatus: string | null;
-}>>;
-type LeanOrder = z.infer<typeof GetLeanOrderByIdReturn>;
+}>;
+type LeanOrder = z.infer<typeof GetLeanOrderByIdReturn> | undefined;
 type FullOrder = NonNullable<OrderByIdFullQuery['order']>;
 declare function getOrderById(id: number | bigint): Promise<LeanOrder>;
 declare function getOrderById(id: number | bigint, detailLevel: 'lean'): Promise<LeanOrder>;
-declare function getOrderById(id: number | bigint, detailLevel: 'full'): Promise<FullOrder | null>;
+declare function getOrderById(id: number | bigint, detailLevel: 'full'): Promise<FullOrder | undefined>;
 
-declare const GetLeanOrderByNameReturn: z.ZodNullable<z.ZodObject<{
+declare const GetLeanOrderByNameReturn: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     createdAt: z.ZodString;
@@ -19000,11 +20517,11 @@ declare const GetLeanOrderByNameReturn: z.ZodNullable<z.ZodObject<{
         amount: z.ZodString;
         currencyCode: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        currencyCode: string;
         amount: string;
-    }, {
         currencyCode: string;
+    }, {
         amount: string;
+        currencyCode: string;
     }>;
     customer: z.ZodNullable<z.ZodObject<{
         id: z.ZodString;
@@ -19026,40 +20543,51 @@ declare const GetLeanOrderByNameReturn: z.ZodNullable<z.ZodObject<{
     createdAt: string;
     updatedAt: string;
     name: string;
+    fulfillmentStatus: string | null;
     customer: {
         id: string;
         displayName: string;
         emailAddress: string | null;
     } | null;
     totalPrice: {
-        currencyCode: string;
         amount: string;
+        currencyCode: string;
     };
-    fulfillmentStatus: string | null;
     financialStatus: string | null;
 }, {
     id: string;
     createdAt: string;
     updatedAt: string;
     name: string;
+    fulfillmentStatus: string | null;
     customer: {
         id: string;
         displayName: string;
         emailAddress: string | null;
     } | null;
     totalPrice: {
-        currencyCode: string;
         amount: string;
+        currencyCode: string;
     };
-    fulfillmentStatus: string | null;
     financialStatus: string | null;
-}>>;
-type LeanOrderByName = z.infer<typeof GetLeanOrderByNameReturn>;
-type FullOrderByName = NonNullable<NonNullable<OrdersByNameFullQuery['orders']>['edges'][number]['node']> | null;
+}>;
+type LeanOrderByName = z.infer<typeof GetLeanOrderByNameReturn> | undefined;
+type FullOrderByName = NonNullable<NonNullable<OrdersByNameFullQuery['orders']>['edges'][number]['node']> | undefined;
 declare function getOrderByName(orderName: string, detailLevel: 'lean'): Promise<LeanOrderByName>;
 declare function getOrderByName(orderName: string, detailLevel: 'full'): Promise<FullOrderByName>;
 declare function getOrderByName(orderName: string): Promise<LeanOrderByName>;
 
+type OrderCancellationInfo = NonNullable<OrderCancellationInfoByNameQuery['orders']['edges'][number]['node']>;
+/**
+ * Retrieves cancellation information for an order by its name (e.g., "B12345").
+ * Returns undefined if no order is found with the specified name.
+ *
+ * @param {string} orderName - The order name to search for (e.g., "B12345").
+ * @returns {Promise<OrderCancellationInfo | undefined>} A promise that resolves to the order cancellation info or undefined if not found.
+ * @throws {Error} If the GraphQL query fails or if the response structure is invalid.
+ */
+declare function getOrderCancellationInfoByName(orderName: string): Promise<OrderCancellationInfo | undefined>;
+
 declare const GetLeanProductVariantsReturn: z.ZodArray<z.ZodObject<{
     productId: z.ZodString;
     productTitle: z.ZodString;
@@ -19068,16 +20596,16 @@ declare const GetLeanProductVariantsReturn: z.ZodArray<z.ZodObject<{
     sku: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     productId: string;
-    variantId: string;
     sku: string;
-    variantTitle: string;
+    variantId: string;
     productTitle: string;
+    variantTitle: string;
 }, {
     productId: string;
-    variantId: string;
     sku: string;
-    variantTitle: string;
+    variantId: string;
     productTitle: string;
+    variantTitle: string;
 }>, "many">;
 type GetLeanProductVariantsReturnType = z.infer<typeof GetLeanProductVariantsReturn>;
 /**
@@ -19091,133 +20619,185 @@ type GetLeanProductVariantsReturnType = z.infer<typeof GetLeanProductVariantsRet
  */
 declare function getLeanProductVariants(skus?: string[]): Promise<GetLeanProductVariantsReturnType>;
 
-declare const GetOrderPaymentDetailsByIdReturn: z.ZodObject<{
-    order: z.ZodObject<{
-        transactions: z.ZodArray<z.ZodObject<{
-            amountSet: z.ZodObject<{
-                shopMoney: z.ZodObject<{
-                    amount: z.ZodString;
-                    currencyCode: z.ZodString;
-                }, "strip", z.ZodTypeAny, {
-                    currencyCode: string;
-                    amount: string;
-                }, {
-                    currencyCode: string;
-                    amount: string;
-                }>;
-            }, "strip", z.ZodTypeAny, {
-                shopMoney: {
-                    currencyCode: string;
-                    amount: string;
-                };
-            }, {
-                shopMoney: {
-                    currencyCode: string;
-                    amount: string;
-                };
-            }>;
-            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;
-            amountSet: {
-                shopMoney: {
-                    currencyCode: string;
-                    amount: string;
-                };
-            };
-        }, {
-            createdAt: string;
-            gateway: string;
-            formattedGateway: string;
-            kind: string;
-            paymentId: string;
-            amountSet: {
-                shopMoney: {
-                    currencyCode: string;
-                    amount: string;
-                };
-            };
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        transactions: {
-            createdAt: string;
-            gateway: string;
-            formattedGateway: string;
-            kind: string;
-            paymentId: string;
-            amountSet: {
-                shopMoney: {
-                    currencyCode: string;
-                    amount: string;
-                };
-            };
-        }[];
-    }, {
-        transactions: {
-            createdAt: string;
-            gateway: string;
-            formattedGateway: string;
-            kind: string;
-            paymentId: string;
-            amountSet: {
-                shopMoney: {
-                    currencyCode: string;
-                    amount: string;
-                };
-            };
-        }[];
-    }>;
+declare const GetProductVariantsBySkusReturn: z.ZodArray<z.ZodObject<{
+    productId: z.ZodString;
+    productTitle: z.ZodString;
+    variantId: z.ZodString;
+    variantTitle: z.ZodString;
+    sku: z.ZodString;
+    status: z.ZodEnum<["ACTIVE", "ARCHIVED", "DRAFT"]>;
 }, "strip", z.ZodTypeAny, {
-    order: {
-        transactions: {
-            createdAt: string;
-            gateway: string;
-            formattedGateway: string;
-            kind: string;
-            paymentId: string;
-            amountSet: {
-                shopMoney: {
-                    currencyCode: string;
-                    amount: string;
-                };
-            };
-        }[];
-    };
+    status: "ACTIVE" | "ARCHIVED" | "DRAFT";
+    productId: string;
+    sku: string;
+    variantId: string;
+    productTitle: string;
+    variantTitle: string;
 }, {
-    order: {
-        transactions: {
-            createdAt: string;
-            gateway: string;
-            formattedGateway: string;
-            kind: string;
-            paymentId: string;
-            amountSet: {
-                shopMoney: {
-                    currencyCode: string;
-                    amount: string;
-                };
-            };
-        }[];
-    };
+    status: "ACTIVE" | "ARCHIVED" | "DRAFT";
+    productId: string;
+    sku: string;
+    variantId: string;
+    productTitle: string;
+    variantTitle: string;
+}>, "many">;
+type ProductVariantBySku = z.infer<typeof GetProductVariantsBySkusReturn>[number];
+type ProductVariantsBySkusOptions = {
+    /** Filter to only active products (excludes ARCHIVED). Defaults to false. */
+    activeOnly?: boolean;
+};
+/**
+ * Retrieves product variants from Shopify filtered by SKUs.
+ * Variants missing a SKU will be filtered out and logged.
+ *
+ * @param {string[]} skus - Array of SKUs to filter by.
+ * @param {ProductVariantsBySkusOptions} [options] - Optional settings.
+ * @param {boolean} [options.activeOnly=false] - If true, excludes ARCHIVED products at query level.
+ * @returns {Promise<ProductVariantBySku[]>} A promise that resolves to an array of product variant data.
+ * @throws {Error} If the GraphQL query fails or returns no data.
+ */
+declare function getProductVariantsBySkus(skus: string[], options?: ProductVariantsBySkusOptions): Promise<ProductVariantBySku[]>;
+
+declare const ProductVariantSchema: z.ZodObject<{
+    status: z.ZodEnum<["ACTIVE", "ARCHIVED", "DRAFT"]>;
+    sku: z.ZodString;
+    barcode: z.ZodNullable<z.ZodString>;
+    price: z.ZodString;
+    title: z.ZodString;
+    url: z.ZodNullable<z.ZodString>;
+    handle: z.ZodString;
+    description: z.ZodString;
+    imageUrl: z.ZodNullable<z.ZodString>;
+    inventoryQuantity: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    status: "ACTIVE" | "ARCHIVED" | "DRAFT";
+    url: string | null;
+    description: string;
+    handle: string;
+    sku: string;
+    barcode: string | null;
+    inventoryQuantity: number;
+    price: string;
+    title: string;
+    imageUrl: string | null;
+}, {
+    status: "ACTIVE" | "ARCHIVED" | "DRAFT";
+    url: string | null;
+    description: string;
+    handle: string;
+    sku: string;
+    barcode: string | null;
+    inventoryQuantity: number;
+    price: string;
+    title: string;
+    imageUrl: string | null;
 }>;
-type GetOrderPaymentDetailsByIdReturnType = z.infer<typeof GetOrderPaymentDetailsByIdReturn>;
+type ProductVariant = z.infer<typeof ProductVariantSchema>;
+/**
+ * Retrieves all product variants from Shopify with full details.
+ * Automatically handles pagination to fetch all variants.
+ *
+ * Each variant includes product info with combined title (product + variant title
+ * when variant title is not "Default Title"), URL with variant ID, and inventory data.
+ *
+ * @returns {Promise<ProductVariant[]>} A promise that resolves to an array of product variants.
+ * @throws {Error} If the GraphQL query fails or if the response is missing expected data.
+ */
+declare function getAllProductVariants(): Promise<ProductVariant[]>;
+
+type OrderPaymentDetails = NonNullable<OrderPaymentDetailsByIdQuery['order']>;
 /**
  * Retrieves payment details for a single order from Shopify by its ID.
- * Returns null if no order is found with the specified ID.
+ * Returns undefined if no order is found with the specified ID.
  *
  * @param {bigint} id - The numerical Shopify order ID (e.g., 12345678n).
- * @returns {Promise<GetOrderPaymentDetailsByIdReturnType | null>} A promise that resolves to the order payment data or null if not found.
+ * @returns {Promise<OrderPaymentDetails | undefined>} A promise that resolves to the order payment data or undefined if not found.
+ * @throws {Error} If the GraphQL query fails.
+ */
+declare function getOrderPaymentDetailsById(id: bigint): Promise<OrderPaymentDetails | undefined>;
+
+type Fulfillment = NonNullable<FulfillmentByIdQuery['fulfillment']>;
+/**
+ * Retrieves a single fulfillment from Shopify by its ID.
+ * Returns undefined if no fulfillment is found with the specified ID.
+ *
+ * @param {string | number | bigint} id - The Shopify fulfillment ID. Can be a GID string (e.g., "gid://shopify/Fulfillment/123456789") or a numeric ID (e.g., 123456789 or 123456789n).
+ * @returns {Promise<Fulfillment | undefined>} A promise that resolves to the fulfillment data or undefined if not found.
  * @throws {Error} If the GraphQL query fails or if the response structure is invalid.
  */
-declare function getOrderPaymentDetailsById(id: bigint): Promise<GetOrderPaymentDetailsByIdReturnType | null>;
+declare function getFulfillmentById(id: string | number | bigint): Promise<Fulfillment | undefined>;
+
+type FulfillmentOrderEdge = NonNullable<FulfillmentOrdersByOrderIdQuery['order']>['fulfillmentOrders']['edges'][number];
+type FulfillmentOrder = FulfillmentOrderEdge['node'];
+/**
+ * Retrieves all fulfillment orders for a given Shopify order.
+ * Returns an empty array if no order is found or if the order has no fulfillment orders.
+ *
+ * @param {string | number | bigint} orderId - The Shopify order ID. Can be a GID string (e.g., "gid://shopify/Order/123456789") or a numeric ID (e.g., 123456789 or 123456789n).
+ * @returns {Promise<FulfillmentOrder[]>} A promise that resolves to an array of fulfillment orders.
+ * @throws {Error} If the GraphQL query fails or if the response structure is invalid.
+ */
+declare function getFulfillmentOrdersByOrderId(orderId: string | number | bigint): Promise<FulfillmentOrder[]>;
+
+type FulfillmentTrackingIds = {
+    trackingNumbers: string[];
+    trackingCompany: string | null;
+};
+/**
+ * Retrieves tracking information for a fulfillment by its ID.
+ * Returns the tracking numbers and the tracking company.
+ *
+ * @param {string | number | bigint} id - The Shopify fulfillment ID. Can be a GID string (e.g., "gid://shopify/Fulfillment/123456789") or a numeric ID (e.g., 123456789 or 123456789n).
+ * @returns {Promise<FulfillmentTrackingIds | undefined>} A promise that resolves to the tracking info or undefined if fulfillment not found.
+ * @throws {Error} If the GraphQL query fails.
+ */
+declare function getFulfillmentTrackingIds(id: string | number | bigint): Promise<FulfillmentTrackingIds | undefined>;
+
+type Customer = CustomersByEmailQuery['customers']['edges'][number]['node'];
+/**
+ * Retrieves customers from Shopify by their email address.
+ * Returns an empty array if no customers are found.
+ *
+ * @param {string} email - The email address to search for.
+ * @param {number} limit - Maximum number of customers to return. Defaults to 10.
+ * @returns {Promise<Customer[]>} A promise that resolves to an array of customers.
+ * @throws {Error} If the GraphQL query fails or if the response structure is invalid.
+ */
+declare function getCustomersByEmail(email: string, limit?: number): Promise<Customer[]>;
+
+type CustomerSegmentMember = CustomerSegmentMembersWithStatisticsQuery['customerSegmentMembers']['edges'][number]['node'];
+type SegmentAttributeStatistics = CustomerSegmentMembersWithStatisticsQuery['customerSegmentMembers']['statistics']['attributeStatistics'];
+interface CustomerSegmentMembersResult {
+    members: CustomerSegmentMember[];
+    totalCount: number;
+    statistics: {
+        attributeStatistics: SegmentAttributeStatistics;
+    };
+}
+/**
+ * Retrieves customer segment members from Shopify based on a segment query.
+ * Returns members with statistics for the specified attribute.
+ *
+ * @param {string} query - The segment query filter string (e.g., "customer_account_status = 'ENABLED'").
+ * @param {string} statisticsAttributeName - Attribute name for statistics (e.g., "amount_spent").
+ * @param {number} limit - Maximum number of members to return. Defaults to 250.
+ * @returns {Promise<CustomerSegmentMembersResult>} Members with statistics.
+ * @throws {Error} If the GraphQL query fails.
+ */
+declare function getCustomerSegmentMembers(query: string, statisticsAttributeName: string, limit?: number): Promise<CustomerSegmentMembersResult>;
+
+type CustomerOrders = NonNullable<OrdersByCustomerIdQuery['customer']>['orders'];
+type OrderPreview = CustomerOrders['edges'][number]['node'];
+/**
+ * Retrieves orders for a specific customer from Shopify.
+ * Returns orders sorted by most recent first, or an empty array if customer not found.
+ *
+ * @param {number | bigint} customerId - The numerical Shopify customer ID.
+ * @param {number} limit - Maximum number of orders to return. Defaults to 250.
+ * @returns {Promise<OrderPreview[]>} A promise that resolves to an array of order previews.
+ * @throws {Error} If the GraphQL query fails.
+ */
+declare function getOrdersByCustomerId(customerId: number | bigint, limit?: number): Promise<OrderPreview[]>;
 
 /**
  * Extract numeric ID from a Shopify GID string.
@@ -19228,4 +20808,14 @@ declare function getOrderPaymentDetailsById(id: bigint): Promise<GetOrderPayment
  */
 declare function parseGid(gid: string): number;
 
-export { type FullOrder, type FullOrderByName, type LeanOrder, type LeanOrderByName, ShopifyUserError, type ShopifyUserErrorDetail, cancelOrderById, deleteCustomerById, getLeanProductVariants, getOrderById, getOrderByName, getOrderPaymentDetailsById, parseGid };
+type Metaobject = NonNullable<MetaobjectByHandleQuery['metaobjectByHandle']>;
+/**
+ * Retrieves a metaobject from Shopify by its handle.
+ * Returns undefined if no metaobject is found with the specified type and handle.
+ *
+ * @param handle - The handle input containing type and handle
+ * @returns A promise that resolves to the metaobject data or undefined if not found.
+ */
+declare function getMetaobjectByHandle(handle: MetaobjectHandleInput): Promise<Metaobject | undefined>;
+
+export { type BulkUpdateProductVariantsResult, type CalculateRefundLineItem, type CalculateRefundOptions, type CreateFulfillmentResult, type CreateMetaobjectDefinitionInput, type CreateMetaobjectDefinitionResult, type CreateRefundLineItem, type CreateRefundOptions, type CreateRefundResult, type CreateRefundTransaction, type Customer, type CustomerSegmentMember, type CustomerSegmentMembersResult, type Fulfillment, type FulfillmentLineItem$1 as FulfillmentLineItem, type FulfillmentOrder, type FulfillmentTrackingIds, type FullOrder, type FullOrderByName, type LeanOrder, type LeanOrderByName, type Metaobject, type MetaobjectFieldDefinition$1 as MetaobjectFieldDefinition, type MetaobjectHandleInput, type OrderCancellationInfo, type OrderPaymentDetails, type OrderPreview, type ProductVariant, type ProductVariantBySku, type ProductVariantsBySkusOptions, type RefundMoney, type SegmentAttributeStatistics, ShopifyUserError, type ShopifyUserErrorDetail, type SuggestedRefund, type UpdateFulfillmentTrackingResult, type UpsertMetaobjectInput, type UpsertMetaobjectResult, type VariantUpdateInput, bulkUpdateProductVariants, calculateRefund, cancelOrderById, createFile, createFulfillment, createMetaobjectDefinition, createRefund, deleteCustomerById, deleteFilesByIds, getAllProductVariants, getCustomerSegmentMembers, getCustomersByEmail, getFulfillmentById, getFulfillmentOrdersByOrderId, getFulfillmentTrackingIds, getLeanProductVariants, getMetaobjectByHandle, getOrderById, getOrderByName, getOrderCancellationInfoByName, getOrderPaymentDetailsById, getOrdersByCustomerId, getProductVariantsBySkus, parseGid, updateFulfillmentTracking, upsertMetaobject };