@nautical-commerce/graphql-schema 3.22.0 → 4.0.0

package/nautical/schema.graphql

@@ -1483,6 +1483,23 @@ type Attribute implements Node & ObjectWithMetadata {
   """Position in storefront search"""
   storefrontSearchPosition: Int!
 
+  """
+  Database-level audit trail for this attribute (requires MANAGE_PRODUCTS).
+  """
+  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
+  ): AttributeAuditEventCountableConnection!
+
   """Filterable in dashboard"""
   filterableInDashboard: Boolean!
 
@@ -1556,6 +1573,64 @@ input AttributeAssignInput {
   type: AttributeTypeEnum!
 }
 
+type AttributeAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'attribute_created', 'attribute_updated', or 'attribute_deleted'.
+  """
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+  name: String!
+  slug: String!
+  inputType: String!
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the 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 the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type AttributeAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [AttributeAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type AttributeAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: AttributeAuditEvent!
+}
+
 """Result of attribute bulk delete mutation."""
 type AttributeBulkDelete {
   """Number of attributes deleted."""
@@ -2685,6 +2760,19 @@ input BundleUpdateInput {
   components: [BundleItemInput!] = null
 }
 
+"""Parsed CSV structure plus mapping suggestions."""
+type CSVImportMetadata {
+  headers: [String!]!
+  rowCount: Int!
+
+  """First values per column"""
+  examples: JSONString!
+
+  """Value-shape profiles per column"""
+  profiles: JSONString!
+  suggestions: [MappingSuggestionType!]!
+}
+
 """CSV file metadata extracted during parsing."""
 type CSVMetadata {
   """Column headers from the CSV"""
@@ -2697,6 +2785,14 @@ type CSVMetadata {
   examples: JSONString!
 }
 
+"""Generated CSV import template (live from marketplace config)."""
+type CSVTemplateType {
+  filename: String!
+
+  """CSV content — trigger a client-side download"""
+  content: String!
+}
+
 """Result of catalogExport mutation."""
 type CatalogExport {
   """Whether the export was successful."""
@@ -2751,6 +2847,23 @@ type Category implements Node & ObjectWithMetadata {
   allowProductAssignment: Boolean!
   level: Int!
 
+  """
+  Database-level audit trail for this category (requires MANAGE_PRODUCTS).
+  """
+  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
+  ): CategoryAuditEventCountableConnection!
+
   """Background image for the category"""
   backgroundImage(size: Int = null): Image
 
@@ -2814,6 +2927,63 @@ type Category implements Node & ObjectWithMetadata {
   ): ProductCountableConnection!
 }
 
+type CategoryAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'category_created', 'category_updated', or 'category_deleted'.
+  """
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+  name: String!
+  slug: String!
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the 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 the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type CategoryAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [CategoryAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type CategoryAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: CategoryAuditEvent!
+}
+
 """Result of category bulk delete mutation."""
 type CategoryBulkDelete {
   """Number of categories deleted."""
@@ -3630,6 +3800,23 @@ type Collection implements Node & ObjectWithMetadata {
   """Whether the collection is visible"""
   isVisible: Boolean!
 
+  """
+  Database-level audit trail for this collection (requires MANAGE_PRODUCTS).
+  """
+  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
+  ): CollectionAuditEventCountableConnection!
+
   """Whether the collection is published"""
   isPublished: Boolean!
 
@@ -3706,6 +3893,62 @@ type CollectionAddVariants {
   productErrors: [ProductError!]!
 }
 
+type CollectionAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """Event label: 'collection_created', '..._updated', or '..._deleted'."""
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+  name: String!
+  slug: String!
+  isVisible: Boolean!
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the 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 the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type CollectionAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [CollectionAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type CollectionAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: CollectionAuditEvent!
+}
+
 """Result of collection bulk delete mutation."""
 type CollectionBulkDelete {
   """Number of collections deleted."""
@@ -3973,6 +4216,13 @@ enum ConfigurationTypeFieldEnum {
   OUTPUT_SECRET
 }
 
+"""Result of confirm import mapping mutation."""
+type ConfirmImportMapping {
+  importFile: ImportFile
+  taskId: String
+  importErrors: [ImportError!]!
+}
+
 """Content page or block."""
 type Content implements Node {
   """The Globally Unique ID of this object"""
@@ -4535,6 +4785,33 @@ type CreditCard {
   expYear: Int
 }
 
+"""import row | status"""
+enum CsvImportRowStatusEnum {
+  """Staged, not yet mapped."""
+  pending
+
+  """Mapped to the canonical intermediate."""
+  mapped
+
+  """Validated; loads cleanly."""
+  valid
+
+  """Loads with gaps (product lands as INCOMPLETE_DATA)."""
+  partial
+
+  """Cannot load; quarantined with row errors."""
+  invalid
+
+  """Entities created/updated."""
+  loaded
+
+  """Load attempted and failed."""
+  failed
+
+  """Deliberately excluded from the load."""
+  skipped
+}
+
 """Result of custom attribute assign mutation."""
 type CustomAttributeAssign {
   """The template with assigned custom attributes."""
@@ -5184,6 +5461,23 @@ type DigitalContent implements Node & ObjectWithMetadata {
   """Number of days the download URL is valid"""
   urlValidDays: Int
 
+  """
+  Database-level audit trail for this digital content (requires MANAGE_PRODUCTS).
+  """
+  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
+  ): DigitalContentAuditEventCountableConnection!
+
   """The product variant associated with this digital content."""
   productVariant: ProductVariant!
 
@@ -5193,8 +5487,63 @@ type DigitalContent implements Node & ObjectWithMetadata {
   """The URL of the digital content file."""
   contentFile: String
 
-  """List of URLs for downloading this digital content."""
-  urls: [DigitalContentUrl!]!
+  """List of URLs for downloading this digital content."""
+  urls: [DigitalContentUrl!]!
+}
+
+type DigitalContentAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'digital_content_created', '..._updated', or '..._deleted'.
+  """
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the 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 the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type DigitalContentAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [DigitalContentAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type DigitalContentAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: DigitalContentAuditEvent!
 }
 
 """A connection to a list of items."""
@@ -5288,6 +5637,23 @@ type DigitalContentUrl implements Node {
   """When the URL was created"""
   created: DateTime!
 
+  """
+  Database-level audit trail for this download URL. Tracks creation and deletion only (download-counter bumps are not audited). Requires MANAGE_PRODUCTS.
+  """
+  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
+  ): DigitalContentUrlAuditEventCountableConnection!
+
   """Number of times this URL has been used for downloads."""
   downloadNum: Int!
 
@@ -5298,6 +5664,62 @@ type DigitalContentUrl implements Node {
   content: DigitalContent
 }
 
+type DigitalContentUrlAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'digital_content_url_created' or 'digital_content_url_deleted'.
+  """
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+  downloadNum: Int!
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the 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 the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type DigitalContentUrlAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [DigitalContentUrlAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type DigitalContentUrlAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: DigitalContentUrlAuditEvent!
+}
+
 """Result of digital content URL create mutation."""
 type DigitalContentUrlCreate {
   """The created digital content URL."""
@@ -6884,6 +7306,11 @@ type ImportFile implements Node & Job {
 
   """List of import events"""
   events: [ImportEvent!]!
+
+  """
+  Pipeline metadata: parse output (headers, examples, profiles), dry_run summary after validation, load_summary after loading.
+  """
+  metadata: JSONString!
 }
 
 """A connection to a list of items."""
@@ -6908,7 +7335,7 @@ type ImportFileCountableEdge {
 }
 
 """
-ImportFile(id, status, message, created_at, updated_at, tenant, user, app, content_file)
+ImportFile(id, status, message, created_at, updated_at, tenant, user, app, content_file, metadata, import_config, seller)
 """
 input ImportFileFilterInput {
   status: JobStatusEnum
@@ -6943,9 +7370,49 @@ input ImportProductsInput {
   fieldMappings: JSONString!
   defaultProductTypeId: ID = null
   defaultCategoryId: ID = null
+  defaultWarehouseId: ID = null
   batchSize: Int = 100
 }
 
+"""One staged CSV row with validation state."""
+type ImportRow implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  rowNumber: Int!
+  groupKey: String!
+  status: CsvImportRowStatusEnum!
+
+  """Structured row errors [{field, code, message, severity}]"""
+  errors: JSONString!
+
+  """Original header→value dict"""
+  raw: JSONString!
+
+  """Canonical mapped form (v1)"""
+  mapped: JSONString
+}
+
+"""A connection to a list of items."""
+type ImportRowCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [ImportRowCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type ImportRowCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: ImportRow!
+}
+
 """Top performing categories report."""
 type InReportTopPerformingCategoriesType {
   """Category of the metric."""
@@ -7568,6 +8035,78 @@ enum LengthUnitsStrEnum {
   M
 }
 
+"""Per-tenant configuration for the hosted MCP surface."""
+type MCPConfiguration {
+  """The ID of the object."""
+  id: ID!
+
+  """
+  When true, the tenant opts IN to the public shopping-agent surface (OAuth-scoped, read-only buyer view) on mcp.thetraide.com/{tenant_slug}/mcp.
+  """
+  shoppingEnabled: Boolean!
+
+  """
+  When true, the authenticated operator MCP surface is exposed for this tenant.
+  """
+  operatorEnabled: Boolean!
+
+  """When true, seller identity is included in agent-visible product data."""
+  sellerIdentityExposed: Boolean!
+
+  """
+  Per-agent request budget per minute. Overrides the mcp-server ADR-0009 default.
+  """
+  rateLimitPerAgent: Int!
+
+  """
+  Optional MCP protocol version pin. Null means the server default is used.
+  """
+  protocolVersionPin: String
+
+  """
+  Allowlist of pre-registered OAuth client ids (empty = open dynamic registration).
+  """
+  shoppingOauthClients: [String!]!
+
+  """Allowlist of product attribute slugs exposed to shopping agents."""
+  exposedAttributes: [String!]!
+}
+
+"""Input for updating the hosted MCP configuration for a tenant."""
+input MCPConfigurationInput {
+  shoppingEnabled: Boolean
+  shoppingOauthClients: [String!]
+  operatorEnabled: Boolean
+  exposedAttributes: [String!]
+  sellerIdentityExposed: Boolean
+  rateLimitPerAgent: Int
+  protocolVersionPin: String
+}
+
+"""Result of mcpConfigurationUpdate mutation."""
+type MCPConfigurationUpdate {
+  """The updated MCP configuration."""
+  mcpConfiguration: MCPConfiguration
+
+  """List of errors that occurred executing the mutation."""
+  mcpConfigurationErrors: [TenantError!]!
+}
+
+"""One suggested header→field mapping with confidence."""
+type MappingSuggestionType {
+  """CSV column header"""
+  header: String!
+
+  """Canonical target field, 'attribute:<id>', or 'attribute:auto:<name>'"""
+  target: String!
+
+  """0.0–1.0"""
+  confidence: Float!
+
+  """Why the engine suggests this"""
+  rationale: String!
+}
+
 """Product or variant margin range"""
 type Margin {
   """Minimum margin percentage."""
@@ -9869,17 +10408,32 @@ type Mutation {
   productsExport(input: ExportProductsInput!): ProductsExport!
 
   """Upload CSV file for product import and parse its structure."""
-  createImportFile(file: Upload!): CreateImportFile!
+  createImportFile(file: Upload!, sellerId: ID = null): CreateImportFile!
 
   """Start processing CSV product import with field mappings."""
   startCsvImport(input: ImportProductsInput!): StartCSVImport!
 
+  """
+  Confirm the header→field mapping for an import and start staging + validation (dry run). Requires MANAGE_PRODUCTS permission.
+  """
+  confirmImportMapping(importFileId: ID!, mappings: JSONString!, attributeStrategy: String! = "explicit_columns", defaultProductTypeId: ID = null, defaultCategoryId: ID = null, warehouseId: ID = null, saveProfileAs: String = null): ConfirmImportMapping!
+
+  """
+  Start loading a staged+validated import into the catalog. Requires a completed dry run. Requires MANAGE_PRODUCTS permission.
+  """
+  startImportLoad(importFileId: ID!): StartImportLoad!
+
   """Update a tenant."""
   tenantUpdate(id: ID!, input: TenantUpdateInput!): TenantUpdate!
 
   """Update tenant onboarding steps."""
   tenantOnboardingUpdate(input: TenantOnboardingUpdateInput!): TenantOnboardingUpdate!
 
+  """
+  Update the hosted MCP configuration for the current tenant. Requires MANAGE_MARKETPLACE_CONFIGURATION permission.
+  """
+  mcpConfigurationUpdate(input: MCPConfigurationInput!): MCPConfigurationUpdate!
+
   """Upload and attach a document to an entity."""
   documentAdd(file: Upload!, relatedObjectId: ID!, description: String = null): DocumentAdd!
 
@@ -10330,6 +10884,11 @@ type NauticalOrder implements Node & ObjectWithMetadata {
     last: Int = null
   ): NauticalOrderAuditEventCountableConnection!
 
+  """
+  Unified change-history feed for this marketplace order. Combines pghistory events from NauticalOrder (status, totals, customer) and NauticalOrderLine (line additions/updates/removals) into a single TimelineEntry list ordered most-recent-first. Powers the dashboard Events page and mirrors the Agreement and seller-Order timeline pattern. Optional `kinds` filters server-side.
+  """
+  timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
+
   """List of seller orders in this marketplace order"""
   subOrders: [Order!]
 
@@ -13833,6 +14392,28 @@ type Product implements Node & ObjectWithMetadata {
   """Date when the product becomes available for purchase"""
   availableForPurchase: Date
 
+  """
+  Database-level audit trail for this product (requires MANAGE_PRODUCTS).
+  """
+  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
+  ): ProductAuditEventCountableConnection!
+
+  """
+  Unified change-history feed for this product. Projects pghistory ProductEvent (the product) + ProductVariantEvent (its variants) rows into a TimelineEntry list ordered most-recent-first. Powers the dashboard Events page and mirrors the Seller and Order timeline pattern. Requires MANAGE_PRODUCTS. Optional `kinds` argument filters server-side.
+  """
+  timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
+
   """Sort order of the product"""
   sortOrder: Int
 
@@ -14001,6 +14582,63 @@ enum ProductAction {
   APPROVED
 }
 
+type ProductAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'product_created', 'product_updated', or 'product_deleted'.
+  """
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+  name: String!
+  status: String!
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the 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 the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type ProductAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [ProductAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type ProductAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: ProductAuditEvent!
+}
+
 """Result of product bulk category update mutation."""
 type ProductBulkCategoryUpdate {
   """Number of products updated."""
@@ -14464,25 +15102,95 @@ input ProductFilterInput {
   DISTINCT: Boolean
 }
 
-"""Represents a product image."""
-type ProductImage implements Node {
-  """The Globally Unique ID of this object"""
-  id: ID!
+"""Represents a product image."""
+type ProductImage implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+
+  """Alt text for the image"""
+  alt: String
+
+  """Sort order of the image"""
+  sortOrder: Int
+
+  """External system identifier"""
+  externalId: String
+
+  """External system source"""
+  externalSource: String
+
+  """
+  Database-level audit trail for this product image (requires MANAGE_PRODUCTS).
+  """
+  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
+  ): ProductImageAuditEventCountableConnection!
+
+  """The URL of the image"""
+  url(size: Int = null): String!
+}
+
+type ProductImageAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """Event label: 'product_image_added', '..._updated', or '..._removed'."""
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the 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 the change was via an API token."""
+  appName: String
 
-  """Alt text for the image"""
-  alt: String
+  """Global ID of the app if via an API token."""
+  appId: String
 
-  """Sort order of the image"""
-  sortOrder: Int
+  """Celery task name if the change was async."""
+  taskName: String
+}
 
-  """External system identifier"""
-  externalId: String
+"""A connection to a list of items."""
+type ProductImageAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
 
-  """External system source"""
-  externalSource: String
+  """Contains the nodes in this connection"""
+  edges: [ProductImageAuditEventCountableEdge!]!
 
-  """The URL of the image"""
-  url(size: Int = null): String!
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type ProductImageAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: ProductImageAuditEvent!
 }
 
 """Result of product image bulk create mutation."""
@@ -14926,6 +15634,23 @@ type ProductType implements Node & ObjectWithMetadata {
   """
   externallyManaged: Boolean!
 
+  """
+  Database-level audit trail for this product type (requires MANAGE_PRODUCTS).
+  """
+  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
+  ): ProductTypeAuditEventCountableConnection!
+
   """Legacy indicator, always true"""
   hasVariants: Boolean!
 
@@ -14986,6 +15711,61 @@ type ProductType implements Node & ObjectWithMetadata {
   ): AttributeCountableConnection!
 }
 
+type ProductTypeAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """Event label: 'product_type_created', '..._updated', or '..._deleted'."""
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+  name: String!
+  slug: String!
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the 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 the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type ProductTypeAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [ProductTypeAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type ProductTypeAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: ProductTypeAuditEvent!
+}
+
 """Result of product type bulk delete mutation."""
 type ProductTypeBulkDelete {
   """Number of product types deleted."""
@@ -15204,6 +15984,28 @@ type ProductVariant implements Node & ObjectWithMetadata {
   """Whether backorders are allowed"""
   allowBackorders: Boolean
 
+  """
+  Database-level audit trail for this variant (requires MANAGE_PRODUCTS).
+  """
+  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
+  ): ProductVariantAuditEventCountableConnection!
+
+  """
+  Unified change-history feed for this variant. Projects pghistory ProductVariantEvent rows (SKU, price, status, inventory changes) into a TimelineEntry list ordered most-recent-first. Powers the dashboard Events page and mirrors the Seller and Order timeline pattern. Requires MANAGE_PRODUCTS. Optional `kinds` argument filters server-side.
+  """
+  timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
+
   """Status of the variant"""
   status: ProductVariantStatus!
 
@@ -15313,6 +16115,62 @@ type ProductVariant implements Node & ObjectWithMetadata {
   ): ShopifyWebhookTransactionCountableConnection!
 }
 
+type ProductVariantAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'variant_created', 'variant_updated', or 'variant_deleted'.
+  """
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+  sku: String
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the 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 the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type ProductVariantAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [ProductVariantAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type ProductVariantAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: ProductVariantAuditEvent!
+}
+
 """Result of product variant bulk create mutation."""
 type ProductVariantBulkCreate {
   """Number of variants created."""
@@ -15835,10 +16693,80 @@ type ProductVideo implements Node {
   """External system source"""
   externalSource: String
 
+  """
+  Database-level audit trail for this product video (requires MANAGE_PRODUCTS).
+  """
+  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
+  ): ProductVideoAuditEventCountableConnection!
+
   """The URL of the video"""
   url: String!
 }
 
+type ProductVideoAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """Event label: 'product_video_added', '..._updated', or '..._removed'."""
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the 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 the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type ProductVideoAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [ProductVideoAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type ProductVideoAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: ProductVideoAuditEvent!
+}
+
 """Result of product video bulk create mutation."""
 type ProductVideoBulkCreate {
   """The product with the new videos."""
@@ -16937,6 +17865,11 @@ type Query {
   """List of available tax types."""
   taxTypes: [TaxType!]!
 
+  """
+  Return the hosted MCP configuration for the current tenant, or null if the tenant has not been configured. A null result means everything is off (fail-closed defaults).
+  """
+  mcpConfiguration: MCPConfiguration
+
   """Look up a plugin by ID. Requires MANAGE_PLUGINS permission."""
   plugin(id: ID!, seller: ID = null): Plugin
 
@@ -17181,6 +18114,36 @@ type Query {
     last: Int = null
   ): ImportFileCountableConnection!
 
+  """
+  Parsed structure plus mapping suggestions for an import file. Requires MANAGE_PRODUCTS permission.
+  """
+  importFileMetadata(id: ID!): CSVImportMetadata
+
+  """
+  Generate a CSV import template from live marketplace configuration (canonical columns + product-template attributes). Requires MANAGE_PRODUCTS.
+  """
+  importCsvTemplate(productTypeIds: [ID!] = null): CSVTemplateType!
+
+  """
+  Staged rows for an import file, filterable by status. Requires MANAGE_PRODUCTS permission.
+  """
+  importRows(
+    importFileId: ID!
+    status: String = null
+
+    """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
+  ): ImportRowCountableConnection!
+
   """List journal entries. Requires MANAGE_PAYOUTS permission."""
   journalEntries(
     filter: JournalEntryFilterInput
@@ -18425,6 +19388,9 @@ type Seller implements Node & ObjectWithMetadata {
   """Store description (HTML)"""
   storeDescription: String!
 
+  """Payout schedule interval (manual, daily, weekly, monthly)"""
+  externalPayoutSchedule: String
+
   """Primary key of the seller"""
   pk: Int!
 
@@ -18476,9 +19442,6 @@ type Seller implements Node & ObjectWithMetadata {
   """Whether payouts are enabled for this seller"""
   externalPayoutStatus: Boolean
 
-  """Payout schedule interval (manual, daily, weekly, monthly)"""
-  externalPayoutSchedule: String
-
   """Seller onboarding checklists"""
   checklists: [SellerOnboardingChecklist!]!
 
@@ -18517,6 +19480,11 @@ type Seller implements Node & ObjectWithMetadata {
     last: Int = null
   ): SellerAuditEventCountableConnection!
 
+  """
+  Unified change-history feed for this seller. Projects pghistory SellerAuditEvent rows (status transitions, profile edits, payout-config changes) into a TimelineEntry list ordered most-recent-first. Powers the dashboard Events tab and mirrors the Agreement and Order timeline pattern. Optional `kinds` argument filters server-side.
+  """
+  timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
+
   """Orders for this seller"""
   orders(
     """Returns the items in the list that come before the specified cursor."""
@@ -19075,7 +20043,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)
+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)
 """
 input SellerFilterInput {
   status: [SellerStatusFilter!]
@@ -20464,6 +21432,13 @@ type StartCSVImport {
   importErrors: [ImportError!]!
 }
 
+"""Result of start import load mutation."""
+type StartImportLoad {
+  importFile: ImportFile
+  taskId: String
+  importErrors: [ImportError!]!
+}
+
 """Represents stock of a product variant at a warehouse."""
 type Stock implements Node {
   """The Globally Unique ID of this object"""
@@ -20850,6 +21825,9 @@ type Tenant implements Node {
 
   """Marketplace configuration for the tenant"""
   marketplaceConfiguration: MarketplaceConfiguration
+
+  """Hosted MCP configuration for the tenant"""
+  mcpConfiguration: MCPConfiguration
 }
 
 """A connection to a list of items."""
@@ -21055,6 +22033,11 @@ enum TimelineEntryKind {
   ORDER
   ORDER_LINE
   FULFILLMENT
+  SELLER
+  NAUTICAL_ORDER
+  NAUTICAL_ORDER_LINE
+  PRODUCT
+  PRODUCT_VARIANT
 }
 
 type TimelineTarget {

package/package.json

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