leocrm/app/plugins/builtins/entity_links/plugin.py

"""Entity Links plugin — link files to companies/contacts, reverse links, event cleanup."""

from __future__ import annotations

from typing import Any

from app.plugins.base import BasePlugin
from app.plugins.manifest import PluginManifest, PluginRouteDef, FrontendDetailTab


class EntityLinksPlugin(BasePlugin):
    """Entity Links plugin for N:M file-to-entity links with event-driven cleanup."""

    manifest = PluginManifest(
        name="entity_links",
        version="1.0.0",
        display_name="Entity Links",
        description="Link files to companies/contacts (N:M), reverse links, event cleanup on deletion.",
        dependencies=[],
        routes=[
            PluginRouteDef(
                path="/api/v1/entity-links",
                module="app.plugins.builtins.entity_links.routes",
                router_attr="router",
            ),
            PluginRouteDef(
                path="/api/v1/contacts",
                module="app.plugins.builtins.entity_links.routes",
                router_attr="contact_router",
            ),
        ],
        events=["contact.deleted"],
        migrations=["0001_initial.sql", "0002_add_deleted_at.sql"],
        permissions=[
            "entity_links:read",
            "entity_links:write",
            "entity_links:delete",
        ],
        is_core=True,
        detail_tabs=[
            FrontendDetailTab(entity_type='contact', label_key='tabs.links', label='Verknüpfungen', component='@/components/contact/ContactLinksTab', icon='Link', order=60, permission='entity_links:read'),
        ],
    
        author="LeoCRM Team",
        min_app_version="1.0.0",
        contract_version="1.0.0")

    async def on_contact_deleted(self, payload: dict[str, Any]) -> None:
        """Handle contact.deleted event — remove all EntityLink rows for that contact."""
        from sqlalchemy import delete

        from app.core.db import get_session_factory
        from app.plugins.builtins.entity_links.models import EntityLink

        entity_id = payload.get("entity_id") or payload.get("contact_id")
        tenant_id = payload.get("tenant_id")
        if entity_id is None or tenant_id is None:
            return

        import uuid as _uuid

        factory = get_session_factory()
        async with factory() as session:
            await session.execute(
                delete(EntityLink).where(
                    EntityLink.tenant_id == _uuid.UUID(tenant_id),
                    EntityLink.entity_type == "contact",
                    EntityLink.entity_id == _uuid.UUID(str(entity_id)),
                )
            )
            await session.commit()

    async def on_deactivate(
        self, db, service_container, event_bus
    ) -> None:
        """Deactivate plugin: unregister contract and event listeners."""
        # Contract abmelden
        from app.plugins.builtins.contracts import get_contract_registry
        get_contract_registry().unregister(self.manifest.name)
        await super().on_deactivate(db, service_container, event_bus)