@aisastra/aura-browser-sdk

@aisastra/aura-browser-sdk

Official browser SDK for the AURA Developer Platform.

Use this in React, Vue, or plain HTML apps. Do not embed app client_secret in browser code — exchange OAuth codes on your server.

Install

npm install @aisastra/aura-browser-sdk

Quick start

import { AuraBrowser } from "@aisastra/aura-browser-sdk";

AuraBrowser.init({
  appId: "YOUR_APP_ID",
  redirectUri: "https://yourapp.com/oauth/callback",
});

// Popup login (PKCE)
const { code, codeVerifier } = await AuraBrowser.getInstance().login({
  scope: "pages:read slambook:read",
});

// Exchange on YOUR backend (never expose client_secret in browser)
const { access_token } = await fetch("/api/aura/token", {
  method: "POST",
  body: JSON.stringify({ code, code_verifier: codeVerifier }),
}).then((r) => r.json());

const aura = AuraBrowser.withAccessToken(access_token);
const pages = await aura.getPages();

Redirect flow

On your callback page:

import { completeRedirectLogin, AuraBrowser } from "@aisastra/aura-browser-sdk";

const { code, codeVerifier } = completeRedirectLogin();
// POST code + codeVerifier to your backend, then:
AuraBrowser.withAccessToken(access_token).getMe();

License

MIT — Aisastra