Add Postbox message authoring and concurrency

src/govoplan_postbox/backend/schemas.py

@@ -49,6 +49,8 @@ class PostboxDirectoryItem(BaseModel):
     holder_count: int = 0
     vacant: bool = True
     access: PostboxAccessDecisionResponse | None = None
+    resource_revision: int = Field(default=1, ge=1)
+    etag: str | None = None
 
 
 class PostboxDirectoryResponse(BaseModel):
@@ -91,6 +93,8 @@ class PostboxMessageItem(BaseModel):
     producer_module: str | None = None
     producer_resource_type: str | None = None
     producer_resource_id: str | None = None
+    in_reply_to_message_id: str | None = None
+    replaces_message_id: str | None = None
     encryption_profile: str
     key_epoch: int
     ciphertext_ref: str | None = None
@@ -111,6 +115,20 @@ class PostboxMessageStateRequest(BaseModel):
     state: Literal["read", "acknowledged"]
 
 
+class PostboxMessageAuthoringPayload(BaseModel):
+    idempotency_key: str = Field(min_length=1, max_length=255)
+    subject: str = Field(min_length=1, max_length=1000)
+    body_text: str | None = None
+    classification: PostboxClassification = "internal"
+    participants: list[PostboxParticipantPayload] = Field(default_factory=list)
+    attachments: list[PostboxAttachmentPayload] = Field(default_factory=list)
+    metadata: dict[str, Any] = Field(default_factory=dict)
+
+
+class PostboxMessageCreateRequest(PostboxMessageAuthoringPayload):
+    postbox_id: str = Field(min_length=1, max_length=36)
+
+
 class PostboxTargetPayload(BaseModel):
     postbox_id: str | None = Field(default=None, max_length=36)
     address_key: str | None = Field(default=None, max_length=500)
@@ -336,6 +354,10 @@ class PostboxTemplateCreateRequest(PostboxTemplateRevisionPayload):
     description: str | None = None
 
 
+class PostboxTemplateReviseRequest(PostboxTemplateRevisionPayload):
+    base_revision: int = Field(ge=1)
+
+
 class PostboxTemplateRevisionItem(PostboxTemplateRevisionPayload):
     id: str
     revision: int
@@ -354,6 +376,8 @@ class PostboxTemplateItem(BaseModel):
     description: str | None = None
     status: str
     current_revision: int
+    resource_revision: int = Field(ge=1)
+    etag: str
     published_revision_id: str | None = None
     revisions: list[PostboxTemplateRevisionItem] = Field(default_factory=list)
     created_at: datetime
@@ -366,6 +390,11 @@ class PostboxTemplateListResponse(BaseModel):
 
 class PostboxTemplatePublishRequest(BaseModel):
     revision: int | None = Field(default=None, ge=1)
+    base_revision: int = Field(ge=1)
+
+
+class PostboxMutationRequest(BaseModel):
+    base_revision: int = Field(ge=1)
 
 
 class PostboxMaterializeRequest(BaseModel):
@@ -425,8 +454,14 @@ class PostboxGroupingPayload(BaseModel):
     postbox_ids: list[str] = Field(default_factory=list, max_length=250)
 
 
+class PostboxGroupingUpdateRequest(PostboxGroupingPayload):
+    base_revision: int = Field(ge=1)
+
+
 class PostboxGroupingItem(PostboxGroupingPayload):
     id: str
+    resource_revision: int = Field(ge=1)
+    etag: str
     created_at: datetime
     updated_at: datetime