Domain Event Webhook

{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "https://contracts.minicenter.dev/events/0.2.0/domain-event.schema.json",
    "title": "Domain Event Webhook",
    "description": "Canonical envelope delivered to MiniCenter webhook consumers.",
    "x-documentation": true,
    "x-domain": "events-webhooks",
    "x-reference-id": "domain-event-envelope",
    "x-stability": "stable",
    "x-delivery": "at-least-once",
    "type": "object",
    "required": [
        "id",
        "type",
        "schema_version",
        "occurred_at",
        "published_at",
        "stream_id",
        "sequence",
        "correlation_id",
        "data"
    ],
    "properties": {
        "id": {
            "type": "string",
            "format": "uuid"
        },
        "type": {
            "type": "string",
            "minLength": 1
        },
        "schema_version": {
            "type": "integer",
            "minimum": 1
        },
        "occurred_at": {
            "type": "string",
            "format": "date-time"
        },
        "published_at": {
            "type": "string",
            "format": "date-time"
        },
        "stream_id": {
            "type": [
                "string",
                "null"
            ],
            "minLength": 1
        },
        "sequence": {
            "type": [
                "integer",
                "null"
            ],
            "minimum": 1
        },
        "correlation_id": {
            "type": "string",
            "format": "uuid"
        },
        "data": {
            "type": "object"
        }
    },
    "allOf": [
        {
            "if": {
                "properties": {
                    "stream_id": {
                        "type": "null"
                    }
                }
            },
            "then": {
                "properties": {
                    "sequence": {
                        "type": "null"
                    }
                }
            },
            "else": {
                "properties": {
                    "sequence": {
                        "type": "integer"
                    }
                }
            }
        }
    ],
    "example": {
        "id": "10000000-0000-4000-8000-000000000001",
        "type": "files.object.available",
        "schema_version": 1,
        "occurred_at": "2026-07-30T09:00:00Z",
        "published_at": "2026-07-30T09:00:01Z",
        "stream_id": "file-object-42",
        "sequence": 1,
        "correlation_id": "20000000-0000-4000-8000-000000000002",
        "data": {
            "object_id": "42"
        }
    }
}

{
    "id": "10000000-0000-4000-8000-000000000001",
    "type": "files.object.available",
    "schema_version": 1,
    "occurred_at": "2026-07-30T09:00:00Z",
    "published_at": "2026-07-30T09:00:01Z",
    "stream_id": "file-object-42",
    "sequence": 1,
    "correlation_id": "20000000-0000-4000-8000-000000000002",
    "data": {
        "object_id": "42"
    }
}