nexus-vylth

Nexus SDK for Python — auth verification and mail API for VYLTH services.

Install

# Mail only
pip install nexus-vylth

# Mail + Auth (JWT verification)
pip install nexus-vylth[auth]

# Everything
pip install nexus-vylth[all]

Mail API

Send emails via your Nexus Mail API key (nm_...):

from nexus_vylth import NexusMail

mail = NexusMail("nm_your_key_here")

# Single send
result = mail.send(
    to="user@example.com",
    subject="Hello",
    body_text="Hi there!",
)
print(result.from_address)  # you@vylth.com

# Batch send
results = mail.send_batch(
    recipients=["alice@example.com", "bob@example.com"],
    subject="Newsletter",
    body_html="<h1>Monthly Update</h1><p>Here's what happened...</p>",
)

Auth (JWT Verification)

Verify Nexus access tokens using JWKS (auto-fetched and cached):

from nexus_vylth import NexusAuth

auth = NexusAuth()

claims = auth.verify(token)
print(claims.email)         # user@vylth.com
print(claims.global_role)   # executor
print(claims.has_role("commander"))  # True

FastAPI

from fastapi import FastAPI, Depends
from nexus_vylth import NexusAuth

app = FastAPI()
auth = NexusAuth()

@app.get("/profile")
async def profile(claims=Depends(auth.fastapi_dependency())):
    return {"email": claims.email, "role": claims.global_role}

@app.get("/admin")
async def admin(claims=Depends(auth.fastapi_dependency("commander"))):
    return {"admin": claims.username}

Flask

from flask import Flask, g, jsonify
from nexus_vylth import NexusAuth

app = Flask(__name__)
auth = NexusAuth()

@app.route("/profile")
@auth.flask_decorator()
def profile():
    return jsonify({"email": g.nexus_claims.email})

@app.route("/admin")
@auth.flask_decorator("commander")
def admin():
    return jsonify({"admin": g.nexus_claims.username})

Claims Fields