@aisastra/aura-sdk

Official TypeScript/JavaScript client for the AURA Developer Platform.

Install

npm install @aisastra/aura-sdk

For browser / React / Vue apps use the dedicated browser SDK (OAuth PKCE + Graph):

npm install @aisastra/aura-browser-sdk

Quick start

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

// User OAuth token (reads + writes)
const user = AuraClient.withUserToken(process.env.AURA_USER_TOKEN!);
const pages = await user.getPages();

// App API key (server-side reads)
const app = AuraClient.withApiKey(process.env.AURA_APP_KEY!);
const me = await app.getMe();

Graph mutations

await user.createPagePost("PAGE_ID", "Hello from SDK");
await user.publishReel("https://cdn.example.com/reel.mp4", "Caption");
await user.graphPost({
  node: "me/messages",
  conversationId: "conv_123",
  content: "Hi there",
});

Batch & debug

await user.debugToken(someToken);
await user.batch([
  { method: "GET", relative_url: "me/pages?limit=5" },
  { method: "GET", relative_url: "me/ad_accounts?limit=5" },
]);

Live mode requirements

External apps need App Review, annual Data Use Checkup, and business verification for messaging/ads scopes before aura_live_ keys and public OAuth work.

License

MIT — Aisastra