{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://catalog.lintel.tools/schemas/schemastore/deepmatch-deeplinks-spec/latest.json",
  "title": "DeepMatch Deeplinks Specification",
  "description": "JSON Schema for DeepMatch .deeplinks.yml and .deeplinks.yaml configuration files",
  "x-lintel": {
    "source": "https://raw.githubusercontent.com/aouledissa/deep-match/main/schemas/deeplinks.schema.json",
    "sourceSha256": "a42a8efe6afb86464e2e4db2b0253d491945fd34f1b892c01b3e12c710398eb5",
    "fileMatch": [
      "**/.deeplinks.yml",
      "**/*.deeplinks.yml",
      "**/.deeplinks.yaml",
      "**/*.deeplinks.yaml"
    ],
    "parsers": [
      "yaml"
    ]
  },
  "type": "object",
  "properties": {
    "deeplinkSpecs": {
      "type": "array",
      "description": "List of deeplink specifications",
      "items": {
        "$ref": "#/$defs/DeeplinkConfig"
      }
    }
  },
  "required": [
    "deeplinkSpecs"
  ],
  "additionalProperties": false,
  "$defs": {
    "DeeplinkConfig": {
      "type": "object",
      "description": "A deeplink configuration object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Unique identifier for the deeplink spec. Used for generated names and must be unique across all specs in the file."
        },
        "description": {
          "type": "string",
          "description": "Free-form description for the deeplink spec"
        },
        "activity": {
          "type": "string",
          "description": "Fully qualified name of the activity eligible to resolve this deeplink",
          "pattern": "^[a-zA-Z0-9_.]+$"
        },
        "categories": {
          "type": "array",
          "description": "Intent filter categories",
          "items": {
            "type": "string",
            "enum": [
              "DEFAULT",
              "BROWSABLE",
              "LAUNCHER",
              "APP_OPENABLE"
            ]
          },
          "default": [
            "DEFAULT"
          ]
        },
        "autoVerify": {
          "type": "boolean",
          "description": "Enables android:autoVerify=\"true\" for app links. If a spec mixes web + custom schemes, generated manifest output is split into separate intent filters so only web schemes are auto-verified.",
          "default": false
        },
        "scheme": {
          "type": "array",
          "description": "Allowed URI schemes",
          "items": {
            "type": "string"
          },
          "minItems": 1,
          "examples": [
            [
              "app"
            ],
            [
              "https"
            ],
            [
              "app",
              "https"
            ]
          ]
        },
        "host": {
          "type": "array",
          "description": "Allowed URI hosts/domains. Leave empty or omit for hostless URIs such as app:///profile/123.",
          "items": {
            "type": "string"
          },
          "default": []
        },
        "port": {
          "type": "integer",
          "description": "Optional URI port filter (e.g., staging links on :8080)"
        },
        "pathParams": {
          "type": "array",
          "description": "Ordered path segments/templates. Order is positional and preserved.",
          "items": {
            "$ref": "#/$defs/Param"
          }
        },
        "queryParams": {
          "type": "array",
          "description": "Typed query definitions. Matching is order-agnostic.",
          "items": {
            "$ref": "#/$defs/QueryParam"
          }
        },
        "fragment": {
          "type": "string",
          "description": "Required URI fragment (#...). Exposed in generated params when declared. Fragment matching is runtime-only (not manifest-level)."
        }
      },
      "required": [
        "name",
        "activity",
        "scheme"
      ],
      "additionalProperties": false
    },
    "Param": {
      "type": "object",
      "description": "A path parameter definition",
      "properties": {
        "name": {
          "type": "string",
          "description": "Path segment label or typed placeholder key"
        },
        "type": {
          "type": "string",
          "description": "Path parameter value type",
          "enum": [
            "numeric",
            "alphanumeric",
            "string"
          ]
        }
      },
      "required": [
        "name"
      ],
      "additionalProperties": false
    },
    "QueryParam": {
      "type": "object",
      "description": "A query parameter definition",
      "properties": {
        "name": {
          "type": "string",
          "description": "Query key name"
        },
        "type": {
          "type": "string",
          "description": "Query parameter value type used for runtime validation and typed generation",
          "enum": [
            "numeric",
            "alphanumeric",
            "string"
          ]
        },
        "required": {
          "type": "boolean",
          "description": "If true, key must be present to match. Optional typed query params are generated nullable.",
          "default": false
        }
      },
      "required": [
        "name"
      ],
      "additionalProperties": false
    }
  }
}