wr-common-lib 0.1.0__tar.gz

wr_common_lib-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+dist/
+build/
+*.egg-info/
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/

wr_common_lib-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wr-common-lib contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

wr_common_lib-0.1.0/PKG-INFO

@@ -0,0 +1,180 @@
+Metadata-Version: 2.4
+Name: wr-common-lib
+Version: 0.1.0
+Summary: 气象导航公用库：领域枚举与共享数据访问
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Provides-Extra: db
+Requires-Dist: async-db-tools>=0.1.0; extra == 'db'
+Description-Content-Type: text/markdown
+
+# wr-common-lib
+
+气象导航各微服务共用的 Python 库：领域枚举、任务类型、以及已定表的共享数据访问（`EmailDbOper` 等）。
+
+| 概念 | 名称 |
+|------|------|
+| PyPI / pip 包名 | `wr-common-lib` |
+| import 包名 | `wr_common_lib` |
+| 本仓库目录 | `common-lib/` |
+
+要求 **Python ≥ 3.12**。
+
+## 目录结构
+
+```
+common-lib/
+├── LICENSE
+├── pyproject.toml
+├── README.md
+└── src/wr_common_lib/
+    ├── __init__.py          # __version__
+    └── email/               # email 表相关
+        ├── constants.py     # MailFlow, MailStatus（对齐 PG 枚举）
+        ├── types.py         # OutboundTask, InboundTask
+        └── db_oper.py       # EmailDbOper（需 [db] 可选依赖）
+```
+
+后续新业务域可在 `wr_common_lib/` 下增加子包（例如 `voyage/`），与 `email/` 平级。
+
+## 安装
+
+### 仅枚举 / 类型（无数据库依赖）
+
+```bash
+pip install wr-common-lib
+# 或 monorepo 本地
+pip install -e /path/to/common-lib
+```
+
+### 含 `EmailDbOper`（依赖 async-db-tools）
+
+```bash
+pip install "wr-common-lib[db]"
+```
+
+### monorepo 本地联调（推荐）
+
+在 `publish` 仓库内，先装数据库工具包，再装本库：
+
+```bash
+pip install -e ../dbtools
+pip install -e ".[db]"
+```
+
+若业务项目的 `pyproject.toml` 使用 path 依赖，示例：
+
+```toml
+dependencies = [
+    "wr-common-lib[db] @ file:///${PROJECT_ROOT}/../common-lib",
+    "async-db-tools @ file:///${PROJECT_ROOT}/../dbtools",
+]
+```
+
+（路径按你本机 monorepo 布局调整；也可用 `uv` / `poetry` 的 path / workspace 写法。）
+
+## 使用
+
+### 邮件枚举
+
+与 PostgreSQL `mail_flow`、`mail_status` 枚举值一致，可直接 `.value` 写入 SQL 或 ORM。
+
+```python
+from wr_common_lib.email import MailFlow, MailStatus
+
+MailFlow.OUTBOUND          # "OUTBOUND"
+MailStatus.QUEUED.value      # "QUEUED"
+
+if MailStatus.SENT.is_terminal:
+    ...
+if MailStatus.PENDING.is_outbound_lifecycle:
+    ...
+```
+
+### 任务类型（TypedDict）
+
+出站、入站字段名不同，用类型区分，避免 `dict` 混用 `to` / `mail_to`：
+
+```python
+from wr_common_lib.email import OutboundTask, InboundTask
+
+task: OutboundTask = {
+    "imo": 1234567,
+    "voyage_id": "...",
+    "mail_from": "noreply@example.com",
+    "to": "ship@example.com",
+    "content_hash": "abc...",
+}
+```
+
+### 共享表操作 `EmailDbOper`
+
+需已安装 `[db]`，并注入各服务自己的 `PostgresPool`：
+
+```python
+from async_db_tools import PostgresPool
+from wr_common_lib.email import EmailDbOper, MailStatus
+
+db_oper = EmailDbOper(pool)
+
+email_id = await db_oper.mark_queued(task)
+await db_oper.mark_sent(email_id)
+await db_oper.mark_failed(email_id)
+
+row = await db_oper.find_by_content_hash("...")
+email_id = await db_oper.insert_inbound_received(inbound_task, content_hash)
+await db_oper.mark_parsed(email_id, {"key": "value"})
+```
+
+`EmailDbOper` 在 `wr_common_lib.email` 中为**懒加载**：只 `import MailStatus` 时不会要求安装 `async-db-tools`；只有 `import EmailDbOper` 时才加载 `db_oper` 模块。
+
+### 邮件状态（约定）
+
+```
+出站 · 发送服务:  PENDING → QUEUED → SENT | FAILED
+出站 · Webhook:   SENT → DELIVERED | BOUNCED | DEFERRED
+入站 · 收件服务:  RECEIVED → PARSED | PARSE_FAILED
+```
+
+## 依赖说明
+
+| 安装方式 | 引入的依赖 |
+|----------|------------|
+| `wr-common-lib` | 无 |
+| `wr-common-lib[db]` | `async-db-tools`（PostgreSQL 连接池） |
+
+业务服务仍需自行配置数据库连接；本库只封装对 `email` 表的 SQL。
+
+## 开发与发布
+
+```bash
+# 可编辑安装（monorepo 内先装 dbtools）
+uv pip install -e ../dbtools
+uv pip install -e ".[db]"
+
+# 发版前改版本（可选）
+uv version 0.1.1
+
+# 构建并发布到 PyPI（推荐）
+export UV_PUBLISH_TOKEN=pypi-xxxxxxxx   # PyPI → Account → API tokens
+uv build
+uv publish
+
+# 或一步：构建产物在 dist/ 后上传
+# uv build && uv publish
+```
+
+`uv publish` 会读取 `dist/` 里的 wheel/sdist 并上传；失败重试同一命令即可（PyPI 会忽略已存在的相同文件）。
+
+也可用传统方式：`python -m build` + `twine upload dist/*`。
+
+表结构变更时，在 `src/wr_common_lib/email/db_oper.py` 中扩展方法即可；各服务将 `app.email.*` 的引用改为 `wr_common_lib.email` 后统一升级版本。
+
+## 版本
+
+当前版本见 `wr_common_lib.__version__` 与 `pyproject.toml` 中的 `[project].version`。
+
+## 许可证
+
+MIT，见 [LICENSE](LICENSE)。

