@nautical-commerce/graphql-schema 4.5.2 → 4.7.0

package/nautical/schema.graphql

@@ -175,6 +175,7 @@ enum AccountErrorCode {
   DELETE_STAFF_ACCOUNT
   DELETE_SUPERUSER_ACCOUNT
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   INVALID_PHONE
   INVALID_PASSWORD
@@ -602,6 +603,7 @@ type AgreementError {
 """An enumeration of possible error codes for agreement operations."""
 enum AgreementErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   PERMISSION_DENIED
@@ -1103,6 +1105,7 @@ enum AnalyticsExportErrorCode {
   INVALID_DATE_RANGE
   PERMISSION_DENIED
   EXPORT_TYPE_NOT_AVAILABLE
+  INTERNAL_ERROR
   INVALID
 }
 
@@ -1302,6 +1305,7 @@ type AppError {
 enum AppErrorCode {
   FORBIDDEN
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   INVALID_STATUS
   INVALID_PERMISSION
@@ -5458,6 +5462,7 @@ type DesignerError {
 enum DesignerErrorCode {
   CANNOT_ASSIGN_NODE
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   REQUIRED
@@ -5964,6 +5969,7 @@ enum DocumentErrorCode {
   NUMBER_NOT_SET
   INVALID_STATUS
   NOT_FOUND
+  INTERNAL_ERROR
   INVALID
   GRAPHQL_ERROR
   UNSUPPORTED_FILE_TYPE
@@ -6439,6 +6445,134 @@ input EmailTemplateUpdateInput {
   isCustom: Boolean = null
 }
 
+"""
+A customer's durable claim on something they bought, held separately from the artifacts that deliver it. A download link may expire or be re-issued without changing what the customer owns.
+"""
+type Entitlement implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+
+  """Identity the claim is bound to. Present even for guest checkouts."""
+  customerEmail: String!
+
+  """Units covered by this claim."""
+  quantity: Int!
+
+  """Product name as recorded at purchase — survives catalog changes."""
+  productName: String!
+
+  """Variant name at purchase."""
+  variantName: String!
+
+  """SKU at purchase."""
+  productSku: String!
+
+  """When the claim was granted."""
+  grantedAt: DateTime
+
+  """When the claim lapses, if ever."""
+  expiresAt: DateTime
+
+  """When the claim was withdrawn."""
+  revokedAt: DateTime
+
+  """Row creation time."""
+  createdAt: DateTime!
+
+  """Row last-modified time."""
+  updatedAt: DateTime!
+
+  """Lifecycle state of the claim."""
+  status: EntitlementStatus!
+
+  """How this was fulfilled, snapshotted at grant time."""
+  kind: FulfillmentKind!
+
+  """Why the claim was withdrawn, if it was."""
+  revokedReason: EntitlementRevokedReason
+
+  """
+  Whether redemption is permitted right now. Combines status with the expiry clock, since nothing sweeps lapsed rows.
+  """
+  isUsable: Boolean!
+
+  """The variant this claim covers, if it still exists."""
+  variant: ProductVariant
+
+  """Uses of this entitlement, most recent first."""
+  redemptions: [RedemptionEvent!]!
+
+  """Download credentials issued against this entitlement."""
+  contentUrls: [DigitalContentUrl!]!
+}
+
+"""A connection to a list of items."""
+type EntitlementCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [EntitlementCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type EntitlementCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: Entitlement!
+}
+
+"""Represents errors from entitlement operations."""
+type EntitlementError {
+  field: String
+
+  """The error message."""
+  message: String!
+
+  """The error code."""
+  code: EntitlementErrorCode!
+}
+
+"""An enumeration of possible error codes for entitlement operations."""
+enum EntitlementErrorCode {
+  GRAPHQL_ERROR
+  INTERNAL_ERROR
+  INVALID
+  NOT_FOUND
+}
+
+"""Payload for entitlementRevoke."""
+type EntitlementRevoke {
+  entitlement: Entitlement
+  entitlementErrors: [EntitlementError!]!
+}
+
+"""Why an entitlement was withdrawn. Drives downstream trust policy."""
+enum EntitlementRevokedReason {
+  REFUND
+  CHARGEBACK
+  FRAUD
+  OPERATOR
+  SELLER
+}
+
+"""
+Lifecycle of a customer's claim. States rather than booleans: 'revoked because refunded' and 'expired because the term ended' are different facts, and only ACTIVE permits redemption.
+"""
+enum EntitlementStatus {
+  PENDING
+  ACTIVE
+  SUSPENDED
+  EXPIRED
+  REVOKED
+  TRANSFERRED
+}
+
 """Represents a generic event in the audit log."""
 type Event {
   """The unique identifier across all event tables."""
@@ -6546,6 +6680,7 @@ type ExportError {
 """An enumeration of possible error codes for export operations."""
 enum ExportErrorCode {
   FORBIDDEN
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   REQUIRED
@@ -6792,6 +6927,7 @@ type FinancialError {
 """An enumeration of possible error codes for financial operations."""
 enum FinancialErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   REQUIRED
@@ -6994,6 +7130,15 @@ type FulfillmentCountableEdge {
   node: Fulfillment!
 }
 
+"""
+How a catalog entity is fulfilled (SPEC-029). Source of truth for isDigital/isShippingRequired, which are derived projections.
+"""
+enum FulfillmentKind {
+  SHIPMENT
+  DIGITAL_FILE
+  SERVICE
+}
+
 """Represents a line in a fulfillment."""
 type FulfillmentLine implements Node {
   """The Globally Unique ID of this object"""
@@ -7285,6 +7430,7 @@ type ImportError {
 """An enumeration of possible error codes for import operations."""
 enum ImportErrorCode {
   FORBIDDEN
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   REQUIRED
@@ -8188,6 +8334,7 @@ type MarketplaceConfiguration {
   automaticFulfillmentDigitalProducts: Boolean!
   defaultDigitalMaxDownloads: Int
   defaultDigitalUrlValidDays: Int
+  revokeEntitlementsOnRefund: Boolean!
   trackInventoryByDefault: Boolean!
   name: String!
   defaultMailSenderName: String!
@@ -8242,6 +8389,11 @@ type MarketplaceConfiguration {
   """Supported countries for the marketplace."""
   supportedCountries: [String!]!
 
+  """
+  Which fulfillment kinds this marketplace allows on catalog entities (SPEC-029).
+  """
+  enabledFulfillmentKinds: [FulfillmentKind!]!
+
   """The default country for the marketplace."""
   defaultCountry: String!
 
@@ -8460,6 +8612,7 @@ An enumeration of possible error codes for marketplace configuration operations.
 """
 enum MarketplaceConfigurationErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
 }
 
@@ -8483,6 +8636,11 @@ input MarketplaceConfigurationInput {
   automaticFulfillmentDigitalProducts: Boolean = null
   defaultDigitalMaxDownloads: Int = null
   defaultDigitalUrlValidDays: Int = null
+
+  """
+  Which fulfillment kinds this marketplace allows on catalog entities (SPEC-029).
+  """
+  enabledFulfillmentKinds: [FulfillmentKind!] = null
   trackInventoryByDefault: Boolean = null
   name: String = null
   description: String = null
@@ -9148,6 +9306,7 @@ type MetadataError {
 """An enumeration of possible error codes for metadata operations."""
 enum MetadataErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   PERMISSION_DENIED
@@ -9816,6 +9975,11 @@ type Mutation {
   """Complete checkout and create order."""
   checkoutComplete(checkoutId: ID!, storeSource: Boolean = false, poNumber: String = null, userOverride: ID = null, redirectUrl: String = null, paymentData: JSONString = null): CheckoutComplete!
 
+  """
+  Withdraw a customer's entitlement, invalidating any download links issued against it. Requires MANAGE_MARKETPLACE.
+  """
+  entitlementRevoke(id: ID!, reason: EntitlementRevokedReason! = OPERATOR): EntitlementRevoke!
+
   """Create a new payout synchronously."""
   payoutCreate(input: PayoutCreateInput!): PayoutCreate! @deprecated(reason: "This will be removed on July 15, 2025. Use payoutCreateAsync instead.")
 
@@ -10578,6 +10742,7 @@ An enumeration of possible error codes for nautical configuration operations.
 """
 enum NauticalConfigurationErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
 }
 
@@ -11402,6 +11567,7 @@ type NauticalOrderLine implements Node & ObjectWithMetadata {
   variantName: String!
   productSku: String
   isShippingRequired: Boolean!
+  fulfillmentKind: OrdersNauticalOrderLineFulfillmentKindEnum!
   quantity: Int!
   quantityFulfilled: Int!
   currency: String!
@@ -11734,6 +11900,7 @@ type NotificationError {
 """An enumeration of possible error codes for notification operations."""
 enum NotificationErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   NOT_FOUND
   REQUIRED
   INVALID
@@ -12650,6 +12817,7 @@ type OrderLine implements Node & ObjectWithMetadata {
   variantName: String!
   productSku: String
   isShippingRequired: Boolean!
+  fulfillmentKind: OrderOrderLineFulfillmentKindEnum!
   quantity: Int!
   quantityFulfilled: Int!
   quantityDeclined: Int!
@@ -12817,6 +12985,36 @@ type OrderMetrics {
   bySeller: [PieChartSegment!]
 }
 
+"""order line | fulfillment kind"""
+enum OrderOrderLineFulfillmentKindEnum {
+  """Shipment"""
+  shipment
+
+  """Digital file"""
+  digital_file
+
+  """Service"""
+  service
+
+  """License key"""
+  license_key
+
+  """Code"""
+  code
+
+  """Gift card"""
+  gift_card
+
+  """External provisioning"""
+  external
+
+  """Booking"""
+  booking
+
+  """Ticket"""
+  ticket
+}
+
 """Order source values."""
 enum OrderOrderSource {
   CHECKOUT
@@ -13119,6 +13317,36 @@ type OrdersByStatusType {
   count: Int
 }
 
+"""nautical order line | fulfillment kind"""
+enum OrdersNauticalOrderLineFulfillmentKindEnum {
+  """Shipment"""
+  shipment
+
+  """Digital file"""
+  digital_file
+
+  """Service"""
+  service
+
+  """License key"""
+  license_key
+
+  """Code"""
+  code
+
+  """Gift card"""
+  gift_card
+
+  """External provisioning"""
+  external
+
+  """Booking"""
+  booking
+
+  """Ticket"""
+  ticket
+}
+
 """
 A static page that can be manually added by a shop operator through the dashboard.
 """
@@ -13219,6 +13447,7 @@ type PageError {
 """An enumeration of possible error codes for page operations."""
 enum PageErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   REQUIRED
@@ -14026,6 +14255,7 @@ enum PermissionGroupErrorCode {
   ASSIGN_NON_STAFF_MEMBER
   DUPLICATED_INPUT_ITEM
   CANNOT_REMOVE_FROM_LAST_GROUP
+  INTERNAL_ERROR
   LEFT_NOT_MANAGEABLE_PERMISSION
   OUT_OF_SCOPE_PERMISSION
   OUT_OF_SCOPE_USER
@@ -14375,6 +14605,7 @@ type PolicyError {
 """An enumeration of possible error codes for policy operations."""
 enum PolicyErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   REQUIRED
@@ -14582,6 +14813,11 @@ type Product implements Node & ObjectWithMetadata {
   """
   timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
 
+  """
+  Typed fulfillment kind (SPEC-029) — source of truth for isDigital/isShippingRequired
+  """
+  fulfillmentKind: FulfillmentKind!
+
   """Sort order of the product"""
   sortOrder: Int
 
@@ -14885,6 +15121,11 @@ input ProductBulkCreateInput {
   """Set whether this product is digital."""
   isDigital: Boolean = null
 
+  """
+  Typed fulfillment kind (SPEC-029). Takes precedence over isDigital/isShippingRequired.
+  """
+  fulfillmentKind: FulfillmentKind = null
+
   """Set whether this product allows price overrides."""
   isPriceOverrideAllowed: Boolean = null
   weight: WeightScalar = null
@@ -15081,6 +15322,11 @@ input ProductCreateInput {
   """
   isDigital: Boolean = null
 
+  """
+  Typed fulfillment kind (SPEC-029). Takes precedence over isDigital/isShippingRequired, which become derived projections of it.
+  """
+  fulfillmentKind: FulfillmentKind = null
+
   """
   Set whether this product allows price overrides by default, will be controlled by product type if provided.
   """
@@ -15226,7 +15472,7 @@ enum ProductFieldEnum {
 }
 
 """
-Product(id, publication_date, is_published, private_metadata, metadata, description, description_html, deleted_at, deleted_by_user, deleted_by_app, deletion_batch_uuid, external_id, external_source, external_inventory_id, tenant, seller, seo_title, seo_description, product_type, name, slug, search_vector, category, currency, minimal_variant_price_amount, updated_at, created_at, charge_taxes, weight, available_for_purchase, visible_in_listings, default_variant, cumulative_price_amount, override_price, override_currency, status, sub_status, is_price_override_allowed, is_shipping_required, is_digital, is_bundle, warnings, product_source, allow_seller_variants, minimal_variant_price, cumulative_price)
+Product(id, publication_date, is_published, private_metadata, metadata, description, description_html, deleted_at, deleted_by_user, deleted_by_app, deletion_batch_uuid, external_id, external_source, external_inventory_id, tenant, seller, seo_title, seo_description, product_type, name, slug, search_vector, category, currency, minimal_variant_price_amount, updated_at, created_at, charge_taxes, weight, available_for_purchase, visible_in_listings, default_variant, cumulative_price_amount, override_price, override_currency, status, sub_status, is_price_override_allowed, is_shipping_required, is_digital, fulfillment_kind, is_bundle, warnings, product_source, allow_seller_variants, minimal_variant_price, cumulative_price)
 """
 input ProductFilterInput {
   isPublished: Boolean
@@ -15564,6 +15810,11 @@ input ProductInput {
   """
   isDigital: Boolean = null
 
+  """
+  Typed fulfillment kind (SPEC-029). Takes precedence over isDigital/isShippingRequired, which become derived projections of it.
+  """
+  fulfillmentKind: FulfillmentKind = null
+
   """
   Set whether this product allows price overrides by default, will be controlled by product type if provided.
   """
@@ -15820,6 +16071,11 @@ type ProductType implements Node & ObjectWithMetadata {
     last: Int = null
   ): ProductTypeAuditEventCountableConnection!
 
+  """
+  Typed fulfillment kind (SPEC-029) — source of truth for isDigital/isShippingRequired
+  """
+  fulfillmentKind: FulfillmentKind!
+
   """Legacy indicator, always true"""
   hasVariants: Boolean!
 
@@ -15996,7 +16252,7 @@ enum ProductTypeEnum {
 }
 
 """
-ProductType(id, private_metadata, metadata, description, description_html, external_id, external_source, external_inventory_id, tenant, name, slug, is_shipping_required, is_locked, is_digital, externally_managed, weight, is_price_override_allowed, created_by)
+ProductType(id, private_metadata, metadata, description, description_html, external_id, external_source, external_inventory_id, tenant, name, slug, is_shipping_required, is_locked, is_digital, fulfillment_kind, externally_managed, weight, is_price_override_allowed, created_by)
 """
 input ProductTypeFilterInput {
   isDigital: Boolean
@@ -16022,6 +16278,7 @@ input ProductTypeInput {
   variantAttributes: [ID!] = null
   isShippingRequired: Boolean = null
   isDigital: Boolean = null
+  fulfillmentKind: FulfillmentKind = null
   weight: WeightScalar = null
   taxCode: String = null
 
@@ -16177,6 +16434,11 @@ type ProductVariant implements Node & ObjectWithMetadata {
   """
   currency: String!
 
+  """
+  Typed fulfillment kind (SPEC-029) — source of truth for isDigital/isShippingRequired
+  """
+  fulfillmentKind: FulfillmentKind!
+
   """Status of the variant"""
   status: ProductVariantStatus!
 
@@ -16404,6 +16666,11 @@ input ProductVariantBulkCreateInput {
   """Set whether this variant is digital."""
   isDigital: Boolean = null
 
+  """
+  Typed fulfillment kind (SPEC-029). Takes precedence over isDigital/isShippingRequired.
+  """
+  fulfillmentKind: FulfillmentKind = null
+
   """Set whether this variant allows price overrides."""
   isPriceOverrideAllowed: Boolean = null
 
@@ -16520,6 +16787,11 @@ input ProductVariantCreateInput {
   """
   isDigital: Boolean = null
 
+  """
+  Typed fulfillment kind (SPEC-029). Takes precedence over isDigital/isShippingRequired, which become derived projections of it.
+  """
+  fulfillmentKind: FulfillmentKind = null
+
   """
   Set whether this variant allows price overrides by default, will be overridden by product type attached to product if available.
   """
@@ -16552,7 +16824,7 @@ type ProductVariantDelete {
 }
 
 """
-ProductVariant(id, sort_order, private_metadata, metadata, created_at, updated_at, deleted_at, deleted_by_user, deleted_by_app, deletion_batch_uuid, external_id, external_source, external_inventory_id, tenant, seo_title, seo_description, sku, name, is_user_defined_name, nautical_stock_number, status, sub_status, currency, price_amount, product, track_inventory, cost_price_amount, weight, seller, published_at, is_published, override_currency, search_vector, allow_backorders, is_price_override_allowed, is_shipping_required, is_digital, warnings, price, cost_price)
+ProductVariant(id, sort_order, private_metadata, metadata, created_at, updated_at, deleted_at, deleted_by_user, deleted_by_app, deletion_batch_uuid, external_id, external_source, external_inventory_id, tenant, seo_title, seo_description, sku, name, is_user_defined_name, nautical_stock_number, status, sub_status, currency, price_amount, product, track_inventory, cost_price_amount, weight, seller, published_at, is_published, override_currency, search_vector, allow_backorders, is_price_override_allowed, is_shipping_required, is_digital, fulfillment_kind, warnings, price, cost_price)
 """
 input ProductVariantFilterInput {
   isPublished: Boolean
@@ -16689,6 +16961,11 @@ input ProductVariantInput {
   """
   isDigital: Boolean = null
 
+  """
+  Typed fulfillment kind (SPEC-029). Takes precedence over isDigital/isShippingRequired, which become derived projections of it.
+  """
+  fulfillmentKind: FulfillmentKind = null
+
   """
   Set whether this variant allows price overrides by default, will be overridden by product type attached to product if available.
   """
@@ -17087,6 +17364,7 @@ enum ProductWarningEnum {
   VARIANT_ATTRIBUTE_VALUE_REQUIRED
   DEFAULT_VARIANT_REQUIRED
   SELLER_PAUSED
+  SELLER_DIGITAL_SUSPENDED
 }
 
 """Result of products export mutation."""
@@ -17819,6 +18097,23 @@ type Query {
     last: Int = null
   ): RefundCountableConnection!
 
+  """
+  List entitlements. Requires MANAGE_ORDERS. Marketplace operators see every entitlement; a seller sees only claims against their own goods.
+  """
+  entitlements(
+    """Returns the items in the list that come before the specified cursor."""
+    before: String = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    after: String = null
+
+    """Returns the first n items from the list."""
+    first: Int = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    last: Int = null
+  ): EntitlementCountableConnection!
+
   """Look up a payout by ID. Requires MANAGE_PAYOUTS permission."""
   payout(id: ID!): Payout
 
@@ -18503,6 +18798,36 @@ enum RecipientTypeEnum {
   STAFF_MEMBER_MARKETPLACE_OR_SELLER @deprecated(reason: "Use STAFF_MEMBER_MARKETPLACE or STAFF_MEMBER_SELLER instead. This value will be deprecated on September 30, 2025")
 }
 
+"""
+A single use of an entitlement — a download now, a scan or activation later.
+"""
+type RedemptionEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+
+  """When the redemption happened."""
+  occurredAt: DateTime!
+
+  """What kind of use this was."""
+  eventType: RedemptionEventType!
+
+  """
+  Key that made this redemption idempotent, when the producer supplied one. Downloads have none — every download is a distinct use.
+  """
+  idempotencyKey: String
+}
+
+"""
+A use of an entitlement. Only DOWNLOAD is produced in v1; the remaining values are reserved for the fulfillment kinds whose stacks have not shipped.
+"""
+enum RedemptionEventType {
+  DOWNLOAD
+  ACTIVATION
+  REVEAL
+  SCAN
+  CHECK_IN
+}
+
 """
 Represents a refund scoped to a nautical order, seller order, or order line.
 """
@@ -19562,6 +19887,9 @@ type Seller implements Node & ObjectWithMetadata {
   """List of seller identification values (e.g., tax IDs)"""
   identification: [String!]
 
+  """Whether this seller may sell digital-kind products (SPEC-029)"""
+  digitalSalesStatus: SellersSellerDigitalSalesStatusEnum!
+
   """Reason for agreement decision"""
   agreementDecisionReason: String!
 
@@ -20133,6 +20461,15 @@ type SellerDataUpdate {
   sellerErrors: [SellerError!]!
 }
 
+"""
+Whether a seller may sell digital-kind products (SPEC-029). SUSPENDED unpublishes the seller's digital products with a stamped warning.
+"""
+enum SellerDigitalSalesStatus {
+  NOT_REQUESTED
+  APPROVED
+  SUSPENDED
+}
+
 """Represents errors from seller operations."""
 type SellerError {
   field: String
@@ -20223,7 +20560,7 @@ enum SellerExternalPayoutSource {
 }
 
 """
-Seller(id, private_metadata, metadata, created_at, updated_at, tenant, external_payout_account_id, external_payout_source, external_payout_onboarding_url, company_name, slug, is_marketplace_seller, logo, identification, default_shipping_address, default_billing_address, owner, default_currency, fulfilled_by_marketplace, status, agreement_decision_reason, banner, store_description, external_payouts_enabled, external_payout_schedule, external_payout_status_synced_at)
+Seller(id, private_metadata, metadata, created_at, updated_at, tenant, external_payout_account_id, external_payout_source, external_payout_onboarding_url, company_name, slug, is_marketplace_seller, logo, identification, default_shipping_address, default_billing_address, owner, default_currency, fulfilled_by_marketplace, status, digital_sales_status, agreement_decision_reason, banner, store_description, external_payouts_enabled, external_payout_schedule, external_payout_status_synced_at)
 """
 input SellerFilterInput {
   AND: SellerFilterInput
@@ -20637,6 +20974,11 @@ input SellerUpdateInput {
   """New seller status"""
   status: String = null
 
+  """
+  Whether this seller may sell digital-kind products (SPEC-029). Requires MANAGE_MARKETPLACE. SUSPENDED unpublishes the seller's digital products with a stamped warning.
+  """
+  digitalSalesStatus: SellerDigitalSalesStatus = null
+
   """ID of user to set as owner"""
   user: ID = null
 
@@ -20727,6 +21069,18 @@ type SellerWithOwnerCreate {
   sellerErrors: [SellerError!]!
 }
 
+"""seller | digital sales status"""
+enum SellersSellerDigitalSalesStatusEnum {
+  """Not Requested"""
+  NOT_REQUESTED
+
+  """Approved"""
+  APPROVED
+
+  """Suspended"""
+  SUSPENDED
+}
+
 input SeoInput {
   title: String = null
   description: String = null
@@ -21147,6 +21501,7 @@ enum ShopErrorCode {
   ALREADY_EXISTS
   CANNOT_FETCH_TAX_RATES
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   PERMISSION_DENIED
@@ -22535,6 +22890,23 @@ type User implements Node & ObjectWithMetadata {
     last: Int = null
   ): WishlistCountableConnection!
 
+  """
+  The customer's library — everything they own, including items whose download links have expired. Owner-scoped: only ever the requesting user's own entitlements.
+  """
+  entitlements(
+    """Returns the items in the list that come before the specified cursor."""
+    before: String = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    after: String = null
+
+    """Returns the first n items from the list."""
+    first: Int = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    last: Int = null
+  ): EntitlementCountableConnection!
+
   """List of documents associated with the user."""
   documents: [Document!]!
 
@@ -22808,6 +23180,7 @@ type VendorPayout implements Node & ObjectWithMetadata {
   gateway: String!
   included: Boolean!
   statusMessage: String
+  externalBatchId: String!
 
   """Adjustment amount."""
   adjustmentAmount: Float! @deprecated(reason: "This will be removed on August 6, 2025. Use the adjustment field instead.")
@@ -23747,6 +24120,7 @@ enum WarehouseErrorCode {
   ALREADY_EXISTS
   FORBIDDEN
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   REQUIRED
@@ -23937,6 +24311,7 @@ type WebhookError {
 """An enumeration of possible error codes for webhook operations."""
 enum WebhookErrorCode {
   GRAPHQL_ERROR
+  INTERNAL_ERROR
   INVALID
   NOT_FOUND
   REQUIRED
@@ -24019,6 +24394,10 @@ enum WebhookEventTypeEnum {
   COLLECTION_DELETED
   COLLECTION_UPDATED
   CUSTOMER_CREATED
+  DIGITAL_CONTENT_URL_CREATED
+  DIGITAL_CONTENT_URL_REVOKED
+  ENTITLEMENT_GRANTED
+  ENTITLEMENT_REVOKED
   CUSTOMER_UPDATED
   CUSTOMER_DELETED
   FULFILLMENT_CREATED

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nautical-commerce/graphql-schema",
-  "version": "4.5.2",
+  "version": "4.7.0",
   "description": "Traide API GraphQL Schema",
   "main": "./nautical/schema.graphql",
   "scripts": {