@nautical-commerce/graphql-schema 3.6.16 → 3.7.0

package/nautical/schema.graphql

@@ -428,6 +428,19 @@ type AgreementCommission implements Node {
 
   """The category instance this commission applies to."""
   instance: Category
+  events(
+    """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
+  ): AgreementCommissionEventCountableConnection!
 }
 
 """Result of agreement commission create mutation."""
@@ -463,6 +476,72 @@ type AgreementCommissionDelete {
   agreementErrors: [AgreementError!]!
 }
 
+type AgreementCommissionEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'commission_added', 'commission_updated', or 'commission_removed'
+  """
+  pghLabel: String!
+
+  """JSON context captured at event time (user, app, tenant info)."""
+  pghContext: JSONString
+  pghContextId: NauticalUUID
+
+  """ContentType ID of the object this commission applies to."""
+  contentTypeId: Int
+
+  """ID of the object this commission applies to."""
+  objectId: Int!
+
+  """Commission rate at time of event."""
+  commission: Decimal!
+
+  """Email of user who made the change."""
+  userEmail: String
+
+  """Global ID of user who made the change."""
+  userId: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """Tenant slug where the change occurred."""
+  tenantSlug: String
+
+  """App name if change was via API token."""
+  appName: String
+
+  """Global ID of app if change was via API token."""
+  appId: String
+
+  """Celery task name if change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type AgreementCommissionEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [AgreementCommissionEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type AgreementCommissionEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: AgreementCommissionEvent!
+}
+
 """A connection to a list of items."""
 type AgreementCountableConnection {
   """Pagination data for this connection"""
@@ -632,6 +711,86 @@ type AgreementFees implements Node {
   """Fee value in domiciled currency"""
   feeValue: Decimal!
   feeName: String!
+  events(
+    """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
+  ): AgreementFeesEventCountableConnection!
+}
+
+type AgreementFeesEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """Event label: 'fee_added', 'fee_updated', or 'fee_removed'"""
+  pghLabel: String!
+
+  """JSON context captured at event time (user, app, tenant info)."""
+  pghContext: JSONString
+  pghContextId: NauticalUUID
+
+  """Fee type: 'percentage' or 'fixed'."""
+  feeType: String!
+
+  """Fee scope: 'line' or 'total'."""
+  feeScope: String!
+
+  """Fee value at time of event."""
+  feeValue: Decimal!
+
+  """Fee name at time of event."""
+  feeName: String!
+
+  """Email of user who made the change."""
+  userEmail: String
+
+  """Global ID of user who made the change."""
+  userId: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """Tenant slug where the change occurred."""
+  tenantSlug: String
+
+  """App name if change was via API token."""
+  appName: String
+
+  """Global ID of app if change was via API token."""
+  appId: String
+
+  """Celery task name if change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type AgreementFeesEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [AgreementFeesEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type AgreementFeesEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: AgreementFeesEvent!
 }
 
 """
