@vaiftechnologies/vaif-client 0.1.0 → 0.1.1

package/dist/index.d.mts

@@ -5,11 +5,23 @@ interface VaifClientOptions {
     /**
      * Your VAIF Studio project ID
      */
-    projectId: string;
+    projectId?: string;
     /**
      * API key for authentication (use anon key for client-side)
      */
-    apiKey: string;
+    apiKey?: string;
+    /**
+     * Base URL for API requests (alternative to apiUrl for admin clients)
+     */
+    baseUrl?: string;
+    /**
+     * Pre-set access token for authenticated requests
+     */
+    accessToken?: string;
+    /**
+     * Custom header name for API key (default: apikey)
+     */
+    apiKeyHeader?: string;
     /**
      * Custom API endpoint (defaults to https://api.vaif.studio)
      */
@@ -49,6 +61,7 @@ interface VaifClientOptions {
 interface VaifConfig {
     projectId: string;
     apiKey: string;
+    apiKeyHeader: string;
     apiUrl: string;
     realtimeUrl: string;
     timeout: number;
@@ -2418,6 +2431,360 @@ declare class VaifTypeGen {
  */
 declare function createTypeGen(client: VaifClient): VaifTypeGen;
 
+/**
+ * VAIF Admin Client
+ *
+ * Admin-only API endpoints for platform management
+ */
+
+interface AdminOverview {
+    users: {
+        total: number;
+        active: number;
+        new24h: number;
+    };
+    orgs: {
+        total: number;
+        active: number;
+    };
+    projects: {
+        total: number;
+        active: number;
+    };
+    requests: {
+        total24h: number;
+        errors24h: number;
+    };
+    revenue: {
+        mrr: number;
+        arr: number;
+    };
+}
+interface AdminUser {
+    id: string;
+    email: string;
+    name: string | null;
+    avatarUrl: string | null;
+    role: string;
+    status: string;
+    createdAt: string;
+}
+interface AdminOrg {
+    id: string;
+    name: string;
+    slug: string;
+    plan: string;
+    memberCount: number;
+    projectCount: number;
+    createdAt: string;
+}
+interface AdminProject {
+    id: string;
+    name: string;
+    orgId: string;
+    orgName: string;
+    region: string;
+    status: string;
+    createdAt: string;
+}
+interface AdminIncident {
+    id: string;
+    title: string;
+    description: string;
+    severity: string;
+    status: string;
+    category: string;
+    createdAt: string;
+    acknowledgedAt: string | null;
+    resolvedAt: string | null;
+}
+interface HealthComponent {
+    id: string;
+    name: string;
+    status: string;
+    message: string | null;
+    updatedAt: string;
+}
+interface QueueInfo {
+    name: string;
+    waiting: number;
+    active: number;
+    completed: number;
+    failed: number;
+    delayed: number;
+}
+interface FeatureFlag {
+    key: string;
+    enabled: boolean;
+    description: string | null;
+    updatedAt: string;
+}
+interface Region {
+    key: string;
+    name: string;
+    provider: string;
+    enabled: boolean;
+}
+interface AdminAdmin {
+    id: string;
+    userId: string;
+    email: string;
+    name: string | null;
+    role: string;
+    notes: string | null;
+    createdAt: string;
+}
+interface AIModel {
+    id: string;
+    modelId: string;
+    provider: string;
+    displayName: string;
+    tier: string;
+    enabled: boolean;
+    inputPrice: number;
+    outputPrice: number;
+    maxTokens: number;
+    contextWindow: number;
+    capabilities: string[];
+    createdAt: string;
+}
+interface PromptTemplate {
+    id: string;
+    name: string;
+    category: string;
+    template: string;
+    variables: string[];
+    description: string | null;
+    createdAt: string;
+}
+interface AISession {
+    id: string;
+    userId: string;
+    projectId: string;
+    modelId: string;
+    status: string;
+    messageCount: number;
+    totalTokens: number;
+    createdAt: string;
+}
+interface GeneratedBackend {
+    id: string;
+    userId: string;
+    projectId: string | null;
+    name: string;
+    description: string | null;
+    status: string;
+    framework: string | null;
+    language: string | null;
+    fileCount: number | null;
+    files: Record<string, string> | null;
+    createdAt: string;
+}
+interface ContextSnapshot {
+    id: string;
+    projectId: string;
+    contextType: string;
+    validUntil: string;
+    createdAt: string;
+}
+interface CopilotSession {
+    id: string;
+    projectId: string;
+    userId: string;
+    title: string | null;
+    status: string;
+    messageCount: number;
+    totalTokens: number;
+    createdAt: string;
+}
+interface CopilotOverview {
+    overview: {
+        totalSessions: number;
+        sessions24h: number;
+        totalMessages: number;
+        messages24h: number;
+        totalCreditsUsed: number;
+        sessionsByStatus: Record<string, number>;
+    };
+    classification: {
+        stats: Array<{
+            method: string;
+            total: number;
+            correct: number;
+            accuracy: string;
+        }>;
+        intentDistribution: Array<{
+            intent: string;
+            count: number;
+        }>;
+    };
+    execution: {
+        total: number;
+        completed: number;
+        failed: number;
+        rolledBack: number;
+        successRate: string;
+    } | null;
+    trends: {
+        dailySessions: Array<{
+            date: string;
+            count: number;
+        }>;
+    };
+}
+interface DlqMessage {
+    id: string;
+    queueName: string;
+    data: unknown;
+    error: string;
+    failedAt: string;
+    retryCount: number;
+}
+/**
+ * Admin API Client
+ */
+declare class VaifAdmin {
+    private client;
+    constructor(client: VaifClient);
+    private request;
+    getOverview(): Promise<AdminOverview>;
+    getSettings(): Promise<{
+        settings: Record<string, unknown>;
+    }>;
+    listUsers(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        users: AdminUser[];
+        total: number;
+    }>;
+    listOrganizations(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        orgs: AdminOrg[];
+        total: number;
+    }>;
+    listProjects(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        projects: AdminProject[];
+        total: number;
+    }>;
+    listIncidents(status?: string): Promise<AdminIncident[]>;
+    createIncident(data: {
+        title: string;
+        description: string;
+        severity: string;
+        category: string;
+    }): Promise<AdminIncident>;
+    acknowledgeIncident(incidentId: string): Promise<void>;
+    resolveIncident(incidentId: string): Promise<void>;
+    getHealthComponents(): Promise<{
+        components: HealthComponent[];
+    }>;
+    updateHealthComponent(name: string, data: {
+        status: string;
+        message?: string;
+    }): Promise<void>;
+    listQueues(): Promise<{
+        queues: QueueInfo[];
+    }>;
+    listFeatureFlags(): Promise<{
+        flags: FeatureFlag[];
+    }>;
+    createFeatureFlag(key: string, enabled: boolean): Promise<FeatureFlag>;
+    updateFeatureFlag(key: string, enabled: boolean): Promise<void>;
+    deleteFeatureFlag(key: string): Promise<void>;
+    listRegions(): Promise<{
+        regions: Region[];
+    }>;
+    updateRegion(key: string, data: {
+        enabled: boolean;
+    }): Promise<void>;
+    listAdmins(): Promise<AdminAdmin[]>;
+    addAdmin(userId: string, role: string, notes?: string): Promise<AdminAdmin>;
+    updateAdmin(adminId: string, data: {
+        role?: string;
+        notes?: string;
+    }): Promise<void>;
+    removeAdmin(adminId: string): Promise<void>;
+    listAIModels(): Promise<{
+        models: AIModel[];
+    }>;
+    createAIModel(data: Partial<AIModel>): Promise<AIModel>;
+    updateAIModel(modelId: string, data: Partial<AIModel>): Promise<void>;
+    toggleAIModel(modelId: string, enabled: boolean, message?: string): Promise<void>;
+    deleteAIModel(modelId: string): Promise<void>;
+    listPromptTemplates(params?: {
+        limit?: number;
+    }): Promise<{
+        templates: PromptTemplate[];
+    }>;
+    createPromptTemplate(data: Partial<PromptTemplate>): Promise<PromptTemplate>;
+    updatePromptTemplate(id: string, data: Partial<PromptTemplate>): Promise<void>;
+    deletePromptTemplate(id: string): Promise<void>;
+    listAISessions(params?: {
+        limit?: number;
+        offset?: number;
+        status?: string;
+        search?: string;
+    }): Promise<{
+        sessions: AISession[];
+        total: number;
+    }>;
+    getAISession(sessionId: string): Promise<{
+        session: AISession;
+    }>;
+    deleteAISession(sessionId: string): Promise<void>;
+    listGeneratedBackends(params?: {
+        limit?: number;
+        offset?: number;
+        search?: string;
+    }): Promise<{
+        backends: GeneratedBackend[];
+        total: number;
+    }>;
+    getGeneratedBackend(backendId: string): Promise<{
+        backend: GeneratedBackend;
+    }>;
+    deleteGeneratedBackend(backendId: string): Promise<void>;
+    listContextSnapshots(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        snapshots: ContextSnapshot[];
+        total: number;
+    }>;
+    invalidateContextSnapshot(snapshotId: string): Promise<void>;
+    deleteContextSnapshot(snapshotId: string): Promise<void>;
+    getCopilotOverview(): Promise<CopilotOverview>;
+    listCopilotSessions(params?: {
+        limit?: number;
+        offset?: number;
+        status?: string;
+        search?: string;
+    }): Promise<{
+        sessions: CopilotSession[];
+        total: number;
+    }>;
+    getCopilotSession(sessionId: string): Promise<{
+        session: CopilotSession;
+        messages: unknown[];
+        plans: unknown[];
+        executions: unknown[];
+    }>;
+    deleteCopilotSession(sessionId: string): Promise<void>;
+    listDlqMessages(params?: {
+        limit?: number;
+    }): Promise<{
+        messages: DlqMessage[];
+    }>;
+    retryDlqMessage(messageId: string): Promise<void>;
+    archiveDlqMessage(messageId: string): Promise<void>;
+}
+
 /**
  * VAIF Studio Client
  *
@@ -2478,6 +2845,10 @@ declare class VaifClient {
      * Type generator for generating TypeScript types from database schema
      */
     readonly typegen: VaifTypeGen;
+    /**
+     * Admin client for platform management (admin-only endpoints)
+     */
+    readonly admin: VaifAdmin;
     constructor(options: VaifClientOptions);
     /**
      * Get current configuration
@@ -2505,4 +2876,4 @@ declare class VaifClient {
     debug(...args: unknown[]): void;
 }
 
-export { type AIGenerateOptions, type ApiError, type ApiResponse, type AuthOptions, type AuthResponse, type Bucket, type ColumnSchema, type DatabaseSchema, type DeleteQuery, type DownloadOptions, type EndpointGenerationResult, type EnumSchema, type FileObject, type FilterOperator, type ForeignKeySchema, type FunctionGenerationResult, type FunctionInvokeOptions, type FunctionResponse, type IndexSchema, type InsertQuery, type OrderDirection, type QueryBuilder$1 as QueryBuilder, RealtimeChannel, type RealtimeEvent, type RealtimeMessage, type RealtimeOptions, type RequestOptions, type SchemaGenerationResult, type SelectQuery, type Session, type SignInCredentials, type SignUpCredentials, type StorageOptions, type SubscriptionCallback, type TableSchema, type TypeGenOptions, type UpdateQuery, type UploadOptions, type User, VaifAI, VaifAuth, VaifClient, type VaifClientOptions, type VaifConfig, VaifDatabase, VaifFunctions, VaifRealtime, VaifStorage, VaifTypeGen, type ViewSchema, createClient, createTypeGen };
+export { type AIGenerateOptions, type AIModel, type AISession, type AdminAdmin, type AdminIncident, type AdminOrg, type AdminOverview, type AdminProject, type AdminUser, type ApiError, type ApiResponse, type AuthOptions, type AuthResponse, type Bucket, type ColumnSchema, type ContextSnapshot, type CopilotOverview, type CopilotSession, type DatabaseSchema, type DeleteQuery, type DlqMessage, type DownloadOptions, type EndpointGenerationResult, type EnumSchema, type FeatureFlag, type FileObject, type FilterOperator, type ForeignKeySchema, type FunctionGenerationResult, type FunctionInvokeOptions, type FunctionResponse, type GeneratedBackend, type HealthComponent, type IndexSchema, type InsertQuery, type OrderDirection, type PromptTemplate, type QueryBuilder$1 as QueryBuilder, type QueueInfo, RealtimeChannel, type RealtimeEvent, type RealtimeMessage, type RealtimeOptions, type Region, type RequestOptions, type SchemaGenerationResult, type SelectQuery, type Session, type SignInCredentials, type SignUpCredentials, type StorageOptions, type SubscriptionCallback, type TableSchema, type TypeGenOptions, type UpdateQuery, type UploadOptions, type User, VaifAI, VaifAdmin, VaifAuth, VaifClient, type VaifClientOptions, type VaifConfig, VaifDatabase, VaifFunctions, VaifRealtime, VaifStorage, VaifTypeGen, type ViewSchema, createClient, createTypeGen, createClient as createVaifClient };