superso-js-sdk 1.0.1

package/dist/ai/ai.d.ts

@@ -0,0 +1,76 @@
+import { SupersoClient } from "../core/client";
+export interface AIChatOptions {
+    agent: string;
+    message: string;
+    conversation_id?: string;
+    streaming?: boolean;
+    temperature?: number;
+    memory?: boolean;
+    metadata?: any;
+}
+export interface AIChatResponse {
+    response: string;
+    tokens_used?: number;
+    model?: string;
+    provider?: string;
+    agent?: string;
+    project_uid?: string;
+}
+export interface AIProvider {
+    id?: string;
+    provider_name: string;
+    base_url: string;
+    api_key?: string;
+    organization_id?: string;
+    headers_json?: any;
+    priority?: number;
+    enabled?: boolean;
+    created_at?: string;
+}
+export interface AIModel {
+    id?: string;
+    provider_id: string;
+    model_name: string;
+    context_window?: number;
+    input_cost?: number;
+    output_cost?: number;
+    supports_vision?: boolean;
+    supports_tools?: boolean;
+    supports_streaming?: boolean;
+    enabled?: boolean;
+}
+export interface AIAgent {
+    id?: string;
+    agent_name: string;
+    description?: string;
+    system_prompt?: string;
+    provider_id?: string;
+    model_id?: string;
+    temperature?: number;
+    memory_enabled?: boolean;
+    tool_permissions?: any;
+    visibility?: string;
+    rate_limit?: number;
+    status?: string;
+}
+export declare function aiChat(client: SupersoClient, options: AIChatOptions): Promise<AIChatResponse>;
+export declare function aiStreamChat(client: SupersoClient, options: AIChatOptions, onChunk: (chunk: string) => void): Promise<void>;
+export declare function getAIProviders(client: SupersoClient, token: string): Promise<any>;
+export declare function createAIProvider(client: SupersoClient, data: AIProvider, token: string): Promise<any>;
+export declare function updateAIProvider(client: SupersoClient, providerId: string, data: Partial<AIProvider>, token: string): Promise<any>;
+export declare function deleteAIProvider(client: SupersoClient, providerId: string, token: string): Promise<any>;
+export declare function getAIModels(client: SupersoClient, token: string): Promise<any>;
+export declare function createAIModel(client: SupersoClient, data: AIModel, token: string): Promise<any>;
+export declare function updateAIModel(client: SupersoClient, modelId: string, data: Partial<AIModel>, token: string): Promise<any>;
+export declare function deleteAIModel(client: SupersoClient, modelId: string, token: string): Promise<any>;
+export declare function getAIAgents(client: SupersoClient, token: string): Promise<any>;
+export declare function createAIAgent(client: SupersoClient, data: AIAgent, token: string): Promise<any>;
+export declare function updateAIAgent(client: SupersoClient, agentId: string, data: Partial<AIAgent>, token: string): Promise<any>;
+export declare function deleteAIAgent(client: SupersoClient, agentId: string, token: string): Promise<any>;
+export declare function getAISettings(client: SupersoClient, token: string): Promise<any>;
+export declare function updateAISettings(client: SupersoClient, data: any, token: string): Promise<any>;
+export declare function estimateTokens(text: string): number;
+export declare function estimateCost(inputTokens: number, outputTokens: number, inputCost: number, outputCost: number): number;
+export declare function supportsVision(model: AIModel): boolean;
+export declare function supportsTools(model: AIModel): boolean;
+export declare function supportsStreaming(model: AIModel): boolean;

package/dist/ai/ai.js

