izteamslots 1.3.2 → 1.4.0

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+# [1.4.0](https://github.com/izzzzzi/izTeamSlots/compare/v1.3.3...v1.4.0) (2026-03-06)
+
+
+### Features
+
+* auto-discovery for mail providers — no manual registration needed ([ca54650](https://github.com/izzzzzi/izTeamSlots/commit/ca54650a42696b714c79cf328da5d58b5e2d1f60))
+
+## [1.3.3](https://github.com/izzzzzi/izTeamSlots/compare/v1.3.2...v1.3.3) (2026-03-06)
+
+
+### Bug Fixes
+
+* quick start recommends configuring mail API key first ([c852b9d](https://github.com/izzzzzi/izTeamSlots/commit/c852b9d63d9e5867b897791e8fd11e712e1a515f))
+* remove extra leading spaces from hero logo ([ddb43bb](https://github.com/izzzzzi/izTeamSlots/commit/ddb43bbc6ba0075736ac7acba433032b45dbfc37))
+
 ## [1.3.2](https://github.com/izzzzzi/izTeamSlots/compare/v1.3.1...v1.3.2) (2026-03-06)
 
 

package/CONTRIBUTING.md

@@ -4,7 +4,7 @@
 
 ## Подготовка окружения
 
-1. Форкните репозиторий
+1. Форкните [izzzzzi/izTeamSlots](https://github.com/izzzzzi/izTeamSlots)
 2. Клонируйте форк:
    ```bash
    git clone https://github.com/<your-username>/izTeamSlots.git

package/README.md

@@ -45,6 +45,12 @@
 ```text
 izTeamSlots/
 ├── app.py                          # Entrypoint: запускает UI
+├── bin/                            # CLI-бинарники
+│   └── izteamslots.mjs             # Кроссплатформенный entrypoint (Node.js)
+├── scripts/                        # Установочные скрипты
+│   ├── setup.mjs                   # Диспетчер: выбирает .sh или .cmd
+│   ├── setup.sh                    # Unix: uv + venv + Bun
+│   └── setup.cmd                   # Windows: uv + venv + Bun
 ├── backend/                        # Весь Python-бэкенд
 │   ├── __init__.py                 # PROJECT_ROOT
 │   ├── __main__.py                 # python -m backend
@@ -71,8 +77,9 @@ izTeamSlots/
 │       ├── screens/MainScreen.ts   # Главный экран
 │       ├── transport/stdioClient.ts # JSON-RPC клиент
 │       └── menus/                  # Меню, таблицы, форматирование
-├── accounts/                       # Данные аккаунтов (runtime)
-├── codex/                          # Codex-файлы (runtime)
+├── requirements.txt                # Python-зависимости
+├── ruff.toml                       # Конфиг линтера Python
+├── LICENSE                         # MIT
 └── README.md
 ```
 
@@ -100,7 +107,9 @@ npm install
 
 ### Настройка
 
-Создайте файл конфигурации `~/.izteamslots/.env`:
+API-ключи и провайдеры почты настраиваются прямо в приложении через меню **«Настройки»**. Значения сохраняются в `~/.izteamslots/.env`.
+
+Альтернативно — создайте файл вручную:
 
 ```bash
 # Linux / macOS
@@ -114,8 +123,6 @@ echo "BOOMLIFY_API_KEY=your_api_key" > "$env:USERPROFILE\.izteamslots\.env"
 
 Конфиг загружается в порядке приоритета: `~/.izteamslots/.env` > `./.env` > встроенный.
 
-Опциональные переменные:
-
 | Переменная | По умолчанию | Описание |
 |-----------|:------------:|----------|
 | `BOOMLIFY_API_KEY` | — | API-ключ Boomlify (обязательно для слотов) |
@@ -234,8 +241,3 @@ flowchart TD
 - Не публикуйте папки `accounts/` и `codex/` в публичные репозитории.
 - Для стабильной работы перелогина у worker должен быть `openai_password`.
 
----
-
-## Участие в разработке
-
-См. [CONTRIBUTING.md](CONTRIBUTING.md).

package/backend/mail/__init__.py

@@ -1,4 +1,4 @@
-"""Pluggable mail provider system.
+"""Pluggable mail provider system with auto-discovery.
 
 Usage::
 
@@ -17,18 +17,17 @@ Select provider via env var or name::
 
     provider = create_provider("imap", host="imap.example.com")
 
-Available providers:
-    trickads - trickadsagencyltd.com temp mail (generic/default)
-    boomlify - Boomlify temp mail API (slots default)
-    imap     - any IMAP server (env: IMAP_HOST, IMAP_PORT, IMAP_SSL)
-
 Custom providers:
-    Subclass ``MailProvider`` from ``backend.mail.base`` and implement
-    ``generate()`` and ``inbox()``.
+    Create a .py file in backend/mail/, subclass MailProvider, set ``name``
+    and optionally ``password_prefix``. The provider will be discovered
+    automatically — no edits to __init__.py needed.
 """
 from __future__ import annotations
 
+import importlib
 import os
+import pkgutil
+from pathlib import Path
 from typing import Any
 
 from .base import Inbox, Mail, MailAuthError, Mailbox, MailError, MailProvider, MailServiceUnavailable
@@ -46,7 +45,38 @@ __all__ = [
     "create_slot_provider",
 ]
 
-_BUILTIN_PROVIDERS = ("boomlify", "trickads", "imap")
+_REGISTRY: dict[str, type[MailProvider]] | None = None
+
+
+def _discover_providers() -> dict[str, type[MailProvider]]:
+    """Scan this package for MailProvider subclasses and build a registry."""
+    registry: dict[str, type[MailProvider]] = {}
+    package_dir = Path(__file__).parent
+
+    for module_info in pkgutil.iter_modules([str(package_dir)]):
+        if module_info.name.startswith("_") or module_info.name == "base":
+            continue
+        try:
+            module = importlib.import_module(f".{module_info.name}", __package__)
+        except Exception:
+            continue
+        for attr in vars(module).values():
+            if (
+                isinstance(attr, type)
+                and issubclass(attr, MailProvider)
+                and attr is not MailProvider
+                and attr.name != "base"
+            ):
+                registry[attr.name] = attr
+
+    return registry
+
+
+def _get_registry() -> dict[str, type[MailProvider]]:
+    global _REGISTRY  # noqa: PLW0603
+    if _REGISTRY is None:
+        _REGISTRY = _discover_providers()
+    return _REGISTRY
 
 
 def create_provider(name: str | None = None, **kwargs: Any) -> MailProvider:
@@ -58,23 +88,12 @@ def create_provider(name: str | None = None, **kwargs: Any) -> MailProvider:
         **kwargs: Passed to provider constructor.
     """
     provider_name = name or os.environ.get("MAIL_PROVIDER", "trickads")
-
-    if provider_name == "boomlify":
-        from .boomlify import BoomlifyProvider
-        return BoomlifyProvider(**kwargs)
-
-    if provider_name == "trickads":
-        from .trickads import TrickAdsProvider
-        return TrickAdsProvider(**kwargs)
-
-    if provider_name == "imap":
-        from .imap import IMAPProvider
-        return IMAPProvider(**kwargs)
-
-    raise ValueError(
-        f"Unknown mail provider: {provider_name!r}. "
-        f"Available: {', '.join(_BUILTIN_PROVIDERS)}"
-    )
+    registry = _get_registry()
+    cls = registry.get(provider_name)
+    if cls is None:
+        available = ", ".join(sorted(registry)) or "(none)"
+        raise ValueError(f"Unknown mail provider: {provider_name!r}. Available: {available}")
+    return cls(**kwargs)
 
 
 def create_slot_provider(name: str | None = None, **kwargs: Any) -> MailProvider:
@@ -89,10 +108,14 @@ def create_slot_provider(name: str | None = None, **kwargs: Any) -> MailProvider
 def create_provider_for_mailbox(mailbox: Mailbox, **kwargs: Any) -> MailProvider:
     """Pick provider based on stored mailbox credentials.
 
-    Boomlify mailboxes store their email id inside ``Mailbox.password`` as
-    ``boomlify:<uuid>``. Everything else falls back to the generic provider.
+    Checks ``password_prefix`` of each registered provider first,
+    then falls back to the default provider.
     """
     password = mailbox.password.strip()
-    if password.startswith("boomlify:"):
-        return create_provider("boomlify", **kwargs)
+    registry = _get_registry()
+
+    for cls in registry.values():
+        if cls.password_prefix and password.startswith(cls.password_prefix):
+            return cls(**kwargs)
+
     return create_provider(**kwargs)

package/backend/mail/base.py

@@ -63,6 +63,7 @@ class MailProvider(ABC):
     """
 
     name: str = "base"
+    password_prefix: str = ""
 
     @abstractmethod
     def generate(self) -> Mailbox:

package/backend/mail/boomlify.py

@@ -50,6 +50,7 @@ class BoomlifyProvider(MailProvider):
     """Temporary email via Boomlify API."""
 
     name = "boomlify"
+    password_prefix = "boomlify:"
 
     def __init__(
         self,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "izteamslots",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "description": "ChatGPT Team slot management — automated invite, register, OAuth login & codex token pipeline",
   "bin": {
     "izteamslots": "bin/izteamslots.mjs"

package/ui/src/screens/MainScreen.ts

@@ -14,8 +14,8 @@ const EMPTY_STATE: AppState = {
 }
 
 const HERO_LOGO = [
-  " izTeamSlots",
-  " Локальный центр управления слотами",
+  "izTeamSlots",
+  "Локальный центр управления слотами",
 ].join("\n")
 
 type RpcJobResult = { job_id: string }
@@ -578,6 +578,7 @@ export class MainScreen {
   private getRecommendedSteps(): string[] {
     if (this.state.admins.length === 0) {
       return [
+        "Откройте «Настройки» и укажите API-ключ временной почты.",
         "Добавьте первого админа через раздел «Админы».",
         "После добавления выполните логин, чтобы сохранить токен и профиль браузера.",
         "Затем создайте слоты и проверьте входящие письма.",