@nautical-commerce/graphql-schema 3.23.0 → 4.0.1

package/nautical/schema.graphql

@@ -2760,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"""
@@ -2772,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."""
@@ -4195,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"""
@@ -4757,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."""
@@ -7251,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."""
@@ -7275,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
@@ -7314,6 +7374,45 @@ input ImportProductsInput {
   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."""
@@ -7993,6 +8092,21 @@ type MCPConfigurationUpdate {
   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."""
@@ -10294,11 +10408,21 @@ 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!
 
@@ -17990,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
@@ -19234,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!
 
@@ -19285,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!]!
 
@@ -19889,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!]
@@ -21278,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"""

package/package.json

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