Zindua for FastAPI

from pydantic import BaseModel, EmailStr, Field
from fastapi import Depends
from zindua.integrations.fastapi import get_zindua
from zindua import Zindua

class SendOtpRequest(BaseModel):
    to: EmailStr
    code: str = Field(min_length=4, max_length=8)
    lang: str | None = Field(default=None, examples=["fr", "en"])

@app.post("/send-otp", tags=["Zindua"])
async def send_otp(body: SendOtpRequest, zindua: Zindua = Depends(get_zindua)):
    return await zindua.send(
        to=str(body.to),
        template="otp-verification",
        lang=body.lang,
        variables={"code": body.code},
    )

# uvicorn main:app --reload --port 8000
# Swagger UI: http://127.0.0.1:8000/docs

# Omit lang → project default language
# Unknown lang on template → template default + lang_fallback=True
result = await zindua.send(
    to=to,
    template="otp-verification",
    lang=user_locale,  # optional: "fr", "en", …
    variables={"code": code, "appName": "MyApp"},
)
print(result.lang_used, result.lang_fallback)

# Email only, max 5 HTTPS urls
result = await zindua.send(
    to="user@example.com",
    template="invoice-ready",
    variables={"name": "Alex", "amount": "49.00"},
    cc="billing@myapp.com",
    reply_to="support@myapp.com",
    attachments=[{"url": "https://cdn.myapp.com/invoice.pdf", "filename": "invoice.pdf"}],
)
print(result.log_id)

# Zindua delivers the message. Your app owns OTP state.
import os
import random
import redis.asyncio as redis
from zindua import Zindua

zindua = Zindua(api_key=os.environ["ZINDUA_API_KEY"])
r = redis.from_url(os.environ["REDIS_URL"])

@app.post("/otp/request")
async def otp_request(email: str):
    code = f"{random.randint(100000, 999999)}"
    await r.setex(f"otp:{email}", 600, code)
    result = await zindua.send(
        to=email,
        template="otp-verification",
        variables={"code": code},
    )
    return {"ok": True, "logId": result.log_id}

from zindua.integrations.fastapi import get_zindua, ZinduaDep

@app.get("/health/zindua")
async def zindua_health(zindua: ZinduaDep):
    project = await zindua.get_project()
    return {"project": project.get("project"), "channels": project.get("channels")}

{
  "success": true,
  "status": "queued",
  "logId": "550e8400-e29b-41d4-a716-446655440000",
  "channel": "email",
  "langUsed": "fr",
  "langFallback": false,
  "testMode": false,
  "context": {
    "plan": {"slug": "free", "emailQuota": 25000, "emailsUsed": 3},
    "channels": {"email": true, "whatsapp": false}
  }
}