wr_common_lib-0.1.0/README.md

@@ -0,0 +1,169 @@
+# wr-common-lib
+
+气象导航各微服务共用的 Python 库：领域枚举、任务类型、以及已定表的共享数据访问（`EmailDbOper` 等）。
+
+| 概念 | 名称 |
+|------|------|
+| PyPI / pip 包名 | `wr-common-lib` |
+| import 包名 | `wr_common_lib` |
+| 本仓库目录 | `common-lib/` |
+
+要求 **Python ≥ 3.12**。
+
+## 目录结构
+
+```
+common-lib/
+├── LICENSE
+├── pyproject.toml
+├── README.md
+└── src/wr_common_lib/
+    ├── __init__.py          # __version__
+    └── email/               # email 表相关
+        ├── constants.py     # MailFlow, MailStatus（对齐 PG 枚举）
+        ├── types.py         # OutboundTask, InboundTask
+        └── db_oper.py       # EmailDbOper（需 [db] 可选依赖）
+```
+
+后续新业务域可在 `wr_common_lib/` 下增加子包（例如 `voyage/`），与 `email/` 平级。
+
+## 安装
+
+### 仅枚举 / 类型（无数据库依赖）
+
+```bash
+pip install wr-common-lib
+# 或 monorepo 本地
+pip install -e /path/to/common-lib
+```
+
+### 含 `EmailDbOper`（依赖 async-db-tools）
+
+```bash
+pip install "wr-common-lib[db]"
+```
+
+### monorepo 本地联调（推荐）
+
+在 `publish` 仓库内，先装数据库工具包，再装本库：
+
+```bash
+pip install -e ../dbtools
+pip install -e ".[db]"
+```
+
+若业务项目的 `pyproject.toml` 使用 path 依赖，示例：
+
+```toml
+dependencies = [
+    "wr-common-lib[db] @ file:///${PROJECT_ROOT}/../common-lib",
+    "async-db-tools @ file:///${PROJECT_ROOT}/../dbtools",
+]
+```
+
+（路径按你本机 monorepo 布局调整；也可用 `uv` / `poetry` 的 path / workspace 写法。）
+
+## 使用
+
+### 邮件枚举
+
+与 PostgreSQL `mail_flow`、`mail_status` 枚举值一致，可直接 `.value` 写入 SQL 或 ORM。
+
+```python
+from wr_common_lib.email import MailFlow, MailStatus
+
+MailFlow.OUTBOUND          # "OUTBOUND"
+MailStatus.QUEUED.value      # "QUEUED"
+
+if MailStatus.SENT.is_terminal:
+    ...
+if MailStatus.PENDING.is_outbound_lifecycle:
+    ...
+```
+
+### 任务类型（TypedDict）
+
+出站、入站字段名不同，用类型区分，避免 `dict` 混用 `to` / `mail_to`：
+
+```python
+from wr_common_lib.email import OutboundTask, InboundTask
+
+task: OutboundTask = {
+    "imo": 1234567,
+    "voyage_id": "...",
+    "mail_from": "noreply@example.com",
+    "to": "ship@example.com",
+    "content_hash": "abc...",
+}
+```
+
+### 共享表操作 `EmailDbOper`
+
+需已安装 `[db]`，并注入各服务自己的 `PostgresPool`：
+
+```python
+from async_db_tools import PostgresPool
+from wr_common_lib.email import EmailDbOper, MailStatus
+
+db_oper = EmailDbOper(pool)
+
+email_id = await db_oper.mark_queued(task)
+await db_oper.mark_sent(email_id)
+await db_oper.mark_failed(email_id)
+
+row = await db_oper.find_by_content_hash("...")
+email_id = await db_oper.insert_inbound_received(inbound_task, content_hash)
+await db_oper.mark_parsed(email_id, {"key": "value"})
+```
+
+`EmailDbOper` 在 `wr_common_lib.email` 中为**懒加载**：只 `import MailStatus` 时不会要求安装 `async-db-tools`；只有 `import EmailDbOper` 时才加载 `db_oper` 模块。
+
+### 邮件状态（约定）
+
+```
+出站 · 发送服务:  PENDING → QUEUED → SENT | FAILED
+出站 · Webhook:   SENT → DELIVERED | BOUNCED | DEFERRED
+入站 · 收件服务:  RECEIVED → PARSED | PARSE_FAILED
+```
+
+## 依赖说明
+
+| 安装方式 | 引入的依赖 |
+|----------|------------|
+| `wr-common-lib` | 无 |
+| `wr-common-lib[db]` | `async-db-tools`（PostgreSQL 连接池） |
+
+业务服务仍需自行配置数据库连接；本库只封装对 `email` 表的 SQL。
+
+## 开发与发布
+
+```bash
+# 可编辑安装（monorepo 内先装 dbtools）
+uv pip install -e ../dbtools
+uv pip install -e ".[db]"
+
+# 发版前改版本（可选）
+uv version 0.1.1
+
+# 构建并发布到 PyPI（推荐）
+export UV_PUBLISH_TOKEN=pypi-xxxxxxxx   # PyPI → Account → API tokens
+uv build
+uv publish
+
+# 或一步：构建产物在 dist/ 后上传
+# uv build && uv publish
+```
+
+`uv publish` 会读取 `dist/` 里的 wheel/sdist 并上传；失败重试同一命令即可（PyPI 会忽略已存在的相同文件）。
+
+也可用传统方式：`python -m build` + `twine upload dist/*`。
+
+表结构变更时，在 `src/wr_common_lib/email/db_oper.py` 中扩展方法即可；各服务将 `app.email.*` 的引用改为 `wr_common_lib.email` 后统一升级版本。
+
+## 版本
+
+当前版本见 `wr_common_lib.__version__` 与 `pyproject.toml` 中的 `[project].version`。
+
+## 许可证
+
+MIT，见 [LICENSE](LICENSE)。

