@unispechq/unispec-core 0.3.2 → 0.3.3

package/dist/generated-schemas.js

@@ -1,2097 +0,0 @@
-// Auto-generated schemas for validator
-// This file is generated during build time
-export const GENERATED_SCHEMAS = {
-    unispec: {
-        "$schema": "https://json-schema.org/draft/2020-12/schema",
-        "$id": "https://unispec.dev/schema/unispec.schema.json",
-        "title": "UniSpec document",
-        "description": "Top-level UniSpec document describing a multi-protocol API service.",
-        "type": "object",
-        "required": [
-            "unispecVersion",
-            "service"
-        ],
-        "properties": {
-            "unispecVersion": {
-                "type": "string",
-                "description": "UniSpec format version (SemVer)."
-            },
-            "service": {
-                "$ref": "./types/service.schema.json#"
-            }
-        },
-        "additionalProperties": false
-    },
-    unispecTests: {
-        "$schema": "https://json-schema.org/draft/2020-12/schema",
-        "$id": "https://unispec.dev/schema/unispec-tests.schema.json",
-        "title": "UniSpec Tests document",
-        "description": "Executable test cases targeting UniSpec-described services.",
-        "type": "object",
-        "required": [
-            "uniSpecTestsVersion",
-            "target",
-            "tests"
-        ],
-        "properties": {
-            "uniSpecTestsVersion": {
-                "type": "string",
-                "description": "UniSpec Tests format version (SemVer)."
-            },
-            "target": {
-                "type": "object",
-                "description": "Service and environment that this test document targets.",
-                "required": [
-                    "serviceName"
-                ],
-                "properties": {
-                    "serviceName": {
-                        "type": "string",
-                        "description": "Identifier of the service, matching service.name from UniSpec."
-                    },
-                    "serviceVersion": {
-                        "type": "string",
-                        "description": "Optional service contract version, matching service.version when provided."
-                    },
-                    "environment": {
-                        "type": "string",
-                        "description": "Optional environment name, matching service.environments[].name when provided."
-                    }
-                },
-                "additionalProperties": false
-            },
-            "tests": {
-                "type": "array",
-                "description": "List of test cases.",
-                "items": {
-                    "$ref": "#/$defs/TestCase"
-                }
-            },
-            "loadTesting": {
-                "type": "object",
-                "description": "Load testing configuration for this test suite.",
-                "properties": {
-                    "concurrentUsers": {
-                        "type": "integer",
-                        "minimum": 1,
-                        "description": "Number of concurrent users to simulate."
-                    },
-                    "duration": {
-                        "type": "string",
-                        "description": "Test duration (e.g., '10m', '1h')."
-                    },
-                    "rampUp": {
-                        "type": "string",
-                        "description": "Ramp-up time for reaching concurrent users."
-                    },
-                    "thresholds": {
-                        "type": "object",
-                        "description": "Performance thresholds.",
-                        "properties": {
-                            "responseTime": {
-                                "type": "string",
-                                "description": "Maximum response time (e.g., '200ms', '1s')."
-                            },
-                            "errorRate": {
-                                "type": "number",
-                                "minimum": 0,
-                                "maximum": 1,
-                                "description": "Maximum error rate (0.0 to 1.0)."
-                            },
-                            "throughput": {
-                                "type": "string",
-                                "description": "Minimum throughput (e.g., '100req/s')."
-                            }
-                        },
-                        "additionalProperties": false
-                    },
-                    "scenario": {
-                        "type": "object",
-                        "description": "Load test scenario configuration.",
-                        "properties": {
-                            "weight": {
-                                "type": "object",
-                                "description": "Test weights by tag or operation.",
-                                "additionalProperties": {
-                                    "type": "integer",
-                                    "minimum": 1
-                                }
-                            },
-                            "thinkTime": {
-                                "type": "string",
-                                "description": "User think time between requests."
-                            }
-                        },
-                        "additionalProperties": false
-                    }
-                },
-                "additionalProperties": false
-            }
-        },
-        "$defs": {
-            "TestCase": {
-                "type": "object",
-                "required": [
-                    "name",
-                    "target",
-                    "request",
-                    "expect"
-                ],
-                "properties": {
-                    "name": {
-                        "type": "string",
-                        "description": "Test identifier, unique within this document."
-                    },
-                    "description": {
-                        "type": "string",
-                        "description": "Human-readable description of the test case."
-                    },
-                    "target": {
-                        "$ref": "#/$defs/TestTarget"
-                    },
-                    "request": {
-                        "$ref": "#/$defs/TestRequest"
-                    },
-                    "expect": {
-                        "$ref": "#/$defs/TestExpect"
-                    },
-                    "tags": {
-                        "type": "array",
-                        "description": "Tags for grouping and filtering tests.",
-                        "items": {
-                            "type": "string"
-                        }
-                    }
-                },
-                "additionalProperties": false
-            },
-            "TestTarget": {
-                "type": "object",
-                "required": [
-                    "protocol",
-                    "operationId"
-                ],
-                "properties": {
-                    "protocol": {
-                        "type": "string",
-                        "description": "Protocol of the operation under test.",
-                        "enum": [
-                            "rest",
-                            "graphql",
-                            "websocket"
-                        ]
-                    },
-                    "operationId": {
-                        "type": "string",
-                        "description": "Operation identifier within the service (for example, REST route name)."
-                    },
-                    "environment": {
-                        "type": "string",
-                        "description": "Optional environment name overriding the document-level target.environment."
-                    }
-                },
-                "additionalProperties": false
-            },
-            "TestRequest": {
-                "type": "object",
-                "description": "Protocol-specific request definition.",
-                "properties": {
-                    "rest": {
-                        "$ref": "#/$defs/RestRequest"
-                    },
-                    "graphql": {
-                        "$ref": "#/$defs/GraphQLRequest"
-                    },
-                    "websocket": {
-                        "$ref": "#/$defs/WebSocketRequest"
-                    }
-                },
-                "additionalProperties": false
-            },
-            "TestExpect": {
-                "type": "object",
-                "description": "Protocol-specific expectations.",
-                "properties": {
-                    "rest": {
-                        "$ref": "#/$defs/RestExpect"
-                    },
-                    "graphql": {
-                        "$ref": "#/$defs/GraphQLExpect"
-                    },
-                    "websocket": {
-                        "$ref": "#/$defs/WebSocketExpect"
-                    }
-                },
-                "additionalProperties": false
-            },
-            "RestRequest": {
-                "type": "object",
-                "properties": {
-                    "params": {
-                        "type": "object",
-                        "properties": {
-                            "path": {
-                                "type": "object",
-                                "additionalProperties": true
-                            },
-                            "query": {
-                                "type": "object",
-                                "additionalProperties": true
-                            }
-                        },
-                        "additionalProperties": false
-                    },
-                    "headers": {
-                        "type": "object",
-                        "additionalProperties": true
-                    },
-                    "body": {
-                        "description": "Request body (arbitrary JSON value)."
-                    },
-                    "authProfile": {
-                        "type": "string",
-                        "description": "Identifier of an authentication profile configured in tooling."
-                    }
-                },
-                "additionalProperties": false
-            },
-            "RestExpect": {
-                "type": "object",
-                "required": [
-                    "status"
-                ],
-                "properties": {
-                    "status": {
-                        "description": "Expected HTTP status code or list of acceptable codes.",
-                        "oneOf": [
-                            {
-                                "type": "integer"
-                            },
-                            {
-                                "type": "array",
-                                "items": {
-                                    "type": "integer"
-                                }
-                            }
-                        ]
-                    },
-                    "headers": {
-                        "type": "object",
-                        "description": "Expected headers (usually partial match).",
-                        "additionalProperties": true
-                    },
-                    "body": {
-                        "$ref": "#/$defs/BodyExpectation"
-                    }
-                },
-                "additionalProperties": false
-            },
-            "BodyExpectation": {
-                "type": "object",
-                "properties": {
-                    "mode": {
-                        "type": "string",
-                        "enum": [
-                            "exact",
-                            "contains",
-                            "schemaOnly",
-                            "snapshot"
-                        ],
-                        "description": "Assertion mode for the response body."
-                    },
-                    "json": {
-                        "description": "JSON value used for exact or contains mode."
-                    },
-                    "schemaRef": {
-                        "type": "string",
-                        "description": "Reference to a schema from service.schemas for schemaOnly mode. Recommended format: <SchemaName> (where SchemaName is a key in service.schemas). Tools may also accept a JSON Pointer in the form #/service/schemas/<SchemaName>."
-                    }
-                },
-                "additionalProperties": false
-            },
-            "GraphQLRequest": {
-                "type": "object",
-                "properties": {
-                    "operationName": {
-                        "type": "string"
-                    },
-                    "query": {
-                        "type": "string"
-                    },
-                    "variables": {
-                        "type": "object",
-                        "additionalProperties": true
-                    },
-                    "headers": {
-                        "type": "object",
-                        "additionalProperties": true
-                    },
-                    "authProfile": {
-                        "type": "string",
-                        "description": "Identifier of an authentication profile configured in tooling."
-                    }
-                },
-                "required": [
-                    "query"
-                ],
-                "additionalProperties": false
-            },
-            "GraphQLExpect": {
-                "type": "object",
-                "properties": {
-                    "data": {
-                        "description": "Expectations on the data field (exact or partial match)."
-                    },
-                    "errors": {
-                        "description": "Expectations on the errors field."
-                    },
-                    "bodyMode": {
-                        "type": "string",
-                        "description": "Optional control over how strictly data and errors are matched."
-                    }
-                },
-                "additionalProperties": false
-            },
-            "WebSocketRequest": {
-                "type": "object",
-                "properties": {
-                    "channel": {
-                        "type": "string",
-                        "description": "Channel identifier, matching protocols.websocket.channels[].name."
-                    },
-                    "direction": {
-                        "type": "string",
-                        "enum": [
-                            "publish",
-                            "subscribe",
-                            "both"
-                        ]
-                    },
-                    "messages": {
-                        "type": "array",
-                        "description": "Message actions (send/expect) forming a small interaction script.",
-                        "items": {
-                            "$ref": "#/$defs/WebSocketMessageAction"
-                        }
-                    },
-                    "authProfile": {
-                        "type": "string",
-                        "description": "Identifier of an authentication profile configured in tooling."
-                    }
-                },
-                "required": [
-                    "channel"
-                ],
-                "additionalProperties": false
-            },
-            "WebSocketMessageAction": {
-                "type": "object",
-                "required": [
-                    "type",
-                    "messageName"
-                ],
-                "properties": {
-                    "type": {
-                        "type": "string",
-                        "enum": [
-                            "send",
-                            "expect"
-                        ],
-                        "description": "Whether this action sends or expects a message."
-                    },
-                    "messageName": {
-                        "type": "string",
-                        "description": "Name of the message, matching protocols.websocket.channels[].messages[].name."
-                    },
-                    "payload": {
-                        "description": "Payload to send or expected payload structure."
-                    }
-                },
-                "additionalProperties": false
-            },
-            "WebSocketExpect": {
-                "type": "object",
-                "properties": {
-                    "messages": {
-                        "type": "array",
-                        "description": "Expected messages to be observed on the channel.",
-                        "items": {
-                            "$ref": "#/$defs/WebSocketMessageAction"
-                        }
-                    },
-                    "timeoutMs": {
-                        "type": "integer",
-                        "description": "Timeout for the WebSocket interaction in milliseconds."
-                    }
-                },
-                "additionalProperties": false
-            }
-        },
-        "additionalProperties": false
-    },
-    unispecConfig: {
-        "$schema": "https://json-schema.org/draft/2020-12/schema",
-        "$id": "https://unispec.dev/schema/unispec-config.schema.json",
-        "title": "UniSpec Config",
-        "description": "Configuration file that describes how to locate UniSpec documents for one or more services.",
-        "type": "object",
-        "required": [
-            "version",
-            "services"
-        ],
-        "properties": {
-            "version": {
-                "type": "integer",
-                "description": "Config format version.",
-                "minimum": 1
-            },
-            "services": {
-                "type": "array",
-                "description": "List of services available in this config.",
-                "items": {
-                    "$ref": "#/$defs/ServiceEntry"
-                },
-                "minItems": 1
-            },
-            "discovery": {
-                "$ref": "#/$defs/Discovery"
-            },
-            "environments": {
-                "type": "array",
-                "description": "Named environments (for example, local, staging, prod) with optional overrides.",
-                "items": {
-                    "$ref": "#/$defs/Environment"
-                }
-            }
-        },
-        "$defs": {
-            "ServiceEntry": {
-                "type": "object",
-                "required": [
-                    "name",
-                    "spec"
-                ],
-                "properties": {
-                    "name": {
-                        "$ref": "./types/common.schema.json#/$defs/Identifier"
-                    },
-                    "baseUrl": {
-                        "type": "string",
-                        "description": "Service base URL. Can differ per service and can be overridden by environments."
-                    },
-                    "spec": {
-                        "$ref": "#/$defs/SpecReference"
-                    },
-                    "health": {
-                        "$ref": "#/$defs/Health"
-                    },
-                    "discovery": {
-                        "$ref": "#/$defs/Discovery"
-                    },
-                    "headers": {
-                        "type": "array",
-                        "description": "HTTP headers commonly used for accessing this service's UniSpec document.",
-                        "items": {
-                            "$ref": "#/$defs/Header"
-                        }
-                    },
-                    "security": {
-                        "type": "array",
-                        "description": "Security requirements for accessing this service's UniSpec document. Each item represents an alternative set of named security schemes.",
-                        "items": {
-                            "$ref": "#/$defs/SecurityRequirement"
-                        }
-                    }
-                },
-                "additionalProperties": false
-            },
-            "SpecReference": {
-                "description": "Reference to a UniSpec document.",
-                "oneOf": [
-                    {
-                        "type": "string",
-                        "description": "Backward-compatible spec reference. Tooling interprets it as a location string (for example, URL or file path)."
-                    },
-                    {
-                        "$ref": "#/$defs/HttpSpecReference"
-                    },
-                    {
-                        "$ref": "#/$defs/FileSpecReference"
-                    },
-                    {
-                        "$ref": "#/$defs/RegistrySpecReference"
-                    }
-                ]
-            },
-            "HttpSpecReference": {
-                "type": "object",
-                "required": [
-                    "type"
-                ],
-                "properties": {
-                    "type": {
-                        "const": "http"
-                    },
-                    "url": {
-                        "type": "string",
-                        "description": "Absolute or relative URL to the UniSpec document (for example, https://... or /unispec.json)."
-                    },
-                    "path": {
-                        "type": "string",
-                        "description": "Backward-compatible alias for url (for example, /unispec.yaml)."
-                    }
-                },
-                "oneOf": [
-                    {
-                        "required": [
-                            "url"
-                        ]
-                    },
-                    {
-                        "required": [
-                            "path"
-                        ]
-                    }
-                ],
-                "additionalProperties": false
-            },
-            "FileSpecReference": {
-                "type": "object",
-                "required": [
-                    "type",
-                    "path"
-                ],
-                "properties": {
-                    "type": {
-                        "const": "file"
-                    },
-                    "path": {
-                        "type": "string",
-                        "description": "Path to the UniSpec document on disk (for example, ./path/to/unispec.json)."
-                    }
-                },
-                "additionalProperties": false
-            },
-            "RegistrySpecReference": {
-                "type": "object",
-                "required": [
-                    "type",
-                    "ref"
-                ],
-                "properties": {
-                    "type": {
-                        "const": "registry"
-                    },
-                    "ref": {
-                        "type": "string",
-                        "description": "Registry reference for resolving the UniSpec document."
-                    }
-                },
-                "additionalProperties": false
-            },
-            "Health": {
-                "type": "object",
-                "required": [
-                    "path"
-                ],
-                "properties": {
-                    "path": {
-                        "type": "string",
-                        "description": "HTTP path for a health check endpoint (for example, /ping)."
-                    }
-                },
-                "additionalProperties": false
-            },
-            "Discovery": {
-                "type": "object",
-                "properties": {
-                    "dnsTemplate": {
-                        "type": "string",
-                        "description": "DNS-based discovery template. Template variables: {service}, {env}. If environment is not set, {env} is replaced with an empty string."
-                    }
-                },
-                "additionalProperties": false
-            },
-            "Environment": {
-                "type": "object",
-                "required": [
-                    "name"
-                ],
-                "properties": {
-                    "name": {
-                        "type": "string",
-                        "description": "Environment name (for example, local, staging, prod)."
-                    },
-                    "overrides": {
-                        "$ref": "#/$defs/EnvironmentOverrides"
-                    },
-                    "observability": {
-                        "$ref": "#/$defs/Observability"
-                    },
-                    "deployment": {
-                        "$ref": "#/$defs/Deployment"
-                    },
-                    "dataResidency": {
-                        "type": "string",
-                        "description": "Geographic region where data is stored for compliance."
-                    },
-                    "audit": {
-                        "$ref": "#/$defs/Audit"
-                    }
-                },
-                "additionalProperties": false
-            },
-            "EnvironmentOverrides": {
-                "type": "object",
-                "properties": {
-                    "services": {
-                        "type": "object",
-                        "description": "Per-service overrides. Keys are service names.",
-                        "additionalProperties": {
-                            "$ref": "#/$defs/ServiceOverride"
-                        }
-                    }
-                },
-                "additionalProperties": false
-            },
-            "ServiceOverride": {
-                "type": "object",
-                "properties": {
-                    "baseUrl": {
-                        "type": "string",
-                        "description": "Override for service baseUrl in this environment."
-                    },
-                    "spec": {
-                        "$ref": "#/$defs/SpecReference"
-                    },
-                    "health": {
-                        "$ref": "#/$defs/Health"
-                    },
-                    "discovery": {
-                        "$ref": "#/$defs/Discovery"
-                    },
-                    "headers": {
-                        "type": "array",
-                        "description": "HTTP headers overrides for accessing this service's UniSpec document in this environment.",
-                        "items": {
-                            "$ref": "#/$defs/Header"
-                        }
-                    },
-                    "security": {
-                        "type": "array",
-                        "description": "Security requirements overrides for accessing this service's UniSpec document in this environment.",
-                        "items": {
-                            "$ref": "#/$defs/SecurityRequirement"
-                        }
-                    }
-                },
-                "additionalProperties": false
-            },
-            "Header": {
-                "type": "object",
-                "required": [
-                    "name"
-                ],
-                "properties": {
-                    "name": {
-                        "type": "string",
-                        "description": "Header name (case-insensitive)."
-                    },
-                    "description": {
-                        "type": "string",
-                        "description": "Human-readable description of the header."
-                    },
-                    "required": {
-                        "type": "boolean",
-                        "description": "Whether this header is required.",
-                        "default": false
-                    },
-                    "defaultValue": {
-                        "type": "string",
-                        "description": "Default value for the header."
-                    }
-                },
-                "additionalProperties": false
-            },
-            "SecurityRequirement": {
-                "type": "array",
-                "description": "Alternative set of named security schemes applied to a service or operation.",
-                "items": {
-                    "$ref": "./types/common.schema.json#/$defs/Identifier"
-                }
-            },
-            "Observability": {
-                "type": "object",
-                "description": "Observability configuration for the environment.",
-                "properties": {
-                    "logging": {
-                        "type": "object",
-                        "properties": {
-                            "level": {
-                                "type": "string",
-                                "enum": [
-                                    "debug",
-                                    "info",
-                                    "warn",
-                                    "error"
-                                ],
-                                "description": "Logging level."
-                            },
-                            "format": {
-                                "type": "string",
-                                "enum": [
-                                    "json",
-                                    "text"
-                                ],
-                                "description": "Log format."
-                            },
-                            "fields": {
-                                "type": "array",
-                                "items": {
-                                    "type": "string"
-                                },
-                                "description": "Additional fields to include in logs."
-                            }
-                        },
-                        "additionalProperties": false
-                    },
-                    "metrics": {
-                        "type": "object",
-                        "properties": {
-                            "enabled": {
-                                "type": "boolean",
-                                "description": "Whether metrics collection is enabled."
-                            },
-                            "endpoints": {
-                                "type": "array",
-                                "items": {
-                                    "type": "string"
-                                },
-                                "description": "Metrics endpoints."
-                            },
-                            "customMetrics": {
-                                "type": "array",
-                                "items": {
-                                    "$ref": "#/$defs/CustomMetric"
-                                },
-                                "description": "Custom metrics definitions."
-                            }
-                        },
-                        "additionalProperties": false
-                    },
-                    "tracing": {
-                        "type": "object",
-                        "properties": {
-                            "enabled": {
-                                "type": "boolean",
-                                "description": "Whether distributed tracing is enabled."
-                            },
-                            "samplingRate": {
-                                "type": "number",
-                                "minimum": 0,
-                                "maximum": 1,
-                                "description": "Sampling rate for traces (0.0 to 1.0)."
-                            },
-                            "exporter": {
-                                "type": "string",
-                                "description": "Tracing exporter (e.g., jaeger, zipkin)."
-                            }
-                        },
-                        "additionalProperties": false
-                    }
-                },
-                "additionalProperties": false
-            },
-            "CustomMetric": {
-                "type": "object",
-                "properties": {
-                    "name": {
-                        "type": "string",
-                        "description": "Metric name."
-                    },
-                    "type": {
-                        "type": "string",
-                        "enum": [
-                            "counter",
-                            "gauge",
-                            "histogram",
-                            "summary"
-                        ],
-                        "description": "Metric type."
-                    },
-                    "description": {
-                        "type": "string",
-                        "description": "Metric description."
-                    },
-                    "labels": {
-                        "type": "array",
-                        "items": {
-                            "type": "string"
-                        },
-                        "description": "Metric labels."
-                    }
-                },
-                "required": [
-                    "name",
-                    "type"
-                ],
-                "additionalProperties": false
-            },
-            "Deployment": {
-                "type": "object",
-                "description": "Deployment configuration for the environment.",
-                "properties": {
-                    "kubernetes": {
-                        "$ref": "#/$defs/KubernetesConfig"
-                    },
-                    "docker": {
-                        "$ref": "#/$defs/DockerConfig"
-                    },
-                    "replicas": {
-                        "type": "integer",
-                        "minimum": 1,
-                        "description": "Number of replicas."
-                    },
-                    "resources": {
-                        "$ref": "#/$defs/Resources"
-                    }
-                },
-                "additionalProperties": false
-            },
-            "KubernetesConfig": {
-                "type": "object",
-                "properties": {
-                    "namespace": {
-                        "type": "string",
-                        "description": "Kubernetes namespace."
-                    },
-                    "image": {
-                        "type": "string",
-                        "description": "Container image."
-                    },
-                    "port": {
-                        "type": "integer",
-                        "description": "Container port."
-                    },
-                    "serviceType": {
-                        "type": "string",
-                        "enum": [
-                            "ClusterIP",
-                            "NodePort",
-                            "LoadBalancer"
-                        ],
-                        "description": "Kubernetes service type."
-                    },
-                    "ingress": {
-                        "type": "object",
-                        "properties": {
-                            "host": {
-                                "type": "string",
-                                "description": "Ingress host."
-                            },
-                            "path": {
-                                "type": "string",
-                                "description": "Ingress path."
-                            },
-                            "tls": {
-                                "type": "boolean",
-                                "description": "Whether TLS is enabled."
-                            }
-                        },
-                        "additionalProperties": false
-                    }
-                },
-                "additionalProperties": false
-            },
-            "DockerConfig": {
-                "type": "object",
-                "properties": {
-                    "image": {
-                        "type": "string",
-                        "description": "Docker image."
-                    },
-                    "port": {
-                        "type": "integer",
-                        "description": "Container port."
-                    },
-                    "environment": {
-                        "type": "object",
-                        "additionalProperties": {
-                            "type": "string"
-                        },
-                        "description": "Environment variables."
-                    },
-                    "volumes": {
-                        "type": "array",
-                        "items": {
-                            "type": "string"
-                        },
-                        "description": "Volume mounts."
-                    }
-                },
-                "additionalProperties": false
-            },
-            "Resources": {
-                "type": "object",
-                "properties": {
-                    "cpu": {
-                        "type": "string",
-                        "description": "CPU request/limit."
-                    },
-                    "memory": {
-                        "type": "string",
-                        "description": "Memory request/limit."
-                    },
-                    "storage": {
-                        "type": "string",
-                        "description": "Storage request/limit."
-                    }
-                },
-                "additionalProperties": false
-            },
-            "Audit": {
-                "type": "object",
-                "description": "Audit configuration for compliance.",
-                "properties": {
-                    "enabled": {
-                        "type": "boolean",
-                        "description": "Whether audit logging is enabled."
-                    },
-                    "retention": {
-                        "type": "string",
-                        "description": "Audit log retention period."
-                    },
-                    "fields": {
-                        "type": "array",
-                        "items": {
-                            "type": "string"
-                        },
-                        "description": "Fields to include in audit logs."
-                    },
-                    "export": {
-                        "type": "object",
-                        "properties": {
-                            "format": {
-                                "type": "string",
-                                "enum": [
-                                    "json",
-                                    "csv"
-                                ],
-                                "description": "Export format."
-                            },
-                            "destination": {
-                                "type": "string",
-                                "description": "Export destination."
-                            }
-                        },
-                        "additionalProperties": false
-                    }
-                },
-                "additionalProperties": false
-            }
-        },
-        "additionalProperties": false
-    },
-    subschemas: [
-        {
-            "$schema": "https://json-schema.org/draft/2020-12/schema",
-            "$id": "https://unispec.dev/schema/types/common.schema.json",
-            "title": "Common UniSpec definitions",
-            "$defs": {
-                "Identifier": {
-                    "type": "string",
-                    "description": "Identifier for services, operations, channels, etc.",
-                    "pattern": "^[A-Za-z_][A-Za-z0-9_.:-]*$"
-                },
-                "Description": {
-                    "type": "string",
-                    "description": "Human-readable description text."
-                },
-                "Email": {
-                    "type": "string",
-                    "description": "Email address with validation.",
-                    "format": "email",
-                    "pattern": "^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$"
-                },
-                "Url": {
-                    "type": "string",
-                    "description": "URL with validation.",
-                    "format": "uri",
-                    "pattern": "^https?://[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}.*$"
-                },
-                "Version": {
-                    "type": "string",
-                    "description": "Semantic version string (SemVer).",
-                    "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$"
-                },
-                "Tag": {
-                    "type": "string",
-                    "description": "Tag for grouping operations and resources.",
-                    "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
-                },
-                "SecurityScheme": {
-                    "type": "object",
-                    "discriminator": {
-                        "propertyName": "type"
-                    },
-                    "oneOf": [
-                        {
-                            "$ref": "#/$defs/ApiKeyScheme"
-                        },
-                        {
-                            "$ref": "#/$defs/HttpScheme"
-                        },
-                        {
-                            "$ref": "#/$defs/OAuth2Scheme"
-                        },
-                        {
-                            "$ref": "#/$defs/JwtScheme"
-                        }
-                    ]
-                },
-                "ApiKeyScheme": {
-                    "type": "object",
-                    "properties": {
-                        "type": {
-                            "const": "apiKey"
-                        },
-                        "name": {
-                            "type": "string",
-                            "description": "Name of the API key header or query parameter."
-                        },
-                        "in": {
-                            "type": "string",
-                            "enum": [
-                                "header",
-                                "query",
-                                "cookie"
-                            ],
-                            "description": "Location of the API key."
-                        },
-                        "description": {
-                            "type": "string",
-                            "description": "Description of the API key usage."
-                        }
-                    },
-                    "required": [
-                        "type",
-                        "name",
-                        "in"
-                    ],
-                    "additionalProperties": false
-                },
-                "HttpScheme": {
-                    "type": "object",
-                    "properties": {
-                        "type": {
-                            "const": "http"
-                        },
-                        "scheme": {
-                            "type": "string",
-                            "enum": [
-                                "basic",
-                                "bearer",
-                                "digest"
-                            ],
-                            "description": "HTTP authentication scheme."
-                        },
-                        "bearerFormat": {
-                            "type": "string",
-                            "description": "Format of the bearer token (e.g., JWT)."
-                        },
-                        "description": {
-                            "type": "string",
-                            "description": "Description of the HTTP authentication scheme."
-                        }
-                    },
-                    "required": [
-                        "type",
-                        "scheme"
-                    ],
-                    "additionalProperties": false
-                },
-                "OAuth2Scheme": {
-                    "type": "object",
-                    "properties": {
-                        "type": {
-                            "const": "oauth2"
-                        },
-                        "flows": {
-                            "type": "object",
-                            "description": "OAuth2 authorization flows.",
-                            "properties": {
-                                "authorizationCode": {
-                                    "$ref": "#/$defs/OAuth2Flow"
-                                },
-                                "clientCredentials": {
-                                    "$ref": "#/$defs/OAuth2Flow"
-                                },
-                                "implicit": {
-                                    "$ref": "#/$defs/OAuth2Flow"
-                                }
-                            },
-                            "additionalProperties": false
-                        },
-                        "description": {
-                            "type": "string",
-                            "description": "Description of the OAuth2 scheme."
-                        }
-                    },
-                    "required": [
-                        "type",
-                        "flows"
-                    ],
-                    "additionalProperties": false
-                },
-                "JwtScheme": {
-                    "type": "object",
-                    "properties": {
-                        "type": {
-                            "const": "jwt"
-                        },
-                        "issuer": {
-                            "type": "string",
-                            "description": "JWT issuer URL."
-                        },
-                        "audience": {
-                            "type": "array",
-                            "items": {
-                                "type": "string"
-                            },
-                            "description": "Allowed JWT audiences."
-                        },
-                        "algorithms": {
-                            "type": "array",
-                            "items": {
-                                "type": "string"
-                            },
-                            "description": "Allowed JWT algorithms."
-                        },
-                        "description": {
-                            "type": "string",
-                            "description": "Description of the JWT scheme."
-                        }
-                    },
-                    "required": [
-                        "type"
-                    ],
-                    "additionalProperties": false
-                },
-                "OAuth2Flow": {
-                    "type": "object",
-                    "properties": {
-                        "authorizationUrl": {
-                            "type": "string",
-                            "format": "uri",
-                            "description": "Authorization URL."
-                        },
-                        "tokenUrl": {
-                            "type": "string",
-                            "format": "uri",
-                            "description": "Token URL."
-                        },
-                        "refreshUrl": {
-                            "type": "string",
-                            "format": "uri",
-                            "description": "Refresh token URL."
-                        },
-                        "scopes": {
-                            "type": "object",
-                            "description": "Available scopes.",
-                            "additionalProperties": {
-                                "type": "string"
-                            }
-                        }
-                    },
-                    "required": [
-                        "authorizationUrl",
-                        "tokenUrl",
-                        "scopes"
-                    ],
-                    "additionalProperties": false
-                }
-            }
-        },
-        {
-            "$schema": "https://json-schema.org/draft/2020-12/schema",
-            "$id": "https://unispec.dev/schema/types/graphql.schema.json",
-            "title": "GraphQL API surface",
-            "type": "object",
-            "$defs": {
-                "Argument": {
-                    "type": "object",
-                    "required": [
-                        "name",
-                        "type"
-                    ],
-                    "properties": {
-                        "name": {
-                            "type": "string",
-                            "description": "Argument name as it appears in the GraphQL operation."
-                        },
-                        "type": {
-                            "type": "string",
-                            "description": "GraphQL type string (e.g., 'ID!', '[User]', 'PostFilter')."
-                        },
-                        "description": {
-                            "type": "string",
-                            "description": "Human-readable description of the argument."
-                        },
-                        "defaultValue": {
-                            "description": "Default value for the argument (any JSON value)."
-                        },
-                        "deprecated": {
-                            "type": "boolean",
-                            "description": "Marks the argument as deprecated.",
-                            "default": false
-                        },
-                        "deprecationReason": {
-                            "type": "string",
-                            "description": "Human-readable reason for deprecation."
-                        }
-                    },
-                    "additionalProperties": false
-                },
-                "SecurityRequirement": {
-                    "type": "array",
-                    "description": "Alternative set of named security schemes applied to an operation.",
-                    "items": {
-                        "$ref": "./common.schema.json#/$defs/Identifier"
-                    }
-                },
-                "Header": {
-                    "type": "object",
-                    "required": [
-                        "name"
-                    ],
-                    "properties": {
-                        "name": {
-                            "type": "string",
-                            "description": "Header name (case-insensitive)."
-                        },
-                        "description": {
-                            "type": "string",
-                            "description": "Human-readable description of the header."
-                        },
-                        "required": {
-                            "type": "boolean",
-                            "description": "Whether this header is required.",
-                            "default": false
-                        },
-                        "defaultValue": {
-                            "type": "string",
-                            "description": "Default value for the header."
-                        }
-                    },
-                    "additionalProperties": false
-                },
-                "Operation": {
-                    "type": "object",
-                    "required": [
-                        "name"
-                    ],
-                    "properties": {
-                        "name": {
-                            "$ref": "./common.schema.json#/$defs/Identifier"
-                        },
-                        "description": {
-                            "$ref": "./common.schema.json#/$defs/Description"
-                        },
-                        "tags": {
-                            "type": "array",
-                            "description": "Tags for grouping operations.",
-                            "items": {
-                                "$ref": "./common.schema.json#/$defs/Tag"
-                            }
-                        },
-                        "deprecated": {
-                            "type": "boolean",
-                            "description": "Marks the operation as deprecated.",
-                            "default": false
-                        },
-                        "deprecationReason": {
-                            "type": "string",
-                            "description": "Human-readable reason for deprecation."
-                        },
-                        "args": {
-                            "type": "array",
-                            "description": "Arguments for this GraphQL operation.",
-                            "items": {
-                                "$ref": "#/$defs/Argument"
-                            }
-                        },
-                        "returnType": {
-                            "type": "string",
-                            "description": "GraphQL return type (e.g., 'User!', '[User]')."
-                        },
-                        "headers": {
-                            "type": "array",
-                            "description": "HTTP headers relevant for this operation.",
-                            "items": {
-                                "$ref": "#/$defs/Header"
-                            }
-                        },
-                        "security": {
-                            "type": "array",
-                            "description": "Security requirements for this operation. Each item represents an alternative set of named security schemes.",
-                            "items": {
-                                "$ref": "#/$defs/SecurityRequirement"
-                            }
-                        }
-                    },
-                    "additionalProperties": false
-                }
-            },
-            "properties": {
-                "url": {
-                    "type": "string",
-                    "description": "Optional path or URL of the GraphQL endpoint. Recommended: relative path (e.g. '/graphql'). Absolute URLs are allowed only if the service is tightly bound to a single host. If omitted, tooling may assume a framework default (commonly '/graphql')."
-                },
-                "schema": {
-                    "type": "string",
-                    "description": "GraphQL schema SDL as a string. Canonical source of type definitions."
-                },
-                "securitySchemes": {
-                    "type": "object",
-                    "description": "Authentication mechanisms available for this GraphQL surface.",
-                    "additionalProperties": {
-                        "type": "object",
-                        "description": "Security scheme definition (shape is intentionally flexible and may evolve).",
-                        "additionalProperties": true
-                    }
-                },
-                "headers": {
-                    "type": "array",
-                    "description": "HTTP headers commonly used for GraphQL requests.",
-                    "items": {
-                        "$ref": "#/$defs/Header"
-                    }
-                },
-                "queries": {
-                    "type": "array",
-                    "description": "Query operations exposed by the GraphQL API.",
-                    "items": {
-                        "$ref": "#/$defs/Operation"
-                    }
-                },
-                "mutations": {
-                    "type": "array",
-                    "description": "Mutation operations exposed by the GraphQL API.",
-                    "items": {
-                        "$ref": "#/$defs/Operation"
-                    }
-                },
-                "subscriptions": {
-                    "type": "array",
-                    "description": "Subscription operations exposed by the GraphQL API.",
-                    "items": {
-                        "$ref": "#/$defs/Operation"
-                    }
-                }
-            },
-            "additionalProperties": false
-        },
-        {
-            "$schema": "https://json-schema.org/draft/2020-12/schema",
-            "$id": "https://unispec.dev/schema/types/rest.schema.json",
-            "title": "REST API surface",
-            "type": "object",
-            "$defs": {
-                "Route": {
-                    "type": "object",
-                    "required": [
-                        "path",
-                        "method"
-                    ],
-                    "properties": {
-                        "name": {
-                            "$ref": "./common.schema.json#/$defs/Identifier"
-                        },
-                        "summary": {
-                            "type": "string",
-                            "description": "Short, human-readable summary of the route."
-                        },
-                        "tags": {
-                            "type": "array",
-                            "description": "Tags for grouping operations.",
-                            "items": {
-                                "$ref": "./common.schema.json#/$defs/Tag"
-                            }
-                        },
-                        "deprecated": {
-                            "type": "boolean",
-                            "description": "Marks the route as deprecated.",
-                            "default": false
-                        },
-                        "deprecationReason": {
-                            "type": "string",
-                            "description": "Human-readable reason for deprecation."
-                        },
-                        "description": {
-                            "$ref": "./common.schema.json#/$defs/Description"
-                        },
-                        "path": {
-                            "type": "string",
-                            "description": "URL path template, e.g. /users/{id}."
-                        },
-                        "method": {
-                            "type": "string",
-                            "description": "HTTP method in upper-case.",
-                            "enum": [
-                                "GET",
-                                "POST",
-                                "PUT",
-                                "PATCH",
-                                "DELETE"
-                            ]
-                        },
-                        "pathParams": {
-                            "type": "array",
-                            "description": "Path parameters bound from the URL template.",
-                            "items": {
-                                "$ref": "#/$defs/Parameter"
-                            }
-                        },
-                        "queryParams": {
-                            "type": "array",
-                            "description": "Query string parameters.",
-                            "items": {
-                                "$ref": "#/$defs/Parameter"
-                            }
-                        },
-                        "headers": {
-                            "type": "array",
-                            "description": "HTTP headers relevant for this route.",
-                            "items": {
-                                "$ref": "#/$defs/Parameter"
-                            }
-                        },
-                        "requestBody": {
-                            "$ref": "#/$defs/RequestBody"
-                        },
-                        "responses": {
-                            "type": "object",
-                            "description": "HTTP responses keyed by status code (e.g. '200', '404').",
-                            "additionalProperties": {
-                                "$ref": "#/$defs/Response"
-                            }
-                        },
-                        "security": {
-                            "type": "array",
-                            "description": "Security requirements for this route. Each item represents an alternative set of named security schemes.",
-                            "items": {
-                                "$ref": "#/$defs/SecurityRequirement"
-                            }
-                        }
-                    },
-                    "additionalProperties": false
-                },
-                "SecurityRequirement": {
-                    "type": "array",
-                    "description": "Alternative set of named security schemes applied to an operation.",
-                    "items": {
-                        "$ref": "./common.schema.json#/$defs/Identifier"
-                    }
-                },
-                "Parameter": {
-                    "type": "object",
-                    "required": [
-                        "name"
-                    ],
-                    "properties": {
-                        "name": {
-                            "type": "string",
-                            "description": "Parameter name as it appears in the API."
-                        },
-                        "description": {
-                            "$ref": "./common.schema.json#/$defs/Description"
-                        },
-                        "required": {
-                            "type": "boolean",
-                            "description": "Whether this parameter is required.",
-                            "default": false
-                        },
-                        "schemaRef": {
-                            "type": "string",
-                            "description": "Reference to a reusable schema defined in service.schemas. Recommended format: <SchemaName> (where SchemaName is a key in service.schemas). Tools may also accept a JSON Pointer in the form #/service/schemas/<SchemaName>."
-                        }
-                    },
-                    "additionalProperties": false
-                },
-                "MediaType": {
-                    "type": "object",
-                    "properties": {
-                        "schemaRef": {
-                            "type": "string",
-                            "description": "Reference to a reusable schema defined in service.schemas used as the content payload. Recommended format: <SchemaName> (where SchemaName is a key in service.schemas). Tools may also accept a JSON Pointer in the form #/service/schemas/<SchemaName>."
-                        }
-                    },
-                    "additionalProperties": false
-                },
-                "Content": {
-                    "type": "object",
-                    "description": "Content keyed by media type, e.g. 'application/json'.",
-                    "additionalProperties": {
-                        "$ref": "#/$defs/MediaType"
-                    }
-                },
-                "RequestBody": {
-                    "type": "object",
-                    "properties": {
-                        "description": {
-                            "$ref": "./common.schema.json#/$defs/Description"
-                        },
-                        "required": {
-                            "type": "boolean",
-                            "description": "Whether a request body is required.",
-                            "default": false
-                        },
-                        "content": {
-                            "$ref": "#/$defs/Content"
-                        }
-                    },
-                    "additionalProperties": false
-                },
-                "Response": {
-                    "type": "object",
-                    "properties": {
-                        "description": {
-                            "$ref": "./common.schema.json#/$defs/Description"
-                        },
-                        "headers": {
-                            "type": "array",
-                            "description": "HTTP headers returned in this response.",
-                            "items": {
-                                "$ref": "#/$defs/ResponseHeader"
-                            }
-                        },
-                        "content": {
-                            "$ref": "#/$defs/Content"
-                        }
-                    },
-                    "additionalProperties": false
-                },
-                "ResponseHeader": {
-                    "type": "object",
-                    "required": [
-                        "name"
-                    ],
-                    "properties": {
-                        "name": {
-                            "type": "string",
-                            "description": "Header name (case-insensitive)."
-                        },
-                        "description": {
-                            "type": "string",
-                            "description": "Human-readable description of the header."
-                        },
-                        "required": {
-                            "type": "boolean",
-                            "description": "Whether this header is required in the response.",
-                            "default": false
-                        },
-                        "schemaRef": {
-                            "type": "string",
-                            "description": "Reference to a reusable schema for header value validation. Recommended format: <SchemaName> (where SchemaName is a key in service.schemas). Tools may also accept a JSON Pointer in the form #/service/schemas/<SchemaName>."
-                        }
-                    },
-                    "additionalProperties": false
-                }
-            },
-            "properties": {
-                "headers": {
-                    "type": "array",
-                    "description": "HTTP headers commonly used for REST requests.",
-                    "items": {
-                        "$ref": "#/$defs/Parameter"
-                    }
-                },
-                "routes": {
-                    "type": "array",
-                    "description": "List of REST routes exposed by the service.",
-                    "items": {
-                        "$ref": "#/$defs/Route"
-                    }
-                },
-                "securitySchemes": {
-                    "type": "object",
-                    "description": "Authentication mechanisms available for this REST surface.",
-                    "additionalProperties": {
-                        "type": "object",
-                        "description": "Security scheme definition (shape is intentionally flexible and may evolve).",
-                        "additionalProperties": true
-                    }
-                }
-            },
-            "additionalProperties": false
-        },
-        {
-            "$schema": "https://json-schema.org/draft/2020-12/schema",
-            "$id": "https://unispec.dev/schema/types/schemas.schema.json",
-            "title": "Reusable data schemas",
-            "description": "Container for reusable data model definitions (request/response bodies, messages, etc.).",
-            "type": "object",
-            "additionalProperties": {
-                "$ref": "#/$defs/SchemaDefinition"
-            },
-            "$defs": {
-                "SchemaDefinition": {
-                    "type": "object",
-                    "description": "Named reusable data schema definition.",
-                    "properties": {
-                        "description": {
-                            "$ref": "./common.schema.json#/$defs/Description"
-                        },
-                        "deprecated": {
-                            "type": "boolean",
-                            "description": "Marks the schema as deprecated.",
-                            "default": false
-                        },
-                        "deprecationReason": {
-                            "type": "string",
-                            "description": "Human-readable reason for deprecation."
-                        },
-                        "examples": {
-                            "type": "array",
-                            "description": "Example values for this schema.",
-                            "items": {
-                                "description": "Example value (any JSON value)."
-                            }
-                        },
-                        "jsonSchema": {
-                            "type": "object",
-                            "description": "Embedded JSON Schema Draft 2020-12 definition for this type.",
-                            "additionalProperties": true
-                        },
-                        "validation": {
-                            "type": "object",
-                            "description": "Additional validation rules for this schema.",
-                            "properties": {
-                                "strict": {
-                                    "type": "boolean",
-                                    "description": "Whether to apply strict validation.",
-                                    "default": false
-                                },
-                                "additionalProperties": {
-                                    "type": "boolean",
-                                    "description": "Whether additional properties are allowed.",
-                                    "default": true
-                                },
-                                "customValidators": {
-                                    "type": "array",
-                                    "items": {
-                                        "type": "object",
-                                        "properties": {
-                                            "name": {
-                                                "type": "string",
-                                                "description": "Validator name."
-                                            },
-                                            "rule": {
-                                                "type": "string",
-                                                "description": "Validation rule expression."
-                                            },
-                                            "message": {
-                                                "type": "string",
-                                                "description": "Error message for failed validation."
-                                            }
-                                        },
-                                        "required": [
-                                            "name",
-                                            "rule"
-                                        ],
-                                        "additionalProperties": false
-                                    },
-                                    "description": "Custom validation rules."
-                                }
-                            },
-                            "additionalProperties": false
-                        }
-                    },
-                    "required": [
-                        "jsonSchema"
-                    ],
-                    "additionalProperties": false
-                }
-            }
-        },
-        {
-            "$schema": "https://json-schema.org/draft/2020-12/schema",
-            "$id": "https://unispec.dev/schema/types/service.schema.json",
-            "title": "UniSpec Service",
-            "type": "object",
-            "required": [
-                "name"
-            ],
-            "properties": {
-                "name": {
-                    "$ref": "./common.schema.json#/$defs/Identifier"
-                },
-                "description": {
-                    "$ref": "./common.schema.json#/$defs/Description"
-                },
-                "version": {
-                    "$ref": "./common.schema.json#/$defs/Version"
-                },
-                "tags": {
-                    "type": "array",
-                    "description": "Tags for grouping and categorizing the service.",
-                    "items": {
-                        "$ref": "./common.schema.json#/$defs/Tag"
-                    }
-                },
-                "baseUrl": {
-                    "$ref": "./common.schema.json#/$defs/Url",
-                    "description": "Base URL for the service. Used as the default prefix for all protocol endpoints."
-                },
-                "contact": {
-                    "type": "object",
-                    "description": "Contact information for the service.",
-                    "properties": {
-                        "name": {
-                            "type": "string",
-                            "description": "Contact name."
-                        },
-                        "email": {
-                            "$ref": "./common.schema.json#/$defs/Email"
-                        },
-                        "url": {
-                            "$ref": "./common.schema.json#/$defs/Url"
-                        }
-                    },
-                    "additionalProperties": false
-                },
-                "license": {
-                    "type": "object",
-                    "description": "License information for the service.",
-                    "properties": {
-                        "name": {
-                            "type": "string",
-                            "description": "License name."
-                        },
-                        "url": {
-                            "$ref": "./common.schema.json#/$defs/Url"
-                        }
-                    },
-                    "additionalProperties": false
-                },
-                "servers": {
-                    "type": "array",
-                    "description": "Alternative servers where the service is available.",
-                    "items": {
-                        "type": "object",
-                        "properties": {
-                            "url": {
-                                "$ref": "./common.schema.json#/$defs/Url"
-                            },
-                            "description": {
-                                "type": "string",
-                                "description": "Description of the server."
-                            }
-                        },
-                        "additionalProperties": false
-                    }
-                },
-                "protocols": {
-                    "type": "object",
-                    "description": "Protocol-specific API surfaces exposed by this service.",
-                    "properties": {
-                        "rest": {
-                            "$ref": "./rest.schema.json#"
-                        },
-                        "graphql": {
-                            "$ref": "./graphql.schema.json#"
-                        },
-                        "websocket": {
-                            "$ref": "./websocket.schema.json#"
-                        }
-                    },
-                    "additionalProperties": false
-                },
-                "schemas": {
-                    "$ref": "./schemas.schema.json#"
-                },
-                "securitySchemes": {
-                    "type": "object",
-                    "description": "Authentication mechanisms available for this service.",
-                    "additionalProperties": {
-                        "$ref": "./common.schema.json#/$defs/SecurityScheme"
-                    }
-                },
-                "rateLimit": {
-                    "type": "object",
-                    "description": "Rate limiting configuration for the service.",
-                    "properties": {
-                        "requestsPerMinute": {
-                            "type": "integer",
-                            "minimum": 0,
-                            "description": "Maximum requests per minute."
-                        },
-                        "requestsPerHour": {
-                            "type": "integer",
-                            "minimum": 0,
-                            "description": "Maximum requests per hour."
-                        },
-                        "requestsPerDay": {
-                            "type": "integer",
-                            "minimum": 0,
-                            "description": "Maximum requests per day."
-                        },
-                        "burstLimit": {
-                            "type": "integer",
-                            "minimum": 0,
-                            "description": "Maximum burst requests allowed."
-                        },
-                        "perUser": {
-                            "type": "boolean",
-                            "description": "Whether rate limiting is applied per user.",
-                            "default": false
-                        },
-                        "perApiKey": {
-                            "type": "boolean",
-                            "description": "Whether rate limiting is applied per API key.",
-                            "default": false
-                        },
-                        "customKey": {
-                            "type": "string",
-                            "description": "Custom key for rate limiting (e.g., IP address, organization ID)."
-                        }
-                    },
-                    "additionalProperties": false
-                },
-                "compliance": {
-                    "type": "array",
-                    "description": "Compliance frameworks the service adheres to.",
-                    "items": {
-                        "type": "string",
-                        "enum": [
-                            "GDPR",
-                            "SOC2",
-                            "HIPAA",
-                            "PCI-DSS",
-                            "ISO27001",
-                            "CCPA"
-                        ]
-                    }
-                },
-                "dataClassification": {
-                    "type": "string",
-                    "description": "Data classification level for the service.",
-                    "enum": [
-                        "public",
-                        "internal",
-                        "confidential",
-                        "restricted"
-                    ]
-                }
-            },
-            "additionalProperties": false
-        },
-        {
-            "$schema": "https://json-schema.org/draft/2020-12/schema",
-            "$id": "https://unispec.dev/schema/types/websocket.schema.json",
-            "title": "WebSocket API surface",
-            "type": "object",
-            "$defs": {
-                "Message": {
-                    "type": "object",
-                    "required": [
-                        "name"
-                    ],
-                    "properties": {
-                        "name": {
-                            "$ref": "./common.schema.json#/$defs/Identifier"
-                        },
-                        "description": {
-                            "$ref": "./common.schema.json#/$defs/Description"
-                        },
-                        "direction": {
-                            "type": "string",
-                            "description": "Direction of message flow.",
-                            "enum": [
-                                "publish",
-                                "subscribe",
-                                "both"
-                            ],
-                            "default": "both"
-                        },
-                        "deprecated": {
-                            "type": "boolean",
-                            "description": "Marks the message as deprecated.",
-                            "default": false
-                        },
-                        "deprecationReason": {
-                            "type": "string",
-                            "description": "Human-readable reason for deprecation."
-                        },
-                        "schemaRef": {
-                            "type": "string",
-                            "description": "Reference to a reusable schema describing the message payload. Recommended format: <SchemaName> (where SchemaName is a key in service.schemas). Tools may also accept a JSON Pointer in the form #/service/schemas/<SchemaName>."
-                        }
-                    },
-                    "additionalProperties": false
-                },
-                "Header": {
-                    "type": "object",
-                    "required": [
-                        "name"
-                    ],
-                    "properties": {
-                        "name": {
-                            "type": "string",
-                            "description": "Header name (case-insensitive)."
-                        },
-                        "description": {
-                            "type": "string",
-                            "description": "Human-readable description of the header."
-                        },
-                        "required": {
-                            "type": "boolean",
-                            "description": "Whether this header is required.",
-                            "default": false
-                        },
-                        "defaultValue": {
-                            "type": "string",
-                            "description": "Default value for the header."
-                        }
-                    },
-                    "additionalProperties": false
-                },
-                "SecurityRequirement": {
-                    "type": "array",
-                    "description": "Alternative set of named security schemes applied to a WebSocket channel.",
-                    "items": {
-                        "$ref": "./common.schema.json#/$defs/Identifier"
-                    }
-                },
-                "Channel": {
-                    "type": "object",
-                    "required": [
-                        "name"
-                    ],
-                    "properties": {
-                        "name": {
-                            "$ref": "./common.schema.json#/$defs/Identifier"
-                        },
-                        "description": {
-                            "$ref": "./common.schema.json#/$defs/Description"
-                        },
-                        "tags": {
-                            "type": "array",
-                            "description": "Tags for grouping channels.",
-                            "items": {
-                                "$ref": "./common.schema.json#/$defs/Tag"
-                            }
-                        },
-                        "namespace": {
-                            "type": "string",
-                            "description": "Optional namespace for the channel (e.g. 'chat', 'notifications'). Used to group related channels and avoid name collisions."
-                        },
-                        "direction": {
-                            "type": "string",
-                            "description": "Direction of message flow on this channel.",
-                            "enum": [
-                                "publish",
-                                "subscribe",
-                                "both"
-                            ],
-                            "default": "both"
-                        },
-                        "connectionParams": {
-                            "type": "object",
-                            "description": "Parameters required for establishing connection to this channel.",
-                            "additionalProperties": {
-                                "type": "string",
-                                "description": "Connection parameter value."
-                            }
-                        },
-                        "reconnectStrategy": {
-                            "type": "object",
-                            "description": "Reconnection strategy for this channel.",
-                            "properties": {
-                                "maxAttempts": {
-                                    "type": "integer",
-                                    "description": "Maximum number of reconnection attempts.",
-                                    "minimum": 0,
-                                    "default": 5
-                                },
-                                "delay": {
-                                    "type": "integer",
-                                    "description": "Initial delay between reconnection attempts in milliseconds.",
-                                    "minimum": 0,
-                                    "default": 1000
-                                },
-                                "backoffMultiplier": {
-                                    "type": "number",
-                                    "description": "Multiplier for exponential backoff.",
-                                    "minimum": 1,
-                                    "default": 2
-                                }
-                            },
-                            "additionalProperties": false
-                        },
-                        "headers": {
-                            "type": "array",
-                            "description": "HTTP headers commonly used for WebSocket connections on this channel.",
-                            "items": {
-                                "$ref": "#/$defs/Header"
-                            }
-                        },
-                        "messages": {
-                            "type": "array",
-                            "description": "Messages that may be sent or received on this channel.",
-                            "items": {
-                                "$ref": "#/$defs/Message"
-                            }
-                        },
-                        "security": {
-                            "type": "array",
-                            "description": "Security requirements for this channel. Each item represents an alternative set of named security schemes.",
-                            "items": {
-                                "$ref": "#/$defs/SecurityRequirement"
-                            }
-                        }
-                    },
-                    "additionalProperties": false
-                }
-            },
-            "properties": {
-                "headers": {
-                    "type": "array",
-                    "description": "HTTP headers commonly used for WebSocket connections.",
-                    "items": {
-                        "$ref": "#/$defs/Header"
-                    }
-                },
-                "url": {
-                    "type": "string",
-                    "description": "Optional path or URL of the WebSocket endpoint. Recommended: relative path (e.g. '/ws' or '/socket.io' for Socket.IO). Absolute URLs are allowed only if the service is tightly bound to a single host. If omitted, tooling may assume a framework default (commonly '/ws' for WebSocket servers or '/socket.io' for Socket.IO)."
-                },
-                "channels": {
-                    "type": "array",
-                    "description": "WebSocket channels/topics exposed by the service.",
-                    "items": {
-                        "$ref": "#/$defs/Channel"
-                    }
-                },
-                "securitySchemes": {
-                    "type": "object",
-                    "description": "Authentication mechanisms available for this WebSocket surface.",
-                    "additionalProperties": {
-                        "type": "object",
-                        "description": "Security scheme definition (shape is intentionally flexible and may evolve).",
-                        "additionalProperties": true
-                    }
-                }
-            },
-            "additionalProperties": false
-        }
-    ]
-};
-export const SCHEMA_IDS = [
-    "https://unispec.dev/schema/types/common.schema.json",
-    "https://unispec.dev/schema/types/graphql.schema.json",
-    "https://unispec.dev/schema/types/rest.schema.json",
-    "https://unispec.dev/schema/types/schemas.schema.json",
-    "https://unispec.dev/schema/types/service.schema.json",
-    "https://unispec.dev/schema/types/websocket.schema.json"
-];