{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://unpkg.com/@squiz/dx-json-schema-lib@latest/lib/manifest/userApiManifest/UserApiManifestV1.json",
  "title": "UserApiManifestV1",
  "type": "object",
  "additionalProperties": false,
  "definitions": {
    "resolvedApiManifest": {
      "type": "object",
      "additionalProperties": false,
      "required": ["endpoints"],
      "properties": {
        "endpoints": {
          "type": "array",
          "minItems": 1,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": ["path", "method", "handler"],
            "properties": {
              "path": {
                "type": "string",
                "pattern": "^/.*",
                "description": "URL path routed to this endpoint; must start with /. May include `*` wildcards or `:param` segments (api-builder style)."
              },
              "method": {
                "type": "string",
                "enum": ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "HEAD"],
                "description": "HTTP method for this route."
              },
              "handler": {
                "type": "string",
                "pattern": "^[a-zA-Z_$][a-zA-Z0-9_$.]*$",
                "description": "Exported handler reference (module.export form)."
              },
              "description": {
                "type": "string",
                "description": "Description of the endpoint."
              }
            }
          }
        }
      }
    }
  },
  "required": ["$schema", "name", "displayName", "filesDir", "entry", "manifest"],
  "properties": {
    "$schema": {
      "type": "string",
      "minLength": 1,
      "description": "JSON Schema reference for IDE support."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "pattern": "^[a-z](?:[a-z0-9-]|_(?!_))*[a-z0-9]$",
      "description": "Slug for this deployment. Lowercase letters, digits, hyphens, or underscores only; must start with a letter, end with a letter or digit, and cannot contain consecutive underscores."
    },
    "displayName": {
      "type": "string",
      "minLength": 1
    },
    "description": {
      "type": "string",
      "description": "Human-readable summary of what the API provides."
    },
    "filesDir": {
      "type": "string",
      "minLength": 1,
      "description": "Directory (relative to the manifest) containing sources."
    },
    "entry": {
      "type": "string",
      "minLength": 1,
      "description": "Entry module path under filesDir (e.g. index.ts)."
    },
    "manifest": {
      "$ref": "#/definitions/resolvedApiManifest"
    }
  }
}