orion/app/api/v1/vendor/content_pages.py

# app/api/v1/vendor/content_pages.py
"""
Vendor Content Pages API

Vendors can:
- View their content pages (includes platform defaults)
- Create/edit/delete their own content page overrides
- Preview pages before publishing
"""

import logging
from typing import List, Optional
from fastapi import APIRouter, Depends, HTTPException, Query
from pydantic import BaseModel, Field
from sqlalchemy.orm import Session

from app.api.deps import get_current_vendor_api, get_db
from app.services.content_page_service import content_page_service
from models.database.user import User

router = APIRouter()
logger = logging.getLogger(__name__)


# ============================================================================
# REQUEST/RESPONSE SCHEMAS
# ============================================================================

class VendorContentPageCreate(BaseModel):
    """Schema for creating a vendor content page."""
    slug: str = Field(..., max_length=100, description="URL-safe identifier (about, faq, contact, etc.)")
    title: str = Field(..., max_length=200, description="Page title")
    content: str = Field(..., description="HTML or Markdown content")
    content_format: str = Field(default="html", description="Content format: html or markdown")
    meta_description: Optional[str] = Field(None, max_length=300, description="SEO meta description")
    meta_keywords: Optional[str] = Field(None, max_length=300, description="SEO keywords")
    is_published: bool = Field(default=False, description="Publish immediately")
    show_in_footer: bool = Field(default=True, description="Show in footer navigation")
    show_in_header: bool = Field(default=False, description="Show in header navigation")
    display_order: int = Field(default=0, description="Display order (lower = first)")


class VendorContentPageUpdate(BaseModel):
    """Schema for updating a vendor content page."""
    title: Optional[str] = Field(None, max_length=200)
    content: Optional[str] = None
    content_format: Optional[str] = None
    meta_description: Optional[str] = Field(None, max_length=300)
    meta_keywords: Optional[str] = Field(None, max_length=300)
    is_published: Optional[bool] = None
    show_in_footer: Optional[bool] = None
    show_in_header: Optional[bool] = None
    display_order: Optional[int] = None


class ContentPageResponse(BaseModel):
    """Schema for content page response."""
    id: int
    vendor_id: Optional[int]
    vendor_name: Optional[str]
    slug: str
    title: str
    content: str
    content_format: str
    meta_description: Optional[str]
    meta_keywords: Optional[str]
    is_published: bool
    published_at: Optional[str]
    display_order: int
    show_in_footer: bool
    show_in_header: bool
    is_platform_default: bool
    is_vendor_override: bool
    created_at: str
    updated_at: str
    created_by: Optional[int]
    updated_by: Optional[int]


# ============================================================================
# VENDOR CONTENT PAGES
# ============================================================================

@router.get("/", response_model=List[ContentPageResponse])
def list_vendor_pages(
    include_unpublished: bool = Query(False, description="Include draft pages"),
    current_user: User = Depends(get_current_vendor_api),
    db: Session = Depends(get_db)
):
    """
    List all content pages available for this vendor.

    Returns vendor-specific overrides + platform defaults (vendor overrides take precedence).
    """
    if not current_user.vendor_id:
        raise HTTPException(status_code=403, detail="User is not associated with a vendor")

    pages = content_page_service.list_pages_for_vendor(
        db,
        vendor_id=current_user.vendor_id,
        include_unpublished=include_unpublished
    )

    return [page.to_dict() for page in pages]


@router.get("/overrides", response_model=List[ContentPageResponse])
def list_vendor_overrides(
    include_unpublished: bool = Query(False, description="Include draft pages"),
    current_user: User = Depends(get_current_vendor_api),
    db: Session = Depends(get_db)
):
    """
    List only vendor-specific content pages (no platform defaults).

    Shows what the vendor has customized.
    """
    if not current_user.vendor_id:
        raise HTTPException(status_code=403, detail="User is not associated with a vendor")

    pages = content_page_service.list_all_vendor_pages(
        db,
        vendor_id=current_user.vendor_id,
        include_unpublished=include_unpublished
    )

    return [page.to_dict() for page in pages]


