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

package/dist/autogen.types.d.ts

@@ -47,6 +47,7 @@ export type TaskStatus = TypeFrom<typeof TaskStatus>;
  */
 export declare const AuthType: {
     readonly Credentials: "credentials";
+    readonly Oauth2: "oauth2";
 };
 export type AuthType = TypeFrom<typeof AuthType>;
 /**
@@ -66,6 +67,10 @@ export interface ChatContext {
     confirmed_tools: {
         [k: string]: unknown;
     }[] | null;
+    /**
+     * User's timezone in IANA format (e.g., 'Europe/Warsaw', 'America/New_York')
+     */
+    timezone: string | null;
     [k: string]: unknown;
 }
 /**
@@ -220,9 +225,9 @@ export interface UsageContent {
     };
 }
 /**
- * Todo item content wrapper.
+ * Plan item content wrapper.
  */
-export interface TodoItemContent {
+export interface PlanItemContent {
     task: Task;
 }
 /**
@@ -231,6 +236,12 @@ export interface TodoItemContent {
 export interface ConfirmationRequestContent {
     confirmation_request: ConfirmationRequest;
 }
+/**
+ * Error content wrapper for displaying error messages to users.
+ */
+export interface ErrorContent {
+    message: string;
+}
 /**
  * Customization for the header section of the UI.
  */
@@ -304,6 +315,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 +342,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 +434,30 @@ export interface AuthenticationConfig {
      * List of available authentication types
      */
     auth_types: AuthType[];
-}
-/**
- * Request body for user login
- */
-export interface CredentialsLoginRequest {
     /**
-     * Username
+     * List of available OAuth2 providers
      */
-    username: string;
-    /**
-     * Password
-     */
-    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 +472,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,9 +529,9 @@ export interface ClearMessageChatResponse {
     type: 'clear_message';
     content: unknown;
 }
-export interface TodoItemChatResonse {
-    type: 'todo_item';
-    content: TodoItemContent;
+export interface PlanItemChatResponse {
+    type: 'plan_item';
+    content: PlanItemContent;
 }
 export interface ConversationSummaryResponse {
     type: 'conversation_summary';
@@ -512,6 +541,10 @@ export interface ConfirmationRequestChatResponse {
     type: 'confirmation_request';
     content: ConfirmationRequestContent;
 }
+export interface ErrorChatResponse {
+    type: 'error';
+    content: ErrorContent;
+}
 export interface ChunkedChatResponse {
     type: 'chunked_content';
     content: ChunkedContent;
@@ -519,4 +552,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 | PlanItemChatResponse | ConversationSummaryResponse | ConfirmationRequestChatResponse | ErrorChatResponse;

package/dist/index.cjs

@@ -52,7 +52,8 @@ var TaskStatus = {
   Retrying: "retrying"
 };
 var AuthType = {
-  Credentials: "credentials"
+  Credentials: "credentials",
+  Oauth2: "oauth2"
 };
 
 // src/index.ts
@@ -99,6 +100,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 +110,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 +144,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,9 +206,14 @@ 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;
@@ -238,7 +258,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 +288,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) {

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

@@ -21,7 +21,8 @@ var TaskStatus = {
   Retrying: "retrying"
 };
 var AuthType = {
-  Credentials: "credentials"
+  Credentials: "credentials",
+  Oauth2: "oauth2"
 };
 
 // src/index.ts
@@ -68,6 +69,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 +79,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 +113,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,9 +175,14 @@ 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;
@@ -207,7 +227,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 +257,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) {

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-dev.202602190302",
     "description": "JavaScript client for the Ragbits API",
     "repository": {
         "type": "git",