For developers

import {
  PromaProvider,
  usePromaAuth,
  useOAuthCallback,
} from '@proma-dev/sdk/react'

// 1. Wrap once. Auth + billing wired up.
<PromaProvider
  clientId={process.env.NEXT_PUBLIC_PROMA_CLIENT_ID!}
  redirectUri="https://yourapp.com/callback"
  scopes={['profile', 'credits', 'ai:chat']}
>
  <App />
</PromaProvider>

// 2. Use anywhere.
function Composer() {
  const { user, login, client } = usePromaAuth()
  if (!user) return <button onClick={() => login()}>Sign in</button>

  const reply = await client.ai.chatText([
    { role: 'user', content: 'Pitch this in one sentence.' },
  ])
  // → user is charged. you earn. no servers, no Stripe.
}

import { PromaClient } from '@proma-dev/sdk'

const proma = new PromaClient({
  clientId: process.env.PROMA_CLIENT_ID!,
  redirectUri: 'https://yourapp.com/callback',
})

// OAuth 2.1 + PKCE. Standard. No vendor lock-in.
const session  = await proma.handleCallback(window.location.href)
const balance  = await proma.credits.getBalance()
const text     = await proma.ai.chatText([
  { role: 'user', content: 'Summarize this PR.' },
])

# No SDK? No problem. It's just HTTP + OAuth.
curl https://api.proma.dev/v1/ai/chat \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "Hello"}]
  }'

# {
#   "id": "msg_01J...",
#   "model": "gemini-2.5-flash",
#   "credits_charged": 1,
#   "content": "Hi! How can I help?"
# }

// In your Lovable project: paste this prompt.
//
//  > Add "Login with Proma" using @proma-dev/sdk/react.
//  > Wrap App with <PromaProvider clientId="..." />,
//  > add a /callback route that calls useOAuthCallback,
//  > and gate features on usePromaAuth().user.
//
// That's it. Lovable wires the SDK. You ship.