hololinked.metadata.td.interaction_affordance.EventAffordance

class EventAffordance(InteractionAffordance, EventMetadata):
    """
    creates event affordance schema from events.

    [Schema](https://www.w3.org/TR/wot-thing-description11/#eventaffordance) <br>
    [UML Diagram](https://docs.hololinked.dev/UML/PDF/InteractionAffordance.pdf) <br>
    """

    # [Supported Fields]() <br>
    subscription: Optional[str] = None
    data: Optional[JSON] = None

    def __init__(self):
        super().__init__()

    @property
    def what(self):  # noqa: D102
        return ResourceTypes.EVENT

    @property
    def event_unique_identifier(self) -> str:
        """Identifier this event is published under, as `<thing id>/<name>`."""
        return f"{self.thing_id}/{self.name}"

    def build(self) -> None:  # noqa: D102
        event = cast(Event, self.objekt)
        doc = event.__doc__ or event.doc
        if doc:
            title = get_summary(doc)
            description = self.format_doc(doc)
            if title and not description.startswith(title):
                self.title = title
                self.description = description
            else:
                self.description = description
        if event.schema:
            if isinstance(event.schema, dict):
                self.data = event.schema
            elif issubklass(event.schema, (BaseModel, RootModel)):
                self.data = type_to_dataschema(event.schema)
            else:
                raise ValueError(f"unknown schema definition for event data, given type: {type(event.schema)}")

    @classmethod
    def from_descriptor(cls, event: Event, owner: Thing | ThingMeta, **kwargs) -> "EventAffordance":  # noqa: D102
        if not isinstance(event, Event):
            raise TypeError(f"event must be instance of Event, given type {type(event)}")
        affordance = EventAffordance()
        affordance.owner = owner
        affordance.objekt = event
        affordance.build()
        affordance.build_non_compliant_metadata()
        return affordance