@@ -0,0 +1,133 @@
+// ======================================
+// REQUEST
+// ======================================
+// ======================================
+// REQUEST
+// ======================================
+async function request(client, endpoint, method = "GET", body, token) {
+    const headers = {
+        "Content-Type": "application/json",
+        "X-Superso-Project-Key": client.apiKey,
+    };
+    if (token) {
+        headers.Authorization =
+            `Bearer ${token}`;
+    }
+    const response = await fetch(`${client.baseUrl}/api/project/${client.projectId}${endpoint}`, {
+        method,
+        headers,
+        body: body
+            ? JSON.stringify(body)
+            : undefined,
+    });
+    const data = await response.json();
+    if (!response.ok) {
+        throw new Error((data === null || data === void 0 ? void 0 : data.message) ||
+            "AI request failed");
+    }
+    return data;
+}
+// ======================================
+// CHAT
+// ======================================
+export async function aiChat(client, options) {
+    return request(client, "/ai/chat", "POST", options);
+}
+// ======================================
+// STREAM CHAT
+// ======================================
+export async function aiStreamChat(client, options, onChunk) {
+    const response = await fetch(`${client.baseUrl}/api/project/${client.projectId}/ai/chat`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "X-Superso-Project-Key": client.apiKey,
+        },
+        body: JSON.stringify(Object.assign(Object.assign({}, options), { streaming: true })),
+    });
+    if (!response.body) {
+        throw new Error("Streaming not supported");
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        const chunk = decoder.decode(value);
+        onChunk(chunk);
+    }
+}
+// ======================================
+// PROVIDERS
+// ======================================
+export async function getAIProviders(client, token) {
+    return request(client, "/ai/providers", "GET", undefined, token);
+}
+export async function createAIProvider(client, data, token) {
+    return request(client, "/ai/providers", "POST", data, token);
+}
+export async function updateAIProvider(client, providerId, data, token) {
+    return request(client, `/ai/providers/${providerId}`, "PUT", data, token);
+}
+export async function deleteAIProvider(client, providerId, token) {
+    return request(client, `/ai/providers/${providerId}`, "DELETE", undefined, token);
+}
+// ======================================
+// MODELS
+// ======================================
+export async function getAIModels(client, token) {
+    return request(client, "/ai/models", "GET", undefined, token);
+}
+export async function createAIModel(client, data, token) {
+    return request(client, "/ai/models", "POST", data, token);
+}
+export async function updateAIModel(client, modelId, data, token) {
+    return request(client, `/ai/models/${modelId}`, "PUT", data, token);
+}
+export async function deleteAIModel(client, modelId, token) {
+    return request(client, `/ai/models/${modelId}`, "DELETE", undefined, token);
+}
+// ======================================
+// AGENTS
+// ======================================
+export async function getAIAgents(client, token) {
+    return request(client, "/ai/agents", "GET", undefined, token);
+}
+export async function createAIAgent(client, data, token) {
+    return request(client, "/ai/agents", "POST", data, token);
+}
+export async function updateAIAgent(client, agentId, data, token) {
+    return request(client, `/ai/agents/${agentId}`, "PUT", data, token);
+}
+export async function deleteAIAgent(client, agentId, token) {
+    return request(client, `/ai/agents/${agentId}`, "DELETE", undefined, token);
+}
+// ======================================
+// SETTINGS
+// ======================================
+export async function getAISettings(client, token) {
+    return request(client, "/ai/settings", "GET", undefined, token);
+}
+export async function updateAISettings(client, data, token) {
+    return request(client, "/ai/settings", "PUT", data, token);
+}
+// ======================================
+// HELPERS
+// ======================================
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+export function estimateCost(inputTokens, outputTokens, inputCost, outputCost) {
+    return ((inputTokens / 1000000) * inputCost +
+        (outputTokens / 1000000) * outputCost);
+}
+export function supportsVision(model) {
+    return !!model.supports_vision;
+}
+export function supportsTools(model) {
+    return !!model.supports_tools;
+}
+export function supportsStreaming(model) {
+    return !!model.supports_streaming;
+}

package/dist/ai/cache.d.ts

@@ -0,0 +1,4 @@
+export declare function setAICache(key: string, value: any): void;
+export declare function getAICache(key: string): any;
+export declare function removeAICache(key: string): void;
+export declare function clearAICache(): void;

package/dist/ai/cache.js

@@ -0,0 +1,29 @@
+const PREFIX = "superso_ai_";
+// ======================================
+// CACHE
+// ======================================
+export function setAICache(key, value) {
+    localStorage.setItem(PREFIX + key, JSON.stringify(value));
+}
+export function getAICache(key) {
+    const raw = localStorage.getItem(PREFIX + key);
+    if (!raw)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch (_a) {
+        return raw;
+    }
+}
+export function removeAICache(key) {
+    localStorage.removeItem(PREFIX + key);
+}
+export function clearAICache() {
+    Object.keys(localStorage)
+        .forEach(key => {
+        if (key.startsWith(PREFIX)) {
+            localStorage.removeItem(key);
+        }
+    });
+}

package/dist/ai/events.d.ts

