@arinova-ai/spaces-sdk 0.1.2 → 0.1.3

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.
@@ -47,6 +69,17 @@ export declare class Arinova {
      * 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 {
@@ -105,7 +110,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.3",
   "description": "Arinova Spaces SDK — OAuth PKCE login for third-party apps",
   "type": "module",
   "main": "dist/index.js",