@arinova-ai/spaces-sdk 0.1.2 → 0.1.4

package/dist/index.d.ts

@@ -30,11 +30,33 @@ export interface TokenResponse {
         image: string | null;
     };
 }
+export interface BalanceResponse {
+    balance: number;
+}
+export interface PurchaseResponse {
+    transactionId: string;
+    newBalance: number;
+}
+export interface TransactionRecord {
+    id: string;
+    type: string;
+    amount: number;
+    description: string | null;
+    createdAt: string;
+}
+export interface TransactionsResponse {
+    transactions: TransactionRecord[];
+    total: number;
+    limit: number;
+    offset: number;
+}
 export declare class Arinova {
     private appId;
     private endpoint;
     private redirectUri;
     private scope;
+    /** The access token from the most recent login/handleCallback. */
+    accessToken: string | null;
     constructor(config: ArinovaConfig);
     /**
      * Start the OAuth PKCE login flow.
@@ -42,11 +64,39 @@ export declare class Arinova {
      * Returns the token response on success.
      */
     login(): Promise<TokenResponse>;
+    /**
+     * Connect to Arinova — auto-detects iframe vs standalone.
+     * In iframe: listens for postMessage from parent (Arinova Chat).
+     * Standalone: falls back to PKCE login popup.
+     */
+    connect(options?: {
+        timeout?: number;
+    }): Promise<{
+        user: TokenResponse["user"];
+        accessToken: string;
+        agents: {
+            id: string;
+            name: string;
+            description: string | null;
+            avatarUrl: string | null;
+        }[];
+    }>;
     /**
      * Handle the OAuth callback (call this on your redirect_uri page).
      * Reads code and state from URL, exchanges for token.
      */
     handleCallback(): Promise<TokenResponse>;
+    private getToken;
+    private apiFetch;
+    /** Get the current user's coin balance. */
+    balance(): Promise<BalanceResponse>;
+    /**
+     * Purchase / charge coins from the user's balance.
+     * Requires the "economy" scope.
+     */
+    purchase(productId: string, amount: number, description?: string): Promise<PurchaseResponse>;
+    /** Get the user's transaction history. */
+    transactions(limit?: number, offset?: number): Promise<TransactionsResponse>;
     private exchangeCode;
 }
 export default Arinova;

package/dist/index.js

@@ -10,6 +10,8 @@
  */
 export class Arinova {
     constructor(config) {
+        /** The access token from the most recent login/handleCallback. */
+        this.accessToken = null;
         this.appId = config.appId;
         this.endpoint = (config.endpoint ?? "https://chat.arinova.ai").replace(/\/+$/, "");
         this.redirectUri =
@@ -66,7 +68,10 @@ export class Arinova {
                             reject(new Error(url.searchParams.get("error_description") ?? "No code received"));
                             return;
                         }
-                        this.exchangeCode(code, verifier).then(resolve).catch(reject);
+                        this.exchangeCode(code, verifier).then((token) => {
+                            this.accessToken = token.access_token;
+                            resolve(token);
+                        }).catch(reject);
                     }
                 }
                 catch {
@@ -84,6 +89,42 @@ export class Arinova {
             }, 300000);
         });
     }
+    /**
+     * Connect to Arinova — auto-detects iframe vs standalone.
+     * In iframe: listens for postMessage from parent (Arinova Chat).
+     * Standalone: falls back to PKCE login popup.
+     */
+    async connect(options) {
+        const timeout = options?.timeout ?? 5000;
+        const inIframe = typeof window !== "undefined" && window.self !== window.top;
+        if (!inIframe) {
+            const token = await this.login();
+            return { user: token.user, accessToken: token.access_token, agents: [] };
+        }
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const timer = setTimeout(() => {
+                if (!settled) {
+                    settled = true;
+                    window.removeEventListener("message", handler);
+                    reject(new Error("connect timeout"));
+                }
+            }, timeout);
+            const handler = (event) => {
+                if (event.data?.type !== "arinova:auth")
+                    return;
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                window.removeEventListener("message", handler);
+                const payload = event.data.payload;
+                this.accessToken = payload.accessToken;
+                resolve(payload);
+            };
+            window.addEventListener("message", handler);
+        });
+    }
     /**
      * Handle the OAuth callback (call this on your redirect_uri page).
      * Reads code and state from URL, exchanges for token.
@@ -105,7 +146,58 @@ export class Arinova {
         if (!verifier) {
             throw new Error("No PKCE verifier found — did you start login()?");
         }
-        return this.exchangeCode(code, verifier);
+        const token = await this.exchangeCode(code, verifier);
+        this.accessToken = token.access_token;
+        return token;
+    }
+    // ── Economy Methods ───────────────────────────────────────────
+    getToken() {
+        if (!this.accessToken) {
+            throw new Error("Not logged in — call login() or handleCallback() first");
+        }
+        return this.accessToken;
+    }
+    async apiFetch(path, init) {
+        const token = this.getToken();
+        const res = await fetch(`${this.endpoint}${path}`, {
+            ...init,
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${token}`,
+                ...init?.headers,
+            },
+        });
+        if (!res.ok) {
+            const body = await res.json().catch(() => ({}));
+            throw new Error(body.error_description ??
+                body.error ??
+                `API error (${res.status})`);
+        }
+        return res.json();
+    }
+    /** Get the current user's coin balance. */
+    async balance() {
+        return this.apiFetch("/api/v1/economy/balance");
+    }
+    /**
+     * Purchase / charge coins from the user's balance.
+     * Requires the "economy" scope.
+     */
+    async purchase(productId, amount, description) {
+        return this.apiFetch("/api/v1/economy/purchase", {
+            method: "POST",
+            body: JSON.stringify({ productId, amount, description }),
+        });
+    }
+    /** Get the user's transaction history. */
+    async transactions(limit, offset) {
+        const params = new URLSearchParams();
+        if (limit != null)
+            params.set("limit", String(limit));
+        if (offset != null)
+            params.set("offset", String(offset));
+        const qs = params.toString();
+        return this.apiFetch(`/api/v1/economy/transactions${qs ? `?${qs}` : ""}`);
     }
     async exchangeCode(code, codeVerifier) {
         const res = await fetch(`${this.endpoint}/oauth/token`, {

package/dist/types.d.ts

@@ -68,6 +68,28 @@ export interface AwardResponse {
 export interface BalanceResponse {
     balance: number;
 }
+export interface PurchaseOptions {
+    productId: string;
+    amount: number;
+    description?: string;
+}
+export interface PurchaseResponse {
+    transactionId: string;
+    newBalance: number;
+}
+export interface TransactionRecord {
+    id: string;
+    type: string;
+    amount: number;
+    description: string | null;
+    createdAt: string;
+}
+export interface TransactionsResponse {
+    transactions: TransactionRecord[];
+    total: number;
+    limit: number;
+    offset: number;
+}
 export interface SSEChunkEvent {
     type: "chunk";
     content: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arinova-ai/spaces-sdk",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Arinova Spaces SDK — OAuth PKCE login for third-party apps",
   "type": "module",
   "main": "dist/index.js",