@nautical-commerce/graphql-schema 4.20.2 → 4.21.0

package/nautical/schema.graphql

@@ -10033,6 +10033,16 @@ type Mutation {
   """Remove a user from a seller. Only for marketplace operators."""
   sellerUserMappingDelete(input: SellerUserInput!): SellerUserMappingDelete!
 
+  """
+  Delete a seller, with what belongs only to it. Refused with CANNOT_DELETE while anything deleting it must not destroy remains, such as products, orders or a staff user on no other seller; Seller.deletionPlan says what. NOT_FOUND when another request deletes it while this one runs. Requires MANAGE_MARKETPLACE.
+  """
+  sellerDelete(id: ID!): SellerDelete!
+
+  """
+  Delete sellers, all of them or none. A seller that cannot be deleted stops the batch, and each such seller gets a CANNOT_DELETE error naming it in `sellers`; one another request deletes while this one runs stops it too, with NOT_FOUND. The batch is judged as a whole: a staff user whose only sellers are all in it blocks it. Requires MANAGE_MARKETPLACE.
+  """
+  sellerBulkDelete(ids: [ID!]!): SellerBulkDelete!
+
   """Create an address for a seller. Requires seller access."""
   sellerAddressCreate(sellerId: ID!, input: AddressInput!): SellerAddressCreate!
 
@@ -20847,6 +20857,11 @@ type Seller implements Node & ObjectWithMetadata {
   """Whether payouts are enabled for this seller"""
   externalPayoutStatus: Boolean
 
+  """
+  Whether sellerDelete would delete this seller now, what stops it, and what deleting it deletes or unlinks along with it. Requires MANAGE_MARKETPLACE.
+  """
+  deletionPlan: SellerDeletionPlan
+
   """Seller onboarding checklists"""
   checklists: [SellerOnboardingChecklist!]!
 
@@ -21301,6 +21316,15 @@ type SellerBannerUpdate {
   sellerErrors: [SellerError!]!
 }
 
+"""Result of seller bulk delete mutation."""
+type SellerBulkDelete {
+  """Number of sellers deleted."""
+  count: Int!
+
+  """List of errors that occurred executing the mutation."""
+  sellerErrors: [SellerError!]!
+}
+
 """Events that can trigger checklist item completion"""
 enum SellerChecklistCompletionTriggersEnum {
   PAYOUT_ACCOUNT_CREATED
@@ -21368,6 +21392,85 @@ type SellerDataUpdate {
   sellerErrors: [SellerError!]!
 }
 
+"""Result of seller delete mutation."""
+type SellerDelete {
+  """
+  The deleted seller, as it was immediately before deletion. Refetching it by ID returns null.
+  """
+  seller: Seller
+
+  """List of errors that occurred executing the mutation."""
+  sellerErrors: [SellerError!]!
+}
+
+"""Something that stops a seller from being deleted."""
+type SellerDeletionBlocker {
+  """The rule that blocks the deletion."""
+  code: SellerDeletionBlockerCode!
+
+  """How many records the rule found."""
+  count: Int!
+
+  """What blocks the deletion, for a person deciding what to do about it."""
+  message: String!
+}
+
+"""Why a seller cannot be deleted yet."""
+enum SellerDeletionBlockerCode {
+  MARKETPLACE_SELLER
+  SOLE_SELLER_OF_STAFF
+  PRODUCTS
+  PRODUCT_VARIANTS
+  DELETED_VARIANTS_ON_ORDERS
+  DELETED_VARIANTS_PURCHASED
+  DELETED_VARIANTS_IN_BUNDLES
+  DELETED_PRODUCTS_IN_MENUS
+  ORDERS
+  VENDOR_PAYOUTS
+  LEDGER_ENTRIES
+  ENTITLEMENTS
+  LICENSE_KEY_POOLS
+  CAPACITY_POOLS
+  WEBHOOK_TRANSACTIONS
+  WAREHOUSE_STOCK
+  ATTRIBUTE_VALUES_IN_USE
+  CREATED_ATTRIBUTES
+  CREATED_PRODUCT_TYPES
+  PRODUCT_MEDIA
+  NESTED_MENU_ITEMS
+  REFERENCED_RECORDS
+}
+
+"""Records that deleting a seller deletes, or keeps and unlinks."""
+type SellerDeletionImpact {
+  """The records and their count, e.g. "2 warehouses"."""
+  label: String!
+
+  """How many records."""
+  count: Int!
+
+  """Whether the records are deleted, or kept and unlinked from the seller."""
+  action: SellerDeletionImpactAction!
+}
+
+"""What deleting a seller does to records that reference it."""
+enum SellerDeletionImpactAction {
+  DELETE
+  UNLINK
+}
+
+"""Whether a seller can be deleted now, and what deleting it does."""
+type SellerDeletionPlan {
+  """Whether sellerDelete would delete this seller now."""
+  canDelete: Boolean!
+
+  """What stops the deletion. Empty when canDelete is true."""
+  blockers: [SellerDeletionBlocker!]!
+
+  """What deleting the seller deletes, or keeps and unlinks, along with it."""
+  impacts: [SellerDeletionImpact!]!
+}
+
 """
 Whether a seller may sell digital-kind products (SPEC-029). SUSPENDED unpublishes the seller's digital products with a stamped warning.
 """
@@ -21386,10 +21489,14 @@ type SellerError {
 
   """The error code."""
   code: SellerErrorCode!
+
+  """IDs of the sellers that caused the error."""
+  sellers: [ID!]
 }
 
 """An enumeration of possible error codes for seller operations."""
 enum SellerErrorCode {
+  CANNOT_DELETE
   GRAPHQL_ERROR
   INVALID
   INVALID_PHONE
@@ -25376,6 +25483,7 @@ enum WebhookEventTypeEnum {
   REFUND_UPDATED
   SELLER_CREATED
   SELLER_UPDATED
+  SELLER_DELETED
   SELLER_AGREEMENT_ACKNOWLEDGED
   SELLER_AGREEMENT_DECLINED
   VARIANT_CREATED

package/package.json

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