@nautical-commerce/graphql-schema 2.22.0 → 2.24.0

package/nautical/schema.graphql

@@ -1700,6 +1700,34 @@ type Query {
     contexts: [AppDashboardIntegrationContextEnum!]
   ): [AppDashboardIntegration!]!
 
+  """
+  Get order metrics including time series data for bar charts and status breakdown for pie charts. Automatically filtered by seller for seller staff users.
+  """
+  orderMetrics(
+    """Date range for the metrics query"""
+    dateRange: AnalyticsDateRangeInput!
+
+    """How to group the time series data"""
+    groupBy: DateGroupingEnum!
+
+    """Optional seller ID to filter by (MPO only)"""
+    sellerId: ID
+  ): OrderMetrics
+
+  """
+  Get sales metrics including time series data for bar charts and breakdown by seller (MPO only) and category. Automatically filtered by seller for seller staff users.
+  """
+  salesMetrics(
+    """Date range for the metrics query"""
+    dateRange: AnalyticsDateRangeInput!
+
+    """How to group the time series data"""
+    groupBy: DateGroupingEnum!
+
+    """Optional seller ID to filter by (MPO only)"""
+    sellerId: ID
+  ): SalesMetrics
+
   """Look up a marketplace agreement by ID or slug."""
   agreement(
     """ID of the marketplace agreement."""
@@ -12243,6 +12271,81 @@ enum AppSortField {
   CREATION_DATE
 }
 
+"""Order metrics including time series and status breakdown"""
+type OrderMetrics {
+  """Order counts over time, grouped by the specified granularity"""
+  timeSeries: [TimeSeriesDataPoint!]!
+
+  """Total number of orders in the date range"""
+  total: Int!
+
+  """Orders broken down by status for pie chart"""
+  statusBreakdown: [PieChartSegment!]!
+}
+
+"""Represents a single point in time-series data for charts"""
+type TimeSeriesDataPoint {
+  """The date/time for this data point"""
+  date: DateTime!
+
+  """The numeric value (count or sum)"""
+  value: Decimal!
+
+  """Human-readable label for this period (e.g., 'Jan 2025')"""
+  label: String
+}
+
+"""Represents a segment in pie chart data"""
+type PieChartSegment {
+  """Label for this segment"""
+  label: String!
+
+  """Numeric value for this segment"""
+  value: Decimal!
+
+  """Percentage of total (0-100)"""
+  percentage: Decimal!
+
+  """Optional color code for rendering"""
+  color: String
+}
+
+"""Input type for specifying date range in analytics queries."""
+input AnalyticsDateRangeInput {
+  """Start of date range (inclusive)"""
+  start: DateTime!
+
+  """End of date range (inclusive)"""
+  end: DateTime!
+}
+
+"""Enum for date grouping granularity in time-series charts."""
+enum DateGroupingEnum {
+  DAILY
+  WEEKLY
+  MONTHLY
+  QUARTERLY
+  YEARLY
+}
+
+"""Sales metrics including time series and category breakdown"""
+type SalesMetrics {
+  """Net sales over time, grouped by the specified granularity"""
+  timeSeries: [TimeSeriesDataPoint!]!
+
+  """Total net sales amount in the date range"""
+  total: Decimal!
+
+  """Currency code for the sales figures"""
+  currency: String!
+
+  """Sales broken down by seller (MPO only)"""
+  bySeller: [PieChartSegment!]
+
+  """Sales broken down by product category"""
+  byCategory: [PieChartSegment!]!
+}
+
 type AgreementCountableConnection {
   """Pagination data for this connection."""
   pageInfo: PageInfo!
@@ -12528,7 +12631,7 @@ type Mutation {
     description: String
 
     """
-    Used when uploading a new document or file in a multipart request that does not exist in the system already. Supported file types: application/vnd.openxmlformats-officedocument.presentationml.slideshow, application/gzipped, image/svg, application/csv, application/excel, application/tif, text/x-csv, application/dwg, image/tiff, text/comma-separated-values, application/vnd.openxmlformats-officedocument.wordprocessingml.document, image/heic, text/rtf, image/jpeg, application/x-eps, image/heic-sequence, application/acad, application/postscript, text/pdf, application/dxf, application/zip, image/png, application/msword, application/x-tar, application/vnd.oasis.opendocument.text, application/svg+xml, text/plain, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, image/vnd.dwg, application/eps, application/vnd.ms-excel, image/eps, image/heif-sequence, application/vnd.ms-powerpoint, image/bmp, image/x-dwg, application/x-rtf, application/rtf, application/vnd.oasis.opendocument.spreadsheet, application/x-rar-compressed, image/x-eps, application/x-rar, application/x-autocad, application/x-csv, application/x-acad, application/vnd.openxmlformats-officedocument.presentationml.presentation, image/dxf, image/x-bmp, application/vnd.oasis.opendocument.presentation, image/gif, image/x-tiff, application/pdf, application/x-gzip, image/webp, application/vnd.ms-word, text/svg-xml, application/x-dwg, text/x-comma-separated-values, application/acrobat, application/x-tif, application/x-pdf, image/svg+xml, application/x-zip-compressed, application/gzip-compressed, image/heif, text/x-pdf, application/x-jpg, application/tiff, image/x-ms-bmp, application/vnd.pdf, image/jpg, drawing/x-dwf, image/tif, application/gzip, image/x-tif, application/x-tiff, text/svg, image/x-dxf, text/csv, drawing/dwg, pplication/vnd.rar, application/x-dxf, drawing/x-dwg, application/jpg.
+    Used when uploading a new document or file in a multipart request that does not exist in the system already. Supported file types: drawing/x-dwf, text/csv, application/vnd.pdf, application/gzipped, image/heic-sequence, image/x-eps, image/png, image/x-tif, drawing/x-dwg, application/x-csv, pplication/vnd.rar, application/acad, application/csv, image/x-ms-bmp, image/dxf, application/x-eps, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/x-tar, application/dxf, application/rtf, application/vnd.oasis.opendocument.presentation, drawing/dwg, application/x-zip-compressed, application/vnd.openxmlformats-officedocument.presentationml.slideshow, image/heic, image/svg+xml, text/x-csv, text/svg-xml, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, text/plain, image/tif, image/x-bmp, application/excel, application/pdf, application/gzip, application/gzip-compressed, image/eps, image/heif, text/x-pdf, application/x-dwg, image/x-dwg, image/jpg, application/x-gzip, application/x-pdf, application/vnd.ms-powerpoint, application/svg+xml, image/svg, image/gif, image/tiff, image/bmp, application/vnd.openxmlformats-officedocument.presentationml.presentation, image/x-tiff, application/eps, text/svg, application/x-dxf, application/tiff, application/x-acad, text/x-comma-separated-values, application/msword, application/x-autocad, application/dwg, image/webp, application/zip, text/comma-separated-values, application/x-tif, text/pdf, application/x-rar-compressed, application/acrobat, application/vnd.ms-excel, application/x-jpg, application/x-rtf, image/x-dxf, application/x-rar, application/x-tiff, image/heif-sequence, application/vnd.oasis.opendocument.spreadsheet, application/tif, image/vnd.dwg, image/jpeg, application/postscript, application/vnd.ms-word, application/jpg, application/vnd.oasis.opendocument.text, text/rtf.
     """
     file: Upload!
 

package/package.json

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