@@ -0,0 +1,5 @@
+type Callback = (payload: any) => void;
+export declare function onAIEvent(event: string, callback: Callback): void;
+export declare function emitAIEvent(event: string, payload: any): void;
+export declare function removeAIEvent(event: string): void;
+export {};

package/dist/ai/events.js

@@ -0,0 +1,17 @@
+const listeners = {};
+export function onAIEvent(event, callback) {
+    if (!listeners[event]) {
+        listeners[event] = [];
+    }
+    listeners[event]
+        .push(callback);
+}
+export function emitAIEvent(event, payload) {
+    if (!listeners[event])
+        return;
+    listeners[event]
+        .forEach(callback => callback(payload));
+}
+export function removeAIEvent(event) {
+    delete listeners[event];
+}

package/dist/ai/middleware.d.ts

@@ -0,0 +1,3 @@
+export declare function rateLimit(key: string, limit?: number, windowMs?: number): boolean;
+export declare function requireAuth(token?: string): boolean;
+export declare function requireRole(userRole: string, allowed: string[]): boolean;

package/dist/ai/middleware.js

@@ -0,0 +1,39 @@
+// ======================================
+// RATE LIMIT
+// ======================================
+const requests = {};
+export function rateLimit(key, limit = 60, windowMs = 60000) {
+    const now = Date.now();
+    if (!requests[key]) {
+        requests[key] = [];
+    }
+    requests[key] =
+        requests[key]
+            .filter(timestamp => now - timestamp <
+            windowMs);
+    if (requests[key]
+        .length >= limit) {
+        throw new Error("Rate limit exceeded");
+    }
+    requests[key]
+        .push(now);
+    return true;
+}
+// ======================================
+// REQUIRE AUTH
+// ======================================
+export function requireAuth(token) {
+    if (!token) {
+        throw new Error("Authentication required");
+    }
+    return true;
+}
+// ======================================
+// REQUIRE ROLE
+// ======================================
+export function requireRole(userRole, allowed) {
+    if (!allowed.includes(userRole)) {
+        throw new Error("Permission denied");
+    }
+    return true;
+}

package/dist/auth/auth.d.ts

@@ -0,0 +1,66 @@
+import { SupersoClient } from "../core/client";
+type AuthListener = (payload: any) => void;
+export declare function clearSession(): void;
+export declare function getAccessToken(): string | null;
+export declare function getRefreshToken(): string | null;
+export declare function getStoredUser(): any;
+export declare function onAuthChange(callback: AuthListener): () => void;
+export declare function register(client: SupersoClient, payload: {
+    display_name?: string;
+    email: string;
+    password: string;
+}): Promise<any>;
+export declare function login(client: SupersoClient, payload: {
+    email: string;
+    password: string;
+}): Promise<any>;
+export declare function logout(client: SupersoClient): Promise<void>;
+export declare function refreshToken(client: SupersoClient): Promise<any>;
+export declare function restoreSession(client: SupersoClient): Promise<any>;
+export declare function getCurrentUser(client: SupersoClient): Promise<any>;
+export declare function updateProfile(client: SupersoClient, data: {
+    display_name?: string;
+    phone?: string;
+    bio?: string;
+    avatar_url?: string;
+    avatar_asset_id?: string;
+}): Promise<any>;
+export declare function changePassword(client: SupersoClient, data: {
+    current_password: string;
+    new_password: string;
+}): Promise<any>;
+export declare function changeEmail(client: SupersoClient, data: {
+    new_email: string;
+    password: string;
+}): Promise<any>;
+export declare function sendOtpLogin(client: SupersoClient, payload: {
+    email?: string;
+    phone?: string;
+}): Promise<any>;
+export declare function verifyEmail(client: SupersoClient, payload: {
+    email: string;
+    otp?: string;
+}): Promise<any>;
+export declare function verifyPhone(client: SupersoClient, payload: {
+    phone: string;
+    otp?: string;
+}): Promise<any>;
+export declare function sendPasswordReset(client: SupersoClient, payload: {
+    email: string;
+}): Promise<any>;
+export declare function confirmPasswordReset(client: SupersoClient, payload: {
+    email: string;
+    otp: string;
+    new_password: string;
+}): Promise<any>;
+export declare function sendMagicLink(client: SupersoClient, payload: {
+    email: string;
+}): Promise<any>;
+export declare function verifyMagicLink(client: SupersoClient, payload: {
+    email: string;
+    token: string;
+}): Promise<any>;
+export declare function getSessions(client: SupersoClient): Promise<any>;
+export declare function revokeSession(client: SupersoClient, sessionId: string): Promise<any>;
+export declare function revokeOtherSessions(client: SupersoClient): Promise<any>;
+export {};

