timeline and readme

schema/models/__init__.py

@@ -5,6 +5,7 @@ This module exports all dataclasses, enums, and constants that the generator
 should process. Add new models here to have them included in generation.
 """
 
+from .api import CreateJobRequest, SystemStatus
 from .grpc import (
     GRPC_SERVICE,
     CancelRequest,
@@ -23,6 +24,10 @@ from .presets import BUILTIN_PRESETS, TranscodePreset
 # Core domain models - generates Django, Pydantic, TypeScript
 DATACLASSES = [MediaAsset, TranscodePreset, TranscodeJob]
 
+# API request/response models - generates TypeScript only (no Django)
+# WorkerStatus from grpc.py is reused here
+API_MODELS = [CreateJobRequest, SystemStatus, WorkerStatus]
+
 # Status enums - included in generated code
 ENUMS = [AssetStatus, JobStatus]
 
@@ -43,6 +48,9 @@ __all__ = [
     "MediaAsset",
     "TranscodePreset",
     "TranscodeJob",
+    # API Models
+    "CreateJobRequest",
+    "SystemStatus",
     # Enums
     "AssetStatus",
     "JobStatus",
@@ -58,6 +66,7 @@ __all__ = [
     "Empty",
     # For generator
     "DATACLASSES",
+    "API_MODELS",
     "ENUMS",
     "GRPC_MESSAGES",
     "BUILTIN_PRESETS",

schema/models/api.py

@@ -0,0 +1,32 @@
+"""
+API Request/Response Schema Definitions
+
+These are separate from the main domain models and represent
+the shape of data sent to/from the API endpoints.
+"""
+
+from dataclasses import dataclass
+from typing import Optional
+from uuid import UUID
+
+
+@dataclass
+class CreateJobRequest:
+    """Request body for creating a transcode/trim job."""
+
+    source_asset_id: UUID
+    preset_id: Optional[UUID] = None
+    trim_start: Optional[float] = None  # seconds
+    trim_end: Optional[float] = None  # seconds
+    output_filename: Optional[str] = None
+
+
+@dataclass
+class SystemStatus:
+    """System status response."""
+
+    status: str
+    version: str
+
+
+# Note: WorkerStatus is defined in grpc.py and reused here