{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://smmods.com/api/v1/publishing/backend-contract.schema.json",
  "title": "SMMODS Publishing Backend Contract",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schema",
    "schemaUrl",
    "generatedAt",
    "status",
    "live",
    "baseUrl",
    "summary",
    "security",
    "roles",
    "endpoints",
    "dataContracts",
    "storage",
    "validationWorker",
    "catalogPublisher",
    "goLiveChecks",
    "manualFallback"
  ],
  "properties": {
    "schema": {
      "const": "smmods.publishing-backend-contract.v1"
    },
    "schemaUrl": {
      "const": "https://smmods.com/api/v1/publishing/backend-contract.schema.json"
    },
    "generatedAt": {
      "type": "string",
      "format": "date-time"
    },
    "status": {
      "enum": [
        "planned-static-contract",
        "live-backend"
      ]
    },
    "live": {
      "type": "boolean"
    },
    "baseUrl": {
      "const": "https://smmods.com"
    },
    "summary": {
      "type": "string",
      "minLength": 1
    },
    "security": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "requiresHttps",
        "sessionCookie",
        "csrfHeader",
        "passwordPolicy",
        "emailDeliveryPolicy",
        "adminBootstrapPolicy",
        "rateLimitPolicy"
      ],
      "properties": {
        "requiresHttps": {
          "const": true
        },
        "sessionCookie": {
          "type": "string",
          "minLength": 1
        },
        "csrfHeader": {
          "type": "string",
          "minLength": 1
        },
        "passwordPolicy": {
          "type": "string",
          "minLength": 1
        },
        "emailDeliveryPolicy": {
          "type": "string",
          "minLength": 1
        },
        "adminBootstrapPolicy": {
          "type": "string",
          "minLength": 1
        },
        "rateLimitPolicy": {
          "type": "string",
          "minLength": 1
        }
      }
    },
    "roles": {
      "type": "array",
      "items": {
        "enum": [
          "player",
          "modder",
          "moderator",
          "admin"
        ]
      },
      "uniqueItems": true,
      "minItems": 4
    },
    "endpoints": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "required": [
          "id",
          "method",
          "path",
          "status",
          "authRequired",
          "roles",
          "summary"
        ],
        "additionalProperties": true,
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9_]*$"
          },
          "method": {
            "enum": [
              "GET",
              "POST",
              "PUT",
              "DELETE"
            ]
          },
          "path": {
            "type": "string",
            "pattern": "^/api/v1/"
          },
          "status": {
            "enum": [
              "planned",
              "implemented"
            ]
          },
          "authRequired": {
            "type": "boolean"
          },
          "roles": {
            "type": "array",
            "items": {
              "enum": [
                "player",
                "modder",
                "moderator",
                "admin"
              ]
            },
            "uniqueItems": true
          },
          "contentType": {
            "type": "string"
          },
          "requiredFields": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "uniqueItems": true
          },
          "metadataSchema": {
            "const": "smmods.mod-release-submission.v1"
          },
          "allowedDecisions": {
            "type": "array",
            "items": {
              "enum": [
                "approve",
                "reject",
                "request_changes",
                "hide",
                "unhide"
              ]
            },
            "uniqueItems": true
          },
          "summary": {
            "type": "string",
            "minLength": 1
          }
        }
      }
    },
    "dataContracts": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "account",
        "uploadSubmission",
        "auditEvent"
      ],
      "properties": {
        "account": {
          "$ref": "#/$defs/fieldList"
        },
        "uploadSubmission": {
          "allOf": [
            {
              "$ref": "#/$defs/fieldList"
            },
            {
              "type": "object",
              "required": [
                "schema",
                "schemaUrl",
                "states"
              ],
              "properties": {
                "schema": {
                  "const": "smmods.upload-submission.v1"
                },
                "schemaUrl": {
                  "const": "https://smmods.com/api/v1/publishing/upload-submission.schema.json"
                },
                "states": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1
                  },
                  "uniqueItems": true
                }
              }
            }
          ]
        },
        "auditEvent": {
          "$ref": "#/$defs/fieldList"
        }
      }
    },
    "storage": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "stagingPathTemplate",
        "publicArtifactPathTemplate",
        "immutablePublicArtifacts",
        "maxPackageBytes",
        "liveUploadGate"
      ],
      "properties": {
        "stagingPathTemplate": {
          "type": "string",
          "minLength": 1
        },
        "publicArtifactPathTemplate": {
          "type": "string",
          "minLength": 1
        },
        "immutablePublicArtifacts": {
          "const": true
        },
        "maxPackageBytes": {
          "type": "integer",
          "minimum": 1
        },
        "liveUploadGate": {
          "type": "string",
          "minLength": 1
        }
      }
    },
    "validationWorker": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "queue",
        "frameworkValidationContractUrl",
        "frameworkValidationContractSchemaUrl",
        "requiredChecks"
      ],
      "properties": {
        "queue": {
          "type": "string",
          "minLength": 1
        },
        "frameworkValidationContractUrl": {
          "const": "https://smmods.com/api/v1/publishing/starminer-publishing-validation.v1.json"
        },
        "frameworkValidationContractSchemaUrl": {
          "const": "https://smmods.com/api/v1/publishing/starminer-publishing-validation.schema.json"
        },
        "requiredChecks": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "uniqueItems": true
        }
      }
    },
    "catalogPublisher": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "outputs",
        "atomicPublication",
        "postPublishSmokeRequired"
      ],
      "properties": {
        "outputs": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "uniqueItems": true
        },
        "atomicPublication": {
          "const": true
        },
        "postPublishSmokeRequired": {
          "const": true
        }
      }
    },
    "goLiveChecks": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "minItems": 1
    },
    "manualFallback": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "active",
        "workflowUrl",
        "runbook",
        "tool"
      ],
      "properties": {
        "active": {
          "const": true
        },
        "workflowUrl": {
          "const": "https://smmods.com/api/v1/publishing/workflow.json"
        },
        "runbook": {
          "type": "string",
          "minLength": 1
        },
        "tool": {
          "type": "string",
          "minLength": 1
        }
      }
    }
  },
  "$defs": {
    "fieldList": {
      "type": "object",
      "additionalProperties": true,
      "required": [
        "requiredFields"
      ],
      "properties": {
        "requiredFields": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "uniqueItems": true,
          "minItems": 1
        }
      }
    }
  }
}