wr_common_lib-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "wr-common-lib"
+version = "0.1.0"
+description = "气象导航公用库：领域枚举与共享数据访问"
+readme = "README.md"
+requires-python = ">=3.12"
+license = { text = "MIT" }
+dependencies = []
+
+[project.optional-dependencies]
+db = ["async-db-tools>=0.1.0"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/wr_common_lib"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/README.md",
+    "/LICENSE",
+    "/pyproject.toml",
+]

wr_common_lib-0.1.0/src/wr_common_lib/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

wr_common_lib-0.1.0/src/wr_common_lib/email/__init__.py

@@ -0,0 +1,18 @@
+from wr_common_lib.email.constants import MailFlow, MailStatus
+from wr_common_lib.email.types import InboundTask, OutboundTask
+
+__all__ = [
+    "EmailDbOper",
+    "InboundTask",
+    "MailFlow",
+    "MailStatus",
+    "OutboundTask",
+]
+
+
+def __getattr__(name: str):
+    if name == "EmailDbOper":
+        from wr_common_lib.email.db_oper import EmailDbOper
+
+        return EmailDbOper
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

wr_common_lib-0.1.0/src/wr_common_lib/email/constants.py

@@ -0,0 +1,63 @@
+from enum import StrEnum
+
+
+class MailFlow(StrEnum):
+    """邮件流向，对应 PostgreSQL mail_flow 枚举。"""
+
+    INBOUND = "INBOUND"    # 入站：船舶发来的午报
+    OUTBOUND = "OUTBOUND"  # 出站：系统发送的邮件
+
+
+class MailStatus(StrEnum):
+    """邮件状态，对应 PostgreSQL mail_status 枚举。
+
+    出站 · 本发送服务: PENDING → QUEUED → SENT | FAILED
+    出站 · FastAPI 回调: DELIVERED | BOUNCED | DEFERRED
+    入站 · 收件服务:     RECEIVED → PARSED | PARSE_FAILED
+    """
+
+    # 出站 · 本发送服务
+    PENDING = "PENDING"    # 待发（API 创建）
+    QUEUED = "QUEUED"      # 已入队，消费中
+    SENT = "SENT"          # 已提交邮件服务商
+    FAILED = "FAILED"      # 本服务发送失败
+
+    # 出站 · FastAPI 回调（webhook）
+    DELIVERED = "DELIVERED"  # 已送达
+    BOUNCED = "BOUNCED"      # 拒收 / 无效邮箱
+    DEFERRED = "DEFERRED"    # 临时失败，可重试
+
+    # 入站 · 收件服务（后续实现）
+    RECEIVED = "RECEIVED"          # 已接收
+    PARSED = "PARSED"              # 已解析
+    PARSE_FAILED = "PARSE_FAILED"  # 解析失败
+
+    @property
+    def is_terminal(self) -> bool:
+        """是否已进入终态（不再由本状态机主动推进）。"""
+        return self in _TERMINAL_STATUSES
+
+    @property
+    def is_outbound_lifecycle(self) -> bool:
+        """是否属于出站邮件生命周期内的状态。"""
+        return self in _OUTBOUND_STATUSES
+
+
+_TERMINAL_STATUSES = frozenset({
+    MailStatus.SENT,
+    MailStatus.FAILED,
+    MailStatus.DELIVERED,
+    MailStatus.BOUNCED,
+    MailStatus.PARSED,
+    MailStatus.PARSE_FAILED,
+})
+
+_OUTBOUND_STATUSES = frozenset({
+    MailStatus.PENDING,
+    MailStatus.QUEUED,
+    MailStatus.SENT,
+    MailStatus.FAILED,
+    MailStatus.DELIVERED,
+    MailStatus.BOUNCED,
+    MailStatus.DEFERRED,
+})

