{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/track/json-schema/track-catalog-preview-schema.json",
  "title": "CatalogPreview",
  "description": "Main serializer for catalog preview response.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/track-imports-api-openapi.yml#/components/schemas/CatalogPreview",
  "type": "object",
  "properties": {
    "releases_to_create": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/CatalogPreviewCreate"
      }
    },
    "releases_to_update": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/CatalogPreviewUpdate"
      }
    },
    "recordings_to_create": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/CatalogPreviewCreate"
      }
    },
    "recordings_to_update": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/CatalogPreviewUpdate"
      }
    },
    "likely_recordings": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/CatalogPreviewUpdate"
      }
    },
    "likely_releases": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/CatalogPreviewUpdate"
      }
    },
    "conflicts_recordings": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/CatalogPreviewConflict"
      }
    },
    "conflicts_releases": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/CatalogPreviewConflict"
      }
    },
    "errors": {
      "$ref": "#/$defs/CatalogPreviewErrors"
    },
    "can_import": {
      "type": "boolean",
      "description": "True when batch has no errors or conflicts (can proceed with import)"
    },
    "can_auto_import": {
      "type": "boolean",
      "description": "True when batch has only exact matches and duplicates (no catalog changes needed)"
    },
    "summary": {
      "$ref": "#/$defs/CatalogPreviewSummary"
    }
  },
  "required": [
    "can_auto_import",
    "can_import",
    "conflicts_recordings",
    "conflicts_releases",
    "errors",
    "likely_recordings",
    "likely_releases",
    "recordings_to_create",
    "recordings_to_update",
    "releases_to_create",
    "releases_to_update",
    "summary"
  ],
  "$defs": {
    "CatalogPreviewConflict": {
      "type": "object",
      "description": "Serializer for a conflicted import item.",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "row_index": {
          "type": "integer"
        },
        "match_status": {
          "type": "string"
        },
        "import_values": {
          "type": "object",
          "additionalProperties": {}
        },
        "catalog_values": {},
        "updates": {
          "type": "object",
          "additionalProperties": {}
        },
        "conflicted_fields": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "resolution": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "conflicted_fields",
        "id",
        "import_values",
        "match_status",
        "row_index",
        "warnings"
      ]
    },
    "CatalogPreviewCreate": {
      "type": "object",
      "description": "Serializer for a release or recording that will be created.",
      "properties": {
        "row_index": {
          "type": "integer"
        },
        "match_status": {
          "type": "string"
        },
        "import_values": {
          "type": "object",
          "additionalProperties": {}
        }
      },
      "required": [
        "import_values",
        "match_status",
        "row_index"
      ]
    },
    "CatalogPreviewError": {
      "type": "object",
      "description": "Serializer for an import item that cannot be imported due to an analysis error.",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "row_index": {
          "type": "integer"
        },
        "match_status": {
          "type": "string"
        },
        "import_values": {
          "type": "object",
          "additionalProperties": {}
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "id",
        "import_values",
        "match_status",
        "row_index",
        "warnings"
      ]
    },
    "CatalogPreviewErrors": {
      "type": "object",
      "description": "Grouped analysis errors for releases and recordings.",
      "properties": {
        "release": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/CatalogPreviewError"
          }
        },
        "recordings": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/CatalogPreviewError"
          }
        }
      },
      "required": [
        "recordings",
        "release"
      ]
    },
    "CatalogPreviewSummary": {
      "type": "object",
      "description": "Summary counts for catalog preview.",
      "properties": {
        "new_releases": {
          "type": "integer"
        },
        "updated_releases": {
          "type": "integer"
        },
        "new_recordings": {
          "type": "integer"
        },
        "updated_recordings": {
          "type": "integer"
        },
        "likely_recordings": {
          "type": "integer"
        },
        "likely_releases": {
          "type": "integer"
        },
        "conflicts_recordings": {
          "type": "integer"
        },
        "conflicts_releases": {
          "type": "integer"
        },
        "errors": {
          "type": "integer"
        }
      },
      "required": [
        "conflicts_recordings",
        "conflicts_releases",
        "errors",
        "likely_recordings",
        "likely_releases",
        "new_recordings",
        "new_releases",
        "updated_recordings",
        "updated_releases"
      ]
    },
    "CatalogPreviewUpdate": {
      "type": "object",
      "description": "Serializer for a release or recording that will be updated.",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "row_index": {
          "type": "integer"
        },
        "match_status": {
          "type": "string"
        },
        "import_values": {
          "type": "object",
          "additionalProperties": {}
        },
        "catalog_values": {},
        "updates": {
          "type": "object",
          "additionalProperties": {}
        }
      },
      "required": [
        "id",
        "import_values",
        "match_status",
        "row_index",
        "updates"
      ]
    }
  }
}