gentiq 0.8.3 → 0.9.0

package/dist/src/App.d.ts

@@ -12,4 +12,4 @@ export interface ChatUIProps {
     disclaimer?: ChatProps['disclaimer'];
     welcome?: import('./types').WelcomeScreenConfig;
 }
-export default function ChatUI({ sidebar, header, components, classNames, disclaimer, welcome }: ChatUIProps): import("react/jsx-runtime").JSX.Element;
+export default function ChatUI({ sidebar, header, components, classNames, disclaimer, welcome, }: ChatUIProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/ComponentsContext.d.ts

@@ -38,5 +38,5 @@ interface ComponentsProviderProps {
  * Merges caller-supplied overrides with the framework defaults and makes the
  * result available to all descendant components via `useComponents()`.
  */
-export declare function ComponentsProvider({ components, history, welcome, threadActions, composer, theme, disclaimer, app, i18n, settings, children }: ComponentsProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function ComponentsProvider({ components, history, welcome, threadActions, composer, theme, disclaimer, app, i18n, settings, children, }: ComponentsProviderProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/src/Part.d.ts

@@ -1,5 +1,6 @@
 import { ReactNode } from 'react';
 import { UIDataTypes, UIMessagePart, UITools, UIMessage } from 'ai';
+import { MessagePart } from './lib/messageParts';
 export interface PartProps {
     part: UIMessagePart<UIDataTypes, UITools>;
     message: UIMessage;
@@ -11,7 +12,7 @@ export interface PartProps {
     isFinished?: boolean;
     readonly?: boolean;
     /** Escape-hatch: return a ReactNode to fully replace rendering for this part. */
-    renderMessagePart?: (part: any, message: any) => ReactNode;
+    renderMessagePart?: (part: MessagePart, message: UIMessage) => ReactNode;
     chat?: any;
 }
 export declare function Part(props: PartProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/src/admin/components/ErrorBanner.d.ts

@@ -0,0 +1,7 @@
+interface ErrorBannerProps {
+    message: string;
+    onDismiss: () => void;
+}
+/** Dismissible inline error banner shared across admin pages. */
+export declare function ErrorBanner({ message, onDismiss }: ErrorBannerProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/admin/components/I18nPreview.d.ts

@@ -0,0 +1,6 @@
+interface I18nPreviewProps {
+    value: string;
+}
+/** Shows the resolved translation for a value that looks like an i18n key. */
+export declare function I18nPreview({ value }: I18nPreviewProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/src/admin/components/ModalCloseButton.d.ts

@@ -0,0 +1,7 @@
+interface ModalCloseButtonProps {
+    onClick: () => void;
+    label?: string;
+}
+/** The "×" button used in the header of hand-rolled admin modals. */
+export declare function ModalCloseButton({ onClick, label }: ModalCloseButtonProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/admin/components/SectionHeader.d.ts

@@ -0,0 +1,8 @@
+import { LucideIcon } from 'lucide-react';
+interface SectionHeaderProps {
+    title: string;
+    icon: LucideIcon;
+}
+/** Centered divider + label used to separate sections on the settings page. */
+export declare function SectionHeader({ title, icon: Icon }: SectionHeaderProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -1,3 +1,4 @@
+import { AppSettings } from '../../types';
 export interface AdminLoginResponse {
     token: string;
     admin_id: string;
@@ -50,8 +51,8 @@ export interface UserUsageSummary {
 export interface UserBulkBalanceFilters {
     query?: string;
     user_ids?: string[];
-    metadata_equals?: Record<string, any>;
-    metadata_in?: Record<string, any[]>;
+    metadata_equals?: Record<string, unknown>;
+    metadata_in?: Record<string, unknown[]>;
 }
 export interface UserBulkBalanceUpdate {
     operation: 'set' | 'add' | 'full_charge';
@@ -94,7 +95,7 @@ export interface ThreadItem {
     id: string;
     thread_id: string;
     role: string;
-    content: any;
+    content: unknown;
     feedback?: string;
     created_at: string;
 }
@@ -105,12 +106,104 @@ export interface Job {
     user_id: string | null;
     created_at: string;
     updated_at: string;
-    metadata: any;
+    metadata: unknown;
     progress: number;
     message: string | null;
-    result: any;
+    result: unknown;
     error: string | null;
 }
+/** Generic `{ status, message }` acknowledgement returned by mutating endpoints. */
+export interface AdminStatusResponse {
+    status: string;
+    message: string;
+}
+/** Response from creating a user. */
+export interface UserCreateResponse {
+    status: string;
+    user: {
+        id: string;
+        phone: string;
+        name: string;
+        surname: string;
+        token: string;
+        created_at: string;
+        recharge_policy?: RechargePolicy | null;
+    };
+}
+/** A user's balance as returned after a balance mutation. */
+export interface AdminUserBalance {
+    tokens: number;
+    requests: number;
+    token_limit: number;
+    request_limit: number;
+    updated_at: string;
+}
+/** Response from updating a user's balance. */
+export interface UserBalanceUpdateResponse {
+    status: string;
+    message: string;
+    balance: AdminUserBalance;
+}
+/** Response from refreshing a user's auth token. */
+export interface UserTokenRefreshResponse {
+    status: string;
+    message: string;
+    user: {
+        id: string;
+        phone: string;
+        name: string;
+        surname: string;
+        token: string;
+        balance?: AdminUserBalance | null;
+        metadata: Record<string, any>;
+    };
+}
+export interface AnalyticsTrendItem {
+    date: string;
+    count: number;
+}
+export interface AnalyticsTokenTrendItem {
+    date: string;
+    input_tokens: number;
+    output_tokens: number;
+    requests: number;
+    cost_microunits: number;
+    unpriced_requests: number;
+}
+export interface AnalyticsFeedbackSentimentItem {
+    sentiment: string;
+    count: number;
+}
+export interface AnalyticsActiveUser {
+    user_id: string;
+    name: string;
+    thread_count: number;
+}
+/** Response from the analytics endpoint. */
+export interface AdminAnalytics {
+    overview: {
+        total_users: number;
+        total_threads: number;
+        total_messages: number;
+        total_input_tokens: number;
+        total_output_tokens: number;
+        total_cost_microunits: number;
+        unpriced_requests: number;
+        currency: string;
+    };
+    trends: {
+        users: AnalyticsTrendItem[];
+        threads: AnalyticsTrendItem[];
+        messages: AnalyticsTrendItem[];
+        token_usage: AnalyticsTokenTrendItem[];
+    };
+    distributions: {
+        feedback_sentiment: AnalyticsFeedbackSentimentItem[];
+    };
+    active_users: AnalyticsActiveUser[];
+}
+/** Request body accepted by the settings update endpoint (all fields optional). */
+export type AppSettingsUpdateInput = Partial<Omit<AppSettings, 'updated_at'>>;
 export declare class AdminAPI {
     private token;
     constructor();
@@ -130,8 +223,8 @@ export declare class AdminAPI {
         name?: string;
         password?: string;
         permissions?: string[];
-    }): Promise<any>;
-    deleteAdmin(adminId: string): Promise<any>;
+    }): Promise<AdminStatusResponse>;
+    deleteAdmin(adminId: string): Promise<AdminStatusResponse>;
     listPermissions(): Promise<{
         permissions: string[];
     }>;
@@ -153,7 +246,7 @@ export declare class AdminAPI {
         users: User[];
         count: number;
     }>;
-    createUser(phone: string, name: string, surname: string, tokens?: number, requests?: number, token_limit?: number, request_limit?: number, metadata?: Record<string, any>, recharge_policy?: RechargePolicyInput): Promise<any>;
+    createUser(phone: string, name: string, surname: string, tokens?: number, requests?: number, token_limit?: number, request_limit?: number, metadata?: Record<string, any>, recharge_policy?: RechargePolicyInput): Promise<UserCreateResponse>;
     updateUser(userId: string, data: {
         phone?: string;
         name?: string;
@@ -164,8 +257,8 @@ export declare class AdminAPI {
         status: string;
         user: User;
     }>;
-    deleteUser(userId: string): Promise<any>;
-    updateUserBalance(userId: string, tokens: number, requests: number, token_limit?: number, request_limit?: number): Promise<any>;
+    deleteUser(userId: string): Promise<AdminStatusResponse>;
+    updateUserBalance(userId: string, tokens: number, requests: number, token_limit?: number, request_limit?: number): Promise<UserBalanceUpdateResponse>;
     bulkUpdateUserBalance(data: UserBulkBalanceUpdate): Promise<{
         status: string;
         matched: number;
@@ -176,17 +269,17 @@ export declare class AdminAPI {
         matched: number;
         updated: number;
     }>;
-    refreshUserToken(userId: string): Promise<any>;
+    refreshUserToken(userId: string): Promise<UserTokenRefreshResponse>;
     getUserUsageSummary(userId: string): Promise<UserUsageSummary>;
-    getAnalytics(days?: number): Promise<any>;
+    getAnalytics(days?: number): Promise<AdminAnalytics>;
     listJobs(limit?: number, type?: string): Promise<{
         jobs: Job[];
         count: number;
     }>;
-    cancelJob(jobId: string): Promise<any>;
-    getSettings(): Promise<any>;
-    updateSettings(data: any): Promise<any>;
-    resetSettings(): Promise<any>;
+    cancelJob(jobId: string): Promise<AdminStatusResponse>;
+    getSettings(): Promise<AppSettings>;
+    updateSettings(data: AppSettingsUpdateInput): Promise<AppSettings>;
+    resetSettings(): Promise<AdminStatusResponse>;
     getAttachmentBlob(objectName: string): Promise<Blob>;
 }
 export declare const adminAPI: AdminAPI;

package/dist/src/admin/pages/settings/ChatSection.d.ts

@@ -0,0 +1,12 @@
+import { Dispatch, SetStateAction } from 'react';
+import { UserMetadataField } from '../../../types';
+import { AdminSettingsState } from './types';
+interface ChatSectionProps {
+    settings: AdminSettingsState;
+    setSettings: Dispatch<SetStateAction<AdminSettingsState>>;
+    userMetadataFields: UserMetadataField[];
+    isRtl: boolean;
+}
+/** Chat experience settings: greetings, feature toggles, and settings-tab field modes. */
+export declare function ChatSection({ settings, setSettings, userMetadataFields, isRtl, }: ChatSectionProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/admin/pages/settings/FieldModeGrid.d.ts

@@ -0,0 +1,14 @@
+import { SettingsFieldMode } from '../../../types';
+interface FieldModeGridProps {
+    title: string;
+    fields: {
+        id: string;
+        label: string;
+    }[];
+    values: Record<string, SettingsFieldMode>;
+    onChange: (id: string, mode: SettingsFieldMode) => void;
+    columns?: 2 | 4;
+}
+/** A titled grid of per-field visibility/mode selects (editable / faded / hidden). */
+export declare function FieldModeGrid({ title, fields, values, onChange, columns, }: FieldModeGridProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/admin/pages/settings/GeneralSection.d.ts

@@ -0,0 +1,11 @@
+import { Dispatch, SetStateAction } from 'react';
+import { AdminSettingsState } from './types';
+interface GeneralSectionProps {
+    settings: AdminSettingsState;
+    setSettings: Dispatch<SetStateAction<AdminSettingsState>>;
+    accentValue: string;
+    accentIsValid: boolean;
+}
+/** App-name, language and appearance (theme + accent) settings. */
+export declare function GeneralSection({ settings, setSettings, accentValue, accentIsValid, }: GeneralSectionProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/admin/pages/settings/SettingsToggleCard.d.ts

@@ -0,0 +1,10 @@
+interface SettingsToggleCardProps {
+    title: string;
+    help: string;
+    checked: boolean;
+    onCheckedChange: (checked: boolean) => void;
+    className?: string;
+}
+/** A bordered card pairing a labeled description with a toggle switch. */
+export declare function SettingsToggleCard({ title, help, checked, onCheckedChange, className, }: SettingsToggleCardProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/admin/pages/settings/TranslationEditor.d.ts

@@ -0,0 +1,9 @@
+/** Nested i18n bundle the translation editor reads/writes: lang → namespace → key → value. */
+export type TranslationStore = Record<string, Record<string, Record<string, string>>>;
+interface TranslationEditorProps {
+    translations: TranslationStore;
+    onChange: (next: TranslationStore) => void;
+}
+/** JSON editor for the per-language / per-namespace i18n bundles. */
+export declare function TranslationEditor({ translations, onChange }: TranslationEditorProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/admin/pages/settings/types.d.ts

@@ -0,0 +1,12 @@
+import { AppSettings, SettingsFieldMode } from '../../../types';
+import { TranslationStore } from './TranslationEditor';
+/**
+ * Local editor state — the backend {@link AppSettings} with the loosely-typed
+ * `translations` and per-section field maps narrowed to the shapes the settings page edits.
+ */
+export type AdminSettingsState = Omit<AppSettings, 'translations' | 'settings_general_fields' | 'settings_profile_fields' | 'settings_account_fields'> & {
+    translations: TranslationStore;
+    settings_general_fields: Record<string, SettingsFieldMode>;
+    settings_profile_fields: Record<string, SettingsFieldMode>;
+    settings_account_fields: Record<string, SettingsFieldMode>;
+};

package/dist/src/admin/pages/users/UserBulkBalanceModal.d.ts

@@ -0,0 +1,11 @@
+import { UserMetadataField } from '../../../types';
+interface UserBulkBalanceModalProps {
+    searchQuery: string;
+    userMetadataFields: UserMetadataField[];
+    onClose: () => void;
+    onApplied: () => void;
+    onError: (message: string) => void;
+}
+/** Modal to apply balance and/or renewal-policy changes to many users at once. */
+export declare function UserBulkBalanceModal({ searchQuery, userMetadataFields, onClose, onApplied, onError, }: UserBulkBalanceModalProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/admin/pages/users/UserFormModal.d.ts

@@ -0,0 +1,13 @@
+import { User } from '../../lib/api';
+import { AppSettings, UserMetadataField } from '../../../types';
+interface UserFormModalProps {
+    editingUser: User | null;
+    appSettings: AppSettings | null;
+    userMetadataFields: UserMetadataField[];
+    onClose: () => void;
+    onSaved: () => void;
+    onError: (message: string) => void;
+}
+/** Add / edit a single user, including initial balance, auto-recharge and metadata. */
+export declare function UserFormModal({ editingUser, appSettings, userMetadataFields, onClose, onSaved, onError, }: UserFormModalProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/admin/pages/users/UserRechargeModal.d.ts

@@ -0,0 +1,10 @@
+import { User } from '../../lib/api';
+interface UserRechargeModalProps {
+    user: User;
+    onClose: () => void;
+    onSaved: () => void;
+    onError: (message: string) => void;
+}
+/** Modal to top up / set the token & request balance of a single user. */
+export declare function UserRechargeModal({ user, onClose, onSaved, onError }: UserRechargeModalProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/admin/pages/users/UserUsageDialog.d.ts

@@ -0,0 +1,9 @@
+import { User } from '../../lib/api';
+interface UserUsageDialogProps {
+    user: User | null;
+    onClose: () => void;
+    onError: (message: string) => void;
+}
+/** Loads and displays a user's aggregate usage summary in a dialog. */
+export declare function UserUsageDialog({ user, onClose, onError }: UserUsageDialogProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/admin/pages/users/UsersTable.d.ts

@@ -0,0 +1,21 @@
+import { User } from '../../lib/api';
+import { UserMetadataField } from '../../../types';
+export type SortField = 'phone' | 'name' | 'surname';
+export type SortOrder = 'asc' | 'desc';
+interface UsersTableProps {
+    users: User[];
+    loading: boolean;
+    totalCount: number;
+    userMetadataFields: UserMetadataField[];
+    sortBy: SortField;
+    sortOrder: SortOrder;
+    onSort: (field: SortField) => void;
+    onLoadMore: () => void;
+    onUsage: (user: User) => void;
+    onEdit: (user: User) => void;
+    onRecharge: (user: User) => void;
+    onCopyToken: (user: User) => void;
+    onDelete: (userId: string) => void;
+}
+export declare function UsersTable({ users, loading, totalCount, userMetadataFields, sortBy, sortOrder, onSort, onLoadMore, onUsage, onEdit, onRecharge, onCopyToken, onDelete, }: UsersTableProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/components/PromptInputArea.d.ts

@@ -8,5 +8,5 @@ interface PromptInputAreaProps {
     conversationId?: string;
     className?: string;
 }
-export declare function PromptInputArea({ onSend, status, isLastMessageFinished, stop, isErrorVisible, conversationId, className }: PromptInputAreaProps): import("react/jsx-runtime").JSX.Element;
+export declare function PromptInputArea({ onSend, status, isLastMessageFinished, stop, isErrorVisible, conversationId, className, }: PromptInputAreaProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/src/components/ai-elements/Conversation.d.ts

@@ -5,5 +5,15 @@ export type ConversationProps = ComponentProps<typeof StickToBottom>;
 export declare const Conversation: ({ className, ...props }: ConversationProps) => import("react/jsx-runtime").JSX.Element;
 export type ConversationContentProps = ComponentProps<typeof StickToBottom.Content>;
 export declare const ConversationContent: ({ className, ...props }: ConversationContentProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Forces a scroll to the bottom the moment the user submits a message, even if
+ * they had scrolled up. Must render inside <Conversation> to read the
+ * stick-to-bottom context. `use-stick-to-bottom` only auto-sticks while the
+ * viewport is already at the bottom, so a fresh send from a scrolled-up
+ * position needs this nudge.
+ */
+export declare const ConversationScrollOnSubmit: ({ status }: {
+    status: string;
+}) => null;
 export type ConversationScrollButtonProps = ComponentProps<typeof Button>;
 export declare const ConversationScrollButton: ({ className, ...props }: ConversationScrollButtonProps) => import("react/jsx-runtime").JSX.Element | null;

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

@@ -1,9 +1,9 @@
-export declare function useAdminUsers(skip?: number, limit?: number, query?: string): import('@tanstack/react-query').UseQueryResult<{
+export declare function useAdminUsers(skip?: number, limit?: number, query?: string, sortBy?: 'phone' | 'name' | 'surname', sortOrder?: 'asc' | 'desc'): import('@tanstack/react-query').UseQueryResult<{
     users: import('../admin/lib/api').User[];
     count: number;
 }, Error>;
 export declare function useAdminUsersMutations(): {
-    createUser: import('@tanstack/react-query').UseMutationResult<any, Error, {
+    createUser: import('@tanstack/react-query').UseMutationResult<import('../admin/lib/api').UserCreateResponse, Error, {
         phone: string;
         name: string;
         surname: string;
@@ -21,15 +21,15 @@ export declare function useAdminUsersMutations(): {
             surname?: string;
         };
     }, unknown>;
-    deleteUser: import('@tanstack/react-query').UseMutationResult<any, Error, string, unknown>;
-    updateBalance: import('@tanstack/react-query').UseMutationResult<any, Error, {
+    deleteUser: import('@tanstack/react-query').UseMutationResult<import('../admin/lib/api').AdminStatusResponse, Error, string, unknown>;
+    updateBalance: import('@tanstack/react-query').UseMutationResult<import('../admin/lib/api').UserBalanceUpdateResponse, Error, {
         userId: string;
         tokens: number;
         requests: number;
     }, unknown>;
-    refreshToken: import('@tanstack/react-query').UseMutationResult<any, Error, string, unknown>;
+    refreshToken: import('@tanstack/react-query').UseMutationResult<import('../admin/lib/api').UserTokenRefreshResponse, Error, string, unknown>;
 };
-export declare function useAdminAnalytics(days?: number): import('@tanstack/react-query').UseQueryResult<any, Error>;
+export declare function useAdminAnalytics(days?: number): import('@tanstack/react-query').UseQueryResult<import('../admin/lib/api').AdminAnalytics, Error>;
 export declare function useAdminAdmins(): import('@tanstack/react-query').UseQueryResult<{
     admins: import('../admin/lib/api').Admin[];
 }, Error>;
@@ -40,7 +40,7 @@ export declare function useAdminAdminsMutations(): {
         name: string;
         permissions: string[];
     }, unknown>;
-    updateAdmin: import('@tanstack/react-query').UseMutationResult<any, Error, {
+    updateAdmin: import('@tanstack/react-query').UseMutationResult<import('../admin/lib/api').AdminStatusResponse, Error, {
         adminId: string;
         data: {
             name?: string;
@@ -48,7 +48,7 @@ export declare function useAdminAdminsMutations(): {
             permissions?: string[];
         };
     }, unknown>;
-    deleteAdmin: import('@tanstack/react-query').UseMutationResult<any, Error, string, unknown>;
+    deleteAdmin: import('@tanstack/react-query').UseMutationResult<import('../admin/lib/api').AdminStatusResponse, Error, string, unknown>;
 };
 export declare function useAdminThreads(skip?: number, limit?: number, query?: string, feedback?: string): import('@tanstack/react-query').UseQueryResult<{
     threads: import('../admin/lib/api').Thread[];
@@ -64,7 +64,7 @@ export declare function useAdminJobs(limit?: number, type?: string): import('@ta
     count: number;
 }, Error>;
 export declare function useAdminJobsMutations(): {
-    cancelJob: import('@tanstack/react-query').UseMutationResult<any, Error, string, unknown>;
+    cancelJob: import('@tanstack/react-query').UseMutationResult<import('../admin/lib/api').AdminStatusResponse, Error, string, unknown>;
 };
 export declare function useAdminAuth(): {
     login: (username: string, password: string) => Promise<import('../admin/lib/api').AdminLoginResponse>;

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 {};