@ragbits/api-client 1.4.0-dev.202512050236 → 1.4.0

package/dist/autogen.types.d.ts

@@ -30,23 +30,12 @@ export declare const MessageRole: {
     readonly System: "system";
 };
 export type MessageRole = TypeFrom<typeof MessageRole>;
-/**
- * Represents the TaskStatus enum
- */
-export declare const TaskStatus: {
-    readonly Pending: "pending";
-    readonly InProgress: "in_progress";
-    readonly Completed: "completed";
-    readonly Failed: "failed";
-    readonly Cancelled: "cancelled";
-    readonly Retrying: "retrying";
-};
-export type TaskStatus = TypeFrom<typeof TaskStatus>;
 /**
  * Represents the AuthType enum
  */
 export declare const AuthType: {
     readonly Credentials: "credentials";
+    readonly Oauth2: "oauth2";
 };
 export type AuthType = TypeFrom<typeof AuthType>;
 /**
@@ -61,11 +50,9 @@ export interface ChatContext {
     user: User | null;
     session_id: string | null;
     /**
-     * List of confirmed/declined tools from the frontend
+     * User's timezone in IANA format (e.g., 'Europe/Warsaw', 'America/New_York')
      */
-    confirmed_tools: {
-        [k: string]: unknown;
-    }[] | null;
+    timezone: string | null;
     [k: string]: unknown;
 }
 /**
@@ -154,33 +141,6 @@ export interface MessageUsage {
     completion_tokens: number;
     total_tokens: number;
 }
-/**
- * Simple task representation.
- */
-export interface Task {
-    id: string;
-    description: string;
-    /**
-     * Task status options.
-     */
-    status: 'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled' | 'retrying';
-    order: number;
-    summary: string | null;
-    parent_id: string | null;
-    full_response: string | null;
-    dependencies: string[];
-}
-/**
- * Represents a tool confirmation request sent to the user.
- */
-export interface ConfirmationRequest {
-    confirmation_id: string;
-    tool_name: string;
-    tool_description: string;
-    arguments: {
-        [k: string]: unknown;
-    };
-}
 /**
  * Text content wrapper.
  */
@@ -220,16 +180,10 @@ export interface UsageContent {
     };
 }
 /**
- * Todo item content wrapper.
- */
-export interface TodoItemContent {
-    task: Task;
-}
-/**
- * Confirmation request content wrapper.
+ * Error content wrapper for displaying error messages to users.
  */
