leocrm/app/plugins/builtins/marketplace/models.py

"""Marketplace plugin — SQLAlchemy models for marketplace listings."""

from __future__ import annotations

import uuid
from datetime import UTC, datetime

from sqlalchemy import DateTime, Float, Index, Integer, String, Text
from sqlalchemy.dialects.postgresql import JSONB
from sqlalchemy.dialects.postgresql import UUID as PGUUID
from sqlalchemy.orm import Mapped, mapped_column

from app.core.db import Base, TimestampMixin


class MarketplaceListing(Base, TimestampMixin):
    """Marketplace listing for a plugin.

    This table is NOT tenant-scoped — marketplace listings are global.
    """

    __tablename__ = "marketplace_listings"
    __table_args__ = (
        Index("ix_marketplace_listings_name", "name", unique=True),
        Index("ix_marketplace_listings_tags", "tags", postgresql_using="gin"),
        Index("ix_marketplace_listings_is_verified", "is_verified"),
        Index("ix_marketplace_listings_download_count", "download_count"),
    )

    id: Mapped[uuid.UUID] = mapped_column(
        PGUUID(as_uuid=True), primary_key=True, default=uuid.uuid4
    )
    name: Mapped[str] = mapped_column(
        String(80), nullable=False, unique=True, comment="Unique plugin identifier (snake_case)"
    )
    display_name: Mapped[str] = mapped_column(
        String(120), nullable=False, comment="Human-readable plugin name"
    )
    description: Mapped[str] = mapped_column(
        Text, nullable=False, default="", comment="Plugin description"
    )
    version: Mapped[str] = mapped_column(
        String(40), nullable=False, comment="Latest available version (SemVer)"
    )
    author: Mapped[str] = mapped_column(
        String(200), nullable=False, default="", comment="Plugin author name"
    )
    homepage: Mapped[str] = mapped_column(
        String(500), nullable=False, default="", comment="Plugin homepage URL"
    )
    download_url: Mapped[str] = mapped_column(
        String(1024), nullable=False, comment="URL to download the plugin ZIP"
    )
    signature_public_key: Mapped[str] = mapped_column(
        Text, nullable=False, default="", comment="Ed25519 public key for signature verification"
    )
    icon: Mapped[str] = mapped_column(
        String(500), nullable=False, default="", comment="Icon URL or emoji"
    )
    screenshots: Mapped[list] = mapped_column(
        JSONB, nullable=False, default=list, comment="List of screenshot URLs"
    )
    tags: Mapped[list] = mapped_column(
        JSONB, nullable=False, default=list, comment="List of category tags"
    )
    price: Mapped[float] = mapped_column(
        Float, nullable=False, default=0.0, comment="Price in EUR (0 = free)"
    )
    is_verified: Mapped[bool] = mapped_column(
        nullable=False, default=False, comment="Whether the plugin is verified by LeoCRM"
    )
    download_count: Mapped[int] = mapped_column(
        Integer, nullable=False, default=0, comment="Number of downloads"
    )
    min_app_version: Mapped[str] = mapped_column(
        String(40), nullable=False, default="0.0.0", comment="Minimum LeoCRM version required"
    )
    license: Mapped[str] = mapped_column(
        String(50), nullable=False, default="MIT", comment="License identifier"
    )
    updated_at: Mapped[datetime] = mapped_column(
        DateTime(timezone=True),
        nullable=False,
        default=lambda: datetime.now(UTC),
        onupdate=lambda: datetime.now(UTC),
    )