@doswiftly/storefront-operations 4.4.0 → 5.4.0

package/schema.graphql

@@ -2,6 +2,16 @@
 # THIS FILE WAS AUTOMATICALLY GENERATED (DO NOT MODIFY)
 # ------------------------------------------------------
 
+"""
+Sets contextual hints on an operation (Shopify Storefront API parity). Currently supports preferredLocationId; country/language/buyer will follow.
+"""
+directive @inContext(
+  """
+  Biases field resolvers (e.g. storeAvailability) toward this location. Must reference an active InventoryLocation in the current shop — invalid / inactive IDs are silently ignored by resolvers.
+  """
+  preferredLocationId: ID
+) on MUTATION | QUERY | SUBSCRIPTION
+
 """Gift card applied to checkout"""
 type AppliedGiftCard {
   """Amount applied to this checkout"""
@@ -26,6 +36,14 @@ type Attribute {
   value: String
 }
 
+"""
+How attribute surcharge affects pricing: BUNDLED (in unitPrice) or SEPARATE_LINE (own OrderItem)
+"""
+enum AttributeBillingMode {
+  BUNDLED
+  SEPARATE_LINE
+}
+
 """Filterable attribute definition"""
 type AttributeDefinition {
   """Display order"""
@@ -56,6 +74,15 @@ type AttributeDefinition {
   type: AttributeType!
 }
 
+"""
+Who fills the attribute value: MERCHANT (admin on product), CUSTOMER (in cart), or BOTH
+"""
+enum AttributeFillingMode {
+  BOTH
+  CUSTOMER
+  MERCHANT
+}
+
 """Filter by attribute values"""
 input AttributeFilterInput {
   """Attribute definition ID or handle"""
@@ -107,6 +134,14 @@ input AttributeInput {
   value: String
 }
 
+"""
+Surcharge calculation: FIXED (minor units) or PERCENT (thousandths of percent — Faza 2)
+"""
+enum AttributeOptionSurchargeType {
+  FIXED
+  PERCENT
+}
+
 """Min/max bounds for numeric attributes"""
 type AttributeRangeBounds {
   """Currency code for CURRENCY type"""
@@ -119,6 +154,67 @@ type AttributeRangeBounds {
   min: Float
 }
 
+"""Typed snapshot of customer-filled attribute selection (Faza 1 R5)"""
+type AttributeSelection {
+  """AttributeDefinition ID (snapshot at addItem)"""
+  attributeDefinitionId: ID!
+
+  """AttributeDefinition name (snapshot)"""
+  attributeName: String!
+
+  """Billing mode; null = informational only"""
+  billingMode: AttributeBillingMode
+
+  """Filling mode (snapshot)"""
+  fillingMode: AttributeFillingMode!
+
+  """Linked ProductVariant ID for component stock (Faza 1.5)"""
+  linkedVariantId: ID
+
+  """Selected option ID (SELECT/RADIO/CHECKBOX)"""
+  optionId: ID
+
+  """Selected option IDs (MULTI_SELECT — Faza 2)"""
+  optionIds: [ID!]
+
+  """Selected option label (snapshot)"""
+  optionLabel: String
+
+  """
+  Surcharge amount snapshot (FIXED = grosze; PERCENT = thousandths of percent)
+  """
+  surchargeAmount: Int!
+
+  """Surcharge type (snapshot)"""
+  surchargeType: AttributeOptionSurchargeType
+
+  """Tax class ID (snapshot); null = inherit from variant"""
+  taxClassId: ID
+
+  """Free-text value (TEXT/TEXTAREA/NUMBER/DATE)"""
+  textValue: String
+
+  """AttributeDefinition type (snapshot)"""
+  type: AttributeType!
+}
+
+"""
+Customer-filled attribute selection (Faza 1 R5 — server-side validated)
+"""
+input AttributeSelectionInput {
+  """AttributeDefinition ID"""
+  attributeDefinitionId: ID!
+
+  """Selected option ID for SELECT/RADIO/CHECKBOX"""
+  optionId: ID
+
+  """Selected option IDs for MULTI_SELECT (Faza 2)"""
+  optionIds: [ID!]
+
+  """Free-text value for TEXT/TEXTAREA/NUMBER/DATE"""
+  textValue: String
+}
+
 """Color or pattern swatch for visual attribute display"""
 type AttributeSwatch {
   """Hex color code (e.g., #FF5733)"""
@@ -472,6 +568,39 @@ type BusinessHour {
   openTime: String
 }
 
+"""Per-day business hours (BOPIS). Missing day = closed."""
+type BusinessHours {
+  """Friday opening windows"""
+  friday: [BusinessHoursWindow!]!
+
+  """Monday opening windows"""
+  monday: [BusinessHoursWindow!]!
+
+  """Saturday opening windows"""
+  saturday: [BusinessHoursWindow!]!
+
+  """Sunday opening windows"""
+  sunday: [BusinessHoursWindow!]!
+
+  """Thursday opening windows"""
+  thursday: [BusinessHoursWindow!]!
+
+  """Tuesday opening windows"""
+  tuesday: [BusinessHoursWindow!]!
+
+  """Wednesday opening windows"""
+  wednesday: [BusinessHoursWindow!]!
+}
+
+"""Opening window for a business day (24h format)"""
+type BusinessHoursWindow {
+  """Closing hour (0-24, 24h format). 24 = midnight close."""
+  closeHour: Int!
+
+  """Opening hour (0-23, 24h format)"""
+  openHour: Int!
+}
+
 """Provider error when fetching rates"""
 type CarrierRateError {
   """Error message"""
@@ -565,6 +694,15 @@ input CartAttributeInput {
   value: String
 }
 
+"""Result of updating cart attributes"""
+type CartAttributesUpdatePayload {
+  """Updated cart"""
+  cart: Cart
+
+  """User errors"""
+  userErrors: [UserError!]!
+}
+
 """Buyer identity information"""
 type CartBuyerIdentity {
   """Country code (ISO 3166-1 alpha-2)"""
@@ -678,7 +816,14 @@ type CartDiscountCodesUpdatePayload {
 
 """Single line item in the cart"""
 type CartLine {
-  """Custom attributes for this line"""
+  """
+  Typed customer-filled attribute selections (Faza 1 R5 — surcharge + tax snapshot)
+  """
+  attributeSelections: [AttributeSelection!]!
+
+  """
+  Shopify-compatible Line Item Properties — raw key/value pairs (e.g., gift wrap, engraving)
+  """
   attributes: [Attribute!]!
 
   """Cost information for this line"""
@@ -723,7 +868,10 @@ type CartLineCost {
 
 """Input for adding a line to cart"""
 input CartLineInput {
-  """Line attributes"""
+  """Customer-filled AttributeDefinition selections (Faza 1 R5)"""
+  attributeSelections: [AttributeSelectionInput!]
+
+  """Line attributes (Shopify Line Item Properties)"""
   attributes: [AttributeInput!]
 
   """Product variant ID"""
@@ -735,7 +883,12 @@ input CartLineInput {
 
 """Input for updating a cart line"""
 input CartLineUpdateInput {
-  """Updated attributes"""
+  """
+  Updated customer-filled attribute selections (null preserves; [] clears)
+  """
+  attributeSelections: [AttributeSelectionInput!]
+
+  """Updated Shopify Line Item Properties (null preserves)"""
   attributes: [AttributeInput!]
 
   """Cart line ID to update"""
@@ -1844,6 +1997,15 @@ type GenerateReferralCodePayload {
   userErrors: [String!]!
 }
 
+"""Geographic coordinates (latitude/longitude)"""
+input GeoCoordinateInput {
+  """Latitude in decimal degrees (-90 to 90)"""
+  latitude: Float!
+
+  """Longitude in decimal degrees (-180 to 180)"""
+  longitude: Float!
+}
+
 """Gift card information"""
 type GiftCard {
   """Current balance"""
@@ -1973,6 +2135,11 @@ type Image {
   """Image ID"""
   id: ID
 
+  """
+  ThumbHash placeholder for progressive loading (base64-encoded, ~40 chars). Decode with thumbHashToDataURL() on the client.
+  """
+  thumbhash: String
+
   """Image URL. Pass transform argument for resized/cropped CDN URLs."""
   url(transform: ImageTransformInput): String!
 
@@ -2006,26 +2173,6 @@ input ImageTransformInput {
   scale: Int
 }
 
-"""Inventory level at a specific location"""
-type InventoryLevel {
-  """
-  Available quantity (computed: onHand - committed - reserved - damaged - safetyStock)
-  """
-  available: Int!
-
-  """Location ID"""
-  locationId: ID!
-
-  """Location name"""
-  locationName: String!
-
-  """Location type"""
-  locationType: LocationType!
-
-  """On-hand quantity at this location"""
-  onHand: Int!
-}
-
 """Language configuration"""
 type Language {
   """Language code (ISO 639-1)"""
@@ -2053,6 +2200,32 @@ enum LanguageDirection {
   RTL
 }
 
+"""
+Summary of a ProductVariant linked to an AttributeOption (Faza 1.5 configurator).
+"""
+type LinkedVariantSummary {
+  """Variant ID (w tenant DB)."""
+  id: ID!
+
+  """Czy w tej chwili dostępny do zakupu (uwzględnia allowBackorder)."""
+  isAvailable: Boolean!
+
+  """Parent product ID."""
+  productId: ID!
+
+  """Dostępna ilość (stock − active reservations, zawsze ≥ 0)."""
+  quantityAvailable: Int!
+
+  """SKU jeśli zdefiniowany."""
+  sku: String
+
+  """Variant name (e.g., "Finiszer Zewnętrzny SD")."""
+  title: String!
+
+  """Czy magazyn śledzi stock dla tego wariantu."""
+  trackQuantity: Boolean!
+}
+
 """Locale to currency mapping entry"""
 type LocaleCurrencyMapping {
   """Currency code (e.g., "PLN", "USD")"""
@@ -2062,7 +2235,98 @@ type LocaleCurrencyMapping {
   locale: String!
 }
 
-"""Type of inventory location"""
+"""Inventory location (warehouse, store, pickup point)"""
+type Location {
+  """Physical address and coordinates"""
+  address: LocationAddress!
+
+  """
+  Per-day business hours. Null when not configured — use pickupLeadTimeHours only.
+  """
+  businessHours: BusinessHours
+
+  """Location ID"""
+  id: ID!
+
+  """Location display name"""
+  name: String!
+
+  """Whether this location supports BOPIS pickup"""
+  pickupEnabled: Boolean!
+
+  """Optional merchant pickup instructions (e.g., "Show ID at counter")"""
+  pickupInstructions: String
+
+  """
+  IANA timezone identifier (e.g., "Europe/Warsaw"). Falls back to shop timezone if null.
+  """
+  timezone: String
+
+  """Location type (WAREHOUSE, STORE, etc.)"""
+  type: LocationType!
+}
+
+"""Physical address of a location (Shopify LocationAddress parity)"""
+type LocationAddress {
+  """Street address line 1"""
+  address1: String
+
+  """Street address line 2 (apartment, suite)"""
+  address2: String
+
+  """City"""
+  city: String
+
+  """Country name"""
+  country: String
+
+  """Country ISO 3166-1 alpha-2 code (e.g., PL, US)"""
+  countryCode: String
+
+  """Formatted address lines (country-aware ordering)"""
+  formatted: [String!]!
+
+  """Latitude (decimal degrees)"""
+  latitude: Float
+
+  """Longitude (decimal degrees)"""
+  longitude: Float
+
+  """Phone number"""
+  phone: String
+
+  """State / province name"""
+  province: String
+
+  """State / province code (e.g., CA, MZ)"""
+  provinceCode: String
+
+  """Postal / ZIP code"""
+  zip: String
+}
+
+"""Paginated location connection"""
+type LocationConnection {
+  """Location edges"""
+  edges: [LocationEdge!]!
+
+  """Pagination info"""
+  pageInfo: PageInfo!
+
+  """Total count of locations matching the query"""
+  totalCount: Int!
+}
+
+"""Edge in a paginated Location connection"""
+type LocationEdge {
+  """Cursor for pagination"""
+  cursor: String!
+
+  """The location node"""
+  node: Location!
+}
+
+"""Type of inventory location (warehouse, physical store, etc.)"""
 enum LocationType {
   DROPSHIPPER
   FULFILLMENT_CENTER
@@ -2387,6 +2651,66 @@ input MailingAddressInput {
   zip: String
 }
 
+"""Navigation menu"""
+type Menu {
+  """URL handle (e.g., main-menu, footer)"""
+  handle: String!
+
+  """Menu ID"""
+  id: ID!
+
+  """Top-level menu items"""
+  items: [MenuItem!]!
+
+  """Total count of items across all levels"""
+  itemsCount: Int!
+
+  """Menu title"""
+  title: String!
+}
+
+"""Navigation menu item"""
+type MenuItem {
+  """Item ID"""
+  id: ID!
+
+  """Custom banner image (with url(transform:) support)"""
+  image: Image
+
+  """Child menu items (max 3 levels)"""
+  items: [MenuItem!]!
+
+  """Linked resource object (lazy, via DataLoader)"""
+  resource: MenuItemResource
+
+  """Linked resource ID"""
+  resourceId: ID
+
+  """Display title"""
+  title: String!
+
+  """Link type"""
+  type: MenuItemType!
+
+  """Resolved URL (always computed server-side)"""
+  url: String
+}
+
+union MenuItemResource = Category | Collection | Product | ShopPage
+
+"""Menu item link type"""
+enum MenuItemType {
+  BLOG
+  CATALOG
+  CATEGORY
+  COLLECTION
+  FRONTPAGE
+  HTTP
+  PAGE
+  PRODUCT
+  SEARCH
+}
+
 """Monetary value with currency"""
 type Money {
   """Decimal money amount"""
@@ -2397,6 +2721,9 @@ type Money {
 }
 
 type Mutation {
+  """Update cart attributes"""
+  cartAttributesUpdate(attributes: [CartAttributeInput!]!, cartId: ID!): CartAttributesUpdatePayload!
+
   """Update buyer identity"""
   cartBuyerIdentityUpdate(buyerIdentity: CartBuyerIdentityInput!, cartId: ID!): CartBuyerIdentityUpdatePayload!
 
@@ -2650,6 +2977,13 @@ type PageInfo {
   startCursor: String
 }
 
+"""Sort keys for pages"""
+enum PageSortKeys {
+  ID
+  TITLE
+  UPDATED_AT
+}
+
 """Payment method available for checkout"""
 type PaymentMethod {
   """Description for customers"""
@@ -2760,6 +3094,14 @@ type PricingTier {
 
 """Product - main catalog item"""
 type Product {
+  """Assigned AttributeSet ID (Hybrid Magento — shared template fields)"""
+  attributeSetId: ID
+
+  """
+  Customer-facing product attributes (configurator) — set definitions + per-product scoped
+  """
+  attributes(filter: ProductAttributeFilterInput): [ProductAttributeDefinition!]!
+
   """Whether product is available for sale (any variant in stock)"""
   availableForSale: Boolean!
 
@@ -2793,6 +3135,11 @@ type Product {
   """All product images"""
   images(first: Float = 10): [Image!]!
 
+  """
+  Per-product option definitions (Color, Size, …) with their available values. Use these to build a variant picker without aggregating `selectedOptions` manually.
+  """
+  options: [ProductOption!]!
+
   """Original compare-at price range in shop base currency"""
   originalCompareAtPriceRange: ProductPriceRange
 
@@ -2805,6 +3152,11 @@ type Product {
   """Product type/category (free text)"""
   productType: String
 
+  """
+  Whether the storefront should offer a direct purchase path (Add to cart / Buy now). Mirrors `visibility === PUBLIC`. BUNDLE_ONLY ("Komponent") products resolve to false — the PDP renders a Komponent banner explaining access is only via configurator.
+  """
+  purchasable: Boolean!
+
   """Similar products recommendations"""
   recommendations(first: Int = 4): ProductRecommendations
 
@@ -2836,6 +3188,106 @@ type Product {
 
   """Vendor/brand name"""
   vendor: String
+
+  """Catalog visibility (Faza 1.5) — PUBLIC | HIDDEN | BUNDLE_ONLY"""
+  visibility: ProductVisibility!
+}
+
+"""Product attribute definition (configurator)"""
+type ProductAttributeDefinition {
+  """Billing mode — BUNDLED | SEPARATE_LINE; null = informational only"""
+  billingMode: String
+
+  """Customer-facing description"""
+  description: String
+
+  """Display order"""
+  displayOrder: Int!
+
+  """Filling mode — MERCHANT | CUSTOMER | BOTH"""
+  fillingMode: String!
+
+  """Definition ID"""
+  id: ID!
+
+  """Required validation flag"""
+  isRequired: Boolean!
+
+  """Visibility flag"""
+  isVisible: Boolean!
+
+  """Max value (NUMBER) / max length (TEXT)"""
+  maxValue: Float
+
+  """Min value (NUMBER) / min length (TEXT)"""
+  minValue: Float
+
+  """Field name (e.g. "Finiszer")"""
+  name: String!
+
+  """Options for SELECT/RADIO/CHECKBOX types"""
+  options: [ProductAttributeOption!]!
+
+  """
+  Per-product scope — set to product ID for unique configurator fields, null for shared (in AttributeSet)
+  """
+  scopeProductId: ID
+
+  """URL-friendly slug"""
+  slug: String!
+
+  """Tax class ID; null = inherit from variant"""
+  taxClassId: ID
+
+  """Field type — TEXT/SELECT/RADIO/CHECKBOX/etc."""
+  type: AttributeType!
+}
+
+"""Filter for product attributes query"""
+input ProductAttributeFilterInput {
+  """
+  Filter by filling mode — MERCHANT | CUSTOMER | BOTH (configurator UI uses CUSTOMER + BOTH)
+  """
+  fillingMode: String
+}
+
+"""Selectable option of a product attribute (configurator)"""
+type ProductAttributeOption {
+  """Hex color (for COLOR/SWATCH types)"""
+  colorHex: String
+
+  """Option ID"""
+  id: ID!
+
+  """Default option marker"""
+  isDefault: Boolean!
+
+  """Display label shown to customer"""
+  label: String!
+
+  """
+  Summary powiązanego ProductVariant (Faza 1.5). Null gdy option nie ma linkedVariantId albo wariant został usunięty.
+  """
+  linkedVariant: LinkedVariantSummary
+
+  """
+  Linked ProductVariant ID for component stock decrement (Faza 1.5 — Hidden Products pattern)
+  """
+  linkedVariantId: ID
+
+  """Sort order"""
+  sortOrder: Int!
+
+  """
+  Surcharge amount when selected (FIXED = grosze; PERCENT = thousandths of percent — Faza 2)
+  """
+  surchargeAmount: Int
+
+  """Surcharge type — FIXED | PERCENT (Faza 2)"""
+  surchargeType: String
+
+  """Internal value (slug-style)"""
+  value: String!
 }
 
 """Paginated product list"""
@@ -2895,6 +3347,11 @@ input ProductFilterInput {
   """Filter by tags"""
   tags: [String!]
 
+  """
+  Filter by per-product variant options (e.g. Color=Red, Size=M). Multiple entries are combined with AND across different option names and OR within the same name. Matching is case-insensitive. Shopify parity.
+  """
+  variantOption: [VariantOptionFilter!]
+
   """Filter by vendor"""
   vendor: String
 
@@ -2902,6 +3359,47 @@ input ProductFilterInput {
   vendors: [String!]
 }
 
+"""Product option"""
+type ProductOption {
+  id: ID!
+
+  """Storefront rendering hint"""
+  inputType: ProductOptionInputType!
+
+  """Option name (e.g. "Color", "Size")"""
+  name: String!
+
+  """Sort position among the product's options"""
+  position: Int!
+
+  """Available values, ordered by position"""
+  values: [ProductOptionValue!]!
+}
+
+"""
+Storefront rendering hint for a product option — SELECT (dropdown), COLOR_SWATCH (colored tiles), or TEXT (free text).
+"""
+enum ProductOptionInputType {
+  COLOR_SWATCH
+  SELECT
+  TEXT
+}
+
+"""Product option value"""
+type ProductOptionValue {
+  """
+  Hex colour for COLOR_SWATCH rendering (e.g. "#FF0000"). Null for other types.
+  """
+  colorHex: String
+  id: ID!
+
+  """Display name (e.g. "Red", "XL")"""
+  name: String!
+
+  """Sort position (0-based)"""
+  position: Int!
+}
+
 """Original price range in shop base currency"""
 type ProductPriceRange {
   """Maximum variant price (shop currency)"""
@@ -3025,11 +3523,6 @@ type ProductVariant {
   """Variant image"""
   image: Image
 
-  """
-  Inventory levels per location. Null for single-location shops. Use locationType filter for BOPIS.
-  """
-  inventoryLevels(locationType: LocationType): [InventoryLevel!]
-
   """Original compare at price in shop base currency"""
   originalCompareAtPrice: Money
 
@@ -3051,6 +3544,23 @@ type ProductVariant {
   """SKU code"""
   sku: String
 
+  """
+  Per-location stock availability (Shopify StoreAvailability parity). Null for single-location shops. Resolved by StoreAvailabilityResolver with `near`, `locationType`, and `@inContext(preferredLocationId)` support.
+  """
+  storeAvailability(
+    """Cursor for pagination"""
+    after: String
+
+    """Number of locations to return"""
+    first: Int! = 10
+
+    """Filter by location type (DoSwiftly extension beyond Shopify parity)"""
+    locationType: LocationType
+
+    """Sort locations by proximity to these coordinates"""
+    near: GeoCoordinateInput
+  ): StoreAvailabilityConnection
+
   """Variant title (e.g., "Large / Red")"""
   title: String!
 
@@ -3058,6 +3568,13 @@ type ProductVariant {
   weight: Float
 }
 
+"""Catalog placement — PUBLIC | HIDDEN | BUNDLE_ONLY (Faza 1.5)"""
+enum ProductVisibility {
+  BUNDLE_ONLY
+  HIDDEN
+  PUBLIC
+}
+
 type Query {
   """List of all currencies supported by the system (ECB rates)"""
   allSupportedCurrencies: [Currency!]!
@@ -3237,6 +3754,34 @@ type Query {
   """Get available languages for this shop"""
   languages: [Language!]!
 
+  """
+  Fetch a single active location by ID. Returns null when missing, inactive, or owned by another shop (tenant isolation via StorefrontShopGuard).
+  """
+  location(
+    """Location UUID"""
+    id: ID!
+  ): Location
+
+  """
+  Paginated locations for the current shop (Shopify parity). Supports proximity (`near`), pickup-only filter (`hasPickupEnabled`), and `locationType` filter.
+  """
+  locations(
+    """Cursor for pagination"""
+    after: String
+
+    """Number of locations to return"""
+    first: Int! = 20
+
+    """Filter to only pickup-enabled locations (for store picker UI)"""
+    hasPickupEnabled: Boolean
+
+    """Filter by location type"""
+    locationType: LocationType
+
+    """Sort locations by proximity to these coordinates"""
+    near: GeoCoordinateInput
+  ): LocationConnection!
+
   """Get loyalty member status"""
   loyaltyMember: LoyaltyMember
 
@@ -3252,6 +3797,36 @@ type Query {
   """Get loyalty transaction history"""
   loyaltyTransactions(after: String, first: Int = 20): LoyaltyTransactionConnection!
 
+  """Get a navigation menu by handle"""
+  menu(handle: String!): Menu
+
+  """Get a page by handle or ID"""
+  page(
+    """Page handle"""
+    handle: String
+
+    """Page ID"""
+    id: ID
+  ): ShopPage
+
+  """List pages with pagination"""
+  pages(
+    """Pagination cursor"""
+    after: String
+
+    """Number of pages to return"""
+    first: Int! = 20
+
+    """Search query (title/handle match)"""
+    query: String
+
+    """Reverse sort order"""
+    reverse: Boolean! = false
+
+    """Sort key"""
+    sortKey: PageSortKeys! = TITLE
+  ): ShopPageConnection!
+
   """Get single product by ID or handle"""
   product(
     """Product handle (slug)"""
@@ -3353,6 +3928,15 @@ type Query {
   """Get translations for a language"""
   translations(input: TranslationsInput!): Translations!
 
+  """List URL redirects"""
+  urlRedirects(
+    """Pagination cursor"""
+    after: String
+
+    """Number of redirects to return (max 250)"""
+    first: Int! = 250
+  ): UrlRedirectConnection!
+
   """Get wishlist by ID"""
   wishlist(
     """Wishlist ID"""
@@ -3755,6 +4339,11 @@ type SelectedOption {
   """Option name (e.g., "Size", "Color")"""
   name: String!
 
+  """
+  Relational `ProductOptionValue.id` — stable FK reference. Null only for legacy variants whose option values have not yet been migrated to the relational model.
+  """
+  optionValueId: ID
+
   """Option value (e.g., "Large", "Red")"""
   value: String!
 }
@@ -4093,6 +4682,57 @@ type ShopFonts {
   primary: String
 }
 
+"""Static CMS page (About, FAQ, Terms, Privacy, Contact)"""
+type ShopPage {
+  """HTML body content"""
+  body: String!
+
+  """Auto-generated plain text summary"""
+  bodySummary: String!
+
+  """Created date (ISO 8601)"""
+  createdAt: String!
+
+  """URL handle"""
+  handle: String!
+
+  """Page ID"""
+  id: ID!
+
+  """Publish date (ISO 8601)"""
+  publishedAt: String
+
+  """SEO metadata"""
+  seo: SEO
+
+  """Page title"""
+  title: String!
+
+  """Updated date (ISO 8601)"""
+  updatedAt: String!
+}
+
+"""Paginated shop pages"""
+type ShopPageConnection {
+  """Page edges"""
+  edges: [ShopPageEdge!]!
+
+  """Pagination info"""
+  pageInfo: PageInfo!
+
+  """Total count of pages"""
+  totalCount: Int!
+}
+
+"""Shop page edge"""
+type ShopPageEdge {
+  """Cursor for pagination"""
+  cursor: String!
+
+  """Page node"""
+  node: ShopPage!
+}
+
 """Shop social media links"""
 type SocialLinks {
   """Facebook page URL"""
@@ -4117,6 +4757,46 @@ type SocialLinks {
   youtube: String
 }
 
+"""Per-location stock availability (Shopify StoreAvailability parity)"""
+type StoreAvailability {
+  """Whether the variant is in stock at this location"""
+  available: Boolean!
+
+  """Location where this stock resides"""
+  location: Location!
+
+  """
+  Human-readable pickup readiness string, localized (e.g., "Usually ready in 2 hours"). Null if location does not support pickup.
+  """
+  pickUpTime: String
+
+  """
+  Quantity available at this location. Token-gated: null for anonymous requests, Int for authenticated customer context (Shopify parity).
+  """
+  quantityAvailable: Int
+}
+
+"""Paginated store availability connection"""
+type StoreAvailabilityConnection {
+  """Availability edges"""
+  edges: [StoreAvailabilityEdge!]!
+
+  """Pagination info"""
+  pageInfo: PageInfo!
+
+  """Total count of locations with stock availability"""
+  totalCount: Int!
+}
+
+"""Edge in a paginated StoreAvailability connection"""
+type StoreAvailabilityEdge {
+  """Cursor for pagination"""
+  cursor: String!
+
+  """The availability node"""
+  node: StoreAvailability!
+}
+
 """Lifecycle status of an order"""
 enum StorefrontOrderStatus {
   CANCELLED
@@ -4207,6 +4887,24 @@ input TranslationsInput {
   namespaces: [String!]
 }
 
+"""URL redirect (SEO, store migration)"""
+type UrlRedirect {
+  """Source path"""
+  path: String!
+
+  """Target path or URL"""
+  target: String!
+}
+
+"""Paginated URL redirects"""
+type UrlRedirectConnection {
+  """Redirect nodes"""
+  nodes: [UrlRedirect!]!
+
+  """Pagination info"""
+  pageInfo: PageInfo!
+}
+
 """User-facing error from mutations"""
 type UserError {
   """Error code"""
@@ -4219,6 +4917,15 @@ type UserError {
   message: String!
 }
 
+"""Per-product variant option filter (Color, Size, …)"""
+input VariantOptionFilter {
+  """Option name (e.g. "Color")"""
+  name: String!
+
+  """Option value (e.g. "Red")"""
+  value: String!
+}
+
 """Customer wishlist"""
 type Wishlist {
   """Created date"""