@router.get("/{slug}", response_model=ContentPageResponse)
def get_page(
    slug: str,
    include_unpublished: bool = Query(False, description="Include draft pages"),
    current_user: User = Depends(get_current_vendor_api),
    db: Session = Depends(get_db)
):
    """
    Get a specific content page by slug.

    Returns vendor override if exists, otherwise platform default.
    """
    if not current_user.vendor_id:
        raise HTTPException(status_code=403, detail="User is not associated with a vendor")

    page = content_page_service.get_page_for_vendor(
        db,
        slug=slug,
        vendor_id=current_user.vendor_id,
        include_unpublished=include_unpublished
    )

    if not page:
        raise HTTPException(status_code=404, detail=f"Content page not found: {slug}")

    return page.to_dict()


@router.post("/", response_model=ContentPageResponse, status_code=201)
def create_vendor_page(
    page_data: VendorContentPageCreate,
    current_user: User = Depends(get_current_vendor_api),
    db: Session = Depends(get_db)
):
    """
    Create a vendor-specific content page override.

    This will be shown instead of the platform default for this vendor.
    """
    if not current_user.vendor_id:
        raise HTTPException(status_code=403, detail="User is not associated with a vendor")

    page = content_page_service.create_page(
        db,
        slug=page_data.slug,
        title=page_data.title,
        content=page_data.content,
        vendor_id=current_user.vendor_id,
        content_format=page_data.content_format,
        meta_description=page_data.meta_description,
        meta_keywords=page_data.meta_keywords,
        is_published=page_data.is_published,
        show_in_footer=page_data.show_in_footer,
        show_in_header=page_data.show_in_header,
        display_order=page_data.display_order,
        created_by=current_user.id
    )

    return page.to_dict()


@router.put("/{page_id}", response_model=ContentPageResponse)
def update_vendor_page(
    page_id: int,
    page_data: VendorContentPageUpdate,
    current_user: User = Depends(get_current_vendor_api),
    db: Session = Depends(get_db)
):
    """
    Update a vendor-specific content page.

    Can only update pages owned by this vendor.
    """
    if not current_user.vendor_id:
        raise HTTPException(status_code=403, detail="User is not associated with a vendor")

    # Verify ownership
    existing_page = content_page_service.get_page_by_id(db, page_id)
    if not existing_page:
        raise HTTPException(status_code=404, detail="Content page not found")

    if existing_page.vendor_id != current_user.vendor_id:
        raise HTTPException(status_code=403, detail="Cannot edit pages from other vendors")

    # Update
    page = content_page_service.update_page(
        db,
        page_id=page_id,
        title=page_data.title,
        content=page_data.content,
        content_format=page_data.content_format,
        meta_description=page_data.meta_description,
        meta_keywords=page_data.meta_keywords,
        is_published=page_data.is_published,
        show_in_footer=page_data.show_in_footer,
        show_in_header=page_data.show_in_header,
        display_order=page_data.display_order,
        updated_by=current_user.id
    )

    return page.to_dict()


@router.delete("/{page_id}", status_code=204)
def delete_vendor_page(
    page_id: int,
    current_user: User = Depends(get_current_vendor_api),
    db: Session = Depends(get_db)
):
    """
    Delete a vendor-specific content page.

    Can only delete pages owned by this vendor.
    After deletion, platform default will be shown (if exists).
    """
    if not current_user.vendor_id:
        raise HTTPException(status_code=403, detail="User is not associated with a vendor")

    # Verify ownership
    existing_page = content_page_service.get_page_by_id(db, page_id)
    if not existing_page:
        raise HTTPException(status_code=404, detail="Content page not found")

    if existing_page.vendor_id != current_user.vendor_id:
        raise HTTPException(status_code=403, detail="Cannot delete pages from other vendors")

    # Delete
    content_page_service.delete_page(db, page_id)

    return None