SDK quick start (React, Node, Python)

node packages/pura-sdk/examples/connect.mjs
# Or, with the Python SDK installed:
python packages/pura-sdk-python/examples/connect.py

import {createAuthorization, PuraOAuthClient, PuraInferenceClient,
  type StoredTokens} from '@pura-ai/sdk';

const options = {
  apiBase: process.env.PURA_API_BASE || 'https://ai.puradigital.it/v1',
  clientId: process.env.PURA_CLIENT_ID!,
  clientSecret: process.env.PURA_CLIENT_SECRET!, // confidential backend only
};
const redirectUri = process.env.PURA_REDIRECT_URI!;
const {url, pending} = await createAuthorization({...options, redirectUri});
// Persist pending in the authenticated user's session; redirect their browser to url.
// In that user's callback handler, callbackUrl is the full incoming HTTPS URL:
// const tokens = await new PuraOAuthClient(options).exchange(callbackUrl, pending);
// Validate and save tokens.pura_user_id against the authenticated local account.

// A runnable in-memory demo store; reconnect after process restart.
// Production must use encrypted per-user persistence with a shared refresh lock.
let saved: StoredTokens | null = null;
const store = {get: async () => saved, set: async (value: StoredTokens) => {saved = value;}};
// await store.set(tokens); // after the callback exchange above
const pura = new PuraInferenceClient({...options, store});
// Once connected:
// console.log(await pura.chat({messages: [{role: 'user', content: 'Hello'}]}));
// console.log(await pura.usage());

import os
from pura_llm import create_authorization, PuraOAuthClient, PuraInferenceClient

options = dict(api_base=os.getenv('PURA_API_BASE', 'https://ai.puradigital.it/v1'),
               client_id=os.environ['PURA_CLIENT_ID'],
               client_secret=os.environ['PURA_CLIENT_SECRET'])
url, pending = create_authorization(**{k: v for k, v in options.items() if k != 'client_secret'},
                                    redirect_uri=os.environ['PURA_REDIRECT_URI'])
# Persist pending in the local user's session and redirect to url.
class DemoStore:
    def __init__(self): self.tokens = None
    def get(self): return self.tokens
    def set(self, tokens): self.tokens = tokens
store = DemoStore()  # demo only: one connected user in one process
# In the authenticated callback handler:
# oauth = PuraOAuthClient(**options)
# try: store.set(oauth.exchange(callback_url, pending))
# finally: oauth.close()
# After connection:
# pura = PuraInferenceClient(**options, store=store)
# try:
#     print(pura.chat(messages=[{'role': 'user', 'content': 'Hello'}]))
#     print(pura.usage())
# finally: pura.close()