xiaoxia-saas/packages/ports/template_repository.py

"""Template repository port (Protocol)."""

from __future__ import annotations

from typing import Optional, Protocol

from packages.domain.template import Template, TemplateCategory, TemplateSegment


class TemplateRepositoryPort(Protocol):
    def list_by_user(
        self,
        user_id: str,
        *,
        skip: int = 0,
        limit: int = 50,
        category: Optional[str] = None,
        tag: Optional[str] = None,
        keyword: Optional[str] = None,
        mode: Optional[str] = None,
        valid_only: bool = False,
    ) -> list[Template]: ...
    def get(self, template_id: str, user_id: str) -> Optional[Template]: ...
    def create(self, template: Template) -> Template: ...
    def update(self, template: Template) -> Template: ...
    def delete(self, template_id: str, user_id: str) -> bool: ...
    def count_by_user(
        self,
        user_id: str,
        *,
        category: Optional[str] = None,
        tag: Optional[str] = None,
        keyword: Optional[str] = None,
        mode: Optional[str] = None,
        valid_only: bool = False,
    ) -> int: ...
    def copy_template(self, template_id: str, user_id: str, new_name: str) -> Template: ...
    def list_segments(self, template_id: str) -> list[TemplateSegment]: ...
    def create_segments(self, segments: list[TemplateSegment]) -> list[TemplateSegment]: ...
    def delete_segments_by_template(self, template_id: str) -> int: ...
    def list_categories(self, user_id: str) -> list[TemplateCategory]: ...
    def create_category(self, category: TemplateCategory) -> TemplateCategory: ...
    def get_category(self, category_id: str, user_id: str) -> Optional[TemplateCategory]: ...
    def delete_category(self, category_id: str, user_id: str) -> bool: ...
    def list_tags(self, user_id: str) -> list[str]: ...
    def get_usage_count(self, template_id: str) -> int: ...