gentiq 0.8.3 → 0.10.0

package/dist/src/hooks/useGentiqChat.d.ts

@@ -1,3 +1,4 @@
+import { UIMessage } from 'ai';
 import { ChatReference } from '../types';
 export type ChatStatus = 'idle' | 'loading-history' | 'ready' | 'streaming' | 'error' | 'submitted';
 export interface UseGentiqChatOptions {
@@ -13,8 +14,8 @@ export declare function useGentiqChat({ onFinish }?: UseGentiqChatOptions): {
     isErrorHistory: boolean;
     conversationId: string;
     id: string;
-    setMessages: (messages: import('ai').UIMessage<unknown, import('ai').UIDataTypes, import('ai').UITools>[] | ((messages: import('ai').UIMessage<unknown, import('ai').UIDataTypes, import('ai').UITools>[]) => import('ai').UIMessage<unknown, import('ai').UIDataTypes, import('ai').UITools>[])) => void;
-    messages: import('ai').UIMessage<unknown, import('ai').UIDataTypes, import('ai').UITools>[];
+    setMessages: (messages: UIMessage<unknown, import('ai').UIDataTypes, import('ai').UITools>[] | ((messages: UIMessage<unknown, import('ai').UIDataTypes, import('ai').UITools>[]) => UIMessage<unknown, import('ai').UIDataTypes, import('ai').UITools>[])) => void;
+    messages: UIMessage<unknown, import('ai').UIDataTypes, import('ai').UITools>[];
     regenerate: ({ messageId, ...options }?: {
         messageId?: string;
     } & import('ai').ChatRequestOptions) => Promise<void>;

package/dist/src/index.d.ts

@@ -1,6 +1,7 @@
 export { GentiqProvider, type GentiqProviderProps } from './GentiqProvider';
 export * from './types';
-export { userAPI } from './lib/api';
+export { createGentiqApi, type GentiqApi } from './lib/api';
+export { useGentiqApi } from './lib/GentiqApiContext';
 export { default as ChatUI, type ChatUIProps } from './App';
 export { default as Chat, type ChatProps } from './Chat';
 export { Part, type PartProps } from './Part';
@@ -17,11 +18,11 @@ export { SettingsDialog } from './components/SettingsDialog';
 export { WelcomeScreen } from './components/WelcomeScreen';
 export { AppSidebar } from './components/AppSidebar';
 export { SidebarProvider } from './components/ui/sidebar';
-export { Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue } from './components/ui/select';
+export { Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, } from './components/ui/select';
 export { default as RequireAuth } from './components/RequireAuth';
 export { default as UserLoginPage } from './pages/UserLoginPage';
 export { default as SharedChatView } from './pages/SharedChatView';
 export { useGentiqChat } from './hooks/useGentiqChat';
-export { useGentiqUser, type UseGentiqUserOptions, } from './hooks/useGentiqUser';
+export { useGentiqUser, type UseGentiqUserOptions } from './hooks/useGentiqUser';
 export { useComponents } from './ComponentsContext';
 export { useTranslation, withTranslation, Translation, Trans } from 'react-i18next';

package/dist/src/lib/GentiqApiContext.d.ts

@@ -0,0 +1,12 @@
+import { ReactNode } from 'react';
+import { GentiqApi } from './api';
+/**
+ * Access the API client of the nearest {@link GentiqProvider}.
+ *
+ * @throws if called outside a `GentiqProvider`.
+ */
+export declare function useGentiqApi(): GentiqApi;
+export declare function GentiqApiProvider({ api, children }: {
+    api: GentiqApi;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/src/lib/api.d.ts

@@ -1,20 +1,39 @@
-import { GentiqConfig, GentiqEndpoints, GentiqUser } from '../types';
-export declare const userAPI: {
-    init: (config: GentiqConfig) => void;
+import { AppConfigResponse, AuthResponse, FeedbackResponse, GentiqConfig, GentiqEndpoints, GentiqUser, RegisterResponse, ShareThreadResponse, SharedThreadResponse, StatusResponse, ThreadHistoryResponse, ThreadMessagesResponse, UserBalance } from '../types';
+/** Endpoint override functions take string path segments and return a path. */
+type EndpointFn = (...args: string[]) => string;
+/**
+ * The user-facing API client. One instance per {@link createGentiqApi} call,
+ * each owning its own config and auth adapter so multiple `GentiqProvider`s
+ * (multi-tenant / multi-backend) never clobber one another's state.
+ *
+ * Obtain the active instance with `useGentiqApi()` inside the provider tree;
+ * call `createGentiqApi()` directly only for tests or non-React usage.
+ */
+export type GentiqApi = ReturnType<typeof createGentiqApi>;
+/**
+ * Create an isolated Gentiq API client. The returned instance closes over its
+ * own `config`/`authAdapter`; reconfigure it later via {@link GentiqApi.configure}.
+ */
+export declare function createGentiqApi(initialConfig?: GentiqConfig): {
+    /**
+     * Merge new config into this instance. Safe to call repeatedly (e.g. when
+     * the provider re-resolves config after fetching dynamic settings).
+     */
+    configure: (next: GentiqConfig) => void;
     getConfig: () => GentiqConfig;
     getToken: () => string | null;
     setToken: (token: string) => void;
     clearToken: () => void;
     getHeaders: () => Record<string, string>;
-    getEndpoint: (key: keyof GentiqEndpoints, fallback: string | ((...args: any[]) => string), ...args: any[]) => string;
-    handleResponse: (res: Response, fallbackMessage?: string) => Promise<any>;
-    login: (phone: string, password: string) => Promise<any>;
-    register: (phone: string, password: string, name: string, surname: string, metadata?: Record<string, any>) => Promise<any>;
-    getBalance: () => Promise<any>;
-    getHistory: (skip?: number, limit?: number) => Promise<any>;
-    getThreadMessages: (threadId: string) => Promise<any>;
-    deleteThread: (threadId: string) => Promise<any>;
-    updateThreadTitle: (threadId: string, title: string) => Promise<any>;
+    getEndpoint: (key: keyof GentiqEndpoints, fallback: string | EndpointFn, ...args: string[]) => string;
+    handleResponse: <T = unknown>(res: Response, fallbackMessage?: string) => Promise<T>;
+    login: (phone: string, password: string) => Promise<AuthResponse>;
+    register: (phone: string, password: string, name: string, surname: string, metadata?: Record<string, any>) => Promise<RegisterResponse>;
+    getBalance: () => Promise<UserBalance>;
+    getHistory: (skip?: number, limit?: number) => Promise<ThreadHistoryResponse>;
+    getThreadMessages: (threadId: string) => Promise<ThreadMessagesResponse>;
+    deleteThread: (threadId: string) => Promise<StatusResponse>;
+    updateThreadTitle: (threadId: string, title: string) => Promise<StatusResponse>;
     /**
      * Fetch an attachment from the Minio-backed proxy endpoint and return
      * a local blob URL usable in <img src>. Caller should revoke via
@@ -26,7 +45,7 @@ export declare const userAPI: {
      * a local blob URL.
      */
     getPublicAttachmentBlobUrl(object_name: string): Promise<string>;
-    saveFeedback: (threadId: string, messageId: string, sentiment: "like" | "dislike" | null) => Promise<any>;
+    saveFeedback: (threadId: string, messageId: string, sentiment: "like" | "dislike" | null) => Promise<FeedbackResponse>;
     getMe: () => Promise<GentiqUser>;
     updateMe: (data: {
         name?: string;
@@ -35,8 +54,9 @@ export declare const userAPI: {
         password?: string;
         metadata?: Record<string, any>;
     }) => Promise<GentiqUser>;
-    pinThread: (threadId: string, pinned: boolean) => Promise<any>;
-    shareThread: (threadId: string) => Promise<any>;
-    getSharedThread: (shareId: string) => Promise<any>;
-    getAppConfig: () => Promise<any>;
+    pinThread: (threadId: string, pinned: boolean) => Promise<StatusResponse>;
+    shareThread: (threadId: string) => Promise<ShareThreadResponse>;
+    getSharedThread: (shareId: string) => Promise<SharedThreadResponse>;
+    getAppConfig: () => Promise<AppConfigResponse>;
 };
+export {};

package/dist/src/lib/errors.d.ts

@@ -1,3 +1,4 @@
+import { TFunction } from 'i18next';
 /**
  * Standardized error codes for the Gentiq framework.
  * These should match the ErrorCode Enum in the backend.
@@ -29,25 +30,25 @@ export declare const GentiqErrorCode: {
     readonly VALIDATION_ERROR: "validation_error";
     readonly NOT_FOUND: "not_found";
 };
-export type GentiqErrorCode = typeof GentiqErrorCode[keyof typeof GentiqErrorCode];
+export type GentiqErrorCode = (typeof GentiqErrorCode)[keyof typeof GentiqErrorCode];
 export interface GentiqErrorResponse {
     error: {
         code: GentiqErrorCode | string;
         message: string;
-        details?: any;
+        details?: unknown;
     };
 }
 export declare class GentiqError extends Error {
     code: GentiqErrorCode | string;
     status?: number;
-    details?: any;
+    details?: unknown;
     constructor(response: GentiqErrorResponse, status?: number);
 }
 /**
  * Checks if an error is a GentiqError.
  */
-export declare function isGentiqError(error: any): error is GentiqError;
+export declare function isGentiqError(error: unknown): error is GentiqError;
 /**
  * Returns a localized error message for a given error or code.
  */
-export declare function getLocalizedErrorMessage(error: Error | GentiqErrorCode | string, t: (key: string, options?: any) => string): string;
+export declare function getLocalizedErrorMessage(error: unknown, t: TFunction): string;

package/dist/src/lib/messageParts.d.ts

@@ -0,0 +1,40 @@
+import { UIDataTypes, UIMessagePart, UITools } from 'ai';
+/**
+ * A message part from the AI SDK union — covers `text`, `reasoning`, `tool-*`,
+ * `file`, and `data-*` parts. Use this instead of `any` for typed `parts` arrays.
+ */
+export type MessagePart = UIMessagePart<UIDataTypes, UITools>;
+/**
+ * A loose, structural view of a message part.
+ *
+ * The AI SDK's part union (and the backend's persisted thread items) expose
+ * per-variant fields — `text`, tool `input`/`output`, file metadata, `data-*`
+ * payloads — that are not surfaced uniformly on {@link MessagePart}. Renderers
+ * read those fields through this shape so the narrowing casts live in one place
+ * instead of being scattered as `as any` across the codebase.
+ *
+ * `data` is intentionally `any`: `data-*` parts carry arbitrary payloads that
+ * are sometimes arrays (`data[0].title`) and sometimes objects (`data.id`).
+ */
+export interface LooseMessagePart {
+    type: string;
+    text?: string;
+    data?: any;
+    url?: string;
+    filename?: string;
+    mediaType?: string;
+    media_type?: string;
+    mime_type?: string;
+    toolName?: string;
+    tool_name?: string;
+    toolCallId?: string;
+    tool_call_id?: string;
+    state?: string;
+    input?: unknown;
+    output?: unknown;
+    error_text?: string;
+    errorText?: string;
+    object_name?: string;
+}
+/** Narrow an AI SDK / backend message part to its {@link LooseMessagePart} view. */
+export declare const asLoosePart: (part: unknown) => LooseMessagePart;