wr_common_lib-0.1.0/src/wr_common_lib/email/db_oper.py

@@ -0,0 +1,218 @@
+import json
+from typing import Any
+from uuid import UUID
+
+from async_db_tools import PostgresPool
+
+from wr_common_lib.email.constants import MailFlow, MailStatus
+from wr_common_lib.email.types import InboundTask, OutboundTask
+
+
+class EmailDbOper:
+    """email 表共享读写；各服务注入 PostgresPool 后使用。"""
+
+    def __init__(self, db: PostgresPool):
+        self._db = db
+
+    async def mark_queued(self, task: OutboundTask) -> UUID:
+        """开始发送：已有记录则更新为 QUEUED，否则插入出站记录。"""
+        email_id = task.get("id")
+        if email_id:
+            return await self._update_status(self._as_uuid(email_id), MailStatus.QUEUED)
+
+        existing_id = await self._find_id_by_content_hash(task.get("content_hash"))
+        if existing_id:
+            return await self._update_status(existing_id, MailStatus.QUEUED)
+
+        return await self._insert_outbound(task, MailStatus.QUEUED)
+
+    async def mark_sent(self, email_id: UUID) -> None:
+        await self._update_status(email_id, MailStatus.SENT)
+
+    async def mark_failed(self, email_id: UUID) -> None:
+        await self._update_status(email_id, MailStatus.FAILED)
+
+    async def find_by_content_hash(self, content_hash: str) -> dict[str, Any] | None:
+        row = await self._db.fetchrow(
+            """
+            SELECT id, mail_status, mail_flow
+            FROM email
+            WHERE content_hash = $1
+            """,
+            content_hash,
+        )
+        return dict(row) if row else None
+
+    async def insert_inbound_received(self, task: InboundTask, content_hash: str) -> UUID:
+        """写入入站记录，状态 RECEIVED。"""
+        return await self._insert_inbound(task, content_hash, MailStatus.RECEIVED)
+
+    async def mark_parsed(self, email_id: UUID, parsed_data: dict[str, Any]) -> None:
+        await self._db.execute(
+            """
+            UPDATE email
+            SET mail_status = $2::mail_status,
+                parsed_data = $3::jsonb,
+                updated_at = now()
+            WHERE id = $1
+            """,
+            email_id,
+            MailStatus.PARSED.value,
+            json.dumps(parsed_data),
+        )
+
+    async def mark_parse_failed(
+        self,
+        email_id: UUID,
+        parsed_data: dict[str, Any] | None = None,
+    ) -> None:
+        await self._db.execute(
+            """
+            UPDATE email
+            SET mail_status = $2::mail_status,
+                parsed_data = COALESCE($3::jsonb, parsed_data),
+                updated_at = now()
+            WHERE id = $1
+            """,
+            email_id,
+            MailStatus.PARSE_FAILED.value,
+            json.dumps(parsed_data) if parsed_data else None,
+        )
+
+    async def _find_id_by_content_hash(self, content_hash: str | None) -> UUID | None:
+        if not content_hash:
+            return None
+        email_id = await self._db.fetchval(
+            "SELECT id FROM email WHERE content_hash = $1",
+            content_hash,
+        )
+        return self._as_uuid(email_id) if email_id else None
+
+    async def _update_status(self, email_id: UUID, status: MailStatus) -> UUID:
+        await self._db.execute(
+            """
+            UPDATE email
+            SET mail_status = $2::mail_status, updated_at = now()
+            WHERE id = $1
+            """,
+            email_id,
+            status.value,
+        )
+        return email_id
+
+    async def _insert_outbound(self, task: OutboundTask, status: MailStatus) -> UUID:
+        self._require_keys(
+            task,
+            ("imo", "voyage_id", "mail_from", "to", "content_hash"),
+            "新建邮件记录缺少必填字段: imo, voyage_id, mail_from, to, content_hash",
+        )
+
+        row_id = await self._db.fetchval(
+            """
+            INSERT INTO email (
+                imo, voyage_id, mail_flow, mail_status,
+                mail_from, mail_to, mail_cc, subject, content,
+                attachment, content_hash, created_user_id
+            )
+            VALUES (
+                $1, $2::uuid, $3::mail_flow, $4::mail_status,
+                $5, $6, $7, $8, $9,
+                $10::jsonb, $11, $12::uuid
+            )
+            ON CONFLICT (content_hash) DO UPDATE SET
+                mail_status = EXCLUDED.mail_status,
+                mail_to = EXCLUDED.mail_to,
+                mail_cc = EXCLUDED.mail_cc,
+                subject = EXCLUDED.subject,
+                content = EXCLUDED.content,
+                attachment = EXCLUDED.attachment,
+                updated_at = now()
+            RETURNING id
+            """,
+            int(task["imo"]),
+            str(task["voyage_id"]),
+            MailFlow.OUTBOUND.value,
+            status.value,
+            task["mail_from"],
+            task["to"],
+            task.get("cc") or None,
+            task.get("subject"),
+            task.get("content"),
+            self._to_jsonb(task.get("attachments")),
+            task["content_hash"],
+            task.get("created_user_id"),
+        )
+        return self._as_uuid(row_id)
+
+    async def _insert_inbound(
+        self,
+        task: InboundTask,
+        content_hash: str,
+        status: MailStatus,
+    ) -> UUID:
+        self._require_keys(
+            task,
+            ("imo", "voyage_id", "mail_from", "mail_to"),
+            "入站邮件缺少必填字段: imo, voyage_id, mail_from, mail_to",
+        )
+
+        body = task.get("body_markdown") or task.get("raw_text") or ""
+        meta = {
+            "brevo": {
+                "uuid": task.get("brevo_uuid"),
+                "message_id": task.get("message_id"),
+                "in_reply_to": task.get("in_reply_to"),
+            }
+        }
+
+        row_id = await self._db.fetchval(
+            """
+            INSERT INTO email (
+                imo, voyage_id, mail_flow, mail_status,
+                mail_from, mail_to, mail_cc, subject, content,
+                attachment, parsed_data, content_hash
+            )
+            VALUES (
+                $1, $2::uuid, $3::mail_flow, $4::mail_status,
+                $5, $6, $7, $8, $9,
+                $10::jsonb, $11::jsonb, $12
+            )
+            ON CONFLICT (content_hash) DO UPDATE SET
+                mail_status = EXCLUDED.mail_status,
+                content = EXCLUDED.content,
+                attachment = EXCLUDED.attachment,
+                parsed_data = EXCLUDED.parsed_data,
+                updated_at = now()
+            RETURNING id
+            """,
+            int(task["imo"]),
+            str(task["voyage_id"]),
+            MailFlow.INBOUND.value,
+            status.value,
+            task["mail_from"],
+            task["mail_to"],
+            task.get("mail_cc") or None,
+            task.get("subject"),
+            body,
+            self._to_jsonb(task.get("attachments")),
+            json.dumps(meta),
+            content_hash,
+        )
+        return self._as_uuid(row_id)
+
+    @staticmethod
+    def _as_uuid(value: str | UUID) -> UUID:
+        return value if isinstance(value, UUID) else UUID(str(value))
+
+    @staticmethod
+    def _require_keys(task: dict[str, Any], keys: tuple[str, ...], message: str) -> None:
+        if not all(task.get(key) for key in keys):
+            raise ValueError(message)
+
+    @staticmethod
+    def _to_jsonb(value: Any) -> str | None:
+        if not value:
+            return None
+        if isinstance(value, str):
+            return value
+        return json.dumps(value)

wr_common_lib-0.1.0/src/wr_common_lib/email/types.py

@@ -0,0 +1,35 @@
+from typing import Any, NotRequired, TypedDict
+from uuid import UUID
+
+
+class OutboundTask(TypedDict, total=False):
+    """出站邮件任务字段（发送服务）。"""
+
+    id: str | UUID
+    imo: int | str
+    voyage_id: str | UUID
+    mail_from: str
+    to: str
+    content_hash: str
+    cc: NotRequired[str | None]
+    subject: NotRequired[str | None]
+    content: NotRequired[str | None]
+    attachments: NotRequired[Any]
+    created_user_id: NotRequired[str | UUID | None]
+
+
+class InboundTask(TypedDict, total=False):
+    """入站邮件任务字段（收件 / 解析服务）。"""
+
+    imo: int | str
+    voyage_id: str | UUID
+    mail_from: str
+    mail_to: str
+    mail_cc: NotRequired[str | None]
+    subject: NotRequired[str | None]
+    body_markdown: NotRequired[str | None]
+    raw_text: NotRequired[str | None]
+    attachments: NotRequired[Any]
+    brevo_uuid: NotRequired[str | None]
+    message_id: NotRequired[str | None]
+    in_reply_to: NotRequired[str | None]