regstack 0.2.3__tar.gz → 0.2.4__tar.gz

{regstack-0.2.3 → regstack-0.2.4}/CHANGELOG.md

@@ -5,6 +5,25 @@ authoritative copy lives at
 [`docs/changelog.md`](docs/changelog.md) and is rendered into the
 Sphinx docs.
 
+## 0.2.4 — 2026-04-28
+
+**Breaking** — back-compat shims removed:
+
+- `RegStack.install_indexes()` (alias for `install_schema()`).
+- `ObjectIdStr` alias for `IdStr` in `regstack.models._objectid`.
+- Re-exports of `UserAlreadyExistsError`,
+  `PendingAlreadyExistsError`, `MfaVerifyOutcome`, and
+  `MfaVerifyResult` from `regstack.backends.mongo.repositories.*`.
+  Their canonical home is `regstack.backends.protocols`.
+
+If you import any of these from the old paths, switch to:
+- `RegStack.install_schema()`
+- `from regstack.models._objectid import IdStr`
+- `from regstack.backends.protocols import UserAlreadyExistsError`
+  (and friends).
+
+The internal mongo `install_indexes(db, config)` function is unchanged.
+
 ## 0.2.3 — 2026-04-28
 
 Docs-only release. Restructured the API reference around the current

{regstack-0.2.3 → regstack-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: regstack
-Version: 0.2.3
+Version: 0.2.4
 Summary: Embeddable user registration, login, and account management for FastAPI apps. SQLite / Postgres / MongoDB.
 Project-URL: Homepage, https://github.com/jdrumgoole/regstack
 Project-URL: Repository, https://github.com/jdrumgoole/regstack

{regstack-0.2.3 → regstack-0.2.4}/docs/architecture.md

@@ -72,7 +72,6 @@ The façade exposes:
 - `backend` — the active `regstack.backends.base.Backend`.
 - `install_schema()` — install indexes (Mongo) or run
   [Alembic](https://alembic.sqlalchemy.org/) migrations (SQL).
-  `install_indexes()` is kept as a back-compat alias.
 - `aclose()` — tear down the backend's connection pool.
 - `bootstrap_admin(email, password)`,
   `add_template_dir(path)`, `set_email_backend(...)`,

{regstack-0.2.3 → regstack-0.2.4}/docs/changelog.md

@@ -3,6 +3,39 @@
 All notable changes to this project are documented here. Versions follow
 [Semantic Versioning](https://semver.org/) once `1.0.0` ships.
 
+## 0.2.4 — 2026-04-28
+
+**Breaking** — every back-compat shim left over from the
+multi-backend refactor has been removed.
+
+### Removed
+
+- `RegStack.install_indexes()` — the 0.1.x alias for
+  `install_schema()`. Call `install_schema()`.
+- `ObjectIdStr` alias for `IdStr` in `regstack.models._objectid`.
+  Import `IdStr` directly.
+- `__all__`-based re-exports of `UserAlreadyExistsError`,
+  `PendingAlreadyExistsError`, `MfaVerifyOutcome`, and
+  `MfaVerifyResult` from `regstack.backends.mongo.repositories.*` and
+  the package `__init__`. Their canonical home is
+  `regstack.backends.protocols`; that's where every consumer in the
+  package itself already imports them.
+
+### Migration
+
+| Old                                                                              | New                                                            |
+|----------------------------------------------------------------------------------|----------------------------------------------------------------|
+| `await regstack.install_indexes()`                                               | `await regstack.install_schema()`                              |
+| `from regstack.models._objectid import ObjectIdStr`                              | `from regstack.models._objectid import IdStr`                  |
+| `from regstack.backends.mongo.repositories.user_repo import UserAlreadyExistsError`     | `from regstack.backends.protocols import UserAlreadyExistsError`     |
+| `from regstack.backends.mongo.repositories.pending_repo import PendingAlreadyExistsError` | `from regstack.backends.protocols import PendingAlreadyExistsError`  |
+| `from regstack.backends.mongo.repositories.mfa_code_repo import MfaVerifyOutcome, MfaVerifyResult` | `from regstack.backends.protocols import MfaVerifyOutcome, MfaVerifyResult` |
+
+The internal Mongo helper
+`regstack.backends.mongo.indexes.install_indexes(db, config)` is
+unchanged — that's the function `MongoBackend.install_schema` calls
+to actually create the indexes.
+
 ## 0.2.3 — 2026-04-28
 
 **Docs-only release.** API reference rewritten around the current

{regstack-0.2.3 → regstack-0.2.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "regstack"
-version = "0.2.3"
+version = "0.2.4"
 description = "Embeddable user registration, login, and account management for FastAPI apps. SQLite / Postgres / MongoDB."
 readme = "README.md"
 requires-python = ">=3.11"

{regstack-0.2.3 → regstack-0.2.4}/src/regstack/app.py

@@ -213,14 +213,6 @@ class RegStack:
         """
         await self.backend.install_schema()
 
-    async def install_indexes(self) -> None:
-        """Backwards-compatible alias for :meth:`install_schema`.
-
-        Kept for the 0.1.x ``install_indexes()`` name. New callers
-        should use :meth:`install_schema`.
-        """
-        await self.install_schema()
-
     async def aclose(self) -> None:
         """Tear down the backend's connection pool.
 

regstack-0.2.4/src/regstack/backends/mongo/repositories/__init__.py

@@ -0,0 +1,13 @@
+from regstack.backends.mongo.repositories.blacklist_repo import BlacklistRepo
+from regstack.backends.mongo.repositories.login_attempt_repo import LoginAttemptRepo
+from regstack.backends.mongo.repositories.mfa_code_repo import MfaCodeRepo
+from regstack.backends.mongo.repositories.pending_repo import PendingRepo
+from regstack.backends.mongo.repositories.user_repo import UserRepo
+
+__all__ = [
+    "BlacklistRepo",
+    "LoginAttemptRepo",
+    "MfaCodeRepo",
+    "PendingRepo",
+    "UserRepo",
+]

{regstack-0.2.3 → regstack-0.2.4}/src/regstack/backends/mongo/repositories/mfa_code_repo.py

@@ -13,9 +13,6 @@ if TYPE_CHECKING:
     from regstack.auth.clock import Clock
 
 
-__all__ = ["MfaCodeRepo", "MfaVerifyOutcome", "MfaVerifyResult"]
-
-
 class MfaCodeRepo:
     def __init__(self, db: AsyncDatabase, collection_name: str, *, clock: Clock) -> None:
         self._collection = db[collection_name]

{regstack-0.2.3 → regstack-0.2.4}/src/regstack/backends/mongo/repositories/pending_repo.py

@@ -13,9 +13,6 @@ if TYPE_CHECKING:
     from pymongo.asynchronous.database import AsyncDatabase
 
 
-__all__ = ["PendingAlreadyExistsError", "PendingRepo"]
-
-
 class PendingRepo:
     def __init__(self, db: AsyncDatabase, collection_name: str) -> None:
         self._collection = db[collection_name]

{regstack-0.2.3 → regstack-0.2.4}/src/regstack/backends/mongo/repositories/user_repo.py

@@ -14,9 +14,6 @@ if TYPE_CHECKING:
     from pymongo.asynchronous.database import AsyncDatabase
 
 
-__all__ = ["UserAlreadyExistsError", "UserRepo"]
-
-
 def _bulk_revoke_cutoff(now: datetime) -> datetime:
     """The cutoff timestamp recorded on the user document. Stored at full
     microsecond precision; the JWT ``iat`` claim is also emitted as a float

{regstack-0.2.3 → regstack-0.2.4}/src/regstack/models/_objectid.py

@@ -7,10 +7,6 @@ the backend:
 - SQL backends use UUID4 hex (32-char).
 - Hosts with their own ID strategy can substitute anything else as long
   as it round-trips as a string.
-
-Historically this was named ``ObjectIdStr`` and validated 24-char hex
-only. The rename and relaxed contract landed when the SQL backends
-arrived; the old name is kept as an alias for any external imports.
 """
 
 from __future__ import annotations
@@ -49,7 +45,3 @@ class _IdValidator:
 
 
 IdStr = Annotated[str, _IdValidator]
-
-# Back-compat alias — the contract is now "any non-empty string", so
-# anyone reaching for ObjectIdStr keeps the same surface area.
-ObjectIdStr = IdStr

{regstack-0.2.3 → regstack-0.2.4}/src/regstack/models/login_attempt.py

@@ -5,7 +5,7 @@ from typing import Any
 
 from pydantic import BaseModel, ConfigDict, EmailStr, Field
 
-from regstack.models._objectid import ObjectIdStr
+from regstack.models._objectid import IdStr
 
 
 def _utcnow() -> datetime:
@@ -19,7 +19,7 @@ class LoginAttempt(BaseModel):
 
     model_config = ConfigDict(populate_by_name=True, extra="allow")
 
-    id: ObjectIdStr | None = Field(default=None, alias="_id")
+    id: IdStr | None = Field(default=None, alias="_id")
     email: EmailStr
     when: datetime = Field(default_factory=_utcnow)
     ip: str | None = None

{regstack-0.2.3 → regstack-0.2.4}/src/regstack/models/mfa_code.py

@@ -5,7 +5,7 @@ from typing import Any, Literal
 
 from pydantic import BaseModel, ConfigDict, Field
 
-from regstack.models._objectid import ObjectIdStr
+from regstack.models._objectid import IdStr
 
 MfaKind = Literal["phone_setup", "login_mfa"]
 
@@ -24,7 +24,7 @@ class MfaCode(BaseModel):
 
     model_config = ConfigDict(populate_by_name=True, extra="allow")
 
-    id: ObjectIdStr | None = Field(default=None, alias="_id")
+    id: IdStr | None = Field(default=None, alias="_id")
     user_id: str
     kind: MfaKind
     code_hash: str

{regstack-0.2.3 → regstack-0.2.4}/src/regstack/models/pending_registration.py

@@ -5,7 +5,7 @@ from typing import Any
 
 from pydantic import BaseModel, ConfigDict, EmailStr, Field
 
-from regstack.models._objectid import ObjectIdStr
+from regstack.models._objectid import IdStr
 
 
 def _utcnow() -> datetime:
@@ -23,7 +23,7 @@ class PendingRegistration(BaseModel):
 
     model_config = ConfigDict(populate_by_name=True, extra="allow")
 
-    id: ObjectIdStr | None = Field(default=None, alias="_id")
+    id: IdStr | None = Field(default=None, alias="_id")
     email: EmailStr
     hashed_password: str
     full_name: str | None = None

{regstack-0.2.3 → regstack-0.2.4}/src/regstack/models/user.py

@@ -5,7 +5,7 @@ from typing import Annotated, Any
 
 from pydantic import BaseModel, ConfigDict, EmailStr, Field, field_validator
 
-from regstack.models._objectid import ObjectIdStr
+from regstack.models._objectid import IdStr
 
 
 def _utcnow() -> datetime:
@@ -25,7 +25,7 @@ class BaseUser(BaseModel):
 
     model_config = ConfigDict(populate_by_name=True, extra="allow")
 
-    id: ObjectIdStr | None = Field(default=None, alias="_id")
+    id: IdStr | None = Field(default=None, alias="_id")
     email: EmailStr
     hashed_password: str
     is_active: bool = True

regstack-0.2.4/src/regstack/version.py

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

{regstack-0.2.3 → regstack-0.2.4}/tests/unit/test_mfa_code_repo.py

@@ -7,7 +7,8 @@ import pytest_asyncio
 
 from regstack.auth.clock import FrozenClock
 from regstack.auth.tokens import hash_token
-from regstack.backends.mongo.repositories.mfa_code_repo import MfaCodeRepo, MfaVerifyOutcome
+from regstack.backends.mongo.repositories.mfa_code_repo import MfaCodeRepo
+from regstack.backends.protocols import MfaVerifyOutcome
 from regstack.models.mfa_code import MfaCode
 
 

{regstack-0.2.3 → regstack-0.2.4}/uv.lock

@@ -1978,7 +1978,7 @@ wheels = [
 
 [[package]]
 name = "regstack"
-version = "0.2.3"
+version = "0.2.4"
 source = { editable = "." }
 dependencies = [
     { name = "aiosmtplib" },

regstack-0.2.3/src/regstack/backends/mongo/repositories/__init__.py

@@ -1,27 +0,0 @@
-from regstack.backends.mongo.repositories.blacklist_repo import BlacklistRepo
-from regstack.backends.mongo.repositories.login_attempt_repo import LoginAttemptRepo
-from regstack.backends.mongo.repositories.mfa_code_repo import (
-    MfaCodeRepo,
-    MfaVerifyOutcome,
-    MfaVerifyResult,
-)
-from regstack.backends.mongo.repositories.pending_repo import (
-    PendingAlreadyExistsError,
-    PendingRepo,
-)
-from regstack.backends.mongo.repositories.user_repo import (
-    UserAlreadyExistsError,
-    UserRepo,
-)
-
-__all__ = [
-    "BlacklistRepo",
-    "LoginAttemptRepo",
-    "MfaCodeRepo",
-    "MfaVerifyOutcome",
-    "MfaVerifyResult",
-    "PendingAlreadyExistsError",
-    "PendingRepo",
-    "UserAlreadyExistsError",
-    "UserRepo",
-]

regstack-0.2.3/src/regstack/version.py

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