package/dist/auth/auth.js

@@ -0,0 +1,285 @@
+// ================================
+// CONSTANTS
+// ================================
+const ACCESS_TOKEN_KEY = "superso_access_token";
+const REFRESH_TOKEN_KEY = "superso_refresh_token";
+const USER_KEY = "superso_auth_user";
+const listeners = new Set();
+function emitAuth(payload) {
+    listeners.forEach((callback) => callback(payload));
+}
+// ================================
+// JWT HELPERS
+// ================================
+function parseJwt(token) {
+    try {
+        return JSON.parse(atob(token.split(".")[1]));
+    }
+    catch (_a) {
+        return null;
+    }
+}
+function isTokenExpired(token) {
+    const decoded = parseJwt(token);
+    if (!(decoded === null || decoded === void 0 ? void 0 : decoded.exp))
+        return true;
+    return (Date.now() >=
+        decoded.exp *
+            1000 -
+            5 * 60 * 1000);
+}
+// ================================
+// SESSION HELPERS
+// ================================
+function saveSession(data) {
+    const token = data === null || data === void 0 ? void 0 : data.token;
+    const refreshToken = data === null || data === void 0 ? void 0 : data.refresh_token;
+    const user = data === null || data === void 0 ? void 0 : data.user;
+    if (token) {
+        localStorage.setItem(ACCESS_TOKEN_KEY, token);
+    }
+    if (refreshToken) {
+        localStorage.setItem(REFRESH_TOKEN_KEY, refreshToken);
+    }
+    if (user) {
+        localStorage.setItem(USER_KEY, JSON.stringify(user));
+    }
+    emitAuth({
+        user,
+    });
+}
+export function clearSession() {
+    localStorage.removeItem(ACCESS_TOKEN_KEY);
+    localStorage.removeItem(REFRESH_TOKEN_KEY);
+    localStorage.removeItem(USER_KEY);
+    emitAuth({
+        user: null,
+    });
+}
+export function getAccessToken() {
+    return localStorage.getItem(ACCESS_TOKEN_KEY);
+}
+export function getRefreshToken() {
+    return localStorage.getItem(REFRESH_TOKEN_KEY);
+}
+export function getStoredUser() {
+    const raw = localStorage.getItem(USER_KEY);
+    if (!raw)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch (_a) {
+        return null;
+    }
+}
+// ================================
+// CORE REQUEST
+// ================================
+async function request(client, endpoint, method = "GET", body = null, auth = false) {
+    let token = getAccessToken();
+    // auto refresh
+    if (auth &&
+        token &&
+        isTokenExpired(token)) {
+        try {
+            const refreshed = await refreshToken(client);
+            token =
+                refreshed === null || refreshed === void 0 ? void 0 : refreshed.token;
+        }
+        catch (_a) {
+            clearSession();
+        }
+    }
+    const headers = {
+        "Content-Type": "application/json",
+        "X-Superso-Project-Key": client.apiKey,
+    };
+    if (auth && token) {
+        headers["Authorization"] =
+            `Bearer ${token}`;
+    }
+    const response = await fetch(`${client.baseUrl}/api/project/${client.projectId}${endpoint}`, {
+        method,
+        headers,
+        body: body
+            ? JSON.stringify(body)
+            : undefined,
+    });
+    let data = {};
+    try {
+        data =
+            await response.json();
+    }
+    catch (_b) {
+        data = {};
+    }
+    if (!response.ok) {
+        throw new Error((data === null || data === void 0 ? void 0 : data.message) ||
+            "Request failed");
+    }
+    return data;
+}
+// ================================
+// AUTH STATE
+// ================================
+export function onAuthChange(callback) {
+    listeners.add(callback);
+    return () => {
+        listeners.delete(callback);
+    };
+}
+// ================================
+// MULTI TAB AUTH SYNC
+// ================================
+window.addEventListener("storage", (event) => {
+    if (event.key ===
+        ACCESS_TOKEN_KEY) {
+        emitAuth({
+            user: getStoredUser(),
+        });
+    }
+});
+// ================================
+// REGISTER
+// ================================
+export async function register(client, payload) {
+    const res = await request(client, "/auth/register", "POST", payload);
+    if (res === null || res === void 0 ? void 0 : res.token) {
+        saveSession(res);
+    }
+    return res;
+}
+// ================================
+// LOGIN
+// ================================
+export async function login(client, payload) {
+    const res = await request(client, "/auth/login", "POST", payload);
+    saveSession(res);
+    return res;
+}
+// ================================
+// LOGOUT
+// ================================
+export async function logout(client) {
+    try {
+        await request(client, "/auth/logout", "POST", {
+            refresh_token: getRefreshToken(),
+        }, true);
+    }
+    catch (_a) { }
+    clearSession();
+}
+// ================================
+// REFRESH TOKEN
+// ================================
+export async function refreshToken(client) {
+    const refresh_token = getRefreshToken();
+    if (!refresh_token) {
+        throw new Error("Missing refresh token");
+    }
+    const res = await request(client, "/auth/refresh-token", "POST", {
+        refresh_token,
+    });
+    saveSession(res);
+    emitAuth({
+        type: "token_rotated",
+        token: res === null || res === void 0 ? void 0 : res.token,
+    });
+    return res;
+}
+// ================================
+// RESTORE SESSION
+// ================================
+export async function restoreSession(client) {
+    const token = getAccessToken();
+    if (!token)
+        return null;
+    try {
+        if (isTokenExpired(token)) {
+            await refreshToken(client);
+        }
+        const me = await getCurrentUser(client);
+        emitAuth({
+            user: (me === null || me === void 0 ? void 0 : me.user) ||
+                (me === null || me === void 0 ? void 0 : me.data),
+        });
+        return me;
+    }
+    catch (_a) {
+        clearSession();
+        return null;
+    }
+}
+// ================================
+// CURRENT USER
+// ================================
+export async function getCurrentUser(client) {
+    return await request(client, "/auth/user/me", "GET", null, true);
+}
+// ================================
+// UPDATE PROFILE
+// ================================
+export async function updateProfile(client, data) {
+    return await request(client, "/auth/user/profile", "PUT", data, true);
+}
+// ================================
+// CHANGE PASSWORD
+// ================================
+export async function changePassword(client, data) {
+    return await request(client, "/auth/user/change-password", "POST", data, true);
+}
+// ================================
+// CHANGE EMAIL
+// ================================
+export async function changeEmail(client, data) {
+    return await request(client, "/auth/user/change-email", "POST", data, true);
+}
+// ================================
+// OTP LOGIN
+// ================================
+export async function sendOtpLogin(client, payload) {
+    return await request(client, "/auth/otp-login", "POST", payload);
+}
+// ================================
+// VERIFY EMAIL
+// ================================
+export async function verifyEmail(client, payload) {
+    return await request(client, "/auth/verify-email", "POST", payload);
+}
+// ================================
+// VERIFY PHONE
+// ================================
+export async function verifyPhone(client, payload) {
+    return await request(client, "/auth/verify-phone", "POST", payload);
+}
+// ================================
+// PASSWORD RESET
+// ================================
+export async function sendPasswordReset(client, payload) {
+    return await request(client, "/auth/send-reset", "POST", payload);
+}
+export async function confirmPasswordReset(client, payload) {
+    return await request(client, "/auth/confirm-reset", "POST", payload);
+}
+// ================================
+// MAGIC LINK
+// ================================
+export async function sendMagicLink(client, payload) {
+    return await request(client, "/auth/magic-link/send", "POST", payload);
+}
+export async function verifyMagicLink(client, payload) {
+    return await request(client, "/auth/magic-link/verify", "POST", payload);
+}
+// ================================
+// SESSIONS
+// ================================
+export async function getSessions(client) {
+    return await request(client, "/auth/user/sessions", "GET", null, true);
+}
+export async function revokeSession(client, sessionId) {
+    return await request(client, `/auth/user/sessions/${sessionId}`, "DELETE", null, true);
+}
+export async function revokeOtherSessions(client) {
+    return await request(client, "/auth/user/sessions", "DELETE", null, true);
+}

package/dist/core/client.d.ts

@@ -0,0 +1,12 @@
+export interface SupersoClientConfig {
+    projectId: string;
+    apiKey: string;
+    baseUrl?: string;
+}
+export declare class SupersoClient {
+    projectId: string;
+    apiKey: string;
+    baseUrl: string;
+    constructor(config: SupersoClientConfig);
+}
+export declare function createClient(config: SupersoClientConfig): SupersoClient;