@@ -692,6 +851,19 @@ type AgreementSellers implements Node {
   plan: Agreement
   acknowledgedOn: DateTime
   effectiveAt: DateTime!
+  events(
+    """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
+  ): AgreementSellersEventCountableConnection!
 }
 
 """A connection to a list of items."""
@@ -715,6 +887,65 @@ type AgreementSellersCountableEdge {
   node: AgreementSellers!
 }
 
+type AgreementSellersEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'seller_assigned', 'seller_agreement_updated', or 'seller_removed'
+  """
+  pghLabel: String!
+
+  """JSON context captured at event time (user, app, tenant info)."""
+  pghContext: JSONString
+  pghContextId: NauticalUUID
+  acknowledgedOn: DateTime
+  effectiveAt: DateTime
+
+  """Email of user who made the change."""
+  userEmail: String
+
+  """Global ID of user who made the change."""
+  userId: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """Tenant slug where the change occurred."""
+  tenantSlug: String
+
+  """App name if change was via API token."""
+  appName: String
+
+  """Global ID of app if change was via API token."""
+  appId: String
+
+  """Celery task name if change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type AgreementSellersEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [AgreementSellersEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type AgreementSellersEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: AgreementSellersEvent!
+}
+
 """Fields available for sorting agreements"""
 enum AgreementSortField {
   TITLE
@@ -724,6 +955,76 @@ enum AgreementSortField {
   PUBLICATION_DATE
 }
 
+type AgreementTimelineEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label (e.g., 'commission_added', 'fee_updated', 'seller_removed').
+  """
+  pghLabel: String!
+
+  """JSON context captured at event time."""
+  pghContext: JSONString
+
+  """Full snapshot of the model state at time of event."""
+  pghData: JSONString
+
+  """
+  Dict of changed fields (old → new values). Null for insert/delete events.
+  """
+  pghDiff: JSONString
+
+  """Source model (e.g., 'agreement.Agreement', 'agreement.AgreementFees')."""
+  pghObjModel: String!
+
+  """Primary key of the source object."""
+  pghObjId: String!
+
+  """Email of user who made the change."""
+  userEmail: String
+
+  """Global ID of user who made the change."""
+  userId: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """Tenant slug where the change occurred."""
+  tenantSlug: String
+
+  """App name if change was via API token."""
+  appName: String
+
+  """Global ID of app if change was via API token."""
+  appId: String
+
+  """Celery task name if change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type AgreementTimelineEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [AgreementTimelineEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type AgreementTimelineEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: AgreementTimelineEvent!
+}
+
 """Result of agreement update mutation."""
 type AgreementUpdate {
   """The updated agreement."""
@@ -9769,9 +10070,26 @@ type NauticalOrder implements Node & ObjectWithMetadata {
   """List of events for this order"""
   events: [NauticalOrderEvent!]!
 
-  """List of seller orders in this marketplace order"""
-  subOrders: [Order!]
-
+  """
+  Database-level audit trail for this marketplace order. Captures every field change via PostgreSQL triggers — status transitions, price updates, address changes, and more.
+  """
+  auditEvents(
+    """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
+  ): NauticalOrderAuditEventCountableConnection!
+
+  """List of seller orders in this marketplace order"""
+  subOrders: [Order!]
+
   """List of seller orders (alias for subOrders)"""
   sellerOrders: [Order!]
 
@@ -9831,6 +10149,84 @@ type NauticalOrderAddNote {
   orderErrors: [OrderError!]!
 }
 
+type NauticalOrderAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'nautical_order_placed', 'nautical_order_updated', or 'nautical_order_deleted'.
+  """
+  pghLabel: String!
+  pghContextId: NauticalUUID
+
+  """JSON context captured at event time (user, app, tenant info)."""
+  pghContext: JSONString
+
+  """Order status at time of event."""
+  status: String!
+
+  """Order sub-status at time of event."""
+  subStatus: String
+
+  """Currency code at time of event."""
+  currency: String!
+
+  """Total net amount at time of event."""
+  totalNetAmount: Decimal!
+
+  """Total gross amount at time of event."""
+  totalGrossAmount: Decimal!
+
+  """Customer email at time of event."""
+  userEmail: String!
+
+  """Order token."""
+  token: String!
+
+  """Email of staff/app user who made the change."""
+  changedByEmail: String
+
+  """Global ID of user who made the change."""
+  changedById: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """Tenant slug where the change occurred."""
+  tenantSlug: String
+
+  """App name if change was via API token."""
+  appName: String
+
+  """Global ID of app if change was via API token."""
+  appId: String
+
+  """Celery task name if change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type NauticalOrderAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [NauticalOrderAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type NauticalOrderAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: NauticalOrderAuditEvent!
+}
+
 """Result of nauticalOrderBulkAssignCustomer mutation."""
 type NauticalOrderBulkAssignCustomer {
   """Orders that had customer assigned."""
@@ -10336,7 +10732,7 @@ type NauticalQuoteOrderSendToCustomer {
   orderErrors: [OrderError!]!
 }
 
-"""UUID scalar with enhanced error handling"""
+"""UUID scalar with format validation (Graphene v3.4.6 parity)"""
 scalar NauticalUUID
 
 """Net sales by category row."""
@@ -10686,6 +11082,23 @@ type Order implements Node & ObjectWithMetadata {
   """List of events for this order"""
   events: [OrderEvent!]!
 
+  """
+  Database-level audit trail for this seller order. Captures every field change via PostgreSQL triggers.
+  """
+  auditEvents(
+    """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
+  ): OrderAuditEventCountableConnection!
+
   """List of fees for this order"""
   fees: [OrderFee!]!
 
@@ -10760,6 +11173,76 @@ input OrderAddNoteInput {
   message: String!
 }
 
+type OrderAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """Event label: 'order_created', 'order_updated', or 'order_deleted'."""
+  pghLabel: String!
+  pghContextId: NauticalUUID
+
+  """JSON context captured at event time."""
+  pghContext: JSONString
+
+  """Order status at time of event."""
+  status: String!
+
+  """Order sub-status at time of event."""
+  subStatus: String
+
+  """Payout status at time of event."""
+  payoutStatus: String!
+
+  """Currency code at time of event."""
+  currency: String!
+
+  """Total net amount at time of event."""
+  totalNetAmount: Decimal!
+
+  """Total gross amount at time of event."""
+  totalGrossAmount: Decimal!
+
+  """Customer email at time of event."""
+  userEmail: String!
+
+  """Order token."""
+  token: String!
+
+  """Email of staff/app user who made the change."""
+  changedByEmail: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """App name if change was via API token."""
+  appName: String
+
+  """Celery task name if change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type OrderAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [OrderAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type OrderAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: OrderAuditEvent!
+}
+
 """Result of orderBulkCancel mutation."""
 type OrderBulkCancel {
   """Number of orders cancelled."""
@@ -11414,6 +11897,9 @@ type OrderPayoutSummary {
   """Shipping in the payout"""
   shipping: Money!
 
+  """Manual ledger adjustments that affected the payout"""
+  adjustments: Money!
+
   """Total for this payout"""
   total: Money!
 
@@ -11966,6 +12452,23 @@ type Payment implements Node & ObjectWithMetadata {
   """List of all transactions within this payment."""
   transactions: [Transaction!]!
 
+  """
+  Database-level financial audit trail. Captures every field change via row-level PostgreSQL triggers — charge status transitions, captured amount changes, and more.
+  """
+  auditEvents(
+    """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
+  ): PaymentEventCountableConnection!
+
   """ID of the checkout this payment is for."""
   checkoutId: ID
 
@@ -12050,6 +12553,75 @@ enum PaymentErrorCode {
   INSUFFICIENT_STOCK
 }
 
+type PaymentEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'payment_created', 'payment_updated', or 'payment_removed'.
+  """
+  pghLabel: String!
+  pghContextId: NauticalUUID
+
+  """JSON context captured at event time."""
+  pghContext: JSONString
+
+  """Payment gateway at time of event."""
+  gateway: String!
+
+  """Charge status at time of event."""
+  chargeStatus: String!
+
+  """Total payment amount at time of event."""
+  total: Decimal!
+
+  """Captured amount at time of event."""
+  capturedAmount: Decimal!
+
+  """Currency code at time of event."""
+  currency: String!
+
+  """Whether payment was active at time of event."""
+  isActive: Boolean!
+
+  """Payment token at time of event."""
+  token: String!
+
+  """Email of user who made the change."""
+  changedByEmail: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """App name if change was via API token."""
+  appName: String
+
+  """Celery task name if change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type PaymentEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [PaymentEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type PaymentEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: PaymentEvent!
+}
+
 """
 Available payment gateway backend with configuration necessary to setup client.
 """
@@ -16005,6 +16577,26 @@ type Query {
     last: Int = null
   ): AgreementEventCountableConnection!
 
+  """
+  Unified timeline of ALL change events for an agreement and its related models (commissions, fees, seller assignments). Requires MANAGE_AGREEMENTS permission.
+  """
+  agreementTimeline(
+    id: ID!
+    includeRelated: Boolean! = true
+
+    """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
+  ): AgreementTimelineEventCountableConnection!
+
   """Return the shop resource."""
   shop: Shop!
 
@@ -16564,6 +17156,80 @@ type Refund implements Node & ObjectWithMetadata {
     """Returns the items in the list that come after the specified cursor."""
     last: Int = null
   ): RefundPaymentCountableConnection!
+
+  """
+  Database-level financial audit trail. Captures every field change via row-level PostgreSQL triggers — status transitions and more.
+  """
+  auditEvents(
+    """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
+  ): RefundAuditEventCountableConnection!
+}
+
+type RefundAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'refund_requested', 'refund_updated', or 'refund_removed'.
+  """
+  pghLabel: String!
+  pghContextId: NauticalUUID
+
+  """JSON context captured at event time."""
+  pghContext: JSONString
+
+  """Refund name at time of event."""
+  name: String!
+
+  """Refund status at time of event."""
+  status: String!
+
+  """Refund token."""
+  token: String!
+
+  """Email of user who made the change."""
+  changedByEmail: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """App name if change was via API token."""
+  appName: String
+
+  """Celery task name if change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type RefundAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [RefundAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type RefundAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: RefundAuditEvent!
 }
 
 """Result of bulk refund delete mutation."""
@@ -17542,6 +18208,23 @@ type Seller implements Node & ObjectWithMetadata {
     last: Int = null
   ): SellerEventTypeCountableConnection!
 
+  """
+  Database-level audit trail for this seller. Captures every field change via PostgreSQL triggers, including status transitions, payout config changes, and profile updates.
+  """
+  auditEvents(
+    """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
+  ): SellerAuditEventCountableConnection!
+
   """Orders for this seller"""
   orders(
     """Returns the items in the list that come before the specified cursor."""
@@ -17836,6 +18519,93 @@ input SellerApplicationUpdateInput {
   checkpoint: SellerApplicationCheckpoint = null
 }
 
+type SellerAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'seller_registered', 'seller_updated', or 'seller_deleted'.
+  """
+  pghLabel: String!
+  pghContextId: NauticalUUID
+
+  """JSON context captured at event time (user, app, tenant info)."""
+  pghContext: JSONString
+
+  """Company name at time of event."""
+  companyName: String!
+
+  """Seller slug at time of event."""
+  slug: String!
+
+  """Seller status at time of event."""
+  status: String!
+
+  """Whether this is the marketplace's own seller entity."""
+  isMarketplaceSeller: Boolean!
+
+  """Default currency at time of event."""
+  defaultCurrency: String!
+
+  """Whether orders are fulfilled by marketplace at time of event."""
+  fulfilledByMarketplace: Boolean!
+
+  """Store description at time of event."""
+  storeDescription: String!
+
+  """Agreement decision reason at time of event."""
+  agreementDecisionReason: String!
+
+  """External payout source (stripe/paypal/trolley) at time of event."""
+  externalPayoutSource: String
+
+  """External payout account ID at time of event."""
+  externalPayoutAccountId: String
+
+  """Email of user who made the change."""
+  userEmail: String
+
+  """Global ID of user who made the change."""
+  userId: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """Tenant slug where the change occurred."""
+  tenantSlug: String
+
+  """App name if change was via API token."""
+  appName: String
+
+  """Global ID of app if change was via API token."""
+  appId: String
+
+  """Celery task name if change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type SellerAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [SellerAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type SellerAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: SellerAuditEvent!
+}
+
 """Result of seller banner delete mutation."""
 type SellerBannerDelete {
   """The seller with banner removed."""
@@ -20550,6 +21320,23 @@ type VendorPayout implements Node & ObjectWithMetadata {
   """Events/history for this vendor payout."""
   events(eventTypes: [VendorPayoutEventsEnum!] = null): [VendorPayoutEvent!]!
 
+  """
+  Database-level financial audit trail for this payout. Captures every field change via PostgreSQL row-level triggers, including amount adjustments, status transitions, and fee recalculations.
+  """
+  auditEvents(
+    """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
+  ): VendorPayoutAuditEventCountableConnection!
+
   """Orders included in this vendor payout."""
   orders(
     """Returns the items in the list that come before the specified cursor."""
@@ -20572,6 +21359,109 @@ input VendorPayoutAddNoteInput {
   message: String!
 }
 
+type VendorPayoutAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """Event label: 'payout_created', 'payout_updated', or 'payout_removed'."""
+  pghLabel: String!
+  pghContextId: NauticalUUID
+
+  """JSON context captured at event time (user, app, tenant info)."""
+  pghContext: JSONString
+
+  """Currency code at time of event."""
+  currency: String!
+
+  """Payout status at time of event."""
+  status: String!
+
+  """Status message at time of event."""
+  statusMessage: String
+
+  """Whether payout was included in batch."""
+  included: Boolean!
+
+  """Payment gateway at time of event."""
+  gateway: String!
+
+  """Net amount at time of event."""
+  net: Decimal!
+
+  """Shipping amount at time of event."""
+  shipping: Decimal!
+
+  """Commission amount at time of event."""
+  commission: Decimal!
+
+  """Fee amount at time of event."""
+  feeAmount: Decimal!
+
+  """Payout amount (payable) at time of event."""
+  payoutAmount: Decimal!
+
+  """Adjustment amount at time of event."""
+  adjustmentAmount: Decimal!
+
+  """Refund amount at time of event."""
+  refundAmount: Decimal!
+
+  """Discounts at time of event."""
+  discounts: Decimal!
+
+  """Volume discounts at time of event."""
+  volumeDiscounts: Decimal!
+
+  """Average order value at time of event."""
+  average: Decimal!
+
+  """Version of seller payable ledger used to initialize this payout."""
+  ledgerVersion: Int!
+
+  """Email of user who made the change."""
+  userEmail: String
+
+  """Global ID of user who made the change."""
+  userId: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """Tenant slug where the change occurred."""
+  tenantSlug: String
+
+  """App name if change was via API token."""
+  appName: String
+
+  """Global ID of app if change was via API token."""
+  appId: String
+
+  """Celery task name if change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type VendorPayoutAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [VendorPayoutAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type VendorPayoutAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: VendorPayoutAuditEvent!
+}
+
 """A connection to a list of items."""
 type VendorPayoutCountableConnection {
   """Pagination data for this connection"""

package/package.json

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