@nautical-commerce/graphql-schema 4.3.0 → 4.4.0

package/nautical/schema.graphql

@@ -2123,7 +2123,9 @@ input AttributeValueInput {
   """The ID of the attribute."""
   id: ID = null
 
-  """The value or slug of an attribute to resolve."""
+  """
+  The value or slug of an attribute to resolve. Legacy catch-all: DROPDOWN and MULTISELECT use it as their primary field, and DATE still accepts a 'YYYY-MM-DD' string here. Prefer the per-type field where one exists.
+  """
   values: [String!] = null
 
   """File for FILE attribute type."""
@@ -2132,10 +2134,9 @@ input AttributeValueInput {
   """URL of a file attribute type."""
   fileUrl: String = null
 
-  """File content type."""
-  contentType: String = null
-
-  """List of entity IDs for REFERENCE attribute types."""
+  """
+  Not supported yet — supply a single entity ID via `reference` instead. Declared for forward compatibility only; see #6190.
+  """
   references: [ID!] = null
 
   """Rich text value for RICH_TEXT attribute type."""
@@ -2144,7 +2145,9 @@ input AttributeValueInput {
   """Boolean value for BOOLEAN attribute type."""
   boolean: Boolean = null
 
-  """Date value for DATE attribute type (YYYY-MM-DD format)."""
+  """
+  Date value for DATE attribute type (YYYY-MM-DD format). Preferred over passing the same string in `values`, which remains supported for existing callers. Interpreted as midnight in the marketplace timezone.
+  """
   date: String = null
 
   """Datetime value for DATE_TIME attribute type."""
@@ -2162,7 +2165,9 @@ input AttributeValueInput {
   """Reference ID for REFERENCE attribute type."""
   reference: String = null
 
-  """The value or slug of an attribute to resolve."""
+  """
+  Value representation of the attribute value — this is the field SWATCH attributes read, as a hex colour such as '#FF0000' or '#F00'. Not interchangeable with `values`.
+  """
   value: String = null
 }
 
@@ -3167,6 +3172,11 @@ type Checkout implements Node & ObjectWithMetadata {
   """The user who owns this checkout."""
   user: User
 
+  """
+  Unified change-history feed for this checkout. Projects the legacy CheckoutEvent log into a TimelineEntry list ordered most-recent-first, so checkout history renders through the same dashboard component as the order, seller and product timelines. Requires MANAGE_CHECKOUTS. Optional `kinds` argument filters server-side.
+  """
+  timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
+
   """The billing address for this checkout."""
   billingAddress: Address
 
@@ -6600,6 +6610,11 @@ type ExportFile implements Node & Job {
 
   """List of export events"""
   events: [ExportEvent!]!
+
+  """
+  Unified change-history feed for this export job. Projects the legacy ExportEvent log into a TimelineEntry list ordered most-recent-first, so job history renders through the same dashboard component as the order, seller and product timelines. Optional `kinds` argument filters server-side.
+  """
+  timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
 }
 
 """A connection to a list of items."""
@@ -7337,6 +7352,11 @@ type ImportFile implements Node & Job {
   """List of import events"""
   events: [ImportEvent!]!
 
+  """
+  Unified change-history feed for this import job. Projects the legacy ImportEvent log into a TimelineEntry list ordered most-recent-first, mirroring the export-job timeline. Optional `kinds` argument filters server-side.
+  """
+  timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
+
   """
   Pipeline metadata: parse output (headers, examples, profiles), dry_run summary after validation, load_summary after loading.
   """
@@ -7552,6 +7572,11 @@ type Invoice implements Node & ObjectWithMetadata & Job {
 
   """Whether the invoice is editable"""
   isEditable: Boolean!
+
+  """
+  Unified change-history feed for this invoice. Projects the legacy InvoiceEvent log into a TimelineEntry list ordered most-recent-first, so invoice history renders through the same dashboard component as the order, seller and product timelines. Entries name the related order or refund when the event has one. Optional `kinds` argument filters server-side.
+  """
+  timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
 }
 
 """Result of invoice cancel mutation."""
@@ -13714,6 +13739,11 @@ type Payout implements Node & ObjectWithMetadata {
 
   """Total payout amount."""
   payout: Money!
+
+  """
+  Unified change-history feed for this payout batch. Projects the legacy PayoutEvent log into a TimelineEntry list ordered most-recent-first. Note this is the marketplace-level batch: only VendorPayout carries pghistory tracking, so this feed is legacy-only while VendorPayout.timeline merges both sources. Optional `kinds` argument filters server-side.
+  """
+  timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
 }
 
 """Result of bulk payout archive mutation."""
@@ -17055,6 +17085,7 @@ enum ProductWarningEnum {
   PRODUCT_ATTRIBUTE_VALUE_REQUIRED
   VARIANT_ATTRIBUTE_VALUE_REQUIRED
   DEFAULT_VARIANT_REQUIRED
+  SELLER_PAUSED
 }
 
 """Result of products export mutation."""
@@ -18571,6 +18602,11 @@ type Refund implements Node & ObjectWithMetadata {
     """Returns the items in the list that come after the specified cursor."""
     last: Int = null
   ): RefundAuditEventCountableConnection!
+
+  """
+  Unified change-history feed for this refund. Merges pghistory RefundAuditEvent rows (status transitions, amount changes) with the legacy RefundEvent activity log into a TimelineEntry list ordered most-recent-first. The legacy source covers activity from before this tenant's pghistory triggers existed. Powers the dashboard Events tab and mirrors the Order and Payout timeline pattern. Optional `kinds` argument filters server-side.
+  """
+  timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
 }
 
 type RefundAuditEvent implements Node {
@@ -22179,6 +22215,21 @@ enum TimelineEntryKind {
   NAUTICAL_ORDER_LINE
   PRODUCT
   PRODUCT_VARIANT
+  STOCK
+  ORDER_ACTIVITY
+  NAUTICAL_ORDER_ACTIVITY
+  SELLER_ACTIVITY
+  PRODUCT_STATUS_LOG
+  VENDOR_PAYOUT
+  VENDOR_PAYOUT_ACTIVITY
+  REFUND
+  REFUND_ACTIVITY
+  CUSTOMER_ACTIVITY
+  INVOICE_ACTIVITY
+  EXPORT_ACTIVITY
+  IMPORT_ACTIVITY
+  PAYOUT_ACTIVITY
+  CHECKOUT_ACTIVITY
 }
 
 type TimelineTarget {
@@ -22442,6 +22493,11 @@ type User implements Node & ObjectWithMetadata {
   """List of events associated with the user."""
   events: [CustomerEvent!]!
 
+  """
+  Unified change-history feed for this customer. Projects the legacy CustomerEvent log into a TimelineEntry list ordered most-recent-first, so customer history renders through the same dashboard component as the order, seller and product timelines. Note that CustomerEvent records the customer an event concerns, not who performed it, so entries report an unknown actor rather than attributing staff actions to the customer. Optional `kinds` argument filters server-side.
+  """
+  timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
+
   """List of stored payment sources."""
   storedPaymentSources: [PaymentSource!]!
 
@@ -22859,6 +22915,11 @@ type VendorPayout implements Node & ObjectWithMetadata {
     last: Int = null
   ): VendorPayoutAuditEventCountableConnection!
 
+  """
+  Unified change-history feed for this payout. Merges pghistory VendorPayoutAuditEvent rows (amount adjustments, status transitions, fee recalculations) with the legacy VendorPayoutEvent activity log into a TimelineEntry list ordered most-recent-first. The legacy source covers activity from before this tenant's pghistory triggers existed. Powers the dashboard Events tab and mirrors the Order and Seller timeline pattern. Optional `kinds` argument filters server-side.
+  """
+  timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
+
   """Orders included in this vendor payout."""
   orders(
     """Returns the items in the list that come before the specified cursor."""

package/package.json

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