@nautical-commerce/graphql-schema 2.29.0 → 2.31.0

package/nautical/schema.graphql

@@ -53,11 +53,15 @@ directive @listSize(assumedSize: Int, slicingArguments: [String!], sizedFields:
 directive @cost(weight: Int!) on ARGUMENT_DEFINITION | FIELD_DEFINITION | INPUT_FIELD_DEFINITION | OBJECT | SCALAR | ENUM
 
 """
-Custom Decimal implementation.
+Custom Decimal scalar implementation.
 
 Returns Decimal as a float in the API,
 parses float to the Decimal on the way back
 ("float -> string -> Decimal" so as not to lose precision).
+
+Note: Extends graphene.Scalar (not graphene.Float) so that the schema
+export includes "scalar Decimal" definition. This is required for
+schema validation tools like graphql-inspector.
 """
 scalar Decimal
 
@@ -1497,7 +1501,7 @@ type Query {
   designerdata(name: String): DesignerDataType
   designerdatalist: [DesignerDataType!]!
 
-  """Token nexessary for connecting to the embedded integration platform"""
+  """Token necessary for connecting to the embedded integration platform"""
   integrationEmbeddingToken: String
 
   """Look up a export file by ID."""
@@ -8320,6 +8324,11 @@ type App implements Node & ObjectWithMetadata {
   """User associated with this app."""
   user: User
 
+  """
+  Seller this app operates as. If null, this is a marketplace-level app (MPO).
+  """
+  seller: Seller
+
   """Last 4 characters of the tokens."""
   tokens: [AppToken!]
 
@@ -12719,7 +12728,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: image/heif, application/vnd.pdf, image/heif-sequence, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/acad, application/svg+xml, application/vnd.ms-excel, application/x-eps, application/x-tif, application/x-pdf, image/eps, text/rtf, image/heic, image/vnd.dwg, application/vnd.openxmlformats-officedocument.presentationml.slideshow, application/x-acad, application/tiff, application/x-rar, application/rtf, application/vnd.oasis.opendocument.text, image/tif, application/excel, application/x-gzip, application/x-rar-compressed, application/x-zip-compressed, application/vnd.oasis.opendocument.presentation, image/x-dxf, application/zip, drawing/x-dwf, drawing/dwg, image/svg, image/x-tiff, application/x-tiff, image/tiff, text/svg, application/eps, image/x-ms-bmp, application/vnd.openxmlformats-officedocument.presentationml.presentation, image/x-tif, application/dwg, application/jpg, image/gif, text/x-csv, application/vnd.oasis.opendocument.spreadsheet, image/dxf, text/csv, image/x-bmp, image/jpg, text/comma-separated-values, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/csv, application/x-tar, image/x-eps, image/jpeg, application/dxf, application/gzip-compressed, application/x-csv, application/vnd.ms-word, image/webp, application/x-dxf, application/gzipped, application/pdf, application/vnd.ms-powerpoint, image/x-dwg, application/tif, image/png, image/svg+xml, application/postscript, text/pdf, application/msword, text/plain, text/svg-xml, application/x-autocad, application/acrobat, application/x-rtf, application/x-dwg, application/x-jpg, drawing/x-dwg, pplication/vnd.rar, image/heic-sequence, image/bmp, application/gzip, text/x-pdf, text/x-comma-separated-values.
+    Used when uploading a new document or file in a multipart request that does not exist in the system already. Supported file types: application/pdf, image/heic-sequence, image/x-eps, image/x-ms-bmp, drawing/x-dwg, application/vnd.ms-word, image/heif, application/x-tif, application/x-eps, application/vnd.pdf, image/eps, image/x-bmp, application/dwg, text/x-pdf, text/svg, application/gzip, application/jpg, image/dxf, application/csv, application/x-jpg, image/heif-sequence, image/x-tif, application/x-dwg, application/tif, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/x-tar, application/vnd.openxmlformats-officedocument.presentationml.presentation, application/dxf, application/postscript, application/vnd.ms-powerpoint, application/x-rtf, application/x-acad, text/comma-separated-values, image/heic, application/vnd.ms-excel, application/vnd.oasis.opendocument.spreadsheet, image/bmp, application/x-rar-compressed, application/gzipped, pplication/vnd.rar, application/x-gzip, application/vnd.openxmlformats-officedocument.presentationml.slideshow, text/csv, image/tiff, image/webp, text/x-comma-separated-values, image/jpg, image/x-dxf, image/vnd.dwg, image/png, application/svg+xml, image/svg, text/x-csv, application/acad, image/gif, application/msword, image/svg+xml, drawing/dwg, text/rtf, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/rtf, image/jpeg, application/zip, image/x-tiff, application/x-pdf, text/pdf, application/eps, application/tiff, text/plain, image/x-dwg, application/x-dxf, application/x-tiff, application/vnd.oasis.opendocument.text, text/svg-xml, application/x-autocad, image/tif, drawing/x-dwf, application/acrobat, application/vnd.oasis.opendocument.presentation, application/x-zip-compressed, application/excel, application/x-csv, application/x-rar, application/gzip-compressed.
     """
     file: Upload!
 
@@ -14973,9 +14982,6 @@ type Mutation {
     input: CatalogueInput!
   ): VoucherRemoveCatalogues
 
-  """Gets and sets Explo dashboard embedding token in cookies"""
-  dashboardEmbeddingToken: DashboardEmbeddingToken
-
   """Export products to csv file."""
   productsExport(
     """Fields required to export product data"""
@@ -15440,6 +15446,22 @@ type Mutation {
     oauthProviderToken: String!
   ): CreateCustomerToken
 
+  """
+  Generate analytics CSV export and return a signed download URL. The URL provides direct access to the file in cloud storage.
+  """
+  analyticsExportCsv(
+    """Export configuration"""
+    input: AnalyticsExportCSVInput!
+  ): AnalyticsExportCSV
+
+  """
+  Get a download URL for analytics CSV export. The URL triggers a synchronous download - navigate to it to download the file.
+  """
+  analyticsExportUrl(
+    """Export configuration"""
+    input: AnalyticsExportUrlInput!
+  ): AnalyticsExportUrl @deprecated(reason: "Use analyticsExportCsv instead for proper tenant handling")
+
   """Create JWT token."""
   tokenCreate(
     """Email of a user."""
@@ -15508,7 +15530,7 @@ type Mutation {
   ): AccountConfirm
 
   """
-  Sets the user's password from the token sent by email using the RequestPasswordReset mutation.
+  Sets the user's password from the token sent by email using the PasswordRequestReset mutation.
   """
   passwordSet(
     """Email of a user."""
@@ -15814,6 +15836,7 @@ type TenantError {
 
 """An enumeration."""
 enum TenantErrorCode {
+  FORBIDDEN
   NOT_FOUND
   REQUIRED
   GRAPHQL_ERROR
@@ -16413,6 +16436,7 @@ enum AgreementErrorCode {
   GRAPHQL_ERROR
   INVALID
   NOT_FOUND
+  PERMISSION_DENIED
   REQUIRED
   UNIQUE
   EXISTING_VENDOR_AGREEMENTS
@@ -16616,6 +16640,7 @@ enum SellerErrorCode {
   INVALID
   INVALID_PHONE
   NOT_FOUND
+  PERMISSION_DENIED
   REQUIRED
   UNIQUE
   JWT_SIGNATURE_EXPIRED
@@ -17063,6 +17088,7 @@ type WarehouseError {
 """An enumeration."""
 enum WarehouseErrorCode {
   ALREADY_EXISTS
+  FORBIDDEN
   GRAPHQL_ERROR
   INVALID
   NOT_FOUND
@@ -17202,6 +17228,7 @@ enum ShopErrorCode {
   GRAPHQL_ERROR
   INVALID
   NOT_FOUND
+  PERMISSION_DENIED
   REQUIRED
   UNIQUE
   NOT_ALLOWED
@@ -17514,6 +17541,7 @@ enum ShippingErrorCode {
   INVALID
   MAX_LESS_THAN_MIN
   NOT_FOUND
+  PERMISSION_DENIED
   REQUIRED
   UNIQUE
   DUPLICATED_INPUT_ITEM
@@ -17938,6 +17966,7 @@ type ProductError {
 enum ProductErrorCode {
   ALREADY_EXISTS
   ATTRIBUTE_ALREADY_ASSIGNED
+  PERMISSION_DENIED
   ATTRIBUTE_CANNOT_BE_ASSIGNED
   ATTRIBUTE_VARIANTS_DISABLED
   ATTRIBUTE_VALUE_CANNOT_BE_CREATED
@@ -20728,6 +20757,7 @@ enum MetadataErrorCode {
   GRAPHQL_ERROR
   INVALID
   NOT_FOUND
+  PERMISSION_DENIED
   REQUIRED
 }
 
@@ -21064,6 +21094,7 @@ type PluginError {
 
 """An enumeration."""
 enum PluginErrorCode {
+  FORBIDDEN
   GRAPHQL_ERROR
   INVALID
   PLUGIN_MISCONFIGURED
@@ -21382,12 +21413,6 @@ type VoucherRemoveCatalogues {
   discountErrors: [DiscountError!]!
 }
 
-"""Gets and sets Explo dashboard embedding token in cookies"""
-type DashboardEmbeddingToken {
-  """JWT token for embedding"""
-  token: String
-}
-
 """Export products to csv file."""
 type ProductsExport {
   """
@@ -21412,6 +21437,7 @@ type ExportError {
 
 """An enumeration."""
 enum ExportErrorCode {
+  FORBIDDEN
   INVALID
   NOT_FOUND
   REQUIRED
@@ -22346,6 +22372,86 @@ enum OauthProviderSourceEnum {
   WORKOS
 }
 
+"""
+Generate analytics CSV export and return a signed download URL. The URL provides direct access to the file in cloud storage.
+"""
+type AnalyticsExportCSV {
+  """Signed URL for downloading the CSV file. Expires in 1 hour."""
+  downloadUrl: String
+
+  """Filename of the export (e.g., 'analytics_orders_20240101.csv')"""
+  filename: String
+
+  """Number of data rows in the export (excluding header)"""
+  rowCount: Int
+
+  """Errors that occurred during the mutation"""
+  errors: [AnalyticsExportError!]!
+}
+
+"""Error type for analytics export mutations."""
+type AnalyticsExportError {
+  """Name of a field that caused the error"""
+  field: String
+
+  """Error message"""
+  message: String
+
+  """The error code"""
+  code: AnalyticsExportErrorCode!
+}
+
+"""Error codes for analytics export mutations."""
+enum AnalyticsExportErrorCode {
+  INVALID_DATE_RANGE
+  PERMISSION_DENIED
+  EXPORT_TYPE_NOT_AVAILABLE
+  INVALID
+}
+
+"""Input for requesting an analytics CSV export."""
+input AnalyticsExportCSVInput {
+  """Type of analytics data to export"""
+  exportType: AnalyticsExportTypeEnum!
+
+  """Date range for the export"""
+  dateRange: AnalyticsDateRangeInput!
+}
+
+"""Types of analytics data that can be exported."""
+enum AnalyticsExportTypeEnum {
+  MARKETPLACE_ORDERS
+  SELLER_ORDERS
+  ORDER_LINE_ITEMS
+  CUSTOMERS
+  PRODUCT_INVENTORY
+  PAYOUTS
+  SELLER_PAYOUTS
+  SALES_VELOCITY
+}
+
+"""
+Get a download URL for analytics CSV export. The URL triggers a synchronous download - navigate to it to download the file.
+"""
+type AnalyticsExportUrl {
+  """
+  Download URL for the CSV export. Navigate to this URL to trigger download.
+  """
+  url: String
+
+  """Errors that occurred during the mutation"""
+  errors: [AnalyticsExportError!]!
+}
+
+"""Input for requesting an analytics export URL."""
+input AnalyticsExportUrlInput {
+  """Type of analytics data to export"""
+  exportType: AnalyticsExportTypeEnum!
+
+  """Date range for the export"""
+  dateRange: AnalyticsDateRangeInput!
+}
+
 """Create JWT token."""
 type TokenCreate {
   """JWT token, required to authenticate."""
@@ -22402,6 +22508,7 @@ enum AccountErrorCode {
   OUT_OF_SCOPE_GROUP
   OUT_OF_SCOPE_PERMISSION
   OUT_OF_SCOPE_SELLER
+  PERMISSION_DENIED
   PASSWORD_ENTIRELY_NUMERIC
   PASSWORD_IDENTICAL
   PASSWORD_TOO_COMMON
@@ -22487,7 +22594,7 @@ type AccountConfirm {
 }
 
 """
-Sets the user's password from the token sent by email using the RequestPasswordReset mutation.
+Sets the user's password from the token sent by email using the PasswordRequestReset mutation.
 """
 type PasswordSet {
   """JWT token, required to authenticate."""

package/package.json

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