PersonaEngine

Problem¶

No SDK available for common languages (Python, JavaScript, Go). Users must implement their own HTTP client.

Requested Features¶

1. Python SDK (pip install persona-engine)
2. JavaScript/TypeScript SDK (npm install persona-engine-sdk)
3. Go SDK (go get github.com/persona/engine-sdk)

API Endpoints Needed¶

• POST /auth/token - No way for existing user to get their token (only register returns token)
• Current workaround: user must store token from registration

Proposed Solution¶

1. Add POST /api/v1/auth/token endpoint that takes email and returns token
2. Create SDK libraries with:
   • Authentication (token management)
   • Persona CRUD operations
   • Webhook management
   • Rate limiting handling
   • Retry logic with exponential backoff

SDK Features¶

• Type-safe models
• Async support
• Automatic token refresh
• Webhook signature verification
• OpenAPI spec auto-generation

References¶

• Stripe SDK as reference implementation
• Vercel SDK pattern