events/nostr_hooks.py

"""Helpers that bridge event-mutation handlers to the Nostr publisher.

Lives in its own module so both `events_api_router` and any future router
can call it without importing through `views_api`, which would create an
import cycle (views_api -> nostr_hooks -> nostr_publisher -> models).
"""

from loguru import logger

from .crud import update_event
from .models import Event
from .nostr_publisher import publish_event_to_nostr


async def publish_or_delete_nostr_event(event: Event, *, delete: bool = False) -> None:
    """Publish or delete the NIP-52 calendar event for `event`.

    Resolves a `NostrSigner` for the wallet owner — backend-agnostic
    (LocalSigner / RemoteBunkerSigner / ClientSideOnlySigner). The
    signer abstraction handles the actual key material; this hook
    only needs `signer.pubkey` for event construction and
    `await signer.sign_event(...)` for signing. Failures are logged
    and swallowed so a Nostr outage doesn't break the HTTP flow that
    triggered the publish.
    """
    try:
        from lnbits.core.signers import resolve_for_wallet

        from . import nostr_client

        signer = await resolve_for_wallet(event.wallet)
        if signer is None:
            # Wallet missing, account missing, unclassified row, or
            # ClientSideOnlySigner account (server can't sign for them).
            # Soft-fail: skip the publish silently. The user can still
            # publish kind-31922/31923 events client-side once we have
            # that path.
            return

        nostr_event = await publish_event_to_nostr(
            nostr_client, event, signer, delete=delete
        )
        if nostr_event and not delete:
            event.nostr_event_id = nostr_event.id
            event.nostr_event_created_at = nostr_event.created_at
            await update_event(event)
    except Exception as exc:
        logger.warning(f"[EVENTS] Nostr publish failed: {exc}")