devcoffee-integration-event 1.0.0__tar.gz

devcoffee_integration_event-1.0.0/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.1
+Name: devcoffee-integration-event
+Version: 1.0.0
+Summary: DevCoffee events data
+Author-Email: Hieu Nguyen <hieu.nguyen@devcoffee.tech>
+License: MIT
+Requires-Python: >=3.12
+Requires-Dist: pydantic>=2.12.5
+Description-Content-Type: text/markdown
+
+# devcoffee-integration-event

devcoffee_integration_event-1.0.0/README.md

@@ -0,0 +1 @@
+# devcoffee-integration-event

devcoffee_integration_event-1.0.0/pyproject.toml

@@ -0,0 +1,24 @@
+[project]
+name = "devcoffee-integration-event"
+version = "1.0.0"
+description = "DevCoffee events data"
+authors = [
+    { name = "Hieu Nguyen", email = "hieu.nguyen@devcoffee.tech" },
+]
+requires-python = ">=3.12"
+readme = "README.md"
+dependencies = [
+    "pydantic>=2.12.5",
+]
+
+[project.license]
+text = "MIT"
+
+[tool.pdm]
+distribution = true
+
+[build-system]
+requires = [
+    "pdm-backend",
+]
+build-backend = "pdm.backend"

devcoffee_integration_event-1.0.0/src/tech/devcoffee/integration/events/__init__.py

@@ -0,0 +1 @@
+from .base import BaseEvent

devcoffee_integration_event-1.0.0/src/tech/devcoffee/integration/events/base.py

@@ -0,0 +1,23 @@
+from datetime import datetime
+from typing import Any
+from uuid import UUID
+
+from pydantic import BaseModel, Field
+
+__all__=[
+    "BaseEvent"
+]
+
+class BaseEvent(BaseModel):
+    event_id: UUID = Field(..., description="Unique identifier of the event (uuid)")
+    trace_id: UUID | None = Field(default=None, description="Trace identifier for distributed tracing (uuid)")
+    event_time: datetime = Field(..., description="When the token was issued")
+    event_name: str = Field(default="token.issued", description="The name of the event")
+    producer: str = Field(..., description="Service that produced the event")
+    data: dict[str, Any] = Field(..., description="Event payload data")
+
+    def __str__(self) -> str:
+        return f"{self.event_name} ({self.event_id})"
+
+    def __repr__(self):
+        return f"<{self.__class__.__name__} {self.event_name} {self.event_id}>"

devcoffee_integration_event-1.0.0/src/tech/devcoffee/integration/events/token.py

@@ -0,0 +1,49 @@
+from uuid import UUID
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from .base import BaseEvent
+
+__all__ = [
+    "IssuedTokenData",
+    "RevokedTokenData",
+    "TokenIssuedEvent",
+    "TokenRevokedEvent",
+]
+
+
+class IssuedTokenData(BaseModel):
+    token: str = Field(..., description="The issued token string.")
+
+    token_type: str = Field(
+        ..., alias="tokenType", description="The type of the token issued (access_token, id_token)."
+    )
+    email: str = Field(..., description="The email of the user for whom the token was issued.")
+    user_id: UUID = Field(..., alias="userId", description="The unique identifier of the user.")
+    client_id: str = Field(
+        ..., alias="clientId", description="The client identifier of the application that requested the token."
+    )
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class RevokedTokenData(BaseModel):
+    token: str = Field(..., description="The revoked token string.")
+    token_type: str = Field(
+        ..., alias="tokenType", description="The type of the token revoked (access_token, id_token)."
+    )
+    email: str = Field(..., description="The email of the user for whom the token was revoked.")
+    user_id: UUID = Field(..., alias="userId", description="The unique identifier of the user.")
+    client_id: str = Field(
+        ..., alias="clientId", description="The client identifier of the application that requested the token."
+    )
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class TokenIssuedEvent(BaseEvent):
+    data: IssuedTokenData
+
+
+class TokenRevokedEvent(BaseEvent):
+    data: RevokedTokenData

devcoffee_integration_event-1.0.0/src/tech/devcoffee/integration/events/user.py

@@ -0,0 +1,58 @@
+from datetime import datetime
+from enum import StrEnum
+from uuid import UUID
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from .base import BaseEvent
+
+__all__ = [
+    "User",
+    "AuthenticationMethod",
+    "Authentication",
+    "Client",
+    "AuthenticationPayload",
+    "UserAuthenticationSucceededEvent",
+]
+
+
+class User(BaseModel):
+    id: UUID = Field(..., description="User's unique identifier (uuid)")
+    email: str = Field(..., description="User's email")
+    first_name: str = Field(..., alias="firstName", description="User's first name")
+    last_name: str = Field(..., alias="lastName", description="User's last name")
+    language: str | None = Field(default=None, description="User's language")
+    timezone: str | None = Field(default=None, description="User's timezone")
+    date_joined: datetime | None = Field(default=None, alias="dateJoined", description="User's joined date.")
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class AuthenticationMethod(StrEnum):
+    PASSWORD = "PASSWORD"
+    OIDC = "OIDC"
+    REMEMBER_TOKEN = "REMEMBER_TOKEN"
+    API_KEY = "API_KEY"
+
+
+class Authentication(BaseModel):
+    method: AuthenticationMethod
+    provider: str | None = Field(
+        default=None, description="OIDC provider that authenticated the user. e.g. google, github"
+    )
+
+
+class Client(BaseModel):
+    ip: str | None = Field(default=None, description="IP address of the client")
+    user_agent: str | None = Field(default=None, description="User agent of the client")
+    device: str | None = Field(default=None, description="Device identifier of the client")
+
+
+class AuthenticationPayload(BaseModel):
+    user: User
+    authentication: Authentication
+    client: Client
+
+
+class UserAuthenticationSucceededEvent(BaseEvent):
+    data: AuthenticationPayload