-export interface ConfirmationRequestContent {
-    confirmation_request: ConfirmationRequest;
+export interface ErrorContent {
+    message: string;
 }
 /**
  * Customization for the header section of the UI.
@@ -304,6 +258,10 @@ export interface ConfigResponse {
      */
     customization: UICustomization | null;
     user_settings: UserSettings;
+    /**
+     * Flag indicating whether API supports file upload
+     */
+    supports_upload: boolean;
     /**
      * Debug mode flag
      */
@@ -327,6 +285,48 @@ export interface FeedbackResponse {
      */
     status: string;
 }
+/**
+ * Response for OAuth2 authorization URL request
+ */
+export interface OAuth2AuthorizeResponse {
+    /**
+     * URL to redirect user to for OAuth2 authorization
+     */
+    authorize_url: string;
+    /**
+     * State parameter for CSRF protection
+     */
+    state: string;
+}
+/**
+ * Configuration for an OAuth2 provider including visual configuration.
+ */
+export interface OAuth2ProviderConfig {
+    /**
+     * Provider name (e.g., 'discord')
+     */
+    name: string;
+    /**
+     * Display name for the provider (e.g., 'Discord')
+     */
+    display_name: string | null;
+    /**
+     * Brand color for the provider (e.g., '#5865F2')
+     */
+    color: string | null;
+    /**
+     * Button background color (defaults to color)
+     */
+    button_color: string | null;
+    /**
+     * Button text color (defaults to white)
+     */
+    text_color: string | null;
+    /**
+     * SVG icon as string
+     */
+    icon_svg: string | null;
+}
 /**
  * Client-side chat request interface.
  */
@@ -377,45 +377,30 @@ export interface AuthenticationConfig {
      * List of available authentication types
      */
     auth_types: AuthType[];
-}
-/**
- * Request body for user login
- */
-export interface CredentialsLoginRequest {
-    /**
-     * Username
-     */
-    username: string;
     /**
-     * Password
+     * List of available OAuth2 providers
      */
-    password: string;
+    oauth2_providers: OAuth2ProviderConfig[];
 }
 /**
- * Represents a JWT authentication jwt_token.
+ * Represents user login credentials.
  */
-export interface JWTToken {
-    access_token: string;
-    token_type: string;
-    expires_in: number;
-    refresh_token: string | null;
-    user: User;
+export interface UserCredentials {
+    username: string;
+    password: string;
 }
 /**
- * Request body for user login
+ * Represents user login credentials.
  */
 export interface LoginRequest {
-    /**
-     * Username
-     */
     username: string;
-    /**
-     * Password
-     */
     password: string;
 }
 /**
- * Response body for successful login
+ * Response body for login with session-based authentication.
+ *
+ * The session ID is set as an HTTP-only cookie by the backend.
+ * Frontend only receives user information.
  */
 export interface LoginResponse {
     /**
@@ -430,19 +415,6 @@ export interface LoginResponse {
      * Error message if login failed
      */
     error_message: string | null;
-    /**
-     * Access jwt_token
-     */
-    jwt_token: JWTToken | null;
-}
-/**
- * Request body for user logout
- */
-export interface LogoutRequest {
-    /**
-     * Session ID to logout
-     */
-    token: string;
 }
 /**
  * Represents an authenticated user.
@@ -500,17 +472,13 @@ export interface ClearMessageChatResponse {
     type: 'clear_message';
     content: unknown;
 }
-export interface TodoItemChatResonse {
-    type: 'todo_item';
-    content: TodoItemContent;
-}
 export interface ConversationSummaryResponse {
     type: 'conversation_summary';
     content: ConversationSummaryContent;
 }
-export interface ConfirmationRequestChatResponse {
-    type: 'confirmation_request';
-    content: ConfirmationRequestContent;
+export interface ErrorChatResponse {
+    type: 'error';
+    content: ErrorContent;
 }
 export interface ChunkedChatResponse {
     type: 'chunked_content';
@@ -519,4 +487,4 @@ export interface ChunkedChatResponse {
 /**
  * Typed chat response union
  */
-export type ChatResponse = TextChatResponse | ReferenceChatResponse | MessageIdChatResponse | ConversationIdChatResponse | StateUpdateChatResponse | LiveUpdateChatResponse | FollowupMessagesChatResponse | ImageChatResponse | MessageUsageChatResponse | ClearMessageChatResponse | TodoItemChatResonse | ConversationSummaryResponse | ConfirmationRequestChatResponse;
+export type ChatResponse = TextChatResponse | ReferenceChatResponse | MessageIdChatResponse | ConversationIdChatResponse | StateUpdateChatResponse | LiveUpdateChatResponse | FollowupMessagesChatResponse | ImageChatResponse | MessageUsageChatResponse | ClearMessageChatResponse | ConversationSummaryResponse | ErrorChatResponse;

package/dist/index.cjs

@@ -24,8 +24,7 @@ __export(index_exports, {
   FeedbackType: () => FeedbackType,
   LiveUpdateType: () => LiveUpdateType,
   MessageRole: () => MessageRole,
-  RagbitsClient: () => RagbitsClient,
-  TaskStatus: () => TaskStatus
+  RagbitsClient: () => RagbitsClient
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -43,16 +42,9 @@ var MessageRole = {
   Assistant: "assistant",
   System: "system"
 };
-var TaskStatus = {
-  Pending: "pending",
-  InProgress: "in_progress",
-  Completed: "completed",
-  Failed: "failed",
-  Cancelled: "cancelled",
-  Retrying: "retrying"
-};
 var AuthType = {
-  Credentials: "credentials"
+  Credentials: "credentials",
+  Oauth2: "oauth2"
 };
 
 // src/index.ts
@@ -99,6 +91,9 @@ var RagbitsClient = class {
     const defaultHeaders = {
       "Content-Type": "application/json"
     };
+    if (options.body instanceof FormData) {
+      delete defaultHeaders["Content-Type"];
+    }
     const headers = {
       ...defaultHeaders,
       ...this.normalizeHeaders(options.headers)
@@ -106,7 +101,11 @@ var RagbitsClient = class {
     if (this.auth?.getToken) {
       headers["Authorization"] = `Bearer ${this.auth.getToken()}`;
     }
-    const response = await fetch(url, { ...options, headers });
+    const response = await fetch(url, {
+      ...options,
+      headers,
+      ...this.auth?.credentials ? { credentials: this.auth?.credentials } : {}
+    });
     if (response.status === 401) {
       this.auth?.onUnauthorized?.();
     }
@@ -136,10 +135,17 @@ var RagbitsClient = class {
       ...restOptions
     };
     if (body && method !== "GET") {
-      requestOptions.body = typeof body === "string" ? body : JSON.stringify(body);
+      if (body instanceof FormData) {
+        requestOptions.body = body;
+        if (requestOptions.headers && "Content-Type" in requestOptions.headers) {
+          delete requestOptions.headers["Content-Type"];
+        }
+      } else {
+        requestOptions.body = typeof body === "string" ? body : JSON.stringify(body);
+      }
     }
     let url = endpoint.toString();
-    if (pathParams) {
+    if (pathParams && typeof pathParams === "object") {
       url = url.replace(/:([^/]+)/g, (_, paramName) => {
         if (paramName in pathParams) {
           const value = pathParams[paramName];
@@ -191,17 +197,19 @@ var RagbitsClient = class {
             if (!line.startsWith("data: ")) continue;
             try {
               const jsonString = line.replace("data: ", "").trim();
-              const parsedData = JSON.parse(
-                jsonString
-              );
+              const parsedData = JSON.parse(jsonString);
+              if (!this.isChatResponse(parsedData)) {
+                console.warn(
+                  "Received response that isn't ChatResponse, skipping.",
+                  parsedData
+                );
+                continue;
+              }
               if (parsedData.type === "chunked_content") {
                 this.handleChunkedContent(parsedData, callbacks);
                 continue;
               }
               await callbacks.onMessage(parsedData);
-              await new Promise(
-                (resolve) => setTimeout(resolve, 0)
-              );
             } catch (parseError) {
               console.error("Error parsing JSON:", parseError);
               await callbacks.onError(
@@ -238,7 +246,8 @@ var RagbitsClient = class {
             method: "POST",
             headers,
             body: JSON.stringify(data),
-            signal
+            signal,
+            ...this.auth?.credentials ? { credentials: this.auth?.credentials } : {}
           }
         );
         if (response.status === 401) {
@@ -267,6 +276,9 @@ var RagbitsClient = class {
       isCancelled = true;
     };
   }
+  isChatResponse(response) {
+    return response !== null && typeof response === "object" && "type" in response && "content" in response;
+  }
   normalizeHeaders(init) {
     if (!init) return {};
     if (init instanceof Headers) {
@@ -329,6 +341,5 @@ var RagbitsClient = class {
   FeedbackType,
   LiveUpdateType,
   MessageRole,
-  RagbitsClient,
-  TaskStatus
+  RagbitsClient
 });

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { ClientConfig, StreamCallbacks, BaseApiEndpoints, EndpointDefinition, EndpointResponse, BaseStreamingEndpoints, EndpointRequest, MakeRequestOptions } from './types';
+import type { ClientConfig, StreamCallbacks, BaseApiEndpoints, EndpointResponse, BaseStreamingEndpoints, EndpointRequest, MakeRequestOptions, AnyEndpoints } from './types';
 /**
  * Client for communicating with the Ragbits API
  */
@@ -29,9 +29,7 @@ export declare class RagbitsClient {
      * @param endpoint - API endpoint path
      * @param options - Typed request options for the specific endpoint
      */
-    makeRequest<Endpoints extends {
-        [K in keyof Endpoints]: EndpointDefinition<any, any, any, any>;
-    } = BaseApiEndpoints, URL extends keyof Endpoints = keyof Endpoints>(endpoint: URL, ...args: MakeRequestOptions<URL, Endpoints>): Promise<EndpointResponse<URL, Endpoints>>;
+    makeRequest<Endpoints extends AnyEndpoints<Endpoints> = BaseApiEndpoints, URL extends keyof Endpoints = keyof Endpoints>(endpoint: URL, ...args: MakeRequestOptions<URL, Endpoints>): Promise<EndpointResponse<URL, Endpoints>>;
     /**
      * Method for streaming requests to known endpoints only
      * @param endpoint - Streaming endpoint path
@@ -39,9 +37,8 @@ export declare class RagbitsClient {
      * @param callbacks - Stream callbacks
      * @param signal - Optional AbortSignal for cancelling the request
      */
-    makeStreamRequest<Endpoints extends {
-        [K in keyof Endpoints]: EndpointDefinition<any, any, any, any>;
-    } = BaseStreamingEndpoints, URL extends keyof Endpoints = keyof Endpoints>(endpoint: URL, data: EndpointRequest<URL, Endpoints>, callbacks: StreamCallbacks<EndpointResponse<URL, Endpoints>>, signal?: AbortSignal, customHeaders?: Record<string, string>): () => void;
+    makeStreamRequest<Endpoints extends AnyEndpoints<Endpoints> = BaseStreamingEndpoints, URL extends keyof Endpoints = keyof Endpoints>(endpoint: URL, data: EndpointRequest<URL, Endpoints>, callbacks: StreamCallbacks<EndpointResponse<URL, Endpoints>>, signal?: AbortSignal, customHeaders?: Record<string, string>): () => void;
+    private isChatResponse;
     private normalizeHeaders;
     private handleChunkedContent;
 }

package/dist/index.js

@@ -12,16 +12,9 @@ var MessageRole = {
   Assistant: "assistant",
   System: "system"
 };
-var TaskStatus = {
-  Pending: "pending",
-  InProgress: "in_progress",
-  Completed: "completed",
-  Failed: "failed",
-  Cancelled: "cancelled",
-  Retrying: "retrying"
-};
 var AuthType = {
-  Credentials: "credentials"
+  Credentials: "credentials",
+  Oauth2: "oauth2"
 };
 
 // src/index.ts
@@ -68,6 +61,9 @@ var RagbitsClient = class {
     const defaultHeaders = {
       "Content-Type": "application/json"
     };
+    if (options.body instanceof FormData) {
+      delete defaultHeaders["Content-Type"];
+    }
     const headers = {
       ...defaultHeaders,
       ...this.normalizeHeaders(options.headers)
@@ -75,7 +71,11 @@ var RagbitsClient = class {
     if (this.auth?.getToken) {
       headers["Authorization"] = `Bearer ${this.auth.getToken()}`;
     }
-    const response = await fetch(url, { ...options, headers });
+    const response = await fetch(url, {
+      ...options,
+      headers,
+      ...this.auth?.credentials ? { credentials: this.auth?.credentials } : {}
+    });
     if (response.status === 401) {
       this.auth?.onUnauthorized?.();
     }
@@ -105,10 +105,17 @@ var RagbitsClient = class {
       ...restOptions
     };
     if (body && method !== "GET") {
-      requestOptions.body = typeof body === "string" ? body : JSON.stringify(body);
+      if (body instanceof FormData) {
+        requestOptions.body = body;
+        if (requestOptions.headers && "Content-Type" in requestOptions.headers) {
+          delete requestOptions.headers["Content-Type"];
+        }
+      } else {
+        requestOptions.body = typeof body === "string" ? body : JSON.stringify(body);
+      }
     }
     let url = endpoint.toString();
-    if (pathParams) {
+    if (pathParams && typeof pathParams === "object") {
       url = url.replace(/:([^/]+)/g, (_, paramName) => {
         if (paramName in pathParams) {
           const value = pathParams[paramName];
@@ -160,17 +167,19 @@ var RagbitsClient = class {
             if (!line.startsWith("data: ")) continue;
             try {
               const jsonString = line.replace("data: ", "").trim();
-              const parsedData = JSON.parse(
-                jsonString
-              );
+              const parsedData = JSON.parse(jsonString);
+              if (!this.isChatResponse(parsedData)) {
+                console.warn(
+                  "Received response that isn't ChatResponse, skipping.",
+                  parsedData
+                );
+                continue;
+              }
               if (parsedData.type === "chunked_content") {
                 this.handleChunkedContent(parsedData, callbacks);
                 continue;
               }
               await callbacks.onMessage(parsedData);
-              await new Promise(
-                (resolve) => setTimeout(resolve, 0)
-              );
             } catch (parseError) {
               console.error("Error parsing JSON:", parseError);
               await callbacks.onError(
@@ -207,7 +216,8 @@ var RagbitsClient = class {
             method: "POST",
             headers,
             body: JSON.stringify(data),
-            signal
+            signal,
+            ...this.auth?.credentials ? { credentials: this.auth?.credentials } : {}
           }
         );
         if (response.status === 401) {
@@ -236,6 +246,9 @@ var RagbitsClient = class {
       isCancelled = true;
     };
   }
+  isChatResponse(response) {
+    return response !== null && typeof response === "object" && "type" in response && "content" in response;
+  }
   normalizeHeaders(init) {
     if (!init) return {};
     if (init instanceof Headers) {
@@ -297,6 +310,5 @@ export {
   FeedbackType,
   LiveUpdateType,
   MessageRole,
-  RagbitsClient,
-  TaskStatus
+  RagbitsClient
 };

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import { ConfigResponse, FeedbackRequest, FeedbackResponse, ChatRequest, ChatResponse, LogoutRequest, LoginRequest, LoginResponse } from './autogen.types';
+import { ConfigResponse, FeedbackRequest, FeedbackResponse, ChatRequest, ChatResponse, LoginRequest, LoginResponse, User, OAuth2AuthorizeResponse } from './autogen.types';
 export interface GenericResponse {
     success: boolean;
 }
@@ -10,6 +10,7 @@ export interface ClientConfig {
     auth?: {
         getToken?: () => string;
         onUnauthorized?: () => Promise<void> | void;
+        credentials?: RequestCredentials;
     };
 }
 /**
@@ -20,7 +21,7 @@ export interface StreamCallbacks<T, E = Error> {
     onError: (error: E) => void | Promise<void>;
     onClose?: () => void | Promise<void>;
 }
-export interface EndpointDefinition<Req = any, Res = any, PathParams = never, QueryParams = never> {
+export interface EndpointDefinition<Req = unknown, Res = unknown, PathParams = never, QueryParams = never> {
     method: string;
     request: Req;
     response: Res;
@@ -34,8 +35,16 @@ export interface BaseApiEndpoints {
     '/api/config': EndpointDefinition<never, ConfigResponse>;
     '/api/feedback': EndpointDefinition<FeedbackRequest, FeedbackResponse>;
     '/api/auth/login': EndpointDefinition<LoginRequest, LoginResponse>;
-    '/api/auth/logout': EndpointDefinition<LogoutRequest, GenericResponse>;
+    '/api/auth/logout': EndpointDefinition<never, GenericResponse>;
+    '/api/auth/authorize/:provider': EndpointDefinition<never, OAuth2AuthorizeResponse, {
+        provider: string;
+    }>;
+    '/api/user': EndpointDefinition<never, User>;
     '/api/theme': EndpointDefinition<never, string>;
+    '/api/upload': EndpointDefinition<FormData, {
+        status: string;
+        filename: string;
+    }>;
 }
 /**
  * Streaming API endpoint definitions with their request/stream response types
@@ -43,36 +52,32 @@ export interface BaseApiEndpoints {
 export interface BaseStreamingEndpoints {
     '/api/chat': EndpointDefinition<ChatRequest, ChatResponse>;
 }
+type AnyEndpointDefinition = EndpointDefinition<unknown, unknown, unknown, unknown>;
+export type AnyEndpoints<T> = {
+    [K in keyof T]: AnyEndpointDefinition;
+};
 /**
  * Extract endpoint paths as a union type
  */
-export type EndpointPath<Endpoints extends {
-    [K in keyof Endpoints]: EndpointDefinition<any, any, any, any>;
-}> = keyof Endpoints;
+export type EndpointPath<Endpoints extends AnyEndpoints<Endpoints>> = keyof Endpoints;
 /**
  * Extract request type for a specific API endpoint
  */
-export type EndpointRequest<URL extends keyof Endpoints, Endpoints extends {
-    [K in keyof Endpoints]: EndpointDefinition<any, any, any, any>;
-}> = Endpoints[URL]['request'];
+export type EndpointRequest<URL extends keyof Endpoints, Endpoints extends AnyEndpoints<Endpoints>> = Endpoints[URL]['request'];
 /**
  * Extract response type for a specific API endpoint
  */
-export type EndpointResponse<URL extends keyof Endpoints, Endpoints extends {
-    [K in keyof Endpoints]: EndpointDefinition<any, any, any, any>;
-}> = Endpoints[URL]['response'];
+export type EndpointResponse<URL extends keyof Endpoints, Endpoints extends AnyEndpoints<Endpoints>> = Endpoints[URL]['response'];
 /**
  * Extract HTTP method for a specific API endpoint
  */
-export type EndpointMethod<URL extends keyof Endpoints, Endpoints extends {
-    [K in keyof Endpoints]: EndpointDefinition<any, any, any, any>;
-}> = Endpoints[URL]['method'];
+export type EndpointMethod<URL extends keyof Endpoints, Endpoints extends AnyEndpoints<Endpoints>> = Endpoints[URL]['method'];
 /**
  * Check if an object type has any required properties
  * - {} extends T means all properties are optional → false
  * - {} doesn't extend T means at least one property is required → true
  */
-export type HasRequiredKeys<T> = [T] extends [never] ? false : {} extends T ? false : true;
+export type HasRequiredKeys<T> = [T] extends [never] ? false : NonNullable<unknown> extends T ? false : true;
 /**
  * Generic request options for API endpoints with typed methods, path params, query params, and body
  * - pathParams is REQUIRED when PathParams is not never
@@ -81,9 +86,7 @@ export type HasRequiredKeys<T> = [T] extends [never] ? false : {} extends T ? fa
  * - body is REQUIRED when it's a specific type (not never, not undefined)
  * - body is OPTIONAL when it's never or undefined
  */
-export type RequestOptions<URL extends keyof Endpoints, Endpoints extends {
-    [K in keyof Endpoints]: EndpointDefinition<any, any, any, any>;
-}> = {
+export type RequestOptions<URL extends keyof Endpoints, Endpoints extends AnyEndpoints<Endpoints>> = {
     method?: Endpoints[URL]['method'];
     headers?: Record<string, string>;
     signal?: AbortSignal;
@@ -116,9 +119,7 @@ export type IsRequired<T> = [T] extends [never] ? false : T extends undefined ?
  * - queryParams has any required keys inside, OR
  * - body/request is required (not never, not undefined)
  */
-export type HasRequiredParams<URL extends keyof Endpoints, Endpoints extends {
-    [K in keyof Endpoints]: EndpointDefinition<any, any, any, any>;
-}> = Endpoints[URL]['pathParams'] extends never ? HasRequiredKeys<Endpoints[URL]['queryParams']> extends true ? true : IsRequired<Endpoints[URL]['request']> : true;
+export type HasRequiredParams<URL extends keyof Endpoints, Endpoints extends AnyEndpoints<Endpoints>> = Endpoints[URL]['pathParams'] extends never ? HasRequiredKeys<Endpoints[URL]['queryParams']> extends true ? true : IsRequired<Endpoints[URL]['request']> : true;
 /**
  * Conditional options parameter for makeRequest
  * - Required if endpoint has:
@@ -127,6 +128,5 @@ export type HasRequiredParams<URL extends keyof Endpoints, Endpoints extends {
  *   - body with specific type (not undefined)
  * - Optional otherwise
  */
-export type MakeRequestOptions<URL extends keyof Endpoints, Endpoints extends {
-    [K in keyof Endpoints]: EndpointDefinition<any, any, any, any>;
-}> = HasRequiredParams<URL, Endpoints> extends true ? [options: RequestOptions<URL, Endpoints>] : [options?: RequestOptions<URL, Endpoints>];
+export type MakeRequestOptions<URL extends keyof Endpoints, Endpoints extends AnyEndpoints<Endpoints>> = HasRequiredParams<URL, Endpoints> extends true ? [options: RequestOptions<URL, Endpoints>] : [options?: RequestOptions<URL, Endpoints>];
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ragbits/api-client",
-    "version": "1.4.0-dev.202512050236",
+    "version": "1.4.0",
     "description": "JavaScript client for the Ragbits API",
     "repository": {
         "type": "git",