@nautical-commerce/graphql-schema 3.12.2 → 3.13.0

package/nautical/schema.graphql

@@ -7941,6 +7941,29 @@ type MarketplaceSubscription implements Node {
   plan: String
 }
 
+"""Result of the marketplace subscription cancel mutation."""
+type MarketplaceSubscriptionCancel {
+  """The subscription that was cancelled."""
+  subscription: MarketplaceSubscription
+
+  """List of errors that occurred executing the mutation."""
+  subscriptionErrors: [MarketplaceSubscriptionError!]!
+}
+
+"""Input for cancelling a marketplace subscription."""
+input MarketplaceSubscriptionCancelInput {
+  """
+  When the cancellation takes effect (immediate or at end of billing period).
+  """
+  mode: SubscriptionCancellationMode!
+
+  """Standard reason for the cancellation."""
+  reasonCode: SubscriptionCancellationReason!
+
+  """Optional free-text detail (recommended when the reason is OTHER)."""
+  reason: String = null
+}
+
 """A connection to a list of items."""
 type MarketplaceSubscriptionCountableConnection {
   """Pagination data for this connection"""
@@ -7962,6 +7985,29 @@ type MarketplaceSubscriptionCountableEdge {
   node: MarketplaceSubscription!
 }
 
+"""Represents errors from marketplace subscription operations."""
+type MarketplaceSubscriptionError {
+  field: String
+
+  """The error message."""
+  message: String!
+
+  """The error code."""
+  code: MarketplaceSubscriptionErrorCode!
+}
+
+"""
+An enumeration of possible error codes for marketplace subscription operations.
+"""
+enum MarketplaceSubscriptionErrorCode {
+  GRAPHQL_ERROR
+  INVALID
+  NOT_FOUND
+  REQUIRED
+  NO_ACTIVE_SUBSCRIPTION
+  PROVIDER_ERROR
+}
+
 """Filter input for marketplace subscriptions"""
 input MarketplaceSubscriptionFilterInput {
   """Filter by active status."""
@@ -9772,6 +9818,11 @@ type Mutation {
   """Send invoice notification email to customer."""
   invoiceSendNotification(id: ID!): InvoiceSendNotification!
 
+  """
+  Cancel the current tenant's marketplace subscription. Internal Traide-staff tool (superuser only) — customers self-serve via the Stripe Customer Portal. Cancels the subscription in Stripe; the customer.subscription.deleted webhook performs the local deactivation. Choose IMMEDIATE or END_OF_PERIOD.
+  """
+  marketplaceSubscriptionCancel(input: MarketplaceSubscriptionCancelInput!): MarketplaceSubscriptionCancel!
+
   """
   Update public metadata of an object. Appends or updates keys without replacing existing ones.
   """
@@ -20654,6 +20705,22 @@ input StripeClientPaymentData {
   paymentMethodToken: String = null
 }
 
+"""When a subscription cancellation should take effect."""
+enum SubscriptionCancellationMode {
+  IMMEDIATE
+  END_OF_PERIOD
+}
+
+"""Reason a subscription was cancelled."""
+enum SubscriptionCancellationReason {
+  CUSTOMER_REQUEST
+  TOO_EXPENSIVE
+  MISSING_FEATURES
+  SWITCHED_SERVICE
+  UNUSED
+  OTHER
+}
+
 """Customer Tax Certificate information."""
 type TaxCertificate {
   """Certificate ID"""

package/package.json

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